DeepSeek V4.1 Flash 接入 Cursor 指南：BYOK 与 Rules 配置

1Settings → Models
2├── OpenAI API Key: sk-xxxxxxxxxxxxxxxxxxxxxxxx
3├── Override OpenAI Base URL: [✓] https://api.deepseek.com/v1
4├── [Verify] → ✓ Verified
5└── Custom Models
6    └── deepseek-chat
7        ├── Chat      [✓]
8        ├── Composer  [✓]
9        ├── Agent     [✓]
10        └── Cursor Tab [✓]   ← 想要补全必须单独打开

1mkdir -p ~/cursor-proxy && cd ~/cursor-proxy
2
3cat > docker-compose.yml <<'EOF'
4version: "3.8"
5services:
6  cursor-proxy:
7    image: ghcr.io/one-api/one-api:latest
8    container_name: cursor-proxy
9    restart: unless-stopped
10    ports:
11      - "3001:3000"
12    environment:
13      - TZ=Asia/Shanghai
14    volumes:
15      - ./data:/data
16EOF
17
18docker compose up -d
19sleep 8
20curl -s -o /dev/null -w "%{http_code}\n" http://localhost:3001/

1// proxy.mjs —— node proxy.mjs 即可，默认监听 3210
2import http from 'node:http';
3
4const UPSTREAM = 'https://api.deepseek.com';
5const API_KEY = process.env.DEEPSEEK_API_KEY;   // 真正的 Key 只存在这里
6const MAX_RETRY = 3;
7
8function readBody(req) {
9  return new Promise((resolve, reject) => {
10    const chunks = [];
11    req.on('data', c => chunks.push(c));
12    req.on('end', () => resolve(Buffer.concat(chunks).toString('utf8')));
13    req.on('error', reject);
14  });
15}
16
17async function forward(payload, authHeader, attempt = 1) {
18  const res = await fetch(`${UPSTREAM}/v1/chat/completions`, {
19    method: 'POST',
20    headers: {
21      'Content-Type': 'application/json',
22      Authorization: `Bearer ${API_KEY}`,
23    },
24    body: payload,
25  });
26  const text = await res.text();
27
28  // 429 / 5xx 才重试；401 / 402 / 400 是配置问题，重试没意义还会烧钱
29  if ((res.status === 429 || res.status >= 500) && attempt < MAX_RETRY) {
30    const waitMs = 800 * attempt ** 2;    // 800 / 3200 / 7200ms 指数退避
31    console.warn(`[retry ${attempt}] status=${res.status} wait=${waitMs}ms`);
32    await new Promise(r => setTimeout(r, waitMs));
33    return forward(payload, authHeader, attempt + 1);
34  }
35  return { status: res.status, text };
36}
37
38http.createServer(async (req, res) => {
39  if (req.url !== '/v1/chat/completions') {
40    res.writeHead(404, { 'Content-Type': 'application/json' });
41    return res.end(JSON.stringify({ error: { message: 'not found' } }));
42  }
43  const raw = await readBody(req);
44  const { status, text } = await forward(raw);
45  res.writeHead(status, { 'Content-Type': 'application/json' });
46  res.end(text);
47}).listen(3210, () => console.log('cursor proxy on http://localhost:3210'));

1export DEEPSEEK_API_KEY=sk-xxxxxxxx
2node proxy.mjs &
3
4curl -s http://localhost:3210/v1/chat/completions \
5  -H "Content-Type: application/json" \
6  -d '{"model":"deepseek-chat","messages":[{"role":"user","content":"ping"}],"max_tokens":8}' \
7  | python3 -c "import sys,json; d=json.load(sys.stdin); print('OK' if 'choices' in d else 'FAIL', d.get('model'))"

1curl -s https://api.deepseek.com/v1/chat/completions \
2  -H "Content-Type: application/json" \
3  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
4  -d '{"model":"deepseek-chat","messages":[{"role":"user","content":"回复两个字：可用"}],"stream":false}' \
5  | python3 -c "import sys,json; d=json.load(sys.stdin); print('MODEL:', d.get('model')); print('USAGE:', d.get('usage'))"

