跳到主要内容

发布说明

通过聊天创建、部署 IIoT 现场应用并向数据提问的工作室——最新版本为 2026.08。

版本标记

版本采用 YYYY.MM 格式（例如：2026.08）。同一月份内的更新保持相同的版本号， 下面按实际发布日期排序。 安装与升级方法请参阅 安装。

🚚 下载地址已变更— product.kopens.io​

安装脚本和离线捆绑包已从 download.kopens.io 迁移至 product.kopens.io。 文件夹结构和文件名保持不变。如果您的安装命令已写入脚本，只需修改地址即可。

…-latest.tar.gz 已移除

之前下载最新捆绑包的副本时，若在发布过程中下载，会导致校验和不匹配， 使完好的文件被判定为"损坏"。现在请读取仅包含最新版本名称的 latest.txt， 并从版本化地址下载。

BASE=https://product.kopens.io/plantpulse-studio
VER=$(curl -fsSL $BASE/latest.txt)
curl -fLO -C - --retry 5 $BASE/plantpulse-studio-images-$VER.tar.gz

已发布的版本不会被删除。 即使推出了 2026.09，…-2026.08.tar.gz 地址依然有效， 您可以随时重新下载或回退。如果已将安装流程固定为脚本，建议直接写明版本号 ，而非使用 latest.txt，这样更安全。

🗓 每月定期发布 — 2026.08​

每月 1 日发布当月版本。2026.08 仅包含部署自动化改动，产品功能没有变化 ——如果您正在使用 2026.07，无需急于升级。

请先确认—升级前需要采取的措施​

如果符合以下情况需要采取的措施
在非隔离网络环境中运行务必应用此更新（阻止构建器边车暴露）
配置文件中存有 API 密钥将密钥迁移至 .env → 密钥管理
使用域名或反向代理提供服务用户需要重新登录一次 → 域名与反向代理
仅有备份但从未执行过恢复请进行一次恢复演练 → 备份与恢复

🛡 数据完整性全面检查​

我们对全部源码进行了审计，发现并修复了严重问题 3 项、高优先级问题 15 项。这些问题大多属于"平时不易发现，但在关键时刻才显现"的类型，因此我们先构建了复现测试，再进行修复。

备份与恢复​

请进行一次恢复演练

恢复操作实际上并未恢复任何数据。 备份每天都正常执行，但执行恢复后，数据库内容没有任何变化，却显示"恢复完成"。在之前的版本中，即使 DRYRUN=1 演练通过，实际恢复也不会生效。因此，建议您在本次更新后实际测试一次恢复 → 备份与恢复

  • 恢复前生成的临时备份若失败，系统仍会继续执行，且无法通过该临时备份回退。现在，临时备份会以与正式备份相同的格式创建，如果失败则不会启动恢复。
  • 备份中遗漏了 .env。 将密钥迁移到环境变量后，如果没有此文件，仅靠备份无法恢复系统 → 密钥管理
  • 修复了工作区中存在 postgres 文件夹时，该文件夹在备份中被静默忽略的问题。
  • 计划备份自首次执行起全部失败（因日志文件路径缺失）。如果您已开启自动备份，可能实际上没有生成任何备份，请检查 dist/。

数据丢失​

  • 删除一个聊天室可能导致其他用户的查询历史一并消失的问题。
  • 项目删除后应保留 7 天的回收站，却在下次重启时立即清空的问题。
  • 存储读取一旦失败，之后创建监视器或技能时，现有数据会全部被删除的问题。
  • 设置或对话历史保存中断时，导致项目或历史丢失的问题。
  • 将轻量（文件）安装升级为 PostgreSQL 时，账户和聊天历史未迁移的问题 → 安装

运行稳定性​

  • 快速打开应用两次，会导致内部端口泄漏，最终所有应用都无法打开的问题。
  • 构建器对话越长，请求体持续增大，导致令牌消耗增加，最终聊天被阻断的问题。
  • 撤回操作在构建器任务执行期间介入，导致结果混乱或丢失的问题 → 使用构建器开发应用
  • 重新安装会删除 TLS 证书，导致 HTTPS 降级为明文的问题 → 域名与反向代理
  • 设备控制命令在响应延迟时，可能最多重复发送 4 次的问题。

