豆包 1.5 Pro 接入 VS Code 完整指南

1✅ Tab 自动补全（延迟低，这是豆包最大的强项）
2✅ 生成大段完整代码（32K 输出，一次生成一个文件不用分段）
3✅ 需要 Function Calling 的 Agent 任务（Cline 工具链跑得通）
4✅ 涉及字节系 SDK / 飞书 / 火山引擎的开发
5✅ 需要看图（UI 截图 → 前端代码）
6✅ 对稳定性要求高的团队（豆包的服务可用性在国产里排前列）
7✅ 成本敏感但要推理质量（比 Flash 贵一点，但质量高一大截）

1❌ 极致便宜的高频补全（选 1.5 Lite，便宜 70%）
2❌ 超长上下文检索（256K 不如 DeepSeek 的 1M）
3❌ 需要本地私有化部署（不开源，只能走 API）
4❌ 中文长文档深度理解（Kimi K3 更强）
5❌ 开源协议敏感的项目（闭源模型，合规审查可能过不了）

1import { useEffect, useRef, useState } from 'react';
2
3export function useDebounce<T>(value: T, delay: number = 300): T {
4  const [debouncedValue, setDebouncedValue] = useState<T>(value);
5
6  useEffect(() => {
7    const timer = setTimeout(() => {
8      setDebouncedValue(value);
9    }, delay);
10
11    return () => {
12      clearTimeout(timer);
13    };
14  }, [value, delay]);
15
16  return debouncedValue;
17}
18
19// 光标在这里，输入 useTh 后触发补全

1export function useThrottle<T>(value: T, interval: number = 300): T {
2  const [throttledValue, setThrottledValue] = useState<T>(value);
3  const lastUpdated = useRef<number>(Date.now());
4
5  useEffect(() => {
6    const now = Date.now();
7    const remaining = interval - (now - lastUpdated.current);
8
9    if (remaining <= 0) {
10      lastUpdated.current = now;
11      setThrottledValue(value);
12    } else {
13      const timer = setTimeout(() => {
14        lastUpdated.current = Date.now();
15        setThrottledValue(value);
16      }, remaining);
17
18      return () => {
19        clearTimeout(timer);
20      };
21    }
22  }, [value, interval]);
23
24  return throttledValue;
25}

1export function useThrottle<T>(value: T, interval: number = 300): T {
2  const [throttledValue, setThrottledValue] = useState<T>(value);
3  const lastUpdated = useRef<number>(0);
4
5  useEffect(() => {
6    const timer = setTimeout(() => {
7      setThrottledValue(value);
8      lastUpdated.current = Date.now();
9    }, interval);
10
11    return () => clearTimeout(timer);
12  }, [value, interval]);
13
14  return throttledValue;
15}

1改一个函数 / 写注释 / 看不懂问一句  → Continue（快，便宜）
2改一批文件 / 跑测试 / 定位线上 bug   → Cline（慢，彻底，但真的能干完活）
3一边敲一边补全                       → Continue Tab（唯一选择）

1{
2  // API Provider：必须是 openai-compatible，方舟走 OpenAI 协议
3  "apiProvider": "openai-compatible",
4
5  // Base URL：火山方舟的 OpenAI 兼容端点。
6  // 注意路径是 /api/v3，不是 /v1；地域 cn-beijing 要和你开接入点的地域一致
7  "openAiBaseUrl": "https://ark.cn-beijing.volces.com/api/v3",
8
9  // API Key：方舟控制台生成的那串 UUID
10  "openAiApiKey": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
11
12  // Model ID：⚠️ 填推理接入点 ID（ep- 开头），不是模型名
13  "openAiModelId": "ep-20260422183015-x8f2k",
14
15  // 自定义请求头，一般留空。公司网关可能需要加鉴权头
16  "openAiCustomHeaders": {},
17
18  // 上下文窗口：豆包 1.5 Pro 是 256K，但 Cline 里建议填 64000。
19  // 填满 256000 会导致每次请求都塞超长上下文，又慢又贵
20  "openAiModelInfo": {
21    "maxTokens": 32768,
22    "contextWindow": 64000,
23    "supportsImages": true,
24    "supportsPromptCache": true,
25    "inputPrice": 1.2,
26    "outputPrice": 3.6
27  },
28
29  // 单次输出上限。豆包支持 32K，但日常任务 8192 够用且更快
30  "maxTokens": 8192,
31
32  // 温度：Cline 干活要确定性，0.2 比较合适
33  "temperature": 0.2,
34
35  // 是否允许 Cline 自动批准「只读」操作（读文件、列目录）
36  "autoApproveReadOnly": true,
37
38  // 是否允许自动跑终端命令。强烈建议保持 false，每条命令都自己看
39  "autoApproveWrite": false,
40  "autoApproveExecute": false,
41
42  // 流式输出，保持开启
43  "streamEnabled": true,
44
45  // 请求超时（秒）。豆包首字快，但长任务可能超过 60 秒
46  "requestTimeoutMs": 120000
47}

