AI 管理控制台

AI 技术栈配套提供一个 管理控制台。GPU 有多忙、LLM 是否变慢、文档索引是否正常运行， 这些都可以不登录服务器、直接在浏览器中查看。

本文一个画面对应一节。每节都配有画面示意图，图中的编号（① ② ③）与下方表格的编号一致。 编号即为自上而下阅读画面的顺序。初次使用者请先按快速浏览走一遍， 之后再查找所需画面对应的章节。

面向谁

面向现场操作员和系统管理员。控制台以只读画面居多，误点导致损坏的情况几乎不会发生。 会更改数值的画面已在各节中单独标注注意。

---

访问与登录

地址为以下三者之一。请向管理员确认使用哪一种。

形式	地址	备注
内网 IP 访问 (HTTP)	http://<AI_SERVER_IP>:5959	PI_ADMIN_WEB_PORT，默认 5959
内网 IP 访问 (HTTPS)	https://<AI_SERVER_IP>:5960	PI_ADMIN_WEB_TLS_PORT，默认 5960。代理（plantpulse-proxy）终止 TLS 后转发至控制台
绑定域名的安装	https://admin.<COMPANY_DOMAIN>	经由代理的 443

HTTP 与 HTTPS 均处于开放状态。通过 HTTP 访问时不会跳转到 HTTPS。

若从 2026.09 之前版本升级而来

截至 2026.09，控制台位于 9080。自 2026.10 起不再使用 9080 —— 请将书签和防火墙规则改为 5959 · 5960。 完整端口清单见服务端口映射表。

在登录画面（/login/）输入账号和密码。默认账号为 admin，密码由管理员在安装时设定。 登录后将返回原本要打开的画面。

只有一个账号

控制台不设置按用户区分的账户。使用运维团队共用的单一账户登录。 请妥善管理密码，不要外泄到团队之外。账户设置见账户与会话。

登录一次保持 8 小时

超过 8 小时后需重新登录。系统会记住当时所看画面的地址，登录后将返回该位置。

可切换为韩语显示

控制台支持 English · 한국어 两种语言。可通过登录画面的语言按钮，或登录后左侧导航栏下方的 语言（Language）按钮切换。在地址末尾追加 ?lang=ko 打开也会以韩语显示。 本文以粗体标注韩语界面名称，并在括号中附上英文界面名称。

---

画面导览

左侧竖栏（导航栏）用于选择服务，其右侧的侧边栏显示该服务的各个画面。 主页 · GPU 没有侧边栏。导航栏下方附有运维手册 ↗ · 语言 · 退出登录。

GPU 与 LLM 位于各服务上方是有意为之的排序。判断什么变慢或宕机，通常要从下层基础设施查起， 因此自上而下逐层排查能更快定位问题。 MCP 网关紧随 LLM 之后 —— 把模型与该模型所用工具经过的关口并排查看。

导航栏（英文界面）	侧边栏画面
主页（Home）	—
GPU	—
LLM	仪表板 · 聊天测试 · 模型注册 · API 密钥 · API 端点 · 上游状态 · 日志 · 设置
MCP 网关（MCP Gateway）	概览，网关分组（服务器 · 工具 · 权限 · 客户端 API 密钥），工具检索分组（检索测试台 · 检索设置），监控分组（调用记录·指标）+ 通用菜单（2026.10 再发布（2026-10-20））
RAG API	仪表板，索引分组（文档 · 视频 · 同步历史 · 图纸台账），API 分组（查询测试）+ 通用菜单
时序洞察（Timeseries Insight）	仪表板，分析分组（资产 · 生产 · OEE · RAM · EMS · 报警 · 系统），AI 自治 · 画像分析 · 特征存储 + 通用菜单
文档解析（Document Parsing）	文档巡检，图纸分组（图纸识读测试）+ 通用菜单
视觉（Vision）	视觉巡检 + 通用菜单
数字主线（Digital Thread）	集成地图 · 图镜像 + 通用菜单
自动化沙箱（Automation Sandbox）	概览，运行分组（运行历史 · 上限）+ 通用菜单（没有 MCP 服务器信息）

通用菜单在 RAG API · 时序洞察 · 文档解析 · 视觉 · 数字主线 · MCP 网关这六个服务中完全相同（自动化沙箱除 MCP 服务器信息外也相同）—— MCP 服务器信息 · API 端点（MCP 分组），日志 · API 密钥（运维分组），以及列表末尾的设置。 掌握一次，六处通用。本文末尾的通用菜单一节统一说明。

现场业务画面不在本控制台中（2026.10）

作业就绪度 · 设备时间线 · 图纸版次标签等面向现场人员的内容位于副驾（现场 › 数字主线 /thread、设备画面的时间线、聊天中的图纸卡片）→ 副驾画面导览。本控制台的 数字主线导航栏只保留接入连接器、监视镜像的运维人员画面。运维人员看的不是判定结果，而是«判定依据挂了哪些源» → 就绪度来源。

隔离网络中手册链接无法打开

导航栏的运维手册指向外部站点（docs.kopens.io）。在无互联网的现场无法打开。 服务器内已一并安装手册副本，请咨询管理员。

窄屏 —— 菜单收起为抽屉

当窗口宽度小于 1024px 时，导航栏和侧边栏会从画面左侧消失，画面顶部出现一条横栏。

编号	位置	作用
①	顶栏左侧 ☰	打开菜单 —— 导航栏和侧边栏以抽屉形式展开
②	顶栏	徽标与产品名称
③	抽屉（右侧场景）	与宽屏的导航栏 · 侧边栏菜单相同。展开后会遮住顶栏的 ① · ②
④	抽屉外的暗色遮罩	点击可关闭抽屉

抽屉可通过 Esc · 点击外部 · 点击菜单项 · 页面跳转 · 将窗口放宽至 1024px 以上中的任一方式关闭。

---

快速浏览

初次使用者请按此顺序走一遍。全程只看不改。

1. 主页 —— 系统状态行的宕机为 0 即可初步放心。
2. GPU —— 查看 XID 错误是否为 0。
3. LLM → 仪表板 —— 查看各模型的 P95 是否与平时相当。
4. RAG API → 文档 —— 仅确认是否有已索引的文档。
5. 同一侧边栏的日志 —— 按最新顺序显示近期日志。无需通过 SSH 执行 docker logs。

在主页查看整体状态 → 进入异常服务 → 查看日志。 控制台上的大部分工作就是这一句话。

---

主页 — /

一眼掌握整个 AI 技术栈的健康状态，并作为进入各服务画面的起点。状态每 20 秒自动刷新。

编号	位置	作用
①	画面顶部	产品名称与副标题 —— 可按安装环境更换的页眉
②	系统状态（System Status）	将所有受监控服务按全部 · 正常 · 注意 · 宕机计数。标题处的圆点为整体判定，旁边有最后刷新时间和刷新按钮。展开查看详情可显示各服务的状态与响应时间
③	服务卡片	一个服务对应一张卡片。按服务 API · 模型服务 · 存储 · 网关 · 追踪顺序分组，便于故障时按«调用方 → 服务方 → 存储·观测方»的顺序逐层排查

卡片的阅读方式如下。

• 右侧的状态点仅出现在受监控的服务上。
• 带箭头的卡片点击即可进入。RAG API · 时序洞察 · 视觉 · 文档理解 · 数字主线会跳转到控制台内部画面， LLM 代理 · 图数据库则在新窗口中打开对应工具的界面。
• 不带箭头的卡片仅用于查看状态，是浏览器无法直接访问的内部服务。
• 卡片第二行是对该服务职责的两行以内说明。例如 RAG API 是「索引并检索资产文档（PDF·Office）·图纸（DXF·PDF）·视频·音频」， 时序推理模型服务器是「TSPulse 异常检测·TTM 预测模型服务器」。

常见操作

1. 展开查看详情。展开一次后，下次进入时仍保持展开状态。
2. 将鼠标悬停在处于注意（黄灯）状态的服务指示上。服务自身上报的原始状态会一并显示在提示框中 —— 例如服务存活但数据库连接已断开的情况。
3. 进入该服务查看日志。

最初几秒为灰色

在尚未获取到状态期间，圆点为灰色（未测得）。灰色不代表「正常」，而是「尚不知晓」。

---

GPU — /gpu/

查看 GPU 设备的使用率·温度·错误。数值每 5 秒重新采集一次。

编号	位置	作用
①	画面顶部	画面名称与最后采集时间 —— 在此确认数值是否停滞
②	摘要行	设备 · 统一内存 · 主机 CPU · XID 错误 —— 一行呈现整机当前占用程度以及是否发生硬件错误
③	设备表	一台 GPU 一行。纵向比较 SM（使用率） · 显存带宽 · 温度 · 显存温度 · 功耗 · SM 时钟 · 编码 / 解码 · XID，找出异常的 GPU
④	趋势	最近 60 分钟图表 —— 判断当前数值是瞬时尖峰还是持续偏高

XID 不为 0 时切勿忽略

XID 是 NVIDIA 硬件或驱动报出的错误。不为 0 时该行会显示红色标记。若放任不管， 下一个症状通常就是服务器宕机。请原样记录该数值并告知系统管理员。

---

LLM 仪表板 — /llm/

查看模型服务引擎的响应速度与吞吐量。数值每 5 秒采集一次。

