dsh-socrates
像苏格拉底一样，先问清楚问题再研究。
Socratic clarify-first deep research plugin for DeepSeek Harness.
一句话
dsh-socrates 是 DeepSeek Harness（DSH）的深度研究插件，主打调查前澄清 + 自适应多轮研究 + 交叉验证 + 引用闭环。不是固定提示词流水线，而是活的、可收敛的研究闭环。
核心特性
- 🔍 调查前澄清（clarify）：Planner 针对主题歧义生成 ≤3 个澄清问题，经
userQuestions.ask 提问；可选计划审批（plan-review 意图卡片，Gemini 式）
- 🔄 自适应多轮研究：每轮并行 researcher（flash）搜索→精读→逐字摘录入证据库；轮末收集 high-priority 缺口，边际增益验证；连续零增益即停 + 轮次硬上限 + token 预算三保险止损
- ✅ 交叉验证（verify）：Verifier 声明级三分裁决（entailed / contradicted / baseless）+ coverage 独立核验 + 单跳回补 ≤2 任务 + 条件修订轮；未验证声明标 ⚠️ UNVERIFIED
- 📝 引用闭环：编号引用只能出自证据库逐字片段（≤100 字，含段落锚点）；非原文内容标
model_knowledge；程序化引用审计（编号存在性 + 摘录紧邻格式 + 逐字一致性 + 100 字上限）
- 🎓 学术三源：内置 arXiv / PubMed / Semantic Scholar 检索（免 key，按频度降级披露）
- 🗂️ 源策展（curate）：depth≥2 默认启用，LLM 策展子代理剔除弱相关低质源
- ⚡ 模型分层降本：Planner / Synthesizer / Reviewer → Pro；Researcher → Flash（provider deepseek-official）
安装
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 | 综合子代理出最终报告；false 只返回三态证据 |
verify | 否 | true | 交叉验证（可关以省成本） |
review | 否 | false | 对抗性审查：引用纠错 + 覆盖度审计 + 矛盾/过度自信标注 |
clarify | 否 | true | 调查前澄清提问 |
planReview | 否 | false | 计划审批（人工确认计划后再研究） |
配置（可选）
| Key | 默认 | 说明 |
|---|
subagentProvider | 引擎默认 spawn | 子代理 provider |
maxParallel | 4 | 每轮研究并发上限 |
maxTotalAgents | 动态计算 | maxParallel×(depth+1)+5（防引擎 cap） |
plannerModel / researcherModel / synthesizerModel / reviewerModel | 继承父配置 | 模型分层 |
输出
每次研究在 runs/<topic-slug>/ 下生成：
evidence.jsonl：逐字摘录证据库（URL + 段落锚点 + 质量分级 A-D）report.md：带编号引用的最终报告state.json：运行状态、覆盖度、验证统计review.md：审查意见（review=true 时）
注：runs 目录默认落在插件安装目录下。可通过环境变量 DSH_SOCRATES_RUNS 显式覆盖。
架构
DSH model ──tool call──▶ index.js（薄壳）
├── deep_research：编排 workflow
└── deepresearch_fetch：网页抓取链
Host 层 ──workflow 引擎桥──▶ 研究脚本
- 编排走 DSH 官方 workflow 引擎（
ctx.workflows），worker 隔离、并发/总数 caps、取消传播
- 搜索/抓取走内置
web_search / web_fetch——插件零网络逻辑、零自研编排
- 证据落盘在插件宿主侧（
src/evidence-store.js），workflow 脚本无 fs/网络能力
与同类插件对比
| dsh-socrates | dsh-deepresearch | dsh-raven-research | dsh-research-report |
|---|
| 核心差异 | 苏格拉底式澄清 + 自适应多轮收敛 + 交叉验证 + 引用审计 | 证据管理 + Web 工作区 + deepResearch namespace | 中途 steer 纠偏 + 引用字节级验证 | 内容寻址证据账本 + 密封报告 |
| 多轮编排 | ✅ 自适应闭环（缺口驱动扩展） | ❌ 不自调度搜索 | ❌ 单 Task 渐进 | ❌ 无研究闭环 |
| 交叉验证 | ✅ 声明级三分裁决 + 单跳回补 | ❌ | ❌ | ✅ 验证裁决 |
| 引用审计 | ✅ 程序化（逐字一致性 + 100 字上限） | ❌ | ✅ 字节比对 | ❌ |
| 学术检索 | ✅ arXiv / PubMed / S2 | ❌ | ❌ | ❌ |
| 模型分层 | ✅ Pro/Flash 自动分层 | ❌ | ❌ | ❌ |
曾用名
本项目原名为 dsh-deep-research。为避免与 GitHub 上 dsh-external/dsh-deep-research 同名仓库混淆，于 2026-08 更名为 dsh-socrates。
里程碑
- M0 探测 ✅（2026-08-17）
- M1 单轮闭环 ✅（2026-08-18）
- M2 多轮自适应 ✅（2026-08-18）：缺口驱动扩展、三层收敛、三保险止损
- M3 澄清+追问连贯 ✅（2026-08-19）：澄清提问、plan-review 审批、追问复用
- M4 交叉验证+引用闭环 ✅（2026-08-19）：三分裁决、单跳回补、条件修订、URL 抽查
- M5 打磨 ✅（2026-08-19）：学术三源、报告长度档、LLM 源策展、成本计量
- M5.1 修复包 ✅（2026-08-20）：verifier 空转降级、引用编号上限、source 字段全链路
- M5.2 空转根因修复 ✅（2026-08-20）：字段名容错 + prompt 强化
致谢
许可证
MIT © 2026 Cruciforms
