Compozy：以守護行程組織代理工作流

本地守護行程為代理工作提供持久空間

CompozyOS 定位為代理工作的作業系統。它以一個本地守護行程為核心，負責管理工作階段、任務、迴圈、記憶、權限、自動化和工具。README 描述稱工作不會因終端關閉而丟失，因為守護行程持有執行時期狀態。使用者可透過 Web 介面和 CLI 檢視與控制，代理則透過結構化 HTTP、UDS、MCP 和原生工具介面存取同一狀態。除非設定了外部提供方或擴充，狀態預設儲存在操作者機器上的 SQLite 資料庫中。這是預設的本地優先設計，README 未提及任何雲端元件。

閱讀 compozy/compozy 時，先把 README 中的名詞和操作入口分開整理。compozy 的描述指出了實際用途，但沒有替讀者承諾所有部署情境都相同。使用者應以文件列出的檔名、命令、資料夾或設定鍵作為觀察點，記下命令的輸入、產生的輸出，以及失敗時顯示的錯誤。這樣才能把專案的宣稱和本機真正看到的行為放在同一張表上。對於版本、平台或外部服務，README 沒有交代的部分就維持未知，不把推測寫成能力。compozy/compozy 的授權與維護資訊也要和使用範圍一起看：可以如何使用，取決於授權文字；能否長期維護，則取決於文件是否說明更新、測試與相依項目。這篇文章只整理已提供的材料，方便讀者回到 compozy/compozy 的具體入口核對。

閱讀 compozy/compozy 時，先把 README 中的名詞和操作入口分開整理。compozy 的描述指出了實際用途，但沒有替讀者承諾所有部署情境都相同。使用者應以文件列出的檔名、命令、資料夾或設定鍵作為觀察點，記下命令的輸入、產生的輸出，以及失敗時顯示的錯誤。這樣才能把專案的宣稱和本機真正看到的行為放在同一張表上。對於版本、平台或外部服務，README 沒有交代的部分就維持未知，不把推測寫成能力。compozy/compozy 的授權與維護資訊也要和使用範圍一起看：可以如何使用，取決於授權文字；能否長期維護，則取決於文件是否說明更新、測試與相依項目。這篇文章只整理已提供的材料，方便讀者回到 compozy/compozy 的具體入口核對。 本段核對焦點是「本地守護行程為代理工作提供持久空間」。

v0.3 測試線取代 v0.2.15

README 將 v0.3 標記為測試版，並指出之前的 v0.2.15 已棄用，僅在 legacy/v0.2 分支上維護關鍵修復。文件中的測試版本為 v0.3.0-beta.2。安裝方式包括經過驗證的安裝程式（會校驗 Sigstore 來源）、npm 套件 @compozy/cli@beta、Go 的明確版本標籤，以及從原始碼建置。Homebrew 在測試視窗期仍提供棄用的 v0.2 版本，因此 README 未將其列入。從 v0.2 遷移的使用者應先閱讀遷移指南。

閱讀 compozy/compozy 時，先把 README 中的名詞和操作入口分開整理。compozy 的描述指出了實際用途，但沒有替讀者承諾所有部署情境都相同。使用者應以文件列出的檔名、命令、資料夾或設定鍵作為觀察點，記下命令的輸入、產生的輸出，以及失敗時顯示的錯誤。這樣才能把專案的宣稱和本機真正看到的行為放在同一張表上。對於版本、平台或外部服務，README 沒有交代的部分就維持未知，不把推測寫成能力。compozy/compozy 的授權與維護資訊也要和使用範圍一起看：可以如何使用，取決於授權文字；能否長期維護，則取決於文件是否說明更新、測試與相依項目。這篇文章只整理已提供的材料，方便讀者回到 compozy/compozy 的具體入口核對。 本段核對焦點是「v0.3 測試線取代 v0.2.15」。

守護行程擁有工作階段、任務、迴圈、記憶和權限

執行時期模型以 home 作用域的守護行程為中心。使用者和代理透過公共控制介面傳送命令，守護行程解析工作區、套用權限和執行時期政策、協調 ACP 代理，並持久化事件和資源狀態。工作階段、任務、迴圈執行、記憶、自動化、工具和 Compozy 網路活動都有明確的擁有者和工作區邊界。結構化 CLI 輸出（-o json）、HTTP/SSE、UDS、MCP 和原生工具都暴露同一守護行程持有的狀態。README 強調 Web 和串流用戶端不維護平行模型，而是讀取同一狀態。

