跳至正文
数字员工平台文档
本页目录

Tego OS v5.3.0 → v5.4.0 升级说明 ​

目标版本： v5.4.0
升级范围： v5.3.0 → v5.4.0
发布日期： 2026-11-05
面向对象： 客户、业务负责人、交付团队、运营团队与平台管理员

升级概述 ​

Tego OS v5.4.0 把用 AI 编写技能的工作从网页端移到 Tego Studio，并让技能的每次上传都成为一个固定的版本；同时回收长期闲置的数字员工工作上下文、修复定时任务用量漏计和长期记忆提取失效等问题，并改善移动端在小屏、横屏和大字体下的可用性。

请注意： 本次升级会删除网页端技能编辑器及其全部数据，升级前请先阅读“升级影响与注意事项”。

本次升级主要解决以下问题：

  • 技能编写移到 Tego Studio： 用 AI 编写、试用和发布技能都在 Tego Studio 中完成；网页端保留 ZIP 上传、技能市场、安装和权限管理。
  • 技能版本可追溯： 每次上传都会生成一个不可更改的新版本，已安装的数字员工可以按更新策略自动跟随，不再原地覆盖旧内容。
  • Tego Studio 能读文档： 对话中可以添加任意文件，并读取 PDF、Word、Excel 和 PowerPoint 的内容；模型支持图片时还能查看扫描页。
  • 闲置对话不再占用存储： 数字员工长期闲置的工作上下文会被自动回收，聊天记录不受影响，再次发消息时能接上最近的对话。
  • 长期记忆恢复提取： 修复了进行中的对话无法进入长期记忆的问题，每轮对话结束后会重新提取。
  • 定时任务用量计算更准确： 修复了运行较久的定时任务在上下文压缩后丢失用量记录的问题。

平台更新 ​

1. 在 Tego Studio 中编写和发布技能 ​

  • 登录 Tego OS： 在 Tego Studio 的“设置 → 账号”中填写服务器地址即可登录。需要修改初始密码的账号，请先在网页端完成修改。
  • 编辑技能： 用表单编辑名称、描述、标签、版本、作者和运行要求，并与代码编辑器保持同步，注释和正文内容不受影响。
  • 试用技能： 新增只读的试用模式，按实际使用方式运行技能；其中的脚本按命令执行策略运行。
  • 继续编辑已有技能： 可以从 Tego OS 下载已有技能，之后每次发布都是这个技能的新版本，拥有管理权限的协作者同样如此。
  • 发布技能： 发布时可以选择升级版本号，并将可见范围设为私有、团队或租户。非管理员扩大可见范围需要审核。
  • 管理已发布的技能： 可以设为私有、撤回审核或从 Tego OS 删除；概览中显示服务器版本、可见范围、待审核状态和已安装的数字员工。

2. 技能版本管理 ​

  • 网页端和 Tego Studio 的每次上传都会生成一个不可更改的版本，不再原地覆盖。
  • 拥有管理权限的协作者可以在 Tego Studio 中为同一技能发布新版本，不会再多出一个同名技能。
  • 新版本发布后，已安装该技能的数字员工会自动更新，更新策略为“手动”的除外。
  • 非管理员上传的升级需要审核：通过后才发布并更新安装，被拒绝或撤回时丢弃上传的内容包。
  • 网页端和 Tego Studio 使用同一套发布规则；校验未通过时，上传对话框会显示服务器给出的具体原因。

3. Tego Studio 的附件与文档读取 ​

  • 对话中可以添加任意文件，单个文件上限 50 MB，发送的消息和输入框中都以文件标签显示。删除对话时，附件一并删除。
  • 回退一条消息时，它的文字、图片和附件都会回到输入框。
  • 数字员工可以按页、幻灯片或工作表分段读取 PDF、Word（.docx / .doc）、Excel（.xlsx / .xlsm）和 PowerPoint（.pptx / .ppt）。
  • 扫描版 PDF 的页面在模型支持图片时以图片形式发送；模型不支持时，会提示切换到支持图片的模型。
  • .xls、.odt、.rtf 等暂不支持的格式，以及扩展名与内容不符的文件，会明确提示如何处理。

4. 在 Tego Studio 中上传和跟踪插件 ​

  • 租户管理员可以在 Tego Studio 中完成插件的版本升级、构建、上传、审批和安装。
  • 上传后会等待插件后端就绪，并跟踪每个数字员工加载新版本的进度。
  • 支持回滚和启用 / 停用插件；概览中显示租户当前版本、后端状态以及已加载新版本的员工数量。
  • 管理接口新增插件在各数字员工上的部署状态查询，包括期望版本、实际版本、错误信息和是否等待重启。
  • 插件工具新增表单、会话模式、任务输入和更多字段类型，方便开发者为 Tego Studio 编写插件。

