[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"similar-UfoMiao--zcf":3,"tool-UfoMiao--zcf":61},[4,18,26,36,44,53],{"id":5,"name":6,"github_repo":7,"description_zh":8,"stars":9,"difficulty_score":10,"last_commit_at":11,"category_tags":12,"status":17},4358,"openclaw","openclaw\u002Fopenclaw","OpenClaw 是一款专为个人打造的本地化 AI 助手，旨在让你在自己的设备上拥有完全可控的智能伙伴。它打破了传统 AI 助手局限于特定网页或应用的束缚，能够直接接入你日常使用的各类通讯渠道，包括微信、WhatsApp、Telegram、Discord、iMessage 等数十种平台。无论你在哪个聊天软件中发送消息，OpenClaw 都能即时响应，甚至支持在 macOS、iOS 和 Android 设备上进行语音交互，并提供实时的画布渲染功能供你操控。\n\n这款工具主要解决了用户对数据隐私、响应速度以及“始终在线”体验的需求。通过将 AI 部署在本地，用户无需依赖云端服务即可享受快速、私密的智能辅助，真正实现了“你的数据，你做主”。其独特的技术亮点在于强大的网关架构，将控制平面与核心助手分离，确保跨平台通信的流畅性与扩展性。\n\nOpenClaw 非常适合希望构建个性化工作流的技术爱好者、开发者，以及注重隐私保护且不愿被单一生态绑定的普通用户。只要具备基础的终端操作能力（支持 macOS、Linux 及 Windows WSL2），即可通过简单的命令行引导完成部署。如果你渴望拥有一个懂你",349277,3,"2026-04-06T06:32:30",[13,14,15,16],"Agent","开发框架","图像","数据工具","ready",{"id":19,"name":20,"github_repo":21,"description_zh":22,"stars":23,"difficulty_score":10,"last_commit_at":24,"category_tags":25,"status":17},3808,"stable-diffusion-webui","AUTOMATIC1111\u002Fstable-diffusion-webui","stable-diffusion-webui 是一个基于 Gradio 构建的网页版操作界面，旨在让用户能够轻松地在本地运行和使用强大的 Stable Diffusion 图像生成模型。它解决了原始模型依赖命令行、操作门槛高且功能分散的痛点，将复杂的 AI 绘图流程整合进一个直观易用的图形化平台。\n\n无论是希望快速上手的普通创作者、需要精细控制画面细节的设计师，还是想要深入探索模型潜力的开发者与研究人员，都能从中获益。其核心亮点在于极高的功能丰富度：不仅支持文生图、图生图、局部重绘（Inpainting）和外绘（Outpainting）等基础模式，还独创了注意力机制调整、提示词矩阵、负向提示词以及“高清修复”等高级功能。此外，它内置了 GFPGAN 和 CodeFormer 等人脸修复工具，支持多种神经网络放大算法，并允许用户通过插件系统无限扩展能力。即使是显存有限的设备，stable-diffusion-webui 也提供了相应的优化选项，让高质量的 AI 艺术创作变得触手可及。",162132,"2026-04-05T11:01:52",[14,15,13],{"id":27,"name":28,"github_repo":29,"description_zh":30,"stars":31,"difficulty_score":32,"last_commit_at":33,"category_tags":34,"status":17},1381,"everything-claude-code","affaan-m\u002Feverything-claude-code","everything-claude-code 是一套专为 AI 编程助手（如 Claude Code、Codex、Cursor 等）打造的高性能优化系统。它不仅仅是一组配置文件，而是一个经过长期实战打磨的完整框架，旨在解决 AI 代理在实际开发中面临的效率低下、记忆丢失、安全隐患及缺乏持续学习能力等核心痛点。\n\n通过引入技能模块化、直觉增强、记忆持久化机制以及内置的安全扫描功能，everything-claude-code 能显著提升 AI 在复杂任务中的表现，帮助开发者构建更稳定、更智能的生产级 AI 代理。其独特的“研究优先”开发理念和针对 Token 消耗的优化策略，使得模型响应更快、成本更低，同时有效防御潜在的攻击向量。\n\n这套工具特别适合软件开发者、AI 研究人员以及希望深度定制 AI 工作流的技术团队使用。无论您是在构建大型代码库，还是需要 AI 协助进行安全审计与自动化测试，everything-claude-code 都能提供强大的底层支持。作为一个曾荣获 Anthropic 黑客大奖的开源项目，它融合了多语言支持与丰富的实战钩子（hooks），让 AI 真正成长为懂上",155373,2,"2026-04-14T11:34:08",[14,13,35],"语言模型",{"id":37,"name":38,"github_repo":39,"description_zh":40,"stars":41,"difficulty_score":32,"last_commit_at":42,"category_tags":43,"status":17},2271,"ComfyUI","Comfy-Org\u002FComfyUI","ComfyUI 是一款功能强大且高度模块化的视觉 AI 引擎，专为设计和执行复杂的 Stable Diffusion 图像生成流程而打造。它摒弃了传统的代码编写模式，采用直观的节点式流程图界面，让用户通过连接不同的功能模块即可构建个性化的生成管线。\n\n这一设计巧妙解决了高级 AI 绘图工作流配置复杂、灵活性不足的痛点。用户无需具备编程背景，也能自由组合模型、调整参数并实时预览效果，轻松实现从基础文生图到多步骤高清修复等各类复杂任务。ComfyUI 拥有极佳的兼容性，不仅支持 Windows、macOS 和 Linux 全平台，还广泛适配 NVIDIA、AMD、Intel 及苹果 Silicon 等多种硬件架构，并率先支持 SDXL、Flux、SD3 等前沿模型。\n\n无论是希望深入探索算法潜力的研究人员和开发者，还是追求极致创作自由度的设计师与资深 AI 绘画爱好者，ComfyUI 都能提供强大的支持。其独特的模块化架构允许社区不断扩展新功能，使其成为当前最灵活、生态最丰富的开源扩散模型工具之一，帮助用户将创意高效转化为现实。",108322,"2026-04-10T11:39:34",[14,15,13],{"id":45,"name":46,"github_repo":47,"description_zh":48,"stars":49,"difficulty_score":32,"last_commit_at":50,"category_tags":51,"status":17},6121,"gemini-cli","google-gemini\u002Fgemini-cli","gemini-cli 是一款由谷歌推出的开源 AI 命令行工具，它将强大的 Gemini 大模型能力直接集成到用户的终端环境中。对于习惯在命令行工作的开发者而言，它提供了一条从输入提示词到获取模型响应的最短路径，无需切换窗口即可享受智能辅助。\n\n这款工具主要解决了开发过程中频繁上下文切换的痛点，让用户能在熟悉的终端界面内直接完成代码理解、生成、调试以及自动化运维任务。无论是查询大型代码库、根据草图生成应用，还是执行复杂的 Git 操作，gemini-cli 都能通过自然语言指令高效处理。\n\n它特别适合广大软件工程师、DevOps 人员及技术研究人员使用。其核心亮点包括支持高达 100 万 token 的超长上下文窗口，具备出色的逻辑推理能力；内置 Google 搜索、文件操作及 Shell 命令执行等实用工具；更独特的是，它支持 MCP（模型上下文协议），允许用户灵活扩展自定义集成，连接如图像生成等外部能力。此外，个人谷歌账号即可享受免费的额度支持，且项目基于 Apache 2.0 协议完全开源，是提升终端工作效率的理想助手。",100752,"2026-04-10T01:20:03",[52,13,15,14],"插件",{"id":54,"name":55,"github_repo":56,"description_zh":57,"stars":58,"difficulty_score":32,"last_commit_at":59,"category_tags":60,"status":17},4721,"markitdown","microsoft\u002Fmarkitdown","MarkItDown 是一款由微软 AutoGen 团队打造的轻量级 Python 工具，专为将各类文件高效转换为 Markdown 格式而设计。它支持 PDF、Word、Excel、PPT、图片（含 OCR）、音频（含语音转录）、HTML 乃至 YouTube 链接等多种格式的解析，能够精准提取文档中的标题、列表、表格和链接等关键结构信息。\n\n在人工智能应用日益普及的今天，大语言模型（LLM）虽擅长处理文本，却难以直接读取复杂的二进制办公文档。MarkItDown 恰好解决了这一痛点，它将非结构化或半结构化的文件转化为模型“原生理解”且 Token 效率极高的 Markdown 格式，成为连接本地文件与 AI 分析 pipeline 的理想桥梁。此外，它还提供了 MCP（模型上下文协议）服务器，可无缝集成到 Claude Desktop 等 LLM 应用中。\n\n这款工具特别适合开发者、数据科学家及 AI 研究人员使用，尤其是那些需要构建文档检索增强生成（RAG）系统、进行批量文本分析或希望让 AI 助手直接“阅读”本地文件的用户。虽然生成的内容也具备一定可读性，但其核心优势在于为机器",93400,"2026-04-06T19:52:38",[52,14],{"id":62,"github_repo":63,"name":64,"description_en":65,"description_zh":66,"ai_summary_zh":66,"readme_en":67,"readme_zh":68,"quickstart_zh":69,"use_case_zh":70,"hero_image_url":71,"owner_login":72,"owner_name":72,"owner_avatar_url":73,"owner_bio":74,"owner_company":75,"owner_location":75,"owner_email":75,"owner_twitter":75,"owner_website":75,"owner_url":76,"languages":77,"stars":89,"forks":90,"last_commit_at":91,"license":92,"difficulty_score":93,"env_os":94,"env_gpu":94,"env_ram":94,"env_deps":95,"category_tags":101,"github_topics":102,"view_count":32,"oss_zip_url":75,"oss_zip_packed_at":75,"status":17,"created_at":122,"updated_at":123,"faqs":124,"releases":165},7527,"UfoMiao\u002Fzcf","zcf","Zero-Config Code Flow for Claude code & Codex","zcf（Zero-Config Code Flow）是一款专为 Claude Code 和 Codex 打造的零配置开发流程工具。它旨在解决开发者在使用前沿 AI 编程助手时，面临的环境配置繁琐、多语言支持不足以及智能体系统搭建困难等痛点。通过“一键式”设置，zcf 让用户无需编写复杂的配置文件，即可快速启动并运行个性化的 AI 编程环境。\n\n该工具特别适合希望提升编码效率的软件开发人员、技术研究人员以及热衷于探索 AI 辅助编程的极客用户。无论是新手还是资深工程师，都能利用它轻松集成双语支持（中文\u002F英文）和智能代理系统，从而更专注于代码逻辑本身而非环境调试。\n\nzcf 的核心亮点在于其真正的“零配置”理念与高度智能化的交互设计。它不仅提供了直观的交互式菜单（通过 `npx zcf` 即可唤起），还内置了灵活的智能体系统，能够根据用户需求动态调整 AI 助手的行为模式。此外，项目拥有完善的文档支持和活跃的社区生态，确保用户在使用过程中能获得稳定、流畅且高效的编码体验。","[![npm version][npm-version-src]][npm-version-href]\n[![npm downloads][npm-downloads-src]][npm-downloads-href]\n[![License][license-src]][license-href]\n[![Claude Code][claude-code-src]][claude-code-href]\n[![codecov][codecov-src]][codecov-href]\n[![JSDocs][jsdocs-src]][jsdocs-href]\n[![Ask DeepWiki][deepwiki-src]][deepwiki-href]\n\n\u003Cdiv align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FUfoMiao_zcf_readme_4c9c1f6b2c21.webp\" alt=\"Banner\"\u002F>\n\n  \u003Ch1>\n    ZCF - Zero-Config Code Flow\n  \u003C\u002Fh1>\n\n  \u003Cp align=\"center\">\n  \u003Cb>English\u003C\u002Fb> | \u003Ca href=\"README_zh-CN.md\">中文\u003C\u002Fa> | \u003Ca href=\"README_ja-JP.md\">日本語\u003C\u002Fa> | \u003Ca href=\"CHANGELOG.md\">Changelog\u003C\u002Fa>\n\n**✨ Full Documentation**: [ZCF Docs](https:\u002F\u002Fzcf.ufomiao.com\u002F)\n\n> Zero-config, one-click setup for Claude Code & Codex with bilingual support, intelligent agent system and personalized AI assistant\n\u003C\u002Fp>\n\u003C\u002Fdiv>\n\n## ♥️ Sponsors\n\n[![GLM](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FUfoMiao_zcf_readme_9d4a89ff62b5.png)](https:\u002F\u002Fz.ai\u002Fsubscribe?ic=8JVLJQFSKB)\n\nThis project is sponsored by Z.ai, supporting us with their GLM CODING PLAN.\nGLM CODING PLAN is a subscription service designed for AI coding, starting at just $10\u002Fmonth. It provides access to their flagship GLM-4.7 & （GLM-5 Only Available  for Pro Users）model across 10+ popular AI coding tools (Claude Code, Cline, Roo Code, etc.), offering developers top-tier, fast, and stable coding experiences.\nGet 10% OFF GLM CODING PLAN：https:\u002F\u002Fz.ai\u002Fsubscribe?ic=8JVLJQFSKB\n\n---\n\n[![Sponsor AI API](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FUfoMiao_zcf_readme_496f2688ff83.jpg)](https:\u002F\u002Fshare.302.ai\u002FgAT9VG)\n[302.AI](https:\u002F\u002Fshare.302.ai\u002FgAT9VG) is a pay-as-you-go enterprise AI resource hub that offers the latest and most comprehensive AI models and APIs on the market, along with a variety of ready-to-use online AI applications.\n\n---\n\n\u003Ctable>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd width=\"180\">\u003Ca href=\"https:\u002F\u002Fwww.packyapi.com\u002Fregister?aff=zcf\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FUfoMiao_zcf_readme_566804b8936a.png\" alt=\"PackyCode\" width=\"150\">\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Thanks to PackyCode for sponsoring this project! PackyCode is a reliable and efficient API relay service provider, offering relay services for Claude Code, Codex, Gemini, and more. PackyCode provides special discounts for our software users: register using  \u003Ca href=\"https:\u002F\u002Fwww.packyapi.com\u002Fregister?aff=zcf\">this link\u003C\u002Fa>  and enter the \"zcf\" promo code during recharge to get 10% off.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd width=\"180\">\u003Ca href=\"https:\u002F\u002Fwww.aicodemirror.com\u002Fregister?invitecode=ZCFZCF\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FUfoMiao_zcf_readme_6a9c99218cac.jpg\" alt=\"AICodeMirror\" width=\"150\">\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Thanks to AICodeMirror for sponsoring this project! AICodeMirror provides official high-stability relay services for Claude Code\u002FCodex\u002FGemini CLI, supporting enterprise-level high concurrency, fast invoicing, and 7x24 dedicated technical support. Official channels for Claude Code\u002FCodex\u002FGemini at discounts as low as 38%\u002F2%\u002F10.9% off, with additional discounts on top-ups! AICodeMirror offers special benefits for ZCF users: users who register through \u003Ca href=\"https:\u002F\u002Fwww.aicodemirror.com\u002Fregister?invitecode=ZCFZCF\">this link\u003C\u002Fa> can enjoy 20% off on first top-up, and enterprise customers can get up to 25% off!\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd width=\"180\">\u003Ca href=\"https:\u002F\u002Fcrazyrouter.com\u002F?utm_source=github&utm_medium=sponsor&utm_campaign=zcf&aff=yJFo\">\u003Cimg src=\".\u002Fsrc\u002Fassets\u002Fcrazyrouter.svg\" alt=\"Crazyrouter\" width=\"150\">\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>Thanks to Crazyrouter for sponsoring this project! Crazyrouter is a high-performance AI API aggregation gateway — one API key for 300+ models (GPT, Claude, Gemini, DeepSeek, and more). All models at 55% of official pricing with auto-failover, smart routing, and unlimited concurrency. Fully OpenAI-compatible, works seamlessly with Claude Code, Codex, and Gemini CLI. Crazyrouter offers an exclusive deal for ZCF users: register via \u003Ca href=\"https:\u002F\u002Fcrazyrouter.com\u002F?utm_source=github&utm_medium=sponsor&utm_campaign=zcf&aff=yJFo\">this link\u003C\u002Fa> to get $2 free credit instantly!\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\n## 🚀 Quick Start\n\n- Recommended: `npx zcf` opens the interactive menu — pick what you need.\n- Common commands:\n\n```bash\nnpx zcf i        # Full initialization: install + workflows + API\u002FCCR + MCP\nnpx zcf u        # Update workflows only\nnpx zcf --lang zh-CN  # Switch interface language (example)\n```\n\n- Non-interactive example (provider preset):\n\n```bash\nnpx zcf i -s -p 302ai -k \"sk-xxx\"\n```\n\nMore usage, options, and workflows: see documentation.\n\n## 📖 Full Documentation\n\n- https:\u002F\u002Fzcf.ufomiao.com\u002F\n\n## 💬 Community\n\nJoin our Telegram group for support, discussions, and updates:\n\n[![Telegram](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FTelegram-Join%20Chat-blue?style=flat&logo=telegram)](https:\u002F\u002Ft.me\u002Fufomiao_zcf)\n\n## 🙏 Acknowledgments\n\nThis project is inspired by and incorporates work from:\n\n- [LINUX DO - New Ideal Community](https:\u002F\u002Flinux.do)\n- [CCR](https:\u002F\u002Fgithub.com\u002Fmusistudio\u002Fclaude-code-router)\n- [CCometixLine](https:\u002F\u002Fgithub.com\u002FHaleclipse\u002FCCometixLine)\n- [ccusage](https:\u002F\u002Fgithub.com\u002Fryoppippi\u002Fccusage)\n- [BMad Method](https:\u002F\u002Fgithub.com\u002Fbmad-code-org\u002FBMAD-METHOD)\n\nThanks to these community contributors for sharing!\n\n## ❤️ Support & Sponsors\n\nIf you find this project helpful, please consider sponsoring its development. Your support is greatly appreciated!\n\n[![ko-fi](https:\u002F\u002Fko-fi.com\u002Fimg\u002Fgithubbutton_sm.svg)](https:\u002F\u002Fko-fi.com\u002FUfoMiao)\n\n\u003Ctable>\n  \u003Ctr>\n    \u003Ctd>\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FUfoMiao_zcf_readme_d8a15ff1ec8c.webp\" width=\"200\" alt=\"Alipay\" \u002F>\u003C\u002Ftd>\n    \u003Ctd>\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FUfoMiao_zcf_readme_158b5526cb3f.webp\" width=\"200\" alt=\"WeChat Pay\" \u002F>\u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\n### Our Sponsors\n\nA huge thank you to all our sponsors for their generous support!\n\n【Corporate Sponsors】\n\n- [302.AI](https:\u002F\u002Fshare.302.ai\u002FgAT9VG) (first corporate sponsorship 🤠)\n- [GLM](https:\u002F\u002Fz.ai\u002Fsubscribe?ic=8JVLJQFSKB) (first AI model sponsorship 🤖)\n- [PackyCode](https:\u002F\u002Fwww.packyapi.com\u002Fregister?aff=zcf) (first API proxy service sponsor 🧝🏻‍♀️)\n- [AICodeMirror](https:\u002F\u002Fwww.aicodemirror.com\u002Fregister?invitecode=ZCFZCF) (official high-stability relay service sponsor 🪞)\n- [UUCode](https:\u002F\u002Fwww.uucode.org\u002Fauth?ref=JQ2DJ1T8) (sponsored $100 proxy credits 💰)\n- [Crazyrouter](https:\u002F\u002Fcrazyrouter.com\u002F?utm_source=github&utm_medium=sponsor&utm_campaign=zcf&aff=yJFo) (AI API aggregation gateway sponsor 🚀)\n\n【Individual Sponsors】\n\n- Tc (first sponsor)\n- Argolinhas (first ko-fi sponsor ٩(•̤̀ᵕ•̤́๑))\n- r\\*r (first anonymous sponsor 🤣)\n- \\*\\*康 (first KFC sponsor 🍗)\n- \\*东 (first coffee sponsor ☕️)\n- 炼\\*3 (first Termux user sponsor 📱)\n- [chamo101](https:\u002F\u002Fgithub.com\u002Fchamo101) (first GitHub issue sponsor 🎉)\n- 初屿贤 (first Codex user sponsor 🙅🏻‍♂️)\n- Protein (first 1688 sponsor 😏)\n- [musistudio](https:\u002F\u002Fgithub.com\u002Fmusistudio) (first open source project author sponsor, the author of [CCR](https:\u002F\u002Fgithub.com\u002Fmusistudio\u002Fclaude-code-router) 🤩)\n- \\*年 (first 100 CNY sponsor 💴)\n- [BeatSeat](https:\u002F\u002Fgithub.com\u002FBeatSeat) (community expert 😎, provided $1000 Claude credits)\n- [wenwen](https:\u002F\u002Fgithub.com\u002Fwenwen12345) (community expert 🤓, provided daily $100 Claude&GPT credits)\n- 16°C coffee (My best friend 🤪, offered ChatGPT Pro $200 package)\n\n### Promotion Thanks\n\nThanks to the following authors for promoting this project:\n\n- 逛逛 GitHub, article: https:\u002F\u002Fmp.weixin.qq.com\u002Fs\u002FphqwSRb16MKCHHVozTFeiQ\n- Geek, tweet: https:\u002F\u002Fx.com\u002Fgeekbb\u002Fstatus\u002F1955174718618866076\n\n## 📄 License\n\n[MIT License](LICENSE)\n\n---\n\n## 🚀 Contributors\n\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002FUfoMiao\u002Fzcf\u002Fgraphs\u002Fcontributors\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FUfoMiao_zcf_readme_cf14fcea728b.png\" \u002F>\n\u003C\u002Fa>\n\u003Cbr \u002F>\u003Cbr \u002F>\n\n## ⭐️ Star History\n\nIf this project helps you, please give me a ⭐️ Star!\n\n[![Star History Chart](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FUfoMiao_zcf_readme_a919d73e8aee.png)](https:\u002F\u002Fstar-history.com\u002F#UfoMiao\u002Fzcf&Date)\n\n\u003C!-- Badges -->\n\n[npm-version-src]: https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Fzcf?style=flat&colorA=080f12&colorB=1fa669\n[npm-version-href]: https:\u002F\u002Fnpmjs.com\u002Fpackage\u002Fzcf\n[npm-downloads-src]: https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fdm\u002Fzcf?style=flat&colorA=080f12&colorB=1fa669\n[npm-downloads-href]: https:\u002F\u002Fnpmjs.com\u002Fpackage\u002Fzcf\n[license-src]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002Fufomiao\u002Fzcf.svg?style=flat&colorA=080f12&colorB=1fa669\n[license-href]: https:\u002F\u002Fgithub.com\u002Fufomiao\u002Fzcf\u002Fblob\u002Fmain\u002FLICENSE\n[claude-code-src]: https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FClaude-Code-1fa669?style=flat&colorA=080f12&colorB=1fa669\n[claude-code-href]: https:\u002F\u002Fclaude.ai\u002Fcode\n[codecov-src]: https:\u002F\u002Fcodecov.io\u002Fgh\u002FUfoMiao\u002Fzcf\u002Fgraph\u002Fbadge.svg?token=HZI6K4Y7D7&style=flat&colorA=080f12&colorB=1fa669\n[codecov-href]: https:\u002F\u002Fcodecov.io\u002Fgh\u002FUfoMiao\u002Fzcf\n[jsdocs-src]: https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fjsdocs-reference-1fa669?style=flat&colorA=080f12&colorB=1fa669\n[jsdocs-href]: https:\u002F\u002Fwww.jsdocs.io\u002Fpackage\u002Fzcf\n[deepwiki-src]: https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FAsk-DeepWiki-1fa669?style=flat&colorA=080f12&colorB=1fa669\n[deepwiki-href]: https:\u002F\u002Fdeepwiki.com\u002FUfoMiao\u002Fzcf\n","[![npm版本][npm-version-src]][npm-version-href]\n[![npm downloads][npm-downloads-src]][npm-downloads-href]\n[![License][license-src]][license-href]\n[![Claude Code][claude-code-src]][claude-code-href]\n[![codecov][codecov-src]][codecov-href]\n[![JSDocs][jsdocs-src]][jsdocs-href]\n[![Ask DeepWiki][deepwiki-src]][deepwiki-href]\n\n\u003Cdiv align=\"center\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FUfoMiao_zcf_readme_4c9c1f6b2c21.webp\" alt=\"Banner\"\u002F>\n\n  \u003Ch1>\n    ZCF - 零配置代码流程\n  \u003C\u002Fh1>\n\n  \u003Cp align=\"center\">\n  \u003Cb>English\u003C\u002Fb> | \u003Ca href=\"README_zh-CN.md\">中文\u003C\u002Fa> | \u003Ca href=\"README_ja-JP.md\">日本語\u003C\u002Fa> | \u003Ca href=\"CHANGELOG.md\">Changelog\u003C\u002Fa>\n\n**✨ 完整文档**: [ZCF Docs](https:\u002F\u002Fzcf.ufomiao.com\u002F)\n\n> 零配置、一键设置 Claude Code 和 Codex，支持双语，配备智能代理系统和个性化 AI 助手\n\u003C\u002Fp>\n\u003C\u002Fdiv>\n\n## ♥️ 赞助商\n\n[![GLM](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FUfoMiao_zcf_readme_9d4a89ff62b5.png)](https:\u002F\u002Fz.ai\u002Fsubscribe?ic=8JVLJQFSKB)\n\n本项目由 Z.ai 赞助，他们通过 GLM 编码计划支持我们。GLM 编码计划是一项专为 AI 编码设计的订阅服务，每月仅需 10 美元起。它使开发者能够访问其旗舰模型 GLM-4.7（GLM-5 仅对 Pro 用户开放），并集成到 10 多种流行的 AI 编码工具中（如 Claude Code、Cline、Roo Code 等），为开发者提供顶级、快速且稳定的编码体验。\n享受 GLM 编码计划 10% 折扣：https:\u002F\u002Fz.ai\u002Fsubscribe?ic=8JVLJQFSKB\n\n---\n\n[![赞助 AI API](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FUfoMiao_zcf_readme_496f2688ff83.jpg)](https:\u002F\u002Fshare.302.ai\u002FgAT9VG)\n[302.AI](https:\u002F\u002Fshare.302.ai\u002FgAT9VG) 是一个按使用付费的企业级 AI 资源中心，提供市场上最新、最全面的 AI 模型和 API，以及多种即用型在线 AI 应用程序。\n\n---\n\n\u003Ctable>\n\u003Ctbody>\n\u003Ctr>\n\u003Ctd width=\"180\">\u003Ca href=\"https:\u002F\u002Fwww.packyapi.com\u002Fregister?aff=zcf\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FUfoMiao_zcf_readme_566804b8936a.png\" alt=\"PackyCode\" width=\"150\">\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>感谢 PackyCode 对本项目的赞助！PackyCode 是一家可靠高效的 API 中继服务提供商，为 Claude Code、Codex、Gemini 等提供中继服务。PackyCode 为我们的软件用户提供特别折扣：使用 \u003Ca href=\"https:\u002F\u002Fwww.packyapi.com\u002Fregister?aff=zcf\">此链接\u003C\u002Fa> 注册，并在充值时输入优惠码 “zcf”，即可享受 10% 的折扣。\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd width=\"180\">\u003Ca href=\"https:\u002F\u002Fwww.aicodemirror.com\u002Fregister?invitecode=ZCFZCF\">\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FUfoMiao_zcf_readme_6a9c99218cac.jpg\" alt=\"AICodeMirror\" width=\"150\">\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>感谢 AICodeMirror 对本项目的赞助！AICodeMirror 为 Claude Code\u002FCodex\u002FGemini CLI 提供官方高稳定性中继服务，支持企业级高并发、快速开票以及 7x24 小时专属技术支持。Claude Code\u002FCodex\u002FGemini 的官方渠道可享受低至 38%\u002F2%\u002F10.9% 的折扣，叠加充值优惠！AICodeMirror 为 ZCF 用户提供特别福利：通过 \u003Ca href=\"https:\u002F\u002Fwww.aicodemirror.com\u002Fregister?invitecode=ZCFZCF\">此链接\u003C\u002Fa> 注册的用户首次充值可享 20% 折扣，企业客户最高可享 25% 折扣！\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd width=\"180\">\u003Ca href=\"https:\u002F\u002Fcrazyrouter.com\u002F?utm_source=github&utm_medium=sponsor&utm_campaign=zcf&aff=yJFo\">\u003Cimg src=\".\u002Fsrc\u002Fassets\u002Fcrazyrouter.svg\" alt=\"Crazyrouter\" width=\"150\">\u003C\u002Fa>\u003C\u002Ftd>\n\u003Ctd>感谢 Crazyrouter 对本项目的赞助！Crazyrouter 是一款高性能的 AI API 聚合网关——只需一个 API 密钥即可访问 300 多种模型（GPT、Claude、Gemini、DeepSeek 等）。所有模型均以官方定价的 55% 提供，具备自动故障转移、智能路由和无限并发能力。完全兼容 OpenAI，可无缝对接 Claude Code、Codex 和 Gemini CLI。Crazyrouter 为 ZCF 用户提供独家优惠：通过 \u003Ca href=\"https:\u002F\u002Fcrazyrouter.com\u002F?utm_source=github&utm_medium=sponsor&utm_campaign=zcf&aff=yJFo\">此链接\u003C\u002Fa> 注册，即可立即获得 2 美元免费额度！\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\n\u003C\u002Ftable>\n\n## 🚀 快速入门\n\n- 推荐：`npx zcf` 打开交互式菜单——选择你需要的内容。\n- 常用命令：\n\n```bash\nnpx zcf i        # 完整初始化：安装 + 工作流 + API\u002FCCR + MCP\nnpx zcf u        # 仅更新工作流\nnpx zcf --lang zh-CN  # 切换界面语言（示例）\n```\n\n- 非交互式示例（预设提供商）：\n\n```bash\nnpx zcf i -s -p 302ai -k \"sk-xxx\"\n```\n\n更多用法、选项和工作流，请参阅文档。\n\n## 📖 全文档\n\n- https:\u002F\u002Fzcf.ufomiao.com\u002F\n\n## 💬 社区\n\n加入我们的 Telegram 群组，获取支持、讨论和最新动态：\n\n[![Telegram](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FTelegram-Join%20Chat-blue?style=flat&logo=telegram)](https:\u002F\u002Ft.me\u002Fufomiao_zcf)\n\n## 🙏 致谢\n\n本项目受到以下项目和工作的启发，并整合了其中的部分内容：\n\n- [LINUX DO - 新理想社区](https:\u002F\u002Flinux.do)\n- [CCR](https:\u002F\u002Fgithub.com\u002Fmusistudio\u002Fclaude-code-router)\n- [CCometixLine](https:\u002F\u002Fgithub.com\u002FHaleclipse\u002FCCometixLine)\n- [ccusage](https:\u002F\u002Fgithub.com\u002Fryoppippi\u002Fccusage)\n- [BMad 方法](https:\u002F\u002Fgithub.com\u002Fbmad-code-org\u002FBMAD-METHOD)\n\n感谢这些社区贡献者们的分享！\n\n## ❤️ 支持与赞助\n\n如果您觉得本项目有所帮助，请考虑赞助其开发。您的支持将不胜感激！\n\n[![ko-fi](https:\u002F\u002Fko-fi.com\u002Fimg\u002Fgithubbutton_sm.svg)](https:\u002F\u002Fko-fi.com\u002FUfoMiao)\n\n\u003Ctable>\n  \u003Ctr>\n    \u003Ctd>\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FUfoMiao_zcf_readme_d8a15ff1ec8c.webp\" width=\"200\" alt=\"支付宝\" \u002F>\u003C\u002Ftd>\n    \u003Ctd>\u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FUfoMiao_zcf_readme_158b5526cb3f.webp\" width=\"200\" alt=\"微信支付\" \u002F>\u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\n### 我们的赞助商\n\n衷心感谢所有赞助商的慷慨支持！\n\n【企业赞助商】\n\n- [302.AI](https:\u002F\u002Fshare.302.ai\u002FgAT9VG)（首个企业赞助 🤠）\n- [GLM](https:\u002F\u002Fz.ai\u002Fsubscribe?ic=8JVLJQFSKB)（首个 AI 模型赞助 🤖）\n- [PackyCode](https:\u002F\u002Fwww.packyapi.com\u002Fregister?aff=zcf)（首个 API 代理服务赞助 🧝🏻‍♀️）\n- [AICodeMirror](https:\u002F\u002Fwww.aicodemirror.com\u002Fregister?invitecode=ZCFZCF)（官方高稳定性中继服务赞助 🪞）\n- [UUCode](https:\u002F\u002Fwww.uucode.org\u002Fauth?ref=JQ2DJ1T8)（赞助 100 美元代理积分 💰）\n- [Crazyrouter](https:\u002F\u002Fcrazyrouter.com\u002F?utm_source=github&utm_medium=sponsor&utm_campaign=zcf&aff=yJFo)（AI API 聚合网关赞助 🚀）\n\n【个人赞助商】\n\n- Tc（首位赞助人）\n- Argolinhas（首位 ko-fi 赞助人 ٩(•̤̀ᵕ•̤́๑)）\n- r\\*r（首位匿名赞助人 🤣）\n- \\*\\*康（首位 KFC 赞助人 🍗）\n- \\*东（首位咖啡赞助人 ☕️）\n- 炼\\*3（首位 Termux 用户赞助 📱）\n- [chamo101](https:\u002F\u002Fgithub.com\u002Fchamo101)（首位 GitHub issue 赞助人 🎉）\n- 初屿贤（首位 Codex 用户赞助 🙅🏻‍♂️）\n- Protein（首位 1688 赞助人 😏）\n- [musistudio](https:\u002F\u002Fgithub.com\u002Fmusistudio)（首位开源项目作者赞助，CCR 的作者 🤩）\n- \\*年（首位 100 元人民币赞助 💴）\n- [BeatSeat](https:\u002F\u002Fgithub.com\u002FBeatSeat)（社区专家 😎，提供了价值 1000 元的 Claude 积分）\n- [wenwen](https:\u002F\u002Fgithub.com\u002Fwenwen12345)（社区专家 🤓，每天提供价值 100 元的 Claude 和 GPT 积分）\n- 16°C coffee（我最好的朋友 🤪，赠送了 ChatGPT Pro 价值 200 美元的套餐）\n\n### 感谢推广\n\n感谢以下作者对本项目的推广：\n\n- 逛逛 GitHub，文章：https:\u002F\u002Fmp.weixin.qq.com\u002Fs\u002FphqwSRb16MKCHHVozTFeiQ\n- Geek，推文：https:\u002F\u002Fx.com\u002Fgeekbb\u002Fstatus\u002F1955174718618866076\n\n## 📄 许可证\n\n[MIT 许可证](LICENSE)\n\n---\n\n## 🚀 贡献者\n\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002FUfoMiao\u002Fzcf\u002Fgraphs\u002Fcontributors\">\n  \u003Cimg src=\"https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FUfoMiao_zcf_readme_cf14fcea728b.png\" \u002F>\n\u003C\u002Fa>\n\u003Cbr \u002F>\u003Cbr \u002F>\n\n## ⭐️ 星标历史\n\n如果这个项目对您有帮助，请为我点个 ⭐️ 星吧！\n\n[![星标历史图表](https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FUfoMiao_zcf_readme_a919d73e8aee.png)](https:\u002F\u002Fstar-history.com\u002F#UfoMiao\u002Fzcf&Date)\n\n\u003C!-- 徽章 -->\n\n[npm-version-src]: https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002Fzcf?style=flat&colorA=080f12&colorB=1fa669\n[npm-version-href]: https:\u002F\u002Fnpmjs.com\u002Fpackage\u002Fzcf\n[npm-downloads-src]: https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fdm\u002Fzcf?style=flat&colorA=080f12&colorB=1fa669\n[npm-downloads-href]: https:\u002F\u002Fnpmjs.com\u002Fpackage\u002Fzcf\n[license-src]: https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flicense\u002Fufomiao\u002Fzcf.svg?style=flat&colorA=080f12&colorB=1fa669\n[license-href]: https:\u002F\u002Fgithub.com\u002Fufomiao\u002Fzcf\u002Fblob\u002Fmain\u002FLICENSE\n[claude-code-src]: https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FClaude-Code-1fa669?style=flat&colorA=080f12&colorB=1fa669\n[claude-code-href]: https:\u002F\u002Fclaude.ai\u002Fcode\n[codecov-src]: https:\u002F\u002Fcodecov.io\u002Fgh\u002FUfoMiao\u002Fzcf\u002Fgraph\u002Fbadge.svg?token=HZI6K4Y7D7&style=flat&colorA=080f12&colorB=1fa669\n[codecov-href]: https:\u002F\u002Fcodecov.io\u002Fgh\u002FUfoMiao\u002Fzcf\n[jsdocs-src]: https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fjsdocs-reference-1fa669?style=flat&colorA=080f12&colorB=1fa669\n[jsdocs-href]: https:\u002F\u002Fwww.jsdocs.io\u002Fpackage\u002Fzcf\n[deepwiki-src]: https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FAsk-DeepWiki-1fa669?style=flat&colorA=080f12&colorB=1fa669\n[deepwiki-href]: https:\u002F\u002Fdeepwiki.com\u002FUfoMiao\u002Fzcf","# ZCF 快速上手指南\n\nZCF (Zero-Config Code Flow) 是一款专为 **Claude Code** 和 **Codex** 打造的零配置初始化工具。它支持一键安装、工作流配置、API\u002FCCR 设置及 MCP 集成，并提供双语界面与智能代理系统。\n\n## 环境准备\n\n在开始之前，请确保您的开发环境满足以下要求：\n\n*   **操作系统**：Linux, macOS 或 Windows (WSL 推荐)。\n*   **运行时依赖**：已安装 **Node.js** (建议 v18 或更高版本) 和 **npm**。\n    *   国内用户若下载 Node.js 较慢，推荐使用 [cnpm](https:\u002F\u002Fnpmmirror.com\u002F) 镜像或 nvm 进行安装。\n*   **目标工具**：本地已安装 `claude` (Claude Code) 或 `codex` CLI 工具（ZCF 可辅助初始化，但需确保基础环境可用）。\n\n## 安装步骤\n\nZCF 无需全局安装，推荐直接使用 `npx` 运行最新版本的交互式菜单。\n\n### 方式一：交互式安装（推荐）\n\n运行以下命令打开交互菜单，根据提示选择所需功能：\n\n```bash\nnpx zcf\n```\n\n### 方式二：命令行快速初始化\n\n如果您希望跳过交互菜单，直接执行全套初始化（安装 + 工作流 + API\u002FCCR + MCP），请使用：\n\n```bash\nnpx zcf i\n```\n\n### 方式三：指定服务商非交互式安装\n\n若您已有 API Key 并希望指定服务商（例如使用 302.AI），可直接传入参数：\n\n```bash\nnpx zcf i -s -p 302ai -k \"sk-xxx\"\n```\n> 请将 `\"sk-xxx\"` 替换为您实际的 API Key。\n\n## 基本使用\n\n安装完成后，您可以通过以下常用命令管理您的 AI 编码环境：\n\n*   **更新工作流**：仅更新现有的工作流配置，不重新安装其他组件。\n    ```bash\n    npx zcf u\n    ```\n\n*   **切换语言**：切换工具界面语言（例如切换为简体中文）。\n    ```bash\n    npx zcf --lang zh-CN\n    ```\n\n*   **查看完整文档**：更多高级用法、自定义工作流及配置选项，请访问官方文档：\n    *   https:\u002F\u002Fzcf.ufomiao.com\u002F\n\n*   **社区交流**：遇到问题或需要讨论，可加入 Telegram 群组：\n    *   https:\u002F\u002Ft.me\u002Fufomiao_zcf","某全栈开发者需要在本地快速搭建一个支持中英双语、具备智能代理能力的 Claude Code 开发环境，以便立即投入新功能研发。\n\n### 没有 zcf 时\n- **配置繁琐耗时**：需要手动安装 Node.js 依赖、配置环境变量、下载模型接口文档，往往耗费数小时才能跑通\"Hello World\"。\n- **语言障碍明显**：官方文档和报错信息多为英文，非英语母语开发者在理解复杂配置项时容易卡壳，沟通成本高。\n- **功能集成困难**：若想引入智能代理系统或个性化助手，需单独寻找插件并编写大量胶水代码进行对接，稳定性难以保证。\n- **试错成本高昂**：不同版本的 Claude Code 与 Codex 兼容性差，手动调试依赖冲突极易导致环境崩溃，不得不重装系统。\n\n### 使用 zcf 后\n- **一键极速启动**：只需运行 `npx zcf`，交互式菜单自动完成所有依赖安装与环境变量配置，分钟级即可进入编码状态。\n- **原生双语支持**：内置中英文切换机制，文档、提示语及错误解释均实时翻译，让开发者无障碍掌握核心逻辑。\n- **智能开箱即用**：预置智能代理系统与个性化 AI 助手模板，无需额外编码即可直接调用高级辅助功能，专注业务逻辑。\n- **稳定兼容保障**：自动匹配最佳的 Claude Code 与 Codex 版本组合，内置容错机制确保持续集成流程顺畅无阻。\n\nzcf 通过零配置的自动化流程，将原本复杂的 AI 编程环境搭建转化为简单的单命令操作，让开发者从“配环境”的泥潭中解放出来，真正实现“所想即所得”的高效编码体验。","https:\u002F\u002Foss.gittoolsai.com\u002Fimages\u002FUfoMiao_zcf_4c9c1f6b.webp","UfoMiao","https:\u002F\u002Foss.gittoolsai.com\u002Favatars\u002FUfoMiao_6f77fb6a.png","",null,"https:\u002F\u002Fgithub.com\u002FUfoMiao",[78,82,86],{"name":79,"color":80,"percentage":81},"TypeScript","#3178c6",100,{"name":83,"color":84,"percentage":85},"Shell","#89e051",0,{"name":87,"color":88,"percentage":85},"JavaScript","#f1e05a",5915,414,"2026-04-14T11:50:51","MIT",1,"未说明",{"notes":96,"python":94,"dependencies":97},"该工具是一个基于 Node.js 的命令行配置工具（通过 npx 运行），用于一键设置 Claude Code 和 Codex 等 AI 编程助手。它本身不依赖 GPU 或特定 Python 环境，主要需求是安装 Node.js 以支持 npx 命令。使用前需准备 AI API 密钥（如通过 302.AI、PackyCode 等服务商获取）。",[98,99,100],"npx (Node.js)","Claude Code","Codex",[14,15,35,52,13],[103,104,105,106,107,108,109,110,111,64,112,113,114,115,116,117,118,119,120,121],"ai","ccr","claude","claude-ai","claude-code","cli","nodejs","typescript","workflow","agent","ai-agent","claude-4","llm","llm-code","prompt","bmad-method","gpt","gpt-5","openai","2026-03-27T02:49:30.150509","2026-04-15T06:14:15.856202",[125,130,135,140,145,150,155,160],{"id":126,"question_zh":127,"answer_zh":128,"source_url":129},33748,"配置 CCR 后，Claude Code 提示 API Key 无效或无法连接怎么办？","请检查 `~\u002F.claude.json` 文件中的 `customApiKeyResponses` 字段。如果 `sk-zcf-x-ccr` 出现在 `rejected` 列表中，说明初次弹出 Key 确认时选择了\"No\"。解决方法是将其移至 `approved` 列表，或者重新运行命令并在弹窗时选择\"Yes\"。此外，确保在 `~\u002F.claude\u002Fsettings.json` 的 env 中正确配置了以下变量：\n\"ANTHROPIC_API_KEY\": \"sk-zcf-x-ccr\",\n\"ANTHROPIC_BASE_URL\": \"http:\u002F\u002F127.0.0.1:3456\"\n这两个值需与 `~\u002F.claude-code-router\u002Fconfig.json` 中的 `APIKEY` 和 `HOST`+`PORT` 对应。","https:\u002F\u002Fgithub.com\u002FUfoMiao\u002Fzcf\u002Fissues\u002F2",{"id":131,"question_zh":132,"answer_zh":133,"source_url":134},33749,"安装 Claude Code 或相关组件失败，显示未完成或卡住如何解决？","这通常是网络问题导致的。如果中途使用 `Ctrl+C` 强制停止，`.incomplete` 文件会残留在 brew 的安装文件夹中，导致文件锁和进程锁未释放，从而阻塞后续安装。\n建议步骤：\n1. 切换代理网络后重试。\n2. 手动清理 brew 安装目录下的 `.incomplete` 文件。\n3. 确保之前的安装进程已完全杀死（kill）以释放锁。\n4. 按照正确顺序检查：先 `which` 检测 -> 尝试链接 -> 再次 `which` -> 检查完整性 -> 若不完整则强制重新下载（记得查看 fetch 输出）-> 最后尝试添加链接。","https:\u002F\u002Fgithub.com\u002FUfoMiao\u002Fzcf\u002Fissues\u002F162",{"id":136,"question_zh":137,"answer_zh":138,"source_url":139},33750,"CCR 配置界面中 URL 应该如何填写？","在 CCR 的 UI 配置模式中，URL 必须填写完整的地址，包含路径后缀。例如：`xxx.xx\u002Fv1\u002Fchat\u002Fcompletions`。\n如果只在环境变量中配置，有时可以省略后缀，但在 CCR 界面中必须完整。请参考官方文档：https:\u002F\u002Fgithub.com\u002Fmusistudio\u002Fclaude-code-router\u002Fblob\u002Fmain\u002FREADME_zh.md#4-ui-%E6%A8%A1%E5%BC%8F","https:\u002F\u002Fgithub.com\u002FUfoMiao\u002Fzcf\u002Fissues\u002F197",{"id":141,"question_zh":142,"answer_zh":143,"source_url":144},33751,"配置 CCR 后启动 Claude Code 报\"ANTHROPIC_AUTH_TOKEN 与 ANTHROPIC_API_KEY 冲突\"警告如何处理？","这是因为 `ccr code` 命令会自动添加配置，可能与 `~\u002F.claude\u002Fsettings.json` 中的现有环境变量冲突。\n解决方法：\n1. 打开 `~\u002F.claude\u002Fsettings.json` 文件。\n2. 删除 env 部分中关于 url 和 key 的配置项（即删除 `ANTHROPIC_API_KEY` 和 `ANTHROPIC_BASE_URL` 的手动设置），让 CCR 自动管理。\n3. 如果仍想手动控制，请确保没有同时设置 `ANTHROPIC_AUTH_TOKEN` 和 `ANTHROPIC_API_KEY`，根据提示取消其中一个环境变量。","https:\u002F\u002Fgithub.com\u002FUfoMiao\u002Fzcf\u002Fissues\u002F254",{"id":146,"question_zh":147,"answer_zh":148,"source_url":149},33752,"在 Windows (PowerShell) 上运行 npx zcf 报错\"could not create process\"或\"Bun failed to remap\"怎么办？","这通常是因为用户主目录（Home Dir）下存在一个 `node_modules` 文件夹，干扰了 Bun 的路径映射。\n解决方法：\n1. 检查用户主目录下是否有 `node_modules` 文件夹。\n2. 如果有，直接删除该文件夹。\n3. 删除后重新运行命令即可恢复正常。","https:\u002F\u002Fgithub.com\u002FUfoMiao\u002Fzcf\u002Fissues\u002F243",{"id":151,"question_zh":152,"answer_zh":153,"source_url":154},33753,"如何使用 VS Code 插件或替代方案连接 Claude Code？","由于官方 VS Code 插件（CCR）可能存在不便或不稳定，建议改用 API 方式连接。\n1. 使用适配好的 API 接口（如 GLM 等官宣适配的 API）。\n2. 如果之前遇到 Mac 上界面卡死但后台扣费的情况，很可能是 CCR 插件的问题，切换到 API 模式通常能解决此问题。","https:\u002F\u002Fgithub.com\u002FUfoMiao\u002Fzcf\u002Fissues\u002F144",{"id":156,"question_zh":157,"answer_zh":158,"source_url":159},33754,"ZCF 是否支持将重复的工作流模板统一管理以减少维护成本？","是的，项目已经进行了优化。针对 claude-code 和 codex 中重复的中英文工作流提示词文件（如 git 工作流），现已统一维护一套提示词，降低了维护成本。此外，ZCF 的工作流未来也可以改为 plugin 形式安装，以利用官方推出的 plugin 功能利好开源社区。","https:\u002F\u002Fgithub.com\u002FUfoMiao\u002Fzcf\u002Fissues\u002F250",{"id":161,"question_zh":162,"answer_zh":163,"source_url":164},33755,"如何初始化多层级的项目文档以便 Claude Code 更好地理解上下文？","可以将 `CLAUDE.md` 放在项目的不同层级目录中，而不仅仅是在根目录。这样能让 Claude Code 在调用查询工具时更准确地理解上下文。\nZCF 最新版已集成了 `spec-workflow mcp`，可以通过 command 触发 agent 来自动初始化各层级的项目文档。建议参考相关的 init-project 和 init-architect 配置文件进行整合。","https:\u002F\u002Fgithub.com\u002FUfoMiao\u002Fzcf\u002Fissues\u002F11",[166,171,176,181,186,191,196,201,206,211,216,221,226,231,236,241,246,251,256,261],{"id":167,"version":168,"summary_zh":169,"released_at":170},263597,"zcf@3.6.4","### 补丁变更\n\n-   ## 修复\n\n    -   更新 MiniMax 提供商预设为 M2.7 系列模型并修正 API 端点（api.minimax.io）\n    -   同步 MiniMax 文档（中英日）中的模型与平台链接说明\n    -   为 MiniMax 提供商配置补充单元测试\n    -   百炼 Coding 预设默认模型改为小写 `glm-5`\n    -   为百炼 Coding 默认模型补充单元测试\n\n    ## 文档\n\n    -   将各语言 README 中赞助板块标题统一为「赞助商」等对应表述\n    -   优化赞助说明措辞并补充日文与中文 README 中的赞助条目\n","2026-03-24T08:45:33",{"id":172,"version":173,"summary_zh":174,"released_at":175},263598,"zcf@3.6.3","### 补丁变更\n\n-   ## 新功能\n\n    -   新增 BMAD 多智能体命令与工作流（bmad-agent-_、bmad-bmm-_、bmad-editorial-_、bmad-review-_、bmad-help、bmad-party-mode 等）\n    -   在文档与 API 提供商预设中新增 Crazyrouter 赞助商\n\n    ## 新功能\n\n    -   新增 BMAD 多智能体命令与工作流（bmad-agent-_、bmad-bmm-_、bmad-editorial-_、bmad-review-_、bmad-help、bmad-party-mode 等）\n    -   在文档与 API 提供商预设中新增 Crazyrouter 赞助商\n\n    ## 文档\n\n    -   更新 README（中英日）及文档中的 Crazyrouter 赞助信息\n    -   在 API 提供商文档（中英日）中新增 Crazyrouter\n","2026-03-10T14:04:31",{"id":177,"version":178,"summary_zh":179,"released_at":180},263599,"zcf@3.6.2","### 补丁变更\n\n-   ## 新功能\n\n    -   将 bmad-init 模板从 V4 升级至 V6\n    -   支持在初始化时跳过输出风格选择\n    -   更新 API 提供商预设并新增服务\n\n    ## 新功能\n\n    -   将 bmad-init 模板从 V4 升级至 V6\n    -   支持在初始化时跳过输出风格选择\n    -   更新 API 提供商预设并新增服务\n\n    ## 修复\n\n    -   根据 Codex 评审反馈改进 codex-backup（跳过 tmp 目录、处理悬空符号链接）\n    -   根据 Qodo\u002FCursor\u002FCodex 评审反馈改进 output-style\n\n    ## 修复\n\n    -   根据 Codex 评审反馈改进 codex-backup（跳过 tmp 目录、处理悬空符号链接）\n    -   根据 Qodo\u002FCursor\u002FCodex 评审反馈改进 output-style\n\n    ## 文档\n\n    -   更新 README 与文档中的赞助信息\n\n    ## 文档\n\n    -   更新 README 与文档中的赞助信息\n","2026-03-04T04:14:30",{"id":182,"version":183,"summary_zh":184,"released_at":185},263600,"zcf@3.6.1","### 补丁变更\n\n-   ## 新功能\n\n    -   添加 AICodeMirror API 提供商预设，简化配置流程\n    -   支持 AICodeMirror 作为新的 API 提供商选项\n\n    ## 新功能\n\n    -   添加 AICodeMirror API 提供商预设，简化配置流程\n    -   支持 AICodeMirror 作为新的 API 提供商选项\n\n    ## 变更\n\n    -   移除 Codex chat 格式支持（已弃用功能）\n    -   简化 Codex 配置，移除 chat 格式选项\n\n    ## 文档\n\n    -   在 README 和文档中添加 AICodeMirror 赞助信息\n    -   更新 API 提供商文档，添加 AICodeMirror 相关信息\n","2026-01-30T11:18:42",{"id":187,"version":188,"summary_zh":189,"released_at":190},263601,"zcf@3.6.0","### 小幅改动\n\n-   ## 新特性\n\n    -   添加 Leibus 工程师输出风格，提供专业技术指导\n    -   添加 rem-engineer 输出风格，提供动漫风格的开发辅助\n\n    ## 新功能\n\n    -   添加 Leibus 工程师输出风格，提供专业技术指导\n    -   添加 rem-engineer 输出风格，提供动漫风格的开发辅助\n\n    ## 修复\n\n    -   增强 Codex API 配置中的提供商名称验证\n\n    ## 修复\n\n    -   增强 Codex API 配置中的提供商名称验证\n\n    ## 文档\n\n    -   更新多语言输出风格文档（英文、简体中文、日文）\n\n    ## 文档\n\n    -   更新多语言输出风格文档（英文、简体中文、日文）\n","2026-01-26T07:08:05",{"id":192,"version":193,"summary_zh":194,"released_at":195},263612,"zcf@3.2.3","### Patch Changes\n\n-   ## New Features\n\n    -   Add Halley-chan animated avatar with hover effects to README files\n    -   Add new banner and logo assets for enhanced visual identity\n    -   Add sponsor information and promotion acknowledgments\n\n    ## Optimization\n\n    -   Enhance code type parameter handling with improved error messages\n    -   Change API key input from password to visible text for better user experience\n    -   Improve code type resolver with better validation and error handling\n\n    ## Documentation\n\n    -   Update README files across all languages (EN, ZH-CN, JA-JP) with new visual assets\n    -   Add comprehensive test coverage for CLI setup and menu commands\n    -   Update sponsor and promotion sections\n\n    ## 新功能\n\n    -   为 README 文件添加 Halley-chan 动画头像和悬停效果\n    -   添加新的 banner 和 logo 资源,增强视觉识别度\n    -   添加赞助商信息和推广致谢\n\n    ## 优化\n\n    -   增强代码类型参数处理,改进错误消息提示\n    -   将 API key 输入从密码模式改为可见文本,提升用户体验\n    -   改进代码类型解析器,增强验证和错误处理能力\n\n    ## 文档\n\n    -   更新所有语言版本的 README 文件(英文、中文、日文),添加新的视觉资源\n    -   为 CLI 设置和菜单命令添加全面的测试覆盖\n    -   更新赞助商和推广部分内容\n","2025-10-26T14:35:15",{"id":197,"version":198,"summary_zh":199,"released_at":200},263613,"zcf@3.2.2","### Patch Changes\n\n-   ## New Features\n\n    -   Add custom API model configuration support for Claude Code\n    -   Extend Windows command wrapper support for uvx and uv tools\n    -   Update sponsor information in README files\n\n    ## 新功能\n\n    -   添加 Claude Code 自定义 API 模型配置支持\n    -   扩展 Windows 命令包装器支持 uvx 和 uv 工具\n    -   更新 README 文件中的赞助信息\n\n    ## Fixes\n\n    -   Guard command wrapper to avoid processing undefined commands\n    -   Restore primaryApiKey and hasCompletedOnboarding when switching profiles\n\n    ## 修复\n\n    -   防护命令包装器避免处理未定义的命令\n    -   切换配置文件时恢复 primaryApiKey 和 hasCompletedOnboarding\n\n    ## Testing\n\n    -   Add comprehensive test coverage for custom model configuration\n    -   Add parameter validation tests for init command\n    -   Enhance platform and codex-platform test coverage\n\n    ## 测试\n\n    -   添加自定义模型配置的全面测试覆盖\n    -   添加 init 命令的参数验证测试\n    -   增强 platform 和 codex-platform 测试覆盖\n","2025-10-22T12:46:35",{"id":202,"version":203,"summary_zh":204,"released_at":205},263614,"zcf@3.2.1","### Patch Changes\n\n-   ## New Features\n\n    -   Add Serena MCP service integration, support Claude Code and Codex\n    -   Improve MCP service configuration with type safety enhancements\n    -   Add comprehensive internationalization support for new MCP services\n\n    ## 新功能\n\n    -   新增 Serena MCP 服务集成，支持 Claude Code 和 Codex\n    -   改进 MCP 服务配置，增强类型安全性\n    -   为新增 MCP 服务添加全面的国际化支持\n\n    ## Optimization\n\n    -   Enhance type safety for MCP service configurations\n    -   Improve multi-config handling with better validation\n    -   Strengthen test coverage for MCP integration scenarios\n\n    ## 优化\n\n    -   增强 MCP 服务配置的类型安全性\n    -   改进多配置处理，提供更好的验证机制\n    -   加强 MCP 集成场景的测试覆盖率\n\n    ## Fixes\n\n    -   Resolve configuration validation issues in multi-config scenarios\n    -   Ensure proper type checking for MCP service definitions\n\n    ## 修复\n\n    -   解决多配置场景中的配置验证问题\n    -   确保 MCP 服务定义的适当类型检查\n\n    ## Testing\n\n    -   Add comprehensive test coverage for Serena MCP integration\n    -   Enhance validation tests for multi-config handling\n    -   Improve test coverage for MCP service type safety\n\n    ## 测试\n\n    -   为 Serena MCP 集成添加全面的测试覆盖\n    -   增强多配置处理的验证测试\n    -   改进 MCP 服务类型安全的测试覆盖率\n","2025-10-20T12:26:01",{"id":207,"version":208,"summary_zh":209,"released_at":210},263602,"zcf@3.5.1","### 补丁变更\n\n-   ## 修复\n\n    -   实现精准的 TOML 更新机制，防止 MCP 配置被破坏\n    -   改进 zcf-config 中的换行处理和可选字段插入\n    -   增强顶层 TOML 字段的正则表达式以支持行内注释\n    -   修复 updateTopLevelTomlFields 中的顶层字段处理\n\n    ## 修复\n\n    -   实现针对性的 TOML 更新，避免 MCP 配置损坏\n    -   优化 zcf-config 的换行逻辑及可选字段插入功能\n    -   强化顶层 TOML 字段的正则表达式，使其支持行内注释\n    -   修正 updateTopLevelTomlFields 函数中对顶层字段的处理问题\n\n    ## 功能\n\n    -   更新 Codex 模型选项和默认配置\n\n    ## 新功能\n\n    -   更新 Codex 模型的可用选项及默认配置\n\n    ## 重构\n\n    -   使用 @rainbowatcher\u002Ftoml-edit-js 替代 smol-toml，以提升 TOML 文件的处理能力\n    -   移除 writeCodexConfig 函数（代码清理）\n\n    ## 重构\n\n    -   将 smol-toml 替换为 @rainbowatcher\u002Ftoml-edit-js，从而更好地处理 TOML 文件\n    -   删除 writeCodexConfig 函数（进行代码优化）\n\n    ## 文档\n\n    -   将旧版计划的 Markdown 文件移至 .zcf\u002Fplan\u002Fhistory 目录下\n    -   更新 README 文件中的赞助商部分\n    -   修复多语言环境下输出样式命令的问题\n    -   更新 Haleclipse 图片，并移除图片中的内联样式\n\n    ## 文档\n\n    -   将历史计划的 Markdown 文件迁移到 .zcf\u002Fplan\u002Fhistory 目录\n    -   更新各 README 文件中的赞助商信息\n    -   修复多语言版本中输出样式命令的显示问题\n    -   更新 Haleclipse 的图片，并移除图片中的内联样式","2026-01-12T01:37:25",{"id":212,"version":213,"summary_zh":214,"released_at":215},263603,"zcf@3.5.0","### 小改动\n\n-   ## 重构\n\n    -   将模板整合到 common 目录以提高代码复用\n    -   统一 output-styles、git workflows 和 sixStep workflows 到 `templates\u002Fcommon\u002F`\n    -   移除重复的 Codex 模板（现与 Claude Code 共享）\n    -   统一 sixStep 计划目录为 `.zcf` 以保持一致性\n\n    ## Fixes\n\n    -   配置 CCR 代理时移除 ANTHROPIC_AUTH_TOKEN 以防止冲突\n    -   修正整合后的 Codex 模板路径结构\n\n    ## Enhancement\n\n    -   在 sixStep 工作流第二阶段添加用户审批请求\n    -   为 sixStep 工作流添加时间戳获取规则\n    -   增强 sixStep 工作流计划目录结构\n    -   重新排序 sixStep 工作流执行阶段步骤以提高清晰度\n\n    ## Testing\n\n    -   添加 Codex 工作流选择 presetWorkflows 过滤的单元测试\n    -   验证模板到 common 目录的整合\n","2025-12-25T16:24:55",{"id":217,"version":218,"summary_zh":219,"released_at":220},263604,"zcf@3.4.3","### 补丁变更\n\n-   ## 修复\n\n    -   为 Linux 非 root 用户在自动更新器中添加 sudo 支持\n    -   在 Codex skip-prompt 模式下正确处理 workflows 和 mcpServices 选项\n    -   更新测试以匹配 PR #251 行为变更\n\n    ## 修复\n\n    -   为 Linux 非 root 用户在自动更新器中添加 sudo 支持\n    -   在 Codex skip-prompt 模式下正确处理 workflows 和 mcpServices 选项\n    -   更新测试以匹配 PR #251 行为变更\n\n    ## 优化\n\n    -   从双模型迁移到四模型 API 配置架构\n    -   优化 Codex skip-prompt 模式初始化流程\n    -   增强配置文件管理中的模型处理\n    -   导出 getAuthTypeLabel 函数以提供更好的 API\n    -   增强提交消息 body 和 footer 指南\n\n    ## 文档\n\n    -   增强 API 模型配置文档，支持四模型架构\n\n    ## 测试\n\n    -   改进 skip-prompt 模式和多配置处理的测试覆盖率","2025-12-13T07:02:00",{"id":222,"version":223,"summary_zh":224,"released_at":225},263605,"zcf@3.4.2","## 讲人话版：\n## 人工语言版本：\n\n### 补丁修复\n1. 修复了codex最新版 api配置报缺失key的问题\n2. 修复claude code homebrew安装后使用check更新失败的问题\n3. codex mcp默认增加startup_timeout_ms=30\n\n### AI生成的：\n## AI生成的：\n\n### 补丁变更\n\n-   ## 改进\n\n    -   增强 Codex 备份消息处理和 env_key 迁移逻辑\n    -   将 Codex 启动超时从毫秒改为秒，提升易用性\n    -   在代码库中将 env_key 迁移至 temp_env_key，配置更清晰\n    -   增强 Claude Code 安装验证和符号链接处理\n    -   支持 Homebrew 安装的 Claude Code 更新逻辑\n    -   增强安装和通用消息的国际化支持\n\n    ## 优化\n\n    -   增强 Codex 备份消息处理和 env_key 迁移逻辑\n    -   将 Codex 启动超时从毫秒改为秒，提升易用性\n    -   在代码库中将 env_key 迁移至 temp_env_key，配置更清晰\n    -   增强 Claude Code 安装验证和符号链接处理\n    -   支持 Homebrew 安装的 Claude Code 更新逻辑\n    -   增强安装和通用消息的国际化支持\n\n    ## 文档\n\n    -   增强文档，集成 UnoCSS 和新组件\n    -   修复 TopBanner 组件的响应式语言支持\n\n    ## 文档\n\n    -   增强文档，集成 UnoCSS 和新组件\n    -   修复 TopBanner 组件的响应式语言支持","2025-12-03T14:46:17",{"id":227,"version":228,"summary_zh":229,"released_at":230},263606,"zcf@3.4.1","### 补丁变更\n\n-   ## 新功能\n\n    -   实现 Codex MCP 配置中的额外字段保留功能\n    -   支持将单个 API 配置保存到 TOML 以便轻松切换配置文件\n    -   在文档中添加社区板块，包含 Telegram 群组链接\n\n    ## 新功能\n\n    -   实现 Codex MCP 配置中的额外字段保留功能\n    -   支持将单个 API 配置保存到 TOML 以便轻松切换配置文件\n    -   在文档中添加社区板块，包含 Telegram 群组链接\n\n    ## 优化\n\n    -   改进更新逻辑以支持多种安装方式\n    -   使用 Claude Code 内置的 'claude update' 命令提升兼容性\n    -   为 Codex 实现智能安装方式检测\n    -   重构 installMethod 类型以提高一致性\n\n    ## 优化\n\n    -   改进更新逻辑以支持多种安装方式\n    -   使用 Claude Code 内置的 'claude update' 命令提升兼容性\n    -   为 Codex 实现智能安装方式检测\n    -   重构 installMethod 类型以提高一致性\n\n    ## 修复\n\n    -   更新 Homebrew cask 版本获取以支持 v2 JSON 格式\n    -   修正 installMethod 为 'npm-global' 以保持配置一致性\n\n    ## 修复\n\n    -   更新 Homebrew cask 版本获取以支持 v2 JSON 格式\n    -   修正 installMethod 为 'npm-global' 以保持配置一致性\n\n    ## 文档\n\n    -   为站点配置添加 favicon 图标以改进品牌形象\n    -   简化侧边栏文本，移除表情符号以提升清晰度\n    -   为输出样式文档添加 Halley-chan 角色图片和说明\n    -   更新文档域名链接\n\n    ## 文档\n\n    -   为站点配置添加 favicon 图标以改进品牌形象\n    -   简化侧边栏文本，移除表情符号以提升清晰度\n    -   为输出样式文档添加 Halley-chan 角色图片和说明\n    -   更新文档域名链接","2025-11-27T10:42:11",{"id":232,"version":233,"summary_zh":234,"released_at":235},263607,"zcf@3.4.0","### Minor Changes\n\n-   ## New Features\n\n    -   Add path normalization utility for Windows compatibility\n    -   Enhance internationalization support for provider management\n    -   Improve CLI uninstall and installation processes with better error handling\n    -   Integrate inquirer-toggle package for enhanced interactive prompts\n    -   Add comprehensive VitePress documentation system with multilingual support (zh-CN, en, ja-JP)\n    -   Migrate and enhance GitBook documentation structure\n\n    ## 新功能\n\n    -   添加路径规范化工具，提升 Windows 兼容性\n    -   增强 provider 管理的国际化支持\n    -   改进 CLI 卸载和安装流程，优化错误处理\n    -   集成 inquirer-toggle 包，增强交互式提示体验\n    -   新增完整的 VitePress 文档系统，支持多语言（中文、英文、日文）\n    -   迁移并增强 GitBook 文档结构\n\n    ## Fixes\n\n    -   Fix environment variable formatting in renderCodexConfig\n    -   Update Codex configuration handling for better reliability\n\n    ## 修复\n\n    -   修复 renderCodexConfig 中的环境变量格式化问题\n    -   更新 Codex 配置处理逻辑，提升可靠性\n\n    ## Documentation\n\n    -   Add comprehensive VitePress documentation covering features, workflows, CLI commands, and best practices\n    -   Significantly expand zh-CN documentation with comprehensive guides\n    -   Update README files with streamlined structure and quick links to documentation\n    -   Add acknowledgments section to README files\n    -   Update CLAUDE.md and installation documentation for versioning and installation methods\n\n    ## 文档更新\n\n    -   新增完整的 VitePress 文档，涵盖功能、工作流、CLI 命令和最佳实践\n    -   大幅扩展中文文档，添加全面的使用指南\n    -   更新 README 文件，优化结构并添加文档快速链接\n    -   在 README 文件中添加致谢部分\n    -   更新 CLAUDE.md 和安装文档，完善版本管理和安装方法说明\n\n    ## Optimization\n\n    -   Update documentation deployment workflow to trigger on main branch\n    -   Improve Node.js setup in CI\u002FCD workflows\n    -   Enhance test coverage configuration to include docs directory\n    -   Refactor GitBook document structure for better organization\n\n    ## 优化\n\n    -   更新文档部署工作流，在 main 分支触发\n    -   改进 CI\u002FCD 工作流中的 Node.js 设置\n    -   增强测试覆盖配置，包含 docs 目录\n    -   重构 GitBook 文档结构，提升组织性\n\n    ## Testing\n\n    -   Add comprehensive test coverage for new features\n    -   Enhance existing test suites for better reliability\n\n    ## 测试优化\n\n    -   为新功能添加全面的测试覆盖\n    -   增强现有测试套件，提升可靠性\n","2025-11-24T19:01:48",{"id":237,"version":238,"summary_zh":239,"released_at":240},263608,"zcf@3.3.3","### Patch Changes\n\n-   ## New Features\n\n    -   Add sudo support for global npm installations on Linux systems\n    -   Enhance installation process with automatic privilege escalation for Cometix and CCR tools\n    -   Improve cross-platform compatibility for system-level package installations\n\n    ## 新功能\n\n    -   为 Linux 系统添加全局 npm 安装的 sudo 支持\n    -   增强 Cometix 和 CCR 工具的安装流程，支持自动权限提升\n    -   改进系统级软件包安装的跨平台兼容性\n\n    ## Documentation\n\n    -   Update README files with GLM CODING PLAN sponsorship information\n    -   Add GLM brand assets and visual resources\n\n    ## 文档更新\n\n    -   更新 README 文件，添加 GLM CODING PLAN 赞助商信息\n    -   添加 GLM 品牌资源和视觉素材\n\n    ## Testing\n\n    -   Add comprehensive test coverage for sudo installation scenarios\n    -   Enhance Codex installation and uninstallation test suites\n    -   Improve platform-specific test cases for Linux environments\n\n    ## 测试优化\n\n    -   为 sudo 安装场景添加全面的测试覆盖\n    -   增强 Codex 安装和卸载测试套件\n    -   改进 Linux 环境的平台特定测试用例\n","2025-11-14T07:24:31",{"id":242,"version":243,"summary_zh":244,"released_at":245},263609,"zcf@3.3.2","### Patch Changes\n\n-   ## New Features\n\n    -   Add PackyCode API provider preset with dedicated assets and configuration\n\n    ## 新功能\n\n    -   新增 PackyCode API 预设供应商及其资源与配置\n\n    ## Fixes\n\n    -   Ensure preset providers apply their default models when creating Claude Code profiles\n    -   Update Kimi API endpoints and tests to reflect the latest service domain\n\n    ## 修复\n\n    -   预设供应商在创建 Claude Code 配置时自动带入默认模型\n    -   更新 Kimi API 接口地址与测试以匹配最新服务域名\n\n    ## Optimization\n\n    -   Remove deprecated onboarding flag from the official login workflow configuration\n\n    ## 优化\n\n    -   移除官方登录流程中过时的 onboarding 标记配置\n\n    ## Documentation\n\n    -   Refresh multilingual README assets with optimized PackyCode sponsor visuals\n\n    ## 文档\n\n    -   更新多语言 README，使用优化后的 PackyCode 赞助展示图\n","2025-11-13T13:59:46",{"id":247,"version":248,"summary_zh":249,"released_at":250},263610,"zcf@3.3.1","### Patch Changes\n\n-   ## New Features\n\n    -   Add configuration copy functionality for easier profile duplication\n    -   Support model configuration editing in profile management\n    -   Refactor Codex constants management for better maintainability\n    -   Enhance multi-language support with new translation keys for configuration features\n\n    ## 新功能\n\n    -   添加配置复制功能，支持快速复制配置文件\n    -   支持在配置管理中编辑模型配置\n    -   重构 Codex 常量管理，提升代码可维护性\n    -   增强多语言支持，为配置功能添加新的翻译键\n\n    ## Optimization\n\n    -   Improve Codex configuration switch logic with comprehensive testing\n    -   Enhance Claude Code incremental manager with better error handling\n    -   Update documentation with latest module descriptions and architecture details\n\n    ## 优化\n\n    -   改进 Codex 配置切换逻辑，新增全面的测试覆盖\n    -   增强 Claude Code 增量管理器的错误处理能力\n    -   更新文档，补充最新的模块描述和架构细节\n\n    ## Testing\n\n    -   Add comprehensive test suites for configuration switching functionality\n    -   Add unit tests for Claude Code incremental manager\n    -   Add integration tests for Codex configuration management\n\n    ## 测试\n\n    -   为配置切换功能添加全面的测试套件\n    -   为 Claude Code 增量管理器添加单元测试\n    -   为 Codex 配置管理添加集成测试\n","2025-10-30T09:47:31",{"id":252,"version":253,"summary_zh":254,"released_at":255},263611,"zcf@3.3.0","### Minor Changes\n\n-   ## New Features\n\n    -   Add API provider preset system for simplified configuration\n    -   Support preset providers: 302.AI, GLM, MiniMax, Kimi, and custom endpoints\n    -   Add `--provider\u002F-p` CLI parameter for quick provider selection\n    -   Implement automatic baseUrl, authType, and model configuration based on provider\n    -   Add comprehensive API provider selection for both Claude Code and Codex\n\n    ## 新功能\n\n    -   添加 API 提供商预设系统,简化配置流程\n    -   支持预设提供商:302.AI、GLM、MiniMax、Kimi 和自定义端点\n    -   添加 `--provider\u002F-p` CLI 参数用于快速选择提供商\n    -   基于提供商自动配置 baseUrl、authType 和模型\n    -   为 Claude Code 和 Codex 添加全面的 API 提供商选择功能\n\n    ## Optimization\n\n    -   Reduce configuration complexity from 5+ parameters to just 2 (provider + API key)\n    -   Improve CI\u002FCD automation experience with preset configurations\n    -   Enhance user experience with provider-specific presets\n    -   Add comprehensive i18n support for provider-related messages\n\n    ## 优化\n\n    -   将配置复杂度从 5+ 个参数简化为仅 2 个(提供商 + API 密钥)\n    -   通过预设配置改善 CI\u002FCD 自动化体验\n    -   使用提供商特定预设增强用户体验\n    -   为提供商相关消息添加全面的国际化支持\n\n    ## Fixes\n\n    -   Automatic identification of code comment languages\n\n    ## 修复\n\n    -   代码注释语言自动识别\n\n    ## Documentation\n\n    -   Add comprehensive documentation for CCR, Code Tools, Cometix, and Templates modules\n    -   Update README with provider preset examples in English, Chinese, and Japanese\n    -   Add detailed API provider configuration guides\n\n    ## 文档\n\n    -   为 CCR、Code Tools、Cometix 和 Templates 模块添加全面文档\n    -   更新 README,添加英文、中文和日文的提供商预设示例\n    -   添加详细的 API 提供商配置指南\n","2025-10-27T10:53:42",{"id":257,"version":258,"summary_zh":259,"released_at":260},263615,"zcf@3.2.0","### Minor Changes\n\n-   ## New Features\n\n    -   Add comprehensive Claude Code multi-configuration management system with TDD approach\n    -   Introduce TOML-based configuration storage for better portability and version control\n    -   Implement incremental configuration manager for progressive profile updates\n    -   Add Codex platform support and enhanced code tool integration\n    -   Provide advanced git commit templates with improved formatting\n    -   Support dynamic configuration switching with backup and recovery mechanisms\n    -   Add comprehensive configuration validation and conflict detection\n    -   Implement intelligent profile merging strategies for complex workflows\n\n    ## 新功能\n\n    -   添加全面的 Claude Code 多配置管理系统，采用 TDD 开发方法\n    -   引入基于 TOML 的配置存储，提供更好的可移植性和版本控制支持\n    -   实现增量配置管理器，支持渐进式配置文件更新\n    -   添加 Codex 平台支持和增强的代码工具集成\n    -   提供改进格式的 git 提交模板\n    -   支持动态配置切换，包含备份和恢复机制\n    -   添加全面的配置验证和冲突检测功能\n    -   实现智能配置文件合并策略，支持复杂工作流程\n\n    ## Optimization\n\n    -   Enhance test coverage with comprehensive multi-configuration scenarios\n    -   Improve CLI option standardization and parameter conflict resolution\n    -   Refactor test organization for better maintainability and coverage\n    -   Optimize configuration detection and validation workflows\n    -   Enhance incremental update mechanisms for better performance\n    -   Streamline configuration loading and caching processes\n    -   Improve error handling and user feedback systems\n\n    ## 优化\n\n    -   增强测试覆盖率，包含全面的多配置场景测试\n    -   改进 CLI 选项标准化和参数冲突解决\n    -   重构测试组织结构，提高可维护性和覆盖率\n    -   优化配置检测和验证工作流程\n    -   增强增量更新机制以提升性能\n    -   简化配置加载和缓存流程\n    -   改进错误处理和用户反馈系统\n\n    ## Documentation\n\n    -   Update README files with improved multi-language support\n    -   Add comprehensive TDD plan documentation for multi-config system\n    -   Enhance API documentation with clearer parameter descriptions\n    -   Update command documentation with latest feature additions\n    -   Add detailed configuration management guides and examples\n    -   Create comprehensive troubleshooting documentation\n\n    ## 文档\n\n    -   更新 README 文件，改进多语言支持\n    -   为多配置系统添加全面的 TDD 计划文档\n    -   增强API文档，提供更清晰的参数描述\n    -   更新命令文档，包含最新功能添加\n    -   添加详细的配置管理指南和示例\n    -   创建全面的故障排除文档\n\n    ## Testing\n\n    -   Add extensive test coverage for configuration management features\n    -   Implement edge case testing for multi-configuration scenarios\n    -   Enhance unit tests for better coverage and reliability\n    -   Add integration tests for Codex platform functionality\n    -   Create comprehensive performance testing suites\n    -   Implement automated configuration validation tests\n\n    ## 测试\n\n    -   为配置管理功能添加广泛的测试覆盖\n    -   实现多配置场景的边界情况测试\n    -   增强单元测试以提高覆盖率和可靠性\n    -   为 Codex 平台功能添加集成测试\n    -   创建全面的性能测试套件\n    -   实现自动化配置验证测试\n","2025-10-19T12:07:39",{"id":262,"version":263,"summary_zh":264,"released_at":265},263616,"zcf@3.1.4","### Patch Changes\n\n-   ## New Features\n\n    -   Add code type resolver with improved error handling and i18n support\n    -   Add tool update scheduler for automated tool management\n    -   Enhance Codex tool with skipPrompt support and language selection\n    -   Add ZCF pull request creation command (\u002Fzcf-pr)\n    -   Add comprehensive Git workflow prompt templates collection\n    -   Support grouped Git workflows selection and expansion\n    -   Add Termux user sponsor information to README files\n\n    ## 新功能\n\n    -   添加代码类型解析器，增强错误处理和国际化支持\n    -   新增工具更新调度器，实现自动化工具管理\n    -   增强 Codex 工具的 skipPrompt 支持和语言选择功能\n    -   新增 ZCF PR 创建命令 (\u002Fzcf-pr)\n    -   添加完整的 Git 工作流提示模板集合\n    -   支持分组 Git 工作流选择和扩展\n    -   在 README 文件中添加 Termux 用户赞助信息\n\n    ## Optimizations\n\n    -   Improve init command configuration and user experience\n    -   Enhance check-updates command functionality\n    -   Optimize CLI setup and internationalization support\n    -   Refine code tools integration and error handling\n\n    ## 优化\n\n    -   改进 init 命令的配置和用户体验\n    -   增强检查更新命令的功能\n    -   优化 CLI 设置和国际化支持\n    -   完善代码工具集成和错误处理\n\n    ## Testing Enhancements\n\n    -   Significantly expand test coverage with new test files\n    -   Add comprehensive integration and unit tests\n    -   Include edge cases and error scenario testing\n    -   Add tests for code type resolver and tool update scheduler\n\n    ## 测试增强\n\n    -   大幅增加测试覆盖率，新增多个测试文件\n    -   添加全面的集成测试和单元测试\n    -   包含边界条件和错误场景测试\n    -   为代码类型解析器和工具更新调度器添加测试\n\n    ## Documentation\n\n    -   Update README files with Termux user sponsor\n    -   Add Git workflow prompt templates documentation\n    -   Enhance CLAUDE.md project documentation\n    -   Add detailed command documentation for new features\n\n    ## 文档\n\n    -   更新 README 文件，添加 Termux 用户赞助信息\n    -   添加 Git 工作流提示模板文档\n    -   完善 CLAUDE.md 项目文档\n    -   为新功能添加详细的命令文档\n","2025-10-09T12:57:59"]