1.2 0.2.8 新功能上手

0.2.8 主要补齐三件事：业务系统调用员工时的执行边界与自动交付、员工包资料的完整使用路径，以及市场创建与 Agent 预设的日常入口。已有安装先按升级与回退保留原数据和安装身份；不需要重新创建员工或迁移会话。

1. 员工 API：按请求指定权限模式和模型

打开 设置 > 员工对外调用，创建或编辑集成时仍然先确认员工、业务范围、有效期和 read/execute/cancel 权限。真正发起工作时，POST /api/v1/works 和续做请求可以额外携带：

• permissionMode：danger-full-access、workspace-write 或 read-only。新工作不传时默认 danger-full-access；续做不传时继承上一轮。
• model：{provider, model, reasoningEffort?}。不传时使用员工配置的默认模型。

权限模式只决定本轮执行边界，不能绕过集成本身的 execute 权限、员工工具授权和工作台审批。选择后仍会校验当前预设和模型目录；不可用时明确失败，不会悄悄换档。

默认是最高执行边界

新工作不传 permissionMode 时默认 danger-full-access。这适合确实需要完整本机执行的任务，不应作为业务系统的常规默认；建议显式传 workspace-write 或 read-only，并先确认员工工具授权与审批规则。

例如最小化写入范围：

{"employeeId":"<员工 ID>","input":"核对这份订单并给出结论","permissionMode":"workspace-write"}

固定成功结果会自动完成同一件事：生成正式成果、完成关联任务、更新工作进展。调用方按 result 读取固定正文和校验和；执行成功不等于业务验收。

员工 API / SDK / MCP 指南

2. 员工包资料：预览、按岗位检索、批量加入检索

员工包里的资料不再只有文件名：

• 打开员工资料或群来源中的资料条目，可以先读正文和版本，再决定是否引用。
• 在员工单聊中，检索范围跟随该员工的岗位资料范围，不会因为同一台机器上有其他人的资料就扩大。
• 资料库的员工分组新增 全部加入检索（N）：一次按员工把其有效资料按来源去重加入本地检索；检索模型未准备时先引导准备，不静默跳过。

已有员工包的更新和卸载仍保留身份、历史、共享资料保护和事务切换；卸载前的影响预览会列出会被清理或保留的内容。

3. 市场创建菜单：技能和应用

市场的 创建 菜单现在包含：

• 创建 AI 员工
• 创建 AI 团队
• 创建技能
• 创建应用
• 导入模板
• 导入技能

创建技能/应用后仍在原工作台完成编辑和启用；创建入口不自动安装、不扩大权限，也不替代审核。

4. Agent 预设：标准内置，PTC 名称更准确

• Teloa 标准模式 现在归入 内置 预设分组；原有标准模式保留，避免已有会话失效。
• PTC 代码模式分为：
  • 代码模式（保留变量）：在当前 Agent 的代码运行会话中跨多个 run_code 调用保留变量、函数和导入模块；内存不落盘，重启、取消、超时或 Agent 重启后清空。
  • 代码模式（Python）：使用 Python 执行 run_code，沿用当前文件权限与审批规则。

预设决定执行方式，员工工具授权决定能否使用具体工具，两者不能互相替代。见原生运行能力与执行权限。

5. 设置与侧栏

设置页的分类现在有分隔线和层级，日常偏好、模型与服务、能力与连接、工作方式、高级分组更易扫读。非中文界面的侧栏品牌不再与新建/搜索按钮重叠；窗口变窄时以实际布局为准。

6. 安全基线

本版容器运行时和文档安装基线为 Node.js 24.22.1。升级已有安装前仍应先备份；原生安装的 Node 要求与 Docker 镜像内运行时分别核对，见安装与运行。

下一步

• 第一次安装：完成安装与运行，再配置模型。
• 第一次让员工工作：首项任务和首支团队。
• 需要业务系统接入：员工 API / SDK / MCP。

界面细节以实际安装版本为准；本文中的入口对应 0.2.8。