Tobs

文档

工作区授权

查看 Bot 可用的文件夹,区分文件夹授权、任务权限与工具批准。

打开 Bot 私聊 → 频道设置 → 工作区授权(聊天顶部 ··· 菜单 → 频道设置…)。授权属于这个 Bot。文件夹出现在 DSH 左侧工作区列表中,不等于所有 Bot 都获得了访问权。

核对文件夹

展开 工作区授权。Bot 自己的 Memory Repository 单独显示;已授权文件夹可展开查看完整 Host 路径及控件。路径操作会在 Host 打开,或下载到当前设备,详见在 Host 上打开文件。

隔离 Bot 的 Memory Repository 与文件夹授权入口

添加文件夹

  1. 点击 添加文件夹。
  2. 在选择器中浏览到目标 Host 目录;Host 提供原生选择器时,使用该选择器。
  3. 确认选择,等待授权完成,再核对新行里的实际路径。
  4. 告诉 Bot 哪个任务需要使用它。新 Assignment 仍须选择有效的 Workspace Grant;只在聊天里提到路径不会授权。

Workspace Grant 允许 Bot 的 Orchestrator 读取该目录,使用它的 Assignment 可以在其中读写。文件夹的 允许 Bot 写入此文件夹 开关是另一次明确选择,用于 Orchestrator 直接写入。工具批准与原生执行限制仍然适用。移除文件夹授权会撤销 Grant;隐藏侧栏项目不会撤销授权。

新任务权限

控件 作用范围
新事项允许所有文件访问:关闭 新 Assignment 默认使用 workspace-write 与逐次询问。
打开后,再确认启用 将今后的 Assignment 设为 danger-full-access 与 never;仍然需要所选 Grant。启用前阅读确认提示。
已存在的 Assignment 保持已保存的权限快照,修改默认值不会重配它。
已保存的工具批准规则 为记录中的 Bot 角色和 Workspace Grant 范围,回答今后匹配的工具请求;查看详情后可单独撤销。

新事项开关不改变 Orchestrator 权限。单个文件夹的 Orchestrator 写入、新 Assignment 访问范围、工具批准是不同控件。

开发者模式 还会显示手动输入 Host 路径、已注册文件夹和已撤销授权历史。日常配置使用 添加文件夹;不要仅凭保存过的文本路径推断授权成立。

截图展示真实初始状态,本次教程截图没有添加文件夹或扩大权限。任务被拒绝时,打开它的会话,核对所选目录、访问模式和实际工具结果,不要仅凭看到了文件夹就认为执行一定成功。

事项等待审批时

没有 Subagent 后代的 Assignment 等待工具审批时,可以释放运行名额。卡片会显示「等待审批,暂不占用事项运行名额」;其他工具必须已结束。这不会解除 Orchestrator 自己的审批或群聊隐私请求等待。

  1. 在 Bot 设置中把 Assignment 并发上限设为 1。请 Bot 创建一个执行无害命令、需要审批的事项,检查准确输入,暂不批准。
  2. 发送一条无关消息。这个独立事项等待期间,Bot 仍能回复。
  3. 请 Bot 创建第二个事项,执行无害的 45 秒等待;批准第二张卡片,并核实命令已经真正开始。
  4. 第二个事项运行时批准第一个请求。原卡片显示「审批决定已收到;等待运行名额后继续原调用」。第二个事项释放名额后,才执行第一个命令。
  5. 打开原 Session,核对实际工具结果。若在原调用等待名额时移除文件夹授权,原调用会被拒绝,不执行。

最多 32 个 Assignment Session 可以独立等待审批;运行名额已满时,新事项仍会被拒绝。Host 重启后,中断事项需要检查,旧审批卡不能自动恢复或重放命令。

相关教程:设置指南、侧栏总览。

在 GitHub 查看原文