stock-up 0.1.0__py3-none-any.whl

stock_up/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

stock_up/cli.py

@@ -0,0 +1,346 @@
+from __future__ import annotations
+
+from datetime import date
+from pathlib import Path
+from typing import Optional
+
+import typer
+from rich.console import Console
+from rich.table import Table
+
+from stock_up.codes import format_code
+from stock_up.config import load_config, write_default_config
+from stock_up.db import init_db
+from stock_up.market.factory import make_provider
+from stock_up.models import Holding, WatchItem
+from stock_up.services.daily import run_daily
+from stock_up.services.dragon_tiger_scanner import run_dragon_tiger_scan
+from stock_up.services.scanner import run_limit_up_scan
+from stock_up.services.tick import run_tick
+from stock_up.repositories import AlertRepository, HoldingRepository, TradeRepository, WatchRepository
+from stock_up.strategy.holding import evaluate_holding
+from stock_up.strategy.trading_day import trading_days_since
+from stock_up.strategy.watch import evaluate_watch
+
+app = typer.Typer(help="stock-up CLI")
+watch_app = typer.Typer(help="观察池")
+hold_app = typer.Typer(help="持仓")
+scan_app = typer.Typer(help="扫描")
+app.add_typer(watch_app, name="watch")
+app.add_typer(hold_app, name="hold")
+app.add_typer(scan_app, name="scan")
+console = Console()
+
+
+def default_home() -> Path:
+    return Path.home() / ".stock-up"
+
+
+def db_path(home: Path) -> Path:
+    return home / "data.db"
+
+
+@app.command()
+def init(home: Path = typer.Option(default_home(), "--home", help="stock-up home directory")):
+    """初始化配置和数据库。"""
+    home.mkdir(parents=True, exist_ok=True)
+    cfg_path = home / "config.yaml"
+    if not cfg_path.exists():
+        write_default_config(cfg_path)
+    (home / "reports").mkdir(exist_ok=True)
+    init_db(db_path(home))
+    console.print(f"初始化完成: {home}")
+
+
+def _make_provider(provider: str, purpose: str = "realtime"):
+    return make_provider(provider, purpose=purpose)
+
+
+@app.command()
+def quote(
+    code: str,
+    provider: str = typer.Option("qq", "--provider", help="qq / akshare / mock"),
+):
+    """查看单只股票行情，便于对比数据源。"""
+    full_code = format_code(code) or code
+    quotes = _make_provider(provider, purpose="realtime").get_realtime_quotes([full_code])
+    if not quotes:
+        console.print(f"暂无行情: {full_code}")
+        return
+    q = quotes[0]
+    table = Table("字段", "值")
+    table.add_row("代码", q.code)
+    table.add_row("名称", q.name)
+    table.add_row("当前价", f"{q.now:g}")
+    table.add_row("昨收", f"{q.pre_close:g}")
+    table.add_row("日高", f"{q.high:g}")
+    table.add_row("日低", f"{q.low:g}")
+    table.add_row("均价", f"{q.avg:g}")
+    table.add_row("成交额", f"{q.amount:g}")
+    table.add_row("成交量", f"{q.volume:g}")
+    console.print(table)
+
+
+@app.command()
+def tick(
+    home: Path = typer.Option(default_home(), "--home"),
+    provider: str = typer.Option("qq", "--provider", help="qq / mock"),
+):
+    """执行一次盘中检查，由外部定时任务调用。"""
+    summary = run_tick(db_path(home), _make_provider(provider))
+    console.print(f"tick完成: 观察 {summary.updated_watch_count}，持仓 {summary.updated_holding_count}")
+
+
+@app.command()
+def daily(
+    home: Path = typer.Option(default_home(), "--home"),
+    provider: str = typer.Option("akshare", "--provider", help="akshare / mock"),
+    trade_date: str = typer.Option("", "--date"),
+):
+    """执行每日扫描、检查并生成报告。"""
+    date_text = trade_date or date.today().isoformat()
+    cfg = load_config(home / "config.yaml")
+    summary = run_daily(
+        db_path(home),
+        _make_provider(provider, purpose="daily"),
+        date_text,
+        home / "reports",
+        rsi_max_updates=cfg.technical.rsi.max_updates_per_daily,
+        enable_hot_leader_scan=cfg.auto_watch.hot_leader_scan_enabled,
+    )
+    console.print(f"daily完成: 新增观察 {summary.new_watch_count}，观察动作 {summary.watch_action_count}，持仓动作 {summary.holding_action_count}")
+    console.print(f"日报: {summary.report_path}")
+
+
+@scan_app.command("dragon-tiger")
+def scan_dragon_tiger(
+    home: Path = typer.Option(default_home(), "--home"),
+    provider: str = typer.Option("stockapi", "--provider", help="stockapi / mock"),
+    trade_date: str = typer.Option("", "--date"),
+):
+    """扫描龙虎榜并加入观察池。"""
+    date_text = trade_date or date.today().isoformat()
+    summary = run_dragon_tiger_scan(db_path(home), _make_provider(provider, purpose="scan"), date_text)
+    console.print(f"龙虎榜扫描完成: 总数 {summary.total_count}，加入 {summary.added_count}")
+
+
+@scan_app.command("limit-up")
+def scan_limit_up(
+    home: Path = typer.Option(default_home(), "--home"),
+    provider: str = typer.Option("akshare", "--provider", help="akshare / mock"),
+    trade_date: str = typer.Option("", "--date"),
+    low_mode: str = typer.Option("same_day", "--low-mode"),
+):
+    """扫描涨停池并加入观察池。"""
+    date_text = trade_date or date.today().isoformat()
+    summary = run_limit_up_scan(db_path(home), _make_provider(provider, purpose="scan"), date_text, initial_low_mode=low_mode)  # type: ignore[arg-type]
+    console.print(f"涨停扫描完成: 总数 {summary.total_count}，加入 {summary.added_count}，跳过 {summary.skipped_count}")
+
+
+@watch_app.command("add")
+def watch_add(
+    code: str,
+    home: Path = typer.Option(default_home(), "--home"),
+    name: str = typer.Option("", "--name"),
+    reason: str = typer.Option("手动关注", "--reason"),
+    high: float = typer.Option(0.0, "--high"),
+    low: float = typer.Option(0.0, "--low"),
+    now: float = typer.Option(0.0, "--now"),
+):
+    full_code = format_code(code) or code
+    repo = WatchRepository(db_path(home))
+    repo.upsert(WatchItem(code=full_code, name=name or full_code, reason=reason, high=high, low=low, now=now))
+    console.print(f"已加入观察池: {full_code} {name or full_code}")
+
+
+@watch_app.command("list")
+def watch_list(home: Path = typer.Option(default_home(), "--home")):
+    repo = WatchRepository(db_path(home))
+    rows = repo.list_active()
+    table = Table("代码", "名称", "状态", "高点", "低点", "现价")
+    for item in rows:
+        table.add_row(item.code, item.name, item.status, f"{item.high:g}", f"{item.low:g}", f"{item.now:g}")
+    console.print(table)
+
+
+@watch_app.command("abandoned")
+def watch_abandoned(home: Path = typer.Option(default_home(), "--home")):
+    repo = WatchRepository(db_path(home))
+    rows = repo.list_abandoned()
+    table = Table("代码", "名称", "状态")
+    for item in rows:
+        table.add_row(item.code, item.name, item.status)
+    console.print(table)
+
+
+@watch_app.command("check")
+def watch_check(home: Path = typer.Option(default_home(), "--home")):
+    repo = WatchRepository(db_path(home))
+    alerts = AlertRepository(db_path(home))
+    table = Table("代码", "名称", "动作", "理由")
+    today = date.today().isoformat()
+    for item in repo.list_active():
+        result = evaluate_watch(item)
+        if result.action in ("watch", "abandon") and alerts.should_alert(item.code, result.title, result.price, 0.01):
+            table.add_row(item.code, item.name, result.title, "; ".join(result.reasons))
+            alerts.record(item.code, item.name, result.title, result.level, result.price, "; ".join(result.reasons), today)
+            if result.action == "abandon":
+                repo.mark_abandoned(item.code, "; ".join(result.reasons), today)
+    console.print(table)
+
+
+@watch_app.command("set")
+def watch_set(
+    code: str,
+    home: Path = typer.Option(default_home(), "--home"),
+    high: Optional[float] = typer.Option(None, "--high"),
+    low: Optional[float] = typer.Option(None, "--low"),
+):
+    repo = WatchRepository(db_path(home))
+    item = repo.get(code)
+    if not item:
+        raise typer.BadParameter(f"观察池不存在: {code}")
+    if high is not None:
+        item.high = high
+    if low is not None:
+        item.low = low
+    repo.upsert(item)
+    console.print(f"已更新观察池: {code}")
+
+
+@hold_app.command("add")
+def hold_add(
+    code: str,
+    home: Path = typer.Option(default_home(), "--home"),
+    name: str = typer.Option("", "--name"),
+    cost: float = typer.Option(..., "--cost"),
+    qty: int = typer.Option(..., "--qty"),
+    buy_date: str = typer.Option("", "--date"),
+    high: float = typer.Option(0.0, "--high"),
+    low: float = typer.Option(0.0, "--low"),
+    swing_low: float = typer.Option(0.0, "--swing-low"),
+    ref_high: float = typer.Option(0.0, "--ref-high"),
+    rule: str = typer.Option("wolf_swing", "--rule"),
+):
+    watch_repo = WatchRepository(db_path(home))
+    holding_repo = HoldingRepository(db_path(home))
+    trade_repo = TradeRepository(db_path(home))
+
+    full_code = format_code(code) or code
+    watch_item = watch_repo.get(full_code)
+    if watch_item:
+        high = high or watch_item.high
+        low = low or watch_item.low
+        name = name or watch_item.name
+        watch_repo.delete(full_code)
+
+    h = Holding(
+        code=full_code,
+        name=name or code,
+        cost=cost,
+        quantity=qty,
+        buy_date=buy_date or date.today().isoformat(),
+        now=cost,
+        highest=max(cost, high),
+        high=high,
+        low=low,
+        swing_low=swing_low,
+        ref_high=ref_high,
+        rule_type=rule,  # type: ignore[arg-type]
+    )
+    holding_repo.upsert(h)
+    trade_repo.record(full_code, name or full_code, "buy", cost, qty, h.buy_date)
+    console.print(f"已加入持仓: {full_code} {name or full_code}")
+
+
+@hold_app.command("list")
+def hold_list(home: Path = typer.Option(default_home(), "--home")):
+    repo = HoldingRepository(db_path(home))
+    table = Table("代码", "名称", "成本", "数量", "规则")
+    for h in repo.list_open():
+        table.add_row(h.code, h.name, f"{h.cost:g}", str(h.quantity), h.rule_type)
+    console.print(table)
+
+
+@hold_app.command("add-buy")
+def hold_add_buy(
+    code: str,
+    home: Path = typer.Option(default_home(), "--home"),
+    price: float = typer.Option(..., "--price"),
+    qty: int = typer.Option(..., "--qty"),
+    trade_date: str = typer.Option("", "--date"),
+):
+    full_code = format_code(code) or code
+    repo = HoldingRepository(db_path(home))
+    trades = TradeRepository(db_path(home))
+    h = repo.add_buy(full_code, price, qty)
+    trades.record(full_code, h.name, "add_buy", price, qty, trade_date or date.today().isoformat())
+    console.print(f"已加仓: {full_code} 新成本 {h.cost:g} 数量 {h.quantity}")
+
+
+@hold_app.command("close")
+def hold_close(
+    code: str,
+    home: Path = typer.Option(default_home(), "--home"),
+    price: float = typer.Option(..., "--price"),
+    reason: str = typer.Option("", "--reason"),
+    trade_date: str = typer.Option("", "--date"),
+    watch: bool = typer.Option(False, "--watch"),
+):
+    full_code = format_code(code) or code
+    holdings = HoldingRepository(db_path(home))
+    trades = TradeRepository(db_path(home))
+    h = holdings.get(full_code)
+    if not h:
+        raise typer.BadParameter(f"持仓不存在: {full_code}")
+    close_date = trade_date or date.today().isoformat()
+    closed = holdings.close(full_code, price, close_date, reason)
+    trades.record(full_code, h.name, "close", price, h.quantity, close_date, reason, closed.realized_pnl)
+    if watch:
+        WatchRepository(db_path(home)).upsert(WatchItem(code=full_code, name=h.name, reason=f"卖出后重新观察: {reason}", high=h.high, low=h.low, now=price))
+    console.print(f"已关闭持仓: {full_code} 已实现盈亏 {closed.realized_pnl:g}")
+
+
+@hold_app.command("check")
+def hold_check(
+    home: Path = typer.Option(default_home(), "--home"),
+    today: str = typer.Option("", "--today"),
+):
+    repo = HoldingRepository(db_path(home))
+    alerts = AlertRepository(db_path(home))
+    table = Table("代码", "名称", "动作", "理由")
+    today_text = today or date.today().isoformat()
+    for h in repo.list_open():
+        days = trading_days_since(h.buy_date, today_text) if h.buy_date else None
+        result = evaluate_holding(h, trading_days_since_buy=days)
+        reasons = "; ".join(result.reasons) if result.reasons else "暂无动作"
+        if alerts.should_alert(h.code, result.title, result.price or h.now or h.cost, 0.01):
+            table.add_row(h.code, h.name, result.title, reasons)
+            alerts.record(h.code, h.name, result.title, result.level, result.price or h.now or h.cost, reasons, today_text)
+    console.print(table)
+
+
+@hold_app.command("set")
+def hold_set(
+    code: str,
+    home: Path = typer.Option(default_home(), "--home"),
+    highest: Optional[float] = typer.Option(None, "--highest"),
+    swing_low: Optional[float] = typer.Option(None, "--swing-low"),
+    ref_high: Optional[float] = typer.Option(None, "--ref-high"),
+    rule: Optional[str] = typer.Option(None, "--rule"),
+):
+    full_code = format_code(code) or code
+    repo = HoldingRepository(db_path(home))
+    h = repo.get(full_code)
+    if not h:
+        raise typer.BadParameter(f"持仓不存在: {full_code}")
+    if highest is not None:
+        h.highest = highest
+    if swing_low is not None:
+        h.swing_low = swing_low
+    if ref_high is not None:
+        h.ref_high = ref_high
+    if rule is not None:
+        h.rule_type = rule  # type: ignore[assignment]
+    repo.upsert(h)
+    console.print(f"已更新持仓: {full_code}")