5. 数字员工的会话回收与记忆 ​

  • 会话回收： 系统每 6 小时清理一次数字员工的工作上下文，范围包括：已删除话题的会话、已删除定时任务的闲置会话、已结束的闲置子任务会话，以及闲置超过 14 天的话题会话。
  • 聊天记录保留： 回收的只是数字员工的工作上下文，用户能看到的聊天记录不受影响。
  • 重开话题： 在已回收的话题中再次发消息时，数字员工会先取回最近的对话内容再继续工作。
  • 删除前保护： 闲置话题回收前会先提取到长期记忆，提取失败则不删除；正在运行的会话和定时任务投递目标所在的话题不会被回收。
  • 长期记忆： 修复了进行中的对话不再提取长期记忆的问题，现在每轮对话结束后都会提取。

6. 定时任务用量与插件升级修复 ​

  • 修复了运行较久的定时任务在上下文压缩后丢失用量的问题；任务执行中产生的辅助用量也会计入这次任务。
  • 改进了用量记录的保存和重试，已结束的任务能可靠地保留用量，数字员工停止前也会再保存一次。
  • 修复了插件升级时跨实例会话清理失败的问题，并让插件热更新和回滚过程中的会话路径归属保持正确。

7. 管理后台 ​

  • 会话合规： 从独立入口移到“审计中心”的“会话合规”标签页。不是管理员但拥有合规菜单权限的角色，同样可以打开。
  • 会话运维： 独立入口取消，相关指标进入运维大屏的新模块，包括服务就绪状态、当前连接、待投递和投递失败的操作、归档积压与延迟、提及员工失败次数和对账差异。没有部署工作会话服务的环境不显示该模块。

8. 知识库 ​

  • 修复了部分环境中，插件托管的知识库在已恢复读取后，因服务重启又被停用的问题。
  • 公开 API 规范升级到 2.0.0，移除文档级权限接口。知识库权限只按库管理。

9. 移动端 ​

  • 聊天： 会话加载失败时显示错误和“重试”按钮，不再在空对话上显示错误横幅；会话加载完成后才能发送消息。拖动列表或点击输入框外部可以收起键盘。
  • 登录： 登录页更紧凑，手机和邮箱登录改为表单下方的文字切换；登录方式加载失败时可以重新加载；启动页和服务器配置在小屏、横屏和大字体下不再溢出或被键盘遮挡。
  • 可读性： 提高了次要文字和品牌色文字的对比度；列表、空状态、话题列表和员工切换面板在大字体下自动换行，不再被截断。
  • 消息操作： 操作按钮的点击区域更大；输入输出用量、模型等次要信息收进助手消息的详情面板。

10. 部署与安全 ​

  • 管理服务不再运行任何特权容器，服务端镜像也不再包含 Docker 命令行工具。数字员工的沙箱不受影响。
  • 离线镜像清单不再包含 docker:27-dind。
  • 修复了 Web 端一个脚本资源缺少安全响应头的问题，现在与其他静态资源一致，无需额外操作。

插件更新 ​

标书专员 2.0.1 → 2.1.0 ​

宿主要求： Host API ^1.33.0

  • 工作委托授权： 改用平台统一的授权对话框，并说明授权范围：员工会读取你参与的投标项目，并以你的名义提交草稿和问题；草稿经你审阅后才生效。员工页面的入口相应改为“授权”和“管理”。
  • 导出保存： 文档、资料、合规检查、查重、导入报告、台账、项目导出和导出模板在桌面端改用系统原生的保存方式；不支持该能力的环境仍使用原有的浏览器下载方式。

升级影响与注意事项 ​

平台 ​

数据库与回退 ​

  • 升级前请备份 Tego OS 主数据库。
  • 网页端技能编辑器的数据会被删除： 本次升级包含主库迁移 0158，会删除该编辑器的全部工作区、会话和版本数据。如有尚未发布且需要保留的内容，请在升级前发布或另行保存。
  • 迁移完成后不建议直接降级到 v5.3.0；如需回退，应同时恢复升级前的数据库和应用版本。
  • 部分已运行过此前版本的环境会再执行一次插件托管知识库的停用迁移。已恢复读取的知识库不受这次迁移影响；从未完成权限同步的知识库会保持停用，直到所属插件完成同步并恢复读取。

