前言¶
在 DSH 里问股票相关问题，模型若只靠训练数据回答，价格、涨跌、财务口径很容易过时或失真。常见做法是自己在对话外查行情站、写脚本调 API，再把结果贴回对话；或者单独配 MCP 服务器、维护 JSON 配置。ashareapi 官方提供的 ashareapi-dsh-plugin 走另一条路：把 ashareapi.com 的 MCP 服务挂进 DSH，Agent 在对话中通过工具拉取实时或结构化 A 股数据。下面介绍它是什么、能做什么，以及桌面端、Web UI 和命令行怎么装、怎么用。
这是什么¶
ashareapi-dsh-plugin 是 A 股数据 API 的 DeepSeek Harness 插件，维护者为 ashareapi。插件本身不含行情计算或多源逻辑，只负责把远端 MCP 端点注册到 DSH；传输、工具注册、断线重连由 DSH 自带的 MCP 客户端处理。底层默认连接 https://api.ashareapi.com/mcp。
装上之后，例如在 DSH 里问「600667 现在多少钱」，Agent 会调用对应工具返回真实数据，而不是编造数字。npm 包版本为 0.1.3，许可证 MIT，运行要求 Node.js ≥ 20、dsh ≥ 0.2.0-rc.2。
核心功能¶
插件共暴露 31 个 A 股相关工具（在 DSH 中名称形如 mcp__ashareapi__ashare_quote）。能力覆盖行情、K 线、分时、五档盘口、财务、资金流、龙虎榜、板块、因子选股、宏观、可转债、量化回测等，与 README 中的工具列表一致。
无需 API Key 即可使用的 5 个工具：
ashare_quote：实时快照ashare_kline：K 线（固定前复权，无adjust参数）ashare_hot：热搜榜ashare_changedist：涨跌分布ashare_market_overview：市场总览
其余 26 个工具（如 ashare_orderbook、ashare_finance、ashare_backtest 等）需要在 ashareapi 定价页 获取 Key 后配置。
README 还说明了若干服务端行为（由 ashareapi 后端承担，非插件本地实现）：多数据源互为备份、K 线口径固定、停牌等「市场无数据」与取数失败区分返回、工具描述面向 Agent 编写。插件仓库仅含 index.js 与配置，零运行时依赖。
安装与启用¶
桌面端 / Web UI（推荐）¶
- 从 DeepSeek Harness 桌面端下载页 安装客户端（macOS / Windows）。
- 打开左侧「插件」页面，输入包名并安装：
ashareapi-dsh-plugin
Web UI（dsh web）使用同一「插件」页面，操作相同。README 注明：桌面端 profile 由桌面应用管理，不能用下面命令行的 plugin add 装桌面端；桌面端请只用插件页面。
装完后重启或重新打开 DSH，即可在对话中使用。命令行与 Web UI 安装会调用本机 pnpm（DSH 不自带；桌面端自带一份）；未安装时可先执行 npm i -g pnpm。
命令行（Web profile）¶
启动 Web UI：
npx @deepseek-ai/dsh web
添加插件：
npx @deepseek-ai/dsh plugin --profile web add ashareapi-dsh-plugin
若已全局安装 dsh，可将 npx @deepseek-ai/dsh 替换为 dsh。装完后重启 dsh web 生效。启动前可检查配置是否挂上：
npx @deepseek-ai/dsh --profile web --dump-config
输出中应出现 # == ashareapi-dsh-plugin。
其他安装方式（命令行）：
# 从 GitHub
npx @deepseek-ai/dsh plugin --profile web add github:ashareapi/ashareapi-dsh-plugin
# 从本地目录（开发调试）
npx @deepseek-ai/dsh plugin --profile web add file:/绝对路径/ashareapi-dsh-plugin
卸载：
npx @deepseek-ai/dsh plugin --profile web remove ashareapi-dsh-plugin
配置 API Key（可选）¶
5 个免费工具不用配置即可调用。要用其余工具，在 ~/.dsh/.env（或 $DSH_HOME 对应目录）增加：
ASHAREAPI_KEY=ct-你的KEY
或在 profile 的 cordis.patch.yml 中按 id 覆盖（Web / 命令行为 ~/.dsh/profiles/web/cordis.patch.yml）：
- id: mcp-ashareapi
name: ashareapi-dsh-plugin
config:
apiKey: ct-你的KEY
可配置项还包括 url（默认 https://api.ashareapi.com/mcp）、serverName（默认 ashareapi）、headers 等；字段说明见仓库 README。
典型用法¶
装好后在对话里直接用自然语言提问，Agent 会选用对应工具。README 给出的对应关系示例：
| 你可以这样问 | 会用到的工具 |
|---|---|
| 600667 现在多少钱？ | ashare_quote |
| 帮我拉一下 600667 最近 60 天的日 K | ashare_kline |
| 今天市场什么情况？ | ashare_market_overview |
| 现在大家都在看什么股票？ | ashare_hot |
| 今天涨跌家数怎么分布？ | ashare_changedist |
参数、返回字段与样例见 ashareapi 文档 与 端点清单。
适用场景与注意¶
适合谁： 已在用 DeepSeek Harness（桌面端、Web UI 或 CLI）做研究、问答或自动化流程，希望在同一对话里查 A 股行情、K 线、市场概览或（配 Key 后）财务、板块、回测等数据的开发者与量化/投研使用者。
分类： 社区目录将其归为「联网工具」；目录站点 skillhub.cn 与 DeepSeek / 幻方无官方从属关系，DSH 生态本身是「一切皆插件」的扩展方式。
安全与权限： 插件以当前 dsh 进程权限 运行，会向配置的 MCP URL 发起网络请求；安装前建议查看 GitHub 源码 与 MIT 许可证，并妥善保管 ASHAREAPI_KEY，勿提交到公开仓库。
不用 DSH 时： 同一 MCP 服务也可在其他支持 MCP 的客户端中通过 URL 接入，说明见 ashareapi MCP 页。
结尾¶
ashareapi-dsh-plugin 把官方 A 股 MCP 以最小配置接入 DSH：包名安装、5 个免费工具免 Key、31 个工具覆盖从快照到量化回测的常见需求。需要进一步了解可访问插件目录页 skillhub.cn/plugins/ashareapi/ashareapi-dsh-plugin 与仓库 github.com/ashareapi/ashareapi-dsh-plugin。
