# stock_view

**Repository Path**: zhudunfeng/stock_view

## Basic Information

- **Project Name**: stock_view
- **Description**: idea插件大A查看器

- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: https://plugins.jetbrains.com/plugin/30147-stock-view/
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-10
- **Last Updated**: 2026-03-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# Stock View Plugin

一个功能强大的 IntelliJ IDEA 插件，用于在 IDE 中实时查看中国 A 股股票数据，支持多种高级功能。

## 目录

- [功能特性](#功能特性)
- [快速开始](#快速开始)
- [详细使用说明](#详细使用说明)
- [界面说明](#界面说明)
- [技术架构](#技术架构)
- [开发与构建](#开发与构建)
- [常见问题](#常见问题)
- [版本历史](#版本历史)
- [许可证](#许可证)
- [贡献指南](#贡献指南)
- [联系方式](#联系方式)

## 功能特性

- **实时行情查看**：实时获取股票最新价格、涨跌额、涨跌幅等详细信息
- **K 线图展示**：支持日 K、周 K、月 K 等多种时间周期，使用自定义 Java2D 绘制
- **自选股管理**：添加、移除和管理自选股票，数据持久化存储
- **多维度筛选**：支持按热门、涨幅、跌幅等维度筛选股票
- **智能搜索**：支持股票代码、名称、拼音缩写等多模式搜索
- **自定义渲染**：涨跌额和涨跌幅根据正负值显示不同颜色（红涨绿跌）
- **API 调用日志**：记录 API 调用情况，支持查看和定时清理
- **后台线程处理**：网络请求在后台线程执行，避免 UI 阻塞
- **缓存机制**：添加股票信息缓存，减少重复网络请求
- **响应式设计**：适配不同 IDE 窗口大小和分辨率

## 快速开始

### 安装方式

1. 下载插件 JAR 包
2. 在 IntelliJ IDEA 中打开 `Settings/Preferences` → `Plugins`
3. 点击 `Install Plugin from Disk...`
4. 选择下载的 JAR 文件并重启 IDE

### 打开工具窗口

通过 `View` → `Tool Windows` → `Stock View` 打开股票查看面板。

## 详细使用说明

### 搜索股票

1. 点击工具栏上的搜索图标或使用快捷键
2. 输入股票代码（如 `600000`）、名称（如 `浦发银行`）或拼音缩写（如 `pfyh`）
3. 从下拉列表中选择目标股票

### 查看详情

在股票列表中双击任意股票，或点击操作列的查看按钮，可打开详情窗口查看：
- 基本信息（代码、名称、交易所）
- 实时行情（最新价、涨跌额、涨跌幅）
- K 线图（支持切换不同周期）

### 管理自选

- **添加自选**：在股票详情窗口点击"添加自选"
- **移除自选**：点击"取消收藏"或从列表中移除
- **查看自选**：切换到"自选"标签页

### 刷新数据

- **手动刷新**：点击工具栏上的刷新按钮
- **自动刷新**：插件默认每 30 秒自动刷新数据

### 查看 API 调用日志

点击工具栏上的日志图标，可查看 API 调用历史和详细信息。

## 界面说明

### 主面板

| 列名 | 说明 |
|------|------|
| 操作 | 查看详情、添加/移除自选 |
| 代码 | 股票代码 |
| 名称 | 股票名称 |
| 最新价 | 当前成交价格 |
| 涨跌额 | 相比昨收涨跌金额，正数显示为红色，负数显示为绿色 |
| 涨跌幅 | 相比昨收涨跌百分比，正数显示为红色，负数显示为绿色 |

### 筛选标签

- **全部**：所有股票
- **自选**：用户收藏的股票
- **热门**：当前热门股票
- **涨幅榜**：涨幅排名前列
- **跌幅榜**：跌幅排名前列

### 工具栏

- **搜索**：打开股票搜索对话框
- **刷新**：手动刷新股票数据
- **日志**：查看 API 调用日志
- **设置**：打开插件配置选项

## 技术架构

### 核心技术栈

- **UI 框架**：Swing / IntelliJ Platform Swing 组件
- **网络请求**：OkHttp 4.x
- **数据解析**：Gson + JSON 库
- **图表绘制**：Java2D 自定义绘制
- **数据存储**：IntelliJ Platform Persistence API
- **构建工具**：Gradle 8.7
- **IDE 集成**：IntelliJ Platform SDK 2022.3+

### 核心模块

1. **API 模块**：负责与东方财富 API 通信，获取股票数据
2. **UI 模块**：实现插件的用户界面，包括工具窗口、对话框等
3. **服务模块**：提供自选股管理等核心服务
4. **工具模块**：包含股票代码处理等工具类

### 数据流程

1. 用户操作触发数据请求
2. 后台线程通过 OkHttpClient 调用东方财富 API
3. 解析 API 返回的 JSON 数据
4. 更新本地缓存和 UI 显示
5. 记录 API 调用日志

## 开发与构建

### 环境要求

- JDK 11+
- IntelliJ IDEA Community/Ultimate 2022.3+
- Gradle 8.7+

### 构建步骤

1. 克隆项目到本地
2. 打开 IntelliJ IDEA，导入项目
3. 等待 Gradle 同步完成
4. 运行 `gradle build` 构建项目
5. 构建产物位于 `build/libs/` 目录

### 开发指南

1. 参考 IntelliJ Platform SDK 文档了解插件开发基础知识
2. 主要开发文件位于 `src/main/java/com/stockview/` 目录
3. 测试文件位于 `src/test/java/com/stockview/` 目录
4. 使用 `gradle runIde` 启动开发模式的 IDE 进行测试

## 常见问题

**Q: 数据不更新怎么办？**
A: 检查网络连接，或尝试手动刷新。如配置了 API Key，请确认 Key 有效。

**Q: 如何切换 K 线周期？**
A: 在股票详情窗口，点击 K 线图上方的周期选择框切换日 K、周 K、月 K。

**Q: 自选数据会丢失吗？**
A: 不会。自选数据会持久化存储在本地，重启 IDE 后自动恢复。

**Q: 为什么涨跌额和涨跌幅显示为绿色？**
A: 插件采用中国股市标准的红涨绿跌显示方式，绿色表示下跌。

**Q: API 调用失败怎么办？**
A: 点击日志按钮查看详细的 API 调用错误信息，检查网络连接和 API 配置。

## 版本历史

### v1.0.0 (2026-02-11)

- 初始版本发布
- 实现实时股票行情查看
- 支持 K 线图展示
- 自选股管理功能
- 多维度股票筛选
- 智能搜索功能
- API 调用日志记录

## 许可证

本项目遵循 [MIT License](LICENSE) 开源协议。

## 贡献指南

欢迎提交 Issue 和 Pull Request 帮助改进本插件。贡献前请确保：

1. 遵循项目的代码风格和架构
2. 编写清晰的提交信息
3. 添加必要的测试用例
4. 确保代码通过构建和测试

## 联系方式

- **问题反馈**：在 GitHub 仓库提交 Issue
- **邮箱**：stockview-plugin@example.com
- **项目地址**：https://github.com/stockview-plugin/stock-view

## 截图预览

### 主界面

![主界面预览](image.png)

### K 线图

![K 线图预览](image-1.png)

### 搜索功能

![搜索功能预览](image-2.png)