大模型应用开发 / 系统课时

接入编辑器与编程助手

接入编辑器与编程助手

学习目标

完成本课后,你将能够:

  • 识别编辑器插件连接 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 权限

任务目标:控制写入和终端。输入或初始条件:助手支持工具调用。实现要求:定义自动、确认和禁止操作。验收条件:密钥、生产命令和仓库外路径被禁止。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

接入编辑器与编程助手

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通