前言¶
在 DSH 的插件化体系里，常见痛点是：外部研究工具已经提供 MCP 能力，但要在 dsh Web 中直接使用，还需要一次接入和配置。dsh-plugin-xquant 解决的就是这个问题：把 xquant 的量化研究 MCP 接入 DeepSeek Harness，安装一次后，就能在 dsh Web 中查询因子、策略逻辑与历史数据。
下面介绍它的定位、核心能力、安装方式、典型用法，以及权限、计费和版本注意事项。
这是什么¶
dsh-plugin-xquant 是一个 DSH 插件，由 codingDuan 维护，许可证为 MIT。
它把 xquant 的量化研究 MCP 接入 DeepSeek Harness，让你可以在 dsh Web 中完成因子查询、策略逻辑浏览、历史数据查询，以及把工具结果整理成更易读的研究结论。
需要注意：这是一个研究工具，不提供具体买卖建议、个性化投资建议或市场预测。历史业绩不代表未来表现，投资有风险。
核心功能¶
插件提供的能力包括：
- 查询可用因子及其定义。
- 计算已支持标的和时间窗口的因子时序。
- 浏览策略逻辑、历史绩效与历史信号的权限内信息。
- 让“小量”风格的研究指引把工具结果解释成更易读的研究结论。
这些能力面向研究侧查询和解释，不等同于交易执行或投资建议。
安装与启用¶
安装前先确认 dsh 进程环境中有可用的 XQUANT_API_KEY。插件只从 dsh 进程环境读取该值，不写入配置文件、不上传、不打印该值。
下面先设置 Key，再添加插件，最后启动 dsh Web。
1. 设置 API Key¶
在准备运行 dsh 的终端中设置：
export XQUANT_API_KEY='xq_live_...'
这一步只是把 Key 放入当前 dsh 进程可读取的环境变量中。插件不会保存或打印它。
2. 添加插件¶
执行官方安装命令：
dsh plugin --profile web add dsh-plugin-xquant
这一步会把 dsh-plugin-xquant 添加到 dsh 的 web profile。
3. 启动 dsh Web¶
执行：
dsh web
经过上面的步骤，就可以在 dsh Web 中使用 xquant 的量化研究 MCP 能力。
插件默认连接：
https://xquant.shop/xquant-mcp/mcp
不要填写已迁移的：
/factor-mcp/
配置私有或 staging 环境¶
如果你要连接私有或 staging 环境，只需要覆盖服务 origin。插件会基于该 origin 使用 xquant MCP 路径，避免误连旧路径。
示例：
export XQUANT_MCP_ORIGIN='https://staging.xquant.shop'
export XQUANT_API_KEY='xq_live_...'
注意：XQUANT_MCP_ORIGIN 必须是没有 path、query 或 hash 的 HTTP(S) origin，例如：
https://mcp.example.com
它不是完整 MCP URL。
典型用法¶
启动：
dsh web
进入 dsh Web 后，可以用自然语言提出研究侧问题。例如：
动量因子通常怎样计算？先查 xquant 的因子定义，再用一个股票示例说明。
这个例子适合用来确认因子定义，并要求基于 xquant 返回内容做说明。
再例如：
帮我比较两个已公开策略的历史收益和回撤；不要给出买卖建议。
这个例子适合用于已公开策略的历史绩效比较，同时明确限制输出不包含买卖建议。
权限、计费与安全¶
插件的权限边界不在本地侧。xquant 服务端是权限和合规的唯一边界。
这意味着：
- 付费内容、近期调仓信号和管理员工具只会按当前账号权限返回。
- 非管理员不会因安装插件而获得管理员工具。
- 插件运行在 dsh 进程中，API Key 只从 dsh 进程环境读取。
- 插件不写入配置文件、不上传、不打印
XQUANT_API_KEY。
计费方面，插件不在本地计费。服务端只会按既有规则对成功的 compute_factor 调用记录用量。MCP 握手、工具枚举和失败调用不应扣除因子计算额度。
适用场景与注意¶
dsh-plugin-xquant 适合以下场景：
- 你已经在 xquant 侧有研究权限，并希望在 dsh Web 中查询因子和策略信息。
- 你需要在 DeepSeek Harness 的插件化工作流中接入 xquant MCP。
- 你希望把工具返回结果整理成研究说明，但不希望输出变成买卖建议或市场预测。
使用前建议注意：
- 插件会读取 dsh 进程环境中的
XQUANT_API_KEY。 - 实际可访问内容取决于 xquant 服务端对当前账号的权限。
- 安装前可以先检查源码与 MIT 许可证。
- 不要把输出当作具体买卖建议、个性化投资建议或市场预测。
- 历史业绩不代表未来表现，投资有风险。
版本与后续¶
DeepSeek Harness 仍处于 developer preview。
本包目前针对 dsh@0.1.0-rc.7 验证。升级 dsh 前，请运行完整冒烟测试并阅读 release notes。
结尾¶
dsh-plugin-xquant 的价值很具体：把 xquant 的量化研究 MCP 接入 DSH，让你在 dsh Web 中查询因子、策略逻辑与历史数据，并把工具结果整理成更容易阅读的研究结论。
仓库地址：
https://github.com/codingDuan/dsh-plugin-xquant
许可证：MIT。