编号	位置	作用
①	画面顶部	画面名称与最后采集时间
②	摘要行	模型 · 运行中 · 队列 · 最差 P95 —— 一行判断引擎是否积压。最差 P95 旁会一并显示告警阈值
③	模型表	一个模型一行。通过状态 · 运行中 · 队列 · 吞吐量 · P50 · P95 · P99 · 1 分钟中断 · KV 缓存 · 30 分钟 TPS 找出哪个模型变慢。短横线（—）表示尚无样本
④	趋势	单个模型最近 60 分钟（1 分钟窗口）图表 —— 定位变慢的时间点

当出现「最近回答变慢」的反馈时，请查看 P95（较慢的 100 次中第 5 位）列。若明显高于平时， 说明这种体感是准确的。

---

聊天测试 — /llm/playground/

向模型网关（LiteLLM）发送一条提示词。由于与应用程序调用的是同一路径， 可用于区分«模型是活的，只是应用不通»的情况。

编号	位置	作用
①	画面顶部	画面名称与网关上报的模型数量
②	提示词卡片	用模型按钮选择发送目标模型，填入系统提示词（可选） · 最大 token · 提示词后发送（Ctrl+Enter）。下方显示回答 · 耗时 · 输入/输出 token

最大 token 由服务器截断为 2048

无论填写多少，服务器都会在 2048 token 处截断。回答一次性返回（流式输出被有意关闭）。 模型在作答前会先«思考»，因此预算过小时可能在输出正文前就结束 —— 此时画面会给出提示。 由于同一块 GPU 也在处理副驾请求，较长的回答会耗时较久。

---

模型注册 — /llm/models/

将外部模型端点注册到网关。无论内部还是商用，只要兼容 OpenAI 即可。

编号	位置	作用
①	画面顶部	画面名称与刷新
②	摘要行	服务中 · 配置文件 · 此处注册 —— 按来源统计网关路由的模型。此处可修改的只有«在此注册»的那些
③	添加模型（Add a model）	注册新端点 —— 填入模型名称 · 提供方路径 · 端点 · 提供方 API 密钥 · API 版本 · 类型，先连接测试再注册
④	服务中的模型	当前正在服务的模型列表 —— 只有来源为«本控制台»的行可以删除

常见操作

1. 填入模型名称（调用方在 model 中传入的名称）、提供方路径（LiteLLM 格式，例如：openai/gpt-4o）、 端点。若端点需要密钥，则填入提供方 API 密钥。 API 版本仅在 Azure OpenAI 时使用。
2. 正确选择类型（聊天 · 补全 · 嵌入 · 重排）。选错会让正常的端点看起来像出了故障。
3. 通过连接测试确认响应后再注册。

这是会更改数值的画面

• 来源为配置文件（litellm-config.yaml）的默认模型无法在此修改 —— 该文件为权威来源。
• 删除后，以该名称调用的一方会立即开始失败。
• 注册 · 测试 · 删除均会记入审计日志（提供方密钥不会被记录，仅保留指纹）。

注册的提供方密钥使用 salt 加密

此处填入的提供方 API 密钥会以 PI_LITELLM_SALT_KEY 加密后保存。若更改 salt，已注册的 模型在列表中仍照常显示，但调用会静默失败 → 密码 · API 密钥变更

---

LLM API 密钥 — /llm/api-keys/

签发 · 重新签发 · 删除要提供给应用程序的虚拟密钥。与通用菜单的 API 密钥 同名但作用不同 —— 后者是测量«我们的密钥是否生效»，这里是签发«要交给他人的密钥»。

位置	作用
摘要行	密钥 · 用量金额 · 已拦截 —— 已签发密钥的使用量以及是否有被拦截的
签发密钥（Issue a key）	设定名称 · 最大预算（USD） · 有效期（例如：30d、24h、1mo）后签发。留空即不限制
已签发密钥表	每个密钥显示哈希 · 模型 · 用量 / 预算 · 状态 · 到期，行末为重新签发 · 删除

签发的密钥只显示一次

控制台和网关都不保存明文。若签发后未及时复制，就必须重新签发。 重新签发·删除后，当前值会立即失效。签发 · 重新签发 · 删除均会记入审计日志（不会记录密钥值）。

LLM 下也有 API 端点（/llm/api-endpoints/）。它是网关的完整 API 列表，形式与 通用菜单中的相同。

---

上游状态 — /llm/operations/

探测网关背后的模型是否真的会响应。一次巡检即一次真实调用。

编号	位置	作用
①	画面顶部	画面名称与执行巡检 —— 仅在点击时才对所有模型各实际调用一次
②	摘要行	健康 · 不健康数量 —— 一眼看出是否有不响应的模型
③	端点表	每个模型的状态与详情 —— 原样呈现网关返回的内容，可直接读取失败原因

---

LLM 日志 — /llm/logs/

经过网关的一次请求即一行。与通用菜单的日志（服务日志文件）不同。

位置	作用
画面顶部	开始 · 结束 → 应用 —— 设定查看区间
表	时间 · 模型 · 类型 · token · 延迟 · 成本 · 请求 id —— 找出哪些请求慢或贵

提示词与回答正文不在此处 —— 它们在 Phoenix 追踪中。

---

LLM 设置 — /llm/config/

查看控制台接入 LLM 技术栈的方式以及网关上报的数值。仅供查看。

编号	位置	作用
①	画面顶部	画面名称与刷新
②	网关（Gateway）	控制台使用的网关地址与密钥。密钥仅显示指纹，只有点击眼睛图标时才返回明文，且该请求会连同用户名记入审计日志
③	指标采集目标（Metric poll targets）	LLM 仪表板直接抓取的引擎列表 —— 仪表板为空时，在此查看目标是否缺失
④	网关已知的模型（Models the gateway knows）	原样呈现网关上报的模型列表 —— 控制台不另行维护自己的列表

给应用程序的应是虚拟密钥而非主密钥

网关的主密钥由控制台服务器持有，不会下发到浏览器。请向应用程序提供 在 LLM API 密钥画面签发的虚拟密钥 —— 可单独设定预算·有效期·作废。

---

RAG 仪表板 — /rag/

查看让聊天机器人基于内部文档作答的服务（RAG API）的索引状态。

编号	位置	作用
①	索引运维（Indexing Operations）	画面名称、最后刷新时间、刷新
②	摘要行	文档总数 · 已索引 · 等待中 · 失败 —— 统计平台台账中的文档是否已完成索引
③	调度器	下次执行 · 最近执行及该批次的结果摘要 —— 查看同步是否按时运行

下方依次是后端可达性表（LightRAG · PostgreSQL · 图数据库 · 向量数据库 · 平台是否可达）和 按资产的索引状态。若失败不为 0 或存在无法连接，请查看该服务的日志。

---

文档 — /rag/documents/

查看已索引的文档，并上传或重新索引文档。收到**「聊天机器人找不到文档」**的反馈时， 先从这里查起。

编号	位置	作用
①	画面顶部	上传（打开上传对话框） · 刷新 · 立即同步（立刻重新拉取平台文档） · 全量重新索引
②	摘要行	文档 · 已索引 · 等待中 · 失败 —— 是否存在未完成索引或索引失败的文档
③	文档表	资产 · 文档 · 状态 · 索引时间 · 操作。通过行末操作可查看详情 · 重新索引 · 下载原件 · 以该文档做检索测试 · 从语料库排除/重新纳入 · 删除（仅限手动上传的文档）

常见操作 —— 聊天机器人找不到文档时

1. 在表中查看该文档是否存在 —— 不存在即说明未被索引。
2. 若存在，通过行末的以该文档做检索测试或查询测试画面，用与用户提问相近的说法进行检索。
3. 在同步历史中确认最近一次同步是否以失败告终。

索引运行期间状态会每秒自动刷新，无需手动刷新。

若图纸索引（DRAWING_INGEST_ENABLED）已开启，图纸行会在文档名下方一并显示图号 · 版次 · 件号和版次标签 （最新版 · 旧版（最新 …） · 变更进行中 · 无法确认）。若要按版次汇总查看图纸，请打开 图纸台账。

• 未能从标题栏读出图号的 PDF 图纸同样显示为图纸行 —— 名称下方会附上「图纸 · 未能从标题栏读出图号」。 这是为了避免它看起来像普通文档。
• 图纸行的检索排除取决于图纸的来源路径。
  • 来自平台台账的图纸（来源 PLATFORM）与普通文档一样，可点击从语料库排除 / 重新纳入按钮。由于台账是权威来源， 无法删除，因此要从检索中剔除就用这个。
  • 在控制台手动上传的图纸按钮不可点击（显示为灰色）。鼠标悬停会提示「手动上传的图纸无法从检索中排除 —— 请删除图纸或重新索引（平台台账图纸可以排除）」。
  • 重新索引 · 下载原件对任何图纸均可用，删除则仅限手动上传的。

未找到依据时的回答措辞并不固定

该措辞由 LLM 临场生成，因而每次都不同。请勿依据特定措辞判断，而应依据索引条数是否为 0 来判断。

文档删除不可撤销

删除操作仅对手动上传的文档（标注手动）可用。已删除的文档聊天机器人将无法再用作依据， 若要重新加入，必须重新上传原始文件。若手头没有原始文件，请勿删除。 来自平台的文档应使用从语料库排除而非删除。

全量重新索引

全量重新索引会对平台文档«全部»重新索引。文档会被渐进式重新采集，因此不会出现索引空档， 手动上传的文档也不受影响。但这仍是耗时操作，请仅在必要时点击。