閱讀 compozy/compozy 時，先把 README 中的名詞和操作入口分開整理。compozy 的描述指出了實際用途，但沒有替讀者承諾所有部署情境都相同。使用者應以文件列出的檔名、命令、資料夾或設定鍵作為觀察點，記下命令的輸入、產生的輸出，以及失敗時顯示的錯誤。這樣才能把專案的宣稱和本機真正看到的行為放在同一張表上。對於版本、平台或外部服務，README 沒有交代的部分就維持未知，不把推測寫成能力。compozy/compozy 的授權與維護資訊也要和使用範圍一起看：可以如何使用，取決於授權文字；能否長期維護，則取決於文件是否說明更新、測試與相依項目。這篇文章只整理已提供的材料，方便讀者回到 compozy/compozy 的具體入口核對。 本段核對焦點是「守護行程擁有工作階段、任務、迴圈、記憶和權限」。

組態分為三層：旗標、工作區和全域

全域預設值位於 ~/.compozy/config.toml，工作區可透過 .compozy/config.toml 覆蓋支援的欄位。優先序為明確的命令列旗標、工作區組態、全域組態、內建預設值。README 提供了顯示組態路徑、驗證和以 JSON 顯示有效組態的命令。它也警告組態、憑證和提供方 home 政策有不同的擁有者，建議遵循組態指南，而不是將 v0.2 狀態複製到 v0.3 的 home 中。

閱讀 compozy/compozy 時，先把 README 中的名詞和操作入口分開整理。compozy 的描述指出了實際用途，但沒有替讀者承諾所有部署情境都相同。使用者應以文件列出的檔名、命令、資料夾或設定鍵作為觀察點，記下命令的輸入、產生的輸出，以及失敗時顯示的錯誤。這樣才能把專案的宣稱和本機真正看到的行為放在同一張表上。對於版本、平台或外部服務，README 沒有交代的部分就維持未知，不把推測寫成能力。compozy/compozy 的授權與維護資訊也要和使用範圍一起看：可以如何使用，取決於授權文字；能否長期維護，則取決於文件是否說明更新、測試與相依項目。這篇文章只整理已提供的材料，方便讀者回到 compozy/compozy 的具體入口核對。 本段核對焦點是「組態分為三層：旗標、工作區和全域」。

代理、技能和記憶是作用域化的資源

代理定義位於 ~/.compozy/agents/<name>/ 或 .compozy/agents/<name>/，每個定義包含 AGENT.md 和可選的代理本地 mcp.json。工作區定義會整體覆蓋全域定義。技能是守護行程發現的資源，具有明確的來源和作用域，可透過技能和市場命令檢查。工作流記憶是持久的、作用域化的、由守護行程持有的；代理可以透過與使用者相同的公共契約檢查、提議和整合記憶。README 指出 v0.2 的工作流記憶檔案仍然是普通儲存庫工件，不會作為隱藏執行時期狀態匯入。

閱讀 compozy/compozy 時，先把 README 中的名詞和操作入口分開整理。compozy 的描述指出了實際用途，但沒有替讀者承諾所有部署情境都相同。使用者應以文件列出的檔名、命令、資料夾或設定鍵作為觀察點，記下命令的輸入、產生的輸出，以及失敗時顯示的錯誤。這樣才能把專案的宣稱和本機真正看到的行為放在同一張表上。對於版本、平台或外部服務，README 沒有交代的部分就維持未知，不把推測寫成能力。compozy/compozy 的授權與維護資訊也要和使用範圍一起看：可以如何使用，取決於授權文字；能否長期維護，則取決於文件是否說明更新、測試與相依項目。這篇文章只整理已提供的材料，方便讀者回到 compozy/compozy 的具體入口核對。 本段核對焦點是「代理、技能和記憶是作用域化的資源」。

擴充透過宣告的執行時期契約接入

擴充透過宣告的提供表面新增版本化資源和執行時期行為。守護行程擁有發現、啟用、信任決策、生命週期和鉤子，因此擴充不會繞過公共執行時期契約。README 展示了三條命令的範例：init、dev 和 tool invoke。編寫是程式碼優先的：在程式碼中宣告一次工具，然後 compozy extension build 產生清單。兩個 SDK 已發布：npm 上的 @compozy/extension-sdk 和 github.com/compozy/compozy/sdk/go，均與守護行程版本匹配。擴充 CLI 命令可以列出、檢視狀態、顯示來源和追蹤日誌。