界面​

  • 进入聊天后立即发送的问题，在列表加载完成后会消失的问题 → 通过聊天查询数据
  • 移动端通知重复弹出，注销后刷新页面又自动登录的问题 → 现场移动端
  • 创建计划后切换模式，已填写的需求会丢失的问题。
  • 会话过期后没有任何提示，只显示空白页面的问题。

📖 内置用户手册​

  • 产品中已包含手册——即您现在看到的本文档。点击左侧导航栏的 手册 ↗（fa-book-open），将在新窗口中打开。
  • 离线也能访问：手册随产品镜像一同分发，因此在隔离网络现场也可以直接查看。全文搜索在本地运行。
  • 略微增大了左侧导航图标，以提升可读性。

🔒 安全与供应链​

  • 粘贴到聊天中的密钥不会记录在历史中：应用变更历史会自动记录（→ 使用构建器开发应用），但此前如果您在聊天窗口粘贴 API 密钥，其值会直接保存在记录中。现在，系统会自动遮蔽已知格式的密钥和令牌。

    请仍然不要粘贴

    无法识别所有形式的机密信息。请将密钥通过 密钥管理 中的环境变量方式配置，而非在聊天中粘贴。

  • 构建器引擎镜像也纳入签名范围：在离线捆绑包中包含的镜像中，此前只有构建器边车未进行签名。现已修正。bin/verify-images.sh 会验证全部 4 类镜像。

  • 配置文件权限在每次保存时被重置的问题已修复：登录令牌文件和配置备份也已纳入保护范围。

  • 构建器引擎更新：OpenHands 边车已升级至 SDK v1.37.1（使用方法无变化）。

📌 版本固定​

  • 所有镜像均已指定固定版本（已移除 latest）。重新安装时不会再因安装时间不同而安装不同版本。可通过 .env 的 TAG 指定所需版本 → 安装。
    ⚠ TAG 已于 2026-08-31 变更为 PP_IMAGE_TAG（现已新增 PS_IMAGE_TAG_SERVER 和 PS_IMAGE_TAG_WEB 以支持按镜像单独固定版本）。当前标准请参阅 环境变量参考。

🔑 密钥管理与连接稳定性​

  • API 密钥仅通过环境变量管理— 此前以明文形式存储在配置文件中的平台、AI、Git 和注册表密钥，现已全部转为仅通过环境变量提供。即使配置文件泄露，密钥也不会暴露。现有安装可继续运行，启动日志会提示需要迁移的内容（日志中不会记录密钥值）。环境配置界面会将这些密钥显示为"正在通过环境变量管理"，并禁止编辑。
    ⚠ 此行为已于 2026-08-23 调整— 因为发现当环境变量优先时，无法通过界面修复失效密钥，所以现在界面值会覆盖环境变量，且输入框不再锁定。当前标准请参阅 密钥管理。
  • 文件权限自动加固— 服务器每次启动时，会将配置文件及 .env 强制设置为仅所有者可读/写（0600）。
  • 配置变更追踪— 变更内容会记录到审计日志中（机密信息仅记录指纹而非值）。这使您可以追踪"从何时开始出现问题"。
  • 长时间构建期间连接中断问题解决— 当代理因执行工具而长时间静默时，代理会断开流，导致"连接错误"的问题，现已通过服务器心跳机制解决（与代理配置无关）。
  • 错误消息改进— 像"边车状态：错误"这类无法说明原因的消息，现在会提供具体原因和应对措施（例如：AI 提供商地址无法访问 → 检查环境配置）。
  • 推理模型兼容— 对于使用工具的模型，此前因网关设置冲突导致查询失败的问题，现已自动修正。
  • 在运维文档中增加了完整的代理配置示例以及"症状 → 原因"对照表。

🔒 安全与稳定性增强​

