OpenCode 接入 GPT-5.1-CodexMax 完整指南

1node -v

1# 安装 nvm 后执行
2nvm install 20
3nvm use 20
4node -v

1curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
2# 重开终端后执行
3nvm install 20
4nvm use 20

1npm -v

1curl -fsSL https://opencode.ai/install | bash

1irm https://opencode.ai/install.ps1 | iex

1npm install -g opencode

1brew install opencode

1opencode --version

1# 一键脚本用户
2curl -fsSL https://opencode.ai/install | bash
3
4# npm 用户
5npm update -g opencode
6
7# Homebrew 用户
8brew upgrade opencode

1cd ~/projects/my-app
2opencode

1# 退出后执行
2curl -fsSL https://opencode.ai/install | bash
3# 再启动
4opencode

1opencode
2# 启动后按 Ctrl+C 退出

1# macOS / Linux
2ls -la ~/.opencode/
3
4# Windows PowerShell
5ls $env:USERPROFILE\.opencode\

1-rw-r--r--  1 user  staff   142 Sep 2 10:00 config.json
2-rw-r--r--  1 user  staff    89 sep 2 10:00 auth.json
3drwxr-xr-x  3 user  staff    96 sep 2 10:00 sessions/

1# 用 VS Code 打开
2code ~/.opencode/config.json
3
4# 或用 Vim
5vim ~/.opencode/config.json
6
7# Windows 用户
8notepad $env:USERPROFILE\.opencode\config.json

1{
2  "$schema": "https://opencode.ai/config.json",
3  "provider": {
4    "openai": {
5      "npm": "@ai-sdk/openai",
6      "name": "OpenAI",
7      "options": {
8        "baseURL": "https://api.openai.com/v1"
9      },
10      "models": {
11        "gpt-5.1-codexmax": {
12          "name": "GPT-5.1 CodexMax",
13          "temperature": 0.2,
14          "maxTokens": 16384,
15          "contextWindow": 262144,
16          "tools": true,
17          "reasoning": true,
18          "reasoningEffort": "high",
19          "agentic": true,
20          "maxSteps": 50
21        },
22        "gpt-5.1": {
23          "name": "GPT-5.1 通用",
24          "temperature": 0.7,
25          "maxTokens": 8192,
26          "contextWindow": 131072,
27          "tools": true,
28          "reasoning": false
29        },
30        "gpt-5.1-mini": {
31          "name": "GPT-5.1 Mini",
32          "temperature": 0.5,
33          "maxTokens": 4096,
34          "contextWindow": 65536,
35          "tools": true,
36          "reasoning": false
37        }
38      }
39    }
40  },
41  "model": "openai/gpt-5.1-codexmax"
42}

1echo 'export OPENAI_API_KEY="sk-proj-你的真实Key"' >> ~/.zshrc
2source ~/.zshrc

1[System.Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "sk-proj-你的真实Key", "User")
2# 重启 PowerShell 后生效

1{
2  "provider": {
3    "openai": {
4      "npm": "@ai-sdk/openai",
5      "name": "OpenAI",
6      "options": {
7        "baseURL": "https://api.openai.com/v1",
8        "apiKey": { "env": "OPENAI_API_KEY" }
9      },
10      "models": {
11        "gpt-5.1-codexmax": {
12          "name": "GPT-5.1 CodexMax"
13        }
14      }
15    }
16  }
17}

1# macOS / Linux
2echo $OPENAI_API_KEY
3
4# Windows PowerShell
5echo $env:OPENAI_API_KEY

1# 用 Node.js 验证（推荐）
2node -e "JSON.parse(require('fs').readFileSync(process.env.HOME + '/.opencode/config.json', 'utf8')); console.log('✓ JSON 格式正确')"
3
4# 或用 Python
5python3 -c "import json; json.load(open('$HOME/.opencode/config.json')); print('✓ JSON 格式正确')"
6
7# Windows PowerShell
8node -e "JSON.parse(require('fs').readFileSync(process.env.USERPROFILE + '\\.opencode\\config.json', 'utf8')); console.log('✓ JSON 格式正确')"

1cd ~/projects/my-app
2opencode