stock_up/codes.py

@@ -0,0 +1,24 @@
+from __future__ import annotations
+
+
+def format_code(code: str) -> str | None:
+    value = str(code or "").strip().lower()
+    if not value:
+        return None
+    if value.startswith(("sh", "sz", "hk", "bj")):
+        return value
+    if not value.isdigit():
+        return value
+
+    if len(value) <= 4 or (len(value) == 5 and value.startswith("0")):
+        return "hk" + value.zfill(5)
+
+    if len(value) == 6:
+        if value.startswith(("4", "8")):
+            return "bj" + value
+        if value.startswith("6") or value.startswith(("51", "56", "58")):
+            return "sh" + value
+        if value.startswith(("0", "1", "3")):
+            return "sz" + value
+
+    return value

stock_up/config.py

@@ -0,0 +1,118 @@
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Literal
+
+import yaml
+from pydantic import BaseModel, Field
+
+
+class MarketConfig(BaseModel):
+    quote_source: Literal["akshare", "qq"] = "akshare"
+    limit_up_source_order: list[str] = Field(default_factory=lambda: ["akshare_em", "akshare_ths"])
+    realtime_fallback_order: list[str] = Field(default_factory=lambda: ["akshare", "qq"])
+
+
+class TickConfig(BaseModel):
+    trading_time_only: bool = True
+    min_interval_seconds: int = 20
+
+
+class LimitUpConfig(BaseModel):
+    exclude_st: bool = True
+    exclude_bj: bool = True
+    exclude_new_stock_days: int = 30
+    min_amount: float = 500_000_000
+    include_first_board: bool = True
+    include_multi_board: bool = True
+
+
+class AutoWatchConfig(BaseModel):
+    hot_leader_scan_enabled: bool = False
+
+
+class WatchConfig(BaseModel):
+    initial_low_mode: Literal["same_day", "recent_1d"] = "same_day"
+    buy_382_tolerance: float = 0.03
+    buy_618_tolerance: float = 0.02
+    abandon_below_786: bool = True
+    abandon_below_low: bool = True
+
+
+class RsiConfig(BaseModel):
+    enabled: bool = True
+    short_period: int = 6
+    long_period: int = 12
+    min_history_days: int = 30
+    max_updates_per_daily: int = 50
+    watch_golden_cross: bool = True
+    holding_dead_cross: bool = True
+
+
+class TechnicalConfig(BaseModel):
+    rsi: RsiConfig = Field(default_factory=RsiConfig)
+
+
+class WolfSwingConfig(BaseModel):
+    stop_loss_pct: float = 0.07
+    take_profit_arm_pct: float = 0.20
+    profit_drawdown_pct: float = 0.30
+
+
+class HaiLongConfig(BaseModel):
+    swing_low_break_pct: float = 0.03
+    validate_days: int = 13
+
+
+class HoldingRulesConfig(BaseModel):
+    wolf_swing: WolfSwingConfig = Field(default_factory=WolfSwingConfig)
+    hai_long: HaiLongConfig = Field(default_factory=HaiLongConfig)
+
+
+class HoldingConfig(BaseModel):
+    default_rule: Literal["wolf_swing", "hai_long", "both"] = "wolf_swing"
+    rules: HoldingRulesConfig = Field(default_factory=HoldingRulesConfig)
+    allow_loss_add_on_618: bool = True
+
+
+class AlertConfig(BaseModel):
+    repeat_price_change_pct: float = 0.01
+
+
+class NotifyConfig(BaseModel):
+    terminal: bool = True
+    markdown_report: bool = True
+
+
+class ReportConfig(BaseModel):
+    only_actionable: bool = True
+    dir: str = "~/.stock-up/reports"
+
+
+class AppConfig(BaseModel):
+    market: MarketConfig = Field(default_factory=MarketConfig)
+    tick: TickConfig = Field(default_factory=TickConfig)
+    limit_up: LimitUpConfig = Field(default_factory=LimitUpConfig)
+    auto_watch: AutoWatchConfig = Field(default_factory=AutoWatchConfig)
+    watch: WatchConfig = Field(default_factory=WatchConfig)
+    technical: TechnicalConfig = Field(default_factory=TechnicalConfig)
+    holding: HoldingConfig = Field(default_factory=HoldingConfig)
+    alert: AlertConfig = Field(default_factory=AlertConfig)
+    notify: NotifyConfig = Field(default_factory=NotifyConfig)
+    report: ReportConfig = Field(default_factory=ReportConfig)
+
+
+def default_config_dict() -> dict:
+    return AppConfig().model_dump(mode="json")
+
+
+def write_default_config(path: Path) -> None:
+    path.parent.mkdir(parents=True, exist_ok=True)
+    path.write_text(yaml.safe_dump(default_config_dict(), allow_unicode=True, sort_keys=False), encoding="utf-8")
+
+
+def load_config(path: Path) -> AppConfig:
+    if not path.exists():
+        return AppConfig()
+    data = yaml.safe_load(path.read_text(encoding="utf-8")) or {}
+    return AppConfig.model_validate(data)

