Python License PyPI

BossKey-Stock — 终端摸鱼盯盘工具

A股 · 在终端里偷看行情 · 按一下 b 秒变 Docker 编译日志

pip install bosskey-stock  |  bosskey

BossKey-Stock 是一个纯终端 A 股实时行情监控工具。不需要打开浏览器、不需要切窗口、不需要 API Key。bosskey 回车，你的终端就变成了红绿相间的行情看板；听到脚步声，按 b 键，它又变成了一个正经的 Docker 构建日志。

🐟 这个项目为什么存在？
作为一名程序员，我一天 8+ 小时在终端里。行情软件切来切去不仅麻烦，而且屏幕上一片红绿实在过于醒目。
我需要一个东西——安安静静地待在终端里，别人路过时看起来像是在认真看 build log，但实际上……它在盯盘。
这个就是 BossKey — 老板键，专门为摸鱼而生。

截图

BossKey-Stock demo

按 t 逐级展开持仓/成本、持仓收益、今日收益列与底部汇总；按 b 一键切换老板模式

Normal mode

正常模式 — 行情 + 持仓/成本 + 持仓收益（率）+ 今日收益（率），底部汇总总市值 / 总成本 / 总收益 / 今日收益

Boss mode

老板模式 — 按 b 后秒变 Docker build 日志

截图可用 python scripts/make_screenshots.py 重新生成（macOS，需 qlmanage）。

功能

功能 说明
📊 实时行情 Rich 表格渲染，红涨绿跌，整行着色
⏱ 智能刷新 交易时段（工作日 9:30-11:30 / 13:00-15:00）自动刷新，非交易时段停刷
🕶 老板模式 按 b 一键切换 Docker build 伪日志，再按 b 切回
⌨️ 零依赖终端控制 单线程，一次 tcsetattr，无后台线程
⚡ 键盘操作 r 手动刷新，t 切换持仓/收益列，q / Ctrl+C 退出
📝 监控列表管理 CLI 子命令 add / rm / list
💼 持仓与收益 pos add 交互式多选录入持仓，TUI 切换显示持仓、成本、持仓收益（率）、今日收益（率），底部同步汇总总市值/总收益
🕶️ 英文伪装 界面与 CLI 交互全英文，英文非母语一眼难读，继续强化「在工作」的伪装
🌐 离线检测 网络断开时黄色 [Offline] 提示，续网自动恢复

安装

从 PyPI（推荐）

pip install bosskey-stock

从源码

git clone https://github.com/shark/bosskey-stock.git
cd bosskey-stock
pip install -e .

安装后使用 bosskey 命令。

快速开始

# 启动盯盘
bosskey

# 添加股票到监控列表
bosskey add 601318 000858

# 移除股票
bosskey rm 000001

# 查看当前监控列表
bosskey list

# 交互式记录持仓：列出监控列表多选，逐个录入股数与成本价
bosskey pos add

# 移除持仓
bosskey pos rm 000001

# 查看全部持仓
bosskey pos list

终端内操作

按键 功能
b 老板模式切换（行情 ↔ Docker 日志）
r 手动刷新行情
t 循环切换显示模式：行情 → +持仓/成本 → +持仓收益（率） → +今日收益（率）；底部同步切换总市值/总成本、总收益（率）、今日收益（率）汇总
q / Ctrl+C 退出（终端完全恢复，无 traceback）

配置

配置文件 ~/.bosskey.toml 在首次运行时自动创建：

[display]
refresh_interval = 3

[watchlist]
codes = ["000001", "600519", "300750"]

[holdings]
# code = { shares = 持仓股数, cost = 成本价 }
600519 = { shares = 100, cost = 1500.50 }

持仓可用 bosskey pos add/rm/list 管理；pos add 交互式多选监控列表中的股票并逐个录入股数与成本价。

数据来源

本项目使用 Sina Finance 实时行情 API，这是一个免费、无需 API Key 的公开接口。

⚠️ 免责声明
Sina Finance API 是非官方的公开接口，无正式服务等级承诺。数据仅作个人参考，不构成投资建议。
如新浪调整接口策略导致工具不可用，请提交 Issue，我们会跟进适配。

与同类工具对比

BossKey-Stock 同花顺/东方财富 tushare
终端运行 ✅ ❌ ✅
老板模式 ✅ ❌ ❌
需 API Key ❌ ❌ ✅
需注册 ❌ ✅ ✅
安装大小 3 个依赖 几百 MB 中等

项目结构

bosskey-stock/
├── bosskey_stock/
│   ├── __init__.py        # 包标记
│   ├── __main__.py        # CLI 入口，子命令路由
│   ├── app.py             # 主循环：Rich Live + 非阻塞键盘输入
│   ├── data.py            # Sina 数据层，GBK 编码解析
│   ├── boss.py            # 老板模式（Docker build 伪日志）
│   └── config.py          # 配置读写
├── tests/
│   ├── test_data.py       # 数据解析测试
│   ├── test_config.py     # 配置管理测试
│   └── test_boss.py       # 老板模式测试
├── docs/
│   └── design.md          # 架构设计文档
├── pyproject.toml          # 打包与项目配置
├── LICENSE
├── README.md
└── CHANGELOG.md

为什么是 Python？

这是有意为之的。典型办公环境预装 Python，pip install bosskey-stock 就能用——不需要申请安装权限、不需要 IT 审批、不需要管理员权限。
一个纯文本的工具，在任何 SSH 会话、tmux 窗口、甚至远程服务器上都能跑。

贡献

见 CONTRIBUTING.md。

License

MIT License

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.2.1)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for angryshark708 from gravatar.com angryshark708

Credits

Author: bosskey-stock contributors

License expression

MIT
View SPDX License List

Requires

Python >=3.10

Provides Extra

dev

Tags

a-stock china-stock terminal tui boss-key 摸鱼

Classifiers

Report project as malware

Download files

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

Source Distribution

bosskey_stock-0.2.0.tar.gz (19.6 kB view details)

Uploaded Source

Built Distribution

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

bosskey_stock-0.2.0-py3-none-any.whl (15.1 kB view details)

Uploaded Python 3

File details

Details for the file bosskey_stock-0.2.0.tar.gz.

File metadata

  • Download URL: bosskey_stock-0.2.0.tar.gz
  • Upload date:
  • Size: 19.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for bosskey_stock-0.2.0.tar.gz
Algorithm Hash digest
SHA256 7476f8be4a48d2df7bde87f5d0eed94bd2a05f7ee0c5f1ae953cb75da4adbdf0
MD5 74214c82a9aadf1ba8b354720e48b53b
BLAKE2b-256 5efa5415419803b65d3846ebee97833d15b72aa057596d57d4e8138a7f8d38d5

See more details on using hashes here.

Provenance

The following attestation bundles were made for bosskey_stock-0.2.0.tar.gz:

Publisher: publish.yml on Angryshark128/bosskey-stock

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file bosskey_stock-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: bosskey_stock-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 15.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for bosskey_stock-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 03711f0160ffc39e8fcf03f757cc1bb119186b96c0ee53d7f0a66fa0684d1717
MD5 867c0427a2d571e6e99755a931432fa7
BLAKE2b-256 26ded0cdf04efc7b4026fb1333a96a76c5e575fad57149be5086f73a4ab5d0d6

See more details on using hashes here.

Provenance

The following attestation bundles were made for bosskey_stock-0.2.0-py3-none-any.whl:

Publisher: publish.yml on Angryshark128/bosskey-stock

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

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