把本机 Codex CLI 变成一个中文、多项目、可追踪、能远程控制的桌面开发工作台。
xxzzaacode 不是另一套 AI 模型，也不需要再接一层模型 API。它直接连接你已经安装并
登录的本机 codex app-server，保留 Codex 的执行能力，再补上项目管理、多会话、
任务进度、附件预览、结果交付、自动验收、Worktree 协作和飞书远程控制。
项目目前处于 Beta 阶段，版本为 0.9.23。源码已通过 132 项自动化测试、 Electron 启动与交互冒烟测试，以及 macOS arm64 应用构建验证。
非官方声明： xxzzaacode 是社区项目，并非 OpenAI 官方产品，也不隶属于 OpenAI。Codex、OpenAI 及相关标识属于其各自权利人。
项目、对话、执行结果和任务状态集中在同一界面；点击图片可查看原尺寸。
在长对话中按要求、最终回复、失败记录和交付文件快速定位。以上截图由内置演示模式 生成，项目名称、路径、任务内容和文件均为虚构数据。
Codex CLI 很强，但同时处理多个项目和长任务时，终端并不总是最直观。xxzzaacode 把高频开发动作集中在一个桌面界面里：
| 开发场景 | xxzzaacode 提供的体验 |
|---|---|
| 多个项目同时开发 | 按项目分组对话，后台任务独立运行，切换时不打断任务 |
| 不知道任务是否卡住 | 汇总任务阶段、最近事件、耗时、完成状态和异常状态 |
| 对话太长、结果难找 | 结果优先视图，文件、图片、引用和失败记录单独呈现 |
| 任务完成后反复手动验证 | 按项目识别测试、Lint、类型检查和构建命令 |
| AI 改坏代码不敢继续 | 每轮快照、Git Diff 和 Worktree 隔离降低回退成本 |
| 不在电脑旁仍需跟进 | 通过飞书私聊查看任务、补充要求、停止任务和接收结果 |
| 图片和文件只能看到路径 | 支持粘贴截图、拖拽附件、聊天内预览和点击打开 |
- 本机 Codex 直连：通过 Codex app-server 协议创建、恢复、分叉和管理任务。
- 项目与对话管理：按目录组织任务，优先恢复上次对话，其余历史渐进加载。
- 多任务作战图：并行任务可进入独立 Git Worktree，减少文件互相覆盖。
- 任务状态恢复：结合 Codex 事件、线程状态和本地记录识别运行、完成、异常与中断。
- 交付结果中心：集中展示生成文件、图片、代码位置、链接、检查结果和失败记录。
- 附件工作流：支持文件选择、图片粘贴、截图粘贴、拖拽以及历史附件卡片。
- 项目工具：文件浏览、Git Diff、终端、项目服务运行器和验收面板。
- 项目大脑：对项目事实进行本地缓存，减少新任务重复扫描和重复解释。
- 安全回退：可在执行前建立快照，并保留 Git 审查和 Worktree 隔离能力。
- 飞书网关：使用飞书官方 Node SDK 与 WebSocket 长连接，不要求公网回调地址。
- 性能模式：动画支持完整、精简和关闭三档；长历史采用窗口化和渐进加载。
可用模型、账号、协议和工具最终以本机 Codex CLI 返回的能力为准。xxzzaacode 不会 凭空增加模型权限，也不会绕过 Codex 本身的账号限制。
flowchart LR
U["用户 / 飞书"] --> UI["Electron 中文界面"]
UI --> IPC["受限 Preload IPC"]
IPC --> CORE["xxzzaacode 主进程"]
CORE --> CODEX["本机 Codex app-server"]
CORE --> LOCAL["文件 / Git / Worktree / 项目服务"]
CORE --> STATE["任务恢复 / 快照 / 验收记录"]
CODEX --> MODEL["用户自己的 Codex 登录与模型能力"]
任务请求直接进入本机 Codex app-server。界面本身不会再调用第二个大模型；但项目 缓存、附件上下文和验收任务可能增加发送给 Codex 的上下文或执行轮次，实际用量仍以 Codex 返回的数据为准。
- Node.js 20 或更高版本
- pnpm 11
- 已安装并登录的 Codex CLI
- 当前已完成 macOS arm64 构建验证；Windows 和 Linux 欢迎参与适配与验证
git clone https://github.com/bestdive999-coder/xxzzaacode.git
cd xxzzaacode
pnpm install --frozen-lockfile
pnpm dev:once如果 Codex 不在系统 PATH 中，可以指定可执行文件：
export XXZZAACODE_CODEX_BINARY="/absolute/path/to/codex"
pnpm dev:once开发模式会监听源码变化并重新启动桌面应用：
pnpm dev只查看浏览器演示界面：
pnpm preview然后打开 http://127.0.0.1:4179/?demo=1。演示模式只使用虚构项目和虚构数据。
xxzzaacode 默认使用 Codex 的 danger-full-access 和 approvalPolicy: never，不会逐项
弹出审批。它能够在当前系统用户权限范围内读取文件、修改代码和执行命令；选择的项目
目录是任务起点，不是安全沙箱。
- 只打开你信任的项目，并审查外部提示词、脚本、MCP 服务和附件。
- 重要项目应使用 Git，并对关键文件另行备份。
- 不要把密码、令牌、私钥、真实
.env或个人聊天记录提交到仓库。 - 飞书远程控制需要本机配对；群聊默认不能执行电脑操作。
- Codex 登录由 Codex CLI 管理，应用不读取或复制
~/.codex/auth.json。
完整说明见 SECURITY.md。仓库已启用 GitHub 私密漏洞报告功能。
飞书接入使用官方 @larksuiteoapi/node-sdk：
- WebSocket 长连接接收机器人私聊，无需部署公网回调服务。
- 首次使用需要在本机完成一次性配对。
- 飞书账号可以绑定本地项目并创建、查看、补充或停止任务。
- 支持任务中心卡片、进度消息、交付结果以及图片和文件附件。
- App Secret 通过系统安全存储加密后保存在本机，不写入仓库。
使用前需要自行创建或授权飞书应用，并授予机器人消息、消息接收和卡片回调权限。
pnpm audit:secrets
pnpm test
pnpm build:app
pnpm smoke:electron其他可用检查：
pnpm smoke:capabilities # 检查真实 Codex 协议能力
pnpm smoke # Codex app-server 连通性检查
pnpm smoke:multi # 多会话检查
pnpm benchmark:context # 上下文开销基准macOS Apple Silicon DMG：
pnpm dist:mac构建输出位于 release/，不会进入 Git。当前仓库未提供已签名、已公证的官方安装包，
请先从源码运行或自行签名构建。
应用状态保存在 Electron 的本机 userData 目录，可能包含最近项目、对话映射、任务
状态、飞书绑定和界面偏好。发布日志、Issue 或截图前请自行脱敏。
仓库不包含 Codex CLI、OpenAI 凭据、飞书凭据、用户对话、个人路径、构建产物或 项目 Logo。开源净化和发布复核记录见 OPEN_SOURCE_AUDIT.md。
欢迎提交 Issue 和 Pull Request，尤其是：
- Windows / Linux 运行与打包适配
- Codex app-server 新协议兼容
- 大规模对话和多任务性能优化
- 飞书卡片与远程任务体验改进
- 自动化测试、可访问性和文档完善
贡献流程见 CONTRIBUTING.md，第三方依赖说明见 THIRD_PARTY_NOTICES.md。
本项目采用 MIT License。