skill-forge-hub 1.3.0 → 1.3.2

package/CHANGELOG.en.md

@@ -4,6 +4,22 @@
 
 Version history of the SkillForge npm package `skill-forge-hub` (command name `skill-forge`).
 
+## 1.3.2 (2026-11-13)
+
+**prompt-pouch in-page usage scenarios + full functional check**
+
+- Functional check all green: 18/18 cards, zero JS errors; search/detail/delete-confirm/add/sort/theme-switch interactions verified; deleting a non-empty group triggers toast guard (confirm only for empty groups, both by design); the template page's three-tier fallback 404 probes are by design
+- In-page "usage tips" sidebar card and help panel (4 → 6 blocks) now cover conversation-saving scenarios: "save the last few rounds of chat into the pouch" with two-step confirmation, delete-first-confirm with prompts.json.bak-timestamp backup before write, and "rollback/restore pouch data" archive selection
+- usage-guide gains a "Typical scenarios" section: conversation capture / starting from scratch / delete & rollback / migration to a new machine
+- Template stamp prompt-pouch@10 → @11 (help panel structure change)
+
+## 1.3.1 (2026-11-12)
+
+**Daily/weekly template sample data generalized + CSDN article visual refresh**
+
+- Daily/weekly reference.html template samples fully generalized: all real project/component/product names removed (srf-web-* end names, MyServiceMenu/PaymentZone/ServiceMenuGrid, MoreServicesSection/StudentProfileCard, DISPATCHING state machine, product alias names, error code 43001, wsprobe probe, APK gate, WeChat/Alipay binding, viewer-side, etc.); concrete business-side names and component names replaced with generic wording (multi-side, menu/payment/grid modules, info cards, payment-channel binding, app-package version gate, viewing experience); only industry-generic technical terms (client/server/gateway, API/JWT/SSL) and quantitative data kept; DOM display and TXT copy source updated in lockstep
+- CSDN promo article visual refresh: new title + six skill screenshots + two mermaid structure diagrams
+
 ## 1.3.0 (2026-11-12)
 
 **prompt-pouch native dialogs eliminated: unified in-page confirm dialog in three modes**

package/CHANGELOG.md

@@ -4,6 +4,22 @@
 
 SkillForge（技能锻造坊）npm 包 `skill-forge-hub`（命令名 `skill-forge`）版本变更记录。
 
+## 1.3.2（2026-11-13）
+
+**prompt-pouch 页内使用场景三处布道 + 功能体检**
+
+- 功能体检全绿：18/18 卡片数、零 JS 报错，搜索/详情/删除确认/新增/排序/换肤全交互验证通过；删除非空分组走 toast 保护提示（组空才弹确认框，均设计内）；模板页三级兜底探测 404 为设计内行为
+- 页内「锦囊用法」侧栏说明卡与「使用帮助」面板（4 段扩 6 段）补充对话保存场景：对 AI 说「把上一轮/最近几轮对话存进锦囊」两段确认入囊、删除先确认且落盘前留 prompts.json.bak-时间戳、「回退/恢复锦囊数据」选档回滚
+- usage-guide 新增「典型使用场景」章节：对话沉淀 / 从零开始 / 对话删除与回退 / 换电脑迁移
+- 版本戳 prompt-pouch@10 → @11（帮助面板结构变化）
+
+## 1.3.1（2026-11-12）
+
+**日报/周报模板示例数据通用化 + CSDN 推广文图文改版**
+
+- 日报/周报 reference.html 模板示例彻底通用化：清除全部真实工程名/组件名/产品专名（srf-web-user/srf-web-wx/srf-web-h5-teacher、MyServiceMenu/PaymentZone/ServiceMenuGrid、MoreServicesSection/StudentProfileCard、DISPATCHING、邻音号、萤火、43001、wsprobe、APK、微信/支付宝、观众端等），业务端名与具体组件名一律换通用表述（多端、菜单/支付/网格等模块、信息卡片、支付渠道绑定、应用安装包版本门禁、观看体验等），仅保留业界通用技术术语（客户端/服务端/网关、API/JWT/SSL 等）与量化数据；DOM 展示区与 TXT 复制源逐处同步；weekly 示例「对外称呼正名」语句顺带修通
+- CSDN 推广文图文并茂改版：换标题 + 六张技能实拍截图 + 两张 mermaid 结构图
+
 ## 1.3.0（2026-11-12）
 
 **prompt-pouch 原生弹框清零：页内统一确认弹框三形态**

package/daily-report/resources/reference.html

@@ -426,7 +426,7 @@ html.js .rv.in{ opacity:1; translate:0 0; }
     <span class="header-badge">生成时间 2026-11-06 17:30:39</span>
     <div class="summary-line">
       <span class="summary-tag">TL;DR</span>
-      <span class="summary-text">三端账单状态色统一与充值切换学生功能双线交付，四项完成；明日聚焦边界场景、暗色适配与多机型回归，风险暂无。</span>
+      <span class="summary-text">多端账单状态色统一与充值切换学生功能双线交付，四项完成；明日聚焦边界场景、暗色适配与多机型回归，风险暂无。</span>
     </div>
     <div class="copy-wrap">
       <button class="copy-btn" id="copyBtn" type="button">
@@ -462,7 +462,7 @@ html.js .rv.in{ opacity:1; translate:0 0; }
         <li class="pbar-done">
           <span class="idx done"><b>1</b></span>
           <div class="entry">
-            <div class="desc">完成账单状态颜色优化，在 srf-web-user/srf-web-wx/srf-web-h5-teacher 三端统一区分待扣款/处理中/成功/失败/已取消五种状态色</div>
+            <div class="desc">完成账单状态颜色优化，在多端统一区分待扣款/处理中/成功/失败/已取消五种状态色</div>
             <div class="meta"><span class="qt">3 文件 +54 行</span> - <b>100%</b> - 用时约2H</div>
             <div class="pbar-track"><div class="pbar-sweep"><div class="pbar-comet"></div></div><div class="pbar-fill" data-w="100"></div></div>
           </div>
