前言¶
代理完成任务后往往会输出一段技术文本,包含文件名、代码、路径和术语。如果你不阅读代码,很难快速判断任务是否成功,或者需要从哪一步开始跟进。dsh-plugin-brief 将每个代理回复转换成简报幻灯片:结论先行,随后是步骤,最后是需要你处理的提问。原版文本始终保留在侧边,供需要时查看。
插件简介¶
这是一个 DeepSeek Harness 插件,旨在为不阅读代码的 Harness 用户提供更易读的回复视图。它将原本的技术文本重新排版为幻灯片形式,并提供了“通俗化”重写功能。
- 维护者:dangxinxing090-svg
- 许可协议:MIT
- 目录页:https://www.skillhub.cn/plugins/dangxinxing090-svg/dsh-plugin-plain-slides
- 源码地址:https://github.com/dangxinxing090-svg/dsh-plugin-brief
核心功能¶
- 幻灯片化展示:回复内容被拆分为几张幻灯片。第一页为结论,中间为执行步骤,最后一页为待处理的问题或请求。
- 通俗化重写:提供“通俗化”按钮,将结论和步骤翻译为通俗语言。重写仅针对报告内容,不包含工作过程。
- 本地布局,零成本:默认情况下,幻灯片在本地根据原文自动排版,不消耗模型调用。
- 按需重写:只有当你点击“通俗化”按钮时,才会发起一次模型调用。重写成功后会被保留,再次查看无需额外付费。
- 双版本保留:卡片中会同时保留原文版和通俗化版,可以通过按钮切换,原版始终可点击查看。
安装与启用¶
在安装前,请确保你的机器上已安装 DeepSeek Harness (dsh)。
- 执行以下命令安装插件:
dsh plugin --profile web add github:dangxinxing090-svg/dsh-plugin-brief
安装后,插件会自动挂载,无需配置文件。
- 如果希望指定版本,可以追加标签:
dsh plugin --profile web add github:dangxinxing090-svg/dsh-plugin-brief#v0.1.0
- 重启
dsh进程使插件生效。
--profile web 中的 web 可以替换为你使用的其他配置文件名称(如 tui)。
典型用法¶
安装完成后,代理的每条回复都会以幻灯片形式展示在回复卡片上。
- 查看默认视图:卡片默认显示为“原版”幻灯片布局。
- 请求重写:在卡片上点击“通俗化”按钮。此时卡片标题会显示“通俗化中…”。
- 查看结果:
- 若重写成功,按钮变为“原版”,表示当前显示的是通俗版,点击可切换回原版。
- 若重写失败,按钮恢复为“通俗化”,但布局依然保留(只是未简化)。
- 查看完整原文:点击卡片顶部的“完整原文”按钮,可查看包含技术摘要(耗时、操作数、Token 使用量)的完整 Markdown 原文。
工作原理与成本¶
- 渲染劫持:插件接管了回复渲染器,将原本的 Markdown 直接渲染改为幻灯片卡片。
- 折叠工作过程:插件会隐藏工具行、推理折叠、注入上下文等干扰信息,只保留必要的对话过程(如失败信息、审批请求等),这些信息会被保留在 Trajectory 视图中。
- 成本控制:
- 默认查看幻灯片不产生费用。
- 只有点击“通俗化”时,才会调用模型翻译报告内容。
- 重写成功后,该结果会被缓存,再次查看或重启 DSH 后无需再次调用模型。
注意事项¶
- 配置文件编辑:不要手动编辑
cordis.yml(该文件由系统生成),请编辑cordis.patch.yml。 - 发布一致性:如果你 Fork 该插件并发布自己的版本,必须保持
package.json中的name与cordis.patch.yml中的name一致,否则加载器无法解析模块。 - 安全检查:插件以当前 DSH 进程的权限运行,安装前请检查源码与许可证。