stock-up 0.1.0__tar.gz

stock_up-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,31 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e '.[dev]'
+
+      - name: Run tests
+        run: pytest -q

stock_up-0.1.0/.gitignore

@@ -0,0 +1,11 @@
+__pycache__/
+.pytest_cache/
+.coverage
+htmlcov/
+*.pyc
+.venv/
+.env
+.DS_Store
+*.db
+reports/
+.stock-up/

stock_up-0.1.0/IMPLEMENTATION_PLAN.md

@@ -0,0 +1,54 @@
+# stock-up 实施计划
+
+## 原则
+
+- 测试先行。
+- 先做离线可测核心，再接真实数据源。
+- 策略层不依赖 AkShare / 腾讯接口。
+- CLI 只编排服务，不写业务细节。
+
+## 阶段 1：项目骨架与核心模型
+
+- 初始化 Python 包。
+- 配置 pytest。
+- 定义 Quote / DailyBar / WatchItem / Holding 等模型。
+- 实现配置加载和默认配置。
+- 实现 SQLite 初始化。
+
+## 阶段 2：策略纯函数
+
+- Fibonacci 计算。
+- RSI 计算与金叉/死叉判断。
+- 观察池信号。
+- wolf_swing / hai_long / both 持仓规则。
+- 提醒去重。
+
+## 阶段 3：数据库仓储
+
+- watchlist CRUD。
+- holdings CRUD。
+- trades 交易记录。
+- alerts 提醒记录。
+- quotes_daily 缓存。
+
+## 阶段 4：CLI 命令
+
+- init
+- watch add/list/abandoned/check/set
+- hold add/list/check/set/add-buy/close
+- scan limit-up
+- daily
+- tick
+
+## 阶段 5：数据源适配
+
+- MarketDataProvider 接口。
+- MockProvider 用于测试。
+- TencentProvider 实时行情。
+- AkShareProvider 涨停池、日 K、交易日历。
+
+## 阶段 6：集成测试与真实数据 smoke test
+
+- CLI runner 测试。
+- 用 mock 数据测试 daily / tick。
+- 可选真实数据 smoke test，不作为 CI 必跑。

stock_up-0.1.0/PKG-INFO