@@ -478,7 +478,7 @@ html.js .rv.in{ opacity:1; translate:0 0; }
         <li class="pbar-done">
           <span class="idx done"><b>3</b></span>
           <div class="entry">
-            <div class="desc">修复首页组件样式问题，调整 MyServiceMenu/PaymentZone/ServiceMenuGrid 布局适配</div>
+            <div class="desc">修复首页组件样式问题，调整菜单、支付、网格等模块布局适配</div>
             <div class="meta"><span class="qt">3 文件 +4 行</span> - <b>100%</b> - 用时约0.5H</div>
             <div class="pbar-track"><div class="pbar-sweep"><div class="pbar-comet"></div></div><div class="pbar-fill" data-w="100"></div></div>
           </div>
@@ -486,7 +486,7 @@ html.js .rv.in{ opacity:1; translate:0 0; }
         <li class="pbar-done">
           <span class="idx done"><b>4</b></span>
           <div class="entry">
-            <div class="desc">完成健康指南图片 2 列 grid 布局改造，优化 MoreServicesSection/StudentProfileCard 等首页样式</div>
+            <div class="desc">完成内容图片 2 列网格布局改造，优化更多服务入口与信息卡片等首页样式</div>
             <div class="meta"><span class="qt">4 文件 +22 行</span> - <b>100%</b> - 用时约1.5H</div>
             <div class="pbar-track"><div class="pbar-sweep"><div class="pbar-comet"></div></div><div class="pbar-fill" data-w="100"></div></div>
           </div>
@@ -571,7 +571,7 @@ html.js .rv.in{ opacity:1; translate:0 0; }
 </div>
 
 <script>
