核心用法
stock-query 是一款面向个人投资者的实时行情查询工具，支持三大市场（A股、港股、美股）及ETF、场外基金、指数的即时报价与历史数据获取。用户可通过简单指令完成单标的多标的批量查询，或查看近30日（可自定义）日K/周K/月K线及均线数据。
自选股管理功能允许用户维护本地 portfolio.csv 文件，记录持仓数量与成本价，系统自动计算市值、浮动盈亏及盈亏比率，输出横向宽表便于快速掌握资产状况。文件优先存放于 ~/.config/stock-query/，兼容多平台安装路径，无需环境变量配置。
显著优点
1. 多市场统一接口：单条命令同时查询A股（6位数字）、港股（自动补零）、美股（英文ticker），无需切换工具或记忆不同平台的代码规则。
2. 零配置开箱即用：依赖仅为基础Shell工具（curl、awk等）与Python3格式化层，无需申请API密钥或绑定券商账户。
3. 本地化自选股管理：CSV格式透明可编辑，数据完全本地存储，不涉及账户密码或资金密码，隐私风险极低。
4. 符合市场习惯的视觉反馈：A股/港股采用红涨绿跌配色，美股采用绿涨红跌，自动适配用户认知习惯。
5. 历史数据即时获取：通过东方财富、腾讯财经等公开接口实时拉取K线，支持前后复权切换与区间统计。
潜在缺点与局限性
- 数据源依赖公开接口：未对接交易所Level-2行情，数据延迟约1-15分钟，不适用于高频交易或T+0决策。
- 功能边界明确：不支持加密货币、期货、期权、外汇及融资融券标的查询，跨市场衍生品覆盖有限。
- 离线不可用：所有行情数据均需网络实时获取，无本地缓存机制，断网或接口限流时无法使用。
- 自选股无加密存储：
portfolio.csv以明文CSV存放，若设备被入侵可能泄露持仓结构与成本信息（虽不涉资金）。 - QDII基金净值延迟：场外基金净值T+2至T+7公布，查询结果为估值而非实际净值，存在偏差风险。
适合人群
- 个人投资者：需要快速查看多市场持仓盈亏、监控自选股行情的散户用户。
- 定投/长期持有者：对实时性要求不高，关注日/周级别趋势与成本管理的价值投资者。
- 轻量化工具偏好者：不愿安装庞大交易软件，偏好命令行或简洁交互的进阶用户。
常规风险
- 数据准确性风险：公开接口偶有异常或延迟，重大行情波动时可能出现报价停滞，建议与券商软件交叉核对。
- 自选股文件误操作：手动编辑CSV时可能因格式错误（如逗号缺失、编码问题）导致解析失败，需按模板规范填写。
- 隐私泄露风险：虽无账户密码，但持仓成本与数量属于敏感财务信息，建议不在共享设备上留存该文件。
- 合规边界：仅限个人学习研究使用，不得用于自动化交易下单或向公众提供有偿行情服务。