README.zh.md

August 16, 2026 · View on GitHub

面向 DeepSeek Harness 生态的 self-harness 工具集

_{中文 · English}

两个可安装的 DSH 组合包，测量并检视你自己的 harness：
一个是模型先验知识探针电池，一个是发布历史归档仪表盘。

为什么

DeepSeek Harness 采用 「一切都是插件」 的架构。本仓库基于官方 Cordis 插件模型发布两个组合包，支持 dsh plugin add 安装，并在 npm 上分发：

dsh-prior-probe — 冻结探针电池工具。测量模型仅凭先验知识能给出多少预期答案（无 harness、单发补全，用确定性 grader 等价正则评分）。
dsh-evidence-dashboard — 项目归档仪表盘：组件概览、设计决策、已否决选项，以及带 changelog 时间线的发布历史 git 树。

特性

prior-probe

Host 插件，含三个模型工具：prior_probe_list（列出内嵌电池）、prior_probe_score（离线确定性评分）、prior_probe_run（对任意 OpenAI 兼容端点执行无 harness 单发探测）。电池冻结并内嵌；api_key_file 让密钥不进会话日志。

evidence-dashboard

一个包携带两半：host 通过 /api/dash-data 提供归档数据，浏览器半注册 设置 → DSH Evidence 面板。标签页：Overview、Decisions、Rejected options，以及带分叉/合并泳道的 Versions git 树与 changelog 时间线。

官方组合包格式

每个插件都是声明 dsh.bundle（patch 层 + ESM 入口）的 npm 包；dashboard 额外声明 dsh.client，携带预构建的 window.__ModuleLoader__ bundle。GitHub / tarball / npm 三种安装渠道，无需构建步骤。

可验证设计

node verify.js（dsh-plugin-kit 的薄包装）解析全部源码、校验每个 JSON 数据集、对内嵌电池做字节比对、抽查评分正则、并对两个包做打包预检——已接入 CI，每次推送自动执行。

快速开始

用最短的官方渠道把两个插件装进 profile：

dsh plugin --profile demo add dsh-prior-probe
dsh plugin --profile demo add dsh-evidence-dashboard

dsh --profile demo --dump-config   # 验证 "# == dsh-prior-probe" 层
dsh web --profile demo             # 打开 设置 → DSH Evidence

其他渠道：GitHub（dsh plugin add github:SuTang-vain/dsh-self-harness-tools#path:plugins/prior-probe）或打包好的 tarball。详见各插件 README。

文档

目标	入口
安装与使用探针电池工具	`plugins/prior-probe/README.md`
安装与使用归档仪表盘	`plugins/evidence-dashboard/README.md`
仓库自检	`node verify.js`
验证、扩展或复用 QA 工具包	`dsh-plugin-kit/README.md`
发版清单（版本号 → npm 发布）	`CONTRIBUTING.md`
各版本变更记录	`CHANGELOG.md`
在仪表盘中查看版本树	Versions 页（v1.0 → v1.6.2）

效用证据 / Evidence

用数据说话，而非承诺——三件套各自可验证的效用：

dsh-plugin-kit：在三个第三方仓库、三种不同分发形态（npm bundle / 官方 .dsh-plugin / profile 片段）上 14/15 项检查通过；同时在本仓库自己的 CI 中运行 82 项检查。见 docs/kit-field-test.md。
dsh-prior-probe：随包附带一份由实际评分代码生成的确定性离线演示（data/example-score-run.json， 5/8 计分、G=0.8、低方向告警可见）；真实端点实测用 prior_probe_run 并传入你自己的凭据。
dsh-evidence-dashboard：渲染本仓库自身的发布历史；同一 schema 还在第三方项目的真实数据上做了演示——@deepseek-ai/dsh 的六次 npm 发布（data/examples/versions-dsh-official.json）。

与官方项目的关系

本仓库构建于 deepseek-ai/deepseek-harness 与 Cordis 插件模型之上。

官方项目提供核心 Agent 能力、插件系统与 Web UI。本仓库主要提供：

两个可复用、可安装的官方 dsh plugin 流程组合包
构建任务套件前测量模型先验的工具
带版本树的项目历史归档仪表盘
携带 dsh.bundle / dsh.client manifest 的 npm 分发
dsh-plugin-kit：面向 DSH 插件仓库的可复用 QA 工具包

若你想为 Harness 核心本身做贡献，请优先参考官方仓库。

社区

DeepSeek Harness 官方：GitHub Discussions · Discord
本仓库：欢迎在 GitHub 上提 issue 与 pull request。

许可

本项目基于 MIT License 发布。

基于 DeepSeek Harness 构建的社区工具，并非 DeepSeek 官方产品。