[!WARNING] Windows v0.1.0 known-bad / Windows v0.1.0 已确认存在严重缺陷

不要在 Windows 上执行 v0.1.0 fresh deployment。该版本可能先因 os.utime(..., follow_symlinks=False) 失败，再由 POSIX 目录 fd 清理触发第二个 PermissionError，覆盖原始错误并留下旧版脚本不能恢复的 initializing journal。不要手工编辑或删除 .codex-keysmith-transaction-*、cleanup marker、snapshot 或其他恢复证据。

请从 v0.1.1 Release 下载并校验 SHA256SUMS，然后使用 v0.1.1 独立脚本依次执行：

bash python3 codex-instruct-v0.1.1.py --codex-dir PATH --status python3 codex-instruct-v0.1.1.py --codex-dir PATH --recover python3 codex-instruct-v0.1.1.py --codex-dir PATH --recover --yes python3 codex-instruct-v0.1.1.py --codex-dir PATH --status

Do not use v0.1.0 for a fresh Windows deployment. Preserve every journal, cleanup marker, and snapshot. Download v0.1.1 from the fixed Release, verify SHA256SUMS, then run --status, recovery preview, --recover --yes, and --status as shown above.

codex-keysmith v0.1.0

首个正式版本。codex-keysmith 是零运行时依赖的单文件 Python CLI，用于以 preview-first、可恢复的方式部署和管理 Codex model_instructions_file。

主要能力

• 默认 dry-run，显式 --yes 才执行写入；支持 --status、--recover、--restore-hooks 与基于部署清单的分层 --uninstall。
• 默认整体隔离活跃 hooks.json，不解析或改写 JSON 内容；--skip-hooks-isolation 必须显式指定目标目录并显示副作用警告。
• 部署前生成持久事务日志，使用文件指纹、原子发布、完整 final sweep 与反向回滚处理并发变化和中断。
• 通过 .codex-keysmith-manifest.json 记录 MD、config、实际隔离的 hooks、实际迁移的 legacy 文件及备份所有权。
• 支持旧版 gpt5.5-unrestricted.md 迁移、自定义外部 Markdown、保守 TOML 顶层键更新，以及 --lang auto|zh-CN|en。
• 提供离线 Prompt Bank 契约验证、branch coverage 门槛和可重复构建的 ZIP、tar.gz、独立脚本与 SHA256SUMS。

使用前必读

内置提示词会显著改变 Codex 的全局回答行为。请先阅读 examples/gpt-unrestricted.md，或使用自己的 --file。内置提示词 SHA-256：

:::text
0ac8420d504f1a42db87be9f8555f740bf4c1e7b72beb0dde6a4b8d70b6cda07

不要使用 curl | python。下载全部资产后，先按附带的 SHA256SUMS 校验，再运行 --version、--status 和 --dry-run。

兼容性

• 主要支持：macOS、Linux。
• 推荐 Python：3.10–3.14；Python 3.8 仅保留 legacy compatibility。
• Windows：v0.1.0 为 experimental。CI 中 Windows job 保持可见但非阻断；尚不声明正式 Windows 支持。

Assets

• codex-keysmith-v0.1.0.zip
• codex-keysmith-v0.1.0.tar.gz
• codex-instruct-v0.1.0.py
• SHA256SUMS

完整变化与升级/回滚说明见 CHANGELOG.md (github.com)。

First formal release. codex-keysmith is a zero-runtime-dependency Python CLI for preview-first, recoverable management of Codex model_instructions_file deployments.

Key capabilities include read-only status, durable deployment recovery, whole-file hook isolation, manifest-owned layered uninstall, legacy prompt migration, conservative TOML updates, explicit language selection, offline prompt-bank contracts, and reproducible release assets.

macOS and Linux are the primary targets. Python 3.10–3.14 is recommended; Python 3.8 is legacy compatibility. Windows support is experimental and its CI jobs are visible but non-blocking.