DeepSeek Harness 插件：dsh-wrapped

前言¶

DeepSeek Harness (dsh) 插件：dsh-wrapped。输入 /wrapped 生成可分享的 SVG 总结卡片。

DSH 会话中包含真实的统计数字，例如工具调用与思考的耗时对比、流式生成的速度等，但通常只以小统计条展示，容易被忽略。dsh-wrapped 将这些数字转化为深色的、适合截图的卡片，用于直接分享。

功能¶

• 生成可分享的 SVG 总结卡片：输出用于展示的图形化摘要。
• 统计回合和步数：记录会话的基本规模。
• 对比工具耗时与思考耗时：区分模型推理时间与外部工具调用时间。
• 计算平均首字生成时间：评估首字响应速度。
• 计算解码速度：以 tokens/sec 为单位统计生成速率。
• 判定会话类型：根据工具耗时与思考耗时的比例，判定为 Explorer（探索者）、Deep Thinker（深思者）或 Balanced Operator（平衡操作员）。

安装与配置¶

安装插件：

dsh plugin --profile <name> add dsh-wrapped

插件默认不会立即生效，需将其添加到配置文件的 bundles 列表中：

{
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "dsh-wrapped"
      ]
    }
  }
}

确认配置是否生效，可使用 dsh --profile <name> --dump-config 命令查看是否有 wrapped 配置项。

可选配置文件位于 profiles/<name>/cordis.patch.yml：

- insert:
    - id: wrapped
      name: 'dsh-wrapped'
      config:
        minDecodeSampleMs: 1000
        verdictRatioThreshold: 1.5

• minDecodeSampleMs：低于此毫秒数（默认 1000ms），解码速度显示为 —，避免样本过小导致数据噪点。
• verdictRatioThreshold：工具耗时与思考耗时的比值阈值（默认 1.5），超过此值判定为 Explorer 或 Deep Thinker，否则为 Balanced Operator。

用法¶

在任意会话中输入 /wrapped。

命令执行后会：
1. 生成一个 SVG 文件，路径为 .dsh-wrapped/wrapped-<sessionId>-<timestamp>.svg。
2. 在终端输出纯文本摘要及文件路径。
3. 在浏览器中打开该 SVG 文件，截图或转换为 PNG 格式即可分享。

注意事项¶

• 依赖项：需要 @deepseek-ai/dsh-session-stats 依赖（默认包含在 dsh-web_app bundle 中）。若未安装该依赖，命令会返回明确的错误信息。
• 会话要求：会话中必须至少包含一个已完成的步骤（step/end），否则无法生成摘要。
• 文件路径：SVG 文件是相对于 Harness 进程的当前工作目录，而非项目目录。
• 资源消耗：命令不消耗 Token，不会进入模型历史记录，不涉及额外持久化数据。

结语¶

dsh-wrapped 通过纯函数逻辑计算统计数据并渲染 SVG，不依赖运行时环境，逻辑单元可测试。它利用 DSH 本身的会话投影数据，无需额外的跟踪机制。

• 目录页：https://www.skillhub.cn/plugins/rand0wn/dsh-wrapped
• GitHub 仓库：https://github.com/rand0wn/dsh-wrapped