项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 6071
使用教程
环境要求
- 已安装 Node.js,终端中可使用 npx 命令
- 可访问网络的终端环境(npx 需联网拉取包)
- 一个可用的模型服务 API Key(非交互式初始化时使用,如 302ai 的 sk-xxx)
- 建议使用支持交互式输入的终端(交互菜单需要按键选择)
安装与启动步骤
-
1确认 npx 可用
打开终端,确认本机已安装 Node.js 且 npx 命令可以正常执行;README 未指定版本,按要求安装 Node.js 即可。
-
2打开交互菜单
运行后进入 zcf 的交互式菜单,按提示选择需要的功能,这是官方推荐的使用方式。
npx zcf -
3执行全量初始化
一条命令完成安装、工作流、API/CCR 与 MCP 的初始化配置,适合首次使用。
npx zcf i -
4仅更新工作流
当已有配置、只想刷新提示词与工作流模板时使用该命令。
npx zcf u -
5切换界面语言
通过 --lang 参数切换界面语言,例如切换为简体中文 zh-CN。
npx zcf --lang zh-CN -
6非交互式初始化
适合脚本或无人值守场景,用 -s 跳过交互并指定服务商预设与 API Key。
npx zcf i -s -p 302ai -k "sk-xxx"
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
-s | 否 | 非交互模式,跳过菜单直接按参数执行 | npx zcf i -s |
-p | 是 | 指定服务商预设(非交互初始化时使用) | 302ai |
-k | 是 | 指定模型服务的 API Key | sk-xxx |
--lang | 否 | 切换界面语言,如 zh-CN | zh-CN |
如何确认成功
运行 npx zcf 后能正常出现交互式菜单,且 npx zcf i 初始化流程无报错完成,即表示可用。
常见问题
Q:zcf 需要先全局安装吗?
A:不需要。README 中的用法都是 npx zcf,由 npx 直接拉取并运行,无需手动全局安装。
Q:不想一步步选择菜单怎么办?
A:使用非交互模式,例如 npx zcf i -s -p 302ai -k "sk-xxx",用参数一次性指定服务商和密钥。
Q:只想更新提示词和工作流怎么做?
A:执行 npx zcf u,该命令只更新工作流,不会重做全部初始化。
Q:界面语言怎么改成中文?
A:在命令后追加 --lang zh-CN,例如 npx zcf --lang zh-CN。
Q:初始化都包含哪些内容?
A:npx zcf i 为全量初始化,包含安装、工作流、API/CCR 以及 MCP 的配置。
注意事项
- README 只提供了 npx 方式的使用说明,更多选项和工作流请查阅官方文档 https://zcf.ufomiao.com/
- 示例中的 sk-xxx 为占位值,请替换为你自己的真实 API Key,不要提交到代码仓库
- 非交互式初始化需由 -p 指定的服务商预设与 -k 的密钥配套使用
- 初始化会修改 Claude Code / Codex 相关配置,建议操作前先做好配置备份
核心亮点
- 真正零配置,安装后直接增强现有 AI 编码流程,学习成本极低
- 内置 BMAD 方法和 CCR 流程,显著提升 AI 对复杂任务的理解与执行连贯性
- 同时支持 Claude Code 和 Codex,覆盖主流 AI 编码工具,适配灵活
不足之处
- 文档/社区待观察
- 依赖特定 AI 工具版本,未来兼容性需持续跟进
适用场景
- 日常开发中希望减少重复提示词编写,快速获得结构化 AI 辅助
- 团队统一 AI 编码流程,提升代码修改质量和一致性
- 在大型代码库中,需要 AI 更精准地定位和修改代码的场景
替代项目
Claude Code、Codex CLI、Aider
上一篇:mini-swe-agent
下一篇:LobsterAI
同类项目推荐
b2b-sdr-agent-template
开源
一键部署AI外贸销售员,自动跑完10阶段销售流程
Open-source AI SDR template for B2B export. 10-stage sales pipeline, 10 cron jobs, 4···
feynman
开源
一句话提问,自动查 arXiv 并写出文献综述
The open source AI research agent.
OpenSwarm
开源
在 Discord 里指挥 AI 团队自动接 Linear 工单写代码
OpenSwarm — Autonomous AI dev team orchestrator powered by Claude Code CLI. Discord···
sage
开源
多模型AI评审团,实时把关编码代理每一步操作。
An LLM council that reviews your coding agent's every move
houtini-lm
开源
把杂活交给便宜模型,省下 Claude 的 token 钱
MCP server that saves Claude Code tokens by delegating bounded tasks to local or clo···
LightAgent
开源
轻量框架,快速构建带工具和记忆的 OpenAI 兼容智能体
LightAgent: Lightweight Python framework for OpenAI-compatible agents with tools, me···
growth-engineer
开源
把增长工作流写成 Markdown,智能体直接照着干
Open-source catalog of go-to-market tools and workflows, written as markdown files a···
loushang
开源
统一调度多模型,让 AI 编码流程可控可追踪
AI-native agent harness for coding workflows by python: multi-model LLM orchestratio···
Open-Interface
开源
让大模型直接操控你的电脑,一句话完成复杂操作。
Control Any Computer Using LLMs.
