AI 代理
Sidian 的 AI 代理是智能助手，可以帮助您编写、理解和重构代码。本指南将说明如何与 AI 代理互动，并利用其功能来增强您的开发流程。
AI 代理概述
Sidian 提供了几种专门的 AI 代理来协助开发的不同方面：
代码助手
- 代码补全和建议
- 函数和类的生成
- 代码重构辅助
- 错误检测和修复
解释代理
- 代码解释和文档生成
- 算法分析
- 架构见解
- 学习建议
与 AI 代理互动
有多种方式可以与 Sidian 的 AI 代理互动：
聊天界面
- 从侧边栏打开 AI 聊天面板
- 用自然语言输入您的问题或请求
- AI 将根据您当前的代码提供上下文相关的回复
- 继续提问以获得更清晰的说明
行内辅助
- 选择代码并按 Ctrl+Shift+L 获取解释
- 右键单击代码以显示上下文菜单选项
- 使用键盘快捷键执行快速 AI 操作
- 将鼠标悬停在错误上以获取 AI 驱动的修复建议
专业提示：AI 代理能够理解您的项目上下文，包括导入的库、编码模式和项目结构。这使得它能提供更准确、更相关的辅助。
代理功能
代码生成
- 函数创建：描述您想要的功能，即可获得完整的函数
- 类结构搭建：生成包含方法和属性的类结构
- 测试生成：为您现有的代码创建单元测试
- 文档生成：生成注释和文档
代码分析
- 错误检测：识别代码中的潜在问题
- 性能优化：提出改进建议以获得更好的性能
- 安全分析：发现安全漏洞
- 代码质量：推荐最佳实践和模式
重构辅助
- 提取方法：将庞大的函数分解
- 重命名变量：在所有文件中保持命名一致
- 组织导入：清理和优化导入语句
- 代码格式化：应用一致的样式
最佳实践
有效沟通
- 具体明确：提供清晰、详细的请求
- 包含上下文：提及编程语言和框架
- 追问：不要犹豫，随时要求澄清
- 提供示例：展示您想要实现的目标
代码审查
- 始终审查：切勿在未经审查的情况下接受 AI 生成的代码
- 彻底测试：运行测试并验证功能
- 理解变更：确保您理解 AI 做了什么
- 保持风格：确保与您的代码库风格一致
隐私与安全
- 敏感数据：谨慎处理专有或敏感代码
- API 密钥：切勿分享 API 密钥或凭证
- 审查建议：验证 AI 建议的安全影响
- 本地处理：对敏感项目使用离线模式
高级功能
自定义提示
为常见任务创建可重用的提示：
上下文管理
- 文件上下文：AI 会考虑当前文件及相关文件
- 项目上下文：理解项目结构和依赖关系
- 历史上下文：以前的对话会为当前回复提供信息
- 选择上下文：专注于所选代码以提供有针对性的辅助
模型选择
为您的任务选择合适的 AI 模型：
- 快速模型：为简单任务提供快速响应
- 高级模型：用于复杂的推理和代码生成
- 专用模型：特定语言或特定领域的模型
- 本地模型：注重隐私的离线处理
故障排除
常见问题
AI 未响应
- 对于云模型：检查互联网连接
- 对于本地模型：验证 Ollama/LM Studio 是否正在运行
- 验证账户状态和订阅
- 尝试刷新 AI 连接
建议不准确
- 在您的请求中提供更多上下文
- 更具体地说明您的要求
- 尝试换一种方式提问
- 使用不同的 AI 模型
性能问题
- 关闭不必要的文件和标签页
- 清除 AI 对话历史
- 切换到更快的 AI 模型
- 检查系统资源
获取帮助
- 文档：全面的指南和教程
- 支持：来自 Sidian 团队的直接帮助
- 反馈：报告问题并提出改进建议
Sidian 中的 AI 代理旨在成为您的编码伴侣，帮助您更快地编写更好的代码，同时在此过程中学习和提高您的技能。