要点速览
察元是运行在 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 中的渠道表可获取产品介绍与捐助等说明，自愿捐助不构成商业服务许可。更新安装包时，建议先卸载或覆盖安装前备份配置，具体以发行说明为准。
