跳到主要内容

发行说明

2026.10 重新发布 — 2026-10-20 · LLM 模型 aura-lite · 界面术语 «事件» · MCP 网关​

兼容性中断 — 必须修改外部 API 调用中的 model 值

LLM 模型名称由 aura-35b → aura-lite 变更。旧名称不保留别名，因此以 aura-35b 调用将返回 404。 直接调用网关（LiteLLM）的外部集成，请将请求中的 "model": "aura-35b" 改为 "aura-lite" → API 集成指南

本手册以此版本为准书写 aura-lite。升级到本版本之前的安装仍为 aura-35b。

LLM 模型 — aura-35b → aura-lite​

  • 不只是名称变更，模型本身也更换了 — 由 AURA-Lite（MoE · 上下文 256K · 兼容图像输入）替代 AURA-35B 运行。
  • 权重目录名也由 Aura-35B-A3B-NVFP4 → Aura-Lite-NVFP4 变更（/opt/kopens/models/Aura-Lite-NVFP4，捆绑模型文件 Aura-Lite-NVFP4.tar.zst）。
  • 安装 · bin/update.sh 会重新下载 Aura-Lite-NVFP4.tar.zst（与 SHA256SUMS 校验，若无法下载则在该步骤停止）。
  • 隔离网络需在可联网设备上通过 MODELS="Aura-Lite-NVFP4 …" 下载后导入 — 捆绑包构建不会下载模型 → 隔离网络安装
  • vLLM 升级到 v0.31.0，启动参数（LLM_MODEL_ARGS）改为适配新模型的解析器（gemma4）。
  • 旧的 Aura-35B-A3B-NVFP4 目录不再使用 — 确认新版本已启动后即可删除。
  • aura-vision · aura-embedding-4b · aura-reranker-0.6b 保持不变。
  • Copilot · 管理控制台 · 文档检索 · 视觉 · 文档理解在 bin/update.sh 之后会自动使用新名称 — Copilot 在启动时会将 DB 中保存的模型名称对齐到接线配置。

界面术语变更 — 故障受理 → 事件​

  • Copilot 界面的 «故障受理» 变为 «事件»（英文界面为 «Incident»）。因为它不仅由故障触发，也会由报警 · 异常信号开启 → 异常检测 · 事件响应
  • 代码 · API · 配置键 · DB 中的名称（incident）保持不变。集成无需修改。
  • 指代实际故障的说法（设备故障 · 故障前兆 · 状态 FAULT）仍为 «故障»。

工具管理 — Copilot «工具服务器（MCP）» → AI 管理控制台 «MCP 网关»​

  • Copilot 管理控制台的 工具服务器（MCP）（/admin/mcp）将被移除。 MCP 服务器注册 · 工具启用/关闭 · 连接确认由新服务 MCP 网关（plantpulse-mcp-gateway-api，内部 7160）负责，界面为 AI 管理控制台 › MCP 网关 → MCP 网关
  • Copilot 不再直接接入 MCP 服务器，只看网关这一个地址。批准关口 · 以人为单位的审计记录保留在 Copilot 中。
  • 🔴 初始启用的工具变多 — 时序洞察 34 种 · 数字主线 9 种 · 工程计算 4 种 · RAG 2 种 · 文档理解 2 种 · 视觉 5 种 · 平台全部。只有外部服务器保持关闭 → MCP 工具地图
  • 工具检索默认开启（预算 20）— 每个问题只挑选相符的工具载入模型。
  • 聊天的文档检索只走网关的 rag_search 这一条路（Copilot 内置的文档检索将被移除）。网关无应答或 rag_search 关闭时，对手册 · 图纸 · 规程类问题不生成答案，而是告知原因 → RAG
  • 在 AI 管理控制台 › MCP 网关 › 工具 中可查看并覆盖每个工具的检索词。调用记录会分开显示并筛选«工具失败»与«传输失败» → MCP 网关
  • 数字主线新增两个工具 — thread_impact_range（延迟的 PO · 不良批次波及到哪里）· thread_interval_production（异常区间内在生产什么）。

事件 · 建议 · 自动化​

  • 在聊天中插入文件 — 通过提问输入框的插入文件 · 拖放 · 粘贴上传 PDF · Excel（xlsx · xls · csv） · Word · PowerPoint · DXF 图纸 · TIFF 扫描件，在该对话中直接提问。每个文件 50MB，每个对话 20 个，读取前 100 页。视频（mp4 · mov · mkv · webm） · 音频（m4a · mp3 · wav）也可放入，最大 1GB · 60 分钟 —— 依据转写的语音 · 字幕回答，回答中写出的时刻会成为播放该场景的依据卡片（5 分钟 · 200MB 以下立即转写，更长的在后台转写，完成后通知。仅限开启了部署开关 PI_MEDIA_ENABLED 的部署）。仅对话所有者可见并可播放，删除对话时一并删除，不会进入公司文档库（RAG） → 提问 — 插入文件
  • 处理方案审核 — 在等待批准的事件的«建议»卡片中选择批准处理方案 · 修改后批准 · 拒绝。拒绝时选择原因（诊断错误 · 并非异常（误报）等六种）并关闭该事件 → 提案 — 处理方案审核
  • 通知接收人 — 只有当符合 管理 › 负责人 中通知角色（维护 · 运营 · 安全）与负责范围（站点 · 设备）的人恰好只有一位时才自动确定，否则由执行人选择。没有 SMTP 的安装会附带原因阻止«通知负责人» → 提案 — 执行措施
  • 运营概况 — 在 管理 › AI › 运营概况（/admin/ops-stats）中查看最近 7 · 30 · 90 天的使用 · 建议 · 事件 · 自动化 → Copilot 管理
  • 诊断准确度 — 按模型分组改为以实际作答的模型为准，原因在每个事件中只计一次。
  • 自动化轮次 — 因服务器重启而中断的轮次保留为**«已中断»**（无报告 · 无发送，不会续跑）。业务型自动化的产出物保存失败会在轮次结果中以警告显示，发送状态准确记录为«已发送» → 自动化
  • 自动化报告标题 — 报告 · 执行记录 · PDF · Excel · 邮件 · 通知 · 消息的标题改为«自动化名称 · 轮次时间»（工厂时区），模型撰写的标题成为副标题。代码生成的报告文字遵循安装语言（PP_LANG） → 自动化 — 报告的标题
  • 自动化«全部»标签页 — 关闭 · 开启 · 删除按钮移到了卡片内的底部一行（删除需确认）。
  • 视频场景标签 — 标签上的时间与播放起点不再是区间的开头，而是命中的场景 → 视频 RAG
  • 数字主线依据面板 — 点击节点可查看此对象的历史（30 天，可查看之前 30 天）与原系统的当前值；若管理员为连接器设置了链接模板，还可打开原系统画面 → 数字主线
  • 自动化沙箱 — AI 管理控制台中新增单独的导航项，可查看运行历史 · 上限 → 自动化沙箱

本版本中的其他内容​

  • 思考模式默认开启 — compose 中 CO_LLM_THINKING_ENABLED 的默认值变为 true（AURA-Lite 留空则不会思考）→ 环境变量设置
  • 选择 «思考程度» — 通过提问输入框的大脑图标选择关闭 · 低 · 中 · 高，管理员可在 管理 › 系统设置 中分别为聊天 · 自动化 · 异常诊断 · 执行建议设定默认值 → 提问 — 思考程度
  • 会话地址 — 新会话为 /chat/new，已打开的会话为 /chat/<id>。旧的 /chat?session=<id> 不再受理 → 提问 — 会话地址
  • 工程计算 MCP — 新服务 plantpulse-engcalc-api 与四个工具（eng_list_formulas · eng_formula · eng_unit_convert · eng_calc_eval）。可连同单位 · 代入步骤 · 出处计算 29 种公式 → MCP 工具地图
  • 安装默认语言 ko — env 模板中的 PP_LANG 为 ko。取值只有 ko · en 两种，为空或为其他值时服务不会启动 → 环境变量设置
  • vLLM v0.31.0（生成 · 嵌入 · 重排 · 转录）
  • 数字主线连接器最低版本 — mes-mcp/0.7 · erp-mcp/0.4 · ehs-mcp/0.3 · 其余 0.2；声明版本低于该要求的连接器不参与同步 · 判定。升级后需重新执行 工具发现 → 适配性 → 启用（bin/reregister-connectors.sh）→ 数字主线连接器

