---
title: 使用原生运行能力
description: 使用多会话、文件预览、插件和可选执行能力。
lastVerified: 2026-09-24
---

# 3.11 使用原生运行能力

本页适用于采用 DSH **0.1.7-rc.1** 的 Teloa 当前开发版，安装包以对应版本为准；下列入口与操作说明不表示所有设备、模型和外部服务组合都已通过验收。现有安装请先看[升级与回退](https://docs.teloa.ai/markdown/deploy/backup.md)。

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

## 多会话与执行小组

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

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

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

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

## 预览文件与查看改动

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

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

Word/PowerPoint 预览使用官方 Office 转 PDF 服务，Excel/CSV/TSV 使用官方表格查看器。转换运行依赖或字体缺失时，以预览页诊断为准。文件卡片打开当前文件，不保存当时的副本；历史改动审阅可能在会话释放或宿主重启后不可用。需要留存交付版本时，使用任务成果记录。

## 管理插件

进入 **能力 → 扩展** 查看清单与状态。在 **设置 → 连接与运行环境** 内直接安装、启停和配置原生插件，配置表单会保留在设置页中。能力页的 **打开引擎管理器** 提供同一管理功能的快捷入口。

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

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

## 后台工作

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

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

## 可选能力

| 能力 | 如何开始 | 使用限制 |
| --- | --- | --- |
| Browser Use | 在插件页找到 `@teloa/native-browser`，显式启用包及 Browser Use、Playwright 两个组件；按详情配置已安装的 Chromium，再创建或恢复会话 | 默认关闭；这是助手操作浏览器的能力，与普通网页预览不同。包启用不授予岗位工具权限；真实浏览器动作及会话隔离仍需在目标环境验证 |
| Computer Use | 找到 `@teloa/native-computer`，启用包及 Computer Use、Cua 两个组件；先检查宿主系统权限 | 默认关闭；依赖平台原生组件及屏幕/辅助功能权限。多个会话共享真实桌面，只在明确指定的应用范围操作 |
| 本地语音 | 在插件页启用官方 Voice Input，按配置页准备本地识别模型；就绪后使用会话输入区的录音入口 | 首次准备可能下载模型，可取消或重试。识别结果进入草稿，由你核对并发送；它不会替你提交消息，也不代表后续对话模型本地运行 |
| 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 页面可见或配置生成成功推断通过。
