clodex-ide：從 README 拆解 持久任務工作區
本機優先、零信任代理程式 IDE，用於可驗證的自主軟體開發。
秒懂
- 它是什麼？
- Local-first, zero-trust agentic IDE for verifiable autonomous software development. 本文聚焦 持久任務工作區與Community Observed 21 預覽版，並標出可核對的限制。
- 適合誰用？
- 適合需要直接研究 clodex-ide 並能依 README 設定環境的人；不適合把倉庫描述、統計或自報數字當成既定保證的場景。採用前先針對 mereyabdenbekuly-ctrl/clodex-ide 的 README 所列入口執行最小流程，記錄實際版本、設定鍵與輸出，再決定是否納入正式工作流。
- 可以商用嗎？
- 可以，但條件嚴格。AGPL-3.0 是網路 copyleft 授權：如果別人透過網路使用你修改過的版本（例如作為託管服務），你必須以同一授權向他們提供原始碼。
- 還在維護嗎？
- 有在維護。儲存庫最近一次提交在 5 天前。
- 用什麼語言寫的？
- 主要是 TypeScript（依據 GitHub 的語言統計）。
以上回答依據專案的 GitHub 資料（最近同步於 2026年9月14日）與我們的分析，不構成法律意見。
開源專案深度解析
持久任務工作區
本節只談 持久任務工作區，對 mereyabdenbekuly-ctrl/clodex-ide 的判斷以第 1 個觀察角度展開。（專案觀察 1-1）
CLODEx 是一個開源的、本地優先的智能體 IDE，面向長期工程工作。README 的核心觀點是，大多數 AI 程式設計介面圍繞下一條訊息設計，而真正的工程工作跨越多個步驟：理解程式碼庫、規劃變更、編輯檔案、執行命令、檢查應用程式、審查差異、從失敗中恢復並繼續後續工作。CLODEx 將這項工作視為持久任務而非一次性聊天。任務保留其工作區與歷史；檔案、Git、終端機、瀏覽器和 MCP 工具共享一個工作區；待處理的編輯、差異、命令輸出和審查仍然是任務的一部分。產品原則被直接陳述：'模型輸出是輸入，不是權威。'（專案觀察 1-2）
在 clodex-ide 的語境中，這個判斷要連同 持久任務工作區 一起閱讀。README 明確寫出的專案記號是 mereyabdenbekuly-ctrl/clodex-ide；未被 README 指定的執行緒、效能、安全保證或相容性，不在本文中補成既定能力。核對時可回到 mereyabdenbekuly-ctrl/clodex-ide 的 README，觀察對應命令、路徑、版本或輸出，並把結果與本文的事實描述分開。這樣讀者能知道第 1 節的事實邊界。（專案觀察 1-3）
針對 mereyabdenbekuly-ctrl/clodex-ide，可把這一節拆成幾個可觀察的問題：README 是否列出明確的安裝入口，命令是否指出必要的檔案或服務，輸入與輸出是否能在本機留下紀錄，失敗時是否有版本或設定線索可追。若文件只描述概念，本文就只把它寫成定位，不把概念延伸為承諾。若文件列出命令，測試範圍應限於該命令能證明的結果，例如安裝是否完成、指定資料是否被讀取、回傳格式是否符合說明，或特定工作流是否產生預期檔案。這些觀察都屬於 clodex-ide 的具體脈絡，不能用倉庫人氣替代。第 1 節也應與其他章節分開記錄，避免把某個環境的成功誤寫成所有平台都相同。（專案觀察 1-4）
針對 mereyabdenbekuly-ctrl/clodex-ide，可把這一節拆成幾個可觀察的問題：README 是否列出明確的安裝入口，命令是否指出必要的檔案或服務，輸入與輸出是否能在本機留下紀錄，失敗時是否有版本或設定線索可追。若文件只描述概念，本文就只把它寫成定位，不把概念延伸為承諾。若文件列出命令，測試範圍應限於該命令能證明的結果，例如安裝是否完成、指定資料是否被讀取、回傳格式是否符合說明，或特定工作流是否產生預期檔案。這些觀察都屬於 clodex-ide 的具體脈絡，不能用倉庫人氣替代。第 11 節也應與其他章節分開記錄，避免把某個環境的成功誤寫成所有平台都相同。（專案觀察 1-5）
Community Observed 21 預覽版
本節只談 Community Observed 21 預覽版，對 mereyabdenbekuly-ctrl/clodex-ide 的判斷以第 2 個觀察角度展開。（專案觀察 2-1）
倉庫目前指向一個名為 Community Observed 21 的免費技術預覽，作為不可變預發布版本 v1.16.0-communityobserved21 於 2026-07-29 發布。README 稱其由精確的規範原始碼 d2dd2b63077c67255d60b8ab53f5c3c0995c7f84 透過 GitHub Actions 執行 30483341383 建置，並通過了強制性的免費/受管與打包位元組閘道。免費產品範圍涵蓋持久任務、程式碼與審查、終端機與瀏覽器、模型、MCP、帳戶存取、語言與隱私以及分發。安裝程式提供用於 macOS Apple Silicon 和 Intel、Windows x64、Debian/Ubuntu x64 和 Fedora/RHEL x64。README 警告這些套件未簽署或採用臨時簽署：macOS 未經公證，Windows 未進行 Authenticode 簽署，Linux 套件不帶有 CLODEx 供應商簽章。它指示使用者驗證 SHA-256 並使用作業系統的逐應用程式審查流程。（專案觀察 2-2）
在 clodex-ide 的語境中，這個判斷要連同 Community Observed 21 預覽版 一起閱讀。README 明確寫出的專案記號是 mereyabdenbekuly-ctrl/clodex-ide；未被 README 指定的執行緒、效能、安全保證或相容性，不在本文中補成既定能力。核對時可回到 mereyabdenbekuly-ctrl/clodex-ide 的 README，觀察對應命令、路徑、版本或輸出，並把結果與本文的事實描述分開。這樣讀者能知道第 2 節的事實邊界。（專案觀察 2-3）
針對 mereyabdenbekuly-ctrl/clodex-ide，可把這一節拆成幾個可觀察的問題：README 是否列出明確的安裝入口，命令是否指出必要的檔案或服務，輸入與輸出是否能在本機留下紀錄，失敗時是否有版本或設定線索可追。若文件只描述概念，本文就只把它寫成定位，不把概念延伸為承諾。若文件列出命令，測試範圍應限於該命令能證明的結果，例如安裝是否完成、指定資料是否被讀取、回傳格式是否符合說明，或特定工作流是否產生預期檔案。這些觀察都屬於 clodex-ide 的具體脈絡，不能用倉庫人氣替代。第 2 節也應與其他章節分開記錄，避免把某個環境的成功誤寫成所有平台都相同。（專案觀察 2-4）
針對 mereyabdenbekuly-ctrl/clodex-ide，可把這一節拆成幾個可觀察的問題：README 是否列出明確的安裝入口，命令是否指出必要的檔案或服務，輸入與輸出是否能在本機留下紀錄，失敗時是否有版本或設定線索可追。若文件只描述概念，本文就只把它寫成定位，不把概念延伸為承諾。若文件列出命令，測試範圍應限於該命令能證明的結果，例如安裝是否完成、指定資料是否被讀取、回傳格式是否符合說明，或特定工作流是否產生預期檔案。這些觀察都屬於 clodex-ide 的具體脈絡，不能用倉庫人氣替代。第 12 節也應與其他章節分開記錄，避免把某個環境的成功誤寫成所有平台都相同。（專案觀察 2-5）
批准、差異與歷史
本節只談 批准、差異與歷史，對 mereyabdenbekuly-ctrl/clodex-ide 的判斷以第 3 個觀察角度展開。（專案觀察 3-1）
README 描述了一個流程：開發者請求導致代理提出計劃或操作，然後進行權限與批准檢查，然後本地工具或整合執行，最後差異、輸出、工件和任務歷史返回以供審查。公開原始碼包括明確的權限、批准、差異和審查介面。在安全方面，任務狀態和桌面工具預設在本地；網路存取僅用於使用者選擇的功能。CLODEx.xyz 登入使用狀態、PKCE S256、一次性不透明程式碼和精確的回環回呼，並且不記名權杖不會在回呼 URL 中返回。憑證使用應用程式受保護的儲存路徑，而不是渲染器本地儲存。遙測僅在使用者選擇允許或拒絕後開始，並且當允許時，它限於偽匿名事件，如安裝 ID、計數器、有界計時和平台中繼資料；Community Observed 合約排除了提示詞、訊息、原始碼、命令、路徑、URL、API 金鑰、工具引數、錯誤文字、回饋文字、工作階段錄製和 AI 追蹤。（專案觀察 3-2）
在 clodex-ide 的語境中，這個判斷要連同 批准、差異與歷史 一起閱讀。README 明確寫出的專案記號是 mereyabdenbekuly-ctrl/clodex-ide；未被 README 指定的執行緒、效能、安全保證或相容性，不在本文中補成既定能力。核對時可回到 mereyabdenbekuly-ctrl/clodex-ide 的 README，觀察對應命令、路徑、版本或輸出，並把結果與本文的事實描述分開。這樣讀者能知道第 3 節的事實邊界。（專案觀察 3-3）
針對 mereyabdenbekuly-ctrl/clodex-ide，可把這一節拆成幾個可觀察的問題：README 是否列出明確的安裝入口，命令是否指出必要的檔案或服務，輸入與輸出是否能在本機留下紀錄，失敗時是否有版本或設定線索可追。若文件只描述概念，本文就只把它寫成定位，不把概念延伸為承諾。若文件列出命令，測試範圍應限於該命令能證明的結果，例如安裝是否完成、指定資料是否被讀取、回傳格式是否符合說明，或特定工作流是否產生預期檔案。這些觀察都屬於 clodex-ide 的具體脈絡，不能用倉庫人氣替代。第 3 節也應與其他章節分開記錄，避免把某個環境的成功誤寫成所有平台都相同。（專案觀察 3-4）
針對 mereyabdenbekuly-ctrl/clodex-ide，可把這一節拆成幾個可觀察的問題：README 是否列出明確的安裝入口，命令是否指出必要的檔案或服務，輸入與輸出是否能在本機留下紀錄，失敗時是否有版本或設定線索可追。若文件只描述概念，本文就只把它寫成定位，不把概念延伸為承諾。若文件列出命令，測試範圍應限於該命令能證明的結果，例如安裝是否完成、指定資料是否被讀取、回傳格式是否符合說明，或特定工作流是否產生預期檔案。這些觀察都屬於 clodex-ide 的具體脈絡，不能用倉庫人氣替代。第 13 節也應與其他章節分開記錄，避免把某個環境的成功誤寫成所有平台都相同。（專案觀察 3-5）
四種模型連線
本節只談 四種模型連線，對 mereyabdenbekuly-ctrl/clodex-ide 的判斷以第 4 個觀察角度展開。（專案觀察 4-1）
CLODEx 支援四種連接路徑：透過 CLODEx.xyz 使用 CLODEx 帳戶登入；為支援的模型提供者自備金鑰；使用自訂的 OpenAI 相容端點；以及連接本地 Ollama，通常位於 http://localhost:11434。對於自備金鑰和自訂端點，README 指出提供者的條款、可用性和費用仍由使用者與所選提供者之間決定。它還警告不要在公開問題中包含 API 金鑰、權杖、私有原始碼或未經編輯的日誌。（專案觀察 4-2）
在 clodex-ide 的語境中，這個判斷要連同 四種模型連線 一起閱讀。README 明確寫出的專案記號是 mereyabdenbekuly-ctrl/clodex-ide；未被 README 指定的執行緒、效能、安全保證或相容性，不在本文中補成既定能力。核對時可回到 mereyabdenbekuly-ctrl/clodex-ide 的 README，觀察對應命令、路徑、版本或輸出，並把結果與本文的事實描述分開。這樣讀者能知道第 4 節的事實邊界。（專案觀察 4-3）
針對 mereyabdenbekuly-ctrl/clodex-ide，可把這一節拆成幾個可觀察的問題：README 是否列出明確的安裝入口，命令是否指出必要的檔案或服務，輸入與輸出是否能在本機留下紀錄，失敗時是否有版本或設定線索可追。若文件只描述概念，本文就只把它寫成定位，不把概念延伸為承諾。若文件列出命令，測試範圍應限於該命令能證明的結果，例如安裝是否完成、指定資料是否被讀取、回傳格式是否符合說明，或特定工作流是否產生預期檔案。這些觀察都屬於 clodex-ide 的具體脈絡，不能用倉庫人氣替代。第 4 節也應與其他章節分開記錄，避免把某個環境的成功誤寫成所有平台都相同。（專案觀察 4-4）
針對 mereyabdenbekuly-ctrl/clodex-ide，可把這一節拆成幾個可觀察的問題：README 是否列出明確的安裝入口，命令是否指出必要的檔案或服務，輸入與輸出是否能在本機留下紀錄，失敗時是否有版本或設定線索可追。若文件只描述概念，本文就只把它寫成定位，不把概念延伸為承諾。若文件列出命令，測試範圍應限於該命令能證明的結果，例如安裝是否完成、指定資料是否被讀取、回傳格式是否符合說明，或特定工作流是否產生預期檔案。這些觀察都屬於 clodex-ide 的具體脈絡，不能用倉庫人氣替代。第 14 節也應與其他章節分開記錄，避免把某個環境的成功誤寫成所有平台都相同。（專案觀察 4-5）
pnpm 建置與安全檢查
本節只談 pnpm 建置與安全檢查，對 mereyabdenbekuly-ctrl/clodex-ide 的判斷以第 5 個觀察角度展開。（專案觀察 5-1）
原始碼樹需要 Node.js 22.23.1、pnpm 10.30.3、Git 以及 macOS、Linux 或 Windows。README 中的設定順序是：複製倉庫，啟用 corepack 並準備固定版本的 pnpm，將 .env.example 複製到 .env 和 .env.dev，使用 pnpm install --frozen-lockfile 安裝，使用 pnpm build:packages 建置套件，然後使用 pnpm --dir apps/browser start:fast 啟動瀏覽器應用。受檢查的開發命令 pnpm --dir apps/browser start 會與 Electron 並行執行型別檢查。在開啟拉取請求之前，貢獻者應執行 pnpm check、pnpm typecheck、pnpm test 和 pnpm security:secrets。貢獻應是有範圍、可測試和可審查的，並且必須根據倉庫的 DCO 簽署提交。（專案觀察 5-2）
在 clodex-ide 的語境中，這個判斷要連同 pnpm 建置與安全檢查 一起閱讀。README 明確寫出的專案記號是 mereyabdenbekuly-ctrl/clodex-ide；未被 README 指定的執行緒、效能、安全保證或相容性，不在本文中補成既定能力。核對時可回到 mereyabdenbekuly-ctrl/clodex-ide 的 README，觀察對應命令、路徑、版本或輸出，並把結果與本文的事實描述分開。這樣讀者能知道第 5 節的事實邊界。（專案觀察 5-3）
針對 mereyabdenbekuly-ctrl/clodex-ide，可把這一節拆成幾個可觀察的問題：README 是否列出明確的安裝入口，命令是否指出必要的檔案或服務，輸入與輸出是否能在本機留下紀錄，失敗時是否有版本或設定線索可追。若文件只描述概念，本文就只把它寫成定位，不把概念延伸為承諾。若文件列出命令，測試範圍應限於該命令能證明的結果，例如安裝是否完成、指定資料是否被讀取、回傳格式是否符合說明，或特定工作流是否產生預期檔案。這些觀察都屬於 clodex-ide 的具體脈絡，不能用倉庫人氣替代。第 5 節也應與其他章節分開記錄，避免把某個環境的成功誤寫成所有平台都相同。（專案觀察 5-4）
針對 mereyabdenbekuly-ctrl/clodex-ide，可把這一節拆成幾個可觀察的問題：README 是否列出明確的安裝入口，命令是否指出必要的檔案或服務，輸入與輸出是否能在本機留下紀錄，失敗時是否有版本或設定線索可追。若文件只描述概念，本文就只把它寫成定位，不把概念延伸為承諾。若文件列出命令，測試範圍應限於該命令能證明的結果，例如安裝是否完成、指定資料是否被讀取、回傳格式是否符合說明，或特定工作流是否產生預期檔案。這些觀察都屬於 clodex-ide 的具體脈絡，不能用倉庫人氣替代。第 15 節也應與其他章節分開記錄，避免把某個環境的成功誤寫成所有平台都相同。（專案觀察 5-5）
AGPLv3 與上游血統
本節只談 AGPLv3 與上游血統，對 mereyabdenbekuly-ctrl/clodex-ide 的判斷以第 6 個觀察角度展開。（專案觀察 6-1）
CLODEx 最初是開源 Stagewise 程式碼庫的修改版本，現已發展為一個獨立維護的專案。確切的上游基礎提交、可重現的差異方法、CLODEx 特有的系統以及持續的上游衍生區域都在 CLODEx vs Stagewise 中有文件記錄。第三方聲明保留了上游版權和授權資訊。CLODEx 與 Stagewise 沒有關聯或認可。該專案以 GNU Affero General Public License v3.0 分發，該授權授予複製、分發和修改軟體的自由，並要求在網路上執行的修改版本向使用者提供其原始碼。授權文字還說明，除非另有規定，否則對工作不提供任何保固。README 強調，驗證報告證明了它實際檢查的內容，並不會將預覽變成穩定的產品。（專案觀察 6-2）
在 clodex-ide 的語境中，這個判斷要連同 AGPLv3 與上游血統 一起閱讀。README 明確寫出的專案記號是 mereyabdenbekuly-ctrl/clodex-ide；未被 README 指定的執行緒、效能、安全保證或相容性，不在本文中補成既定能力。核對時可回到 mereyabdenbekuly-ctrl/clodex-ide 的 README，觀察對應命令、路徑、版本或輸出，並把結果與本文的事實描述分開。這樣讀者能知道第 6 節的事實邊界。（專案觀察 6-3）
針對 mereyabdenbekuly-ctrl/clodex-ide，可把這一節拆成幾個可觀察的問題：README 是否列出明確的安裝入口，命令是否指出必要的檔案或服務，輸入與輸出是否能在本機留下紀錄，失敗時是否有版本或設定線索可追。若文件只描述概念，本文就只把它寫成定位，不把概念延伸為承諾。若文件列出命令，測試範圍應限於該命令能證明的結果，例如安裝是否完成、指定資料是否被讀取、回傳格式是否符合說明，或特定工作流是否產生預期檔案。這些觀察都屬於 clodex-ide 的具體脈絡，不能用倉庫人氣替代。第 6 節也應與其他章節分開記錄，避免把某個環境的成功誤寫成所有平台都相同。（專案觀察 6-4）
針對 mereyabdenbekuly-ctrl/clodex-ide，可把這一節拆成幾個可觀察的問題：README 是否列出明確的安裝入口，命令是否指出必要的檔案或服務，輸入與輸出是否能在本機留下紀錄，失敗時是否有版本或設定線索可追。若文件只描述概念，本文就只把它寫成定位，不把概念延伸為承諾。若文件列出命令，測試範圍應限於該命令能證明的結果，例如安裝是否完成、指定資料是否被讀取、回傳格式是否符合說明，或特定工作流是否產生預期檔案。這些觀察都屬於 clodex-ide 的具體脈絡，不能用倉庫人氣替代。第 16 節也應與其他章節分開記錄，避免把某個環境的成功誤寫成所有平台都相同。（專案觀察 6-5）
編輯結論
適合需要直接研究 clodex-ide 並能依 README 設定環境的人；不適合把倉庫描述、統計或自報數字當成既定保證的場景。採用前先針對 mereyabdenbekuly-ctrl/clodex-ide 的 README 所列入口執行最小流程，記錄實際版本、設定鍵與輸出，再決定是否納入正式工作流。本文所有判斷都繫於 clodex-ide 的具體命令與文件，不能移植成其他專案的通用結論。
社群筆記