Codex 三系统实用教程：用文件清单练习路径处理、SHA-256 与只读验收

同一个文件在两台机器上看起来一样为什么哈希却不同让 Codex 帮忙排查时先把“看起来一样”拆成字节、换行、路径和工具运行位置才有可验证的目标。这次用一个只读取指定文件的小工具串起安装、登录、任务描述、代码审阅和结果验证。与此前 CSV、JSONL 教程不同本例关心文件本身适合排查下载产物、构建输入和跨系统传输差异。一、三系统安装、登录与工作目录本文使用 Codex CLI。以下安装与更新入口于 2026-09-25 对照 OpenAI 官方 CLI 文档 核查桌面应用和 IDE 扩展不是同一安装流程。Windows PowerShellpowershell-ExecutionPolicy ByPass-cirm https://chatgpt.com/codex/install.ps1 | iexmacOS、Linux 在各自终端执行curl-fsSLhttps://chatgpt.com/codex/install.sh|sh独立安装器可用同一命令更新若已有 npm 或 Homebrew 安装沿原渠道更新。新开终端执行codex --versionWindows 用Get-Command codex、macOS/Linux 用command -v codex核对实际入口。进入新建练习目录后执行codex按界面选择适用的登录方式。会话内用/status查看状态、/permissions核对工作范围确认工具正在处理哪一份项目。Windows 原生环境可以作为起点。只有依赖 Linux 工具链、项目已经在 WSL2或原生沙盒不满足需求时再选择 WSL不要把所有故障都归为“Windows 不支持”。依据见 Windows 官方说明。二、把验收要求写给 Codex本练习额外需要 Python 3它是示例程序的依赖。Windows 先检查py -3 --versionmacOS/Linux 检查python3 --version。安装了其他 Python 入口时后面的命令跟随已核实的解释器调整。在一个新的file-lab目录中启动 Codex可以给出下面的任务实现 file_report.py只用 Python 标准库。 命令行接收一个或多个明确指定的文件路径不递归扫描目录。 逐个输出路径、原始字节数、SHA-256、独立 LF、CRLF、独立 CR 数量。 必须按原始字节读取不做解码、换行转换或内容修复。 保留参数顺序重复路径按重复参数保留。 成功在 stdout 输出一个 JSON 对象并退出 0。 任一输入失败在 stderr 说明错误stdout 不输出部分 JSON退出 2。 输入只读拒绝末级符号链接和非普通文件。 先说明当前目录与修改计划完成后运行正常和失败场景报告实际结果。这里的“独立 LF”指不属于 CRLF 的 LF 字节不是文本行数。没有末尾换行的两行文本也可能只有一个 LF。提前把语义写清楚能避免模型自行选择另一种统计方式。三、可运行的参考实现保存为file_report.py。这份程序用于本次离线验证不是某次 Codex 模型会话的输出记录。importargparseimporthashlibimportjsonimportsysfrompathlibimportPathdefinspect_file(path):pathPath(path)ifpath.is_symlink()ornotpath.is_file():raiseValueError(expected a regular, non-symlink file)datapath.read_bytes()crlfdata.count(b\r\n)return{path:str(path),bytes:len(data),sha256:hashlib.sha256(data).hexdigest(),lf_only:data.count(b\n)-crlf,crlf:crlf,cr_only:data.count(b\r)-crlf,}defmain(argvNone):parserargparse.ArgumentParser()parser.add_argument(files,nargs,typePath)argsparser.parse_args(argv)try:rows[inspect_file(path)forpathinargs.files]except(OSError,ValueError)aserror:print(str(error),filesys.stderr)return2print(json.dumps({files:rows},ensure_asciiTrue,indent2))return0if__name____main__:raiseSystemExit(main())read_bytes()保留文件原始字节SHA-256 计算也直接使用这些字节参见 Path.read_bytes 和 hashlib。因此 UTF-8 BOM、不同换行都会计入长度和摘要。JSON 使用 ASCII 转义输出中文路径可能显示为\uXXXX读回 JSON 后仍是原路径不是路径丢失。程序不把文本编码正确与否当作输入条件二进制文件也能按字节检查。四、制造一个可手算的跨系统样本把下面代码保存为make_sample.py用 Python 创建样本可避免编辑器默认换行影响实验frompathlibimportPath folderPath(样本 files)folder.mkdir(exist_okTrue)(folder/LF.txt).write_bytes(ba\nb\n)(folder/CRLF.txt).write_bytes(ba\r\nb\r\n)Windows PowerShell 在练习目录执行py-3 make_sample.py py-3 file_report.py样本 files/LF.txt样本 files/CRLF.txt$LASTEXITCODEmacOS/Linux 在各自终端执行python3 make_sample.py python3 file_report.py样本 files/LF.txt样本 files/CRLF.txtecho$?路径包含空格时整体加引号。本例路径使用/交给 Python 的路径处理不要把C:\...直接当成 Linux 路径使用。WSL 内的解释器和依赖也需要在 WSL 内确认。预期LF 文件为 4 字节、独立 LF 为 2CRLF 文件为 6 字节、CRLF 为 2。两者摘要不同退出码为 0。长度差来自两个额外的 CR 字节与模型能力无关。本轮在 macOS arm64、Python 3.13.13 实际运行得到上述结果12 个测试方法通过覆盖已知哈希、空文件、混合换行、无末尾换行、二进制、BOM、中文空格路径、参数顺序、缺失文件、目录、符号链接和无参数。只读检查本机 Codex CLI 为 0.155.1没有把这个版本称为所有平台的最新版。五、三系统排障时先定位层次Windows命令找不到先查安装入口和当前 PowerShell文件找不到先检查工作目录、引号和盘符不要改算法掩盖路径错误。macOS确认正在使用哪一套 Python尤其不要把不同终端环境中的解释器混为一谈。Linux核对文件名实际大小写、读权限和挂载位置。相同文件名不代表传输后的字节相同。WSL先决定项目在哪个环境运行再统一工具、Python 和样本路径不要一半命令在 Windows、一半在 WSL却拿两份文件作比较。交付审阅时要求 Codex 展示修改文件、实际命令和测试结果。若使用 Git还要检查新文件和差异确认没有悄悄修改样本“测试通过”不替代对测试含义的理解。六、这个练习的边界整文件读取不适合超大文件符号链接检查只针对末级路径不是抵御路径竞争或目录链接的安全隔离机制。多个文件依次读取也不构成一致性快照。源码没有写入输入但读文件可能更新文件系统访问时间。生产场景需要另行设计资源限制和并发变更处理。SHA-256 可以用于检查字节是否与可信摘要相符本例没有证明文件来源可信也没有判断业务内容是否正确。先把这些边界讲清楚Codex 才能围绕实际需求继续开发。本文使用 AI 辅助整理与编写。实测仅指有记录的本机 Python 程序没有运行两款工具的模型会话也没有 Windows/Linux 实机测试。