[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-qxcnm--Codex-Manager":3,"tool-qxcnm--Codex-Manager":64},[4,23,32,40,48,56],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":22},2268,"ML-For-Beginners","microsoft\u002FML-For-Beginners","ML-For-Beginners 是由微软推出的一套系统化机器学习入门课程，旨在帮助零基础用户轻松掌握经典机器学习知识。这套课程将学习路径规划为 12 周，包含 26 节精炼课程和 52 道配套测验，内容涵盖从基础概念到实际应用的完整流程，有效解决了初学者面对庞大知识体系时无从下手、缺乏结构化指导的痛点。\n\n无论是希望转型的开发者、需要补充算法背景的研究人员，还是对人工智能充满好奇的普通爱好者，都能从中受益。课程不仅提供了清晰的理论讲解，还强调动手实践，让用户在循序渐进中建立扎实的技能基础。其独特的亮点在于强大的多语言支持，通过自动化机制提供了包括简体中文在内的 50 多种语言版本，极大地降低了全球不同背景用户的学习门槛。此外，项目采用开源协作模式，社区活跃且内容持续更新，确保学习者能获取前沿且准确的技术资讯。如果你正寻找一条清晰、友好且专业的机器学习入门之路，ML-For-Beginners 将是理想的起点。",84991,2,"2026-04-05T10:45:23",[13,14,15,16,17,18,19,20,21],"图像","数据工具","视频","插件","Agent","其他","语言模型","开发框架","音频","ready",{"id":24,"name":25,"github_repo":26,"description_zh":27,"stars":28,"difficulty_score":29,"last_commit_at":30,"category_tags":31,"status":22},2181,"OpenHands","OpenHands\u002FOpenHands","OpenHands 是一个专注于 AI 驱动开发的开源平台，旨在让智能体（Agent）像人类开发者一样理解、编写和调试代码。它解决了传统编程中重复性劳动多、环境配置复杂以及人机协作效率低等痛点，通过自动化流程显著提升开发速度。\n\n无论是希望提升编码效率的软件工程师、探索智能体技术的研究人员，还是需要快速原型验证的技术团队，都能从中受益。OpenHands 提供了灵活多样的使用方式：既可以通过命令行（CLI）或本地图形界面在个人电脑上轻松上手，体验类似 Devin 的流畅交互；也能利用其强大的 Python SDK 自定义智能体逻辑，甚至在云端大规模部署上千个智能体并行工作。\n\n其核心技术亮点在于模块化的软件智能体 SDK，这不仅构成了平台的引擎，还支持高度可组合的开发模式。此外，OpenHands 在 SWE-bench 基准测试中取得了 77.6% 的优异成绩，证明了其解决真实世界软件工程问题的能力。平台还具备完善的企业级功能，支持与 Slack、Jira 等工具集成，并提供细粒度的权限管理，适合从个人开发者到大型企业的各类用户场景。",70626,3,"2026-04-05T22:51:36",[19,17,20,16],{"id":33,"name":34,"github_repo":35,"description_zh":36,"stars":37,"difficulty_score":10,"last_commit_at":38,"category_tags":39,"status":22},3074,"gpt4free","xtekky\u002Fgpt4free","gpt4free 是一个由社区驱动的开源项目，旨在聚合多种可访问的大型语言模型（LLM）和媒体生成接口，让用户能更灵活、便捷地使用前沿 AI 能力。它解决了直接调用各类模型时面临的接口分散、门槛高或成本昂贵等痛点，通过统一的标准将不同提供商的资源整合在一起。\n\n无论是希望快速集成 AI 功能的开发者、需要多模型对比测试的研究人员，还是想免费体验最新技术的普通用户，都能从中受益。gpt4free 提供了丰富的使用方式：既包含易于上手的 Python 和 JavaScript 客户端库，也支持部署本地图形界面（GUI），更提供了兼容 OpenAI 标准的 REST API，方便无缝替换现有应用后端。\n\n其技术亮点在于强大的多提供商支持架构，能够动态调度包括 Opus、Gemini、DeepSeek 等多种主流模型资源，并支持 Docker 一键部署及本地推理。项目秉持社区优先原则，在降低使用门槛的同时，也为贡献者提供了扩展新接口的便利框架，是探索和利用多样化 AI 资源的实用工具。",65970,"2026-04-04T01:02:03",[16,19,17],{"id":41,"name":42,"github_repo":43,"description_zh":44,"stars":45,"difficulty_score":10,"last_commit_at":46,"category_tags":47,"status":22},51,"gstack","garrytan\u002Fgstack","gstack 是 Y Combinator CEO Garry Tan 亲自开源的一套 AI 工程化配置，旨在将 Claude Code 升级为你的虚拟工程团队。面对单人开发难以兼顾产品战略、架构设计、代码审查及质量测试的挑战，gstack 提供了一套标准化解决方案，帮助开发者实现堪比二十人团队的高效产出。\n\n这套配置特别适合希望提升交付效率的创始人、技术负责人，以及初次尝试 Claude Code 的开发者。gstack 的核心亮点在于内置了 15 个具有明确职责的 AI 角色工具，涵盖 CEO、设计师、工程经理、QA 等职能。用户只需通过简单的斜杠命令（如 `\u002Freview` 进行代码审查、`\u002Fqa` 执行测试、`\u002Fplan-ceo-review` 规划功能），即可自动化处理从需求分析到部署上线的全链路任务。\n\n所有操作基于 Markdown 和斜杠命令，无需复杂配置，完全免费且遵循 MIT 协议。gstack 不仅是一套工具集，更是一种现代化的软件工厂实践，让单人开发者也能拥有严谨的工程流程。",64604,"2026-04-05T23:10:16",[17,16],{"id":49,"name":50,"github_repo":51,"description_zh":52,"stars":53,"difficulty_score":10,"last_commit_at":54,"category_tags":55,"status":22},193,"meilisearch","meilisearch\u002Fmeilisearch","Meilisearch 是一个开源的极速搜索服务，专为现代应用和网站打造，开箱即用。它能帮助开发者快速集成高质量的搜索功能，无需复杂的配置或额外的数据预处理。传统搜索方案往往需要大量调优才能实现准确结果，而 Meilisearch 内置了拼写容错、同义词识别、即时响应等实用特性，并支持 AI 驱动的混合搜索（结合关键词与语义理解），显著提升用户查找信息的体验。\n\nMeilisearch 特别适合 Web 开发者、产品团队或初创公司使用，尤其适用于需要快速上线搜索功能的场景，如电商网站、内容平台或 SaaS 应用。它提供简洁的 RESTful API 和多种语言 SDK，部署简单，资源占用低，本地开发或生产环境均可轻松运行。对于希望在不依赖大型云服务的前提下，为用户提供流畅、智能搜索体验的团队来说，Meilisearch 是一个高效且友好的选择。",56972,"2026-04-05T22:34:33",[13,17,14,20,16,18],{"id":57,"name":58,"github_repo":59,"description_zh":60,"stars":61,"difficulty_score":10,"last_commit_at":62,"category_tags":63,"status":22},4022,"awesome-claude-skills","ComposioHQ\u002Fawesome-claude-skills","awesome-claude-skills 是一个精心整理的开源资源库，旨在帮助用户挖掘和扩展 Claude AI 的潜力。它不仅仅是一份列表，更提供了实用的“技能（Skills）”模块，让 Claude 从单纯的文本生成助手，进化为能执行复杂工作流的智能代理。\n\n许多用户在使用 AI 时，常受限于其无法直接操作外部软件或处理特定格式文件的痛点。awesome-claude-skills 通过预设的工作流解决了这一问题：它不仅能教会 Claude 专业地处理 Word、PDF 等文档，进行代码开发与数据分析，还能借助 Composio 插件连接 Slack、邮箱及数百种常用应用，实现发送邮件、创建任务等自动化操作。这使得重复性任务变得标准化且可复用，极大提升了工作效率。\n\n无论是希望优化日常办公流程的普通用户、需要处理复杂文档的研究人员，还是寻求将 AI 深度集成到开发管线中的开发者，都能从中找到适合的解决方案。其独特的技术亮点在于“技能”的可定制性与强大的应用连接能力，让用户无需编写复杂代码，即可通过简单的配置让 Claude 具备跨平台执行真实任务的能力。如果你希望让 Claude",51312,"2026-04-05T19:04:23",[17,16],{"id":65,"github_repo":66,"name":67,"description_en":68,"description_zh":69,"ai_summary_zh":69,"readme_en":70,"readme_zh":71,"quickstart_zh":72,"use_case_zh":73,"hero_image_url":74,"owner_login":75,"owner_name":76,"owner_avatar_url":77,"owner_bio":78,"owner_company":79,"owner_location":79,"owner_email":79,"owner_twitter":79,"owner_website":79,"owner_url":80,"languages":81,"stars":106,"forks":107,"last_commit_at":108,"license":109,"difficulty_score":110,"env_os":111,"env_gpu":112,"env_ram":112,"env_deps":113,"category_tags":119,"github_topics":79,"view_count":10,"oss_zip_url":79,"oss_zip_packed_at":79,"status":22,"created_at":120,"updated_at":121,"faqs":122,"releases":152},4107,"qxcnm\u002FCodex-Manager","Codex-Manager","一个Codex cli 账号管理与切换工具。为 Codex cli提供本地网关转发。","Codex-Manager 是一款专为 Codex CLI 设计的本地账号管理与网关转发工具。它通过“桌面端 + 后台服务”的架构，帮助用户统一管理多个 AI 账号、监控用量数据以及配置平台 API Key，并提供稳定的本地网关代理能力。\n\n对于拥有多个 AI 账号或需要频繁切换身份的开发者和高级用户而言，Codex-Manager 有效解决了手动管理账号繁琐、用量统计分散以及网络请求配置复杂等痛点。其核心亮点在于智能的路径自动分流技术，能根据请求路径自动识别并适配 Codex 或 Claude Code 协议，无需为不同客户端重复维护密钥；同时支持全局模型名称改写规则，让不同平台的模型调用更加灵活透明。此外，工具还提供了详细的请求日志分析功能，清晰区分客户端设定与最终生效的服务等级，便于排查问题。\n\n该项目主要面向开发者、AI 研究人员及需要高效管理多账号资源的技术爱好者。值得注意的是，Codex-Manager 严格遵循各平台服务条款，仅作为本地管理辅助工具，不提供任何账号分发或绕过限制的功能，旨在为用户提供一个安全、合规且高效的本地化操作环境。","\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fqxcnm_Codex-Manager_readme_ce6639791b3f.png\" alt=\"CodexManager Logo\" width=\"220\" \u002F>\n\u003C\u002Fp>\n\n\u003Ch1 align=\"center\">CodexManager\u003C\u002Fh1>\n\n\u003Cp align=\"center\">本地桌面端 + 服务进程的 Codex 账号管理器+网关转发\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"README.en.md\">English\u003C\u002Fa>|\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fqxcnm\u002FCodex-Manager\">GitHub 主仓库\u003C\u002Fa>|\n  \u003Ca href=\"https:\u002F\u002Fqxnm.top\">官网\u003C\u002Fa>|\n  \u003Ca href=\"#赞助商\">赞助商\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\u003Cstrong>本地桌面端 + 服务进程的 Codex 账号池管理器\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cp align=\"center\">统一管理账号、用量与平台 Key，并提供本地网关能力。\u003C\u002Fp>\n\n## 认可社区\n\u003Cp align=\"left\">\n  \u003Ca href=\"https:\u002F\u002Flinux.do\u002Ft\u002Ftopic\u002F1688401\" title=\"LINUX DO\">\n    \u003Cimg\n      src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fqxcnm_Codex-Manager_readme_a51966fd7b90.png\"\n      alt=\"LINUX DO\"\n      width=\"100\"\n      hight=\"100\"\n    \u002F>\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n## 源码说明：\n> 本产品完全由本人指挥+AI打造 Codex（98%） Gemini (2%) 如果在使用过程中产生问题请友好交流，因为开源只是觉得有人能用的上，基本功能也没什么问题，不喜勿喷。\n> 其次是本人没有足够的环境来验证每个包都有没有问题，本人也要上班(我只是个穷逼买不起mac之类的)，本人只保证win的桌面端的可用性，如果其他端有问题，请在交流群反馈或者在充分测试后提交Issues，有时间我自会处理\n> 最后感谢各位使用者在交流群反馈的各个平台的问题和参与的部分测试。\n\n\n## 免责声明\n\n- 本项目仅用于学习与开发目的。\n\n- 使用者必须遵守相关平台的服务条款（例如 OpenAI、Anthropic）。\n\n- 作者不提供或分发任何账号、API Key 或代理服务，也不对本软件的具体使用方式负责。\n\n- 请勿使用本项目绕过速率限制或服务限制。\n\n## 赞助商\n\n感谢以下朋友与伙伴对 CodexManager 的支持。\n    末端夏：感谢提供 token 支持。他的 GPT 卡网支持自助购买、自助兑换激活，稳定不到车，带质保，支持 Codex 5.4。官网：[小末AI](https:\u002F\u002Fwww.aixiamo.com)\n\n [Wonderdch](https:\u002F\u002Fgithub.com\u002FWonderdch)、 Catch_Bat、 [suxinwl](https:\u002F\u002Fgithub.com\u002Fsuxinwl)、 [Hermit](https:\u002F\u002Fgithub.com\u002FHermitChen)、 [Suifeng023](https:\u002F\u002Fgithub.com\u002FSuifeng023)、 [HK-hub](https:\u002F\u002Fgithub.com\u002FHK-hub)\n\n\n## ☕ 支持项目 (Support)\n\n如果您觉得本项目对您有所帮助，欢迎打赏作者！\n\u003Ctable>\n  \u003Ctr>\n    \u003Cth>支付宝 (Alipay)\u003C\u002Fth>\n    \u003Cth>微信支付 (WeChat)\u003C\u002Fth>\n  \u003C\u002Ftr>\n  \u003Ctr>\n    \u003Ctd align=\"center\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fqxcnm_Codex-Manager_readme_52986e9c9084.jpg\" alt=\"支付宝赞助码\" width=\"220\" \u002F>\u003C\u002Ftd>\n    \u003Ctd align=\"center\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fqxcnm_Codex-Manager_readme_66d0e0351a11.jpg\" alt=\"微信赞助码\" width=\"220\" \u002F>\u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\n## Star History\n\n\u003Ca href=\"https:\u002F\u002Fwww.star-history.com\u002F?repos=qxcnm%2FCodex-Manager&type=date&legend=top-left\">\n \u003Cpicture>\n   \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\"https:\u002F\u002Fapi.star-history.com\u002Fimage?repos=qxcnm\u002FCodex-Manager&type=date&theme=dark&legend=top-left\" \u002F>\n   \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fqxcnm_Codex-Manager_readme_dc117f0cb8dd.png\" \u002F>\n   \u003Cimg alt=\"Star History Chart\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fqxcnm_Codex-Manager_readme_dc117f0cb8dd.png\" \u002F>\n \u003C\u002Fpicture>\n\u003C\u002Fa>\n\n## 首页导览\n| 你要做什么 | 直接进入 |\n| --- | --- |\n| 首次启动、部署、Docker、macOS 放行 | [运行与部署指南](docs\u002Freport\u002F运行与部署指南.md) |\n| 配置端口、代理、数据库、Web 密码、环境变量 | [环境变量与运行配置](docs\u002Freport\u002F环境变量与运行配置说明.md) |\n| 排查账号不命中、导入失败、挑战拦截、请求异常 | [FAQ 与账号命中规则](docs\u002Freport\u002FFAQ与账号命中规则.md) |\n| 排查后台任务账号跳过、禁用与停用原因 | [后台任务账号跳过说明](docs\u002Freport\u002F后台任务账号跳过说明.md) |\n| 插件中心最小接入、快速对接 | [插件中心最小接入说明](docs\u002Freport\u002F插件中心最小接入说明.md) |\n| 对接插件中心、查看接口清单、市场模式与 Rhai 接口 | [插件中心对接与接口清单](docs\u002Freport\u002F插件中心对接与接口清单.md) |\n| 系统全部可对接内部接口 | [系统内部接口总表](docs\u002Freport\u002F系统内部接口总表.md) |\n| 本地构建、打包、发版、脚本调用 | [构建发布与脚本说明](docs\u002Frelease\u002F构建发布与脚本说明.md) |\n\n## 最近变更\n  - 当前最新版本：`v0.1.17`（2026-04-05，pre-release）\n  - 请求日志现在会同时区分“客户端显式服务等级”和“最终生效服务等级”，可以直接看出平台 Key 默认 `Fast` 是否真的在请求改写后生效，不会再把 `auto` 和最终上游行为混为一谈。\n  - 平台 Key 的普通协议类型已经收敛成“通配兼容 (Codex \u002F Claude Code)”，默认按请求路径自动分流：`\u002Fv1\u002Fmessages*` 走 Claude 语义，其它标准路径走 Codex \u002F OpenAI 语义，不再需要为不同客户端重复维护两套 Key。\n  - 设置页新增“模型转发规则”，支持使用 `pattern=target` 做全局模型改写，例如 `spark*=gpt-5.4-mini`；如果平台 Key 自身绑定了固定模型，则平台 Key 绑定值优先。\n  - 账号页的“额度详情”悬浮卡位置也做了收口，浮层现在会按额度概览卡片的中线对齐，查看 5 小时 \u002F 7 天 \u002F 专属额度时更贴近视觉锚点，不会再明显偏上。\n  - 这轮版本收口也已完成：workspace、前端包、Tauri 桌面端、锁文件、README 和 CHANGELOG 的版本说明已统一到 `0.1.17`。\n\n### 近期提交摘要\n- `a2c0e05`：平台 Key 协议切换为按请求路径通配，并新增全局模型转发规则。\n- `4389764`：请求日志新增“最终生效服务等级”，区分客户端显式值与实际生效值。\n- `83bdb96`：补齐账号页与用量弹窗的全部额度展示，刷新后会把标准额度和附加额度一起回显。\n- `41375a4`：新增 `\u002Fv1\u002Fresponses` WebSocket 请求支持，并补齐 transport-aware 请求日志链路。\n- `b762a65`：修复 `service_tier` 日志口径，并为 HTTP \u002F WS 增加客户端原始 `service_tier` 诊断事件。\n- `7e7b76f`：整理上一轮遗留的纯格式化改动，避免和功能提交混在一起。\n- `be73359`：调整词元缩写显示保留两位小数，首页、日志和平台 Key 页的数字展示更稳定。\n- `dfb4494`：合并 PR #86，集中修复 Anthropic SSE 工具调用参数在流式桥接中的兼容问题。\n- `981bc6e`：将 `chat.completion` 用量别名映射到 OpenAI `prompt\u002Fcompletion tokens`，减少统计口径不一致。\n- `480f847`：修复 completed 事件里空 `edits` 覆盖已流出的编辑参数问题。\n- `7bbc5fc`：修复 `chat\u002Fcompletions` SSE 在已有内容时未正确合并 completed 工具参数的问题。\n- `aa2c09c`：在 Anthropic SSE 转换前先合并流式工具参数，避免完成态丢参。\n- `29c3b6b`：避免占位工具参数清空真实编辑载荷，继续补强流式工具调用稳定性。\n- `c1844b7`：统一流式断连提示为“网络抖动”，减少用户误判。\n- `a89cd9c`：保留上游原始错误文案并收敛日志提示，方便排查真实故障。\n- `8d619a0`：支持按选中导出账号，并优化用量刷新时的切号体验。\n\n## 功能概览\n- 账号池管理：分组、标签、排序、备注、封禁识别与封禁筛选\n- 批量导入 \u002F 导出：支持多文件导入、桌面端文件夹递归导入 JSON、按账号导出单文件\n- 用量展示：支持标准 5 小时 + 7 日窗口、仅 7 日单窗口账号，以及 Code Review \u002F Spark 等附加额度窗口；刷新后会统一展示各额度的剩余百分比与重置时间\n- 授权登录：浏览器授权 + 手动回调解析\n- 平台 Key：生成、禁用、删除、模型绑定、推理等级、服务等级（跟随请求 \u002F Fast \u002F Flex）\n- 聚合 API：管理第三方最小转发上游，支持创建、编辑、测试连通性、供应商名称、顺序优先级，以及按 Codex \u002F Claude 分类展示\n- 插件中心：路由为 `\u002Fplugins\u002F`，支持内置精选、企业私有、自定义源三种市场模式，并提供插件清单、任务、日志与 Rhai 对接接口\n- 设置页：支持“系统推导”按钮、单账号并发上限，以及更保守的高并发退化策略\n- 系统内部接口总表：列出当前桌面端与服务端所有可对接命令、RPC 方法、以及插件内建函数\n- 本地服务：自动拉起、可自定义端口与监听地址\n- 本地网关：为 CLI 和第三方工具提供统一 OpenAI 兼容入口\n\n## 截图\n![仪表盘](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fqxcnm_Codex-Manager_readme_9fca4746c8bb.png)\n![账号管理](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fqxcnm_Codex-Manager_readme_021ad1fce0f8.png)\n![平台 Key](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fqxcnm_Codex-Manager_readme_cfa19a229ada.png)\n![聚合 API](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fqxcnm_Codex-Manager_readme_06012c8edf22.png)\n![插件中心](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fqxcnm_Codex-Manager_readme_57e7e7f82866.png)\n![日志视图](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fqxcnm_Codex-Manager_readme_16047057019d.png)\n![设置页](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fqxcnm_Codex-Manager_readme_7c375e7edc80.png)\n\n## 快速开始\n1. 启动桌面端，点击“启动服务”。\n2. 进入“账号管理”，添加账号并完成授权。\n3. 如回调失败，粘贴回调链接手动完成解析。\n4. 刷新用量并确认账号状态。\n\n## 默认数据目录\n- 桌面端默认会把 SQLite 数据库写到应用数据目录下，文件名固定为 `codexmanager.db`。\n- Windows：`%APPDATA%\\\\com.codexmanager.desktop\\\\codexmanager.db`\n- macOS：`~\u002FLibrary\u002FApplication Support\u002Fcom.codexmanager.desktop\u002Fcodexmanager.db`\n- Linux：`~\u002F.local\u002Fshare\u002Fcom.codexmanager.desktop\u002Fcodexmanager.db`\n- 如需调整数据库、代理、监听地址等运行配置，可继续查看 [环境变量与运行配置](docs\u002Freport\u002F环境变量与运行配置说明.md)。\n\n## 页面展示\n### 桌面端\n- 账号管理：集中导入、导出、刷新账号与用量，支持低配额 \u002F 封禁筛选与重置时间展示\n- 平台 Key：按模型、推理等级、服务等级绑定平台 Key，并查看调用日志\n- 插件中心：`\u002Fplugins\u002F` 路由，内置精选 \u002F 企业私有 \u002F 自定义源市场切换，插件安装、启停、任务、日志、Rhai 对接\n- 设置页：统一管理端口、监听地址、代理、主题、自动更新、后台行为\n\n### Service 版\n- `codexmanager-service`：提供本地 OpenAI 兼容网关\n- `codexmanager-web`：提供浏览器管理页面\n- `codexmanager-start`：一键拉起 service + web\n\n## 常用文档\n- 版本历史：[CHANGELOG.md](CHANGELOG.md)\n- 协作约定：[CONTRIBUTING.md](CONTRIBUTING.md)\n- 架构说明：[ARCHITECTURE.md](ARCHITECTURE.md)\n- 测试基线：[TESTING.md](TESTING.md)\n- 安全说明：[SECURITY.md](SECURITY.md)\n- 文档索引：[docs\u002FREADME.md](docs\u002FREADME.md)\n\n## 专题页面\n| 页面 | 内容 |\n| --- | --- |\n| [运行与部署指南](docs\u002Freport\u002F运行与部署指南.md) | 首次启动、Docker、Service 版、macOS 放行 |\n| [环境变量与运行配置](docs\u002Freport\u002F环境变量与运行配置说明.md) | 应用配置、代理、监听地址、数据库、Web 安全 |\n| [FAQ 与账号命中规则](docs\u002Freport\u002FFAQ与账号命中规则.md) | 账号命中、挑战拦截、导入导出、常见异常 |\n| [后台任务账号跳过说明](docs\u002Freport\u002F后台任务账号跳过说明.md) | 后台任务过滤、禁用账号、workspace 停用原因 |\n| [最小排障手册](docs\u002Freport\u002F最小排障手册.md) | 快速定位服务启动、请求转发、模型刷新异常 |\n| [插件中心对接与接口清单](docs\u002Freport\u002F插件中心对接与接口清单.md) | 插件中心路由、市场模式、Tauri\u002FRPC 接口、清单字段、Rhai 内建函数 |\n| [构建发布与脚本说明](docs\u002Frelease\u002F构建发布与脚本说明.md) | 本地构建、Tauri 打包、Release workflow、脚本参数 |\n| [发布与产物说明](docs\u002Frelease\u002F发布与产物说明.md) | 各平台发版产物、命名、是否 pre-release |\n| [脚本与发布职责对照](docs\u002Freport\u002F脚本与发布职责对照.md) | 各脚本负责什么、什么场景该用哪个 |\n| [协议兼容回归清单](docs\u002Freport\u002F协议兼容回归清单.md) | `\u002Fv1\u002Fchat\u002Fcompletions`、`\u002Fv1\u002Fresponses`、tools 回归项 |\n| [当前网关与 Codex 请求头和参数差异表](docs\u002Freport\u002F当前网关与Codex请求头和参数差异表.md) | 当前网关参数传递、请求头和请求参数与 Codex 的对照说明 |\n| [系统内部接口总表](docs\u002Freport\u002F系统内部接口总表.md) | 桌面端、服务端、插件中心全部可对接内部接口 |\n| [CHANGELOG.md](CHANGELOG.md) | 最新发版内容、未发版更新与完整版本历史 |\n\n## 目录结构\n```text\n.\n├─ apps\u002F                # 前端与 Tauri 桌面端\n│  ├─ src\u002F\n│  ├─ src-tauri\u002F\n│  └─ dist\u002F\n├─ crates\u002F              # Rust core\u002Fservice\n│  ├─ core\n│  ├─ service\n│  ├─ start              # Service 版本一键启动器（拉起 service + web）\n│  └─ web                # Service 版本 Web UI（可内嵌静态资源 + \u002Fapi\u002Frpc 代理）\n├─ docs\u002F                # 正式文档目录\n├─ scripts\u002F             # 构建与发布脚本\n└─ README.md\n```\n\n## 鸣谢与参考项目\n\n- Codex（OpenAI）：本项目在请求链路、登录语义与上游兼容行为上参考了该项目的实现与源码结构 \u003Chttps:\u002F\u002Fgithub.com\u002Fopenai\u002Fcodex>\n\n\n\n## 联系方式\n- 公众号：七线牛马\n- 微信： ProsperGao\n\n- 交流群：答案是项目名：CodexManager\n\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fqxcnm_Codex-Manager_readme_d8a404c66f75.jpg\" alt=\"交流群二维码\" width=\"280\" \u002F>\n\n- Telegram 群聊：[CodexManager TG 群](https:\u002F\u002Ft.me\u002F+OdpFa9GvjxhjMDhl)\n","\u003Cp align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fqxcnm_Codex-Manager_readme_ce6639791b3f.png\" alt=\"CodexManager Logo\" width=\"220\" \u002F>\n\u003C\u002Fp>\n\n\u003Ch1 align=\"center\">CodexManager\u003C\u002Fh1>\n\n\u003Cp align=\"center\">本地桌面端 + 服务进程的 Codex 账号管理器+网关转发\u003C\u002Fp>\n\n\u003Cp align=\"center\">\n  \u003Ca href=\"README.en.md\">English\u003C\u002Fa>|\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fqxcnm\u002FCodex-Manager\">GitHub 主仓库\u003C\u002Fa>|\n  \u003Ca href=\"https:\u002F\u002Fqxnm.top\">官网\u003C\u002Fa>|\n  \u003Ca href=\"#赞助商\">赞助商\u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cp align=\"center\">\u003Cstrong>本地桌面端 + 服务进程的 Codex 账号池管理器\u003C\u002Fstrong>\u003C\u002Fp>\n\u003Cp align=\"center\">统一管理账号、用量与平台 Key，并提供本地网关能力。\u003C\u002Fp>\n\n## 认可社区\n\u003Cp align=\"left\">\n  \u003Ca href=\"https:\u002F\u002Flinux.do\u002Ft\u002Ftopic\u002F1688401\" title=\"LINUX DO\">\n    \u003Cimg\n      src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fqxcnm_Codex-Manager_readme_a51966fd7b90.png\"\n      alt=\"LINUX DO\"\n      width=\"100\"\n      hight=\"100\"\n    \u002F>\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n## 源码说明：\n> 本产品完全由本人指挥+AI打造 Codex（98%） Gemini (2%) 如果在使用过程中产生问题请友好交流，因为开源只是觉得有人能用的上，基本功能也没什么问题，不喜勿喷。\n> 其次是本人没有足够的环境来验证每个包都有没有问题，本人也要上班(我只是个穷逼买不起mac之类的)，本人只保证win的桌面端的可用性，如果其他端有问题，请在交流群反馈或者在充分测试后提交Issues，有时间我自会处理\n> 最后感谢各位使用者在交流群反馈的各个平台的问题和参与的部分测试。\n\n\n## 免责声明\n\n- 本项目仅用于学习与开发目的。\n\n- 使用者必须遵守相关平台的服务条款（例如 OpenAI、Anthropic）。\n\n- 作者不提供或分发任何账号、API Key 或代理服务，也不对本软件的具体使用方式负责。\n\n- 请勿使用本项目绕过速率限制或服务限制。\n\n## 赞助商\n\n感谢以下朋友与伙伴对 CodexManager 的支持。\n    末端夏：感谢提供 token 支持。他的 GPT 卡网支持自助购买、自助兑换激活，稳定不到车，带质保，支持 Codex 5.4。官网：[小末AI](https:\u002F\u002Fwww.aixiamo.com)\n\n [Wonderdch](https:\u002F\u002Fgithub.com\u002FWonderdch)、 Catch_Bat、 [suxinwl](https:\u002F\u002Fgithub.com\u002Fsuxinwl)、 [Hermit](https:\u002F\u002Fgithub.com\u002FHermitChen)、 [Suifeng023](https:\u002F\u002Fgithub.com\u002FSuifeng023)、 [HK-hub](https:\u002F\u002Fgithub.com\u002FHK-hub)\n\n\n## ☕ 支持项目 (Support)\n\n如果您觉得本项目对您有所帮助，欢迎打赏作者！\n\u003Ctable>\n  \u003Ctr>\n    \u003Cth>支付宝 (Alipay)\u003C\u002Fth>\n    \u003Cth>微信支付 (WeChat)\u003C\u002Fth>\n  \u003C\u002Ftr>\n  \u003Ctr>\n    \u003Ctd align=\"center\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fqxcnm_Codex-Manager_readme_52986e9c9084.jpg\" alt=\"支付宝赞助码\" width=\"220\" \u002F>\u003C\u002Ftd>\n    \u003Ctd align=\"center\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fqxcnm_Codex-Manager_readme_66d0e0351a11.jpg\" alt=\"微信赞助码\" width=\"220\" \u002F>\u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\n## Star History\n\n\u003Ca href=\"https:\u002F\u002Fwww.star-history.com\u002F?repos=qxcnm%2FCodex-Manager&type=date&legend=top-left\">\n \u003Cpicture>\n   \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\"https:\u002F\u002Fapi.star-history.com\u002Fimage?repos=qxcnm\u002FCodex-Manager&type=date&theme=dark&legend=top-left\" \u002F>\n   \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fqxcnm_Codex-Manager_readme_dc117f0cb8dd.png\" \u002F>\n   \u003Cimg alt=\"Star History Chart\" src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fqxcnm_Codex-Manager_readme_dc117f0cb8dd.png\" \u002F>\n \u003C\u002Ficture>\n\u003C\u002Fa>\n\n## 首页导览\n| 你要做什么 | 直接进入 |\n| --- | --- |\n| 首次启动、部署、Docker、macOS 放行 | [运行与部署指南](docs\u002Freport\u002F运行与部署指南.md) |\n| 配置端口、代理、数据库、Web 密码、环境变量 | [环境变量与运行配置](docs\u002Freport\u002F环境变量与运行配置说明.md) |\n| 排查账号不命中、导入失败、挑战拦截、请求异常 | [FAQ 与账号命中规则](docs\u002Freport\u002FFAQ与账号命中规则.md) |\n| 排查后台任务账号跳过、禁用与停用原因 | [后台任务账号跳过说明](docs\u002Freport\u002F后台任务账号跳过说明.md) |\n| 插件中心最小接入、快速对接 | [插件中心最小接入说明](docs\u002Freport\u002F插件中心最小接入说明.md) |\n| 对接插件中心、查看接口清单、市场模式与 Rhai 接口 | [插件中心对接与接口清单](docs\u002Freport\u002F插件中心对接与接口清单.md) |\n| 系统全部可对接内部接口 | [系统内部接口总表](docs\u002Freport\u002F系统内部接口总表.md) |\n| 本地构建、打包、发版、脚本调用 | [构建发布与脚本说明](docs\u002Frelease\u002F构建发布与脚本说明.md) |\n\n## 最近变更\n  - 当前最新版本：`v0.1.17`（2026-04-05，pre-release）\n  - 请求日志现在会同时区分“客户端显式服务等级”和“最终生效服务等级”，可以直接看出平台 Key 默认 `Fast` 是否真的在请求改写后生效，不会再把 `auto` 和最终上游行为混为一谈。\n  - 平台 Key 的普通协议类型已经收敛成“通配兼容 (Codex \u002F Claude Code)”，默认按请求路径自动分流：`\u002Fv1\u002Fmessages*` 走 Claude 语义，其它标准路径走 Codex \u002F OpenAI 语义，不再需要为不同客户端重复维护两套 Key。\n  - 设置页新增“模型转发规则”，支持使用 `pattern=target` 做全局模型改写，例如 `spark*=gpt-5.4-mini`；如果平台 Key 自身绑定了固定模型，则平台 Key 绑定值优先。\n  - 账号页的“额度详情”悬浮卡位置也做了收口，浮层现在会按额度概览卡片的中线对齐，查看 5 小时 \u002F 7 天 \u002F专属额度时更贴近视觉锚点，不会再明显偏上。\n  - 这轮版本收口也已完成：workspace、前端包、Tauri 桌面端、锁文件、README 和 CHANGELOG 的版本说明已统一到 `0.1.17`。\n\n### 过去几天的提交摘要\n- `a2c0e05`：平台 Key 协议切换为按请求路径通配，并新增全局模型转发规则。\n- `4389764`：请求日志新增“最终生效服务等级”，区分客户端显式值与实际生效值。\n- `83bdb96`：补齐账号页与用量弹窗的全部额度展示，刷新后会把标准额度和附加额度一起回显。\n- `41375a4`：新增 `\u002Fv1\u002Fresponses` WebSocket 请求支持，并补齐 transport-aware 请求日志链路。\n- `b762a65`：修复 `service_tier` 日志口径，并为 HTTP \u002F WS 增加客户端原始 `service_tier` 诊断事件。\n- `7e7b76f`：整理上一轮遗留的纯格式化改动，避免和功能提交混在一起。\n- `be73359`：调整词元缩写显示保留两位小数，首页、日志和平台 Key 页的数字展示更稳定。\n- `dfb4494`：合并 PR #86，集中修复 Anthropic SSE 工具调用参数在流式桥接中的兼容问题。\n- `981bc6e`：将 `chat.completion` 用量别名映射到 OpenAI `prompt\u002Fcompletion tokens`，减少统计口径不一致。\n- `480f847`：修复 completed 事件里空 `edits` 覆盖已流出的编辑参数问题。\n- `7bbc5fc`：修复 `chat\u002Fcompletions` SSE 在已有内容时未正确合并 completed 工具参数的问题。\n- `aa2c09c`：在 Anthropic SSE 转换前先合并流式工具参数，避免完成态丢参。\n- `29c3b6b`：避免占位工具参数清空真实编辑载荷，继续补强流式工具调用稳定性。\n- `c1844b7`：统一流式断连提示为“网络抖动”，减少用户误判。\n- `a89cd9c`：保留上游原始错误文案并收敛日志提示，方便排查真实故障。\n- `8d619a0`：支持按选中导出账号，并优化用量刷新时的切号体验。\n\n## 功能概览\n- 账号池管理：分组、标签、排序、备注、封禁识别与封禁筛选\n- 批量导入 \u002F 导出：支持多文件导入、桌面端文件夹递归导入 JSON、按账号导出单文件\n- 用量展示：支持标准 5 小时 + 7 日窗口、仅 7 日单窗口账号，以及 Code Review \u002F Spark 等附加额度窗口；刷新后会统一展示各额度的剩余百分比与重置时间\n- 授权登录：浏览器授权 + 手动回调解析\n- 平台 Key：生成、禁用、删除、模型绑定、推理等级、服务等级（跟随请求 \u002F Fast \u002F Flex）\n- 聚合 API：管理第三方最小转发上游，支持创建、编辑、测试连通性、供应商名称、顺序优先级，以及按 Codex \u002F Claude 分类展示\n- 插件中心：路由为 `\u002Fplugins\u002F`，支持内置精选、企业私有、自定义源三种市场模式，并提供插件清单、任务、日志与 Rhai 对接接口\n- 设置页：支持“系统推导”按钮、单账号并发上限，以及更保守的高并发退化策略\n- 系统内部接口总表：列出当前桌面端与服务端所有可对接命令、RPC 方法、以及插件内建函数\n- 本地服务：自动拉起、可自定义端口与监听地址\n- 本地网关：为 CLI 和第三方工具提供统一 OpenAI 兼容入口\n\n## 截图\n![仪表盘](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fqxcnm_Codex-Manager_readme_9fca4746c8bb.png)\n![账号管理](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fqxcnm_Codex-Manager_readme_021ad1fce0f8.png)\n![平台 Key](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fqxcnm_Codex-Manager_readme_cfa19a229ada.png)\n![聚合 API](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fqxcnm_Codex-Manager_readme_06012c8edf22.png)\n![插件中心](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fqxcnm_Codex-Manager_readme_57e7e7f82866.png)\n![日志视图](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fqxcnm_Codex-Manager_readme_16047057019d.png)\n![设置页](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fqxcnm_Codex-Manager_readme_7c375e7edc80.png)\n\n## 快速开始\n1. 启动桌面端，点击“启动服务”。\n2. 进入“账号管理”，添加账号并完成授权。\n3. 如回调失败，粘贴回调链接手动完成解析。\n4. 刷新用量并确认账号状态。\n\n## 默认数据目录\n- 桌面端默认会把 SQLite 数据库写到应用数据目录下，文件名固定为 `codexmanager.db`。\n- Windows：`%APPDATA%\\\\com.codexmanager.desktop\\\\codexmanager.db`\n- macOS：`~\u002FLibrary\u002FApplication Support\u002Fcom.codexmanager.desktop\u002Fcodexmanager.db`\n- Linux：`~\u002F.local\u002Fshare\u002Fcom.codexmanager.desktop\u002Fcodexmanager.db`\n- 如需调整数据库、代理、监听地址等运行配置，可继续查看 [环境变量与运行配置](docs\u002Freport\u002F环境变量与运行配置说明.md)。\n\n## 页面展示\n### 桌面端\n- 账号管理：集中导入、导出、刷新账号与用量，支持低配额 \u002F 封禁筛选与重置时间展示\n- 平台 Key：按模型、推理等级、服务等级绑定平台 Key，并查看调用日志\n- 插件中心：`\u002Fplugins\u002F` 路由，内置精选 \u002F 企业私有 \u002F 自定义源市场切换，插件安装、启停、任务、日志、Rhai 对接\n- 设置页：统一管理端口、监听地址、代理、主题、自动更新、后台行为\n\n### Service 版\n- `codexmanager-service`：提供本地 OpenAI 兼容网关\n- `codexmanager-web`：提供浏览器管理页面\n- `codexmanager-start`：一键拉起 service + web\n\n## 常用文档\n- 版本历史：[CHANGELOG.md](CHANGELOG.md)\n- 协作约定：[CONTRIBUTING.md](CONTRIBUTING.md)\n- 架构说明：[ARCHITECTURE.md](ARCHITECTURE.md)\n- 测试基线：[TESTING.md](TESTING.md)\n- 安全说明：[SECURITY.md](SECURITY.md)\n- 文档索引：[docs\u002FREADME.md](docs\u002FREADME.md)\n\n## 专题页面\n| 页面 | 内容 |\n| --- | --- |\n| [运行与部署指南](docs\u002Freport\u002F运行与部署指南.md) | 首次启动、Docker、Service 版、macOS 放行 |\n| [环境变量与运行配置](docs\u002Freport\u002F环境变量与运行配置说明.md) | 应用配置、代理、监听地址、数据库、Web 安全 |\n| [FAQ 与账号命中规则](docs\u002Freport\u002FFAQ与账号命中规则.md) | 账号命中、挑战拦截、导入导出、常见异常 |\n| [后台任务账号跳过说明](docs\u002Freport\u002F后台任务账号跳过说明.md) | 后台任务过滤、禁用账号、workspace 停用原因 |\n| [最小排障手册](docs\u002Freport\u002F最小排障手册.md) | 快速定位服务启动、请求转发、模型刷新异常 |\n| [插件中心对接与接口清单](docs\u002Freport\u002F插件中心对接与接口清单.md) | 插件中心路由、市场模式、Tauri\u002FRPC 接口、清单字段、Rhai 内建函数 |\n| [构建发布与脚本说明](docs\u002Frelease\u002F构建发布与脚本说明.md) | 本地构建、Tauri 打包、Release workflow、脚本参数 |\n| [发布与产物说明](docs\u002Frelease\u002F发布与产物说明.md) | 各平台发版产物、命名、是否 pre-release |\n| [脚本与发布职责对照](docs\u002Freport\u002F脚本与发布职责对照.md) | 各脚本负责什么、什么场景该用哪个 |\n| [协议兼容回归清单](docs\u002Freport\u002F协议兼容回归清单.md) | `\u002Fv1\u002Fchat\u002Fcompletions`、`\u002Fv1\u002Fresponses`、tools 回归项 |\n| [当前网关与 Codex 请求头和参数差异表](docs\u002Freport\u002F当前网关与Codex请求头和参数差异表.md) | 当前网关参数传递、请求头和请求参数与 Codex 的对照说明 |\n| [系统内部接口总表](docs\u002Freport\u002F系统内部接口总表.md) | 桌面端、服务端、插件中心全部可对接内部接口 |\n| [CHANGELOG.md](CHANGELOG.md) | 最新发版内容、未发版更新与完整版本历史 |\n\n## 目录结构\n```text\n.\n├─ apps\u002F                # 前端与 Tauri 桌面端\n│  ├─ src\u002F\n│  ├─ src-tauri\u002F\n│  └─ dist\u002F\n├─ crates\u002F              # Rust core\u002Fservice\n│  ├─ core\n│  ├─ service\n│  ├─ start              # Service 版本一键启动器（拉起 service + web）\n│  └─ web                # Service 版本 Web UI（可内嵌静态资源 + \u002Fapi\u002Frpc 代理）\n├─ docs\u002F                # 正式文档目录\n├─ scripts\u002F             # 构建与发布脚本\n└─ README.md\n```\n\n## 鸣谢与参考项目\n\n- Codex（OpenAI）：本项目在请求链路、登录语义与上游兼容行为上参考了该项目的实现与源码结构 \u003Chttps:\u002F\u002Fgithub.com\u002Fopenai\u002Fcodex>\n\n\n\n## 联系方式\n- 公众号：七线牛马\n- 微信： ProsperGao\n\n- 交流群：答案是项目名：CodexManager\n\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fqxcnm_Codex-Manager_readme_d8a404c66f75.jpg\" alt=\"交流群二维码\" width=\"280\" \u002F>\n\n- Telegram 群聊：[CodexManager TG 群](https:\u002F\u002Ft.me\u002F+OdpFa9GvjxhjMDhl)","# CodexManager 快速上手指南\n\nCodexManager 是一款本地桌面端与服务进程结合的 Codex 账号管理器及网关转发工具，支持统一管理账号池、用量监控、平台 Key 管理及本地 OpenAI 兼容网关能力。\n\n## 1. 环境准备\n\n### 系统要求\n- **Windows**: Windows 10\u002F11 (作者主要验证环境)\n- **macOS**: macOS 10.15+ (需自行测试兼容性)\n- **Linux**: 主流发行版 (需自行测试兼容性)\n- **架构**: x86_64 \u002F ARM64\n\n### 前置依赖\n- 无需额外安装运行时环境（桌面端为独立打包应用）。\n- 若使用 Docker 部署或源码构建，需安装：\n  - Docker & Docker Compose\n  - Node.js (前端构建)\n  - Rust & Cargo (后端核心构建)\n\n## 2. 安装步骤\n\n### 方式一：下载桌面端（推荐）\n1. 访问 [GitHub Releases](https:\u002F\u002Fgithub.com\u002Fqxcnm\u002FCodex-Manager\u002Freleases) 页面。\n2. 根据操作系统下载对应的安装包：\n   - Windows: `CodexManager_setup_x64.exe`\n   - macOS: `CodexManager.dmg`\n   - Linux: `CodexManager.AppImage` 或 `.deb`\u002F`.rpm`\n3. 运行安装程序并完成安装。\n\n### 方式二：Docker 部署 (Service 版)\n适用于服务器环境，提供 Web 管理界面和 API 网关。\n\n```bash\ndocker run -d \\\n  --name codexmanager \\\n  -p 3000:3000 \\\n  -v .\u002Fdata:\u002Fapp\u002Fdata \\\n  -e WEB_PASSWORD=your_secure_password \\\n  ghcr.io\u002Fqxcnm\u002Fcodexmanager:latest\n```\n*注：具体镜像地址请以仓库最新 Release 说明为准，若无官方镜像可参考源码构建。*\n\n### 方式三：源码构建\n```bash\ngit clone https:\u002F\u002Fgithub.com\u002Fqxcnm\u002FCodex-Manager.git\ncd Codex-Manager\n\n# 安装前端依赖\ncd apps && npm install && npm run build\n\n# 构建后端 (需 Rust 环境)\ncd ..\u002Fcrates\ncargo build --release\n\n# 启动服务\n.\u002Ftarget\u002Frelease\u002Fcodexmanager-start\n```\n\n## 3. 基本使用\n\n### 第一步：启动服务\n1. 打开已安装的 **CodexManager 桌面端**。\n2. 点击主界面的 **“启动服务”** 按钮。\n   - 服务启动后，将在本地监听默认端口（通常为 `http:\u002F\u002F127.0.0.1:3000`）。\n   - 此时本地网关已就绪，可作为 OpenAI 兼容接口供其他工具调用。\n\n### 第二步：添加账号\n1. 进入左侧菜单 **“账号管理”**。\n2. 点击 **“添加账号”**，选择浏览器授权或手动输入凭证。\n3. **授权流程**：\n   - 点击授权后会自动唤起浏览器登录。\n   - 登录成功后复制回调链接，粘贴回桌面端的输入框中完成解析。\n   - *若自动回调失败，请手动粘贴浏览器地址栏的完整回调 URL。*\n\n### 第三步：配置与验证\n1. 在账号列表中点击 **“刷新用量”**，确认账号状态、额度剩余及重置时间。\n2. 进入 **“平台 Key\"** 页面，生成或绑定 API Key，设置推理等级（Fast\u002FFlex）及模型绑定规则。\n3. **调用测试**：\n   使用任意支持 OpenAI 协议的客户端（如 curl、Postman 或 CLI 工具），请求本地网关：\n\n```bash\ncurl http:\u002F\u002F127.0.0.1:3000\u002Fv1\u002Fchat\u002Fcompletions \\\n  -H \"Authorization: Bearer YOUR_PLATFORM_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"model\": \"gpt-4o\",\n    \"messages\": [{\"role\": \"user\", \"content\": \"Hello\"}]\n  }'\n```\n\n### 第四步：高级配置（可选）\n- **插件中心**：访问 `\u002Fplugins\u002F` 路由，安装精选插件或对接私有市场。\n- **环境变量**：如需修改监听地址、数据库路径或代理设置，请参考 [环境变量与运行配置说明](docs\u002Freport\u002F环境变量与运行配置说明.md)。\n\n---\n*提示：默认数据文件存储在系统应用数据目录下（如 Windows 的 `%APPDATA%`），如需备份请查找 `codexmanager.db` 文件。*","某全栈开发团队在本地同时维护多个 Codex 和 Claude Code 项目，需频繁切换不同付费等级的 API 账号以测试模型表现并控制成本。\n\n### 没有 Codex-Manager 时\n- **账号切换繁琐**：每次更换测试账号或调整服务等级（如从 Fast 切换到 Priority），开发者必须手动修改环境变量或配置文件，极易出错且打断开发心流。\n- **多协议配置冗余**：面对 Codex 和 Anthropic 不同接口路径，需为同一组账号维护两套独立的 Key 配置，管理混乱且难以复用。\n- **用量监控盲区**：无法直观查看各账号的实时额度消耗与剩余量，常因超额使用导致请求突然中断，排查问题耗时耗力。\n- **模型映射困难**：想要将内部私有模型名统一映射到上游特定模型（如将 `spark*` 强制指向 `gpt-5.4-mini`），需在每个客户端单独硬编码，维护成本极高。\n\n### 使用 Codex-Manager 后\n- **一键无缝切换**：通过本地网关统一管理账号池，开发者可在桌面端界面即时切换账号与服务等级，请求自动转发，无需重启服务或修改代码。\n- **智能协议兼容**：利用通配兼容特性，Codex-Manager 根据请求路径（如 `\u002Fv1\u002Fmessages*`）自动分流至对应语义协议，一套配置即可同时支持多平台客户端。\n- **可视化额度洞察**：界面实时展示各账号的 5 小时\u002F7 天额度详情及最终生效的服务等级，帮助团队精准把控预算，避免意外超限。\n- **全局模型重写**：内置模型转发规则引擎，只需配置 `pattern=target` 即可全局统一模型映射逻辑，大幅简化了多环境下的测试配置工作。\n\nCodex-Manager 将碎片化的账号与网关管理转化为可视化的集中控制，让开发者能专注于核心业务逻辑而非基础设施配置。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002Fqxcnm_Codex-Manager_9fca4746.png","qxcnm","qxnm","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002Fqxcnm_aa765f15.jpg","姓名：高宏顺\r\n邮箱：\r\n18272669457@163.com、qxnms@outlook.com\r\n微信：ProsperGao  \r\n公众号、知乎: 七线牛马\r\n博客园：高宏顺",null,"https:\u002F\u002Fgithub.com\u002Fqxcnm",[82,86,90,94,98,102],{"name":83,"color":84,"percentage":85},"Rust","#dea584",82.3,{"name":87,"color":88,"percentage":89},"TypeScript","#3178c6",16.7,{"name":91,"color":92,"percentage":93},"CSS","#663399",0.4,{"name":95,"color":96,"percentage":97},"PowerShell","#012456",0.3,{"name":99,"color":100,"percentage":101},"JavaScript","#f1e05a",0.2,{"name":103,"color":104,"percentage":105},"Shell","#89e051",0.1,1089,172,"2026-04-05T19:47:46","MIT",4,"Windows, macOS, Linux","未说明",{"notes":114,"python":112,"dependencies":115},"本项目为本地桌面端 + 服务进程架构，非纯 Python AI 模型运行环境。作者明确说明仅保证 Windows 桌面端的可用性，macOS 和 Linux 端需自行测试反馈。数据默认存储在系统应用数据目录下的 SQLite 数据库中。支持 Docker 部署。无需特定 GPU 或大显存，主要作为账号管理和网关转发工具使用。",[116,117,118],"Tauri (桌面端框架)","Rust (核心服务)","SQLite (数据库)",[16],"2026-03-27T02:49:30.150509","2026-04-06T09:03:54.399558",[123,128,133,138,143,147],{"id":124,"question_zh":125,"answer_zh":126,"source_url":127},18724,"使用 Codex CLI 时报错 '403 Forbidden: invalid api key' 如何解决？","这是因为 auth.json 文件中包含了多余的配置项。Codex 识别到 token 后会优先使用 token 请求，导致冲突。解决方法是打开 auth.json 文件，只保留 'OPENAI_API_KEY' 这一项配置，删除其他所有配置项即可恢复正常。","https:\u002F\u002Fgithub.com\u002Fqxcnm\u002FCodex-Manager\u002Fissues\u002F55",{"id":129,"question_zh":130,"answer_zh":131,"source_url":132},18725,"在 Claude Code 中通过反代调用出现异常或报错怎么办？","该问题通常与 'Pencil MCP' 插件有关。如果遇到了调用异常，请尝试在配置中关闭或停用 Pencil MCP。维护者表示已修复该问题但可能尚未发布新版本，临时解决方案是先停用该插件。","https:\u002F\u002Fgithub.com\u002Fqxcnm\u002FCodex-Manager\u002Fissues\u002F71",{"id":134,"question_zh":135,"answer_zh":136,"source_url":137},18726,"Docker 部署登录后回调本地地址报错 '403 Forbidden' 或登录失败如何处理？","这通常是网络环境问题导致的。回调过程是去 OpenAI 获取 token，没有其他复杂操作。如果全局代理无效，建议检查网络连通性。此外，如果是本地端口被占用也可能导致回调失败，可以尝试检查本地 1455 端口是否被其他程序占用。","https:\u002F\u002Fgithub.com\u002Fqxcnm\u002FCodex-Manager\u002Fissues\u002F16",{"id":139,"question_zh":140,"answer_zh":141,"source_url":142},18727,"添加账号时提示 'token endpoint returned status 400 Bad Request' 是什么原因？","如果在点击登录后回调链接报错，最常见的原因是本地 1455 端口被其他程序占用了。请检查并释放该端口，或者重启相关服务后再试。如果网络环境特殊（如梯子问题），也可能导致此错误，请确保网络通畅。","https:\u002F\u002Fgithub.com\u002Fqxcnm\u002FCodex-Manager\u002Fissues\u002F57",{"id":144,"question_zh":145,"answer_zh":146,"source_url":142},18728,"Codex Windows 桌面端的配置文件在哪里？如何修改配置？","Codex 桌面端一直存在，其配置方式与 CLI 版本一致。配置文件位于用户目录下的 '.codex' 文件夹中，主要修改 'auth.json' 和 'config.toml' 这两个文件即可进行账号和参数配置。",{"id":148,"question_zh":149,"answer_zh":150,"source_url":151},18729,"为什么配置好账号后无法命中缓存，每次请求都显示未命中？","如果确认配置默认且账号正常，但日志显示同一对话未命中缓存，可能是软件设置问题或特定客户端（如 Opencode）的兼容性差异。维护者测试过 OpenCode、Codex、Claude 等客户端均可完美命中。建议检查是否有额外设置干扰，或加入社区群组提供具体日志以便排查是否为规则变更导致。","https:\u002F\u002Fgithub.com\u002Fqxcnm\u002FCodex-Manager\u002Fissues\u002F89",[153,158,163,168,173,178,183,188,193,198,203,208,213,218,223,228,233,238,243,248],{"id":154,"version":155,"summary_zh":156,"released_at":157},109216,"v0.1.16","  - 当前最新版本：`v0.1.16`（2026-04-05，预发布）\n  - 该版本主要新增了对 `\u002Fv1\u002Fresponses` 的 WebSocket 请求支持。网关现在能够根据传输类型走完整代理链路，并对请求类型、头部进行归一化处理，同时将日志记录与运行时行为统一收口。\n  - 账号管理页面和用量弹窗在刷新后会统一展示所有已返回的额度窗口，不仅显示标准的 5 小时\u002F7 天额度，还会一并列出 Code Review、Spark 等附加额度，并附上各自的剩余额度及重置时间。\n  - `service_tier` 的日志口径也已同步补齐：HTTP\u002FWS 请求日志仅在客户端显式携带 `service_tier` 参数时才会记录为 `fast` 级别，不再将平台 Key 默认的服务等级误记为请求显式开启的级别。\n  - 此轮版本的收口工作也已完成：workspace、前端包、Tauri 桌面端、锁文件、README 和 CHANGELOG 中的版本说明均已统一更新至 `0.1.16`。","2026-04-05T08:19:50",{"id":159,"version":160,"summary_zh":161,"released_at":162},109217,"v0.1.15","- 当前最新版本：`v0.1.15`（2026-04-03）\n  - 本版本主要围绕“网关流式稳定性”和“账号操作体验”两条主线进行收尾：修复了在 OpenAI -> Anthropic SSE 桥接过程中，工具调用参数被覆盖、丢失或被空的 `edits` 数组清空的问题；同时补齐了 `chat.completion` 用量字段与 OpenAI `prompt\u002Fcompletion tokens` 的映射，使工具调用和用量统计更加稳定。\n  - 错误提示链路进一步收敛：尽可能保留上游的原始错误文案，将流式断连统一归因于更易理解的“网络抖动”，并减少重复及具有误导性的日志提示，从而降低排障成本。\n  - 账号页面新增“按选中导出账号”功能，并优化了用量刷新时的切号体验；同时，词元缩写显示统一保留两位小数，使首页、日志和平台 Key 页面的读数更加一致。\n  - 此轮版本的收尾工作也已全部完成：workspace、前端包、Tauri 桌面端、运行文档以及 README 中的版本说明均已统一更新至 `0.1.15`。","2026-04-04T16:00:39",{"id":164,"version":165,"summary_zh":166,"released_at":167},109218,"v0.1.14","  - 当前最新版本：`v0.1.14`（2026-03-30）\n  - 本版本主要围绕“更稳定的服务”和“更便捷的接入”两条主线进行收尾：在入口层新增了短队列等待机制与超载快速降级策略，在设置页面新增了“系统推导”功能和“单账号并发上限”配置。无论在哪台机器上，系统都会先进行排队处理，再根据情况降级，从而避免进程被轻易拖垮。\n  - 插件中心和接入文档继续完善：README 中增加了插件中心的预览图，插件中心的最小接入说明、完整接口清单以及系统内部接口总表均已补齐，外部对接更加简便。\n  - 长期保留的文档统一去除了日期前缀，README 和 docs 的链接也一并切换为稳定的文件名，便于后续维护。\n  - 定时脚本入口已挂载到账号页，默认每分钟执行一次，用户仍可自行调整；同时补充了系统内部接口总表，方便宿主与插件之间的对接。\n  - 此轮版本的收尾工作也已完成：workspace、前端包、Tauri 桌面端、校验脚本以及 README 中的版本说明均已统一更新至 `0.1.14`。","2026-03-31T07:46:21",{"id":169,"version":170,"summary_zh":171,"released_at":172},109219,"v0.1.13","### 不保证没有bug\n- 当前最新版本：`v0.1.13`（2026-03-26） \n- 新增“聚合 API”管理页：可将多个第三方中转服务作为最小转发上游统一管理，支持按 `Codex \u002F Claude` 分类、配置供应商名称 \u002F 顺序 \u002F URL \u002F 密钥，并提供连通性测试。\n- 平台密钥轮转现在支持 `账号轮转 \u002F 聚合 API 轮转` 两种策略；聚合 API 轮转会优先按顺序命中对应供应商，再按协议直接透传上游请求，账号轮转逻辑保持不变。\n- `v0.1.13` 继续补齐这一轮桌面与文档收口：聚合 API 管理页与平台密钥轮转链路已经打通，桌面端的服务启动与页面切换行为也更稳定，README 同步补齐最新功能说明。\n- 账号管理补齐了这一轮最常用的治理能力：`account_deactivated` 与 `workspace_deactivated` 会被自动识别为不可用信号，页面支持直接筛选“封禁”，并提供“一键清理封禁账号”入口。\n- 账号页的 5 小时 \u002F 7 天额度现在都会在进度条下方显示重置时间；仅提供 7 天窗口的 free 账号也会把重置时间正确显示到 7 天列，避免看错窗口。\n- 平台密钥新增服务等级配置：`跟随请求`、`Fast`、`Flex`。其中 `Fast` 会映射为上游 `priority`，`Flex` 会直传为 `flex`；桌面端创建 \u002F 编辑链路也已修正，现在能正常保存与回显。\n- 设置页补回了服务监听切换，支持在 `localhost` 与 `0.0.0.0` 之间切换；“检查更新”按钮现在只会在手动点击时显示加载状态，不会再被静默自动检查误触发。\n- Web \u002F 桌面交互层也做了补丁修复：Web 非首页刷新不再误下载文件，复制 API Key \u002F 登录链接在缺少 `navigator.clipboard.writeText` 的环境下也会自动降级复制。\n- 发布链路继续统一收口：版本已提升到 `0.1.13`，workspace、前端包、Tauri 桌面端、版本一致性校验脚本和 README 版本说明已同步对齐。完整历史请看 [CHANGELOG.md](CHANGELOG.md)","2026-03-26T10:58:13",{"id":174,"version":175,"summary_zh":176,"released_at":177},109220,"v0.1.12","对0.1.11进行补充修复","2026-03-21T15:53:03",{"id":179,"version":180,"summary_zh":181,"released_at":182},109221,"v1w.test","交流测试版本","2026-03-20T08:13:28",{"id":184,"version":185,"summary_zh":186,"released_at":187},109222,"v0.1.11","- 当前最新版本：`v0.1.11`（2026-03-20）\n- `v0.1.11` 重点优化了 Codex-first 主链路：包括会话绑定、自动切号即切线程，以及 `originator` \u002F `User-Agent` \u002F 请求压缩等出站语义，进一步向 Codex 标准对齐；同时移除了 upstream cookie 链路和旧兼容路径的遗留影响。\n- 账号管理模块补齐了本轮最常用的治理功能：`account_deactivated` 和 `workspace_deactivated` 将被自动识别为不可用状态，页面支持直接筛选“封禁”账号，并新增“一键清理封禁账号”的入口。\n- 账号页的 5 小时\u002F7 天额度信息现会在进度条下方显示重置时间；对于仅提供 7 天使用窗口的免费账号，重置时间也会正确显示在 7 天列中，避免用户误判使用窗口。\n- 平台密钥新增服务等级配置：`跟随请求`、`Fast`、`Flex`。其中 `Fast` 会映射为上游的 `priority` 参数，`Flex` 则会直接传递为 `flex` 参数；桌面端创建\u002F编辑链路的相关问题也已修复，现在可正常保存并正确回显设置。\n- 设置页面恢复了服务监听地址的切换功能，支持在 `localhost` 和 `0.0.0.0` 之间自由切换；“检查更新”按钮现仅在手动点击时显示加载状态，不会再因静默自动检查而误触发。\n- Web 和桌面端的交互层也进行了补丁修复：Web 非首页刷新不再误下载文件，且在缺少 `navigator.clipboard.writeText` API 的环境下，复制 API Key 或登录链接时会自动降级为普通复制操作。\n- 发布流程继续统一收口：版本已升级至 `0.1.11`，workspace、前端包、Tauri 桌面端、版本一致性校验脚本以及 README 中的版本说明均已同步更新。完整变更记录请参阅 [CHANGELOG.md](CHANGELOG.md)。","2026-03-19T20:46:39",{"id":189,"version":190,"summary_zh":191,"released_at":192},109223,"v0.1.10","## 新 UI 遗漏了自动更新替换的调用链，后续再进行修复。Docker 部署请直接使用项目 master 分支下的 docker 文件夹中的配置，并结合 master 源码进行部署。\n`v0.1.10` 是基于 `v0.1.9` 的补发修复版本，重点修复了 Web 和 Docker 环境下误提示桌面专属能力、账号启用\u002F禁用参数错误、禁用账号仍被轮询、`refresh token 401` 状态不统一，以及 Windows 本地 Web 启动器关闭后子进程残留于后台等问题。\n- 上一个大版本更新将桌面端和 Web 管理界面整体重做，并统一收口至新的 `apps` 前端：旧前端已被移除，账号管理、平台密钥、请求日志、设置页、顶部状态栏和侧边导航均采用统一的桌面优先布局，列表密度、弹窗交互、筛选区和卡片区也进行了全面重构。\n- 请求链路继续按照 Codex 的实际行为进行收口，但仅保留真正影响请求命中与否的部分：登录\u002Fcallback\u002Fworkspace 校验、refresh 语义、`\u002Fv1\u002Fresponses` 与 `\u002Fv1\u002Fresponses\u002Fcompact` 的请求体重写、线程锚点、`session_id`\u002F`x-client-request-id`\u002F`x-codex-turn-state`、请求压缩、错误摘要和 fallback 诊断均已完善。\n- 账号策略与可用性也进行了实用化收口：free\u002F7 天单窗口账号现会统一按设置中的模型发起请求；优先账号、失败回退、并发上限和 refresh token 误摘号问题均已修正，请求日志中也能查看首次尝试的账号及尝试链路。\n- 可观测性显著增强：请求日志改为后端分页与统计，对于 compact 假成功体、HTML\u002Fchallenge 页面、`401 refresh` 原因、`503 no available account` 等失败场景，都会输出更为明确的诊断信息，网关磁盘日志也收敛为以失败摘要为导向。\n- 桌面稳定性和启动体验再次优化：服务启动误判、`\u002Frpc` 空响应、刷新用量弹窗不更新、首次切换页面卡顿、Hydration 不一致、开发态渲染指示误导等问题均已解决，Web 密码与桌面\u002FWeb 设置同步功能也已完成收口。\n- 发布链路实现了统一治理：版本已提升至 `0.1.10`，Tauri Rust 侧及 workflow 中的 Tauri CLI\u002Fpnpm 版本已重新对齐，`release-all.yml` 继续作为 Windows\u002FmacOS\u002FLinux 的单一发布入口。完整历史请参阅 [CHANGELOG.md](CHANGELOG.md)。","2026-03-18T12:48:01",{"id":194,"version":195,"summary_zh":196,"released_at":197},109224,"v0.1.9","- 本次发版的重点是将桌面端和 Web 管理界面整体重做，并统一接入新的 `apps` 前端：旧前端已移除，账号管理、平台密钥、请求日志、设置页、顶部状态栏和侧边导航均采用统一的桌面优先布局，列表密度、弹窗交互、筛选区和卡片区也进行了全面重构。\n- 请求链路继续按照 Codex 的实际行为进行收敛，但仅保留真正影响请求命中与否的部分：登录 \u002F callback \u002F workspace 校验、refresh 语义、`\u002Fv1\u002Fresponses` 与 `\u002Fv1\u002Fresponses\u002Fcompact` 的请求体重写、线程锚点、`session_id` \u002F `x-client-request-id` \u002F `x-codex-turn-state`、请求压缩、错误摘要和 fallback 诊断均已完善。\n- 账号策略与可用性也进行了实用性的收敛：free \u002F 7 天单窗口账号现将统一按设置中的模型发起请求；优先账号、失败回退、并发上限以及 refresh token 误摘号问题均已修复，请求日志中也能查看首次尝试的账号及尝试链路。\n- 可观测性显著增强：请求日志改为后端分页与后端统计，对于 compact 假成功体、HTML\u002Fchallenge 页、`401 refresh` 原因、`503 no available account` 等失败场景，都会输出更为明确的诊断信息，网关磁盘日志也已整合为以失败摘要为导向的形式。\n- 桌面端的稳定性和启动体验再次优化：服务启动误判、`\u002Frpc` 空响应、刷新用量弹窗不更新、首次切换页面卡顿、Hydration 不一致、开发态渲染指示误导等问题均已解决，Web 密码与桌面\u002FWeb 设置的同步功能也已完成收敛。\n- 发布流程实现了统一管理：版本号提升至 `0.1.9`，Tauri Rust 侧以及工作流中的 Tauri CLI 和 pnpm 版本已重新对齐，`release-all.yml` 继续作为 Windows \u002F macOS \u002F Linux 的单一发布入口。完整变更记录请参阅 [CHANGELOG.md](CHANGELOG.md)。\n\n## 目前某些场景与 Web 版本尚未充分测试，存在一些问题，后续会通过补丁版本加以修复。","2026-03-17T16:12:21",{"id":199,"version":200,"summary_zh":201,"released_at":202},109225,"v0.1.8","- 当前最新版本：`v0.1.8`（2026-03-13）\n- 本次发版已收敛最近一轮协议兼容、登录链路、网关错误响应、桌面交互、Web 安全和长期维护治理；完整历史请看 [CHANGELOG.md](CHANGELOG.md)。\n- 仪表盘继续补齐账号池视角：新增“账号池总剩余”卡片，5 小时 \u002F 7 天剩余比例已下沉到后端聚合，并接入启动快照与自动刷新链路，账号规模上来后也能持续刷新。\n- Codex 登录账号链路继续对齐：ChatGPT 登录账号主请求已统一改为直接使用 `access_token`，不再混入 `api_key_access_token` 语义；默认 `https:\u002F\u002Fapi.openai.com\u002Fv1` fallback 已移除，challenge \u002F 403 不再被本地硬改成额外的 fallback 错误。\n- 401 恢复链路已补齐：当 ChatGPT 登录账号请求命中 `401` 时，会使用本地 `refresh_token` 刷新 `access_token`，并对当前请求执行一次单次重试；不再继续沿用旧的 401 stateless retry。\n- 网关运行与诊断增强：gateway 自合成失败响应已改成结构化 OpenAI 风格 `error.message \u002F error.type \u002F error.code`，同时保留错误码与 trace 响应头；长输出场景的 SSE 空闲断流重连更稳定；设置页新增上游流式超时和 SSE keepalive 配置并支持热生效。\n- 桌面体验继续修正：启动后会优先恢复仪表盘 \u002F 账号 \u002F 请求日志快照；登录成功后账号表格会自动刷新；平台密钥创建与上游代理保存流程也做了收口。\n- Web 安全链路已补齐：`codexmanager-web` 的访问密码仍会持久化，但登录会话会绑定当前 Web 进程；关闭并重新打开后，旧 Cookie 不再继续生效，必须重新验证密码。\n- 项目内部也在持续做长期维护向重构：前端主入口、设置页、请求日志、Tauri 命令层、service 生命周期、gateway protocol adapter、HTTP bridge 和 upstream 流程都已继续拆分，目录边界和模块职责更清晰。\n- 发布体系继续收敛到单一入口：`release-all.yml` 统一负责 Windows \u002F macOS \u002F Linux 一键发布；当 `run_verify=false` 时会自动回退到本地前端构建，不再强依赖预构建工件。","2026-03-13T05:08:43",{"id":204,"version":205,"summary_zh":206,"released_at":207},109226,"v0.1.7","- 当前最新版本：`v0.1.7`（2026-03-11）\r\n- 本次发版已收敛最近一轮协议兼容、桌面交互、Web 安全和长期维护治理；完整历史请看 [CHANGELOG.md](CHANGELOG.md)。\r\n- 协议兼容继续收敛：进一步统一 `\u002Fv1\u002Fchat\u002Fcompletions`、`\u002Fv1\u002Fresponses`、Claude `\u002Fv1\u002Fmessages`；补齐多 MCP server 工具保留、长工具名缩短与响应还原，并继续覆盖 Cherry Studio、OpenClaw、Claude Code 等兼容场景。\r\n- 网关运行与诊断增强：失败响应增加结构化 `errorCode` \u002F `errorDetail` 与追踪响应头；长输出场景的 SSE 空闲断流重连更稳定；设置页新增上游流式超时和 SSE keepalive 配置并支持热生效。\r\n- 桌面体验继续修正：启动后会优先恢复仪表盘 \u002F 账号 \u002F 请求日志快照；登录成功后账号表格会自动刷新；平台密钥创建与上游代理保存流程也做了收口。\r\n- Web 安全链路已补齐：`codexmanager-web` 的访问密码仍会持久化，但登录会话会绑定当前 Web 进程；关闭并重新打开后，旧 Cookie 不再继续生效，必须重新验证密码。\r\n- 项目内部也在持续做长期维护向重构：前端主入口、设置页、请求日志、Tauri 命令层、service 生命周期、gateway protocol adapter、HTTP bridge 和 upstream 流程都已继续拆分，目录边界和模块职责更清晰。\r\n- 发布体系继续收敛到单一入口：`release-all.yml` 统一负责 Windows \u002F macOS \u002F Linux 一键发布；当 `run_verify=false` 时会自动回退到本地前端构建，不再强依赖预构建工件。","2026-03-11T08:18:22",{"id":209,"version":210,"summary_zh":211,"released_at":212},109227,"v0.1.6","- 当前最新版本：`v0.1.6`（2026-03-07）\r\n- 当前主分支已继续补齐 Web 安全链路：`codexmanager-web` 的访问密码仍会持久化，但登录会话现在会绑定当前 Web 进程；关闭并重新打开后，旧 Cookie 不再继续生效，必须重新验证密码。\r\n- 协议适配继续对齐 Codex \u002F OpenAI 兼容生态：`\u002Fv1\u002Fchat\u002Fcompletions` 与 `\u002Fv1\u002Fresponses` 转发链路进一步统一，`tools` \u002F `tool_calls` 聚合、工具名缩短与响应还原链路已补齐，并覆盖 Cherry Studio、OpenClaw、Claude Code 等兼容场景。\r\n- 网关诊断能力增强：失败响应增加结构化 `errorCode` \u002F `errorDetail` 字段，并补充 `X-CodexManager-Error-Code`、`X-CodexManager-Trace-Id` 头；请求日志也补充了原始路径、适配路径和更多上游上下文，便于精确排障。\r\n- 发布体系继续收敛到单一入口：`release-all.yml` 统一负责 Windows \u002F macOS \u002F Linux 一键发布；当 `run_verify=false` 时会自动回退到本地前端构建，不再强依赖预构建工件，同时继续复用前端产物与协议回归基线。\r\n- 桌面端与设置治理同步完善：新增 SOCKS5 \u002F HTTP 上游代理归一化与提示文案、服务监听地址绑定模式配置、文件夹递归导入账号、单实例窗口治理，以及更统一的设置页常用配置布局。\r\n- 完整版本历史请查看 [CHANGELOG.md](CHANGELOG.md)。","2026-03-07T17:31:03",{"id":214,"version":215,"summary_zh":216,"released_at":217},109228,"v0.1.5","- 网关协议适配进一步对齐 Codex CLI：`\u002Fv1\u002Fchat\u002Fcompletions` 与 `\u002Fv1\u002Fresponses` 两条链路统一收敛到 Codex `responses` 语义，上游流式\u002F非流式行为与官方更接近，兼容 Cherry Studio 等客户端的 OpenAI 兼容调用。\r\n- 修复 `tool_calls` \u002F `tools` 相关回归：补齐 chat 聚合路径中的工具调用保留、工具名缩短与响应还原链路，避免工具调用在 OpenAI 兼容返回、流式增量和适配转换中丢失或名称错乱。\r\n- 完善 OpenClaw \u002F Anthropic 兼容返回适配，确保工具调用、SSE 增量和非流式 JSON 响应都能按兼容格式正确还原。\r\n- 新增“按文件夹导入”：桌面端可直接选择目录，递归扫描其中 `.json` 文件并批量导入账号。\r\n- 新增 OpenAI 上游代理配置与请求头收敛策略开关，可在设置页直接保存并即时生效，并降低部分 Cloudflare \u002F WAF challenge 命中率。\r\n- 设置页顶部常用配置改为统一的三列行布局，代理配置与其保持一致；同时支持关闭窗口后隐藏到系统托盘运行。\r\n- 请求日志追踪增强：补充原始路径、适配路径和更多上下文，便于定位 `\u002Fv1\u002Fchat\u002Fcompletions -> \u002Fv1\u002Fresponses` 转发与协议适配问题。\r\n- 发布流程整合为单一一键多平台 workflow，按 `Windows -> macOS -> Linux` 顺序发布；同时收敛产物形态，Windows 直接提供 portable exe，macOS 统一使用 DMG 分发。\r\n- 补充 chat tools 命中探针脚本与相关修复，便于本地验证工具调用是否真正命中与透传。","2026-03-05T05:39:20",{"id":219,"version":220,"summary_zh":221,"released_at":222},109229,"v0.1.4","- `v0.1.4`（最新）\r\n- 账号管理页操作区整合为单一“账号操作”下拉菜单，替代右侧多按钮堆叠，界面更简洁。\r\n- 新增“一键移除不可用 Free 账号”：批量清理“不可用 + free 计划”账号，并返回扫描\u002F跳过\u002F删除统计。\r\n- 新增“导出用户”：支持选择本地目录并按“一个账号一个 JSON 文件”导出。\r\n- 导入兼容增强：支持 `tokens.*`、顶层 `*_token`、camelCase 字段（如 `accessToken\u002FidToken\u002FrefreshToken`）自动识别。\r\n- 兼容旧 service：前端导入前会自动归一化顶层 token 格式，避免旧版后端报 `missing field: tokens`。\r\n- 兼容\u002Fv1\u002Fchat\u002Fcompletions 的转发\r\n","2026-03-03T09:34:36",{"id":224,"version":225,"summary_zh":226,"released_at":227},109230,"v0.1.3","- `v0.1.3`（最新）\r\n- 设置页重构：改为单页聚合布局，新增“后台任务”配置区（轮询开关\u002F间隔 + worker 参数），并补齐中文文案与悬浮提示。\r\n- 新增后台任务配置链路：前端 -> Tauri -> RPC 打通 `gateway\u002FbackgroundTasks\u002Fget|set`，可在设置页统一管理用量轮询、网关保活、令牌刷新轮询与 worker 参数。\r\n- 后台任务运行时行为增强：轮询类参数支持运行中热更新；`usageRefreshWorkers`、`httpWorkerFactor\u002FhttpWorkerMin`、`httpStreamWorkerFactor\u002FhttpStreamWorkerMin` 会提示“需重启 service 生效”。\r\n- 全量刷新提示优化：自动刷新失败不再频繁弹错误 toast（改为日志告警）；手动刷新时才提示失败项名称和示例错误，减少“后台任务一直报错”的干扰。\r\n- 网关兼容性修复：针对 `\u002Fv1\u002Fresponses` 完成 no-cookie 场景恢复、参数白名单与非 codex 请求透传，多账号轮转 + failover 下的降级行为更稳定。\r\n- 选路与可用性修复：不可用账号不进入候选池；修复“手动锁定账号被预跳过导致不生效”；补强双 Codex 并发会话隔离与流式断流日志。\r\n- 新增 Service 一键启动器 `codexmanager-start`：单进程拉起 `service + web`，支持 `Ctrl+C` 联动关闭，降低“多进程手工启动”成本。\r\n- Service 版 `codexmanager-web` 支持 `embedded-ui`：前端静态资源内嵌进二进制，解压后无需额外 `web\u002F` 目录。\r\n- 新增 Service\u002FWeb Docker 独立部署与 `docker-compose` 编排，支持无桌面环境部署。","2026-02-28T09:40:37",{"id":229,"version":230,"summary_zh":231,"released_at":232},109231,"v0.1.2","- `v0.1.2`（最新，包含自 `v0.1.1` 以来全部更新）\r\n- 新增 Azure OpenAI 协议支持：平台 Key 可选择 `azure_openai`，支持独立 Endpoint 配置与 Azure API Key 鉴权链路。\r\n- 网关新增 Azure 专属转发模块（独立文件），在不破坏原有 OpenAI\u002FAnthropic 路径的前提下完成协议分流。\r\n- 平台 Key 弹窗优化：Azure 配置改为 `Endpoint + API Key` 直填模式，交互更直观。\r\n- 请求日志体验优化：当账号信息缺失时，账号列使用 Key 前缀兜底展示，避免空白。\r\n  > mac 启动需要按照以下流程\r\n  >\r\n  >首次运行前，请在终端执行：\r\n  >xattr -dr com.apple.quarantine \u002FApplications\u002FCodexManager.app\r\n  >然后执行：\r\n  >open \u002FApplications\u002FCodexManager.app \r\n","2026-02-27T11:50:42",{"id":234,"version":235,"summary_zh":236,"released_at":237},109232,"v0.1.1","- 启动速度优化：启动阶段改为“本地优先加载”（账号\u002F用量\u002F模型先读本地），模型列表引入本地缓存与后台按需刷新（缓存为空立即拉取，随后按周期刷新），显著降低首屏等待。\r\n- 网关模块重构：`gateway` 按 `auth\u002Fcore\u002Frequest\u002Frouting\u002Fobservability\u002Fupstream` 分层，代码可维护性与定位效率提升。\r\n- 前端交互优化：账号页与日志页显著降卡顿，筛选与刷新链路改为更稳定的异步合并策略。\r\n- 刷新体验升级：账号页“刷新所有”支持进度展示（完成\u002F剩余）与按钮 busy 稳定处理，避免“点了没反应”感知。\r\n- 账号导入增强：支持大批量导入分批处理，默认导入分组为 `IMPORT`，空分组账号自动补齐。\r\n- 用量状态统一：后端引入统一可用状态枚举，并透出到前端进行一致文案映射（可用\u002F单窗口可用\u002F不可用\u002F未知）。\r\n- 请求日志体验优化：窄屏下按优先级隐藏次要列，保留账号\u002F路径\u002F模型\u002F状态核心信息。\r\n- 按钮与布局统一：页面主按钮、操作列按钮与弹窗按钮统一尺寸规范，账号管理与仪表盘版心对齐。\r\n- 发布流程继续规范：`release-windows.yml`、`release-linux.yml`、`release-macos-beta.yml` ；Linux 构建缓存策略进一步优化。\r\n> mac 启动需要按照以下流程\r\n\r\n首次运行前，请在终端执行：\r\nxattr -dr com.apple.quarantine \u002FApplications\u002FCodexManager.app\r\n然后执行：\r\nopen \u002FApplications\u002FCodexManager.app ","2026-02-26T06:18:07",{"id":239,"version":240,"summary_zh":241,"released_at":242},109233,"v0.1.0","- `v0.1.x` 汇总（最近版本）\r\n- 更新能力重构：更新按钮改为“两段式”（先检查、再执行更新），设置页新增“当前版本”展示，更新状态反馈更清晰。\r\n- GitHub 版本检查增强：当 Release API 限流或失败时，自动回退到 Release 页面解析最新版本，减少“检查失败”概率。\r\n- 发布流程拆分：原多平台 workflow 拆分为 `release-windows.yml`、`release-linux.yml`、`release-macos-beta.yml`，全部保持手动触发。\r\n- macOS 内测分发：提供未签名内测包流程（`macos-beta`），并附带运行说明，避免误解为正式签名发布。\r\n- 便携更新流程优化：便携包改为单文件可执行形式（如 `CodexManager-portable.exe`），更新端不再依赖 marker 文件作为唯一判定。\r\n- 更新下载简化：完全移除 `checksums.txt` 依赖，更新按版本与资产命名规则直接匹配并拉取。","2026-02-24T10:38:06",{"id":244,"version":245,"summary_zh":246,"released_at":247},109234,"v0.0.9","添加Claude  Code Cli的转发支持\r\n网关协议适配继续拆分，protocol_adapter 的请求映射与响应转换进一步模块化，响应转换已按 JSON\u002FSSE 独立子模块维护。\r\n后端路由边界收敛，统一 backend router 分发路径，减少网关\u002F代理双栈重复逻辑。\r\n稳定性增强：前端刷新链路与请求日志竞态治理完成，复制能力统一为 clipboard API + execCommand fallback，关键事件绑定更稳。\r\n安全与运行时控制增强：\u002Frpc token 鉴权强制开启，请求闸门等待预算、上游连接超时、代理 body 限制、账号并发上限均支持环境变量置。\r\n 可观测性增强：补齐 route\u002Fstatus_class\u002Fprotocol 维度指标，并新增 RPC 与 usage refresh 相关指标。\r\n发布链路增强且保持手动触发：release workflow 新增 run_verify 可选质量门、目标 SHA 追踪、RELEASE-META.txt 元信息产物。\r\n 发布脚本对齐：rebuild.ps1 已对齐 workflow 输入 tag\u002Fref\u002Frun_verify，并按 head_sha 轮询匹配正确 workflow run。\r\n","2026-02-16T04:44:09",{"id":249,"version":250,"summary_zh":251,"released_at":252},109235,"v0.0.8","  - 持续推进服务端 gateway 模块化，拆分 upstream \u002F local_validation \u002F model_picker \u002F request_rewrite 等子模块。\r\n  - 前端入口与事件绑定进一步解耦，主流程更清晰，后续改 UI 和交互成本更低。\r\n  - 测试目录统一迁移到与 src 同级的 tests 结构。\r\n  - 发布链路修复并统一产物策略，三平台打包路径更一致。\r\n  - 安全增强：缓解渲染层 XSS 风险，并强化桌面端 CSP 策略。","2026-02-14T05:46:30"]