說明文件

怎麼安裝 Pyloxa、連接 Agent、跑第一個計畫,以及常見問題怎麼處理。標有 Pro 的功能需要試用、Pro 預覽或 Pro;其他都在免費版裡。

適用 Pyloxa 0.2.0 以後的版本・最後更新:2026 年 11 月 21 日

安裝與更新

需要什麼

Pyloxa 不收 AI 用量的費用:CLI 用的是你自己的訂閱或 API Key。

下載與安裝

  1. 從最新版本下載 Pyloxa-Setup-<版本>.exe。
  2. 選用:檢查檔案。在 PowerShell 執行 Get-FileHash .\Pyloxa-Setup-<版本>.exe -Algorithm SHA256,和版本說明裡的 SHA-256 比對。
  3. 執行安裝檔。它只安裝給你這個 Windows 使用者(不需要系統管理員權限),會先顯示授權合約,可以選安裝資料夾,並在開始功能表與桌面建立捷徑。

「Windows 已保護您的電腦」

安裝檔目前還沒有程式碼簽章,所以 Microsoft Defender SmartScreen 可能會擋下它,顯示「Windows 已保護您的電腦」與「未知的發行者」。請按「其他資訊」,再按「仍要執行」。想確認檔案是我們發布的那一個,可以先比對 SHA-256(見上方)。如果是防毒軟體擋下安裝檔或 App,請看防毒軟體擋下 Pyloxa 或 CLI。

更新

設定精靈

第一次開啟 Pyloxa 時,設定精靈會帶你走十個步驟。用「下一步」與「上一步」前後切換,也可以按「略過設定精靈」;之後隨時可以在 設定 → 一般設定 →「重新開啟設定精靈」再打開。

  1. 歡迎:先說明 Pyloxa 和自己開好幾個 Session 有什麼不同:大腦把需求拆成工作、依規則交給不同家的 Agent,Pyloxa 自己跑測試,額度用完經你確認後換手,Agent 不碰你的資料夾、合併與推送由你決定。也可以在這裡選介面語言。已經有可以派工的 Agent 時,這一頁就有「開始試駕」。
  2. 環境檢查:git(必要)與 Node.js(選用)。缺少或版本太舊時,複製畫面上的 winget 命令,或開啟官方下載頁,裝好後按「重新檢查」。
  3. 安裝 Agent:每個 CLI 一張卡。「安裝 {name}」會先讓你看到完整的命令,再以 CLI 官方的 npm 套件(npm install -g …)安裝 Pyloxa 已驗證的最新版本。這一步需要 Node.js。如果裝好了卻找不到,請重新啟動 Pyloxa。
  4. 登入與金鑰:每個 CLI 是否「可以派工」。用畫面上的命令在終端機登入(例如 claude auth login 或 codex login),或改用 API Key。詳見連接 Agent。至少一個 Agent 可以派工時,最上面也有「開始試駕」。
  5. 選大腦:負責規劃工作的 Agent。詳見大腦。
  6. 分工:哪一類工作交給哪個 Agent。之後可以在「工作流程」頁修改。
  7. 工作習慣:worktree 的方式、大腦驗收、交叉測試、精簡回覆、派工模式、沒有規則命中時怎麼辦、驗收方式,以及通知與更新。
  8. Skills:各個 CLI 現在看得到的 Skills。詳見 Skills。
  9. 開啟專案:選一個至少有一次 commit 的 git repo,再核准它的驗證命令。
  10. 第一個工作:說明一個工作怎麼跑,也可以選擇先用範例專案試駕。

精靈結束後,視窗裡會留著「入門清單」,直到你關掉它:連上一個 Agent、選好大腦、開啟專案、核准驗證命令、接受第一個成果、看看 Skills、合併成果或開 PR。第一次用到 App 的各個地方時會出現簡短的提示;可以在 設定 → 一般設定 關掉或重新顯示。

連接 Agent

到 設定 → Agent 與工作流程 →「Agent 連線」。每個 CLI 會顯示版本、相容性、登入狀態、計費方式,以及「可以派工」、「無法派工」或「額度受限」。安裝或登入之後按「重新偵測」。

訂閱帳號(Claude Code 與 Codex CLI)

在終端機用 CLI 自己的命令登入:Claude Code 是 claude auth login,Codex CLI 是 codex login。Pyloxa 只用 CLI 自己的狀態命令確認是否登入,並像你一樣啟動 CLI;不會讀取、複製或傳送你的 token 或憑證檔。