1帮我从零搭一个 Node.js + Express + TypeScript 的 REST API 项目，要求：
2
31. 使用 ESM 模块（package.json 里 "type": "module"）
42. 用 zod 做请求参数校验
53. 用 Prisma 做数据库 ORM（先用 SQLite）
64. JWT 鉴权（登录、注册、token 刷新）
75. 两个核心模块：
8   - /users：CRUD + 分页 + 按邮箱搜索
9   - /tasks：CRUD + 按状态过滤 + 批量更新
106. 统一错误处理中间件
117. 用 Vitest 跑测试，至少给 /users 的 5 个接口写测试
128. 写好 .env.example、README.md、docker-compose.yml
139. 目录结构：src/{routes,middlewares,services,schemas,utils,types,prisma}
14
15请直接创建所有文件到当前目录，处理完后跑 npm test 确认测试通过

1.
2├── package.json
3├── tsconfig.json
4├── .env.example
5├── README.md
6├── docker-compose.yml
7├── prisma/
8│   └── schema.prisma
9└── src/
10    ├── index.ts
11    ├── routes/
12    │   ├── users.ts
13    │   ├── tasks.ts
14    │   └── auth.ts
15    ├── middlewares/
16    │   ├── errorHandler.ts
17    │   ├── auth.ts
18    │   └── validate.ts
19    ├── services/
20    │   ├── userService.ts
21    │   └── taskService.ts
22    ├── schemas/
23    │   ├── userSchema.ts
24    │   └── taskSchema.ts
25    ├── utils/
26    │   ├── jwt.ts
27    │   └── prisma.ts
28    └── types/
29        └── index.ts
30tests/
31└── routes/
32    └── users.test.ts

1// src/routes/users.ts
2import { Router } from 'express';
3import { z } from 'zod';
4import { userService } from '../services/userService';
5import { validate } from '../middlewares/validate';
6import { auth } from '../middlewares/auth';
7
8const router = Router();
9
10const createUserSchema = z.object({
11  email: z.string().email(),
12  name: z.string().min(1).max(100),
13  password: z.string().min(8),
14});
15
16const listUsersSchema = z.object({
17  page: z.coerce.number().int().positive().default(1),
18  pageSize: z.coerce.number().int().positive().max(100).default(20),
19  search: z.string().optional(),
20});
21
22router.post('/', validate(createUserSchema), async (req, res, next) => {
23  try {
24    const user = await userService.create(req.body);
25    res.status(201).json(user);
26  } catch (err) {
27    next(err);
28  }
29});
30
31router.get('/', auth, validate(listUsersSchema, 'query'), async (req, res, next) => {
32  try {
33    const result = await userService.list(req.query as any);
34    res.json(result);
35  } catch (err) {
36    next(err);
37  }
38});
39
40router.get('/:id', auth, async (req, res, next) => {
41  try {
42    const user = await userService.getById(req.params.id);
43    if (!user) return res.status(404).json({ error: 'User not found' });
44    res.json(user);
45  } catch (err) {
46    next(err);
47  }
48});
49
50export default router;

1请重构 src/services/processOrder.ts 里的 processOrder 函数：
2
31. 拆成单一职责的小函数（每个不超过 50 行）
42. 提取常量到文件顶部
53. 用早返回（early return）减少嵌套（最深不超过 3 层）
64. 不要改变对外接口签名（export 的函数名和参数不变）
75. 给每个拆出来的函数写 JSDoc 注释（含 @param、@returns、@throws）
86. 处理完后跑 npm test 确认没破坏功能
97. 如果测试失败，自主修复直到全部通过
108. 最后给我一份「重构报告」：拆出了几个函数、各自职责、改了哪些行

