mereyabdenbekuly-ctrl/clodex-ide

# Clodex ### 具备受控执行的本地优先智能体 IDE [](https://ide.clodex.xyz)  [](./LICENSE)   [](https://x.com/CLODEx_lab) Clodex 是一个开源的智能体开发环境，它将持久化的 AI 任务、代码、终端、浏览器、Git、模型、内存以及受控的执行结合在一个 Electron 工作区中。 这是一个早期阶段、由个人主导的研究和工程项目。当前的技术预览版旨在验证架构和实际工作流；它并非作为一个生产成熟的 IDE 或一个成熟的社区来呈现。 它围绕着一个简单的原则构建： **当前发布状态：** 技术预览版。架构核心已在本地实现并经过测试。高级执行通道仍处于功能门控状态，直到它们的实时推广证据和手动签核完成。 ## 从这里开始 | 目标 | 文档 | | --------------------------------------- | --------------------------------------------------------------------------------------------- | | 花几分钟了解产品 | [产品概述](./short_doc.en.md) · [Русский обзор](./short_doc.md) | | 在本地运行 Clodex | [开发者手册](./DEVELOPERS.md) | | 研究完整系统 | [完整项目文档](./full_doc.md) | | 浏览工程文档 | [开发者文档索引](./docs/developer/README.md) | | 查看架构 | [架构](./docs/developer/architecture.md) | | 查看安全性和数据处理 | [安全与数据](./docs/developer/security-and-data.md) · [安全策略](./SECURITY.md) | | 了解项目血统 | [Clodex 与 Stagewise 上游](./CLODEX_VS_UPSTREAM.md) | | 贡献或协作 | [贡献指南](./CONTRIBUTING.md) · [协作路径](./COLLABORATE.md) | | 了解项目治理 | [治理](./GOVERNANCE.md) · [行为准则](./CODE_OF_CONDUCT.md) | | 跟踪独立内核迁移 | [混合绞杀者计划](./docs/migration/README.md) | | 探索在线项目 | [ide.clodex.xyz](https://ide.clodex.xyz) |

