核心用法
stock-price-query 是一款轻量级实时股票行情查询技能，支持 A 股（沪深两市）、港股、美股 三大市场。用户可通过股票代码（如 600519、00700、NVDA）或常见中文名称触发查询，自动识别市场类型并返回结构化行情数据。
调用流程：解析用户输入 → 名称转代码（如有映射）→ 自动识别市场 → 执行 stock_query.py → 格式化输出。脚本输出 JSON 包含当前价、涨跌幅、开高低收、成交量、成交额及时间戳。
特色输出：采用紧凑文本格式（非表格），自动处理单位换算（成交额超亿显示"亿"）、涨跌箭头标识，适配 IM 聊天场景避免分页截断。
显著优点
- 零配置开箱即用：无需 API Key，无额外依赖，仅需 Python3 环境
- 多市场覆盖：同时支持 A 股（sh/sz）、港股（hk）、美股（us），满足跨境投资需求
- 输入容错智能：支持纯代码、带前缀代码、常见中文名称多种输入方式
- 安全加固：输入正则校验（
^[A-Za-z0-9]{1,10}$）+ 市场白名单，防范命令注入 - 异常处理完善：网络失败、非交易时段、API 限流均有明确降级策略
潜在缺点与局限性
- 数据源依赖：使用免费公开行情 API，数据延迟约 15 分钟至数秒不等，非交易所直连实时流
- 名称映射有限：仅内置 10 只常见股票名称映射，非标名称需用户手动提供代码
- 无历史数据：仅支持当前快照查询，无法获取 K 线、分时走势或财务数据
- 美股时区敏感：非美股交易时段可能返回 stale 数据，需用户自行判断时效性
- 无持仓管理：纯查询工具，不支持模拟交易、盈亏计算或自选股列表
适合人群
- casual 投资者：快速查持仓股价、关注自选股涨跌，无需专业终端
- 多市场交易者：同时关注 A 股、港股、美股，厌倦切换多个 App
- IM 场景用户：在飞书/钉钉/微信群聊中快速分享行情，追求信息密度
- 轻量化需求者：不愿注册证券账户 API、不想配置复杂金融数据接口
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 数据准确性 | 免费 API 可能存在延迟或异常值 | 关键交易决策请以券商 APP 为准 |
| 命令注入 | 虽经正则过滤，但仍属外部输入执行 | 已限制 alnum 字符，避免 shell 元字符 |
| API 可用性 | 第三方服务可能变更或限流 | 内置 1 秒重试机制，失败时明确提示 |
| 合规提示 | 非持牌金融信息服务 | 输出含免责声明，不构成投资建议 |