1// src/services/processOrder.ts
2
3// ===== 常量 =====
4const MAX_ITEMS_PER_ORDER = 100;
5const MIN_ORDER_AMOUNT = 0.01;
6const DISCOUNT_STACKING_RULE = 'no_overlap';
7
8// ===== 类型 =====
9interface OrderItem { sku: string; qty: number; price: number; }
10interface Discount { type: 'coupon' | 'fullReduction' | 'member'; value: number; }
11interface ProcessOrderResult { orderId: string; amount: number; items: OrderItem[]; }
12
13// ===== 主函数（保持原签名）=====
14/**
15 * 处理订单：校验 → 计价 → 优惠 → 落库
16 * @param items 订单商品列表
17 * @param discounts 优惠信息（可叠加）
18 * @param userId 下单用户
19 * @returns 订单处理结果
20 * @throws {ValidationError} 参数校验失败
21 * @throws {OutOfStockError} 库存不足
22 */
23export async function processOrder(
24  items: OrderItem[],
25  discounts: Discount[],
26  userId: string,
27): Promise<ProcessOrderResult> {
28  validateItems(items);
29  await checkStock(items);
30  const subtotal = calculateSubtotal(items);
31  const amount = applyDiscounts(subtotal, discounts);
32  return await persistOrder(items, amount, userId);
33}
34
35// ===== 子函数（每个单一职责）=====
36function validateItems(items: OrderItem[]): void {
37  if (items.length === 0) throw new ValidationError('订单不能为空');
38  if (items.length > MAX_ITEMS_PER_ORDER) throw new ValidationError('超出单订单上限');
39  // ...
40}
41
42async function checkStock(items: OrderItem[]): Promise<void> {
43  // 调用库存服务
44}
45
46function calculateSubtotal(items: OrderItem[]): number {
47  return items.reduce((sum, i) => sum + i.qty * i.price, 0);
48}
49
50function applyDiscounts(subtotal: number, discounts: Discount[]): number {
51  // ...
52}
53
54async function persistOrder(items: OrderItem[], amount: number, userId: string): Promise<ProcessOrderResult> {
55  // ...
56}

1src/services/processOrder.ts 里有个 bug：
2- 现象：用户下单后，最终金额偶尔为负数
3- 重现条件：优惠券 + 满减叠加 + 商品价格低于阈值时
4- 频率：约 0.3% 的订单触发
5
6请你：
71. 读 processOrder.ts 和它依赖的所有文件，建立完整调用链
82. 用推理分析哪些输入组合会触发负数（请展开推理过程）
93. 找到根因后，给我一份「Bug 分析报告」：
10   - 根因定位（具体哪一行、哪个分支）
11   - 触发条件的精确描述
12   - 修复方案（含改动前后对比）
134. 我确认方案后由你实施修复
145. 加单元测试覆盖这个边界场景，跑测试确认通过

1推理过程：
21. 金额计算流程：subtotal → 减 discount → 减 couponValue → 减 fullReduction → 减 memberDiscount
32. 当用户同时有优惠券（couponValue）和满减（fullReduction）时，两者独立减额
43. 如果商品价格 $10，couponValue=$8（85 折），fullReduction=$5（满 100 减 5 触发条件被错误地按原价判断），
5   实际金额 = 10 - 8 - 5 = -3
64. 根因：fullReduction 的触发条件用了 subtotal 而非 (subtotal - couponValue)
75. 修复方案：fullReduction 的触发判断改为基于「已优惠后金额」

1// 修复前（有 Bug）
2function applyDiscounts(subtotal: number, discounts: Discount[]): number {
3  let amount = subtotal;
4  amount -= discounts.find(d => d.type === 'coupon')?.value ?? 0;
5  // ❌ 满减判断用了 subtotal，应该是当前的 amount
6  const fullReduction = discounts.find(d => d.type === 'fullReduction');
7  if (fullReduction && subtotal >= fullReduction.threshold) {
8    amount -= fullReduction.value;
9  }
10  return amount;
11}
12
13// 修复后
14function applyDiscounts(subtotal: number, discounts: Discount[]): number {
15  let amount = subtotal;
16  amount -= discounts.find(d => d.type === 'coupon')?.value ?? 0;
17  // ✅ 满减判断基于当前已优惠金额
18  const fullReduction = discounts.find(d => d.type === 'fullReduction');
19  if (fullReduction && amount >= fullReduction.threshold) {
20    amount -= fullReduction.value;
21  }
22  // ✅ 兜底：金额不可能为负
23  if (amount < 0) {
24    console.warn(`[processOrder] 金额为负，归零处理`, { subtotal, discounts });
25    amount = 0;
26  }
27  return amount;
28}

