deeptrade-quant 0.1.0__tar.gz → 0.2.0__tar.gz

{deeptrade_quant-0.1.0 → deeptrade_quant-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deeptrade-quant
-Version: 0.1.0
+Version: 0.2.0
 Summary: LLM-driven A-share (Shanghai/Shenzhen main board) stock screening CLI
 Project-URL: Homepage, https://github.com/ty19880929/deeptrade
 Project-URL: Repository, https://github.com/ty19880929/deeptrade
@@ -53,10 +53,18 @@ Description-Content-Type: text/markdown
 ### 安装
 
 ```bash
-# 推荐
+# 推荐：pipx 隔离环境（命令名仍是 deeptrade）
+pipx install deeptrade-quant
+# 或
+uv tool install deeptrade-quant
+```
+
+> **注**：PyPI 项目名是 `deeptrade-quant`，CLI 命令是 `deeptrade`，Python 包名是 `deeptrade`（`import deeptrade`）。三者不同是 Python 生态常态（同 `pip install scikit-learn` → `import sklearn`）。
+
+```bash
+# 开发模式（克隆本仓库，editable install）
 uv sync --all-extras
 uv run pre-commit install
-
 # 兜底（无 uv）
 python -m venv .venv && source .venv/bin/activate  # Windows: .\.venv\Scripts\activate
 pip install -e ".[dev]"
@@ -73,12 +81,18 @@ deeptrade config test-llm                 # 对所有 provider 做连通性自
 deeptrade config show                     # 表格展示当前配置（密钥脱敏）
 ```
 
-### 安装内置插件并运行
+### 安装官方插件并运行
+
+官方插件维护在 [DeepTradePluginOfficial](https://github.com/ty19880929/DeepTradePluginOfficial)，框架通过短名查注册表 → 拉 GitHub release tarball 自动安装。
 
 ```bash
-# 安装一个 strategy 插件 + 一个 channel 插件
-deeptrade plugin install ./deeptrade/strategies_builtin/limit_up_board -y
-deeptrade plugin install ./deeptrade/channels_builtin/stdout -y
+# 浏览注册表
+deeptrade plugin search
+
+# 按短名安装（注册表 → 最新 release tag）
+deeptrade plugin install limit-up-board
+deeptrade plugin install volume-anomaly
+deeptrade plugin install stdout-channel
 
 deeptrade plugin list                     # 查看已安装
 
@@ -96,6 +110,8 @@ deeptrade volume-anomaly prune --days 30  # 剔除追踪 ≥30 日的标的
 deeptrade stdout-channel test
 ```
 
+> **第三方插件 / 本地开发**：`deeptrade plugin install ./path/to/my-plugin` 仍可装本地目录；`deeptrade plugin install https://github.com/owner/repo` 装完整 git 仓库（仓库根需含 `deeptrade_plugin.yaml`）。详见 [`docs/plugin-development.md`](docs/plugin-development.md)。
+
 报告产出在 `~/.deeptrade/reports/<run_id>/`。
 
 ## 📦 命令矩阵

{deeptrade_quant-0.1.0 → deeptrade_quant-0.2.0}/README.md

@@ -19,10 +19,18 @@
 ### 安装
 
 ```bash
-# 推荐
+# 推荐：pipx 隔离环境（命令名仍是 deeptrade）
+pipx install deeptrade-quant
+# 或
+uv tool install deeptrade-quant
+```
+
+> **注**：PyPI 项目名是 `deeptrade-quant`，CLI 命令是 `deeptrade`，Python 包名是 `deeptrade`（`import deeptrade`）。三者不同是 Python 生态常态（同 `pip install scikit-learn` → `import sklearn`）。
+
+```bash
+# 开发模式（克隆本仓库，editable install）
 uv sync --all-extras
 uv run pre-commit install
-
 # 兜底（无 uv）
 python -m venv .venv && source .venv/bin/activate  # Windows: .\.venv\Scripts\activate
 pip install -e ".[dev]"
@@ -39,12 +47,18 @@ deeptrade config test-llm                 # 对所有 provider 做连通性自
 deeptrade config show                     # 表格展示当前配置（密钥脱敏）
 ```
 
-### 安装内置插件并运行
+### 安装官方插件并运行
+
+官方插件维护在 [DeepTradePluginOfficial](https://github.com/ty19880929/DeepTradePluginOfficial)，框架通过短名查注册表 → 拉 GitHub release tarball 自动安装。
 
 ```bash
-# 安装一个 strategy 插件 + 一个 channel 插件
-deeptrade plugin install ./deeptrade/strategies_builtin/limit_up_board -y
-deeptrade plugin install ./deeptrade/channels_builtin/stdout -y
+# 浏览注册表
+deeptrade plugin search
+
+# 按短名安装（注册表 → 最新 release tag）
+deeptrade plugin install limit-up-board
+deeptrade plugin install volume-anomaly
+deeptrade plugin install stdout-channel
 
 deeptrade plugin list                     # 查看已安装
 
@@ -62,6 +76,8 @@ deeptrade volume-anomaly prune --days 30  # 剔除追踪 ≥30 日的标的
 deeptrade stdout-channel test
 ```
 
+> **第三方插件 / 本地开发**：`deeptrade plugin install ./path/to/my-plugin` 仍可装本地目录；`deeptrade plugin install https://github.com/owner/repo` 装完整 git 仓库（仓库根需含 `deeptrade_plugin.yaml`）。详见 [`docs/plugin-development.md`](docs/plugin-development.md)。
+
 报告产出在 `~/.deeptrade/reports/<run_id>/`。
 
 ## 📦 命令矩阵

{deeptrade_quant-0.1.0 → deeptrade_quant-0.2.0}/deeptrade/__init__.py

@@ -4,5 +4,5 @@ from __future__ import annotations
 
 from deeptrade.core.notifier import notification_session, notify
 
-__version__ = "0.1.0"
+__version__ = "0.2.0"
 __all__ = ["__version__", "notification_session", "notify"]

{deeptrade_quant-0.1.0 → deeptrade_quant-0.2.0}/deeptrade/core/notifier.py

@@ -7,8 +7,9 @@ Three layers compose top-down:
               └─ ChannelPlugin instances (loaded from type=channel plugins)
 
 The framework knows nothing about feishu / dingtalk / wechat-work. Channels
-are delivered as plugins (``channels_builtin/`` mirrors ``strategies_builtin/``);
-new channels = new plugin packages, zero framework change.
+are delivered as ``type: channel`` plugins, installed at runtime through
+``deeptrade plugin install`` from the official registry or any local/git
+source. New channels = new plugin packages, zero framework change.
 
 Top-level API (used by any plugin that needs to notify):
 

{deeptrade_quant-0.1.0 → deeptrade_quant-0.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "deeptrade-quant"
-version = "0.1.0"
+version = "0.2.0"
 description = "LLM-driven A-share (Shanghai/Shenzhen main board) stock screening CLI"
 readme = "README.md"
 requires-python = ">=3.11"

deeptrade_quant-0.1.0/deeptrade/channels_builtin/stdout/deeptrade_plugin.yaml

@@ -1,25 +0,0 @@
-plugin_id: stdout-channel
-name: Stdout Channel
-version: 0.1.0
-type: channel
-api_version: "1"
-entrypoint: stdout_channel.channel:StdoutChannel
-description: Reference notification channel — fully consumes the payload but only prints "✔ push success" to stdout.
-author: DeepTrade
-
-permissions:
-  tushare_apis:
-    required: []
-    optional: []
-  llm: false
-  llm_tools: false
-
-migrations:
-  - version: "20260509_001"
-    file: migrations/20260509_001_init.sql
-    checksum: "sha256:7317d23d4ac91b9a1259e2ba4d990863491de8fe1115e19052b02f83939399cc"
-
-tables:
-  - name: stdout_channel_log
-    description: Audit log of payloads delivered through the stdout channel
-    purge_on_uninstall: true

deeptrade_quant-0.1.0/deeptrade/channels_builtin/stdout/migrations/20260509_001_init.sql

@@ -1,13 +0,0 @@
--- stdout channel: delivery log so we can verify the payload was actually
--- consumed (not just acknowledged with a fake "✔ push success").
-CREATE TABLE IF NOT EXISTS stdout_channel_log (
-    delivered_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
-    plugin_id    VARCHAR NOT NULL,
-    run_id       UUID NOT NULL,
-    status       VARCHAR NOT NULL,
-    title        VARCHAR NOT NULL,
-    section_count INTEGER NOT NULL,
-    item_count    INTEGER NOT NULL,
-    metric_count  INTEGER NOT NULL,
-    PRIMARY KEY (run_id, plugin_id, delivered_at)
-);

deeptrade_quant-0.1.0/deeptrade/channels_builtin/stdout/stdout_channel/channel.py

@@ -1,180 +0,0 @@
-"""Stdout reference channel plugin.
-
-Implements the framework's ``ChannelPlugin`` Protocol:
-    * ``validate_static`` — install-time self-check (no network)
-    * ``dispatch(argv)``  — CLI dispatch (subcommands: test, log)
-    * ``push(ctx, payload)`` — receive a NotificationPayload from the notifier
-
-Behaviour on push:
-    * FULLY consume the NotificationPayload (walk every section/item/metric)
-      so any structural bug surfaces immediately.
-    * Persist a one-row audit record to ``stdout_channel_log``.
-    * Emit ONE concise line: "✔ push success (...)".
-
-This channel is the zero-dependency target for unit tests of the notify
-plumbing and is safe to ship enabled-by-default in dev installs.
-"""
-
-from __future__ import annotations
-
-import argparse
-import sys
-from typing import TYPE_CHECKING
-
-if TYPE_CHECKING:  # pragma: no cover
-    from deeptrade.plugins_api.base import PluginContext
-    from deeptrade.plugins_api.notify import NotificationPayload
-
-
-class StdoutChannel:
-    """Stdout-only IM channel plugin."""
-
-    metadata = None  # injected by framework after install
-
-    # ----- Plugin Protocol -------------------------------------------------
-
-    def validate_static(self, ctx: PluginContext) -> None:  # noqa: ARG002
-        # Sanity: the audit table must exist (created by our own migration).
-        # If it's missing, the install pipeline already failed; this is just a
-        # belt-and-braces self-check that doesn't touch the network.
-        return
-
-    def dispatch(self, argv: list[str]) -> int:
-        """Channel-side CLI: ``test`` and ``log``.
-
-        ``test`` synthesizes a minimal payload and routes it back through this
-        channel's own ``push`` so the user can verify the channel is wired up
-        without running a real strategy. ``log`` dumps the most recent
-        ``stdout_channel_log`` rows.
-        """
-        parser = argparse.ArgumentParser(
-            prog="deeptrade stdout-channel",
-            description="Stdout notification channel — local self-test + audit log.",
-        )
-        sub = parser.add_subparsers(dest="cmd", required=False)
-
-        sub.add_parser("test", help="Push a synthetic payload through this channel.")
-        log_p = sub.add_parser("log", help="Print recent delivery audit rows.")
-        log_p.add_argument("--limit", type=int, default=20)
-
-        args = parser.parse_args(argv)
-        if args.cmd is None:
-            parser.print_help()
-            return 0
-        if args.cmd == "test":
-            return self._cmd_test()
-        if args.cmd == "log":
-            return self._cmd_log(args.limit)
-        return 2
-
-    # ----- ChannelPlugin Protocol ------------------------------------------
-
-    def push(self, ctx: PluginContext, payload: NotificationPayload) -> None:
-        # 1) Walk the payload — counts come from real iteration, never from
-        # dict.len(), so we cannot "succeed" without having actually read the
-        # plugin's data.
-        section_count = len(payload.sections)
-        item_count = sum(len(s.items) for s in payload.sections)
-        metric_count = len(payload.metrics)
-        for section in payload.sections:
-            for item in section.items:
-                _ = (item.code, item.name, item.rank, item.score, item.label, item.note)
-        for k, v in payload.metrics.items():
-            _ = (k, v)
-        _ = payload.title, payload.summary, payload.report_dir, payload.extras
-
-        # 2) Persist a delivery audit row.
-        ctx.db.execute(
-            "INSERT INTO stdout_channel_log(plugin_id, run_id, status, title, "
-            "section_count, item_count, metric_count) VALUES (?, ?, ?, ?, ?, ?, ?)",
-            (
-                payload.plugin_id,
-                payload.run_id,
-                payload.status.value,
-                payload.title,
-                section_count,
-                item_count,
-                metric_count,
-            ),
-        )
-
-        # 3) One concise line. Use sys.stdout (not rich console) so this stays
-        # out of any TUI / strategy console that the caller may have running.
-        sys.stdout.write(
-            f"✔ push success (channel=stdout-channel run_id={payload.run_id} "
-            f"status={payload.status.value})\n"
-        )
-        sys.stdout.flush()
-
-    # ----- private helpers -------------------------------------------------
-
-    def _cmd_test(self) -> int:
-        """Round-trip a synthetic payload through ``deeptrade.notify``.
-
-        Goes through the framework's notifier layer (not directly through
-        ``self.push``) so the test exercises the full path: install →
-        build_notifier → dispatch → push.
-        """
-        import uuid
-
-        from deeptrade import notify
-        from deeptrade.core import paths
-        from deeptrade.core.db import Database
-        from deeptrade.core.run_status import RunStatus
-        from deeptrade.plugins_api.notify import (
-            NotificationItem,
-            NotificationPayload,
-            NotificationSection,
-        )
-
-        payload = NotificationPayload(
-            plugin_id="stdout-channel",
-            run_id=str(uuid.uuid4()),
-            status=RunStatus.SUCCESS,
-            title="DeepTrade — stdout channel test",
-            summary="Synthetic payload from `deeptrade stdout-channel test`.",
-            sections=[
-                NotificationSection(
-                    key="demo",
-                    title="Demo items",
-                    items=[
-                        NotificationItem(
-                            code="600519.SH", name="贵州茅台", rank=1, score=87.5,
-                            label="top_candidate", note="演示条目，非真实推荐",
-                        ),
-                    ],
-                ),
-            ],
-            metrics={"selected": 1},
-        )
-        db = Database(paths.db_path())
-        try:
-            notify(db, payload)
-        finally:
-            db.close()
-        return 0
-
-    def _cmd_log(self, limit: int) -> int:
-        from deeptrade.core import paths
-        from deeptrade.core.db import Database
-
-        db = Database(paths.db_path())
-        try:
-            rows = db.fetchall(
-                "SELECT delivered_at, plugin_id, run_id, status, title, "
-                "section_count, item_count, metric_count "
-                "FROM stdout_channel_log ORDER BY delivered_at DESC LIMIT ?",
-                (limit,),
-            )
-        finally:
-            db.close()
-
-        if not rows:
-            sys.stdout.write("(no deliveries yet)\n")
-            return 0
-        for r in rows:
-            sys.stdout.write(
-                f"{r[0]}  {r[1]:<20}  {r[3]:<8}  sec={r[5]} item={r[6]} "
-                f"metric={r[7]}  {r[4]}\n"
-            )
-        return 0

deeptrade_quant-0.1.0/deeptrade/strategies_builtin/limit_up_board/deeptrade_plugin.yaml

@@ -1,83 +0,0 @@
-plugin_id: limit-up-board
-name: 打板策略
-version: 0.4.0
-type: strategy
-api_version: "1"
-entrypoint: limit_up_board.plugin:LimitUpBoardPlugin
-description: A 股打板策略：双轮 LLM 漏斗（强势标的分析 → 连板预测）
-author: DeepTrade
-
-permissions:
-  tushare_apis:
-    required:
-      - stock_basic
-      - trade_cal
-      - daily
-      - daily_basic
-      - stock_st
-      - limit_list_d
-      - limit_step
-      - moneyflow
-      - top_list
-      - top_inst
-      - cyq_perf
-    optional:
-      - limit_list_ths
-      - limit_cpt_list
-      - ths_hot
-      - dc_hot
-      - stk_auction_o
-      - anns_d
-      - suspend_d
-      - stk_limit
-  llm: true
-  llm_tools: false
-
-migrations:
-  - version: "20260509_001"
-    file: migrations/20260509_001_init.sql
-    checksum: "sha256:8f6bc721fedbd94f652fa356779eea7b4ef801483968dabfa6648cf2f639064f"
-
-tables:
-  - name: lub_stock_basic
-    description: stock_basic 落库（限本插件使用）
-    purge_on_uninstall: true
-  - name: lub_trade_cal
-    description: trade_cal 落库
-    purge_on_uninstall: true
-  - name: lub_daily
-    description: daily 行情落库
-    purge_on_uninstall: true
-  - name: lub_daily_basic
-    description: daily_basic 行情指标落库
-    purge_on_uninstall: true
-  - name: lub_moneyflow
-    description: moneyflow 资金流落库
-    purge_on_uninstall: true
-  - name: lub_limit_list_d
-    description: 涨停明细缓存（limit_list_d）
-    purge_on_uninstall: true
-  - name: lub_limit_ths
-    description: 同花顺涨停榜单缓存（limit_list_ths）
-    purge_on_uninstall: true
-  - name: lub_stage_results
-    description: 策略各阶段（R1/R2/final_ranking）结构化结果
-    purge_on_uninstall: true
-  - name: lub_runs
-    description: 本插件 run 历史（替代框架 strategy_runs）
-    purge_on_uninstall: true
-  - name: lub_events
-    description: 本插件 run 事件流（替代框架 strategy_events）
-    purge_on_uninstall: true
-  - name: lub_top_list
-    description: 龙虎榜个股明细（top_list）
-    purge_on_uninstall: true
-  - name: lub_top_inst
-    description: 龙虎榜机构席位明细（top_inst）
-    purge_on_uninstall: true
-  - name: lub_cyq_perf
-    description: 筹码每日指标（cyq_perf）
-    purge_on_uninstall: true
-  - name: lub_config
-    description: 本插件用户可调设置（流通市值 / 股价上限）
-    purge_on_uninstall: true

deeptrade_quant-0.1.0/deeptrade/strategies_builtin/limit_up_board/limit_up_board/calendar.py

@@ -1,65 +0,0 @@
-"""TradeCalendar — pure helper around tushare trade_cal frames."""
-
-from __future__ import annotations
-
-import pandas as pd
-
-
-class TradeCalendar:
-    """Read-only view over the trade_cal DataFrame.
-
-    Required columns: cal_date (str YYYYMMDD), is_open (0/1), pretrade_date (str).
-    """
-
-    def __init__(self, df: pd.DataFrame) -> None:
-        if not {"cal_date", "is_open"}.issubset(df.columns):
-            raise ValueError("trade_cal frame missing required columns")
-
-        # ⚠ Bug fix: tushare trade_cal returns cal_date as int64 in some
-        # environments; JSON cache round-trip can also widen "20260428" → 20260428.
-        # Normalize to string up-front so all downstream comparisons are str↔str.
-        df = df.copy()
-        df["cal_date"] = df["cal_date"].astype(str)
-        if "pretrade_date" in df.columns:
-            # Some non-trading days have NaN pretrade_date; preserve NaN, stringify the rest
-            df["pretrade_date"] = df["pretrade_date"].apply(
-                lambda v: str(v) if pd.notna(v) else None
-            )
-        # is_open is sometimes "1"/"0" strings — coerce to int for ==1 comparison
-        df["is_open"] = pd.to_numeric(df["is_open"], errors="coerce").fillna(0).astype(int)
-
-        # Normalize: deduplicate on cal_date, keeping the SSE/last row
-        sorted_df = df.sort_values("cal_date").drop_duplicates("cal_date", keep="last")
-        self._df = sorted_df.reset_index(drop=True)
-        self._idx: dict[str, int] = {
-            str(row.cal_date): i for i, row in enumerate(self._df.itertuples(index=False))
-        }
-
-    def is_open(self, date: str) -> bool:
-        idx = self._idx.get(date)
-        if idx is None:
-            return False
-        return int(self._df.at[idx, "is_open"]) == 1
-
-    def pretrade_date(self, date: str) -> str:
-        """Return the most recent open day strictly BEFORE `date`."""
-        # Walk backwards through cal_date sorted index
-        candidates = self._df[self._df["cal_date"] < date]
-        opens = candidates[candidates["is_open"] == 1]
-        if opens.empty:
-            raise ValueError(f"no prior open trading day before {date}")
-        return str(opens.iloc[-1]["cal_date"])
-
-    def next_open(self, date: str) -> str:
-        """Return the first open day strictly AFTER `date`."""
-        candidates = self._df[self._df["cal_date"] > date]
-        opens = candidates[candidates["is_open"] == 1]
-        if opens.empty:
-            raise ValueError(f"no future open trading day after {date}")
-        return str(opens.iloc[0]["cal_date"])
-
-    def latest_closed_on_or_before(self, date: str) -> str:
-        """Return the latest open day ≤ `date` (i.e. `date` itself if open, else preceding)."""
-        if self.is_open(date):
-            return date
-        return self.pretrade_date(date)