@363045841yyt/klinechart 0.1.4 → 0.1.5

package/README.md

@@ -4,28 +4,33 @@
 
 这是一个基于 Vue 3 和 Canvas 的金融图表绘制库，专注于提供高性能的 K 线图展示功能。该库支持横向滚动、移动平均线（MA）显示以及从多种数据源（包括 **BaoStock**、AKTools）获取金融数据。
 
-![](https://s2.loli.net/2026/01/25/LObQPXmoN4ZdFey.png)
+<img src="https://s2.loli.net/2026/02/01/7j9uHWIvrAGxFBC.png" alt="示例图片" style="border-radius: 8px;">
+
 
 ## 功能特性
 
-- 📊 **K 线图绘制**：使用 Canvas 实现高性能的 K 线图绘制
-- 🎯 **TradingView 级别稳定**：物理像素控制缩放，影线完美居中，无累积偏移
-- 📈 **移动平均线**：支持 MA5、MA10、MA20 等多种移动平均线显示
-- ↔️ **横向滚动**：支持大量历史数据的横向滚动浏览
-- 🎨 **深色模式**：自动适配系统深色模式
-- 📱 **响应式设计**：适配不同屏幕尺寸，支持所有设备像素比（DPR）
-- ⚡ **高性能**：使用 requestAnimationFrame 优化渲染性能
+- **基于 Canvas**：使用 Canvas 实现高性能的 K 线图绘制
+- **响应式设计**：适配不同屏幕尺寸，支持所有设备像素比（DPR），不同 DPR 下绘制清晰
+- **框架无关**：核心逻辑完全独立，不依赖特定框架
 
 ## 技术栈
 
 - [Vue 3](https://vuejs.org/) - 渐进式 JavaScript 框架
-- [Vite](https://vite.dev/) - 下一代前端构建工具
-- [TypeScript](https://www.typescriptlang.org/) - JavaScript 类型检查
-- [Canvas API](https://developer.mozilla.org/zh-CN/docs/Web/API/Canvas_API) - 图形绘制
-- [BaoStock](http://baostock.com/) - 开源金融数据接口（推荐）
-- [AKTools](https://github.com/akfamily/aktools) - 开源金融数据接口库（存在反爬限制）
+- [Rolldown Vite](https://cn.vite.dev/guide/rolldown) - 下一代前端构建工具，极速构建
+- [TypeScript](https://www.typescriptlang.org/)
+- [Canvas API](https://developer.mozilla.org/zh-CN/docs/Web/API/Canvas_API)
 - [Vitest](https://vitest.dev/) - 单元测试框架
 
+## 数据源
+- [BaoStock](http://baostock.com/) - 开源金融数据接口，每日支持十万次 API 调用
+- [AKTools](https://github.com/akfamily/aktools) - 开源金融数据接口库（可能存在反爬限制）
+
+## 使用 NPM 安装组件库
+```bash
+npm i @363045841yyt/klinechart
+```
+
+
 ## 项目结构
 
 ```
@@ -36,15 +41,15 @@ src/
 │       └── baostock.ts  # BaoStock K 线数据接口（推荐）
 ├── components/          # 组件
 │   └── KLineChart.vue   # K 线图主组件
-├── core/               # 核心渲染引擎
+├── core/                # 核心渲染引擎
 │   ├── chart.ts         # 图表控制器
-│   ├── draw/           # 像素对齐工具
+│   ├── draw/            # 像素对齐工具
 │   │   └── pixelAlign.ts
-│   ├── renderers/      # 渲染器
-│   │   ├── candle.ts   # K 线渲染器
+│   ├── renderers/       # 渲染器
+│   │   ├── candle.ts    # K 线渲染器
 │   │   └── ...
-│   ├── scale/          # 缩放控制
-│   └── viewport/       # 视口管理
+│   ├── scale/           # 缩放控制
+│   └── viewport/        # 视口管理
 ├── types/               # 类型定义
 │   ├── kLine.ts         # K 线类型定义
 │   └── price.ts         # 价格类型定义
@@ -56,18 +61,9 @@ src/
 └── assets/              # 静态资源
 ```
 
-## 数据源
-
-本项目支持多种数据源，通过统一接口实现无缝切换。
-
-| 数据源 | 稳定性 | 反爬限制 | 推荐场景 |
-|--------|--------|----------|----------|
-| [BaoStock](http://baostock.com/) | ⭐⭐⭐ 高 | 无 | 生产环境（推荐） |
-| [AKShare](https://github.com/akfamily/akshare) | ⭐⭐ 中 | 有 | 开发测试 |
-
 ### BaoStock（推荐）
 
-BaoStock 是免费开源的 Python 证券数据接口，提供稳定可靠的金融数据服务。
+BaoStock 是免费开源的 Python 证券数据接口，提供稳定可靠的金融数据服务。  
 
 - 官方文档：[http://www.baostock.com/mainContent?file=stockKData.md](http://www.baostock.com/mainContent?file=stockKData.md)
 
@@ -76,9 +72,14 @@ BaoStock 是免费开源的 Python 证券数据接口，提供稳定可靠的金
 ```bash
 # 安装
 uv pip install baostock
+```
+
+由于 BaoStock 未提供 AkTools 的后端接口，需要自行搭建 FastAPI 服务：
+```bash
+git clone https://github.com/363045841/stockbao.git
 
-# 启动服务（需自行实现服务层或参考 BaoStock 文档）
-python your_baostock_server.py
+# 启动服务
+python server.py
 ```
 
 ### AKShare
@@ -87,7 +88,7 @@ AKShare 基于 Python 的开源财经数据接口库，数据来源于东方财
 
 - GitHub：[https://github.com/akfamily/akshare](https://github.com/akfamily/akshare)
 
-> **⚠️ 注意：** 存在反爬机制，频繁请求可能导致 IP 被封禁
+> **⚠️ 注意：** 该库采取直连API，容易触发反爬机制，频繁请求可能导致 IP 被封禁
 
 #### 快速开始
 
@@ -102,7 +103,7 @@ uv run python -m aktools
 pnpm aktools
 ```
 
-### 数据接入配置
+### 后端数据源配置
 
 #### Vite 代理配置
 
@@ -130,9 +131,10 @@ import { fetchKLineData, type KLineDataSourceConfig } from '@/api/data'
 
 const DATA_SOURCE: 'baostock' | 'dongcai' = 'baostock'
 
+// AKshare要求日期为YYYYMMDD格式, BaoStock要求日期为YYYY-MM-DD格式
 const config: KLineDataSourceConfig = {
-  symbol: '601360',        // 统一格式：纯代码
-  startDate: '2024-01-01', // 统一格式：YYYY-MM-DD
+  symbol: '601360',       
+  startDate: '2024-01-01',
   endDate: '2024-12-31',
   period: 'daily',
   adjust: 'qfq',
@@ -142,13 +144,6 @@ const data = await fetchKLineData(DATA_SOURCE, config)
 </script>
 ```
 
-#### 股票代码格式
-
-| 市场 | 格式 | 示例 |
-|------|------|------|
-| 沪市A股 | `sh.` | `sh.600000` |
-| 深市A股 | `sz.` | `sz.000001` |
-
 ## 使用方法
 
 ### 1. 安装依赖
@@ -253,7 +248,7 @@ onMounted(async () => {
 - Node.js: ^20.19.0 || >=22.12.0
 - pnpm: 包管理器
 - Python: 用于运行 AKTools 服务（可选）
-- uv: Python 包与运行器（用于 `pnpm aktools`，可选但推荐）
+- uv: Python 包管理器
 
 ## 构建与部署
 
@@ -269,55 +264,6 @@ pnpm build
 pnpm preview
 ```
 
-## API 接口说明
-
-### getKlineDataBaoStock
-
-从 BaoStock 获取 K 线数据（推荐）。
-
-**参数:**
-
-```ts
-interface BaoStockKLineRequest {
-  symbol: string              // 股票代码，格式：sh.600000 或 sz.000001
-  start_date: string          // 开始日期，格式：YYYY-MM-DD
-  end_date: string            // 结束日期，格式：YYYY-MM-DD
-  period?: 'daily' | 'weekly' | 'monthly' | '5' | '15' | '30' | '60'
-  adjust?: 'qfq' | 'hfq' | 'none'  // qfq: 前复权, hfq: 后复权, none: 不复权
-  timeout?: number            // 超时时间（秒）
-}
-```
-
-**返回值:**
-`Promise<KLineData[]>` - 已转换为标准格式的 K 线数据数组
-
-**特性:**
-- ✅ 支持 1 小时本地缓存
-- ✅ 无反爬限制
-- ✅ 数据自动按时间排序
-
-### getKlineDataDongCai
-
-从 AKTools/东方财富获取 K 线数据。
-
-> **⚠️ 注意：** 此接口依赖 AKShare，存在反爬机制，频繁请求可能导致 IP 被封禁。
-
-**参数:**
-
-```ts
-interface KLineDailyDongCaiRequest {
-  symbol: string              // 股票代码
-  period: 'daily' | 'weekly' | 'monthly' // 周期
-  start_date: string          // 开始日期，格式：YYYYMMDD
-  end_date: string            // 结束日期，格式：YYYYMMDD
-  adjust?: 'qfq' | 'hfq'      // 复权方式，qfq: 前复权, hfq: 后复权
-  timeout?: number            // 超时时间（秒）
-}
-```
-
-**返回值:**
-`Promise<KLineDailyDongCaiResponse[]>` - K 线数据数组（需调用 `toKLineData()` 转换）
-
 ## 贡献
 
 欢迎提交 Issue 和 Pull Request 来改进这个项目。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@363045841yyt/klinechart",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "type": "module",
   "engines": {
     "node": "^20.19.0 || >=22.12.0"