调研编排层/Agent Skill + MCP + Hook/MIT

把一次调研, 做成能溯源的档案

Lead Agent 并行派发子 Agent 检索 34 个数据源,每条结论落成 claim 挂上一手来源与 Tier 分级; 发布前过机器校验门并盖防伪戳——没戳就等于没校验。环境不足时硬停并给出配置指引,不静默降级开跑。

下载离线安装包 查看源码
32数据源 · 四层
4阶段范式 PESR
891项测试,解包后实测
1个第三方依赖(ddgs)
3.10+Python 版本要求
01

拿到 zip 就能装,不需要 git

解压后三条命令完成安装。硬性校验由包内自带 Python 执行,不依赖宿主是否加载插件。

bash — 在解压出的 deep-research-ultra/ 目录内
$ pip install -r skills/deep-research-ultra/requirements.txt
$ rm -rf ~/.qoder/skills/deep-research-ultra && cp -r skills/deep-research-ultra ~/.qoder/skills/
# Windows:robocopy skills\deep-research-ultra %USERPROFILE%\.qoder\skills\deep-research-ultra /MIR(返回码 0/1/3 都算成功,≥8 才是失败)
$ python skills/deep-research-ultra/scripts/research.py --probe
[GATE] 引擎今天真出不出数据,逐项实测后打印清单

SKILL.md 必须在顶层:最终路径要是 <skills>/deep-research-ultra/SKILL.md,再深一层宿主扫不到。

宿主不限于 Qoder:Claude Code、TRAE、Codex CLI 等能读 SKILL.md 的都可以,换宿主只换落点目录。

想要 drux_* 工具与收尾 Stop 钩子,再把同一份目录登记为宿主插件——可选加分项。

02

34 个数据源,按四层分级调用

下面的清单与计数来自 research.py --list 的实际输出。虚线框的那批要先配 key 才解锁。

L1

MCP 服务器 + 学术直连13 个

优先走带全文与引用图谱的学术通道,同行评审论文稳定落进高 Tier
OpenAlex 474M+Semantic ScholarPubMed Europe PMC 全文Crossref DOI arXiv 全文Unpaywall OA引用图谱 TavilyFirecrawlopen-websearch paper-searcharXiv 搜索
L2

Skill 层 + GitHub 深挖 + 国内平台14 个

分桶搜索覆盖到 <10 star 的项目;本土平台交给百度与搜狗
GitHub 深度搜索GitHub Codeoss-finder last30dayssciversedefuddleContext7 百度 SERP搜狗微信搜狗知乎百度学术 魔搭模型卡Giteeagent-reach
L3

宿主内置 + 浏览器抓取3 个

宿主自带通道只在 Agent 进程里有效,路由时单列一档,不与脚本通道混算
WebSearchWebFetchCrawl4AI
L4

降级兜底 + 反爬4 个

curl_cffi 做 TLS 指纹伪装,失败自动退避重试,最后才动 HTML 解析
DuckDuckGo (ddgs)SearXNG百度 HTMLBing HTML

34 个源里 5 个要先配 key 或服务,其余 29 个开箱即用——这个分配只取决于配置,用 --list 查一次就是定数。至于某个源此刻到底还出不出数据,那是 --probe 的实测范围,别拿静态数字当结论。

03

四道机器门,不靠自觉

都是包内脚本执行的硬校验,两种用法(解包 / 插件)下同样生效。

A

证据账本

结论落成 claim,挂来源与 Tier 1–4;转载指纹算独立来源,不重复计数。 归属型断言走「一手制品 + 逐字反查」,跨域三角只给多来源立论用。矛盾记 conflict 并留处置,就地更正附 amended_at 留痕。
B

发布前校验门

主指标是引用—证据对齐:被引用立论的 claim 必须 verified 或已标冲突;引用编号不得指向不同来源。 全量覆盖率只告警不阻断——分母里含没写进报告的过程记录。
C

防伪戳

过门后 --stamp 盖上正文与账本指纹,交付前 --verify-stamp 复核。骨架里的【待写】占位过不了门。
D

Phase 0 环境闸门

--probe 逐项实测引擎出不出数据,出数据不足 3 个 / 覆盖不足 2 层 / 无一手制品通道 → 退出码 3 硬停, 并逐条打印去哪申请、解锁什么、配哪个变量。要带缺口开跑得显式加 --allow-degraded,且会强制声明数据源受限。
04

Plan → Execute → Synthesize → Reflect

主 Agent 担任 Lead,一次性并行派发子 Agent;产物逐段落盘,返回值只给短摘要。

PHASE 1

Plan 拆解

MECE 问题树,6 状态子问题机。识别查询意图,按主题生成引擎链。

PHASE 2

Execute 检索

三级级联路由派发子 Agent 并发检索;单引擎挂掉不吞掉其余引擎的结果。

PHASE 3

Synthesize 综合

CER 结构组织,CRAAP 评分,推荐等级 Adopt / Trial / Assess / Hold 与雷达图。

PHASE 4

Reflect 反思

多信号收敛:边际收益递减即停,无高优先级缺口才交付,专家团对抗补空白。

05

它刻意不做的几件事

这些是产品立场,不是待办。

不接入需绑卡的免费额度

每月有免费量但要求绑定银行卡的数据源,一概不接入、不推荐、不在引导里出现。

不把「宿主专属」报成可用

只能在 Agent 进程里生效的通道标 🤖,不计进脚本侧可用数,也不进建议的 --sources。

不把限流当高风险

仓库健康度扫描分五态,429 / 403 判 UNKNOWN 并提示配 GITHUB_TOKEN,不冒充仓库本身有问题。

不把下载成功当读到内容

PDF / LaTeX 先验魔数、篇幅、完整性与论文 ID;被网络层换成报错页不算下载成功。

下载 v7.0.0 安装包

一个 zip 就是全部:内核 skill、MCP 服务、Stop 钩子、校验脚本与全部测试。解压后按上面三条命令安装,离线可用。

文件deep-research-ultra-v7.0.0.zip
内容源码 + 校验脚本 + 全量测试
内核版本6.47.0
插件壳版本7.0.0
许可MIT
已复制