dsh-plugin-brief: Convert DeepSeek Harness Responses into Slides

前言¶

DeepSeek Harness (DSH) 是一个用于智能体开发的工具。智能体完成任务后，通常输出大量技术文本，如文件路径、代码片段和复杂说明。对于不阅读代码的用户，这些内容难以快速获取核心结论。dsh-plugin-brief 旨在解决这个问题，它提供了一种替代的阅读方式，将技术文本转化为简短幻灯片。

插件介绍¶

这是一个 DeepSeek Harness 插件，插件 ID 为 brief，由 dangxinxing090-svg 维护，采用 MIT 许可证。它不改变智能体的原始输出逻辑，而是接管了渲染流程，为每个回复提供幻灯片视图。

核心功能¶

插件主要提供以下功能：

幻灯片视图：将每个代理回复转换为幻灯片。优先展示结论、后续步骤以及等待用户决策的问题。
本地渲染：默认情况下，回复以幻灯片形式在本地渲染，不产生调用成本。
通俗化重写：提供“通俗化”按钮，将当前技术文本重写为通俗语言。
重试机制：重写失败时，插件会自动重试，最多重试 3 次。
信息过滤：在对话流中隐藏工具行、系统提示、推理过程折叠等内部细节，仅保留 Trajectory（轨迹）。
历史保留：成功的历史翻译会保留，再次查看时无需重新调用模型。

安装与启用¶

使用以下命令安装插件：

dsh plugin --profile web add github:dangxinxing090-svg/dsh-plugin-brief

安装后需要重启 dsh 才能生效。包目前不在 npm 上，只能通过 GitHub 仓库安装。

如果需要手动安装，请执行以下步骤：

    cd ~/.dsh/profiles/web

安装包：

    pnpm add github:dangxinxing090-svg/dsh-plugin-brief

编辑 cordis.patch.yml 文件，添加插件配置：

    - insert:
        - id: brief
          name: 'dsh-plugin-brief'

重启 dsh。

典型用法¶

在 DSH 界面中，安装插件后，回复区域会显示为幻灯片卡片。用户可以点击“通俗化”按钮将技术文本重写为通俗语言，或点击“完整原文”查看原始 Markdown。

配置插件行时，必须包含 id: brief 和 name: 'dsh-plugin-brief'。如果需要完全移除重写按钮，可以在配置中设置 disabled: true。

卸载插件的命令如下：

dsh plugin --profile web remove dsh-plugin-brief

适用场景与注意¶

适用场景：适合需要向非技术背景人员汇报智能体工作结果的场景，或者需要快速浏览工作结论的场景。
配置文件：编辑 cordis.patch.yml 时，不要修改 cordis.yml（后者是生成的）。
成本与性能：默认情况下回复成本为 0，仅在点击“通俗化”时调用模型。仅翻译最后一步的报告，不翻译工作过程。滚动回不重新请求。
权限：插件以当前 dsh 进程的权限运行，安装前应检查源码与许可证。

短结尾¶

该插件通过改变默认显示方式，降低了非技术用户阅读 DSH 输出的门槛。更多细节和源码，请参考 GitHub 仓库。