DeepSeek Companion（开发者版）

版本说明：本仓库为开发者版，包含 A–J 全部九大模块。精简版（A–D 四大基础模块）请见 beijingwahw/dsh-companion。

DeepSeek Harness 官方伴侣插件 —— 基于 Cordis 框架与 Harness Plugin SDK 构建，为 DeepSeek Harness 平台提供对话智能导出、上下文交接摘要、API 成本优化、全局对话检索、执行轨迹分析、Prompt 工程工作台、多模型竞技场、任务编排与安全审计九大能力。

开发语言：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`
E · 执行轨迹分析器（开发者）	Harness 原生轨迹解析为可交互时间轴（耗时/Token 拆分/模型/缓存命中）、一键定位最慢与最贵的 3 个步骤、异常自动标注（重试循环/Token 爆炸/缓存未命中/死循环）、两次轨迹 Diff 对比（HTML 报告导出）、日聚合趋势与历史基准线告警	`enableTrace`
F · Prompt 工程工作台（开发者）	Prompt 版本管理（自动版本号/备注/标签/回滚）、A/B 测试面板（批量测试集、指标对比、人工评分胜率统计）、模板库（分类/变量插值/一键生成 Python·Node.js·curl 调用代码）、结构化输出 JSON Schema 批量校验与合规率统计	`enablePrompt`
G · 多模型竞技场（开发者）	同 Prompt 多模型并行对比（最多 5 个，输出/耗时/Token/费用并排）、批量评测排行榜（准确率/P50·P95·P99/成本/合规率综合得分，MD/HTML 报告）、模型推荐引擎（任务类型+预算+延迟+峰谷定价感知，附推荐理由）、外部厂商 Key 加密托管

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：检索 + 标签 │ ├── trace/ # 模块 E：轨迹派生 / 异常标注 / Diff / 日聚合统计 │ ├── prompt/ # 模块 F：版本管理 / A/B 测试 / 模板库 / Schema 校验 │ ├── arena/ # 模块 G：模型目录 / 并行对比 / 排行榜 / 推荐引擎 │ ├── orchestrator/ # 模块 H：流水线引擎 / 队列 / Cron 与自然语言调度 │ └── security/ # 模块 J：命名 Key / 审计日志 / DLP / 合规报表 ├── 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 / 检索视图 / 报表视图 / │ # 轨迹分析 / Prompt 工作台 / 竞技场 / 任务编排 / 安全审计视图 └── types/ # Harness 子系统适配层类型声明

字段	类型	默认值	说明
`enableExport`	boolean	`true`	启用模块 A
`enableHandoff`	boolean	`true`	启用模块 B
`enableCost`	boolean	`true`	启用模块 C
`enableSearch`	boolean	`true`	启用模块 D
`enableTrace`	boolean	`true`	启用模块 E
`enablePrompt`	boolean	`true`	启用模块 F
`enableArena`	boolean	`true`	启用模块 G
`enableOrchestrator`	boolean	`true`	启用模块 H
`enableSecurity`	boolean	`true`	启用模块 J
`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：全局检索与对话内搜索

配置参考

架构简介

安全与隐私

交付物清单

能力来源

许可