补全

​

用户交互模型

​

能力

{
  "capabilities": {
    "completions": {}
  }
}

​

协议消息

​

请求补全

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "completion/complete",
  "params": {
    "ref": {
      "type": "ref/prompt",
      "name": "code_review"
    },
    "argument": {
      "name": "language",
      "value": "py"
    }
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "completion": {
      "values": ["python", "pytorch", "pyside"],
      "total": 10,
      "hasMore": true
    }
  }
}

​

引用类型

​

补全结果

• 每个响应最多100个项目
• 可选的可用匹配总数
• 表示是否存在额外结果的布尔值

​

消息流

​

数据类型

​

CompleteRequest

• ref：PromptReference或ResourceReference
• argument：包含以下内容的对象：
  • name：参数名称
  • value：当前值

​

CompleteResult

• completion：包含以下内容的对象：
  • values：建议数组（最多100个）
  • total：可选的匹配总数
  • hasMore：额外结果标志

​

错误处理

• 方法未找到：-32601（不支持的能力）
• 无效的提示名称：-32602（无效参数）
• 缺少必需参数：-32602（无效参数）
• 内部错误：-32603（内部错误）

​

实施考虑

1. 服务器应该：
   • 返回按相关性排序的建议
   • 在适当的情况下实现模糊匹配
   • 限制补全请求速率
   • 验证所有输入
2. 客户端应该：
   • 防抖快速补全请求
   • 在适当的情况下缓存补全结果
   • 优雅地处理缺失或部分结果

​

安全

• 验证所有补全输入
• 实施适当的速率限制
• 控制对敏感建议的访问
• 防止基于补全的信息泄露