跳到正文
社区版开源 Web · 0.2.2 发行文档 · 0.2.2内容核对:2026-10-18查看 Markdown

3.11 使用原生运行能力 ​

Teloa 社区版 0.2.2 使用 DSH 0.2.1-rc.2。升级已有安装前,先看升级与回退。

DSH 负责会话、工具执行和扩展生命周期;Teloa 保留业务归属、员工授权、审批与交付验收。启用一个扩展,不会自动授权所有员工使用它。

按任务选择执行引擎 ​

主会话由 DSH 运行,独立工作可委派给已配置的 Codex 或 Claude Code/Claude Agent。例如:“这次用 Codex 检查代码”“让 Claude Agent 分析这些文件”,或“自动选择合适引擎”。本次选择不修改永久偏好,也不自动切换聊天模型。

在 设置 > 连接与运行环境 核对对应执行提供方,按其提示准备认证;引擎不可用时先处理具体缺项,原任务保留。外部引擎使用其原生权限,每次启动需本人同意;Teloa 的文件范围与逐项审批不会自动传入,确认前核对其工作目录及权限。结果返回原工作,启动受理不等于任务已完成。

多会话与执行小组 ​

从对话目录继续已有会话,或从员工页发起沟通。主会话与工作过程中打开的子会话可以同时保留;查看文件、工具记录或发送消息前,核对当前会话和业务语境。

当前组合启用执行小组。普通会话的主助手或某位 AI 员工都可以围绕当前任务发起小组,不要求先创建工作群。需要分工时,说明每位执行助手的目标、依赖与最终汇总方式,在会话的执行小组界面查看成员和工作记录。

AI 员工是长期存在的身份,在AI 员工页管理技能、员工记忆、资料与授权;工作群用于你与员工开展业务合作。执行助手是本次任务的临时成员,不会自动入职,也不能自行取得新的业务权限。普通会话沿用其会话权限;受管任务中的分工继续受本次授权与额度约束。

例如,营销工作群中的 Alice 负责内容,Bob 负责数据分析;两位员工可以各自组织执行小组,再各自汇总成果回群。成员之间的消息不能代替你的审批,成员完成也不等于整项任务已交付。旧子会话仍可读取与恢复,不会被标成新执行小组成员。更多概念见AI 员工、工作群与执行小组。

选择运行模式与执行方式 ​

新会话的输入框显示当前模式,默认为 标准模式,可为本次会话改选;会话开始后模式固定,并显示在会话标题旁。在 设置 > Agent 预设 中可把某个模式 设为新任务默认。PTC 模式和极简模式需先在 设置 > 通用设置 开启 开发者工具 才会出现。员工可在员工配置中指定工作模式;创造模式仅限本人会话,不能用于员工。

模式适合什么工作
标准模式默认选择,分析资料、使用工具并交付工作成果,适合大多数任务
PTC 模式包含标准模式的能力,通过 run_code 组合工具调用,适合批量处理结果并筛选、整理、去重、统计或汇总
极简模式只用终端和图片读取工具,适合测试和对比基础表现
创造模式用对话定制 DSH:编写插件添加功能或界面,或组合工具和提示词创建自己的模式;仅限本人会话

本人将默认模式设为创造模式时,未固定模式的员工使用标准模式。群内消息路由始终使用标准模式,个人切换模式不会改变群的业务身份。

三种执行方式各有用途:

  • Workflow:按步骤编排。 例如先并行整理两份资料,再比较差异并汇总。支持官方前台和后台执行;受管任务中的后台工作保留任务归属和停止入口。
  • PTC:用代码调用工具。 程序可以组合已提供的工具;内层每次工具调用仍检查员工的工具及参数授权。
  • Ralph:围绕同一目标迭代。 只在本人明确要求 Ralph 或使用新助手逐轮迭代时使用。每轮使用新的执行助手,根据同一个目标和上一轮的结构化交接继续工作,不继承父会话或上一轮的对话历史。当前在前台运行,不代替定时自动化。

为员工使用这些能力时,先暂停该员工,在 可授予权限 中选择对应能力,保存后恢复在岗。员工授权不会代替逐次确认;每次脚本或 Ralph 执行仍需本人批准。如果当前权限模式不允许人工确认,先切换到可确认的权限模式。

脚本直接访问文件或网络时,不经过员工的工具调用白名单;网页工具的域名限制也不会限制整段脚本的网络访问。批准前应核对完整脚本的访问范围,实际访问能力取决于运行环境和原生沙箱。

受管子工作与执行小组共用每次运行的数量和层数限额。当前组合的 Ralph 最多 6 轮;每次 Workflow、PTC 或 Ralph 调用在审批后开始执行计时,达到 10 分钟时请求取消,原生运行器的较短超时仍可能提前结束执行。这些不是精确的 token 或金额预算,取消后的退出收尾也可能超过该时间。受管派生助手不能使用本人扩权,也不能借用负责人的员工记忆写入或群发言身份。成果由负责员工汇总交回,再按业务要求验收。

停止会请求取消已关联的子工作和后台任务;确认相关工作退出前,不能视为已停止。Teloa 重启不会自动恢复 Ralph 或重放脚本。运行成功也不代表工作质量已经过独立评审。开发接入边界见业务能力与执行引擎边界。

