weopenfire-git/dsh-market-quote

README 摘要

dsh-market-quote DeepSeek Harness 行情工具插件：为 Agent 注册 market quote / market kline 两个只读工具，用 一个数据源 覆盖 A股 / 港股 / 美股 的实时行情与历史日 / 周 / 月 K 线。 无需额外 API ：数据来自腾讯公开行情接口（免费、免 key、免注册）。 专为机器使用 ：只返回结构化 OHLCV 数据，依赖 DSH 通用工具卡片渲染，不附带冗余的图形界面。 使用说明（含截图与实测示例）：docs/USAGE.md ｜ 设计记录：docs/design.md 简体中文 · English 核心亮点 - 两工具、三市场、单一源 ：实时报价 + 历史 K 线；A股 / 港股 / 美股统一裸代码入口（ 600000 / 00700 / AAPL ），前缀后缀自动补齐。 - 零凭证、零配置 ：腾讯公开行情接口，免 API key、免 Referer；Node ≥22.19 内置 fetch 与 GBK TextDecoder ，无第三方运行时依赖。 - 内置限流防封 ：全局限速 ≤2 QPS（两次请求间隔 ≥500ms）+ 同 key 单飞 + 报价 5s / K 线 5min 缓存，把并发突发摊平为低频串行请求，避免「一次性要太多」触发上游封禁 / IP 封锁；均可配置。 - 安全重试 ：只对临时错误（5xx / 网络失败 / 超时）做指数退避重试（1s→2s→4s + 全抖动，≤3 次）；4xx（含 429「停」信号）绝不重试；重试同样排队走全局限速，不放大 QPS。 - 超大区间发出前确认 ： day 区间超过 640 根（会分页、等待变长）时，先询问用户是否继续；无 UI / headless 时自动放行。 - 只读、并发安全、30s 超时 ：工具无副作用，可安全并发调用。 技术设计 - 单一数据源 + 字节级解码 ：实时接口 qt.gtimg.cn 返回 GBK 编码、 分隔的字段串，按字节解码（ TextDecoder('gbk') ）而非按 UTF-8 字符串；只读稳定核心字段（[0..53]），容忍上游字段变体与未知尾部，解析不因尾字段变化而崩。 - K 线分页游标 ：腾讯单请求上限 640 根，且对区间查询返回「最新 640 根」。 day 周期因此 向后翻页 （每页最旧一根的前一日作为下一页终点），最后反转成最旧在前； week / month 640 根 ≈ 12 / 53 年，单请求覆盖；总返回量硬上限 2000 根。 - 美股历史自动补交易所后缀 ：腾讯美股历史要求 usAAPL.OQ 之类带后缀的代码，插件先从实时报价解析出权威代码再喂给 K 线接口，用户只传裸代码 AAPL 。 - 限流防封（三层，下探到每个 HTTP 请求） ：进程内 TTL 缓存（…

分类