权限 — 角色组合 · 数据范围 · 文档等级
Copilot 为每个人设定三件事。这是从 2026.10 再发布 6(2026-10-08)起加入的功能。
| 什么 | 决定的内容 | 在哪里 |
|---|---|---|
| 角色组合 | 能做什么 — 菜单 · 建议的来源 · 审批 · 审核 · 聊天工具 · 自动化 · 管理控制台 | 管理控制台 › 角色组合(/admin/bundles)，为人员附加则在用户(/admin/users)中进行 |
| 数据范围 | 能看到哪些设备 · 项目 · PO | 因人而异 — 用户编辑中的范围·等级组合。见下方数据范围 |
| 阅览等级 | 能看到哪个等级的文档 — 一般 · 内部 · 对外保密 · 管控 | 因人而异 — 用户编辑中的范围·等级组合。文档一侧在管理控制台 › 文档等级(/admin/grades) |
判定统一在 Copilot 一处进行，后端(数字线程 · RAG · 时序 Insight)只按 Copilot 每次请求附带的用户信息进行过滤。 因此无论是提问 · 建议 · 自动化 · 文档回答 · API，任何入口看到的都是同一范围。改动的值从该人的下一次请求起（最迟 30 秒内）生效，无需重新登录。
首次启动时会为每个既有用户附加业务角色对应的组合（管理员还会附加«管理员»组合）、范围全部、阅览等级对外保密。
菜单 · 审批 · 审核与升级前相同，审计记录中以 system:migration 留存。唯一不同的一点 — 管控等级
文档必须将该人的阅览等级设为管控才能打开。
基本组合是作业员 · 班长 · 维护 · 厂长 · 管理员五个，其余八个单独显示为其他组合 — 功能 · 权限 · 已附加的人员都保持不变。同时精简了现场组合的默认权限(见下表)。启动只会在作业员 · 班长 · 维护 组合仍是"之前的默认值"时改动一次，管理员已修改过的组合不会被触碰。作业员看不到建议中的"待确认异常"是有意为之。
Copilot 以提问 · 建议 · 自动化三种方式使用(侧边栏从上到下是新对话 · 建议 · 自动化，提问通过«新对话»和首屏进入)。 权限列表和组合的默认值没有变化，只是同一权限打开的位置迁移到了新画面 — 旧的«执行建议 · 异常诊断 · 解决»权限现在打开建议的来源(计划 · 待确认异常 · 事件)。升级时无需任何操作 → Copilot 画面地图
角色组合
权限不直接附加到人身上，而是附加到组合上。一个人可以拥有多个组合，权限是它们的合集。
管理控制台 › 角色组合(/admin/bundles)中会分开显示基本组合五个和其他组合。列为组合 · 权限数 · 默认阅览等级 ·
人数 · 最后变更，自建组合会带有«自建»标记。点击该行会在右侧展开组合。
| 编号 | 位置 | 作用 |
|---|---|---|
| ① | 组合列表 | 基本组合五个。点击该行会在右侧展开，最上方显示该组合所附加的人数(«N 人使用») |
| ② | 权限 | 该组合包含的权限 — 见下表 |
| — | 范围种类 · 默认阅览等级 | 在权限下方。可为该组合的人员指定的范围种类(设备 · 项目 · 客户 PO · 合作商等)及默认等级 |
| ③ | 保存 | 只有存在改动时才能点击。从附加该组合的人的下一次请求起生效，并记入审计 |
真正过滤某人回答的值是因人而异设定的数据范围 · 阅览等级(下方两节)。组合的范围种类 · 默认阅览等级只是以该组合的"模板"形式保存的值， 在组合中修改也不会改变已附加人员的范围 · 等级。唯一例外是«外部 API»组合 — 通过 API 密钥进入的调用遵循该组合的默认阅览等级。
权限名称与管理画面上显示的完全一致，括号内为权限代码。
| 权限 | 打开的内容 · 没有时的情况 |
|---|---|
菜单 — 提问 (menu:ask) | 提问(/chat)。没有该权限则侧边栏的新对话按钮消失，该地址返回 403 |
建议 — 计划 (menu:work) | 建议的计划来源 — 执行建议和自动化上报的卡片 |
建议 — 待确认异常 (menu:floor) | 建议的突发中的"待确认异常" |
建议 — 事件接收·处理中·完成 (menu:resolve) | 建议的突发中的"事件"，以及处理中 · 完成标签页。事件的批准处置方案 · 修改后批准 · 拒绝也凭此权限进行 — 无需另外的审批权限 |
菜单 — 旧版今日画面 (menu:today) | 🔴 新画面中没有使用该权限的位置。 这是打开旧版«今日»画面的权限，仍保留在组合中 |
| 审批 — 供应链催办草稿 · 审批 — MES 维护请求 | 提问回答下方"可执行操作"卡片上没有审批按钮 |
审批 — 建议卡片草稿 (approve:proposal) | 建议详情中的审批并生成草稿按钮消失(栏位仍可见)。自动化建议的工单草稿也通过该权限审批 |
审批 — 执行事件处置 (approve:incident_action) | 无法在建议详情中执行处置(确认报警 · 通知负责人 · 现场巡检 · 记录调查)，执行请求返回 403。批准 · 拒绝处置方案所需的不是此权限，而是"建议 — 事件接收·处理中·完成"。也无法将自动化的结果发送给除自己以外的人 · 角色 · 消息渠道(接收方只能保留为"我") |
影子判定审核 (review:shadow) | 🔴 新画面中没有使用该权限的位置。 这是在旧画面"待验证"中将影子判定标记为正确·错误的权限，仍保留在组合中 |
致命设备长期搁置 (shelve:alert) | 🔴 新画面中没有使用该权限的位置。 这是在旧画面通知架中把致命设备通知搁置超过 1 小时的权限，仍保留在组合中 |
阈值调整晋升·回退 (tune:accuracy) | 无法在管理控制台 › 准确度调优中执行晋升 · 回退 · 重启 |
查看审计记录 (read:audit) | 审计画面会提示"需要具备«查看审计记录»权限的组合。"而被阻挡 |
| 聊天工具 — 内置(文档检索·设备状态) · 平台集成 MCP · 已注册 MCP 服务器 | 提问中该来源的工具消失，执行也会被拒绝 |
指定文档等级 (grade:set) | 文档等级画面会提示"需要具备«指定文档等级»权限的组合。"而被阻挡 |
创建·管理自动化 (manage:agent) | 侧边栏中自动化消失 |
更改品牌 (manage:brand) | 无法在管理控制台 › 品牌中更改名称 · Logo · 颜色 |
发布影像作业规程 (publish:procedure) | 无法发布影像生成的作业规程草稿 — 提示"没有执行此操作的权限 — 只有创建者或有发布权限的人可以执行"(可以创建和修改草稿) |
管理控制台 (admin) | 整个管理控制台。无法从«管理员»组合中移除 |
- 如果没有一个可见的建议来源(计划 · 待确认异常 · 事件权限全都没有)，侧边栏中的建议会消失。没有"菜单 — 提问"时新对话按钮会消失。
- 画面中看不到的旧值 —
menu:report。 这是只负责开关旧版报表画面的权限，在新画面中不阻挡任何内容，也不会显示在组合编辑中。 完成标签页和摘要通过"建议 — 事件接收·处理中·完成"权限打开。组合中原有的值即便修改其他栏位后保存，也会原样保留。 - 处理通知渠道 · 邮件允许域名没有单独的权限 — 只要能打开管理控制台即可 → Copilot 管理控制台 — 通知渠道
- 这次画面更换没有新增权限。
内置组合 — 五个基本组合 + 八个高级组合
首次启动时仅在不存在时才添加。此后管理员修改过的值不会被升级覆盖。前五个是画面上的基本组合，其余为其他组合。
| 组合 | 可见内容 | 其他权限 |
|---|---|---|
| 作业员 | 提问 · 建议(计划 · 事件) — 处置方案的批准 · 拒绝与结果记录在事件中完成(无法执行处置) | — |
| 维护 | 提问 · 建议(计划 · 待确认异常 · 事件) | 审批维护请求 · 影子判定审核 · 执行事件处置 · 发布影像作业规程 |
| 班长 | 与维护相同 | 审批维护请求 · 影子判定审核 · 执行事件处置 · 发布影像作业规程 |
| 厂长 | 全部 | 审批催办草稿 · 审批维护请求 · 执行事件处置 · 发布影像作业规程 |
| 管理员 | 全部 + 管理控制台 | 全部(包括更改品牌) |
| (其他) 品质 | 全部 | — |
| (其他) 设计 · 采购 · 生产管理 · EHS · 审计 · 合作商 | 全部(合作商只有提问) | 审计拥有"查看审计记录"。默认不附加给任何人 — 需要时再附加 |
| (其他) 外部 API | — | 外部系统通过 API 密钥调用时的权限 · 等级 — 不附加给人 |
- 创建·管理自动化包含在附加给人的所有内置组合中(仅外部 API 组合除外)。由于自动化只会在创建者的权限 · 范围内运行， 权限不会因此扩大。最初只有厂长 · 管理员拥有，既有安装会在启动时为其余组合追加一次 — 此后若管理员移除，不会再次添加。
- 除管理员外的所有组合都包含聊天工具权限(合作商只有内置 · 已注册 MCP)。
- 所有人员组合中都仍保留旧版«今日»权限 — 目前不会打开或阻挡任何内容。
附加给人 — 用户编辑
在管理控制台 › 用户(/admin/users)中点击某人所在行，右侧会展开编辑栏。新用户通过添加用户创建。
栏位从上到下依次是基本 · 角色组合 · 范围·等级 · 代理·过期 · 平台连接五个组合。
编辑画面中的全部栏位(与画面上所写名称一致)。
| 组合 | 栏位 | 作用 |
|---|---|---|
| 基本 | 姓名 · 邮箱 · 手机 | 账户信息 |
| 我的业务 | 作业员 · 班长 · 维护 · 品质 · 厂长 中的一个。"首次打开时看到的画面会不同，切换为该业务对应的角色组合。仅管理员可设定。" — 选择后，下方角色组合中业务角色五个组合里会只勾选那一个，管理员 · 合作商等其他组合保持不变 → 用户权限与业务角色 | |
| 打开管理控制台 | 开启后该人员可打开管理控制台(/admin)。与«管理员»组合是同一回事，改动一边另一边也会随之改变 | |
| 新密码 | 留空则不修改。至少 8 位 | |
| 角色组合 | 组合勾选列表 | 基本组合和其他组合在同一列表中。可多选，权限是所选组合的合集 |
| 范围·等级 | 全部范围 开关 | 开启后可见全部。"关闭后只能看到下方所列范围内的数据。" |
| 种类 · 键值 · 添加范围 | 选择种类(设备·产线·站点 · 项目 · 客户 PO · 合作商)并输入键值，逐行添加。设备可在键值栏中选择资产树中的站点 · 产线 · 设备填入。行末的 × 用于删除 | |
| 阅览等级 | "可打开该等级以下的文档。" — 一般 · 内部 · 对外保密 · 管控 | |
| 代理·过期 | 每个组合的期限 | 所选每个组合都会生成一个日期栏。"若为组合设置期限，则仅在该日期内有效，过期后下一次请求起会被移除。" 留空则无期限。«合作商»组合为到期日(必填) |
| 期间代理(代行) | 输入将谁的组合(选择人员) · 到何时(日期)后点击代理。"将所选人员当前的角色组合赋予给本人，直到当天结束。点击后立即生效。" — 与下方的保存分开执行。仅在编辑中可见，添加用户时没有 | |
| 平台连接 | 平台用户 | 从列表中选择或输入平台登录账号。"与平台登录账号关联后，将以该人的权限调用平台工具。留空则不关联。" 无法读取列表时会提示"无法读取平台用户列表 — 请直接输入账号。" |
| 底部 | 设为停用 · 保存 | 见下 |
- 保存按账户信息 → 我的业务 → 权限(组合 · 范围 · 等级)的顺序写入。中途被拒绝时会提示"已保存：… / 未保存：… — 原因"，告知保存到何处，正在修改的栏位会原样保留。
- 无法加载权限栏位时会提示"无法加载权限设置。现在保存只会更改账户信息。" — 此时保存不会触碰范围 · 等级。
- 通过添加用户创建的人员若什么都不选，将以作业员组合 · 全部范围 · 阅览等级对外保密开始。
- 改动内容会记入审计记录，标记为
access.user:<아이디>(组合 · 范围 · 等级的旧值 → 新值，操作人)。更改"我的业务"的记录为employee.work_role:<아이디>。 - 本人只能在设置(
/settings)的个人资料组合中查看自己的角色和可见范围。
保存被拒绝时画面显示的原因如下。
| 画面提示 | 含义 |
|---|---|
| "范围为空 — 照此保存将看不到任何数据。" | 关闭了全部范围且未添加任何项目(警告 — 仍会保存) |
| "范围过大(超过 6KB) — 请按站点·产线单位归并指定" | 项目过多 |
| "合作商组合必须设置到期日" · "合作商账户的范围只能以合作商项目指定(至少一个)" · "合作商账户无法查看管控等级" | 见下方合作商账户规则 |
| "期限必须是未来日期" | 组合期限 · 代理日期早于今天 |
| "不能将代理设为自己" · "没有可代理的组合" | 期间代理的对象有误，或所选人员没有可赋予的组合 |
数据范围
在哪里设置 — 管理控制台 › 用户 › 该人员 › 范围·等级组合。关闭全部范围开关后，输入种类 · 键值并通过添加范围逐行添加。 阅览等级也在同一组合的阅览等级栏位中选择(文档一侧的等级见下方文档等级)。
| 范围项目 | 含义 |
|---|---|
all(«全部范围») | 可见全部。不能与其他项目同时设置 |
asset:<자산 id> | 平台资产树中的节点 — 无论是站点 · 区域 · 产线 · 设备中的哪一层，其下所有设备都在范围内 |
project:<id> · customer_po:<PO> · supplier:<id> | 关联到该项目 · 客户 PO · 合作商的内容 |
- 🔴 留空则看不到任何内容。 如果要让其可见全部，请开启全部范围开关(
all)。关闭该开关后，已填入的项目仍保留在画面上，再次开启即可恢复。 - 项目过多超过 6 KB 时保存会被拒绝 — 不要逐个添加设备，应按站点 · 产线单位归并。单个键值最多 200 字符。
- 范围的含义与平台的资产范围(安全策略)相同。这是为了防止同一人在平台画面和 AI 回答中看到不同的设备。
范围过滤的位置
| 何处 | 范围用户可见内容 |
|---|---|
| 画面 | 提问首屏的"今日待办" · 建议(待确认异常 · 事件 · 处理中 · 完成) · 通知(/alerts) — 仅限范围内设备的内容。建议的计划卡片只能看到记有设备信息的卡片 |
| 全厂汇总 | 如全厂 OEE 这类统计整个工厂的数值会被关闭，设备健康状况只统计范围内设备。本体图谱会回答"不知道" |
| 通知 | 画面通知 · 手机 · 浏览器推送也只有范围内设备的内容。没有设备信息的全厂级通知只会发送给拥有全部范围的人。自动化发送的应用通知只会留存在被指定为接收方的人的通知列表中，若结果涉及的设备在该人范围之外则不会发送 |
| 提问 | 询问范围外的设备会回答超出范围。文档回答 · 今日工作 · 准备度 · 数字线程工具的回答同样仅限范围内 |
| 自动化 | 只在创建者的权限 · 范围内运行。自动化列表的全部标签页(所有人的自动化)仅对管理员和«厂长»组合可见，打开 · 关闭 · 删除他人自动化只有管理员能做 |
| 通过地址打开范围外对象时 | 显示"无"(404) — 不会告知是存在但被阻挡的。建议中则显示"找不到该事项" |
在 241 演示中，若将范围设为仅转子产线一条，可见设备会从 122 个减少到 3 个，事件从 100 件减少到 0 件，询问范围外设备时回答会被拒绝。
将账户改为停用后，该人员已打开的会话会在下一次请求时中断，该人员创建的自动化也不再运行。
文档等级
等级共有四种 — 一般 < 内部 < 对外保密 < 管控。用户只能看到自己阅览等级以下的文档。未设定等级的 文档为内部。
在管理控制台 › 文档等级(/admin/grades，权限"指定文档等级")中可按设备缩小范围，为每份文档选择等级。选择的瞬间就会在文档服务器上指定并记入审计 —
没有单独的保存按钮。
| 编号 | 位置 | 作用 |
|---|---|---|
| ① | 按设备 ID 缩小范围 | 按设备 ID 缩小范围。留空则显示全部 — 仅显示前 300 条，数量多时请缩小范围 |
| ② | 表格 | 文档名称 · 设备 |
| ③ | 等级 | 逐行选择等级后立即生效 |
- 指定人员必须同时能查看当前等级和新等级。若要指定为管控，自己的阅览等级必须是管控。
- 图纸的同一编号 · 版本的全部文件(DXF 原件 · PDF · 按设备的副本)会以其中最高的等级统一处理。归并的依据 不是文件名，而是标题栏上的编号 · 版本。
- 指定操作会记入审计记录，标记为
access.grade:<설비>/<문서>。
| 等级 | 画面 | 提问 |
|---|---|---|
| 一般 · 内部 | 保持原样 | 保持原样 |
| 对外保密 | 图纸页预览上会加查看者 ID · 时间水印。浏览会被记录 | 引用的回答会被记录 |
| 管控 | 水印 + 预览分辨率受限，原件下载对可浏览者也会被阻挡。浏览会被记录 | 引用的回答会被记录 |
超出阅览等级的文档不会打开影像 · 图纸页 · 版本对比，也不会出现在提问回答的素材中 — 既不会出现在依据卡片中，也不会出现在引用编号中。
记入浏览记录的内容 — 对外保密 · 管控文档的影像播放开始、图纸页浏览、提问回答的引用(仅限回答实际引用的内容)，以及建议所引用的文档回答。
审计画面 — /audit
在一个画面中查看设置 · 权限变更记录及对外保密 · 管控文档的浏览记录。只读。
| 编号 | 位置 | 作用 |
|---|---|---|
| ① | 过滤栏 | 起始日 · 结束日 · 用户(ID) · 种类(全部 · 变更 · 浏览)。留空则为最近 7 天 |
| ② | CSV 下载 | 下载过滤结果。可在 Excel 中打开。表格上方会显示过滤的期间和行数，一次最多 2,000 条 — 超过则需缩小期间 |
| ③ | 表格 | 时间 · 种类 · 用户 · 对象(access.bundle:… · access.user:… · agent:… 等) · 内容(旧值 → 新值) |
入口
| 谁 | 在哪里 |
|---|---|
| 管理员 | 管理控制台 › 审计日志(/admin/audit) |
| 非管理员但拥有"查看审计记录"权限的人(«审计»组合等) | 侧边栏下方个人资料行 › 审计(/audit) — 同一画面 |
仅凭"查看审计记录"一个权限即可打开。启动时的迁移记录中，用户字段会留存为 system:migration。
双人审批 · 代理 · 合作商账户
从再发布 7(2026-10-09)起加入的规则。
| 什么 | 怎么做 |
|---|---|
| 什么 | 怎么做 |
| --- | --- |
| 双人审批 | 提问回答下方"可执行操作"卡片不能由进行该对话的人(创建者)本人审批 — 会显示"创建者无法审批 — 请由具备 … 权限的其他人在建议的待审批中审批。"，由拥有审批权限的其他人在建议中打开该事项，填写理由后审批 · 拒绝。高影响操作在首次审批后会变为"○○已先行审批，等待其他审批人"，须由首个审批人以外的另一人审批后才能发送。建议详情中"审批后生成的草稿"也同理 → 建议 |
| 代理 | 将他人当前的组合赋予本人，直到指定日期结束。也可为每个组合单独设置期限，过期后下一次请求起(最迟 30 秒)会被移除 |
| 合作商账户 | 附加«合作商»组合时，范围只能是 supplier:<협력사 키>(至少一个)，组合的到期日必填，阅览等级非管控才能保存。到期日过后，该账户已打开的会话会在下一次请求时中断 |
因休假 · 轮班导致审批人空缺时可用代理填补。所有记录均记入审计记录，标记为 access.user:<아이디>。
外部系统 — 仅限 API 密钥
外部集成地址 /api/v1/** 和 /mcp 仅能通过 API 密钥打开。若以已登录的浏览器会话调用则会被拒绝(403)。
通过 API 密钥调用的权限 · 等级遵循«外部 API»组合(默认对外保密)，范围始终为全部 → Copilot 管理控制台 — API 密钥
运维 — 后端用户信息检查模式
后端三个组件通过一个安装值来决定如何处理没有用户信息的调用(PI_USER_CONTEXT_MODE，默认 off)。
由于 Copilot 发出的调用始终携带用户信息，即使在默认值 off 下，上述范围 · 等级依然照常生效。
| 值 | 无用户信息的调用 |
|---|---|
off(默认) | 按全部范围处理(管控文档被关闭) |
log | 按全部范围处理，但留下警告和指标 user_context_missing_total |
enforce | 以 401 拒绝 |
推荐的运维值为 log。enforce 不是安全边界，而是"检测用户信息传递遗漏"的手段(持有后端入站密钥的一方已经
拥有全部权限)，只在没有向外部客户端开放后端 — 即代理的 /mcp/rag/ · /mcp/timeseries/ 与 rag.* · timeseries.*
主机不被客户 MCP · API 客户端使用的安装中启用。外部机器客户端会在 enforce 收到 401。
切换到 enforce 之前，先用 log 运行一天，确认指标是否为 0。管理控制台(admin-web)直接调用后端的调用
也包含在内。后端若返回 401 user_context_*，请确认 Copilot 与后端的入站密钥是否一致，以及主机时钟是否对齐
(容差 30 秒)。
问题排查
| 症状 | 原因 · 处理 |
|---|---|
| 可以登录，但建议为空，提问首屏没有"今日待办"行 | 数据范围可能为空。请在用户编辑的范围·等级中开启全部范围或添加范围项目 |
| 保存用户后提示"已保存：账户信息 / 未保存：…" | 账户信息已保存，但权限部分被拒绝。请根据一同显示的原因(合作商规则 · 范围 · 期限)修改后重新保存 |
| 组合编辑中看不到"报表"权限 | 属正常现象 — menu:report 在新画面中不阻挡任何内容，因此被隐藏 |
| 侧边栏没有建议菜单 | 没有一个可见来源 — 请在组合中加入"建议 — 计划 · 待确认异常 · 事件接收·处理中·完成"中的一项 |
| 侧边栏没有自动化菜单 | 组合中没有"创建·管理自动化"。内置组合中本应包含，说明管理员已移除 |
| 询问全厂 OEE 等全厂级数据不予回答 | 该人员被指定了范围 — 全厂汇总只对拥有全部范围的人可见 |
| 明明是存在的设备，用地址打开却显示"无" | 该设备在我的范围之外 |
| 图纸原件下载被阻挡 | 这是管控文档。管控文档的原件不会提供给任何人 |
| 将文档等级改为管控被拒绝 | 我的阅览等级不是管控，或者该设备在我的范围之外 |
| 身为厂长但催办卡片上没有审批按钮 | 若是我自己提问的对话中的卡片，属正常现象 — 创建者不能审批，需由其他审批人在建议中审批。若是他人的卡片却仍没有，说明未附加«厂长»组合 |
| 审批了催办但未发送 | 这是需要双人审批的操作 — 正在等待首位审批人以外的另一人完成第二次审批 |
| 升级后作业员看不到建议的"待确认异常" | 这是再发布 7 的默认值。如有需要，请在«作业员»组合中勾选"建议 — 待确认异常" |
| 看不到品质 · 设计组合 | 它们位于角色组合画面的其他组合下方。在用户编辑中，所有组合都在同一个列表中 |
| 被指定范围的人的文档回答稍慢 | 属正常现象 — 若存在文档等级指定或该用户为范围用户，只能依据过滤后的依据生成回答 |
在浏览器中打开 /api/v1/... 返回 403 | 属正常现象 — 外部集成地址仅能通过 API 密钥打开 |
相关文档
- 用户权限与业务角色 — 按业务角色划分的可见菜单
- Copilot 管理控制台 — 用户 · 角色组合 · 文档等级 · 审计日志
- Copilot 画面地图 · 建议
- 以图纸提问