1// src/services/processOrder.test.ts
2describe('applyDiscounts', () => {
3  it('优惠券+满减叠加导致负数时应归零', () => {
4    const discounts: Discount[] = [
5      { type: 'coupon', value: 8 },
6      { type: 'fullReduction', value: 5, threshold: 5 },
7    ];
8    expect(applyDiscounts(10, discounts)).toBe(0);
9  });
10
11  it('满减阈值应基于已优惠后金额', () => {
12    const discounts: Discount[] = [
13      { type: 'coupon', value: 8 },
14      { type: 'fullReduction', value: 5, threshold: 5 },
15    ];
16    // subtotal=10, 减 coupon 8 → 2，2 < 5 不应触发满减
17    expect(applyDiscounts(10, discounts)).toBe(2);
18  });
19
20  it('正常情况下应返回正确金额', () => {
21    const discounts: Discount[] = [
22      { type: 'coupon', value: 20 },
23      { type: 'fullReduction', value: 10, threshold: 100 },
24    ];
25    expect(applyDiscounts(200, discounts)).toBe(170);
26  });
27});

1我刚接手这个项目，请你做一份「5 分钟上手指引」：
2
31. 读 package.json，告诉我项目类型、主要技术栈、关键依赖
42. 读 README.md 和 docs/ 目录下的文档，总结项目定位和核心功能
53. 找到入口文件（src/index.ts 或 main.ts），梳理启动流程
64. 画出模块依赖关系图（用 Mermaid 语法）
75. 列出最核心的 5 个文件，每个用一句话说明作用
86. 指出最复杂的部分（通常是测试覆盖最差、git log 改动最频繁的代码）
97. 找出 3 个潜在的代码质量问题（带具体文件和行号）
10
11输出一份 Markdown 报告，存到 docs/onboarding.md

1# 项目上手指南
2
3## 项目概览
4- **类型**：Node.js 微服务（订单系统）
5- **技术栈**：NestJS + TypeORM + PostgreSQL + Redis + RabbitMQ
6- **核心功能**：订单创建、支付、履约、退款
7
8## 模块依赖图
9
10```mermaid
11graph TD
12  A[main.ts] --> B[AppModule]
13  B --> C[OrderModule]
14  B --> D[PaymentModule]
15  B --> E[InventoryModule]
16  C --> F[OrderService]
17  C --> G[PaymentClient]
18  D --> F

1
2> **小白提示**: 对于超大型代码库（百万行级），CodexMax 的 256K 上下文也读不完。这时可以**分模块调研**：先让它读 `package.json` 和顶层目录结构，然后你指定它深入某个模块：「现在重点分析 src/payment/ 这个模块」。一步步缩小范围。
3
4---
5
6## 高级配置：把 GPT-5.1-CodexMax 调教成你的专属代码助手
7
8基础配置跑通后，下面这些高级技巧能让 CodexMax 用得更顺手、更省 token、更安全。
9
10### 1. 模型参数调优
11
12`config.json` 里每个 model 下都可以配这些参数：
13
14```json
15{
16  "gpt-5.1-codexmax": {
17    "name": "GPT-5.1 CodexMax",
18    "temperature": 0.2,
19    "topP": 0.95,
20    "maxTokens": 16384,
21    "frequencyPenalty": 0,
22    "presencePenalty": 0,
23    "reasoningEffort": "high",
24    "maxSteps": 50
25  }
26}

1{
2  "gpt-5.1-codexmax": {
3    "name": "GPT-5.1 CodexMax",
4    "contextWindow": 262144
5  }
6}

1{
2  "provider": {
3    "openai": {
4      "npm": "@ai-sdk/openai",
5      "name": "OpenAI",
6      "options": {
7        "baseURL": "https://api.openai.com/v1",
8        "apiKey": { "env": "OPENAI_API_KEY" }
9      },
10      "models": {
11        "gpt-5.1-codexmax": {
12          "name": "CodexMax · 重活",
13          "temperature": 0.2,
14          "contextWindow": 131072,
15          "reasoningEffort": "high",
16          "maxSteps": 50
17        },
18        "gpt-5.1": {
19          "name": "GPT-5.1 · 通用",
20          "temperature": 0.5,
21          "contextWindow": 32768
22        },
23        "gpt-5.1-mini": {
24          "name": "GPT-5.1 Mini · 轻活",
25          "temperature": 0.3,
26          "contextWindow": 16384,
27          "maxTokens": 2048
28        }
29      }
30    }
31  },
32  "model": "openai/gpt-5.1-codexmax"
33}

