配置文件与生效范围
优先通过界面修改对应设置；需要手动编辑时，先确认数据目录、字段范围和保存方式。
配置保存在哪里
个人安装的主配置是 ~/.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 文件，并不等于所有运行中的模块都已经重新加载。
TUI 问答配置
TUI 中的 AskUserQuestion 会在选项较多或说明较长时使用可滚动内容区。以下字段位于配置文件的 tui 对象中：
| 字段 | 默认值 | 有效范围 | 说明 |
|---|---|---|---|
question_min_visible_rows | 4 | 2–12 | AskUserQuestion 内容区的最小可见行数。内容超出视口后，可使用鼠标滚轮或滚动条查看。 |
question_selection_feedback_ms | 200 | 0–1000 | 预设选项提交后保留选中视觉反馈的时长，单位为毫秒。设置为 0 可关闭反馈延迟。 |
例如：
{
+ "tui": {
+ "question_min_visible_rows": 4,
+ "question_selection_feedback_ms": 200
+ }
+}这两个字段会在读取配置时限制在有效范围内。超出范围的整数会自动限制到边界，并记录警告；非整数值会被忽略并继续使用默认值。省略字段时使用默认值，配置保存采用稀疏写入，不会强制写出默认值。
手动编辑与错误恢复
- 先备份当前有效配置，使用支持 UTF-8 的编辑器打开。
- 只修改目标字段，保持正确的 JSON 类型，不加入注释或尾随逗号。
- 重新加载相关功能，或按该功能要求重启。
- 检查界面实际值和一次小操作，确认修改已生效。
当前版本会保存有效配置快照。配置损坏且存在有效快照时，会备份错误文件并尝试自动恢复；Web/Desktop 会显示一次配置已自动回滚提示。没有可用快照时仍会报告配置错误。按提示查看备份位置并修复目标字段，备份可能含密钥，不要直接公开。