deeptrade-quant 0.0.2__tar.gz

deeptrade_quant-0.0.2/.gitignore

@@ -0,0 +1,47 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.egg
+*.egg-info/
+build/
+dist/
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Tooling caches
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.coverage
+htmlcov/
+.tox/
+
+# Editor
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Environment
+.env
+.env.local
+
+# DeepTrade local artifacts
+.deeptrade/
+dev.duckdb
+dev.duckdb.wal
+*.duckdb-wal
+
+# Logs
+*.log
+logs/
+
+# OS
+.DS_Store
+Thumbs.db

deeptrade_quant-0.0.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DeepTrade
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

deeptrade_quant-0.0.2/PKG-INFO

@@ -0,0 +1,166 @@
+Metadata-Version: 2.4
+Name: deeptrade-quant
+Version: 0.0.2
+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
+Project-URL: Issues, https://github.com/ty19880929/deeptrade/issues
+Author: DeepTrade
+License: MIT
+License-File: LICENSE
+Keywords: a-share,cli,deepseek,duckdb,llm,stock,tushare
+Requires-Python: >=3.11
+Requires-Dist: click>=8.1
+Requires-Dist: duckdb>=1.0
+Requires-Dist: keyring>=25.0
+Requires-Dist: openai>=1.0
+Requires-Dist: pandas>=2.2
+Requires-Dist: pydantic>=2.7
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: questionary>=2.0
+Requires-Dist: rich>=13.7
+Requires-Dist: tenacity>=8.0
+Requires-Dist: tushare>=1.4
+Requires-Dist: typer>=0.12
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pre-commit>=3.7; extra == 'dev'
+Requires-Dist: pytest-mock>=3.12; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.5; extra == 'dev'
+Requires-Dist: types-pyyaml>=6.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# DeepTrade
+
+> 本地运行的 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)
+
+## ✨ 主要特性
+
+- **轻量本地化**：单文件 DuckDB + uv，一条命令跑完，无需服务进程或容器。
+- **纯透传式插件 CLI**：框架命令面**封闭**——只管 `init / config / plugin / data`；其余命令一律按 `deeptrade <plugin_id> <argv...>` 透传给插件，插件自管 `--help`、子命令、参数、持久化。新增插件类型（皮肤、新数据源、回测、IM 渠道……）零框架改动。
+- **数据隔离（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
+# 推荐
+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]"
+```
+
+### 初始化与配置
+
+```bash
+deeptrade init                            # 建库 + 应用 core migrations
+deeptrade config set-tushare              # 交互式输入 tushare token
+deeptrade config set-llm                  # 交互式增/改/删 LLM provider（deepseek / qwen / kimi …）
+deeptrade config list-llm                 # 列出已配置且可用的 provider
+deeptrade config test-llm                 # 对所有 provider 做连通性自检（也可加 <name> 单测）
+deeptrade config show                     # 表格展示当前配置（密钥脱敏）
+```
+
+### 安装内置插件并运行
+
+```bash
+# 安装一个 strategy 插件 + 一个 channel 插件
+deeptrade plugin install ./deeptrade/strategies_builtin/limit_up_board -y
+deeptrade plugin install ./deeptrade/channels_builtin/stdout -y
+
+deeptrade plugin list                     # 查看已安装
+
+# 运行打板策略（CLI 由插件自管，--help 由插件渲染）
+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/reports/<run_id>/`。
+
+## 📦 命令矩阵
+
+### 框架命令（封闭集合）
+
+| 命令 | 用途 |
+|---|---|
+| `deeptrade --version` / `-V` | 显示版本 |
+| `deeptrade --help` / `-h` | 框架命令清单（**不**枚举插件子命令） |
+| `deeptrade init [--no-prompts]` | 建库 + 应用 core migrations |
+| `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 uninstall <id> [--purge]` | 卸载（`--purge` 才 DROP 表） |
+| `deeptrade plugin upgrade <path>` | 升级（增量 migrations） |
+| `deeptrade data sync ...` | （暂停用，下版本恢复） |
+
+保留字（不可作为 plugin_id）：`init / config / plugin / data`。
+
+### 插件命令（按 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 <你的-plugin-id> ...` | 你自己写的任何插件 |
+
+任意插件子命令的 `--help` 都由插件自身渲染——框架不感知动词语义。
+
+## 🧱 架构
+
+```
+┌──────────────────────── deeptrade CLI (custom click.Group) ────────────────────────┐
+│                                                                                    │
+│  framework commands (closed):                                                      │
+│      init │ config │ plugin │ data                                                 │
+│                                                                                    │
+│  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) │
+                                                  └────────────────────┘
+```
+
+设计决策见 [docs/plugin_cli_dispatch_evaluation.md](docs/plugin_cli_dispatch_evaluation.md)。
+
+## 📖 文档
+
+- [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) — 版本变更
+
+## ⚖️ 免责声明
+
+本工具仅用于策略研究、数据整理与候选标的分析，**不构成投资建议**，**不进行自动交易**。所有 LLM 输出基于提交的结构化数据，不引用任何外部信息源；用户应自行核验候选标的的最新状态后再做决策。

