OfficeAI 服务端部署手册

企业版需要先在服务器上部署服务端，再生成客户端下载链接分发给用户安装使用。本文档面向系统管理员，覆盖环境准备、安装配置、用户管理、安全运维全流程。

系统构成

部署前先建立整体认知：OfficeAI 由三段协同——管理服务端与 AI 运行时部署在同一台内网服务器上，客户端插件分发到用户办公机。三段全程在客户内网闭环运行，数据不出网。管理后台（:52001）用于配置与管控，客户端 API（:52000）供插件调用。

环境准备

部署前请确认以下条件就绪：

• 服务器：一台 Linux 服务器，最低 8 核 CPU、16G 内存、256G 硬盘
• 大模型：已部署本地大模型，或已注册外网/专网模型 API Key
• 系统适配：确认服务器操作系统版本、客户端 OS 及办公软件版本满足兼容性要求

环境适配列表

客户端

平台	支持版本
Windows	Windows 7（SP1, 64 位）及以上
信创系统	麒麟 Kylin V10、中科方德
macOS	X86、M 系列芯片架构
办公软件	Microsoft Office 2013、WPS 2019 及以上版本（以插件形式运行）

服务端

平台	支持版本
Linux	Ubuntu 20.04、CentOS 7、RedHat 7 及以上
信创服务端	麒麟 Kylin Server V10、中科方德

大模型

部署方式	说明	支持平台
内网模型	本地部署开源大语言模型	Qwen、DeepSeek 等，基于 VLLM、Ollama、LMStudio 等框架搭建的兼容 OpenAI 协议的模型
外网模型	云端 API 调用	阿里云、腾讯云、华为云、天翼云、火山引擎、硅基流动、月之暗面、深度求索、文心一言、智谱清言等
专网模型	行业专网部署	政务云、公安网、海关网、涉密网等

服务端安装与配置

安装

注意： 1）尽量避免和其他业务共用服务器，避免冲突；2）不要更改安装脚本与文件，否则会导致部署失败。

步骤一：下载解压

# 示例：officeai-v26.0410.1911125-linux-amd64.zip
unzip officeai-v26.0410.1911125-linux-amd64.zip

步骤二：执行安装脚本

cd officeai-v26.0410.1911125-linux-amd64/
./setup.sh

安装过程中一路回车即可。脚本会提示设置安装目录、管理后台端口（默认 52001）、客户端端口（默认 52000）。安装成功后控制台会打印 Setup Token，请妥善保存——首次登录管理后台需要用到。

登录管理后台

访问管理后台地址 http://localhost:52001。首次访问需要设置超级管理员密码：复制控制台打印的 Setup Token 并输入，默认用户名为 admin。

导入 License 文件

价值： 只有导入有效 License 文件，服务端才能正常使用。License 与服务器设备指纹绑定，确保授权唯一性。

进入 管理后台 → 授权管理，将服务器设备指纹（ID）复制给我们，我们会生成对应的 License 文件。在该页面「上传 License 文件」中上传 License 文件完成授权。

配置大模型

价值： 大模型是 AI 能力的引擎。通过管理后台可接入多种模型平台，支持一个场景配置一个专用模型（如识图专用 VL 模型），灵活适配不同业务需求。

进入 管理后台 → 模型配置，模型服务默认内置了各类平台供应商，可通过启用开关控制模型是否启用。

• 内网模型：在 Ollama 或 vLLM 中配置（仅这两个平台支持内网模型部署）
• 外网模型：其余平台需要外部模型 API Key

① 添加模型

找到要接入的模型平台（如 Ollama），在 管理后台 → 模型配置 中添加 API Key（可添加多个），然后点击「新增模型」进行配置。

② 配置模型参数

参数	说明	建议值
上下文长度	限制发送给大模型的最大字符数，超过此限制模型将无法响应当次会话	参考模型官方文档，尽可能设大
最大输出 Tokens	模型单次输出的 token 上限，单位为 k	0（不限制）
模型类型：工具	Function Call 函数调用能力	参考官方文档确认后勾选
模型类型：推理	针对可开关推理的模型（如 Qwen3 系列），开启后在客户端展示「思考」按钮，用户可关闭推理/思考过程	按需开启
模型类型：图像能力	识图等视觉输入能力（如 Qwen2.5-VL 混合模型支持）	仅支持视觉的模型勾选

⚠️ 模型类型请谨慎勾选。 如果勾选了模型不支持的能力，对话会出错。请在模型官方文档确认后再配置。

③ 检测模型连接

配置完成后，点击「测试」按钮验证模型连接。连接成功会显示「正常」。

④ 场景模型配置

在模型配置页面左上角点击「场景配置」按钮，可为特定场景（如识图）指定专用模型。

选择模型供应商后，系统会展示支持该场景的模型列表，选择并保存即可。

客户端发布

价值： 服务端部署完成后，需要将客户端分发给用户安装使用；后续版本迭代也通过管理后台升级。

进入 管理后台 → 版本升级：