升级时​

  • 若主机 env 中存在 LLM_NAME · LLM_MODEL_PATH · LLM_MODEL_ARGS 行，请删除。 若为旧值则新模型无法启动；若与新默认值相同，启动前判定会以 redundant 阻止启动。
  • Copilot 的旧工具表（mcp_server · mcp_tool_pref · mcp_tool_call_log）会在启动时被删除。旧版中启用和关闭的值不会迁移，而是按网关策略重新开始。 若有特意关闭的工具，请在升级后于 MCP 网关 › 工具 中重新关闭。直接接入 Copilot 的外部 MCP 服务器需在网关的 服务器 中重新注册并重新填写认证值。

2026.10 重新发布 8 — 2026-10-13 · Copilot 界面全面改版​

这是以相同 2026.10 标签重新发布的捆绑包。Copilot 的界面整体更换 — 数据 · 权限 · 设置照常保留。 已升级到 2026.10 的安装以 bin/update.sh 获取。其中也包含管理控制台 · 洞察 · 文档检索（RAG）· 视觉 · 数字主线 · 文档理解 · 代理的修复。

旧界面在本版本中移除

升级到本版本后，Copilot 只提供新界面。没有回退到旧界面的开关 — 升级前请阅读下文的 «移除的界面与旧地址» 和 «升级时»。

定位 — 现场判断应用​

它是«发现工厂问题并给出带依据的建议，由人审批闭环，不清楚就提问，重复性工作交给自动化的现场判断应用»。 它不是 MES · ERP · BI 仪表板 · 聊天机器人 · 作业者执行终端。本定位取代重新发布 7 的«车间 AI 助手 · 六个菜单»。

三种用法 — 提问 · 建议 · 自动化​

  • 侧边栏 — 自上而下为 新会话 · 建议 · 自动化，其下为最近会话（可搜索），最底部为个人资料菜单（设置 · 管理 · 审计 · 帮助 · 主题 · 退出），顶部为通知铃。 没有单独的 «提问» 项 — 新会话与首次打开的界面即为提问。界面为无彩色，颜色仅用于状态点 → 界面地图
  • 提问（首屏）— 问候语 · 输入框 · 今日事项 · 问题标签。«今日事项» 以「今日事项 N 件」折叠为一行，点击展开（无事项时不显示该行）。 回答正文中的表格置于圆角边框容器内，回答中的颜色标记以状态点呈现 → 提问
  • 建议 — 待办 · 进行中 · 已完成。计划（执行建议）与突发（待确认异常 · 故障受理）同列一个列表，在同一详情页完成 检测 · 受理 → 审批 → 处置 → 结果 → 复发验证的闭环。«解决» 菜单已移除 → 建议
  • 自动化（原 «智能体构建器»）— 用自然语言创建 · 试运行 · 共享 · 执行记录 · 报表 · 版本历史与回滚 → 自动化
  • 设置与个人信息合并为一个界面（/settings）。
  • 首次访问者按浏览器语言显示（非韩语 · 英语时使用安装默认语言），登录前打开的地址在登录后会返回该界面。不存在的地址提示「未找到该页面」。

右侧面板与图纸查看器​

  • 文档原文 · 图纸 · 视频均在同一右侧面板中打开。可在保留会话或建议详情的同时在旁查看，拖动边缘调整宽度。
  • 建议的依据也以面板方式打开。它叠加在详情之上，通过标题栏的返回回到详情。
  • 屏幕过窄无法并排时，面板以覆盖正文的抽屉形式打开；在手机上以全屏打开。
  • 图纸查看器 — 点击图纸卡片会在面板中打开预览，通过 在查看器中打开（新标签页） 打开新标签页查看器：放大 · 缩小、页面列表、版本比对（并排 · 叠加，标出差异处）， 在图纸上拖拽框选后 按此区域提问 → 用图纸提问

自动化 — 接收方与模板​

  • 发送 — 结果可通过 应用通知 · 企业邮件 · 消息频道（Teams · Slack）接收。收件人只能从公司内用户 · 角色中选择，不填写地址。 接收方在创建时即固定，运行过程中 AI 无法更改。
  • 附件 — 邮件可附带 Excel · CSV。PDF 仅在配置了 PDF 转换服务（CO_GOTENBERG_URL）的安装中可选，否则在界面上显示为禁用。
  • 发送上限 — 单个自动化对同一人每天 6 封邮件、单个频道每天 12 条消息、按角色选取的收件人最多 50 人（可在系统设置中调整）。相同内容当天不重复发送。
  • 审批动作 — 自动化可在卡片中建议的动作增加到五种（维修申请草稿 · 催交采购订单草稿 · 作业指令草稿 · 提交建议 · 提交故障受理）。全部需由人在卡片上审批后才会发出。
  • 14 个模板 — 新增 条件监视（「超过…就通知我」）· 未结故障受理催办 · 图纸改版通知。依赖数字主线的三个模板 （交期风险 PO · 质量异常追溯 · 图纸改版通知）仅在具备相应工具时才出现在模板库中。
  • 用自然语言创建 · 试运行 · 立即执行都在后台运行，界面会显示「执行中…」直至完成。请求过多时会提示稍后重试。

提问 · 自动化 · 管理的其他变化​

  • 提问 — 使用工具期间会显示步骤（思考中 → 工具执行中 → 整理回答），文本在工具结束后流式输出。停止响应会连服务器端生成一并停止。 新增重新生成，依据卡片中只保留回答实际使用过的工具结果。同一会话中必须等一个回答结束才能发送下一个问题。
  • 自动化 — «条件监视» 在未触及条件时不会调用 AI 模型，周期最短可设为 5 分钟。模板的接收方默认为 «我 + 应用通知»，角色 · 邮件 · 消息需自行选择。 应用通知会保留在通知列表和铃铛中。管理员 · 厂长可见全部标签页（关闭 · 删除仅限管理员）。
  • 建议 — 已完成标签页中一并显示已关闭的计划卡片；两人同时处理同一卡片时，会提示「已有他人先行处理」并重新加载列表。
  • 管理 — 系统设置中始终显示已知配置键及其名称 · 说明 · 默认值，并可恢复默认值。审计日志支持查看原文。
  • PDF 下载 · 附件仅在安装的 PDF 转换服务有响应时启用。
  • 回答的工具行 — 展开后只显示工具名称 · 耗时 · 条数。工具的原始结果仅对管理员以折叠方式显示。
  • 图表标题说明 — 标注的不是所问的时间范围，而是实际绘制数据的时间范围与条数；数据被截断时追加「仅部分」。
  • 文档引用片段 — 为原文中的句子或表格中的一行。表格的一行以单元格连接而成的一行文本显示。
  • 删除会话会连同问题 · 回答 · 工具执行的原文一并删除（已审批的动作卡片与审计记录保留）。
  • 自动化 — 未试运行过的自动化，其立即执行按钮为禁用并显示原因。点击应用通知会打开该次运行产出的报表 · 建议卡片 · 执行记录； 删除自动化时，该自动化发出的应用通知也会一并删除。范围内的设备与监视标签以名称显示。

名称变更​

旧名称新名称
事故（Incident）故障受理
智能体 · 智能体构建器自动化

API 路径 · 配置键 · 审计记录中的名称（incident · agent）保持不变。

移除的界面与旧地址​

