# MoFin — 持仓分析与策略管理系统

## 概述

MoFin（Mo Fin/莫Fin）是知微的持仓分析与策略管理系统。提供实时行情监控、策略生命周期管理、自动盯盘推送、知识萃取等功能。

## 目录结构

```
MoFin/
├── src/           # 核心源码（Linux 服务器端）
│   ├── server.py                    # Flask Web Dashboard (port 8899)
│   ├── strategy_lifecycle.py        # 策略生命周期管理（核心引擎）
│   ├── technical_analysis.py        # 技术分析模块（枢轴点/支撑压力）
│   ├── strategy_evaluator.py        # 策略双维度评估
│   ├── strategy_feedback.py         # 策略反馈引擎
│   ├── advice_reconciliation.py     # 建议对齐工具
│   ├── check_key_levels.py          # 关键价位检查
│   ├── get_realtime_prices.py       # 腾讯API实时行情
│   ├── bulk_strategy_regenerate.py  # 批量策略重生成
│   ├── post_mortem.py               # 事后分析
│   ├── market_watch.py              # 市场数据采集
│   ├── system_health_check.py       # 系统健康检查
│   ├── regenerate_strategies.py     # 策略重生成
│   └── prompt_manager/              # 📝 提示词版本管理模块
│       ├── registry.py              #   注册表CRUD + 版本管理
│       ├── tracking.py              #   策略→提示词版本关联
│       ├── analytics.py             #   版本有效性分析引擎
│       └── dashboard_views.py       #   Dashboard API路由
├── clients/        # 客户端程序（在其他机器上运行）
│   └── tdx-relay/                   # 🚀 通达信行情中继
│       ├── docs/TDX_DEV_GUIDE.md    #   开发指南（给小小莫）
│       ├── src/relay/               #   中继源代码
│       │   ├── tdx_client.py        #   opentdx 连接封装（待小小莫实现）
│       │   ├── config.py            #   配置（招商证券IP等）
│       │   └── pusher.py            #   推送数据到MoFin API
│       ├── scripts/
│       │   ├── run_relay.py         #   运行入口
│       │   └── install_deps.bat     #   Windows依赖安装
│       └── tests/
│           ├── test_tdx_connect.py  #   通达信连接测试
│           └── test_push.py         #   MoFin API推送测试
├── data/          # 运行时数据（JSON）
│   ├── portfolio.json               # 持仓数据
│   ├── watchlist.json               # 自选股
│   ├── decisions.json               # 策略决策库
│   ├── evaluation.json              # 评估数据
│   ├── accuracy_stats.json          # 准确率统计
│   ├── prompts/                     # 📝 提示词版本数据
│   │   ├── registry.json            #   注册表
│   │   ├── versions/                #   版本内容文件
│   │   └── associations.json        #   策略关联记录
│   └── ...（其他运行时数据）
├── docs/          # 文档
│   ├── EXPERT_SYSTEM_DESIGN.md      # 专家系统设计说明书
│   ├── SYSTEM_ARCHITECTURE.md       # 系统架构文档
│   └── PROMPT_MANAGER.md            # 📝 提示词管理模块说明
└── README.md      # 本文件
```

## 数据流

```
                ┌────────────────────────────────────────┐
                │  小小莫 (Windows)                       │
                │  通达信中继 → POST /api/update/realtime │
                └────────────────┬───────────────────────┘
                                 │ 实时港股行情
                                 ▼
┌─── 腾讯API (实时A股) ──→  MoFin Dashboard (:8899) ──→ 知微 → XMPP → 老爸
└─── 通达信中继 (实时港股) ──↗
                                 │
                                 ▼
                           price_monitor.py → 价格偏离检测
                                 │
                                 ▼
                           strategy_lifecycle.py → 策略评估
                                 │
                                 ▼
                           cron_to_xmpp.py → XMPP推送
```

## 数据源说明

| 数据 | 来源 | 实时性 | 备注 |
|------|------|--------|------|
| A股行情 | 腾讯API (qt.gtimg.cn) | 实时 | 稳定运行 |
| 港股行情 | 通达信中继 → 招商证券主站 | **实时** | 解决原15分钟延迟 |
| K线/技术面 | 腾讯API + 新浪API | 日线级 | 收盘后补充 |
| 策略数据 | strategy_lifecycle.py | 按需 | 技术面驱动 |

## 中继系统（tdx-relay）

小小莫在 Windows 上运行 `clients/tdx-relay/` 下的程序，利用招商证券（通达信内核）的行情主站获取实时港股行情，推送到 MoFin Dashboard。

详见：[clients/tdx-relay/docs/TDX_DEV_GUIDE.md](clients/tdx-relay/docs/TDX_DEV_GUIDE.md)

## Cron 任务清单

| 任务 | 频率 | 说明 |
|------|------|------|
| price_monitor.py | 每1分钟 | 价格偏离监控 |
| market_watch.py | 每30分钟 | 市场数据采集 |
| system_health_check.py | 每日9:00 | 系统健康检查 |
| cron_to_xmpp.py | 每1分钟 | 报告→XMPP推送 |
| sync_dashboard.py | 每小时 | 数据同步 |
| bulk_strategy_regenerate.py | 收盘后 | 全量策略重评 |
| strategy_evaluator.py | 每日21:00 | 双维度评估 |
| advice_reconciliation.py | 周六20:00 | 建议对账 |
| 知识萃取 | 16:30 | 经验日志写入 |
| 快速盯盘 | 每15分钟(交易时段) | 盘面监控 |
| 持仓复查 | 周四20:00 | 全面复查 |

## 提示词版本管理

MoFin 内置了提示词版本管理系统，所有知微用到的提示词（策略生成规则、盯盘prompt、报告格式等）都在 `prompt_manager` 中统一管理，每个版本关联生成的策略，并统计哪个版本最有效。

详见 `docs/PROMPT_MANAGER.md`，Dashboard 中也有「提示词」Tab。