行为变化 ​

  • 网页端技能编辑器已移除： “创建技能”“用 AI 编辑”入口及对应页面不再提供，/ai-workspaces 接口也已删除。请改用 Tego Studio 编写技能；网页端的 ZIP 上传、技能市场、安装和权限管理不变。
  • 技能上传规则：
    • 内容与最新版本相同的上传不会产生变化；内容有变化时，版本号必须高于最新版本和技能当前显示的版本，否则上传会被拒绝。未声明版本号时按 1.0.0 处理，因此不改版本号直接覆盖的旧做法不再可用，已有上传脚本需要相应调整。
    • SKILL.md 的 name 只能包含小写字母、数字和连字符，长度不超过 64 个字符；description 不少于 20 个字符；version 须为带引号的语义化版本号；内容包最多 200 个文件。
    • 名称不符合规则的已有技能，在发布新版本时会更换为合规的名称，技能标识不变。
  • 技能自动更新： 如果希望某个安装不随上传的新版本自动更新，请将它的更新策略设为“手动”。
  • 会话回收默认开启： 重开已回收的话题时，数字员工取回的是最近的对话内容：不包含子任务输出，附件只保留文件名，内容总量也有上限。如需调整，可在数字员工的“自定义环境变量”中设置以下变量并重启：
    • TEGO_SESSION_RETENTION：on（默认）、dry-run（只统计不删除）或 off（关闭）。
    • TEGO_SESSION_IDLE_TOPIC_DAYS：闲置话题的回收天数，默认 14。
  • 定时任务用量： 此前漏计的用量现在会被计入，运行较久的定时任务，其用量统计可能高于升级前。
  • 公开 API： /knowledge-bases/{id}/documents/{documentId}/permissions 已不在公开 API 规范中，规范版本升至 2.0.0。对接了该路径的外部系统请改为按知识库管理权限。
  • 管理后台入口： “会话合规”和“会话运维”的独立入口已取消，请按上文告知相关管理员新的位置。
  • 插件发布工具： 使用插件 SDK 或 tego-plugin publish 发布员工级插件时，avatarIds 代表完整的安装范围，未列出的数字员工会被卸载。不传该参数时，升级会保留现有的数字员工，首次安装不会选中任何数字员工。

部署与配置 ​

  • 不再使用以下配置，可以从自定义配置中删除：TEGO_AI_WS_*、AVATAR_ENABLE_SANDBOX、AVATAR_DIND_IMAGE、Helm 的 components.server.sandbox.dind 和 runtimeStorage.dindImagesHostPath。
  • 管理服务的命名空间不再需要切换为特权模式。
  • Compose 部署不再挂载 /var/lib/tego/ai-ws，也无需再备份该目录；旧版本留下的目录会在执行 setup.sh uninstall 时清理。
  • 会话回收后释放的空间会被数据库复用，文件体积不一定立刻变小。存量较多的用户会分几轮回收完。

插件 ​

  • 标书专员 2.1.0 的宿主要求为 Host API ^1.33.0。
  • 工作委托的授权入口改为平台统一的对话框，请告知使用该功能的用户。

建议验收清单 ​

平台 ​

  1. 技能编写：网页端不再出现“创建技能”“用 AI 编辑”入口，ZIP 上传、技能市场和安装正常；Tego Studio 可以登录 Tego OS，并能完成技能的编辑、试用和发布。
  2. 技能版本：上传相同内容不产生新版本；内容变化但版本号未升高时被拒绝并显示原因；发布新版本后，非“手动”策略的安装自动更新，“手动”策略的安装保持原版本。
  3. 技能审核：非管理员上传的升级进入审核，通过后发布，拒绝后不生效。
  4. 文档读取：在 Tego Studio 对话中添加 PDF、Word、Excel、PowerPoint 文件，数字员工能读取内容；扫描版 PDF 在支持图片的模型下可读。
  5. 插件上传：租户管理员在 Tego Studio 中上传插件后，能看到每个数字员工的加载进度，回滚和启用 / 停用可用。
  6. 会话回收：打开一个闲置超过回收天数的话题，聊天记录完整，发送消息后数字员工能接上最近的对话。
  7. 长期记忆：完成一轮对话后，相关内容能在长期记忆中查到。
  8. 定时任务：运行一个较长的定时任务，确认用量记录完整。
  9. 管理后台：“会话合规”在审计中心可见；运维大屏显示工作会话指标，未部署工作会话服务时不显示。
  10. 知识库：确认插件托管的知识库状态符合预期，重启服务后已恢复读取的知识库不会再次停用。
  11. 部署：管理服务正常启动，且其 Pod 中没有特权容器；数字员工的沙箱可以正常使用。
  12. 移动端：断网或会话加载失败时可以重试；在小屏、横屏和大字体下，登录页、聊天页和列表显示正常。

插件 ​

标书专员 2.1.0

  1. 在员工页面发起工作委托授权，确认平台对话框显示授权范围；授权后可以通过“管理”入口查看。
  2. 在桌面端导出标书文档、台账等内容，确认弹出系统保存对话框且文件正常保存。