# DeepCode-Assistant

**Repository Path**: lzkong1029/DeepCode-Assistant

## Basic Information

- **Project Name**: DeepCode-Assistant
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-02-26
- **Last Updated**: 2025-02-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# DeepCode-Assistant - IntelliJ IDEA Plugin

[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![Version](https://img.shields.io/badge/version-1.0.0-green.svg)](https://github.com/kobewl/liangAI/releases)

## 📝 项目介绍

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` 文件：

```yaml
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:

```powershell
setx DEEPSEEK_API_KEY "your-actual-api-key"
```

Linux/macOS:

```bash
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](LICENSE) 文件。

## 👨‍💻 作者

**王梁 (Wang Liang)**

- Email: wl3130187893@gmail.com
- GitHub: [@kobewl](https://github.com/kobewl)

## 🙏 致谢

- 感谢 [DeepSeek AI](https://deepseek.com) 提供的强大 API 支持
- 感谢所有为这个项目做出贡献的开发者

## 📞 联系方式

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

- 提交 [Issue](https://github.com/kobewl/liangAI/issues)
- 发送邮件至 wl3130187893@gmail.com
- 访问我的 [GitHub 主页](https://github.com/kobewl)