Skip to main content

CLI stock strategy assistant

Project description

stock-up

CI PyPI version Python versions

命令行版个人股票策略执行助手。

AI agent / 编程助手请先阅读 AGENTS.md,里面有安装、使用、开发和提交约定。

安装

从 PyPI 安装:

python3 -m pip install stock-up

如果要使用 AkShare 备用数据源:

python3 -m pip install 'stock-up[akshare]'

验证安装:

stock-up --help

快速开始

普通使用只需要关注这几个命令:

1. 初始化

stock-up init

初始化本地配置、数据库和报告目录。

2. 添加持仓

stock-up hold add 300308 --name 中际旭创 --cost 120 --qty 100 --rule both

常用规则:

wolf_swing = 狼大波段规则,偏趋势持股
hai_long   = 海指导规则,偏长线仓/时间验证
both       = 两套规则同时开启

3. 盘中检查

stock-up tick

更新观察池和持仓池的实时行情,并检查是否有需要动作的信号。

stock-up 不常驻,建议用系统定时任务在交易时间内每 20 秒调用一次。

4. 每日复盘

stock-up daily

收盘后执行一次。默认使用 StockAPI,并自动扫描龙虎榜加入观察池,生成 Markdown 日报:

~/.stock-up/reports/YYYY-MM-DD.md

5. 检查持仓

stock-up hold check

手动查看当前持仓是否触发止损、止盈、RSI 死叉或增持观察。

6. 卖出后关闭持仓

stock-up hold close 300308 --price 135 --reason 止盈

如果卖出后还想继续观察:

stock-up hold close 300308 --price 135 --reason 止盈 --watch

开发环境

git clone https://github.com/Guitenbay/stock-up.git
cd stock-up
python3 -m pip install -e '.[dev]'
pytest -q

如果开发时要使用 AkShare:

python3 -m pip install -e '.[dev,akshare]'

配置文件

默认配置文件位置:

~/.stock-up/config.yaml

stock-up init 会自动创建默认配置、数据库和报告目录。完整参数说明见 命令说明

更多文档

免责声明

本工具仅用于个人复盘和策略辅助,不构成投资建议。

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

stock_up-0.1.2.tar.gz (38.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

stock_up-0.1.2-py3-none-any.whl (31.6 kB view details)

Uploaded Python 3

File details

Details for the file stock_up-0.1.2.tar.gz.

File metadata

  • Download URL: stock_up-0.1.2.tar.gz
  • Upload date:
  • Size: 38.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.9

File hashes

Hashes for stock_up-0.1.2.tar.gz
Algorithm Hash digest
SHA256 1854247d9d775190191835d998e0e85478b07a6e9fc41f269d4c81384e82941b
MD5 e6e2e82311e9d9e210890e6d7ac4d915
BLAKE2b-256 a2c19fbf903b6b916fbef2c49ec7f65e5036490061e719adb776a31e47690b15

See more details on using hashes here.

File details

Details for the file stock_up-0.1.2-py3-none-any.whl.

File metadata

  • Download URL: stock_up-0.1.2-py3-none-any.whl
  • Upload date:
  • Size: 31.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.9

File hashes

Hashes for stock_up-0.1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 92dd7903daf09d48f7f1f54fe3d41f2fb3e9a389ce246e5041b0a54c20b28822
MD5 904761c4c74a9516862a708b9d86e12b
BLAKE2b-256 1c4a952df9a1d75e954cf33741226e6500f7b6a8394654d502e568a17d3d521e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page