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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: deeptrade-quant
-Version: 0.2.0
+Version: 0.3.1
 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.1}/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.1/deeptrade/__init__.py

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

{deeptrade_quant-0.2.0 → deeptrade_quant-0.3.1}/deeptrade/cli.py

@@ -103,8 +103,7 @@ def _build_plugin_command(plugin_id: str) -> click.Command | None:
         )
         def _disabled() -> None:
             typer.echo(
-                f"✘ plugin {plugin_id!r} is disabled; "
-                f"run `deeptrade plugin enable {plugin_id}`"
+                f"✘ plugin {plugin_id!r} is disabled; run `deeptrade plugin enable {plugin_id}`"
             )
             raise typer.Exit(2)
 
@@ -204,15 +203,16 @@ def init(
         cmd_set_llm()
 
 
-
 @app.command(name="db", context_settings={"ignore_unknown_options": True, "allow_extra_args": True})
 def db_cmd(ctx: click.Context) -> None:
     """Database migration and management commands (legacy stub; use `deeptrade db init` via group if added)."""
     pass
 
+
 db_app = typer.Typer(name="db", help="Database migration and management commands.")
 app.add_typer(db_app, name="db")
 
+
 @db_app.command("init")
 def db_init() -> None:
     """Initialize the core database tables and apply migrations."""
@@ -232,10 +232,12 @@ def db_init() -> None:
     finally:
         db.close()
 
+
 @db_app.command("upgrade")
 def db_upgrade() -> None:
     """Apply any pending core migrations."""
     db_init()
 
+
 if __name__ == "__main__":
     app()

{deeptrade_quant-0.2.0 → deeptrade_quant-0.3.1}/deeptrade/cli_config.py

@@ -156,10 +156,12 @@ def cmd_set_llm() -> None:
         existing = sorted(cfg.llm_providers.keys())
 
         if existing:
-            choices = ["[+] Add new provider"] + [f"[~] {n}" for n in existing] + ["[x] Delete a provider"]
-            picked = questionary.select(
-                "Pick action:", choices=choices
-            ).ask()
+            choices = (
+                ["[+] Add new provider"]
+                + [f"[~] {n}" for n in existing]
+                + ["[x] Delete a provider"]
+            )
+            picked = questionary.select("Pick action:", choices=choices).ask()
             if picked is None:
                 raise typer.Exit(1)
             if picked.startswith("[+]"):
@@ -177,9 +179,7 @@ def cmd_set_llm() -> None:
 
 
 def _set_llm_new(svc: ConfigService) -> None:
-    name = questionary.text(
-        "Provider name (e.g. deepseek, qwen-plus, kimi):"
-    ).ask()
+    name = questionary.text("Provider name (e.g. deepseek, qwen-plus, kimi):").ask()
     if not name:
         raise typer.Exit(1)
     name = name.strip()
@@ -259,9 +259,7 @@ def _prompt_and_save_provider(
         raise typer.Exit(2) from e
 
     api_key_prompt = (
-        "API key (leave empty to keep existing):"
-        if defaults is not None
-        else "API key:"
+        "API key (leave empty to keep existing):" if defaults is not None else "API key:"
     )
     api_key = questionary.password(api_key_prompt).ask()
     if api_key is None:

{deeptrade_quant-0.2.0 → deeptrade_quant-0.3.1}/deeptrade/cli_plugin.py

@@ -58,9 +58,7 @@ def _format_origin(resolved: ResolvedSource) -> str:
     if resolved.origin == "local":
         return f"本地路径 ({d.get('local_path', resolved.path)})"
     if resolved.origin == "github_registry":
-        return (
-            f"GitHub 注册表 ({d['repo']}@{d['ref']}, subdir={d['subdir']})"
-        )
+        return f"GitHub 注册表 ({d['repo']}@{d['ref']}, subdir={d['subdir']})"
     if resolved.origin == "github_url":
         return f"GitHub URL ({d['repo']}@{d['ref']})"
     return resolved.origin
@@ -68,9 +66,7 @@ def _format_origin(resolved: ResolvedSource) -> str:
 
 @app.command("install")
 def cmd_install(
-    source: str = typer.Argument(
-        ..., help="短名（注册表）/ 本地路径 / GitHub URL"
-    ),
+    source: str = typer.Argument(..., help="短名（注册表）/ 本地路径 / GitHub URL"),
     ref: str | None = typer.Option(
         None, "--ref", help="Tag / branch / sha (默认 = 该插件最新 release)"
     ),
@@ -150,9 +146,7 @@ def cmd_info(plugin_id: str = typer.Argument(...)) -> None:
     try:
         try:
             rec = mgr.info(plugin_id)
-            typer.echo(
-                yaml.safe_dump(rec.metadata.model_dump(mode="json"), allow_unicode=True)
-            )
+            typer.echo(yaml.safe_dump(rec.metadata.model_dump(mode="json"), allow_unicode=True))
             return
         except PluginNotFoundError:
             pass  # fall through to registry lookup
@@ -237,9 +231,7 @@ def cmd_uninstall(
 
 @app.command("upgrade")
 def cmd_upgrade(
-    source: str = typer.Argument(
-        ..., help="短名（注册表）/ 本地路径 / GitHub URL"
-    ),
+    source: str = typer.Argument(..., help="短名（注册表）/ 本地路径 / GitHub URL"),
     ref: str | None = typer.Option(
         None, "--ref", help="Tag / branch / sha (默认 = 该插件最新 release)"
     ),
@@ -269,9 +261,7 @@ def cmd_upgrade(
                     pid = meta.plugin_id
                 except PluginInstallError:
                     pid = source
-                typer.echo(
-                    f'✘ 插件 "{pid}" 未安装，请先执行 deeptrade plugin install'
-                )
+                typer.echo(f'✘ 插件 "{pid}" 未安装，请先执行 deeptrade plugin install')
                 raise typer.Exit(2) from e
             except PluginInstallError as e:
                 typer.echo(f"✘ Upgrade failed: {e}")
@@ -293,9 +283,7 @@ def cmd_search(
     keyword: str | None = typer.Argument(
         None, help="可选过滤关键词（匹配 plugin_id / name / description）"
     ),
-    no_cache: bool = typer.Option(
-        False, "--no-cache", help="强制刷新注册表（旁路 ETag 缓存）"
-    ),
+    no_cache: bool = typer.Option(False, "--no-cache", help="强制刷新注册表（旁路 ETag 缓存）"),
 ) -> None:
     """List plugins available in the official registry."""
     try:

deeptrade_quant-0.3.1/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.1}/deeptrade/core/config.py

@@ -87,6 +87,11 @@ class AppConfig(BaseModel):
     # tushare.*  (token lives in secret_store)
     tushare_rps: float = Field(default=6.0, gt=0)
     tushare_timeout: int = Field(default=30, ge=1)
+    # Tenacity stop_after_attempt for transient errors (rate limit / server /
+    # transport). Default 7 keeps worst-case wait around one minute of
+    # jittered exponential backoff. Each attempt re-enters the token bucket,
+    # so retries never bypass rate limiting.
+    tushare_max_retries: int = Field(default=7, ge=1, le=20)
 
     # Global preset name. v0.7 — renamed from ``deepseek.profile``; semantics
     # are vendor-agnostic. Per-stage tuning is resolved by each plugin's
@@ -134,6 +139,7 @@ _DOT_TO_FIELD: dict[str, str] = {
     "app.close_after": "app_close_after",
     "tushare.rps": "tushare_rps",
     "tushare.timeout": "tushare_timeout",
+    "tushare.max_retries": "tushare_max_retries",
     "app.profile": "app_profile",
     "llm.providers": "llm_providers",
     "llm.audit_full_payload": "llm_audit_full_payload",
@@ -365,8 +371,7 @@ class ConfigService:
             # already default; otherwise we'd leave the dict with no
             # default at all. Preserve prior_default in that case.
             other_has_default = any(
-                k != name and bool((v or {}).get("is_default"))
-                for k, v in current.items()
+                k != name and bool((v or {}).get("is_default")) for k, v in current.items()
             )
             new_default = prior_default if not other_has_default else False
 
@@ -374,7 +379,11 @@ class ConfigService:
         # the invariant "at most one default" holds.
         if new_default:
             for other_name, other_cfg in current.items():
-                if other_name != name and isinstance(other_cfg, dict) and other_cfg.get("is_default"):
+                if (
+                    other_name != name
+                    and isinstance(other_cfg, dict)
+                    and other_cfg.get("is_default")
+                ):
                     current[other_name] = {**other_cfg, "is_default": False}
 
         current[name] = {