运行证据录制器rrrrrredy/deepseek-harness-runcase-adapter

DeepSeek Harness RunCase 适配器

CI

将一次 DeepSeek Harness SDK 运行记录为一个经过验证、可移植的 agent.run.v1 JSON 文件。该记录将提示词、配置的模型、保留的 Harness 事件、运行时结果、脱敏状态以及已知的观测缺口保存在一起。

这是一个独立的社区适配器。它不是 DeepSeek 的官方产品，也不声称一次已完成的运行解决了任务。在没有外部验证器的情况下，outcome.status 保持为 unknown。

我应该使用哪个仓库？

| 你想做什么 | 从这里开始 |
| --- | --- |
| 保留、诊断、比较并安全地应用一次 Codex 能力文件变更 | Runtime Evolution Workbench |
| 构建并检查可重置的工作流 Case；仅在隔离门通过的地方运行 Codex | Workflow Environment Factory |
| 将 DeepSeek Harness SDK 运行捕获为可移植证据 | DeepSeek Harness RunCase Adapter |
| 验证或实现可移植的 Run、Case 和 Score 文件 | RunCase Interchange |

这增加了什么

- 启动官方固定版本的 DeepSeek Harness SDK 运行时，并记录其通知流。
- 在写入之前对常见的 API 密钥、bearer 令牌、凭据以及用户选择的路径进行脱敏。
- 当 Harness 运行时崩溃或超时时，保留部分事件。
- 生成一条 RunCase Interchange v0.1.2 记录，可离线验证或导入 Runtime Evolution Workbench 的本地 Protocol 库。
- 在 GitHub 托管的 Windows x64、Ubuntu x64 和 Apple Silicon macOS 上运行无密钥契约测试。

它不添加 Codex 专用的 Evolution Lab，不更改 DeepSeek Harness 配置，不揭示隐藏推理，不验证任务正确性，也不报告 SDK 未暴露的远程子代理完成情况。

要求

- Node 22 系列中的 Node.js 22.19 或更高版本，或 Node 23/24。
- 在你选择作为 DSH_HOME 的目录中配置 DeepSeek Harness 凭据和配置文件。
- 一个允许 Harness 使用的工作区。

上游 SDK 目前会安装其同版本的完整 Harness 运行时，因此依赖下载量远大于此适配器。

从发布版本安装

从 GitHub Release 下载 deepseek-harness-runcase-adapter-0.1.0.tgz 及其校验和，验证校验和，然后安装本地文件：

npm install --global ./deepseek-harness-runcase-adapter-0.1.0.tgz

该包不会注册后台服务、插件、启动项或账户连接。

使用以下命令移除全局命令和包：

npm uninstall --global deepseek-harness-runcase-adapter

记录一次运行
将凭据保存在环境或你的 Harness 主目录中；不要将 API 密钥放在命令行上。

dsh-runcase run \
--prompt-file task.txt \
--workspace ./my-repository \
--dsh-home ./private-dsh-home \
--output ./records/parser-run.json

该命令会写入两个新文件，并拒绝覆盖其中任何一个：

- parser-run.capture.json：适配器级别的 DeepSeek 捕获；
- parser-run.json：经过验证的可移植 agent.run.v1 记录。

有用的选项包括 --provider、--model、--profile、可重复的 --patch、--reasoning-effort、--max-tokens，以及可重复的 --exclude-path。

记录默认使用 . 和 _runtime/deepseek-harness 作为工作区和 Harness 主目录，因此移动或共享 JSON 不会泄露主机目录名称。--retain-host-paths 是明确的仅限本地的选择加入选项，并且会打印警告，因为它会将两个绝对路径写入捕获文件和 RunCase 文件。

验证或重新转换

dsh-runcase validate ./records/parser-run.json
dsh-runcase convert --capture ./records/parser-run.capture.json --output ./records/rebuilt-run.json

要将其保留在 Runtime Evolution Workbench 中，请打开 Runs → Protocol library → Import JSON。导入会存储一份经过单独验证和脱敏的副本；它不会将 DeepSeek 记录转换为原生 Codex Evolution Lab 实验。

平台证据

版本 0.1.0 已在 GitHub 托管的 CI 中于 Windows x64、Ubuntu x64 和 Apple Silicon macOS 上进行了测试。这些作业会针对一个无密钥的 JSON-RPC 替身运行真实发布的 SDK 客户端，覆盖启动、通知、脱敏、崩溃保留、转换、验证和包内容。它们不使用生产 DeepSeek 账户、物理 Mac，也不证明模型质量。

请参阅映射详情、已知限制、安全性和上游兼容性。

开发

npm ci
npm check
npm pack --dry-run

Apache-2.0。有关署名信息，请参阅 NOTICE；在提交更改之前，请参阅 CONTRIBUTING.md。