上传对话框 —— 文档 · 图纸台账 · 视频通用

三个画面打开的是同一个对话框。只有初始值和可接受格式随打开位置而不同。

打开位置	按钮	对话框
文档	上传	接受下列全部格式。PDF 初始识别为文档
图纸台账	上传图纸	标题为「上传图纸」，PDF 初始识别为图纸
视频	上传视频	标题为「上传视频·音频」，仅接受视频 · 音频 · 字幕。拖入文档 · 图纸会以「此处仅接受视频·音频·字幕」拦截

编号	位置	作用
①	资产	按资产 ID · 名称搜索并选择。若不选择则上传为公共（_manual），不与资产关联
②	拖放区 · 可接受格式	可一次拖入多个文件，或通过选择文件挑选。下方横栏显示当前可接受的格式及各格式最大尺寸 —— 已关闭的格式显示为关
③	文件列表	每个文件显示类型（见下表）和状态（就绪 · 已拦截 · 上传中 · 完成 · 失败）。PDF 行带有文档 / 图纸选择按钮，可用所有 PDF 批量切换
④	被拦截的行	发送前被拦截的原因会写在该行（见下）
⑤	上传 N 个	逐个依次发送文件 —— 因为 RAG 索引一次只能写入一个

扩展名	类型
pdf · docx · pptx · xlsx · md · txt	文档（PDF 可在文档 / 图纸中选择）
dxf	图纸
mp4 · mov · mkv · webm	视频
m4a · mp3 · wav	音频
srt · vtt	字幕

将 PDF 选为图纸后将按图纸进行索引（会一并发送 document_kind=drawing）。在图纸索引（DRAWING_INGEST_ENABLED）关闭的 安装环境中，会提示「图纸索引已关闭 … PDF 将按普通文档索引」，PDF 将作为普通文档处理。

发送前会被拦截的情况

拦截情形	行内显示的原因
.dwg	「不接受 DWG —— 请导出为 DXF 或 PDF 后上传。」
视频 · 音频但媒体采集已关闭	「视频·音频采集已关闭 —— 请在安装 env 中开启 PI_MEDIA_ENABLED=true …」
字幕但字幕采集已关闭	「字幕采集已关闭（MEDIA_TEXT_TRACKS）。」
DXF 但图纸索引已关闭	「图纸索引已关闭（DRAWING_INGEST_ENABLED），无法索引 DXF。」
超出尺寸	「文件过大 —— … 超过上限 …。」上限为：文档 · 图纸 SYNC_MAX_FILE_MB（捆绑值 50 MB），视频 · 音频 MEDIA_MAX_FILE_MB（默认 2048 MB），字幕 5 MB
空文件	「这是空文件。」

• 已启用的功能与上限并非由对话框决定，而是读取 RAG API 的配置而定。若无法读取配置，会提示「未能读取 rag-api 配置 —— 格式与大小由服务器判定。」，此时仅拦截 .dwg 和未知扩展名。
• 此处上传的文件标记为手动（手动上传），同步不会将其删除。
• 上传图纸后，结果行会显示图号 · 版次 · 尺寸 · 物料表行数；视频 · 音频则以「已进入转写·索引队列」结束 —— 转写将在处理时间段开始。
• 若同名文件已以另一种方式（图纸 / 普通文档）被索引，服务器会拒绝 —— 请先删除或更改文件名。

---

视频 — /rag/videos/

按文件查看维修 · 培训 · 设备运行的视频与音频 —— 是否已转写、是否生成了场景图、是否进入检索索引。 当聊天中视频未作为回答依据出现时，先从这里查起。视频在聊天中如何被使用，见 视频检索。

在媒体采集关闭的安装环境中

画面只显示「视频·音频采集已关闭」提示框，没有表格。安装 env 文件中的 PI_MEDIA_ENABLED=true 是开关 —— 开启后重建技术栈，RAG API 才会接受视频采集并启动转写（ASR）服务器。在此之前 RAG API 没有视频通道，视频上传会被 拒绝 → 环境配置

编号	位置	作用
①	画面顶部	画面名称与说明
②	摘要行	文件 · 已索引 · 等待·处理中 · 失败（失败 · 跳过） · 转写为空 · 检索缺失（已索引但不在检索索引中的片段数）
③	工具行	文件·资产搜索（文件名 · 资产 ID · 资产名称的部分匹配） · 仅问题项（仅显示失败 · 跳过 · 转写为空 · 存在检索缺失片段的项） · 刷新 · 上传视频（以仅接受视频 · 音频 · 字幕的方式打开上传对话框）
④	工具行右侧	处理时间段 —— 转写 · 索引何时启动（见下）
⑤	表	文件 · 资产 · 时长 · 状态 · 转写（字数 · 片段数） · 场景（场景图数） · 上传时间 · 操作
⑥	展开的行	展开后显示播放器、带时间标签的转写（点击标签从该时刻播放）、与视频配对的字幕文件、处理信息（语言 · 已索引片段 · ASR 模型 · 更新时间等）
⑦	行末操作	只显示与状态匹配的按钮 —— 图中已索引行有重新转写（↻）和删除（仅限手动上传），失败 · 跳过行有重试（见下）

处理时间段。 视频转写会长时间占用 GPU，因此只在设定的时间段内启动。行中会显示三者之一。

• 「处理时间段 … —— 正在处理」
• 「处理时间段 … —— 等待文件将于 … 开始」
• 「处理时间段无限制」

时间段由 MEDIA_PROCESSING_WINDOW 设定。留空则为 20:00-06:00（以安装时区 PP_TZ 为准），若为 always 则随时 可启动。时间段只约束处理的«启动» —— 已启动的处理即使时间段结束也会跑完 → 环境配置

状态

状态	含义
等待中	正在等待处理时间段
拉取中 · 转写中 · 索引中	处理进行中
已索引	可用于检索
无声音 · 无语音	没有音轨或未找到语音 —— 若该视频确有语音，请执行重新转写
跳过 · 失败	未能完成处理 —— 展开查看原因后执行重试
删除中	删除进行中

操作

操作	出现的行	作用
重试	失败 · 跳过	重新加入队列。将在下一个处理时间段启动
重新转写	已索引 · 无语音 · 无声音	从头重新转写。丢弃当前转写稿，新片段索引完成后替换旧片段
删除	仅限手动上传的（手动）	删除片段 · 转写稿 · 归档原件。来自平台台账的视频无法在此删除

• 若存在处理中的行，画面会每 5 秒自动重新读取。若只有等待中则不重新读取（因为等待时间段可能长达数小时）。
• 转写为空不为 0 时切勿忽略。确有语音的视频若转写为空，聊天就无法将其用作依据 —— 请按展开行中的提示确认 ASR 模型后执行重新转写（或重试）。
• 自 2026.10 重发布 4 起，转写不再丢弃接在静音 · 噪声之后的第一句话，并将保留句子的时间戳对齐到实际语音起点。此前 已转写的视频不会自动重做，因此对于首句缺失或来源时间戳错位的视频，请执行重新转写 —— 系统将在处理时间段（留空则为 20:00-06:00）重新转录。
• 时间（上传时间 · 下次启动）按安装时区（PP_TZ）显示。转写标签中的 m:ss 是视频内的位置。

---

同步历史 — /rag/sync-history/

拉取平台资产文档的各次同步批次的历史记录。重启后仍保留。

编号	位置	作用
①	画面顶部	画面名称、已记录批次数、刷新
②	表	每个批次显示开始 · 触发 · 资产 · 台账 · 索引 · 消失 · 卡片 · 耗时 · 结果 —— 查看何时有什么进入或移除、是否有失败批次

若最上面一行的结果为错误，请查看该时间点前后的 RAG API 日志。

---

图纸台账 — /rag/drawings/

将 RAG 中已索引的图纸（DXF · 矢量 PDF）按图号归集、每个版次一行查看。若同一版次有多个文件（DXF 与 PDF、 平台台账与手动上传），会归入同一行。可用于判断「现场张贴的图纸是否为最新版」、 「标题栏是否读取正确」。

编号	位置	作用
①	画面顶部	画面名称与说明
②	摘要行	图纸 · 版次 · 旧版 · 未识读 —— 旧版与识读失败各有多少张
③	筛选行	搜索框（图号或件号 —— 也可用文档名片段查找，不区分大小写） · 仅旧版 · 仅识读失败 · 刷新 · 上传图纸（PDF 从一开始即识别为«图纸»的上传对话框）
④	表	图号 · 版次 · 件号 · 版次状态 · 文件 · 识读 · 上传时间。同一图号内新版在上。点击行左侧箭头展开，可看到页面预览（翻页）与标题栏识读值
⑤	文件列	该版次的文件格式标签 —— 深色标签为代表文件（聊天卡片 · 预览所打开的文件）
⑥	展开行右侧	该版次的 N 个文件 —— 格式 · 台账/手动上传 · 资产 · 文件名，代表文件标注「（代表 —— 以此文件打开）」。代表文件按可用文件 → DXF 原件 → 平台台账的顺序选取
⑦	比较列	若同一图号有两个以上版次，新版行会出现与 ○ 版比较按钮 —— 与紧邻的下一版次对比

