本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-deep-research

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add github:omdsh-dev/dsh-deep-research

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 「深度调研一下 MCP 生态现状，重点对比几家主流实现，出一份带引用的报告」
• 「按这份问题清单做研究：1. ... 2. ...」（已有清单 → 跳过自动拆解，直接并行研究）
• 「调研一下 A/B 方案，purpose 是决定我们选哪个」（用途越明确，答案空间越准）
• 复杂主题会自动扩展轮次（自适应闭环），简单主题一轮收敛；想要更严谨传 depth: 3，
• plugin ≠ skill：不注册进 ctx.skills；触发靠工具描述（深度研究/调研/多源信息综合分析等）。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

这个插件和官方 .claude/skills/deep-research 是同一回事吗？

不是。.claude/skills 下的 deep-research 是 skill 体系，本插件是 cordis 插件，挂在官方 workflow 引擎上跑；README 与源码都明确两者独立、互不替代（README.md:107-114）。

安装后需要额外配置吗？

不需要。Config 全部可选（src/index.ts:73-85）；默认按继承父 profile 配置跑。最常用的微调是把研究阶段换成便宜模型，规划/综合保留强模型以省成本（README.md:69-70）。

depth 参数到底是几轮？

depth 决定研究阶段最多几轮（深度=轮次上限-1）：1=初步（最多 2 轮），2=深入（默认，最多 3 轮），3=穷尽（最多 4 轮）；达到上限或某一轮没有新增 high-priority 缺口即停（src/index.ts:428-431 / 469-472）。

有些 Web Profile 装上后没生效怎么办？

本插件运行时依赖官方 workflow provider；如 profile 没声明 workflows provider，loader 会保持 pending，此时要么去 DSH Hub 登记 provider 关系，要么改用已经提供该服务的 profile 组合（README.md:117-122）。

如何升级和卸载？

升级 dsh plugin --profile <profile> update，卸载 dsh plugin --profile <profile> remove @dsh-external/dsh-deep-research，或从 profile 的 package.json 移除依赖后再次 update（README.md:77-81）。

这个插件会自己抓网页吗？会不会被风控拦？

不会。搜索/抓取全部走宿主内置的 web_search/web_fetch（src/index.ts:255 / 401-413），插件本身零网络逻辑、零自研编排，子代理用宿主继承下来的同一组工具。

我已经列好问题了，怎么跳过自动拆解？

把问题清单作为字符串传给 questions 参数（每行一个，或 1./2./3. 编号），插件就会跳过规划阶段直接进入并行研究（src/index.ts:208 / 475 / 543-550）。

简单主题真的会一轮就结束吗？

会。收敛条件是信息论意义上的：某一轮没产出任何新的 high-priority 缺口就停；规划代理声明的盲区假设会作为补充侦察进入下一轮，但如果实际查证后无可获信息也不会硬凑（src/index.ts:280-312 / 246-249）。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 未声明
• Node: ^22.19.0 || >=24.0.0

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则