Give your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
Python agent-infrastructureai-agentai-searchautomationbilibiliclaude-codeclicursorfree-apillm-toolsmcppythonreddit-scrapertwitter-scraperweb-scraperxiaohongshuyoutube-transcript
refactor: shorten installation receipt to key public capabilities
LohseZSaid603ba10cd11
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex f114d39a..d32f11f4 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -7,6 +7,20 @@ All notable changes to this project will be documented in this file.---+## 1.6.3 — 2026-10-19(本地候选版)++中文:+- 安装输出精简为一张短表,保留默认安装结果、免登录可获取内容及按需登录提示。++English:+- Installation now shows one compact table with default installs, public content and optional sign-in.++Technical changes:+- Replace the two detailed matrices with a short, generated receipt; retain full structured capabilities and reference documentation.+- Preserve installation failures, user removals and live-verification scope in the compact view.+++## 1.6.2 — 2026-10-19(本地候选版)中文:diff --git a/agent_reach/__init__.py b/agent_reach/__init__.pyindex 5f1335f6..6073d44f 100644--- a/agent_reach/__init__.py+++ b/agent_reach/__init__.py@@ -1,6 +1,6 @@# -*- coding: utf-8 -*-"""Agent Reach — internet access for AI agents."""-__version__ = "1.6.2"+__version__ = "1.6.3"__all__ = ["__version__"]diff --git a/agent_reach/runtime/onboarding.py b/agent_reach/runtime/onboarding.pyindex 28ae4a0c..ca6bd1d1 100644--- a/agent_reach/runtime/onboarding.py+++ b/agent_reach/runtime/onboarding.py@@ -43,16 +43,21 @@ _CAPABILITY_LIMITS = {}-# Capability depth is separate from installation and live-check status.-# Standalone native/API evidence must not masquerade as a declared Reach action.-_ANONYMOUS_DEPTH = {- 'github': ('✅ 仓库搜索', '✅ README、Issue/PR 正文', '✅ 公开 Issue/PR 评论', '—'),- 'youtube': ('✅ 视频搜索', '✅ 简介;不等同视频内容',- '⚠️ 原生工具样本可读;❌ Reach 无独立评论动作', '✅ 已有字幕;⚙️ 音频转录需服务 Key'),- 'bilibili': ('✅ 视频搜索、热门', '✅ 简介、元信息;不等同视频内容',- '⚠️ 公开接口样本可读;❌ Reach 无独立评论动作', '🔐 Reach 字幕路径按需登录;须有字幕'),- 'v2ex': ('✅ 热门、节点列表', '✅ 主题正文', '⚠️ 返回的回复;完整性需核对', '—'),- 'web': ('✅ 网页搜索', '⚠️ 可公开读取的正文', '⚠️ 仅页面已返回的评论', '❌ 无独立字幕动作'),+# Short user-facing receipt; detailed actions and limits stay in capability_summary.+_QUICK_ACCESS = {+ 'github': '✅ 仓库、README、Issue/PR 和公开评论',+ 'youtube': '✅ 视频搜索、简介、已有字幕;转录需配置 Key',+ 'bilibili': '✅ 视频搜索、简介;🔐 部分字幕路径',+ 'v2ex': '✅ 主题正文、部分回复',+ 'web': '✅ 网页搜索、公开正文',+ 'reddit': '✅ 公开帖子、部分评论;🔐 站内搜索/列表',+ 'twitter': '⚠️ 索引、部分单帖;🔐 站内搜索/推文串',+ 'xiaohongshu': '⚠️ 部分公开列表;🔐 笔记正文、评论',+ 'instagram': '⚠️ 部分主页/索引;🔐 用户搜索、帖子描述',+ 'facebook': '⚠️ 公开摘要;🔐 站内搜索、主页',+ 'linkedin': '⚠️ 职位索引;🔐 职位搜索、JD',+ 'boss': '⚠️ 职位索引;🔐 职位搜索、JD',+ 'xueqiu': '✅ 公开行情;🔐 社区热门内容',}_DISPLAY_NAMES = {@@ -62,13 +67,6 @@ _DISPLAY_NAMES = {'boss': 'BOSS直聘', 'xueqiu': '雪球',}-_ACTION_NAMES = {- 'search': '搜索', 'read': '详情读取', 'subreddit': '板块帖子列表',- 'profile': '个人主页', 'tweets': '用户推文', 'thread': '推文串',- 'posts': '指定用户帖子', 'comments': '评论读取', 'jobs': '职位搜索',- 'hot_posts': '热门帖子', 'hot_stocks': '热门股票',-}-_STATUS_LABELS = {'not_added': '未接入,可按需添加', 'needs_setup': '待配置', 'unverified': '已接入,待实测','ready': '已有有效验收', 'search_ready': '仅搜索已有验收',@@ -78,67 +76,44 @@ _STATUS_LABELS = {def installation_report(result):- """Render the complete install receipt, without discovery or network access."""+ """Render one short receipt; keep detailed evidence in the structured summary."""def cell(value):return str(value).replace('|', r'\|').replace('\n', ' ')entries = result['capability_summary']['channels']installs = {row['channel']: row for row in result['default_channels']}installed = sum(bool(row['ok']) for row in installs.values())+ names = '、'.join(_DISPLAY_NAMES.get(name, name) for name, row in installs.items() if row['ok'])lines = [- f"# Agent Reach {result['version']} · 安装与能力清单", '',- f'默认渠道依赖:{installed}/{len(installs)} 项准备成功。安装结果与联网验收分别列出。', '',- '✅ 提供免登录路径;⚠️ 部分内容或受访问条件影响;🔐 该路径按需登录;'- '⚙️ 需要额外配置;❌ 本版未提供相应动作;— 不适用。',- '表中勾叉表示能力范围,不表示本机已经联网测通;公开路径可能使用 Agent 自带工具、原生工具或公开接口。', '',- '## 默认渠道:安装结果与免登录粒度', '',- '| 渠道 | 本次安装 | 搜索/列表 | 正文/详情 | 评论/回复 | 字幕/转录 |',- '|---|---|---|---|---|---|',+ f"Agent Reach {result['version']} 已初始化。", '',+ f'默认依赖:{installed}/{len(installs)} 项准备成功' + (f'({names})。' if names else '。'), '',+ '✅ 公开可用;⚠️ 公开范围有限;🔐 按需登录/配置。内容和网络条件以实际访问为准。', '',+ '| 渠道 | 安装后能获取什么 |', '|---|---|',]- for entry in entries:- if entry['level'] != 'default':- continue+ for entry in sorted(entries, key=lambda item: item['level'] != 'default'):name = entry['channel']+ label = _DISPLAY_NAMES.get(name, name)item = installs.get(name)- status = ('已安装' if item['ok'] else- '安装失败:' + item.get('error', {}).get('code', 'UNKNOWN')) if item else '保留用户移除'- depth = _ANONYMOUS_DEPTH.get(name, ('⚠️ 以声明动作与实际返回为准',) * 4)- lines.append('| ' + ' | '.join(map(cell, (_DISPLAY_NAMES.get(name, name), status, *depth))) + ' |')- lines += [- '', '## 按需渠道:公开可读与登录后的增量', '',- '| 渠道 | 当前接入 | 免登录先尝试 | 按需登录/配置后可启用 | 当前边界 |',- '|---|---|---|---|---|',- ]- for entry in entries:if entry['level'] == 'default':- continue- name = entry['channel']- actions = entry['authentication']['may_enable_actions']- labels = [_ACTION_NAMES.get(action, action) for action in actions]- if name == 'instagram':- labels = ['用户搜索' if action == 'search' else label for action, label in zip(actions, labels)]- elif name == 'reddit':- labels = ['帖子及返回评论' if action == 'read' else label for action, label in zip(actions, labels)]- elif name == 'boss':- labels = ['职位搜索' if action == 'search' else label for action, label in zip(actions, labels)]- extra = ('🔐 ' + '、'.join(labels) + '(该路径要求认证时)') if actions else '⚙️ 按声明动作配置'- lines.append('| ' + ' | '.join(map(cell, (- _DISPLAY_NAMES.get(name, name), _STATUS_LABELS.get(entry['reach_status'], entry['reach_status']),- '⚠️ ' + entry['public_access'], extra, ' '.join(entry['limits']) or '仅覆盖实际返回内容',- ))) + ' |')- lines += ['', '**本机联网验收**:本次安装没有发起平台查询。已存在且仍有效的验收如下;其余待实测。']+ if item and not item['ok']:+ label += '(安装失败:' + item.get('error', {}).get('code', 'UNKNOWN') + ')'+ elif not item:+ label += '(保留用户移除)'+ elif entry['reach_status'] in {'needs_setup', 'needs_login', 'cooldown', 'needs_user_action', 'broken'}:+ label += '(' + _STATUS_LABELS[entry['reach_status']] + ')'+ lines.append('| ' + cell(label) + ' | ' + cell(_QUICK_ACCESS.get(name, entry['public_access'])) + ' |')verified = [entry for entry in entries if entry['verified_actions']]- lines += ['- ' + _DISPLAY_NAMES.get(entry['channel'], entry['channel']) + ':' +- ' / '.join(entry['verified_actions']) for entry in verified] if verified else ['- 暂无有效动作验收记录。']- lines += [- '', '**Reddit 怎么用**:⚠️ 先尝试公开搜索、正文和部分评论,公开 JSON 样本可能含父子 ID;'- '🔐 需要时启用站内搜索、板块列表及帖子/返回评论读取;'- '❌ 不提供发评论;⚠️ 完整评论树与全部回复不作保证,登录后仍需实际验证。', '',- '直接告诉我你想查什么即可。已有公开结果够用就交付;缺少某项内容时再准备渠道、复用授权会话,实际需要时才请你登录。',- ]+ if verified:+ names = ';'.join(_DISPLAY_NAMES.get(entry['channel'], entry['channel']) + ':' ++ '/'.join(entry['verified_actions']) for entry in verified)+ lines += ['', '有效验收:' + names + '。其余待实测;本次初始化未发起平台查询。']+ else:+ lines += ['', '联网验收:待实测;本次初始化未发起平台查询。']+ lines += ['公开内容优先用 Agent 已有能力;评论仅含实际返回样本。需要时再配置渠道,不要求逐个平台登录。']return '\n'.join(lines) + '\n'+def capability_summary(channels, statuses):"""Describe public options, declared actions and local evidence without any I/O.diff --git a/agent_reach/skill/SKILL.md b/agent_reach/skill/SKILL.mdindex a1de5821..3f85df52 100644--- a/agent_reach/skill/SKILL.md+++ b/agent_reach/skill/SKILL.md@@ -18,15 +18,13 @@ metadata:一个命令接所有平台:`agent-reach`。只读,默认输出 JSON;`setup --text` 直接显示安装能力表。-## 安装完成必须展示能力表+## 安装完成展示精简能力表-安装或重新初始化后,最终回复必须展示程序生成的两张表:**默认渠道的安装结果与免登录粒度**、**按需渠道的公开能力与登录后增量**,并带上勾叉图例和本机联网验收说明。不得仅回复“5 个默认渠道依赖就绪”“待联网实测”,也不得把完整表格留到用户追问时。+安装或重新初始化后,最终回复直接展示 `result.installation_report.markdown`:一句默认安装结果、一张“渠道 → 安装后能获取什么”的短表、一句实测状态。不要再补两张详细矩阵、重复解释图例或逐项列后台动作;详细边界仅在用户追问时读取 [能力边界](references/capabilities.md)。-运行 `agent-reach setup`,读取 `result.installation_report.markdown`,将其中的表格及图例直接呈现在最终回复;用户直接操作终端可运行 `agent-reach setup --text`。程序也保存 `result.installation_report.path`,报告链接作为补充,不替代表格。依据实际结果报告安装失败、用户已移除的渠道与待配置状态。+运行 `agent-reach setup` 获取 JSON;用户操作终端可用 `agent-reach setup --text`。报告链接只作补充。保留安装失败、用户移除和需处理的状态。Reddit 用“免登录可获取公开帖子、部分评论;站内功能按需登录”说明,不承诺完整评论树。-✅ 是免登录能力路径,⚠️ 是部分/条件能力,🔐 是该路径按需认证,❌ 是本版未提供的动作;这些符号不代表本机已实测。正文、评论与字幕分开列出。Reddit 必须说明公开可读范围、按需认证可启用的站内动作、完整树与发评论等边界;以程序报告为准,不承诺登录后读全。--如果当前运行时没有 `installation_report`,核对所装版本和来源;不能把省略表格的初始化结果当成本版交付完成。+如果当前运行时没有 `installation_report`,核对所装版本和来源。勾叉描述能力路径,联网实测状态单列,公开内容无需先配置全部渠道。## 怎么用@@ -111,7 +109,7 @@ Cloak 查询和导入验收默认 `headless=True`。独立登录使用 `agent-re| 卸载 | 先 `agent-reach uninstall --dry-run` 给用户看,确认后 `agent-reach uninstall` || 让另一个 AI 也能用 | `agent-reach skill link <那个 AI 的 skill 目录>`;`agent-reach skill` 查看现在放在哪 |-首次安装按上方“安装完成必须展示能力表”交付;普通查询按需读取 [能力边界](references/capabilities.md),不预先安装全部可选渠道。+首次安装按上方“安装完成展示精简能力表”交付;普通查询按需读取 [能力边界](references/capabilities.md),不预先安装全部可选渠道。## 有新版本时diff --git a/agent_reach/skill/SKILL_en.md b/agent_reach/skill/SKILL_en.mdindex 6feb2236..f5f25b7d 100644--- a/agent_reach/skill/SKILL_en.md+++ b/agent_reach/skill/SKILL_en.md@@ -19,13 +19,13 @@ metadata:One command for every platform: `agent-reach`. Read-only; JSON by default, or a human-readable installation report with `setup --text`.-## Required installation handoff+## Compact installation handoff-After install or reinitialization, the final response must display both generated tables: **default installations and anonymous evidence depth**, and **optional channels, public access and authentication increments**. Include the symbol legend and local verification scope. Do not reduce this to a dependency count or postpone the tables until asked.+Present `result.installation_report.markdown` directly: one default-install outcome, one short channel-to-capability table, and one verification line. Do not append two detailed matrices, repeated legends or internal action lists. Load [Capability scope](references/capabilities.md) only when the user asks for detail.-Run `agent-reach setup` and present `result.installation_report.markdown`, including its tables, directly in the final response. For direct terminal use, `agent-reach setup --text` displays the same report. Link to `result.installation_report.path` as a supplement, not a substitute. Preserve failed installs, user-removed channels and pending configuration.+Use JSON `agent-reach setup`, or `setup --text` for direct terminal output. A report link is supplementary. Preserve failed installs, user removals and states requiring attention. Explain Reddit as public posts and some comments without login, with site-specific features enabled on demand; do not promise complete comment trees.-Checkmarks describe capability paths, not a successful live test. Separate bodies, comments and subtitles. For Reddit include public access, declared browser actions enabled when authentication is needed, and the lack of full-tree guarantees or posting. If the runtime has no `installation_report`, check the installed build/source; do not claim that an abbreviated response completes this release's handoff.+If `installation_report` is missing, check the build/source. Capability paths and local live verification remain separate, and public access does not require configuring every channel.## Usagediff --git a/docs/install.md b/docs/install.mdindex 87e4aa27..701eff29 100644--- a/docs/install.md+++ b/docs/install.md@@ -21,7 +21,7 @@ agent-reach setupagent-reach doctor --text```-`agent-reach setup --text` prints the same capability tables directly. Plain `setup` preserves the JSON contract and saves `installation-report.md` under the private Reach directory.+`agent-reach setup --text` prints the same compact capability table directly. Plain `setup` preserves the JSON contract and saves `installation-report.md` under the private Reach directory.`agent-reach` not found after install? Run `uv tool update-shell` and open a new shell.@@ -31,10 +31,10 @@ agent-reach doctor --text## 2. Report to the user-Display the generated report in the final response. The two capability tables are required:+Present the generated compact report directly in the final response:1. **Installation outcome**: version, default dependency results and AIs in `result.skill.agents`. An `ok: true` dependency install is not a live business check.-2. **Supported depth**: present `result.installation_report.markdown` with both tables, symbol legend and verification scope. This lists installation outcomes and anonymous search/body/comment/subtitle depth, then optional channels and authentication increments. The report path is supplementary; do not replace the tables with a link, a dependency count or "pending live tests".+2. **Capabilities**: present `result.installation_report.markdown` unchanged: one install outcome, one short channel/capability table, and one live-verification line. Keep failures and user removals visible. Do not append detailed matrices, extra backend/action lists or duplicate explanations. The report link supplements the table; detailed boundaries are available when asked.3. **Optional capabilities**: add only for a missing capability or explicit setup request. `login_if_required` and `logins[].when=only_if_required` are conditional, not a to-do list. Existing public content remains available if login is skipped.4. **Example, Reddit**: public search, bodies and some comments can be attempted with existing web tools. Reach browser actions add search, post reading and subreddit lists; reuse an authorized session and log in only when the selected path requires it. Full comment trees, all replies and writing comments are outside the guarantee.5. **Later management**: the user can say 'add Xiaohongshu' or 'remove V2EX'. Default channels can be removed too.diff --git a/pyproject.toml b/pyproject.tomlindex 9ff72eaf..04df0e69 100644--- a/pyproject.toml+++ b/pyproject.toml@@ -1,6 +1,6 @@[project]name = "agent-reach"-version = "1.6.2"+version = "1.6.3"description = "Internet access for AI agents: one CLI with JSON output to search and read the web, YouTube, GitHub, V2EX and more."readme = "README.md"license = {text = "MIT"}diff --git a/tests/test_manage.py b/tests/test_manage.pyindex cd5c66e8..2b0762b8 100644--- a/tests/test_manage.py+++ b/tests/test_manage.py@@ -500,14 +500,13 @@ def test_setup_adds_default_channels_and_survives_a_failing_install(env, monkeypassert '安装失败:UPSTREAM_BROKEN' in report['markdown']-def test_setup_text_displays_both_capability_tables_and_keeps_json_mode(env, capsys):+def test_setup_text_displays_compact_capability_table_and_keeps_json_mode(env, capsys):from agent_reach.runtime import cliassert cli.main(['setup', '--text']) == 0text = capsys.readouterr().out- assert '默认渠道:安装结果与免登录粒度' in text- assert '按需渠道:公开可读与登录后的增量' in text- assert '| 搜索/列表 | 正文/详情 | 评论/回复 | 字幕/转录 |' in text+ assert '| 渠道 | 安装后能获取什么 |' in text+ assert text.count('|---|---|') == 1assert '完整报告已保存:' in textassert not text.startswith('{')assert cli.main(['setup']) == 0@@ -530,7 +529,7 @@ def test_setup_receipt_never_overwrites_a_linked_foreign_file(env, tmp_path):assert foreign.read_text() == 'keep this'assert result['installation_report']['path'] is Noneassert result['installation_report']['write_error']- assert '默认渠道:安装结果与免登录粒度' in result['installation_report']['markdown']+ assert '| 渠道 | 安装后能获取什么 |' in result['installation_report']['markdown']# ── uninstall ──diff --git a/tests/test_session_onboarding.py b/tests/test_session_onboarding.pyindex 7c596681..4eaa4890 100644--- a/tests/test_session_onboarding.py+++ b/tests/test_session_onboarding.py@@ -201,15 +201,14 @@ def test_install_receipt_displays_depth_and_authentication_without_claiming_livefor ch in channels if ch.level == 'default'],})assert '5/5 项准备成功' in report- assert '| 搜索/列表 | 正文/详情 | 评论/回复 | 字幕/转录 |' in report- assert '✅ 仓库搜索' in report and '✅ 已有字幕' in report- assert '❌ Reach 无独立评论动作' in report- assert '| Reddit | 未接入,可按需添加 |' in report- assert '搜索、帖子及返回评论、板块帖子列表' in report- assert '❌ 不提供发评论' in report- assert '完整评论树与全部回复不作保证' in report- assert '本次安装没有发起平台查询' in report- assert '暂无有效动作验收记录' in report+ assert '| 渠道 | 安装后能获取什么 |' in report+ assert report.count('|---|---|') == 1+ assert '公开帖子、部分评论' in report+ assert '🔐 站内搜索/列表' in report+ assert '已有字幕' in report+ assert '本次初始化未发起平台查询' in report+ assert '联网验收:待实测' in report+ assert len(report) <= 1000for name in ('GitHub', 'YouTube', 'B站', 'V2EX', 'Web', 'Reddit', '小红书','X/Twitter', 'Facebook', 'Instagram', 'LinkedIn', 'BOSS直聘', '雪球'):assert '| ' + name + ' |' in report@@ -225,5 +224,5 @@ def test_install_receipt_preserves_failed_installs_and_user_removed_channels():'channel': 'bilibili', 'ok': False, 'error': {'code': 'TIMEOUT'}}],})assert '1/2 项准备成功' in report- assert '| B站 | 安装失败:TIMEOUT |' in report- assert '| GitHub | 保留用户移除 |' in report+ assert '| B站(安装失败:TIMEOUT) |' in report+ assert '| GitHub(保留用户移除) |' in report