要点速览察元是运行在 WPS 文字中的 AI 文档助手类加载项在 WPS 内提供对话、写作、翻译、审校与批量处理等能力可作为 WPS 环境下的 AI 助手能力补充。软件可免费使用源代码在 GitHub 公开许可以仓库 LICENSE 为准。部署上支持离线安装包分发模型可指向本机或内网 OpenAI 兼容服务便于在无公网或内网策略下使用。本文面向银河麒麟等国产 Linux 桌面说明与系统架构匹配的 deb 获取与安装步骤。关键词WPS AI助手、免费、开源、离线部署、麒麟系统、银河麒麟、察元、Chayuan、WPS 文档助手、WPS 文字、加载项、linux-x64、linux-arm64、内网模型、deb、国产操作系统、Linux 安装包一、文档目的与适用环境本文说明在国产麒麟类 Linux 桌面环境中安装察元 AI 文档助手加载项的推荐路径与注意点若您关注 WPS 内的 AI 助手能力、零授权费用、源码可查、离线或内网部署可先阅读上文要点速览与第七节、第九节。一般用户无需自行下载源码编译可直接从官网或 GitHub 发布页获取与 CPU 架构匹配的 Linux 安装包。麒麟发行版分支较多包管理可能是 deb 系或 rpm 系本文以与 Debian 或 Ubuntu 类似、可使用 dpkg 安装 deb 包的环境为主撰写。若您使用的是仅支持 rpm 或专用软件商店的版本需按单位信息化要求选用兼容的安装介质或联系维护者获取适配方式本文不替代该发行版官方文档。 察元是面向 WPS 文字的开源项目许可以公开仓库 LICENSE 为准。产品支持离线资源与内网模型接入是否满足贵单位安全要求须单独测评。二、功能介绍察元 AI 文档助手是运行在 WPS 文字内的智能加载项在 Ribbon 与右键菜单中提供 AI 对话、文本分析、翻译、多模态生成、保密与脱密相关流程、文档与表格及图像批量处理、表单辅助、模板与规则管理等功能。生成结果可按配置插入当前文档、替换选区或写入批注减少在浏览器与编辑器之间反复复制粘贴。 在麒麟与内网场景下其价值主要体现在三方面。第一可将大模型推理指向本机或机房内的 OpenAI 兼容接口便于数据路径可控。第二安装包可为离线资源形态便于在无公网 CDN 的环境分发。第三内置与自定义助手、任务编排相结合便于把单位常用的审校、保密检查、表单与审计步骤固化成可重复流程。 功能细节与助手定义以仓库 README 与安装后的软件界面为准本文不替代产品手册。三、功能清单下列条目与仓库 README 功能总览对齐便于在麒麟环境安装后对照验收。关于产品介绍与能力说明。AI 助手主对话、拼写与语法检查、生成摘要。文本分析改写、扩写、缩写、段落序号检查、AI 痕迹检查、批注与超链接解释、纠正拼写语法、提炼关键词等。翻译多语言翻译菜单随配置变化。多模态文本转图像、文本转语音、文本转视频依赖所配模型与网关能力。智能助手多个固定入口主助手与更多动态菜单。安全保密保密检查、文档脱密、脱密复原流程与法律效力以单位制度为准。文档批量清理未使用样式、统计已使用样式、删除空白行。表格批量导出或删除全部表格、行宽与样式、按文字删行列、追加替换、序号与样式、表格题注等。图像批量导出或删除全部图像、统一或清除格式、图像题注等。察元 AI 编审表单辅助填报、表单内容预览、文档审计。模板与规则导出、导入、下载模板规则制作、导入、导出。设置任务清单模型、数据路径、助手等综合设置。右键菜单添加到察元、文本分析、翻译、智能助手快捷入口。扩展能力包括自定义智能助手、任务编排与任务清单、报告或审计类生成及场景化引导问答。内置助手覆盖对话、多模态与大量文本分析类能力用户可在设置中新建自定义助手并与任务编排联动具体以安装后的软件界面为准。四、麒麟环境为何单独说明银河麒麟、中标麒麟等桌面系统在党政机关与关键行业装机量大常与内网策略、国产软硬件适配要求同时出现。国产整机常见 x86 与 ARM 两种 CPU 架构安装包须与之一致。察元 Linux 侧发布物通常以 deb 等形式提供文件名或说明中会区分架构便于在内网镜像或离线介质中分发。实际能否安装仍取决于该环境是否已安装支持 JS 加载项的 WPS 文字 Linux 版以及 WPS 官方对该发行版的支持说明须在目标机器上验证。五、安装前准备第一确认本机已安装可正常使用的 WPS 文字 Linux 客户端且版本满足官方对加载项或 JS 插件的要求具体以金山办公公开说明为准。 第二确认 CPU 架构以便下载正确的安装包。常见对应关系为64 位 Intel 或 AMD 桌面与笔记本对应 amd64 或 x86_64 生态发布页附件名常含 linux-x64 等字样飞腾、鲲鹏等 ARM 平台对应 arm64 或 aarch64附件名常含 linux-arm64 或 linux-arm 等字样。具体文件名以官网或 GitHub Release 页面为准错用架构会导致无法安装或无法加载。 第三deb 包安装过程可能依赖系统已安装 python3若最小化系统提示缺依赖请按系统软件源说明先安装再执行安装包。 第四若仅使用官方发布的安装包不要求本机安装 Node.js 或配置源码编译环境。六、获取与安装安装包推荐流程为从官网或 GitHub 获取与当前系统架构一致的 Linux 安装包本地安装后重启 WPS 文字。 第一打开官网 http://aidooo.com 或项目仓库 https://github.com/zhgyuhuii/chayuan 中的 Releases 发布页在附件列表中选择适用于 Linux 的 deb 或单位提供的等价安装介质。文件名中一般会带有版本号以及 linux-x64、linux-arm64 等区分架构的字样请与第五节所述 CPU 类型核对后再下载。 第二将文件拷贝至麒麟本机或内网镜像站后可使用图形界面软件安装程序双击安装。若使用终端在 deb 所在目录执行 sudo dpkg -i 文件名.deb也可直接 sudo dpkg -i 加 deb 的完整路径。文件名需与实际下载一致常见形态含 chayuan、版本号、linux-x64 或 linux-arm64 等字段。若报依赖错误可尝试 sudo apt install -f 后按提示修复或用系统自带的软件包工具安装。完成后重启 WPS 文字。 第三安装完成后在 WPS 文字中查看是否出现察元相关菜单或插件入口。若单位仅允许离线介质分发可将上述 deb 经审批后刻录或导入内网软件仓库不在此赘述。 维护人员或二次开发者若需自行从源码生成安装包可查阅仓库 README 与构建脚本此路径面向贡献者与定制场景一般用户可忽略。七、离线部署与内网模型离线部署包含两层含义。一是安装包内的加载项资源可在无外网 CDN 的条件下完成安装适合拷贝至隔离网络。二是大模型推理可指向内网 OpenAI 兼容服务例如本机或机房内的 Ollama、Xinference、OneAPI 等网关在软件设置中填写基础地址与密钥使文档内容不必经公网 SaaS。两层都配置正确后才接近真正意义上的内网闭环办公仍须由单位安全部门对日志与密钥管理做最终认定。八、安装后检查与注释安装成功后启动 WPS 文字在功能区或插件列表中是否出现察元相关入口以实际界面为准。若未出现请检查加载项是否被禁用、安装是否完整、当前用户是否有读权限。若仍异常可在信息化政策允许的前提下查阅 WPS 官方关于 JS 加载项的说明或到 GitHub 提交 Issue 并附系统版本与架构信息。 以下为常见注意点非完整排错手册。其一架构必须与系统一致错用包会导致安装失败或无法加载。其二升级 WPS 主版本后若加载项异常需按新版本说明重新登记或重装插件。其三麒麟系统安全策略可能限制未签名包或未知来源需在信息化政策允许的前提下放行或改用单位认可的签名分发流程。九、开源、官网与更新项目公开仓库为 https://github.com/zhgyuhuii/chayuan 版本与发行说明以 Releases 为准。官网 http://aidooo.com 与仓库 README 中的渠道表可获取产品介绍与捐助等说明自愿捐助不构成商业服务许可。更新安装包时建议先卸载或覆盖安装前备份配置具体以发行说明为准。