codex-keysmith v0.1.0

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：

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。

---

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.