stock_up/db.py

@@ -0,0 +1,113 @@
+from __future__ import annotations
+
+import sqlite3
+from pathlib import Path
+
+
+SCHEMA = """
+CREATE TABLE IF NOT EXISTS watchlist (
+  code TEXT PRIMARY KEY,
+  name TEXT,
+  reason TEXT,
+  added_date TEXT,
+  high REAL,
+  low REAL,
+  avg REAL,
+  now REAL,
+  f382 REAL,
+  f618 REAL,
+  f786 REAL,
+  status TEXT,
+  abandoned_at TEXT,
+  abandon_reason TEXT,
+  note TEXT,
+  updated_at TEXT
+);
+
+CREATE TABLE IF NOT EXISTS holdings (
+  code TEXT PRIMARY KEY,
+  name TEXT,
+  cost REAL,
+  quantity INTEGER,
+  buy_date TEXT,
+  now REAL,
+  highest REAL,
+  high REAL,
+  low REAL,
+  swing_low REAL,
+  ref_high REAL,
+  rule_type TEXT,
+  status TEXT,
+  note TEXT,
+  updated_at TEXT
+);
+
+CREATE TABLE IF NOT EXISTS holding_history (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  code TEXT,
+  name TEXT,
+  cost REAL,
+  quantity INTEGER,
+  buy_date TEXT,
+  close_date TEXT,
+  close_price REAL,
+  realized_pnl REAL,
+  reason TEXT,
+  created_at TEXT
+);
+
+CREATE TABLE IF NOT EXISTS trades (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  code TEXT,
+  name TEXT,
+  trade_type TEXT,
+  price REAL,
+  quantity INTEGER,
+  trade_date TEXT,
+  reason TEXT,
+  realized_pnl REAL,
+  created_at TEXT
+);
+
+CREATE TABLE IF NOT EXISTS alerts (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  code TEXT,
+  name TEXT,
+  signal_type TEXT,
+  level TEXT,
+  price REAL,
+  message TEXT,
+  trade_date TEXT,
+  created_at TEXT
+);
+
+CREATE TABLE IF NOT EXISTS quotes_daily (
+  code TEXT,
+  trade_date TEXT,
+  open REAL,
+  high REAL,
+  low REAL,
+  close REAL,
+  pre_close REAL,
+  pct_chg REAL,
+  amount REAL,
+  volume REAL,
+  is_limit_up INTEGER,
+  rsi_short REAL,
+  rsi_long REAL,
+  PRIMARY KEY (code, trade_date)
+);
+"""
+
+
+def connect(db_path: Path) -> sqlite3.Connection:
+    db_path.parent.mkdir(parents=True, exist_ok=True)
+    conn = sqlite3.connect(db_path)
+    conn.row_factory = sqlite3.Row
+    return conn
+
+
+def init_db(db_path: Path) -> None:
+    with connect(db_path) as conn:
+        conn.executescript(SCHEMA)
+        conn.commit()