1我是豆包 1.5 Pro。我可以通过工具读取和编辑你项目里的文件、
2执行终端命令、进行网页搜索。有什么可以帮你的？

1code ~/.continue/config.json

1{
2  "models": [
3    {
4      // 侧边栏对话用的主模型：豆包 1.5 Pro
5      "title": "豆包 1.5 Pro",
6      "provider": "openai",
7      // ⚠️ model 字段填推理接入点 ID，不是模型名
8      "model": "ep-20260422183015-x8f2k",
9      "apiKey": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
10      "apiBase": "https://ark.cn-beijing.volces.com/api/v3",
11      // 上下文长度：填 64000 而不是 256000，避免塞太多导致变慢
12      "contextLength": 64000,
13      "completionOptions": {
14        "temperature": 0.2,
15        "maxTokens": 8192
16      }
17    },
18    {
19      // 备用小模型：豆包 1.5 Lite，处理简单问答省钱
20      "title": "豆包 1.5 Lite",
21      "provider": "openai",
22      "model": "ep-20260422183240-m3p9q",
23      "apiKey": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
24      "apiBase": "https://ark.cn-beijing.volces.com/api/v3",
25      "contextLength": 64000,
26      "completionOptions": {
27        "temperature": 0.1,
28        "maxTokens": 4096
29      }
30    }
31  ],
32
33  // ⭐ 省钱关键：Tab 补全单独指向 Lite，不要和对话共用 Pro
34  "tabAutocompleteModel": {
35    "title": "豆包 1.5 Lite (Tab)",
36    "provider": "openai",
37    "model": "ep-20260422183240-m3p9q",
38    "apiKey": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
39    "apiBase": "https://ark.cn-beijing.volces.com/api/v3",
40    "contextLength": 8192
41  },
42
43  // Tab 补全的行为参数
44  "tabAutocompleteOptions": {
45    // 停止输入后等待多久触发补全（毫秒）。
46    // 300 是甜点值，设 100 会疯狂发请求烧钱
47    "debounceDelay": 300,
48    // 单次补全最大 token。设 64 足够补一两个 token 语句，设大了会卡
49    "maxPromptTokens": 1024,
50    // 关闭多行补全（多行慢且容易错，单行够用）
51    "multilineCompletions": "never",
52    // 光标前后各取多少字符作为上下文
53    "maxSuffixPercentage": 0.2,
54    "prefixPercentage": 0.7
55  },
56
57  // 嵌入模型：豆包不提供 embedding，用本地 transformers.js 避免额外费用和依赖
58  "embeddingsProvider": {
59    "provider": "transformers.js"
60  },
61
62  // 自定义 slash 命令：把高频提示词固化
63  "slashCommands": [
64    {
65      "name": "test",
66      "description": "为选中代码生成单元测试",
67      "prompt": "为下面这段代码生成完整的单元测试，使用项目现有的测试框架（pytest/jest/vitest 等）。要求：\n1. 覆盖正常路径 + 至少 2 条异常/边界路径\n2. 所有 IO 依赖用 mock 打桩\n3. 测试风格对齐项目已有测试\n4. 只输出测试代码，不要解释\n\n{{{ input }}}"
68    },
69    {
70      "name": "review",
71      "description": "代码评审，找出问题",
72      "prompt": "请以资深工程师视角评审下面这段代码，重点找：\n1. 逻辑错误和边界条件遗漏\n2. 性能问题（N+1 查询、重复计算、内存泄漏）\n3. 安全隐患（注入、越权、敏感信息泄露）\n4. 可读性问题\n\n按严重程度排序输出，每条给出文件行号和修改建议。\n\n{{{ input }}}"
73    },
74    {
75      "name": "doc",
76      "description": "生成中文接口文档",
77      "prompt": "为这段代码生成中文接口文档，包含：接口说明、参数表（名称/类型/必填/说明）、返回值表、可能的异常及触发条件。用 Markdown 表格输出。\n\n{{{ input }}}"
78    }
79  ]
80}

