前言¶

DSH 开发者在处理会话轨迹时，往往需要一份结构化的复盘材料。手动整理耗时且容易遗漏关键步骤。下面介绍 dsh-trace-narrator 插件，它可以直接将一次会话轨迹转化为脱敏的报告。

这是什么¶

这是一个 DSH 插件，由 xiangyun0519 维护。它的功能是把一次会话 trajectory 变成脱敏的结构化报告，支持 HTML、Markdown 和 JSON 输出。

核心功能¶

该插件提供以下能力：

• 生成结构化报告。
• 支持 HTML/Markdown/JSON 输出。
• 内置 5 套 schema。
• 支持中英日三语。
• 默认严格脱敏。
• 数据不出本地。
• Agent/Inbox 集成复述总结。
• Schema 校验。

安装与启用¶

安装命令如下：

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

安装完成后，在任意 DSH 会话中即可使用。

典型用法¶

• 基础使用，默认生成当前会话的结构化报告：

    /trace-narrate

• 指定会话、schema、语言和格式：

    /trace-narrate sess_abc --schema postmortem --lang en --format md

• 使用自定义 schema 并调整脱敏级别：

    /trace-narrate --schema ./my-schema. --redact minimal

• 指定输出格式和本地路径：

    /trace-narrate --format  --output ./trace-narrate

适用场景与注意¶

该插件适合复盘会话、交接或教学场景，利用内置 schema 将长 trajectory 压缩后交给 LLM 总结并生成报告。

需要注意以下几点：

• 这是一个本地插件，不是公共在线报告站点。
• 插件不负责实时采集、多会话合并或云端 viewer。
• 报告默认落在本地；需要多人访问时，请自行提供受控的 viewer 和上传端点。
• 默认严格脱敏，上传是 opt-in 且只接受 HTTPS。
• 使用前应检查源码与许可证。

结尾¶

该插件通过命令行接口即可生成合规的结构化报告，适合需要在本地处理轨迹数据的开发者。相关代码与文档可前往 GitHub 仓库 查看。