我在信息科,今年牵头的一件事是给全科室配 AI 校对工具。领导提的要求就一句话:好用,但东西不能出去。这篇是部署实录,踩过的坑都记着,给同行参考。
选型先说结论:最后落地的是察元AI文档助手,开源(Apache-2.0),形态是 WPS 加载项加一个跑在本机的 MCP 服务,当前版本 4.1.2。看中它三点。一是长在 WPS 文字里:我们这两年信创替代,办公套件本来就换成了 WPS,AI 能力直接装进大家天天用的界面,不用再教一套新软件,推广成本低到可以忽略。二是离线优先:模型端点接内网的 Ollama 和 Xinference,一个 OpenAI 兼容地址就配上了,校对、批注这些活内网模型就够用。三是它的 MCP 服务只监听 127.0.0.1 的 62588 端口,网络层面就决定了文档数据出不去这台机器——向领导汇报时我只说了这一句,他就拍板了。
部署过程三个坑,逐个说。
坑一:内外网隔离。安装脚本默认在线拉取(Gitee 优先,多源回退),我们的内网机器出不去。解法是走离线分发:先在有外网的机器上备齐安装文件和安装包(仓库提供了安装包分发渠道),再拷进内网统一安装;模型端点提前在内网服务器上起好,加载项里只填内网地址。
坑二:校对模型没配。第一台机器装完跑校对,报 MODEL_NOT_CONFIGURED——加载项装好了,但校对要用的模型端点还没填。内网地址配上之后一切正常。这个错误码设计得直白,排查不绕弯,比"未知错误"友好太多。
坑三:WPS 没起来。有台机器服务在线、健康检查正常,校对却报 WPS_AGENT_OFFLINE——WPS 没开,加载项没连上。后来大家养成习惯:先开 WPS 再用。好在安装脚本自带四级体检(加载项目录、健康检查、MCP 握手、桥接工具),装机当天跑一遍,全绿才算交付,省了我们逐台排查的功夫。
验证环节两条命令记在这里,内网机器同样适用:
curlhttp://127.0.0.1:62588/healthz返回 online 就是服务在线。给写材料的科室接 Claude Code 的话:
claude mcpadd--transporthttp chayuan-wps-mcp http://127.0.0.1:62588/mcp注册完,智能体就能调用那 46 个文档工具,读正文、写批注、批量替换都在本机完成。
推广阶段的真实反馈:用得最勤的是错别字批注和发布前终检,序号检查在拼材料的科室是刚需。培训我们只安排了半小时,加一张打印好的提示词清单贴在工位上;各科室再按自己的高频操作做自定义助手——察元支持把系统提示、输入来源、写回动作、显示位置配好,放到右键菜单或主菜单,等于每个科室一个专属按钮。后来版本升到 4.1.2,sidecar 改成隐藏启动,以前总有同事问"那个黑窗口能不能关",现在窗口没了服务也稳了——这种细节对推广帮助不小,用户感知不到的存在才是好的存在。也有同事问它和 WPS AI 什么关系——两个独立的东西,一个是第三方加载项,一个是金山内置能力,可以共存互不影响,这话我原样转述,不拉踩。
后续我们在评估服务版(Docker 部署的网络版,全科室共用一套服务端),知识库 RAG 对接察元桌面版,材料检索和校对走同一套内网体系。这一步还在测试,没急着上——先把单机版用出习惯,再谈集中部署,顺序不能反。
最后是信息科本位的边界说明,也是我在总结会上讲的:工具部署在内网,解决的是"数据不出域"这个前提;但 AI 输出仍是概率性的,错别字有漏报,敏感信息筛查有误判,材料质量责任还在经办和核稿人;涉密文稿的管理流程一寸不让,该走的定密程序和人工保密审查一步不省。工具归工具,制度归制度——这一年最大的部署心得就这一句。信创这盘棋走到办公环节,缺的正是这种原生长在国产办公套件上的小工具,而不是又一个要单独培训的大平台。