dsh-trace-narrator
DSH 插件：把会话轨迹变成可分享、可复盘、可教学的结构化报告（脱敏 + LLM 总结，HTML/MD/JSON 输出）
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:xiangyun0519/dsh-trace-narrator#ee8e8eebd08268220155d4304a71403648782609Trace Narrator 以 dsh-trace-narrator 发布，当前版本为 1.2.2。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
面向 DeepSeek Harness（DSH）开发者：把一次会话 trajectory 变成脱敏的 HTML、Markdown 或 JSON 复盘报告。
如果你需要回答“这次会话做了什么、哪里失败、哪些步骤值得交接或教学”，这个插件给出一条命令和一份可读报告。先看一个完全虚构、已脱敏的输出：示例报告。
前置条件：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 包发布后使用：
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
summary、postmortem、tutorial、debug、executive 报告--redact off 时会关闭这层保证这是 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 或包含个人信息的报告。