前言¶
在 DeepSeek Harness（DSH）裏，對話記錄、上下文交接、API 成本和歷史檢索通常分散在不同流程中。DeepSeek Companion 是一個 DeepSeek Harness 官方伴侶插件，把對話導出、上下文交接摘要、API 成本優化、全局對話檢索放進同一組插件模塊裏。
下面按能力、安裝、用法、配置與注意介紹。該插件由四個獨立 Cordis 子插件組成，可任意組合啓停。
這是什麼¶
倉庫：beijingwahw/dsh-companion。
許可證：MIT。
package.json 版本：0.1.0。
本倉庫爲精簡版，包含 A–D 四大基礎模塊：
1、對話智能導出
2、上下文交接摘要
3、API 成本優化
4、全局對話檢索
開發者版另見 beijingwahw/dsh-companion-dev。
核心功能¶
對話智能導出¶
支持 Markdown、PDF、JSON、PNG 長圖導出。
支持回合級勾選導出、隱私脫敏、批量 ZIP 打包。
批量導出單次最多 100 個會話，自動去重。
PNG 長圖僅客戶端界面可用，命令面板無 canvas。
上下文交接摘要¶
支持生成不超過 500 字的四段式摘要。
摘要可編輯、可複製到剪貼板、可保存爲模板。
摘要可導入作爲新對話的 system 首條消息，用於上下文交接。
API 成本優化¶
支持官方動態計價、峯谷分時計價、峯谷自動調度、模型智能路由、日/月雙檔預算和成本報表。
使用前需配置 DeepSeek API Key。API Key 以 AES-256-GCM 加密落盤；明文不會出現在接口響應、日誌、事件中；/cost/state 僅返回 apiKeyConfigured 布爾。
全局對話檢索¶
支持關鍵詞、時間範圍、自定義標籤篩選。
搜索結果點擊後可直達對話。
對話內搜索¶
支持 Ctrl/Cmd+F 浮動查找欄。
支持大小寫開關、全詞開關、查詢歷史、流式輸出自動重同步。
安裝與啓用¶
前置要求：
- DeepSeek Harness
>= 0.1.0 - Node.js
^22.19 || >=24 - pnpm
一鍵安裝：
dsh plugin add beijingwahw/dsh-companion --profile web
啓動插件面板：
dsh web
升級、卸載和本地路徑安裝：
dsh plugin upgrade dsh-companion --profile web
dsh plugin remove dsh-companion --profile web
dsh plugin add ./dsh-companion --profile web
從源碼構建安裝：
git clone https://github.com/beijingwahw/dsh-companion.git
cd dsh-companion
pnpm install
pnpm run build
dsh plugin add . --profile web
配置 DeepSeek API Key：
1、打開插件設置頁「開發者模式」總開關。
2、在「API Key 管理」粘貼並保存。
3、可點擊「測試連接」。
典型用法¶
- 導出對話：對話頭部點擊「導出」，或命令面板執行
export。 - 批量導出：導出對話框勾選「批量導出」，按篩選/勾選會話打包 ZIP。
- 生成交接摘要：點擊「交接摘要」或命令
handoff。 - 導入歷史摘要：點擊「導入歷史摘要」或命令
handoff-import。 - 全局檢索：歷史對話列表頂部搜索框或命令
search；標籤可用命令tag。 - 對話內搜索：點擊「對話內搜索」或按
Ctrl/Cmd+F。 - 成本報表：命令
usage可在面板內快速查看本月文本報告。
配置參考¶
可覆蓋配置字段包括：
enableExportenableHandoffenableCostenableSearchapiBaseUrlapiTimeoutMs
適用場景與注意¶
適合需要在 DSH 中整理歷史對話、把上一輪上下文交給新對話、控制 API 預算並快速定位舊對話的使用者。
插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。本倉庫許可證爲 MIT。
注意：
- 批量導出單次最多 100 個會話，自動去重。
- PNG 長圖僅客戶端界面可用，命令面板無 canvas。
- 開發 HMR 需 Node
>= 24.11；24.1.0等早期 24.x 與cordis-plugin-loader 1.0.2不兼容。
鏈接¶
GitHub：https://github.com/beijingwahw/dsh-companion
目錄頁鏈接未在本次覈實資料中確認，本文不給出未確認 URL。
