agent-reach 1.6 系列按官方流程使用 uv 安装命令行程序，再运行 setup 准备默认渠道和技能说明。安装前先检查 uv 和已有版本，避免照搬旧教程。pypi 上同名的 agent-reach 不是这个项目，应使用官方仓库给出的发行包地址。
检查 uv 和旧版安装
在终端依次运行 uv --version 和 agent-reach version。尚未安装 Agent-Reach 时，第二条找不到命令是正常情况；uv 不存在时，先按 Astral 官方说明安装 uv，重新打开终端再检查。
若 Agent-Reach 已是 1.6 及以上，可按官方更新流程运行 agent-reach update；1.5 或更早的旧安装，应参照官方 Upgrade from 1.5 or earlier 说明识别并处理旧入口。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
安装官方发行包并初始化
运行 uv tool install https://github.com/Panniantong/Agent-Reach/releases/latest/download/agent-reach.zip，完成后运行 agent-reach setup。不要替换成 pip install agent-reach。
安装后仍提示找不到命令时，运行 uv tool update-shell，关闭并重新打开终端。setup 会准备默认渠道并安装供 AI 助手使用的 skill，额外渠道以后再加。
查看安装报告并测试需要的渠道
查看 setup 返回的 result.installation_report.markdown，确认已完成的项目和仍需处理的步骤。安装报告不是所有网站都可用的保证。
运行 agent-reach doctor --text 看本地状态，再用 agent-reach check github --text 等命令联网测试目标渠道。最后让 AI 助手读取一项实际公开资料，核对返回内容和来源。
