大模型应用开发 / 系统课时
接入编辑器与编程助手
接入编辑器与编程助手
学习目标
完成本课后,你将能够:
- 识别编辑器插件连接 Ollama 的常见配置
- 选择适合代码任务的模型与上下文
- 控制仓库文件、终端和工具权限
- 用编译与测试评估代码助手效果
接入方式
编辑器或命令行编程助手通常支持以下一种方式:
- 原生 Ollama Provider
- OpenAI 兼容 Provider
- 自定义 HTTP Provider
- 本地代理或模型网关
具体字段取决于插件。配置前应阅读插件官方文档,确认它是否支持聊天、补全、嵌入、工具和流式。
常见配置概念
text
provider: ollama 或 openai-compatible
base_url: http://localhost:11434 或 http://localhost:11434/v1
model: <CODE_MODEL>
context_length: <SUPPORTED_CONTEXT>
temperature: 0这只是概念示例,不是某个插件的真实配置文件。不要把未知字段写入插件并假定生效。
模型选择
代码助手需要根据功能选择:
| 功能 | 重点 |
|---|---|
| 代码解释 | 仓库上下文、语言理解 |
| 代码生成 | 可编译率、版本约束 |
| 补全 | 低延迟、短输出 |
| 调试 | 错误日志和跨文件推理 |
| Agent 修改 | 工具调用、补丁与测试 |
| 仓库问答 | 嵌入检索和长上下文 |
大型推理模型未必适合低延迟行内补全。
上下文管理
编程助手可能把以下内容送入模型:
- 当前文件
- 打开的标签页
- 选中代码
- 仓库索引结果
- Git diff
- 终端日志
- 项目规则文件
上下文过多会增加延迟和显存。应限制文件类型、最大大小和排除目录,例如构建产物、依赖目录、密钥和二进制文件。
敏感文件排除
至少排除:
text
.env
*.pem
*.key
credentials.*
secrets/**
node_modules/**
build/**
dist/**
.git/**真实规则应结合项目。前端忽略列表不等于安全保障,插件和索引器必须真正不读取这些文件。
工具与终端权限
Agent 型助手可能请求:
- 读写文件
- 执行命令
- 安装依赖
- 提交 Git
- 调用网络
- 修改数据库
推荐默认:
- 只读模式开始
- 写入前显示 diff
- 命令执行需确认
- 禁止读取密钥
- 限制工作目录
- 危险命令黑名单与权限隔离
- 每次操作可撤销
验证连接
在终端先确认模型服务:
bash
curl --fail --silent --show-error http://localhost:11434/api/tags预期结果:
text
返回包含目标代码模型的 models 数组。如果插件使用兼容接口,再验证:
bash
curl --fail --silent --show-error http://localhost:11434/v1/chat/completions -H "Content-Type: application/json" -d '{
"model": "<CODE_MODEL>",
"messages": [
{"role": "user", "content": "只回答:connected"}
]
}'预期结果:
text
HTTP 200,choices[0].message.content 非空。评估编程质量
使用真实项目任务:
- 修复带测试的 Bug
- 为现有函数补单测
- 解释一个跨文件调用链
- 按项目版本生成配置
- 修改代码但不改变无关文件
- 运行格式化与测试
指标包括测试通过率、无关改动、虚构 API、响应时间和人工修正量。
本课练习
练习 1:配置只读助手
任务目标:完成安全接入。输入或初始条件:选择一个支持 Ollama 的编辑器插件。实现要求:配置地址、模型和文件排除。验收条件:助手不能修改文件或执行命令。
练习 2:评估代码模型
任务目标:用测试而非主观印象选型。输入或初始条件:准备 10 个带验收的代码任务。实现要求:比较两个模型。验收条件:报告包含测试通过率和平均响应时间。
练习 3:设计 Agent 权限
任务目标:控制写入和终端。输入或初始条件:助手支持工具调用。实现要求:定义自动、确认和禁止操作。验收条件:密钥、生产命令和仓库外路径被禁止。
按自己的节奏,确认真正理解。