SuperAPI AI 工具集

codex-keysmith-instruction-installer

编程与开发

查看项目

更新于 10-15 22:34

技能介绍

用途:把本地 Markdown 指令文件安装到 Codex CLI 配置目录,并为其设置 model_instructions_file 配置项。工具为单个 Python 脚本,除 Python 3.8+ 外无外部依赖,仅用标准库。安装:git clone https://github.com/Jia-Ethan/codex-keysmith.git 后进入目录,可用 python3 -m py_compile codex-instruct.py 做语法检查,并用 python3 codex-instruct.py --dry-run 预览。

主要能力:默认只预览,任何写入都需额外加 --yes;写入前自动备份 config.toml 与已有指令文件(带时间戳);对 --name 做路径安全校验,拒绝路径分隔符、绝对路径、上级目录引用、空名和带空格名;内置可选的 GPT-5.5 unrestricted 示例指令文件,也支持自定义 .md 文件。

用法:安装内置示例用 python3 codex-instruct.py --codex-dir ~/.codex --yes;安装自定义文件用 python3 codex-instruct.py --file ./my-custom-instructions.md --name my-custom --codex-dir ~/.codex --yes。可用 --dry-run 预览,--codex-dir 指定目录,不指定时脚本会在 ~/.codex、~/.config/codex、macOS 的 ~/Library/Application Support/codex 等处自动查找。写入后 config.toml 更新为 model_instructions_file = "./my-custom.md",需重启 Codex CLI 使指令生效,可用 cat ~/.codex/config.toml | grep model_instructions_file 验证。回滚可复制带 .bak_ 时间戳的备份文件还原,或手动移除该配置行并删除指令文件。

适用场景:为 Codex CLI 管理本地指令文件、按项目类型切换指令、团队通过 Git 共享指令文件等。

限制:不会修补 Codex 二进制、不拦截网络流量、不修改运行中进程,也不处理 token、cookie 或凭据。建议始终显式指定 --codex-dir,先预览再写入,并定期清理旧备份。