配置文件与生效范围
优先通过界面修改对应设置；需要手动编辑时，先确认数据目录、字段范围和保存方式。
配置保存在哪里
个人安装的主配置是 ~/.acecode/config.json，Windows 对应 %USERPROFILE%\.acecode\config.json。模型预设、默认模型以及网络、技能、MCP 等全局选项保存在这套用户配置中。
Windows 服务模式使用 %PROGRAMDATA%\acecode，与个人安装的数据目录分开。连接远端后台时，配置属于远端用户或服务身份；编辑本机文件不会自动修改远端配置。
| 配置层 | 适合保存的内容 |
|---|---|
| 全局配置 | 服务商连接、默认值、扩展连接与运行选项。 |
| 工作目录覆盖 | 例如 TUI 用 /model --cwd 保存的项目模型选择。 |
| 项目文件 | 项目规则、项目技能和项目 Hooks。 |
| 当前任务 | 任务选择的模型、权限与对话上下文。 |
具体位置见本地配置和数据。复制配置到其他计算机前，检查其中的绝对路径、可执行文件位置和认证信息。
修改与生效
模型页通过保存模型或保存修改提交；个性化文本和 MCP JSON 等控件会在离开编辑区时保存，并显示保存状态。TUI 设置中心的 General、Appearance 开关通常即时保存，配置与模型表单按底部提示使用 Ctrl+S。
不同配置有不同生效边界。任务模型和权限使用专门的切换入口；后台连接与运行服务以界面的应用结果为准。出现“重启 daemon 后生效”时，保存正在进行的工作后重启。手动改动任意 JSON 文件，并不等于所有运行中的模块都已经重新加载。
手动编辑与错误恢复
- 先备份当前有效配置，使用支持 UTF-8 的编辑器打开。
- 只修改目标字段，保持正确的 JSON 类型，不加入注释或尾随逗号。
- 重新加载相关功能，或按该功能要求重启。
- 检查界面实际值和一次小操作，确认修改已生效。
当前版本会保存有效配置快照。配置损坏且存在有效快照时，会备份错误文件并尝试自动恢复；Web/Desktop 会显示一次配置已自动回滚提示。没有可用快照时仍会报告配置错误。按提示查看备份位置并修复目标字段，备份可能含密钥，不要直接公开。