API Key

Gemini CLI(實驗性)

Gemini CLI 只能用你自己的付費 Gemini API Key,不支援 Google 帳號登入與 Google 的訂閱方案。Pyloxa 用一個獨立的設定資料夾執行它。它可以接寫作、文件之類的工作,但不能擔任大腦,也不能測試其他 Agent 的成果。

CLI 版本

Pyloxa 會測試它支援的每個 CLI 版本。連線卡上會顯示三種狀態之一:

CLI 有新版本時,卡片上會顯示「更新到 {version}」(Pyloxa 已驗證的最新版本)、「複製命令」與 CLI 官方的更新說明。CLI 自己更新之後,會有橫幅告訴你現在是哪個版本。

第一個計畫

送出需求

開啟專案,在訊息框描述你想完成的事。在「交給誰」選「交給大腦」讓它規劃,或選「直接交給 {name}」,不經過計畫,直接把一個工作交給一個 Agent。輸入 / 可以插入常用指令;免費版最多存五個,Pro Pro 不限數量。

大腦

大腦是你的其中一個 Agent。它回答問題、把需求拆成階段與工作,也可以驗收成果。在 設定 → Agent 與工作流程 →「Agent 與大腦」選擇,也可以在那裡設定「大腦的模型」與「大腦的思考強度」;這兩項只影響大腦,不影響執行工作的 Agent。大腦不能改你的設定。Gemini CLI 不能擔任大腦。主要大腦不能用時接手的備援大腦是 Pro。

核准計畫

派工規則與派工模式

規則在 設定 → Agent 與工作流程 →「工作流程」。「分工」的分工表決定每一類工作交給哪個 Agent,備援只在 Agent 出問題(例如額度用盡)時才用。「規則模擬」可以看一個工作會被派到哪裡,不會呼叫任何 Agent。「派工模式」決定計畫怎麼開始:

同時能跑多少

驗證、大腦驗收與交叉測試

Agent 說做完了不算數,Pyloxa 會自己檢查每一份成果。

驗證命令與 Gate

大腦驗收

在「工作流程」頁的「檢查」,「大腦驗收」可以關閉(預設)、只驗收沒有驗收命令的工作,或驗收所有工作。大腦只讀不改,決定接受、要求修改或問你;它的判斷會標示為 AI 判斷。大腦不會驗收自己做的工作:由備援大腦 Pro 驗收,沒有的話就等你處理。

交叉測試

工作流程

設定 → Agent 與工作流程 →「工作流程」顯示工作經過的五段:規劃、階段、分工、檢查、交付。點任一段會跳到它的設定。

Agent Teams Pro

Agent Teams 是實驗功能,讓同一個計畫裡的 Agent 互相溝通:分工、回報進度、提問與傳訊息,由大腦或你擔任 Lead。

試駕與驗證報告卡

先用範例專案試駕

在設定精靈的最後一步,或還沒有任何專案時的歡迎畫面,按「開始試駕」。已經登入 Agent 的話,精靈的第 1 步(歡迎)與第 4 步(登入與金鑰)也有這個按鈕。從前面開始試駕時,精靈會以預設值結束:大腦與分工都用預設的,側欄的「入門清單」列出還沒做的事,之後可以在 設定 → 一般設定 重新開啟精靈。Pyloxa 會在它的資料夾裡建立一個藏了一個 bug 的小型範例 repo,並附上寫好的計畫,所以大腦不會用到額度。導覽會帶你走過:核准計畫、Agent 修正、Pyloxa 執行 node --test、有第二個 Agent 時由它交叉測試、接受結果,最後是驗證報告卡。預覽會估算大約會用多少。試駕需要 git 與 Node.js,本身是免費的;其中的自動交叉測試需要 Pro,免費版要自己按下測試。試完可以刪掉範例資料夾。

驗證報告卡

計畫完成後,計畫卡上的「驗證報告卡」整理每一份成果:✅ 通過 Pyloxa 執行的命令、⚠️ 沒有命令驗證、❌ 有檢查沒過、⏳ 還沒完成。每份成果會列出由誰完成、交叉測試的結果與新增的測試、跑了哪些命令,以及怎麼被接受的。可以按「複製 Markdown」,或在開 PR 時選擇把報告卡附在說明最後。

共用記憶

共用記憶是放在你電腦上的一份記憶,每個 Agent 工作時都會拿到它當作背景資料:規則、偏好、決定、事實與踩過的坑。免費版就有。在 設定 → Agent 與工作流程 →「共用記憶」開啟。

