explore — 仅基于订阅的增强研究
用途
explore 是 researchkit 的完整增强研究流水线,每一步都运行在订阅制 CLI harness 上:council(5 个 harness)负责细化主题并将其拆解为多个子调查;每个子项目使用五个 CLI 提供方进行研究(包含网络搜索);各子报告摘要以及跨主题的超级摘要同样通过 CLI 运行。整个流程在任何步骤都不读取 API 密钥。
何时使用 / 何时不使用
适用于不希望产生 API 费用或无法获得 API 密钥时的深度、带引用研究。不适用于:快速提问(一次运行会消耗 15–30 分钟的真实订阅用量)、纯观点类问题(应使用 /advise、/council),或追求最大来源广度——API 提供方能更快收集更多引用;harness 路径以广度换取深度(由真正阅读页面的智能体完成)。
工作流程
首先选择输出目录。如果你所在项目有被 gitignore 忽略的 .local/ 目录,请把运行结果放在那里——研究输出体积较大,绝不能进入提交:
git check-ignore -q .local && export RESEARCHKIT_PROJECTS_DIR="$PWD/.local/research"
要确认它确实被忽略(git check-ignore -q .local),而不仅仅是存在:未被忽略的 .local/ 会把整个包纳入暂存。若没有 .local/,则不要设置该变量,输出将进入 projects/。
从 researchkit 仓库根目录运行(或使用 --directory 指定检出目录)。给主题加引号;按需添加标志:
uv run researchkit explore "TOPIC" --days 7 uv run researchkit explore "TOPIC" --materials --ingest ../brainkit/brain
它是在运行而非卡死:stderr 上的 [boost] heartbeat 行会跟踪 council、每个子项目的提供方以及超级摘要的进度。
输出位于 <projects-dir>/<timestamp>_<topic>/ —— 若第一步设置了变量则为 .local/research,否则为 projects/(绝对路径会以 wrote: … 打印):子报告位于 subprojects/*/report.md,超级摘要为父级 report.md。--materials 会按子项目归档被引用的页面;--ingest <brain> 会把本次运行交给 brainkit。
转述超级摘要;如需深入可指向各子报告。若 stderr 显示 "super-summary unavailable",子报告仍然有效。
默认值来自 models.yaml 中的 harness 预设(提供方 codex:gpt-6-astra / agy:gemini-3.8-flash-high / grokcli:grok-4.6 / kimicli:kimi-code/k3 / claude:claude-opus-5;站点研究关闭——其连接器属于 API 密钥路径)。--preset <name> 可整体替换模型集合。先运行 uv run researchkit doctor --preset harness 验证每个固定项——20 分钟的运行不是发现模型 id 失效的好时机。
失败模式
各提供方独立降级:某个 harness 失败或没有返回内容(实际观察到:codex 拒绝重型研究提示)只会损失其来源,不会导致整个运行失败——目前 Claude Code 和 Grok CLI 承担了深度部分。每次 harness 调用有 30 分钟预算(可用 RESEARCHKIT_CLI_TIMEOUT=<seconds> 覆盖),因此较慢的智能体也能完成而不会超时。
五个 CLI 都必须已登录;按设计没有 API 回退。
预算提示:一次增强运行会对你的订阅发起大量 harness 调用——不要随意循环运行。