前言¶

DeepSeek Harness（DSH）的理念是「一切皆插件」。对 DSH 或智能体开发者来说，日常开发中经常会遇到几类问题：对话记录难以导出和归档，长任务上下文跨对话传递不方便，API 调用成本缺少统一管理，历史对话检索不够直接，Prompt 调优、多模型对比、任务编排和安全审计也往往需要分散处理。

dsh-companion-dev 是 beijingwahw 维护的 DeepSeek Harness 官方伴侣插件，基于 Cordis 框架与 Harness Plugin SDK 构建。它提供对话智能导出、上下文交接摘要、API 成本优化、全局对话检索、执行轨迹分析、Prompt 工程工作台、多模型竞技场、任务编排与安全审计九大能力。下面介绍它的定位、安装方式、典型用法和注意事项。

这是什么¶

• 仓库：beijingwahw/dsh-companion-dev
• 许可证：MIT
• 定位：DeepSeek Harness 官方伴侣插件，开发者版包含资料中列出的九个模块
• 精简版：若只需要 A–D 四大基础模块，可参考 beijingwahw/dsh-companion
• 运行框架：DeepSeek Harness，Cordis ≥ 4.0
• 开发语言：TypeScript，strict: true，ESM
• 前置要求：DeepSeek Harness >= 0.1.0；Node.js ^22.19 || >=24
• 数据位置：用户数据仅存于 Harness 插件沙箱本地
• 密钥存储：API Key 以 AES-256-GCM 加密落盘
• 包名：dsh-companion；manifest id 为 deepseek-companion
• 模块关系：九个模块均为独立 Cordis 子插件，可任意组合启停，互不影响

资料中列出的功能编号为 A、B、C、D、E、F、G、H、J。

核心功能¶

A · 对话智能导出¶

支持将对话导出为 Markdown、PDF、JSON、PNG 长图，提供时间戳开关和隐私脱敏，也支持多会话批量 ZIP 打包。

B · 上下文交接摘要¶

支持生成不超过 500 字的四段式摘要，并可编辑、复制到剪贴板、保存为模板。也可以将摘要导入新对话，作为 system 角色首条消息，用于上下文交接。

C · API 成本优化¶

提供 API Key 加密托管、官方动态计价、峰谷分时计价、峰谷自动调度、模型智能路由、日/月双档预算，以及 Token 消耗与费用报表。

D · 全局对话检索 + 对话内搜索¶

支持关键词模糊搜索、时间范围筛选、标签筛选，搜索结果可直达对话。对话内也提供浮动查找栏。

E · 执行轨迹分析器¶

提供轨迹时间轴，可定位最慢与最贵的 3 个步骤，支持异常标注、两次轨迹 Diff、日聚合趋势与基准线告警。

F · Prompt 工程工作台¶

提供 Prompt 版本管理、A/B 测试、模板库，以及结构化输出 JSON Schema 批量校验。

G · 多模型竞技场¶

支持同 Prompt 多模型并行对比、批量评测排行榜、模型推荐引擎，以及外部厂商 Key 加密托管。

H · 断点续跑与任务编排¶

提供可视化流水线、断点续跑、批量任务队列，以及 Cron / 中文自然语言定时调度。

J · 安全与审计¶

提供多 API Key 管理、操作审计日志、DLP，以及合规报表。

安装与启用¶

安装¶

推荐用 dsh CLI 安装。--profile 用于指定目标 profile，例如 web：

dsh plugin add beijingwahw/dsh-companion-dev --profile web
dsh web

如果希望从源码安装，可以先克隆仓库并构建：

git clone https://github.com/beijingwahw/dsh-companion-dev.git
cd dsh-companion-dev
pnpm install
pnpm run build

验证安装¶

在 Harness 命令面板执行 usage。如果返回本月用量文本报告，说明插件已正确挂载。

配置模块 C¶

如果要使用 API 成本优化相关能力，先做下面两步：

1. 打开插件设置页的「开发者模式」总开关。
2. 在「API Key 管理」输入并保存 DeepSeek API Key，可选测试连接。

典型用法¶

导出对话¶

在对话界面头部操作区点击「导出」，或在命令面板执行 export。随后选择 Markdown、PDF、JSON 或 PNG 长图。多会话也可以批量导出为 ZIP。

生成交接摘要¶

在对话头部点击「交接摘要」，或执行命令 handoff。生成后可以复制到剪贴板，也可以保存为模板。新建对话时，可以使用 handoff-import 导入历史摘要。

检索历史对话¶

在历史对话列表顶部使用全局搜索框，或执行命令 search。进入具体对话后，可按 Ctrl/Cmd+F 打开对话内浮动查找栏。

查看用量¶

在命令面板执行 usage，查看本月用量文本报告。

模块开关¶

插件根配置包含以下开关：

enableExport
enableHandoff
enableCost
enableSearch
enableTrace
enablePrompt
enableArena
enableOrchestrator
enableSecurity
apiBaseUrl
apiTimeoutMs

前九个开关默认值为 true。apiBaseUrl 默认值为：

https://api.deepseek.com

apiTimeoutMs 默认值为：

60000

适用场景与注意¶

这个插件适合使用 DeepSeek Harness 的开发者，尤其是需要处理以下事情的人：

• 导出对话记录或归档对话内容
• 把长任务上下文交给新的对话继续处理
• 管理 API Key、预算、调用费用
• 检索历史对话和对话内容
• 分析执行轨迹
• 管理 Prompt 版本并做 A/B 测试
• 对比多个模型
• 编排任务、断点续跑和定时调度
• 查看安全审计与合规信息

使用前需要注意：

• 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
• 本仓库为开发者版；如果只需要 A–D 基础能力，可参考 beijingwahw/dsh-companion。
• 开发期热更新 HMR 需要 Node >= 24.11；早期 24.x 的 Node 内部接口与 cordis-plugin-loader 1.0.2 不兼容。
• 九个模块可独立启停，停用某个模块不会影响其他模块。
• API Key 以 AES-256-GCM 加密落盘，用户数据仅存于 Harness 插件沙箱本地。

结尾¶

dsh-companion-dev 把对话导出、上下文交接、成本优化、检索、轨迹分析、Prompt 工程、多模型对比、任务编排和安全审计整合进 DeepSeek Harness 插件体系。如果你正在使用 DSH 做智能体开发，并且希望在一套插件中处理这些工程化需求，可以按上面的命令安装并验证。

GitHub：https://github.com/beijingwahw/dsh-companion-dev