[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-80745":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":16,"stars7d":17,"stars30d":13,"stars90d":15,"forks30d":15,"starsTrendScore":18,"compositeScore":19,"rankGlobal":10,"rankLanguage":10,"license":20,"archived":21,"fork":21,"defaultBranch":22,"hasWiki":23,"hasPages":21,"topics":24,"createdAt":10,"pushedAt":10,"updatedAt":35,"readmeContent":36,"aiSummary":37,"trendingCount":15,"starSnapshotCount":15,"syncStatus":17,"lastSyncTime":38,"discoverSource":39},80745,"Guanlan","shenyangs\u002FGuanlan","shenyangs","观澜 \u002F Guanlan：AI Agent 的中文互联网研究、阅读与信源路由工具。","https:\u002F\u002FGuanlan.xin",null,"Python",45,4,41,0,1,2,3,2.1,"MIT License",false,"main",true,[25,26,27,28,29,30,31,32,33,34],"ai-agent","chinese-web","cli","llm-tools","mcp","python","research-tool","search","source-routing","web-reader","2026-06-12 02:04:06","\u003Ch1 align=\"center\">观澜 \u002F Guanlan\u003C\u002Fh1>\n\n\u003Cp align=\"center\">\n  \u003Cstrong>让 AI Agent 看懂中文互联网\u003C\u002Fstrong>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  临流观势，循源取义。观澜是面向 AI Agent 的中文互联网研究工具：会路由信源、阅读网页、观察热榜、整理证据。\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-1677ff?style=for-the-badge\" alt=\"MIT License\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fpython-3.10%2B-3776AB?style=for-the-badge&logo=python&logoColor=white\" alt=\"Python 3.10+\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fcontext-chinese--web-84cc16?style=for-the-badge\" alt=\"Chinese web context\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fmode-cli--first-06b6d4?style=for-the-badge\" alt=\"CLI-first mode\">\n  \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fstage-alpha-555555?style=for-the-badge\" alt=\"Alpha stage\">\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"#30-秒-tldr\">30 秒 TL;DR\u003C\u002Fa> ·\n  \u003Ca href=\"#安装\">安装\u003C\u002Fa> ·\n  \u003Ca href=\"#安全边界\">安全边界\u003C\u002Fa> ·\n  \u003Ca href=\"#文档入口\">文档\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  语言：\u003Cstrong>中文\u003C\u002Fstrong> ·\n  \u003Ca href=\"docs\u002FREADME_en.md\">English\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002FREADME_ja.md\">日本語\u003C\u002Fa> ·\n  \u003Ca href=\"docs\u002FREADME_ko.md\">한국어\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"docs\u002Fassets\u002Fguanlan-overview.png\" alt=\"观澜 Guanlan 面向 AI Agent 的中文互联网研究底座流程图\">\n\u003C\u002Fp>\n\n## 30 秒 TL;DR\n\n普通搜索让 Agent 看见网页，观澜让 Agent 看懂中文互联网。\n\n观澜不是“又一个搜索 CLI”，而是给 AI Agent 用的中文互联网研究底座：它会先判断该去哪里找，再把网页、热榜、RSS、官方源、垂类媒体和社区样本整理成可追溯的证据上下文。\n\n如果你只想先用起来：\n\n```bash\nuv tool install --force --upgrade --refresh --default-index https:\u002F\u002Fpypi.org\u002Fsimple guanlan\nguanlan version\nguanlan agent \"人工智能 政策 最新\" --json\nguanlan search \"人工智能 政策 最新\" --profile china --limit 80\n```\n\n## 最稳能力\n\n1. **中文网页搜索**：公开网页搜索、去重、排序、来源标注，默认给 Agent 足够大的候选池。\n2. **信源路由**：政策看官方和党央媒，口碑看社区样本，技术看开发者与 RSS，产业看垂类媒体。\n3. **网页阅读**：把网页转成 Markdown；公众号文章优先走公开专项抽取，并提供正文质量、噪声、fallback 和 trace。\n4. **热榜观察**：用 `hotnews` 和 `feeds` 帮 Agent 观察“今天中文互联网在涌动什么”。\n5. **股票财经结构化入口**：`guanlan stock` \u002F `guanlan_stock` 先拿股票行情、指数、ETF\u002F基金净值、资金流、榜单和时效边界，再回到公告、宏观、研报和情绪样本分层核验。\n6. **证据包输出**：`research`、`compare`、`timeline`、`dossier`、`recipe`、`archive`、`--format context` 面向 Agent 继续推理。\n7. **长期意图雷达**：`watch` 把一次性 query 固化为本地 standing intent，按需 fire，复用搜索、RSS、归档和去重状态发现新线索。\n\n## 典型命令\n\n```bash\n# 1. 搜中文网页，默认建议给 Agent 足够候选池\nguanlan agent \"WPS AI 灵犀 最近热点\" --mode fresh --json\nguanlan search \"新质生产力 政策 原文\" --profile china --limit 80 --trace\n\n# scope 默认是软收敛：优先看这类信源，质量不足时自动混入开放网页\nguanlan search \"AI Agent 发展趋势 2025\" --profile china --scope tech_dev --limit 80 --trace\n\n# 为 WPS\u002FAI Office 赛道找选题线索，品牌、竞品、技术、信创、安全和热点一起看\nguanlan research \"WPS AI PPT Agent 办公选题 最近热点\" --preset wps_office --limit 80 --read-top 5 --advisor\n\n# 股票\u002F指数\u002FETF\u002F基金净值\u002F资金流先走结构化入口，不要让 Agent 硬读动态财经页\nguanlan stock plan \"宁德时代 股价 财报 公告 最近风险\"\nguanlan stock quote \"024051\"\nguanlan stock detail \"宁德时代\"\n\n# 2. 读取网页正文，检查是否干净\nguanlan read \"https:\u002F\u002Fexample.com\u002Farticle\" --quality-report --trace\nguanlan read \"https:\u002F\u002Fmp.weixin.qq.com\u002Fs\u002FARTICLE_ID\" --trace --max-chars 12000\n\n# 用户自配公众号导出服务后，才使用授权 exporter 适配器\nguanlan wechat-exporter status --probe\nguanlan wechat-exporter account-search \"公众号名称\" --json\n\n# 3. 做一份 Agent 可直接使用的研究证据包\nguanlan research \"某产品 用户评价 值不值得买\" --preset reputation --advisor --format context\nguanlan recipe run public-opinion-pulse \"某产品 最近风评 被夸还是被骂\"\nguanlan recipe run competitor-watch \"某产品 竞品 功能 定价 口碑\"\n\n# 4. 看今日中文互联网水势\nguanlan hotnews today --limit 80 --trends\n\n# 5. 把一个主题变成长期观察意图，先诊断 fire，再按需记录 seen\nguanlan watch plan \"OpenAI API release notes\" --profile english\nguanlan watch add \"WPS AI PPT Agent 办公选题\" --feed-source curated --schedule \"daily 09:00\"\nguanlan watch fire \u003Cid> --record-seen --limit 30\n\n# 6. 不确定去哪搜时，先看信源路由\nguanlan route \"AI 产业政策 地方 补贴\" --json\n\n# 7. 想系统搞懂一个对象时，先生成对象脉络\u002F同类格局研究链路\nguanlan recipe run trajectory-map \"Cursor 发展历程 竞品格局\"\n```\n\n更多命令见 [完整使用手册](docs\u002Ffull-guide.md) 和 [Agent 使用指南](docs\u002Fagent-usage.md)。\n\n## 安装\n\n推荐任选一种方式。安装或升级后，先确认版本和路径，避免 Agent 调到旧版。\n\n### Homebrew\n\n```bash\nbrew update\nbrew tap shenyangs\u002Ftap\nbrew reinstall shenyangs\u002Ftap\u002Fguanlan\n```\n\n### uv\n\n```bash\nuv tool install --force --upgrade --refresh --default-index https:\u002F\u002Fpypi.org\u002Fsimple guanlan\n```\n\n### pipx\n\n```bash\npipx install --force guanlan\n```\n\n### 验证\n\n```bash\nguanlan version\nguanlan doctor --install-check\nguanlan status\n```\n\n看到 `观澜 \u002F Guanlan v0.6.13`，并且安装检查没有版本\u002F路径漂移，就说明基础部署成功。\n\n## 给 Agent 复制的安装指令\n\n```text\n请帮我安装观澜 CLI，并验证基础功能可用。\n\n优先使用：\nuv tool install --force --upgrade --refresh --default-index https:\u002F\u002Fpypi.org\u002Fsimple guanlan\n\n安装完成后运行：\nguanlan version\nguanlan doctor --install-check\nguanlan status\n\n如果 guanlan version 不是 README 标注的当前版本，请不要继续配置 MCP 或可选渠道，先排查 PATH 和安装来源。\n\n安全要求：不要读取浏览器 Cookie，不要触发登录授权，不要请求钥匙串权限。\n```\n\n## 安全边界\n\n观澜默认只读、低扰、明源。\n\n- 默认不读取浏览器 Cookie、钥匙串、登录态或私密配置。\n- 浏览器辅助补证只读取用户授权后的目标页可见内容；Cookie 读取必须另行说明平台、用途、风险和只读范围，并获得单独明确授权。动态页补证使用会话契约、内容就绪信号和采集充分性，不把固定等待或空结果当作成功。\n- 不自动点赞、评论、关注、发帖或发送消息。\n- 高风险平台能力保持 `best-effort` \u002F `opt-in` \u002F `experimental` 口径，不包装成稳定端到端能力。\n- `doctor` 默认不做深度授权探测；需要认证检查必须显式运行相关命令。\n- Archive、Wiki、LLM Wiki、RAG 导出都基于本地已归档资料，不代表全网事实。\n- 真实网络超时应被视为网络\u002F上游证据，不应直接解释为“没有结果”。\n\n## 文档入口\n\n| 你想做什么 | 去哪里看 |\n| --- | --- |\n| 完整命令和长说明 | [完整使用手册](docs\u002Ffull-guide.md) |\n| Agent 怎么正确调用观澜 | [Agent 使用指南](docs\u002Fagent-usage.md) |\n| 安装、升级和路径排查 | [安装指南](docs\u002Finstall.md) \u002F [更新指南](docs\u002Fupdate.md) \u002F [故障排查](docs\u002Ftroubleshooting.md) |\n| 本地模型联网 | [Local LLM 指南](docs\u002Flocal-llm.md) |\n| 精选信源包 | [Source Packs](docs\u002Fsource-packs.md) |\n| 热点目录接入 | [热点目录接入](docs\u002Fhotboard-api.md) |\n| 输出字段稳定契约 | [Contract](docs\u002Fcontract.md) |\n| 中文互联网设计依据 | [China-Aware Web Rationale](docs\u002Fchinese-web-design.md) |\n| 发版和质量闸门 | [Release Automation](docs\u002Frelease-automation.md) \u002F [Quality Test Plan](docs\u002Fquality-test-plan.md) |\n| 路线图 | [Roadmap](docs\u002Froadmap.md) |\n\n## 项目定位\n\n观澜当前仍是 Alpha 阶段的 CLI-first 工具。最稳路径是公开搜索、网页阅读、热榜观察、研究证据包和本地归档；部分平台能力依赖公开页面、外部后端、网络环境或显式授权。\n\n> 临流观势，循源取义。观澜让 Agent 在进入中文互联网之前，先学会“观”。\n\n## License\n\nMIT License. See [LICENSE](LICENSE) for details.\n","观澜 \u002F Guanlan 是一个面向 AI Agent 的中文互联网研究工具，旨在帮助 AI 更好地理解和处理中文网络内容。其核心功能包括中文网页搜索、信源路由、网页阅读转换为Markdown格式、热榜观察及股票财经信息的结构化提取等，支持通过命令行界面操作。该工具特别适合需要对中文互联网进行深入研究和分析的应用场景，如政策追踪、市场调研和技术趋势分析等。基于Python开发，遵循MIT许可协议，适用于Python 3.10及以上版本。","2026-06-11 04:01:53","CREATED_QUERY"]