Codex CLI config.toml 可视化修改工具（Rust）

本项目提供一个 Windows 桌面 GUI，用于编辑 Codex CLI 的 config.toml（通常位于 C:\Users\<用户名>\.codex\config.toml）。

核心规则（很重要）

• 默认全部留空：打开程序时，所有配置项都是“未设置”状态。
• 留空=不修改/不写入：
  • 勾选“合并保存”（推荐）且目标 config.toml 已存在时：留空表示不修改原有值，不会清除其它配置（例如 mcp_servers 等）。
  • 取消勾选“合并保存”时：留空表示不写入该项，保存会只包含你填写的项（会覆盖原文件）。

使用方式

1. 运行程序后，确认顶部的 config.toml 路径 是否正确（默认会根据 USERPROFILE 推导）。
2. （可选）点击 从文件导入：把现有 config.toml 的值填充到界面中。
3. 在列表中修改配置：
   • bool：使用三态下拉框（未设置/true/false）
   • 字符串/数字：直接输入；清空即变为“未设置”
   • 数组：可以逐行输入（每行一个元素），也可以直接粘贴 TOML 数组（例如 ["a","b"]）
   • 复杂结构：使用“可直接粘贴 TOML 值片段”的多行输入框
   • 填入示例：若模板中提供了示例值，可点击“填入示例”快速填充
   • 可选值：若模板注释中包含枚举值（如 never/on-request/untrusted），界面会显示“可选值”按钮，点击即可填入
4. 点击 保存：写入到指定路径；下方“保存预览”只展示会写入的内容。

中文显示（方块）问题

本工具启动时会尝试从 Windows 系统字体目录加载中文字体（优先 C:\Windows\Fonts\simhei.ttf，其次 Deng.ttf 等），以避免中文显示为方块。

如果你的系统缺少中文字体，界面仍可能出现方块。解决办法：

• 安装/启用系统中文字体（推荐包含 simhei.ttf 或其它中文 ttf/otf 字体）
• 重启本工具

“合并保存/保留未知项”说明

当你通过 从文件导入 读取了现有 config.toml：

• 勾选 保存时合并现有配置并保留未知项（推荐）：保存时会在原文件基础上更新你填写的项，并保留原文件中其它配置（更安全）。
• 取消勾选：保存时仅写入你在界面中填写的项（更干净，但更破坏性）。

构建与打包（二进制）

手动构建 Release：

cargo build --release

生成的可执行文件在：

• target\release\codex-config-gui.exe

运行（开发模式）：

cargo run

配置项说明来源

界面中每个配置项下方的“作用说明”，来自本项目内置的模板文件：

• assets\template_config.toml

（该模板来自你提供的示例配置，程序会解析其中的注释作为说明。）

迁移策略

无迁移，直接替换：推荐使用“合并保存”，这样只会更新你填写的项，其它配置（如 mcp_servers）不会被清除。若你确实想生成“最小配置”，可取消勾选“合并保存”后再保存（会覆盖原文件）。