Skip to content

Give your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.

refactor: shorten installation receipt to key public capabilities

LohseZSaid603ba10cd11
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 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__.py
index 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.py
index 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.md
index 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.md
index 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.
## Usage
diff --git a/docs/install.md b/docs/install.md
index 87e4aa27..701eff29 100644
--- a/docs/install.md
+++ b/docs/install.md
@@ -21,7 +21,7 @@ agent-reach setup
agent-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.toml
index 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.py
index 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, monkeyp
assert '安装失败: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 cli
assert cli.main(['setup', '--text']) == 0
text = capsys.readouterr().out
- assert '默认渠道:安装结果与免登录粒度' in text
- assert '按需渠道:公开可读与登录后的增量' in text
- assert '| 搜索/列表 | 正文/详情 | 评论/回复 | 字幕/转录 |' in text
+ assert '| 渠道 | 安装后能获取什么 |' in text
+ assert text.count('|---|---|') == 1
assert '完整报告已保存:' in text
assert 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 None
assert 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.py
index 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_live
for 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) <= 1000
for 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