## 项目血统 Clodex 最初是开源 Stagewise 代码库的修改版本，后来分化为一个独立维护的项目，专注于受控执行、证据、策略强制执行、模型路由、运行器隔离和会话连续性。 确切的上游基础提交、可复现的 diff 方法、Clodex 特有的系统以及持续派生自上游的区域均记录在 [`CLODEX_VS_UPSTREAM.md`](./CLODEX_VS_UPSTREAM.md) 中。上游的版权和许可证声明保留在 [`THIRD-PARTY-NOTICES.md`](./THIRD-PARTY-NOTICES.md) 中。Clodex 不隶属于 Stagewise，也未获得其认可。 ## 为什么选择 Clodex 传统的编码助手只能生成下一个答案或补丁。而 Clodex 将工程工作建模为一个具有自身状态、工作区、进程、权限、证据和审查生命周期的持久任务。 一个任务可以： 1. 在长时间运行的工作和应用重启期间保留上下文； 2. 跨越文件、Git、终端、浏览器标签页、MCP 工具和运行器进行操作； 3. 在不改变周围工作流的情况下，在模型之间路由工作； 4. 在执行高影响力的 shell、网络、浏览器或远程操作之前请求批准； 5. 在本地执行或移动到 Docker、SSH 或云端支持的环境； 6. 返回 diff、回执、构建产物和独立完整的结果。 ## 核心能力 | 领域 | Clodex 提供的内容 | | -------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | | **持久化任务** | 可搜索的任务历史、项目、工作区、分支、目标、进度、token 预算和时间预算。 | | **Agent runtime** | 受管理的对话轮次、取消、恢复、协作模式、工具执行和受监督的生命周期处理。 | | **代码工作区** | 文件编辑、待定编辑、行级 diff、Git 操作、工作树、Pull Request 审查和受保护的合并流程。 | | **终端和浏览器** | 持久化的 shell 会话、本地端口、浏览器/CDP 上下文、控制台输出、屏幕截图和可视化验证。 | | **证据支持的内存** | 作用域内存、仅追加的证据记录、检索、出处、检查点和有界的上下文注入。 | | **Model Fabric** | 提供商中立的模型路由、endpoint 健康状况、降级方案、预算控制、使用量统计和策略发布。 | | **Execution Fabric** | 本地执行、SSH 会话、Docker 运行器、自定义运行器契约、云端任务基础和可移植的快照。 | | **Guardian** | 针对敏感功能的独立授权决策、失败即停止（fail-closed）结果、审批升级和审计事件。 | | **网络策略** | 目标授权、DNS 验证、受控的浏览器访问、MCP 出站执行和审计账本。 | | **扩展** | MCP 服务器、技能、签名的插件、私有市场、运行器 SDK 和能力受限的生成应用。 | | **连续性** | 会话检查点、崩溃恢复、内存同步、构建产物捕获和实验性的会话瞬移。 | ## 架构 Clodex 将用户界面、Agent 执行、工具、机密信息和策略分离到明确的进程和信任边界中。 ``` flowchart TB USER["Developer"] --> UI["Electron renderer"] UI <--> IPC["Karton typed IPC"] IPC <--> MAIN["Electron main process"] MAIN <--> AGENT_HOST["Agent Host process"] MAIN <--> MCP_HOST["MCP Host process"] MAIN <--> SANDBOX["Sandbox workers"] AGENT_HOST --> CORE["Agent Core"] CORE --> TASKS["Task lifecycle and goals"] CORE --> MEMORY["Evidence memory and context ledger"] CORE --> FABRIC["Model Fabric"] CORE --> POLICY["Guardian and Zero-Trust policy"] POLICY --> EXECUTION["Local, SSH, Docker, or cloud execution"] EXECUTION --> ARTIFACTS["Artifacts, receipts, and checkpoints"] ARTIFACTS --> MEMORY ``` ### 重要包 ``` apps/browser/ Electron desktop application apps/website/ Public project website agent/runtime-node/ Isolated Node.js agent runtime packages/agent-core/ Agent lifecycle, memory, routing, and policy packages/agent-shell/ Shell and execution contracts packages/clodex-contracts/ Shell-independent Stage 0 kernel contracts packages/mcp-runtime/ MCP transport and protocol runtime packages/runner-sdk/ External runner integration SDK packages/karton/ Typed state and RPC transport packages/stage-ui/ Shared interface components ``` 有关完整的映射，请参阅 [`docs/developer/repository-map.md`](./docs/developer/repository-map.md)。 ## 安全模型 Clodex 不依赖于通过 prompt 要求模型安全行事。敏感操作将通过模型 runtime 之外的确定性控制。 - **失败即停止：** 模糊或无效的授权结果将不会执行。 - **隔离的主机：** Agent 轮次、MCP 服务器和沙盒化的工作负载在渲染器之外运行。 - **显式能力：** 拥有工具并不自动授予使用它的权限。 - **受控出站流量：** 网络目的地的评估独立于模型意图。 - **受保护的存储：** 凭证使用操作系统支持的存储；敏感的任务构建产物使用绑定上下文的认证加密。 - **人工审查：** 待处理的编辑、权限提示、受保护的合并流程和高影响力的审批将最终决定权交还给用户。 - **供应链检查：** 在激活之前，会验证扩展身份、签名、完整性、兼容性、回滚和隔离机制。 - **隐私感知审计：** 操作事件避免存储 prompt、源代码、音频、凭证或其他不必要的敏感内容。 在 [`docs/developer/security-and-data.md`](./docs/developer/security-and-data.md) 中阅读详细模型。 通过 [`SECURITY.md`](./SECURITY.md) 报告漏洞，而不要通过公开 issue 报告。 ## 能力状态 | 能力 | 状态 | | ---------------------------------------------------- | ------------------------------- | | 桌面工作区、文件、Git、终端和浏览器 | **可用于本地测试** | | 任务生命周期、目标、作用域内存和恢复 | **可用于本地测试** | | MCP runtime 和隔离的 Agent Host | **可用于本地测试** | | 本地和 SSH 执行 | **可用于本地测试** | | Docker 和外部运行器控制平面 | **预览版** | | Guardian 和受管理的网络出站流量 | **预览版** | | 签名的扩展和生成的应用 | **预览版** | | 云端任务和会话瞬移 | **实验室 / 受推广门控** | | 稳定的跨平台分发 | **等待推广证据** | 这些状态标签是经过深思熟虑的：在完成实际的安装证据、监控、回滚和手动推广检查之前，已实现的基础功能并不会作为稳定的生产能力进行展示。 ## 从源码运行 ### 要求 - Node.js `22.23.1` - pnpm `10.30.3` - Git - macOS、Linux 或 Windows（用于开发） - macOS（用于 DMG 打包和公证） ### 设置 ``` git clone https://github.com/mereyabdenbekuly-ctrl/clodex-ide.git cd clodex-ide corepack enable corepack prepare pnpm@10.30.3 --activate cp .env.example .env cp .env.example .env.dev pnpm install --frozen-lockfile pnpm build:packages pnpm --dir apps/browser start:fast ``` 当你希望在运行 Electron 的同时并行执行类型检查时，请使用已检查的开发命令： ``` pnpm --dir apps/browser start ``` 环境和提供商配置记录在 [`docs/developer/local-development.md`](./docs/developer/local-development.md) 中。 切勿提交 `.env`、凭证、签名密钥或本地 runtime 状态。 ## 验证 在发起 Pull Request 之前，请运行完整的本地验证套件： ``` pnpm check pnpm typecheck pnpm test pnpm security:secrets ``` **2026 年 7 月 12 日** 验证的基准： | 门控 | 结果 | | ------------------------ | ---------------: | | 包构建 | `7 / 7` | | 类型检查任务 | `14 / 14` | | 测试任务 | `16 / 16` | | 自动化测试 | `3,322 passed` | | 工作区机密扫描 | `0 findings` | | 网站生产环境构建 | `passed` | | 桌面端启动冒烟测试 | `passed` | | 主计划就绪状态 | `ready=true` | | 稳定版推广 | `evidence-gated` | CI 和签名发布证据仍然是已发布构建产物的真实来源。请参阅 [`docs/developer/testing-and-release.md`](./docs/developer/testing-and-release.md) 和 [`VERSIONING.md`](./VERSIONING.md)。 ## 扩展 Clodex Clodex 暴露了多种集成接口： - **MCP：** 连接本地 stdio 或远程 Streamable HTTP/SSE 服务器； - **技能：** 打包可复用的 Agent 指令和工作流； - **插件：** 分发已签名的功能和可选的可执行 runtime； - **运行器 SDK：** 集成 Docker、SSH、集群或自定义执行后端； - **生成的应用：** 创建具有显式授权的任务专属交互工具； - **自动化：** 调度具有声明能力的受限任务。 从 [`docs/developer/extensions-and-integrations.md`](./docs/developer/extensions-and-integrations.md) 开始。 ## 支持独立开发 如果 Clodex 对您有用，当前的支持选项及其条款列在 [Clodex 网站](https://ide.clodex.xyz/#support) 上。资金支持并不换取路线图优先权、仓库访问权限或合并决定。 ## 许可证 Clodex 采用 [GNU Affero General Public License v3.0](./LICENSE) 进行分发。 第三方组件和声明列在 [`THIRD-PARTY-NOTICES.md`](./THIRD-PARTY-NOTICES.md) 中。

标签：AI编程, Electron, MITM代理, SOC Prime, 开发工具, 本地优先, 自动化攻击, 请求拦截, 集成开发环境