| name | yichen-unified-search |
| description | 统一编排关键词驱动的公共网页、AI 最新动态、垂直领域和社交平台搜索，返回标准化候选；支持有界 X Research、显式站点 Map，以及本次搜索所得候选的轻量核验。不用于读取或下载用户直接给出的已知 URL，此类任务使用 yichen-content-archive。 |
逸尘统一搜索
按“确定范围 → 离线路由 → 执行候选搜索 → 标准化与核验”处理任务。保留用户指定的平台、关键词和时间，不把候选当成已核实事实。
固定边界
- 只处理当轮目标所需的公开内容。不发帖、评论、点赞、关注、私信或改变账号状态；不读取、同步或搜索私人收藏、书签、个人 Feed、群组、通知、私信、草稿或后台。
- 绝对不得操控微信桌面或移动端 UI。公众号只走匿名公共搜索。
- 不下载媒体、不归档、不建长期数据库、不运行定时监控。用户给出已知 URL、URL 文件或要求读取/下载/归档已确认候选时，交给
$yichen-content-archive，传递动作、范围和输出位置，并重新确认动作与范围；搜索不授予下载、私域、登录态或费用权限。
- 不绕过验证码、登录墙或风控。以下明确列出的只读登录态路线以外，不升级账号访问。后端失败与零结果分开报告；未知字段保留
null。
- 查询和候选 URL 会发送给计划指定的服务。不得包含密码、Cookie、个人数据、商业秘密或其他敏感内容；凭证处理与各服务的数据流见 访问与凭证边界。
离线路由
下文 SKILL_DIR 指本 Skill 的安装目录，YICHEN_SKILLS_ROOT 指同级 Skills 根目录；使用前按实际安装位置设置并导出这两个变量。
python3 "${SKILL_DIR}/scripts/route_search.py" \
--query "检索词" --platform auto --mode search --limit 10
路由器不联网。执行前检查 status、authorization、steps 和 limitations。invalid_request 无可执行步骤，CLI 退出码为 2；依据提示在已授权范围内调整参数，不把它当成零结果。范围清楚时直接执行，不要求用户逐项重复确认。
| 目标 | 路线与使用方式 |
|---|
| 普通网页、概念/教程、批量关键词、垂直领域 | AnySearch；anysearch_adapter.py 输出统一 envelope，垂直域先发现子域与全部必填参数 |
| AI 主题且具有新闻/最近/发布意图 | AI HOT 精选；明确“日报”才用日报，明确“全部”才用全量 |
| 指定平台站内搜索 | 平台意图优先于 AI HOT；使用计划中的平台适配器 |
| 多平台或多个关键词 | 每个原始查询必须有执行或拆分记录，不能丢弃；不同平台意图返回 query_routes，按平台拆分并显式传 --platform |
| 公开站点链接枚举 | 仅显式 --mode site-map，Firecrawl 最多 100 条同源且位于种子路径范围内的候选，不读正文 |
| 本次搜索所得候选核验 | 默认 AnySearch；仅显式 --verify-backend firecrawl 才用 Firecrawl |
“微博公司财报”是搜索对象，不等于微博站内搜索。自动识别有歧义时，根据当前任务直接显式选择平台；只有无法判断用户意图时才询问。普通 issue 不触发 GitHub 路线。
- YouTube、GitHub、B站、公众号、小红书、抖音、头条、小宇宙的原生
search 一次只接收一个查询；多查询应分别运行，或明确选 batch 使用公共 site: 索引。知乎和微博有各自的显式原生 batch；X Quick 支持重复 --query。具体能力见 路由契约，单查询限制集中在 scripts/search_policy.py。
- AI HOT items 最多 7 天；路由器同时检查自然语言和显式
--days，后者优先。超过范围的自动请求走 AnySearch，显式 AI HOT 报范围错误。多主题最多 5 个，适配器分别检索、合并去重并记录 matched_topics 与逐主题 coverage。数量不足或主题失败必须如实交付。日期、日报与滚动窗口不同，严格时间任务还需核对原文时间。
- AnySearch 通用路线不直接落实
--days，必须在查询中保留时间范围，交付前核对日期。长窗口转到 AnySearch 不代表已完成确定性日期筛选。
- URL 仅在用户明确要求搜索其引用/讨论时作为
--input-kind url-seed；不读取种子本身。站点 Map 和明确 YouTube 频道浏览是发现容器例外；普通已知 URL 仍交归档层。
执行与核验
- 根据路由读取 references/routes.md 中对应后端的参数与限制；不要默认加载全部平台细节。X、多后端或登录态路线先运行
${YICHEN_SKILLS_ROOT}/yichen-web-research/scripts/doctor_yichen.py；OpenCLI 路线再运行 opencli doctor。命令存在不等于可用，不回调总路由 Skill。
- 只执行计划中的后端。AnySearch 使用
anysearch_adapter.py（读取现有 runtime.conf），AI HOT 使用 aihot_search.py，知乎使用 zhihu_adapter.py search|hot，微博使用 weibo_adapter.py search --session-mode auto，YouTube 使用 youtube_search.py；不复制 CLI、硬编码代理或 Key。
- AI HOT、AnySearch、显式 Firecrawl 不可用时报告错误，只有用户同意后才改换公共网页后端。已有明确登录态例外见下一节；不要扩大例外。
- 按 candidate-schema.md 交接候选、routes、coverage、errors。非空原始结果无法解析必须记为错误；保留真实后端、原始 URL、时间限制和登录态。AI HOT 异常条目计入 rejected_count，全部异常为 failed，部分异常为 partial，不能冒充成功零结果。
- X 按 tweet_id、再 canonical URL 去重；其他平台按 URL 去重，并保留命中查询与来源。标题/作者/时间均高度一致才合并近重复；互动量不能证明事实。
- 搜索卡片、AI HOT 的 AI 摘要都只是线索。最终引用前打开原文核验具体主张。本轮 AnySearch 核验必须向
anysearch_adapter.py verify --candidate-from-search 提供带有效 HMAC 回执的完整 candidate JSON 或 @file；明确选择 Firecrawl 时交给 firecrawl_adapter.py scrape。不接受裸 URL 或自行拼接候选，打开页面本身也不等于事实核验。
登录态与 X Research
- 小红书、抖音：允许有界公开只读搜索自动复用现有 Chrome 会话；后台临时会话、一次一个关键词、串行且间隔至少 5 秒，单次分别最多 20/30 条。不复制或输出 Cookie。
- 微博：临时匿名访客会话优先，仅访问门失败后自动执行一次有界 OpenCLI 只读搜索；网络错误不触发回退。每次最多 3 页、最多 20 条，批量最多 5 次且串行间隔至少 5 秒。
- 知乎只走另行安装的 Open Platform CLI 兼容运行时 与其 Keychain，不接收 Secret。B站、YouTube、微信公众号、头条、小宇宙先匿名，登录限定时停止。
- X 一律先官方 Grok CLI OAuth + 原生
x_search。只有明确额度耗尽才能转 FxTwitter；随后失败或零结果才进入 OpenCLI → xreach，使用浏览器登录态前按工具要求取得当轮授权。未登录、401/403、超时、网络、服务错误和主链零结果都不能当成额度耗尽。
- X Quick 每个查询独立调用，单次最多 20 条、1–7 天。
--depth research 至少 3 个独立聚焦查询；只执行当前 ready 波次，归一化并合并后才解锁后续波次。最多 40 次外层搜索、最多补搜一轮，达到目标、预算耗尽、无缺口、补搜无新增或主链非额度故障时停止。详见路由契约的 X 节。
- 每次 Grok 输出必须经过
grok_x_result_adapter.py，只映射 <x_post_time_verification>.matched，排除 excluded_outside_window，然后用 x_research_merge.py。Grok criteria 只是检索约束；作者、语言、互动阈值和转评类型只对实际结构化字段筛选，缺失时保留未知，不能声称已验证。
X 的浏览器回退默认关闭。只有取得当轮明确授权后才传 --login-approved；路由器据此设置 allow_authenticated_fallback=true，未授权时保持 false。知乎路线使用 zhihu-open-platform-cli，Keychain 认证访问公开内容并标记 authenticated_public / login_state_used=true；不以官方身份背书。
交付
返回 {schema_version, request, routes, candidates, coverage, errors}。用户只要答案时用 Markdown 展示精选结果，保留相同字段语义。说明各平台覆盖、失败、截断、日期与登录态限制，不宣称穷尽或把候选当事实。上游许可见 THIRD_PARTY_NOTICES.md。
