26 · 终端集成

┌──────────────────────────────────────────────────┐
│                   AI 大脑层                        │
│  ┌──────────┐  ┌──────────────┐  ┌────────────┐  │
│  │ 错误检测  │  │ 修复建议生成  │  │ 命令规划   │  │
│  └─────┬────┘  └──────┬───────┘  └─────┬──────┘  │
│        │              │                │          │
│  ┌─────┴──────────────┴────────────────┴──────┐   │
│  │          终端上下文管理（Terminal Context） │   │
│  └───────────────────┬───────────────────────┘   │
├──────────────────────┼──────────────────────────┤
│   集成层              │                          │
│  ┌────────────────────┴───────────────────────┐  │
│  │    终端观察器（Terminal Watcher）           │  │
│  │  · 实时读取 stdout/stderr                   │  │
│  │  · 解析 ANSI 转义码                         │  │
│  │  · 缓存最近输出行                           │  │
│  └────────────────────┬───────────────────────┘  │
│                       │                          │
│  ┌────────────────────┴───────────────────────┐  │
│  │    Xterm 渲染引擎 + Shell 进程管理层         │  │
│  └────────────────────┬───────────────────────┘  │
├───────────────────────┼─────────────────────────┤
│   底层                │                         │
│  ┌────────────────────┴───────────────────────┐  │
│  │   终端模拟器 (基于 xterm.js)                │  │
│  │   · 前端渲染层 (VS Code Terminal Protocol)  │  │
│  │   · Shell 配置：zsh/bash/pwsh + profile    │  │
│  └────────────────────────────────────────────┘  │
└──────────────────────────────────────────────────┘

┌───┬───┬───┬──────────────────────────┐
│ 1 │ 2 │ + │  ... "zsh"              │
│   │   │   │                          │
│ bash│zsh│node│                        │
└───┴───┴───┴──────────────────────────┘

终端输出示例：

$ npm run build
> my-app@1.0.0 build
> vite build

vite v5.0.0 building for production...
✗ [ERROR] Could not resolve "./utils/api"
    src/pages/user.tsx:4:30:
      4 │ import { fetchUser } from "./utils/api"
        ╵                         ~~~~~~~~~~~~~~

  The module "./utils/api" does not exist in the file tree.

你在终端里：
npm run test

AI 看到 3 个测试失败后，指出：
"测试文件 tests/user.test.ts 中的第 42 行引用了
一个已删除的接口 getUserProfile。建议将引用更新为
getProfile()，这是该接口的替代实现。"

你点击修复 → AI 自动修改文件 → 你看到 diff → 接受

你：帮我启动开发服务器
AI：[运行] npm run dev
你：帮我检查端口 3000 是否被占用
AI：[运行] lsof -i :3000

你：帮我启动后端服务器，然后在它运行的时候给我看 API 路由

AI：
[步骤 1] 运行 npm run server
- 输出：Server started on port 4000
- 命令保持运行中（监控中）

[步骤 2] 运行 npx api-routes --list
- 输出：GET /users  POST /users  GET /posts ...

AI 继续监控服务器的实时日志...

@terminal 帮我看一下这个 build 报错是哪里的问题

你在终端中运行：
$ npm run build

输出一堆错误。你无需复制粘贴，只需在 Chat 中输入：

@terminal 这些构建错误是什么原因？有没有统一的解决方向？

AI 会分析整个 build 输出，给出概括性的解释：
"所有 5 个错误都是因为 utils 目录重构后，
路径变了但部分文件没有更新 import 路径。
建议使用项目的别名路径 @/utils/ 来统一解决。"

{
  "terminal.integrated.shell.osx": "/bin/zsh",
  "terminal.integrated.shell.linux": "/bin/bash",
  "terminal.integrated.shell.windows": "C:\\Program Files\\PowerShell\\7\\pwsh.exe"
}

{
  "terminal.integrated.profiles.osx": {
    "zsh": {
      "path": "/bin/zsh",
      "args": ["-l"]
    },
    "bash": {
      "path": "/bin/bash",
      "args": ["-l"]
    },
    "fish": {
      "path": "/opt/homebrew/bin/fish",
      "args": ["-l"]
    }
  },
  "terminal.integrated.defaultProfile.osx": "zsh"
}

{
  "cursor.terminal.enableAiDetection": true,
  "cursor.terminal.enableAutoFixSuggestions": true,
  "cursor.terminal.contextLines": 50
}

阶段 1 — 终端 1：运行后端
[你] 启动开发服务器
[Agent] 执行 npm run dev
[终端 1] 服务器启动在 :4000，Agent 持续监控日志

阶段 2 — 终端 2：运行前端
[你] 再建一个终端，启动前端
[手动] Ctrl+Shift+` → npm run dev -- --port 3000
[终端 2] 前端启动，同时存在

阶段 3 — 终端 3：测试 API
[你] 用 curl 测试你的新端点
[手动] curl http://localhost:4000/api/users
[报错] 500 Internal Server Error
[AI] 检测到错误 → 分析日志 → 指出路由冲突
[你] 点击修复 → AI 修改路由配置 → 一键重跑 curl
[终端 3] 返回 200 OK

{
  "terminal.integrated.cwd": "${workspaceFolder}/backend"
}