在全面审计（安全、代码质量、前端、运维）后，对发现的问题进行了统一处理。

  • 阻止构建器边车暴露— 构建器引擎边车在默认配置下启动，导致整个内网环境中无需认证即可访问。现已限制为仅回环地址绑定，并应用了内存、CPU 和日志上限。如果您的环境不是隔离网络，请务必应用此更新。
  • 预览访问控制— 此前仅知道预览地址即可访问私有项目的源码和聊天附件。现已限制为仅所有者、管理员和共享用户可访问（包括实时更新的 WebSocket）。
  • 应用源代理限制— 生成应用的数据代理原先允许所有方法和所有路径。现已缩减为只读路径白名单 + 仅在应用自身已认证时才允许写操作（界面行为保持不变）。
  • 防止监视器成本事故— 修改 API 未对输入进行验证，导致错误值可能导致监视器停止，或每分钟调用 AI。
  • 提供恢复脚本— 此前只有备份没有恢复手段。现已新增恢复脚本（包括用于演练的非破坏性模式），并强化了备份文件权限为仅所有者可读/写。
  • 重装安全性— 如果在一线服务器上重新执行一键安装，会删除 .env 和本地备份，导致栈无法启动。现已修改为保留这些内容。
  • 性能— 首屏捆绑包体积减少 66%（图表引擎和界面延迟加载），移除回答流式传输期间的输入延迟，停止后台标签页轮询。
  • 可访问性与多语言— 为 11 种弹窗和抽屉添加了 Esc 键和焦点处理；翻译了 83 条在英文模式下仍显示韩文的错误消息。

🌐 支持自定义域名部署​

  • 应用源设置— 在环境配置 → 运行时标签页中，可指定预览和部署应用的公开 URL。在反向代理/HTTPS 域名后部署时，无需重启即可立即生效。
  • 登录 Cookie 自动设置域名— 如果工作室和应用源是同级子域名，将自动为 Cookie 设置公共父级域名，这样即使域名分离，部署应用也能查询实时数据，并能访问私有应用。⚠ 更改域名设置后需要重新登录一次。
  • 混合内容提示— 如果 HTTPS 工作室使用 HTTP 应用源，将不再显示空白页，而是在预览和设置界面显示原因和解决方法。
  • 部署指南— 整理了双源配置、Host 保留、WebSocket、Cloudflare 注意事项 → 域名与反向代理
  • UI 优化：移除英文模式构建器界面的水平滚动条，调整上下文栏切换位置。

🏗 3D 数字孪生 + 扩展栈​

  • 3D 数字孪生— 通过聊天生成工厂 3D 画面。新增了包含状态颜色、报警脉冲、数值看板的标准 3D 工具包和"3D 数字孪生"模板。
  • 图纸 → 地面纹理— 在聊天中附加图纸图片，会自动保存并平铺在 3D 场景地面上。
  • 预置 12 种扩展栈— 工艺流程图、动画、表单、拖放、虚拟滚动、二维码扫描地图等，无需额外安装即可使用。
  • 应用会话容器默认内存提升至 2 GB（以支持 3D 构建）。

🧩 MCP 注册表​

  • 环境配置 MCP 标签页— 添加/删除外部 MCP 服务器，自动发现工具（10 分钟缓存 + 手动刷新），按工具切换启用/聊天/构建器状态，显示新增和冲突标记。
  • 平台工具自动同步— 平台添加工具后，会自动显示在工作室聊天和构建器中。

🔒 构建器构建标准​

  • 依赖锁定（默认开启）— 阻止生成的应用安装任意包或更改设置，以固定标准栈。可通过管理员白名单设置例外。
  • 布局强制（默认开启）— 验证所有界面是否使用标准外壳，如违反，代理会自动修正。
  • 应用默认布局— 在环境配置中统一指定产品名称、强调色、最大宽度和页脚，并将其注入新应用。

📦 离线导出捆绑包​

  • 在部署版本侧边栏点击 [捆绑包] ，即可下载包含应用镜像和执行脚本的压缩文件。可在气隙现场使用 bash run.sh 一行命令启动。

🐳 Docker — 随处运行应用​

  • 推送应用镜像— 点击一次即可将部署版本打包为 Docker 镜像并推送至注册表。可在工作室之外的任何地方以容器方式运行。
  • 运行时面板— 在底部状态栏中可实时查看会话容器状态（CPU/内存），点击可查看日志、甚至重启。
  • 应用目录— 点击已部署应用的缩略图，即可在新标签页中直接启动。