今日 · 异常诊断 · 解决 · 报表 · 仪表板 · 网络 · 预测 · 主线界面与移动专用版（/m）、聊天的角色标签页 · 上下文标签已移除。 🔴 旧地址不会跳转到新位置。 书签 · 旧邮件 · 推送中的旧链接会显示「未找到该页面」→ 旧地址

  • 原先在仪表板 · 预测 · 主线中查看的内容，在提问中提问即可得到同样的回答（工具保持不变）。
  • 🔴 监视（Watch）已移除。 不仅界面，运行监视的执行器 · API 也一并移除 — 需要持续盯防的内容请用自动化创建（模板 «条件监视»）→ 自动化
  • AI 准确率数值请在管理控制台的 准确率调优 · 回答质量 中查看 → AI 发现与准确率
  • 数字主线为可选集成。没有专用界面，接通后提问 · 自动化的工具与建议的依据会随之增加 → 数字主线

管理控制台​

界面重新编排为四组（人员与权限 · AI · 运维 · 记录）→ Copilot 管理控制台

  • 通知渠道（新界面，/admin/channels）— 注册自动化要发送的 Teams · Slack 频道，并设定邮件允许域名。🔴 域名为空时自动化邮件处于关闭状态。
  • 用户编辑 — 在一个界面中设定我的业务 · 打开管理控制台 · 角色组 · 数据范围 · 查阅等级 · 组有效期 · 期间委派（代理）· 合作商到期日 · 关联 Platform 用户 → 权限 — 赋予人员
  • 品牌（新界面）— 客户名称 · 标签页标题 · Logo · Favicon · CI 配色 · 登录界面 · 联系方式 · 邮件显示名。
  • 角色组编辑中不再显示旧的报表权限（menu:report）— 因为新界面中它不再限制任何内容。
  • 会话管理 · AI 使用统计 · 执行日志 · 系统监视 · 通知栏界面已移除。窄屏下管理表格的部分列会折叠。

运维​

  • 登录会话保存在会话存储中。 在之前的版本中，会话仅存在于 Copilot 内存里，每次重启 · 重新部署都会导致全员退出。自本版本起会保持 — 但升级到本版本的这一次需要重新登录。
  • 管理控制台在升级后也需重新登录一次 — 管理控制台的会话格式已变更，升级前的登录状态不会延续。
  • 代理会压缩响应（gzip）并添加安全头。无需人工干预。
  • 指标 — GET /actuator/prometheus（Prometheus 格式）。🔴 **仅可通过 API 密钥（X-API-Key）**访问 — 使用登录会话时即便管理员也无法访问（403），无密钥则为 401。 该密钥与公开 API（/api/v1）所用密钥相同 → 日志与监控
  • 日志改为单行 JSON（容器日志与文件 /app/logs/system.log 均是）。密码 · 令牌 · 密钥 · 邮箱的前缀部分做掩码后保留。 如有抓取旧文本格式的采集规则，请予以修改。
  • PDF 转换服务（Gotenberg）作为仅在栈内使用的容器一同启动（不对外开放端口）。它是可选的 — CO_GOTENBERG_URL 为空时仅关闭 PDF 下载 · PDF 附件，其余不受影响 → 环境配置

升级时​

项目操作
界面无需额外开启。升级后即为新界面，且无法回退到旧界面
登录升级后所有人需重新登录一次 — Copilot 与管理控制台均是
书签 · 旧链接旧界面地址会以「未找到该页面」结束。公司门户 · Wiki 上的链接请改为新地址（/chat · /tasks · /automations）
已创建的监视🔴 升级后不再运行。 监视的表不会删除而是原样保留，但不会自动迁移为自动化 — 需要持续盯防的内容请用同样的语句重新创建自动化。监视此前已提交的故障受理仍保留在建议中
自动化邮件如需使用，请在管理控制台 › 通知渠道 中填写邮件允许域名（为空则关闭）。邮件服务器配置见系统设置的 smtp.*
权限 · 组无需变更。没有新增权限

打开方式​

Web 浏览器 · 主屏应用（PWA）· Windows 桌面应用 → 打开 Copilot

2026.10 重新发布 7 — 2026-10-09​

这是以相同 2026.10 标签重新发布的捆绑包。端口不变，新表（智能体）在启动时自动创建。已升级到 2026.10 的 安装只需以 bin/update.sh 获取 — 无需手工操作。

Copilot — 车间 AI 助手​

  • 六个菜单 — 今日 · 执行建议 · 异常诊断 · 解决 · 报表 · 提问。工作进入的入口有两个（计划 = 执行建议，突发 = 异常诊断）， 两者都在 解决 这一个列表中完成 指派 → 处置 → 结果 → 复发验证 的闭环。导航栏图标下方附有简称。
  • 异常诊断 — 将待确认异常按设备逐一以卡片呈现，每张卡片各有一个 确认 → 转为事故 · 忽略 按钮。此前的异常检测表格 已移至运维控制台。
  • 今日（首页） — 当前最紧急事项横幅 · 指标磁贴 · 执行建议 / 异常诊断发现 / 解决 7 日趋势 · 紧急列表。角色卡片置于下方折叠区。
  • 报表 — 三个标签页（概览 · AI 准确率 · 统计）。AI 准确率界面成为报表的一个标签页。
  • 工厂现况 · 监视 · 关联分析 · 预测 · 数字主线已从菜单移除，但仍可通过地址和链接打开。周报简报界面已移除 （/briefing → 首页），/incidents → 解决，/accuracy → 报表 › AI 准确率。
  • 手机底部栏与移动应用同样为五格（今日 · 建议 · 诊断 · 解决 · 提问）。

→ Copilot 界面地图

Copilot — 智能体构建器​

  • 用一句话描述，AI 便生成五个要素（何时 · 何处 · 用什么 · 如何 · 发往何处）的草稿，预览确认后启用。 结果以执行建议卡片输出。三个模板 — 早班交接简报 · 重复故障原因 · 物料 PO 延迟。
  • 仅在创建者的权限 · 范围内使用只读工具。由厂长 · 管理员（权限 «创建 · 管理智能体»）创建。

→ 智能体构建器

行为变更 — 五个角色​

  • 管理界面中默认显示的角色组为 作业者 · 班长 · 维修 · 厂长 · 管理员 五个。其余八个位于高级角色折叠区内， 权限 · 已关联人员保持不变。
  • 精简了现场各组的默认菜单 — 作业者为 今日 · 执行建议 · 解决 · 提问，维修在此基础上增加异常诊断。启动时仅对保持此前默认值的组 变更一次，管理员已修改的组保持不变。审计记录中记为 «系统（迁移）»。
  • 事故处置的 «执行» 收紧为新权限 «执行事故处置» — 默认为班长 · 维修 · 厂长 · 管理员。作业者 · 质量不再可执行。

行为变更 — 双人审批 · 代理 · 合作商账号​

  • 提问者不能审批自己的聊天动作卡片。 需由其他具备审批权限的人在执行建议左侧的待审批中审批 · 驳回。
  • 物料催办申请需两名不同人员审批后才发送（设置 access.two_person.tools）。维修申请仍为单人审批。
  • 期间委派 — 在用户编辑中可将他人的角色组按日期出借。每个组都可设定有效期。
  • 合作商账号 — 合作商组仅限范围 supplier:、必须设置到期日、不可设受控等级。到期后会话即断开。

→ 双人审批 · 代理 · 合作商账号

修复内容​

  • 语音提问 — 录音条浮于输入框上方，按钮不再移位，可用条上的停止录音停止。麦克风按钮与发送按钮大小一致。
  • 权限界面 — 文档等级的等级选择框可见，用户编辑窗口的输入宽度正确，审计表的类型 · 内容按界面语言显示。
  • 界面标题（标题 · 副标题）统一为一套规则。

运维​

2026.10 重新发布 6 — 2026-10-08​

这是以相同 2026.10 标签重新发布的捆绑包。端口不变，DB 表在启动时自动创建。已升级到 2026.10 的 安装只需以 bin/update.sh 获取 — 无需手工操作。