-var TXT = "今日日报 - 20261106\n\n生成时间：2026-11-06 17:30:39\n\nTL;DR：三端账单状态色统一与充值切换学生功能双线交付，四项完成；明日聚焦边界场景、暗色适配与多机型回归，风险暂无。\n\n今日任务进度\n1、完成账单状态颜色优化，在 srf-web-user/srf-web-wx/srf-web-h5-teacher 三端统一区分待扣款/处理中/成功/失败/已取消五种状态色（3 文件 +54 行）- 进度100% - 用时约2H\n2、实现充值页面切换学生与不可充值学生拦截功能，含 API 对接、组件改造及页面逻辑优化（3 文件 +94 行）- 进度100% - 用时约3H\n3、修复首页组件样式问题，调整 MyServiceMenu/PaymentZone/ServiceMenuGrid 布局适配（3 文件 +4 行）- 进度100% - 用时约0.5H\n4、完成健康指南图片 2 列 grid 布局改造，优化 MoreServicesSection/StudentProfileCard 等首页样式（4 文件 +22 行）- 进度100% - 用时约1.5H\n\n明日计划\n1、继续完善充值切换学生功能的边界场景处理与异常提示 - 进度0% - 预估用时2H\n2、推进账单状态颜色优化的暗色模式适配 - 进度0% - 预估用时2H\n3、开展首页样式优化回归测试，验证各组件在不同机型下的显示效果 - 进度0% - 预估用时2H\n\n风险阻塞点\n暂无";
+var TXT = "今日日报 - 20261106\n\n生成时间：2026-11-06 17:30:39\n\nTL;DR：多端账单状态色统一与充值切换学生功能双线交付，四项完成；明日聚焦边界场景、暗色适配与多机型回归，风险暂无。\n\n今日任务进度\n1、完成账单状态颜色优化，在多端统一区分待扣款/处理中/成功/失败/已取消五种状态色（3 文件 +54 行）- 进度100% - 用时约2H\n2、实现充值页面切换学生与不可充值学生拦截功能，含 API 对接、组件改造及页面逻辑优化（3 文件 +94 行）- 进度100% - 用时约3H\n3、修复首页组件样式问题，调整菜单、支付、网格等模块布局适配（3 文件 +4 行）- 进度100% - 用时约0.5H\n4、完成内容图片 2 列网格布局改造，优化更多服务入口与信息卡片等首页样式（4 文件 +22 行）- 进度100% - 用时约1.5H\n\n明日计划\n1、继续完善充值切换学生功能的边界场景处理与异常提示 - 进度0% - 预估用时2H\n2、推进账单状态颜色优化的暗色模式适配 - 进度0% - 预估用时2H\n3、开展首页样式优化回归测试，验证各组件在不同机型下的显示效果 - 进度0% - 预估用时2H\n\n风险阻塞点\n暂无";
 (function(){
   var btn = document.getElementById('copyBtn');
   btn.addEventListener('click', function(){

package/docs/articles/csdn-skillforge-21-skills.md

@@ -1,8 +1,12 @@
-# 还在每次从头教 AI？我把 21 种重复劳动锻造成了开箱即用的技能包
+# 别再从零教 AI：我把 21 种重复劳动，锻成了开箱即用的技能包
 
 > 项目：SkillForge（技能锻造坊） · 开源协议：MIT · 仓库：https://github.com/windfallsheng/SkillForge
 > 一句话安装：`npm i -g skill-forge-hub && skill-forge init`
 
+![Magic Deck 幻灯效果](../images/magic-deck.png)
+
+*说一句「做个 PPT」，魔法幻灯直接生成可全屏放映的 HTML 幻灯——这就是技能包的打开方式。*
+
 ## 一、一个熟悉的场景
 
 你一定经历过：让 AI 写日报，它这次三段、下次五段；让它做 PPT，封面风格全靠运气；上个月调教好的「完美提示词」，这个月翻遍聊天记录也找不回来。
@@ -13,7 +17,19 @@
 
 ## 二、21 个技能，七个车间
 
-目前工坊里锻造了 21 件技能，按「最终产出什么」分七类。
+目前工坊里锻造了 21 件技能，按「最终产出什么」分七类：
+
+```mermaid
+graph TB
+    SF[SkillForge 技能锻造坊<br/>21 件技能 · 七个车间]
+    SF --> A[报表汇演 6 件<br/>日报 / 周报 / 月报 / 季报 / 年报 / 收集台]
+    SF --> B[演示汇演 2 件<br/>magic-deck / deck-stage]
+    SF --> C[文档装裱 3 件<br/>article-to-html / twin-docs / one-pager]
+    SF --> D[沟通协作 3 件<br/>meeting-minutes / prompt-pouch / decision-log]
+    SF --> E[工程提效 3 件<br/>doc2spec / spec2doc / release-notes]
+    SF --> F[数据整备 2 件<br/>data-prepper / commit-heatmap]
+    SF --> G[技能自造 2 件<br/>meta-forge / skill-doctor]
+```
 
 ### 1. 报表汇演（6 件）——从一句话到五件套汇报
 
@@ -26,6 +42,10 @@
 
 季报带环比同比双基准，年报五段式含新年规划，团队收集台能把成员的日报收拢成按日期分组的汇总。**同一套口述习惯，打通整条汇报链。**
 
+![日报页面效果](../images/daily-report.png)
+
+*日报「今日任务进度」四格进度条与「明日计划」一眼看完——说一句「昨天的日报」，它就自己写完。*
+
 ### 2. 演示汇演（2 件）——PPT 的两副面孔
 
 - **magic-deck**：内容 → 单文件 HTML 幻灯。16:9 舞台、十六套版式模板、十七套主题、21 套领域模板，自动播放、键盘热键、全屏纯净放映；
@@ -33,18 +53,34 @@
 
 一个适合演示效果，一个适合交付修改，说「做个 PPT」它自会问你要哪种。
 
+![deck-stage 生成的 PPT 数据页](../images/deck-stage.png)
+
+*deck-stage 生成的 .pptx 数据页：数字卡、图表全部原生可编辑，交付出去还能改。*
+
 ### 3. 文档装裱（3 件）——让文档体面地走出去
 
 - **article-to-html**：Word / Markdown / 纯文本 → 精美独立 HTML（思源黑体 + Roboto 商用免费字体），图表用 HTML/CSS 矢量重绘，再逐章截出 Retina 2x 高清图；
 - **twin-docs**：中文文档翻译并同步为英文版（或反向），术语表对齐、标题层级逐项对应、双向同步检查；
 - **one-pager**：一句话想法 → 一页纸 HTML 海报。**32 套布局模板（含水墨、红金宫廷、青绿山水等国风）× 25 套配色主题 = 800 种版式**，主题坞悬停即显主题名，?shot 参数一键截 PNG。
 
+![article-to-html 装裱效果](../images/article-to-html.png)
+
+*article-to-html 把 Word 文章装裱成组件化 HTML 长文：图表矢量重绘、任意倍率锐利，四色随点随换。*
+
 ### 4. 沟通协作（3 件）——把碎片收进体系
 
 - **meeting-minutes**：口述材料 → 五段式会议纪要，行动项带负责人与截止时间——汇报链的源头，可被日报周报引用；
 - **prompt-pouch**：本地提示词管理台。分组、搜索、收藏、标签、{变量} 插值、导入导出备份，好提示词从此有了回得来的家；
 - **decision-log**：重要决策四元组日志（结论 / 取舍 / 被否方案 / 适用条件），随时检索复盘。
 
+![会议纪要页面](../images/meeting-minutes.png)
+
+*五段式会议纪要：结论 TL;DR 一句看清，行动项带负责人与截止时间，随手可被日报周报引用。*
+
+![锦囊提示词管理台](../images/prompt-pouch.png)
+
+*锦囊提示词管理台：分组、标签、收藏、{变量} 插值一应俱全，调教好的提示词从此有了回得来的家。*
+
 ### 5. 工程提效（3 件）——文档与代码之间
 
 - **spec-doc2spec**：Word/Markdown 需求文档 → 结构化需求切片（Pandoc 机械转换 + AI 校对防错）；
@@ -65,6 +101,14 @@
 
 提示词是一次性的对话；技能是**可移植的手艺**：
 
+```mermaid
+graph TB
+    subgraph 技能包三层结构
+        A[SKILL.md 薄入口<br/>AI 先读这一页] --> B[resources/ 按阶段分册<br/>执行到哪步才读哪册]
+        C[user-config.md<br/>你的个性化配置出站] -.升级永不覆盖.-> C
+    end
+```
+
 1. **宿主中立**：换一份薄薄的 frontmatter 信封，同一份技能就能从 Qoder 带去 Claude Code、Cursor——不绑定任何厂商；
 2. **配置保护**：你的个性化配置出站在 user-config.md，升级技能永不覆盖；配置结构变化时先备份再三选一；
 3. **版本感知回炉**：模板升级后说一句「把我旧日报都升级成新样式」，旧产物批量换新，旧版先备份；

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skill-forge-hub",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "description": "SkillForge (技能锻造坊) — a curated collection of AI craft skills. Install once, then pick skills interactively: daily/weekly/monthly/quarterly/annual reports, meeting minutes, article-to-HTML, magic-deck slides, deck-stage PPTX, prompt-pouch manager, Pandoc doc converters, meta-forge.",
   "bin": {
     "skill-forge": "cli.js"

package/prompt-pouch/SKILL.md

@@ -31,11 +31,13 @@ disable-model-invocation: false
 1. **初始化**（目标目录无 `prompt-pouch.html` 时）：
    - **已有页面分支**：用户说「创建/生成」但目标目录已有 prompt-pouch.html → AskUserQuestion 三选项：A 打开现有页面（推荐，数据无损）；B 覆盖重建——旧页面先复制 .bak-时间戳，仅重置页面为新版 reference.html（DATA_DIR/BACKUP_DIR 数据目录一概不动，用户数据绝不丢）；C 取消不创建。默认推荐 A
    - **目录确认**：用户未提目录 → 用配置 `DIR`；`CONFIRM: true` 时先 AskUserQuestion 确认（选项：用默认目录 / 换目录）；用户已说「放到 XX 目录」→ 直接用该目录（本次会话有效，不改配置文件）
+   - **存内容触发的初始化**：用户因「把 XX 存进锦囊」而首次创建锦囊（目标目录无页面）→ 初始化前先 AskUserQuestion 询问示例数据（选项：A 生成示例五组（推荐，页面首开有内容可看）；B 空结构——直接进整理流程只存用户本次内容），用户未回应默认 A；选定后初始化继续，随后衔接步骤 2/5 完成本次入囊
    - 复制 `resources/reference.html` → `<DIR>/prompt-pouch.html`（原样复制，不修改任何样式与脚本；仅两处例外：①html 根标签 `data-theme` 属性值设为配置 `THEME`——reference 默认 "gold"，仅当配置非 gold 时替换该属性值；②head 中 `<meta name="pouch-id" content="...">` 的 content 替换为本次用 crypto.randomUUID() 新生成的全局唯一 ID——标准 UUID v4（十六进制 8-4-4-4-12 节，禁止手写变体、禁止沿用 reference 的占位 ID REF-POUCH-0000、禁止两份锦囊共用同一 ID；复制文件副本=同一身份共享数据）；落盘写文件前顺扫 <DIR> 下已有 html 的 pouch-id meta 查重，撞号重掷至不重复）
    - 创建 `<DIR>/<DATA_DIR>/` 与 `<DIR>/<BACKUP_DIR>/` 子目录（配置为空串则跳过、平铺根目录）；生成 `<DIR>/<DATA_DIR>/prompts.json`：`INIT_DATA: example` 时写入「各职业通用」示例五组（写作输出/沟通协作/规划执行/复盘成长/提问艺术，每组 3 条，标题与正文按下方「## 默认示例数据」清单写，**每条必带 createdAt 当前时间（YYYY-MM-DD HH:mm:ss，写到时分秒）**）；`empty` 时写空结构（version + 空 groups/prompts）
    - 收尾提示启动方式：`cd <DIR> && python3 -m http.server <PORT>`（Windows 无 python3 时 `py -m http.server`），浏览器访问 `http://localhost:<PORT>/prompt-pouch.html`（HTTP 自动读 prompts.json；file:// 直开浏览器会拦截文件读取——已授权目录则刷新自动直读 data/prompts.json，权限需重新确认时点徽标「🔓 恢复数据」一键续权，读不到则回退本地快照/镜像，推荐 HTTP 打开）
 2. **维护**（页面已存在时）：读 `<DIR>/<DATA_DIR>/prompts.json` → 按用户意图修改 → 写回（UTF-8、2 空格缩进、保留 version 字段）→ 提醒用户刷新页面
    - **落盘确认**：写回前展示将要落盘的内容（新增/修改的标题、分组、正文摘要，一句话说清改了什么），等用户确认后落盘；用户明确说「直接存/不用确认」则跳过（本次会话有效）；写回前重读最新文件合并；落盘完成后对话报告产物位置：页面文件 `<DIR>/prompt-pouch.html`、数据文件 `<DIR>/<DATA_DIR>/prompts.json`、滚动备份目录 `<DIR>/<BACKUP_DIR>/`
+   - **写回前备份**：每次修改写回前先复制 `<DIR>/<DATA_DIR>/prompts.json` 为同级 `prompts.json.bak-时间戳`（破坏性操作——删除提示词/删除或改动分组/批量整理——必做；简单新增可免但建议保留）；页面自动滚动备份只在页面运行时生效，AI 直写不触发，回退保障必须由 AI 自己留档。用户说「回退/恢复锦囊数据」时：列 `<DIR>/<DATA_DIR>/` 下 `.bak-时间戳` 清单（含时间与条目数）让用户选 → 恢复前再备份当前版（双保险）→ 恢复后机器校验 schema → 提醒用户刷新
    - **分类交互**：用户说「添加 XX」但未说分组 → 先按现有分组语义智能匹配（如内容讲周报 → 建议「写作输出 ✍️」并说明理由），匹配到则默认归入、用户可改口换组；匹配不到 → AskUserQuestion 列出全部现有分组（加「新建分组」选项）让用户选；用户指定的分组不存在 → 明确告知该分组不存在，并问是否新建（新建则补 groups 条目：id 16 位数字主键（雪花规则见 data-format.md）、name 中文、icon 一个 emoji）
 2.5 **交付前自检**（初始化与每次维护落盘后必做，硬门禁不可跳过）：
    - **json 机器校验**：`python3 -c "import json;json.load(open('<DIR>/<DATA_DIR>/prompts.json',encoding='utf-8'))"`（Windows 用 py）解析通过，且 schema 自查无缺（version/groups/prompts 齐全、group 引用存在、order 连续、新增条目 createdAt 到时分秒）
@@ -68,7 +70,7 @@ disable-model-invocation: false
 
 ## 产物升级（回炉）
 
-生成/初始化页面时头部写版本戳 `<meta name="sf-template" content="prompt-pouch@10">`（模板升级时递增 @N 并同步 reference.html 与本文档）。用户说「升级旧锦囊/回炉旧页面/旧锦囊换新样式」时：扫 `<DIR>` 下 `prompt-pouch.html` 读版本戳筛出旧版（无版本戳或缺少 `<meta name="pouch-id">` 稳定 ID 的产物视为 v0 最旧版，一并进清单）→ 列清单（文件/旧版本/有无用户数据）→ AskUserQuestion 选全部或部分 → 逐份升级：浅升级（仅 CSS/JS 变化）对旧页替换 `<style>` 块与交互脚本；深升级（DOM 结构变化）从 reference.html 重建，**必须沿用原页 pouch-id meta 值**（IndexedDB 用户数据按 pouch-id 命名空间存取，换 ID = 数据失联，重建后原收藏/分组照旧读回），`<DIR>/<DATA_DIR>/prompts.json` 数据文件一概不动，先备份旧页 `.bak-时间戳` → 报告三段式：✅ 已升级清单 / ⚠️ 手改保留说明 / 🟡 失败项原因。模板改动分级：业务改动（板块/段落/标题体系）、数据格式改动（字段/存储结构）、页面改动（样式/布局/交互）任一发生即模板升级，版本戳 +1 并同步 reference.html 与本文档；纯措辞润色不 bump。每次生成/初始化新锦囊时顺扫 `<DIR>` 读版本戳：发现旧版产物主动告知「技能模板已升级至 vN，检测到 X 份旧版锦囊，说『把我旧锦囊都升级成新样式』即可一键升级」，不让用户背触发语。
+生成/初始化页面时头部写版本戳 `<meta name="sf-template" content="prompt-pouch@11">`（模板升级时递增 @N 并同步 reference.html 与本文档）。用户说「升级旧锦囊/回炉旧页面/旧锦囊换新样式」时：扫 `<DIR>` 下 `prompt-pouch.html` 读版本戳筛出旧版（无版本戳或缺少 `<meta name="pouch-id">` 稳定 ID 的产物视为 v0 最旧版，一并进清单）→ 列清单（文件/旧版本/有无用户数据）→ AskUserQuestion 选全部或部分 → 逐份升级：浅升级（仅 CSS/JS 变化）对旧页替换 `<style>` 块与交互脚本；深升级（DOM 结构变化）从 reference.html 重建，**必须沿用原页 pouch-id meta 值**（IndexedDB 用户数据按 pouch-id 命名空间存取，换 ID = 数据失联，重建后原收藏/分组照旧读回），`<DIR>/<DATA_DIR>/prompts.json` 数据文件一概不动，先备份旧页 `.bak-时间戳` → 报告三段式：✅ 已升级清单 / ⚠️ 手改保留说明 / 🟡 失败项原因。模板改动分级：业务改动（板块/段落/标题体系）、数据格式改动（字段/存储结构）、页面改动（样式/布局/交互）任一发生即模板升级，版本戳 +1 并同步 reference.html 与本文档；纯措辞润色不 bump。每次生成/初始化新锦囊时顺扫 `<DIR>` 读版本戳：发现旧版产物主动告知「技能模板已升级至 vN，检测到 X 份旧版锦囊，说『把我旧锦囊都升级成新样式』即可一键升级」，不让用户背触发语。
 
 ## ⚙️ 配置与自定义主题
 

package/prompt-pouch/resources/reference.html

@@ -3,7 +3,7 @@
 <head>
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
-<meta name="sf-template" content="prompt-pouch@10">
+<meta name="sf-template" content="prompt-pouch@11">
 <meta name="pouch-id" content="REF-POUCH-0000">
 <title>锦囊 Prompt Pouch — 提示词管理台</title>
 <style>
@@ -852,15 +852,23 @@ footer.open .ht-arrow{ transform:rotate(180deg); }
         <div class="hp-d">页面点 <b>「＋ 新增提示词」/「👁 详情」/「✎」/「🗑」</b>（授权目录即写即存），或对 AI 说 <b>「把 XX 加到锦囊的写作输出分组」</b>，AI 写入 data/prompts.json，刷新即见。</div>
       </div>
       <div class="hp-item">
-        <div class="hp-t">② 排序与移动</div>
+        <div class="hp-t">② 对话整理入囊</div>
+        <div class="hp-d">对 AI 说 <b>「把上一轮对话存进锦囊」「把最近几轮对话整理进锦囊」</b>——AI 提炼条目并智能打标、给 {变量} 泛化建议，确认条目后再推荐分组（装不下的建议新建），两段确认一次性入囊；还没锦囊时会先引导创建。</div>
+      </div>
+      <div class="hp-item">
+        <div class="hp-t">③ 排序与移动</div>
         <div class="hp-d">默认最新添加在前，可切「最近使用 / 使用频率 / 手动顺序」；拖动卡片或点 ▲▼ 自动切回手动、点 ⇄ 移到其它分组，点 <b>📋 复制变更指令</b> 交给 AI 落盘。</div>
       </div>
       <div class="hp-item">
-        <div class="hp-t">③ 打开方式</div>
+        <div class="hp-t">④ 删除与回退</div>
+        <div class="hp-d">页面点 🗑 删除弹统一确认框防误触（分组内有条目需先移出或删）；对 AI 说删同样先确认——AI 落盘前留 <b>prompts.json.bak-时间戳</b> 备份，说 <b>「回退/恢复锦囊数据」</b> 选档回滚。</div>
+      </div>
+      <div class="hp-item">
+        <div class="hp-t">⑤ 打开方式</div>
         <div class="hp-d">HTTP 访问读 data/prompts.json；file:// 直开则回退到本地缓存快照。</div>
       </div>
       <div class="hp-item">
-        <div class="hp-t">④ 数据安全</div>
+        <div class="hp-t">⑥ 数据安全</div>
         <div class="hp-d">收藏与排序存浏览器本地（IndexedDB）刷新不丢；每次变更 2 秒内自动备份到 backup/pouch-backup.json（滚动双备份），未授权时降级本地快照（保留 5 份）；<b>「📂 换目录」</b> 可随时重配，↩ 一键恢复。</div>
       </div>
     </div>
@@ -1033,7 +1041,7 @@ footer.open .ht-arrow{ transform:rotate(180deg); }
       html += '<div class="nav-item' + (state.curGroup===g.id?' on':'') + '" data-g="' + g.id + '" draggable="true" title="拖拽调整分组顺序"><span class="icon">' + g.icon + '</span><span class="g-name">' + escapeHtml(g.name) + '</span><span class="cnt">' + n + '</span><span class="g-ops"><button class="g-edit" title="编辑分组">✎</button><button class="g-del" title="删除分组">🗑</button></span></div>';
     });
     html += '</div>';
-    html += '<div class="side-tip"><b>锦囊用法</b><br>· 页面直接增删改：＋ 新建分组 / ＋ 新增提示词 / ✎ 编辑 / 🗑 删除（授权目录即写即存）<br>· 也可对 AI 说「把 XX 加到写作输出分组」<br>· 顶栏切换排序；⇄ 移组、拖卡片排序自动保存；拖分组条调整分组顺序<br>· 点卡片标签按标签筛选（再点取消）；标签悬停 ✕ 删 / ＋ 加；⤓ 导出 / ⤒ 导入 JSON 备份<br>· ⭐ 收藏常用 · 复制次数在卡片右上角</div>';
+    html += '<div class="side-tip"><b>锦囊用法</b><br>· 页面直接增删改：＋ 新建分组 / ＋ 新增提示词 / ✎ 编辑 / 🗑 删除（授权目录即写即存）<br>· 对 AI 说「把刚才这轮对话存进锦囊」——提炼条目、推荐分组，确认后入囊；也可说「把 XX 加到写作输出分组」<br>· 顶栏切换排序；⇄ 移组、拖卡片排序自动保存；拖分组条调整分组顺序<br>· 点卡片标签按标签筛选（再点取消）；标签悬停 ✕ 删 / ＋ 加；⤓ 导出 / ⤒ 导入 JSON 备份<br>· 删错对 AI 说「回退/恢复锦囊数据」选档回滚<br>· ⭐ 收藏常用 · 复制次数在卡片右上角</div>';
     sideNav.innerHTML = html;
     sideNav.querySelectorAll('.nav-item').forEach(function(el){
       el.addEventListener('click', function(){

package/prompt-pouch/resources/usage-guide.md

@@ -15,11 +15,18 @@
 9. **分组排序**：左侧分组条可直接拖拽调整顺序（已授权目录即写即存，未授权时指令自动复制给 AI 落盘）
 10. **导入 / 导出**：顶栏「⤓ 导出」把当前全部数据下载为 JSON 备份文件（文件名带时间戳）；「⤒ 导入」选择 JSON 文件整库覆盖现有数据（导入前自动备份，可从「↩ 恢复」回滚；未授权目录时导出仍可用、导入需先授权）
 
+## 典型使用场景
+
+- **对话沉淀**：对 AI 说「把上一轮对话存进锦囊」「把最近几轮对话整理进锦囊」「把最近一小时聊的内容存进锦囊」——AI 先把对话提炼成条目清单（标题/正文/智能标签/插值泛化建议），你确认条目后再按现有分组推荐归类（装不下的推荐新建分组），确认后一次性入囊
+- **从零开始**：还没创建锦囊时直接说「把 XX 存进锦囊」——AI 会先确认目录并引导创建页面（可选示例数据），随后无缝衔接入囊流程
+- **对话删除与回退**：对 AI 说「删掉锦囊里 XX 分组 / XX 这条」——先确认、落盘前自动留 `prompts.json.bak-时间戳` 备份；删错说「回退/恢复锦囊数据」，列出备份档供选档恢复（恢复前再备份当前版，双保险）
+- **换电脑迁移**：旧机「⤓ 导出」JSON 文件 → 新机「⤒ 导入」整库恢复（含分组与标签）；收藏、排序等页面本地态存浏览器本地（随页面 pouch-id 身份），不随 JSON 迁移
+
 ## 特色功能
 
 - **搜索高亮**：搜索框输入关键词，命中卡片的标题/正文/标签中匹配词以主题色徽标高亮（五主题自适应）；命中落在正文三行折叠区之外时，卡片顶部提示「正文命中，详见详情」，点开详情弹窗全文同样高亮
 - **{变量} 插值**：内容含花括号占位（如「{功能名}」）的提示词，点复制会自动弹出填充面板，填入变量后实时预览再复制
-- **自动备份（默认开启）**：数据一有变更 2 秒内自动备份——首次变更会请求授权写入 prompt-pouch.html 所在目录（弹窗选同目录即可，选一次后浏览器记住），写 backup/pouch-backup.json 并滚动保留上一版 .prev.json；未授权或浏览器不支持时自动降级为本地快照（浏览器内保留最近 5 份），页内「↩ 恢复」均可一键回滚；顶栏「📂 换目录」可随时重新配置备份目录
+- **自动备份（默认开启）**：数据一有变更 2 秒内自动备份——首次变更会请求授权写入 prompt-pouch.html 所在目录（弹窗选同目录即可，选一次后浏览器记住），写 backup/pouch-backup.json 并滚动保留上一版 .prev.json；未授权或浏览器不支持时自动降级为本地快照（浏览器内保留最近 5 份），页内「↩ 恢复」均可一键回滚；顶栏「📂 换目录」可随时重新配置备份目录；AI 代笔修改（对话中说增删改）落盘前也会在 data/ 目录留 `prompts.json.bak-时间戳`，说「回退/恢复锦囊数据」即可选档回滚
 - **统一确认弹框**：删除提示词/分组、覆盖导入、恢复备份、授权与换备份目录等需要确认的操作，都用页内统一样式的确认弹框（不再弹浏览器原生对话框）；删除/覆盖/恢复等危险操作为红调按钮，Esc 或点遮罩均可取消
 - **详情弹窗**：点卡片「👁 详情」弹出全文查看（超长内容限高 52vh 内滚动），带复制与修改入口，附时间线（创建 / 上次修改 / 最近使用）；含 {变量} 的模板会在弹窗里标出变量清单，复制时自动进入填充面板
 - **页面直写（双笔）**：页面增删改直接写入 data/prompts.json（与自动备份共用同一目录授权）；未授权时自动降级——生成操作指令复制到剪贴板，粘贴给 AI 落盘

package/weekly-report/resources/reference.html

@@ -549,7 +549,7 @@ html.js .rv.in{ opacity:1; translate:0 0; }
     <span class="header-badge">生成时间 2026-11-06 14:57:02</span>
     <div class="summary-line">
       <span class="summary-tag">TL;DR</span>
-      <span class="summary-text">本周 11 次提交覆盖客户端/服务端/网关三端，周三单日 8 次提交集中交付直播、礼物、登录、互动等多线功能；底部导航两轮修复后随 v1.2.2 收口。整体节奏紧凑、无阻塞风险，下周可聚焦配送链路打磨与直播体验优化。</span>
+      <span class="summary-text">本周 11 次提交覆盖客户端、服务端与网关等模块，周三单日 8 次提交集中交付直播、礼物、登录、互动等多线功能；底部导航两轮修复后随 v1.2.2 收口。整体节奏紧凑、无阻塞风险，下周可聚焦配送链路打磨与直播体验优化。</span>
     </div>
     <div class="copy-wrap">
       <button class="copy-btn" id="copyBtn" type="button">
@@ -658,7 +658,7 @@ html.js .rv.in{ opacity:1; translate:0 0; }
         <li class="pbar-done">
           <span class="idx done"><b>2</b></span>
           <div class="entry">
-            <div class="desc">完成订单配送能力深化：客户端配送费预估与骑手状态展示，服务端 DISPATCHING 状态机与骑手通道抽象</div>
+            <div class="desc">完成订单配送能力深化：客户端配送费预估与骑手状态展示，服务端配送状态机与骑手通道抽象</div>
             <div class="meta"><span class="qt">2 次提交、15 文件、+507/-35 行</span> - <b>100%</b> - 用时约1.5D</div>
             <div class="pbar-track"><div class="pbar-sweep"><div class="pbar-comet"></div></div><div class="pbar-fill" data-w="100"></div></div>
           </div>
@@ -666,7 +666,7 @@ html.js .rv.in{ opacity:1; translate:0 0; }
         <li class="pbar-done">
           <span class="idx done"><b>3</b></span>
           <div class="entry">
-            <div class="desc">完成对外号正名为产品级主账号邻音号，我的页/账号中心/联系人/群聊全面去内部术语</div>
+            <div class="desc">完成对外称呼正名为产品级主账号，我的页/账号中心/联系人/群聊全面去内部术语</div>
             <div class="meta"><span class="qt">1 次提交、4 文件、+25/-25 行</span> - <b>100%</b> - 用时约0.5D</div>
             <div class="pbar-track"><div class="pbar-sweep"><div class="pbar-comet"></div></div><div class="pbar-fill" data-w="100"></div></div>
           </div>
@@ -674,7 +674,7 @@ html.js .rv.in{ opacity:1; translate:0 0; }
         <li class="pbar-done">
           <span class="idx done"><b>4</b></span>
           <div class="entry">
-            <div class="desc">完成萤火虚拟币礼物体系：钱包/充值/16 款四档礼物/原子扣款与 43001 拦截、WS 房间广播、模拟观众自动送礼</div>
+            <div class="desc">完成平台虚拟币礼物体系：钱包/充值/16 款四档礼物/原子扣款与 余额不足拦截、实时房间广播、模拟观众自动送礼</div>
             <div class="meta"><span class="qt">1 次提交、22 文件、+1246/-3 行</span> - <b>100%</b> - 用时约1D</div>
             <div class="pbar-track"><div class="pbar-sweep"><div class="pbar-comet"></div></div><div class="pbar-fill" data-w="100"></div></div>
           </div>
@@ -690,7 +690,7 @@ html.js .rv.in{ opacity:1; translate:0 0; }
         <li class="pbar-done">
           <span class="idx done"><b>6</b></span>
           <div class="entry">
-            <div class="desc">完成登录安全加固与三方登录：短信验证码（回显+限流+签名）、微信/支付宝绑定、换绑手机号、APK 版本门禁</div>
+            <div class="desc">完成登录安全加固与三方登录：短信验证码（回显+限流+签名）、支付渠道绑定、换绑手机号、应用安装包版本门禁</div>
             <div class="meta"><span class="qt">1 次提交、42 文件、+1792/-87 行</span> - <b>100%</b> - 用时约1.5D</div>
             <div class="pbar-track"><div class="pbar-sweep"><div class="pbar-comet"></div></div><div class="pbar-fill" data-w="100"></div></div>
           </div>
@@ -698,7 +698,7 @@ html.js .rv.in{ opacity:1; translate:0 0; }
         <li class="pbar-done">
           <span class="idx done"><b>7</b></span>
           <div class="entry">
-            <div class="desc">完成网关 V2 二进制帧协议升级：Protobuf 上下行帧、JWT 握手鉴权与 HMAC 签名、房间索引、wsprobe 冒烟探针</div>
+            <div class="desc">完成网关 V2 二进制帧协议升级：Protobuf 上下行帧、JWT 握手鉴权与 HMAC 签名、房间索引、连接冒烟探针</div>
             <div class="meta"><span class="qt">1 次提交、10 文件、+1552/-59 行</span> - <b>100%</b> - 用时约1D</div>
             <div class="pbar-track"><div class="pbar-sweep"><div class="pbar-comet"></div></div><div class="pbar-fill" data-w="100"></div></div>
           </div>
@@ -706,7 +706,7 @@ html.js .rv.in{ opacity:1; translate:0 0; }
         <li class="pbar-done">
           <span class="idx done"><b>8</b></span>
           <div class="entry">
-            <div class="desc">完成多线功能收束：直播推流与观众端、验证码/三方登录页、短视频录制播放、收藏互动、更新自检、SSL pinning</div>
+            <div class="desc">完成多线功能收束：直播推流与观看体验、验证码/三方登录页、短视频录制播放、收藏互动、更新自检、SSL pinning</div>
             <div class="meta"><span class="qt">1 次提交、72 文件、+11.1k/-2.1k 行</span> - <b>100%</b> - 用时约2D</div>
             <div class="pbar-track"><div class="pbar-sweep"><div class="pbar-comet"></div></div><div class="pbar-fill" data-w="100"></div></div>
           </div>
@@ -770,7 +770,7 @@ html.js .rv.in{ opacity:1; translate:0 0; }
 <script src="https://cdn.jsdelivr.net/npm/echarts@5.5.1/dist/echarts.min.js"></script>
 <script>
 // 复制纯文本
-var TXT = "本周周报 - 20261102 ~ 20261106\n\n生成时间：2026-11-06 14:57:02\n\nTL;DR：本周 11 次提交覆盖客户端/服务端/网关三端，周三单日 8 次提交集中交付直播、礼物、登录、互动等多线功能；底部导航两轮修复后随 v1.2.2 收口。整体节奏紧凑、无阻塞风险，下周可聚焦配送链路打磨与直播体验优化。\n\n本周结论\n1、最重要的结果：八项功能全部交付并随 v1.2.2 收口，底部导航顽疾两轮修复后根治\n2、值得处理的变化：多端并行交付节奏加速，需求拆解粒度偏粗、联调集中在周三单日\n3、下周优先的动作：聚焦配送链路打磨与直播体验优化，联调前移、避免单日集中交付\n\n本周任务进度\n1、完成底部导航仿参考图重绘：白栏穹顶拱形与发布按钮凸出，两轮修复根治白条与三角缺口，并发布 v1.2.2（3 次提交、23 文件、+1741/-178 行）- 进度100% - 用时约1.5D\n2、完成订单配送能力深化：客户端配送费预估与骑手状态展示，服务端 DISPATCHING 状态机与骑手通道抽象（2 次提交、15 文件、+507/-35 行）- 进度100% - 用时约1.5D\n3、完成对外号正名为产品级主账号邻音号，我的页/账号中心/联系人/群聊全面去内部术语（1 次提交、4 文件、+25/-25 行）- 进度100% - 用时约0.5D\n4、完成萤火虚拟币礼物体系：钱包/充值/16 款四档礼物/原子扣款与 43001 拦截、WS 房间广播、模拟观众自动送礼（1 次提交、22 文件、+1246/-3 行）- 进度100% - 用时约1D\n5、完成帖子互动闭环与媒体上传：评论/点赞/收藏/分享四实体与互动快照、30MB 短视频上传接口（1 次提交、22 文件、+1311/-31 行）- 进度100% - 用时约1D\n6、完成登录安全加固与三方登录：短信验证码（回显+限流+签名）、微信/支付宝绑定、换绑手机号、APK 版本门禁（1 次提交、42 文件、+1792/-87 行）- 进度100% - 用时约1.5D\n7、完成网关 V2 二进制帧协议升级：Protobuf 上下行帧、JWT 握手鉴权与 HMAC 签名、房间索引、wsprobe 冒烟探针（1 次提交、10 文件、+1552/-59 行）- 进度100% - 用时约1D\n8、完成多线功能收束：直播推流与观众端、验证码/三方登录页、短视频录制播放、收藏互动、更新自检、SSL pinning（1 次提交、72 文件、+11.1k/-2.1k 行）- 进度100% - 用时约2D\n\n下周计划\n暂无\n\n风险阻塞点\n暂无";
+var TXT = "本周周报 - 20261102 ~ 20261106\n\n生成时间：2026-11-06 14:57:02\n\nTL;DR：本周 11 次提交覆盖客户端、服务端与网关等模块，周三单日 8 次提交集中交付直播、礼物、登录、互动等多线功能；底部导航两轮修复后随 v1.2.2 收口。整体节奏紧凑、无阻塞风险，下周可聚焦配送链路打磨与直播体验优化。\n\n本周结论\n1、最重要的结果：八项功能全部交付并随 v1.2.2 收口，底部导航顽疾两轮修复后根治\n2、值得处理的变化：多端并行交付节奏加速，需求拆解粒度偏粗、联调集中在周三单日\n3、下周优先的动作：聚焦配送链路打磨与直播体验优化，联调前移、避免单日集中交付\n\n本周任务进度\n1、完成底部导航仿参考图重绘：白栏穹顶拱形与发布按钮凸出，两轮修复根治白条与三角缺口，并发布 v1.2.2（3 次提交、23 文件、+1741/-178 行）- 进度100% - 用时约1.5D\n2、完成订单配送能力深化：客户端配送费预估与骑手状态展示，服务端配送状态机与骑手通道抽象（2 次提交、15 文件、+507/-35 行）- 进度100% - 用时约1.5D\n3、完成对外称呼正名为产品级主账号，我的页/账号中心/联系人/群聊全面去内部术语（1 次提交、4 文件、+25/-25 行）- 进度100% - 用时约0.5D\n4、完成平台虚拟币礼物体系：钱包/充值/16 款四档礼物/原子扣款与 余额不足拦截、实时房间广播、模拟观众自动送礼（1 次提交、22 文件、+1246/-3 行）- 进度100% - 用时约1D\n5、完成帖子互动闭环与媒体上传：评论/点赞/收藏/分享四实体与互动快照、30MB 短视频上传接口（1 次提交、22 文件、+1311/-31 行）- 进度100% - 用时约1D\n6、完成登录安全加固与三方登录：短信验证码（回显+限流+签名）、支付渠道绑定、换绑手机号、应用安装包版本门禁（1 次提交、42 文件、+1792/-87 行）- 进度100% - 用时约1.5D\n7、完成网关 V2 二进制帧协议升级：Protobuf 上下行帧、JWT 握手鉴权与 HMAC 签名、房间索引、连接冒烟探针（1 次提交、10 文件、+1552/-59 行）- 进度100% - 用时约1D\n8、完成多线功能收束：直播推流与观看体验、验证码/三方登录页、短视频录制播放、收藏互动、更新自检、SSL pinning（1 次提交、72 文件、+11.1k/-2.1k 行）- 进度100% - 用时约2D\n\n下周计划\n暂无\n\n风险阻塞点\n暂无";
 (function(){
   var btn = document.getElementById('copyBtn');
   btn.addEventListener('click', function(){