前言¶
在 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。
