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 强化

致谢

• 上游审读：omdsh-dev/dsh-deep-research（MIT 许可，commit c0b329e），仅借鉴机制，未复制代码。
• DSH 官方 workflow 引擎、web_search / web_fetch 能力。

许可证

MIT © 2026 Cruciforms