适用版本技能包v4.1.0 MCP 目录v0.10.046 个文档工具 · 15 个域官网https://aidooo.com/skill 开源https://github.com/zhgyuhuii/chayuan-wps-releases 国内镜像https://gitee.com/cloudshd/chayuan-wps-releasesTL;DR太长不看如果你正在用Claude Code / Cursor / Codex这类 AI 编程智能体又常用WPS 文字写文档那你大概率遇到过这个割裂感AI 在终端里很聪明可它碰不到你正打开的那篇 .docx——要先把文档内容复制粘贴出去改完再粘回来表格、批注、排版全丢。wps-skill-chayuan就是来消除这个割裂感的。一条命令三样东西同时就绪WPS 加载项察元 AI 文档助手装进 WPS本机 MCP 服务开机自启127.0.0.1:62588无需 Token、数据不出域技能文件投放进你本机的 Claude / Cursor / Codex。装完你在智能体里说一句「帮我把当前 WPS 文档里的错别字用批注标出来」它就真的去改你屏幕上那篇文档了。一条命令任选一条粘贴到终端即可# WindowsPowerShell([scriptblock]::Create((iwr-UseBasicParsinghttps://gitee.com/cloudshd/chayuan-wps-releases/raw/master/scripts/install-wps-skill-chayuan.ps1)))-Fetch# macOS / Linuxcurl-fsSLhttps://gitee.com/cloudshd/chayuan-wps-releases/raw/master/scripts/install-wps-skill-chayuan.sh|bash-s----fetch脚本会自动多源回退下载便携包Gitee→官网→GitHubSHA-256 强校验再完成全部安装。海外或 GitHub 直连好的把 URL 换成https://raw.githubusercontent.com/zhgyuhuii/chayuan/main/scripts/install-wps-skill-chayuan.{ps1,sh}即可。下面从「这是什么」一路讲到「怎么用、能干什么」。一、这到底是什么解决什么痛点1.1 三合一交付wps-skill-chayuan是一个便携技能包。一份技能定义SKILL.md 一个 4 步闭环安装脚本把三样本来要分别配置的东西打成一个整体组件作用没有它会怎样WPS 加载项察元 AI 文档助手在 WPS 文字里提供任务窗格、Ribbon、右键菜单能读写正文、加批注、改格式AI 没有手碰不到文档本机 MCP 服务sidecar把「读/定位/改/批注/校对/表格/导出」等46 个工具暴露成标准 MCP 接口外部智能体无法标准化调用 WPS技能文件告诉 Claude/Cursor/Codex「你有这些能力、该这么用」智能体不知道 WPS 这套工具的存在痛点就一句话AI 编程智能体很强但它们和 WPS 文档之间缺一根标准化的管子。MCPModel Context Protocol就是这根管子而本技能包把这根管子预先接好、开机自启、一条命令部署到各智能体。1.2 为什么是「技能」而不是「插件」对WPS 用户它表现为一个加载项在编辑器内直接用。对开发者它表现为一个本机 MCP 服务一个 URL 就能接。对AI 智能体它表现为一份技能/规则文件告诉模型有哪些工具可用。同一个东西三个视角装一次全齐。这就是「双向自启」你从「装技能」进去加载项也装好了你从「装加载项」进去技能也带上了。1.3 和「在浏览器里用大模型」的本质区别维度浏览器/独立 App 里的大模型wps-skill-chayuan文档写回复制粘贴丢格式丢批注插入/替换/批注/链接批注/追加可定位到具体字、具体单元格表格多数只能整段处理12 个表格 action读切片、插行/列、合并单元格、统一列宽、导出数据去向正文上传到云端仅本机回环 127.0.0.1无 Token可全离线模型锁定厂商自选Ollama / LM Studio / Xinference / OneAPI 或任意云端二、安装一条命令四个步骤2.1 一行命令推荐终端用户把开头的两条命令之一粘贴到终端。脚本参数--fetchmac/linux/-FetchWindows只拿到脚本、需要联网补下载载荷时必加。一行命令场景下已默认带上。--with-all/-WithAll强制部署到 Claude Cursor Codex默认只装检测到的。--skill-only/-SkillOnly只投放技能文件不动加载项 / 服务。-Version 4.1.0指定版本。已经克隆了本仓库等价的本地写法powershell-ExecutionPolicy Bypass-File scripts\install-wps-skill-chayuan.ps1-Fetchbashscripts/install-wps-skill-chayuan.sh--fetch2.2 离线整包内网 / 无外网机器从 Gitee Releases 或 官网 下载wps-skill-chayuan-4.1.0-portable.zip解压后进目录跑本地脚本不带--fetch因为整包已在手bashscripts/install-wps-skill-chayuan.sh# mac/linuxpowershell-ExecutionPolicyBypass-Filescripts\install-wps-skill-chayuan.ps1# Windows每个压缩包都带.sha256旁车文件安装器下载后会逐源强校验任一源被篡改都不会通过。2.3 安装器到底干了什么四步闭环同一条脚本按顺序做四件事全程无需 Node.jssidecar 已预编译为单文件二进制装加载项—— 把加载项释放到 WPS 的 jsaddons 目录并写好publish.xml重启 WPS后功能区出现「察元」。MCP 自启—— 释放chayuan-mcp-平台二进制注册OS 级开机自启Windows注册表HKCU\…\Run\ChayuanWpsMcpmacOSLaunchAgentcom.chayuan.mcpRunAtLoadKeepAliveLinuxsystemd--user单元chayuan-mcp.serviceRestarton-failure四级体检——jsaddons→/healthz→initialize握手 → 桥接工具装完即验证可用不是「装完走人」。投放技能—— 自动探测本机已装的 Claude / Cursor / Codex按各自格式投放技能文件。2.4 卸载手动清理暂未提供一键卸载技能文件删~/.claude/skills/wps-skill-chayuan/、~/.cursor/rules/wps-skill-chayuan.mdc、~/.codex/prompts/wps-skill-chayuan.md及config.toml里的[mcp_servers.chayuan-wps-mcp]段。WPS 加载项删 jsaddons 目录里的chayuan_版本与对应publish.xml条目。MCP 自启macOSlaunchctl bootout gui/uid/com.chayuan.mcpWindows 删HKCU\…\Run\ChayuanWpsMcp后结束 62588 端口进程Linux 停chayuan-mcp.service。最后结束占用 62588 的进程即可。三、配置把 MCP 接到你的智能体只需一个 URL技能装好后MCP 服务地址只有一个所有智能体通用http://127.0.0.1:62588/mcp如果你是用「一条命令」装的技能文件里已经写好这个地址多数情况无需再手动配置。下面是「想手工接 / 想理解原理 / 换机器」时各智能体的配置位置。3.1 Claude CodeCLI 一键注册--transport httpstreamable-http是同义别名claude mcpadd--transporthttp chayuan-wps-mcp http://127.0.0.1:62588/mcp或写项目级 / 用户级.mcp.json{mcpServers:{chayuan-wps-mcp:{url:http://127.0.0.1:62588/mcp}}}技能文件落地~/.claude/skills/wps-skill-chayuan/SKILL.md。装完在 Claude Code 里输入/skills可见wps-skill-chayuan。3.2 Cursor项目级.cursor/mcp.json或 设置 → MCP → Add{mcpServers:{chayuan-wps-mcp:{url:http://127.0.0.1:62588/mcp}}}规则文件落地~/.cursor/rules/wps-skill-chayuan.mdcfrontmatter 含 description / globs / alwaysApply。3.3 OpenAI Codexcodex CLI编辑~/.codex/config.toml加一段 Streamable HTTP MCP server[mcp_servers.chayuan-wps-mcp] url http://127.0.0.1:62588/mcp提示词落地~/.codex/prompts/wps-skill-chayuan.md。3.4 Hermes / OpenClaw / 其它 GUI 智能体两者都支持 HTTP 类型 MCP server新建一个 MCP 服务类型选 HTTP / Streamable HTTPURL 填http://127.0.0.1:62588/mcp。无需 Token、无需命令行、无需 stdio。3.5 Claude Desktop / 其它 JSON 配置型客户端{mcpServers:{chayuan-wps-mcp:{url:http://127.0.0.1:62588/mcp}}}远程机器注意服务固定监听127.0.0.1:62588本机回环。要让另一台机器调用需经本机代理转发或在该机设置CHAYUAN_MCP_PORT等环境变量调整。这是出于「涉密不出域」的安全设计不是 bug。四、验证怎么确认装好了由易到难四种验证方式任选其一4.1 健康检查最快浏览器或 curl 访问GET http://127.0.0.1:62588/healthz应返回online。返回这个就说明 sidecar 已在跑。4.2 分层状态最全在智能体里让它调wps_status不给参数或用 Inspector见 4.4调。它会返回分层健康agent.agentOnline—— WPS 加载项是否连上 sidecardocument.*—— 当前活动文档名 / 路径ui.visibleWpsWindows—— 是否有可见的 WPS 窗口防止文档在后台 Preview 态被误判为「已打开」4.3 一句话冒烟测试打开任意一篇 WPS 文档在智能体里说用察元读一下当前文档的前三段告诉我大致在讲什么。如果它真的读到了你屏幕上的内容——成了。4.4 MCP Inspector不依赖 IDE最直观npx modelcontextprotocol/inspector选Streamable HTTP填http://127.0.0.1:62588/mcp点 Connect。能看到 46 个工具的完整列表、参数、并能手动调用——这是验收「到底接没接上」的金标准。4.5 关于「四级体检」安装脚本结尾自动跑的四级体检jsaddons → /healthz → initialize → 桥接工具结果会写进Windows%LOCALAPPDATA%\chayuan-wps\mcp\selftest-run.json仓库侧mcp-sidecar/last-selftest.json判据GO/GO_WITH_CAUTION 全链路可用NO_GO多半是本机没装 WPSKWPS.Document.12注册表缺失。五、使用从一句话到文档被改端到端走查下面四个例子覆盖最典型的工作流。核心心法你的人提需求AI模型负责推理判断工具只负责读/定位/写——写之前默认先预览你确认了再落盘。5.1 错别字校对先预览、再批注打开一篇文档对智能体说帮我检查这篇文档的错别字先用 dryRun 汇总问题不要改正文。模型会走proofread_run({dryRun:true})返回一张问题清单。你扫一眼回一句「确认写成批注」它再调proofread_apply_comments把批注钉到具体错字上包括表格单元格里的字。想要它直接改正文说「找出错别字并直接改正先给我预览清单确认后再执行」。5.2 逐段翻译并插到段后把全文译成英文每一段中文后面插入对应英文译文插入前先预览第一段我确认风格后再全部执行。模型的标准剧本document_list_paragraphs—— 取出每段文本 start/end 锚点模型自己翻译工具不翻译只搬运document_apply_ops({action:insert-after, confirmed:false})—— 先预览你确认 →confirmed:true一次性批量写回≤200 段一次调用从最后一段往前插避免锚点漂移。5.3 表格插行、合并单元格v4.1 新能力表格在 v4.1 从 9 个 action 扩到12 个能按口语「在哪插」操作结构在「销售额」这一列后面插一列「环比」再把表头第一行的前两个单元格合并。模型剧本table(action:list)→table(action:header_read)/column_read找到「销售额」列的索引table(action:column_insert,{col:找到的列, where:after, confirmed:true})table(action:cell_merge,{row1:1,col1:1,row2:1,col2:2, confirmed:true})—— 同行 跨列合并同列 跨行合并。工具只按显式坐标执行不替你猜「在哪」——这是「工具只执行事实模型负责判断」纪律的体现避免幻觉式改表。5.4 保密检查涉密场景辅助非定密帮我检查这份材料的保密风险和敏感信息用批注标出疑似身份证号、手机号、内部路径。模型用保密类能力扫描把命中项用批注钉在原文上。需要真正脱密替换成占位符时走declassify_preview不写盘→ 你确认 →declassify_apply需密码 confirmed→ 日后declassify_restore用密码复原。重要免责保密检查 / AI 痕迹检查仅作辅助参考不替代人工定密不构成司法结论。六、技能功能清单46 个工具 · 15 个域架构上分两层31 个核心工具按职责命名15 个域聚合工具带action判别把同类细操作收拢。合计46。设计纪律工具只返回事实读到了什么、定位到哪、写没写成功判断永远在模型这一侧。没有「评判类」工具也不会过度抓取——模型按需取用、组合调用而不是一个工具干完所有事。6.1 核心工具31 个WPS 连接与文档生命周期工具作用wps_status分层健康sidecar / Agent 在线 / 活动文档 / 可见窗口wps_launchOS 冷启动 WPS 文字并等 Agent 连接document_open打开本地 .docx 为活动文档可见窗口document_ensure_open与活动文档一致则 no-op否则打开document_list_open列出当前打开的文档document_activate在已开文档间切换name/path/query/indexdocument_new新建空白文档或从模板开副本document_save保存 / 另存为读取与定位工具作用document_meta元信息名称 / 字数 / 段数 / 是否建议分块document_list_paragraphs分页段落文本含 start/end 锚点逐段工作流入口document_chunks长文分页分块cursor/limit百万字友好document_get_text文档/选区纯文本超 ~80k 需 force 或改用 chunksdocument_locate定位字词/句返回多命中用于锚点写回改正文工具作用document_replace替换锚点文本段先 preview 再 confirmeddocument_insert相对锚点/文末插入after/before/append/prependdocument_apply_ops批量写回replace/comment/comment-replace/insert-after≤200 ops字符与段落格式工具作用format_run字符外观加粗/斜体/下划线/删除线、字体/字号/颜色/高亮/拼音format_para段落外观对齐 / 行距 / 段前段后 / 首行缩进format_apply_ops批量套格式run/para≤100 opssystem_fonts_list列出本机可用字体名校对 · 知识库 · 助手 · 脱密工具作用proofread_run跑错别字/语法校对dryRun 默认仅返回 issuesproofread_apply_comments把 issues 转成 WPS 批注需 confirmproofread_job_poll轮询异步校对任务进度kb_retrieve检索知识库片段供模型推理只读assistants_list_domains列出察元助手领域目录Agent 离线也可用assistants_search按查询/领域检索数千个察元助手assistants_get导出单个助手完整定义/提示词declassify_status查询是否处于脱密/遮蔽态declassify_preview由关键词构建遮蔽预览不写盘declassify_apply应用脱密需 confirm 密码 关键词declassify_restore用密码复原脱密文档6.2 域聚合工具15 个域带action域action 清单典型用途table12 actioninsertlistheader_readrow_readcolumn_readcell_readheader_repeatcolumn_set_widthexportrow_insertcolumn_insertcell_merge表格切片读 插行/列 合并 列宽/重复表头 导出 md/csv/jsoncommentlistadddelete批注增删查revisionmodelistapply修订模式开关 / 列修订 / 接受·拒绝layoutpagecolumnsbreakblank_page纸张方向页边距 / 分栏 / 分页分节符 / 空白页navlocationoutlinepane_set页码行号 / 标题大纲 / 导航窗格tocinsertupdate插入自动目录 / 更新目录bookmarklistgoto书签列表 / 跳转captionlist图/表/式题注枚举连续性由模型判断fieldlistadd域枚举SEQ/TOC/PAGEREF/DATE 构造 SEQ/TOC 域imagelistinsertdeleteexport图片增删查导出hyperlinklistadddelete超链接增删查headerfootergetset页眉页脚读写watermarksetclear文字水印加 / 清stylelistapplyaudit样式列表 / 应用如标题1/ 统计·清理未用exportfile导出 docx / pdf6.3 写操作的「先预览再确认」纪律凡是会改文档的工具都遵循同一套确认策略未传confirmed:true传了返回preview:true或CONFIRMATION_REQUIRED不写盘落盘 审计适用document_replace/document_insert/document_apply_ops/format_*/ 各域写 action /declassify_apply|restore/proofread_apply_comments。这意味着模型不会偷偷改你的稿——除非你明确说「确认」。七、使用场景大全带可直接复制的提示词下面按场景给出提示词。原则先预览 / dryRun再确认写批注或改正文涉密、定稿类务必人工复核。7.1 校对类场景提示词全文错别字帮我检查文档中的错别字用批注标出原文和建议改法选区错别字只检查当前选区的错别字写成批注表格内错别字重点检查表格单元格里的错别字批注必须钉在具体错字上同音/形近字排查同音别字的/地/得、象/像和形近字己/已/巳标点符号检查标点中英文混用、引号书名号配对、顿号逗号用批注标出病句语法检查病句、搭配不当、成分残缺用批注给出改法序号体例检查标题/条款序号一、一、1.是否层级混乱先预览后写回先 dryRun 汇总问题不要改正文我确认后再写成批注7.2 正确性与逻辑场景提示词正确性总检核对这篇文章错别字、标点、语法、前后矛盾一并查结果用批注数字勾稽核对数表与正文数字是否一致合计、百分比时间线检查日期、工期、里程碑时间线是否合理图表一致核对正文描述与表格内容是否一致版本对比对照上一版/附件打开两份文档标出口径变化处7.3 公文 / 合同 / 规范场景提示词公文格式按党政机关公文习惯检查标题、主送、落款、附件说明是否缺项合同条款检查合同是否缺主体、金额、期限、违约责任列风险清单批注敏感措辞标出绝对化用语务必、从未、100%并建议弱化落款日期检查成文日期、签发人是否齐全7.4 翻译 / 润色 / 摘要场景提示词逐段翻译插段后帮我翻译成英文并把译文插到每一段后面仅译文批注给出译文建议用批注写在原段不要改正文润色在不改变原意的前提下润色全文改动处用批注说明摘要生成 300 字以内摘要插入文档开头先预览去 AI 腔弱化「首先其次总之」等模板腔给修改建议批注7.5 表格 / 名单场景提示词表内校对检查表格内文字的错别字与标点批注钉在单元格文字上插行/列在「XX」列后面插一列「YY」合并表头把表头第一行的前两个单元格合并统一列宽把所有列宽统一为相同宽度导出表格把第一张表导出成 Markdown名单去重检查人员名单是否重名、漏项7.6 定位 / 替换 / 批量写回场景提示词批量替换把「永鹅」全部替换为「咏鹅」先预览再确认条件替换仅在表格第二列把 A 替换为 B批注解释给所有「待确认」字样加批注「请业务确认」7.7 保密 / 脱密辅助非定密场景提示词保密风险帮我检查保密风险与敏感信息用批注标出找敏感号查找疑似身份证号、手机号、银行卡号并批注脱密预览按关键词做脱密预览先不要落盘外发前检查外发前再扫一遍是否残留内部路径、账号、未脱敏字段7.8 排版 / 结构场景提示词自动目录帮我基于标题样式插入一个自动目录设标题样式把「第一章 总则」设为一级标题分页/分栏在这里插一个分页符 / 把正文分成两栏页眉页脚设置页眉为「内部资料」加水印给文档加一个「机密」水印导出 PDF把当前文档导出为 PDF 到桌面7.9 组合工作流可整段粘贴你是 WPS 文档校对助手通过 chayuan-wps-mcp 操作当前文档 1先 proofread dryRun检查错别字、标点、明显病句 2汇总问题列表给我确认 3我回复「确认写批注」后再写成 WPS 批注钉在具体文字上尤其是表格 4不要擅自改正文除非我明确说「确认替换」。帮我做发布前终检错别字、标点、数字前后一致性、表格与正文是否一致 全部用批注输出最后给我一份问题分级摘要严重/一般/建议。八、进阶用法8.1 百万字长文分块剧本千万别对百万字文档默认document_get_text会返回DOCUMENT_TOO_LARGE。正确剧本document_meta→ 看recommendChunks/charCount循环document_chunks({cursor, limit:1..3})→ 模型处理这一段产出带originalTextstart/end的 opsdocument_apply_ops不 confirm预览 → 确认后confirmed:true。8.2 自定义助手约数千个按需检索导出不把几千个察元助手都注册成工具那样模型选择面爆炸。而是assistants_search({query:合同审查, domain:法务})找到助手assistants_get({id})导出它的完整提示词模型按这个提示词 文档工具执行流程。8.3 多文档串行「依次处理这两份文件先错别字批注再统一术语」——模型用document_open/document_activate在文档间切换逐份处理。8.4 知识库对照需已配置 KB「对照知识库里的制度检查本文是否违规表述引用条文批注」——kb_retrieve({query})取片段 → 模型对照 →comment加批注。8.5 资源ResourcesURI作用chayuan://wps/health分层健康状态chayuan://assistants/manifest助手领域清单chayuan://assistants/domain/{domain}某领域助手摘要chayuan://assistants/{id}助手完整定义chayuan://guide/tool-routing工具分层路由指引九、安全与合规维度说明网络边界MCP 仅监听127.0.0.1:62588本机即信任边界不对外鉴权无需 Token、无需命令行、无需 stdio数据出域sidecar 与 WPS 同机模型可配离线 / 内网端点Ollama、LM Studio、Xinference、OneAPI 等 OpenAI 兼容服务正文不出本机完整性每个发布包带.sha256旁车文件安装器逐源强校验防供应链篡改可还原脱密用密码可复原批量/脱密/替换类操作前务必备份原件免责保密检查、AI 痕迹检查仅作辅助参考不替代人工定密与法务审查不构成司法结论涉密 / 内网部署建议优先离线模型 隔离终端密钥按岗最小授权外发审计报告注意渠道。MCP 发现文件%LOCALAPPDATA%\chayuan-wps\mcp\mcp-server.json记录 url / port / wpsExecutable便于运维定位。十、常见问题FAQQ需要装 Node.js 吗不需要。安装器是纯 POSIX bashmac/linux与 PowerShellWindows技能包里已预编译各平台 MCP 二进制开箱即用。二进制缺失时 autostart 脚本才回落node server.mjs。Q技能和加载项是什么关系技能包 WPS 加载项 本机 MCP 各智能体技能文件的「三合一」交付。装一次三样齐备。Q连不上 MCP 怎么办① 确认 WPS 已打开、察元加载项已加载GET /healthz返回online② 服务固定在127.0.0.1:62588被占用时会启动失败结束占用进程后重启③ 看%LOCALAPPDATA%\chayuan-wps\mcp\selftest-run.json的体检结论。Q模型会不会偷偷改我的稿不会。所有写操作默认返回预览必须你明确「确认」confirmed:true才落盘。Q表格工具会自己猜「在哪插」吗不会。row_insert/column_insert/cell_merge都要显式坐标模型先用header_read/column_read找到锚点再调用——工具只执行事实判断在模型侧。Q支持哪些 AI 智能体任何支持Streamable HTTP MCP的客户端Claude Code、Cursor、OpenAI Codex、Hermes、OpenClaw、Claude Desktop、Cline 等。填同一个 URL 即可。Q适合涉密环境吗适合。MCP 仅本机回环、无 Token模型可指向离线/内网端点正文不出域。但自动检查不替代定密程序。Q怎么换模型WPS 加载项里设置 → 模型与供应商填 OpenAI 兼容端点本机 Ollama/LM Studio 或云端。外部智能体则用它自己的模型配置MCP 只管「接 WPS」不绑模型。QGitHub 被墙怎么办一行命令默认走 Gitee国内首选安装器--fetch会按 Gitee→官网→GitHub 顺序回退。十一、获取与版本渠道地址官网技能页 下载https://aidooo.com/skillGitHub源码 Releasehttps://github.com/zhgyuhuii/chayuan-wps-releasesGitee国内镜像 Releasehttps://gitee.com/cloudshd/chayuan-wps-releases一条命令安装见本文 §2.1版本信息技能包 v4.1.0 MCP 目录 v0.10.0 46 工具 / 15 域 Apache-2.0。出品北京智灵鸟科技中心。十二、结语wps-skill-chayuan想做的事很简单把 AI 编程智能体的聪明接到你正写的那篇 WPS 文档上——不用复制粘贴、不用在浏览器和编辑器之间反复横跳、不用把涉密正文传到云端。一条命令装好一个 URL 接通然后你只管用自然语言提需求校对、翻译、改表格、查保密、做摘要、排目录……模型负责想工具负责读写你掌握每一处改动的最终裁量权。把 AI 当作「加速审阅与起草的副驾驶」而不是「替代签字的驾驶员」——这是在严肃办公场景里用好它的最稳妥心态。祝用得安心、审得清楚、写得高效。