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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deeptrade-quant
-Version: 0.2.0
+Version: 0.3.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
@@ -34,23 +34,24 @@ Description-Content-Type: text/markdown
 
 # DeepTrade
 
-> 本地运行的 A 股（沪深主板）选股 CLI 工具：tushare 行情 + OpenAI 兼容 LLM（DeepSeek / Qwen / Kimi …）+ DuckDB 单机仓库 + 插件式 CLI 框架。
+> 本地运行的 A 股（沪深主板）选股 CLI 框架：tushare 行情 + OpenAI 兼容 LLM（DeepSeek / Qwen / Kimi …）+ DuckDB 单机仓库 + 纯透传式插件 CLI。框架不携带任何业务策略，所有策略按需从官方注册表安装。
 
-[![tests](https://img.shields.io/badge/tests-passing-brightgreen)](#) [![python](https://img.shields.io/badge/python-3.11+-blue)](#) [![license](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+> 📖 **在线文档**：[deeptrade.tiey.ai](https://deeptrade.tiey.ai) — 用户手册 + 开发者手册 + 官方插件目录
+
+[![tests](https://img.shields.io/badge/tests-passing-brightgreen)](#) [![python](https://img.shields.io/badge/python-3.11+-blue)](#) [![license](https://img.shields.io/badge/license-MIT-green)](LICENSE) [![version](https://img.shields.io/badge/version-0.3.0-blue)](CHANGELOG.md)
 
 ## ✨ 主要特性
 
 - **轻量本地化**：单文件 DuckDB + uv，一条命令跑完，无需服务进程或容器。
-- **纯透传式插件 CLI**：框架命令面**封闭**——只管 `init / config / plugin / data`；其余命令一律按 `deeptrade <plugin_id> <argv...>` 透传给插件，插件自管 `--help`、子命令、参数、持久化。新增插件类型（皮肤、新数据源、回测、IM 渠道……）零框架改动。
+- **框架与插件物理解耦**：`deeptrade-quant` wheel 只含框架（`init / config / plugin / data`），所有策略走 `deeptrade plugin install <短名>` 从注册表安装。
+- **纯透传式插件 CLI**：未知首词一律按 `deeptrade <plugin_id> <argv...>` 透传给插件，插件自管 `--help`、子命令、参数、持久化。
 - **数据隔离（Plan A）**：每个插件在自己的 migrations 里声明并拥有自己的表（含 tushare 派生数据），框架不持有任何业务表。`tushare_sync_state` / `tushare_calls` / `llm_calls` 都按 `plugin_id` 维度隔离。
-- **顶层通知 API**：`from deeptrade import notify, notification_session` 一行发推送；框架根据已安装的 channel 插件自动路由，无 channel 时自动 noop。
 - **多 LLM Provider 共存**：`llm.providers` 字典化配置，多个 OpenAI 兼容服务并存；插件通过 `LLMManager.get_client(name=...)` 按名取用，单次 run 内可调多家。
 - **LLM 强约束**：JSON 模式 + Pydantic 双层校验；**永远**不传 tools / function calls。
-- **盘中数据隔离**：`--allow-intraday` 模式下同步的不完整数据写入 `data_completeness='intraday'`，日终模式严格拒绝命中。
 
 ## 🚀 5 分钟上手
 
-### 安装
+### 安装框架
 
 ```bash
 # 推荐：pipx 隔离环境（命令名仍是 deeptrade）
@@ -73,7 +74,7 @@ pip install -e ".[dev]"
 ### 初始化与配置
 
 ```bash
-deeptrade init                            # 建库 + 应用 core migrations
+deeptrade init                            # 建库 + 应用 core migrations（交互式可选配 tushare / LLM）
 deeptrade config set-tushare              # 交互式输入 tushare token
 deeptrade config set-llm                  # 交互式增/改/删 LLM provider（deepseek / qwen / kimi …）
 deeptrade config list-llm                 # 列出已配置且可用的 provider
@@ -83,16 +84,16 @@ deeptrade config show                     # 表格展示当前配置（密钥脱
 
 ### 安装官方插件并运行
 
-官方插件维护在 [DeepTradePluginOfficial](https://github.com/ty19880929/DeepTradePluginOfficial)，框架通过短名查注册表 → 拉 GitHub release tarball 自动安装。
+官方插件维护在 [DeepTradePluginOfficial](https://github.com/ty19880929/DeepTradePluginOfficial)，框架按短名查注册表 → 拉 GitHub release tarball 自动安装。
 
 ```bash
 # 浏览注册表
-deeptrade plugin search
+deeptrade plugin search                   # 全量列出
+deeptrade plugin search anomaly           # 关键词过滤
 
-# 按短名安装（注册表 → 最新 release tag）
+# 按短名安装（注册表 → 该插件最新 release tag）
 deeptrade plugin install limit-up-board
 deeptrade plugin install volume-anomaly
-deeptrade plugin install stdout-channel
 
 deeptrade plugin list                     # 查看已安装
 
@@ -101,16 +102,18 @@ deeptrade limit-up-board --help
 deeptrade limit-up-board run              # 默认日终模式
 deeptrade limit-up-board run --allow-intraday --force-sync
 
-# 运行成交量异动策略（三模式）
+# 运行成交量异动策略
 deeptrade volume-anomaly screen           # 异动筛选 → upsert va_watchlist
 deeptrade volume-anomaly analyze          # LLM 主升浪启动预测
-deeptrade volume-anomaly prune --days 30  # 剔除追踪 ≥30 日的标的
-
-# 推送链路自检
-deeptrade stdout-channel test
+deeptrade volume-anomaly evaluate         # T+N 自动回测闭环
+deeptrade volume-anomaly stats            # 收益统计聚合
 ```
 
-> **第三方插件 / 本地开发**：`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 plugin install <SOURCE>` 三种来源统一处理，判定顺序为 *本地目录存在 → git URL → 注册表短名*：
+>
+> - `deeptrade plugin install ./path/to/my-plugin` — 本地目录
+> - `deeptrade plugin install https://github.com/owner/repo` — 完整 git 仓库（仓库根需含 `deeptrade_plugin.yaml`）
+> - `deeptrade plugin install my-plugin --ref v1.2.0` — 指定 tag/branch/sha
 
 报告产出在 `~/.deeptrade/reports/<run_id>/`。
 
@@ -123,26 +126,27 @@ deeptrade stdout-channel test
 | `deeptrade --version` / `-V` | 显示版本 |
 | `deeptrade --help` / `-h` | 框架命令清单（**不**枚举插件子命令） |
 | `deeptrade init [--no-prompts]` | 建库 + 应用 core migrations |
+| `deeptrade db init` / `db upgrade` | 显式建库 / 应用待执行迁移 |
 | `deeptrade config {show, set, set-tushare, set-llm, list-llm, test-llm}` | 全局配置 |
-| `deeptrade plugin install <path> [-y]` | 本地路径安装（绝不联网） |
-| `deeptrade plugin list / info <id>` | 列表 / 详情 |
-| `deeptrade plugin enable <id> / disable <id>` | 启 / 停 |
+| `deeptrade plugin search [keyword] [--no-cache]` | 浏览官方注册表 |
+| `deeptrade plugin install <SOURCE> [--ref <REF>] [-y]` | 注册表短名 / GitHub URL / 本地路径 |
+| `deeptrade plugin list` / `info <id>` | 列表 / 详情（未安装时回退注册表条目） |
+| `deeptrade plugin enable <id>` / `disable <id>` | 启 / 停 |
 | `deeptrade plugin uninstall <id> [--purge]` | 卸载（`--purge` 才 DROP 表） |
-| `deeptrade plugin upgrade <path>` | 升级（增量 migrations） |
-| `deeptrade data sync ...` | （暂停用，下版本恢复） |
+| `deeptrade plugin upgrade <SOURCE> [--ref <REF>]` | 升级（SemVer 比较，禁止降级；增量 migrations） |
+| `deeptrade data sync ...` | （暂停用，下版本恢复；改用插件自带的 sync 子命令） |
 
-保留字（不可作为 plugin_id）：`init / config / plugin / data`。
+保留字（不可作为 plugin_id）：`init / config / plugin / data / db`。
 
 ### 插件命令（按 plugin_id 透传，插件自管）
 
-| 命令 | 来源 |
+| 命令 | 来源（注册表短名） |
 |---|---|
-| `deeptrade limit-up-board {run, sync, history, report}` | 内建打板策略插件 |
-| `deeptrade volume-anomaly {screen, analyze, prune, history, report}` | 内建成交量异动插件 |
-| `deeptrade stdout-channel {test, log}` | 内建 stdout 通知插件 |
+| `deeptrade limit-up-board {run, sync, history, report, settings}` | `limit-up-board`（strategy） |
+| `deeptrade volume-anomaly {screen, analyze, evaluate, stats, prune, history, report}` | `volume-anomaly`（strategy） |
 | `deeptrade <你的-plugin-id> ...` | 你自己写的任何插件 |
 
-任意插件子命令的 `--help` 都由插件自身渲染——框架不感知动词语义。
+任意插件子命令的 `--help` 都由插件自身渲染——框架不感知动词语义。各插件的最新子命令、参数与运行手册见 [DeepTradePluginOfficial](https://github.com/ty19880929/DeepTradePluginOfficial)。
 
 ## 🧱 架构
 
@@ -150,33 +154,30 @@ deeptrade stdout-channel test
 ┌──────────────────────── deeptrade CLI (custom click.Group) ────────────────────────┐
 │                                                                                    │
 │  framework commands (closed):                                                      │
-│      init │ config │ plugin │ data                                                 │
+│      init │ config │ plugin │ data │ db                                            │
 │                                                                                    │
 │  plugin pass-through (open):                                                       │
 │      <plugin_id>  ──argv──→  Plugin.dispatch(argv) → int  (plugin owns the rest)   │
 └──────────────────────────────────┬─────────────────────────────────────────────────┘
                                    │
-            ┌──────────────────────┼──────────────────────────┐
-            ▼                      ▼                          ▼
-   ┌─────────────────┐   ┌──────────────────┐    ┌────────────────────┐
-   │ Core services    │   │ deeptrade.notify │    │  Plugins (any type)│
-   │ DuckDB · Config │   │ → routes to all  │    │  • metadata        │
-   │ Tushare · LLM   │   │   enabled        │    │  • validate_static │
-   │ Notifier        │   │   channel plugins│    │  • dispatch(argv)  │
-   └─────────────────┘   └──────────────────┘    │  (channel: + push) │
-                                                  └────────────────────┘
+                                   │
+                  ┌────────────────┴────────────────┐
+                  ▼                                 ▼
+        ┌──────────────────┐              ┌────────────────────┐
+        │ Core services    │              │  Plugins (strategy)│
+        │ DuckDB · Config  │              │  • metadata        │
+        │ Tushare · LLM    │              │  • validate_static │
+        └──────────────────┘              │  • dispatch(argv)  │
+                                          └────────────────────┘
 ```
 
-设计决策见 [docs/plugin_cli_dispatch_evaluation.md](docs/plugin_cli_dispatch_evaluation.md)。
+每个插件通过自己的 migrations 声明并拥有 `<prefix>_*` 业务表；`tushare_sync_state` / `tushare_calls` / `llm_calls` 按 `plugin_id` 维度隔离，`__framework__` 为框架自身保留 sentinel。
 
-## 📖 文档
+## 📖 参考
 
-- [DESIGN.md](DESIGN.md) — 设计文档
-- [docs/plugin_cli_dispatch_evaluation.md](docs/plugin_cli_dispatch_evaluation.md) — 当前架构的评估与决策记录（v0.3）
-- [docs/quick-start.md](docs/quick-start.md) — 上手指南
-- [docs/plugin-development.md](docs/plugin-development.md) — 写一个新插件
-- [docs/limit-up-board.md](docs/limit-up-board.md) — 打板策略说明
-- [CHANGELOG.md](CHANGELOG.md) — 版本变更
+- [CHANGELOG.md](CHANGELOG.md) — 版本变更与历次 breaking change 记录
+- [DeepTradePluginOfficial](https://github.com/ty19880929/DeepTradePluginOfficial) — 官方插件源码、注册表、各插件运行手册
+- 历史快照 `archive/with-builtin-plugins-v0.1.0-preview` — 含 builtin 子树的最后一版状态（v0.2.0 之前）
 
 ## ⚖️ 免责声明
 

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

@@ -1,22 +1,23 @@
 # DeepTrade
 
-> 本地运行的 A 股（沪深主板）选股 CLI 工具：tushare 行情 + OpenAI 兼容 LLM（DeepSeek / Qwen / Kimi …）+ DuckDB 单机仓库 + 插件式 CLI 框架。
+> 本地运行的 A 股（沪深主板）选股 CLI 框架：tushare 行情 + OpenAI 兼容 LLM（DeepSeek / Qwen / Kimi …）+ DuckDB 单机仓库 + 纯透传式插件 CLI。框架不携带任何业务策略，所有策略按需从官方注册表安装。
 
-[![tests](https://img.shields.io/badge/tests-passing-brightgreen)](#) [![python](https://img.shields.io/badge/python-3.11+-blue)](#) [![license](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+> 📖 **在线文档**：[deeptrade.tiey.ai](https://deeptrade.tiey.ai) — 用户手册 + 开发者手册 + 官方插件目录
+
+[![tests](https://img.shields.io/badge/tests-passing-brightgreen)](#) [![python](https://img.shields.io/badge/python-3.11+-blue)](#) [![license](https://img.shields.io/badge/license-MIT-green)](LICENSE) [![version](https://img.shields.io/badge/version-0.3.0-blue)](CHANGELOG.md)
 
 ## ✨ 主要特性
 
 - **轻量本地化**：单文件 DuckDB + uv，一条命令跑完，无需服务进程或容器。
-- **纯透传式插件 CLI**：框架命令面**封闭**——只管 `init / config / plugin / data`；其余命令一律按 `deeptrade <plugin_id> <argv...>` 透传给插件，插件自管 `--help`、子命令、参数、持久化。新增插件类型（皮肤、新数据源、回测、IM 渠道……）零框架改动。
+- **框架与插件物理解耦**：`deeptrade-quant` wheel 只含框架（`init / config / plugin / data`），所有策略走 `deeptrade plugin install <短名>` 从注册表安装。
+- **纯透传式插件 CLI**：未知首词一律按 `deeptrade <plugin_id> <argv...>` 透传给插件，插件自管 `--help`、子命令、参数、持久化。
 - **数据隔离（Plan A）**：每个插件在自己的 migrations 里声明并拥有自己的表（含 tushare 派生数据），框架不持有任何业务表。`tushare_sync_state` / `tushare_calls` / `llm_calls` 都按 `plugin_id` 维度隔离。
-- **顶层通知 API**：`from deeptrade import notify, notification_session` 一行发推送；框架根据已安装的 channel 插件自动路由，无 channel 时自动 noop。
 - **多 LLM Provider 共存**：`llm.providers` 字典化配置，多个 OpenAI 兼容服务并存；插件通过 `LLMManager.get_client(name=...)` 按名取用，单次 run 内可调多家。
 - **LLM 强约束**：JSON 模式 + Pydantic 双层校验；**永远**不传 tools / function calls。
-- **盘中数据隔离**：`--allow-intraday` 模式下同步的不完整数据写入 `data_completeness='intraday'`，日终模式严格拒绝命中。
 
 ## 🚀 5 分钟上手
 
-### 安装
+### 安装框架
 
 ```bash
 # 推荐：pipx 隔离环境（命令名仍是 deeptrade）
@@ -39,7 +40,7 @@ pip install -e ".[dev]"
 ### 初始化与配置
 
 ```bash
-deeptrade init                            # 建库 + 应用 core migrations
+deeptrade init                            # 建库 + 应用 core migrations（交互式可选配 tushare / LLM）
 deeptrade config set-tushare              # 交互式输入 tushare token
 deeptrade config set-llm                  # 交互式增/改/删 LLM provider（deepseek / qwen / kimi …）
 deeptrade config list-llm                 # 列出已配置且可用的 provider
@@ -49,16 +50,16 @@ deeptrade config show                     # 表格展示当前配置（密钥脱
 
 ### 安装官方插件并运行
 
-官方插件维护在 [DeepTradePluginOfficial](https://github.com/ty19880929/DeepTradePluginOfficial)，框架通过短名查注册表 → 拉 GitHub release tarball 自动安装。
+官方插件维护在 [DeepTradePluginOfficial](https://github.com/ty19880929/DeepTradePluginOfficial)，框架按短名查注册表 → 拉 GitHub release tarball 自动安装。
 
 ```bash
 # 浏览注册表
-deeptrade plugin search
+deeptrade plugin search                   # 全量列出
+deeptrade plugin search anomaly           # 关键词过滤
 
-# 按短名安装（注册表 → 最新 release tag）
+# 按短名安装（注册表 → 该插件最新 release tag）
 deeptrade plugin install limit-up-board
 deeptrade plugin install volume-anomaly
-deeptrade plugin install stdout-channel
 
 deeptrade plugin list                     # 查看已安装
 
@@ -67,16 +68,18 @@ deeptrade limit-up-board --help
 deeptrade limit-up-board run              # 默认日终模式
 deeptrade limit-up-board run --allow-intraday --force-sync
 
-# 运行成交量异动策略（三模式）
+# 运行成交量异动策略
 deeptrade volume-anomaly screen           # 异动筛选 → upsert va_watchlist
 deeptrade volume-anomaly analyze          # LLM 主升浪启动预测
-deeptrade volume-anomaly prune --days 30  # 剔除追踪 ≥30 日的标的
-
-# 推送链路自检
-deeptrade stdout-channel test
+deeptrade volume-anomaly evaluate         # T+N 自动回测闭环
+deeptrade volume-anomaly stats            # 收益统计聚合
 ```
 
-> **第三方插件 / 本地开发**：`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 plugin install <SOURCE>` 三种来源统一处理，判定顺序为 *本地目录存在 → git URL → 注册表短名*：
+>
+> - `deeptrade plugin install ./path/to/my-plugin` — 本地目录
+> - `deeptrade plugin install https://github.com/owner/repo` — 完整 git 仓库（仓库根需含 `deeptrade_plugin.yaml`）
+> - `deeptrade plugin install my-plugin --ref v1.2.0` — 指定 tag/branch/sha
 
 报告产出在 `~/.deeptrade/reports/<run_id>/`。
 
@@ -89,26 +92,27 @@ deeptrade stdout-channel test
 | `deeptrade --version` / `-V` | 显示版本 |
 | `deeptrade --help` / `-h` | 框架命令清单（**不**枚举插件子命令） |
 | `deeptrade init [--no-prompts]` | 建库 + 应用 core migrations |
+| `deeptrade db init` / `db upgrade` | 显式建库 / 应用待执行迁移 |
 | `deeptrade config {show, set, set-tushare, set-llm, list-llm, test-llm}` | 全局配置 |
-| `deeptrade plugin install <path> [-y]` | 本地路径安装（绝不联网） |
-| `deeptrade plugin list / info <id>` | 列表 / 详情 |
-| `deeptrade plugin enable <id> / disable <id>` | 启 / 停 |
+| `deeptrade plugin search [keyword] [--no-cache]` | 浏览官方注册表 |
+| `deeptrade plugin install <SOURCE> [--ref <REF>] [-y]` | 注册表短名 / GitHub URL / 本地路径 |
+| `deeptrade plugin list` / `info <id>` | 列表 / 详情（未安装时回退注册表条目） |
+| `deeptrade plugin enable <id>` / `disable <id>` | 启 / 停 |
 | `deeptrade plugin uninstall <id> [--purge]` | 卸载（`--purge` 才 DROP 表） |
-| `deeptrade plugin upgrade <path>` | 升级（增量 migrations） |
-| `deeptrade data sync ...` | （暂停用，下版本恢复） |
+| `deeptrade plugin upgrade <SOURCE> [--ref <REF>]` | 升级（SemVer 比较，禁止降级；增量 migrations） |
+| `deeptrade data sync ...` | （暂停用，下版本恢复；改用插件自带的 sync 子命令） |
 
-保留字（不可作为 plugin_id）：`init / config / plugin / data`。
+保留字（不可作为 plugin_id）：`init / config / plugin / data / db`。
 
 ### 插件命令（按 plugin_id 透传，插件自管）
 
-| 命令 | 来源 |
+| 命令 | 来源（注册表短名） |
 |---|---|
-| `deeptrade limit-up-board {run, sync, history, report}` | 内建打板策略插件 |
-| `deeptrade volume-anomaly {screen, analyze, prune, history, report}` | 内建成交量异动插件 |
-| `deeptrade stdout-channel {test, log}` | 内建 stdout 通知插件 |
+| `deeptrade limit-up-board {run, sync, history, report, settings}` | `limit-up-board`（strategy） |
+| `deeptrade volume-anomaly {screen, analyze, evaluate, stats, prune, history, report}` | `volume-anomaly`（strategy） |
 | `deeptrade <你的-plugin-id> ...` | 你自己写的任何插件 |
 
-任意插件子命令的 `--help` 都由插件自身渲染——框架不感知动词语义。
+任意插件子命令的 `--help` 都由插件自身渲染——框架不感知动词语义。各插件的最新子命令、参数与运行手册见 [DeepTradePluginOfficial](https://github.com/ty19880929/DeepTradePluginOfficial)。
 
 ## 🧱 架构
 
@@ -116,33 +120,30 @@ deeptrade stdout-channel test
 ┌──────────────────────── deeptrade CLI (custom click.Group) ────────────────────────┐
 │                                                                                    │
 │  framework commands (closed):                                                      │
-│      init │ config │ plugin │ data                                                 │
+│      init │ config │ plugin │ data │ db                                            │
 │                                                                                    │
 │  plugin pass-through (open):                                                       │
 │      <plugin_id>  ──argv──→  Plugin.dispatch(argv) → int  (plugin owns the rest)   │
 └──────────────────────────────────┬─────────────────────────────────────────────────┘
                                    │
-            ┌──────────────────────┼──────────────────────────┐
-            ▼                      ▼                          ▼
-   ┌─────────────────┐   ┌──────────────────┐    ┌────────────────────┐
-   │ Core services    │   │ deeptrade.notify │    │  Plugins (any type)│
-   │ DuckDB · Config │   │ → routes to all  │    │  • metadata        │
-   │ Tushare · LLM   │   │   enabled        │    │  • validate_static │
-   │ Notifier        │   │   channel plugins│    │  • dispatch(argv)  │
-   └─────────────────┘   └──────────────────┘    │  (channel: + push) │
-                                                  └────────────────────┘
+                                   │
+                  ┌────────────────┴────────────────┐
+                  ▼                                 ▼
+        ┌──────────────────┐              ┌────────────────────┐
+        │ Core services    │              │  Plugins (strategy)│
+        │ DuckDB · Config  │              │  • metadata        │
+        │ Tushare · LLM    │              │  • validate_static │
+        └──────────────────┘              │  • dispatch(argv)  │
+                                          └────────────────────┘
 ```
 
-设计决策见 [docs/plugin_cli_dispatch_evaluation.md](docs/plugin_cli_dispatch_evaluation.md)。
+每个插件通过自己的 migrations 声明并拥有 `<prefix>_*` 业务表；`tushare_sync_state` / `tushare_calls` / `llm_calls` 按 `plugin_id` 维度隔离，`__framework__` 为框架自身保留 sentinel。
 
-## 📖 文档
+## 📖 参考
 
-- [DESIGN.md](DESIGN.md) — 设计文档
-- [docs/plugin_cli_dispatch_evaluation.md](docs/plugin_cli_dispatch_evaluation.md) — 当前架构的评估与决策记录（v0.3）
-- [docs/quick-start.md](docs/quick-start.md) — 上手指南
-- [docs/plugin-development.md](docs/plugin-development.md) — 写一个新插件
-- [docs/limit-up-board.md](docs/limit-up-board.md) — 打板策略说明
-- [CHANGELOG.md](CHANGELOG.md) — 版本变更
+- [CHANGELOG.md](CHANGELOG.md) — 版本变更与历次 breaking change 记录
+- [DeepTradePluginOfficial](https://github.com/ty19880929/DeepTradePluginOfficial) — 官方插件源码、注册表、各插件运行手册
+- 历史快照 `archive/with-builtin-plugins-v0.1.0-preview` — 含 builtin 子树的最后一版状态（v0.2.0 之前）
 
 ## ⚖️ 免责声明
 

deeptrade_quant-0.3.0/deeptrade/__init__.py

@@ -0,0 +1,6 @@
+"""DeepTrade — LLM-driven A-share stock screening CLI."""
+
+from __future__ import annotations
+
+__version__ = "0.3.0"
+__all__ = ["__version__"]

deeptrade_quant-0.3.0/deeptrade/core/__init__.py

@@ -0,0 +1,7 @@
+"""Core services layer.
+
+Houses cross-cutting infrastructure (DB, config, secrets, clients) that plugins
+consume directly via the public ``deeptrade.plugins_api`` surface.
+"""
+
+from __future__ import annotations

{deeptrade_quant-0.2.0 → deeptrade_quant-0.3.0}/deeptrade/core/config_migrations.py

@@ -8,16 +8,22 @@ or already-migrated DB is a no-op.
 
 v0.6 — deepseek.* → llm.providers / llm.<name>.api_key (DESIGN §0.7 / §10.5).
 v0.7 — deepseek.profile → app.profile (DESIGN §10.1 update).
+v0.3.0 — purge legacy channel-type plugin installs (channel type removed).
 """
 
 from __future__ import annotations
 
 import json
+import logging
+import shutil
+from pathlib import Path
 from typing import TYPE_CHECKING
 
 if TYPE_CHECKING:  # pragma: no cover
     from deeptrade.core.db import Database
 
+logger = logging.getLogger(__name__)
+
 
 _LEGACY_KEYS = (
     "deepseek.base_url",
@@ -95,9 +101,7 @@ def migrate_legacy_deepseek_keys(db: Database) -> bool:
         # Rename secret. UPDATE-only avoids re-encrypting; if the destination
         # row already exists (extremely unlikely on a non-migrated DB), prefer
         # the legacy value as canonical and overwrite.
-        existing_dest = db.fetchone(
-            "SELECT 1 FROM secret_store WHERE key = 'llm.deepseek.api_key'"
-        )
+        existing_dest = db.fetchone("SELECT 1 FROM secret_store WHERE key = 'llm.deepseek.api_key'")
         if existing_dest is not None:
             db.execute("DELETE FROM secret_store WHERE key = 'llm.deepseek.api_key'")
         db.execute(
@@ -134,9 +138,7 @@ def migrate_llm_default_provider(db: Database) -> bool:
     if not isinstance(providers, dict) or not providers:
         return False
 
-    has_default = any(
-        isinstance(v, dict) and bool(v.get("is_default")) for v in providers.values()
-    )
+    has_default = any(isinstance(v, dict) and bool(v.get("is_default")) for v in providers.values())
     if has_default:
         return False
 
@@ -154,6 +156,63 @@ def migrate_llm_default_provider(db: Database) -> bool:
     return True
 
 
+def migrate_purge_non_strategy_plugins(db: Database) -> list[str]:
+    """Remove legacy non-``strategy`` plugin records (v0.3.0).
+
+    The ``channel`` plugin type was retired in v0.3.0 along with the framework
+    notifier. Any plugin row whose ``type`` is not ``'strategy'`` would now
+    fail :class:`PluginMetadata` validation on every ``list_all`` call, which
+    blocks the CLI hard. This migration silently:
+
+      1. Drops each legacy plugin's owned tables (respecting
+         ``purge_on_uninstall``).
+      2. Deletes the rows in ``plugin_tables`` / ``plugin_schema_migrations``
+         / ``plugins``.
+      3. Removes the on-disk install directory.
+
+    Idempotent: returns an empty list when no offending rows exist. Returns
+    the list of purged ``plugin_id`` values otherwise (caller logs them).
+    """
+    rows = db.fetchall("SELECT plugin_id, type, install_path FROM plugins WHERE type != 'strategy'")
+    if not rows:
+        return []
+
+    purged: list[str] = []
+    for plugin_id, plugin_type, install_path in rows:
+        tables = db.fetchall(
+            "SELECT table_name, purge_on_uninstall FROM plugin_tables WHERE plugin_id = ?",
+            (plugin_id,),
+        )
+        with db.transaction():
+            for tname, purge_flag in tables:
+                if purge_flag:
+                    try:
+                        db.execute(f"DROP TABLE IF EXISTS {tname}")  # noqa: S608 — name validated at install
+                    except Exception:  # noqa: BLE001 — best-effort cleanup
+                        logger.warning(
+                            "purge: failed to drop table %s owned by legacy plugin %s",
+                            tname,
+                            plugin_id,
+                        )
+            db.execute("DELETE FROM plugin_tables WHERE plugin_id = ?", (plugin_id,))
+            db.execute("DELETE FROM plugin_schema_migrations WHERE plugin_id = ?", (plugin_id,))
+            db.execute("DELETE FROM plugins WHERE plugin_id = ?", (plugin_id,))
+
+        if install_path:
+            dest = Path(install_path)
+            if dest.exists():
+                shutil.rmtree(dest, ignore_errors=True)
+
+        logger.warning(
+            "purged legacy plugin %r (type=%r) — type retired in v0.3.0",
+            plugin_id,
+            plugin_type,
+        )
+        purged.append(plugin_id)
+
+    return purged
+
+
 def migrate_legacy_deepseek_profile_key(db: Database) -> bool:
     """Migrate ``deepseek.profile`` → ``app.profile`` (v0.7).
 

{deeptrade_quant-0.2.0 → deeptrade_quant-0.3.0}/deeptrade/core/db.py

@@ -167,6 +167,7 @@ def apply_core_migrations(db: Database) -> list[str]:
         migrate_legacy_deepseek_keys,
         migrate_legacy_deepseek_profile_key,
         migrate_llm_default_provider,
+        migrate_purge_non_strategy_plugins,
     )
 
     if migrate_legacy_deepseek_keys(db):
@@ -177,4 +178,9 @@ def apply_core_migrations(db: Database) -> list[str]:
     # v0.8 data migration — backfill is_default on existing providers.
     if migrate_llm_default_provider(db):
         newly.append("data:v08_llm_default_provider")
+    # v0.3.0 data migration — drop legacy non-strategy (channel) plugin rows
+    # so list_all() / PluginMetadata.model_validate don't crash on the
+    # retired type literal.
+    if migrate_purge_non_strategy_plugins(db):
+        newly.append("data:v030_purge_non_strategy_plugins")
     return newly

{deeptrade_quant-0.2.0 → deeptrade_quant-0.3.0}/deeptrade/core/migrations/core/20260509_001_init.sql

@@ -41,7 +41,7 @@ CREATE TABLE IF NOT EXISTS plugins (
     plugin_id     VARCHAR PRIMARY KEY,
     name          VARCHAR NOT NULL,
     version       VARCHAR NOT NULL,
-    type          VARCHAR NOT NULL,             -- 'strategy' | 'channel' | future
+    type          VARCHAR NOT NULL,             -- 'strategy' (reserved for future plugin types)
     api_version   VARCHAR NOT NULL,
     entrypoint    VARCHAR NOT NULL,
     install_path  VARCHAR NOT NULL,

{deeptrade_quant-0.2.0 → deeptrade_quant-0.3.0}/deeptrade/core/plugin_manager.py

@@ -167,10 +167,9 @@ def _load_entrypoint(
 def _build_validate_ctx(db: Database, meta: PluginMetadata) -> Any:
     """Build the framework's minimal ``PluginContext`` for ``validate_static``.
 
-    All plugin types (strategy / channel / future) share the same narrow
-    context shape: db + config + plugin_id. Plugins that need richer services
-    (TushareClient, LLMManager / LLMClient, ...) construct them inside their own
-    ``dispatch`` from these primitives.
+    Every plugin shares the same narrow context shape: db + config + plugin_id.
+    Plugins that need richer services (TushareClient, LLMManager / LLMClient, ...)
+    construct them inside their own ``dispatch`` from these primitives.
     """
     from deeptrade.core.config import ConfigService
     from deeptrade.plugins_api.base import PluginContext

{deeptrade_quant-0.2.0 → deeptrade_quant-0.3.0}/deeptrade/plugins_api/__init__.py

@@ -4,8 +4,6 @@ All plugins import from this package; the rest of ``deeptrade.*`` is internal.
 
 Stable surface (api_version = "1"):
     - Plugin (Protocol), PluginContext — every plugin's contract: metadata + validate_static + dispatch
-    - ChannelPlugin (Protocol) — channel-specific extension (push hook)
-    - NotificationPayload, NotificationSection, NotificationItem — notify data contract
     - PluginMetadata, TableSpec, MigrationSpec, PluginPermissions, ...
     - StageProfile — LLM 调参档；插件持有 preset → stage 映射表，自行解析
 """
@@ -13,7 +11,6 @@ Stable surface (api_version = "1"):
 from __future__ import annotations
 
 from deeptrade.plugins_api.base import Plugin, PluginContext
-from deeptrade.plugins_api.channel import ChannelPlugin
 from deeptrade.plugins_api.llm import StageProfile
 from deeptrade.plugins_api.metadata import (
     MigrationSpec,
@@ -22,18 +19,9 @@ from deeptrade.plugins_api.metadata import (
     TableSpec,
     TushareApiPermissions,
 )
-from deeptrade.plugins_api.notify import (
-    NotificationItem,
-    NotificationPayload,
-    NotificationSection,
-)
 
 __all__ = [
-    "ChannelPlugin",
     "MigrationSpec",
-    "NotificationItem",
-    "NotificationPayload",
-    "NotificationSection",
     "Plugin",
     "PluginContext",
     "PluginMetadata",

{deeptrade_quant-0.2.0 → deeptrade_quant-0.3.0}/deeptrade/plugins_api/base.py

@@ -6,10 +6,7 @@ NOTHING about the plugin's domain semantics; the plugin owns its own command
 parsing, execution, persistence, and output.
 
 ``PluginContext`` is the minimal services bundle the framework hands to every
-plugin's ``validate_static`` (during install) and to channel plugins' ``push``
-(during notify). It lives here — alongside the base ``Plugin`` Protocol —
-because it is the universal context for the base contract; channel-specific
-extensions live in :mod:`deeptrade.plugins_api.channel`.
+plugin's ``validate_static`` (during install).
 """
 
 from __future__ import annotations
@@ -26,8 +23,7 @@ if TYPE_CHECKING:  # pragma: no cover
 @dataclass
 class PluginContext:
     """Minimal services bundle the framework hands to a plugin's
-    ``validate_static`` (during install) and to a channel plugin's ``push``
-    (during notify).
+    ``validate_static`` (during install).
 
     Plugins that need richer services (TushareClient, LLMManager / LLMClient, etc.)
     construct them inside their own ``dispatch`` from these primitives.

{deeptrade_quant-0.2.0 → deeptrade_quant-0.3.0}/deeptrade/plugins_api/metadata.py

@@ -53,9 +53,7 @@ class PluginMetadata(BaseModel):
     plugin_id: str = Field(..., pattern=r"^[a-z][a-z0-9-]{2,31}$")
     name: str
     version: str
-    # v0.4: widened to support channel plugins (DESIGN §18.4). Old yaml with
-    # type='strategy' (or omitted) remains valid via the default.
-    type: Literal["strategy", "channel"] = "strategy"
+    type: Literal["strategy"] = "strategy"
     api_version: str
     entrypoint: str = Field(..., pattern=r"^[A-Za-z_][\w\.]*:[A-Za-z_]\w*$")
     description: str

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

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