用途：smart-search-cli 是给 AI 工具使用的指令包，说明何时调用本地 smart-search 可执行文件、哪条命令匹配用户意图、如何保留来源证据，以及如何解读服务商状态与回退字段。它本身不提供搜索访问，实际工作由已配置的 smart-search CLI 及其服务商完成；它不是 MCP 服务器，不存储服务商 API 密钥，也不创建 Trellis、钩子、智能体或命令。
主要能力与路由：search 用于实时、广泛探索、社区信号与多来源摘要；route 在本地解释能力路由而不执行服务商；research 为在线深度研究执行器，覆盖规划、发现、抓取/阅读、缺口检查与仅基于证据的综合；deep 为离线深度研究规划器；zhipu-search 面向中文、中国境内、政策法规、公告与本地来源；context7-library / context7-docs 面向库、SDK、API、框架与文档意图；exa-search 面向官方域名、论文、产品页与日期/域名过滤的低噪声发现；fetch 用于用户提供的 URL 或依赖页面内容的断言；map 用于在批量抓取前了解文档站点或域名结构；anysearch-* 与 sciverse-* 为显式实验性垂直/学术搜索，不应作为默认回退。
使用方式：配置或可用性不确定时运行 smart-search doctor --format json；缺少配置时用 smart-search setup 或 smart-search config set KEY VALUE。若 doctor 返回 ok: true，则仅使用 smart-search CLI 子命令做网页研究，不要在同一任务中调用 Codex 原生网页搜索。安装技能可用 smart-search setup --install-skills，已安装技能通过 smart-search agent-guide 获取当前指令。检查或刷新技能用 smart-search skills status --targets codex --format json 与 smart-search skills update --targets codex --format json。架构变更后用 smart-search smoke --mock --format json，仅在确有真实密钥且用户期望实时检查时用 --live。
限制与边界：smart-search 应从用户 PATH 解析；私密 API 密钥应通过 setup 或 config set 保存，环境变量仍支持 CI 与高级用户；沙箱运行时可将 SMART_SEARCH_CONFIG_DIR 设为绝对可写路径。标准最小配置要求 main_search、docs_search、fetch 三类能力各有一个已配置服务商，缺失即为硬性配置失败。回退必须保持同能力，不得用 Context7 替代广泛新闻/网页事实，也不得用页面抓取服务商替代文档搜索。TAVILY_ENABLED=false 视为有意的无网络边界，不得绕过。对时事、政策、金融、健康等高风险事实，不得仅凭 search.content 作答，应抓取关键页面并只总结抓取文本支持的内容。回答中应保留命令行与来源 URL，优先引用已抓取页面或 primary_sources。更多命令示例、深度研究工作流、CLI 入口与配置细节见 references 目录下各参考文件。