股票行情监视器 - 简化模式 / 详情模式
=====================================

使用方法
--------
### Windows
1. 双击 watch.cmd，默认 15 秒刷新，简化模式
2. 或命令行运行：watch.cmd [刷新秒数] [参数]

### macOS / Linux
1. 打开终端，进入项目目录
2. 运行：./watch [刷新秒数] [参数]

常用命令
--------
  watch.cmd                    简化模式，15秒刷新（推荐）
  ./watch 5 --index on         macOS 下 5 秒刷新并显示指数方块
  watch.cmd 30                 简化模式，30秒刷新
  watch.cmd --once             取一次数据后退出
  watch.cmd --stealth off --index on
                               切换为详情模式：中文 + 指数方块

快捷键
------
  Esc          退出
  R            立即刷新一次行情（不影响自动刷新间隔）
  C            按涨跌幅排序（第一次高到低，第二次低到高，第三次恢复）
  V            按量比排序（第一次高到低，第二次低到高，第三次恢复）
  B / F9       切换为 npm 构建日志外观 / 正常行情
  S            切换简化模式（白色英文）/ 详情模式（中文）
  ↑ / ↓        移动光标
  →            进入盘口详情（五档买卖）
  ← / Esc      盘口页返回列表

盘口详情
--------
在自选股列表中将光标移到想看的股票上，按 → 进入盘口页：
- 显示买卖五档价格与挂单量（单位：手）
- 显示最新、现手、昨收、今开、最高、最低、涨停、跌停、换手、成交、量比
- 显示总市值、流通市值
- 按 R 立即刷新盘口
- 按 ↑ / ↓ 切换到上一只 / 下一只自选股盘口
- 按 ← 或 Esc 返回列表

参数说明
--------
  --index on|off     是否显示指数方块，默认 off
                     （简化模式会固定显示上证指数、深证成指）
  --stealth on|off   简化模式（白色文字、低调窗口标题），默认 on
  --hy on|off        启动时获取并缓存半年涨跌，默认 off
                     缓存会先展示，后台更新失败也不会空白
  --once             只取一次数据后退出

文件说明
--------
  watch.cmd            Windows 启动器（cmd 下运行）
  watch                跨平台统一入口（macOS / Linux / Git Bash）
  watch.sh             macOS / Linux 启动器（watch 的兼容备用）
  watch_quotes.ps1     主程序（PowerShell，Windows 完整功能版）
  watch_quotes.py      主程序（Python，macOS / Linux 版）
  quotes_core.py       Python 版核心库
  watchlist.json       自选股配置
  .secids_cache.json        股票代码缓存（删除后会重新搜索）
  .hy_pct_cache.json        半年涨跌幅缓存（删除后会重新获取）
  .market_total_cache.json  沪深京三市场成交额缓存（删除后会重新获取）

行情数据源与冗余
----------------
- 默认优先使用东方财富（searchapi / push2 / push2his）接口
- 当东财行情接口（push2.eastmoney.com）因 DNS、网络或临时屏蔽不可用时，
  会自动降级到新浪财经（hq.sinajs.cn）获取实时行情
- 新浪财经兜底目前支持：沪深 A 股、上证指数、深证成指、创业板指、科创 50
  （北证 50 暂无法通过新浪简版接口获取，会显示为空）
- 所有脚本在请求失败时均会自动重试 1 次，降低偶发网络抖动的影响

注意事项
--------
- 简化模式默认白色英文显示，窗口标题为 System
- 按 B 键或 F9 立即切换为 npm 构建日志外观，再按恢复
- 修改 watchlist.json 可增删股票和指数
- 首次运行如提示执行策略限制，请用 watch.cmd 启动
- 若长时间频繁刷新仍被屏蔽，可适当加大刷新间隔（如 watch.cmd 60）

macOS 特别说明
--------------
- 首次运行若提示 SSL 证书验证失败，程序会自动降级为不验证证书继续访问，
  并打印一次警告。如需彻底解决，请运行 Python 安装目录下的
  "Install Certificates.command"。
- 在 macOS 终端中，./watch 与 ./watch.sh 等价，推荐使用 ./watch。
- 快捷键、字段、显示方式已与 Windows 版对齐：
  * 默认 15 秒刷新、简化模式
  * S 键切换简化/详情模式
  * B / F9 切换 npm 构建日志外观
  * → 进入盘口详情，← / Esc 返回
  * 详情模式列表含：代码、名称、涨跌幅、涨跌额、最新、昨收、今开、
    最高、最低、量比、换手%、成交额、半年涨跌
  * 盘口详情字段与顺序与 Windows 版一致
- 键盘输入使用 macOS 的 termios 原始模式（raw）：方向键 / 功能键 / Esc 可被
  正确识别，不会回显成 ^[[A、^[[B 之类的转义序列；退出时自动恢复终端模式，
  且保留输出换行回车的正常处理，避免整屏阶梯状错位。
- 因操作系统本身差异，macOS 版与 Windows 版仍有以下区别：
  * 无鼠标点击按钮功能：macOS Python 无法调用 Windows Console API，
    因此底部按键栏仅作提示，不支持鼠标点击。
  * 无局部增量重绘：Windows 版在盘口页只重写变化的行以减少闪烁；
    macOS 版每次自动刷新整体清屏重绘，观感上可能略有闪烁。
  * 终端标题依赖 ANSI 转义序列：若使用的终端（如部分精简版 ssh 客户端）
    不支持 OSC 标题序列，标题切换将不生效。
  * 颜色表现依赖终端：简化模式为白色文字，详情模式为白色文字 + 隔行黑/深灰
    背景；盘口详情标题的涨跌方向用红/绿（▲▼）标示。以上颜色均由 ANSI
    颜色码实现，不同终端配色方案下观感会有差异。