改版紀錄

這一版來自在兩個真實專案（一個 .NET API、一個 React 網頁）上實測 Pyloxa，修正了實際工作時卡住的地方。

新功能

• Agent 可以自己確認成果：Claude Code 現在可以執行你在「驗證命令」核准的命令，例如安裝依賴、建置、測試，先確認再回報；其他命令照樣自動拒絕。以前所有命令都被拒絕，Agent 只能寫程式、不能執行。
• .NET、Gradle 與 Maven 專案的命令建議：「驗證命令」頁會為方案建議 dotnet build，並為每個測試專案各建議一個 dotnet test；Java 專案則建議使用專案自己的 Gradle 或 Maven wrapper。
• 驗證命令可以設定環境變數：例如重新產生快照的旗標。名稱看起來像金鑰或密碼的變數不會被儲存，也不能覆寫 PATH 等系統變數。
• Windows 上 .NET 專案的提醒：Windows 上 Codex 的沙箱無法還原 NuGet 套件，所以無法建置 .NET 專案。.NET 的工作派給 Codex 時，計畫預覽會說明這一點；按一下就能讓這個專案的後端工作改由 Claude Code 負責，Codex 留作備援。
• 不穩定的檢查會再跑一次：階段的 Gate 檢查沒通過時，Pyloxa 會先在同一個版本上再跑一次，仍然沒過才請 Agent 修正。

修正

• Windows 長路徑：資料夾很深的專案，核准計畫時不再出現「Filename too long」。Pyloxa 的 worktree 資料夾名稱也縮短了。
• git 錯誤更清楚：git 錯誤會顯示真正的原因，不再被進度輸出蓋過。核准計畫失敗時，錯誤會留在計畫卡上。
• 驗證紀錄的標題：在 pull request 裡，很長的目標不再從括號中間截斷，Agent 名稱也不再重複。

隱私與安全

• Agent 能執行的命令，就是你在「驗證命令」核准的那些。Pyloxa 驗收成果時本來就會在同一個 worktree 執行這些命令，所以 Agent 並沒有多出新的權限。
• 環境變數和命令一起存在你的電腦上，請不要放入金鑰或密碼。

升級

直接執行新的安裝檔覆蓋舊版即可。存在 %APPDATA%\Pyloxa 的執行紀錄、專案與設定都會保留。已經在執行的計畫會沿用原本的 worktree 資料夾。

已知限制

• 只支援 Windows 10 與 11（64 位元）。
• 安裝檔沒有程式碼簽章，SmartScreen 可能跳出警告；請按「其他資訊」，再按「仍要執行」。
• 不會自動更新。有新版本時 Pyloxa 會提示你。
• Codex 透過 codex exec 在它的沙箱內執行。在 Windows 上，這個沙箱通常無法建置專案或安裝套件，所以 Codex 的成果以你的驗證命令驗收。
• Gemini CLI 是實驗性支援：不能擔任大腦，在無人值守模式下也不能執行命令。
• 已測試 Claude Code 2.1.316–2.1.317、Codex CLI 0.166.0 與 Gemini CLI 0.42.0。

校驗碼

三個 Agent 一裝好就能分工，Gemini CLI 以實驗性功能加入，計畫也可以同時執行兩個工作。

新功能

