# R10 | 门面工程与发布（最后一轮，预计 1 天）

- 前置：R1-R9 与 R11、R12 全部完成（README 数字、能力清单、FAQ、评测数据都要反映最终状态，提前做会返工）。
- 目标：让一个陌生研究者打开仓库 **3 秒看懂价值、30 秒想试、3 分钟装上**——看了就想 star/fork 的水准；同时完成 v3.0.0 发布。

## R10.1 README 重构（中文主文档）

逐节改造清单（保留现有"案例展示/九图/知识库"等优质资产，调结构补缺口）：

1. **英雄区**：现有 logo+标语保留；徽章控制 ≤7 枚（现有 7 枚正好，CI 徽章确认绿）；标语下补一行数字带量化卖点（28 技能 · 9 库 · N 个可跑脚本 · N 张知识卡——数字从 WHATS_INCLUDED 实数）。
2. **新增"推荐配置"节**（用户钦定内容，放安装节之前），全文如下骨架：

   > ### 🏆 推荐配置（最佳体验）
   > | 项 | 推荐 | 说明 |
   > |---|---|---|
   > | Harness | **Claude Code** / **Codex** | 两端一键安装，技能自动触发 |
   > | 模型 | **Claude Opus 4.8**、**GPT 5.5** | 备用：DeepSeek V4 Pro 等 |
   > | 生图模型（强烈建议） | **GPT Image 2** / **Nanobanana 2** / **Seedream 5.0** 任一 | 解锁 PPT 生图流水线（`imggen-enhanced`）；不配置则自动走程序化路线 |
   >
   > 不配生图 key 一切核心功能照常；配了，答辩/路演 PPT 直接上一个档次。

3. **demo 动图**：英雄区或"为什么用它"后插 1-2 个终端录屏 GIF——场景 A：一句话触发文献检索→出综述骨架；场景 B：R6 流水线从 deck_spec 到可编辑 PPT。制作：vhs（`charmbracelet/vhs`，脚本化可复现）优先，asciinema+agg 备选；本机做不了就截图三联代替并在 PROGRESS 标注（不放假动图）。
4. **会话衔接卖点**：FAQ 已有条目（R2 产出）基础上，在"为什么用它"对比表加一行"上下文断了怎么办：普通助手=重新解释一遍 vs Light=衔接卡+启动提示词无缝续"。
5. **PPT 生图流水线宣传块**：技能总览 m16 行更新 + "完整链路"图加 imggen 分支一行。
6. **技能链路图**：现有 ASCII 链路升级为 `assets/pipeline.svg`（Mermaid 导出或手绘 SVG，28 技能主线+常驻环），README 引用；ASCII 版保留在折叠块（终端用户友好）。
7. **Star History**：尾部加 star-history.com 图表链接（标准 markdown 嵌入）。
8. **竞品对照矩阵**：取 R12.8 定稿的矩阵草稿并入"为什么用它"节（每格实查留痕，注明对照日期）；"低配模型已知限制"小字（R11.5 产出）并入推荐配置节。
9. **数字核对**：全文出现的技能数/库数/脚本数/校验器数/评测任务数与 WHATS_INCLUDED、实际目录一致（R8 已有部分 gate，人工再过一遍）。

## R10.2 README.en 同步

- 与中文版结构同构（R8.3 的 gate 必须绿）；推荐配置/衔接协议/imggen 三个新节全量翻译；不逐字直译，英文读者习惯优先（主动语态、短句）。

## R10.3 仓库元数据与社交面

| 项 | 动作 |
|---|---|
| Topics | `claude-code` `codex` `agent-skills` `ai-skills` `research-tools` `academic-writing` `latex` `scientific-figures` `literature-review` `pptx` （gh CLI：`gh repo edit --add-topic …`） |
| About | 一句话（中英）+ 指向 README 锚点链接 |
| 社交预览图 | 新建 `assets/social-preview.png`（1280×640）：logo+标语+28/9 数字+链路示意；gh 不支持设置则给用户上传指引 |
| Discussions | 确认开启，建 3 个分类：使用问答 / 技能建议 / 成果展示（用户晒用 Light 做出的论文/PPT——最强社证） |
| Issue 模板 | 现有 bug/功能模板核对，补"新知识卡贡献"模板（降低数据库众包门槛，呼应 R9） |
| CITATION.cff | 版本号升 3.0.0、日期更新 |

## R10.4 v3.0.0 发布

1. CHANGELOG.md：按 Keep a Changelog 风格补 3.0.0 节——Added（会话衔接协议/imggen 流水线/venue_signal 等新脚本/45+ 新知识卡）、Changed（OpenAlex 口径/契约统一/瘦身）、Fixed（11 P0 逐条）。
2. `git tag -a v3.0.0 -m "第三期:P0清零、中文链路闭环、会话衔接、PPT生图流水线、数据库上量"` + push tag。
3. GitHub Release：标题 + 正文（CHANGELOG 3.0.0 节中英双语摘要 + 三张亮点图：链路图/imggen 流水线示意/九图拼图）。
4. WHATS_INCLUDED.md 终核：脚本/模板/卡片计数全部实数。

## R10.5 Star/Fork 体检清单（发布前自评，全过才算门面完工）

- [ ] 首屏 3 秒：是什么/给谁用/凭什么强，不滚动即见
- [ ] 有真实可验证的成果展示（案例论文 PDF 可点开）
- [ ] 安装是一条命令，前置依赖写全
- [ ] 推荐配置表存在且与 m16 文档口径一致
- [ ] 有动图或三联截图证明"真的能跑"
- [ ] 对比表回答"我为什么不用 ChatGPT 直接聊"
- [ ] FAQ 覆盖：key/隐私/卸载/上下文衔接/会不会造假
- [ ] 英文 README 结构同构、新功能不缺
- [ ] 所有徽章绿/有效，无死链（check_skill_links 范围外的 README 外链人工点一遍）
- [ ] Release/tag/CHANGELOG/CITATION 四处版本一致

## R10.6 用户决策项（汇总拍板，不替用户决定）

1. **skills.sh 发布与否**：获得分发渠道 vs 公开维护承诺（生态 13.4% 技能含安全问题，发布方自身要扛审视）。建议：发布，但 README 声明"官方源仅 GitHub"。等用户拍板。
2. **宣传渠道**：知乎/小红书/X 发布文案是否需要（可备草稿）。等用户点头再写。
3. **db08 样例来源**（R9.6 遗留）与 **Hermes 方案追认**（R1.6 遗留）。

## 提交切分建议

- `README:推荐配置、演示动图与会话衔接卖点`
- `英文README:同步第三期全部新能力`
- `仓库门面:社交预览图、链路图与议题模板`
- `发布:v3.0.0变更日志、引用信息与版本标签`

## 收尾（收官）

总纲 §5 八步 + **总纲 §7 最终验收指标逐项填实际值**（写入 PROGRESS 尾部"收官记录"）；向用户汇报全期完成情况与三个决策项。
