# 文稿修改记录

记录用户在对话中对具体文稿提出的表达纠正，按时间追加；同一处的后续纠正补在原条目下。格式与处理方法见[反馈流程](./writing-feedback-guide.md)。

## 2026-11-02 · Super-agent 文章反馈整理

来源是本 session 中已经出现的用户原话与改稿过程。下文的“修改后”保留当时版本；提交或发布不代表用户已评价、认可 AI 改稿。未提供原因的地方如实记为“未说明”，AI 对语感的分析单独标注。

| ID | 对应问题 | 当前证据与状态 |
| --- | --- | --- |
| [WF-20261102-01](#wf-20261102-01) | “作者”指代不明确 | 用户指定改为 dsh 或 Superagent 原作者；限本篇。 |
| [WF-20261102-02](#wf-20261102-02) | 图内注释没有意义 | 用户要求精简；具体删法为 AI 改稿，尚无评价。 |
| [WF-20261102-03](#wf-20261102-03) | 群聊、PR 与后续问题的句子不顺 | 用户提供了自己的改写，已按原句采用；语感原因仍是 AI 分析。 |
| [WF-20261102-04](#wf-20261102-04) | 结尾的投入评估建议不需要 | 用户明确要求整段删除；多次重复指向同一段。 |
| [WF-20261102-05](#wf-20261102-05) | 实验限制像压缩备注，读不懂 | 用户要求结合其说话习惯改写；AI 改稿尚无评价。 |
| [WF-20261102-06](#wf-20261102-06) | “续办流程”“任务身份”看不懂 | 用户指出难懂；AI 改为 CSV 实例，尚无评价。 |
| [WF-20261103-01](#wf-20261103-01) | `follow_up` 通知一句难懂 | 用户给出改写方向并要求解释原因；AI 补充源码依据，尚无评价。 |
| [WF-20261103-02](#wf-20261103-02) | “新目标”不符合题意 | 用户确认用“新任务”。 |
| [WF-20261103-03](#wf-20261103-03) | 准入与过滤一段 | 用户确认 AI 的主语调整。 |
| [WF-20261103-04](#wf-20261103-04) | Router 工具边界一段难懂 | 用户指出难懂；AI 拆开解释，尚无评价。 |
| [WF-20261103-05](#wf-20261103-05) | 第 02 节引入句 | 用户给出改写；已采用，删去“不是四个 Agent”的对比。 |
| [WF-20261103-06](#wf-20261103-06) | Ticket 与 Assignment 一段看不懂在表达什么 | 用户询问含义；AI 按续办场景改写，尚无评价。 |
| [WF-20261103-07](#wf-20261103-07) | “只在聊天里说”缺主语 | 用户决定保留“收到，我来处理”。 |
| [WF-20261103-08](#wf-20261103-08) | 一致性机制一段 | 用户给出“dsh 的方式是采用 xxx 方案来解决相应问题”的句式；AI 改为总起句加三项列表，尚无评价。 |
| [WF-20261103-09](#wf-20261103-09) | “另一个窗口”指代与衔接不清 | 用户追问指什么、与上文的关系；AI 补出衔接与重复发送的后果，尚无评价。 |
| [WF-20261103-10](#wf-20261103-10) | 第 03 节结尾引语的意义不清 | 用户要求删除，已删。 |
| [WF-20261103-11](#wf-20261103-11) | “3～5 个活跃 Session”的限定句没有意义 | 用户认为无意义并征求意见；AI 同意并删除。 |
| [WF-20261103-12](#wf-20261103-12) | 异步输入与按渠道输出两段看不懂 | 用户要求删去推不出来的内容，已删。 |

## WF-20261102-01

- 文档与位置：`superagent.html`、`content/superagent.md`，介绍双层分工及其他提及原团队的段落。
- 用户原话：“这里不要用作者了吧，直接就是 dsh 或者 superagent原作者”
- 修改前：“作者把职责分成两层。”
- 修改后：“dsh 把职责分成两层。”首次提及处注明 DeepSeek Harness（dsh）团队。
- 修改原因：未说明；用户明确给出了希望使用的称谓。
- 原因来源：未说明。
- AI 推测：泛称“作者”可能让读者分不清本站作者与原团队。待确认。
- 适用范围：本篇对原团队的指代，不扩大为所有文章禁用“作者”。
- 改稿状态：已按指定称谓修改，尚无用户对实际改稿的评价。
- 偏好关联：仅限本篇，未列入长期偏好。

## WF-20261102-02

- 文档与位置：`superagent.html`、`content/superagent.md` 的图注，以及 `scripts/render-superagent-source-diagrams.cjs` 中的图内注释。
- 用户原话：“然后图片里面的很多注释都没意义”
- 修改前（图 4 图注示例）：“据原文图 4 重绘｜Router 维持共享的高层关联，Worker 在各自上下文中执行。 来源 · 对照原图。沿用博客字体与配色；作者设计与公开实现的范围仍按正文说明。”
- 修改后（AI 实际改稿）：“图 4 · 双层分工（重绘）。dsh 原文 · 原图”。来源链接和原图入口保留；删除多处重复的绘图过程说明，保留节点、调用名、数据单位与必要边界。
- 修改原因：用户认为多处注释没有意义；未逐项说明哪些注释、为什么无意义。
- 原因来源：用户原话。
- AI 推测：重复正文、解释绘图过程的注释增加了阅读负担。待确认，不能据此推断用户希望删除所有图注或实验限制。
- 适用范围：本篇图内注释与图注；图的宽度、配色和箭头问题另记在发布流程中。
- 改稿状态：已精简，具体删法尚无用户评价。
- 偏好关联：WP-04（2026-11-03 由 AI 整理，见 WF-20261103-16）。

## WF-20261102-03

- 文档与位置：`superagent.html`、`content/superagent.md`，第 01 节开头。
- 用户原话：“这句话非常不顺，太AI味，太读不懂了”
- 修改前：“在群聊提出请求，在 PR 里评审，用 CI 检查改动，隔几周再反馈回归：入口改变，任务可以延续。让多个独立会话各自理解整段历史，既费推理，也需要人反复搬运信息。”
- 第一次 AI 改写：“需求在群聊里提出，代码在 PR 里评审，后续问题又回到群聊。如果每次都由一个新 Agent 接手，人就得找出旧需求和 PR，重新解释之前做了什么。”
- 修改后（用户亲自提供，随后采用）：“需求是在群聊里提出的，而代码在 PR 里评审，需求后续的问题还是得回到群聊中讨论解决。”
- 修改原因：用户明确说原句不顺、太 AI 味、读不懂；未明确说明自己改写中各个词的选择原因。
- 原因来源：用户原话；具体语感原因未说明。
- AI 推测：用户版本先说明群聊和 PR 的用途；“而”区分两处的分工，“还是得”表达后续仍需讨论的需要，“讨论解决”说明具体动作。第一次 AI 改写过早转到了新 Agent 接手的成本。这些是 AI 分析，待用户确认；不把几个连接词当作固定写法。
- 适用范围：本处；可作为用户自写的中文样本，尚未确认适用于所有文章的长期规则。
- 改稿状态：已按用户原句采用；用户提供原句这一事实已确认，AI 对原因的解释未获明确确认。
- 后续反馈：用户要求“分析一下我为什么这么说，跟之前有什么不一样，如何说出更有人味的话”，随后要求“分析完给我把代码提交了吧”。后一句是提交指令，不单独视为对 AI 归因的认可。
- 偏好关联：WP-01、WP-02（2026-11-03 由 AI 整理，见 WF-20261103-16）；原句同时作为用户自写样本。

## WF-20261102-04

- 文档与位置：`superagent.html`、`content/superagent.md`，第 06 节结尾建议。
- 用户原话：“这句话也不需要”。后续再次指向同一段说“这句话也不用了”。
- 修改前：“再观察一个验收通过的任务需要人主动操作多少分钟，质量与返工如何变化，新增模型与维护开销是否值得。失败、误触发和额外审查也计入，不能只统计成功演示。botmux 已有不少接入、执行和恢复能力，投入应由真实缺口决定，具体比较见配套文章。”
- 修改后：整段删除。
- 修改原因：未说明；用户明确要求不保留此段。
- 原因来源：未说明。
- AI 推测：该段转向了通用的投入评估建议，可能打断了本篇结尾。待确认；不能据此推断用户不接受任何成本分析、实验边界或 botmux 比较。
- 适用范围：本段、本篇。
- 改稿状态：已执行删除。重复反馈合并在本条，不计为多条独立偏好证据。
- 后续反馈：用户重复引用同一段要求删除；AI 随后核对源码与新发布页，确认删除已生效。是否由旧标签页或缓存造成，未确认；重复引用不另算一条文风证据。
- 偏好关联：WP-04（2026-11-03 由 AI 整理，见 WF-20261103-16）。

## WF-20261102-05

- 文档与位置：`superagent.html`、`content/superagent.md`，第 05 节补充微实验后的说明。
- 用户原话：“这句话不太像是人话，你结合我之前的说话习惯，改一下”
- 修改前：“分摊开销下降，但整批等待超过一分钟。耗时包含 CLI/Harness 路径；模板有限、大批次重复少，历史原始响应缺失，只能说明趋势，不能证明生产路由正确率。完整次数、汇总与缺失记录的限制见实验附录。”
- 修改后（AI 版本）：

  > 每条消息平均用的时间少了，但要等到整批结果，还是得一分钟以上。这里的耗时也包括 CLI 和 Harness 运行所花的时间。
  >
  > 这次用的消息模板不多。每批 128 条的测试，每个模型只跑了两次，原始返回结果也没有保存下来，没法再逐条核对。所以，这组数据可以用来看批量处理后的耗时变化，实际用起来能不能把消息分对，还得另外测试。具体数据和测试记录见实验附录。

- 修改原因：用户认为原段“不太像是人话”，要求参考既有说话习惯；未进一步解释具体原因。
- 原因来源：用户原话。
- AI 推测：耗时、测试方法和结果限制压在分号与术语串里，不便理解；拆开说明、把“大批次重复少”换成具体次数会更易读。待确认。
- 技术依据：128 条一批、每个模型两次来自 `content/superagent-evidence.md`，不是从用户语气偏好中推导的事实。平均耗时与整批等待、CLI/Harness 开销、原始响应未保存、实际业务仍需另测的边界保留。
- 适用范围：本段；用户明确要求本次参考之前的表达样本，不自动扩展成全局写法。
- 改稿状态：已按要求改写，尚无用户对 AI 改稿的评价。
- 偏好关联：WP-02、WP-03（2026-11-03 由 AI 整理，见 WF-20261103-16）。

## WF-20261102-06

- 文档与位置：`superagent.html`、`content/superagent.md`，引言第二段。
- 用户原话：“这句话也看不懂”
- 修改前：“Super-agent 想接管这段续办流程。**Router 判断任务关联，Worker 执行工作，程序保存任务与讨论的关系。** 聊天、PR 和一次执行可以结束，任务的身份仍然保留。”
- 修改后（本 session 的 AI 版本）：“Super-agent 会把这次 CSV 修复记成一项任务，记录它来自哪个群聊、对应哪个 PR、目前处理到哪一步。PR 合并后，这条任务记录仍会保留。两周后同事在原话题里追问旧版 Excel 的问题，系统还能找到之前的需求和修复记录，接着处理。”
- 修改原因：用户表示看不懂；未进一步说明具体原因。
- 原因来源：用户原话。
- AI 推测：“续办流程”“任务关联”“任务的身份”在开头缺少具体指向；先延续 CSV 例子，说明记录哪些东西、后续能用来做什么，再在后文解释角色分工，可能更容易理解。待确认，不将这些术语设为禁用词。
- 适用范围：本段及本篇引言。
- 改稿状态：已按要求改写，尚无用户对这一 AI 版本的评价。Router 与 Worker 的分工仍在第 01 节。
- 后续版本：当前文件后来又将结尾调整为“继续追问”“系统需要能找到……”。本 session 未出现相应的用户纠正原话，不依据这一 diff 新增用户反馈或认定认可，也不覆盖当前稿。
- 偏好关联：WP-01（2026-11-03 由 AI 整理，见 WF-20261103-16）。

## WF-20261103-01

- 文档与位置：`superagent.html`、`content/superagent.md`，第 01 节“订阅与直通”图 7 之后一段。
- 用户原话：“这里可以改成 当下一次追问被认定为直通后，可以节省再次分派的开销，同时 router 还是会收到 follow_up的通知（这里需要你解释一下为什么）”
- 修改前：“人类追问直通后，Router 仍可能收到 `follow_up` 通知；节省的是再次分派等开销，不能把 Router 的后续推理成本算成零。”
- 修改后：“有人在原话题追问时，程序按订阅把消息直接送到 Worker，省去 Router 再次分派的开销。Router 仍会收到一条 `follow_up` 通知，说明消息已经送到哪些任务。它不再转发这条消息，但追问里可能有“先别做了”这样的要求，而停止任务由 Router 调用 `stop` 执行，所以它仍需要看到追问。读这条通知也要消耗推理成本。”
- 修改原因：用户给出改写方向，要求先说节省什么、再说 Router 仍收到通知，并解释原因；未进一步说明原句的问题。
- 原因来源：用户原话。
- AI 推测：原句先下结论、后用“不能算成零”反驳，读者不知道 Router 为什么还会收到通知。待确认。
- 技术依据：固定源码 `src/app/notices.ts` 的 `followupNotice` 与 `FOLLOWUP_NOTE`、`prompts/dispatch.md` 对 follow_up 的说明：消息已送达 Worker，由 Worker 判断归属；Router 只在用户要求停止时用 `orchestrator_route` 的 `stop` 处理，不再转发、accept 或 attach。
- 适用范围：本处。
- 改稿状态：已按要求修改，尚无用户评价。
- 偏好关联：无已确认的长期偏好。

## WF-20261103-02

- 文档与位置：`superagent.html`、`content/superagent.md`、`assets/superagent/routes.js`，第 01 节路由示意与其后一段。
- 用户原话：“新目标可以换成新的工作项or新任务，目标怎么理解呢，不太符合题意”
- 修改前：“‘增加 CSV 导入功能’是新目标，需要新 Ticket 和 Worker。仅仅主题相似不足以复用旧任务。同一话题也可能出现新目标：……”
- 修改后：“‘增加 CSV 导入功能’是新任务，需要新建 Ticket 和 Worker。主题相似不足以复用旧任务。同一话题里也可能提出新任务：……”；路由示意的按钮、图注与说明同步改为“新任务”。
- 修改原因：用户认为“目标”不好理解，不符合这里要表达的意思。
- 原因来源：用户原话。
- AI 推测：这里比较的是是否复用旧 Ticket，“任务”与文中 Ticket、旧任务的叫法一致。待确认。
- 适用范围：本篇“新目标”的叫法；未扩展为全局禁用词。
- 改稿状态：已按要求修改，尚无用户评价。
- 偏好关联：无已确认的长期偏好。
- 后续反馈：AI 说明选用“新任务”的理由后，用户回复“那就新任务”。改稿状态：用户明确认可。

## WF-20261103-03

- 文档与位置：`superagent.html`、`content/superagent.md`，第 01 节“消息先过准入，再判断归属”首段。
- 用户原话：“现实环境中，router收到的消息大多是闲聊、通知、背景资料等混乱的消息。dsh 在此处的策略是先用xxxxxx; 整体测的策略如下:”
- 修改前：“真实环境里大多是闲聊、通知和背景资料。原文先用程序检查来源、范围和明确请求，再让模型判断需要理解语义的候选。公开版对应来源配置、策略准入和 Router 评估。过滤减少调用量，剩余候选的判断正确率仍需另测。”
- 修改后：开头句 + “dsh 的策略是先用程序规则过滤，再让模型判断剩下的消息。整体策略如下：” + “程序准入”“语义判断”两项列表 + “程序过滤能减少模型调用；剩下的候选判断得准不准，还需要另外测试。”
- 修改原因：未说明；用户直接给出开头与结构。
- 原因来源：未说明。
- AI 推测：原段主语缺失（“真实环境里大多是”谁收到的消息），两步策略压在一句里。待确认。
- 技术依据：主语未照用户原句写成 Router，因为程序准入发生在 Router 之前（`src/policy.ts` 的 `gate`；图 5），改为“系统从群聊和 PR 收到的消息”。“混乱的消息”改为“与任务无关的内容”，“整体测的策略”按笔误理解为“整体策略”。
- 适用范围：本段。
- 改稿状态：已按要求修改，尚无用户评价。
- 偏好关联：无已确认的长期偏好。
- 后续反馈：AI 说明主语改为“系统从群聊和 PR 收到的消息”的原因后，用户回复“ok”。改稿状态：用户明确认可该处主语与措辞调整。

## WF-20261103-04

- 文档与位置：`superagent.html`、`content/superagent.md`，第 01 节“谁写实施提示词”末段。
- 用户原话：“这句话比较难懂”
- 修改前：“常规分发依据任务记录，源码调查属于 Worker。主动观察的候选是例外：Router 可用有界只读工具检查具体范围是否符合接单规则。Router 在公开版仍保留 Bash 等工具，“不亲自实现”包含提示词约束，不能描述成完全的工具硬隔离。”
- 修改后：“Router 平时只看任务记录来分发，不读代码；查源码、定位问题是 Worker 的事。例外是系统主动发现的候选，也就是没人明确提出请求、但可能符合接单规则的消息。这时 Router 可以用限定范围的只读工具查看相关讨论和仓库，判断它是否在接单规则覆盖的范围内。公开版的 Router 仍然有 Bash 等工具，“不读代码、不亲自实现”主要靠提示词约束，工具层面并没有禁止。”
- 修改原因：用户认为难懂；未进一步说明。
- 原因来源：用户原话。
- AI 推测：“主动观察的候选”“有界只读工具”“工具硬隔离”未解释，四个判断挤在三句里。待确认。
- 技术依据：`docs/007-architecture.md` 的 MasterAssessor 与主会话工具说明（“Avoiding code reads is a prompt rule, not a tool restriction.”）；`prompts/dispatch.md` 的 “Outside proactive assessment, do not … read code”。
- 适用范围：本段。
- 改稿状态：已按要求修改，尚无用户评价。
- 偏好关联：无已确认的长期偏好。

## WF-20261103-05

- 文档与位置：`superagent.html`、`content/superagent.md`，第 02 节首段。
- 用户原话：“为了让“旧版 Excel 还是打不开”这条消息可以被定位到之前的已经存在的同一项修复，系统需要通过4条不同类型的记录来实现：”
- 修改前：“为了让“旧版 Excel 还是打不开”回到同一项修复，系统需要保存几种不同的东西。它们不是四个 Agent，而是四类记录。”
- 修改后：“为了让“旧版 Excel 还是打不开”这条消息能定位到之前已有的同一项修复，系统需要用到四类不同的记录：”
- 修改原因：未说明；用户直接给出改写。
- 原因来源：未说明。
- AI 推测：“回到同一项修复”指向不清；“不是四个 Agent，而是四类记录”属于先否定再强调的句式。待确认。
- 技术依据：用户原句的“4条”改为“四类”，因为下表是四种记录类型，每类可有多条。
- 适用范围：本处。
- 改稿状态：已采用用户句式并微调，尚无用户评价。
- 偏好关联：无已确认的长期偏好。

## WF-20261103-06

- 文档与位置：`superagent.html`、`content/superagent.md`，第 02 节记录表格后一段。
- 用户原话：“这句话在表达什么”
- 修改前：“新任务建立新 Ticket 和 Worker。旧任务重新开始，可以新建 Assignment，同时复用固定 ID `worker-<ticketId>` 的原 Worker。任务身份与执行轮次分开，才能解释“工作已经结束，为什么还能续办”。”
- 修改后：“新任务会新建 Ticket 和 Worker。旧任务重新开始时，比如修复已经结束又有人追问，系统不新建 Ticket，只在原 Ticket 下新开一轮执行，即新的 Assignment。Worker 会话的 ID 由 Ticket ID 固定生成（`worker-<ticketId>`），所以接手的还是原来的 Worker。Ticket 记录这是哪项工作，Assignment 记录其中一轮执行。上一轮结束了，Ticket 还在，同一项工作就能接着做。”
- 修改原因：用户看不懂这句话的意思；未进一步说明。
- 原因来源：用户原话。
- AI 推测：“任务身份与执行轮次分开”是结论，缺少“结束后有人追问”的场景和两者各记录什么。待确认。
- 技术依据：`src/core/tickets.ts` 的 `wake()`：已结束的 Ticket 收到人的消息时删除 `ended`、调用 `newAssignment`，无 Eval、无新 Decision；`src/executor/dsh.ts` 的 `workerSessionId`。
- 适用范围：本段。
- 改稿状态：已按要求修改，尚无用户评价。
- 偏好关联：无已确认的长期偏好。

## WF-20261103-07

- 文档与位置：`superagent.html`、`content/superagent.md`，第 03 节首段。
- 用户原话：“只在聊天里说？谁在聊天里说，主体是什么”
- 修改前：“再看一个假设的故障窗口：系统答应接单，Worker 启动前进程退出。只在聊天里说“我会处理”不能帮助恢复；系统需要同时保存任务和待启动动作。”
- 修改后：“再看一个假设的故障窗口：Router 决定接单，在群里回复了一句“收到，我来处理”，但 Worker 还没启动，进程就退出了。重启后，这句回复只留在聊天记录里，程序无从知道还有一个 Worker 等着启动。所以接单时，系统要把任务和“启动 Worker”这个待执行动作一起存下来，重启后才能接着做。”
- 修改原因：用户指出“只在聊天里说”缺少主语。
- 原因来源：用户原话。
- AI 推测：原句还省略了“为什么聊天回复不能帮助恢复”，补上重启后程序读不到这句回复。待确认。
- 技术依据：`prompts/dispatch.md` 中 accept 需带 acknowledgement；`docs/007-architecture.md`：accept 在同一事务中创建 Ticket、Mandate、Assignment、订阅与 acknowledgement，Effects 在提交后执行。
- 适用范围：本处。
- 改稿状态：已按要求修改，尚无用户评价。
- 偏好关联：无已确认的长期偏好。
- 后续反馈：用户原话“就是，收到，我来处理就行了”。AI 曾指出原型 `dispatch.md` 不允许泛泛的确认，提议改成具体内容；用户决定保留“收到，我来处理”。改稿状态：用户明确认可。

## WF-20261103-08

- 文档与位置：`superagent.html`、`content/superagent.md`，第 03 节第二段。
- 用户原话：“dsh 的方式是采用 xxx 方案来解决相应问题”
- 修改前：“公开原型采用单机状态目录锁、SQLite 事务和持久 Effects 队列。接单时，把 Decision、Ticket、Assignment、订阅、待启动动作和确认消息写进同一事务；失败回滚。Worker 启动与对外发送在提交后执行，崩溃后可以继续派发队列。”
- 修改后：“dsh 公开原型用三样东西解决这个问题：”加“状态目录锁”“SQLite 事务”“持久 Effects 队列”三项列表，每项说明它防的是什么。
- 修改原因：未说明；用户给出句式，要求先点明方案与它要解决的问题。
- 原因来源：用户原话。
- AI 推测：原段先列三个技术名词，没有和上一段的故障窗口接上。待确认。
- 技术依据：`docs/007-architecture.md`：Runtime 构造时锁定状态目录，防止第二个进程迁移或写同一份状态；accept 原子创建 Ticket、Mandate、Assignment、订阅与 acknowledgement；`Effects.enqueue` 在事务内调用，提交后执行。保留“公开原型”限定。
- 适用范围：本段。
- 改稿状态：已按要求修改，尚无用户评价。
- 偏好关联：无已确认的长期偏好。

## WF-20261103-09

- 文档与位置：`superagent.html`、`content/superagent.md`，第 03 节边注后一段。
- 用户原话：“另一个窗口是什么，跟上文的关系是什么，”
- 修改前：“另一个窗口更难：外部消息已发出，本地还没存回执就退出。SQLite 和飞书、GitHub 没有共同事务，仍需稳定 ID、幂等、会话历史检查或渠道回查。Worker 自己执行的 Git 与 PR 操作也要在恢复时核对真实状态。这套机制不能保证所有操作严格只执行一次，也不是多个 Router 副本的分布式一致性协议。”
- 修改后：“上面的办法解决的是“本地还没写完就退出”。还有一种故障更难处理：消息已经发到飞书或 GitHub，本地还没来得及记下“已发送”，进程就退出了。重启后，Effects 队列里这条发送动作仍是未完成，直接重试就会把消息再发一遍。SQLite 的事务管不到飞书和 GitHub，两边没法一起提交或回滚，只能在重试前想办法确认：给每条消息一个固定 ID，让重复发送只生效一次；或者先查会话历史、回查渠道，看消息是否已经发出。Worker 自己做的 Git 提交和 PR 操作也一样，恢复时要先核对仓库和 PR 的实际状态，再决定是否重做。所以这套机制不能保证每个操作严格只执行一次；它也只管单个进程，不是多个 Router 副本之间的分布式一致性协议。”
- 修改原因：用户看不出“另一个窗口”指什么，也看不出它和上文的关系。
- 原因来源：用户原话。
- AI 推测：“窗口”承接首段的“故障窗口”，但中间隔了列表、图和边注，读者已接不上；原段也没说重试会导致重复发送。待确认。
- 技术依据：`docs/007-architecture.md`：Outbox 在事务中记录回执并排入 `reply` effect，提交后发送；`AgentDelivery` 按 request id 只投递一次，恢复的 Session 也适用；Runtime 锁定状态目录，单进程写入。
- 适用范围：本段。
- 改稿状态：已按要求修改，尚无用户评价。
- 偏好关联：无已确认的长期偏好。

## WF-20261103-10

- 文档与位置：`superagent.html`、`content/superagent.md`，第 03 节结尾引语及其后一句。
- 用户原话：“这一段在这里的意义是什么”（附页面截图）
- 修改前：“**任务记录一致，不代表任务归类正确。** 隔离、订阅和评审降低风险，合并前仍需要检查并行改动的关系。”
- 修改后：“**记录写对了，任务不一定分对了。** 前面的锁、事务和队列保证任务记录不会写乱，但两条消息是不是同一个问题，要靠 Router 判断，程序管不了。独立目录、订阅和代码评审能降低风险，两个 PR 合并前仍要检查它们是否重复，或者改到了同一处。”
- 修改原因：用户看不出这段在此处的作用；未进一步说明。
- 原因来源：用户原话。
- AI 推测：引语是第 03 节的收束，对应“事务保证记录不乱”和“重复任务靠 Router 判断”两部分，但“记录一致”“归类正确”过于抽象，读者联系不到前文。待确认。
- 适用范围：本处。
- 改稿状态：已按要求修改，尚无用户评价；同时向用户提出可整段删除的选项。
- 偏好关联：无已确认的长期偏好。
- 后续反馈：AI 提出可整段删除，用户回复“删掉”。已删除引语及其后的解释段。改稿状态：用户要求删除，已执行。

## WF-20261103-11

- 文档与位置：`superagent.html`、`content/superagent.md`，第 04 节图 3 之后一段的末句。
- 用户原话：“原文“一个人通常只能跟进 3～5 个活跃 Session”属于 dsh 的观察，未提供样本或对照，不能当作人的容量常数。 这句话没啥意义吧，你感觉呢”
- 修改前：“图中的 [2]～[6] 对应原文章节。……状态/环境分离与 Watchdog 处理持久运行。原文“一个人通常只能跟进 3～5 个活跃 Session”属于 dsh 的观察，未提供样本或对照，不能当作人的容量常数。”
- 修改后：删除末句，保留前文。
- 修改原因：用户认为这句话没有意义。
- 原因来源：用户原话。
- AI 推测：本文其他地方没有引用“3～5 个”这个数字，这句是在反驳一个读者没读到的说法，放在图 3 说明里也和上下文无关。待确认。
- 适用范围：本处。
- 改稿状态：已删除，尚无用户评价。
- 偏好关联：无已确认的长期偏好。

## WF-20261103-12

- 文档与位置：`superagent.html`、`content/superagent.md`，第 04 节“长命令运行时，还能接收新输入”图 10 之后两段。
- 用户原话：“这个表达的是什么，为什么还需实测”
- 修改前：“公开原型通过 Harness 的后台工具和输入投递使用这条路径，默认前台命令等待上限为 5 秒。用户不必等长命令完成再补充，但仍要等模型步骤边界。”“输出按信道组织：IM 给简短结论和需要人决定的事项，PR 与文档保存背景、改动和验证。原型设 IM 回复 100 词上限，普通进度留在内部，需要人行动的报告及时对外发送。消息减少是否节省了人工时间，仍需实测。”
- 修改后：“公开原型借助 Harness 实现这一点：长命令放到后台运行，新消息通过输入投递送进会话。Router 会话的前台命令和等待任务结果最多阻塞 5 秒，超时就先返回，不会一直占着会话。所以用户不必等长命令跑完才补充要求；但模型正在生成的这一步不会被打断，新消息要等这一步结束后才被读到。”“输出按渠道分工：IM 里只发简短结论和需要人决定的事；背景、改动内容和验证结果写在 PR 与文档里。原型限制每条 IM 回复最多 100 词，普通进度不发到群里，只有需要人处理的事才立即通知。这样群里的消息会少很多，但人是否因此省了时间还不知道：消息少了，人可能要更多地翻 PR 才能弄清情况，也可能漏看关键信息。原文的两组实验测的是耗时和 token，没有覆盖这一点。”
- 修改原因：用户看不懂两段在表达什么，也不明白为什么还需实测。
- 原因来源：用户原话。
- AI 推测：“使用这条路径”“模型步骤边界”指向不清；“仍需实测”没说要测什么、为什么不能直接推出。待确认。
- 技术依据：`docs/007-architecture.md` “Presets and wait limits”：新 main Session（Router）使用 `dsh-superagent-router` 预设，shell 命令和 job 等待 5 秒后返回；`src/app/sessions.ts` 的 `noWait`。原稿“默认前台命令等待上限”未限定会话，改稿限定为 Router 会话。IM 100 词来自 `IM_WORDS`（`src/app/tools/main.ts`）。`content/superagent-evidence.md` 无人工时间实验。
- 适用范围：本处。
- 改稿状态：已按要求修改，尚无用户评价。
- 偏好关联：无已确认的长期偏好。
- 后续反馈：用户原话“推不出来的东西就不要写了”。已删除 AI 推测的“人可能要更多地翻 PR、可能漏看关键信息”，结尾改为“人工时间是否因此减少，原文的实验没有测量。”5 秒限定为 Router 会话一处未被要求修改，保留。改稿状态：继续修改。

## 2026-11-03 · 博客协作工作流文章反馈

来源是本 session 中用户对 `blog-workflow.html` 的整体意见。

## WF-20261103-13

- 文档与位置：`blog-workflow.html`，全文结构、标题与开篇。
- 用户原话：“1. 这篇文章缺少特别好看符合题意的题图 2. 缺少流程图 整个文档缺少主题；我真正的目标是想解释两件事：1. 我的博客流程是什么样的，为什么这样行之有效 2. 具体的细节有哪些，我是如何做的”
- 修改前：标题“和 Agent 写博客：我的改稿意见怎么留下来”；开篇从 Super-agent 文章的一处改稿讲起，随后依次是九步流程、改稿记录、认可判断、长期偏好、检查，没有说明全文要回答什么。
- 修改后（AI 改稿）：标题改为“我和 Agent 写博客的流程，以及它为什么管用”；开篇说明全文讲两件事。第 1 节用图 1 泳道流程图讲九步与回头路，第 2 节分五点讲为什么管用（审阅只在两处、规则按任务读、一篇一个工作区、统一检查、改稿意见分开记），引用 PR 与 CI 记录；第 3 至 7 节讲具体做法，原 Super-agent 改稿例子移到第 4 节开头。新增题图与流程图。
- 修改原因：用户说明文章缺少主题，并给出要解释的两件事；题图和流程图属于配图要求。
- 原因来源：用户原话。
- AI 推测：原稿把改稿记录当成主线，流程本身和它为什么有效反而没有正面回答。待确认。
- 适用范围：本篇。题图与流程图的要求属于图示反馈，不作为文风证据。
- 改稿状态：已按要求修改，尚无用户评价。
- 偏好关联：无已确认的长期偏好。

## WF-20261103-14

- 文档与位置：`blog-workflow.html`，第 4 节六张改稿卡片的标签与状态说明；`assets/blog-workflow/cover.svg` 修改记录卡上的标签。
- 用户原话：“这里不用写AI推测：待确认，写博客文章是要给别人阅读的，所以需要一些委婉的表达，或者只说未来的终局；这里应该是改成AI分析和推测我真实想表达的AI味是什么”
- 修改前：每张卡片标“AI 推测 · 待确认”，状态写“我没有确认过”“原因未说明”“改稿我还没评价”。
- 修改后：标签改为“AI 分析：我真实想表达的 AI 味是什么”（WF-03）和“AI 分析：我真实想表达的是什么”（其余五张）；状态改为这条反馈归入哪条长期偏好。题图卡片上的“AI 推测 / 待确认”改为“AI 分析 → 偏好”。
- 修改原因：文章写给别人读，需要委婉的表达，或者只说最后的结果。
- 原因来源：用户原话。
- 适用范围：所有发布的文章，提炼为 WP-05；内部记录文件仍按反馈流程记录来源。
- 改稿状态：已按要求修改，尚无用户评价。
- 偏好关联：WP-05。

## WF-20261103-15

- 文档与位置：`blog-workflow.html`，原第 5 节“什么才算我认可了”（六道判断题）。
- 用户原话：“这个章节想表达什么，跟整体文章相关性是什么，可以不要吗”
- 修改前：用六道判断题说明“提交上线、提交指令、沉默”等情况不算用户认可文风。
- 修改后：整节删除，连同 `workflow.js` 的判断题交互与 `workflow.css` 的判断题样式。
- 修改原因：未说明；用户质疑这一节与全文主题的关系。
- 原因来源：未说明。
- AI 分析：这一节讲的是内部记录规则的边界，读者读完流程和五个做法后用不上，和“流程是什么、为什么管用、具体怎么做”两件事都不直接相关。
- 适用范围：本篇。
- 改稿状态：已删除，尚无用户评价。
- 偏好关联：无。

## WF-20261103-16

- 文档与位置：`blog-workflow.html`，原第 6 节“六处反馈，零条长期偏好”，及第 2 节“改稿意见留原话，不让 Agent 学错”。
- 用户原话：“这是啥啊，没有长期偏好的话，那怎么证明可以让这条流程完成呢，还是上面的问题，你应该说是AI把我的反馈，转成长期偏好”
- 修改前：标题“六处反馈，零条长期偏好”；正文说偏好文件一条规则也没有，表格列“候选”和“还要确认什么”。
- 修改后：标题改为“六处反馈，变成五条偏好”；正文说明 AI 把能用到下一篇的反馈整理成长期偏好，表格列偏好、来自哪些反馈、写作时怎么用。第 2 节小标题改为“反馈变成偏好”。同时把 WP-01 至 WP-05 写入 `content/writing-preferences.md`，并更新反馈流程说明。
- 修改原因：没有长期偏好，就证明不了这条流程能走完；应写成 AI 把用户的反馈转成长期偏好。
- 原因来源：用户原话。
- 适用范围：本篇正文，以及反馈流程本身（AI 负责把反馈整理成长期偏好）。
- 改稿状态：已按要求修改，尚无用户评价。
- 偏好关联：WP-01 至 WP-05 由本条要求产生。

## WF-20261103-17

- 文档与位置：`blog-workflow.html`，原第 8 节“还没做完的”。
- 用户原话：“没做完的别说了，这篇博客给谁看，主体是什么”
- 修改前：列出四项未完成事项：偏好未确认、样本少、数字只覆盖两天、Markdown 生成器未写。
- 修改后：整节删除；结尾改为第 7 节“想照着做，从这五件事开始”，按开篇的五个做法给读者五条可以照做的步骤。
- 修改原因：未说明具体原因；用户提醒读者是谁、文章主体是什么。
- 原因来源：用户原话。
- AI 分析：读者是想和 Agent 合写博客或文档的人，主体是这套流程和它管用的原因；未完成的内部事项对他们没有用。
- 适用范围：所有发布的文章，并入 WP-05。
- 改稿状态：已按要求修改，尚无用户评价。
- 偏好关联：WP-05。

## WF-20261103-18

- 文档与位置：`blog-workflow.html`，标题、开篇排版与全文结构；`content/original-articles.json`、`content/seo.json`、`content/og-images.json`。
- 用户原话：“然后你再思考一下之前我让你去总结好的文章结构应该是什么样的，是不是用户读完还能记住之前说的内容，你感觉这篇文章你做到了吗”；“我和 Agent 写博客的流程，以及它为什么管用 这个标题你觉得起的好吗，能吸引人吗。然后title和题图的排版，你觉得遵守之前的研究了吗”
- 修改前：标题“我和 Agent 写博客的流程，以及它为什么管用”，标题、题图、引言上下堆叠；五个做法只在第 2 节出现一次，结尾是未完成事项。
- 修改后：标题改为问题句“我只看两次稿，文章是怎么上线的？”，副标题“和 Agent 合写博客：九步流程与五个做法”；开篇改为 kicker、标题、副标题、导语与题图左右并排（700px 以下上下排列）。引言先点出五个做法的短名，第 2 节小标题与之对应，第 7 节按同样五个短名收尾。
- 修改原因：未说明；用户以提问指出标题吸引力、排版和可记忆性的问题。
- 原因来源：未说明。
- AI 分析：原标题只描述内容，没有问题或结果来吸引读者；排版没有沿用 Super-agent 的“问题标题＋副标题＋导语＋题图并排”。要点只出现一次，读者读完难以复述。
- 适用范围：本篇。
- 改稿状态：已按要求修改，尚无用户评价。
- 偏好关联：无。

## WF-20261103-19

- 文档与位置：`blog-workflow.html`，开篇引言、导航与新增第 1 节。
- 用户原话：“缺少背景，我的博客的技术架构，纯 html，通过ghpage部署，通过cludeflare来监控性能，评论区控件xxx，是个纯静态站，相对传统的博客站这样做的好处是性能好，灵活度比较高，可以自由定制页面；但是这样带来的坏处就是站点的样式由agent来控制的话会比较不受控，balablaxxx ，所以需要一套与AI的协作方案”
- 修改前：开篇直接进入九步流程，没有交代博客的技术架构，读者不知道为什么需要这套协作方式。
- 修改后：新增第 1 节“纯静态博客，自由也容易走样”：架构（原生 HTML/CSS/JS、GitHub Pages、Python 生成脚本、Cloudflare Web Analytics、giscus）、好处（快、可按篇定制）、代价（样式由 Agent 改容易走样，引用三处真实反馈；新会话记不住意见），最后引出协作方案；后续章节顺延编号，引言与导航同步更新。
- 修改原因：缺少背景；纯静态站自由但样式不受控，所以需要与 AI 的协作方案。
- 原因来源：用户原话。
- AI 分析：读者先要知道“为什么需要流程”，五个做法才有对象；背景里的问题应当与第 3 节五个麻烦对应。
- 适用范围：本篇；写工作流类文章时先交代问题背景。
- 改稿状态：已按要求修改。
- 偏好关联：WP-01。

## WF-20261103-20

- 文档与位置：`blog-workflow.html`，开篇 kicker “WORKFLOW · BLOG × AGENT”。
- 用户原话：“这里是啥，为啥颜色是这样，不应该是红色的tag吗”
- 修改前：kicker 样式已是 10px 等宽、强调红；页面引用 `workflow.css` 与 `workflow.js` 未带版本号，GitHub Pages 缓存 600 秒，浏览器可能仍用旧样式，显示为深色无衬线文字。
- 修改后：两处引用加 `?v=2`，样式更新后浏览器重新下载。
- 修改原因：截图颜色与设计不符。
- 原因来源：用户提问。
- AI 分析：问题出在样式缓存，不在文字；kicker 是栏目标签，沿用 Super-agent 开篇的红色等宽小字，不带边框。
- 适用范围：本篇；文章专属 CSS/JS 修改后同步更新版本号。
- 改稿状态：已修改。
- 偏好关联：无。

## WF-20261103-21

- 文档与位置：`about.html`，全页结构。
- 用户原话：“工作经历可以去掉，我想了下，还是得有个炫酷或者个性化点的介绍只要写一些核心项目就行了”
- 修改前：按简历组织：个人简介、擅长（5 项）、工作经历（字节、菜鸟、阿里云、国际 UED 各列要点，2012–2016 合并为“更早”）、教育、相关文章。
- 修改后：开头改为“你好，我是胡正伟。”，加一句个人定位；下方用终端样式（`whoami`、`git log`、`cat motto.txt`）交代身份和年份线；正文只留五个核心项目，每个配一个关键数字和一段说明；去掉擅长、工作经历和教育。
- 修改原因：要个性化的介绍，不要简历式的工作经历。
- 原因来源：用户原话。
- AI 分析：关于页给读者认识作者，不是给招聘方核对履历；读者要记住的是“这个人做过什么、关心什么”，逐段经历和技能清单记不住。
- 适用范围：本页。
- 改稿状态：已按要求修改，尚无用户评价。
- 偏好关联：无。

## WF-20261103-22

- 文档与位置：`about.html`，介绍区引导语与下方说明段。
- 用户原话：“写了十多年代码，做过全栈，最爱的还是javascript的所见即所得；现在在通过AI探索更多可能；”（用户直接给出替换文字，附当前介绍区截图）
- 修改前：引导语“写了十四年代码，做的大多是字段多、联动多、每条业务线规则都不一样的系统。”；说明段“商品发布表单、政务低代码编辑器、采购报价单都是这类系统。现在我把 Agent 接进研发流程，想看它能不能接住这种复杂度，这个博客记录我看到的结果。”
- 修改后：引导语改为“写了十多年代码，做过全栈，最爱的还是 JavaScript 的所见即所得。现在通过 AI 探索更多可能。”；删去说明段。SEO 摘要同步改为“十多年”“最爱 JavaScript 的所见即所得”“通过 AI 探索更多可能”。
- 修改原因：未说明。
- 原因来源：未说明。
- AI 分析：用户想先讲自己喜欢什么，再讲做过什么。“十多年”比“十四年”随意，读起来像自我介绍；“所见即所得”是用户对前端的偏爱，原句只写了工作内容。项目细节由下方能力圈和项目列表交代，说明段就删了。按中文排版习惯，JavaScript 首字母大写、中英文之间加空格，原句末的分号改为句号。
- 适用范围：本页。
- 改稿状态：已按用户给出的文字修改，尚无用户评价。
- 偏好关联：无。

## WF-20261103-23

- 文档与位置：`content/about-map.json`（生成到 `about.html` 能力圈），工程化、复杂表单、前端架构三格的副标题与点开后的说明。
- 用户原话：“工程化：AI友好型工程； 复杂表单：东半球最复杂的表单系统；前端架构：BFF，低代码平台，SDK，微前端”；之后“一起改成新说法吧”。
- 修改前：副标题“20 → 5 个仓库”“60+ 字段 · 50+ 联动”“动态表单 · 低代码 · 微前端”；说明“菜鸟驿站收敛存量仓库，统一 React、Vue 和组件库；在阿里做过 oly-cli 研发交付工具集。”“一直在做字段多、联动多的业务前端：淘宝天猫商品发布、政务低代码、采购报价单。”
- 修改后：副标题“AI 友好型工程”“东半球最复杂的表单系统”“BFF · 低代码平台 · SDK · 微前端”；工程化说明改为“让仓库适合 Agent 接手：规则写进 AGENTS.md，改完一条命令跑完全部检查，这个博客就这样维护。早先在菜鸟驿站把 20 多个仓库收敛到 5 个。”；前端架构说明改为“写过 BFF；做过阿里云政务低代码平台、淘宝天猫商品发布 SDK（10 多条业务线接入），政务事项中心用微前端交付给不同省市。”；复杂表单说明保留数字，只补“淘宝天猫”。
- 修改原因：未说明。
- 原因来源：未说明。
- AI 分析：用户想让副标题说出自己的定位和态度，而不是罗列指标；“东半球最复杂”是有意的夸张，带个性。数字仍留在点开后的说明里，作为夸张的底气。工程化说明的例子取自本站《我只看两次稿，文章是怎么上线的？》，前端架构的业务线数取自本页项目列表。
- 适用范围：本页。
- 改稿状态：副标题按用户给出的文字修改；说明为 AI 改稿，尚无用户评价。
- 偏好关联：无。

## 2026-11-02 反馈的归纳

以下是 AI 从上述例子中提炼的方向。2026-11-03 按用户要求（WF-20261103-16）整理为[个人写作偏好](./writing-preferences.md) WP-01 至 WP-04；表格保留当时的边界说明，供以后修订偏好时参考。

| 候选 | 对应例子 | 仍需确认的边界 |
| --- | --- | --- |
| 先讲具体场景和动作，再解释抽象概念。 | WF-20261102-03、WF-20261102-06 | 是这些段落的处理方式，还是普遍适用于后续技术博客？ |
| 写清分工、转折和实际需要，避免把若干名词并列当作解释。 | 用户在 WF-20261102-03 中的自写句子；WF-20261102-05 的难读反馈 | 对“而”“还是得”的解释尚为 AI 归因，不能机械套词。 |
| 实验边界用具体事实说清楚，不把多项限制压成一串备注。 | WF-20261102-05 | AI 改稿尚无评价，不能认定拆分方式已获认可。 |
| 图注和结尾只保留对本篇有用的信息。 | WF-20261102-02、WF-20261102-04 | 两处删除要求成立，进一步的“有用”判断标准仍待确认。 |

配图不和谐、图片过宽、箭头奇怪，以及并行提交与 PR 冲突的问题，属于图示和交付反馈，见[博客发布流程](./blog-publishing-workflow.md)，不作为个人文风证据。


## WF-20261103-24

- 文档与位置：`README.md`，整体结构。
- 用户原话：“ok，改掉吧，README.md 放个首页的截图吧，其他有的没得可以不用放了，移到其他文档去，写个简介啥的”
- 修改前：README 包含发布、工程目录、SEO、访问统计、性能、Skill、评论、Issues 迁移、学习页和 Super-agent 研究资产的详细说明。
- 修改后：保留博客简介、站点入口、首页截图、本地预览命令与维护文档入口；详细说明移到 `content/repository-guide.md`。
- 修改原因：“其他有的没得可以不用放了，移到其他文档去”。
- 原因来源：用户原话。
- AI 分析：仓库首页先帮助读者认识博客和看到页面；维护细节由独立文档提供，README 只保留入口。
- 适用范围：本仓库 README。
- 改稿状态：已按要求修改，尚无用户评价。
- 偏好关联：无。


## WF-20261104-01

- 文档与位置：工作对话的说明方式；未指定具体文稿。
- 用户原话：“我发现你在干活的时候也非常喜欢这样干，写一堆免责声明啥的，很烦，你思考一下怎么优化”
- 修改前：未提供具体对话原句；附图批评界面中过多的小字说明、辅助标签与描述，作为理解反馈的参考。
- 修改后：拟采用“已修复，检查通过。”等直接表达；仅在确有影响时补充具体事实，例如“移动端尚未预览。”这些为 AI 拟写示例，并非对本次仓库工作的结果陈述。
- 修改原因：“写一堆免责声明啥的，很烦”。
- 原因来源：用户原话。
- AI 分析：过多的自我解释、预防性质的声明和重复保证增加阅读负担。每条说明应有明确用途：影响判断、指导操作或提出必要决策。界面里的同类问题优先通过布局和命名解决。附图中的建议作为参考材料，不视为用户逐条要求执行。
- 适用范围：工作对话、交付说明；界面文案为结合附图的归纳。
- 改稿状态：已记录偏好与拟写示例，尚无用户评价。
- 偏好关联：WP-06。