1{
2  "gpt-5.1-codexmax": {
3    "name": "GPT-5.1 CodexMax",
4    "systemPrompt": "你是一个资深的全栈工程师，精通 TypeScript / React / Node.js / PostgreSQL。\n写代码时遵循以下规范：\n1. 使用 ESM 模块语法（import/export）\n2. 函数必须有 JSDoc 注释（含 @param、@returns）\n3. 优先使用 async/await，禁止 .then() 链\n4. 错误处理用自定义错误类，不要 throw 字符串\n5. 永远不要用 any 类型，必须显式标注\n6. 数据库操作必须用事务（prisma.$transaction）\n7. 所有对外 API 必须用 zod 校验入参\n8. 永远用中文回复\n9. 改代码前先告诉我思路，等我确认后再动手\n10. 跑测试用 npm test，不要用 yarn"
5  }
6}

1// 项目根目录下的 .opencode.json
2{
3  "provider": {
4    "openai": {
5      "models": {
6        "gpt-5.1-codexmax": {
7          "temperature": 0.1,
8          "systemPrompt": "这是金融交易系统，所有金额计算必须用 big.js，禁止用 Number 直接运算。\n所有数据库写入必须在事务内。\n所有时间用 UTC，禁止用本地时间。\n日志必须脱敏（不能出现用户身份证号、银行卡号）。"
9        }
10      }
11    }
12  },
13  "model": "openai/gpt-5.1-codexmax"
14}

1{
2  "permissions": {
3    "edit": ["src/**", "tests/**", "docs/**"],
4    "bash": ["npm test", "npm run lint", "npm run build", "git status", "git diff", "git log"]
5  }
6}

1{
2  "gpt-5.1-codexmax": {
3    "maxSteps": 100,
4    "agentic": true
5  }
6}

1# macOS / Linux
2opencode --log-level debug 2>&1 | tee opencode.log
3
4# Windows PowerShell
5opencode --log-level debug 2>&1 | Tee-Object opencode.log

1{
2  "provider": {
3    "openai": {
4      "options": {
5        "baseURL": "https://your-proxy.example.com/v1"
6      }
7    }
8  }
9}

1# macOS / Linux
2export HTTP_PROXY=http://127.0.0.1:7890
3export HTTPS_PROXY=http://127.0.0.1:7890
4opencode
5
6# Windows PowerShell
7$env:HTTP_PROXY = "http://127.0.0.1:7890"
8$env:HTTPS_PROXY = "http://127.0.0.1:7890"
9opencode

1{
2  "provider": {
3    "azure": {
4      "npm": "@ai-sdk/azure",
5      "name": "Azure OpenAI",
6      "options": {
7        "baseURL": "https://your-resource.openai.azure.com/openai/deployments/your-deployment",
8        "apiKey": { "env": "AZURE_OPENAI_API_KEY" },
9        "apiVersion": "2026-09-01-preview"
10      },
11      "models": {
12        "gpt-5.1-codexmax": {
13          "name": "GPT-5.1 CodexMax (Azure)"
14        }
15      }
16    }
17  },
18  "model": "azure/gpt-5.1-codexmax"
19}

1curl -i https://api.openai.com/v1/models \
2  -H "Authorization: Bearer $OPENAI_API_KEY"

1# .gitignore
2.opencode/auth.json
3.opencode/sessions/
4.opencode.log
5*.env
6.env.local

1{
2  "permissions": {
3    "edit": ["src/**", "tests/**", "docs/**"],
4    "bash": ["npm test", "npm run lint", "npm run build", "git status", "git diff"]
5  }
6}

1// .opencode.json （放在项目根目录）
2{
3  "$schema": "https://opencode.ai/config.json",
4  "provider": {
5    "openai": {
6      "npm": "@ai-sdk/openai",
7      "name": "OpenAI",
8      "options": {
9        "baseURL": "https://api.openai.com/v1",
10        "apiKey": { "env": "OPENAI_API_KEY" }
11      },
12      "models": {
13        "gpt-5.1-codexmax": {
14          "name": "CodexMax",
15          "temperature": 0.2,
16          "contextWindow": 65536,
17          "tools": true,
18          "reasoning": true,
19          "reasoningEffort": "medium",
20          "agentic": true,
21          "maxSteps": 30,
22          "systemPrompt": "团队代码规范：\n1. 使用 ESM\n2. 函数必须有 JSDoc\n3. 禁止 any 类型\n4. 数据库操作用事务\n5. 所有 API 入参用 zod 校验\n6. 永远用中文回复"
23        }
24      }
25    }
26  },
27  "model": "openai/gpt-5.1-codexmax",
28  "permissions": {
29    "edit": ["src/**", "tests/**"],
30    "bash": ["npm test", "npm run lint", "git status", "git diff"]
31  }
32}