预览文件与查看改动 ​

  1. 在会话中打开“本轮文件”的文件名,或点击原生交付卡片的侧栏预览入口。
  2. 右栏按文件格式提供 Markdown、代码、图片、PDF、HTML、Office 文档或表格预览。文件更新后,按提示重新载入。
  3. 若要查看文本修改,先在 设置 > 通用 > 开发者工具 开启开关;完成一轮文件编辑后,点击 在侧边栏查看本轮改动,可切换左右或单栏对比,并打开整个文件。

“本轮文件”来自成功的原生文件写入或编辑。用命令生成文档后,可以要求助手“把最终文件作为交付文件展示”,由原生 present 提供卡片;仅在回复中写一个文件名不等于生成或交付成功。

Word/PowerPoint 预览使用官方 Office 转 PDF 服务,Excel/CSV/TSV 使用官方表格查看器。转换运行依赖或字体缺失时,以预览页诊断为准。文件卡片打开当前文件,不保存当时的副本;历史改动审阅可能在会话释放或 Teloa 重启后不可用。需要留存某一版文件时,在 工作概览 中预览该文件并点 保存工作成果,它作为本机工作成果保留版本;需结项的交付在任务中选择成果版本。

管理扩展 ​

在 设置 > 连接与运行环境 查看原生扩展清单,并直接安装、启停和配置;排查用 设置 > 组件状态。

  1. 查看扩展说明、来源、版本、组件与诊断。已列出的内置可选包无需重复安装。
  2. 添加新的可信扩展时,使用原生安装页选择来源,并阅读依赖或构建脚本提示。
  3. 安装完成后,单独点击 立即启用,或在列表中启用。按扩展详情完成配置;若显示需要重启,安排 Teloa 重启后再验证实际调用。
  4. 停用保留安装文件,卸载移除可卸载的扩展包。Teloa 必需组件的启停或移除入口受保护。

旧市场安装若仍有待处理记录,请先到 应用 > 应用安装记录 完成核对或处理安装。这些记录存在时,新的原生安装会明确拒绝;对应包也不能从原生页面绕过核对启用或卸载。市场目录的白名单规则仍独立生效,详见能力与连接。

后台工作 ​

从任务、群交办或自动化进入相应执行记录。已纳入任务的原生后台工作归属于该次执行;初始回复结束后,如果后台工作仍未结束,任务不能据此提前交付。

停止后等待相关工作退出并核对最终状态。官方本地后台进程在 Teloa 重启后不会继续运行;重启后按中断记录处理,先确认此前的实际结果,再决定是否重试。取消不会撤销已经完成的外部操作。

可选能力 ​

能力如何开始使用限制
Browser Use在 设置 > 连接与运行环境 的扩展清单里找到 @teloa/native-browser,显式启用包及 Browser Use、Playwright 两个组件;按详情配置已安装的 Chromium,再创建或恢复会话默认关闭;这是助手操作浏览器的能力,与普通网页预览不同。包启用不授予员工工具权限;真实浏览器动作及会话隔离仍需在目标环境验证
Computer Use找到 @teloa/native-computer,启用包及 Computer Use、Cua 两个组件;先检查运行 Teloa 的电脑的系统权限默认关闭;依赖平台原生组件及屏幕/辅助功能权限。多个会话共享真实桌面,只在明确指定的应用范围操作
本地语音默认已启用。首次点会话输入区的录音入口时,按提示准备本机 SenseVoice 模型并允许麦克风只显示入口不会下载或录音;准备可取消或重试,取消后草稿保留。可在设置中停用,之后启动保留你的选择。识别结果进入草稿,由你核对并发送;它不会替你提交消息,也不代表后续对话模型本地运行
Auto review首次启动即装载官方实验扩展;需要时在普通会话的权限选项中主动选择装载不改变会话的默认权限;它采用更宽的执行模式,不是人工审批的替代。Teloa 受管任务及其派生会话处于 Auto 或 Full access 时,后续工具执行会被业务守卫拒绝

Browser 与 Computer 的网页提交、点击和输入不受文件工作区边界约束。先用测试页面或测试窗口验证;停止或取消后重新读取状态,再决定下一步。已安装、已启用、具备系统权限和实际可用是四种不同状态。

在普通会话点击停止后,会通过官方关闭工具收回该会话的浏览器页面,保留聊天记录和排队消息,不影响其他会话。关闭未获授权时,输入框附近会显示未确认提示;关闭已经发出但超时或异常时,该会话暂停后续浏览器操作,普通聊天仍可继续,也可新建会话。

受管任务继续使用原有收尾检查。停止不会撤销已经完成的外部操作。

Auto review 停用时,官方可能把仍处于 Auto 的会话切换为 Full access。继续普通会话前核对权限模式;Teloa 受管执行仍拒绝这种扩权状态。

SSH 与无界面执行 ​

远端能力仅通过官方 SSH + Headless 独立运行。@teloa/native-remote 是配置生成器,不是 Web 扩展,也不能让当前 Web 会话直接使用远端路径。

由部署者准备 OpenSSH 主机别名、已验证的主机密钥、远端 Node、匹配版本的官方 helper 及其校验值,再向生成器提供独立工作目录。生成器只创建新的配置目录,不连接、部署或启动远端服务;已有目录不会被覆盖。随后按随包说明使用官方 dsh --profile … --json 运行,续接时指定原会话 ID 和相同工作目录。

只读或工作区写入边界由官方远端服务执行。断线可能留下未确认结果,不能自动重放外部写操作。SSH、Headless 及平台相关能力须单独完成真实环境验收;不由 Web 页面可见或配置生成成功推断通过。