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

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

pip install bosskey-stock  |  bosskey

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

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

截图

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

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

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

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

功能

安装

从 PyPI（推荐）

pip install bosskey-stock

从源码

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

安装后使用 bosskey 命令。

快速开始

# 启动盯盘
bosskey

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

# 移除股票
bosskey rm 000001

# 查看当前监控列表
bosskey list

# 交互式调整监控列表顺序并删除（展示代码+中文名，↑/↓ 移动游标，空格拿起/放下，d 标记删除，s 保存，q 退出）
bosskey list -i

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

# 移除持仓
bosskey pos rm 000001

# 查看全部持仓
bosskey pos list

# 指定语言运行（可选：默认取配置 display.lang，未设置时英文）
bosskey --lang zh run
bosskey --lang zh list

终端内操作

配置

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

[display]
refresh_interval = 3
lang = "en"  # 界面语言：en / zh（TUI 内按 l 切换）

[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/
├── bosskey_stock/
│   ├── __init__.py        # 包标记
│   ├── __main__.py        # CLI 入口，子命令路由
│   ├── app.py             # 主循环：Rich Live + 非阻塞键盘输入
│   ├── data.py            # Sina 数据层，GBK 编码解析
│   ├── boss.py            # 老板模式（Docker build 伪日志）
│   ├── config.py          # 配置读写
│   └── i18n.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。

致谢

感谢以下代码贡献者与 issue 提出者：

	贡献
	@mcxue — 代码贡献：单色模式（c 键切换）、list -i 交互式排序/删除、ETF 与北交所（4/8/92 开头）代码支持（PR #3）
	@vhmlee-dev — 提出 ETF 支持需求（Issue #4）

License

MIT License