察元AI文档助手在我这台机器上跑了半年从看客变成部门人肉接口人被问的问题重复率极高。挑十个最高频的整理成问答答案都是我实际踩过验证过的不是手册复读。排错密度最高的那两周我几乎每天都要口头重复其中三条干脆整理成文。AI Agent 办公落地这一年这些问题大概每个单位都会遇到一遍。一、它和 WPS AI 是什么关系察元是独立第三方加载项WPS AI 是金山办公内置能力两者相互独立、可以共存。形态差异在于察元同时提供本机 MCP 服务Claude Code、Cursor、Codex CLI 这些外部 Agent 能通过 http://127.0.0.1:62588/mcp 直连进来操作 WPS 文档这条链路是它最有意思的地方。二、数据会不会传到云端默认架构是离线与内网优先模型端点可接 Ollama、LM Studio、Xinference、OneAPI 等任意 OpenAI 兼容端点MCP 服务只监听 127.0.0.1本机即信任边界无需 Token。你也可以并行配置云端供应商但用不用、用哪家配置权在你手里。涉密文档该走的流程还是得走工具不给定密背书。我们内网接的就是本地端点文档内容不出这台机器这也是它能进单位内网的原因。三、需要装 Node.js 吗不需要。chayuan-mcp 是单文件二进制安装脚本直接部署并注册开机自启Windows 写 HKCU\RunmacOS 用 LaunchAgentLinux 走 systemd --user。整个安装就是一行命令的事。Windows 那条长命令还顺手解决了 PowerShell 5.1 的 GBK 与 BOM 乱码问题双击党完全无感。四、AI 会不会偷偷改我的稿子不会。写操作带确认机制document_replace、document_insert、document_apply_ops 不带确认只返回 preview 不写盘document_add_comment、proofread_apply_comments、declassify_apply 这些必须显式传 confirmed:true 才执行否则返回 CONFIRMATION_REQUIRED。第一次见到这个码别慌补参数重发就是了。preview 模式还有个好处先看看它打算怎么改不合适当场调整提示词零成本试错。五、几百页的长文档怎么办先看 document_meta 的建议超过约 80k 字符的整篇读取会被拒DOCUMENT_TOO_LARGE改用 document_chunks 带 cursor 和 limit 分页读。我的做法是让 Agent 自己决定先 meta 再分块摘要和细节分层拿Token 也省。分块读配合 document_list_paragraphs 的锚点回来写批注位置才钉得准这是长文任务最容易忽略的一环。六、报错一串英文看不懂怎么办六个错误码覆盖九成场景WPS_AGENT_OFFLINE 是 WPS 没开或加载项没连上先开 WPSLOCATE_MISMATCH 或 LOCATE_NOT_FOUND 是文档变了锚点失效重新 document_locateMODEL_NOT_CONFIGURED 是校对模型没配。对表处理基本不用喊人。完整名单是WPS_AGENT_OFFLINE、DOCUMENT_TOO_LARGE、LOCATE_MISMATCH、LOCATE_NOT_FOUND、LICENSE_REQUIRED、MODEL_NOT_CONFIGURED外加一个属于确认策略的 CONFIRMATION_REQUIRED它不算故障。七、免费额度用完了怎么一点提示都没有这正是设计LICENSE_REQUIRED 不弹购买窗安静失败。要么等额度要么接自有模型。我们部门后来统一接了内网端点这个问题就消失了。八、Mac 能用吗能。macOS 和 Linux 一条 curl 搞定curl-fsSLhttps://gitee.com/cloudshd/chayuan-wps-releases/raw/master/scripts/install-wps-skill-chayuan.sh|bash-s----fetch下载源 Gitee、aidooo、GitHub 多源回退带 sha256 强校验装完同样四级体检。体检全绿再关终端别看命令跑完就走人。九、怎么跟我已经在用的 Claude Code 接上一条命令注册claude mcpadd--transporthttp chayuan-wps-mcp http://127.0.0.1:62588/mcpCursor 在项目级 .cursor/mcp.json 里按 mcpServers 写法填 URLCodex CLI 编辑 ~/.codex/config.toml 加 mcp_servers 段。装技能文件时脚本也会自动投放双向自启装加载项等于带技能。Codex CLI 在 ~/.codex/config.toml 里给 mcp_servers 段填上 url 即可Hermes、OpenClaw 这类工具选 HTTP 型 MCP 填同一地址。拿 MCP Inspector 验证npx modelcontextprotocol/inspector选 Streamable HTTP 连一下就知道通没通。十、后台会不会一堆黑窗和垃圾文件老版本确实有这两个毛病都修了4.1.1 起 -Fetch 临时解压目录退出即清理不再每次残留约 290MB4.1.2 起 sidecar 全面隐藏启动黑窗不再出现关窗不断服务运行 Spike掉线自愈。同事被黑窗吓到的工单升级后再没出现过。升级姿势也一句话重跑同一行安装命令就是覆盖升级旧配置不动回滚加 -Version 指定旧版本号。最后补一句被问出经验的话日常最推荐的一条提示词所有岗位通用帮我做发布前终检错别字、标点、数字前后一致性、表格与正文是否一致全部用批注输出最后给我一份问题分级摘要严重/一般/建议先 AI 一轮、人工复核一轮再送审是目前最稳的用法。校对是辅助签字盖章的还是人。这十个问题如果在你单位也高频出现直接把这篇转给问的人。