文心快码（Baidu Comate）接入 VS Code 完整指南

1✅ 中文注释 / 中文需求文档 → 代码（文心的绝对强项）
2✅ 国内企业的合规敏感项目（私有化部署方案成熟）
3✅ 大型代码库里定位「这段代码在哪」（代码库级检索）
4✅ 金融 / 政务 / 国企项目（合规审查容易过）
5✅ 用百度系技术栈（百度智能云、飞桨、文心 API）
6✅ 不想折腾 API Key 的新手（官方扩展零配置）
7✅ 团队要统一管理、要审计日志（企业版功能完整）

1❌ 纯英文开源项目（Copilot 略占优）
2❌ 极致成本敏感的高频补全（选 DeepSeek V4.1 Flash 更便宜）
3❌ 需要超长上下文（128K 不如 Kimi / DeepSeek 的 256K-1M）
4❌ 需要 Agent 自动改一堆文件 + 跑测试（要用 Cline，走路径 B）
5❌ 需要本地跑开源模型（文心不开源）

1# 从订单表里捞最近 30 天已支付但未发货的订单
2# 每个订单要带上用户昵称和收货地址
3# 金额超过 500 的要标记出来，方便客服优先处理
4# 结果按下单时间倒序，最多取 200 条

1def get_pending_ship_orders(session, days: int = 30) -> list[dict]:
2    """
3    查询最近 N 天已支付但未发货的订单。
4
5    Args:
6        session: 数据库 session
7        days: 时间窗口天数，默认 30
8
9    Returns:
10        订单字典列表，金额 > 500 的订单带 priority=True 标记
11    """
12    cutoff = datetime.now() - timedelta(days=days)
13
14    query = (
15        session.query(Order, User.nickname, Address.detail)
16        .join(User, Order.user_id == User.id)
17        .outerjoin(Address, Order.address_id == Address.id)
18        .filter(Order.status == OrderStatus.PAID)
19        .filter(Order.shipped_at.is_(None))
20        .filter(Order.created_at >= cutoff)
21        .order_by(Order.created_at.desc())
22        .limit(200)
23    )
24
25    result = []
26    for order, nickname, address in query.all():
27        result.append({
28            "order_id": order.id,
29            "nickname": nickname,
30            "address": address or "",
31            "amount": order.amount,
32            "priority": order.amount > 500,
33            "created_at": order.created_at,
34        })
35    return result

1def get_recent_orders(session, days=30):
2    cutoff = datetime.now() - timedelta(days=days)
3    orders = (
4        session.query(Order)
5        .filter(Order.status == 'paid')
6        .filter(Order.created_at >= cutoff)
7        .order_by(Order.created_at.desc())
8        .limit(200)
9        .all()
10    )
11    return orders

1我是文心快码，由百度开发的 AI 编程助手，基于文心大模型。
2我可以帮你做代码补全、代码解释、单元测试生成、代码库检索等任务。

1{
2  // ===== 身份与模型 =====
3  // 模型选择。官方扩展支持文心系列多个规格，
4  // 一般不用手填，面板里的下拉框选了会同步到这里
5  "comate.model": "ernie-code-default",
6
7  // 登录态由扩展自己维护，路径 A 不需要填 API Key。
8  // 只有走路径 B（千帆 API）才需要，这里保留注释
9  // "comate.apiKey": "bce-v3/ALTAK-xxxxxxxx",
10
11  // ===== Tab 自动补全 =====
12  // 补全总开关
13  "comate.inlineSuggest.enabled": true,
14
15  // 触发延迟（毫秒）。停止打字后等多久请求补全。
16  // 小于 200 会疯狂发请求且打断思路，大于 800 会感觉「补全不出来」
17  "comate.suggestionDelay": 350,
18
19  // 候选数量。1 条最省，3 条可用 Alt+] 切换
20  "comate.maxSuggestions": 1,
21
22  // 生效语言白名单，没写的不触发补全
23  "comate.enabledLanguages": [
24    "python", "javascript", "javascriptreact",
25    "typescript", "typescriptreact", "go", "rust",
26    "java", "csharp", "cpp", "c", "php", "ruby",
27    "kotlin", "swift", "scala", "sql", "shellscript"
28  ],
29
30  // ===== 代码库级检索（文心快码的差异化功能） =====
31  // 是否建立全仓库索引。打开后能回答「XX 功能在哪个文件」，
32  // 但首次建索引会耗时（1 万行约 30 秒）并占用本地资源
33  "comate.codebaseIndex.enabled": true,
34
35  // 索引忽略的目录（不建索引，省时间也避免噪声）
36  "comate.codebaseIndex.exclude": [
37    "**/node_modules/**",
38    "**/dist/**",
39    "**/build/**",
40    "**/.git/**",
41    "**/vendor/**",
42    "**/*.min.js"
43  ],
44
45  // 检索时返回的最大文件数
46  "comate.codebaseIndex.maxResults": 8,
47
48  // ===== 侧边栏问答 =====
49  // 问答默认带光标前后各多少行上下文
50  "comate.chat.contextLines": 150,
51
52  // 问答时是否自动检索代码库（比手动 @ 方便，但多花约 1000 tokens）
53  "comate.chat.autoCodebaseSearch": false,
54
55  // ===== 生成参数 =====
56  // 温度。写代码要确定性，0.2 合适
57  "comate.temperature": 0.2,
58
59  // 单次最大输出 token
60  "comate.maxTokens": 8192,
61
62  // ===== 体验 =====
63  // 流式输出（打字机效果）
64  "comate.stream": true,
65
66  // 隐私模式：开启后只发送光标附近片段，不发送整个文件
67  "comate.privacyMode": false,
68
69  // 状态栏常驻显示，方便确认没跑错模型
70  "comate.showStatusBar": true,
71
72  // 是否在保存文件时自动检查（会额外消耗额度）
73  "comate.autoReviewOnSave": false
74}