字段	取值	含义
版次状态	最新版 · 旧版（最新 ○） · 变更进行中 · 无法确认	这是以件号向 PLM 查询发布版次与设计变更所得的答复。无法确认不等于«最新»，而是«不知道» —— 没有 PLM 连接器或未得到响应 → 数字主线
识读	已读标题栏 · 无标题栏 · 失败（附原因） · 处理中	只说明是否从标题栏读出图号以及索引是否失败。未能读出图号的 PDF 图纸同样会登入台账，并以无标题栏计入未识读
上传时间	—	按安装时区（PP_TZ）显示

点击比较后，该行下方会展开摘要 · 置信度 · 无法比较项 · 变更表（标题栏 · 尺寸 · 物料表 · 注释的 新增 · 删除 · 变更），以及在新版图上标出的变更区域。再次点击即关闭。

若图纸索引已关闭

画面顶部会提示「rag-api 的图纸索引已关闭（DRAWING_INGEST_ENABLED）」，页面预览 · 版次状态 · 版次比较将 不可用。出厂默认为关闭。开启方法见环境配置。

想查看尺寸 · 物料表的识读情况

台账的识读字段只说明标题栏与索引失败。请将同一文件上传到图纸识读测试 —— 它与 RAG 索引图纸时使用的识读器相同。

---

查询测试 — /rag/query/

直接对已索引的文档进行检索。与消费方使用的查询 API 契约一致，因此可原样复现聊天机器人 所获取的依据。

编号	位置	作用
①	画面顶部	画面名称与说明
②	查询框	输入问题并选择检索方式（hybrid · local · global · naive · mix，默认 hybrid）后执行查询（Ctrl+Enter）。下方显示回答 · 耗时 · 来源

若目标文档未出现在来源中，请换一种模式重试。

---

时序洞察仪表板 — /insight/

查看从设备数据中发现异常征兆并预测未来的引擎（时序洞察）的状态。这是菜单最多的 服务。

编号	位置	作用
①	画面顶部	画面名称
②	状态提示	服务及其依赖组件是否全部响应 —— 分为正常 / 异常 / 服务器连接错误
③	摘要行	异常检测 · 预测 · MCP 工具 · 调度器 —— 该引擎提供的分析·工具与定时任务数量
④	流水线表	每条特征存储流水线的最近执行时间 —— 查看分析所需的原料是否按时生成

下方依次是分析领域说明与系统信息（AI 模型 · 运行时长 · 调度器 · 预测模型）。

---

异常检测 — /insight/anomaly/asset/ 等

对目标的近期数据打异常分，并对哪些标签·指标偏离平时最多进行排名。 以下六个画面形式相同（报警的频次异常见下文报警分析一节）。

侧边栏	路径	对象
资产 › 异常检测	/insight/anomaly/asset/	单台设备的传感器标签
生产 › 异常检测	/insight/anomaly/order/	近期工单（横轴为工单顺序而非时间）
OEE › 异常检测	/insight/anomaly/oee/	将累计 OEE 转为增量（delta）后的稼动率·性能·质量
RAM › 异常检测	/insight/anomaly/ram/	可靠性 · 可用性 · 可维护性（MTBF/MTTR）
EMS › 异常检测	/insight/anomaly/ems/	将累计能耗（电力·燃料）转为增量后的消耗量
系统 › 异常检测	/insight/anomaly/system/	采集主机的 CPU·内存·磁盘

编号	位置	作用
①	画面顶部	画面名称与所用模型
②	参数	设定待分析资产与范围（数据间隔 · 行数上限 · 阈值 · 查询范围 · 最近区间 · Top K）后点击执行异常检测。结果为摘要行、时序 + 异常分、异常排名、响应数据与说明卡片，依次展开于下方

常见操作

1. 选择资产 ID 并点击执行异常检测。
2. 选取异常排名最上方的标签，在时序 + 异常分中查看分数飙升时刻的实际值。
3. 以同一资产打开预测画面，查看后续走势。

分数表示「与平时不同」，而非「故障」

分数是在所请求窗口«内部»重新归一到 0~1 的值，因此即使在平稳窗口中也会出现接近 1 的点。更换窗口后， 同一个点的分数也会改变。请一并阅读结果下方说明卡片中的容易误解之处。

自 2026.10 起 OEE · RAM · EMS 已进入菜单

旧版本中这三组不在侧边栏，只能通过地址打开。现在它们以分组形式显示在资产 · 生产下。

---

预测 — /insight/forecast/asset/ 等

预测目标的下一区间，并以带状区域一并绘制置信区间。以下六个画面形式相同（报警的 故障预测见下文报警分析一节）。

侧边栏	路径	对象
资产 › 预测	/insight/forecast/asset/	单台设备的传感器标签
生产 › 质量预测	/insight/forecast/order/	后续若干工单的质量·OEE·能耗
OEE › 预测	/insight/forecast/oee/	OEE 的后续走势
RAM › 预测	/insight/forecast/ram/	可靠性 · 可用性 · 可维护性（MTBF/MTTR）
EMS › 预测	/insight/forecast/ems/	能源消耗
系统 › 预测	/insight/forecast/system/	采集主机的 CPU·内存·磁盘

编号	位置	作用
①	画面顶部	画面名称与所用模型
②	参数	设定待预测资产与长度（数据间隔 · 行数上限 · 上下文长度 · 预测长度 · 查询范围 · 置信区间）后点击执行预测。结果为摘要行（耗时 · 模型 · 置信区间 · 上下文）、预测结果、响应数据与说明卡片

若模型显示为 NAIVE

摘要行的模型须为 TTM 才是真正的预测。NAIVE 表示 TTM 失败后返回了替代值。 预测长度上限为 96 个点，超出时不会被截断而是直接拒绝。

---

健康指数 — /insight/asset/health/

将单台设备以 0~100 分的单一数值呈现，并同时查看导致扣分的各项扣减。

编号	位置	作用
①	画面顶部	画面名称 —— 说明这是综合传感器 · OEE · RAM · EMS · 报警的分数
②	参数与说明卡片	设定资产 ID · 数据间隔后点击查看健康指数。结果展开分数 · 各领域分数 · 响应数据。说明卡片（详情 / 收起）告诉你如何解读分数以及下一步应前往哪个画面

结果会复用 60 秒

60 秒内再次点击不会重新计算，而是显示上一次结果。无数据的领域不计为正常，而是从 评分中剔除 —— 若观测不足，等级会以「-」挂起。

停机只对«计划外»扣分

换型 · 计划停机 · 日历休息 · 班次外均不扣分。历史过短的领域不记 0 分，而是列为判定挂起（响应数据中的 held_domains），此时给出的等级为暂定（grade_provisional）→ 时序洞察工具 —— 健康指数的解读方法

---

报警分析 — /insight/alarm/…

这是侧边栏报警分组下的五个画面。它们形式相同：在上方参数中填入资产与范围并点击执行按钮后， 下方展开结果与响应数据、说明卡片。图示为频次异常。

编号	位置	作用
①	画面顶部	画面名称与说明
②	参数	设定资产 · 优先级 · 聚合窗口 · 行数上限 · 阈值 · Top K 后点击执行异常检测。执行前结果区域只有提示文字

侧边栏	路径	执行按钮	查看内容
频次异常	/insight/alarm/anomaly/	执行异常检测	报警集中在哪些时段
故障预测	/insight/alarm/forecast/	执行预测	今后每个窗口会上报多少条报警
持续时间分析	/insight/alarm/duration/	持续时间分析	同一报警是否持续时间越来越长（劣化检测）
传感器关联	/insight/alarm/correlation/	关联分析	报警挂在哪些传感器标签上
统计	/insight/alarm/stats/	查询统计	报警条数 · 优先级分布 · 排名靠前的报警设定与标签

传感器关联并非相关系数

这是按标签·时段«计数»报警的画面。它们只是经常同时出现的标签，并非已被证明同步变化的标签。 在统计中若期间内没有报警，不会报错，而是返回 0 与空列表。

---

AI 发现 — /insight/findings/

查看 AI 在现场察觉到的事项（工单未达 · 数据中断 · AI 变更 · 工艺异常 · 传感器故障）。未关闭的 优先显示。位于侧边栏的 AI 自治分组中。

编号	位置	作用
①	画面顶部	画面名称与刷新
②	摘要行	未关闭 · 紧急 · 高严重度 · 已确认 —— 当前需要人工查看的有多少条
③	状态筛选	按未关闭的 · 打开 · 已确认 · 已关闭缩小列表。旁边还可按类型和资产进一步缩小
④	表	每条发现显示类型 · 资产 · 严重度 · 内容 · 最后观测 · 状态，行末为确认 · 关闭 —— 留下已在查看的标记与处理完成记录

常见操作

1. 阅读未关闭发现的内容，点击确认表示正在跟进。
2. 处理完毕后点击关闭，并在确认对话框中再次确认。

已关闭的发现在相同条件持续期间不会再次打开

确认·关闭会以登录管理员的名义记录，并同时写入控制台审计日志（insight.write）。

---

自治改进 — /insight/autonomy/

在此查看 AI 自主做了哪些更改及其原因，并可停止或回滚。

编号	位置	作用
①	画面顶部	画面名称与刷新
②	当前模式（Current mode）	当前模式（自动 · 仅建议 · 关闭）及设定者与设定时间、最近一次夜间执行。模式切换按钮与紧急停止关闭也在此处
③	对象表	每个改进对象显示当前使用版本 · 试验中 · 待选候选 · 状态，行末为回滚 · 恢复（停止时） · 批准替换（仅建议模式下已就绪的）

下方的变更记录（Change log）会逐行留下时间 · 位置 · 事件 · 执行者。

