dsh-socrates

Socratic clarify-first deep research plugin for DeepSeek Harness: adaptive multi-round research with evidence-closed cited reports, cross-verification, and citation auditing.

latest

Source

npm

Version: 0.1.0

Version published: 2 months ago

Maintainers: 1

Created: 2 months ago

Source

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 自动分层	❌	❌	❌