dsh-story

3 分钟看懂 DeepSeek Harness 的一次运行。

这是一个 DeepSeek Harness 插件：把你和 Agent 的每一轮对话，重建成一条可读的故事线——你提出了什么、Harness 装配了什么上下文、模型为什么调用工具、工具执行的结果如何流回模型、回答如何形成。每个结论都挂着证据序号，可以一直下钻到原始事件。

安装

需要 DeepSeek Harness 0.1.0-rc.6 和 pnpm:

dsh plugin --profile web add dsh-story

然后在 Harness 里打开任意会话，切到「运行审查」视图。

第一次打开、会话还没有内容时，你会看到一次内置的示例运行——工具失败、多工具并行、MCP 调用都在里面，可以直接点开每一拍熟悉界面；你的会话产生事件后自动切换为真实运行。

你会看到什么

• 章节流:一次运行 = 序幕（会话准备）+ 每轮一章 + 实时跟随。异常章和进行中章自动展开，其余收成目录卡，顶部锚点直达。
• 因果嵌套：模型决定调用的工具，缩进挂在它的决策之下——谁触发了谁，静止可读，不需要点任何高亮。
• 来龙去脉：打开任意动作的详情，可以看到「由谁触发 / 触发了谁 / 产生了哪条回答」，点击直接跳转。
• 每轮体检：模型路由、Token 用量、上下文压力、工具成败，以及带证据序号的开发诊断。
• 教学注释：每一拍都有一行小字解释这一步在 Harness 执行流程中的职责；术语（上下文、系统指令、工具定义……）保留原词，悬停有解释。

证据纪律

• 「已观测 Observed」来自官方事件；「已推导 Derived」来自确定性关联或统计；当前版本不生成推测。
• 没有独立记录的耗时和指标显示「未记录」，不编数。
• 每条诊断必须能展开到证据事件；底层事实折叠但不丢弃，覆盖率数字（N 条已解释 / M 条技术事实）随时可核对。
• 官方 Session Log 始终是原始事实来源，本插件不复制、不替代它。

兼容基线

首个发布系列以 DeepSeek Harness 0.1.0-rc.6 为编译和运行基线，事件编目（packages/core/src/known-events.ts,44 种事件）与该版本逐一对齐。Harness 升级后如果出现未知事件，会以「未编目」形式显式呈现并记入诊断，不会静默丢失。

安全说明

插件以当前用户权限运行，默认不联网、不上传 Session 内容；页面直接读取当前已认证 Session 中的原始事实，折叠只服务阅读层级，不承担脱敏职责。进入审查页即代表使用与 Session Log 相同的本地信任边界。

工作区

包	职责
dsh-story-contracts	Host、Client 和扩展共同使用的版本化数据协议
dsh-story-core	纯函数事件折叠、诊断和语义辅助逻辑
dsh-story-host	注册 DeepSeek Session Projection 单元
dsh-story-client	运行审查整页视图和客户端增量语义图
dsh-story	可由 dsh plugin --profile <name> add 安装的组合包

本地开发

pnpm install
pnpm check   # typecheck + 测试 + 构建

本地源码开发时，把组合包、Host 插件和 Client 插件同时 link 到独立的 Web profile:

dsh plugin --profile web add \
  link:$PWD/packages/bundle \
  link:$PWD/packages/host \
  link:$PWD/packages/client

真正决定装配关系的是组合包内的 cordis.patch.yml。设计文档见 docs/architecture/，开发交接见 docs/dev-handoff.md。

License

MIT