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

关注

原创最新推荐文章于 2026-10-31 09:09:45 发布 184 阅读 AI 写同款· GEO 优化 ›

AI应用架构师：用RAG解决大模型“幻觉”问题的客服架构设计在当今的智能客服领域，大语言模型（LLM）凭借流畅的对话能力和强大的理解能力，逐渐取代传统规则式机器人，成为客服系统的核心。但随之而来的“幻觉”问题（即模型编造不存在的信息）却成了致命伤：比如客户问“你们的产品保修期多久”，AI客服可能会自信地回答“3年”，而实际保修期只有1年——这种错误不仅会误导客户，还可能引发投诉、退货甚至法律风险。阅读详情

同一个文件在两台机器上看起来一样，为什么哈希却不同？让 Codex 帮忙排查时，先把“看起来一样”拆成字节、换行、路径和工具运行位置，才有可验证的目标。

这次用一个只读取指定文件的小工具串起安装、登录、任务描述、代码审阅和结果验证。与此前 CSV、JSONL 教程不同，本例关心文件本身，适合排查下载产物、构建输入和跨系统传输差异。

一、三系统安装、登录与工作目录

本文使用 Codex CLI。以下安装与更新入口于 2026-09-25 对照 OpenAI 官方 CLI 文档核查；桌面应用和 IDE 扩展不是同一安装流程。

Windows PowerShell：

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

macOS、Linux 在各自终端执行：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

独立安装器可用同一命令更新；若已有 npm 或 Homebrew 安装，沿原渠道更新。新开终端执行 codex --version，Windows 用 Get-Command codex、macOS/Linux 用 command -v codex 核对实际入口。

进入新建练习目录后执行 codex，按界面选择适用的登录方式。会话内用 /status 查看状态、/permissions 核对工作范围，确认工具正在处理哪一份项目。

Windows 原生环境可以作为起点。只有依赖 Linux 工具链、项目已经在 WSL2，或原生沙盒不满足需求时，再选择 WSL；不要把所有故障都归为“Windows 不支持”。依据见 Windows 官方说明。

二、把验收要求写给 Codex

本练习额外需要 Python 3，它是示例程序的依赖。Windows 先检查 py -3 --version；macOS/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 模型会话的输出记录。

import argparse
import hashlib
import json
import sys
from pathlib import Path


def inspect_file(path):
    path = Path(path)
    if path.is_symlink() or not path.is_file():
        raise ValueError('expected a regular, non-symlink file')
    data = path.read_bytes()
    crlf = data.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,
    }


def main(argv=None):
    parser = argparse.ArgumentParser()
    parser.add_argument('files', nargs='+', type=Path)
    args = parser.parse_args(argv)
    try:
        rows = [inspect_file(path) for path in args.files]
    except (OSError, ValueError) as error:
        print(str(error), file=sys.stderr)
        return 2
    print(json.dumps({'files': rows}, ensure_ascii=True, indent=2))
    return 0


if __name__ == '__main__':
    raise SystemExit(main())

read_bytes() 保留文件原始字节；SHA-256 计算也直接使用这些字节，参见 Path.read_bytes 和 hashlib。因此 UTF-8 BOM、不同换行都会计入长度和摘要。

JSON 使用 ASCII 转义输出，中文路径可能显示为 \uXXXX；读回 JSON 后仍是原路径，不是路径丢失。程序不把文本编码正确与否当作输入条件，二进制文件也能按字节检查。

四、制造一个可手算的跨系统样本

把下面代码保存为 make_sample.py，用 Python 创建样本，可避免编辑器默认换行影响实验：

from pathlib import Path
folder = Path('样本 files')
folder.mkdir(exist_ok=True)
(folder / 'LF.txt').write_bytes(b'a\nb\n')
(folder / 'CRLF.txt').write_bytes(b'a\r\nb\r\n')

Windows PowerShell 在练习目录执行：

py -3 make_sample.py
py -3 file_report.py "样本 files/LF.txt" "样本 files/CRLF.txt"
$LASTEXITCODE

macOS/Linux 在各自终端执行：

python3 make_sample.py
python3 file_report.py "样本 files/LF.txt" "样本 files/CRLF.txt"
echo $?

路径包含空格时整体加引号。本例路径使用 /，交给 Python 的路径处理；不要把 C:\... 直接当成 Linux 路径使用。WSL 内的解释器和依赖也需要在 WSL 内确认。

预期：LF 文件为 4 字节、独立 LF 为 2；CRLF 文件为 6 字节、CRLF 为 2。两者摘要不同，退出码为 0。长度差来自两个额外的 CR 字节，与模型能力无关。

本轮在 macOS arm64、Python 3.13.13 实际运行得到上述结果；12 个测试方法通过，覆盖已知哈希、空文件、混合换行、无末尾换行、二进制、BOM、中文空格路径、参数顺序、缺失文件、目录、符号链接和无参数。只读检查本机 Codex CLI 为 0.155.1；没有把这个版本称为所有平台的最新版。