用途:通过 Argus 搜索代理完成研究任务,不消耗 Claude Code 令牌,用于节省 Claude token。以廉价模式(仅 SearXNG)调用 Argus。
主要能力:先检查全局 docs-cache;命中则直接返回缓存文档路径,未命中则通过 Argus 搜索;若结果包含官方文档则加入全局缓存;最终在当前项目生成 docs/research/{date}_{topic}_final.md 研究报告。研究耗时 5-15 秒。
使用方式:命令为 /freesearch [topic]。流程需按顺序执行。第一步检查全局缓存:cat ~/github/docs-cache/docs/cache/.index.md | grep -i "[KEYWORD]",找到即返回缓存路径。未找到则先问 2-3 个澄清问题(目标、深度、受众)。第二步通过 Argus 搜索:curl -s -X POST http://localhost:8005/api/search -H "Content-Type: application/json" -d '{"query": "[TOPIC]", "mode": "cheap"}'。第三步若结果含官方文档,则加入全局缓存:cd ~/github/docs-cache,mkdir -p docs/cache/{category}/{name},写入 README.md 并更新 .index.md,然后 git add docs/cache/、git commit -m "Add cache: {name}"、git push。第四步在当前项目创建 docs/research/{date}_{topic}_final.md。
输出格式:命中缓存时显示 [CACHED] 及路径;否则显示 [Searched Argus: cheap mode] 与关键发现,并提示已加入缓存及完整研究文件路径。
回退方案:若 Argus 不可达,先执行 curl -s http://localhost:8005/api/health >/dev/null 2>&1,再检查 config/search.yaml 中的廉价模式提供方并直接调用。
限制与注意事项:搜索前必须先查缓存;仅将官方文档加入缓存,不加入随机博客文章;缓存位置为 ~/github/docs-cache/,是全局而非按项目隔离;资料暂未提供其他收费、平台或效果信息。