必须绕过Muse Wonder Full自动保存，将项目导出为标准文件结构后初始化Git并配置.gitignore排除.musecache/、.musestate等文件，再分阶段add与commit变更，同时关闭自动保存或每次启动前restore状态文件以防冲突。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在 Muse Wonder Full 中管理多文件代码变更时，必须绕过其内置的自动保存机制，将项目目录作为 Git 仓库直接操作，否则 Git 无法捕获真实文件状态变化。
确认 Muse Wonder Full 项目结构是否可被 Git 跟踪
打开 Muse Wonder Full 项目所在文件夹，检查是否存在 【.museproject 文件且同级有 src/、assets/、config.json 等实际源码目录】；若只有单个 .mwf 或 .zip 包，说明项目被封装，Git 无法有效管理——必须先导出为标准文件结构。
点击菜单栏「文件 → 导出为文件夹」，选择空目录导出，确保生成含 index.html、src/、public/ 的扁平化结构。
初始化 Git 仓库并排除 Muse 自动生成文件
进入导出后的项目根目录，终端执行：git init。
创建 .gitignore 文件，写入以下四行：
.musecache/<br>.musestate<br>node_modules/<br>*.mwf
这一步不能跳过：Muse Wonder Full 运行时会持续写入 .musecache/ 和 .musestate，不忽略会导致大量无关二进制变更污染提交历史。
分阶段提交多文件变更
第一步：用 git add -N . 告知 Git 当前工作区所有路径，但暂不暂存内容（适用于新增大量文件前预检）。
第二步：执行 git status --short，观察输出中以 ?? 开头的新文件和 M 开头的已修改文件，重点核对 src/components/ 和 public/ 下的变更是否符合预期。
第三步：按逻辑模块分批暂存，例如先运行 git add src/utils/ src/hooks/，再单独处理样式变更：git add src/styles/theme.css src/styles/base.scss。
第四步：提交时强制使用 -m 并附带明确范围，如：git commit -m "feat(login): add token refresh logic + error boundary"。避免用 “update files” 这类模糊描述，Muse 的多文件联动常引发隐式副作用，清晰的提交信息是回溯关键。
处理 Muse 自动注入的 runtime 文件冲突
方法一：每次启动 Muse Wonder Full 前，先运行 git restore .musestate .musecache/ 清除运行态残留。
方法二：在 Muse 设置中关闭「自动保存项目状态」（设置 → 编辑器 → 取消勾选“Persist editor state across sessions”），从源头禁用 .musestate 生成。
【务必在首次 clone 仓库后立即执行方法二，否则团队成员本地会反复产生 .musestate 提交冲突】