1. 确认客户端接口请求地址：系统自动检测服务器 IP 地址并展示。如果服务器配置了多个网卡或使用了 Nginx 等反向代理，可能导致客户端无法通过此地址正常访问，此时可点击「修改」手动设置正确的地址
2. 服务端升级：上传服务端安装包即可完成升级
3. 客户端升级与下载：上传插件安装包后，客户端用户点击刷新按钮或重启 WPS 后即可收到升级提醒，按提示操作完成升级

企业自定义设置

价值： 自定义产品标识、品牌色调与企业信息，修改后所有客户端界面同步更新，打造统一的品牌体验。

进入 管理后台 → 企业自定义设置，可配置产品 Logo、品牌色、企业名称等信息，修改后客户端即时生效。

用户管理

价值： 管理客户端用户的账号生命周期——注册审批、创建、分组、权限分配、禁用与删除，确保只有授权人员能够使用产品。

进入 管理后台 → 用户管理：

用户自行注册与管理端审批

客户端用户可在 WPS 插件界面自行注册账号。注册后管理员在「待审批」列表中审批通过，用户即可登录使用。

💡 点击「待审批」界面右上角「自动审批规则」，可取消审批流程，用户注册后直接登录，无需人工干预。

管理员新增用户

在用户管理首页点击右上角「新增成员」，即可由管理员直接为用户创建账号。

部门管理

支持管理员创建符合企业组织架构的部门树，调整员工所属部门。部分权限可设置为仅对特定部门生效。

成员信息管理

成员列表中 4 个操作图标依次为：

• ✏️ 编辑：修改成员信息
• 🚫 禁用：暂停账号使用
• 🔑 重置密码
• 🗑️ 删除用户

快捷功能与导航项

价值： 管理员可自定义客户端首页展示的功能按钮及其子级操作，控制不同部门看到不同功能，实现千人千面的功能入口。

快捷功能与导航项的关系

管理端配置的快捷功能（任务类型按钮）会作为客户端侧边栏首页的按钮展示给用户，两者一一对应：

管理端任务类型按钮：

客户端侧边栏首页按钮（完全对应）：

快捷功能

默认内置的快捷功能包括：校对、排版、润色、续写、翻译。管理员可在此基础上自定义。

列表操作：

• 新建：创建新的快捷功能
• 编辑：修改已有功能类型
• 排序：按住拖拽调整客户端展示顺序

编辑快捷功能时可配置：

配置项	说明
图标	选择在客户端显示的图标
名称	支持自定义命名
描述	可选，帮助客户端用户了解功能用途
关联分组	关联工作流分组（工作流功能正式推出后更新）

导航项

导航项是快捷功能下的子级操作，每条导航项可绑定一条"带提示词的快捷指令"。管理员可为不同部门配置不同的导航项可见范围。

导航项入口位于 管理后台 → 导航栏：

点击某个快捷功能，可查看和管理其下的导航项。点击右侧「...」可编辑或新增。

编辑导航项时可配置：

配置项	说明
名称	自定义导航项名称，会显示在客户端
描述	可选，描述快捷指令用途
关联工作流	关联用户自定义工作流（持续更新中）
工作流参数	与工作流流程相关（持续更新中）
使用范围	指定显示给哪些部门/人群
状态	启用或关闭，关闭后所有客户端均不可见

工作流

定义： Workflow（工作流）是将大语言模型（LLM）、外部工具、数据源及业务规则，通过预定义的固定逻辑路径串联而成的结构化自动化流水线。核心特征是"人定流程，AI 执行"，旨在克服单次模型调用的不确定性，实现复杂任务的可预测、可管控输出。

非标准的、复杂的校对、排版或其他功能需求，可利用工作流实现。该功能持续更新中，请注意关注后续文档更新。

安全类配置

操作日志

价值： 满足企业审计和合规要求。记录所有用户的操作行为，支持多维筛选和操作详情查看。

入口：管理后台 → 操作日志

筛选条件：支持按「姓名与账号」「分类」「结果」「时间」等维度组合筛选。点击右侧箭头可查看每条操作的详细内容。

DLP 配置（敏感信息保护）

价值： 防止敏感信息（如身份证号、银行卡号、合同机密条款）通过 AI 功能被不当传播。支持设置敏感词库和三种不同力度的处理方式。

入口：管理后台 → DLP 配置

操作说明：

• 新增规则：创建新的敏感信息保护规则
• 编辑与删除：点击右侧「...」对已有规则进行编辑或删除

新增/编辑 DLP 规则时的配置项：

配置项	说明
名称	自定义规则名称，便于识别
描述	可选，多条规则时有助于查找和管理
分类	选择敏感分类（如金融、身份信息等）
匹配模式	正则表达式或关键词（关键词模式设置更简单）
匹配内容	多个敏感词汇用| 分隔
处理方式	提示（仅提醒）→ 警告（用户确认后放行）→ 直接拦截（阻断操作）

仪表盘

价值： 让管理者快速掌握系统运行状况——活跃用户数、使用量趋势、功能调用热度排行，为运营决策提供数据支撑。

入口：管理后台 → 仪表盘

主要数据看板：

• 活跃与用量：周活跃 / 月活跃用户数（发起过对话的去重用户），以及总用量数据
• 趋势图表：不同时间段的用量变化趋势，快速浏览使用情况
• 用量排行：按人员、部门、任务类型、快捷指令、技能维度的调用次数排名