Agent Reach v1.6 入門：安裝、檢查與第一次讀取

概述

本篇依 Agent Reach v1.6.0 的官方安裝指南與 release notes，帶你安裝命令列介面 (CLI)、確認版本、完成 setup、查看通道狀態，再讀取一個網址。安裝與設定命令請在終端機執行。

安裝與確認版本

v1.6.0 使用 uv 從 GitHub 發行版壓縮檔 (release ZIP) 安裝。PyPI 上同名的 agent-reach 套件不是這個專案，請勿從 PyPI 安裝。

uv tool install https://github.com/Panniantong/Agent-Reach/releases/latest/download/agent-reach.zip
agent-reach version

v1.6.0 的 agent-reach version 輸出為 JSON (JavaScript Object Notation)。若安裝後找不到命令，官方指南建議執行 uv tool update-shell，再開啟新的 shell (命令列環境)。

執行 setup 與檢查通道

setup 啟用預設通道並安裝 Agent skill (代理技能)。完成後可用 doctor 或 check 檢視通道狀態；有些通道需要登入或設定 API 金鑰 (API key)，狀態依目前環境而異。

agent-reach setup
agent-reach doctor
agent-reach check

安裝回報會列出安裝結果，以及哪些 AI 可讀取 skill、可選通道和可選登入。請依回報處理需要的登入或 Key，不要預設所有通道都已可用。

讀取一個網址

v1.6.0 的統一 CLI 提供 agent-reach read <url>。例如請 Agent Reach 讀取 Agent Reach 的 GitHub 頁面：

agent-reach read https://github.com/Panniantong/Agent-Reach

這裡只示範上游列出的命令形式；結果欄位與可讀內容依實際回應而定。

從 v1.5 或更早版本升級

舊版升級需強制安裝 v1.6 release ZIP，並使用新版 version 命令確認已切換，再執行 setup：

uv tool install --force https://github.com/Panniantong/Agent-Reach/releases/latest/download/agent-reach.zip
agent-reach version
agent-reach setup

官方指南說明，setup 會保留 ~/.agent-reach/config.yaml，移除舊版 Agent Reach 程式，並更新 Agent skill。完整步驟見標記為 v1.6.0 的 install.md；release 頁面見Agent Reach v1.6.0。