dsh-deep-research

@dsh-external/dsh-deep-research

把 deep-research 流程做成 DSH 扩展插件（plugin，与 skill 体系分开）， 基于 DSH 官方 workflow 引擎（ctx.workflows / @deepseek-ai/dsh-workflow-workerthread） 实现，按 控制论 + 信息论 设计——不是固定提示词流水线，而是活的、自适应的研究闭环。

理论 → 机制

理论	插件里的落地
控制论：参考信号校准（闭环控制错误目标 = 白费）	规划代理先定义答案空间（scope：研究支撑什么判断/决策）与每个子问题的验收标准（acceptance），再开始研究
Ashby 必要多样性定律（控制器多样性 < 系统多样性 ⇒ 必有盲区）	规划代理枚举主题的信息维度，每个子问题映射一个维度，并输出覆盖度自检 coverage_gaps
信息论：信息 = 不确定性的减少	研究子代理维护三态证据 confirmed / uncertain / gaps——条件熵的工程表达；报告保留置信度与矛盾，不掩盖不确定性
信息论：边际信息增益（EIG）递减 ⇒ 无限搜索是错的	每个研究子代理：预测（针对哪个高熵点、预期新增什么）→ 行动（web_search/web_fetch）→ 更新证据 → 边际增益验证；连续一轮零增益即停 + 轮次硬上限
控制论：自适应控制（流程是活的，不是固定脚本）	研究阶段是闭环再规划：第 1 轮并行研究全部子问题；每轮结束收集 high-priority 缺口 → 自动派发下一轮补充研究；规划声明的"盲区"会被定向侦察验证（假设被实验检验而非静态接受）；简单主题一轮收敛，复杂主题自动扩展，直到边际增益 ≈ 0
信息论：率失真（给定"率"最小化失真）	综合子代理把证据有损压缩为最终报告：只保留对结论有区分度的信息，决策有用性最大化
信息论：信道冗余/纠错（对抗幻觉=噪声）	可选对抗性审查子代理 = 奇偶校验：引用抽查（URL 可达性/支撑性）、覆盖度审计、矛盾与过度自信标注

结构

dsh-deep-research/
├── package.json    # @dsh-external/dsh-deep-research（声明 dsh.bundle.patch）
├── cordis.patch.yml  # bundle 补丁：按包名插入插件行
├── src/index.ts    # cordis 插件：注册 deep_research 工具，提交官方 workflow 脚本（原生 TS，零构建）
├── tsconfig.json   # typecheck 配置（project references 解析到 sibling deepseek-harness 源码）
└── README.md

开发与检查

pnpm install        # 仅 typescript/@types/node（typecheck 用）
pnpm run typecheck  # tsc -b，类型从 sibling deepseek-harness checkout 解析

源码即运行时：包入口直接指向 src/index.ts，无构建步骤。profile 安装的副本位于 node_modules 下，由 dsh 源码启动器的 tsx hook 加载（Node 原生类型剥离拒绝 node_modules 内的文件）；源码 checkout 在 node_modules 外直跑时也可用 Node ≥22.18 原生剥离。要求 erasable-only TS 语法（无 enum/命名空间等）， node --test/pnpm typecheck 会挡住不可移植写法。

安装与使用方式

包声明了 dsh.bundle.patch（cordis.patch.yml），通过 dsh plugin 装进任意 profile （把 <profile> 换成 tui / headless / web 或自建 profile）：

dsh plugin --profile <profile> add git+https://github.com/dsh-external/dsh-deep-research.git
dsh --profile <profile>        # 重启生效：工具 deep_research 随 profile 注入

若 pnpm 把 https URL 重写成 git+ssh（本机全局 git insteadof 配置所致），用上面的 git+https:// 形式；dsh plugin 会提示需要 allowBuilds 时按提示在 $DSH_HOME/profiles/<name>/pnpm-workspace.yaml 加一行即可。

工具由模型按工具描述自动触发（深度研究/调研/多源信息综合分析/研究报告/文献搜集）， 对话中直接说人话即可：

• 「深度调研一下 MCP 生态现状，重点对比几家主流实现，出一份带引用的报告」
• 「按这份问题清单做研究：1. ... 2. ...」（已有清单 → 跳过自动拆解，直接并行研究）
• 「调研一下 A/B 方案，purpose 是决定我们选哪个」（用途越明确，答案空间越准）
• 复杂主题会自动扩展轮次（自适应闭环），简单主题一轮收敛；想要更严谨传 depth: 3， 要引用纠错和覆盖度审计传 review: true。

成本建议：模型分层——规划/综合用强模型、研究用便宜模型（配置 plannerModel/researcherModel/synthesizerModel/reviewerModel），可显著降本。

依赖要求：profile 的组合必须包含官方 workflow 引擎与内置 web 工具——dsh 官方 base 组合自带，无需额外安装；peer 依赖（@deepseek-ai/dsh-tools 等）由组合提供， profile 的 autoInstallPeers: false 可避免向 registry 查找未发布的 @deepseek-ai/*。

更新 / 卸载：

dsh plugin --profile <profile> update
dsh plugin --profile <profile> remove @dsh-external/dsh-deep-research
# 或：从 profile 的 package.json 移除依赖后 dsh plugin --profile <profile> update

工具参数

参数	必填	说明
topic	是	研究主题
purpose	否	研究用途（要支撑的判断/决策）——用于定义答案空间；缺省时规划代理声明假设用途
questions	否	已有问题清单（每行一个）；提供则跳过自动拆解
depth	否	精度/容差：1=初步 2=深入（默认）3=穷尽——决定研究闭环轮次上限（depth+1）
synthesize	否	综合子代理出最终报告（默认 true）；false 只返回三态证据
review	否	对抗性审查（默认 false）：引用纠错 + 覆盖度审计 + 矛盾/过度自信标注

配置（可选）

Key	默认	说明
subagentProvider	引擎默认 spawn	子代理 provider
maxParallel	4	每轮研究并发上限
maxTotalAgents	引擎上限	整次运行子代理总数上限
plannerModel / researcherModel / synthesizerModel / reviewerModel	继承父配置	模型分级（OpenAI 指南：规划/综合用强模型，执行用便宜模型）

设计说明

• plugin ≠ skill：不注册进 ctx.skills；触发靠工具描述（深度研究/调研/多源信息综合分析等）。
• 复用官方能力：编排走官方 workflow 引擎（worker 隔离、并发/总数 caps、取消、进度事件、wf-runs 记录）；搜索/抓取走内置 web_search/web_fetch——插件零网络逻辑、零自研编排。
• 不碰 TUI：无 tuiPrompt / overlay / system-prompt 注入，规避 prompt 槽位 disposed 类崩溃。
• 取消传播：exec.signal 传入 workflow run，取消时子代理随之中止。
• 失败隔离：单个子问题研究失败只在该节标注；规划失败则工具报错，主代理可调参重试。
• 技能模板（.claude/skills/deep-research）保留不动，两者独立。

Profile 兼容性

本插件运行时依赖 DSH 官方 workflow 引擎（ctx.workflows，peer：@deepseek-ai/dsh-workflow）。 请把它安装进提供 workflows provider 的 Profile（如 tui/headless 组合）；若 Profile 未声明 该 provider（如部分 Web Profile 组合），Loader 会保持 pending——此时请先在 DSH Hub 登记 workflows provider 关系或改用提供该服务的组合。编译产物（lib/types/index.js）为官方 0810 生产入口，Node 原生可加载。