# god-python

**Repository Path**: wjyuian/god-python

## Basic Information

- **Project Name**: god-python
- **Description**: 好用的 python
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-12
- **Last Updated**: 2026-08-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# god-python

个人 Python 工具集，按功能分文件夹管理。

---

## 目录结构

```
god-python/
├── README.md                    # 本文件
├── runner.py                    # 多策略选股综合执行器
├── stock_common.py              # 公共工具（网络/K线/MACD/KDJ/周线）
├── data/
│   └── tracking.db              # 统一数据库（多策略）
├── report.html                  # 统一报告（策略+日期双切换）
└── strategies/                  # 策略目录（动态加载）
    ├── stock_screener_v3/       #   策略1：四条件筛选V3
    │   └── strategy.py
    └── comprehensive_v1/        #   策略2：综合选股策略V1
        └── strategy.py
```

---

## 多策略选股框架

### 快速开始

```bash
# 跑全部策略
python3 runner.py

# 指定策略
python3 runner.py --strategy comprehensive_v1

# 列出所有策略
python3 runner.py --list
```

纯 Python 标准库，无需 `pip install`。建议**收盘后（15:00 后）执行**，保证日 K 线数据完整。

### 策略开发规范（动态可替换）

每个策略是一个文件夹，放在 `strategies/` 下，内含 `strategy.py`，必须暴露：

```python
STRATEGY_ID = "my_strategy"        # 唯一标识
STRATEGY_NAME = "我的策略"          # 显示名称

def select() -> list[dict]:
    """执行选股，返回结果列表"""
    ...
```

`select()` 返回的每个元素必须包含统一字段：

```
code, name, price, close, ma5, ma10, ma20,
score_total, s_trend, s_profit, s_capital, s_value,
scenario, support, resistance, stop_profit
```

公共能力通过 `import stock_common as sc` 复用（K线获取、MA/MACD/KDJ/周线计算、全A股列表等）。

**新增策略三步走**：建文件夹 → 写 `strategy.py` → `runner.py` 自动识别，无需改任何其他代码。

### 已有策略

| 策略 ID | 名称 | 核心逻辑 |
|---------|------|----------|
| `stock_screener_v3` | 四条件筛选V3 | 四条技术条件 + 趋势/筹码/资金/估值评分 |
| `comprehensive_v1` | 综合选股策略V1 | 均线方向+周线兜底+三金叉共振+PE Gate+振幅过滤 |

---

## 数据库（单库多策略）

所有表含 `strategy` 字段，按策略隔离：

| 表名 | 说明 | 更新方式 |
|------|------|----------|
| `tracking` | 累计跟踪（strategy+code 唯一） | 新股插入，老股更新 latest_price |
| `daily_results` | 每日全部选股结果 | 当天覆盖 |
| `daily_top10` | 每日 Top10 快照 | 每天追加 |
| `daily_tracking_snapshot` | 每日跟踪汇总快照 | 当天覆盖 |

每次执行 runner.py 会自动：记录策略 + 选股结果 + 跟踪汇总 + 刷新所有跟踪股票最新价。

---

## 报告页（report.html）

- **策略下拉框** + **日期下拉框** 双维度切换
- 切换策略后，日期列表自动联动
- 四区域：摘要 / Top10 / 梯队明细 / 跟踪汇总

---

## 多设备使用

仓库含 `data/tracking.db` 和 `report.html`，家里电脑 `git pull` 后直接执行，数据连续不中断。

---

## 添加其他工具

在根目录下创建新文件夹，在此 README 中添加说明即可。

```
god-python/
├── strategies/          # 选股策略（多策略框架）
└── your-new-tool/       # 其他新工具
    └── main.py
```