@@ -0,0 +1,264 @@
+Metadata-Version: 2.4
+Name: stock-up
+Version: 0.1.0
+Summary: CLI stock strategy assistant
+Project-URL: Homepage, https://github.com/Guitenbay/stock-up
+Project-URL: Repository, https://github.com/Guitenbay/stock-up
+Project-URL: Issues, https://github.com/Guitenbay/stock-up/issues
+Author: Guitenbay
+License: MIT
+Keywords: a-share,cli,rsi,stock,trading
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Requires-Python: >=3.10
+Requires-Dist: pydantic>=2
+Requires-Dist: pyyaml>=6
+Requires-Dist: requests>=2
+Requires-Dist: rich>=13
+Requires-Dist: typer>=0.12
+Provides-Extra: akshare
+Requires-Dist: akshare; extra == 'akshare'
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=5; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# stock-up
+
+[![CI](https://github.com/Guitenbay/stock-up/actions/workflows/ci.yml/badge.svg)](https://github.com/Guitenbay/stock-up/actions/workflows/ci.yml)
+[![PyPI version](https://img.shields.io/pypi/v/stock-up.svg)](https://pypi.org/project/stock-up/)
+[![Python versions](https://img.shields.io/pypi/pyversions/stock-up.svg)](https://pypi.org/project/stock-up/)
+
+命令行版个人股票策略执行助手。
+
+## 安装
+
+从 PyPI 安装：
+
+```bash
+python3 -m pip install stock-up
+```
+
+如果要使用 AkShare 备用数据源：
+
+```bash
+python3 -m pip install 'stock-up[akshare]'
+```
+
+验证安装：
+
+```bash
+stock-up --help
+```
+
+## 开发环境
+
+```bash
+git clone https://github.com/Guitenbay/stock-up.git
+cd stock-up
+python3 -m pip install -e '.[dev]'
+pytest -q
+```
+
+如果开发时要使用 AkShare：
+
+```bash
+python3 -m pip install -e '.[dev,akshare]'
+```
+
+## 初始化
+
+```bash
+stock-up init
+```
+
+默认创建：
+
+```text
+~/.stock-up/config.yaml
+~/.stock-up/data.db
+~/.stock-up/reports/
+```
+
+测试时可以指定目录：
+
+```bash
+stock-up init --home /tmp/stock-up-demo
+```
+
+## 观察池
+
+手动加入观察：
+
+```bash
+stock-up watch add 300308 --name 中际旭创 --high 130 --low 110 --now 120
+```
+
+查看观察池：
+
+```bash
+stock-up watch list
+```
+
+检查观察信号：
+
+```bash
+stock-up watch check
+```
+
+查看废弃观察：
+
+```bash
+stock-up watch abandoned
+```
+
+修正高低点：
+
+```bash
+stock-up watch set 300308 --high 135 --low 112
+```
+
+## 持仓
+
+添加持仓：
+
+```bash
+stock-up hold add 300308 --name 中际旭创 --cost 120 --qty 100 --rule wolf_swing
+```
+
+规则支持：
+
+```text
+wolf_swing = 狼大波段规则
+hai_long   = 海指导规则
+both       = 两套规则同时开启
+```
+
+加仓：
+
+```bash
+stock-up hold add-buy 300308 --price 125 --qty 100
+```
+
+检查持仓：
+
+```bash
+stock-up hold check
+```
+
+关闭持仓：
+
+```bash
+stock-up hold close 300308 --price 135 --reason 止盈
+```
+
+关闭后重新加入观察：
+
+```bash
+stock-up hold close 300308 --price 135 --reason 止盈 --watch
+```
+
+## 盘中 tick
+
+`stock-up` 不常驻。盘中由外部定时任务反复调用：
+
+```bash
+stock-up tick
+```
+
+默认使用腾讯实时行情。测试可用：
+
+```bash
+stock-up tick --provider mock
+```
+
+建议外部定时任务每 20 秒调用一次。
+
+## 数据源
+
+当前默认：
+
+```text
+实时行情：腾讯 qt.gtimg.cn
+自动加入观察：默认关闭
+日 K / RSI：StockAPI，失败再尝试其他源
+```
+
+热点板块龙头自动加入观察目前默认关闭，因为 StockAPI 龙头接口需要 token：
+
+```yaml
+auto_watch:
+  hot_leader_scan_enabled: false
+```
+
+StockAPI 无 token 时会按 5 天窗口分段请求，以满足免费接口限制。
+
+RSI 日 K 数据很宝贵，`daily` 更新 RSI 时遵循：
+
+```text
+先更新持仓池
+再更新观察池
+达到 max_updates_per_daily 后停止
+```
+
+配置项：
+
+```yaml
+technical:
+  rsi:
+    max_updates_per_daily: 50
+```
+
+## 涨停扫描
+
+```bash
+stock-up scan limit-up
+```
+
+默认使用 AkShare。测试可用：
+
+```bash
+stock-up scan limit-up --provider mock --date 2026-05-31
+```
+
+初始低点模式：
+
+```bash
+stock-up scan limit-up --low-mode same_day
+stock-up scan limit-up --low-mode recent_1d
+```
+
+## 每日报告
+
+```bash
+stock-up daily
+```
+
+测试：
+
+```bash
+stock-up daily --provider mock --date 2026-05-31
+```
+
+报告输出到：
+
+```text
+~/.stock-up/reports/YYYY-MM-DD.md
+```
+
+## 测试
+
+```bash
+pytest -q
+```
+
+## 免责声明
+
+本工具仅用于个人复盘和策略辅助，不构成投资建议。

stock_up-0.1.0/README.md

@@ -0,0 +1,232 @@
+# stock-up
+
+[![CI](https://github.com/Guitenbay/stock-up/actions/workflows/ci.yml/badge.svg)](https://github.com/Guitenbay/stock-up/actions/workflows/ci.yml)
+[![PyPI version](https://img.shields.io/pypi/v/stock-up.svg)](https://pypi.org/project/stock-up/)
+[![Python versions](https://img.shields.io/pypi/pyversions/stock-up.svg)](https://pypi.org/project/stock-up/)
+
+命令行版个人股票策略执行助手。
+
+## 安装
+
+从 PyPI 安装：
+
+```bash
+python3 -m pip install stock-up
+```
+
+如果要使用 AkShare 备用数据源：
+
+```bash
+python3 -m pip install 'stock-up[akshare]'
+```
+
+验证安装：
+
+```bash
+stock-up --help
+```
+
+## 开发环境
+
+```bash
+git clone https://github.com/Guitenbay/stock-up.git
+cd stock-up
+python3 -m pip install -e '.[dev]'
+pytest -q
+```
+
+如果开发时要使用 AkShare：
+
+```bash
+python3 -m pip install -e '.[dev,akshare]'
+```
+
+## 初始化
+
+```bash
+stock-up init
+```
+
+默认创建：
+
+```text
+~/.stock-up/config.yaml
+~/.stock-up/data.db
+~/.stock-up/reports/
+```
+
+测试时可以指定目录：
+
+```bash
+stock-up init --home /tmp/stock-up-demo
+```
+
+## 观察池
+
+手动加入观察：
+
+```bash
+stock-up watch add 300308 --name 中际旭创 --high 130 --low 110 --now 120
+```
+
+查看观察池：
+
+```bash
+stock-up watch list
+```
+
+检查观察信号：
+
+```bash
+stock-up watch check
+```
+
+查看废弃观察：
+
+```bash
+stock-up watch abandoned
+```
+
+修正高低点：
+
+```bash
+stock-up watch set 300308 --high 135 --low 112
+```
+
+## 持仓
+
+添加持仓：
+
+```bash
+stock-up hold add 300308 --name 中际旭创 --cost 120 --qty 100 --rule wolf_swing
+```
+
+规则支持：
+
+```text
+wolf_swing = 狼大波段规则
+hai_long   = 海指导规则
+both       = 两套规则同时开启
+```
+
+加仓：
+
+```bash
+stock-up hold add-buy 300308 --price 125 --qty 100
+```
+
+检查持仓：
+
+```bash
+stock-up hold check
+```
+
+关闭持仓：
+
+```bash
+stock-up hold close 300308 --price 135 --reason 止盈
+```
+
+关闭后重新加入观察：
+
+```bash
+stock-up hold close 300308 --price 135 --reason 止盈 --watch
+```
+
+## 盘中 tick
+
+`stock-up` 不常驻。盘中由外部定时任务反复调用：
+
+```bash
+stock-up tick
+```
+
+默认使用腾讯实时行情。测试可用：
+
+```bash
+stock-up tick --provider mock
+```
+
+建议外部定时任务每 20 秒调用一次。
+
+## 数据源
+
+当前默认：
+
+```text
+实时行情：腾讯 qt.gtimg.cn
+自动加入观察：默认关闭
+日 K / RSI：StockAPI，失败再尝试其他源
+```
+
+热点板块龙头自动加入观察目前默认关闭，因为 StockAPI 龙头接口需要 token：
+
+```yaml
+auto_watch:
+  hot_leader_scan_enabled: false
+```
+
+StockAPI 无 token 时会按 5 天窗口分段请求，以满足免费接口限制。
+
+RSI 日 K 数据很宝贵，`daily` 更新 RSI 时遵循：
+
+```text
+先更新持仓池
+再更新观察池
+达到 max_updates_per_daily 后停止
+```
+
+配置项：
+
+```yaml
+technical:
+  rsi:
+    max_updates_per_daily: 50
+```
+
+## 涨停扫描
+
+```bash
+stock-up scan limit-up
+```
+
+默认使用 AkShare。测试可用：
+
+```bash
+stock-up scan limit-up --provider mock --date 2026-05-31
+```
+
+初始低点模式：
+
+```bash
+stock-up scan limit-up --low-mode same_day
+stock-up scan limit-up --low-mode recent_1d
+```
+
+## 每日报告
+
+```bash
+stock-up daily
+```
+
+测试：
+
+```bash
+stock-up daily --provider mock --date 2026-05-31
+```
+
+报告输出到：
+
+```text
+~/.stock-up/reports/YYYY-MM-DD.md
+```
+
+## 测试
+
+```bash
+pytest -q
+```
+
+## 免责声明
+
+本工具仅用于个人复盘和策略辅助，不构成投资建议。