注册表、LaunchAgent、systemd：察元AI文档助手三平台 MCP 常驻方案

AI Agent 办公要落地一个绕不开的工程问题是Agent 随时可能被唤起那 Agent 依赖的本机服务凭什么是随时在线的这个问题不解决体验就是每次先开终端手动拉服务、再开 AI 工具多两步就劝退一批用户。「察元AI文档助手」在三个平台上给出了三套常驻方案这篇按平台逐个说清楚顺便讲讲为什么这么设计。为什么要常驻而不是按需拉起先看架构察元的 MCP 服务跑在http://127.0.0.1:62588/mcpStreamable HTTPClaude Code、Cursor、Codex 这些客户端连这个地址调用 46 个文档工具。另一种常见做法是 stdio 模式客户端每次自己拉起服务进程——代价是每个客户端各养一个进程、状态不共享、客户端一关服务就没了。常驻 HTTP 服务则是一个服务多方共用WPS 加载项、多个 AI 工具同时连互不干扰。而常驻的前提就是开机自启和断线自愈。Windows注册表 HKCU\RunWindows 上安装脚本把服务写进当前用户的HKCU\Run注册表项用户登录即拉起 chayuan-mcp 单文件二进制。注意是 HKCU 不是 HKLM——用户级注册不需要管理员权限审批也不污染系统全局卸载跟着用户走。这是办公软件最稳妥的落点。4.1.2 版在这条线上修了两个实际影响体验的问题一是 sidecar 全面隐藏启动以前服务起来会闪一个控制台黑窗办公场景里看着像出了什么事现在完全静默而且关掉窗口不会把服务带停二是「运行 Spike」掉线自愈偶发断连不再需要人工干预。装好之后浏览器开http://127.0.0.1:62588/healthz看到返回 online就说明自启链条通了。macOSLaunchAgentmacOS 的用户级常驻标准答案是 LaunchAgent安装脚本用的就是它配置落在用户目录下随登录生效不需要 root。对开发者居多的 Mac 用户来说这意味着察元的服务和你在 Homebrew 里管理的其他服务是同一个世界的规则想看状态用系统自带工具就能查。安装还是那一行 curlcurl-fsSLhttps://gitee.com/cloudshd/chayuan-wps-releases/raw/master/scripts/install-wps-skill-chayuan.sh|bash-s----fetchLinuxsystemd --userLinux 桌面和服务器场景走 systemd 的用户实例--user同样不碰系统级配置。服务跟随用户会话管理登录即起这套机制 systemd 原生支持不需要额外造轮子。服务器上挂 WPS 的场景不多但 Linux 桌面用户跑 WPS 并不少见国产信创终端大量就是 Linux 桌面环境这条路径的完整支持对国产化替代浪潮里的单位是有实际意义的。三条通用规则平台机制虽然不同但有三条规则是跨平台一致的。第一服务只监听 127.0.0.1信任边界就是本机无需 Token远程访问要走代理或改CHAYUAN_MCP_PORT环境变量自己规划第二服务是单文件二进制不依赖 Node.js三平台上都没有运行时安装负担第三升级就是重跑安装命令覆盖安装且旧配置保留4.1.1 之后临时解压目录退出即清理不会每次残留约 290MB。顺带交代一个自启失效时的典型表现AI 工具报WPS_AGENT_OFFLINE说明 WPS 或加载项没连上服务端。排查顺序照旧从下往上——先浏览器开http://127.0.0.1:62588/healthz看 online 与否服务不在就查自启项是否被安全软件或系统策略禁了服务在而桥不通就重启 WPS 让加载项重连。三个平台这套流程完全一样运维同事学一次就能管三套系统。接入侧一行命令服务常驻就位后客户端接入是分钟级的。Claude Code 一条命令注册claude mcpadd--transporthttp chayuan-wps-mcp http://127.0.0.1:62588/mcpCursor 用户写.cursor/mcp.jsonCodex 用户在~/.codex/config.toml里加三行都是填同一个 URL这里不展开。接好之后建议拿一句提示词立刻试水比如帮我检查文档中的错别字用批注标出原文和建议改法批注能不能钉到原文位置一测便知链路全通。最后照例说边界常驻服务管的是随时能干不包办干得对——批量写回单次上限 200 条操作、写批注必须显式确认这些闸门就是为自动化留的安全垫重大修改前还是该人过一遍 preview。让服务像水电一样存在让每一次落笔前有人工确认这才是 Agent 进办公室该有的样子。