• 可按期间（7 · 30 · 90 天，默认 7 天）和决策结果筛选。每次显示 50 条，可通过查看更多继续加载。
• 跳过行默认隐藏。可通过也显示跳过项开启。行上方的文字会说明窗口内总数 · 显示数 · 隐藏数。

模式	作用
自动	AI 自主巡检·试验·替换基准，结果变差时自行回滚
仅建议	对新版本巡检·试验后，在变更前等待批准
关闭	不做任何巡检·替换·回滚。当前使用的内容保持原样

这是会更改数值的画面

模式切换 · 关闭 · 批准替换 · 回滚 · 恢复均经确认对话框后立即生效，更改后的模式在重启后仍 保持。所有操作均以登录管理员的名义记入变更记录与控制台审计日志（insight.write）。 紧急情况下，关闭即为急停。

---

评分器对比（影子） — /insight/shadow/

在资产的近期数据上运行无模型评分器，查看若当初开启会捕获到什么。

编号	位置	作用
①	画面顶部	画面名称与说明
②	输入	填入资产 ID · 最近分钟数后点击执行评分。结果展开告警区间 · 告警分钟数 · 不作判定 · 传感器异常摘要，以及所用基准和按区间的表格

只读

不保存任何内容，也不发送通知。运行中的异常判定保持原样。

---

资产画像分析 — /insight/profile/asset/

用真实数据自动理解资产的标签 —— 每个标签测量什么、正常范围及其置信度。

编号	位置	作用
①	画面顶部	画面名称，右侧为资产选择与重新加载画像
②	正文	选择资产前只有提示文字。选定后展开摘要行与标签理解 · 关系图标签页

标签理解标签页按标签显示类型 · 正常范围 · 报警限值 · 置信度；关系图标签页的 执行关系分析会计算同步变化的标签以及领先 → 滞后关系（可能耗时数十秒）。

---

流水线状态 — /insight/feature/status/

查看上述分析所消费的加工数据（特征存储）当前是否正常生成。分析结果为空 或陈旧时，原因多半在此。

编号	位置	作用
①	画面顶部	画面名称、刷新、全部执行 —— 立即一次性运行所有流水线
②	调度器任务	每个任务的触发与下次执行 —— 查看定时任务是否存活
③	流水线	每条流水线的最近执行与触发，每行配有执行按钮 —— 找出长时间未运行的并单独运行

下方的回填状态卡片会显示进行中的回填与最近的错误。

以下是同属特征存储分组的其余三个画面。

侧边栏	路径	作用
执行历史（Run History）	/insight/feature/history/	流水线的历史执行 —— 执行时间 · 耗时 · 处理量 · 状态 · 备注
特征数据（Feature Data）	/insight/feature/data/	资产特征查询（资产 ID · 周期 · 查询条数 → 查询特征）与文本检索、相似资产（向量检索）
回填（Backfill）	/insight/feature/backfill/	选择开始日期 · 结束日期 · 流水线后点击开始回填 —— 补齐缺失区间。若已有回填在运行，则无法新开

回填会让服务器变得繁忙

这是重新计算历史区间的作业，范围过大时耗时长且会推高服务器负载。 请在生产空闲时段，仅针对必要区间执行。若是首次操作，建议与管理员商量。

---

文档解析巡检 — /parser/

上传一份文档，原样确认文档解析服务如何读取它（即 RAG 会索引的文本）。 这是在信任 RAG 索引结果之前使用的画面。侧边栏名称为文档巡检。

编号	位置	作用
①	画面顶部	画面名称与本画面调用的服务
②	输入	选择解析配置档（default · fast · ocr · scan）后拖入文档（PDF · DOCX · PPTX · XLSX · 图像）或点击选择文件。default 与 RAG 索引使用相同配置，选择其他项时会标注«与默认不同»
③	② 下方	说明卡片 —— 说明所选配置档的作用（若为 default 则为「RAG 是如何读取这份文档的」）。可通过收起折叠

结果显示在旁边的解析后的 Markdown 卡片中，上方摘要行附有耗时 · 置信度 · 字数 · 行数。 若结果为空且文档为扫描件，请改用 scan 配置档重试。

每个所选配置档在 ② 下方都附有说明卡片（③），说明该配置档做什么 · 何时使用 · 需注意什么。

配置档	卡片标题	要点
default	「RAG 是如何读取这份文档的」	与 RAG 索引使用相同的解析选项。此处呈现的文本即 RAG 会索引的文本，此处缺失的内容 RAG 同样不知道
fast	「关闭 OCR 快速读取时，这份文档是什么样」	OCR 已关闭，扫描件 · 图像中的文字不会出现。与 RAG 所看到的不同
ocr	「只抽取文字时，这份文档会得到什么」	不识别表格结构，表格会被展开为连续文本。视觉控制台的 OCR 运算使用此配置档
scan	「丢弃文本层全部走 OCR 时，这份文档会被如何读取」	连完好的文本层也丢弃，改用 OCR 读取。对于数字化生成的 PDF，default 更准确

• 卡片一并提示的限制 —— 经由控制台的上传上限为 100 MB（超出返回 413）。控制台上限会比服务自身上限（MAX_DOCUMENT_BYTES，默认 200 MiB） 更早拦截。画面每 2 秒轮询进度，若约 5 分钟仍未结束则停止等待 —— 但这并不会取消解析。
• 此处上传的文档只展示结果随后丢弃，不会被索引到 RAG。
• 即便 scan 明显更好，本画面的配置档也不会更改 RAG 配置。若要在 RAG 中获得相同结果，必须更改文档解析的 OCR 配置（DOCLING_*）。
• 图纸（DXF · PDF）不在本画面查看，请使用图纸识读测试。

---

图纸识读测试 — /parser/drawings/

上传一个图纸文件，查看文档理解服务从该图纸中读到了什么、在哪里读到。位于侧边栏图纸分组中。 由于与 RAG 索引图纸时使用的识读器相同，可用于排查「聊天机器人把图纸尺寸说错了」。

编号	位置	作用
①	画面顶部	画面名称与说明
②	图纸	拖入文件或点击选择后执行识读图纸。允许的格式与尺寸上限由服务决定，上传区下方的文字即为相关说明
③	摘要行	格式 · 页数 · 尺寸 · 物料表行数 · 标题栏（找到 · 未找到） · 警告
④	页面图	在页面图上以彩色框标出识读位置。可通过类型按钮（标题栏 · 尺寸 · 物料表 · 注释）开关这些框
⑤	识读表	以表格呈现标题栏 · 尺寸（公差） · 物料表 · 注释 · 图区。点击表中某行会高亮对应的框
⑥	两版比较测试	上传同一图纸的旧版 · 新版两个文件后点击比较 —— 查看标题栏 · 尺寸 · 物料表 · 注释的变更以及变化区域

尺寸表的«上下限»列。 对每个尺寸一并标注其允许范围的来源。

字段中显示的内容	含义
«下限 ~ 上限»值 + （公式）	由图纸中的配合符号（例如 H7）经 ISO 配合计算式得出的推算值 —— 与标准表可能存在 µm 级差异
«下限 ~ 上限»值 + （图纸）	图纸中以 ± 标注的数值原文
未计算	未进行计算 —— 鼠标悬停可查看原因
一般公差 …	对未标注公差的尺寸，图纸所指定的一般公差等级（不给出数值）

只要存在任一«公式»值，表格下方就会附上「«公式»为 ISO 配合计算式的推算值 —— … 合格判定请以所持标准文件为准确认。」

几何公差框检查卡片。 检查图纸中的几何公差框是否符合规则。标题处显示图纸的一般公差指定与基准字母， 每行显示严重度（错误 · 警告 · 信息） · 对象字母 · 内容 · 依据（标准编号 · 概念名称）。点击与尺寸关联的行， 该尺寸会在图中高亮。若无违规框，则显示「没有违反规则的框。」

说明卡片。 上传区下方的「从这份图纸中读到了什么」、比较测试下方的「两版之间发生了什么变化」卡片会说明读什么 · 何时读 · 如何解读。要点如下。

• RAG 的图纸索引也使用此识读结果。此处缺失的尺寸 RAG 同样不知道。
• 此处上传的图纸只展示结果随后丢弃，不会被索引到 RAG —— 已索引的图纸请在图纸台账中查看。
• 没有文字层的扫描 PDF 无法读取该页的文字。本识读器不执行 OCR。
• 若比较结果显示毫无变更，说明两版相同或未能完成比较 —— 可通过无法比较列表与置信度加以区分。

琥珀色警告不等于失败

未找到标题栏 · 无文字层（扫描页） · **图区网格取默认值（无边框刻度）**只是服务在告知«它是如何读取的»。 扫描 PDF 因没有文字层而无法读取尺寸。

不接受 DWG

超出允许格式的文件，服务会连同原因一并拒绝。DWG 请在 CAD 中导出为 DXF 或 PDF 后上传。

---

视觉巡检 — /vision/

上传一张图像，确认视觉服务实际看到了什么。

编号	位置	作用
①	画面顶部	画面名称与本画面调用的服务
②	请求	选择运算（巡检 · 仪表读数 · 文本抽取 · 分类 · 自由提问 · 目标检测）并上传图像后点击执行
③	说明卡片	所选运算做什么、如何解读结果（详情 / 收起）

执行后会显示样本 · 一致 · 不一致摘要行与图像 · 结果卡片。若为目标检测，图像上 会绘制检测框。

