@topmindspace/topmind-skills 4.14.0 → 4.15.1

package/evals/evals.json

@@ -1,7 +1,7 @@
 {
   "skill_name": "topmind",
   "daily_entry": "topmind",
-  "version": "4.14.0",
+  "version": "4.15.1",
   "evals": [
     {
       "id": 1,
@@ -252,6 +252,29 @@
       "primary_skill": "topmind-organize",
       "extra_skills": [],
       "expected_output": "Organize 整理本周 on the activity window: tidies the period note in place, then L1-suggests todo maintain diff (add/complete/update vs memory/todo.md) and optional memory/topic candidates per shared/auto-suggest.md. User accepts before writing todo/memory changes. No auto memory writes, no INDEX.md."
+    },
+    {
+      "id": 35,
+      "prompt": "对比一下 Claude 和 Gemini 最新发布的技术报告，要带一手来源。",
+      "primary_skill": "topmind",
+      "extra_skills": [
+        "topmind-organize"
+      ],
+      "expected_output": "Router applies the 研究 / 分析 / 对比 row in shared/trigger-disambiguation.md: the request needs external primary sources, so it hands off to the optional external skill topmind-research (analyze) when installed. When topmind-research is not installed, falls back to topmind-organize 研究分析 and states in the receipt that only workspace materials and host search were used. Output lands in a topic or Inbox per shared/writeback-receipt.md with source_type: ai-derived. No auto memory writes, no auto chaining to briefs or write."
+    },
+    {
+      "id": 36,
+      "prompt": "对比一下 20-研究/2026-示例研究 专题里已经存的几篇笔记的观点。",
+      "primary_skill": "topmind-organize",
+      "extra_skills": [],
+      "expected_output": "Routes through topmind-organize 研究分析 because the objects are notes already saved in the workspace; does not hand off to topmind-research even if it is installed. Builds a comparison table with provenance, writes the synthesis to a topic-root note per writeback_mode (leave-a-trace), and only L1-suggests memory candidates."
+    },
+    {
+      "id": 37,
+      "prompt": "这周 AI 大厂有什么新的官方动态？顺便看看社区怎么评价。",
+      "primary_skill": "topmind",
+      "extra_skills": [],
+      "expected_output": "Router splits into ordered steps per shared/trigger-disambiguation.md: official announcements, technical reports and papers → optional external topmind-research (collect); community discussion → optional external last30days. Does not route to topmind-organize 整理本周 (that phrase means the workspace stream category) and does not use TopStream每日精选 unless the user asks for the daily digest. Any skill that is not installed falls back to topmind-organize on saved workspace materials, and the receipt says so. Each step returns its own receipt; no auto chaining."
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@topmindspace/topmind-skills",
-  "version": "4.14.0",
+  "version": "4.15.1",
   "description": "topmind Agent Skills pack — portable markdown skills for capture, organize, write, memory, maintain, loop.",
   "type": "module",
   "license": "MIT",

package/shared/auto-suggest.md

@@ -65,8 +65,10 @@ Host 能力映射：
 | 能力 | Desktop | UTR | 纯 Host Agent |
 |------|---------|-----|---------------|
 | 提取 | `add_todo` · `todo_maintain` | `memory.add-todo` | 读活动窗口 → 识别行动语 → 写 checklist |
-| 维护 | `toggle_todo` · `maintainTodos` | `memory.toggle-todo` | 对照周期本与 todo.md 做 diff 建议 |
+| 维护 | `toggle_todo` · `update_todo` · `set_todo_due` · `delete_todo` · `maintainTodos` | `memory.toggle-todo` | 对照周期本与 todo.md 做 diff 建议 |
 | 列表 | `list_todos` · Todo 面板 | `memory.list-todos` | 读 `memory/todo.md` 活跃段 |
+| 动态查询 | `list_recent_stream` | `workspace-read.list-recent-captures` | 读最近周期本日段 |
+| 记忆查询 | `list_recent_memories` | `memory.list-profile` 等 | 读 `memory/` 活跃段（勿整库倾倒） |
 | 分类/专题建议 | `topic_classify`（确认后 `create_topic`） | 文件工具 + role 路由 | 按 role + 内容性质给最多 3 候选 |
 | 记忆建议 | `memory_organize`（append/update/retire 建议） | `memory.append-profile` 等（确认后） | 识别稳定事实 → L1 候选 |
 

package/shared/long-url-capture.md

@@ -74,6 +74,9 @@ word_count: 1200
 - URL 类型提示（GitHub README / GitHub 原文 / X / 网页）  
 - Inbox：按 `source_type` 筛选「网页/摘录」  
 - AI `fetch_url` 支持 `maxLen` + `render`；Obsidian `fetch_url` 对 GitHub md 自动走 raw  
+- AI `capture_url`：一键抓取并入库（带 source URL + 标题）；Desktop 与 Obsidian 对齐（`forceInbox` / `forceAtom`）  
+- AI `web_search`：无需 Key 的网络搜索短列表（域名打分 + 同域去重）；命中后 `fetch_url` / `capture_url`  
+- 工具失败会返回**一条**具体恢复步骤（如 edit 失败 → 先 read_file 刷 contentHash）
 
 ## 不要做的事
 

package/shared/trigger-disambiguation.md

@@ -1,7 +1,8 @@
 # Trigger Disambiguation（路由消歧真源）
 
 > Router（`topmind`）与各子 skill 的「When NOT」必须与本表一致。  
-> 子 skill **不得**自动链式 dispatch 下一 skill；「下一步」仅用户面建议。
+> 子 skill **不得**自动链式 dispatch 下一 skill；「下一步」仅用户面建议。  
+> 外部可选技能（`topmind-research`、`topmind-briefs`、`last30days`、`TopStream每日精选`）不随本包发布：仅在宿主已安装时按表路由；未安装按该行写明的回退处理，回执可提示可选安装，不报错。
 
 ## 碰撞词裁决
 
@@ -9,6 +10,8 @@
 |--------|--------------|------|
 | 总结要点 | organize vs memory | 默认 → `topmind-organize`。仅「更新我的情况 / 加到专题记忆 / 沉淀到记忆」→ memory |
 | 沉淀 | capture vs memory | 默认 → `topmind-capture`。仅「沉淀成稳定结论 / 更新我的情况」→ memory |
+| **记一下 / Note it** | capture 主入口 | **完整捕获**（笔记 / 链接 / 附件）→ `topmind-capture` |
+| **记下 / Log it** | capture（追加） | **写入当前周期本**（动态追加，同文件续写）→ `topmind-capture`，默认平铺到当前周期；不弹分类访谈 |
 | 记一下要做 X / 别忘了 X | capture vs todo | → `topmind-capture`（材料落盘）+ 待办写入/建议 `memory/todo.md`（见 `auto-suggest.md`） |
 | 待办 / 有什么要做的 | router 直达 | 读 `memory/todo.md` 活跃项；不新建概念、不进 organize |
 | X 做完了 / 这条不用了 | todo vs organize | 清单项 → 勾掉/归档 `memory/todo.md`；整周事项状态 → organize「整理本周」 |
@@ -19,6 +22,9 @@
 | 归档 | capture vs maintain | 「归档材料」→ capture。「归档专题 / archive topic」→ maintain |
 | 笔记 / note | capture vs write | 未限定 → capture。「写作 / 起草 / 续写」→ write |
 | 记账 / 记一笔 / 花了 / 存入 | ledger vs capture | 「记账 / 记一笔 / 花了 / 存入 / 查看账单 / 账户余额」→ `topmind-ledger`（记忆平面账本）。「记一下」仍 → capture |
+| 研究 / 分析 / 对比 | organize vs topmind-research（外部可选） | 对象是工作区里已存的笔记、专题内材料 → `topmind-organize`。需要对外检索一手资料（论文、技术报告、官方公告、模型或产品横向对比）、AI 前沿深挖 → `topmind-research`（analyze）；未安装 → `topmind-organize`「研究分析」 |
+| AI 动态 / 大厂动态 / AI 周报 / 最近有什么新的 | topmind-research vs last30days vs TopStream每日精选（均外部可选） | 官方公告、技术报告、论文的周度汇总 → `topmind-research`（collect）。社区讨论与口碑（X、Reddit、HN 等）→ `last30days`。每日精选例行 → `TopStream每日精选`。对应技能未安装 → `topmind-organize`（只用工作区已存材料，回执注明）。「整理本周 / 理顺本周动态」指工作区动态类别，仍 → organize「整理本周」 |
+| 读论文 / 论文解读 | topmind-research vs topmind-briefs（均外部可选） | 想弄懂内容、要带来源的研究报告 → `topmind-research`（analyze）；未安装 → `topmind-organize`「研究分析」。要直接出一篇短稿发布 → `topmind-briefs`（可附 research 产出的已核验事实表）；未安装 → `topmind-write` |
 | 公众号 / 微信排版 | wechat vs write | 「公众号 / 微信排版 / 公众号定稿 / 发公众号」→ `topmind-wechat`。通用「写一篇」仍 → `topmind-write` |
 
 **原则**：动作动词定 action；修饰词定 confidence。无法判定 → capture（先存后整）。
@@ -34,6 +40,7 @@
 | write | 稿件 / delivery | 为「补结构」空建 `topic.md` |
 | loop | 状态 / 可逆修复 | 代写记忆；建硬索引 |
 | ledger | `{memory.dir}/ledgers/` 追加一行 | 改 `topic.md`；发明 ClassFund/Giggs/Mom；当第六用户概念 |
+| topmind-research（外部可选） | 研究报告、周报、已核验事实表，按 `writeback-receipt.md` 落专题或 Inbox（frontmatter `source_type: ai-derived`） | 自动写记忆；自动改它自带的 `config/sources.yaml`；未经用户点名自动深挖；自动链式 briefs / write |
 
 ## 多意图顺序
 
@@ -44,6 +51,8 @@
 | organize + write | 先 organize（落盘综合），再 write |
 | organize + memory | 先 organize 候选与综合笔记，**用户接受建议后再** memory |
 | write + memory | 先 write，回执建议 memory |
+| research + write | 先 research 出报告与事实表，回执建议 briefs / write（不自动链式） |
+| research + memory | 先 research 落盘，回执建议 memory（须用户再确认才写） |
 | 整理 inbox | organize + plan-inbox-routing（不是 maintain/loop） |
 | 清理工作区 | maintain |
 

package/topmind/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: topmind
-version: 4.14.0
+version: 4.15.1
 description: >-
   topmind 总入口与多意图路由（类别/专题/笔记/待办/交付）。Use when 用户说 topmind、意图模糊、
   待办/有什么要做的/todo list、或需要收→整→写 分步。单意图明确时直接用 topmind-capture|organize|write|memory|maintain|loop|weread|x|ledger|wechat。
@@ -23,7 +23,7 @@ compatibility: >-
 author: TopMindSpace
 license: MIT
 homepage: https://github.com/topmindspace/topmind
-updated: 2026-09-28
+updated: 2026-10-08
 degradation: ../shared/capability-degradation.md
 ---
 
@@ -51,7 +51,8 @@ degradation: ../shared/capability-degradation.md
 待办 / 有什么要做的/todo → 本 router           → 读 memory/todo.md 活跃项（卫星，非新概念）
 X 做完了 / 这条不用了    → 本 router           → 勾掉/归档对应待办（可恢复）
 整理本周/理顺流水        → topmind-organize    → 活动窗口就地理顺 + 建议（确认后写）
-整理/分析/研究/总结/对比 → topmind-organize    → 当前专题 / Inbox 路由 / 活动窗口
+整理/分析/研究/总结/对比 → topmind-organize    → 当前专题 / Inbox 路由 / 活动窗口（对象是已存材料）
+对外检索/论文/AI 动态    → topmind-research*   → 专题 / Inbox（*外部可选；未装 → organize）
 写/改/稿/交付/导出       → topmind-write       → delivery 或专题根
 公众号/微信排版/定稿发稿  → topmind-wechat      → 创作类 YYYY-公众号/ 交付包
 记住我/更新我的情况      → topmind-memory      → memory/profile.md（主 memory）
@@ -69,7 +70,7 @@ loop/整体体检/巡检       → topmind-loop        → .topmind/loop/ 可恢
 
 待办是 `memory/todo.md` **卫星**（与 profile 同层），不是第六概念。提取/维护语义见 [`../shared/auto-suggest.md`](../shared/auto-suggest.md)。
 
-English: capture → capture · weekly review/organize (activity window) → organize · write → write · about me → memory/profile · period reflection → memory/periodic/{YYYY}/ · new topic folder → organize (content category) · doctor → maintain · loop → loop · bookkeeping/spent/deposited → ledger (`memory/ledgers/`, personal default).
+English: capture → capture · weekly review/organize (activity window) → organize · write → write · about me → memory/profile · period reflection → memory/periodic/{YYYY}/ · new topic folder → organize (content category) · doctor → maintain · loop → loop · bookkeeping/spent/deposited → ledger (`memory/ledgers/`, personal default) · external primary-source research / papers / official AI news → optional external `topmind-research` when installed, else organize.
 
 读配置：`stream.packing`（默认 weekly）· `stream.year_dir`（默认 true）· `memory.layers.global.file`（`profile.md`）。  
 **活动窗口**（Desktop/Kernel 与 organize 共用）：近期周期本 ∪ 近期改动笔记 ∪ 增补锚定的原文——不只「最新周期文件名」。
@@ -125,6 +126,7 @@ Which category? Which topic (or loose note)? Which object? Which action? Which s
 
 真源：[`../shared/trigger-disambiguation.md`](../shared/trigger-disambiguation.md)。  
 多意图：[`references/multi-intent.md`](references/multi-intent.md)。  
+外部可选技能（`topmind-research` 等）：不随本包发布，已安装才路由，未安装按真源表回退；不是第二前台。  
 Connector：[`references/connector-resolution.md`](references/connector-resolution.md)。
 
 ## Sub-Skill Receipt Chaining
@@ -139,7 +141,7 @@ Connector：[`references/connector-resolution.md`](references/connector-resoluti
 主路径：host 文件工具 + project-model-brief。Skills pack **不依赖** Pi / `pi-agent-core`；不要编造 bash / shell。宿主若有唯一片段替换，中段改稿优先用它。  
 降级：[`../shared/capability-degradation.md`](../shared/capability-degradation.md)。
 
-UTR 可选（MCP primary+danger 共 26；注册表 35 = 8 域 / 35 命令，见 TOOLS.md）：`list-categories` · `list-topics` · `inspect-topic` · `list-topic-files` · `list-inbox` · `create-topic` · `capture-note` · `save-output` · `contract.validate` · `contract.reseed` · `memory.promote` · `memory.digest` · `memory.append-profile` · `memory.append-topic` · `memory.retire-profile` · `memory.update-profile` · `memory.compact-history` · `memory.restore-profile` · `memory.list-todos` · `memory.add-todo` · `memory.toggle-todo` · `doctor-workspace` · `plan-inbox-routing` · `archive-topic` · `archive-stream-year` · `restore-safety-receipt`。
+UTR 可选（MCP primary+danger 共 29；注册表 38 = 8 域 / 38 命令，见 TOOLS.md）：`list-categories` · `list-topics` · `inspect-topic` · `list-topic-files` · `list-inbox` · `create-topic` · `capture-note` · `save-output` · `contract.validate` · `contract.reseed` · `memory.promote` · `memory.digest` · `memory.append-profile` · `memory.append-topic` · `memory.retire-profile` · `memory.update-profile` · `memory.compact-history` · `memory.restore-profile` · `memory.list-todos` · `memory.add-todo` · `memory.toggle-todo` · `memory.update-todo` · `memory.set-todo-due` · `memory.delete-todo` · `doctor-workspace` · `plan-inbox-routing` · `archive-topic` · `archive-stream-year` · `restore-safety-receipt`。
 
 字段始终独立 **`category` + `topic`**（真实目录名，非写死编号）。
 

package/topmind/references/multi-intent.md

@@ -1,16 +1,18 @@
 # Multi-Intent Resolution
 
-当用户请求包含多个意图时，按以下矩阵裁决（与 `shared/trigger-disambiguation.md` 一致）：
+当用户请求包含多个意图时，按以下矩阵裁决（与 `../../shared/trigger-disambiguation.md` 一致）：
 
 | 意图组合 | 裁决 | 说明 |
 |---------|------|------|
 | capture + organize | 先 capture，回执中建议 organize | 先确保材料落地 |
 | capture + memory | 先 capture，回执中建议 memory | 先存笔记再更新我的情况 / 周期反思 |
-| capture + todo | 先 capture；显式行动语同轮写 `memory/todo.md`，隐含则 L1 建议 | 见 `shared/auto-suggest.md` |
+| capture + todo | 先 capture；显式行动语同轮写 `memory/todo.md`，隐含则 L1 建议 | 见 `../../shared/auto-suggest.md` |
 | organize + write | 先 organize 提炼，再 write 输出 | 分两步 |
 | organize + memory | 先 organize 候选，再 memory 落盘 | organize 产出列表 |
 | organize + todo | 整理本周后 L1 待办 diff 建议 | 不自动批量改清单 |
 | write + memory | 先 write，回执中建议 memory | 写作不改 memory/profile |
+| research + write | 先 research 出报告与已核验事实表，回执中建议 briefs / write | `topmind-research`、`topmind-briefs` 为外部可选；未装 research → organize「研究分析」，未装 briefs → write |
+| research + memory | 先 research 落盘专题或 Inbox，回执中建议 memory | research 不自动写记忆；用户确认后才走 memory |
 | 整理 inbox | `topmind-organize` + `plan-inbox-routing` | 不是 maintain/loop |
 | 清理工作区 | `topmind-maintain` | 系统健康 |
 

package/topmind-capture/SKILL.md

@@ -1,9 +1,10 @@
 ---
 name: topmind-capture
-version: 4.14.0
+version: 4.15.1
 description: >-
-  把链接、摘录、随手记收进动态周期本、Inbox 或专题；行动语自动提取/建议待办。Use when 记一下、收进、
-  剪藏、保存链接、记一下要做/别忘了、capture、save URL/idea。
+  把链接、摘录、随手记收进动态周期本、Inbox 或专题；行动语自动提取/建议待办。Use when 记一下、
+  收进、剪藏、保存链接、记一下要做/别忘了、capture、save URL/idea、Note it。
+  记下/Log it 是动态主区「写入当前周期本」——路由仍进本 skill，但不作 frontmatter 触发词（见 shared/trigger-disambiguation.md）。
   Do NOT use for 整理本周、出稿、写我的情况、doctor/loop、微信读书、X.
 action_category: capture
 triggers:
@@ -30,6 +31,7 @@ triggers:
   - capture
   - note
   - save
+  - "Note it"
 tags: [capture, inbox, note, material]
 entrypoint: false
 compatibility: topmind workspace. Host file tools or optional UTR capture-note.

package/topmind-ledger/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: topmind-ledger
-version: 4.14.0
+version: 4.15.1
 description: >-
   通用记账到记忆平面（默认个人/自己账本，用户自建账本与分类）。Use when 记账、记一笔、花了、存入、查看账单、账户余额。
   Do NOT use for 记一下到动态、待办、微信读书、发推、Feishu/lark-cli.

package/topmind-loop/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: topmind-loop
-version: 4.14.0
+version: 4.15.1
 description: >-
   可中断的工作区语义巡检（走专题/Inbox，.loop 断点续跑）。Use when 跑一遍 loop、巡检、整体体检、复盘、
   继续 loop、audit。Do NOT use for 快速 doctor（→maintain）、单专题整理、捕获、写作、仅记忆.

package/topmind-maintain/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: topmind-maintain
-version: 4.14.0
+version: 4.15.1
 description: >-
   确定性体检/清理/结构修复/回执恢复。Use when 快速体检、诊断、doctor、清理、修复、workspace check。
   Do NOT use for 整体巡检 loop、内容整理、捕获、写作、记忆.

package/topmind-memory/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: topmind-memory
-version: 4.14.0
+version: 4.15.1
 description: >-
   更新「我的情况」或周期反思。Use when 记住这个、更新我的情况、加到专题记忆、沉淀结论。
   Do NOT use for 捕获、仅总结（→organize）、整理本周正文、出稿、开/并专题、doctor/loop.

package/topmind-organize/SKILL.md

@@ -1,9 +1,9 @@
 ---
 name: topmind-organize
-version: 4.14.0
+version: 4.15.1
 description: >-
   整理本周动态、专题内整理/研究/分析/路由 Inbox。Use when 整理本周、整理、分析、研究、对比、总结要点、organize、summarize。
-  Do NOT use for 首次捕获、最终出稿、仅写我的情况、快速 doctor、全库 loop.
+  Do NOT use for 首次捕获、最终出稿、仅写我的情况、快速 doctor、全库 loop、对外检索一手资料与 AI 前沿深挖（已装外部 topmind-research 时）.
 action_category: organize
 triggers:
   - 整理本周
@@ -37,7 +37,7 @@ compatibility: topmind workspace with stream period notes, topics, or Inbox.
 author: TopMindSpace
 license: MIT
 homepage: https://github.com/topmindspace/topmind
-updated: 2026-09-28
+updated: 2026-10-08
 degradation: ../shared/capability-degradation.md
 ---
 
@@ -59,6 +59,7 @@ degradation: ../shared/capability-degradation.md
 - 交付最终报告/文章 → `topmind-write`  
 - 只写「我的情况」/ 周期反思 → `topmind-memory`  
 - doctor / 全库巡检 → `topmind-maintain` / `topmind-loop`  
+- 对外检索一手资料（论文、技术报告、官方公告、模型或产品横向对比）、AI 前沿深挖、周度官方动态 → 外部可选 `topmind-research`（已安装时）；未安装仍由本 skill「研究分析」接手，回执注明来源范围（见 [`../shared/trigger-disambiguation.md`](../shared/trigger-disambiguation.md)）  
 
 ## 动作入口判断
 
@@ -110,6 +111,8 @@ degradation: ../shared/capability-degradation.md
 
 证据链：来源 → 事实 → 推断 → 待验证。对比用表；保留 URL/日期；区分确认与假设。有价值的对比/结论同样**默认落盘**（专题根 md），避免只留在聊天里。
 
+对象是工作区已存材料。需要对外检索一手资料时，已装外部可选 `topmind-research` 则交给它；未安装时本节接手，回执写明只用了工作区材料和宿主可用的检索。
+
 ### 实体提取（非默认）
 
 仅显式要求时。实体附证据；不建默认子目录。

package/topmind-pack.json

@@ -4,8 +4,8 @@
   "label": "topmind",
   "description": "topmind skill pack: single daily entry topmind + progressive disclosure (shared/ + references/), Agent Skills open-standard aligned, capture-first template-driven categories, optional connectors topmind-weread and topmind-x, optional topmind-ledger (记账), optional write sub-skill topmind-wechat. None of the optional skills is an extra user concept. File-system-first content truth; UTR optional.",
   "daily_entry": "topmind",
-  "version": "4.14.0",
-  "updated": "2026-09-28",
+  "version": "4.15.1",
+  "updated": "2026-10-08",
   "license": "MIT",
   "locales": {
     "default": "zh-CN",
@@ -382,7 +382,10 @@
         "restore-profile",
         "list-todos",
         "add-todo",
-        "toggle-todo"
+        "toggle-todo",
+        "update-todo",
+        "set-todo-due",
+        "delete-todo"
       ],
       "lifecycle": [
         "scan"
@@ -391,8 +394,8 @@
         "rebuild"
       ]
     },
-    "command_count": 35,
-    "mcp_default_count": 26,
+    "command_count": 38,
+    "mcp_default_count": 29,
     "command_exposure": {
       "primary": [
         "workspace-read.list-categories",
@@ -416,7 +419,10 @@
         "memory.restore-profile",
         "memory.list-todos",
         "memory.add-todo",
-        "memory.toggle-todo"
+        "memory.toggle-todo",
+        "memory.update-todo",
+        "memory.set-todo-due",
+        "memory.delete-todo"
       ],
       "danger": [
         "workspace-maintain.archive-topic",

package/topmind-wechat/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: topmind-wechat
-version: 4.14.0
+version: 4.15.1
 description: >-
   公众号文章全生命周期子技能（write 族）：交付包、审校改写、质量三关、状态同步、微信内联排版与发布清单。
   支持 forward（底稿→公众号）、reverse（选题原创→回推）、站外拉取（在线精选站→reverse+pending）三条路径；
@@ -49,14 +49,15 @@ compatibility: topmind workspace. Writes via UTR workspace-write / Desktop Works
 | `scripts/push-to-topstream.py` | 可选回推：公众号稿降级为纯 Markdown notes |
 | `scripts/lint-wechat.py` | 排版体检 + 自动修复（中英文间距、段长、AI 腔…） |
 | `scripts/md2wechat.py` | Markdown → 全内联 HTML；**必加 `--embed-images`** |
-| `scripts/scan_ai_flavor.py` | 中文去 AI 味扫描（与 `qu-aiwei-zh` 同源） |
+| `scripts/scan_ai_flavor.py` | 中文去 AI 味扫描 —— **转发器**，实现在 canonical `qu-aiwei-zh`（`--which` 可查解析结果；本目录不含实现，避免副本漂移） |
+| `scripts/audit-provenance.py` | **改稿保真审计**：双向逐段溯源（本稿→源稿 / 源稿→本稿），抓悄悄扩写与被落下的段。有源稿时定稿必跑 |
 
 ```bash
 # 路径解析：CLI --base/--workspace → env TOPMIND_WECHAT_BASE / TOPMIND_WORKSPACE / TOPSTREAM_ROOT → 惯例
 export TOPMIND_WORKSPACE=/path/to/workspace   # 推荐
 python3 scripts/new-article.py --slug demo --title "标题" --direction reverse
 python3 scripts/lint-wechat.py --input <包>/公众号稿.md --fix
-python3 scripts/scan_ai_flavor.py <包>/公众号稿.md          # 目标 ≥85
+python3 scripts/scan_ai_flavor.py <包>/公众号稿.md          # 总分与作者姿态分都 ≥85
 python3 scripts/md2wechat.py --input <包>/公众号稿.md --out-dir <包> --slug demo \
   --asset-root <素材根> --embed-images
 python3 scripts/sync-status.py --set 定稿 <包> --apply
@@ -147,6 +148,13 @@ python3 scripts/sync-status.py --set 定稿 <包> --apply
 - 改稿续写：正文已有数字**回源重核**（上一轮文本最不可信）  
 - 多口径（主轮/复跑）显式拆开；表格从数据源生成，禁止手抄  
 - 外部工具改过的稿：**先核数字再动文字**；「比值对但绝对值错」= 全段重核  
+- **有源稿时（`reverse` / 站外拉取）跑一次双向溯源审计**，别靠「我记得只改了三处」：
+
+  ```bash
+  python3 scripts/audit-provenance.py --draft <包>/公众号稿.md --source <包>/源稿-*.md
+  ```
+
+  正向查「本稿有、源稿找不到」（扩写藏在这里），反向查「源稿有、本稿落下」。**退出码 1 不是失败，是「有待判定项」**——每一项要么归入已声明的修正/增补，要么就是不该有的改动；逐条在包内 README 声明后即收口。源稿里后加的块（勘误等）用 `--skip '^>\s*\[!'` 排除。  
 
 ### 关 2 · 逻辑
 
@@ -156,13 +164,16 @@ python3 scripts/sync-status.py --set 定稿 <包> --apply
 ### 关 3 · 文字（去 AI 味）
 
 ```bash
-python3 scripts/scan_ai_flavor.py <包>/公众号稿.md   # ≥85（人话）
+python3 scripts/scan_ai_flavor.py <包>/公众号稿.md   # 总分 ≥85（人话）
 ```
 
+- **同时看「作者姿态分」（E 类，与总分独立）**，目标同样 ≥85。实测两者会严重背离：同一篇 AI 完整版总分 92 / 姿态 21，手改发布版 100 / 100——**总分只差 8 分，姿态差 79 分**，只看总分会被骗
+- ⚠️ 这里调的是 canonical `qu-aiwei-zh` 的脚本（本目录的 `scripts/scan_ai_flavor.py` 是转发器）。**若输出里没有「作者姿态层」一节，说明拿到的是 E 类之前的旧版本**，分数不可信——先 `--which` 确认实际执行的是哪一份
 - 删套话/黑话/工程圈行话；降调段末加粗金句  
 - **满分 ≠ 有人味**：再查「段末金句癖 / 节奏过分整齐 / 没有场景与我 / 报告体标注」  
 - **口语化 ≠ 有人味**：删社交垫词（元叙述、空转过渡、姿态句）  
 - 判据：**这句话删掉之后，读者少知道了什么？**  
+- **姿态分只对文章有效**：清单 / 词表 / 说明书不适用（检测器会把被引用的反例当真命中），脚本命中 ≥70% 落在表格行时会提示「疑似清单文档」，看到提示先确认再改
 
 详见 [`references/writing-quality.md`](references/writing-quality.md)。
 

package/topmind-wechat/references/workflow.md

@@ -60,21 +60,32 @@ python3 scripts/sync-status.py --set 定稿 <包> --apply
 
 | 输出 | 口径 | 用途 |
 |------|------|------|
-| frontmatter `word_count` | 纯中文 `\[一-鿿\]` | 映射真源 |
+| frontmatter `word_count` | 正文**全文**的 `[\u4e00-\u9fff]` 计数 —— **frontmatter 之后的一切都算，含图注、也含图片路径里的中文** | 映射真源 |
 | lint「字数」 | 视觉长度（中 1 + 英数 ×0.6，URL 不计） | 阅读时长 / 段长 |
 | md2wechat「正文字数」 | 渲染后字符 | 仅展示 |
 
+⚠️ `word_count` **只能由 `sync-status.py --apply` 回写，禁止手算**。它的口径与直觉不同：一篇 9 图稿，光 `images/NN-中文名.png` 这一串路名就贡献 40+ 字。自制口径（如「剔掉图注与路径」）会得出一个更小、更像「正文字数」的值，写进 frontmatter 后会被 `sync-mapping.py` 判为漂移 —— 实测一篇 1,027 vs 1,450，而错值同时落进 `topic.md` 总表与包内 README，**一个错值三处落盘**。
+
 ## 定稿验收命令串
 
 ```bash
-python3 scripts/scan_ai_flavor.py <包>/公众号稿.md    # ≥85
+python3 scripts/scan_ai_flavor.py <包>/公众号稿.md    # 总分 ≥85 且「作者姿态分」≥85
 python3 scripts/lint-wechat.py --input <包>/公众号稿.md
+python3 scripts/audit-provenance.py --draft <包>/公众号稿.md --source <包>/源稿-*.md
 python3 scripts/sync-mapping.py --no-topstream
 python3 scripts/sync-status.py
 python3 scripts/md2wechat.py --input <包>/公众号稿.md --out-dir <包> \
   --slug <slug> --asset-root <素材根> --embed-images
 ```
 
+第 3 行只在**有源稿**时跑（`reverse` / 站外拉取；`forward` 的底稿在 `notes/` 也一样适用）。退出码 **0 = 双向干净**、**1 = 有待判定项**、2 = 参数错。**1 不等于稿子有问题**——它只是把「本稿有源稿找不到」和「源稿有本稿落下」两类段摆出来，由人逐条判：归入已声明的修正/增补，或改回去。判定完把结论写进包内 `README.md`，这一关才算收口。
+
+三个易踩的点：
+
+- **阈值别乱调**：默认 `0.72`。调高会把正常的改写（换词、调序）判成新增，调低会漏掉真扩写。
+- **源稿后加的块要 `--skip`**：若源稿顶部有本包后补的勘误/说明块（`> [!note] …`），它在本稿侧不存在，会恒定报一条反向待判定。用 `--skip '^>\s*\[!'` 排除，别去改稿子。
+- **图注不算遗漏**：脚本反向侧额外建了一个「去掉 `▲ 图 N` 前缀」的候选池，图注编号不会被误判为漏段。
+
 ## 收尾
 
 1. 更新专题 `topic.md` 总表（派生视图）  

package/topmind-wechat/references/writing-quality.md

@@ -44,7 +44,7 @@
 |---|---|---|
 | 中文长文 / 公众号改稿 | `humanizer-zh` + `qu-aiwei-zh` | 先立边界，再扫描定位（默认组合） |
 | 只要分数和命中清单 | `qu-aiwei-zh` | 跑脚本，不改稿 |
-| 随笔要「加声音」 | `qu-aiwei-zh` + `references/pan-style.md` | 用表达方式加，不编故事 |
+| 随笔要「加声音」 | `qu-aiwei-zh` + `qu-aiwei-zh/references/pan-style.md` | 用表达方式加，不编故事 |
 | 英文文本 | `humanizer` | `humanizer-zh` 只针对中文 |
 | 清单 / 词表 / 说明书 | 都不用 E 类姿态分 | 这类文体靠列举反例，检测器会把反例当真命中 |
 
@@ -70,12 +70,20 @@
 
 ### 第二步：扫描定位（`qu-aiwei-zh`）
 
-目标：`qu-aiwei-zh` 扫描 **≥ 85 分**。
+目标：`qu-aiwei-zh` 扫描 **总分 ≥ 85**，且**「作者姿态分」（E 类）也 ≥ 85**。两个分数独立，都要看。
 
 ```bash
+python3 scripts/scan_ai_flavor.py <稿>.md
+# 或直连 canonical（同一个脚本）
 python3 ~/.workbuddy/skills/qu-aiwei-zh/scripts/scan_ai_flavor.py <稿>.md
 ```
 
+`scripts/scan_ai_flavor.py` 是**转发器**，实现在 canonical `qu-aiwei-zh`，两条命令等价（`--which` 可查解析到哪一份）。
+
+⚠️ **认准「作者姿态层」这一节**：姿态分是后加的维度，早期版本没有。若输出里没有这一节，说明调用到了旧版脚本，**分数不可信**。实测同一篇稿：AI 完整版总分 92 / 姿态 21，手改发布版 100 / 100 —— 总分只差 8 分，姿态差 79 分，**只看总分会被骗**。
+
+⚠️ **姿态分只对文章有效**：清单 / 词表 / 说明书不适用——这类文体靠列举反例工作，检测器会把被引用的例子当成真命中。脚本命中 ≥70% 落在表格行时会提示「疑似清单文档」，看到提示先确认文体再改。
+
 ### 删套话
 
 值得注意 / 值得记录 / 值得单独强调 / 本质上 / 事实上 / 意味着 / 由此可见 / 不难看出 / 换句话说 / 换言之 / 殊途同归 / 显而易见 / 众所周知 / 更进一步说
@@ -114,7 +122,7 @@ python3 ~/.workbuddy/skills/qu-aiwei-zh/scripts/scan_ai_flavor.py <稿>.md
 
 有「我」、有具体场景、有具体数字与人名、有不确定性表达（「其实」「不过」「还在想」）、句子长短交替、有真实细节而不是「很多人」「大多数」。
 
-⚠️ 这一段说的是**表达方式**。原文没有第一人称、没有数字时，不许靠这一条去补——那正好踩中 `humanizer-zh` 的优先级第 1 条。加声音的手段是句长节奏、设问、括号自注（见 `pan-style.md`），配合删掉元叙述和教学腔。`humanizer-zh` 里写着同一句话：「用户要求增强个人风格时，用表达方式实现，不编故事。」
+⚠️ 这一段说的是**表达方式**。原文没有第一人称、没有数字时，不许靠这一条去补——那正好踩中 `humanizer-zh` 的优先级第 1 条。加声音的手段是句长节奏、设问、括号自注（见 `qu-aiwei-zh/references/pan-style.md`），配合删掉元叙述和教学腔。`humanizer-zh` 里写着同一句话：「用户要求增强个人风格时，用表达方式实现，不编故事。」
 
 英文文本才走 `humanizer`：它的取向是 **Add soul**（主动注入个性），与中文改稿的**保真优先**方向相反，别把它的思路套到中文稿上。