# MoFin 提示词管理系统

## 概述

知微（持仓分析师）用到的所有提示词（prompts）的统一管理模块。提供：

1. **集中注册表** — 所有提示词分类管理，可查阅历史版本
2. **版本管理** — 每次修改记录版本号/变更日志/完整内容
3. **策略关联** — 每只股票的策略关联生成它的提示词版本
4. **统计分析** — 按提示词版本聚合策略评估结果，找出最有效的版本

## 模块架构

```
prompt_manager/
├── __init__.py          # 模块入口，导出主要函数
├── models.py            # 数据模型（PromptDef, PromptVersion, StrategyLink）
├── registry.py          # 注册表CRUD + 版本管理
├── tracking.py          # 策略→提示词版本关联记录
├── analytics.py         # 按版本聚合分析引擎
├── dashboard_views.py   # Dashboard API路由 + 前端HTML
└── init_registry.py     # 初始化脚本（录入所有现有提示词版本）
```

## 数据文件

```
data/prompts/
├── registry.json        # 注册表（所有提示词元数据+版本记录）
├── versions/            # 每个版本的完整内容文件
│   ├── strategy-generation-v1.md
│   ├── strategy-generation-v2.md
│   └── ...
└── associations.json    # 策略→提示词版本关联记录
```

## 提示词分类

| 分类 | 说明 | 当前数量 |
|------|------|---------|
| strategy | 策略生成规则 | 6个版本 |
| scan | 快速盯盘 | 3个版本 |
| evaluation | 策略评估 | 2个版本 |
| knowledge | 知识萃取 | 1个版本 |
| review | 持仓复查 | 1个版本 |
| health | 系统健康检查 | 2个版本 |
| format | 报告格式规范 | 3个版本 |
| analysis | 分析规则 | 2个版本 |

## 使用方式

### 查看提示词

通过 MoFin Dashboard (http://192.168.1.246:8899) →「提示词」Tab 查看。

### 添加新版本

```python
from prompt_manager.registry import add_version
from prompt_manager.models import PromptVersion

add_version("strategy-generation", PromptVersion(
    version="v2.5",
    label="新特性描述",
    created_at="2026-06-15T10:00:00",
    changelog="变更说明",
    content="完整提示词内容...",
    status="active",
    tags=["标签1", "标签2"],
))
```

### 切换活跃版本

```python
from prompt_manager.registry import set_active_version
set_active_version("strategy-generation", "v2.5")
```

### 查看版本有效性

```python
from prompt_manager.analytics import generate_report
print(generate_report())
```

或通过 Dashboard → 提示词 →「📊 版本有效性报告」按钮。

### 策略关联

策略生成时自动记录（`strategy_lifecycle.py` 的 `regenerate_all()` 已集成）：

```python
from prompt_manager.tracking import record_strategy_generation
record_strategy_generation("000700", "模塑科技", "盈利持有 | 损13.97 | 盈15.27")
```

## 版本有效性分析逻辑

1. `strategy_lifecycle.py` 生成策略时 → `record_strategy_generation()` 记录关联
2. `strategy_evaluator.py` 评估策略时 → 写入 decisions.json 的 evaluation 字段
3. `analytics.py` 读取两者 → 按 `prompt_id@version` 聚合
4. 聚合指标：策略总数、达到止盈数、跌破止损数、成功率和平均盈亏比

## 演化历史

- **2026-06-09**: v1 机械百分比（止损-15%/止盈+20%）
- **2026-06-11**: v2 技术面支撑压力位
- **2026-06-12**: v2.1 R/R校验+最小波幅；v2.2 止损三级分离+移动止损
- **2026-06-13**: v2.3 买入区R/R约束+时机四象限；v2.4 阈值差异化+止损最小距离