ZCode 里用 WPS 文档智能体:内置 CLI 和自研 Agent 两条路

ZCode 是智谱出的智能体开发环境,一个桌面端,里面既能跑它自研的 Agent,也能挂 Claude Code、Codex 这些命令行智能体统一管理。我平时在 ZCode 里跑 GLM 模型干杂活,最近把察元的 WPS 文档能力接了进去,发现它有两条路可以走,都记一下。先装底座不管走哪条路,WPS 加载项和本机 MCP 服务都得先有。Windows 下 PowerShell 一行: {[Net.ServicePointManager]::SecurityProtocol[Net.SecurityProtocolType]::Tls12;$wNew-Object Net.WebClient;$w.Encoding[Text.Encoding]::UTF8;$s$w.DownloadString(https://gitee.com/cloudshd/chayuan-wps-releases/raw/master/scripts/install-wps-skill-chayuan.ps1);if($s.Length -and $s[0]-eq[char]0xFEFF){$s$s.Substring(1)}; ([scriptblock]::Create($s)) -Fetch}Linux 和 macOS 用 curl 对应那行。跑完之后 jsaddons 里有了加载项,62588 端口的 MCP 服务开机自启,浏览器访问 http://127.0.0.1:62588/healthz 能看到 ok 为 true 就绪。第一条路:ZCode 里的 Claude Code 会话这是最省事的一条。安装脚本的第四步会探测本机的 Claude Code 并完成两件事:执行 claude mcp add 把 MCP 注册进去,再把技能文件投放到 ~/.claude/skills/。ZCode 管理的 Claude Code 智能体用的就是这套用户目录的配置,所以在 ZCode 里开一个 Claude Code 会话,察元的技能已经在了,不用再配。验证方式:ZCode 里开 Claude Code 会话,WPS 打开一份文档,说:读取当前文档标题和前两段,只读冒烟。能念回来就是通了。之后的用法跟原生 Claude Code 完全一样,校对、批注、翻译插段、表格插列,技能文件里的纪律它自己遵守。第二条路:ZCode 自研 Agent 走 MCP用 ZCode 自带的 Agent 或者里面挂的其它智能体,就得手动配 MCP。ZCode 的界面跟着版本迭代比较快,我不写死菜单路径,说思路:在设置里找到 MCP 服务或工具集成的入口,新建一个服务,协议类型选 HTTP(Streamable HTTP),名称填 chayuan-wps-mcp,地址填:http://127.0.0.1:62588/mcp鉴权字段留空,这个服务只在回环地址上监听,不设 token。保存后看工具列表能不能刷出四十多个文档工具,能刷出来就是连上了。要是你用的版本支持按 JSON 配置,那就是一个 mcpServers 节点下一条 url 记录的事,跟其它客户端的写法一致。自研 Agent 没有 Claude Code 那种技能文件机制,建议把察元技能包里那份通用提示词(generic.prompt.md)贴到 Agent 的指令或人设里。里面是几条硬规矩:动手前先只读确认文档没拿错;写回前先出预览;默认批注不改正文;表格这类结构性写入必须等确认。贴了之后 Agent 干文档活会稳很多,GLM 的中文语感做校对清单质量也够用。场景与提示词我在 ZCode 里跑得最多的三个:标书终检。一份应标文件,几十页,格式要求一大堆:对当前文档做终检:标题层级是否连续、段落编号是否跳号、正文里有没有错别字,按问题类型分组出清单,先预览。确认后按批注写回,评审前过一遍批注就交。中英对照材料:把当前文档逐段翻译成英文,译文插到各段后面,从最后一段往前处理,先预览前两段。数据表整理。报价汇总表要按产品加一列单位:读取当前文档第一个表格的表头,告诉我产品名称是第几列,然后在它后面插入一列,列名单位。它会先回报定位,等我说确认才插。注意事项ZCode 版本更新快,界面叫法可能有出入,认准两点就行:新增 MCP 服务、类型 HTTP。实在找不到入口,走第一条路用里面的 Claude Code 会话,体验没有差别。MCP 服务只在本机监听,ZCode 和 WPS 得在同一台机器上,跑在容器或者远程主机里的智能体连不进来。对话模型在察元自己的设置里配,跟 ZCode 用的模型是两回事:工具调用走 ZCode 侧的模型,而校对、翻译这类内容活走察元配置的模型,内网用 Ollama 也行。两头都配好,文档活的质量和稳定性都有保障。