DeepSeek Companion

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 子插件，可任意组合启停，互不影响。

安装指南

环境要求

Node.js ^22.19 || >=24
pnpm（Harness 仓库工作区）或 npm（独立构建本插件）
一个可用的 DeepSeek Harness 部署（harness >= 0.1.0）

方式一：作为 bundle patch 层安装（推荐）

将本包放入 Harness 工作区（或发布后以依赖引入）：
```
pnpm install
pnpm run build        # 产出 lib/（ESM + d.ts）
```
在目标 profile 的 dsh.profile.bundles 中列出 dsh-companion。Harness 会自动应用 cordis.patch.yml patch 层，将插件挂载为 companion。
重启 Harness 会话，插件即随宿主启动。

方式二：独立验证构建

npm install
npm run typecheck      # tsc --noEmit 严格类型检查
npm run build          # 编译到 lib/

构建产物（lib/**/*.js、）连同、即为可分发的插件包（见的字段）。

src/ ├── index.ts # 宿主入口：挂载核心服务 + 按配置挂载四个模块子插件 ├── config.ts # 根配置 schema（schemastery 校验） ├── core/ # 核心基础设施 │ ├── service.ts # CompanionCore 根服务（ctx.companion，持有动态计价引擎） │ ├── vault.ts # SecretVault：AES-256-GCM 加密保险库 │ ├── crypto.ts # AES-256-GCM 原语（Node crypto） │ ├── deepseek.ts # DeepSeek Chat Completions 客户端 │ ├── usage.ts # 用量记账存储（日粒度，含缓存命中 tokens） │ ├── pricing.ts # 计价桥接层（官方 usage → 计价引擎用量形状） │ ├── price/ # 动态计价引擎（移植自 dsh-usage-ledger）： │ │ # types / catalog（多厂商刊例价目录）/ scrapers（官方定价页解析）/ service │ ├── time.ts # 北京时间峰谷窗口计算 │ ├── transcript.ts # 对话转录格式化（MD/JSON） │ ├── privacy.ts # 隐私脱敏（手机/邮箱/身份证/银行卡） │ ├── pdf.ts / zip.ts # 零依赖 PDF 生成 / ZIP 打包 │ └── http.ts # 私有 HTTP 路由器（前缀 /companion） ├── modules/ │ ├── export/ # 模块 A：导出 + 批量 ZIP + 光栅载荷（PNG/免打印 PDF） │ ├── handoff/ # 模块 B：摘要生成 / 模板 / 武装导入 │ ├── cost/ # 模块 C：网关 / 调度器 / 路由 / 日/月双档预算 / 设置 │ └── search/ # 模块 D：检索 + 标签 ├── client/ # 浏览器端 UI（slots 注入，官方组件库） │ ├── index.tsx # 客户端入口：slot 注册 + 对话内搜索控制器生命周期 │ ├── raster.ts # 客户端光栅导出引擎（移植自 dsh-conv-export）： │ │ # PNG 长图 / 免打印多页 PDF（foreignObject → canvas → JPEG → PDF 组装） │ ├── convsearch/ # 对话内搜索（移植自 dsh-conv-search）： │ │ # engine（Highlight API）/ controller（浮动栏+快捷键）/ styles │ └── components/ # 导出弹窗 / 摘要弹窗 / 导入 dock / 检索视图 / 报表视图 └── types/ # Harness 子系统适配层类型声明

字段	类型	默认值	说明
`enableExport`	boolean	`true`	启用模块 A
`enableHandoff`	boolean	`true`	启用模块 B
`enableCost`	boolean	`true`	启用模块 C
`enableSearch`	boolean	`true`	启用模块 D
`apiBaseUrl`	string	`https://api.deepseek.com`	DeepSeek API 基址（manifest 仅放行该域名）
`apiTimeoutMs`	number	`60000`	单次 API 调用超时（毫秒）

要求	实现
数据本地化	对话内容、设置、API Key 仅写入 Harness 插件沙箱的 `companion` 存储域，不上传任何第三方服务器
API Key 加密	AES-256-GCM（12 字节随机 IV + 认证标签），自描述载荷 `v1...`；密钥与密文分离存储
权限最小化	`manifest.json` 网络白名单仅 `https://api.deepseek.com`；存储域仅 `companion`；服务清单逐项列明
无追踪	无任何遥测 / 行为分析代码；`manifest.json` 显式声明 `tracking: false, telemetry: false`
Key 不外泄	任何响应、日志、事件中不出现 Key 明文；导出与摘要内容仅在浏览器本地生成

来源仓库	吸收的能力	落点
`dsh-usage-ledger`	官方定价页动态计价引擎（实时抓取/解析/兜底快照）、峰谷分时计价、多厂商价格目录与专用解析器、缓存命中折扣、日/月双档预算	`src/core/price/`、`src/modules/cost/`
`dsh-conv-export`	PNG 长图光栅导出、免打印对话框多页 PDF（foreignObject → canvas → JPEG → 零依赖 PDF 组装）、图片 data-URL 内联	`src/client/raster.ts`、`src/modules/export/`（kind:'raster' 载荷）
`dsh-conv-search`	对话内搜索引擎（CSS Custom Highlight API 无侵入高亮）、浮动查找栏（快捷键/查询历史/大小写与全词开关）、流式输出 MutationObserver 重同步与命中锚点保持	`src/client/convsearch/`

dsh-companion

安装

说明文档

DeepSeek Companion

功能总览

安装指南

环境要求

方式一：作为 bundle patch 层安装（推荐）

方式二：独立验证构建

验证安装

使用说明

配置 DeepSeek API Key（模块 C 前置）

模块 A：导出对话

模块 B：交接摘要

模块 C：成本优化

模块 D：全局检索与对话内搜索

配置参考

架构简介

安全与隐私

交付物清单

能力来源

许可