DeepCode-Assistant - IntelliJ IDEA Plugin

📝 项目介绍

DeepCode-Assistant 是一个强大的 IntelliJ IDEA 插件，它集成了 DeepSeek AI 的能力，为开发者提供智能的编码辅助功能。这个插件旨在提高开发效率，帮助开发者更快更好地编写代码。

✨ 主要特性

• 🤖 智能代码生成
• 📚 代码解释和文档生成
• 🔍 代码审查建议
• 💡 实时 AI 编程助手
• ⚡ 流式响应，快速反馈

🛠️ 技术栈

• Java
• IntelliJ Platform SDK
• DeepSeek AI API
• OkHttp3
• Gson
• Spring Framework

📂 项目结构

src/main/
├── java/com/wangliang/deepseek/
│   ├── config/             # 配置类
│   │   └── ApiConfig.java  # API 配置
│   ├── constants/          # 常量类
│   │   └── ApiConstants.java # API 相关常量
│   └── service/           # 服务类
│       └── DeepSeekService.java # DeepSeek API 服务
└── resources/
    ├── application.yml          # 主配置文件
    └── application.yml.example  # 配置文件示例

🚀 快速开始

安装要求

• IntelliJ IDEA 2020.3 或更高版本
• Java 11 或更高版本
• DeepSeek API Key

安装步骤

1. 打开 IntelliJ IDEA
2. 进入 Settings/Preferences → Plugins
3. 点击 Marketplace
4. 搜索 "DeepSeek AI Assistant"
5. 点击 Install

⚙️ 配置说明

1. 配置文件设置

1. 在 src/main/resources 目录下复制 application.yml.example 为 application.yml
2. 编辑 application.yml 文件：

deepseek:
  api:
    # API密钥（必需配置项）
    key: ${DEEPSEEK_API_KEY:your-api-key-here}
    # API调用超时时间（可选，默认60秒）
    timeout-seconds: 60
    # 最大重试次数（可选，默认3次）
    max-retries: 3
    # 重试延迟（可选，默认1000毫秒）
    retry-delay-ms: 1000

# 日志配置
logging:
  level:
    com.wangliang.deepseek: INFO
    root: WARN
  file:
    name: logs/deepseek-assistant.log

2. 环境变量配置（推荐）

为了安全起见，建议通过环境变量设置 API Key：

Windows:

setx DEEPSEEK_API_KEY "your-actual-api-key"

Linux/macOS:

export DEEPSEEK_API_KEY="your-actual-api-key"

3. 配置项说明

配置项	说明	默认值	是否必需
deepseek.api.key	DeepSeek API 密钥	-	是
deepseek.api.timeout-seconds	API 调用超时时间	60	否
deepseek.api.max-retries	失败重试次数	3	否
deepseek.api.retry-delay-ms	重试延迟时间	1000	否

💻 使用方法

1. 安装插件后，在 IDE 右侧工具栏中找到 "DeepCode Assistant" 图标
2. 点击图标打开 AI 助手窗口
3. 输入你的问题或需求
4. 等待 AI 响应并查看建议

快捷键：

• 打开 AI 助手: Ctrl + Alt + D (Windows/Linux) / Cmd + Alt + D (macOS)

🔒 安全说明

为了保护您的 API Key 和其他敏感信息，项目已配置了 .gitignore 文件，以下文件将不会被提交到版本控制系统：

• application.yml（包含实际配置）
• 所有的 .properties 文件
• 日志文件
• IDE 相关文件
• 编译输出目录

建议：

1. 不要直接在代码中硬编码 API Key
2. 使用环境变量或配置文件管理敏感信息
3. 定期更换 API Key
4. 不要将包含敏感信息的配置文件提交到版本控制系统

🤝 贡献指南

欢迎提交 Pull Request 或创建 Issue！

1. Fork 本仓库
2. 创建你的特性分支 (git checkout -b feature/AmazingFeature)
3. 提交你的更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 创建一个 Pull Request

📄 开源协议

本项目基于 MIT 协议开源，详见 LICENSE 文件。

👨‍💻 作者

王梁 (Wang Liang)

• Email: [email protected]
• GitHub: @kobewl

🙏 致谢

• 感谢 DeepSeek AI 提供的强大 API 支持
• 感谢所有为这个项目做出贡献的开发者

📞 联系方式

如果你有任何问题或建议，欢迎通过以下方式联系我：

• 提交 Issue
• 发送邮件至 [email protected]
• 访问我的 GitHub 主页