前言¶
在 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。