deeptrade_quant-0.0.2/README.md

@@ -0,0 +1,133 @@
+# DeepTrade
+
+> 本地运行的 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)
+
+## ✨ 主要特性
+
+- **轻量本地化**：单文件 DuckDB + uv，一条命令跑完，无需服务进程或容器。
+- **纯透传式插件 CLI**：框架命令面**封闭**——只管 `init / config / plugin / data`；其余命令一律按 `deeptrade <plugin_id> <argv...>` 透传给插件，插件自管 `--help`、子命令、参数、持久化。新增插件类型（皮肤、新数据源、回测、IM 渠道……）零框架改动。
+- **数据隔离（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
+# 推荐
+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]"
+```
+
+### 初始化与配置
+
+```bash
+deeptrade init                            # 建库 + 应用 core migrations
+deeptrade config set-tushare              # 交互式输入 tushare token
+deeptrade config set-llm                  # 交互式增/改/删 LLM provider（deepseek / qwen / kimi …）
+deeptrade config list-llm                 # 列出已配置且可用的 provider
+deeptrade config test-llm                 # 对所有 provider 做连通性自检（也可加 <name> 单测）
+deeptrade config show                     # 表格展示当前配置（密钥脱敏）
+```
+
+### 安装内置插件并运行
+
+```bash
+# 安装一个 strategy 插件 + 一个 channel 插件
+deeptrade plugin install ./deeptrade/strategies_builtin/limit_up_board -y
+deeptrade plugin install ./deeptrade/channels_builtin/stdout -y
+
+deeptrade plugin list                     # 查看已安装
+
+# 运行打板策略（CLI 由插件自管，--help 由插件渲染）
+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/reports/<run_id>/`。
+
+## 📦 命令矩阵
+
+### 框架命令（封闭集合）
+
+| 命令 | 用途 |
+|---|---|
+| `deeptrade --version` / `-V` | 显示版本 |
+| `deeptrade --help` / `-h` | 框架命令清单（**不**枚举插件子命令） |
+| `deeptrade init [--no-prompts]` | 建库 + 应用 core migrations |
+| `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 uninstall <id> [--purge]` | 卸载（`--purge` 才 DROP 表） |
+| `deeptrade plugin upgrade <path>` | 升级（增量 migrations） |
+| `deeptrade data sync ...` | （暂停用，下版本恢复） |
+
+保留字（不可作为 plugin_id）：`init / config / plugin / data`。
+
+### 插件命令（按 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 <你的-plugin-id> ...` | 你自己写的任何插件 |
+
+任意插件子命令的 `--help` 都由插件自身渲染——框架不感知动词语义。
+
+## 🧱 架构
+
+```
+┌──────────────────────── deeptrade CLI (custom click.Group) ────────────────────────┐
+│                                                                                    │
+│  framework commands (closed):                                                      │
+│      init │ config │ plugin │ data                                                 │
+│                                                                                    │
+│  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) │
+                                                  └────────────────────┘
+```
+
+设计决策见 [docs/plugin_cli_dispatch_evaluation.md](docs/plugin_cli_dispatch_evaluation.md)。
+
+## 📖 文档
+
+- [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) — 版本变更
+
+## ⚖️ 免责声明
+
+本工具仅用于策略研究、数据整理与候选标的分析，**不构成投资建议**，**不进行自动交易**。所有 LLM 输出基于提交的结构化数据，不引用任何外部信息源；用户应自行核验候选标的的最新状态后再做决策。

deeptrade_quant-0.0.2/deeptrade/__init__.py

@@ -0,0 +1,8 @@
+"""DeepTrade — LLM-driven A-share stock screening CLI."""
+
+from __future__ import annotations
+
+from deeptrade.core.notifier import notification_session, notify
+
+__version__ = "0.0.1"
+__all__ = ["__version__", "notification_session", "notify"]

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

@@ -0,0 +1,25 @@
+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: "20260429_001"
+    file: migrations/20260429_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.0.2/deeptrade/channels_builtin/stdout/migrations/20260429_001_init.sql

@@ -0,0 +1,13 @@
+-- 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.0.2/deeptrade/channels_builtin/stdout/stdout_channel/channel.py

@@ -0,0 +1,180 @@
+"""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