1# 1. 拉项目
2git clone https://github.com/your-team/your-project.git
3cd your-project
4
5# 2. 配环境变量
6echo 'export OPENAI_API_KEY="sk-proj-你的Key"' >> ~/.zshrc
7source ~/.zshrc
8
9# 3. 启动 OpenCode
10opencode

1# .github/workflows/ai-review.yml
2name: AI Code Review
3on:
4  pull_request:
5    types: [opened, synchronize]
6
7jobs:
8  review:
9    runs-on: ubuntu-latest
10    steps:
11      - uses: actions/checkout@v4
12        with:
13          fetch-depth: 0
14
15      - uses: actions/setup-node@v4
16        with:
17          node-version: 20
18
19      - name: Install OpenCode
20        run: npm install -g opencode
21
22      - name: Run AI review with CodexMax
23        env:
24          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
25        run: |
26          # 用非交互模式调用 OpenCode，让它审查 diff
27          opencode run "请审查 git diff origin/main...HEAD 的改动，重点关注：
28          1. 是否有安全漏洞（SQL 注入、XSS、敏感信息泄露、未授权访问）
29          2. 是否有性能问题（O(n²) 循环、不必要的内存分配、N+1 查询）
30          3. 是否符合团队代码规范（ESM、JSDoc、禁止 any）
31          4. 是否有边界情况遗漏
32          5. 测试是否充分覆盖新代码
33          输出 Markdown 格式的审查报告，按严重程度分级（🔴 严重 / 🟡 警告 / 🔵 建议）" \
34          --model openai/gpt-5.1-codexmax \
35          --max-tokens 8192 > review.md
36
37      - name: Post review comment
38        uses: actions/github-script@v7
39        with:
40          script: |
41            const fs = require('fs');
42            const body = fs.readFileSync('review.md', 'utf8');
43            github.rest.issues.createComment({
44              issue_number: context.issue.number,
45              owner: context.repo.owner,
46              repo: context.repo.repo,
47              body: `## 🤖 GPT-5.1-CodexMax AI 代码审查\n\n${body}`
48            });

1# .gitlab-ci.yml
2ai-review:
3  stage: review
4  image: node:20
5  only:
6    - merge_requests
7  script:
8    - npm install -g opencode
9    - |
10      opencode run "审查 git diff origin/$CI_MERGE_REQUEST_TARGET_BRANCH_NAME...HEAD 的改动..." \
11        --model openai/gpt-5.1-codexmax > review.md
12    - cat review.md
13  artifacts:
14    paths:
15      - review.md
16  variables:
17    OPENAI_API_KEY: $OPENAI_API_KEY

1{
2  "$schema": "https://opencode.ai/config.json",
3  "provider": {
4    "openai": {
5      "npm": "@ai-sdk/openai",
6      "name": "OpenAI",
7      "options": {
8        "baseURL": "https://api.openai.com/v1",
9        "apiKey": { "env": "OPENAI_API_KEY" }
10      },
11      "models": {
12        "gpt-5.1-codexmax": {
13          "name": "CodexMax · 重活",
14          "temperature": 0.2,
15          "maxTokens": 16384,
16          "contextWindow": 131072,
17          "tools": true,
18          "reasoning": true,
19          "reasoningEffort": "medium",
20          "agentic": true,
21          "maxSteps": 50,
22          "systemPrompt": "你是一个资深的全栈工程师。写代码时遵循：1. 使用 ESM；2. 函数必须有 JSDoc；3. 优先 async/await；4. 禁用 any 类型；5. 始终用中文回复。"
23        },
24        "gpt-5.1": {
25          "name": "GPT-5.1 · 通用",
26          "temperature": 0.5,
27          "maxTokens": 8192,
28          "contextWindow": 32768,
29          "tools": true,
30          "reasoning": false
31        },
32        "gpt-5.1-mini": {
33          "name": "GPT-5.1 Mini · 轻活",
34          "temperature": 0.3,
35          "maxTokens": 4096,
36          "contextWindow": 16384,
37          "tools": true,
38          "reasoning": false
39        }
40      }
41    }
42  },
43  "model": "openai/gpt-5.1-codexmax",
44  "permissions": {
45    "edit": ["src/**", "tests/**", "docs/**"],
46    "bash": ["npm test", "npm run lint", "npm run build", "git status", "git diff", "git log"]
47  }
48}

