正文内容
Codex 深度搜索
利用 Codex CLI 的网页搜索能力,执行需要比 Brave API 片段更深入信息的研究任务。
何时优先选用 codex-deep-search(而非 web_search)
- 涉及复杂或小众主题,需整合多个来源的信息
- 用户明确要求全面、深入的研究
- Brave 返回的结果过于浅显,或缺乏必要背景信息
使用方式
分发模式(推荐 — 后台执行 + 回调通知)
nohup bash /home/ubuntu/clawd/skills/codex-deep-search/scripts/search.sh \
--prompt "您的研究查询" \
--task-name "notebooklm-research" \
--telegram-group "-5006066016" \
--timeout 120 > /tmp/codex-search.log 2>&1 &
分发后:告知用户搜索已在后台运行,结果将通过 Telegram 发送。切勿轮询检查结果。
同步模式(仅适用于简短查询)
bash /home/ubuntu/clawd/skills/codex-deep-search/scripts/search.sh \
--prompt "快速事实类查询" \
--output "/tmp/search-result.md" \
--timeout 60
随后读取输出文件并进行摘要总结。
参数说明
| 标志 | 是否必需 | 默认值 | 说明 |
|---|---|---|---|
--prompt |
是 | — | 研究查询语句 |
--output |
否 | data/codex-search-results/ |
输出文件路径 |
--task-name |
否 | search- |
任务标识符 |
--telegram-group |
否 | — | 用于回调的 Telegram 聊天 ID |
--model |
否 | gpt-5.3-codex |
模型覆盖选项 |
--timeout |
否 | 120 |
自动终止前的秒数 |
结果文件
| 文件 | 内容 |
|---|---|
data/codex-search-results/ |
搜索报告(增量式写入) |
data/codex-search-results/latest-meta.json |
任务元数据及当前状态 |
data/codex-search-results/task-output.txt |
Codex 原始输出内容 |
核心设计原则
- 增量写入:每轮搜索结束后即保存结果,可抵御 OOM 或超时导致的中断
- 低推理开销:降低内存占用,避免因内存溢出触发 SIGKILL
- 超时防护:自动中止失控的长时间搜索任务
- 分发模式:后台执行 + Telegram 回调,无需轮询