Codex CLI 也能校对 WPS 稿子：一份 config.toml 加一个斜杠命令

1. 为什么要在终端里校对 WPS 稿子Codex CLI 是我终端里常驻的工具平时主要拿它写脚本、查日志、跑一些重复性的文本处理。但有个场景一直让我觉得割裂稿子本身在 WPS 里校对却要切到浏览器或者另一个编辑器里复制粘贴。尤其是会议纪要、英文说明文档这类需要逐段核对的东西来回切换窗口的损耗比校对本身还大。后来我换了个思路既然 Codex CLI 支持 MCP 服务而 WPS 又有本机加载项那能不能让 Codex CLI 直接读到当前打开的 WPS 文档然后用一个斜杠命令触发校对实测下来这条路是通的而且配置比想象中简单——一份config.toml加一个斜杠命令文件就够了。这篇要讲的就是这套落地配置。核心是三件事第一在~/.codex/config.toml里接入 TaoToken 的统一 Key/API 通道让 Codex CLI 的模型请求走一个稳定入口第二注册一个 MCP 服务指向本机 WPS 加载项第三写一个斜杠命令文件当操作手册在会话里手动引入校对纪律。适合已经在用 Codex CLI、又经常和 WPS 文档打交道的人尤其是需要做保密自查、英文校对、会议纪要提取行动项这类重复劳动的同学。需要提前说明的是这套链路要求 Codex 会话和 WPS 在同一台机器上因为 MCP 服务只在127.0.0.1监听。远程开发机上跑 Codex 的话这条链路通不了得另想办法。下面按配置顺序一步步来。2. TaoToken 前置统一 Key 与 API 通道Codex CLI 默认走 OpenAI 的接口但很多时候我们需要一个统一的入口来管理 Key、切换模型、控制成本。TaoToken 在这里扮演的就是这个角色——它提供一个兼容的 API 通道你只需要在config.toml里把 base URL 指过去Key 换成 TaoToken 的Codex CLI 的其他使用习惯完全不变。先拿到 Key。打开 TaoToken 控制台在 API Keys 页面创建一个新 Key复制出来。这个 Key 后面要写进config.toml所以别弄丢。控制台地址是 https://taotoken.net/console 创建 Key 的入口在 https://taotoken.net/api-keys 。拿到 Key 之后先确认 Codex CLI 本身能跑起来。终端里执行codex --version如果提示找不到命令说明 Codex CLI 还没装。装好之后先别急着配 MCP先把模型通道跑通。这一步很关键因为后面校对功能里涉及模型推理的部分比如英文语法检查、翻译都依赖这个通道。如果模型没配好文档类工具能调但涉及推理的校对会报错。TaoToken 的 API 地址是 https://taotoken.net/api 注意这个地址不带任何查询参数直接作为 base URL 用。Key 的格式通常是sk-开头的一串字符。把这两个信息记下来下一步写进配置。3. 可复制配置config.toml 骨架与斜杠命令3.1 config.toml 的模型通道配置~/.codex/config.toml是 Codex CLI 的主配置文件。如果你之前没动过它可能只有几行默认内容。我们要做的是追加两段一段是模型通道一段是 MCP 服务。先看模型通道部分。在文件里加入model_provider taotoken model gpt-4o [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY这里model填你想用的模型名base_url固定指向 TaoToken 的 API 地址。env_key表示 Key 从环境变量读取这样不会把 Key 硬编码在配置文件里。然后在 shell 的启动文件里加上export TAOTOKEN_API_KEYsk-你的KeyWindows PowerShell 的话用$env:TAOTOKEN_API_KEYsk-你的Key想永久生效就写进系统环境变量。配好之后新开一个终端跑一次简单请求验证codex exec 用一句话说明什么是 TOML 格式如果能看到模型返回内容说明通道通了。这一步没过就别往下走后面所有校对都依赖它。3.2 追加 MCP 服务指向 WPS 加载项WPS 那边需要一个本机加载项来暴露文档内容。安装脚本会检测~/.codex目录如果存在就往config.toml追加一段 MCP 配置。追加的内容长这样[mcp_servers.chayuan-wps-mcp] url http://127.0.0.1:62588/mcp这段的意思是Codex CLI 启动时会去连接本机 62588 端口的 MCP 服务这个服务由 WPS 加载项提供。注意它是追加写入的脚本会先查重不会重复添加。如果你手工编辑过config.toml要保证 TOML 格式合法别多一个引号或者少一个方括号否则 Codex CLI 启动时会直接报解析错误。MCP 服务只在127.0.0.1监听不带 token 认证。这意味着它只对本机可见安全性上没问题但也意味着 Codex 会话和 WPS 必须在同一台机器上。远程开发机上跑 Codex 的同学这条链路通不了。3.3 斜杠命令文件Codex 版的技能Codex CLI 没有 Claude Code 那种自动加载技能目录的机制所以接 WPS 文档智能体的方式比较直接配一个 MCP 服务再加一个提示词文件当操作手册。安装脚本会往~/.codex/prompts/放一个wps-skill-chayuan.md这个文件就是 Codex 版的技能。它的作用是在会话里通过斜杠命令手动引入。文件本身是普通 markdown你可以按自己的习惯改。比如把常用的校对开场白直接写进去省得每次新会话都重新敲一遍。文件内容大致包含操作纪律、批注模式说明、从后往前插入翻译的顺序要求等。斜杠命令的触发方式是/wps-skill-chayuan敲完之后提示词文件的内容会被加载进当前会话上下文。这跟 Codex 本身的使用习惯是一致的——它不自动加载靠你手动引入。4. 验证请求与成功结果配置写完先做冒烟测试。开一个新会话敲/mcp看服务列表里有没有chayuan-wps-mcp。如果有说明 MCP 连接正常。然后在 WPS 里随便打开一份文档回到 Codex 会话里敲/wps-skill-chayuan这会把操作纪律加载进来。接着发一条只读指令读取当前文档标题和前两段只读冒烟不写批注不改正文。如果回显的标题和段落内容跟 WPS 里对得上说明整条链路通了。这一步只读不写不会动你的文档可以放心测。冒烟通过之后就可以试真实校对场景了。比如会议纪要从当前文档提取行动项和风险行动项写明责任人和期限风险单列。先以清单形式给我预览确认后用批注挂在对应段落上。它会先列清单你删掉不靠谱的条目再说按剩下的写批注。批注模式原文不动发出去给人核对很干净。英文材料处理也是类似。逐段检查拼写语法逐段检查这份英文文档的拼写语法输出问题清单每条带原文片段和修改建议。只预览。中文稿翻英文则是把当前文档逐段翻译成英文译文插到各段后面从最后一段开始往前插先预览两段给我确认风格。从后往前这个顺序有讲究从前往后插每插一段后面的锚点就变了容易串段。提示词文件里写了这条它自己会执行但知道原理更放心。保密自查也常用对当前文档做保密检查重点手机号、身份证号、内部系统名称命中项先列清单。确认后可以走脱密占位符替换是可逆的密码自己设。5. 本篇常见错排查5.1 MCP 服务列表里没有 chayuan-wps-mcp先确认 WPS 加载项是否在运行。MCP 服务由加载项提供加载项没起来的话 62588 端口是空的。可以在终端里测一下端口curl -s http://127.0.0.1:62588/mcp如果连接被拒绝说明服务没起。重启 WPS或者重新跑一遍安装脚本的--fetch参数。另外确认config.toml里那段[mcp_servers.chayuan-wps-mcp]确实写进去了有时候手工编辑会把这段覆盖掉。5.2 模型推理类校对报错文档类工具能调但涉及模型推理的校对报错通常是模型通道没配好。检查TAOTOKEN_API_KEY环境变量是否在当前 shell 里生效echo $TAOTOKEN_API_KEY如果输出为空说明环境变量没加载。新开终端或者手动 export 一次。另外确认config.toml里的base_url是https://taotoken.net/api不要多加斜杠或者路径。5.3 TOML 解析错误导致 Codex CLI 起不来手工编辑过config.toml的话最容易出的问题是格式不合法。TOML 对引号和方括号很敏感。一个快速检查办法是用 Python 解析一遍python3 -c import tomllib; tomllib.load(open($HOME/.codex/config.toml,rb)); print(ok)如果报错根据提示行号去改。常见错误包括字符串没加引号、表头少了一个方括号、键值对之间少了等号。5.4 斜杠命令每次新会话都要敲这是 Codex CLI 的设计不是 bug。它没有自动加载技能目录的机制所以每次新会话都要手动/wps-skill-chayuan一次。嫌烦的话把常用校对开场白直接写进提示词文件按自己的习惯改~/.codex/prompts/wps-skill-chayuan.md那是个普通 markdown改完下次会话就生效。5.5 远程开发机上跑 Codex 连不上MCP 服务只在127.0.0.1监听远程开发机和本机 WPS 不在同一台机器上这条链路通不了。这种情况得想别的办法比如把文档同步到开发机再用纯文本方式处理或者在本机跑 Codex 会话。这不是配置问题是架构限制。6. 把校对流程固化下来整套配置跑通之后我自己的用法是把校对流程拆成几个固定动作先/wps-skill-chayuan引入纪律再发只读冒烟确认链路然后按场景发校对指令。会议纪要、英文校对、保密自查这三个场景用得最多基本可以覆盖日常文档处理的大部分重复劳动。如果你主要做长期编码或者 Agent 类任务可以考虑 Coding Plan把模型调用和额度管理统一起来https://taotoken.net/coding-plan 。如果只是想先验证模型对话效果模型对话页面可以直接试https://taotoken.net/chat 。接入过程中遇到 Key 或者通道问题先看接入文档https://taotoken.net/doc 大部分配置细节那里都有。最后提醒一句config.toml是追加写入的脚本会先查重不会重复添加。但如果你手工编辑过这个文件保持 TOML 格式合法别多一个引号。模型配置不在这套技能里TaoToken 的设置界面里配对话模型云端 API 或者内网兼容端点都行。模型没配的话文档类工具能调但涉及模型推理的校对会报错提示还挺明确。