1API Key:    bce-v3/ALTAK-8xKq2mPvN4wRtY6uI0oP
2Secret Key: aSdF1gH2jK3lZ4xC5vB6nM7qW8eR9tY0

1API Provider: OpenAI Compatible
2Base URL:     https://qianfan.baidubce.com/v2
3API Key:      bce-v3/ALTAK-8xKq2mPvN4wRtY6uI0oP
4Model ID:     ep-20260714120533-c7x2m   （或 ernie-4.0-turbo-128k）

1{
2  // Provider 必须是 openai-compatible，千帆 /v2 走 OpenAI 协议
3  "apiProvider": "openai-compatible",
4
5  // ⚠️ 千帆的 OpenAI 兼容端点是 /v2，不是 /v1
6  "openAiBaseUrl": "https://qianfan.baidubce.com/v2",
7
8  // 千帆的 API Key
9  "openAiApiKey": "bce-v3/ALTAK-8xKq2mPvN4wRtY6uI0oP",
10
11  // 模型 ID：接入点 ID 或模型名，两种都试
12  "openAiModelId": "ep-20260714120533-c7x2m",
13
14  // 模型能力声明
15  "openAiModelInfo": {
16    "maxTokens": 8192,
17    // 文心官方 128K，但 Cline 里填 64000 更实际，
18    // 填满会导致每次请求塞超长上下文，又慢又贵
19    "contextWindow": 64000,
20    "supportsImages": false,
21    "supportsPromptCache": true,
22    "inputPrice": 1.5,
23    "outputPrice": 4.5
24  },
25
26  // 单次输出上限
27  "maxTokens": 8192,
28
29  // 温度：Agent 干活要确定性
30  "temperature": 0.2,
31
32  // 只读操作可自动批准（读文件、列目录）
33  "autoApproveReadOnly": true,
34
35  // ⚠️ 写文件和跑命令必须手动批准
36  "autoApproveWrite": false,
37  "autoApproveExecute": false,
38
39  // 流式输出
40  "streamEnabled": true,
41
42  // 超时（秒）。文心长任务可能超过 60 秒
43  "requestTimeoutMs": 120000
44}

1{
2  "models": [
3    {
4      // 侧边栏对话主模型：文心
5      "title": "文心快码",
6      "provider": "openai",
7      // 接入点 ID 或模型名
8      "model": "ep-20260714120533-c7x2m",
9      "apiKey": "bce-v3/ALTAK-8xKq2mPvN4wRtY6uI0oP",
10      // ⚠️ /v2 不是 /v1
11      "apiBase": "https://qianfan.baidubce.com/v2",
12      "contextLength": 64000,
13      "completionOptions": {
14        "temperature": 0.2,
15        "maxTokens": 8192
16      }
17    },
18    {
19      // 备用：便宜模型做补全兜底
20      "title": "文心 Speed",
21      "provider": "openai",
22      "model": "ernie-speed-128k",
23      "apiKey": "bce-v3/ALTAK-8xKq2mPvN4wRtY6uI0oP",
24      "apiBase": "https://qianfan.baidubce.com/v2",
25      "contextLength": 16000,
26      "completionOptions": {
27        "temperature": 0.1,
28        "maxTokens": 2048
29      }
30    }
31  ],
32
33  // Tab 补全单独用小模型省钱
34  "tabAutocompleteModel": {
35    "title": "文心 Speed (Tab)",
36    "provider": "openai",
37    "model": "ernie-speed-128k",
38    "apiKey": "bce-v3/ALTAK-8xKq2mPvN4wRtY6uI0oP",
39    "apiBase": "https://qianfan.baidubce.com/v2",
40    "contextLength": 8192
41  },
42
43  "tabAutocompleteOptions": {
44    // 停止输入后等待多久触发（毫秒）
45    "debounceDelay": 350,
46    // 单次补全最大 prompt token
47    "maxPromptTokens": 1024,
48    // 单行补全，多行又慢又容易错
49    "multilineCompletions": "never",
50    "prefixPercentage": 0.7,
51    "maxSuffixPercentage": 0.2
52  },
53
54  // 嵌入模型用本地的，避免额外费用和依赖
55  "embeddingsProvider": {
56    "provider": "transformers.js"
57  },
58
59  // 自定义 slash 命令
60  "slashCommands": [
61    {
62      "name": "test",
63      "description": "为选中代码生成单元测试",
64      "prompt": "为下面这段代码生成完整单元测试，使用项目现有测试框架。要求：\n1. 覆盖正常路径 + 至少 2 条异常/边界路径\n2. IO 依赖全部 mock\n3. 风格对齐项目已有测试\n4. 只输出测试代码\n\n{{{ input }}}"
65    },
66    {
67      "name": "comment",
68      "description": "补中文注释",
69      "prompt": "为这段代码补充中文注释：\n- 每个函数一句 docstring，说明做什么、参数、返回值\n- 只在逻辑不明显处加行内注释，说明「为什么」\n- 不要逐行废话注释\n- 保持原有代码不变\n\n{{{ input }}}"
70    },
71    {
72      "name": "review",
73      "description": "代码评审",
74      "prompt": "以资深工程师视角评审这段代码，重点找：\n1. 逻辑错误和边界条件遗漏\n2. 性能问题（N+1 查询、重复计算、内存泄漏）\n3. 安全隐患（注入、越权、敏感信息泄露）\n4. 可读性问题\n按严重程度排序，每条给出行号和修改建议。\n\n{{{ input }}}"
75    }
76  ]
77}

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"
10  ],
11
12  // 写文档时不要被补全打断
13  "continue.disableTabAutocompleteIn": ["markdown", "plaintext"]
14}

