dsh-market-quote

v0.6.1 · 0 天前发布

DSH tool plugin: realtime quotes and historical K-line for A-share / HK / US markets via Tencent's public quote API.

deepseek-harnessdshdsh-pluginmarketquoteklinestockfinance

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。

**超大区间发出

版本兼容矩阵

DSH 版本	状态	说明
`dsh@0.1.0-rc.6`	❓ 未知	metadata 缺失
`dsh@0.1.0`	❓ 未知	—
`dsh@0.2.0`	⚠️ 待验证	待实测（API 可能在变）
`dsh@0.3.0+`	❓ 未知	尚未发布

💡 兼容矩阵每周末自动跑实测，欢迎 PR 修正

元数据

License: MIT
npm: dsh-market-quote
Repo: —
Engines: {"node":"^22.19.0 || >=24.0.0"}
Weekly DL: 0
Monthly DL: 0
dsh.bundle: {}