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

收盘后执行一次,生成 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.1.tar.gz (37.7 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.1-py3-none-any.whl (31.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: stock_up-0.1.1.tar.gz
  • Upload date:
  • Size: 37.7 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.1.tar.gz
Algorithm Hash digest
SHA256 ae5fd88e667ecd65c7663e9dce2709acd18714c875fff860d3c8def418dab84d
MD5 cd0c0ae313bd99895cfcafd756226b10
BLAKE2b-256 8be88365aa42453b1351f266cef1ba1185c5de78bc515649b06a68b948c96442

See more details on using hashes here.

File details

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

File metadata

  • Download URL: stock_up-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 31.5 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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 6d048e43c9b041b4f6f1d3ef73ce23af44db6cb6828a352b109d6f48e7dda69f
MD5 48aeeb0b5121de44597a74ea9d97535b
BLAKE2b-256 a4680cbc0b0a586ccc8caef48725b56e46e836fff5003cd58c492b160320aa5d

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