---
title: 使用原生运行能力
description: 使用多会话、文件预览、扩展和可选执行能力。
lastVerified: 2026-10-22
---

# 3.11 使用原生运行能力

Teloa 社区版 **0.2.4** 使用 DSH **0.2.1-rc.2**。升级已有安装前，先看[升级与回退](https://docs.teloa.ai/v/0.2.7/markdown/deploy/backup.md)。

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

## 按任务选择执行引擎

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

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

## 多会话与执行小组

从[对话](https://docs.teloa.ai/v/0.2.7/markdown/guides/conversations.md)目录继续已有会话，或从员工页发起沟通。主会话与工作过程中打开的子会话可以同时保留；查看文件、工具记录或发送消息前，核对当前会话和业务语境。

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

AI 员工是长期存在的身份，在[AI 员工](https://docs.teloa.ai/v/0.2.7/markdown/guides/colleagues.md)页管理技能、员工记忆、资料与授权；工作群用于你与员工开展业务合作。执行助手是本次任务的临时成员，不会自动入职，也不能自行取得新的业务权限。普通会话沿用其会话权限；受管任务中的分工继续受本次授权与额度约束。

例如，营销工作群中的 Alice 负责内容，Bob 负责数据分析；两位员工可以各自组织执行小组，再各自汇总成果回群。成员之间的消息不能代替你的审批，成员完成也不等于整项任务已交付。旧子会话仍可读取与恢复，不会被标成新执行小组成员。更多概念见[AI 员工、工作群与执行小组](https://docs.teloa.ai/v/0.2.7/markdown/concepts/people.md)。

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

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

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

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

三种执行方式各有用途：

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

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

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

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

停止会请求取消已关联的子工作和后台任务；确认相关工作退出前，不能视为已停止。Teloa 重启不会自动恢复 Ralph 或重放脚本。运行成功也不代表工作质量已经过独立评审。开发接入边界见[业务能力与执行引擎边界](https://docs.teloa.ai/v/0.2.7/markdown/develop/engine-integration.md)。

## 预览文件与查看改动

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

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

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

## 管理扩展

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

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

旧市场安装若仍有待处理记录，请先到 **应用 > 应用安装记录** 完成核对或处理安装。这些记录存在时，新的原生安装会明确拒绝；对应包也不能从原生页面绕过核对启用或卸载。市场目录的白名单规则仍独立生效，详见[能力与连接](https://docs.teloa.ai/v/0.2.7/markdown/guides/capabilities.md)。

## 后台工作

从[任务](https://docs.teloa.ai/v/0.2.7/markdown/guides/tasks.md)、群交办或自动化进入相应执行记录。已纳入任务的原生后台工作归属于该次执行；初始回复结束后，如果后台工作仍未结束，任务不能据此提前交付。

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

## 可选能力

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

启用浏览器组合包后，右侧「开始 > 浏览器」提供手动网页浏览。它使用官方沙箱 iframe；网站不允许嵌入时，可在系统浏览器中打开。这个面板与助手的自动化浏览器不共享页面。

助手的 Browser Use 默认使用每个活动会话独立的无头浏览器，按需创建页签，无需提供浏览器 PID，也不会弹出本机浏览器窗口。日常网页任务优先使用这一能力；Computer Use 用于操作真实桌面或明确指定的已有浏览器，使用的是另一套工具和宿主权限。

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 页面可见或配置生成成功推断通过。

[![在连接与运行环境中查看原生能力与启用状态。](https://docs.teloa.ai/v/0.2.7/assets/screenshots/extensions-024.58d3171491f5.png)](https://docs.teloa.ai/v/0.2.7/assets/screenshots/extensions-024.58d3171491f5.png)

*0.2.4 真实界面，示例数据。*