DuoboxDocs

Shell 与 Agent

在当前 Space 中运行命令,并安全处理 Agent 的工具请求。

目标

理解 Shell 与 Agent 的分工,并在当前 Space 中完成一次可检查的操作。

Shell

Shell 是当前 Space 的终端,适合运行你已经知道的命令。

  1. 先打开目标 Space;
  2. Cmd/Ctrl+J 打开 Shell 面板;
  3. 运行 pwd,确认工作目录是当前 Space;
  4. 使用 Cmd/Ctrl+Shift+J 新建 Shell 标签页;
  5. 使用 Cmd/Ctrl+W 关闭当前 Shell 标签页。

切换 Space 后,Shell 会使用新 Space 的工作目录和环境。

Agent

Agent 适合需要分析项目、组合步骤或调用工具的任务。在 Chat 中直接说明目标、范围和完成条件,例如:

检查当前 Space 的 Markdown 链接。
只报告失效链接,不修改文件。

当 Agent 请求运行 Shell 或其他工具时,可以:

  • 允许一次:只批准当前操作;
  • 会话内允许:后续同类请求在当前会话中直接执行;
  • 拒绝:保留当前状态,并让 Agent 改用其他方法。

默认使用“询问”。只有明确理解命令、路径和影响时,才使用“会话内允许”。

Space 环境变量

项目级变量保存在当前 Space 的 .env 中。可以从 Space 菜单打开环境变量编辑器。凭证应使用专用变量,并确认 .env 不会进入共享内容或 Git。

完成标志

  • pwd 指向当前 Space;
  • Agent 能说明准备执行的工具和目标;
  • 执行后可以从文件变化或命令输出验证结果。

常见问题

  • Shell 提示先打开目录:先打开一个本地 Space。
  • 命令找不到:确认工具已经安装,并检查 PATH
  • Agent 一直请求确认:这是“询问”模式的预期行为。

本页内容