集成终端

编程工作区的集成终端在所选工作目录中运行 shell 命令。它保留连续终端会话，并提供快捷命令、命令历史与诊断入口。终端输出和聊天中的工具结果需要分别核对。

运行前确认位置

先选定项目或 worktree，再打开终端。检查活动终端、所用 shell 与当前目录。没有有效工作目录时，先打开工作区，不从其他项目借用一个终端执行命令。

在执行构建、迁移或清理前，用 pwd（PowerShell 使用 Get-Location）和 git status --short --branch 核对位置。终端的目录和环境决定命令作用范围；聊天标题不构成目录证明。

选择执行方式

快捷项包含 git status、npm test、npm run build。它们是执行入口，不代表项目一定使用 npm；先读仓库脚本，再选择对应检查。

示例：运行项目检查

打开目标项目的终端，先核对位置，再读取 package.json 中的 scripts。下面的命令适用于提供 test 和 build 脚本的 npm 项目：

git status --short --branch
npm test
npm run build

逐条执行并检查结果；测试进入 watch 模式时，按仓库约定结束 watch 或改用它支持的单次运行参数。不要在前一条命令仍占用终端时，把后续命令当成已执行。

终端是持续会话，前面执行的 cd、环境变量或虚拟环境会影响后续输入。快捷命令也发送到这个活动 shell，不会自动创建一个干净环境。退出码应在目标命令结束后立即检查。

运行开发服务器时，保留对应会话并记录端口。要在服务器运行期间执行测试，使用另一个终端会话；关闭一个面板不能作为服务器已经停止的证明。

判断命令是否完成

命令进入终端不等于执行成功。检查进程是否仍在运行、退出状态、完整错误和预期产物。测试通过后确认测试覆盖了本次修改；构建成功后确认目标产物存在。

持续服务与一次性命令分别管理。终端显示输出停止，不代表后台服务已经退出。中断前确认该进程属于当前任务，避免停止其他项目的服务。

历史、诊断与敏感信息

命令历史按工作目录组织，用于找回执行过的输入，不替代命令结果。清理输入历史也不等于清理终端输出、日志或外部系统记录。

不要把 token、完整环境变量或含秘密的连接串直接写入命令。分享诊断前检查目录、账号、请求内容及日志中的敏感字段，保留能定位问题的错误和时间信息。

常见处理

隔离目录的选择见Git worktree，差异验收见代码审阅与变更处理。