deepseekplugins

DeepSeek Harness plugin

dsh-socrates-crucifor

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

Docs & Rendering
Jump to install

Source facts

Repository
Cruciforms/dsh-socrates
Latest update
Aug 20, 2026
Category
Docs & Rendering
GitHub stars
0
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-21

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/Cruciforms/dsh-socrates
Plugin: dsh-socrates-crucifor
Author: Cruciforms

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

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
maxParallel4每轮研究并发上限
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-socratesdsh-deepresearchdsh-raven-researchdsh-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](LICENSE) © 2026 Cruciforms

Back to searchOpen GitHub repository

More related plugins

View category