「无法判定」是正常的答复

视觉服务会多次询问模型，只有足够多的答复一致时才给出结果（通常为 3 中 2，仪表读数为 5 中 4）。答复分歧时不会编造数值，而是返回无法判定。再次点击结果也一样， 请重新拍照。自由提问不经过这一一致性校验，因此请勿用于读数或判定。

---

集成地图 — /thread/

用一张地图查看数字主线与外部系统的连接情况。连接器注册 · 字段绑定 · 同步 步骤请见数字主线。

编号	位置	作用
①	画面顶部	视图按钮（地图 · 列表 · 就绪度来源）、添加连接器（在侧边面板中完成注册四步）、刷新
②	摘要行	连接器 · 启用 · 适配性失败 · 工具 —— 有多少集成处于存活状态
③	地图	上方筛选行（族 · 状态）与地图。自左向右呈现外部系统 → 连接器 → 工具 → 绑定 → 工厂图谱。绿色 = 启用，红色 = 适配性失败，灰色 = 禁用。点击节点会在侧边面板中展开配置·适配性结果·最近的行动调用，同时地图只高亮该节点所在的链路

地图的操作方式如下。

• 初始以1 倍大小居中打开。连接器按族顺序 ERP → MES → PLM → SCM → 排程优先排列，其余族按名称排序。
• 可拖动平移，用滚轮上下滚动，Ctrl+滚轮缩放。右上角按钮为放大 · 缩小 · 查看全部。
• 在地图上方的筛选行中按族 · 状态缩小连接器范围（仅作用于地图）。可通过清除筛选还原。
• 地图缩略图默认隐藏。可通过操作按钮中的显示缩略图开启。
• 若连接器过多导致地图难以辨读，可切换到列表查看表格 —— 名称 · 族 · 系统 · 端点 · 状态 · 级别 · 工具 · 凭据 · 适配性。
• 添加连接器的族列表初始显示 erp · mes · plm · scm · sched · qm。

连接器侧边面板中的立即同步会立刻将该连接器的绑定载入镜像，并关闭在源端已消失的连接（不删除，而是 写入结束时间 —— 连接历史由此建立）。完成后会提示「已同步 N 个对象 · N 条连接」。若连接器返回的列表被截断， 还会一并显示黄色提示「本次同步未关闭已消失的连接 —— 采集被截断（…）。将在完整读取的同步中关闭。」 —— 因为用被截断的列表关闭连接会误关正常连接。已启用的连接器，服务也会按周期同步 → 数字主线 —— 连接器同步

变更类操作会记入审计日志

连接器的注册·修改·删除·发现·测试·同步以及字段绑定，均会以登录管理员的名义记入控制台审计日志（thread.write）。 行动工具（🔒）不从控制台调用 —— 由副驾通过已批准的建议卡片中转。

---

就绪度来源 —— 集成地图的第三个视图

从运维视角查看副驾的班组长作业就绪度（每道工序的 Go/No-Go）依据什么作出判定。判定结果（哪道 工序受阻）不在此处，而在副驾画面。这里看的是«每个项目挂接了哪个连接器、其数据是否 新鲜、若缺失会导致判定变成什么»。仅当数字主线服务为提供该功能的版本时，才会显示该视图按钮。

编号	位置	作用
①	标题行	最后判定时间与状态（已判定 · 来源陈旧 —— 判定中止 · 无 MES —— 不作判定）、立即重测
②	项目 · 接线	每个项目（共八项）显示已接线（绿） · 部分接线（橙） · 无（灰）
③	来源（族 · 工具 → 连接器）	每项输入标注必需 · 二选一 · 可选，以及通过哪个族的哪个工具读取、提供该工具的连接器名称。若数据超过上限时长未更新，会附上橙色陈旧标签。点击连接器名称会返回地图并打开该连接器的侧边面板
④	若缺失	来源缺失时判定会变成什么 —— 判定为«未知»，或在没有 MES 工单时完全不作判定。每项输入都附有一行说明会因此而不知道什么（例如「不知道物料短缺 —— 物料为未知」）。最近判定中实际未能读取的输入会标注为«最近判定中未能读取»

以下是八个项目及其供给族（权威定义在数字主线服务的单一声明处，判定与本画面读取同一声明）。

项目	读取的来源
（基础）	MES 工单 —— 没有则任何项目都不作判定
前道工序	MES 工单
物料	SCM 缺料（无则由 MES 提供的同名工具）
工具·校准	工具管理（按作业的工具清单 —— 必需，工具台账 —— 可选）
人员·资质	MES 工序的资质要求 + ERP 人员（无则 MES 人员）
许可·隔离	安全（EHS）作业许可（必需） · 隔离（可选）
质量阻塞	质量（QM）不合格（无则 MES 不合格）
设备维护	维护（CMMS）预防性维护窗口 · 维护工单，至少其一
图纸版次	PLM 设计变更（必需） · PLM BOM（可选） · 工位图纸（数字主线镜像 —— RAG 已索引的图纸）

• 新鲜度以最后一次判定为准。若没有判定记录，会提示「尚无判定记录」—— 立即重测会跑一次判定（仅读取） 后重新测量。
• 新鲜度上限因族而异 → 数字主线 —— 数据陈旧时
• 地图中连接器的侧边面板也有就绪度项目一行，可看到该连接器供给哪些项目。

若班组长画面满屏«未知»

不是判定出错，而是来源没有接上。请在此找出显示为无（灰色）的项目，接入该族的连接器。 «未知»不等于 GO —— 来源缺失的项目不会被计为通过。

---

图镜像 — /thread/mirror/

查看将平台台账与已学习的边周期性搬运到工厂图谱（投影）的状态。只读。 详细内容见数字主线。

编号	位置	作用
①	画面顶部	画面名称与刷新
②	摘要行	投影 · 最后成功 · Dt 对象 · 已投影连接 —— 投影是否按时成功
③	最近执行	结束时间 · 批次 · 连续失败 · 分阶段结果 —— 定位哪个阶段失败
④	镜像中的内容	各项的来源与条数 —— 什么载入了多少

---

MCP 网关 — /mcp-gateway/

这是 AI 调用的所有 MCP 工具都要经过的关口。它汇集平台集成 MCP、本安装的 AI 服务（时序洞察 · RAG · 文档理解 · 视觉 · 数字主线 · 工程计算）以及运维人员接入的外部 MCP 服务器的工具，通过一个地址（plantpulse-mcp-gateway-api:7160/mcp/）对外提供。 副驾只看这一个地址，工具的启用与关闭也在这里进行（2026.10 再发布（2026-10-20） —— 此前是副驾管理控制台的**工具服务器（MCP）**画面）。

画面	地址	作用
概览	/mcp-gateway/	网关状态（数据库 · 嵌入 · 平台 MCP · MCP 服务器）、服务器摘要、过去 24 小时的调用 · 错误 · 延迟 p95 · 检索次数
服务器	/mcp-gateway/servers/	网关背后的服务器 —— 类型（平台 · 内置 · 外部）· 前缀 · 状态 · 已启用工具数 · 认证 · 熔断 · 最后发现。重新发现 · 启用/关闭，外部服务器的注册服务器 · 修改 · 认证 · 删除
工具	/mcp-gateway/tools/	已发现的全部工具 —— 公开名称 · 服务器 · 说明 · 检索词及其来源 · 状态 · 检索索引。逐个工具启用和关闭的地方，并可覆盖说明（4000 字）和检索词 → 工具检索词
权限	/mcp-gateway/permissions/	哪个调用方（副驾 · 每个已签发的密钥）能看到哪个服务器的工具
客户端 API 密钥	/mcp-gateway/client-keys/	给外部 MCP 客户端（其他智能体 · 桌面应用）的密钥（ppgw_…）签发 · 范围 · 作废
检索测试台	/mcp-gateway/search/	输入一个问题，查看网关会交给模型哪些工具 —— 分数 · 词汇排名 · 嵌入排名 · 选中理由
检索设置	/mcp-gateway/search-settings/	是否使用工具检索 · 预算（每轮提供的工具数）· 系列保障 · 依赖补全
调用记录·指标	/mcp-gateway/calls/	按服务器 · 错误统计的调用次数，以及每次调用的时间 · 调用方 · 服务器 · 工具 · 结果（成功 · 工具失败 · 传输失败）· 耗时 · 结果大小 → 调用记录

工具启用/关闭 —— 初始值由策略决定

工具首次被发现时，按网关策略以启用或关闭状态进入。此后保留在工具画面中改过的值，启动或版本升级都不会覆盖。

服务器	初始
平台集成 MCP	全部启用
时序洞察	34 种启用 · 4 种关闭 · 1 种写入工具无法启用
数字主线	9 种启用
工程计算	4 种启用
RAG · 文档理解 · 视觉	启用（2 · 2 · 5 种全部）—— 关闭文档检索 rag_search 后，聊天将找不到文档
外部服务器	关闭

各工具的列表见 MCP 工具地图。

• 有些工具无法启用 —— 疑似写入的工具（声明了 readOnlyHint=false，或名称 · 说明属于写入），以及非数字主线服务器发出的连接器工具（mes_ · erp_ …）。 平台工具网关不拦截；若是写入工具，由副驾的批准关口取得人的批准。
• 两个服务器发出相同的公开名称时，先注册的一方胜出，后来者以«冲突»状态不公开。请修改后来服务器的前缀。
• 覆盖的说明会同时改变模型读到的说明和检索索引。清空即恢复为原服务器的说明。

