小红书 Skill 创新赛 · 参与思路

从赛题拆解、选题决策、设计实现、验收到提交策略的完整复盘——一份可复用的参赛方法论，而非单次作品记录。

• 赛事：2026 华为开发者大赛
• 赛道：小红书 Skill 创新赛（竞赛 ID 1300000350）
• 奖池：¥500,000
• 作品：xhs-note-polish

01 赛赛概况

先看清规则再动手——这是整件事的起点。

• 赛事：2026 华为开发者大赛，下设多个赛道，本专题聚焦「小红书 Skill 创新赛」，总奖池 ¥500,000。
• 核心理念：学—做—晒 闭环。不是交一个 Skill 就完事，而是「学到—做出—晒出来」形成可传播闭环。晒（真实发布一篇笔记）是传播力分的证据。
• 硬门槛：必须用码道 CodeArts 或果办 OfficeAce 提交；主账号；实名认证；Skill ≤30 文件、≤40MB。

时间线（关键节点）

**⚠️ 反直觉点：**提交通道是「码道/果办 → 华为云 Skill 市场 + 小红书 Skill 市场」，不是 Git 仓库。把作品推到公开 Git 仓库等于把作品摆给所有报名者看，是这次最大的坑之一。

02 评审五维

五维是打分表，也是选题和取舍的标尺。每个设计决策都回扣到某一维。

**方法论：**选题前先用五维给自己打分，哪维弱就补哪维；任何「这个功能要不要做」的纠结，都回到「它提升哪一维、扣哪一维」来决断。

03 选题决策

选题 = 在五维约束下找全局最优解，不是找最酷的技术。

选定作品：xhs-note-polish（出片一键发）

输入一组照片（+ 可选用户历史文案），输出一份可直接发布的小红书笔记：重排后的图片（带画框/文案/签名叠加）+ note.md（标题/正文/标签）。

为什么是这个（对着五维打分）

**⚠️ 被否掉的选项：**纯文案生成（撞官方 AI，差异化≈0）、照片精修/美颜（PIL 做不稳，完成度会崩）、真 CV 场景识别（沙箱跑不了大模型，离线可跑优先）。

04 设计思路

每一步都是独立可跑的纯函数，评委能拆开单测，整条链离线可跑。

① 启发式场景识别（image_analyze.py）

用色彩统计（亮度/饱和度/暖冷偏/绿占比/肤色比）+ 边缘密度 + 宽高比，把照片分到 8 类：美食/夜景/风景/人像/室内/穿搭/探店/日常。

**⚠️ 诚实声明：**这是色彩统计启发式，不是真 CV 识别。选它是因为沙箱离线可跑、不依赖大模型；接 LLM 的扩展点 XHS_LLM_ENDPOINT 已留，但不承诺。这是「完成度」维的关键取舍——不虚标能力。

② 图片重排

规则可解释、非随机：封面 = 最高边缘密度（抓眼球）→ 同场景聚拢（读起来像故事）→ 竖横交替（视觉节奏）→ 最宽横图收尾。理由写进 note.md 注释，评委看得到不是随机。

③ few-shot 文案（caption_gen.py）

从用户 3–5 篇历史文案提取风格指纹：emoji 习惯、句长、标签。按人设（文艺/搞笑/种草/干货/记录）+ 场景分布拼一段连贯正文（不是每图一行模板拼接）。硬禁 17 个 AI 套话词（姐妹们/绝绝子/yyds/谁懂啊/直接封神…），命中即剔除并计数。

④ PIL 叠加

白色画框 + 底部渐变文字带（标题/正文）+ 序号徽章 + 签名水印。中文字体随仓库内置（SimHei.ttf），离线可跑。

平台 / 人设矩阵（复用性的证据）

同一组照片、同一引擎，换两个参数就是两篇不同笔记——这是复用率的可验证证据。

05 实现结构

12 个文件、5.1MB，全部硬指标内（≤30 文件、≤40MB）。

