DeepSeek Companion（精简版）

English | 中文

版本说明：本仓库为精简版，包含 A–D 四大基础模块（对话导出 / 交接摘要 / 成本优化 / 全局检索）。 开发者版（A–J 九大模块，含执行轨迹分析、Prompt 工作台、多模型竞技场、任务编排、安全审计）请见 beijingwahw/dsh-companion-dev。

DeepSeek Harness 官方伴侣插件 —— 基于 Cordis 框架与 Harness Plugin SDK 构建，为 DeepSeek Harness 平台提供对话智能导出、上下文交接摘要、API 成本优化与全局对话检索四大能力。

• 开发语言：TypeScript（strict: true，ESM）
• 运行框架：DeepSeek Harness（Cordis ≥ 4.0，一切皆插件）
• API 直连：DeepSeek 官方 API（https://api.deepseek.com）
• 数据安全：所有用户数据仅存于 Harness 插件沙箱本地，API Key 以 AES-256-GCM 加密落盘

---

功能总览

模块	能力	独立开关
A · 对话智能导出	Markdown / PDF / JSON / PNG 长图导出、回合级勾选导出（角色徽章 + 内容预览 + 全选/全不选，仅导出选中回合）、时间戳开关、隐私脱敏（手机号/邮箱/身份证/银行卡自动打码）、批量可视化多选（筛选 + 全选 + 已选计数）、多会话批量 ZIP 打包、导出进度实时显示与一键中止；含中文的 PDF 由客户端 canvas 光栅化为免打印多页 PDF（无 window.print() 对话框冻结）	enableExport
B · 上下文交接摘要	会话选择面板（当前会话徽章 / 筛选 / 选中任意历史会话）、一键生成 ≤500 字四段式交接摘要、可编辑、复制到剪贴板、保存为模板、导入摘要作为新对话的 system 首条消息实现上下文继承	enableHandoff
C · API 成本优化（开发者模式）	API Key 加密托管、官方动态计价引擎（每小时抓取 DeepSeek 与国产厂商官方定价页，新模型/调价自动导入，抓取失败静默降级内置快照）、峰谷分时计价（高峰时段按高峰价计费）、峰谷自动调度（高峰窗口实时解析自官方定价页）、模型智能路由、日/月双档预算 80%/100% 预警并自动暂停非必要调用、缓存命中折扣计费、每日/每周 Token 消耗与费用报表	enableCost
D · 全局对话检索 + 对话内搜索	关键词模糊搜索、时间范围筛选、自定义标签增删与按标签过滤、结果点击直达对话；对话内搜索（Ctrl+F 浮动查找栏，CSS Custom Highlight API 无侵入高亮，大小写/全词开关、查询历史、流式输出期间自动重同步）	enableSearch

四个模块均为独立 Cordis 子插件，可任意组合启停，互不影响。

---

安装

前置要求

• DeepSeek Harness >= 0.1.0
• Node.js ^22.19 || >=24
• pnpm（npm install -g 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。更多方式见「开发期热更新」后附。

---

开发期热更新（HMR）

层	方法	生效范围
运行配置	编辑 dsh 用户层 cordis.patch.yml（~/.dsh/profiles/<name>/ 或 ~/.dsh/），保存即生效	dsh 原生监视用户层，事务性重载该行（bundle 层默认值已全量列出，照抄整行覆盖即可）
开发期代码	npm run dev 起独立 cordis + HMR 进程	保存 src/ 下任意文件或 cordis.yml → 旧实例卸载（effect 回卷）→ 新代码挂载，无需重启
安装产物	改代码 → pnpm build → 重新 dsh plugin add beijingwahw/dsh-companion --profile web → 重启 dsh	更新已安装的插件

npm run dev 的组成：仓库根 cordis.yml 依次挂 logger / timer / hmr / 宿主桩 / 本插件（直接加载 src/index.ts，config 与 cordis.patch.yml 逐键一致）； dev/host-stubs.ts 提供 dsh 宿主 7 个服务的最小桩（webServer / storageDomain / credentials / sessionQuery / commands / settings / systemPrompt）——存储域为内存版且按名缓存，热重载后开发数据不丢。

注意：开发 HMR 需 Node ≥ 24.11（24.1.0 等早期 24.x 的 Node 内部接口与 cordis-plugin-loader 1.0.2 不兼容，表现为编辑文件不触发重载）。

从源码构建安装（贡献者 / 离线场景）

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（模块 C 前置）

1. 打开插件设置页的「开发者模式」总开关。
2. 在「API Key 管理」输入框粘贴你的 DeepSeek API Key 并保存。
   • Key 通过 AES-256-GCM 加密后存入 Harness 插件沙箱的 companion 存储域；
   • 任何接口响应、日志、事件中均不会出现 Key 明文（/cost/state 仅返回 apiKeyConfigured 布尔）。
3. 可选：点击「测试连接」验证 Key 有效性（对应 /cost/test-call）。

模块 A：导出对话

…