# cc

**Repository Path**: fqcto/cc

## Basic Information

- **Project Name**: cc
- **Description**: 岛主量化
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-05
- **Last Updated**: 2026-06-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 书记粉丝后援会💎 — 岛主量化

> 对标 同花顺SuperMind / 通达信 / 东方财富 的开源跨平台量化桌面端
> Vue 3 + TypeScript + Vite + Electron

完整产品方案见 [PRODUCT_PLAN.md](./PRODUCT_PLAN.md)。

## ✨ 功能

- 📊 **行情中心** — A 股涨跌榜 / 成交额榜（默认 100 只热门股，10s 自动刷新）
- 📈 **K 线分析** — 日/周/月/分钟 K 线，内置 MA / MACD / KDJ 指标
- ⭐ **自选股** — 本地持久化 + 一键加入
- 🧪 **策略回测** — 简化版 DSL（类通达信公式），输出收益曲线、最大回撤、胜率
- 🔌 **数据源管理** — 自动从 GitHub 探测可用开源接口（akshare / efinance / baostock 等），多源自动降级

## 🚀 快速开始

### 环境要求
- **Node.js ≥ 18**（推荐 20+ 或 22+）
- npm / pnpm / yarn 任一

> 如果你装了 nvm-windows 且默认是 14，可执行 `nvm use 22.18.0`。

### 安装与启动

```bash
# 1. 安装依赖
npm install

# 2. 开发模式（自动启动 Vite + Electron）
npm run dev

# 3. 冒烟测试（不启动 GUI，纯 Node 验证数据接口）
node scripts/smoke-test.mjs

# 4. 打包 Windows .exe
npm run build:win
# 产物：release/书记粉丝后援会💎-0.1.0-x64.exe (NSIS 安装包)
#       release/书记粉丝后援会💎-0.1.0-x64.exe (portable)

# 5. 打包 macOS .dmg
npm run build:mac
```

## 🗂 目录结构

```
cc/
├── PRODUCT_PLAN.md              产品方案
├── README.md                    本文档
├── package.json
├── vite.config.ts
├── tsconfig.json
├── electron-builder.yml         打包配置
├── index.html
├── electron/
│   ├── main.ts                  Electron 主进程
│   ├── preload.ts               IPC 桥接
│   ├── ipc/
│   │   ├── data-handler.ts      行情/K线/自选 IPC handlers
│   │   └── github-discovery.ts  GitHub 接口探测
│   └── data-sources/
│       ├── base.ts              数据源抽象
│       ├── eastmoney.ts         东方财富适配器（默认）
│       ├── sina.ts              新浪财经（备用）
│       └── manager.ts           多源调度 + 健康检查
├── scripts/
│   └── smoke-test.mjs           冒烟测试
└── src/
    ├── main.ts
    ├── App.vue
    ├── router/
    ├── views/
    │   ├── MarketView.vue
    │   ├── ChartView.vue
    │   ├── WatchlistView.vue
    │   ├── StrategyView.vue
    │   └── DataSourceView.vue
    ├── services/indicators.ts   MA/MACD/KDJ 等指标计算
    ├── styles/index.scss        暗色 vibe 主题
    └── types/stock.d.ts
```

## 🔌 数据接口

- **东方财富免费接口**（默认）— 无需 token
  - 行情列表：`push2.eastmoney.com/api/qt/clist/get`
  - K 线：`push2his.eastmoney.com/api/qt/stock/kline/get`
- **新浪财经**（备用快照）— `hq.sinajs.cn`
- **GitHub 自动探测** — 拉取 stars > 100 的 A 股开源 SDK，按热门度排序展示，24h 缓存

## ⚖️ 合规声明

- 仅供学习交流，不提供投资建议
- 所有数据均来自公开免费接口
- 使用者自行承担合规与使用风险

## 📜 License

MIT