Agent-Reach：为代理准备并诊断网页读取工具
实践：制作带来源证据的 Agent-Reach 读取日志
把渠道健康、实际获取和答案验收关联起来，保留日期但不收集账号秘密。
实践：制作带来源证据的 Agent-Reach 读取日志知识学习CN编辑简报更新 2026-09-18
你将学会
- 保存三个独立观察
- 解释最早失败阶段
- 测试证据关系
开始前需要
- 基本命令行与配置阅读能力
- 能够在独立且获准的环境中试验
把渠道健康、实际获取和答案验收关联起来，保留日期但不收集账号秘密。
先看结论
- 后续成功需要独立证据。
- 健康新鲜度不是文档新鲜度。
- 来源学习不需要收集秘密。
保存三个独立观察
分别记录渠道状态、获取结果和答案评价，并附来源 URL、时间和后端名称。健康成功不能自动填写后面两个成功字段，每一步都需要自己的证据。
首先使用公开的虚构夹具，不需要完整正文时保留哈希或短小获准片段。学习日志不能保存 Cookie、认证头或无关个人资料，以免扩大数据风险。
解释最早失败阶段
将依赖缺失、渠道不可用、提取不完整和答案无依据分开显示，帮助读者选择下一项检查。摘要错误不应该触发重新安装整套工具。
旧内容继续显示原获取日期，不因为 doctor 又运行一次就改成最新。渠道健康新鲜度与文档新鲜度是不同属性，应在记录中保持独立。
测试证据关系
构造健康但不可读、可读但不完整、完整却误引的案例。验收要求后续状态没有自身证据就不能标成功，第一版界面保持只读，不自动修复账号或工具。
这是独立学习建议，不是上游现成功能。表格和简短证据流已经合适，三维场景不会让来源关系更容易核验，也不应影响正文可读性。
如何选择
| 比较维度 | 方案 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
测试部分成功和陈旧内容。
可复制示例
json
{
"proposal": true,
"sourceUrl": "https://example.com",
"capturedAt": null,
"channelHealth": null,
"retrieval": null,
"answerCheck": null,
"readOnly": true
}常见问题
项目已有这份日志吗？
本章提出独立格式建议。
它应该自动修复渠道吗？
初始练习只读并解释证据。
资料来源
- Agent-Reach / README.md来源核查 2026-09-18
- Agent-Reach / agent_reach/doctor.py来源核查 2026-09-18