Oysterun
繁中 EN

開始使用

從 Host 準備完成走到一個有用的 Session。

依照手機優先的單一路徑操作，同時明確辨識 Host identity、瀏覽器路徑、選定資料夾與完成回覆。

Oysterun 是 Beta 軟體。提供者、作業系統與 Host 是否支援，取決於目前設定；這條路徑只證明你現在實際確認的選項，不構成路線圖承諾。

  1. 安裝 Oysterun Host

    前置需求：Ubuntu 22.04+ 使用 Bash；macOS 使用 Bash 或 zsh。下載需要 curl。Ubuntu 的 direct root 可執行 apt-get update && apt-get install -y curl；一般管理員可執行 sudo apt-get update && sudo apt-get install -y curl。macOS 正常內建 /usr/bin/curl；若缺少，請停止並透過 macOS Software Update 或 Apple 支援恢復。只有這些有限前置操作或 installer 明確要求時才使用管理員權限。

    installer 會在目標使用者環境檢查 Node.js 與 npm，保留 Node.js 22，並在支援的環境把缺少或不同 major 的 runtime 改為 Node.js 22。macOS 未安裝 Homebrew 時會在修改前停止，並引導使用官方 Node.js installer。絕對不要使用 sudo npm install -g oysterun。

    macOS

    安裝程式保留目前的 macOS 使用者；Node.js 過舊時使用既有 Homebrew，沒有 Homebrew時會在修改前停止並提供官方 Node.js 指引。

    下載、檢視並執行

    curl -fsSL https://oysterun.com/install.sh | bash

    預期結果: $HOME/.local/npm

    Linux（Ubuntu）

    一般或 sudo 啟動保留原使用者；只有 direct-root Linux 伺服器建立或重用專用 oysterun 使用者。

    下載、檢視並執行

    curl -fsSL https://oysterun.com/install.sh | bash

    預期結果: $HOME (direct-root: /home/oysterun); $HOME/.local/npm

    下一步：連線手機或瀏覽器

    設定完成且狀態正常後，下載 Oysterun iOS App 並掃描當下顯示的新 QR；或在一般瀏覽器開啟同一個 Host URL，以目前的 Host 密碼登入。QR 與 bootstrap token 應視為暫時密碼，不要保存或公開。

    下載 Oysterun iOS App

  2. 完成 Host 引導設定

    通用安裝程式完成安裝後會開啟 oysterun；缺少設定時會自動進入引導設定。之後可用 oysterun setup 再次開啟。依序完成七項引導選擇：Host 名稱、Default Browse Root、Host 密碼、Managed connectivity、telemetry 與隱私、手機 App，以及 Start Host。

  3. 確認 Host 成功啟動

    等到設定流程回報預期的 Host 正在運行，再記下目前 URL；只有要連接手機時，才在成功啟動後產生新的 QR。若設定回報錯誤，或 Host identity 與剛才的選擇不同，請先解決該結果再繼續。安裝成功本身不代表 Host 設定已完成。

  4. 視需要準備 Session 提供者

    安裝與設定 Host 不要求任何提供者。若要建立 Session，請選擇目前畫面列為支援的任一提供者，替同一位作業系統使用者安裝並登入，再確認 readiness；沒有任何單一提供者是必裝項目。開始 Session 前，先處理登入、信任、model 或 readiness 警告。

  5. 從手機與瀏覽器開啟同一個 Host

    在手機上掃描 Host 成功啟動後產生的新 QR，或輸入畫面顯示的精確 Host URL 與目前 Host 密碼；再於一般瀏覽器開啟完全相同的 Host URL。手機與瀏覽器只是連到同一 Host identity 與相同 Session 狀態的兩個 Client，不是兩個 Host。若任一 Client 顯示不同 identity、非預期網址或安全警告，立即停止。

  6. 從目前登入路徑進入

    使用 Host 目前只有密碼欄位的登入畫面；裝置配對與通知權限都不能取代 Host 驗證。可見的成功檢查點，是抵達剛才已核對 Host 的 Sessions 頁面。頁面可連線只證明路徑可達，不代表提供者 Session 已經能完成工作。

  7. 建立一個範圍受限的提供者 Session

    從 Sessions 開啟新的 Session Setup；只有在所選提供者的 readiness 狀態仍為目前資訊時才繼續，填入容易辨識的 Agent ID 與 Session Name，並選定精確的 Start Folder。啟動 Session 後，傳送這段已審查 prompt：只讀取目前資料夾。回覆資料夾名稱，並用一句話說明其中內容。不要編輯、建立、刪除、移動、重新命名或執行任何檔案。若選定的提供者或資料夾與先前審查內容不同，立即停止。

  8. 等待完成回覆

    Connected、可連線的 Chat，或 Working 指示都不是完成答案。等到工作中狀態消失，且提供者的 final response 已清楚顯示。這個有限檢查點，是回覆能說出選定資料夾名稱，並描述其中目前內容，而不要求修改；登入、核准、tool 或 readiness 警告，以及仍在工作的 turn，都是尚未終止、應先停下處理的狀態。

  9. 辨識並回到 Session

    記錄 Oysterun 顯示的 Session Name 與穩定 identity。離開 Chat、回到 Sessions，再開啟同一列；繼續前先確認 Agent ID、精確資料夾與先前回覆都相同。這是返回既有 Session 的路徑；已能辨識該 Session 時，不要另外建立重複 Session。