dsh-hhxg-market

dsh-hhxg-market

一句话定位：把恢恢量化（hhxg.top）的 A 股行情与量化数据 MCP server 桥接成 DeepSeek Harness 的原生工具，面向 Max 会员，只读研究用途。 In one line: an A-share market data MCP bridge for DeepSeek Harness (dsh) — 13 read-only research tools backed by the hhxg MCP server (https://hhxg.top/mcp/rpc), for Max members. 接入说明 / Docs：https://hhxg.top/developer.html#mcp（「AI 接入」页，签发 AI 接入 Token、MCP 与数据 API 的接法都在这里）

恢恢量化 hhxg.top A股量化数据插件 for DeepSeek Harness (dsh)。

把 A股日报快照、财经快讯、融资融券、市场情绪、题材热度、条件选股、盘中实时等量化数据变成 dsh Agent 的原生工具——问一句"今天市场情绪怎么样"，模型自己调工具拿真实数据回答。

13 个工具：日报快照、财经快讯、融资融券、投资者事件日历、市场情绪、题材热度、数据集目录、个股综合诊断、条件选股与量化策略预设（约 270 列，支持两个指标互相比较，返回全市场命中数）、连板晋级预测、异动历史、数据集查询、盘中实时行情与指标，填入 Max 会员的 AI 接入 Token（即 MCP Token）即用。

实测记录：我把选股条件直接「说」给 AI，它不但筛完全市场，还自己设计了 5 套策略（知乎，0.5.0 条件选股的 5 组对话 + 5 套策略逐套计数，含可筛字段分组与限制说明）。

安装

方式一：在 DSH 的插件安装入口输入 GitHub 地址（不用命令行）：

https://github.com/Niceck/dsh-hhxg-market

方式二：命令行，从 npm 安装（推荐，2026-11-01 起发布为 @hhxg/dsh-hhxg-market）：

dsh plugin --profile web add @hhxg/dsh-hhxg-market

国内网络下载慢：先执行 npm config set registry https://registry.npmmirror.com 切到 npmmirror 镜像再安装（dsh plugin 把参数转给 pnpm，pnpm 读这项设置；npmmirror 会自动同步新版本）。该设置全局生效，改回官方源用 npm config delete registry。国内连 GitHub 不稳定，优先用 npm 安装。

或直接从 GitHub 安装（备选，解析到仓库最新提交）：

dsh plugin --profile web add github:Niceck/dsh-hhxg-market

⚠️ 仍在用 0.6.x 及更早版本的请升级：0.7.0 之前有 7 个工具直调 hhxg.top 的公开端点（/api/snapshot /api/news /api/margin /api/calendar 等），这些端点 2026-11-08 起已下线（返回 404），旧版插件的这 7 个工具会报「数据不存在」；0.2.x 的 hhxg_strategy_signals / hhxg_stock_alerts 调用的服务端旧工具名已于 2026-10-27 下线。重新执行上面的安装命令即可升级到最新版（dsh plugin 把参数转给 pnpm，add 会重新解析到最新版本）。

工具一览

全部 13 个工具都经 hhxg MCP server（https://hhxg.top/mcp/rpc）取数，都需要 Max 会员的 AI 接入 Token；没有 Token 时工具仍会注册，调用返回开通指引（不发请求）。

工具	说明	取数通道
hhxg_snapshot	A股日报快照：情绪指数 / 涨停炸板 / 连板天梯 / 热门题材 / 行业资金 / 游资龙虎榜 / 焦点新闻	resources/read hhxg://kb/snapshot
hhxg_news	最新财经快讯（每小时滚动，含频道与来源），limit 1-50	tools/call search_documents（kind=news）
hhxg_margin	近 7 交易日融资融券余额走势 + 融资增减 TOP 个股	resources/read hhxg://kb/margin
hhxg_calendar	月度投资者事件日历（限售解禁 / 分红除权 / 新股申购与上市 / 可转债上市 / 股指期货、ETF 期权、富时 A50 交割 / LPR / 央行回笼 / 国债逆回购 / MSCI 审议等），按事件类型分组；month 为 YYYYMM，默认当月（北京时间）	resources/read hhxg://calendar/{yyyymm}
hhxg_sentiment	近 7 交易日市场情绪：涨停家数 / 最高连板 / 连板分布 / 热门行业与概念	resources/read hhxg://kb/sentiment
hhxg_themes	当日题材概念热度榜 TOP 30（游资参与 / 涨停数 / 涨停占比）	resources/read hhxg://kb/theme
hhxg_datasets	全部数据集目录（id / 分类 / 格式 / 更新频率 / 能否用 hhxg_query_dataset 查询；会员专属的全市场宽表标「筛选」，不提供下载），hhxg_query_dataset 的 id 发现入口	resources/read hhxg://datasets/index
hhxg_diagnose_stock	个股综合诊断：日/周/月技术指标、异动评级、两融趋势、龙虎榜、涨停、大宗、公告、概念	tools/call diagnose_stock
hhxg_strategy_signals	A 股条件选股 / 指标筛选 / 全市场命中计数（最新盘后快照，约 270 列，含题材概念、股票池、财务等基本信息；数据是上一交易日收盘的快照、不含今天盘中行情，交易时段按最新价筛选请用 hhxg_realtime view=screen，0.6.1 起交易时段调本工具时结果首行会提醒）：list_fields=true 列出全部可筛字段与类型；filters=[{field, op, value}]（最多 8 条，op gt/gte/lt/lte/eq/ne/in/contains/not_null）自定义筛选，如日线均线多头排列 {field:"日均线多头", op:"eq", value:1}；两个数值字段互相比写 {field, op, ref, scale}（field op ref × scale，op 只能 gt/gte/lt/lte），如站上 20 日线 {field:"收盘价", op:"gt", ref:"MA20"}；题材概念 / 股票池 / 持股标签 / 游资席位是多值列，只用 contains / not_null；结果首行给全市场命中数 total（limit 1-100 只控制每页行数，只问数量设 limit=1），sort / fields / cursor 翻页；strategy_id 可选用 9 个策略预设（涨停 / 放量突破 / 缩量整理 / 九转买入 / 九转卖出 / KDJ 超买 / KDJ 超卖 / 暴跌预警 / MACD 金叉），与 filters 取交集	tools/call screen_stocks
hhxg_predict_lianban	连板股次日晋级率预测（题材热度 / 行业热度 / 板高强度 3 因子）	tools/call predict_lianban_promotion
hhxg_stock_alerts	个股近 30 日异动历史（普通 / 临近严重 / 严重异动逐日记录）	tools/call query_dataset（dataset_id=stock_alerts_history）
hhxg_query_dataset	对数据集（JSON 与 300KB 以内的 CSV）做过滤 / 排序 / 截断查询（先用 hhxg_datasets 查合法 id 与是否可查）	tools/call query_dataset
hhxg_realtime	盘中实时（交易日约 1 分钟一帧，盘后为当日收盘帧）：view=market 涨跌家数 / 涨跌停与炸板 / 涨停池与连板晋级率；view=quotes 指定个股（最多 30 只）的最新价与日 / 周 / 月指标；view=screen 全市场条件筛选（最多 8 条、返回最多 100 行、无翻页；交易时段的选股优先用它）；view=fields 可用字段与示例；view=kline 指定个股（最多 5 只）的日 K 序列（已完成交易日 ≤260 根，codes × bars ≤ 1000，adj 前复权 / 不复权）+ 实时帧那天未走完的 K（live；comparable 只有 true 才可与历史拼接，false 疑似除权 / 基准不一致，null 无法判断——缓存滞后、个股停牌或日历不可用，原因见 live.reason，缓存状态见 history）。盘中 MA / BBI / MACD / KDJ 等指标按最新价把帧交易日当天当作未走完的 K 线计算（不是上一交易日收盘的指标，indicators.base_date 只是历史基准日，结果里有【口径】行写明）。结果文本首行标出帧的时效与交易日，并带 frame.status（盘中实时 / 午间休市 / 收盘帧 / 非实时·上一交易日 / 非实时·延迟，首行与桌面端卡片徽标同一套文案）；不是 live 就不是此刻的数据。分钟 K 不提供（快照差分还原不了区间高低）	tools/call get_realtime

数据每个交易日盘后约 20:00 更新（快讯每小时；盘中实时交易时段约 1 分钟一帧）；非交易日返回最近一个交易日。

解锁步骤：

1. 到 hhxg.top/vip.html 开通 Max 会员（月付 ¥99 / 年付 ¥999）；AI 接入 Token 只签给 Max
2. 到 hhxg.top/developer.html#mcp 生成 AI 接入 Token（有效期跟随会员到期；旧地址 account/mcp.html 会自动跳转过来）
3. 把 Token 写进你 profile 的 cordis.patch.yml（dsh 目前不渲染第三方插件的配置项，没有设置界面可填；保存后重启 dsh 生效）：

# ~/.dsh/profiles/<profile>/cordis.patch.yml
- update:
    - id: hhxg-market
      config:
        mcpToken: "<你的 AI 接入 Token>"

从终端启动 dsh 的话也可以不改文件：配置留空，设环境变量 HHXG_MCP_TOKEN=<你的 AI 接入 Token>（显式配置非空时以配置为准；GUI 启动的 dsh 不一定继承 shell 环境）。

未填 Token 时 13 个工具仍会注册为引导占位（调用返回开通指引，不发请求）。Token 对应的会员不是 Max（服务端返回 MAX_REQUIRED / API_ACCESS_REQUIRED）时，工具返回「需要 Max 会员的 AI 接入 Token」的说明并附升级页地址。

hhxg_strategy_signals 的 12 个策略标识里有 3 个（oversold_rebound / macd_death_cross / distribution）暂不能作为预设，调用会返回说明（PRESET_NOT_SUPPORTED）；前两个可以直接用 0.6.0 的两列比较 filters 写出来（工具说明里给了写法），distribution 需要分位数，写不出来。全市场指标全表（quant_signal_pool）自 2026-10-23 起为会员数据、不再提供下载地址；自定义条件直接用本工具的 filters。能写成 filters 的条件都应一次交给服务端筛完，不要翻页取回再让模型自己比（2026-11-03 实测：自己比 552 行漏了 5 只，标题总数还和表格对不上）。盘中 hhxg_realtime view=screen 没有派生列，但同样能用两列比较：多头排列 = MA5 gt ref=MA10、MA10 gt ref=MA20、MA20 gt ref=MA60 三条；两个字段须同为实时字段或同为盘后属性列。

版本对应：0.7.0 起 13 个工具全部经 hhxg MCP server 取数（原直调公开端点的 7 个工具改走 resources/read 与 search_documents，服务端公开端点 /api/snapshot /api/news /api/margin /api/calendar 已于 2026-11-08 下线）；0.3.0 起进阶工具只调用服务端正式工具（diagnose_stock / screen_stocks / predict_lianban_promotion / query_dataset，0.4.0 起加 get_realtime）。0.2.x 调用的 get_strategy_signals / get_stock_alerts_history 在服务端 0.3.0 起只是别名，已于 2026-10-27 下线（服务端 0.5.0），0.2.x 的这两个工具已失效，请升级。

零代码替代方案（Max 用户）

dsh 原生支持 MCP。不装本插件、或想要全部 8 个 MCP 工具 + resources + prompts，可直接把 hhxg MCP server 挂进 dsh 的 MCP 配置：

URL:    https://hhxg.top/mcp/rpc
Header: Authorization: Bearer <你的 AI 接入 Token>

本插件的价值是：工具输出针对模型阅读做了格式化（KB 信封 / 日历 / 数据集索引渲染成表格，盘后筛选结果首行给全市场命中数，盘中结果首行标出帧时效与日期），本地参数预检省掉必败的往返，业务性答复（无数据 / 需要 Max / 参数有误）不会被当成工具故障，以及桌面端 hhxg_realtime 的结果卡。

设计约定

• 只读（research-only）：本插件只提供行情与研究数据，不下单、不划转资金，也不存在任何交易执行接口。
• 凭证最小暴露：Token 仅用于请求的 Authorization 头，不写盘、不打日志（日志只记「来自配置 / 环境变量 / 未配置」）；错误信息经脱敏处理，不回显 Token。Token 本体只存在于你本机的 profile 配置或你自己设置的环境变量里（环境变量对同进程插件与继承环境的子进程可见，不是保险库）。
• 上游文本消毒：新闻标题、题材名、事件说明等第三方文本进入模型上下文前统一清洗（删不可见字符、压平控制字符、断开链接/图片语法），降低数据侧 prompt injection 风险。
• 免责声明：所有数据仅供研究参考，不构成投资建议。数据可能存在延迟或缺失，据此操作风险自负。

开发

npm ci                                           # 按 lockfile 安装开发/peer 依赖
npm test                                         # 全部测试（纯逻辑：fetch 全部打桩，不请求 hhxg.top）

纯 JavaScript（ESM），无构建步骤；lib/ 即源码。

License

MIT