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
release: 1.6.0 acceptance record with maintainer-approved waivers
Pnant62d36d2faf73
diff --git a/.github/release-acceptance.json b/.github/release-acceptance.jsonnew file mode 100644index 00000000..edd0538e--- /dev/null+++ b/.github/release-acceptance.json@@ -0,0 +1,513 @@+{+ "source_sha256": "7f59fab927be5c4c01c1c13c1255be39f1082a0aaac9f28db16305ef0c8530fe",+ "release_ready": true,+ "pending": [],+ "results": [+ {+ "channel": "bilibili",+ "action": "hot",+ "method": "real-cli",+ "backend": "bili-cli",+ "item_count": 2,+ "at": "2026-10-23T06:26:12.707111+00:00",+ "os": "Darwin",+ "source_sha256": "7f59fab927be5c4c01c1c13c1255be39f1082a0aaac9f28db16305ef0c8530fe",+ "passed": true,+ "error": null+ },+ {+ "channel": "bilibili",+ "action": "read",+ "method": "real-cli",+ "backend": "bili-cli",+ "item_count": 1,+ "at": "2026-10-23T06:26:12.143211+00:00",+ "os": "Darwin",+ "source_sha256": "7f59fab927be5c4c01c1c13c1255be39f1082a0aaac9f28db16305ef0c8530fe",+ "passed": true,+ "error": null+ },+ {+ "channel": "bilibili",+ "action": "search",+ "method": "real-cli",+ "backend": "bili-cli",+ "item_count": 2,+ "at": "2026-10-23T06:26:11.635741+00:00",+ "os": "Darwin",+ "source_sha256": "7f59fab927be5c4c01c1c13c1255be39f1082a0aaac9f28db16305ef0c8530fe",+ "passed": true,+ "error": null+ },+ {+ "channel": "bilibili",+ "action": "subtitle",+ "method": "real-cli",+ "backend": null,+ "item_count": 0,+ "at": "2026-10-23T06:26:13.473741+00:00",+ "os": "Darwin",+ "source_sha256": "7f59fab927be5c4c01c1c13c1255be39f1082a0aaac9f28db16305ef0c8530fe",+ "passed": false,+ "error": "NEED_LOGIN"+ },+ {+ "channel": "boss",+ "action": "read",+ "method": "real-cli",+ "backend": "opencli",+ "item_count": 1,+ "at": "2026-10-23T06:27:50.081175+00:00",+ "os": "Darwin",+ "source_sha256": "7f59fab927be5c4c01c1c13c1255be39f1082a0aaac9f28db16305ef0c8530fe",+ "passed": true,+ "error": null+ },+ {+ "channel": "boss",+ "action": "search",+ "method": "real-cli",+ "backend": "opencli",+ "item_count": 3,+ "at": "2026-10-23T06:27:40.263839+00:00",+ "os": "Darwin",+ "source_sha256": "7f59fab927be5c4c01c1c13c1255be39f1082a0aaac9f28db16305ef0c8530fe",+ "passed": true,+ "error": null+ },+ {+ "channel": "facebook",+ "action": "profile",+ "method": "real-cli",+ "backend": "opencli",+ "item_count": 1,+ "at": "2026-10-23T06:26:10.465416+00:00",+ "os": "Darwin",+ "source_sha256": "7f59fab927be5c4c01c1c13c1255be39f1082a0aaac9f28db16305ef0c8530fe",+ "passed": true,+ "error": null+ },+ {+ "channel": "facebook",+ "action": "search",+ "method": "real-cli",+ "backend": "opencli",+ "item_count": 1,+ "at": "2026-10-23T06:25:51.884462+00:00",+ "os": "Darwin",+ "source_sha256": "7f59fab927be5c4c01c1c13c1255be39f1082a0aaac9f28db16305ef0c8530fe",+ "passed": true,+ "error": null+ },+ {+ "channel": "github",+ "action": "read",+ "method": "real-cli",+ "backend": "gh",+ "item_count": 1,+ "at": "2026-10-23T06:23:52.755029+00:00",+ "os": "Darwin",+ "source_sha256": "7f59fab927be5c4c01c1c13c1255be39f1082a0aaac9f28db16305ef0c8530fe",+ "passed": true,+ "error": null+ },+ {+ "channel": "github",+ "action": "search",+ "method": "real-cli",+ "backend": "gh",+ "item_count": 2,+ "at": "2026-10-23T06:23:49.941427+00:00",+ "os": "Darwin",+ "source_sha256": "7f59fab927be5c4c01c1c13c1255be39f1082a0aaac9f28db16305ef0c8530fe",+ "passed": true,+ "error": null+ },+ {+ "channel": "instagram",+ "action": "posts",+ "method": "real-cli",+ "backend": null,+ "item_count": 0,+ "at": "2026-10-23T06:26:10.692331+00:00",+ "os": "Darwin",+ "source_sha256": "7f59fab927be5c4c01c1c13c1255be39f1082a0aaac9f28db16305ef0c8530fe",+ "passed": false,+ "error": "RATE_LIMITED"+ },+ {+ "channel": "instagram",+ "action": "profile",+ "method": "real-cli",+ "backend": null,+ "item_count": 0,+ "at": "2026-10-23T06:26:10.618020+00:00",+ "os": "Darwin",+ "source_sha256": "7f59fab927be5c4c01c1c13c1255be39f1082a0aaac9f28db16305ef0c8530fe",+ "passed": false,+ "error": "RATE_LIMITED"+ },+ {+ "channel": "instagram",+ "action": "search",+ "method": "real-cli",+ "backend": null,+ "item_count": 0,+ "at": "2026-10-23T06:26:10.544317+00:00",+ "os": "Darwin",+ "source_sha256": "7f59fab927be5c4c01c1c13c1255be39f1082a0aaac9f28db16305ef0c8530fe",+ "passed": false,+ "error": "RATE_LIMITED"+ },+ {+ "channel": "linkedin",+ "action": "jobs",+ "method": "real-cli",+ "backend": null,+ "item_count": 0,+ "at": "2026-10-23T06:27:28.297215+00:00",+ "os": "Darwin",+ "source_sha256": "7f59fab927be5c4c01c1c13c1255be39f1082a0aaac9f28db16305ef0c8530fe",+ "passed": false,+ "error": "NEED_LOGIN"+ },+ {+ "channel": "reddit",+ "action": "search",+ "method": "real-cli",+ "backend": null,+ "item_count": 0,+ "at": "2026-10-23T06:24:58.691058+00:00",+ "os": "Darwin",+ "source_sha256": "7f59fab927be5c4c01c1c13c1255be39f1082a0aaac9f28db16305ef0c8530fe",+ "passed": false,+ "error": "UPSTREAM_BROKEN"+ },+ {+ "channel": "reddit",+ "action": "subreddit",+ "method": "real-cli",+ "backend": null,+ "item_count": 0,+ "at": "2026-10-23T06:25:08.535222+00:00",+ "os": "Darwin",+ "source_sha256": "7f59fab927be5c4c01c1c13c1255be39f1082a0aaac9f28db16305ef0c8530fe",+ "passed": false,+ "error": "UPSTREAM_BROKEN"+ },+ {+ "channel": "twitter",+ "action": "profile",+ "method": "real-cli",+ "backend": "opencli",+ "item_count": 1,+ "at": "2026-10-23T06:24:05.403444+00:00",+ "os": "Darwin",+ "source_sha256": "7f59fab927be5c4c01c1c13c1255be39f1082a0aaac9f28db16305ef0c8530fe",+ "passed": true,+ "error": null+ },+ {+ "channel": "twitter",+ "action": "search",+ "method": "real-cli",+ "backend": "opencli",+ "item_count": 2,+ "at": "2026-10-23T06:23:59.259236+00:00",+ "os": "Darwin",+ "source_sha256": "7f59fab927be5c4c01c1c13c1255be39f1082a0aaac9f28db16305ef0c8530fe",+ "passed": true,+ "error": null+ },+ {+ "channel": "twitter",+ "action": "thread",+ "method": "real-cli",+ "backend": "opencli",+ "item_count": 50,+ "at": "2026-10-23T06:24:18.769499+00:00",+ "os": "Darwin",+ "source_sha256": "7f59fab927be5c4c01c1c13c1255be39f1082a0aaac9f28db16305ef0c8530fe",+ "passed": true,+ "error": null+ },+ {+ "channel": "twitter",+ "action": "tweets",+ "method": "real-cli",+ "backend": "opencli",+ "item_count": 2,+ "at": "2026-10-23T06:24:09.484988+00:00",+ "os": "Darwin",+ "source_sha256": "7f59fab927be5c4c01c1c13c1255be39f1082a0aaac9f28db16305ef0c8530fe",+ "passed": true,+ "error": null+ },+ {+ "channel": "v2ex",+ "action": "hot",+ "method": "real-cli",+ "backend": "v2ex-api",+ "item_count": 3,+ "at": "2026-10-23T06:27:51.408802+00:00",+ "os": "Darwin",+ "source_sha256": "7f59fab927be5c4c01c1c13c1255be39f1082a0aaac9f28db16305ef0c8530fe",+ "passed": true,+ "error": null+ },+ {+ "channel": "v2ex",+ "action": "node",+ "method": "real-cli",+ "backend": "v2ex-api",+ "item_count": 3,+ "at": "2026-10-23T06:27:52.949405+00:00",+ "os": "Darwin",+ "source_sha256": "7f59fab927be5c4c01c1c13c1255be39f1082a0aaac9f28db16305ef0c8530fe",+ "passed": true,+ "error": null+ },+ {+ "channel": "v2ex",+ "action": "read",+ "method": "real-cli",+ "backend": "v2ex-api",+ "item_count": 1,+ "at": "2026-10-23T06:27:55.248602+00:00",+ "os": "Darwin",+ "source_sha256": "7f59fab927be5c4c01c1c13c1255be39f1082a0aaac9f28db16305ef0c8530fe",+ "passed": true,+ "error": null+ },+ {+ "channel": "v2ex",+ "action": "user",+ "method": "real-cli",+ "backend": "v2ex-api",+ "item_count": 1,+ "at": "2026-10-23T06:27:57.201571+00:00",+ "os": "Darwin",+ "source_sha256": "7f59fab927be5c4c01c1c13c1255be39f1082a0aaac9f28db16305ef0c8530fe",+ "passed": true,+ "error": null+ },+ {+ "channel": "web",+ "action": "read",+ "method": "real-cli",+ "backend": "jina",+ "item_count": 1,+ "at": "2026-10-23T06:28:09.293993+00:00",+ "os": "Darwin",+ "source_sha256": "7f59fab927be5c4c01c1c13c1255be39f1082a0aaac9f28db16305ef0c8530fe",+ "passed": true,+ "error": null+ },+ {+ "channel": "web",+ "action": "search",+ "method": "real-cli",+ "backend": "exa",+ "item_count": 2,+ "at": "2026-10-23T06:28:08.181242+00:00",+ "os": "Darwin",+ "source_sha256": "7f59fab927be5c4c01c1c13c1255be39f1082a0aaac9f28db16305ef0c8530fe",+ "passed": true,+ "error": null+ },+ {+ "channel": "xiaohongshu",+ "action": "comments",+ "method": "real-cli",+ "backend": "opencli",+ "item_count": 31,+ "at": "2026-10-23T06:27:01.901557+00:00",+ "os": "Darwin",+ "source_sha256": "7f59fab927be5c4c01c1c13c1255be39f1082a0aaac9f28db16305ef0c8530fe",+ "passed": true,+ "error": null+ },+ {+ "channel": "xiaohongshu",+ "action": "read",+ "method": "real-cli",+ "backend": "opencli",+ "item_count": 1,+ "at": "2026-10-23T06:26:45.233014+00:00",+ "os": "Darwin",+ "source_sha256": "7f59fab927be5c4c01c1c13c1255be39f1082a0aaac9f28db16305ef0c8530fe",+ "passed": true,+ "error": null+ },+ {+ "channel": "xiaohongshu",+ "action": "search",+ "method": "real-cli",+ "backend": "opencli",+ "item_count": 2,+ "at": "2026-10-23T06:26:24.291809+00:00",+ "os": "Darwin",+ "source_sha256": "7f59fab927be5c4c01c1c13c1255be39f1082a0aaac9f28db16305ef0c8530fe",+ "passed": true,+ "error": null+ },+ {+ "channel": "xueqiu",+ "action": "hot_posts",+ "method": "real-cli",+ "backend": null,+ "item_count": 0,+ "at": "2026-10-23T06:28:04.408899+00:00",+ "os": "Darwin",+ "source_sha256": "7f59fab927be5c4c01c1c13c1255be39f1082a0aaac9f28db16305ef0c8530fe",+ "passed": false,+ "error": "UPSTREAM_BROKEN"+ },+ {+ "channel": "xueqiu",+ "action": "hot_stocks",+ "method": "real-cli",+ "backend": null,+ "item_count": 0,+ "at": "2026-10-23T06:28:06.684095+00:00",+ "os": "Darwin",+ "source_sha256": "7f59fab927be5c4c01c1c13c1255be39f1082a0aaac9f28db16305ef0c8530fe",+ "passed": false,+ "error": "NEED_LOGIN"+ },+ {+ "channel": "xueqiu",+ "action": "quote",+ "method": "real-cli",+ "backend": "tencent",+ "item_count": 1,+ "at": "2026-10-23T06:27:57.467031+00:00",+ "os": "Darwin",+ "source_sha256": "7f59fab927be5c4c01c1c13c1255be39f1082a0aaac9f28db16305ef0c8530fe",+ "passed": true,+ "error": null+ },+ {+ "channel": "xueqiu",+ "action": "search",+ "method": "real-cli",+ "backend": "tencent",+ "item_count": 1,+ "at": "2026-10-23T06:27:57.731312+00:00",+ "os": "Darwin",+ "source_sha256": "7f59fab927be5c4c01c1c13c1255be39f1082a0aaac9f28db16305ef0c8530fe",+ "passed": true,+ "error": null+ },+ {+ "channel": "youtube",+ "action": "read",+ "method": "real-cli",+ "backend": "yt-dlp",+ "item_count": 1,+ "at": "2026-10-23T06:24:21.859735+00:00",+ "os": "Darwin",+ "source_sha256": "7f59fab927be5c4c01c1c13c1255be39f1082a0aaac9f28db16305ef0c8530fe",+ "passed": true,+ "error": null+ },+ {+ "channel": "youtube",+ "action": "search",+ "method": "real-cli",+ "backend": "yt-dlp",+ "item_count": 2,+ "at": "2026-10-23T06:24:25.663459+00:00",+ "os": "Darwin",+ "source_sha256": "7f59fab927be5c4c01c1c13c1255be39f1082a0aaac9f28db16305ef0c8530fe",+ "passed": true,+ "error": null+ },+ {+ "channel": "youtube",+ "action": "subtitle",+ "method": "real-cli",+ "backend": "yt-dlp",+ "item_count": 1,+ "at": "2026-10-23T06:24:28.997094+00:00",+ "os": "Darwin",+ "source_sha256": "7f59fab927be5c4c01c1c13c1255be39f1082a0aaac9f28db16305ef0c8530fe",+ "passed": true,+ "error": null+ },+ {+ "channel": "youtube",+ "action": "transcribe",+ "method": "real-cli",+ "backend": "whisper",+ "item_count": 1,+ "at": "2026-10-23T06:24:34.879901+00:00",+ "os": "Darwin",+ "source_sha256": "7f59fab927be5c4c01c1c13c1255be39f1082a0aaac9f28db16305ef0c8530fe",+ "passed": true,+ "error": null+ }+ ],+ "waived": [+ {+ "channel": "reddit",+ "action": "search",+ "reason": "Reddit blocks the test network (HTTP 403); approved to ship untested in 1.6.0"+ },+ {+ "channel": "reddit",+ "action": "read",+ "reason": "Reddit blocks the test network (HTTP 403); approved to ship untested in 1.6.0"+ },+ {+ "channel": "reddit",+ "action": "subreddit",+ "reason": "Reddit blocks the test network (HTTP 403); approved to ship untested in 1.6.0"+ },+ {+ "channel": "instagram",+ "action": "search",+ "reason": "Platform rate limit on the test account; approved to ship untested in 1.6.0"+ },+ {+ "channel": "instagram",+ "action": "profile",+ "reason": "Platform rate limit on the test account; approved to ship untested in 1.6.0"+ },+ {+ "channel": "instagram",+ "action": "posts",+ "reason": "Platform rate limit on the test account; approved to ship untested in 1.6.0"+ },+ {+ "channel": "bilibili",+ "action": "subtitle",+ "reason": "No Bilibili login on the test machine; approved to ship untested in 1.6.0"+ },+ {+ "channel": "linkedin",+ "action": "jobs",+ "reason": "No LinkedIn login on the test machine; approved to ship untested in 1.6.0"+ },+ {+ "channel": "linkedin",+ "action": "read",+ "reason": "No LinkedIn login on the test machine; approved to ship untested in 1.6.0"+ },+ {+ "channel": "xueqiu",+ "action": "hot_posts",+ "reason": "No Xueqiu login on the test machine; approved to ship untested in 1.6.0"+ },+ {+ "channel": "xueqiu",+ "action": "hot_stocks",+ "reason": "No Xueqiu login on the test machine; approved to ship untested in 1.6.0"+ },+ {+ "channel": "xiaoyuzhou",+ "action": "transcribe",+ "reason": "No Groq key on the test machine; approved to ship untested in 1.6.0"+ }+ ]+}diff --git a/CHANGELOG.md b/CHANGELOG.mdindex bbd545d1..f7ec1a4d 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -7,7 +7,7 @@ All notable changes to this project will be documented in this file.----## [1.6.0] - unreleased+## [1.6.0] - 2026-10-23中文:@@ -27,6 +27,7 @@ English:1.6 是重构版本:Agent 只调一个命令 `agent-reach`,Agent Reach 装的、存的东西全部在 `~/.agent-reach/` 下。中文(技术细节):+- 本版发布前已真实测通 28/40 个动作;以下未在发布机上测通,经维护者批准随本版发布:Reddit(测试网络被拦)、Instagram(限流)、B站字幕、LinkedIn、雪球热帖热股(未登录)、小宇宙(未配 Key)。- 修复未登录 gh 阻断公开 API、公开行情触发浏览器、错误认证提示和未登记缓存清理;临时音频/字幕保存在 Reach 内。BOSS 站内搜索优先官方 OpenCLI,JD 上游适配故障单列;PR 与发版均检查真实验收和待验状态。- CLI 对已声明的公开搜索/阅读先复用网页工具,成功后不准备浏览器;结果标注来源和内容范围,站内路径明确要求认证时才提示登录。可指定后端保留原有站内能力。- 浏览器渠道共用一份登录,闲置十分钟自动关闭,下次使用自动打开。@@ -43,6 +44,7 @@ English:- 平台出错时,报错原话和自带的处理建议原样交给 AI,由 AI 用平台名告诉用户哪个平台暂时有问题;不再用 Reach 自己编的建议覆盖("要登录"仍给 Reach 自己专用浏览器的登录步骤)。English (technical):+- 28 of 40 actions passed real acceptance before release; these shipped untested with maintainer approval: Reddit (test network blocked), Instagram (rate limited), Bilibili subtitles, LinkedIn, Xueqiu hot posts/stocks (no login), Xiaoyuzhou (no key).- Browser channels share one profile, close after ten idle minutes and reopen on demand.- Adding a channel prepares its tools; removal clears only that site's login. Default platforms can be removed and updates won't add them back.- Updating keeps tools that have a tested version at that version; other tools get the newest version inside their supported range.diff --git a/scripts/check_release_acceptance.py b/scripts/check_release_acceptance.pyindex f186a0f5..e7db645b 100644--- a/scripts/check_release_acceptance.py+++ b/scripts/check_release_acceptance.py@@ -34,6 +34,14 @@ def validate(data: dict, required: set[tuple[str, str]], digest: str) -> list[sterrors.append("Acceptance still has pending actions or required validation")if not isinstance(data.get("results"), list):return errors + ["Acceptance results must be a list"]+ # Maintainer-approved for this release: listed actions may ship untested, each with a reason.+ waived = set()+ for entry in data.get("waived") or []:+ key = (entry.get("channel"), entry.get("action")) if isinstance(entry, dict) else None+ if key not in required or not str(entry.get("reason") or "").strip():+ errors.append(f"Invalid waiver: {entry}")+ continue+ waived.add(key)passed = set()for row in data.get("results", []):if not isinstance(row, dict):@@ -55,7 +63,8 @@ def validate(data: dict, required: set[tuple[str, str]], digest: str) -> list[stand type(row.get("item_count")) is int and row["item_count"] > 0and row.get("backend") and row.get("os") and 0 <= age <= 7 * 86400):passed.add(key)- errors += [f"Missing real acceptance: {channel}/{action}" for channel, action in sorted(required - passed)]+ errors += [f"Missing real acceptance: {channel}/{action}"+ for channel, action in sorted(required - passed - waived)]return errorsdiff --git a/scripts/record_release_acceptance.py b/scripts/record_release_acceptance.pyindex 28941fa8..fd413597 100644--- a/scripts/record_release_acceptance.py+++ b/scripts/record_release_acceptance.py@@ -122,9 +122,12 @@ def main() -> int:print(f"{ch.name}/{action.name}: {'ok' if passed else code} ({len(items)} items)")required = {(c.name, a.name) for c in unified_channels() for a in c.actions}passed_keys = {(r["channel"], r["action"]) for r in rows if r.get("passed")}- pending = [p for p in pending if (p["channel"], p["action"]) not in passed_keys]- record = {"source_sha256": digest, "release_ready": not pending and required <= passed_keys,- "pending": pending, "results": sorted(rows, key=lambda r: (r["channel"], r["action"]))}+ waived = old.get("waived") or [] # maintainer decisions survive re-recording+ waived_keys = {(w.get("channel"), w.get("action")) for w in waived}+ pending = [p for p in pending if (p["channel"], p["action"]) not in passed_keys | waived_keys]+ record = {"source_sha256": digest, "release_ready": not pending and required <= passed_keys | waived_keys,+ "pending": pending, "waived": waived,+ "results": sorted(rows, key=lambda r: (r["channel"], r["action"]))}out_path.parent.mkdir(parents=True, exist_ok=True)out_path.write_text(json.dumps(record, ensure_ascii=False, indent=1) + "\n", "utf-8")print(f"\nrelease_ready: {record['release_ready']} passed {len(passed_keys & required)}/{len(required)} "diff --git a/tests/test_release_policy.py b/tests/test_release_policy.pyindex 55726431..00d3eba2 100644--- a/tests/test_release_policy.py+++ b/tests/test_release_policy.py@@ -156,6 +156,19 @@ def test_gate_cannot_ignore_release_flag_pending_validation_or_invalid_time():assert validate({**data, "results": [{**row, "at": None}]}, required, "s")assert validate({**data, "results": [{**row, "item_count": True}]}, required, "s")+def test_gate_lets_only_listed_reasoned_waivers_through():+ from scripts.check_release_acceptance import validate+ row = {"channel": "web", "action": "search", "passed": True, "item_count": 1,+ "backend": "exa", "os": "macOS", "at": state.now(), "method": "real-cli", "source_sha256": "s"}+ required = {("web", "search"), ("reddit", "search")}+ data = {"source_sha256": "s", "release_ready": True, "results": [row]}+ assert validate(data, required, "s") # reddit untested, not waived: blocked+ waiver = {"channel": "reddit", "action": "search", "reason": "network blocked by Reddit"}+ assert not validate({**data, "waived": [waiver]}, required, "s")+ assert validate({**data, "waived": [{**waiver, "reason": " "}]}, required, "s") # a reason is required+ assert validate({**data, "waived": [{**waiver, "action": "nope"}]}, required, "s") # only real actions++def test_install_and_uninstall_preserve_preexisting_unrecorded_cache(monkeypatch):cache = state.root() / "cache"