• 三個 Agent 分工的預設流程：新安裝時，Claude Code 擔任大腦，負責前端與影片剪輯；Codex 負責後端與生圖；Gemini 負責文章與文件。某個 Agent 還沒設定時，它的工作交給大腦，計畫預覽會說明原因。每條規則都可以在「派工規則」頁修改或刪除。已經在用 Pyloxa 的話，到那裡按「套用預設流程」，原有的規則會保留。
• Gemini CLI（實驗性）：在「連線」頁用你自己的付費 Gemini API Key 連上 Gemini CLI，不支援 Google 帳號登入與 AI Pro、Ultra 訂閱。即使你自己的 Gemini 設定選了 Google 帳號登入，Pyloxa 也會讓 Gemini CLI 只用你的 API Key。Gemini 可以執行工作，不能擔任大腦。
• 同時執行兩個工作：一個計畫最多同時執行兩個互不依賴的工作，每個 CLI 最多同時兩個。會改到同一些檔案的工作會互相等待，計畫卡會說明它在等什麼。
• 第一個工作的引導：新對話會推薦一個範圍小的第一個工作，並說明流程。資料夾不是 git 專案或還沒有 commit 時，計畫預覽會在你核准前說明。
• 新版提示與桌面通知：有新版本時 Pyloxa 會提示你。Pyloxa 不在前景時，計畫擬好、工作等你處理、工作完成或失敗、大腦回覆、CLI 額度用盡，都會用 Windows 通知提醒你。兩者都可以在「設定」關閉。
• 版本警告變少：和已測試版本同系列的修補版（例如 Claude Code 2.1.x）不再顯示「未驗證版本」的警告。
• PR 說明附上驗證紀錄：建立 pull request 時，可以附上每個 Agent 成果實際經過的檢查：驗收命令、必要檔案、寫入範圍、階段檢查與核准者。沒有執行的檢查不會寫成通過。
• Skills 盤點：新的「Skills」頁列出各 CLI 讀得到的 Skills，並標示同名但內容不同的。
• 放在 repo 裡的團隊規則：Pyloxa 會讀取專案裡的 .pyloxa/rules.json 與 .pyloxa/commands.json。你會先看到預覽，規則要你選擇套用才會成為這個專案的規則，命令也照舊要你逐一核准。
• 使用統計與回報：「設定」頁顯示第一次成功、完成率、備援接手等次數，只在你的電腦計算。「複製診斷資訊」可以把版本與次數複製到問題回報。

隱私

• Pyloxa 啟動時和每 12 小時會向 GitHub 查詢最新版本。只送出這個查詢，不含任何專案或使用資料。可以在「設定 → 通知與更新」關閉。
• 「Skills」頁會讀取各 CLI 的 Skills 資料夾（~/.agents/skills、~/.claude/skills、~/.codex/skills、~/.gemini/skills）與開啟中專案的 Skills 資料夾，不讀取這些 CLI 資料夾裡的其他內容，也不做任何修改。
• 使用統計只在你的電腦計算，不會傳送。診斷資訊不含專案名稱、路徑、指示、程式碼、帳號或金鑰，只有你自己貼到其他地方時才會離開你的電腦。

升級

直接執行新的安裝檔覆蓋舊版即可。存在 %APPDATA%\Pyloxa 的執行紀錄與專案會保留。原本的設定不會自動加入預設流程；想要的話，到「派工規則」頁按「套用預設流程」。

已知限制

• 只支援 Windows 10 與 11（64 位元）。
• 安裝檔沒有程式碼簽章，SmartScreen 可能跳出警告；請按「其他資訊」，再按「仍要執行」。
• 不會自動更新。有新版本時 Pyloxa 會提示你，請到版本頁下載。
• Codex 透過 codex exec 在它的沙箱內執行，無法逐一核准單一動作。
• Gemini CLI 是實驗性支援：不能擔任大腦，也不能接續上一次的 session。Gemini CLI 在無人值守模式下不提供執行命令的工具，所以 Gemini 可以修改檔案，但不能執行命令。
• 已測試 Claude Code 2.1.316–2.1.317、Codex CLI 0.166.0 與 Gemini CLI 0.42.0。同系列的其他修補版不會顯示警告；換到新的系列時只能用監督模式，輸出格式也可能不同。
• 同時執行兩個工作是新功能，已經用 Claude Code 與 Codex CLI 實際測試過；如果遇到異常，請回報給我們。

校驗碼

第一次使用更容易上手，也可以改用自己的 API Key，不一定要訂閱。

新功能

