QUICKSTART

從一台 Worker、
一個資料夾開始。

這份指南描述開發者預覽的連線流程。公開 Worker 安裝包尚未發布;加入 Beta 後會取得對應版本與配對指令。

安裝前準備

先確認工具本身可用。

RelayMesh 是協調層,不會替你安裝、登入或授權第三方 CLI。每台 Worker 至少需要:

作業系統Windows 11 x64(Beta 優先驗證)
基礎工具Node.js 20+、Git
AI 工具至少一個已能獨立運作的 CLI,或本機 Ollama
專案可回復的 Git 工作區;建議先用非敏感測試資料
網路可由本機主動連出 HTTPS;不需要公開連入
連線流程

五步完成第一條安全路徑。

01

準備本機環境

安裝 Node.js 20+、Git,以及至少一個你有權使用的 Codex、Claude、Grok、AGY CLI 或 Ollama。先直接執行該工具,確認登入與基本命令正常。

02

建立 RelayMesh 組織

登入網站後建立組織。所有裝置、專案、Discord 綁定與任務都隔離在這個租戶範圍。

03

配對 Worker

從裝置頁建立短效配對碼,再於本機 Worker 輸入。Worker 只主動連向控制面,不需要路由器轉發連接埠。

04

授權一個資料夾

在 Worker 端選擇測試專案,確認解析後的實體路徑,再於網站設定可用 CLI、角色與執行政策。

05

從外面建立第一個任務

在手機或其他電腦登入網站,選擇已授權專案再送出範圍小、可驗證且容易回復的任務。家中 Worker 會主動領取,不必公開本機 Port。

遠端會員操作

人在外面,工作回家裡執行。

會員只需要登入 RelayMesh HTTPS 控制台。網站建立受租戶與專案權限限制的簽章工作;家中 Worker 主動連出領取,因此不需要 Remote Desktop、路由器 Port Forwarding,也不會公開本機 Dashboard。

登入Supabase Auth Session;正式商用前需再完成 MFA 與帳號恢復流程
選擇只列出會員有 operate 權限且本機仍授權的專案 ID
派送任務不接受本機路徑、任意 shell、CLI Token 或政策覆寫
執行Worker 再驗證簽章、期限、專案映射與本機 approval profile
回報只回傳去敏狀態、計數與驗證結果;CLI 登入與 Vault 正文留在本機
多專案怎麼隔離?

每個網站專案固定對應一台 Worker 上的一個 opaque local project ID。不同專案可分別授權 Remote MCP;同一專案的網站、CLI 與 MCP 寫入仍共用單一寫入鎖。

查看 Remote MCP 與 Obsidian 記憶邊界 →

Ollama(選用)

Ollama 是你電腦上的 Runtime。

它不是 RelayMesh 的雲端 quota。Windows Worker 已內附鎖版 standalone runtime,不必另裝 Ollama Desktop;模型權重不隨 Worker 打包,仍由你自行選擇與下載。

PowerShell本機 API:127.0.0.1:11434
# 啟動服務;桌面版通常已在背景執行
ollama serve

# 將 <model> 換成你自行選擇的模型名稱
ollama pull <model>

# 列出本機已安裝模型
ollama ls

# 查看目前載入的模型
ollama ps
模型選單從哪裡來?

Worker 讀取 ollama ls 的實際結果。沒有安裝的模型不顯示;本機運算沒有雲端剩餘百分比。

第一個任務

寫成能被驗證的目標。

建議格式
修復登入表單在 session 過期後不會回到登入頁的問題。只修改 src/auth 與相關測試;完成條件是既有測試加上新的逾時測試全部通過。

具體的問題、允許範圍與完成條件,能讓規劃、寫入和驗證角色做出一致判斷。

狀態詞彙

看到停止,不代表系統壞了。

Ready

Worker 在線、專案政策完整且至少有一條可用路由。

Unknown

CLI 沒有安全查詢方法;系統不替未知值填入百分比。

Blocked

政策、額度或能力不符合任務需要,已在寫入前停止。

Needs fixes

有實際修改,但驗證未通過,因此不標記完成。