1curl -X POST https://qianfan.baidubce.com/v2/chat/completions \
2  -H "Content-Type: application/json" \
3  -H "Authorization: Bearer bce-v3/ALTAK-8xKq2mPvN4wRtY6uI0oP" \
4  -d '{
5    "model": "ep-20260714120533-c7x2m",
6    "messages": [{"role": "user", "content": "你好，一句话介绍自己"}],
7    "temperature": 0.2
8  }'

1{
2  "id": "as-20260714120845-x7k2m",
3  "object": "chat.completion",
4  "choices": [
5    {
6      "message": { "role": "assistant", "content": "我是文心一言，由百度开发..." },
7      "finish_reason": "stop"
8    }
9  ],
10  "usage": { "prompt_tokens": 11, "completion_tokens": 28, "total_tokens": 39 }
11}

1# 订单导出接口
2# 支持按时间范围和订单状态筛选
3# 导出成 Excel，文件名带上导出时间
4# 超过 1 万条要走异步任务，不要阻塞请求

1这个项目里，用户积分是怎么扣减的？
2请告诉我涉及的文件、函数名和完整调用链。

1积分扣减的调用链：
2
31. 入口：api/points.py:42  POST /api/v1/points/deduct
42. 校验：services/points.py:18  check_balance()
5   检查积分是否足够，不够抛 InsufficientPointsError
63. 扣减：services/points.py:56  deduct()
7   开启事务 → 写 points_record 表 → 更新 user.points
84. 落库：models/point.py:88   PointsRecord.create()
95. 副作用：tasks/notify.py:23  扣减后异步发站内信
10
11注意：第 3 步的事务边界只包住了写记录，没包住更新 user.points，
12极端情况下可能出现记录写了但余额没扣的不一致。

1请把 blueprints/ 目录下 6 个文件的函数视图改成 Flask MethodView 类视图：
21. 每个资源一个类，get/post/put/delete 对应同名方法
32. 装饰器（@login_required 等）移到 dispatch_request 或类装饰器上
43. 路由注册统一改成 add_url_rule
54. 不要改任何接口的对外行为
65. 改完运行 pytest，把失败测试修到全绿
7每改完一个文件给我看 diff，确认后再改下一个。

1# 项目规则
2
3## 技术栈
4- Python 3.11 + Flask 2.3 + SQLAlchemy 2.0
5- 测试用 pytest，不用 unittest
6- 异步任务用 Celery + Redis
7
8## 代码规范
9- 所有公开函数必须有类型注解和 docstring
10- docstring 用中文，Google 风格
11- 每个函数不超过 50 行
12- 数据库查询必须显式指定字段，不要 select *
13
14## 禁止事项
15- 不要引入新依赖
16- 不要改 requirements.txt 的版本号
17- 不要动 legacy/ 目录
18- 不要用 print，统一用 logging
19
20## 已知易错点（AI 常犯的）
21- 手机号正则不支持 +86 前缀，不要假设支持
22- 身份证校验的闰年逻辑在 utils/validators.py:67，照抄别自己写
23- 积分扣减的事务边界有已知 bug，不要顺手改，单独提 issue

1✅ .clinerules 这类固定内容放最前面，措辞不变
2✅ 同一任务连续多轮追问
3✅ Cline 的工具调用循环天然重复前缀，自动命中
4❌ 提示词里插时间戳 / 随机数

1阶段 1（入门）：官方 Comate 扩展，百度账号登录开箱即用      ← 本篇路径 A 到这里
2阶段 2（进阶）：开启代码库索引 + 自定义 slash 命令
3阶段 3（高级）：千帆 API Key + Cline 跑多文件重构
4阶段 4（专家）：企业版私有化部署 + Function Calling 接内部系统