接入外部 MCP 服务器

1. 服务器 › 注册服务器 —— 名称 · Streamable HTTP 地址 · 工具前缀（小写字母 · 数字，以 _ 结尾，必填）· 调用超时上限（1~600 秒，默认 120）。 服务器创建时处于关闭状态，且未授权给任何人。
2. 需要认证时，在认证中填入头名称和值。值会被封存，不再显示（只显示«已设置»）。
3. 启用 → 重新发现。外部工具以关闭状态进入。🔴 外部工具的说明和参数会原样进入模型提示词， 请在工具画面中阅读后逐个启用。已启用的外部工具定义一旦改变，网关会关闭该工具并标记为需要重新查看。
4. 在权限中向副驾（或已签发的密钥）授权该服务器或工具。

• 外部工具以写入工具身份交给副驾 —— 副驾不会在没有人工批准的情况下调用。
• 地址解析为回环 · 链路本地 · 云元数据地址时无法接入。内网（10/8 · 172.16/12 · 192.168/16）可以。
• 平台 · 内置服务器由安装决定，因此只能关闭，不能修改 · 删除。
• 🔴 MES · ERP · PLM 等外部系统连接器不在这里接入，而是接入集成地图。

权限与客户端 API 密钥

• 内置服务器一开始就以所有工具授权给副驾。«所有工具»也包括之后才发现的工具。
• 新的外部服务器和新密钥创建时未授权任何内容。「一个工具都看不到」时，请先查看权限。
• 密钥原文只在签发时显示一次。列表中只保留前 12 个字符。作废立即生效。
• 密钥需要赋予范围（设备 · 站点 · 项目 · 客户 PO · 供应商）和等级。没有范围的密钥只能调用外部服务器工具， 内置工具按该范围 · 等级缩小读取。平台工具只有范围为整个安装的密钥才能调用（平台不按范围过滤）。
• 此密钥只用于 /mcp/。与通用菜单的 API 密钥是不同的画面。
• 外部 MCP 客户端接入的地址是 https://<호스트>/mcp/gateway/ → API 对接指南

工具检索 —— 默认启用，预算 20

不是每个问题都载入全部已启用的工具，而是只挑选与问题相符的交给副驾。初始值为启用 · 预算 20 · 系列保障启用 · 依赖补全启用。 按名称查找 ID 的 search_domains 与文档检索 rag_search 不受预算限制，始终载入（在该账户获准使用的情况下）。

• 在检索设置中关闭后，副驾会收到已授权的全部工具 —— 工具有 70 多种时，模型经常选错。 启用的标准是离线评估的召回率@20 达到 0.95 以上；低于标准仍要启用时，画面会发出警告（但不阻止）。
• 运维人员修改并保存的值优先 —— 升级版本也不会恢复为默认值。
• 🔴 检索依赖嵌入服务。嵌入服务宕机时检索返回 503 search_unavailable，且没有替代路径 —— 请查看概览中的«嵌入»。
• 检索测试台即使在检索关闭时也会给出排名。用于查看「这个问题为什么没调用这个工具」。

工具检索词 —— 将韩语问题连接到工具的词语

工具说明是英文的，因此「알람 확인 처리（报警确认处理）」这类韩语问题要靠检索词连接到工具。检索词只用于词语检索（BM25）， 不做嵌入，模型也看不到。在工具画面的说明栏下方，可以看到每个工具当前使用的检索词及其来源。

来源	含义
本安装覆盖	本安装的运维人员做了覆盖 —— 优先于下面三种
服务器声明	MCP 服务器随工具一起声明（时序洞察 · 数字主线 · 工程计算 · RAG · 文档理解 · 视觉）
网关默认值	网关为不声明检索词的服务器（平台集成 MCP）附加的值
无检索词	只按名称和说明建立索引

• 检索词不截断，全部显示。外部服务器声明的检索词，也请在启用前全部读一遍。
• 用检索词按钮修改**韩语（ko）**检索词，每行一个（或用逗号分隔）。其他语言的检索词保持不变，并一同显示在窗口中。
• 🔴 上限为每个工具4 种语言，所有语言合计 8 个 · 64 字。超出后保存按钮会被锁定。
• 未做修改时保存按钮也会被锁定 —— 以免服务器值的副本固化为覆盖，日后服务器改值时被遮住。
• 清空后保存，该工具即为«无韩语检索词»。窗口上方«本安装正在覆盖检索词»横条中的解除覆盖则会 回到服务器声明 · 网关默认值。两者是不同的按钮。
• 服务器给出的格式错误或超出上限的检索词，以及因超出上限而被丢弃的已保存覆盖，其原因会以警告行显示（被丢弃的值视为不存在，改用下一个来源）。 被丢弃的覆盖也用解除覆盖清除。
• 画面上方的搜索框同时按名称 · 说明 · 检索词筛选。已启用的外部工具的检索词发生变化时，网关会视为定义已变更并关闭该工具。

遇到这些情况

症状	查看
服务器状态为«宕机»	服务器的熔断（连续失败 3 次则 120 秒内不调用）与发现错误
外部服务器为«注意»，认证为«未设置»	已定好认证头但没有值 —— 在认证中重新填入
调用为 upstream_auth	该服务器返回了 401/403 —— 确认认证值
调用为 result_too_large	结果超过了 1 MiB
用已签发的密钥看不到任何工具	新密钥没有权限 —— 权限
用韩语提问时没有载入合适的工具	把该问题输入检索测试台查看排名，再在工具画面查看该工具的检索词与来源 → 工具检索词
调用为«工具失败»但服务器正常	后端已应答但结果为失败 —— 不看服务器，而看工具结果（参数 · 原始数据）→ 调用记录
已签发密钥的调用为 forbidden_scope	该密钥没有范围，或调用的是平台工具但范围不是整个安装 —— 客户端 API 密钥

调用记录 —— 工具失败与传输失败

调用记录·指标的结果有三种。错误数包含工具失败，旁边以«工具 N · 传输 N»分开显示。按服务器统计的表中也有工具失败列。

结果	含义
成功	工具已应答，结果也是成功
工具失败	后端服务器已应答，但结果为失败 —— isError、非空的 error、{"ok": false}、error_code 与 status: "error"（与副驾判定失败的规则相同）
传输失败	未能到达后端，或被网关拦截 —— 错误代码即原因

结果筛选为全部 · 成功 · 失败（全部） · 工具失败。「服务器好好的，回答却不对」时，请按工具失败筛选。

调用记录中不保留参数 · 结果 · 认证值。以人为单位的«谁问了什么»属于副驾的审计记录 → 副驾管理

---

自动化沙箱 — /sandbox/

这是运行自动化步骤中Python 代码（用 numpy · pandas · scipy 处理前一步骤的工具结果，并输出 JSON · 表格 · 图 · 文字）的服务的画面。 在导航栏中，它是与 MCP 网关分开的自动化沙箱。控制台只读 —— 运行由副驾已批准的自动化计划执行， 从控制台到沙箱的写入被拦截。

隔离是这样实现的

沙箱容器本身运行在 gVisor（runsc）之上，每次运行都在其中以新的命名空间（user · net · pid · mount）启动隔离的进程。 并不是每次运行都启动新的 gVisor。运行内部没有网络，无法调用工具或 REST，根文件系统为只读。

画面	地址	作用
概览	/sandbox/	隔离（gVisor 版本 · 平台 · 架构 · 网络，最后一次自检）、运行中 · 队列、按时段统计的运行 · 错误 · 退回、按结果代码的运行次数
运行历史	/sandbox/runs/	每次运行的接收时间 · 结果 · 错误代码 · 代码 SHA-256 · 大小 · 等待 · 耗时。展开可见输入 · 输出大小 · 限额 · 上下文。默认保留 30 天
上限	/sandbox/limits/	单次运行的限额（时间 · 内存，代码 · 输入 · 输出 · 表 · 图 · /tmp · 进程）、并发运行 · 等待限额、可 import 的包及其版本。这是沙箱实际施加的值

结果有成功 · 错误 · 退回三种。退回是未运行的请求，在运行历史中耗时为«—»。

代码	结果	含义
ok	成功	运行结束并返回了结果
syntax	错误	代码未能编译 —— 什么都没有运行
forbidden	错误	尝试了计算步骤不能做的事（网络 · 进程 · 原生代码 · /tmp 以外的文件）
timeout	错误	超出了墙钟或 CPU 限额
memory	错误	超出了内存限额
output_too_large	错误	输出 · 表 · 图 · /tmp 中有一项超出了上限
runtime	错误	其他异常，或未能把结果转换为 JSON
queue_full	退回	队列已满
queue_timeout	退回	等待空位的时间过长
sandbox_unavailable	退回	未能准备好隔离 —— 代码没有运行

• 🔴 这里没有代码原文。 沙箱不保留代码 · 输入 · 输出，只保留大小和代码 SHA-256。原文在具有相同哈希的副驾已批准计划中。
• sandbox_unavailable 不断累积，或概览中出现「隔离自检失败」时，说明隔离准备一直在失败。请查看概览 › 隔离中的运行时版本与最后一次自检，再查看沙箱的日志。
• 出现「运行记录未被保存」时，说明无法写入运行记录存储（PostgreSQL）。运行会继续，但这期间的运行不计入记录和数字。
• 通用菜单为 API 端点 · 日志 · API 密钥 · 设置。沙箱没有 MCP 服务器，因此没有 MCP 服务器信息。

