DeepSeek Harness (DSH) 插件：dsh-research-autoresearch

前言¶

DeepSeek Harness (DSH) 的设计理念是“一切皆插件”。对于需要构建科研工作流的开发者而言，如何将文献检索、评分、评审和状态管理标准化，是一个常见需求。dsh-research-autoresearch 是该协议的 DSH 工具化实现，旨在为智能体提供一个闭环的科研处理流程。

插件概览¶

该插件由 yuan-source-666 维护，是一个单 bundle 发布的 AutoResearch 全家桶。它采用 MIT 许可证。核心价值在于将 AutoResearch 框架协议转化为可插拔的 DSH 工具集。

核心功能¶

插件包含以下六个主要工具：

1. arxiv_search：文献 Recall。支持 arXiv 检索与去重。
2. lit_score：LQS 五维评分分桶。
3. research_state：研究状态/进度面板。包含 7 种操作。
4. stall_check：停滞检测。提供 pivot/escalate/cap 红绿灯机制。
5. peer_review：五人格中位数评审。
6. research_ui_switch：可视化总控台。支持运行时开关。

设计理念¶

该插件的设计灵感源自 Deli Chen 的 AutoResearch 框架协议，特别是其关于评审机制和停滞检测的实证研究：
* 评审机制：采用 MEDIAN 而非均值，防止单人格抬分。
* 诚实降分：保留 scoreDropped 字段，用于记录外部引用核查后的主动降分。
* 停滞检测：遵循 “pivot structure, not tactics” 原则，设置 15 轮 / 30 分钟双上限。

安装与启用¶

安装方式如下：

方式一（git 安装）：

dsh plugin --profile web add github:<your-github-user>/dsh-research-autoresearch

方式二（预构建 tarball）：
先构建并打包：

npm run build && npm pack

然后安装：

dsh plugin --profile web add ./dsh-research-autoresearch-0.3.1.tgz

安装后，可在 profile 的 cordis.patch.yml 中添加配置以停用插件，或在 Web 设置页的「插件配置」中通过科研可视化总控台卡片进行控制。

可视化控制¶

插件提供三级可视化控制，以避免功能不可见：
1. 套件级：通过 config.enabled=false 禁用整个 bundle。
2. 部署级：通过 *Cards 声明式注入进度卡片（默认关闭）。
3. 会话级：通过命令 research_ui_switch {feature, action: on|off|reset} 或设置 defaultCards 进行即时开关。

版本更新与修复¶

插件在 0.3.0 和 0.4.0 版本中针对科研流程中的常见缺陷进行了修复：

• v0.4.0 编排层补全：修复了注册缺失导致的“装着但没生效”问题。新增了 autoresearch runtime skill，确保模型能正确调用工具。修复了 6 个工具被调用 0 次的 Bug。
• v0.3.0 文献驱动升级：
  • 引用窗口校正：针对 <400 天的新论文，当引用数为 0 时，使用其余分量均值插补，并标记 citationEmergingImputed。
  • 评审不确定性带：新增 judgeDisagreement（极差）与 scoreBand（MAD 稳健区间）。分歧 ≥4 的面板不能再直接 accept。
  • 构建自含化：所有源码打包，确保独立构建。

测试成果¶

插件经过多轮测试，结果如下：
* 宿主半冒烟：11 项断言通过。
* 浏览器半回放：9/9 通过。
* 安装态稳定性：16/16 通过。
* 冷启动稳定性：3/3 通过（HTTP 200，3-7s）。
* 真实网络往返：arXiv ≈1.0–1.3s；S2 ≈2.9–16.5s。
* 类型检查：0 诊断。
* 端到端模拟：133/133 通过。

依赖项¶

插件依赖以下 DSH 核心库：
* @deepseek-ai/cordis
* @deepseek-ai/dsh-settings
* @deepseek-ai/dsh-tools
* @deepseek-ai/schemastery

生成物位于 lib/client.js，不建议手动修改。

总结¶

该插件为 DSH 提供了一套标准化的科研处理流程，涵盖了从文献召回、评分、评审到状态管理的全链路。对于需要构建科研类智能体的开发者，这是一个可直接落地的工具集。

GitHub 仓库
社区目录