执行资源与权限

工作在哪里执行#

需要工具执行的任务，必须具备可用的账户沙箱，或显式选择已授权的实体设备。未开通沙箱且没有授权设备时，任务会明确拒绝执行。

使用自己的电脑#

• 在 ADC 或现有设备入口完成 Connector 连接和账号绑定。
• 确认设备在线，项目绑定指向正确设备与目录。
• 授权需要的文件范围和工具能力。
• 提交任务时选择这个项目，并核对操作范围。

Connector 从设备主动向平台建立连接。设备保留最终权限，平台只在已授权范围内分发请求。

权限如何生效#

一次任务的可用能力由账号权限、所选 Agent / 交互配置、设备策略、文件范围和任务请求共同约束。请求参数只能进一步选择或缩小范围。

读取项目时可以先从只读模式开始。需要修改时，再在已允许写入的项目中选择相应策略。示例中的 ID 与目录必须替换为自己的实际值：

zion chat --project PROJECT_ID --preset read-only \
  --tool read --tool glob --tool grep --tool tree \
  --file-root /path/to/your/project

共享工作区中的多任务#

同一账号使用同一沙箱工作区时，不同会话可能看到相同文件。给任务使用清楚的子目录、输出文件名与端口，避免同时覆盖同一文件。代码项目可以使用独立分支或 worktree。

停止一个任务时，应通过它的 Run ID 控制。遇到“工作区忙碌”等错误，先查看当前运行与资源状态；可用并发行为以部署版本为准。

没有资源或设备离线#

• 没有执行资源：完成账户沙箱开通，或绑定并选择已授权设备。
• 设备离线：检查设备上的 Connector 是否运行，以及网络和凭据状态。
• 文件不可见：核对执行环境、项目绑定和文件根目录。
• 权限不足：检查任务策略与设备授权，增加命令参数不会绕过限制。