前言¶
DeepSeek Harness (DSH) 的核心理念是「一切皆插件」，允許模型編排複雜的工作流。量化因子研究通常涉及從數據探針、面板構建、因子計算（IC/5門）、回測到 Regime 檢測的繁瑣流程。dsh-quant-factor-pipeline 將這套工程紀律嚴格的研究流水線封裝爲模型可逐步調用的 MCP 工具。
核心功能¶
該插件提供一組工具，覆蓋因子研究的全鏈路：
- panel_probe：拉取 A 股日頻面板，彙報換手率覆蓋率，產出完整性
panel_hash。 - ic_gate：構建 CGO 處置效應因子，計算 RankIC vs 前瞻收益、Newey-West t 統計、R² 機械健康度。
- regime_check：對信號/收益序列做粗粒度 regime 狀態 + 相關性斷裂 / 正交性檢測。
- factor_backtest：純 Node 多空十分位回測近似（RankIC / ICIR / Sharpe / 換手 / 淨值曲線）。
- project_save / project_load：將研究項目 manifest 寫入 YAML，實現研究狀態的持久化。
安裝與運行¶
安裝該插件需手動執行打包與安裝步驟：
npm pack && cd ~/.dsh/profiles/web && npm install /path/to/dsh-quant-factor-pipeline-0.1.0.tgz --no-save --no-audit --no-fund
重啓 dsh web（端口 3080）後生效。
運行環境要求：
* 協議：NDJSON（JSON-RPC 2.0），每行一個 JSON 對象，以 \n 結束，容忍末尾 \r。不要使用 Content-Length 幀。
* 運行時：managed Node 22.22.2（絕對路徑，無需構建）。
* 依賴：零依賴，僅使用 Node 內置模塊（http/https、zlib、crypto、fs、path）。
數據源¶
插件依賴以下已驗證端點進行數據獲取：
* push2his.eastmoney.com/api/qt/stock/kline/get —— kline + 換手率
* datacenter-web.eastmoney.com/api/data/v1/get —— RPT_LICO_FN_CPD 財務數據
* qt.gtimg.cn —— 騰訊快照
以下端點爲禁區，調用會導致 403 或失效：
* emweb.securities（舊東方財富 emweb 站點）
* f10.eastmoney.com/zycwzbAjax
* web.ifzq.gtimg.cn（部分歷史端點）
環境變量¶
通過環境變量可配置數據目錄與日誌路徑：
QMT_DATADIR：QMT 仿真終端datadir路徑，設空則禁用 QMT 數據源層。AKSHARE_PYTHON：運行 akshare 橋接腳本的 Python 解釋器，默認爲python3。AKSHARE_HELPER：akshare 橋接.py腳本路徑。QUANT_MCP_LOG：側向日誌文件路徑，默認同目錄dsh-mcp-quant-factor-server.log。QUANT_PROJECTS_DIR：project_save/project_load持久化 manifest 目錄，默認爲用戶主目錄下.quant-pipeline/projects。
注意事項¶
- 版本鎖定：不要裸裝
@latest，請以本倉庫鎖定版本爲準。 - 邊界釐清：本倉庫首次發佈，與
dsh-quant-data-mcp的職責邊界需進一步釐清，避免重複數據源。
許可證¶
MIT — Copyright (c) 2026 helibeiqi
