dsh-plugin-xquant
把 xquant 的量化研究 MCP 接入 DeepSeek Harness。安装一次，就能在 dsh Web 中查询因子、策略逻辑与历史数据。
研究工具，不提供具体买卖建议、个性化投资建议或市场预测。历史业绩不代表未来表现，投资有风险。
安装
1. 安装 dsh
npm install --global @deepseek-ai/dsh@0.1.0-rc.7
dsh --version
如果提示 dsh: command not found，执行下面两行后重开终端：
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc
exec zsh
2. 安装 xquant 插件
先在 xquant 开发者中心 创建 API Key，再执行：
export XQUANT_API_KEY='xq_live_...'
dsh plugin --profile web add dsh-plugin-xquant
启动 dsh Web：
dsh web
插件默认连接 https://xquant.shop/xquant-mcp/mcp。不要填写已迁移的 /factor-mcp/ 路径。
可做什么
- 查询可用因子及其定义；
- 计算已支持标的和时间窗口的因子时序；
- 浏览策略逻辑、历史绩效与历史信号的权限内信息；
- 让“小量”风格的研究指引把工具结果解释成更易读的研究结论。
示例问题：
动量因子通常怎样计算？先查 xquant 的因子定义，再用一个股票示例说明。
帮我比较两个已公开策略的历史收益和回撤；不要给出买卖建议。
配置私有或 staging 环境
仅需覆盖服务 origin；插件会固定补全 /xquant-mcp/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。
权限、计费与安全
- API Key 只从 dsh 进程环境读取；插件不写入配置文件、不上传、不打印该值。
- xquant 服务端是权限和合规的唯一边界。付费内容、近期调仓信号和管理员工具只会按当前账号权限返回；非管理员不会因安装插件而获得管理员工具。
- 插件不在本地计费。服务端只会按既有规则对成功的
compute_factor 调用记录用量；MCP 握手、工具枚举和失败调用不应扣除因子计算额度。
- 未设置
XQUANT_API_KEY 时，请访问 开发者中心 获取 Key 后重启 dsh。
开发
pnpm install
pnpm test
pnpm run typecheck
pnpm run build
DeepSeek Harness 仍处于 developer preview。本包目前针对 dsh@0.1.0-rc.7 验证；升级 dsh 前请运行完整冒烟测试并阅读 release notes。
License
MIT
