Agent-Reach：为代理准备并诊断网页读取工具
Agent-Reach 架构：就绪、后端选择与实际读取
沿 doctor 汇总流程理解状态来源，并将诊断控制信息与上游命令返回的文档分开。
Agent-Reach 架构：就绪、后端选择与实际读取知识学习CN编辑简报更新 2026-09-18
你将学会
- 渠道定义自己的检查
- 异常限定在渠道内部
- 输出有脱敏边界
开始前需要
- 基本命令行与配置阅读能力
- 能够在独立且获准的环境中试验
把渠道健康、实际获取和答案验收关联起来，保留日期但不收集账号秘密。
先看结论
- 检查证据由渠道实现决定。
- 单渠道异常不会抹掉全部报告。
- 只读配置不等于离线执行。
渠道定义自己的检查
doctor.check_all 遍历 get_all_channels 并调用各渠道 check(config)，收集状态、描述、消息、层级、后端列表和 active_backend。每个检查能证明什么，由具体渠道实现决定。
汇总器本身不解析所有网页，也不负责摘要。README 说明宿主直接调用上游读取工具，因此渠道控制信息不能替代那些工具真正获取到的内容。
异常限定在渠道内部
每个渠道检查都在 try/except 内，异常产生 error 状态并清空结果中的活动后端，随后继续循环。因此一个渠道坏了不会让其他渠道的检查结果全部消失。
这种隔离提高诊断完整性，却不保证检查很快或完全无副作用。配置只读表示不写配置文件，外部探针仍可能发起网络请求，两者不能混淆。
输出有脱敏边界
保存 message 前调用 scrub_url_credentials，终端报告还会转义 Rich 标记。JSON 与终端共享汇总逻辑，但呈现方式不同，应分别考虑内容与渲染风险。
即使存在 URL 脱敏，报告仍可能包含来源名称或不在该规则范围内的敏感上下文。只保留解释故障所需字段，分享前审阅，真实文档内容另行核查。
如何选择
| 比较维度 | 方案 A | 方案 B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
实施步骤
- 1
识别所选渠道到底检查什么。
- 2
将状态和后端与文档内容分开。
- 3
保留诊断前先脱敏审阅。
可复制示例
text
渠道注册表 → ch.check(config)
异常 → error + active_backend=None
消息 → scrub_url_credentials
结果 → JSON 或转义后的终端报告常见问题
doctor 负责最终读取吗？
它汇总检查，内容由宿主调用上游读取器获取。
JSON 一定适合公开吗？
仍需审阅，局部脱敏不能移除全部敏感背景。
资料来源
- Agent-Reach / agent_reach/doctor.py来源核查 2026-09-18
- Agent-Reach / agent_reach/cli.py来源核查 2026-09-18
- Agent-Reach / README.md来源核查 2026-09-18