# dingpiao-miao

**Repository Path**: eProduct/dingpiao-miao

## Basic Information

- **Project Name**: dingpiao-miao
- **Description**: 盯票喵 - 股票盯盘与分析 Android App。支持自选股管理、K线图表、AI智能分析、技术指标（MACD/KDJ/RSI）等功能的股票辅助工具。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: develop
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-28
- **Last Updated**: 2026-06-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 盯票喵

股票盯盘与分析 Android App。支持自选股管理、K线图表、AI智能分析、技术指标计算等功能的股票辅助工具。

## 功能特性

- **自选股管理** — 搜索添加/删除自选股票，3秒轮询实时行情，返回首页自动刷新
- **K线图表** — 自定义 Canvas 绘制 K 线，支持 **日线/60分/5分** 三周期 Tab 一键切换
- **AI智能分析** — 一键调用大模型分析盘面，打字机效果逐批输出，附带当前周期 K 线图
- **多维度分析** — 以 **日 K 线（30条）** 为指标基准、**5分钟（48条）** 为短线参考，覆盖 20+ 分析维度
- **技术指标** — MACD 金叉死叉、KDJ 超买超卖、RSI 趋势判断
- **HTTP 耗时统计** — 三大区块（指数/列表/详情）独立计时，页面内联显示
- **加载指示器** — 下拉刷新和返回页面时自动显示进度圈

## 技术栈

| 层级 | 技术 |
|------|------|
| 语言 | Kotlin |
| UI | Jetpack Navigation、Fragment、LiveData、SwipeRefreshLayout |
| 异步 | Kotlin Coroutines、Flow |
| 网络 | OkHttp、Retrofit |
| 持久化 | Room |
| 图表 | 自定义 Canvas 绘制蜡烛图、成交量、MACD |
| 技术指标 | ta4j、自定义 IndicatorCalculator (MACD/KDJ/RSI/SMA) |
| AI | 大模型 API 接入 |
| 构建 | Gradle (Kotlin DSL) + Maven (api-test) |

## 项目结构

```
dingpiao-miao/
├── app/                          # Android 主模块
│   ├── src/main/java/com/dingpiaomiao/app/
│   │   ├── ai/                   # AI 分析逻辑、模板管理
│   │   ├── data/                 # 数据层
│   │   │   ├── local/            # Room 数据库、DAO、Entity
│   │   │   ├── remote/           # 网络请求、数据解析
│   │   │   └── repository/       # Repository 层
│   │   ├── domain/               # 业务逻辑
│   │   │   ├── indicator/        # 技术指标计算 (MACD/KDJ/RSI)
│   │   │   ├── model/            # 数据模型
│   │   │   └── StockAnalyzer.kt  # 多维度分析引擎
│   │   ├── network/              # 网络拦截、监控
│   │   ├── ui/                   # UI 层
│   │   │   ├── addstock/         # 添加自选弹窗
│   │   │   ├── analysis/         # AI 分析页
│   │   │   ├── chart/            # K线/分时图表（自定义 View）
│   │   │   ├── debug/            # 调试浮窗
│   │   │   ├── detail/           # 股票详情（含多周期 Tab 切换）
│   │   │   ├── search/           # 股票搜索
│   │   │   └── stocklist/        # 自选列表（含指数卡片）
│   │   ├── util/                 # 工具类
│   │   ├── AppConfig.kt
│   │   ├── DingPiaoMiaoApp.kt
│   │   └── MainActivity.kt
│   ├── res/                      # 布局、资源
│   └── build.gradle.kts
├── api-test/                     # Spring Boot API 测试工具
└── pom.xml                       # Maven 父 POM
```

## 分析维度

### A. 日线主分析（指标基准）
日 K 线 30 条，MACD/KDJ/RSI 等全部以日线计算。

| 维度 | 说明 |
|------|------|
| 日线趋势 | MA5/MA10/MA20 排列判断中期方向 |
| 日线位置 | 30日高低点分位百分比 |
| 日线均线 | 距 MA5/MA20 偏离度 |
| 日线量能 | 末量/均值比，放量缩量判断 |
| 日线MACD | 金叉/死叉、柱线方向、动能判断 |
| 日线KDJ | 超买/超卖、K/D 交叉 |
| 日线RSI | 超买超卖区间、趋势方向 |
| 日内对比 | 当前最新价 vs 昨日收盘价 |

### B. 5分钟短线参考
5分钟 48 条（一个完整交易日），配合日线做细节判断。

| 维度 | 说明 |
|------|------|
| 分段走势 | 三段式走势 + 振幅 |
| 量价关系 | 上涨/下跌量价同步率 |
| 波动特征 | 近期波动 vs 全量平均对比 |
| 均价偏离 | 收盘偏离近日均价程度 |
| 短线节奏 | 最大连涨/连跌、末三根阴阳组合 |
| 极值距离 | 距近日高低点比例 |
| 短线趋势 | 5min MA5/MA10/MA20 |
| 短线量能 | 5min 成交量变化 |
| 短线动量 | 短时涨跌力度 |
| 支撑压力 | 短线关键价位 |
| 涨跌统计 | 上涨/下跌次数 |
| 形态 | 最后一根 K 线实体判断 |
| 日内量能 | 前后半段量能分布、最大量时间点 |

### C. 综合建议
全部维度加权评分（日线权重 ×2，短线权重 ×1），输出多空结论。

| 评分 | 结论 |
|------|------|
| ≥ 4 | 中期趋势偏多，可积极关注 |
| ≥ 2 | 短线偏多，可逢低关注 |
| ≤ -4 | 中期趋势偏弱，注意控制风险 |
| ≤ -2 | 短线承压，谨慎观望 |
| 其他 | 多空平衡，等待方向选择 |

## 图片展示

![分析卡片](docs/screenshot_analysis.png)

> 打开详情页 → 点击 **AI解析** 按钮 → K 线图默认显示日线，可通过 **日线 / 60分 / 5分** Tab 切换周期 → 分析文字以打字机效果逐段输出

## 构建

```bash
# Debug APK
./gradlew :app:assembleDebug

# Release APK
./gradlew :app:assembleRelease
```

## 配置

在 `AppConfig.kt` 中配置 API 地址和密钥：

```kotlin
object AppConfig {
    const val STOCK_API_BASE = "https://your-stock-api.com"
    const val AI_API_KEY = "your-ai-api-key"
    // ...
}
```

## 许可证

MIT