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）。

功能

支持的品种

基金、债券与股票走同一套管理命令 —— 直接把代码填进来就行，不需要前缀、开关或额外配置；监控列表、分组、排序、持仓与收益计算全部通用。

场内基金按 3 位小数显示（价格与涨跌额一致），股票按 2 位；沪 5 段与深 18 段的存量封闭式基金同样按 3 位处理。场外基金按 4 位（净值本身就是 4 位小数，fu:110022 显示 2.8377）。港股尚未支持。

管理基金和管股票没有区别：

bosskey add 510300 159915 508000       # 加进监控列表（股票 / 基金 / 债券混着填）
bosskey add 180101 --group 场内         # 顺手归组（组名不存在会自动建）
bosskey add fu:110022                  # 场外基金：必须带 fu: 前缀（见下）
bosskey group add 场内 510300 159915    # 或往已有分组里追加
bosskey group list                     # 看分组内容
bosskey list -i                        # 交互式调整顺序 / 删除
bosskey pos add                        # 录入持仓（份数 + 成本价），收益与汇总自动算
bosskey                                # 启动盯盘，TUI 内按 t 切换列、g 切换分组

场外开放式基金（fu: 前缀）

场外净值型基金（在支付宝 / 天天基金按金额申购的开放式基金，不是 ETF / LOF 那类场内品种）用显式前缀 fu: 指定，例如 bosskey add fu:110022（易方达消费行业股票）。数据取自 Sina 的场外接口，只有净值、没有盘口：

• 显示当日估算净值（4 位小数）与估算涨跌幅；开 / 高 / 低 / 成交量 / 成交额这些场内字段没有，表格里显示 --。
• 净值是日频估值而非逐笔成交价，「实时」的含义与场内不同。
• 持仓按金额申购：份额是小数（1000 元 ÷ 2.8377 ≈ 352.4 份），pos add 收小数份额，TUI 与 pos list 照实显示（整数份额仍显示为整数，与原来一致）。
• 前缀只能手写：场外代码段与 A 股、场内代码大面积重叠（000001 既是平安银行又是华夏成长混合，110022 既是沪市可转债段又是易方达消费行业），程序不做自动判别，裸代码一律按场内段位规则解析。想加场外基金就得写 fu:。

⚠️ 不支持场外货币基金：这类基金接口不返回净值（fu:511990 返回空串），add fu:511990 会明确提示「查不到净值 —— 代码不存在，或为不支持的场外货币基金」。

同名代码与无行情代码

所有要填代码的管理命令（add / rm / group add / group add-codes / group rm-codes / pos rm）都会先探测这个代码在沪（sh）/ 深（sz）/ 京（bj）各交易所有没有行情，再决定怎么办（场外基金 fu: 不参与裸代码探测，只能显式写）：

• 只命中一个 → 直接用，静默完成（绝大多数代码）。
• 命中多个（同名代码）→ 不打断、不追问，直接用段位规则那条，并把另一条候选连同它的强制前缀打成一行提示：

  $ bosskey add 000001
  000001 = 平安银行（另有 上证指数 → sh:000001）
  Added: 000001
  

• 零命中 → 直接告诉你「查无行情」，不再静默跳过。
• 删除时命中多条（rm / group rm-codes / pos rm）→ 列出候选（带名称）让你选一条，或按 a 全删（删除要明确，这里仍然会问）。
• 离线 → 探测失败就回退段位规则照常加入，不阻塞。

想取另一条候选，自己写前缀即可，同样不追问：bosskey add sh:000001（上证指数）、bosskey add sz:510300（强制按深市解析）、bosskey add fu:110022（场外基金，见上）。bosskey add --help 里有同样的说明（帮助恒为中文）。

存成带显式前缀的键（如 sh:000001）时，list 与 TUI 里也照此显示 —— 这样两条同码能区分开；与段位规则一致时仍存裸代码，老配置不用改。

场内基金与股票不会撞车 —— 段位互斥（沪 5 段基金 vs 6 段股票，深 15/16/18 段基金 vs 00/30 段股票，10-13 段债券）。同名只发生在跨市场/跨命名空间：指数 vs 股票、场外基金 vs 场内代码。

会撞车的代码就那么一组：实测沪市 000001~000999 有 319 条上证系列指数（上证指数、A股指数、工业指数、沪深300…），深市同号段有 506 只主板股票，两边同时有行情的只有 204 个。也就是说需要那行提示的只有这 204 个代码，其余一律静默完成 —— 并且这件事跟基金无关，基金段位压根没参与。

安装

从 PyPI（推荐）

pip install bosskey-stock

从源码

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

安装后使用 bosskey 命令。

快速开始

# 启动盯盘
bosskey

# 添加代码到监控列表（股票 / ETF / LOF / REITs / 债券 / 回购 混着填都行）
bosskey add 601318 000858
bosskey add 510300 508000 113550

# 移除代码
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 切换）
colorize = false  # 红绿着色：false=单色（默认）/ true=彩色（TUI 内按 c 切换）

[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