stock_up/market/akshare_provider.py

@@ -0,0 +1,85 @@
+from __future__ import annotations
+
+from datetime import date, timedelta
+
+from stock_up.models import DailyBar, LimitUpStock, Quote
+
+
+def calc_hist_date_range(days: int, today: date | None = None) -> tuple[str, str]:
+    today = today or date.today()
+    # Calendar-day buffer: enough to cover weekends/holidays for RSI windows.
+    start = today - timedelta(days=max(days * 2 + 10, 40))
+    return start.strftime("%Y%m%d"), today.strftime("%Y%m%d")
+
+
+class AkShareProvider:
+    """AkShare data provider.
+
+    AkShare is an optional dependency. Import lazily so the CLI remains usable
+    without installing it when users only need Tencent realtime quotes.
+    """
+
+    def __init__(self):
+        try:
+            import akshare as ak  # type: ignore
+        except ImportError as exc:
+            raise RuntimeError("AkShare 未安装，请执行: pip install 'stock-up[akshare]'") from exc
+        self.ak = ak
+
+    def get_realtime_quotes(self, codes: list[str]) -> list[Quote]:
+        # MVP uses Tencent for realtime by default; keep this conservative.
+        return []
+
+    def get_daily_bars(self, code: str, days: int) -> list[DailyBar]:
+        symbol = code.replace("sh", "").replace("sz", "").replace("bj", "")
+        start_date, end_date = calc_hist_date_range(days)
+        try:
+            df = self.ak.stock_zh_a_hist(
+                symbol=symbol,
+                period="daily",
+                start_date=start_date,
+                end_date=end_date,
+                adjust="",
+            )
+        except Exception:
+            return []
+        rows = []
+        for _, row in df.tail(days).iterrows():
+            rows.append(DailyBar(
+                code=code,
+                trade_date=str(row.get("日期", "")),
+                open=float(row.get("开盘", 0) or 0),
+                high=float(row.get("最高", 0) or 0),
+                low=float(row.get("最低", 0) or 0),
+                close=float(row.get("收盘", 0) or 0),
+                volume=float(row.get("成交量", 0) or 0),
+                amount=float(row.get("成交额", 0) or 0),
+            ))
+        return rows
+
+    def get_limit_up_pool(self, trade_date: str) -> list[LimitUpStock]:
+        date_text = trade_date.replace("-", "")
+        df = self.ak.stock_zt_pool_em(date=date_text)
+        items: list[LimitUpStock] = []
+        for _, row in df.iterrows():
+            code = str(row.get("代码", ""))
+            name = str(row.get("名称", ""))
+            items.append(LimitUpStock(
+                code=code,
+                name=name,
+                trade_date=trade_date,
+                high=float(row.get("最新价", 0) or 0),
+                low=float(row.get("最新价", 0) or 0),
+                close=float(row.get("最新价", 0) or 0),
+                amount=float(row.get("成交额", 0) or 0),
+                reason=str(row.get("涨停原因类别", "") or ""),
+                board_count=int(row.get("连板数", 1) or 1),
+            ))
+        return items
+
+    def get_trade_calendar(self) -> list[str]:
+        try:
+            df = self.ak.tool_trade_date_hist_sina()
+        except Exception:
+            return []
+        return [str(v) for v in df.get("trade_date", []).tolist()]