xhs-note-polish/
├── SKILL.md                  触发词 + 五维设计说明 + 用法 + 复用示例 + 失败处理
├── .gitignore
├── scripts/
│   ├── polish.py             主入口：编排 analyze→reorder→caption→overlay
│   ├── image_analyze.py      启发式场景识别（8 类）+ 视觉特征
│   ├── reorder.py            重排：封面/场景聚拢/竖横交替/横图收尾
│   ├── caption_gen.py        few-shot 风格 + 禁 AI 套话 + 连贯正文
│   └── overlay.py            PIL 画框/渐变文字带/序号徽章/签名
├── references/style_guide.md  禁用清单 + 人设档位 + 平台字数
├── assets/
│   ├── SimHei.ttf            内置中文字体（9.7MB，离线可跑）
│   ├── download_font.sh      字体备用拉取脚本
│   └── README.md
└── tests/test_acceptance.py   7 场景 × 10 断言验收

主流程一条命令

python3 scripts/polish.py \
  --photos ./my_photos \
  --out ./out \
  --persona 文艺 \
  --signature "@我的小日子" \
  --style-samples ./my_past_captions.txt

失败处理（全部显式，绝不静默）

06 验收

「逐功能真调用验收」是完成度维的落点——全过才算交付。

python3 tests/test_acceptance.py
=== 10 passed, 0 failed ===

7 个场景 × 10 项断言

⚠️ 未覆盖的诚实缺口：验收用的是合成图，启发式场景识别在真实照片上的准确率还没验。这是提交前最大的未知点（见 09）。

07 提交策略

提交是 irreversible 的竞赛动作，通道选错全盘皆输。

正确通道

1. 用华为云主账号登录码道 CodeArts（子账号不行，代金券也只发主账号）。
2. 把 Skill 目录弄进 CodeArts（IDE 打开本地目录，或导入 .skill 包）。
3. 在 CodeArts 对话框发官方口令：

我正在参加小红书Skill创新赛，帮我把这个Skill先发布到华为云Skill市场，
再使用 redskillhub-upload 发布到小红书 Skill 市场

4. 码道自动走发布流程，中间确认信息按实际确认。先发华为云 Skill 市场，确认成功再发小红书。
5. 发布到小红书 Skill 市场 = 非公开的参赛提交（不是公开发笔记）。另外再用自己的 Skill 产出一篇真实笔记，那是「晒」、是传播力分的证据。

为什么不走公开仓库

**❌ 公开 Git 仓库 = 抄袭风险。**初筛 11.16 才开始，提前公开等于把作品摆给 1.4 万报名者看。即使别人没原样抄，「撞创意」后评委判重复你也说不清。提交通道根本不是 Git 仓库——这是最该记住的坑。

私有仓库的定位

私有 GitCode 仓库（qin_rui/xhs-note-polish，private）只作云端备份 + 版本追溯，不是提交通道。clone 后直接可跑（字体已随仓库提交）。

08 踩坑记录

每个坑都记下根因和解法——下次参赛能直接绕开。

可提炼的两条通则：
① 沙箱 agent 没有用户的登录态和凭据，凡是要「以用户身份发布/提交」的动作，都该引导用户去对应官方客户端做，别在沙箱里假装。
② 多文件推远端优先 git push（Smart HTTP 代理），别逐文件 API 并发——会抢锁。

09 待办建议

提交前最该做、且能真做的事，按优先级。

1. 🔥 真实照片验收（最高优先）：拿一组真实出片跑 polish.py --style-samples <你过往3-5篇文案>，确认启发式场景识别在真素材上分得准。这是现在最大的不确定点——只用了合成图验过。
2. 实名认证 + 主账号：没实名 / 用子账号，代金券领不到、提交可能被挡。
3. 先华为云 Skill 市场，再小红书：口令里是两步串行，别跳；任一步报错把报错贴回来排查。
4. 发一篇真实笔记：用产物发一篇，截图作为「晒」的证据，别只交 Skill 不发笔记。
5. 迭代提交：以截止前最新一次提交为准，初筛前还能改。

**⚠️ 启发式阈值可能要调：**真实照片的色彩分布和合成图不同，image_analyze.classify 的几个阈值（亮度<60 判夜景、肤色比>0.18 判人像…）在真素材上可能需要微调。这是真实照片验收要重点看的。

10 成果

当前产物的三个落点：

**✅ 一句话总结：**选题对着五维打分、每步纯函数可单测、离线可跑不虚标、文案禁套话像人写的、提交走码道双市场不走公开仓库——这套思路换一个赛道也大体适用。

小红书 Skill 创新赛 · 参与思路专题 | 作品 xhs-note-polish | 2026-10-19