---

通用菜单

这是 RAG API · 时序洞察 · 文档解析 · 视觉 · 数字主线 · MCP 网关这六个服务中完全相同的五个画面。 地址中的 <服务> 位置分别为 rag · insight · parser · vision · thread · mcp-gateway。图示为 RAG API 的。 自动化沙箱（sandbox）除 MCP 服务器信息 外的四个画面相同。

MCP 服务器信息 — /(服务)/mcp-info/

编号	位置	作用
①	画面顶部	该服务的 MCP 地址与摘要（工具 · 资源 · 提示词数量）—— 直接向服务查询并实时填充
②	工具表	AI 副驾可调用的工具列表 —— 工具 · 说明 · 参数。点击行可展开参数的类型 · 必需 · 默认值

下方依次是资源 · 提示词表。

工具数为 0 并不正常

一个工具都没有的 MCP 服务器，不应视为«没有工具»，而应视为读取列表失败。

API 端点 — /(服务)/api-endpoints/

编号	位置	作用
①	画面顶部	端点数量与说明 —— 由服务的 OpenAPI schema 生成
②	表	方法 · 路径 · 说明 · 领域 —— 供集成开发者查找要调用的 API

MCP 端点（POST /mcp）不在 OpenAPI schema 中 —— 请查看 MCP 服务器信息。

日志 — /(服务)/logs/

编号	位置	作用
①	画面顶部	自动 5 秒（开启后每 5 秒重新读取） · 刷新
②	标题行	正在读取的日志文件 · 大小 · 记录数 —— 文件是否为空或存在损坏行
③	日志 tail	日志文件的尾部，最新在最上 —— 时间 · 级别 · 事件 · 字段

可在画面上方按行数 · 级别 · 搜索词（Enter）缩小范围。无需通过 SSH 执行 docker logs。

API 密钥 — /(服务)/api-keys/

测量该服务的入站 API 密钥认证是否真的已启用。这不是查看密钥«值»的画面。

编号	位置	作用
①	画面顶部	画面名称与执行巡检 —— 仅在点击时才分别以不带密钥·带密钥各调用一次
②	摘要行	控制台密钥（控制台是否持有密钥及其指纹） · 认证（巡检结果） · 服务间共用（是否多个服务使用同一密钥）
③	往返测试（Round trip）	不带密钥 · 带密钥的响应码与判定 · 含义 —— 已关闭的服务会依次返回 401 与 200
④	接线（Wiring）	每个服务的控制台环境变量 · 服务环境变量 · 密钥 · 上游 —— 密钥以什么名称进入何处。点击指纹旁的眼睛图标可查看明文，该操作会连同用户名记入审计日志
⑤	表下方说明	调用方须以 X-API-Key 发送的密钥，以及控制台和服务各自以哪个环境变量持有它

判定	含义
已强制	拒绝不带密钥的调用并接受控制台的密钥 —— 正常
开放	不带密钥也会响应 —— 任何能触达该路径的人都可访问
未强制	控制台持有密钥，但服务不带密钥也会响应
密钥不匹配	服务已关闭，但拒绝控制台持有的密钥
控制台无密钥	服务已关闭，但控制台没有密钥
无法连接	服务未响应 —— 这不等于«通过»

仅打开画面并不会进行测量

这五个服务在入站密钥（PI_INBOUND_API_KEY）为空时会拒绝启动。例外仅限在安装 env 中 写入 PI_INBOUND_AUTH_DISABLED=true 有意关闭认证的情况，此时服务会在无密钥状态下启动 —— 容器显示 healthy，不会有任何信号。 因此需点击执行巡检来测量 —— 这样设计是为了避免仅打开画面就在服务端堆积 401。若不带密钥也会 响应（开放），会在表格之前先弹出警告框。巡检会有意发送一次无密钥请求，因此若有监控 401 的 告警，可能会被触发 → API 集成指南 —— 入站密钥

设置 — /(服务)/config/

编号	位置	作用
①	画面顶部	配置键数量与刷新
②	组件表	服务所使用的各组件的状态 · 端点 —— 查看哪个依赖断开了
③	配置表	当前生效的运行时配置键 · 值 —— 密码·令牌等敏感值会被遮蔽显示

设置不是用于修改的画面

它只展示数值，无法更改。若要实际修改，请参阅密码 · API 密钥变更与 服务运维。

---

遇到这些情况这样做

症状	先看哪里	然后
聊天机器人找不到文档	RAG API → 文档	用查询测试直接检索 → 同步历史
聊天机器人回答慢	LLM 仪表板的 P95	GPU 使用率·温度
模型不作答	LLM → 上游状态	LLM → 用聊天测试直接试一次
分析结果为空	时序洞察 → 流水线状态	执行历史中的失败项
后端是否无认证开放	对应服务 → API 密钥 → 执行巡检	密码 · API 密钥变更
画面显示 … rejected the console's inbound API key (401) - check <환경변수>	该服务的密钥与控制台持有的密钥不一致（错误原因 upstream_auth，502）	对应服务 → API 密钥的接线表 → 对齐消息中列出的环境变量并重启控制台
LLM 画面（API 密钥 · 日志 · 模型注册等）返回 502，原因 llm_upstream	网关（LiteLLM）或其数据库返回了 5xx。这不是控制台故障 —— upstream_status 是网关的状态码	docker compose logs plantpulse-litellm → 问题排查
集成地图显示「无法使用连接器注册表：503 … config_error …」	数字主线的注册表存储（DT_PG_*）或加密密钥（DT_SECRET_KEY）为空	请管理员配置。图镜像与此无关，仍会正常运行
图纸台账显示「图纸索引已关闭」	rag-api 的 DRAWING_INGEST_ENABLED 处于关闭状态（出厂默认）	在环境配置中开启并重启 rag-api
视频画面显示「视频·音频采集已关闭」 · 视频上传被拦截	安装 env 中的 PI_MEDIA_ENABLED 未开启（出厂默认关闭）	在环境配置中开启并重建技术栈
上传的视频长时间处于等待中	处于处理时间段之外 —— 视频画面的处理时间段行会显示下次启动时间	若要更改时间段请设置 MEDIA_PROCESSING_WINDOW → 环境配置
聊天不以视频作为依据	RAG API → 视频的转写为空 · 检索缺失	展开该行并按提示执行重新转写
图纸台账的版次状态全部为无法确认	没有可查询版次的 PLM 连接器，或其未响应	数字主线 → 集成地图中确认 PLM 连接器是否已启用 → 数字主线
班组长就绪度满屏«未知»	该项目的来源连接器未接入或数据陈旧	数字主线 → 集成地图 → 就绪度来源
主页出现黄灯	展开查看详情并确认提示框	对应服务 → 日志
主页出现红灯	对应服务 → 日志	服务运维中的重启步骤
画面空白并显示错误提示条	该服务可能尚未启动	在主页确认状态

服务密钥错误也不会导致退出登录

当服务拒绝控制台的密钥时，控制台不会将其视为登录过期，而是以一行错误提示（502，upstream_auth） 呈现。重新登录也无法解决，请检查消息中列出的环境变量。

「为空」与「未能取到」是两回事

控制台在未能取到数据时不会伪装成空表，而是弹出错误提示条。若看到错误 提示条，说明不是没有数据，而是连接未建立。

---

账户与会话

控制台账户不由数据库而由环境变量决定（/etc/kopens/plantpulse-ai.env）。

环境变量	含义	默认值
PI_ADMIN_USER	登录账号	admin
PI_ADMIN_PASSWORD	登录密码	无 —— 必须指定
PI_ADMIN_SESSION_SECRET	会话签名密钥	由安装程序生成
ADMIN_SESSION_MAX_AGE	登录保持时长（分钟）	480（8 小时）

在容器内部它们以 ADMIN_AUTH_USERNAME · ADMIN_AUTH_PASSWORD · ADMIN_SESSION_SECRET 的名称 出现，但这是 compose 将上述值搬运进去的，因此要修改的是 PI_* 这一侧。

没有密码则根本不会启动

若将 PI_ADMIN_PASSWORD 留空，控制台会拒绝启动。这是为了防止无认证的管理门户 被静默开放，属于正常行为。

若会话频繁失效

一旦 PI_ADMIN_SESSION_SECRET 发生变化，此前的登录会全部失效。保持安装程序生成的那个值 不变，重启后登录状态也会保持。

控制台密码无法通过 bin/passwd.sh 更改

bin/passwd.sh 所管理的密钥清单中不包含控制台账户 （请参阅密码 · API 密钥变更中的表格）。 若要更改，必须直接修改环境文件并重启服务。请向管理员 提出申请。

---

相关文档

• 服务端口映射表 —— 控制台地址及各服务开放的位置
• 服务运维 —— 启动·停止·重启步骤
• 密码 · API 密钥变更 —— 密钥轮换
• 日志与监控 —— 在服务器上直接查看日志时
• 数字主线 —— 集成地图·图镜像·就绪度来源的概念与连接器注册步骤
• 环境配置 —— 图纸索引 · 视频·音频采集开关（DRAWING_INGEST_ENABLED · PI_MEDIA_ENABLED）、处理时间段（MEDIA_PROCESSING_WINDOW）
• 视频检索 —— 已索引视频在聊天中的使用方式
• 副驾管理 —— 行动工具批准发生的一侧
• MCP 工具地图 —— 各服务器的工具与初始启用的工具