指南
Mac 應用程式
喺你部 Mac 用你自己嘅編程 agent 同 Docker 運行 Skynet。
Skynet Mac 應用程式喺你自己部電腦上面運行 Skynet。佢會經一個喺你部 Mac 已登入嘅編程 CLI 發出模型呼叫，所以呢啲呼叫由你嘅 CLI 計劃支付。你亦可以將應用程式連結到你嘅雲端 Skynet 帳戶。
要求
- 一部用 Apple silicon 嘅 Mac。有 Intel 版本，但係未有人喺 Intel 硬件上面測試過。
- Docker Desktop，要運行緊，而且開咗 Use Rosetta for x86_64/amd64 emulation。
- 一個已登入嘅編程 CLI：
- Claude Code (
claude) 2.1.226 或者更新版本，或者 - Codex (
codex) 0.160.0 或者更新版本。
- Claude Code (
設定 Codex
Codex 一定要將憑證保存喺檔案入面。第一次啟動之前，做以下步驟：
- 打開
~/.codex/config.toml，加入呢一行：
cli_auth_credentials_store = "file"- 用你嘅 ChatGPT 帳戶登入：
codex login安裝應用程式
呢啲版本用 ad hoc 簽署，冇經過公證 (notarization)。喺你移除隔離標記之前，macOS 會封鎖佢哋。
- 打開
.dmg檔案。 - 將 Skynet 拖去 Applications。
- 喺 Terminal 運行呢個指令：
xattr -dr com.apple.quarantine /Applications/Skynet.app- 喺 Applications 打開 Skynet。
啟動時會發生乜事
應用程式會按次序做以下步驟：
- 佢會由你嘅登入 shell 讀取
PATH，等佢搵到 Docker 同你嘅 CLI。 - 佢會檢查 Docker 同你嘅編程 CLI。
- 佢會喺 Docker 入面啟動一個本機 Postgres 數據庫。
- 佢會為
linux/amd64建立沙盒映像skynet-local-sandbox。Docker 會喺 Rosetta 下面運行佢。 - 佢會更新數據庫結構 (schema)。
- 佢會啟動本機 API 同網頁應用程式，再喺視窗入面顯示網頁應用程式。
初次設定檢查
應用程式會顯示一個檢查清單：Docker、Coding CLI、Signed in、Usage limit、Local services 同 Account。如果有一項檢查失敗，應用程式會顯示一個畫面，話你知要做乜：
| 畫面 | 要做乜 |
|---|---|
| Install Docker Desktop | 安裝 Docker Desktop。 |
| Start Docker | 啟動 Docker Desktop。 |
| Install a coding CLI | 安裝 Claude Code 或者 Codex。 |
| Update your coding CLI | 將 CLI 更新到上面嘅最低版本。 |
| Sign in to your CLI | 喺 Terminal 登入 CLI。 |
| Usage limit reached | 等到重設時間。重設之後，新工作可以再開始。 |
修好問題之後，撳 Check again。撳 Open logs 睇記錄檔。喺 Usage limit reached 畫面，你可以撳 Open Skynet anyway。
本機運行
喺應用程式入面，模型呼叫會經過你部 Mac 上面嘅 CLI。模型選單會將呢個模式顯示為 本機。提示會話：「調用費用由你嘅計劃支付，所以呢個模型為運行加 $0。」
應用程式入面嘅 CLI 名稱係 Claude Code 同 Codex。
喺你嘅 CLI 運行提議器
喺我嘅 CLI 上運行提議器 呢個設定控制提議器代理喺邊度運行。選擇有 代理引擎（預設） 同 停用（沙盒提議器）。
提議器權限 設定 CLI 可以接觸到乜嘢：
- 只限工作區 係預設值。佢依賴每個 CLI 自己嘅沙盒。
- 完全存取 會用你嘅用戶權限運行 CLI。
喺應用程式入面標註
喺 Mac 應用程式用 AI 標註，需要你自己嘅供應商金鑰。喺 自備金鑰 下面揀一個模型。睇 用標註工具標註數據。
連結到你嘅 Skynet 帳戶
你唔使帳戶都可以用應用程式。撳 Use without signing in 就得。想同你嘅雲端帳戶同步，就要連結應用程式。
連結呢部 Mac
- 去到 Sign in to Skynet 呢一步，應用程式會喺你嘅預設瀏覽器打開 Link a Mac 頁面。
- 如果瀏覽器要求，就喺瀏覽器登入 Skynet。
- 檢查 連結之後，呢部 Mac 可以： 下面嘅清單。
- 撳 連結呢部 Mac。頁面會顯示「返緊去 Mac app…」。
如果登入失敗或者你取消，應用程式會顯示 Try again 同 Use without signing in。
連結之後，呢部 Mac 可以：
- 睇到你嘅名同電郵。
- 睇到你嘅結餘。
- 將你嘅運行同你嘅帳戶同步。
- 用雲端模型，費用由你嘅結餘支付。
- 用你已連接嘅資料來源。
- 經 Skynet 搜尋同瀏覽網頁。
連結用一個安全嘅登入流程（OAuth 加 PKCE）。應用程式會將佢嘅 token 加密保存喺你部 Mac。當你解除連結，Skynet 會撤銷呢啲 token。
連結限制
| 限制 | 數值 |
|---|---|
| 每個帳戶可連結嘅 Mac | 10 |
| 存取 token 有效期 | 1 小時，之後應用程式會更新佢 |
| 連結閒置逾時 | 30 日冇用 |
| 連結最長期限 | 365 日 |
閒置逾時或者到咗最長期限之後，要再連結一次部 Mac。
連結狀態
應用程式會顯示以下其中一個狀態：本機模式、已連結呢部 Mac、登入嚟同步 或者 已連結(離線)。
本機服務同數據
所有本機服務都只係監聽 127.0.0.1：
| 服務 | 埠範圍 |
|---|---|
| API | 48100 至 48119 |
| 網頁應用程式 | 48120 至 48139 |
| Postgres | 48140 至 48159 |
應用程式將佢嘅數據保存喺 ~/Library/Application Support/Skynet。logs/ 資料夾裝住 desktop.log、api.log、frontend.log、migrate.log 同 sandbox-build.log。
當你結束應用程式，佢會停止網頁應用程式、API、Postgres 同所有工作容器。
重設應用程式
先結束應用程式。然後運行：
docker volume rm skynet-local-pgdata
rm -rf ~/Library/Application\ Support/Skynet