1#!/bin/bash
2# setup-gpt5-opencode.sh
3
4read -p "请粘贴你的 OpenAI API Key (sk- 或 sk-proj- 开头): " KEY
5if [[ ! "$KEY" =~ ^sk- ]]; then
6  echo "❌ Key 格式不正确，应以 sk- 或 sk-proj- 开头"
7  exit 1
8fi
9
10# 写入 zshrc
11echo "export OPENAI_API_KEY=\"$KEY\"" >> ~/.zshrc
12source ~/.zshrc
13
14# 验证
15if [ -z "$OPENAI_API_KEY" ]; then
16  echo "❌ 环境变量设置失败"
17  exit 1
18fi
19
20echo "✅ OPENAI_API_KEY 已配置"
21echo "✅ 请重启终端后执行 opencode 启动"

1# setup-gpt5-opencode.ps1
2$key = Read-Host "请粘贴你的 OpenAI API Key (sk- 或 sk-proj- 开头)"
3if ($key -notmatch "^sk-") {
4    Write-Host "❌ Key 格式不正确，应以 sk- 或 sk-proj- 开头" -ForegroundColor Red
5    exit 1
6}
7
8[System.Environment]::SetEnvironmentVariable("OPENAI_API_KEY", $key, "User")
9Write-Host "✅ OPENAI_API_KEY 已配置为用户级环境变量" -ForegroundColor Green
10Write-Host "✅ 请重启 PowerShell 后执行 opencode 启动" -ForegroundColor Green

1#!/bin/bash
2# check-gpt5-opencode.sh
3
4echo "🔍 检查 Node.js..."
5if ! command -v node &> /dev/null; then
6    echo "❌ Node.js 未安装"
7    exit 1
8fi
9NODE_VERSION=$(node -v | sed 's/v//' | cut -d. -f1)
10if [ "$NODE_VERSION" -lt 18 ]; then
11    echo "❌ Node.js 版本过低 (当前: $(node -v), 需要: 18+)"
12    exit 1
13fi
14echo "✅ Node.js $(node -v)"
15
16echo "🔍 检查 OpenCode..."
17if ! command -v opencode &> /dev/null; then
18    echo "❌ OpenCode 未安装，请运行: curl -fsSL https://opencode.ai/install | bash"
19    exit 1
20fi
21echo "✅ OpenCode $(opencode --version)"
22
23echo "🔍 检查 OPENAI_API_KEY..."
24if [ -z "$OPENAI_API_KEY" ]; then
25    echo "❌ OPENAI_API_KEY 环境变量未设置"
26    exit 1
27fi
28if [[ ! "$OPENAI_API_KEY" =~ ^sk- ]]; then
29    echo "⚠️  OPENAI_API_KEY 格式异常，应以 sk- 或 sk-proj- 开头"
30fi
31echo "✅ OPENAI_API_KEY 已设置 (前 8 位: ${OPENAI_API_KEY:0:8}...)"
32
33echo "🔍 检查 config.json..."
34CONFIG_FILE="$HOME/.opencode/config.json"
35if [ ! -f "$CONFIG_FILE" ]; then
36    echo "⚠️  config.json 不存在 ($CONFIG_FILE)"
37    echo "    请先启动一次 opencode 生成默认配置，或参考教程创建"
38else
39    if node -e "JSON.parse(require('fs').readFileSync('$CONFIG_FILE', 'utf8'))" 2>/dev/null; then
40        echo "✅ config.json JSON 格式正确"
41    else
42        echo "❌ config.json JSON 格式错误"
43        exit 1
44    fi
45fi
46
47echo "🔍 测试 OpenAI API 连通性..."
48HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" \
49    -H "Authorization: Bearer $OPENAI_API_KEY" \
50    https://api.openai.com/v1/models)
51
52if [ "$HTTP_CODE" = "200" ]; then
53    echo "✅ OpenAI API 连通正常"
54elif [ "$HTTP_CODE" = "401" ]; then
55    echo "❌ OpenAI API 鉴权失败 (401)，请检查 Key"
56    exit 1
57elif [ "$HTTP_CODE" = "000" ]; then
58    echo "⚠️  无法连接 OpenAI API，可能需要代理"
59    echo "    尝试: export HTTPS_PROXY=http://127.0.0.1:7890"
60else
61    echo "⚠️  OpenAI API 返回 HTTP $HTTP_CODE"
62fi
63
64echo ""
65echo "🎉 自检完成！执行 opencode 启动"

