version: "1.0.3" name: guanlan description: > 观澜是面向 AI Agent 的中文互联网信源与平台路由器。 默认只读、低扰、明源，覆盖搜索、热榜、社交、视频、开发者社区与网页阅读。

【路由方式】SKILL.md 包含路由表和常用命令，复杂场景需按需阅读对应分类的 references/*.md。 分类：search / hotnews / social (小红书/抖音/微博/推特/B站/V2EX/Reddit) / career(LinkedIn) / dev(github) / web(网页/文章/公众号/RSS) / video(YouTube/B站/播客).

Use when user asks to search, read, or interact on any supported platform, shares a URL, or asks to search the web. triggers:

• search: 搜/查/找/search/搜索/查一下/帮我搜
• hotnews: 热榜/热点/今日热点/快讯/趋势/舆情
• social:
• 小红书: xiaohongshu/xhs/小红书/红书
• 抖音: douyin/抖音
• Twitter: twitter/推特/x.com/推文
• 微博: weibo/微博
• B站: bilibili/b站/哔哩哔哩
• V2EX: v2ex
• Reddit: reddit
• career: 招聘/职位/求职/linkedin/领英/找工作
• dev: github/代码/仓库/gh/issue/pr/分支/commit
• web: 网页/链接/文章/公众号/微信文章/rss/读一下/打开这个
• video: youtube/视频/播客/字幕/小宇宙/转录/yt
• finance: 雪球/股票/stock/xueqiu/行情/基金
• wps_office: 金山办公/WPS/WPS AI/WPS365/办公AI/PPT/Agent/信创办公
• entertainment: 文娱/娱乐/影视/电影/电视剧/综艺/明星/票房/豆瓣/猫眼/游戏/欧美娱乐/日韩娱乐/K-pop/J-pop
• watch/radar: 长期观察/持续关注/每天扫/定期看/监控/watch/radar/standing intent
• archive/wiki/rag: 本地知识库/archive/RAG/向量库/Agent Wiki/知识底座
• diagnose/recipe: 页面读不到/动态页/登录墙/WAF/研究模板/固定流程/recipe
• report: 报表/html report/可视化报告/汇报页/出个报告
• daily: 日报/晨报/每日简报/今日简报/品牌日报/舆情日报/市场日报
• site_map: 站内/站点/网站/官网/文档/价格/API/公告/联系方式/下载页/sitemap
• yinshen: 引申/发散/扩展选题/选题角度/关键词地图/专题策划/angle

metadata: openclaw: homepage: local-repo

观澜 / Guanlan — 路由器

面向 AI Agent 的中文互联网信源与平台路由器。根据用户意图选择对应分类。

Agent 运行规则

• 把 AGENTS.md、docs/agent-playbook.md、docs/agent-usage.md 和本文件当作 Guanlan 的长期记忆入口；做新 benchmark、自动化或 MCP 编排前，至少重读前两份。
• 搜索、研究、热榜、回响和本地知识库检索时，默认使用 80 条候选池；复杂调研可提高到 80-100。
• 只有用户明确要“少量样本”“快速试一下”“只看前几条”时，才主动降低 limit。
• 如果命令或用户要求 --limit 小于 30，把它当作 smoke sample，不要直接下强结论；读取 trace 里的 agent_limit_advice.silent_repair_commands，除非用户明确只要 smoke，先无感补跑 --limit 80 再回答。
• --site 是硬过滤：--site gov.cn 不允许返回知乎、SEO 页或其他域名当作结果；为空时按 external_fetch_strategy 或站内入口补证。
• 显式年份/年份范围是强时间窗，窗口外材料只作背景，不应进入主时间线或写成最新证据。
• 强路由命中时直接走对应 --preset 或 --scope，不要先泛搜一轮；只有意图混合、拿不准信源角色、或需要解释路由时，才先跑 guanlan route "query" --json。
• 强路由包括：WPS/AI Office wps_office、欧美娱乐 global_entertainment、日韩娱乐 jp_kr_entertainment、CVE/反诈 cybersecurity、天气灾害 weather_disaster、体育 sports、财经/股票/宏观金融 finance、科学新闻 science、职场薪资面经 career、播客 podcast、考试备考 test_prep、高校招生导师 university、学术投稿检索 academic、产品/公司口碑 reputation。
• Agent 自动挡：如果只是拿不准该用哪个 Guanlan 命令，先跑 guanlan agent "query" --json；MCP 模式调用 guanlan_agent。它只做本地规划，默认返回 schema_version=agent_plan_v2、primary_command、少量 agent_next_steps、task_model、capability_selection、execution_contract 和 self_check_contract。执行 primary 后，把 Guanlan JSON/错误摘要交给 guanlan agent "query" --phase review --observation-json result.json --json 或 MCP guanlan_agent phase=review，按 next_decision=answer|continue|repair|ask_user|authorize_browser|stop 决定回答、补证、换路由、请求授权或停止。--mode quick 保持轻路径，--mode fresh 把 hotnews/feeds 放进短链路，--mode deep 进入深查。
• Evidence Mixer 只做候选证据优先级诊断：默认 search 附带 evidence_mixer_shadow，不删除、不重排、不扩大空结果率；需要 Agent 明确看到优先阅读顺序时用 --evidence-mode assist，回滚或对照时用 --evidence-mode off。coverage_floor fallback 说明应保留完整候选池继续补读，不应收紧过滤。
• 信源解释：当需要说明“为什么该看这些来源/某来源能不能当主证据”时，先用 guanlan sources explain "query" 或 guanlan sources show gov.cn；需要治理口径漂移时用 guanlan sources audit。这些都是只读信源元数据，不是实际搜索结果。
• 搜索入口目录：query_strategy.search_entrypoint_policy 与 sources explain/export 会展示 Baidu/Bing/DuckDuckGo/搜狗微信/头条/集思录/Google 等入口的适用边界和 operator 提示。它是只读目录，不是“逐个裸抓 17 个搜索引擎”的执行计划；真正执行仍走 Guanlan search 后端、scope/site、AnySearch 和质量门禁，不把 session cookie retry 当稳定恢复能力。
• 站点入口发现：用户给出明确网站/域名并要找站内文档、价格、公告、API、联系方式或下载页时，用 guanlan map "https://example.com" --query "pricing docs" --limit 80 --read-top 2。map 只从公开 robots.txt、sitemap XML 和页面链接发现候选 URL；不是全网搜索、不是规模化爬取。--read-top 只读取少量代表页，回答只能引用 read_pack.readings / readings 中 read_evidence_v1.usable=true 的正文，未读 URL 仍只是入口线索。
• 轻重分流：不确定任务该轻搜还是深查时，先跑 guanlan workflow "query" --json；simple/direct 任务不要过度规划，复杂/高风险/对比/时间线/档案任务才用 guanlan investigate "query" --limit 80 --format context。
• 页面诊断：当 read 读到动态页壳、登录墙、WAF、安全验证、搜索兜底或弱正文时，先跑 guanlan diagnose page "URL"；诊断只解释页面是否能当证据，不读取 Cookie，不执行浏览器动作。
• 浏览器辅助补证：如果 diagnose page 输出 browser_assist.recommended=true，必须先询问用户授权；如需登录、验证或切换账号，让用户自己在浏览器里完成；Agent 只读取目标页面的浏览器可见内容，本次可见页补证不读取 Cookie、Token、钥匙串、localStorage、sessionStorage、浏览器数据库/profile 或无关个人信息。私信、订单、后台、账号页只有在它们就是目标页且用户单独明确授权目标、用途、风险和只读范围时才读取，并标记 private_account_evidence=true；如果仍需 Cookie 或其他凭据材料，必须另行说明平台、用途和风险并获得用户明确同意，凭据材料不得进入 browser-visible payload，也不点赞、评论、关注、发帖、私信、下单或提交表单。OpenGuanlan 就是 Guanlan 的浏览器补证总层，默认复用宿主 Agent 浏览器可见页契约，不要求插件、daemon、OpenCLI、Playwright 或独立浏览器 profile。用户授权后可先用 guanlan browser-assist adapters --check 查看只读适配器自检，用 guanlan browser-assist sessions "URL" --json 获取同一目标页会话契约，再用 guanlan browser-assist run "URL" --adapter openguanlan --json 取得 OpenGuanlan 执行契约；可见页结果优先由宿主 Agent 直接提取 JSON/JSONL，并用 guanlan archive add-browser-note --from-json browser-notes.jsonl 入库。openguanlan-bridge 只是可选扩展桥；只有用户明确需要独立 Chrome/Chromium 桥时，才用 guanlan browser-assist setup-openguanlan --json、openguanlan pair-code --json 和扩展 popup 配对。open-cli 只作为兼容迁移入口，不要求用户安装 OpenCLI。xhs-cli 等外部适配器必须由用户预先配置；不要临时下载 Playwright、启动独立浏览器或读取浏览器 profile。--url "URL" --text-file notes.md 只是无浏览器提取能力时的手动兜底，并保留 browser_assisted / visible_page_only 边界。
• 浏览器可见页动态采集不能只靠固定 sleep。优先等待标题/正文、结果数增长、DOM 变化趋稳或相关网络响应；aria-label、placeholder、title、按钮文字等会随语言变化，不要用单一 UI 文案当唯一 selector。列表、评论、搜索页需要样本池时，用 --min-visible-items 并输出 requested_min_items、collected_count、partial_reason；未达到目标要标记 partial，不要把空结果当成功。
• 研究模板：高频垂直任务先用 guanlan recipe list / guanlan recipe run <recipe> "query" 固化流程，例如 finance-risk、university-advisor、product-reputation、public-opinion-pulse、brand-risk-watch、competitor-watch、pricing-watch、review-mining、app-review-pulse、entertainment-pulse、security-advisory、tech-radar、wps-office-radar、trajectory-map。
• 关键词引申/选题发散用 guanlan yinshen "关键词" --limit 80 --angles 5-8。它先建立关键词证据语境，再生成媒体友好的延展角度和每个角度的深搜路径；不要把它当成无来源脑暴。
• 不要把 Guanlan 降格成“一次泛搜”。默认工作流是动态分档：结果已可用时走 search -> read；普通研究走 route -> scoped search -> read；热点题先补 hotnews；技术/AI/WPS/AI Office 题补 feeds；来源过窄时再补 dossier/compare/timeline 或受控 research。
• research 是重型证据包工具，不是 Agent 自动挡的第一选择。只有用户明确要深度综合/可复用证据包，或 search + read 后仍缺信源角色覆盖时再用；MCP/Agent 默认把 read_top 控在 0-2，并优先用单独 guanlan read 补代表 URL。Schema 接受 0-5，3-5 只给用户明确要求多页深查且宿主外层 timeout 为 180-300 秒的任务。
• 宿主 Agent 的数值边界：正常搜索 limit=80，同类搜索最多 2 轮，同一工具失败最多重试 1 次，单任务网络并发推荐 2/上限 3，重型工具并发和单任务数量都为 1，总工具调用推荐 4-7/上限 12。compare 只接受 2-4 个对象名，比较维度单独放 focus；不要先完整泛搜后再重复跑整套 compare/research。
• 体育比分/赛程、财经行情/公告披露/宏观数据、天气灾害、CVE、安全公告、科学机构声明、文娱榜单/票房、考试官方信息等高确定性垂直题，优先执行 route 推荐的 direct guanlan read 命令，再用匹配的 preset/scope 扩大证据面；不要只看搜索引擎是否返回。
• 在完成当前档位要求的 Guanlan 工具前，不要立刻切 web_search/web_fetch。quality_summary=warn 通常表示证据包还不完整，不等于 Guanlan 搜索失败。
• quality_gate.reason=partial_salvage 表示观澜保留了强官方/垂直信源线索但仍有覆盖缺口；先读代表原文，不要写成失败。read 出现 兜底状态: unusable 时，不要引用搜索兜底，改用页面诊断、结构化入口、scope 搜索或 WebFetch 定点补证。
• 使用 guanlan agent "query" --json 时，先执行 primary_command，再用 review 模式复盘观察结果。若出现空结果、小 limit、preferred 命中为 0、后端降级、partial_salvage、时间窗不符、read 不可用、official-only 或 research timeout 等信号，按 review 返回的 next_commands 先补证；用户面前不要说 Guanlan 崩了/坏了/没搜到，而是说明“当前证据包覆盖不足，需要补证/补读代表性来源”，再合并证据回答。
• 如果 Guanlan 输出 external_fetch_strategy，可以调用宿主 Agent 的 WebFetch/WebRead 读取候选 URL；外显时说明这是“Guanlan 规划信源 + WebFetch 定点补证”的搜索策略，不是 Guanlan 脆弱。
• guanlan read --format json 的 backend_capability / extract_contract 是给 Agent 的内部抽取契约：can_cite_as_page_body=true 才能引用目标页正文；status=context_only 只是搜索兜底线索；truncation.content_truncated=true 表示正文被截断。对用户表达为“需要补读代表页/原文”，不要表达为工具报错。
• 面向用户不要写“Guanlan 崩了 / 抽风了 / 挂了 / 炸了 / 翻车 / 拉胯 / 坏了”。只在影响证据边界时说明“目标页公开读取超时或上游响应慢，已按 Guanlan 定点补证路线读取目标页”；否则直接给来源和结论。
• 做 benchmark 时不要误用：实时题必须带 hotnews，技术/AI/WPS/AI Office 题必须带 feeds，政策题要测 search --scope gov + read；research --preset ... 只作为深查/证据包链路单独评估。
• 自动挡或路由规则变更要沉淀 positive/negative/near-miss：把错例加到 tests/fixtures/routing_regression_cases.jsonl，用 expected_* 和 forbidden_* 同时约束命中与误命中，再跑 tests/test_routing_regression_cases.py、guanlan eval benchmark 和 guanlan eval suite run chinese-web-v1。
• guanlan quality live-smoke 是可选公网漂移探针，默认不阻断。长期观察用 guanlan quality live-smoke --record-history --trend-window 10，看 live_trend_report 的 new/recovered/persistent/network-or-upstream 信号；--strict 仍只按本次 fail 决定退出码。
• 如果 Agent/MCP/自动化平台能设置工具 timeout：search/read/status/doctor 用 60-90 秒；hotnews/feeds/pulse/read batch 和默认 archive ingest-research 用 120 秒；research/compare/timeline/dossier/archive ingest-research --read-top N 用 180-300 秒；安装/升级/发布 smoke 用 300-600 秒。单位要按宿主字段名换算：timeout_budget_seconds 传秒，timeout_ms / timeout_milliseconds 传毫秒，例如 120 秒 = 120000 ms、300 秒 = 300000 ms；不要把 timeout=120 这种裸数字交给下游。
• 超时只代表网络或上游源未完成，不代表没有证据；优先重试一次、加 --cache-ttl 3600，或把 --read-top 降到 0/1，不要为了速度把 80 条候选池砍成小样本。
• 科技/AI/WPS/AI Office/开发者/工程实践类问题必须额外补一轮 RSS/精品内容流；默认用 search --scope tech_dev|wps_office 加 guanlan feeds curated --category ai --limit 80。AI 公司、模型、Agent、开发者平台更新类任务再补 guanlan feeds ai-official --limit 80 和 guanlan feeds ai-media --limit 80。research --preset tech|wps_office 只在深查/证据包模式下使用，且保持 --read-top 0-2。
• arXiv、预印本、论文线索和近期研究发现任务补 guanlan feeds arxiv --keyword "query" --limit 80。preprint_record 是论文候选，不是同行评议结论；若输出 preprint_search_entrypoint / api_unavailable，使用返回入口或 research --preset academic 继续补证。
• 长期观察指定博客、项目、机构公告或固定源池时用 guanlan feeds watchlist --watchlist PATH --limit 80；watchlist 支持 JSON、JSONL、每行一个 RSS/Atom URL。watchlist_update_signal 要保留 user_watchlist / feed_dependent 边界。
• 长期观察一个意图而不只是固定 RSS 源时用 guanlan watch plan/add/fire。watch 是 Guanlan-native standing intent 雷达，不启动后台、不发通知、不要求 Qdrant/Docker；watch fire 默认是诊断调用，不写 seen，只有 --record-seen 才更新本地去重状态。NEW 线索仍需 read --quality-report 或 research/archive ingest-research 补证。
• 品牌、公关、市场、舆情团队要日报/晨报/每日简报时，优先用 guanlan daily "主题" --time-window 3d --format markdown --read-top 3。日报主线来自 storylines，会区分 A 一手/官方、B 媒体/产业/开发者、C 社区/用户样本、D 弱线索/SEO；不要把官网信息写成全网情况，不要把社区样本外推成总体口碑。editorial_health.status=block 时只能当线索池。交付到 IM 用 --format im，静态页用 --format html，连续日报显式加 --record-history --compare-days N。
• 公众号文章链接先跑普通 guanlan read "https://mp.weixin.qq.com/s/..." --trace。selected_backend=wechat_article 说明已成功走公开文章专项正文提取；不要再要求用户授权浏览器或 Cookie。这个路径只读公开文章 HTML，不读取 Cookie、credentials、IndexedDB 或公众号后台。只有专项提取、Jina 和 direct HTML 都弱/被挡时，才转 diagnose page 或浏览器可见页补证。用户已经自配公众号导出服务时，才使用 guanlan wechat-exporter status --probe / account-search / articles / download；auth key 只能从当前 shell 环境读取，不写入提示词、日志或文档。
• 金山办公/WPS/WPS AI/WPS 365/AI Office/PPT/办公 Agent/文档协作/SaaS/信创/办公安全等选题任务先用 search --scope wps_office --trace，再补 feeds curated --category ai、feeds ai-official、feeds ai-media；深查时才用受控 research --preset wps_office --read-top 0-2 --max-search-jobs 2。它不是品牌白名单搜索，应主动外扩到竞品、科技/AI 媒体、RSS/公众号/热榜、开发者/用户样本和安全/信创线索。
• 文娱/影视/综艺/明星/游戏/票房/评分/口碑类问题优先用 route 或 research --preset entertainment；把平台热度、用户评分、产业报道、宣发通稿和粉圈讨论分层看。
• 欧美娱乐、Hollywood、Taylor Swift、Billboard、Grammy、巡演、新歌专辑等问题优先用 research --preset global_entertainment --profile english；英文行业媒体、榜单/奖项和艺人/厂牌一手信息优先于粉丝账号和八卦站。
• 日韩娱乐、K-pop/J-pop、韩剧日剧、Soompi、Oricon、Naver 等问题优先用 research --preset jp_kr_entertainment --profile hybrid；区分本地媒体/榜单、经纪公司口径、英文翻译站和粉丝讨论。
• 财经、股票、行情、ETF/基金净值、公告、财报、基金公告、监管、宏观金融、雪球/股吧情绪和研报问题先跑 guanlan stock plan "问题"（如果不确定该怎么查），再用 guanlan stock ... / guanlan-stock ... 获取结构化行情、净值、榜单、资金流向和大盘概览，再用 search --scope finance_quote|finance_disclosure|finance_macro|finance_sentiment|finance_research 扩展证据；只有深查/证据包时才用受控 research --preset finance --read-top 0-2 --max-search-jobs 2。把行情/净值、公告披露、监管/宏观、新闻、研报观点和投资者情绪分层看，不输出买卖建议。
• CVE/漏洞/补丁/反诈/诈骗短信用 research --preset cybersecurity 或 search --scope cybersecurity --trace；优先 CVE/NVD/CISA/厂商公告/监管来源。
• 台风/天气/地震/灾害预警用 search --scope weather_disaster --trace；优先官方气象和应急来源，并检查时间戳。
• 体育、科学新闻、招聘薪资面经、播客、考试备考分别用 sports、science、career、podcast、test_prep preset/scope，不要停在泛搜索。
• 如果新用户问“装好了怎么用/怎么让 Agent 用观澜”，先运行 guanlan welcome。
• 如果用户或 Agent 不知道观澜有哪些功能、该用哪个命令，先运行 guanlan capabilities；MCP 模式下调用 guanlan_capabilities。
• --advisor 输出的是证据边界和写作规则，Agent 需要据此生成自然建议，不要机械复述固定小标题。
• research 证据包会附带证据审计提示；遇到版本号、价格、参数量、发布日期冲突时，先说明不同来源分别怎么说，再给取舍依据。
• 知识星球属于授权私域社区；只有用户明确要查自己已加入/创建的星球内容时，才引导安装/登录 zsxq-cli。默认只做浏览、搜索和资料整理，发帖、评论、回答、编辑、删除、打标签和笔记写入必须逐次确认。
• report html 是旁支展示层，只把已有 JSON/stdin/demo 数据渲染成静态 HTML；不要用它替代 search/read/research/hotnews 主链路。
• archive wiki/context/pack 是本地 archive 的旁支组织层：只使用已归档资料，不代表全网知识，不自动上传。
• 更新观澜时必须全量更新，不要只跑增量 upgrade：优先 uv tool install --force --upgrade --refresh --default-index https://pypi.org/simple guanlan，注意 uv 只有 --force 可能重装旧锁定版本；Homebrew 用 brew update && brew reinstall shenyangs/tap/guanlan；pipx 用 pipx install --force guanlan。更新后运行 hash -r、command -v guanlan、which -a guanlan、guanlan version，再跑 guanlan capabilities、guanlan doctor --install-check、guanlan doctor --trace、guanlan search "人工智能 政策" --profile china --limit 5 --trace、guanlan hotnews today --limit 5 --trends。若 Agent 报 PyPI 低于 GitHub，必须用 PyPI JSON 与 pip index 安装源复核，不要用搜索结果或缓存文本判断最新版。版本或路径不一致时停止配置 MCP。

路由表

零配置快速命令

# Exa 网页搜索
mcporter call 'exa.web_search_exa(query: "query", numResults: 50)'
 
# 观澜统一网页搜索（默认公开搜索，不需要 Cookie）
guanlan welcome
guanlan capabilities
guanlan search "query" --limit 80
guanlan search "EI会议 投稿 检索" --profile china --scope academic
guanlan search "清华大学计算机系研究生招生 导师" --profile china --scope university
guanlan search "电影 票房 评分" --profile china --scope entertainment
guanlan search "WPS AI PPT Agent 办公选题 最近热点" --profile china --scope wps_office --limit 80 --trace
guanlan search "贵州茅台 公告 财报" --profile china --scope finance_disclosure --limit 80 --trace
guanlan search "上证指数 今日 行情" --profile china --scope finance_quote --limit 80 --trace
guanlan search "社融 CPI 降息 央行" --profile china --scope finance_macro --limit 80 --trace
guanlan stock plan "宁德时代 股价 财报 公告 最近风险"
guanlan stock quote "贵州茅台"
guanlan stock quote "024051"
guanlan stock detail "600519"
guanlan stock fundflow "宁德时代"
guanlan-stock rank --sort turnover --limit 20
guanlan-stock index
guanlan search "Taylor Swift latest" --profile english --scope global_entertainment
guanlan search "BLACKPINK K-pop comeback" --profile hybrid --scope jp_kr_entertainment
guanlan search "OpenSSL CVE 最新 漏洞 影响版本" --scope cybersecurity --limit 80 --trace
guanlan search "台风 路径 中央气象台 日本气象厅" --scope weather_disaster --limit 80 --trace
guanlan search "梅西 比赛 伤病 最新" --scope sports --limit 80
guanlan research "NBA季后赛2026年首轮战绩比分" --preset sports --read-top 2 --max-search-jobs 2
guanlan search "AI 创业 播客 小宇宙" --scope podcast --limit 80
guanlan install --env=auto --channels=zsxq
zsxq-cli auth login
zsxq-cli group +list
zsxq-cli topic +search --group-id <id> --query "关键词"
guanlan search "最近 query 热点" --profile china --trace
guanlan search "中文问题" --profile china --limit 80 --trace  # 查看 Baidu/Bing/DDG 状态与 backend_recovery
guanlan diagnose page "https://example.com/article"
guanlan browser-assist plan "https://example.com/article" --json
guanlan browser-assist adapters --check
guanlan browser-assist setup-openguanlan --json
guanlan browser-assist setup-opencli --json
guanlan browser-assist sessions "https://example.com/article" --json
guanlan browser-assist run "https://example.com/article" --adapter openguanlan --json
guanlan recipe list
guanlan recipe run finance-risk "宁德时代 股价 财报 公告 最近风险"
guanlan recipe run wps-office-radar "WPS AI PPT Agent 办公选题 最近热点"
guanlan recipe run public-opinion-pulse "某产品 最近风评 被夸还是被骂"
guanlan recipe run competitor-watch "某产品 竞品 功能 定价 口碑"
guanlan recipe run app-review-pulse "某 App 应用商店评论 差评主题"
guanlan recipe run trajectory-map "Cursor 发展历程 竞品格局"
guanlan yinshen "AI写代码" --limit 80 --angles 6 --format context
guanlan search "query" --site zhihu.com --limit 80
guanlan search "query" --site gov.cn --limit 80 --trace  # 硬过滤，空结果不放宽到域外
guanlan search "query" --trace
guanlan search "query" --cache-ttl 3600
guanlan search "query" --format context
guanlan search "query" --format prompt
guanlan search "query" --source-chart
guanlan route "query"
guanlan workflow "query" --json
guanlan investigate "query" --limit 80 --format context
guanlan investigate "query" --budget deep --dry-run
guanlan sources explain "query"
guanlan eval suite run chinese-web-v1
guanlan sources audit
guanlan quality performance
guanlan research "query" --profile china --read-top 0 --max-search-jobs 2 --advisor
guanlan research "query" --profile china --format prompt
guanlan research "EI会议 投稿 检索 要求" --preset academic --read-top 0
guanlan research "清华大学计算机系研究生招生 导师" --preset university --read-top 0
guanlan research "电影/综艺/游戏/明星 票房口碑" --preset entertainment --read-top 0
guanlan search "WPS AI PPT Agent 办公选题 最近热点" --scope wps_office --limit 80 --trace
guanlan search "宁德时代 股价 财报 公告 最近风险" --scope finance_disclosure --limit 80 --trace
guanlan research "Taylor Swift 最新动态 新专辑 巡演" --preset global_entertainment --profile english
guanlan research "BLACKPINK K-pop 最新回归" --preset jp_kr_entertainment --profile hybrid
guanlan search "OpenSSL CVE 最新 漏洞 影响版本" --scope cybersecurity --limit 80 --trace
guanlan research "字节 AI 产品经理 校招 薪资 面经" --preset career --read-top 2 --max-search-jobs 2
guanlan research "雅思 口语 题库 机经" --preset test_prep --read-top 4
guanlan prompt "query" --profile china --style evidence
guanlan context "query" --profile china --style evidence
guanlan research "product 用户评价" --preset reputation --read-top 0 --advisor
guanlan compare "A" "B" --focus "价格 口碑 风险" --limit 80 --format context
guanlan timeline "某事件 最新进展" --limit 80 --format context
guanlan timeline "某事件 2024-2025" --limit 80 --format context
guanlan dossier "某对象" --focus "业务 口碑 风险" --limit 80 --format context
guanlan yinshen "关键词" --limit 80 --angles 5 --angle-read-top 1
guanlan pulse "query" --format context
 
# 通用网页阅读
guanlan read "URL" --max-chars 12000
guanlan read "URL" --strict --trace
guanlan read "URL" --backend direct --extract metadata
guanlan read batch urls.txt --format context
guanlan read batch urls.txt --concurrency 4 --format context
guanlan read "URL" --watch
guanlan feeds curated --limit 80
guanlan feeds curated --category ai --min-score 85 --limit 80
guanlan feeds arxiv --keyword "AI Agent" --limit 80
guanlan feeds watchlist --watchlist ~/.guanlan/feeds-watchlist.json --limit 80
guanlan watch plan "OpenAI API release notes" --profile english
guanlan watch add "WPS AI PPT Agent 办公选题" --feed-source curated --schedule "daily 09:00"
guanlan watch fire <id> --limit 30
guanlan watch fire <id> --record-seen --limit 30
guanlan daily "WPS AI" --time-window 3d --format markdown --read-top 3
guanlan daily "WPS AI" --format im
guanlan daily "WPS AI" --format html --output daily.html
guanlan daily "WPS AI" --record-history --compare-days 7
guanlan feeds baidu-rss --limit 80
guanlan feeds wechat-rss --limit 80
guanlan feeds curated-sources --keyword AI --limit 80
guanlan feeds list
 
# 本地知识库
guanlan archive add "URL"
guanlan archive add-browser-note --from-json browser-notes.jsonl
guanlan archive ingest-research "query" --limit 80
guanlan archive ingest-research "query" --limit 80 --read-top 3
guanlan archive ingest-research "query" --limit 80 --dry-run
guanlan archive search "query" --format context --trace
guanlan archive embed --backend local
guanlan archive search "query" --semantic --format context --trace
guanlan archive inspect 1
guanlan archive reindex
guanlan archive verify
guanlan archive context "query" --limit 20
guanlan archive wiki build --output ./guanlan-wiki
guanlan archive wiki build --output ./guanlan-llm-wiki --format llm-wiki
guanlan archive wiki context "query"
guanlan archive pack "query" --format langchain-jsonl --output guanlan-pack.jsonl
guanlan archive pack "query" --format llm-wiki --output ./topic-wiki
guanlan archive export --format rag-jsonl
guanlan mcp config --client codex
guanlan serve --host 127.0.0.1 --port 8765
guanlan plugin template my_company_api
guanlan quality robustness
guanlan quality live-smoke --record-history --trend-window 10
guanlan eval benchmark
guanlan eval scenarios --format jsonl
guanlan report html --input results.json --output report.html
 
# GitHub 搜索
gh search repos "query" --sort stars --limit 50
 
# 中文热榜（原生公开源，不需要 Cookie）
guanlan hotnews today --limit 80
guanlan hotnews today --limit 80 --trends
guanlan hotnews weibo --limit 80
guanlan hotnews bilibili --limit 80
guanlan hotnews ithome --limit 80
guanlan hotnews ebrun:cross-border --limit 10
guanlan hotnews ebrun:retail --limit 10
guanlan hotnews ebrun:ai --limit 10
guanlan hotnews tophub:weibo --limit 80
guanlan hotnews tophub:catalog:news --limit 80
guanlan hotnews hotboard:catalog:finance --limit 30
guanlan hotnews hotboard:snapshots:weibo --limit 20
guanlan hotnews uapis:catalog --limit 80
guanlan hotnews vvhan:all --limit 80
guanlan hotnews zhihu --json  # experimental，失败时改用 site:zhihu.com 搜索
guanlan hotnews list
 
# 助理视角：用户要建议、影响、下一步、或“可能为什么搜这个”时使用
guanlan research "query" --profile china --advisor
 
# Twitter 搜索
twitter search "query" --limit 50
 
# YouTube/B站字幕
yt-dlp --write-sub --skip-download -o "/tmp/%(id)s" "URL"
 
# Reddit 搜索
rdt search "query" --limit 50
 
# Reddit 读帖 + 评论
rdt read POST_ID
 
# V2EX 热门
curl -s "https://www.v2ex.com/api/topics/hot.json" -H "User-Agent: guanlan/1.0"

Archive 入库时如果看到 skipped 或 ingest_audit，优先把它理解为质量保护：观澜在写入本地知识库前检查了相关性、平台首页、重复候选、正文厚度和漂移风险。

环境检查

# 检查可用 channel
guanlan doctor
 
# 查看诊断路径，确认是否跳过认证/Cookie/登录态探测
guanlan doctor --trace
 
# 扫描本地配置中的明文 Cookie、Token、Key 或代理凭据
guanlan doctor --check-config
 
# 配置展示和扫描只输出路径、风险类型或打码值；不要把 Cookie/session/csrf/auth/ct0 等原值写入提示词、日志或文档
 
# 查看 channel 稳定性、授权边界、批量边界和缓存概览
guanlan status
 
# 查看所有 MCP 服务
mcporter_list_servers()

工作区规则

不要在 agent workspace 创建文件。 使用 /tmp/ 存放临时输出，~/.guanlan/ 存放持久数据。

详细文档

根据用户需求，阅读对应的详细文档：

• 搜索工具 — Exa AI 搜索
• 社交媒体 — 小红书, 抖音, Twitter, B站, V2EX, Reddit
• 职场招聘 — LinkedIn
• 开发工具 — GitHub CLI
• 网页阅读 — Jina Reader, 微信公众号, RSS
• 视频播客 — YouTube, B站, 小宇宙

配置渠道

如果某个 channel 需要配置，获取安装指南： docs/install.md

用户只需提供 cookies，其他配置由 agent 完成。