Copilot — 权限​

  • 角色组 — 权限附着于组而非个人。管理员控制台 › 角色组 中有 13 个默认组（管理员 · 作业者 · 班长 · 维修 · 质量 · 厂长 · 设计 · 采购 · 生产管理 · EHS · 合作商 · 审计 · 外部 API），每人可关联多个。
  • 数据范围 — 为每人指定站点 · 产线 · 设备（或项目 · 客户 PO · 合作商）后，在界面 · 聊天 · 文档回答 · API 中 都只能看到该范围。
  • 文档等级 — 普通 · 内部 · 机密 · 受控。在管理员控制台 › 文档等级 中指定，并为每人设定查阅等级。机密图纸页的 预览会打上查看者 · 时间水印，受控文档不可下载原件且查阅行为会被记录。
  • 审计界面（/audit）— 可按期间 · 用户 · 类型筛选设置 · 权限变更与机密 · 受控文档的查阅记录，并导出 CSV。
  • 升级后行为不变。 现有用户会迁移为对应业务角色的组（管理员还会加上管理员组）· 范围为全部 · 查阅等级为机密。 唯一变化的是受控文档 — 必须为每人指定查阅等级为受控才能打开。

→ 权限 — 角色组 · 数据范围 · 文档等级

行为变更 — 外部集成仅限 API 密钥​

