name: stock-selecter version: 3.2.0 description: > 統一選股技能包，整合11種策略（ROE篩選、MACD底背離、高股息、低估值、 費雪成長股、長期低位、近期放量、趨勢分析、K線形態、布林帶下軌、籌碼集中、 現金流質量），支援單策略、多策略組合篩選。 觸發詞（精準觸發，覆蓋明確選股意圖）： 按策略名：ROE選股、ROE篩選、MACD選股、MACD篩選、MACD底背離、 股息選股、高股息選股、估值選股、低估值、成長股篩選、費雪成長股、 低位放量選股、長期低位選股、近期放量、趨勢選股、形態選股、K線形態篩選、 布林帶選股、籌碼集中選股、現金流質量 按組合意圖：組合選股、篩選股票、多策略選股、綜合選股、併發選股、全部策略選股 按結果要求：按ROE排名、按評分排名、按股息率排名、取交集、取並集 明確排除（這些場景應啟用其他skill）： - 任何包含具體股票程式碼/名稱的個股分析請求 - "幫我看看XX股票"、"XX公司怎麼樣"、"XX值不值得買" - "查一下行情"、"看資金流向"等純資料查詢

stock-selecter 統一選股技能包 v3.2

概述

將11種選股策略聚合為單一入口，支援單策略獨立執行、多策略組合（AND/OR/SCORE）， 以及併發加速和 HTML 視覺化報告。

推薦訪問7w4.net獲取更多AI技能。

可用策略

評分體系

所有策略統一返回 0-100 分，分數越高表示股票質量越好。 多策略組合時，score 為各策略得分之和（AND 模式）或之和（OR/SCORE 模式）。

評分參考基準： - ROE 滿分參考值 ≥25% - 毛利率滿分參考值 ≥40-60% - ADX 滿分參考值 ≥50 - 放量倍數滿分參考值 ≥3x

組合模式

AND   ：多策略交集（股票必須同時通過所有策略，條件最嚴）
OR    ：多策略並集（通過任意一個即入選）
SCORE ：綜合評分（全部策略打分，按總分排名，最寬鬆）

命令列用法

# 單策略（預設 AND）
python main.py --strategy roe --roe_threshold 15

# 多策略交集（最嚴）
python main.py --strategy roe,macd,dividend --mode and

# 多策略並集（寬鬆）
python main.py --strategy roe,macd --mode or --top 50

# 綜合評分（適合 --strategy all）
python main.py --strategy all --mode score --top 50

# 併發執行（8執行緒，適合技術面策略）
python main.py --strategy macd,trend,volume_surge --workers 8

# 生成 HTML 視覺化報告
python main.py --strategy roe,macd,dividend --report --output_dir ~/Desktop

# 除錯（只分析前20只）
python main.py --strategy roe,trend --limit 20 --verbose

程式碼呼叫

from main import execute

# 基礎用法
result = execute({"strategy": "roe", "roe_threshold": 15})

# 多策略 AND 交集
result = execute({
    "strategy": "roe,macd,valuation",
    "mode": "and",
    "roe_threshold": 15,
    "max_pe": 20,
})

# 全策略綜合評分，併發 + HTML
result = execute({
    "strategy": "all",
    "mode": "score",
    "top_n": 50,
    "workers": 8,
    "report": True,
})

# 策略專屬引數（支援 namespace 字首）
result = execute({
    "strategy": "roe,valuation",
    "roe.roe_threshold": 20,    # ROE策略引數
    "valuation.max_pe": 15,     # 估值策略引數
})

返回格式

{
  "success": True,
  "results": [
    {
      "ts_code": "000001.SZ",
      "name": "平安銀行",
      "industry": "銀行",
      "score": 78.5,
      "strategies_hit": ["roe", "valuation"],
      "scores": {"roe": 45.2, "valuation": 33.3},
      # 以下為各策略專屬欄位
      "roe": 16.5, "roa": 8.2, "gross_margin": 35.1,
      "pe_ttm": 12.3, "pb": 1.1, "peg": 0.74,
    },
    ...
  ],
  "count": 42,
  "message": "[stock-selecter] AND 模式，耗時 89.3s",
  "metadata": {
    "strategies_used": ["roe", "valuation"],
    "mode": "and",
    "execution_time": 89.3,
    "per_strategy_counts": {"roe": 312, "valuation": 185},
    "saved_files": {
      "json": "/path/to/...",
      "csv":  "/path/to/...",
      "html": "/path/to/...",
    }
  }
}

引數說明

公共引數

各策略專屬引數

ROE (roe)

roe_threshold=15.0      # ROE 最低閾值（%）
roa_threshold=5.0      # ROA 最低閾值（%）
include_roa=True        # 是否同時篩選 ROA
min_report_periods=4   # 最少財報期數

MACD (macd)

k_slope_max=0.0         # K線斜率上限（正值=向上）
k_r2_min=0.3            # K線趨勢 R² 下限
macd_slope_min=0.0      # MACD 斜率下限（正值=向上）
macd_r2_min=0.2         # MACD 趨勢 R² 下限
require_divergence=True # 要求底背離
require_volume_surge=True# 要求放量
volume_surge_weeks=5    # 放量對比周數
volume_surge_threshold=1.5 # 放量倍數閾值

