AI 代码补全

Sidian 由 AI 驱动的代码补全超越了传统的智能感知 (IntelliSense)，可提供能理解您代码意图和模式的、具有上下文感知能力的智能建议。

AI 代码补全的工作原理

智能分析

上下文理解：AI 分析您的整个代码库以提供相关建议
模式识别：从您的编码模式和风格中学习
多语言支持：适用于不同的编程语言
实时处理：在您键入时提供建议

高级功能

整行补全：补全整行代码
多行建议：生成多行相关代码
函数生成：根据注释或名称创建完整的函数
导入建议：自动建议并添加所需的导入

启用代码补全

基本设置

登录：确保您已登录您的 Sidian 账户
启用功能：前往“设置”→“提供商/本地”→“启用代码补全”
选择模型：选择您偏好的 AI 模型用于补全
配置延迟：设置建议出现前的延迟时间（默认：500毫秒）

配置选项

建议数量：显示的建议数量（1-5）
最小触发长度：触发前的最少字符数（1-3）
自动接受：自动接受单个建议
行内显示：在行内显示建议 vs. 在弹出窗口中显示

使用代码补全

基本用法

开始输入：在任何支持的语言中开始输入代码
等待建议：AI 建议将在配置的延迟后出现
接受建议：按 Tab 接受高亮的建议
循环浏览建议：使用 ↑/↓ 箭头浏览多个建议
关闭：按 Esc 关闭建议

键盘快捷键

操作	快捷键	描述
接受建议	`Tab`	接受当前建议
下一个建议	`↓` 或 `Ctrl`+`↓`	移动到下一个建议
上一个建议	`↑` 或 `Ctrl`+`↑`	移动到上一个建议
关闭建议	`Esc`	关闭建议弹出窗口
强制触发	`Ctrl`+`Space`	手动触发建议

补全类型

变量和函数名

智能命名：根据上下文建议有意义的变量名
驼峰命名法：自动以适当的大小写格式化名称
类型推断：根据推断的类型建议名称
遵循惯例：遵循特定语言的命名惯例

代码模式

常见模式：识别并补全常见的编码模式
样板代码：为类、函数生成标准样板代码
错误处理：建议适当的错误处理模式
API 使用：根据文档补全 API 调用

特定语言功能

JavaScript/TypeScript

Promise 处理：Async/await 和 Promise 补全
React 组件：JSX 和 React 钩子模式
Node.js 模块：CommonJS 和 ES6 导入/导出
类型注解：TypeScript 类型补全

Python

列表推导式：复杂的列表推导式模式
装饰器：函数和类的装饰器建议
上下文管理器：With 语句补全
包导入：智能导入建议

Java

流操作：Java 8+ 流方法链
异常处理：Try-catch 块补全
注解使用：Spring、JPA 和其他框架的注解
泛型类型：泛型类型参数补全

C#

LINQ 查询：复杂的 LINQ 表达式补全
异步模式：基于任务的异步模式
属性定义：自动属性和完整属性模式
特性使用：特定框架的特性补全

高级功能

上下文感知建议

项目上下文：理解您的项目结构和依赖关系
文件上下文：考虑当前文件中的导入、变量和函数
选择上下文：根据所选代码提供相关建议
注释驱动：根据注释和文档生成代码

学习与适应

使用模式：从您接受和拒绝的建议中学习
代码风格：适应您的编码风格和偏好
项目特定：学习您项目特有的模式
团队一致性：与团队编码标准保持一致

多语言项目

跨语言：理解不同语言之间的关系
API 边界：建议不同语言之间的适当接口
配置文件：在 JSON、YAML、XML 中补全配置
模板语言：支持 HTML、CSS 和模板引擎

自定义

模型选择

快速模型：建议速度快，准确性较低
平衡模型：在速度和准确性之间取得良好平衡
高级模型：准确性最高，但处理时间较长
本地模型：注重隐私的离线处理

筛选选项

语言筛选：为特定语言启用/禁用
文件类型筛选：控制不同文件类型中的补全
项目筛选：为不同项目设置不同配置
上下文筛选：根据代码上下文（注释、字符串等）进行筛选

性能调优

缓存设置：配置建议缓存
网络超时：为基于云的模型设置超时
批量处理：将多个请求分组以提高效率
资源限制：控制 CPU 和内存使用

故障排除

常见问题

建议未出现

检查设置中是否已启用代码补全
确认您已登录并拥有有效的订阅
对于云模型：确保互联网连接正常
对于本地模型：验证 Ollama/LM Studio 是否正在运行
尝试增加触发延迟

建议缓慢

切换到更快的 AI 模型
减少显示的建议数量
检查网络连接速度
清除建议缓存

建议不相关

通过输入更多字符来提供更多上下文
使用注释来引导 AI
检查是否检测到正确的语言
尝试使用不同的 AI 模型

资源占用高

切换到更轻量的 AI 模型
降低建议频率
如果可用，启用本地处理
关闭不必要的文件和标签页

最佳实践

提供上下文：编写描述性的注释和变量名
保持耐心：给 AI 时间来分析上下文
审查建议：在接受前始终审查生成的代码
学习快捷键：掌握键盘快捷键以高效使用
自定义设置：调整设置以匹配您的开发风格
提供反馈：使用反馈选项来改进建议

Sidian 中的 AI 代码补全旨在提高您的生产力，同时保持代码质量。请花些时间探索和自定义这些功能，以匹配您的开发风格。