CodexCliPlus

基于 CLIProxyAPI 的 Codex Windows CLI 一站式管理增强平台
C# / WPF / WebView2 / .NET 10 + CLIProxyAPI Go 后端 + Codex CLI 增强层

架构约束 · 构建与发布 · 测试与验收 · 管理 API 映射 · QQ群聊

项目定位

CodexCliPlus 是面向 Windows 10/11 x64 的 Codex CLI 本地管理增强平台，服务于中文、Windows、本地优先、低配置成本、只使用 Codex 的用户。桌面端负责 WPF/WebView2 宿主、托盘、后端生命周期、更新与安全存储；管理界面来自仓库内置的 WebUI；后端运行时基于 CLIProxyAPI，并以 ccp-core.exe 作为 CodexCliPlus 托管资产名。

目标人群

• 中文用户：界面、文档和默认工作流优先面向中文使用场景。
• Windows 用户：聚焦 Windows 10/11 x64 本地桌面体验，不追求跨平台泛化。
• 本地用户：优先把账号、配置、日志、插件与运行状态留在本机管理。
• 懒人配置用户：减少手动编辑环境变量、认证文件和 .codex 配置的步骤。
• 仅 Codex 用户：围绕 Codex CLI 做管理增强，不扩展成通用多模型客户端。

当前特性

• Windows 桌面宿主：WPF + WebView2 主窗口、系统托盘、桌面通知。
• 托管后端运行时：魔改 CPA 后端作为 CodexCliPlus 管理的 ccp-core.exe 资产。
• 内置本地 WebUI：从仓库内置 WebUI 构建并随应用发布，通过应用窗口界面实时刷新数据，不依赖浏览器界面和手动刷新。
• Codex 专向管理面：管理入口聚焦 Codex CLI，检测并修复 Node.js、npm、PowerShell、PATH、WSL、Codex CLI 等本地依赖。
• OpenAI 兼容上游透传：移植并搭载 openai-compatibility 能力，可接入 NewAPI、OneAPI、OpenRouter 等 OpenAI 兼容上游；支持 provider base-url、多 API Key、自定义 Header、模型别名/模型池、每 Key 代理，以及非流式、流式和 /responses/compact 透传。
• 本机凭据保护：首次启动生成本地安全密钥；管理密钥和敏感值通过 Windows DPAPI 保存；API Key、OAuth Token、Authorization、Cookie 等写入时迁移为 ccp-secret:// 引用，含凭据配置只允许导出为 .sac v2 加密包，使用 Argon2id 和 AES-256-GCM；禁止明文导出含凭据内容。
• 本地用量持久化：在 CPA 用量接口基础上增加 SQLite 持久化、事件去重、水位过滤、导入导出和清理能力，保留跨会话用量记录。
• 更新与发布链路：支持从 CodexCliPlus GitHub Releases 检查、下载、校验并调用更新器安装；发布链路生成离线安装器、更新包、校验和、签名或未签名侧车元数据。

开发路线

• 集成 Codex 工作流：围绕 Codex CLI 做安装检测、更新、启动、日志、账号、用量和常用任务入口整合。
• 可视化编辑 .codex：提供图形化配置编辑、一键配置和配置校验，减少手写 TOML/JSON/YAML 的错误成本。
• 官方模式 / CPA 模式自由切换：支持在官方 Codex 路由和 CPA（CLIProxyAPI）路由之间按需切换，并尽量保留一致的本地管理体验。
• 邮件转发到手机：将 Codex 阶段性结论、任务完成结果和关键失败状态通过邮件系统转发给用户，方便在手机上接收进度。

快速开始

1. 准备环境

• Windows 10/11 x64
• .NET SDK 10
• Node.js 与 npm
• PowerShell 7 或 Windows PowerShell 5.1
• Microsoft Edge WebView2 Runtime
• Codex CLI（可选；未安装时仍可启动桌面宿主）

2. 拉取、还原并构建

git clone https://github.com/C4AL/CodexCliPlus.git
cd CodexCliPlus

dotnet tool restore
dotnet restore CodexCliPlus.sln
dotnet run --project ./src/CodexCliPlus.BuildTool/CodexCliPlus.BuildTool.csproj -- fetch-assets
dotnet build CodexCliPlus.sln --configuration Release
dotnet test ./tests/CodexCliPlus.Tests/CodexCliPlus.Tests.csproj --configuration Release

3. 启动桌面宿主

dotnet run --project ./src/CodexCliPlus.App/CodexCliPlus.App.csproj

4. 验证 WebUI

Push-Location ./resources/webui/upstream/source
npm ci
npm run lint
npm run type-check
npm run test
npm run build
Pop-Location

5. 发布与打包

dotnet run --project ./src/CodexCliPlus.BuildTool/CodexCliPlus.BuildTool.csproj -- verify-assets --version <version>
dotnet run --project ./src/CodexCliPlus.BuildTool/CodexCliPlus.BuildTool.csproj -- publish --configuration Release --runtime win-x64 --version <version>
dotnet run --project ./src/CodexCliPlus.BuildTool/CodexCliPlus.BuildTool.csproj -- package-offline-installer --configuration Release --runtime win-x64 --version <version>
dotnet run --project ./src/CodexCliPlus.BuildTool/CodexCliPlus.BuildTool.csproj -- package-update --configuration Release --runtime win-x64 --version <version>
dotnet run --project ./src/CodexCliPlus.BuildTool/CodexCliPlus.BuildTool.csproj -- verify-package --configuration Release --runtime win-x64 --version <version>

主要产物位于 artifacts/buildtool：

• publish/win-x64/CodexCliPlus.exe
• publish/win-x64/assets/backend/windows-x64/ccp-core.exe
• publish/win-x64/assets/webui/upstream/dist/index.html
• packages/CodexCliPlus.Setup.Online.<version>.exe
• packages/CodexCliPlus.Setup.Offline.<version>.exe

许可证

MIT