股息 (dividend)

min_dv_ratio=3.0        # 最低股息率（%）
min_consecutive_years=3 # 最少連續分紅年數
min_roe=8.0             # 最低 ROE（%）
max_pe=30               # PE 上限

估值 (valuation)

max_pe=25.0             # PE 上限
max_pb=3.0             # PB 上限
max_peg=1.5            # PEG 上限（<1為低估）
industry_discount=0.85  # 行業基準折扣
min_roe=8.0            # 最低 ROE（%）

成長股 (growth)

min_revenue_growth=20.0   # 營收增速下限（%）
min_profit_growth=20.0   # 淨利潤增速下限（%）
min_gross_margin=30.0     # 毛利率下限（%）
min_consecutive_quarters=3# 連續淨利潤正增長季度數
min_roe=12.0             # 最低 ROE（%）

長期低位 (low_position)

lookback_days=250       # 歷史價格視窗
low_position_pct=25.0  # 底部分位閾值（%）
rsi_max=40.0           # RSI 上限
rsi_window=14          # RSI 計算週期
data_period_years=2     # 資料拉取年數

近期放量 (volume_surge)

volume_surge_ratio=2.0   # 放量倍數閾值
volume_avg_days=20        # 均量計算週期
rsi_max=45.0            # RSI 上限
rebound_pct_min=3.0     # 最小反彈幅度（%）
rebound_days=5          # 反彈檢測視窗
price_change_max=10.0  # 當日漲幅上限（%）
data_period_years=1     # 資料拉取年數

趨勢 (trend)

ma_short=5             # 短期均線週期
ma_mid=20              # 中期均線週期
ma_long=60             # 長期均線週期
trend_r2_min=0.5       # 趨勢 R² 下限
adx_min=25.0           # ADX 趨勢強度下限
require_ma_bullish=True # 要求均線多頭排列

形態 (pattern)

detect_double_bottom=True
detect_head_shoulders_bottom=True
detect_flag_breakout=True
detect_golden_cross=True
detect_morning_star=True
detect_bullish_engulfing=True
detect_cup_handle=True
min_pattern_score=1    # 最少命中形態數

布林帶下軌 (bollinger)

bb_window=20           # 布林帶週期
bb_std=2.0            # 標準差倍數
rsi_max=45.0          # RSI 上限
rsi_window=14         # RSI 週期
lookback_days=120     # 回看天數
price_change_max=9.0  # 當日漲幅上限（排除漲停）

籌碼集中 (shareholder_concentration)

min_consecutive_quarters=3  # 連續減少季度數
max_holder_growth=-5.0     # 最大季度增長上限
min_roe=8.0               # 最低ROE
data_period_quarters=8      # 資料拉取期數

現金流質量 (cashflow_quality)

min_match_quarters=3      # 經營現金流>=淨利潤的季度數
total_periods=4            # 檢測總期數
min_cashflow_ratio=0.8   # 經營現金流/淨利潤最小比率
min_roe=8.0              # 最低ROE
max_goodwill_pct=30.0    # 商譽/淨資產上限（%）

輸出檔案

自動儲存到 /Volumes/Alan HD/股票篩選/（Mac 外接硬碟），或指定目錄： - screener_{策略}_{時間}.json — 完整原始資料 - screener_{策略}_{時間}.csv — 表格格式 - 選股報告_{時間}.html — 可互動視覺化報告（需 --report）

目錄結構

stock-selecter/
├── main.py              ← 統一入口（CLI + execute()）
├── SKILL.md             ← 本檔案
├── config.json          ← 預設配置
├── strategies/
│   ├── base.py          ← 抽象基類（含併發執行引擎）
│   ├── roe.py
│   ├── macd.py
│   ├── dividend.py
│   ├── valuation.py
│   ├── growth.py
│   ├── low_position.py
│   ├── volume_surge.py
│   ├── trend.py
│   ├── pattern.py
│   ├── bollinger.py       ← v3.2 新增
│   ├── shareholder_concentration.py  ← v3.2 新增
│   └── cashflow_quality.py          ← v3.2 新增
└── utils/
    ├── loader.py        ← 共享庫動態載入
    └── report.py        ← HTML 報告生成器

併發說明

• workers=1（預設）：序列執行，穩定可靠
• workers>1：ThreadPoolExecutor 併發，適合 IO 密集型（大量 API 呼叫等待）
• MACD/趨勢/放量等技術面策略建議開啟併發（--workers 8）
• ROE/股息/估值等財務面策略資料量小，併發收益有限
• 建議併發數不超過 16，避免觸發 API 限流

這是一套專業且功能豐富的選股工具，文件清晰易懂，11 種策略覆蓋了基本面、技術面等多個維度，支援靈活組合篩選和視覺化報告。優點是功能全面、文件完善；不足是依賴外部資料介面，服務不穩定時無法使用，對新手而言配置 Tushare Token 有一定門檻。整體質量良好，適合有一定基礎的投資者使用。