dsh-trace-narrator

August 22, 2026 · View on GitHub

npm version CI license node DSH

面向 DeepSeek Harness（DSH）开发者：把一次会话 trajectory 变成脱敏的 HTML、Markdown 或 JSON 复盘报告。

如果你需要回答“这次会话做了什么、哪里失败、哪些步骤值得交接或教学”，这个插件给出一条命令和一份可读报告。先看一个完全虚构、已脱敏的输出：示例报告。

30 秒开始

前置条件：Node.js ≥ 20、DSH cordis v4，以及 @deepseek-ai/dsh-commands / @deepseek-ai/dsh-settings ≥ 0.1.0-rc.6。

从源码安装

当前仓库可以直接验证，不依赖 npm 发布状态：

git clone https://github.com/xiangyun0519/dsh-trace-narrator.git
cd dsh-trace-narrator
pnpm install
pnpm build
dsh plugin --profile web add link:/absolute/path/to/dsh-trace-narrator

Windows 请把最后一行替换为实际绝对路径，例如 link:F:/deepseek/dsh-trace-narrator/dsh-trace-narrator。安装后重启 dsh。

从 npm 安装

npm 包发布后使用：

dsh plugin --profile web add dsh-trace-narrator

如果返回 package not found，说明当前版本还没有发布到 npm；请先使用上面的源码安装方式。发布和验收步骤见 docs/release.md。

第一次使用

在任意 DSH 会话中运行：

/trace-narrate

默认行为：当前会话 → summary schema → strict 脱敏 → 自包含 HTML → 对话内报告链接。DSH agent/inbox 能力可用时，还会让对话模型在下一轮复述；headless 或裁剪环境仍返回本地报告。

常用变体：

/trace-narrate sess_abc --schema postmortem --lang en --format md
/trace-narrate --schema ./my-schema.json --redact minimal
/trace-narrate --format json --output ./trace-narrate

能解决什么

  • 复盘一次 DSH 会话：目标、关键步骤、决策和结果
  • 生成适合交接或教学的 summary、postmortem、tutorial、debug、executive 报告
  • 将长 trajectory 压缩后再交给 LLM，总结输出通过 schema 校验
  • 默认 strict 脱敏，支持 HTML、Markdown、JSON 三种输出
  • 在 DSH agent/inbox 能力可用时，让对话模型在下一轮复述总结并给出后续动作建议
  • 可选地把已脱敏报告上报到自托管 viewer；关闭 viewer 上报不会向 viewer 发送报告，但 LLM 总结或 HTTPS schema URL 仍可能联网

安全边界

  • 默认 strict 配置下，trajectory 在发送给 LLM 前先脱敏；使用 --redact off 时会关闭这层保证
  • LLM 输出在写盘、inbox 和上传前再次脱敏
  • HTML 动态内容全量转义；报告使用自包含资源，不依赖第三方脚本
  • 上传是 opt-in，且只接受 HTTPS；Bearer token 只从环境变量读取
  • 审计日志只记录检测器、计数和事件序号，不记录原文

不负责什么

这是 DSH 插件，不是公共在线报告站点。当前版本不负责实时采集、多会话合并、云端 viewer、公共知识库或 dsh 会话存储。报告默认落在本地；需要多人访问时，请自行提供受控的 viewer 和上传端点。

文档与示例

文档内容
示例报告不安装 DSH 也能看到的输出样例
使用文档安装、命令、配置、退出码、审计与安全模型
发布指南打包、npm 发布、GitHub Release 和发布后检查
设计文档架构、运行时契约、数据流和版本计划
脱敏规则级别、检测器、占位符和审计日志
Schema 说明内置 schema、自定义加载、校验与重试
自定义 schema可直接复制的 JSON Schema 示例
变更记录版本历史

本地开发

pnpm install
pnpm test        # Vitest
pnpm typecheck   # tsc --noEmit
pnpm build       # tsup → lib/
pnpm pack --dry-run

发布前请按 docs/release.md 完成测试、打包和安装验证。CI 会在 push 和 pull request 上重复这些检查。

反馈

请在 GitHub Issues 中提供：DSH 版本、插件版本、命令、错误信息和可复现步骤。不要提交原始 trajectory、token、API key 或包含个人信息的报告。

License

MIT