想要用 CodeBuddy 的 /init 命令快速搭建项目框架？关键前提是让 AI 优先加载当前工作区的上下文信息。否则，它生成的通用模板很可能与你实际的技术栈、目录结构或配置偏好不匹配，后续所有代码都可能偏离真实需求。

务必注意，这一步如果遗漏，后续修复的成本会高得多。因此，在正式操作前，请先确认环境已准备妥当。

确认环境准备就绪

打开终端，进入项目根目录——请确保不是父文件夹，也不是空的无关目录。该目录应该是已有或新创建的空项目根目录，且不能包含 package.json、tsconfig.json 这类关键配置文件。

执行 codebuddy --version，确认 CLI 已正确安装且是最新版本（v2.4.0 及以上）。若尚未安装，请运行 npm install -g codebuddy-cli。

启动 CodeBuddy 交互模式：输入 codebuddy 并回车，等待界面出现「Ready」提示符即可。

执行 /init 命令

在交互模式中直接输入 /init。

AI 会自动扫描当前目录结构，检测项目语言特征——例如是否存在 .vue、.tsx、Dockerfile 等文件，大约 5 秒内即可输出初始化结果。

如果目录为空，AI 默认按 Node.js + TypeScript 全栈方案生成。若检测到 .git 存在但缺少 src/ 目录，AI 会询问你偏好的框架（React、Vue 或 Svelte），然后根据你的选择生成。如果目录中已有部分文件（如 .env 或 README.md），AI 会保留它们，仅补全缺失的项目骨架。

验证与修正

首先检查生成的文件，重点确认 .codebuddy/ 目录是否成功创建，该目录下应包含 project.graph.json 和 rules.yaml。

接着运行 ls -la，确认 src/、package.json、tsconfig.json 等文件是否齐全。缺少任意一项，说明扫描失败——此时不要急于重试 /init，建议先用 /debug context 查看 AI 读取到的目录快照。

如果发现生成的端口配置（例如 5000）与你本地已占用的端口冲突，请立即编辑 server.js 或 dev-server.config.js，修改 PORT 值，以免后续启动时报错。