本地设备

扣子桌面端可以将你的个人电脑连接到扣子，让扣子 Agent 在获得授权后，帮助你处理本地电脑上的文件、文件夹和部分本地 Shell 任务。

能做什么

扣子桌面端支持连接你的本地电脑，帮助扣子 Agent 在授权范围内操作本地文件目录、处理文件内容，并执行常见的 Shell 命令。配合扣子移动端，你还可以在手机上通过语音输入向扣子 Agent 下达任务，让家中或办公室的桌面端扣子执行本地电脑上的复杂操作。
扣子已经不仅限于在云端帮你完成任务，它已经进化出了桌面的操作能力，和你的物理世界连接更紧密。
连接桌面端后，你可以让扣子 Agent 完成以下操作：

• 操作本地目录和文件：查找、读取、分析和上传本地文件；在你授权的文件夹中创建、修改文件。
• 执行 Shell 命令：运行脚本、处理数据或进行简单网络请求等 Shell 命令。

为保护你的电脑和文件安全，Agent 不会默认拥有所有权限。涉及访问受系统保护的目录、写入文件、执行高风险命令等操作时，系统会要求你确认授权。

使用限制

• 仅扣子 Agent 可以操作你的本地电脑设备。
• 通过 Agent 操作本地电脑时，请确保电脑处于唤醒状态，并已打开扣子桌面端应用程序。
• 在实际运行过程中，扣子可能会申请操作本地电脑所需的相关权限。执行高风险命令等敏感操作时，系统会先弹出确认请求，只有在你同意后才会继续执行。
• AI 模型也可能会犯错，建议不要使用此功能处理敏感数据。

如何使用

开启本地文件访问能力

首次使用前，请先安装扣子桌面端，并使用你的扣子账号登录。登录完成并授权后，桌面端会自动将当前电脑连接到你的扣子账号。你可以在设备管理页查看本地设备状态。

如果你是首次使用扣子桌面端，扣子会询问你是否允许 Agent 使用本地电脑能力。你可以根据需要开启或关闭。关闭后，Agent 将无法通过扣子桌面端访问你的本地文件或执行本地任务。
你也可以之后在桌面端的设置 > 应用和权限管理中开启或关闭该能力。

下达任务并完成授权

开启本地文件访问能力后，你可以直接在对话中告诉 Agent 想要完成的任务。例如“帮我读取下载文件夹里的报告，并总结重点。”
当 Agent 首次需要在某个文件夹中操作文件时，对话中会出现授权卡片。授权卡片会说明本次请求的操作内容、目标设备、目标文件夹和请求原因。
你可以根据需要选择：

• 本对话允许：只在当前对话中允许 Agent 操作该文件夹。
• 所有对话允许：允许该 Agent 后续在所有对话中继续操作该文件夹。
• 拒绝：不允许 Agent 操作该文件夹，当前任务将无法继续。

授权完成后，你也可以在 Agent 设置中的设备权限页面查看或修改授权状态，例如将“所有对话允许”改为“未授权”。

操作本地文件

你可以让 Agent 在授权范围内处理本地文件和文件夹，包括查看、分析、编辑、移动文件。
常见指令示例：

• 查看和查找文件：“帮我在下载文件夹里找到最近修改过的 PDF。”
• 读取和分析文件：“帮我读取这个目录下的需求文档，并总结重点。”
• 创建和编辑文件：“帮我把整理结果保存到指定文件夹。”
• 移动和整理文件：“帮我把图片文件移动到 images 文件夹中。”

执行 Shell 命令

Shell 命令可以理解为本地电脑上的命令行操作。开启本地电脑能力后，Agent 可以根据任务需要执行部分 Shell 命令，帮助你处理文件、运行脚本、调用工具或进行数据处理。
常见可执行的操作包括：

• 文件操作：创建、读取、编辑文件和目录，查找文件，压缩或解压文件。
• 开发相关：运行 Python、Node.js 等脚本，安装依赖，执行 Git 操作，管理或部署项目。
• 本地电脑操作：执行本地命令、读取或写入授权路径下的文件，必要时进行截图等操作。
• 网络相关：通过 curl 请求 API，下载文件，进行简单的网络连通性测试。
• 数据处理：清洗数据、转换格式、统计计算，或生成图表。

以下命令或操作会受到限制：

• 需要交互式输入的命令，例如 ssh、vim 等
• 需要手动输入密码的命令，例如部分 Git 推送、系统提权命令等
• 访问未授权路径的命令
• 可能影响文件安全、系统设置或网络安全的高风险命令

对于受限制或高风险的命令，扣子会根据实际情况提示你补充信息、完成授权或确认是否继续。只有在满足权限要求后，Agent 才会继续执行。
如果你不确定某条命令的影响，可以选择拒绝，并让 Agent 解释命令的作用或换一种更安全的处理方式。

管理个人电脑设备

你可以在设备管理页面查看当前账号已连接的个人电脑设备，包括设备名称、在线状态、设备 ID、设备系统等信息。
设备状态说明：

你可以在设备管理页面执行以下操作：

安全提醒

扣子桌面端让 Agent 具备访问本地文件和执行本地指令的能力。为了让你更放心地使用，扣子提供了多层保护机制：

• 你始终拥有最终控制权：Agent 在访问本地文件夹、执行敏感指令前，会先请求你的授权。你可以随时查看、修改或撤销已授予的权限，也可以关闭 Agent 对本机的访问能力。
• 默认最小权限：首次使用时，Agent 不会默认获得本地访问能力。你需要明确开启后，Agent 才能使用本地能力。文件夹授权会按 Agent 和目录分别管理，每个 Agent、每个目录都需要单独授权，互不影响。

扣子桌面端的本地能力仍在持续迭代中，Agent 可能会理解错误或执行不符合预期的操作。建议你先从熟悉、可控的场景开始尝试，避免直接授权包含密钥、财务信息或身份信息的目录。

场景演示

场景1：整理桌面文件

当桌面上积累了较多文件时，你可以让 Agent 帮你查找、分类和整理文件。
示例指令：

帮我整理桌面文件，把 PDF、图片和压缩包分别归类，并生成一份整理结果说明。

可能流程：Agent 会确认桌面目录，在你完成必要授权后，对桌面文件进行分类整理并返回结果。

场景 2 ：远程办公协作

当你不在电脑旁，但电脑已保持唤醒并打开扣子桌面端时，可以通过扣子移动端让 Agent 读取本地文件，并把处理结果交给项目成员继续确认。
示例指令：

帮我从本地设备的桌面上找到本月销售报表，整理出关键数据和异常项，然后请项目里的小李确认。

可能流程：Agent 会通过在线的桌面端访问报表文件，在获得授权后完成整理，并将结果发送给指定项目成员确认。

场景 3：托管批量任务

对于需要处理多个文件、运行脚本或生成结果文件的任务，你可以让 Agent 在本地电脑上按顺序执行。
示例指令：

帮我扫描这个目录，把所有 Markdown 文件的标题加一个前缀 Coze

可能流程：Agent 会确认任务范围，按顺序处理相关文件或脚本，并在完成后返回统计结果和报告。