外部集成地址 /api/v1/** 与 /mcp 现在**仅可通过 API 密钥（X-API-Key）**访问。以已登录的浏览器会话调用将返回 403。以 API 密钥集成的外部系统照常工作。

运维​

  • 新增环境变量 PI_USER_CONTEXT_MODE（off · log · enforce，默认 off）— 用于设定后端如何处理不带用户信息的调用。 无需写入 .env。填入未知值时安装检查（lint-env）会阻止 → 运维 — 后端用户信息校验模式
  • 对已指定文档等级或已限定范围的用户，文档回答需基于过滤后的依据生成，可能略有延迟。
  • 修复了审计日志查询返回 500、无权查看的图纸预览会断开连接（现为 «不存在» 404）的问题。
  • 为时序洞察增加了连接超时，避免在 Platform DB 停止时长时间挂起。

→ 准确率已按本版本的公开流水线数值更新 — 准确率 · 基准

2026.10 重新发布 5 — 2026-10-07​

这是以相同 2026.10 标签重新发布的捆绑包。端口 · DB 迁移 · 环境变量与重新发布 4 相同。已升级到 2026.10 的 安装以 bin/update.sh 获取即可。

Copilot — 聊天动作卡片​

  • «零件延迟 N 天怎么办» 类问题会先调用恢复计算而非文档检索。恢复计算若建议催办，回答下方会附上 物料催办 动作卡片，正文不再给出催办文案，而是提示「可在下方卡片中审批草稿」。
  • 新卡片 维修申请 — 回答中存在未关闭的故障风险发现时，会附上 MES 维修申请草稿卡片。由班长 · 维修 · 厂长 · 管理员 审批（待办 › 执行建议中的建议卡片仍仅限管理员）。仅当 MES 连接器提供维修申请工具时出现。

→ AI Chat Web — 动作卡片 · 用户权限与业务角色

Copilot — 图纸​

  • 聊天图纸卡片改为按图号 · 版本各一张。同一版本的 DXF · PDF 原先分成不同卡片，现已合并，卡片上标注「N 个文件」， 点击以代表文件（存在 DXF 时为 DXF）打开。管理控制台的图纸台账同样按此规则在一行中显示文件标签。
  • 询问「○ 版与 ○ 版的差异」时，不再回答 «无法比较»，而是给出版本比对结果（标题栏 · 尺寸 · 部件表 · 注记变更）。
  • 版本比对列表中的公差改为以自然语言显示而非 JSON 原文，标题栏项目以韩语显示。

→ 用图纸提问 · 管理控制台 — 图纸台账

Copilot — 界面 · 回答​

  • 班长起始界面的今日作业列表改为在卡片内滚动 — 即使工序有 12 行，首个问题与示例问题也能在首屏看到。
  • 「今天有什么作业？」表格下方的尾注只有一条（「另 N 件」或「M 行中仅显示 N 行」）。修复了两个数字互相矛盾的问题。
  • 修复了回答中直接显示 ** 的问题（强调结尾接助词时）。
  • 修复了管理控制台视频列表中 «无语音» 下方重叠显示英文 «no speech» 的问题。

运维​

  • Platform DB 连接中断后恢复时，Copilot 会自行恢复。超过 5 分钟仍无法建立连接时，容器会自行重启。
  • 预测（insight）在缺测较多的设备上改为回答**「数据不足」**而非报错。

2026.10 重新发布 4 — 2026-10-06​

这是相同 2026.10 标签的最终公开捆绑包。端口 · DB 迁移 · 环境变量与重新发布 3 相同。已升级到 2026.10 的 安装以 bin/update.sh 获取即可。

Copilot — 班长 «今日作业»​

  • 卡片中的工序状态 · Platform 订单状态不再显示代码（in_progress · planned · START …），而是显示中文标签（计划 · 进行中 · 运行中 …）。Platform 订单简写为「订单设备开始时刻」。
  • 客户 PO 的余量改为 「计划余量 N 天」 — 以作业指令计划结束为准，因此不含零件延迟。计入零件延迟的数值 以「（含延迟）」显示在恢复计算的受影响客户 PO表中。
  • 修复了「今天有什么作业？」的回答中出现两次表格的问题 — 仅保留服务器生成的今日作业表一张，并在该表中 新增受阻原因列。列名为客户 PO 计划余量。
  • 数字主线会通过 Platform 订单列表中的外部订单号，将 Platform 上运行的订单关联到工序。

→ AI Chat Web — 班长卡片 · 数字主线

Copilot — 聊天回答​

  • 视频 · 语音卡片即使聊天回答正文中未编号也会显示（会折叠的仅为文档 · 图纸卡片）。新会话的首个问题 会按用户所写的原句检索文档 → 用视频 · 语音提问
  • 公差类问题（「Ø35 H7 的公差范围？」）的回答会以图纸尺寸表的上 · 下偏差开头 — 此前版本中存在已取得数值 却回答 «无法确认» 的情况 → 用图纸提问
  • «零件延迟 N 天怎么办» 这类 what-if 问题一律以恢复计算作答，并按问题中的假设（零件 · 天数）计算。回答会同时 说明假设与当前延迟。
  • 模型因重复同一内容而中断时会重写一次，仍失败则连同出处卡片展示文档检索结果。

Copilot — 界面​

  • 修复了英文界面中菜单 · 标题直接显示文案键（nav.main.today 等）的缺陷。
  • 待验证（/review）的提示改为「业务角色由管理员在用户管理中修改」（此前为 «在个人资料中»）。
  • 用户编辑窗口新增副标题「修改用户信息与业务角色」，并修复了双列输入框溢出窗口的问题。
  • 横向滚动条变得与纵向一样纤细，右上角通知（Toast）的关闭按钮可在原位点击。

RAG · 视频​

  • 在管理控制台文档表中可对 Platform 台账图纸执行 «从语料中排除 / 重新纳入»。手工上传的图纸仍不可排除， 按钮的气泡提示会说明原因。图纸 409 的文案也按对象（手工图纸 · 台账图纸）作了区分 → 管理员控制台 · 故障排除
  • 修复了转录丢弃静音 · 噪声之后首句的问题，并将保留句子的时间戳前移至实际语音处。已转录的视频 不会自动重做 — 在管理控制台视频中执行重新转录，将在处理时间段（留空则为 20:00-06:00）重新听写。

2026.10 重新发布 3 — 2026-10-06​

这是重新构建的相同 2026.10 标签。端口与 DB 迁移未变，新表 · 新列在启动时自动创建。已升级到 2026.10 的安装以 bin/update.sh 获取即可。

重新获取前须知
  • 若曾在主机 env 中手工写入 MEDIA_INGEST_ENABLED · ASR_URL 来开启视频 · 语音，直接升级也不会中断 — 旧名称在本次发布期间作为别名保留，运维脚本首次运行时会迁移为 PI_MEDIA_ENABLED。启动前判定的 [warn] 会列出需要清理的 sed。别名将在 2026.11 移除。
  • 将 ERP 连接器升级到 erp-mcp/0.3 后工具列表会变化，重新发现时连接器会被禁用。请重新运行适配性测试 后再启用 → 数字主线

视频 · 语音 — 现已可启用​

  • 主机 env 中的一行 PI_MEDIA_ENABLED=true 会启动转录服务，使 rag-api 接收视频 · 语音，文档理解开放转录 入口，并让 bin/fetch-models.sh 下载转录模型 Aura-ASR-Turbo（约 1.5 GB）。默认为关闭。
  • 新增一次性服务 plantpulse-asr-audio，用于向转录服务迁移音频库 — 这修复了此前版本中转录服务 停留在 unhealthy 的原因。«Exited (0)» 为正常，bin/status.sh 也按正常计数（启用的安装为 23/23）。
  • 聊天中的语音提问在启用的安装中同样可用。
  • 新增管理控制台 RAG › 索引 › 视频 界面（上传视频 · 处理状态 · 转录 · 重试）。未启用的安装仅提示启用方法。
  • 隔离网络环境下镜像始终随捆绑包提供，仅需以 PI_MEDIA_ENABLED=true MODEL_BASE=… bin/fetch-models.sh 下载转录模型后迁移。
  • 将 MEDIA_PROCESSING_WINDOW 留空则仅在 20:00-06:00（PP_TZ）开始处理。若要始终处理，设为 always。

→ 视频 · 语音采集 · 视频 · 语音检索 · 隔离网络安装

安装 · 配置​

  • 入站密钥为空时的中止点已从 compose 移至启动前判定（[fail] PI_INBOUND_API_KEY is empty …）。新增仅用于开发 · 测试的 免认证开关 PI_INBOUND_AUTH_DISABLED（默认 false），存在密钥时该开关被忽略。
  • 新增可调项（保持默认即正常）— RAG_S3_BUCKET（rag-api 存储桶，默认 plantpulse-rag）· 数字主线连接器 周期同步 DT_CONNECTOR_SYNC_ENABLED（默认开启）· DT_CONNECTOR_SYNC_INTERVAL_S · DT_CONNECTOR_MAX_AGE · DT_LINK_HISTORY_DAYS。
  • bin/doctor.sh 会将旧名称 · 重复行单列为 «old or redundant lines» 而非 «bad»。
  • 自研镜像增至十三个（新增 pi/plantpulse-asr-audio），docling-serve 为 v1.36.0。bin/backup.sh 不再挂载转录 音频库卷。

→ 环境变量设置 · 服务运维

Copilot — 界面​

  • 左侧导航顺序改为 今日 · 向 AI 提问 · 现场 · 待办 · 解决 · 报表，移动端底栏改为 今日 · 向 AI 提问 · 现场 · 待办。「现场」的标签页顺序为 关联分析 · 预测。
  • 业务角色仅管理员可修改（每次修改都会记入审计日志）。个人资料中的「我的业务」变为只读，取而代之新增了 由本人选择的**「起始界面」**。
  • 聊天起始界面的班长标签页改为**「今日作业」** — 按今日各工序显示就绪度 · 设备状态 · 客户 PO 余量 · 物料 PO · 图纸版本。以「今天有什么作业？」提问时，回答末尾会附上今日作业表（新工具 thread_today_work，默认开启）。
  • what-if 工具 thread_explain_recovery 改为默认开启，回答中会附上**「可执行的动作」**卡片。可审批的人员 由业务角色决定 → 业务角色
  • 待办（/tasks）— 隐藏所绑定发现均已关闭的紧急卡片，并将同一设备 · 同一类型的发现按天合并为一张。 「相关 SOP 文档」面板仅以该设备的文档为依据。
  • 异常检测的「无法判定」框默认折叠为一行，数字主线界面的就绪度圆点新增工具提示且原因按界面语言显示。

→ Copilot 界面 · 数字主线

管理控制台​

  • 宽度小于 1024px 时菜单折叠为抽屉（☰）。
  • 上传对话框支持多文件，图纸台账新增**「上传图纸」**（PDF 可逐文件选择归为文档或图纸）。
  • 图纸识读测试新增尺寸上 · 下偏差列与**「形位公差框检查」**卡片。
  • 集成地图的**「立即同步」**会关闭已消失的连接（采集被截断时会提示未关闭）。

→ AI 管理控制台

数字主线 · RAG​

  • 数字主线改为以 PO 为中心串联 — 物料 PO → 作业指令 → 客户订单行 → 客户。ERP 连接器 erp-mcp/0.3 提供采购 · 入库 · 销售订单工具，并计算客户订单的余量天数与风险。新增 API GET /api/v1/today 与 MCP 工具 today_work（数字主线工具共七个）。
  • 对已启用的连接器执行周期性重新同步（默认开启）。
  • 在启用图纸采集的安装中，Platform 资产文档中的图纸（.dxf，文档类型为 DRAWING 的 PDF）也会纳入。
  • 询问公差 · 范围时以图纸尺寸表作答；若使用配合公式计算得出的数值，会附上 «公式推定» 提示。

→ 图纸检索 · 数字主线

时序洞察​

  • 健康指数的停机扣分仅计计划外停机。历史较短的域不再记 0 分，而是暂缓判定。
  • 订单未达成发现在依据不足时予以暂缓。

→ 时序洞察

修复内容​

  • 聊天过程中仅连接中断时，不再显示「发生错误」，而是提示「连接已断开。服务器仍在继续生成回答…」， 桌面界面会在最多 5 分钟内找回回答。
  • 空回答以「未能生成回答…」结束，陷入重复的回答以「⚠ 因内容重复已中止回答生成…」结束。 修复了「LLM 调用失败: finish_reason is null」与引用编号错位的问题。
  • 修复了上传的图纸未出现在文档列表、DXF 预览文字显示为空框、韩语界面中残留英文的问题。

→ 故障排除

组件版本​

组件版本
docling-servev1.36.0

其余与下文「2026.10」相同。

2026.10 重新发布 — 2026-10-05​

这是重新构建的相同 2026.10 标签（月份标签为滚动标签）。安装步骤与端口未变。已升级到 2026.10 的安装以 bin/update.sh 获取即可；若从 2026.09 及以下升级，请照下文「2026.10」的手工操作 逐项执行。

重新获取前须确认两点
  1. PI_INBOUND_API_KEY 是否为空 — 现在若为空，后端服务将无法启动（见下文「安全」）。 由安装器生成的 env 已包含值。
  2. 若在主机 env 中写过 TS_GPU_UTIL 请删除 — 时序推理服务器的 GPU 份额已移至硬件配置档， 主机 env 中的该行会被启动前判定判为 profile。

安全 — 后端入站密钥「为空即停」​

  • RAG · 时序洞察 API · 文档理解 · 视觉 · 数字主线在入站密钥为空时拒绝启动。此前密钥为空时 会以无认证开放状态显示 healthy。compose 也将 PI_INBOUND_API_KEY 设为必填。
  • 各服务新增了无密钥放行的开关（*_INBOUND_AUTH_DISABLED），但本版本的 compose 未传入。自重新发布 3 起通过主机开关 PI_INBOUND_AUTH_DISABLED 传入，空密钥由启动前判定而非 compose 阻止（见上）。

→ 环境变量设置 · 故障排除

可观测性 — 指标与请求 id​

  • 五个 Python 后端提供 GET /metrics（Prometheus 文本格式）。不新增端口，且位于入站密钥之后。
  • 同样这五个服务会在每次请求的响应中返回 X-Request-ID，并以 request_id 写入该请求的日志行。

→ 日志与监控 · API 集成指南

图纸 — 默认关闭，现已可启用​

  • compose 会将 DRAWING_INGEST_ENABLED（默认 false）传给 rag-api — 此前没有启用途径。
  • 在已启用的安装中可输出两个版本的差异 — rag-api GET /api/v1/drawings/{asset_id}/{doc_name}/diff?lang=（与已索引图纸的 上一版本比较）· 文档理解 POST /api/v1/drawings/diff（两个文件比较）。

→ API 集成指南

文档 · 图片工具​

  • compose 会将 FETCH_ALLOWED_HOSTS 传给文档理解 · 视觉。可将公司文件服务器的 URL 写入允许列表以便访问 （此前版本未传入，导致内网 URL 总被拒绝）。
  • vision_ocr 改为使用正在服务的 LLM 识读（三次中两次一致才作答）。可识读韩文铭牌 · 标签。若要回退到 原先的 docling OCR，设为 VISION_OCR_ENGINE=docling。

→ MCP 工具地图

视频 · 语音 — 调节项已就位（本版本转录尚不可用）​

  • compose 中加入了视频 · 语音采集调节项（MEDIA_* · ASR_* · OCR_*）与转录服务 plantpulse-asr（profile media，默认 关闭），其 GPU 份额（ASR_GPU_UTIL）已预先计入硬件配置档的总和。
  • 本版本中转录服务所用的 vLLM 镜像缺少音频解码器，转录无法工作。该问题已在重新发布 3 中修复， 现可通过一行 PI_MEDIA_ENABLED=true 启用（见上）。

→ 视频 · 语音采集

安装 · 配置​

  • install.sh 会用同名环境变量填充剩余的占位符（… | sudo PP_API_TOKEN=… bash）。已填入的值不会被覆盖。
  • 启动前判定对旧的 CH_* 行不再提示「删除」，而是提示 renamed — 仅改名的 sed。从此不会因删除 而使值回退为默认值。
  • 硬件配置档包含五项份额（LLM · EMB · RERANK · TS · ASR）— GB10 为 0.4 · 0.10 · 0.08 · 0.13 · 0.03（合计 0.74）， g7e 为 0.53 · 0.13 · 0.10 · 0.15 · 0.04（合计 0.95）。

→ 环境变量设置 · 系统要求

Copilot · 数据​

  • 管理员可设定聊天起始界面的安装默认角色（设置 chat.home.default_role）— 仅在员工没有业务角色时使用， 留空则由起始界面让用户选择角色 → Copilot 管理员控制台
  • 新表 · 新列（chat_action · chat_turn_metric · chat_bench_run · chats.context · agent_tool_call_log.approved_by，Aster TSDB PI_NAVIGATOR_ACTION_CHECK）在启动时自动创建。无需手工执行迁移。

→ 数据库模型

2026.10​

若从 2026.09 及以下升级 — 五项手工操作

安装器不会重新生成已存在的 /etc/kopens/plantpulse-ai.env，也不会追加新行。以下必须手工完成。

  1. 配置 Platform 凭据获取 — 填入 PP_DATALAKE_ADMIN_URL · PP_DATALAKE_ADMIN_API_KEY，并将 Platform 信任锚放到 /etc/kopens/ca/root.crt（同样内容也放到 CA.crt）。AI 主机 IP 必须在 Platform 允许列表中。 否则使用凭据的各容器会以 FATAL 停止 → 安装概述
  2. 存储凭据加密密钥 — 添加 PI_COPILOT_SECRET_KEY · PI_DT_SECRET_KEY 行（openssl rand -base64 32）。 缺少 PI_COPILOT_SECRET_KEY 时 Copilot 无法启动 → 环境变量设置
  3. CH_* → CO_* 改名 — Copilot 环境变量前缀已变更且无回退。请勿删除旧行，保留原值 仅迁移名称（自重新发布起，启动前判定会以 renamed 捕获并输出仅改名的 sed）→ 环境变量设置
  4. 清理主机 env — 主机 env 现在只保留站点值与密钥。旧 env 中残留的镜像引用 · GPU 份额 · 与 compose 默认值相同的值 · PP_HOST · Platform 账号 · 密码（PP_PG_* · PP_CASSANDRA_* · PP_REDIS_PASSWORD · PP_S3_* 等）· LITELLM_IMAGE 行会导致启动前判定中止启动。请依据 bin/lint-env.sh 输出的 sed 删除，并 添加 PP_HW_PROFILE=gb10（AWS g7e 为 g7e）。请先完成 1 与 3 → 环境变量设置
  5. 管理控制台地址 — 9080 关闭，开放 5959（HTTP）· 5960（HTTPS）。请迁移书签与防火墙规则。

Copilot — 界面​

  • 左侧导航整理为六个菜单 — 今日 · 现场 · 待办 · 解决 · 向 AI 提问 · 报表。点击菜单进入 首个界面，菜单内的各界面通过正文顶部的标签页切换（今日：摘要 · 周报简报 / 现场：工厂现况 · 监视 · 异常检测 · 预测 · 关联分析）。名称也有变更 — 首页 → 摘要，工厂状态 → 工厂现况， 监视（Watch）→ 监视，关联分析 → 关联分析，AI 聊天 → 向 AI 提问。
  • 按业务角色的起始界面 — 从 / 进入时，作业者 · 班长 · 质量进入「今日」，维修进入「待办」，厂长进入 「报表」。
  • 移动端标签页变为四个 — 今日 · 现场 · 待办 · 向 AI 提问。
  • 监视标签页（/watch）的告警侧改为两栏 — 左侧为监视告警 → AI 发现，右侧为关注设备 · 维修后确认。
  • 默认主题为浅色。即使操作系统为深色，用户未选择深色模式也不会启用。
  • 修复了通知订阅静默一段时间后被代理断开的问题（Copilot 发送心跳，代理仅对该路径等待最长 1 小时）。

→ Copilot 界面

Copilot — AI 发现，人来判定​

  • 接收 AI 发现 — 接收时序洞察找到的发现，以通知 · 晨间简报 · 「AI 发现」片段呈现， 并给出订单未达成建议（默认开启）。同时引入了处方型发现卡片与维修后自动确认。
  • 关注设备 — 「今天优先查看的设备」（默认开启）。
  • 人机协同（Human in the loop） — 可对单条异常标注正确 · 误报 · 不确定，上报漏检的异常，接受 · 拒绝建议 并留下结果。这些标注可通过公开 API GET /api/v1/ai-feedback 读取。
  • AI 准确率（/accuracy，管理员）— 与停机 · 故障规则比对得出的准确率，以及按设备自动调整传感器阈值。
  • 待验证（/review）— 供班长 · 维修 · 管理员使用。默认关闭。
  • 公开聊天 API 在不带 session_id 时会开启新会话（此前版本返回 500）。以 X-API-Key 调用的聊天也已修复。

→ 时序洞察 · API 集成指南

数字主线​

  • plantpulse-digital-thread-api 已默认纳入技术栈 — 它是工厂图镜像与连接器注册表的持有者。 镜像存放于专用 Neo4j（plantpulse-digital-thread-neo4j），不与 LightRAG 的图共用同一 DB。 两者都不向主机开放端口。
  • 管理控制台新增集成地图（/thread/）与图镜像（/thread/mirror/）界面。
  • Copilot 聊天中接入数字主线工具（thread_get_timeline · thread_trace_links，默认开启）。引入了在建议卡片中 由管理员审批后在 MES · SCM 中创建一条草稿 · 申请的审批 → 草稿流程。
  • 连接器家族新增 PLM（plm-mcp/0.1 — 设计变更指令 · 设计 BOM）与 QM（qm-mcp/0.1 — 检验 · 不合格）， mes-mcp/0.5 的 SCM 可提供合作商供应能力。均为只读。
  • what-if 工具 thread_explain_recovery（默认关闭）的回答中新增了每条设计变更 · 不合格所追加的延迟，以及延迟零件 能否从合作商提前取得（在相应连接器已启用时）。

→ 数字主线 · AI 管理控制台

安装 · 配置​

  • Platform 凭据在启动时获取 — PG · Aster TSDB · Redis · RustFS 的账号 · 密码 · 端口 不再放在主机 env 中。容器以及启动前 DB 预置之类的主机脚本都从同一 API 获取。 获取失败则以 FATAL 停止，且没有关闭证书校验的途径。
  • 安装器不再询问 Platform 主机 · 账号，而是询问 PP_DATALAKE_ADMIN_URL · PP_DATALAKE_ADMIN_API_KEY。若为 START=1， 会在拉取镜像前先试取一次凭据，失败则不启动任何服务。
  • 主机 env 只放站点值与密钥 — 产品默认值移至 compose，vLLM 的 GPU 份额移至硬件配置档 （compose/profiles/<PP_HW_PROFILE>.env）。镜像固定不可放在主机 env 中， 紧急情况下只能通过 shell 环境一次性提供。
  • 安装器在开放防火墙后，会对本技术栈之外进程已占用的端口发出警告。
  • Copilot 环境变量前缀 CH_ → CO_（见上「手工操作」）。
  • 存储凭据加密密钥 PI_COPILOT_SECRET_KEY · PI_DT_SECRET_KEY — 首次安装由安装器生成。轮换通过 _PREVIOUS 进行，不属于 passwd.sh 的范围 → 密码 · API 密钥变更
  • AI 应用 PG 改用 DB pi — Copilot 使用 schema co，数字主线使用 dt。旧 DB ch 会在启动时 迁移为 pi.co。
  • PI_NEO4J_PASSWORD 是 Neo4j 两个实例的账号。bin/passwd.sh 会同时变更两者。
  • 安装器会选定一个 PP_TZ 并同步到主机 OS 时区。若为 HOST_TUNING=skip|plan，则不执行软件包安装与 nvidia 运行时注册（重启 Docker）。env 中已写入的 TLS SAN 在重新安装后仍保留。
  • LiteLLM 主机端口可通过 PI_LITELLM_PORT（默认 4000）更改。

→ 环境变量设置 · 安装概述

隔离网络​

  • bin/up.sh 同样会在占位符残留时拒绝启动 — 此前仅拦截 START=1 路径，导致导入后手工启动的 技术栈可能以公开模板中的密码开放。
  • 导入在未执行 START 即结束时，会输出后续步骤（填充占位符 → 放置模型 → bin/up.sh）。
  • vLLM 模型需在联网侧以 bin/fetch-models.sh 下载后迁移（校验发布权重 · 校验和）。时序推理模型已包含在 镜像内，无需导入。

→ 隔离网络安装

访问 · 端口​

  • 管理控制台 9080 → 5959（HTTP，PI_ADMIN_WEB_PORT）· 5960（HTTPS，PI_ADMIN_WEB_TLS_PORT，经代理）。 两者均开放并指向同一控制台。
  • 当控制台后端服务拒绝控制台的入站密钥时，不再退回登录界面，而是显示 502 · upstream_auth 以及需检查的变量名。LLM 读取界面会把网关（或其 DB）的 5xx 转为 502 · llm_upstream （此前为 500）→ 故障排除
  • 入口代理改为非 root 运行后，容器内部端口变为 8080 · 9443 · 8443。主机的 80 · 443 · 5960 保持不变。

→ 服务端口映射

运维​

  • 容器以非 root 运行 — compose 中所有服务都显式指定运行用户（我方镜像与入口代理 · vLLM 为 uid 10001、gid 0），root 例外仅 GPU 指标的 plantpulse-dcgm 一个。旧安装中 root 所属的可写卷 （含代理证书 · Qdrant · Neo4j）由 up.sh · restart.sh · update.sh 在启动前统一修正一次（bin/volumes-nonroot.sh）→ 服务运维
  • 新增卷 pi-digital-thread-neo4j-data（工厂图镜像）· pi-ttm-tuned-models（各安装的时序微调权重）。

镜像​

  • 自研镜像增至十二个 — 新增数字主线，LightRAG · LiteLLM 改为我方封装镜像 （pi/plantpulse-lightrag · pi/plantpulse-litellm）。两者均跟随月份标签，紧急情况下仅固定其一时， 通过 shell 环境提供 PI_IMAGE_TAG_LIGHTRAG · PI_IMAGE_TAG_LITELLM。LITELLM_IMAGE 已移除。
  • 自研镜像的默认标签为 2026.10。

组件版本​

组件版本
vLLMv0.29.0
LightRAGv1.5.7 (封装镜像的基础)
docling-servev1.34.0
LiteLLMv1.103.0 (封装镜像的基础)
Neo4j5.26.28 (两个实例)
Qdrantv1.18.2

2026.09 (2026-09-25)​

若从 2026.08 及以下升级 — 两项手工操作

安装器不会重新生成已存在的 /etc/kopens/plantpulse-ai.env。以下两项必须手工修改后才能启动。

  1. 对象存储键改名 — 将 PP_MINIO_PORT · PP_MINIO_ACCESS_KEY · PP_MINIO_PASSWORD 仅改名为 PP_S3_PORT · PP_S3_ACCESS_KEY · PP_S3_PASSWORD（值保持不变）。若只有旧名称， 启动前判定会中止并提示需迁移的行 → 环境变量设置
  2. LiteLLM 管理界面密码 — 添加 PI_LITELLM_UI_PASSWORD=<password> 行。缺少时 compose 会 拒绝启动 → 初始密码变更

若外部集成此前以 gpt-4o · gpt-4o-mini 调用模型，需改为新名称（aura-35b 等 — 自重新发布（2026-10-20） 起为 aura-lite）（见下文）。

模型名称​

  • 注册到网关的名称变更为 aura-35b（重新发布（2026-10-20） 中再次改为 aura-lite）· aura-vision（视觉别名）· aura-embedding-4b · aura-reranker-0.6b。
  • 移除了 gpt-4o · gpt-4o-mini 之类的兼容别名。 VLM_NAME 也已移除 — 视觉别名 由网关配置持有。

安装​

  • 内部密钥由安装器生成 — 网关主密钥 · 盐 · vLLM 密钥 · 入站密钥 · RAG 密钥 · 控制台会话密钥。只向人询问仅人知晓的值（管理员密码）与 Platform 值（PP_*）。
  • 会询问 TLS 证书 SAN（PP_PROXY_CERT_SAN）。非交互模式下按主机地址推定并给出警告。
  • 在 START=1 情况下若占位符仍残留则拒绝启动（此前仅警告）。
  • 若为 START=1，会自动下载缺失的模型并校验 SHA256（隔离网络除外）。
  • 启动后 bin/verify-install.sh 衡量的不是「是否起来了」，而是「是否可用」（模型 · 网关密钥 · Platform 令牌）。FAIL 时安装以失败结束。
  • 安装器会安装 NVIDIA 驱动 · container toolkit（可用 SKIP_GPU=1 跳过）。
  • HOST_TUNING=skip|plan|apply — 在运行着其他容器的主机上默认为 plan（仅输出）。
  • ALLOW_DOCKER_RECONFIGURE=1 — 对原本已安装的 Docker，默认保留其仓库配置且不重启。
  • env 模板与机器架构不匹配时中止（可用 ENV_TEMPLATE_SKIP_ARCH_CHECK=1 跳过）。

→ 安装概述

隔离网络​

  • 捆绑包签名校验（verify-bundle.sh）成为导入的第一步。未通过校验或找不到捆绑包时 中止。隔离网络用的 cosign 随捆绑包一并提供。
  • 两个同级仓库一并打入捆绑包。Docker 离线包类型依架构而定 （arm64 → deb，amd64 → rpm）。

→ 隔离网络安装

访问 · 端口​

  • 默认主机上新增 /llm/（OpenAI 兼容网关）与 /mcp/rag/ · /mcp/timeseries/ · /mcp/parser/ · /mcp/vision/ 路径 — 可用单一域名访问。
  • 不再向主机发布 Phoenix（6006）。 默认启动不变，仅在诊断时以 PP_DEBUG_PORTS=1 开放。
  • 新增 LiteLLM 管理界面账号（PI_LITELLM_UI_USERNAME · PI_LITELLM_UI_PASSWORD，默认 admin / admin123!）。 此前必须以主密钥作为密码输入。

→ 服务端口映射

配置​

  • 对象存储键 PP_MINIO_* → PP_S3_*（见上「手工操作」）。
  • 设备报警通道 Kafka → MQTT（1884，TLS）。PP_KAFKA_PORT 已移除。
  • GPU 份额总和校验 — 各服务 GPU 份额之和超过 PP_GPU_BUDGET_CEILING（默认 0.75）时在启动前中止。
  • CH_API_V1_KEY — 公开 API（/api/v1）的机器认证密钥。留空则无法以该密钥接入。
  • LightRAG 实体抽取超时 LIGHTRAG_LLM_TIMEOUT 默认 3600 秒 — 修复大文档索引中途失败的问题。

→ 环境变量设置

运维​

  • bin/passwd.sh --generate — 由工具生成待轮换的值。生成的密钥通过系列前缀 （ppin_ · ppvl_ · pprg_ · sk-pplm_）自我标识用途。
  • bin/backup.sh 会备份 compose 的全部卷（日志 · 缓存除外）— 新增了 TLS 证书与 Phoenix 数据。以 --list 查看判定结果。→ 数据库管理

→ 密码 · API 密钥变更

管理控制台​

  • 可选择韩语（登录界面的语言切换）。
  • LLM 菜单新增 聊天测试 · 模型注册（外部 OpenAI 兼容端点）· API 密钥（签发虚拟密钥）· 上游状态。

→ AI 管理控制台

Copilot​

  • 监视（/watch）— 写下需要盯防的内容，便会以告警通知 → 自动化
  • 左侧导航的界面顺序按工作流重新排列 → Copilot 界面
  • 会话标题搜索，依据视图中工具参数的密钥值掩码
  • Copilot 管理界面的 API 密钥签发与公开 API /api/v1 → API 集成指南
  • 时序预测默认模型 TTM R3，设备传感器异常检测的校正分数默认阈值 5.0 → 时序洞察

组件版本​

组件版本
vLLMv0.29.0
LightRAGv1.5.6
docling-servev1.34.0
LiteLLMv1.102.0
Neo4j5.26.28
Qdrantv1.18.2
Arize Phoenix19.6.0

2026.08 (2026-08-23)​

  • 引入 plantpulse-proxy — 将外部入口统一到 80 / 443 并启用 TLS。
  • 运维通用命令 — bin/up.sh · down.sh · restart.sh · logs.sh · shell.sh · update.sh · remove.sh · doctor.sh。
  • bin/passwd.sh — 密码 · API 密钥变更（platform · ai · studio 通用规范）。
  • 配置正本迁移至 /etc/kopens/plantpulse-ai.env（不再读取 compose/.env）。
  • 停止向主机发布内部服务（vLLM · 嵌入 · 重排 · docling · Qdrant · 时序推理 · admin-api）的端口。 将四个后端服务的入站密钥统一为一个值（当时名称 PP_INBOUND_API_KEY，现为 PI_INBOUND_API_KEY）。
  • 发布构建分为 arm64 · amd64 两条线。env 模板名称变为 env.gb10.example。

v2.0.0 (2026-07) — 架构大改版​

信息

以下 v1.x 条目是基于改版前架构的历史记录。当前架构请参考本 v2.0.0 条目。

聊天编排内置化（移除 Langflow）​

  • 聊天/智能体执行统一由 AI Chat Web 内置智能体（AgentOrchestrator + ToolRegistry）承担。
  • Langflow 引擎及 15 个自定义组件、Jupyter 已从技术栈中移除。Arize Phoenix 当时也一并移除，但于 2026-07-27 作为 LLM 追踪用途回归，现已默认启动（自 2026.09 起主机端口关闭）。
  • LLM 推理经由 LiteLLM(:4000) 网关。当时模型名称为 gpt-4o，2026.09 改为 aura-35b，2026.10 重新发布（2026-10-20） 改为 aura-lite。智能体执行流程可在聊天界面的"查看任务"中确认。

MCP / 本体集成​

  • 原独立服务 plantpulse-mcp-server(:50000) 与 plantpulse-ontology(:8888) 已归档，由 Platform server-web 集成 MCP（/api/v5/mcp，api_key 认证）替代。本体工具已并入集成 MCP。
  • 内置智能体的 ToolRegistry 通过 tools/list 动态发现工具。

RAG → LightRAG 迁移​

  • 自研 RAG 服务器（原 plantpulse-rag）已由官方 LightRAG 服务器（当时 1.5.4，2026.09 为 1.5.6）替代。文档管理在 LightRAG WebUI（/webui）中进行。

基础设施共用化​

  • PostgreSQL · Aster TSDB · Redis · RustFS 改为共用 PlantPulse 平台安装实例（废止 AI 技术栈内置运行）。

v1.4.0 (2026-03-29)​

文档​

  • 问题示例扩充至 178 个（特征存储细分、复合问题强化、业务场景补充）
  • 新增故障排除指南
  • 新增 API 集成指南
  • 新增发行说明页面
  • README 中新增 GitBook 在线手册 URL

v1.3.0 (2026-03-29)​

文档​

  • 问题示例扩充至 170 个（按领域细分）
  • 新增 3 篇附录算法指南：
    • 理解 RAG 算法（分块、嵌入、混合检索、重排）
    • 理解 AI 模型算法（TSPulse 异常检测、TTM 预测、特征存储）
    • 理解本体（知识图谱）（图数据库、子图探索）
  • 新增故障排除指南
  • 新增 API 集成指南
  • 新增发行说明页面

v1.2.0 (2026-03-29)​

文档​

  • 新增 3 篇附录算法指南

v1.1.0 (2026-03-29)​

文档​

  • 新增问题示例页面（130 个）

v1.0.0 (2026-03-29)​

初始发布​

PlantPulse AI 产品手册 GitBook 初始搭建。

平台构成​

  • 集成 151 个 MCP 工具
    • PlantPulse MCP Server：116 个只读 API
    • TimeSeries-Insight：27 个 AI 分析工具
    • Ontology：5 个图工具
    • RAG：3 个检索工具
  • 15 个自定义 Langflow 组件
  • AURA LLM — 工业专用自研模型（LLM + Embedding + Reranker）

AI 模型​

模型用途
AURA LLM对话/分析/报告生成
AURA Embedding向量嵌入（2560 维）
AURA Reranker检索结果重排
IBM Granite TSPulse时序异常检测
TinyTimeMixer (TTM)时序预测

基础设施​

组件技术
后端Java 21 / Spring Boot 3.4, Python / FastAPI
图数据库Neo4j
向量数据库Qdrant
关系型数据库PostgreSQL 18
时序数据库Apache Cassandra
缓存Valkey (Redis 兼容)
对象存储RustFS (S3 兼容)
LLM 代理LiteLLM
AI 工作流Langflow
AI 可观测性Arize Phoenix
实验环境Jupyter Notebook

各模块主要功能​

AI Chat Web

  • 基于自然语言的工厂数据查询
  • SSE 实时流式响应
  • ECharts/Mermaid 丰富可视化
  • 多 AI Flow 管理

MCP Server

  • 基于 OPC-UA/ISA-95 的 116 个只读 API
  • 10 个数据域：设备、OPC、作业指令、站点、标签、OEE、日历、系统、RAM、EMS、报警、点位等
  • KST 原生时间处理

TimeSeries-Insight

  • 7 个领域异常检测（IBM Granite TSPulse）
  • 7 个领域预测（TinyTimeMixer TTM）
  • 报警深度分析（统计、持续时间、相关性）
  • 特征存储（按小时/按日自动计算、向量嵌入、LLM 上下文）
  • 设备健康评分（0~100）

Ontology

  • 14 种节点类型的工厂知识图谱
  • 子图探索（可指定 depth）
  • PlantPulse DB ↔ Neo4j 60 秒自动同步

RAG

  • 4 种检索模式（hybrid、naive、local、global）
  • 混合检索（Dense + Sparse）
  • 多模态支持（文本 + 图像 + 表格）
  • Docling 文档解析器、重排器

AI Studio

  • Langflow 可视化流程编程
  • 15 个 PlantPulse 专用组件
  • LiteLLM LLM 代理
  • Arize Phoenix AI 评估/监控
  • Jupyter Notebook 实验环境