🗣 直接向数据提问的聊天​

  • 自然语言查询— 例如"第 3 号线各设备的标签数量"，系统会使用平台实时数据立即回答。
  • 富文本回答— 使用表格（支持 CSV 复制）、图表、流程图进行可视化。
  • 聊天室管理— 会话隔离、重命名、搜索、显示响应耗时、图片附件。
  • 聊天 → 应用转换— 好的回答一键即可成为仪表板应用草稿。

🛰 监视器 — 自然语言监控规则​

  • 只需写"当管线压力超过 8bar 时通知我"。周期执行和条件判断由 AI 完成。
  • 触发时实时界面通知（Toast） + 未确认标记（设备间同步）。
  • 通知列表界面（搜索、查看更多）、发送兼容 Slack/Teams 的 Webhook。
  • 在聊天中输入"监控这个"即可创建监视器。

🏭 语义层 — 理解工厂的 AI​

  • 工作室会通过快照学习站点、线、设备和标签结构。
  • 代理会将设备名称、别名、时间表达（如"昨天"、"上周"）解释为准确的数据地址。
  • 使用 ISA-95 层级选择器，人员也可浏览相同结构。

📊 运营可见性​

  • 统计仪表板（管理员）— 在一个标签页中集中查看使用量、活动、应用、查询、部署成功/失败日志和审计搜索。
  • 部署支持分步进度对话框（构建 → 切换）和二维码，可直达现场平板访问。
  • 审计日志全文搜索、部署历史和回滚追踪。

🤖 编码代理升级​

  • OpenHands 引擎— 可选择使用行业标准开源编码代理引擎来构建应用（环境配置 → 代理 → 构建器引擎）。通过精确编辑和对话摘要压缩，长会话也能保持稳定。聊天（查询）不受影响，可随时切换回内置引擎。
  • 构建器三种模式— 计划（审批配置方案后构建） · 自动（默认） · 接受（在预览中确认编辑后再接受/撤销 — 对话历史保留）。
  • 斜杠命令— 在聊天输入中键入 / 会显示 /plan /build /review /fix /test /loop /deploy。/loop 会反复自动修正，直到通过类型检查（最多 3 次）。

📱 现场移动端​

  • 手机专用界面— 使用手机访问时会自动切换到移动端视图（平板和桌面端除外）。
  • 底部 4 个标签页— 首页 · 聊天 · 监视器 · 应用。
  • 首页摘要— 以卡片形式展示未确认通知、活动监视器、已部署应用和会话数量，最近的通知一目了然。
  • 实时通知— 即使在其他设备上触发监视器，也会通过 Toast 和未确认标记立即通知。
  • 移动端监视器管理— 列表、启用/禁用、立即执行、删除，甚至可用自然语言创建新监视器。
  • 访问部署应用— 通过实时迷你预览卡片查看已部署的应用，一键打开。
  • 主题和语言— 浅色/深色模式、韩文/英文切换。

应用列表与设计更新​

  • 应用列表双标签页— 分为 [已部署] 和 [已共享]，区分我已部署的应用和他人分享给我的应用。
  • 高级仪表盘设计— 柔和的极光背景、玻璃卡片、状态 LED 脉冲，让现场手机屏幕更清晰（保留工业深色调）。

🔒 安全与运维加固​

  • 生成的应用源隔离（与工作室使用独立监听器）— 明确信任边界。
  • 平台 API 密钥仅存储在服务器上，并仅对已登录用户代理（阻止匿名访问）。
  • 登录和 AI 路径速率限制、审计日志、基于角色的权限（管理员/构建者/查看者）。
  • 所有核心数据（会话、监视器、通知已读状态、技能、部署历史）持久化到 PostgreSQL — 不依赖浏览器存储。
  • 私有部署应用仅所有者、管理员和共享用户可用（由之前的"所有已登录用户允许"更严格限制）。共享通过应用卡片中的"用户共享"指定。
  • 附带气隙（隔离网络）安装及备份/恢复脚本。

安装与升级​

情况文档
全新安装安装
在隔离网络安装隔离网络安装
使用域名和 HTTPS 提供服务域名与反向代理
升级前备份备份与恢复
将密钥迁移至环境变量密钥管理
遇到问题时故障排除

如果是初次使用，请从 快速入门 开始。