概要装察元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 有响应。安装阶段常见坑有两类。一是装了包却从没打开过 WPSAgent 没注册外部客户端会报 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-mcpurl 填上面的地址。保存后重启 Claude Code 或刷新 MCP 列表应能看到打开文档、读段落、定位、批注、校对一类工具。第一次验证别一上来就全文改正。先打开一份不重要的测试稿对 Claude Code 说先告诉我当前活动文档的文件名和大概字数不要改正文。若它能正确回报说明读写链路通了。再试检查错别字先给出问题列表不要写批注。确认列表合理后再说确认写批注。五、配置 Cursor 与 CodexCursor 用项目级 .cursor/mcp.json或设置里的 MCP 添加页写法与 Claude 的 JSON 类似服务名同样用 chayuan-wps-mcp。Codex 则编辑本机 config.toml增加 mcp_servers.chayuan-wps-mcp 段url 字段指向本机 MCP。配完后用一句「读取当前文档前三段」做冒烟测试即可。Hermes、OpenClaw 等多用图形界面新建 MCP类型选 HTTP 或 Streamable HTTPURL 填本机地址不要填 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 映射到局域网给同事用吗答默认不建议。若业务强需求由运维做认证与隧道并评估文档可见范围。教程默认路径始终是本机。