右侧 AI Copilot（页面助手）
在当前业务页面右侧查询真实业务数据、处理文件，并在确认后完成受控写入。
页面助手与全屏 /agent AI 工作台使用同一套 Session、Chat、Run、工作模式、权限和审计能力。设计系统在中国大陆、US、HK、MO 站点保持一致；文档、导航和 AI 策略按地区切换。
打开、关闭与停靠
- 登录后，在任意受保护页面点击“页面助手”，打开随页面板。
- 点击“关闭页面助手”或侧栏外的收起按钮即可隐藏；再次点击浮动图标恢复。
- 拖拽侧栏左边缘调整宽度，也可以聚焦分隔条后用键盘左右箭头微调。
- 点击“展开页面助手”可暂时放大工作区；移动端会切换为全屏覆盖层。
当前标签与 API 上下文
侧栏顶部显示当前标签标题和路由标识。切换报表、总账、税务或法务页面后，下一条消息会携带新的结构化页面上下文快照；已经发送的历史消息不会被回写。
“API 上下文”表示服务端根据路由白名单调用只读业务工具，再执行工作区、角色、权限 Scope、辖区和脱敏校验。AI 只收到有界的业务摘要和来源标识。
不会读取 DOM 文本、CSS、截图、隐藏字段、Cookie、localStorage、访问令牌或完整前端状态，也不会自动上传未选择的附件原文。
从页面助手到 AI 工作台
页面助手默认使用“询问”模式，适合在当前页面旁边读取和解释信息。需要编排完整任务时，可以切换“规划”或“执行”，也可以点击“在 AI 工作台继续”；全屏工作台会恢复同一个 Session／Chat、草稿和模式，而不是复制一段新对话。
模式由服务端强制执行：“询问”只能调用只读工具；“规划”可以生成待确认行动计划；“执行”可以组合获授权工具，但任何写入仍需明确确认。模式、surface、地区和 Run 身份会一起进入审计链。
查询进销存与订单
工作区管理员先在设置 → 工作区视图启用进销存，并由实施人员连接真实 Medusa 数据源。之后可在右侧 AI Copilot 中要求调用 get_inventory_overview，读取仓库、SKU、现存、占用、可用和在途数量。
| 状态 | 页面助手行为 |
|---|---|
| 模块未启用 | 返回“进销存模块尚未启用”，引导管理员前往设置，不显示入口数据。 |
| 数据源未配置 | 返回“进销存数据源尚未配置”，不会用示例或 AI 补全数据替代。 |
| 数据源可用 | 从当前工作区绑定的真实数据源读取库存汇总，可继续结合订单、履约和财务上下文分析。 |
读取并修改 Excel
- 打开右侧 AI Copilot，切换到“执行”模式并上传真实
.xlsx文件。 - 要求 AI 先调用
inspect_workbook，核对文件 SHA、工作表、范围和目标单元格。 - 明确说明要修改的工作表、单元格和新值；AI 调用
update_workbook_cells后只会生成待确认方案。 - 在确认卡中核对原文件、目标版本和变更单元格数量，再点击“确认执行”。
- 完成后点击“下载新版本”。新文件会成为 v2 或后续版本，原文件及其 SHA 保持不变。
不会覆盖原文件：工作簿写入使用版本链、乐观锁和幂等键。文件版本或 SHA 已变化时，系统会拒绝旧方案，必须重新读取后再修改。
地区化行为
| 层次 | 统一部分 | 地区化部分 |
|---|---|---|
| 界面 | 布局、组件、交互和视觉令牌 | 当前站点语言与入口文案 |
| 信息架构 | 导航框架和权限模型 | CN、US、HK、MO 的产品入口与文档中心内容 |
| AI | 同一会话、工具协议、审计链 | 辖区规则、可用工具、数据来源和回答提示 |
安全与审计
每次上下文解析都绑定当前用户、工作区、辖区和授权 Scope，并记录工具调用、脱敏结果、模式、surface 和 Session/Chat/Run 追踪信息。“询问”只能执行被授权的只读查询；“规划”或“执行”中的写入动作仍显示明确的确认卡片。
视觉示例