• 入門引導：沒有任何 Agent CLI 可以使用時，首頁與對話中會說明要安裝什麼，提供可以複製到終端機的官方登入指令（claude auth login 或 codex login），回到 Pyloxa 時自動重新偵測。
• API Key 連線：在「連線」頁可以把 Claude Code 或 Codex 改成用你自己的 API Key，用量按次計費、記在你的 API 帳單，不會用到訂閱額度。Pyloxa 以 Windows 的安全儲存（DPAPI）加密金鑰，只交給執行工作的 CLI 程序，介面只顯示最後 4 碼。改回訂閱時會刪除保存的金鑰。
• 連線問題說得更清楚：側欄、Agent 設定與對話中，會顯示真正擋住派工的問題，例如「未登入」，而不是「版本未驗證」。
• 重新偵測找得到剛安裝的 CLI：重新偵測時會重新讀取 PATH，安裝 CLI 之後不必重開 Pyloxa。
• 大腦不能用時：輸入框上方會說明原因，並提供處理方式的連結；送不出去的訊息會留下原因。

升級

直接執行新的安裝檔覆蓋舊版即可。存在 %APPDATA%\Pyloxa 的執行紀錄與專案會保留。

已知限制

• 只支援 Windows 10 與 11（64 位元）。
• 安裝檔沒有程式碼簽章，SmartScreen 可能跳出警告；請按「其他資訊」，再按「仍要執行」。
• 不會自動更新，新版本請到版本頁下載。
• 同一時間只有一個 Agent 工作。
• Codex 透過 codex exec 在它的沙箱內執行，無法逐一核准單一動作。
• 已測試 Claude Code 2.1.316 與 Codex CLI 0.166.0。較新的版本只能用監督模式，輸出格式也可能不同。

校驗碼

Pyloxa Windows 版的第一個免費版本。

功能

• 一段對話：告訴大腦（Claude Code 或 Codex）你想做什麼。它會先讀過專案，不清楚時先發問，再直接回答或提出分成階段與工作的計畫。
• 派工規則：由你的規則決定每個工作交給哪個 Agent。每個工作都會標出命中的規則、派工理由與備援；規則頁可以在不呼叫 Agent 的情況下模擬派工。
• 隔離的工作環境：每個會寫入的工作都在自己的 git worktree 執行。Pyloxa 不會對你的工作目錄執行 stash、reset 或 checkout。
• 驗證命令：核准 npm run test 這類命令、先試跑，再讓工作執行。檢查全部通過、而且不需要審查的工作會自動接受；沒通過的工作會自動修正一次。
• 階段 Gate：每個階段結束時，在整合後的成果上執行 Gate 命令。計畫會自動往下走，或等你核准；Gate 沒通過時會自動新增一個修正工作。
• 額度用盡時：CLI 回報用量上限時，Pyloxa 會把那個連線標為受限、顯示重設時間，並停止派工給它。你可以確認由備援 Agent 從前一個 Agent 的成果接著做，或等額度恢復後自動重試。限流與網路錯誤會自動重試一次。
• 用量：每個工作與整個計畫的 token 用量。
• 重啟核對：如果 Pyloxa 在工作進行中結束，下次啟動時會停止殘留的 CLI 程序、保留已完成的部分，並請你核對。
• 工作區：瀏覽與搜尋檔案、編輯 Markdown 並即時預覽、查看差異、提交、分支、推送與拉取，並透過 gh 開 pull request。
• 語言與主題：English、繁體中文、简体中文，以及淺色、深色與多種色彩主題。

已知限制

• 只支援 Windows 10 與 11（64 位元）。
• 安裝檔沒有程式碼簽章，SmartScreen 可能跳出警告；請按「其他資訊」，再按「仍要執行」。
• 不會自動更新，新版本請到版本頁下載。
• 同一時間只有一個 Agent 工作。
• Codex 透過 codex exec 在它的沙箱內執行，無法逐一核准單一動作。
• 已測試 Claude Code 2.1.316 與 Codex CLI 0.166.0。其他版本也許可以用，但輸出格式可能不同。

校驗碼