终端与命令路由

概述

wescode 对 AI 执行的终端命令实施三类路由策略，根据命令的性质自动分流到不同的执行环境。这一设计让 AI 能高效地后台检索信息，同时确保用户对关键操作保持可见性和控制权。

三类命令路由

检索 / 探索（静默执行）

AI 在后台静默执行的只读命令，用户不会看到终端输出干扰。

典型命令：

• rg（ripgrep 搜索）
• git status、git log、git diff
• ls、cat、wc
• find、head、tail

这类命令仅用于收集信息，不产生副作用，因此无需用户关注。

验证 / 构建（只读终端 Tab）

编译、测试、lint 等验证类命令，在专用的只读终端 tab 中执行，tab 名称带有 [AI] 前缀。

典型命令：

• go build ./...、go vet ./...、go test ./...
• npm test、npm run build
• cargo test、cargo build
• pnpm lint、pnpm check

用户可以随时查看 AI 的验证输出，但不能在该 tab 中输入。AI 会根据验证结果决定下一步操作。

服务 / 交互（用户终端 Tab）

需要持续运行或需要用户交互的命令，在 VS Code 集成终端的常规 tab 中执行。

典型命令：

• npm start、npm run dev
• npm install
• docker compose up
• 其他需要用户输入的交互式命令

路由优先级

命令路由按以下优先级判定：

1. user_visible=true → 交互模式（用户终端 tab）
2. isVerificationCommand() 匹配 → 验证模式（只读终端 tab + mirrorSession）
3. 默认 → 检索静默模式（后台执行）

AI 在调用 exec 工具时会自动判断命令类型并选择合适的路由，无需用户手动指定。

使用方式

查看 AI 执行的命令

• 验证类命令：查看终端面板中带 [AI] 前缀的 tab
• 交互类命令：查看终端面板中的常规 tab
• 检索类命令：输出包含在 Chat 面板的工具调用结果中

后台进程

AI 可以通过 background=true 参数在后台启动长期运行的进程（如开发服务器）。后台进程完成时，AI 会收到通知并据此继续工作。

注意事项

• AI 执行的所有命令都在当前工作区目录下运行
• exec 工具的 CWD 优先级：显式 cwd 参数 > 项目根目录 > Scratch 目录
• 超时和配额可在设置中调整
• AI 不会在你未打开的工作区中执行命令