前言¶
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_appbundle 中)。若未安裝該依賴,命令會返回明確的錯誤信息。 - 會話要求:會話中必須至少包含一個已完成的步驟(
step/end),否則無法生成摘要。 - 文件路徑:SVG 文件是相對於 Harness 進程的當前工作目錄,而非項目目錄。
- 資源消耗:命令不消耗 Token,不會進入模型歷史記錄,不涉及額外持久化數據。
結語¶
dsh-wrapped 通過純函數邏輯計算統計數據並渲染 SVG,不依賴運行時環境,邏輯單元可測試。它利用 DSH 本身的會話投影數據,無需額外的跟蹤機制。