AI 助手启用与停用
本页介绍 RuoYi Office 企业管理一体化平台右侧 AI 助手的显示控制。关闭助手入口、撤销访问权限、停止智能体服务是不同操作，请按目标选择。
1. 我只是暂时不想看到招呼
点击招呼气泡上的 ×，只收起招呼，不会停用 AI 助手。需要使用时，仍可点击右侧助手打开对话。
2. 我想缩小入口，不想彻底关闭
- 点击右侧助手，打开对话面板。
- 点击面板顶部的 画板图标（外观与显示设置）。
- 将“关闭对话后的入口”设置为 贴边隐藏。
- 关闭面板，入口将收起到浏览器页面右侧边缘，点击可恢复。
在同一面板也可以调整外形、颜色、动作强度；改回 展示 可恢复常规入口。设置保存在当前浏览器，不影响其他员工。
3. 我想在当前浏览器关闭助手
方法一：从助手面板关闭
打开助手对话 → 顶部画板图标 → 关闭 AI 助手。
方法二：从平台偏好设置关闭或重新开启
平台右上角 齿轮 → 偏好设置 → 业务偏好 → 启用 AI 助手。
- 关闭：隐藏当前浏览器的平台助手入口。
- 开启：恢复入口，但必须同时满足管理员的全局开关允许启用。
关闭后如何找回来
助手入口消失后，仍可通过平台偏好设置重新开启。个人设置仅保存在当前浏览器，不是服务端账号级策略；换电脑、无痕窗口或清理浏览器存储后，显示状态可能不同。
4. 管理员：全站启用或停用助手入口
这项配置位于平台 PC 前端，不是 AgentOS 的模型配置页，也不是数据库字典。
用编辑器打开 apps/web-antd/ 下当前生产构建模式实际使用的环境文件。全站关闭：
dotenv
VITE_AGENTOS_ASSISTANT_ENABLE=false全站开放入口并接入推荐生产路径：
dotenv
VITE_AGENTOS_ASSISTANT_ENABLE=true
VITE_AGENTOS_URL=/ai/修改后 重新构建、部署平台 PC 前端，刷新页面；必要时核对 CDN 与浏览器缓存。本地开发则重启前端开发服务。
- 全局关闭时，个人偏好无法强行开启入口。
- 全局重新开启后，曾在当前浏览器个人关闭的员工，仍需要到偏好设置中开启。
- 该开关不会停止 AgentOS 后端、删除会话或撤销账号权限。
- 未购买、未部署智能体的客户，建议将全局开关设为
false，避免出现无法连接的入口。
5. 我不希望员工再访问智能体
仅隐藏入口并不能禁止访问。 即使关闭平台右侧助手，知道 /ai/work 地址的用户仍可能通过独立页面访问；已有智能体菜单也不会由这个前端开关自动移除。
按实际范围选择：
- 只限制部分人员：由管理员调整角色菜单和对应接口权限；验收已有登录会话在权限缓存刷新或重新登录后的行为。不能只删菜单而保留接口权限。
- 全站临时维护：关闭平台助手入口、处理智能体菜单，并在反向代理或服务运维层暂停智能体访问。停止前告知用户，避免打断正在执行的业务请求。
- 长期停用产品：先备份智能体数据库、加密密钥和私密配置，再按运维流程停止独立服务、关闭相关路由、撤销专用 OAuth 客户端及不再需要的角色授权。不要删除已生成的平台业务单据。
停止服务会影响独立工作台，不影响已在平台生成的报销草稿等业务记录；这些记录仍按平台规则管理。
6. 上线前确认
- 只关闭招呼时，助手仍可点击。
- 贴边隐藏后，入口在右侧且能恢复。
- 个人关闭后，可从偏好设置恢复。
- 全局关闭后，其他浏览器也不再显示助手，但独立入口权限需要另行控制。
- 全局重新开启后，已配置的地址正确、登录可用，个人关闭状态不会被误认为部署失败。
客户源码部署默认不需要体验码或 License 公钥。公开演示站的体验解锁是另一套独立配置，不是此处的 AI 助手开关。