閱讀 compozy/compozy 時，先把 README 中的名詞和操作入口分開整理。compozy 的描述指出了實際用途，但沒有替讀者承諾所有部署情境都相同。使用者應以文件列出的檔名、命令、資料夾或設定鍵作為觀察點，記下命令的輸入、產生的輸出，以及失敗時顯示的錯誤。這樣才能把專案的宣稱和本機真正看到的行為放在同一張表上。對於版本、平台或外部服務，README 沒有交代的部分就維持未知，不把推測寫成能力。compozy/compozy 的授權與維護資訊也要和使用範圍一起看：可以如何使用，取決於授權文字；能否長期維護，則取決於文件是否說明更新、測試與相依項目。這篇文章只整理已提供的材料，方便讀者回到 compozy/compozy 的具體入口核對。 本段核對焦點是「擴充透過宣告的執行時期契約接入」。

快速開始與開發工作流

快速開始透過 compozy install 引導 home，啟動守護行程，並在目前目錄建立持久工作階段。README 警告 Go 的 @latest 仍解析到 v0.2 版本，因此需要明確版本。開發是一個 Go 和 Bun 的 monorepo；make dev 啟動帶自動 Go 重建的守護行程和帶 Vite HMR 的 Web UI，而 make verify 執行完整的儲存庫門禁。CLI 參考是產生的，對動詞、旗標、結構化輸出和退出行為具有權威性。貢獻指南要求公共行為保持代理可管理，並在傳送變更前執行 make verify。授權是 MIT，授予使用、複製、修改、合併、發布、分發、再授權和銷售副本的權限，但軟體按「原樣」提供，不提供任何擔保。

閱讀 compozy/compozy 時，先把 README 中的名詞和操作入口分開整理。compozy 的描述指出了實際用途，但沒有替讀者承諾所有部署情境都相同。使用者應以文件列出的檔名、命令、資料夾或設定鍵作為觀察點，記下命令的輸入、產生的輸出，以及失敗時顯示的錯誤。這樣才能把專案的宣稱和本機真正看到的行為放在同一張表上。對於版本、平台或外部服務，README 沒有交代的部分就維持未知，不把推測寫成能力。compozy/compozy 的授權與維護資訊也要和使用範圍一起看：可以如何使用，取決於授權文字；能否長期維護，則取決於文件是否說明更新、測試與相依項目。這篇文章只整理已提供的材料，方便讀者回到 compozy/compozy 的具體入口核對。 本段核對焦點是「快速開始與開發工作流」。

採用 compozy 前的具體核對

可從 compozy/compozy 的 README 入口開始，依文件指定的命令或檔案逐項核對輸入與輸出。對資料型專案，先確認檔案結構與欄位；對工具或技能，先確認安裝位置、版本與實際產物。這些檢查只針對 compozy 已公開的內容，README 未說明的行為不作推論。

閱讀 compozy/compozy 時，再把 README 中的名詞和操作入口分開整理。compozy 的描述指出了實際用途，但沒有替讀者承諾所有部署情境都相同。使用者應以文件列出的檔名、命令、資料夾或設定鍵作為觀察點，記下命令的輸入、產生的輸出，以及失敗時顯示的錯誤。這樣才能把專案的宣稱和本機真正看到的行為放在同一張表上。對於版本、平台或外部服務，README 沒有交代的部分就維持未知，不把推測寫成能力。compozy/compozy 的授權與維護資訊也要和使用範圍一起看：可以如何使用，取決於授權文字；能否長期維護，則取決於文件是否說明更新、測試與相依項目。這篇文章只整理已提供的材料，方便讀者回到 compozy/compozy 的具體入口核對。

閱讀 compozy/compozy 時，先把 README 中的名詞和操作入口分開整理。compozy 的描述指出了實際用途，但沒有替讀者承諾所有部署情境都相同。使用者應以文件列出的檔名、命令、資料夾或設定鍵作為觀察點，記下命令的輸入、產生的輸出，以及失敗時顯示的錯誤。這樣才能把專案的宣稱和本機真正看到的行為放在同一張表上。對於版本、平台或外部服務，README 沒有交代的部分就維持未知，不把推測寫成能力。compozy/compozy 的授權與維護資訊也要和使用範圍一起看：可以如何使用，取決於授權文字；能否長期維護，則取決於文件是否說明更新、測試與相依項目。這篇文章只整理已提供的材料，方便讀者回到 compozy/compozy 的具體入口核對。 本段核對焦點是「採用 compozy 前的具體核對」。

編輯結論

v0.3 測試線是當前路徑，v0.2 已棄用。README 明確守護行程持有執行時期狀態，擴充必須遵守公開契約。MIT 授權給予通常的複製、修改、分發權限，但不提供任何擔保。

官方來源

1. Official documentation
2. Official README
3. Project repository
4. Release notes