核心用法
stock-query 是一款面向投资者的多市场金融行情查询工具，支持 A 股（沪/深）、港股、美股三大市场，覆盖股票、ETF、场外基金、指数四类标的。用户可通过简洁的代码输入快速获取实时价格、涨跌幅、成交量等关键数据，支持批量查询与历史 K 线（日/周/月）检索。内置自选股管理功能，可记录持仓数量与成本价，自动计算浮盈亏与盈亏比率，输出直观的 Markdown 表格。
显著优点
多源数据整合：同时对接腾讯财经、新浪财经、东方财富、雅虎财经等七大权威数据源，自动切换保障数据可用性；跨市场统一体验：A 股/港股采用中国红涨绿跌惯例，美股遵循国际绿涨红跌标准，emoji 直观区分；零配置自选股：仅需维护单个 CSV 文件（~/.config/stock-query/portfolio.csv），无需 API 密钥或账户绑定；轻量依赖：仅需 curl、iconv、python3，macOS/Linux 开箱即用；静默执行设计：无过程日志输出，直接呈现格式化结果，适合快速决策场景。
潜在缺点与局限性
平台受限：仅支持 macOS/Linux，Windows 用户需借助 WSL；无实时推送：依赖主动查询，不具备行情预警或自动刷新功能；数据源风险：免费接口存在频率限制或临时调整可能，极端行情下数据延迟；无交易功能：纯查询工具，不支持下单、撤单等交易操作；CSV 安全风险：虽文档明确禁止，但用户仍可能在 portfolio.csv 中误存敏感信息。
适合人群
- 个人投资者：需要快速查看多市场持仓盈亏的散户
- 量化研究者：需要轻量 CLI 工具获取原始行情数据
- 终端用户：偏好命令行/聊天界面、反感臃肿金融 App 的效率人群
- 跨市场配置者：同时持有 A 股、港股、美股、QDII 基金的用户
常规风险
1. 数据准确性：免费行情接口可能存在分钟级延迟，不构成投资决策唯一依据
2. 汇率波动：港股、美股持仓市值按当地货币计价，未自动换算为人民币
3. CSV 文件安全：建议定期备份，避免在共享环境中暴露持仓信息
4. 网络依赖：完全依赖外部 API，断网或源站故障时无法使用
5. 合规边界：工具本身不提供投资建议，盈亏计算仅供参考，不构成财务顾问服务