Skills

設定 → Agent 與工作流程 →「Skills」列出每個 Skill,以及哪些 CLI 看得到它。

背景執行

以下都在免費版裡,位於 設定 → 一般設定 →「背景執行」。

用量與額度

用量表

Agent 額度用盡時

排程、任務中心與通知

備份與搬移設定

設定 → 一般設定 →「備份與搬移」,免費版就有。沒有雲端同步,檔案由你自己搬。

Pro 帳號、試用與 Pro 預覽

免費版不需要帳號。試用、Pro 預覽與 Pro 需要登入;帳號只用來授權,看不到你的專案或程式碼。帳號會保存哪些資料,請看隱私權政策。

登入

Pro 預覽與試用

兩台電腦

保持連線

試用、預覽或 Pro 結束時

Pyloxa 會回到免費版。執行中的工作會先做完,不會刪除任何資料、檔案或設定。Pro 的設定會暫停,並標示「需要 Pro,已暫停」;回到 Pro 時立即恢復。

資料放在哪裡,以及解除安裝

資料夾裡面有什麼
%APPDATA%\Pyloxa設定、紀錄與資料庫(pyloxa.sqlite3)、加密保存的 API Key 與授權(secrets.json)、Skills 與記憶的備份,以及試駕的範例專案
%LOCALAPPDATA%\Pyloxa\worktreesAgent 工作用的 git worktree
你的 repo名稱是 pyloxa/… 的工作分支,以及你合併進去的內容

Pyloxa 不會把這些資料夾的內容傳給我們。解除安裝前,先在系統匣圖示上結束 Pyloxa(關掉視窗它可能還在背景執行),再到 Windows 的 設定 → 應用程式,像其他 App 一樣解除安裝。解除安裝會保留上面兩個資料夾,重新安裝後可以接著用。要全部移除的話:

  1. 刪除 %APPDATA%\Pyloxa 與 %LOCALAPPDATA%\Pyloxa。
  2. 在用過的每個 repo 執行 git worktree prune,再刪掉不需要的 pyloxa/… 分支。
  3. 用過「同步到各 CLI」的話,從 AGENTS.md 與各 CLI 的記憶檔刪掉 Pyloxa 標記的區塊。CLI 本身與同步過去的 Skills 會留著。
  4. 登入過的話,在帳號頁刪除帳號,或寫信到 support@pyloxa.com 請我們刪除。

疑難排解

Windows 對安裝檔發出警告

請看「Windows 已保護您的電腦」。

防毒軟體擋下 Pyloxa 或 CLI

因為 App 還沒有程式碼簽章,有些防毒軟體會隔離安裝檔、不讓 Pyloxa 啟動,或擋下它啟動的 CLI。可能的樣子:安裝檔不見了、CLI 在終端機能用但 Pyloxa 顯示沒有安裝,或工作失敗並顯示「無法啟動 claude」(或 codex、gemini)。

CLI 顯示「無法派工」

工作因為錯誤停下來

登入或授權的問題

資料夾無法開成專案

Pyloxa 需要一個至少有一次 commit 的 git repo。先執行 git init 並做第一次 commit,再重新開啟資料夾。

回報問題

免費版與 Pro 一覽

功能免費版Pro
計畫、派工規則、worktree、驗證命令、Gate、大腦驗收有有
工作流程範本與自訂計畫階段有有
共用記憶、試駕、驗證報告卡、背景執行、用量表、設定備份有有
同時進行的專案一個多個,加上任務中心
一個計畫同時進行的工作兩個計畫內沒有上限
派工模式建議後詢問、僅依設定執行再加上授權範圍內自動
額度用盡時每次接手由你確認自動備援
交叉測試你按下時才測自動測試,失敗時交回修正
大腦一個最多三個備援大腦
我的流程、版本紀錄與用一句話建立流程匯入的流程照存有
Agent Teams(實驗)—有
排程計畫、專案優先序與額度分配等待中的工作在重設後繼續有
用量報表匯出每次執行的用量跨專案,Markdown 或 CSV
通知Windows 桌面通知再加上 Telegram、Discord、webhook
Skills盤點與檢視Skills 庫、同步、依專案指派
派工包讀取 repo 裡的 .pyloxa/匯入與匯出,可以帶我的流程
常用指令最多五個不限數量

這份說明目前有英文與繁體中文,官網其他語言之後再補。找不到答案的話,請寫信到 support@pyloxa.com。