前言¶

DeepSeek Harness（DSH）的理念是「一切皆插件」。對 DSH 或智能體開發者來說，日常開發中經常會遇到幾類問題：對話記錄難以導出和歸檔，長任務上下文跨對話傳遞不方便，API 調用成本缺少統一管理，歷史對話檢索不夠直接，Prompt 調優、多模型對比、任務編排和安全審計也往往需要分散處理。

dsh-companion-dev 是 beijingwahw 維護的 DeepSeek Harness 官方伴侶插件，基於 Cordis 框架與 Harness Plugin SDK 構建。它提供對話智能導出、上下文交接摘要、API 成本優化、全局對話檢索、執行軌跡分析、Prompt 工程工作臺、多模型競技場、任務編排與安全審計九大能力。下面介紹它的定位、安裝方式、典型用法和注意事項。

這是什麼¶

• 倉庫：beijingwahw/dsh-companion-dev
• 許可證：MIT
• 定位：DeepSeek Harness 官方伴侶插件，開發者版包含資料中列出的九個模塊
• 精簡版：若只需要 A–D 四大基礎模塊，可參考 beijingwahw/dsh-companion
• 運行框架：DeepSeek Harness，Cordis ≥ 4.0
• 開發語言：TypeScript，strict: true，ESM
• 前置要求：DeepSeek Harness >= 0.1.0；Node.js ^22.19 || >=24
• 數據位置：用戶數據僅存於 Harness 插件沙箱本地
• 密鑰存儲：API Key 以 AES-256-GCM 加密落盤
• 包名：dsh-companion；manifest id 爲 deepseek-companion
• 模塊關係：九個模塊均爲獨立 Cordis 子插件，可任意組合啓停，互不影響

資料中列出的功能編號爲 A、B、C、D、E、F、G、H、J。

核心功能¶

A · 對話智能導出¶

支持將對話導出爲 Markdown、PDF、JSON、PNG 長圖，提供時間戳開關和隱私脫敏，也支持多會話批量 ZIP 打包。

B · 上下文交接摘要¶

支持生成不超過 500 字的四段式摘要，並可編輯、複製到剪貼板、保存爲模板。也可以將摘要導入新對話，作爲 system 角色首條消息，用於上下文交接。

C · API 成本優化¶

提供 API Key 加密託管、官方動態計價、峯谷分時計價、峯谷自動調度、模型智能路由、日/月雙檔預算，以及 Token 消耗與費用報表。

D · 全局對話檢索 + 對話內搜索¶

支持關鍵詞模糊搜索、時間範圍篩選、標籤篩選，搜索結果可直達對話。對話內也提供浮動查找欄。

E · 執行軌跡分析器¶

提供軌跡時間軸，可定位最慢與最貴的 3 個步驟，支持異常標註、兩次軌跡 Diff、日聚合趨勢與基準線告警。

F · Prompt 工程工作臺¶

提供 Prompt 版本管理、A/B 測試、模板庫，以及結構化輸出 JSON Schema 批量校驗。

G · 多模型競技場¶

支持同 Prompt 多模型並行對比、批量評測排行榜、模型推薦引擎，以及外部廠商 Key 加密託管。

H · 斷點續跑與任務編排¶

提供可視化流水線、斷點續跑、批量任務隊列，以及 Cron / 中文自然語言定時調度。

J · 安全與審計¶

提供多 API Key 管理、操作審計日誌、DLP，以及合規報表。

安裝與啓用¶

安裝¶

推薦用 dsh CLI 安裝。--profile 用於指定目標 profile，例如 web：

dsh plugin add beijingwahw/dsh-companion-dev --profile web
dsh web

如果希望從源碼安裝，可以先克隆倉庫並構建：

git clone https://github.com/beijingwahw/dsh-companion-dev.git
cd dsh-companion-dev
pnpm install
pnpm run build

驗證安裝¶

在 Harness 命令面板執行 usage。如果返回本月用量文本報告，說明插件已正確掛載。

配置模塊 C¶

如果要使用 API 成本優化相關能力，先做下面兩步：

1. 打開插件設置頁的「開發者模式」總開關。
2. 在「API Key 管理」輸入並保存 DeepSeek API Key，可選測試連接。

典型用法¶

導出對話¶

在對話界面頭部操作區點擊「導出」，或在命令面板執行 export。隨後選擇 Markdown、PDF、JSON 或 PNG 長圖。多會話也可以批量導出爲 ZIP。

生成交接摘要¶

在對話頭部點擊「交接摘要」，或執行命令 handoff。生成後可以複製到剪貼板，也可以保存爲模板。新建對話時，可以使用 handoff-import 導入歷史摘要。

檢索歷史對話¶

在歷史對話列表頂部使用全局搜索框，或執行命令 search。進入具體對話後，可按 Ctrl/Cmd+F 打開對話內浮動查找欄。

查看用量¶

在命令面板執行 usage，查看本月用量文本報告。

模塊開關¶

插件根配置包含以下開關：

enableExport
enableHandoff
enableCost
enableSearch
enableTrace
enablePrompt
enableArena
enableOrchestrator
enableSecurity
apiBaseUrl
apiTimeoutMs

前九個開關默認值爲 true。apiBaseUrl 默認值爲：

https://api.deepseek.com

apiTimeoutMs 默認值爲：

60000

適用場景與注意¶

這個插件適合使用 DeepSeek Harness 的開發者，尤其是需要處理以下事情的人：

• 導出對話記錄或歸檔對話內容
• 把長任務上下文交給新的對話繼續處理
• 管理 API Key、預算、調用費用
• 檢索歷史對話和對話內容
• 分析執行軌跡
• 管理 Prompt 版本並做 A/B 測試
• 對比多個模型
• 編排任務、斷點續跑和定時調度
• 查看安全審計與合規信息

使用前需要注意：

• 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
• 本倉庫爲開發者版；如果只需要 A–D 基礎能力，可參考 beijingwahw/dsh-companion。
• 開發期熱更新 HMR 需要 Node >= 24.11；早期 24.x 的 Node 內部接口與 cordis-plugin-loader 1.0.2 不兼容。
• 九個模塊可獨立啓停，停用某個模塊不會影響其他模塊。
• API Key 以 AES-256-GCM 加密落盤，用戶數據僅存於 Harness 插件沙箱本地。

結尾¶

dsh-companion-dev 把對話導出、上下文交接、成本優化、檢索、軌跡分析、Prompt 工程、多模型對比、任務編排和安全審計整合進 DeepSeek Harness 插件體系。如果你正在使用 DSH 做智能體開發，並且希望在一套插件中處理這些工程化需求，可以按上面的命令安裝並驗證。

GitHub：https://github.com/beijingwahw/dsh-companion-dev