DeepSeek Harness 插件：dsh-quant-factor-pipeline（量化因子研究流水线）

前言¶

DeepSeek Harness (DSH) 的核心理念是「一切皆插件」，允许模型编排复杂的工作流。量化因子研究通常涉及从数据探针、面板构建、因子计算（IC/5门）、回测到 Regime 检测的繁琐流程。dsh-quant-factor-pipeline 将这套工程纪律严格的研究流水线封装为模型可逐步调用的 MCP 工具。

核心功能¶

该插件提供一组工具，覆盖因子研究的全链路：

1. panel_probe：拉取 A 股日频面板，汇报换手率覆盖率，产出完整性 panel_hash。
2. ic_gate：构建 CGO 处置效应因子，计算 RankIC vs 前瞻收益、Newey-West t 统计、R² 机械健康度。
3. regime_check：对信号/收益序列做粗粒度 regime 状态 + 相关性断裂 / 正交性检测。
4. factor_backtest：纯 Node 多空十分位回测近似（RankIC / ICIR / Sharpe / 换手 / 净值曲线）。
5. 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