概述

Agent Reach v1.6.0（2026-10-23 發布）是重構版。官方說明指出，Agent 只需呼叫統一的 agent-reach 命令，Agent Reach 安裝與保存的內容都放在 ~/.agent-reach/。

安裝與升級

v1.6.0 使用 uv 安裝 GitHub release ZIP，接著執行 setup 啟用預設通道並安裝 Agent skill。PyPI 上同名的 agent-reach 套件不是這個專案，請勿從 PyPI 安裝。

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

從 v1.5 或更早版本升級

舊版升級要強制安裝 v1.6 release ZIP。開啟新 shell 後確認 agent-reach version 輸出 JSON，再執行 setup。如果仍顯示舊版純文字，官方指南要求執行 uv tool update-shell，開啟新 shell 後再次確認。

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 提供 setup、add、remove、login、logout、doctor、check、skill、update、configure 與 uninstall 等管理命令。添加通道時，CLI 會準備它所需的工具；官方文件說明，需登入的平台由使用者登入，需金鑰的平台則由使用者輸入 Key。

登入狀態分別放在 ~/.agent-reach/sessions/ 與 Agent Reach 專用瀏覽器中。專用瀏覽器按需開啟，閒置十分鐘後關閉。remove 會清除該站點登入資料及未被其他已加入通道使用的私有工具。

v1.6.1 起專用瀏覽器的埠號可以配置：當電腦上其他軟體佔用瀏覽器埠時，可執行 agent-reach configure browser-port <埠號> 改用其他埠，不必關閉佔用埠的軟體（#848）。

上游驗收範圍

上游 release notes 記錄 40 個動作中有 28 個在發布前通過真實驗收。以下項目未在發布機上測通，經維護者批准隨版發布：Reddit（測試網路遭阻擋）、Instagram（限流）、B 站字幕、LinkedIn、未登入狀態的雪球熱帖與熱股，以及未設定 Key 的小宇宙。這是上游發布紀錄，不能視為本站或讀者環境的實測結果。

升級檢查

官方來源：v1.6.0 release與標記為 v1.6.0 的 docs/install.md。