1curl -s https://api.deepseek.com/v1/chat/completions \
2  -H "Content-Type: application/json" \
3  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
4  -d @- <<'EOF' | python3 -c "import sys,json; m=json.load(sys.stdin)['choices'][0]['message']; print('TOOL_CALL:', m.get('tool_calls') and m['tool_calls'][0]['function']['name'])"
5{
6  "model": "deepseek-chat",
7  "messages": [{"role": "user", "content": "读取 package.json 的内容"}],
8  "tools": [{
9    "type": "function",
10    "function": {
11      "name": "read_file",
12      "description": "读取指定路径的文件内容",
13      "parameters": {
14        "type": "object",
15        "properties": {"path": {"type": "string", "description": "文件路径"}},
16        "required": ["path"]
17      }
18    }
19  }]
20}
21EOF

1给 src/utils/date.ts 里的 formatDate 函数补单元测试，
2用项目里已有的 vitest，放到同目录的 date.test.ts，
3覆盖：正常日期、非法输入、时区边界三种情况。

1your-project/
2└── .cursor/
3    └── rules/
4        ├── 00-project.mdc      # Always 类型，全局约束
5        ├── 10-typescript.mdc   # globs: src/**/*.ts
6        ├── 20-testing.mdc      # globs: **/*.test.ts
7        └── 30-api.mdc          # globs: src/api/**

1---
2description: TypeScript 业务代码的编写约束
3globs: src/**/*.ts
4alwaysApply: false
5---
6
7# TypeScript 约束
8
9## 类型
10- 禁止 any。确需时用 unknown + 类型收窄
11- 导出函数必须有显式返回类型注解
12
13## 错误处理
14- 业务异常统一抛 AppError，禁止直接 throw new Error
15- catch 里禁止空实现，至少要 logger.warn
16
17## 命名
18- 布尔变量/函数用 is/has/should 前缀
19- 异步返回 Promise 的函数不加 Async 后缀
20
21## 禁止
22- 禁止在 src/ 下直接调用 fetch，必须走 src/api/client.ts

1---
2description: AI 修改代码时必须遵守的最小约束集
3globs: **/*
4alwaysApply: true
5---
6
7# 最小约束集
8
91. 【最小改动】只改完成任务必须改的部分，不顺手重构、不顺手格式化、不调整无关命名
102. 【先读后写】修改任何文件前先用工具读取当前内容，禁止凭记忆写全量覆盖
113. 【保留注释】不删除已有注释，除非该注释描述的代码已被删除
124. 【不改依赖】不修改 package.json 里的版本号，需要新依赖先说明原因并等确认
135. 【不碰测试】不为了让测试通过而修改测试断言本身
146. 【中文输出】涉及说明、注释、提交信息的部分用简体中文
157. 【报不确定】对不确定的 API 行为直接说不确定，不要给出看似确定的猜测
168. 【报传播范围】改了接口签名时，必须列出受影响的所有调用点

1把 getUserInfo 重命名为 fetchUserProfile。
2
3约束：
4- 只改标识符本身，不改任何逻辑
5- packages/*/src/** 全部纳入范围
6- 对每个 re-export 链，必须同时改 export 语句和所有 import 语句
7- 遇到动态字符串引用（如 obj["getUserInfo"]）单独列出，不要自动改
8
9输出格式：
10先列出你计划修改的文件清单（路径 + 改动处数），我确认后再执行。

1读 src/order/ 目录下所有文件，理解 OrderService 的完整调用链。
2
3然后：
41. 画一张文字版的调用链路图（谁调谁，同步还是异步）
52. 指出调用链上 3 个最容易出错的节点
63. 针对这 3 个节点写 vitest 集成测试，用 testcontainers 起真实 postgres
74. 你不知道的部分直接标 TODO，不要编造 API

1刚才跑 npm test 报了这个错，帮我定位根因并修复：
2
3<整段堆栈粘贴>
4
5约束：
6- 先说你从堆栈里读到了什么，再说可能的原因
7- 如果可能原因有多个，按概率排序，逐个给出验证方法
8- 不要一上来就改代码