Claude Code、Codex 怎么给本机 WPS 做文件自动审查
概要：装察元AI文档助手、接通本机 MCP 后，用 Claude Code、Codex、Cursor 直接审当前 docx：先预览问题，再确认写批注。本文写清安装到第一次审查闭环。
正文：
想让 Claude Code 或 Codex 自动审查本机 WPS 里的文件，关键不是再找一个网页上传框，而是让智能体能调用文档工具。察元加载项跑在 WPS 里，本机再起一个 MCP 服务，Claude Code、Codex、Cursor、OpenClaw、Hermes 连上本地地址后，就能读当前稿、跑校对预览、在你确认后写批注或改字。文档默认不离开这台机器。下面按安装、自检、各客户端配置、第一次自动审查写完，中间留贴图位。
一、自动审查在链路里怎么分工
察元安装包会装进 WPS 文字的加载项，负责读段落、定位文字、写批注、替换、保存。旁边还有本机 sidecar，默认监听 127.0.0.1 的 62588 端口，对外提供 Streamable HTTP MCP。Claude Code、Codex、Cursor、OpenClaw、Hermes 只要支持 HTTP 型 MCP，就填同一个地址。服务名建议统一写成 chayuan-wps-mcp，少写后缀，客户端列表里容易当成另一个服务。
推理在智能体客户端完成：它决定查错别字还是查标点，怎么组织问题列表。WPS 侧负责把结果落到编辑器。文件自动审查的稳妥顺序是：智能体先预览，人确认后写批注，需要改字再说确认替换。这个停顿后面还会反复提到。
二、安装：三平台各走一遍
发行包一般是 Windows 自解压 exe、macOS 的 pkg、Linux 的 deb。版本以你拿到的安装包为准，4.0 起安装包会内嵌本机 MCP 二进制，并注册开机自启，一般不再要求先装 Node。
Windows：双击安装包，按提示完成。安装脚本会把 sidecar 放到本机用户目录下的 chayuan-wps 相关路径，并写入当前用户开机启动项。装完先开一次 WPS 文字，确认加载项出现。若任务窗格没有察元入口，到 WPS 的加载项管理里看是否启用。
macOS：打开 pkg，按向导安装。系统可能提示允许辅助功能或相关权限，按提示处理。安装后 LaunchAgent 会负责拉起 MCP 服务。若首次打开 WPS 提示加载项来自未识别开发者，按你们单位对 WPS 加载项的既有策略处理，不要和「杀毒误报」混成一件事。
Linux：用 deb 安装后，确认用户级 systemd 单元是否在。桌面环境各异，重点仍是：WPS 能打开、加载项在线、本机 62588 有响应。
安装阶段常见坑有两类。一是装了包却从没打开过 WPS，Agent 没注册，外部客户端会报 WPS 离线一类错误。二是旧版本残留路径和当前版本混用，表现为 healthz 通但工具调用失败。处理办法是关掉 WPS，确认 sidecar 只有一份在跑，再重新打开文档。
三、本机服务自检：先看 healthz，再进设置页
浏览器地址栏访问：
http://127.0.0.1:62588/healthz
期望看到在线状态。MCP 入口是：
http://127.0.0.1:62588/mcp
不需要 Token。端口只绑在本机回环地址，默认不是给公网用的。
再进察元设置里的 MCP 服务一页。这里通常能刷新状态、复制连接信息、必要时手动启动本机服务。有 Spike 或自检入口的版本，可以跑一遍，确认 sidecar、Agent、活动文档三层都绿。
连不上时按这个顺序查：WPS 是否打开；察元加载项是否加载；62588 是否被占用或被本机防火墙拦；客户端里的 URL 是否抄成了局域网 IP 却没有做代理。远程要用，需要你们自己加隧道或反向代理，那是运维话题，默认安装刻意收窄暴露面。
四、配置 Claude Code
终端执行一行即可：
claude mcp add --transport http chayuan-wps-mcp http://127.0.0.1:62588/mcp
也可以在项目或用户目录的 .mcp.json 里写服务名 chayuan-wps-mcp，url 填上面的地址。保存后重启 Claude Code 或刷新 MCP 列表，应能看到打开文档、读段落、定位、批注、校对一类工具。
第一次验证别一上来就全文改正。先打开一份不重要的测试稿，对 Claude Code 说：先告诉我当前活动文档的文件名和大概字数，不要改正文。若它能正确回报，说明读写链路通了。再试：检查错别字，先给出问题列表，不要写批注。确认列表合理后，再说确认写批注。
五、配置 Cursor 与 Codex
Cursor 用项目级 .cursor/mcp.json，或设置里的 MCP 添加页，写法与 Claude 的 JSON 类似，服务名同样用 chayuan-wps-mcp。Codex 则编辑本机 config.toml，增加 mcp_servers.chayuan-wps-mcp 段，url 字段指向本机 MCP。配完后用一句「读取当前文档前三段」做冒烟测试即可。
Hermes、OpenClaw 等多用图形界面：新建 MCP，类型选 HTTP 或 Streamable HTTP，URL 填本机地址，不要填 Token，也不要配成 stdio 命令行。保存后做连通测试，能列出工具即可。这类客户端的逐步界面差异大，本稿不绑死某一版菜单名，原则不变：HTTP、本机地址、无 Token。
六、安装后还要配什么：模型与校对相关
MCP 通了，不等于校对一定能跑。拼写与语法检查依赖你在察元里配置的模型供应商。可以是内网的 Ollama、LM Studio、Xinference、OneAPI 一类 OpenAI 兼容端点，也可以是云端模型，按单位合规要求选。没配模型时，外部智能体调用校对接口可能返回模型未配置一类错误，这和 MCP 没连上是两回事。
建议在设置里先用加载项自带的「拼写与语法检查」跑一小段，确认批注能落下来，再让外部 Agent 走同一条能力。这样排错时能分清是模型问题还是 MCP 问题。
七、第一次文件自动审查闭环：从预览到批注
配通之后，Claude Code 或 Codex 并不是「接管 WPS 随便改」，而是按你的话执行审查步骤。推荐口头指令模板如下，可直接粘贴：
你通过 chayuan-wps-mcp 对当前 WPS 文件做自动审查。先做校对预览，列出错别字、标点和明显病句。等我回复确认写批注后，再写批注，且尽量钉在具体文字上。没有我说确认替换，不要改正文。
技术上对应先预览或 dryRun，再带确认写批注。写替换、插入、批量写回时，未确认通常只返回预览。这是故意设计，不是故障。公文、合同、对外稿尤其不要跳过这一步。Codex 与 Claude Code 用同一套说法即可，差别只在客户端壳。
表格多的材料，指令里补一句：批注钉在单元格里的具体错字上，不要挂到整格。表格锚点比纯正文更容易漂，你仍要用眼睛看批注有没有落在对的字上。
若要一次多文件：先让智能体打开指定路径并确认是活动文档，再重复「预览、确认写批注」。不要假设它自动扫完整个文件夹且已全部写回。
八、和「网页上传校对」差在哪
网页上传是文件出去、意见回来，再手工改 WPS。Claude Code、Codex 走本机 MCP，是意见直接变成编辑器里的批注或替换，这才叫对着文件自动审查，而不是对着聊天窗口审一段复制文本。密钥与正文是否出网，取决于你有没有配云端模型；MCP 通道本身默认不出公网。内网只跑本地模型时，整条链路可以做到文档与推理都在可控环境内。
九、排错速查
WPS_AGENT_OFFLINE：打开 WPS，确认加载项已加载，再刷新 MCP。
DOCUMENT_TOO_LARGE：长文不要一次拉全文，让智能体按块读。
CONFIRMATION_REQUIRED：你还没确认写回，补一句确认写批注或确认替换。
MODEL_NOT_CONFIGURED：先去察元设置配校对用的模型。
LOCATE 相关失败：原文可能已变，或命中歧义，让它重新定位再写。
十、装完当天建议做的三份小练习
练习一，只读。打开一份公开说明书或自己写的测试稿，让 Claude Code 回报文件名、段落数、是否建议分块。目的是确认 document 相关工具通，且你不会在紧张的正式稿上试第一次。
练习二，只批注。故意写错两三个字，要求先预览再确认写批注。打开批注窗格，核对锚点。若锚点漂移，把原文句子发回去让它重新定位，不要立刻改用「全文替换」。
练习三，小范围替换。只改一个确定的错词，要求先预览命中列表，确认条数无误后再确认替换。另存一份副本，保留原件。三份练习都通过，再把正式公文放进来。
十一、单位批量部署时多想一步
个人试用按上文即可。若信息技术部门要给科室批量装，建议单独准备一页内部说明：安装包来源、是否允许云端模型、默认只用内网端点、MCP 端口是否纳入本机防火墙白名单、出问题找谁。端口 62588 只绑 127.0.0.1，一般不涉及对外放行，但仍有安全同事会问「会不会被别的程序本机调用」。答案是：本机其他进程理论上可以连，信任边界是这台登录会话。公共机房账号混用时，要按账号隔离策略评估，不要和「已经上了公网」混为一谈。
加载项更新与 sidecar 更新尽量同版本推进。只更新前端加载项、旧 sidecar 仍在，可能出现工具列表与行为不一致。反之亦然。发版说明里若写了 MCP 端口未变，外部客户端配置通常不用改，这是运维友好点。
十二、常见问答（安装配置向）
问：必须联网吗？
答：安装与加载项运行可以在内网。是否联网取决于你配的模型。纯本地模型时，校对也可以在断网环境做。
问：和 WPS 官方 AI 是什么关系？
答：不是同一个产品。察元是独立加载项，侧重本机模型、细粒度写回和 MCP 对外暴露。可以和官方能力并存，具体以你们 WPS 版本的加载项管理为准。
问：会不会自动保存并覆盖我的文件？
答：保存、替换、批注都是明确动作。养成另存副本和先预览的习惯后，风险可控。仍建议重要稿先复制一份再练。
问：Linux 下 WPS 行为不一致怎么办？
答：先确认 WPS 文字版本与加载项机制是否被当前发行版支持，再查 Agent 是否注册成功。Linux 桌面差异大，以 healthz 与设置页状态为准，不要只看安装成功提示。
问：可以把 62588 映射到局域网给同事用吗？
答：默认不建议。若业务强需求，由运维做认证与隧道，并评估文档可见范围。教程默认路径始终是本机。
