17 · 终端使用

AI 对终端的感知清单
├── 当前工作目录（pwd）
├── 已执行的命令历史（按顺序）
├── 每条命令的退出码（0=成功，非0=出错）
├── 输出中的重要信号
│   ├── ERROR / error / Error
│   ├── Traceback (Python 异常)
│   ├── failed / FAILED
│   ├── warning / Warning
│   └── 编译/构建错误行
└── 活跃的进程（如 dev server、watch 模式）

你：（什么也没说，切到 Chat）
Chat AI：我检测到你在终端中运行 npm run dev 时遇到了模块安装错误
         `Module not found: can't resolve 'react-dom'`。
         需要我帮你安装 react-dom 吗？

┌─ AI 执行命令的安全层级 ──────────────┐
│                                      │
│  只读操作（读取、查看）       ← 直接执行  │
│  ├── git status / diff / log          │
│  ├── ls / cat / head                  │
│  ├── pwd / which / type               │
│  └── npm ls / pip list                │
│                                      │
│  一般操作（安装、构建）       ← 确认后执行│
│  ├── npm install / yarn add           │
│  ├── npm run build / tsc              │
│  └── git add / git commit             │
│                                      │
│  危险操作（删除、覆盖）       ← 必须你手动│
│  ├── git push / git rebase --force    │
│  ├── rm -rf / mv (覆盖)              │
│  └── 生产环境部署命令                 │
│                                      │
└──────────────────────────────────────┘

你：帮我把这个项目跑起来

AI：先看看项目结构...
    → package.json 中有 start 脚本
    → 运行 npm install（已安装，跳过）
    → 运行 npm run dev
    ┌─────────────────────────────────┐
    │ ⚠ AI 将执行: npm run dev       │
    │ [确认执行] [修改命令] [取消]     │
    └─────────────────────────────────┘

你点确认 → 终端自动运行 npm run dev → dev server 启动 → 右侧 Webview 预览

你在终端执行命令
    ↓
命令报错（退出码非 0）
    ↓
AI 实时捕获输出
    ↓
AI 分析错误类型
    ├── 语法错误 → 指出具体行号
    ├── 依赖缺失 → 建议安装命令
    ├── 配置错误 → 指出配置文件
    ├── 类型错误 → 建议修复类型
    └── 运行时错误 → 分析调用栈
    ↓
终端内显示修复建议
    "检测到错误，需要我帮你修复吗？"
    ↓
确认 → AI 自动执行修复

$ python app.py
Traceback (most recent call last):
  File "app.py", line 3, in <module>
    import requests
ModuleNotFoundError: No module named 'requests'

────────────────────────────────────────────
🔍 AI 检测到错误：缺少 requests 模块
  建议修复：pip install requests
  [一键安装] [查看详情]
────────────────────────────────────────────

$ npx tsc
src/user.ts:42:3 - error TS2322: Type 'string | undefined' is not assignable to type 'string'.

────────────────────────────────────────────
🔍 AI 检测到错误：类型 'string | undefined' 不能赋值给类型 'string'
  位置：src/user.ts:42
  建议：使用可选链或默认值处理 undefined
  [显示修复方案] [打开文件到指定行]
────────────────────────────────────────────

你：报错了，帮我看看
    （你没有粘贴任何终端输出）

AI：（已在上下文中获取到终端最近输出）
    我注意到你在运行 `npm run build` 时遇到了 webpack 打包错误：
      - 错误文件：src/components/Header.tsx:24
      - 错误类型：未使用的变量 'unusedVar'
      - 解决方案：删除未使用的变量或添加下划线前缀

Builder 创建项目
    ↓
AI 执行: npx create-react-app my-app --template typescript
    ↓
终端输出实时回流 → AI 读取到 "Success! Created my-app"
    ↓
AI 继续下一步: cd my-app && npm install @tanstack/react-query
    ↓
终端输出回流 → AI 检查退出码 → 0（成功）
    ↓
继续下一步...

      终端执行命令
         │
         ▼
   ┌─────────────┐
   │ 终端输出流   │──→ 你看到（实时显示）
   └──────┬──────┘
          │
          ▼
   ┌─────────────┐
   │ AI 上下文    │──→ AI 理解并响应
   │ 缓存（最近N条│
   │ 命令+输出）  │
   └─────────────┘
          │
          ▼
   ┌─────────────┐
   │ Chat/Builder│──→ 你不用复制粘贴
   │ /SOLO 会话  │     AI 已经有了上下文
   └─────────────┘

{
  "terminal.integrated.profiles.windows": {
    "PowerShell": { "path": "pwsh", "args": ["-NoLogo"] },
    "Command Prompt": { "path": "cmd" },
    "Git Bash": { "path": "C:\\Program Files\\Git\\bin\\bash.exe" }
  },
  "terminal.integrated.profiles.osx": {
    "zsh (默认)": { "path": "zsh" },
    "bash": { "path": "bash" },
    "Python REPL": { "path": "python3" }
  },
  "terminal.integrated.defaultProfile.osx": "zsh (默认)"
}

{
  "terminal.integrated.cwd": "${workspaceFolder}",
  "terminal.integrated.env.osx": {
    "NODE_ENV": "development"
  },
  "terminal.integrated.shellArgs.osx": []
}

AI 对用户终端的长期记忆
├── 你常用哪些命令
│   ├── npm / yarn / pnpm（偏好哪个包管理器）
│   ├── git 工作流（rebase 还是 merge）
│   └── 构建工具（webpack / vite / tsc）
├── 你的项目目录习惯
│   ├── 前端项目从哪个目录启动
│   └── 后端项目常用的端口号
├── 你偏好的启动方式
│   ├── npm run dev
│   ├── docker-compose up
│   └── python manage.py runserver
└── 你常犯的错误
    ├── 总会忘记装某个依赖
    └── 某种模式容易打错命令

你：帮我跑项目
AI：好的，我看到 package.json，要执行 npm run dev 吗？

你：帮我跑项目
AI：根据你之前的习惯，这个项目你通常先用 `npm install`，
    然后用 `npm run dev`（端口 3000）。
    这次要从头开始还是继续之前的工作？
    需要我一起执行吗？

你：npm run build 报错了
AI：这个错误你上周遇到过三次，都是因为 .env.local 中缺少
    API_KEY 变量。要我把上次的修复方案直接应用吗？

{
  "trae.terminal.aiLearning": {
    "enabled": true,
    "learnFromHistory": true,
    "learnFromErrors": true,
    "maxHistoryLines": 1000
  }
}

你：帮我记录一下这个项目常用的命令

AI：根据你的使用情况，这个项目的常用命令是：
    - npm run dev → 启动开发服务器（端口 5173）
    - npm run build → 构建生产版本
    - npm run test:watch → 持续运行测试
    - npm run lint → 代码检查
    要我创建一个 .trae/commands.md 文件保存下来吗？

你：帮我在 8080 端口跑一个 Python 的 HTTP 服务器，只允许本地访问

AI: 执行 python3 -m http.server 8080 --bind 127.0.0.1
    ┌─────────────────────────────────┐
    │ ⚠ AI 将执行: python3 -m         │
    │   http.server 8080 --bind       │
    │   127.0.0.1                     │
    │ [确认执行] [修改命令] [取消]     │
    └─────────────────────────────────┘