1{
2  // Continue 是否启用 Tab 补全
3  "continue.enableTabAutocomplete": true,
4
5  // 在哪些语言里启用补全（没写的语言不触发）
6  "continue.enableTabAutocompleteFor": [
7    "python", "typescript", "typescriptreact",
8    "javascript", "javascriptreact", "go", "rust",
9    "java", "csharp", "cpp", "php", "sql", "shellscript"
10  ],
11
12  // 是否在 Markdown / 注释里也补全。建议关掉，写文档时被补全打断很烦
13  "continue.disableTabAutocompleteIn": ["markdown", "plaintext"],
14
15  // 侧边栏是否显示模型选择器下拉框
16  "continue.showModelSelect": true,
17
18  // 是否把 git diff 自动带进上下文（做 commit message 时很有用）
19  "continue.includeGitDiff": false
20}

1function formatDate_

1curl -X POST https://ark.cn-beijing.volces.com/api/v3/chat/completions \
2  -H "Content-Type: application/json" \
3  -H "Authorization: Bearer a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
4  -d '{
5    "model": "ep-20260422183015-x8f2k",
6    "messages": [{"role": "user", "content": "你好，一句话介绍自己"}],
7    "temperature": 0.2
8  }'

1{
2  "id": "chatcmpl-20260422184512-x8f2k",
3  "model": "ep-20260422183015-x8f2k",
4  "choices": [
5    {
6      "message": { "role": "assistant", "content": "我是豆包，由字节跳动开发..." },
7      "finish_reason": "stop"
8    }
9  ],
10  "usage": {
11    "prompt_tokens": 12,
12    "completion_tokens": 31,
13    "total_tokens": 43
14  }
15}

1请把 routers/ 目录下所有路由文件从回调风格改成 async/await，要求：
21. 所有 fs/database 的回调调用改成 await + promisify
32. 错误处理统一改成 try/catch，不要再层层传 next(err)
43. 不要改变任何接口的对外行为（请求参数、响应格式必须完全一致）
54. 改完运行 npm test，把失败的测试修到全绿
6
7每改完一个文件先给我看 diff，我确认后再改下一个。

1按照这张设计稿，写一个 React + Tailwind 组件。要求：
21. 布局用 flex，不要用绝对定位
32. 颜色从设计稿里取，写成 Tailwind 的 class
43. 响应式：移动端单列，桌面端三列
54. 组件名叫 ProductCard，props 接收 title/price/imageUrl
65. 只输出组件代码，不要解释

1# 项目规则
2
3## 技术栈
4- TypeScript 5.x + React 18 + Tailwind CSS 3
5- 状态管理用 Zustand，不要用 Redux
6- 数据请求用 TanStack Query，不要手写 useEffect + fetch
7
8## 代码规范
9- 所有导出函数必须有显式返回类型标注
10- 禁止 `any`，实在不行用 `unknown` + 类型守卫
11- 组件文件名用 PascalCase，工具函数用 camelCase
12- 每个组件最多 150 行，超了就拆
13
14## 禁止事项
15- 不要引入新的第三方依赖（需要的话先问我）
16- 不要改 package.json 的版本号
17- 不要动 src/legacy/ 目录
18- 不要写 console.log，用统一的 logger
19
20## 已知易错点
21- 分页函数的 pageSize 为 0 时返回空数组，不抛异常（AI 经常搞错这条）
22- 时间统一用 UTC 存储、本地时区展示，不要混用

1✅ 把 .clinerules 这类固定内容放在最前面，措辞每次都一样
2✅ 同一任务连续多轮追问（前缀自然复用）
3✅ Cline 的连续工具调用会自动命中（它每次都带相同的 system prompt）
4❌ 在提示词里插时间戳 / 随机数（前缀一变全失效）
5❌ 每次对话都改一个字的 system prompt

1阶段 1（入门）：Continue + 豆包 Pro 跑通补全和问答        ← 本篇到这里
2阶段 2（进阶）：Pro / Lite 分流 + 自定义 slash 命令
3阶段 3（高级）：装 Cline 跑多文件重构 + 自动跑测试
4阶段 4（专家）：.clinerules 沉淀团队规范 + Function Calling 接内部系统