xiangyun0519/dsh-trace-narrator

README 摘要

dsh-trace-narrator 面向 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 发布状态： Windows 请把最后一行替换为实际绝对路径，例如 link:F:/deepseek/dsh-trace-narrator/dsh-trace-narrator 。安装后重启 dsh。 从 npm 安装 npm 包发布后使用： 如果返回 package not found ，说明当前版本还没有发布到 npm；请先使用上面的源码安装方式。发布和验收步骤见 docs/release.md。 第一次使用 在任意 DSH 会话中运行： 默认行为：当前会话 → summary schema → strict 脱敏 → 自包含 HTML → 对话内报告链接。DSH agent/inbox 能力可用时，还会让对话模型在下一轮复述；headless 或裁剪环境仍返回本地报告。 常用变体： 能解决什么 - 复盘一次 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 插件，…

分类