1请重构 src/legacy/uploadFile.ts 里的 uploadFile 函数：
2
31. 把所有回调改成 async/await
42. 用 Promise.all 并行化可以并行的步骤（比如生成缩略图 + 上水印 + 提取元数据）
53. 失败时给出明确错误，不要吞异常
64. 加上超时控制（单个步骤超过 30 秒就失败）
75. 用 perf_hooks 测量每一步耗时，打印到日志
86. 保持对外接口签名不变
97. 跑 npm test 验证，失败自主修复

1扫描 src/ 下所有 .ts 文件，给每个 export 的函数补上 JSDoc 注释：
2
31. 用 /** */ 格式，不要用 //
42. 包含 @param 和 @returns
53. 描述要具体，不要写「该函数返回数据」这种废话
64. 类型如果是 union（如 'create' | 'update' | 'delete'），注释里要列出所有可能值
75. 不要改函数实现，只加注释
86. 处理完后跑 npm run lint 确认没问题
9
10文件较多，请一个一个处理，每处理完一个就告诉我进度

1读取 openapi.yaml 文件，帮我生成一个 TypeScript SDK，要求：
2
31. 输出到 src/sdk/ 目录
42. 用 axios 做 HTTP 客户端
53. 每个 endpoint 一个方法，方法名按 operationId 生成
64. 请求和响应都用 interface 定义类型
75. 错误统一抛出 ApiError 类，包含 status、message、data
86. 支持拦截器配置（认证 token、日志）
97. 写好完整的使用示例 src/sdk/example.ts
108. 给 SDK 配 Vitest 测试，mock axios 验证调用
119. 生成完跑 npm test 验证

1src/sdk/
2├── index.ts          # 统一导出
3├── client.ts         # ApiClient 类
4├── types.ts          # 所有 interface
5├── errors.ts         # ApiError 类
6├── users.ts          # users 相关接口
7├── orders.ts         # orders 相关接口
8├── example.ts        # 使用示例
9└── tests/
10    ├── client.test.ts
11    └── users.test.ts

1扫描 src/ 下所有 .ts 文件，输出一份测试优先级报告：
2
31. 找出所有 export 的函数
42. 按复杂度（圈复杂度）从高到低排序
53. 标注每个函数当前的测试覆盖状态（读 tests/ 目录看是否已有测试）
64. 给出 Top 10 急需补测试的函数列表
75. 对 Top 3 的函数，给出建议的测试用例（输入、预期输出、边界情况）
8
9报告输出到 docs/test-coverage-report.md

1# 测试覆盖优先级报告
2
3生成时间：2026-09-02
4扫描范围：src/**/*.ts
5
6## 急需补测试的函数 Top 10
7
8| 排名 | 函数 | 文件 | 圈复杂度 | 当前测试 | 优先级 |
9|---|---|---|---|---|---|
10| 1 | processOrder | src/services/processOrder.ts | 18 | ❌ 无 | 🔴 高 |
11| 2 | calculateDiscount | src/services/discount.ts | 12 | ❌ 无 | 🔴 高 |
12| 3 | validateUserInput | src/utils/validator.ts | 10 | ✅ 有但不全 | 🔴 高 |
13| ... | ... | ... | ... | ... | ... |
14
15## Top 3 函数的测试用例建议
16
17### 1. processOrder (src/services/processOrder.ts)
18
19**功能**：处理订单，含金额计算、库存扣减、优惠券应用
20
21**建议测试用例**：
22
23| 用例 ID | 描述 | 输入 | 预期输出 |
24|---|---|---|---|
25| TC001 | 正常下单 | { items: [...], coupon: null } | 订单创建成功 |
26| TC002 | 库存不足 | { items: [超量的商品] } | 抛出 OutOfStockError |
27| TC003 | 优惠券叠加导致负金额 | { items: [...], coupon: 0.9, discount: 50 } | 金额归零，打 warning |
28| TC004 | 空订单 | { items: [] } | 抛出 ValidationError |
29| TC005 | 价格为 0 的商品 | { items: [{ price: 0 }] } | 订单创建成功，金额为 0 |