前言¶
DeepSeek Harness (DSH) 的设计理念是「一切皆插件」。现有的深度研究插件大多表现为固定提示词的流水线，缺乏对研究过程的闭环控制与结果验证。dsh-socrates 插件通过引入苏格拉底式的澄清机制与自适应研究逻辑，试图解决这一问题。
插件定位¶
dsh-socrates 是 DeepSeek Harness 的深度研究插件，由 Cruciforms 维护，采用 MIT 许可证。它主打调查前澄清 + 自适应多轮研究 + 交叉验证 + 引用闭环。与固定提示词流水线不同，它是一个活的、可收敛的研究闭环。
核心功能¶
1. 调查前澄清¶
在开始研究前，Planner 会针对主题生成 ≤3 个澄清问题，通过 userQuestions.ask 提问给用户。用户确认后，研究计划才进入执行阶段。支持 planReview 意图卡片进行计划审批。
2. 自适应多轮研究¶
研究过程不是一次性完成，而是分轮进行。
* 并行研究：每轮中，多个 researcher（flash 模型）并行搜索、精读并逐字摘录入证据库。
* 缺口驱动：每轮末尾收集高优先级缺口，若边际增益验证为负，则提前停止。
* 止损机制：连续零增益、轮次硬上限、token 预算三重保险。
3. 交叉验证¶
Verifier 对每个声明进行声明级三分裁决：entailed（蕴含）、contradicted（矛盾）、baseless（无依据）。若未验证，会在报告中标记 ⚠️ UNVERIFIED。系统支持单跳回补任务与条件修订轮。
4. 引用闭环¶
编号引用必须出自证据库中的逐字片段（≤100 字，含段落锚点）。非原文内容会被标记为 model_knowledge。程序化引用审计会检查编号存在性、摘录紧邻格式、逐字一致性及长度上限。
5. 学术三源与源策展¶
插件内置 arXiv、PubMed、Semantic Scholar 检索接口，无需 API Key。当 depth ≥ 2 时，会启用 LLM 策展子代理剔除弱相关低质源。
6. 模型分层降本¶
插件支持模型分层调度：Planner、Synthesizer、Reviewer 使用 Pro 模型；Researcher 使用 Flash 模型，以降低成本。
安装与启用¶
使用官方命令安装：
dsh plugin --profile web add dsh-socrates
安装后需要重启 DSH 进程以使插件生效。
使用方式¶
在对话中直接使用自然语言，模型会根据工具描述自动触发研究流程。
- 通用调研：「深度调研一下 MCP 生态现状，重点对比几家主流实现，出一份带引用的报告」
- 已有清单：「按这份问题清单做研究：1. … 2. …」（提供清单后，插件会跳过自动拆解，直接并行研究）
- 明确用途：「调研一下 A/B 方案，purpose 是决定我们选哪个」（用途越明确，答案空间越准）
对于更复杂的主题，插件会自动扩展轮次；简单主题则一轮收敛。若需更严谨的输出，可传递参数 depth: 3；若要开启引用纠错和覆盖度审计，可传递 review: true。
参数说明¶
| 参数 | 必填 | 默认 | 说明 |
|---|---|---|---|
topic |
是 | — | 研究主题 |
purpose |
否 | — | 研究用途，用于定义答案空间 |
questions |
否 | — | 已有问题清单（每行一个） |
depth |
否 | 2 |
精度等级：1=初步（3 子问题/2 轮），2=深入（4 子问题/3 轮），3=穷尽（6 子问题/4 轮） |
synthesize |
否 | true |
是否生成最终综合报告 |
verify |
否 | true |
是否启用交叉验证 |
review |
否 | false |
是否启用对抗性审查（引用纠错、覆盖度审计） |
clarify |
否 | true |
是否在调查前进行澄清提问 |
planReview |
否 | false |
是否在研究前进行计划审批 |
输出与架构¶
输出目录¶
每次研究的证据与报告落盘在宿主侧。默认路径为插件安装目录下的 runs/<topic-slug>/。
输出文件¶
evidence.jsonl：逐字摘录证据库，包含 URL、段落锚点、质量分级。report.md：带编号引用的最终报告。state.json：运行状态、覆盖度、验证统计。review.md：审查意见（review=true时生成）。
架构设计¶
插件通过 index.js 作为薄壳，调用 DSH 官方 workflow 引擎进行编排。
* 编排：使用 ctx.workflows，支持并发控制与取消传播。
* 搜索/抓取：直接调用 DSH 内置的 web_search / web_fetch，插件本身不包含网络逻辑或自研编排。
* 证据存储：由宿主的 src/evidence-store.js 管理，workflow 脚本无直接文件系统访问权限。
与同类插件对比¶
| 功能 | dsh-socrates | dsh-deepresearch | dsh-raven-research | dsh-research-report |
|---|---|---|---|---|
| 核心差异 | 苏格拉底式澄清 + 自适应闭环 + 验证 + 引用审计 | 证据管理 + Web 工作区 | 中途 steer 纠偏 | 内容寻址证据账本 + 密封报告 |
| 多轮编排 | ✅ 自适应闭环 | ❌ 不自调度搜索 | ❌ 单 Task 渐进 | ❌ 无研究闭环 |
| 交叉验证 | ✅ 声明级三分裁决 + 回补 | ❌ | ❌ | ✅ 验证裁决 |
| 引用审计 | ✅ 程序化（逐字一致性） | ❌ | ✅ 字节比对 | ❌ |
| 学术检索 | ✅ arXiv / PubMed / S2 | ❌ | ❌ | ❌ |
| 模型分层 | ✅ Pro/Flash 自动分层 | ❌ | ❌ | ❌ |
其他信息¶
- 曾用名：项目原名为
dsh-deep-research。为避免与 GitHub 上 dsh-external/dsh-deep-research 同名仓库混淆，于 2026-08 更名为dsh-socrates。 - 依赖：需要
@deepseek-ai/dsh-tools(v0.1.0-rc.6+)。
插件源码与文档可在 GitHub 查看。
