设置与运行时能力

先说结论

设置中心把外观、构建信息、运行阈值、Provider、模型厂商、Prompt 注入、快捷键、模型内置能力、视频生成和 UI 日志汇总到一个页面。不同卡片的作用域与生效时机并不相同，保存成功也不意味着正在运行的 Thread 会被热替换。

多数运行时设置要求先选择项目，因为它们以当前 CWD 作为偏好与能力边界。外观设置例外：它即时作用于整个工作台，并保存在当前浏览器。

怎么理解

Model Providers 只保存 API Key 的环境变量名称，不在设置页输入或显示密钥明文。

怎么使用

1. 先在聊天页选择项目，再打开设置，确认页头显示正确的当前项目。
2. 在 About 区刷新构建信息，记录版本、runtime、构建时间与 commit；排障时这些信息应与复现证据一起保存。
3. 修改 runtime 阈值时保持 0 < warn < danger < critical <= 100，统一超时至少为 30 秒。
4. 选择 Active Provider 后保存 Provider 设置；新建 Thread 验证新配置，不用旧 Thread 判断保存是否生效。
5. 分别调整 Summary 和 ApprovalPolicy。never 表示全部放行，风险显著高于默认 on-request，不应为了减少提示而盲目启用。
6. 配置模型厂商时只填写环境变量名、Base URL、模型、Codex home/instance 与预算策略；密钥值放在受控环境中。
7. 查看“模型内置能力”的 enforcement 分组：native-hard 在启动前移除，effect-hard 限制为只读，soft-audit 仅提醒优先使用项目工具。
8. 修改 Prompt、快捷键或 UI 日志后，用对应页面和真实动作验证，而不是只看“已保存”提示。

常见问题

• 页面提示当前项目路径为空：回到聊天页选择项目；不要把空 CWD 保存成全局默认。
• 阈值保存失败：检查百分比顺序、整数要求和最小超时。
• Provider 保存成功但旧会话无变化：创建新 Thread；Provider 与 Prompt snapshot 有生命周期边界。
• 模型厂商显示 missing：检查环境变量名对应的变量是否在 owner 进程环境中存在，不把明文密钥粘进表单或日志。
• 内置能力关闭后仍可能出现：先看 enforcement。soft-audit 不是强制拦截，Codex 当前不支持可靠关闭所有同类能力。
• 更新按钮禁用：当前构建未启用应用更新，不代表网络故障。

适用范围

• 移动端账号区当前主要展示本地项目与 Provider 状态；退出登录入口仍标记为待鉴权接入。
• Prompt 覆盖用于调试，留空保存会恢复默认；它不应替代 canonical Prompt、Memory 或 Skill 真源。
• UI 日志级别只控制 UI log surface，不会自动修改所有后端日志策略。
• 视频生成 API Key 是单独能力入口；不得把它误当成 Model Provider 通用密钥配置。
• 设置页显示的成功状态必须由新 Thread、真实工具调用、更新检查或日志查询等相应动作验证。

延伸阅读

Provider 身份、审批和恢复语义见 Provider、审批与恢复；Prompt 与能力真源见 Memory、Prompt 与 Skills。