@dsh-external/dsh-deep-research

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

理论 → 机制

结构

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

工具参数

配置（可选）

设计说明

• 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 原生可加载。