deepseek-harness-quant README

The project's README from github.com/yuanwang589-dev/deepseek-harness-quant. As one markdown file: README.md.

DeepSeek HARNESS Quant

自然语言驱动的 A 股量化系统。低频。主观决策 + 写死引擎 + 数据裁决。

AI 不预测个股。这是硬约束,不是选项。

驱动层  语言模型        控制 · 挖因子 · 审计 · 牛散蒸馏
执行层  写死引擎        评分 · 回测 · 风控 · 扫描(确定性 Python,可复现)
事实层  数据系统        PIT · T+1 · 覆盖率分年核查(可证伪)

开始

新用户直接走 一键部署。接入 AI API 后,数据源、配置、验证全交给 AI 向导,不必读本页其余内容。

接入 DeepSeek API

接入 API 后,语言模型接管驱动层。控制、挖因子、审计、魔改,全部解锁。不接入,则只有写死引擎,没有 AI。

前提:完整包(zip)已内置 HARNESS 运行时;单文件(exe)不含 HARNESS,AI 控制台不可用。系统需 Node.js 18+(https://nodejs.org),无则 HARNESS 自动跳过、量化系统照常。

最快方式:双击 接入API.cmd,粘贴 Key,自动写入并验证。

# 1. 获取 Key
#    https://platform.deepseek.com/api_keys

# 2. 复制凭据模板,填入 Key(或直接用接入API.cmd)
copy harness\home\.credentials.yaml.example harness\home\.credentials.yaml
#    编辑 .credentials.yaml:
#    DEEPSEEK_API_KEY: sk-<your-key>

# 3. 启动(打印「启动 DeepSeek HARNESS」即集成成功)
python launcher.py
#    http://127.0.0.1:8787/control

接入后,直接对话:

其余数据源(Tushare 等)接入后让 AI 指导完成。核心逻辑:先接 AI 的 API,AI 帮你接剩下的。

架构

模块 职责
data/ 数据获取 + 本地缓存 + Point-in-Time(cache.py 唯一读取接口)
factors/ 因子引擎 + 机会扫描 + 远期池(五池 T+1/5/20/60 验证)
strategy/ 决策链(L0 择时 → L2 Pitch 审批 → T+1 执行)+ 组合构建
risk/ 风控七道(数据审计 / 因子健康 / FRC 排雷 / Beneish / 竞价 / 单因子 / L0 门控)
backtest/ 回测引擎(T+1 开盘 / 一字板过滤 / 成本模型 / 结论分级)
etf/ ETF 映射(策略暴露 → 可交易配置)
deck/ ui_v2/ Web 决策台(9 页,前端零硬编码)
harness/ DeepSeek HARNESS 运行时(AI 控制台 / 牛散桥 / 动态插件)
config/ 策略注册表 / ETF 池 / 阈值,全部配置化 + .example 模板

因子

123+ 因子,全部 A 股本地实证(PIT / T+1 / 分年度)。九步入池,17+ 项证伪留档。

维度 代表 实证
换手率 turn_mid_prox / turnover / turn_std20 turn_mid_prox ICIR 0.87
低波动 lowvol / std20 / downside_vol 防守底仓主力
反转 reversal20 / o2c 日内反转族 limup_ex_5 ICIR 1.24
流动性 amihud 0.43,多空夏普 1.12
彩票/偏度 max_ret20 / skew20 / rmax max_ret20 0.64
振幅/动量 amp20 / open_prem_20 open_prem_20 0.96
基本面低频 f_score / sue / accruals / asset_growth / bp f_score 120日 0.49
短线涨跌停 limit_up_* / consec_limit_down 跌停排雷 0.97
机构行为 lhb_jg_cnt_20 / shebao_chg lhb 0.90
行业层 ind_crowd_60 / ind_rs_20 拥挤 0.30
Alpha101 alpha015 / alpha050 / alpha006 / alpha003 / alpha044 alpha015 0.76

来源:学术复现 · 开源策略库复刻 · 事件驱动实证 · 牛散蒸馏 · AI 自动挖掘 · 机构资金行为。

Skill

12 个技能文件,封装方法论 + 资产 + 踩坑记录,AI 按需加载。

安装与运行

# 源码
pip install -r requirements.txt
python data/demo/build_demo_db.py    # 生成演示数据
python launcher.py                   # deck:8787 + HARNESS:3080

# 单文件
QuantDeck.exe                        # 双击即用,自动开浏览器

# 完整包
DSHQuant-v1.0.9-Release.zip          # 解压即用,含 HARNESS 运行时

下载注意:从 Release 页 Assets 区下载 DSHQuant-v1.0.9-Release.zip(完整包,含 HARNESS 运行时)。 不要下载页面底部的 "Source code (zip)" —— 那是源码包,harness/node_modules 被排除,没有 AI 控制台。 判断:解压后 harness\node_modules 文件夹存在 = 完整包;不存在 = 下错了。

运行要求:Python 3.10+(源码)/ 无(exe)。HARNESS 控制台需 Node.js 18+(可选)。

数据

数据由用户自行获取。系统不分发数据。

许可

MIT。仅供研究学习。不构成投资建议。

文档

资产盘点 · 架构说明 · 一键部署 · 快速开始 · HARNESS 接入 · 数据说明 · 分钟数据接入

更新机制:scripts/update.py(manifest 驱动,用户配置保护,应用前自动备份)。

deepseek-harness-quant (yuanwang589-dev/deepseek-harness-quant)

Searching Database…

Что это?Система торговых решений для квант-трейдинга с низкой частотой сделок и управлением на естественном языке для китайского рынка A-акций. Она сочетает субъективную цепочку решений Pitch, жёстко заданный факторный движок и строгий арбитраж на основе данных, при этом ИИ запрещено предсказывать движения отдельных акций.
ИИ сам выбирает акции и торгует или просто помогает?ИИ никогда напрямую не предсказывает отдельные акции — это жёсткое ограничение. Он ведёт майнинг факторов, аудит и общается с персонажами «легендарных трейдеров», но решения всё равно проходят цепочку от тайминга L0 через одобрение Pitch на L2 до исполнения T+1, прежде чем что-либо произойдёт.
Как его запустить?Новым пользователям стоит использовать развёртывание в один клик: возьмите DSHQuant-v1.0.9-Release.zip из Assets на странице Release (не авто-генерируемый «Source code (zip)»), затем дважды щёлкните 接入API.cmd и вставьте свой ключ DeepSeek API — после этого мастер на базе ИИ сам настроит для вас источники данных, конфигурацию и проверку.
Нужен ли ключ DeepSeek API для использования?Без ключа доступен только жёстко заданный движок, вообще без ИИ-функций. Подключение ключа DeepSeek API открывает управление, майнинг факторов, аудиты и настройку поведения на ходу. Запуск из исходников требует Python 3.10+; exe не требует ничего дополнительного; опциональной консоли HARNESS AI дополнительно нужен Node.js 18+.
Какой подводный камень при установке стоит учитывать?Не берите авто-генерируемый GitHub «Source code (zip)» — в нём отсутствует папка harness/node_modules, поэтому консоль ИИ не заработает. Нужен DSHQuant-v1.0.9-Release.zip из Release Assets, где упакован полный рантайм HARNESS.
Входят ли в комплект биржевые данные?Нет, система не содержит рыночных данных вовсе — вы добываете их сами (например, из Tushare); в репозитории только скрипты загрузки плюс синтетические демо-данные. Данных по оборачиваемости до 2019 года нет, поэтому выводы, основанные на оборачиваемости до 2019 года, недействительны.
Что покрывают 123+ факторов?Факторы охватывают оборот, низкую волатильность, разворот, ликвидность (Amihud), эффекты асимметрии и «лотереи», моментум, низкочастотные фундаментальные показатели (F-score, SUE, accruals), поведение у лимитов вверх/вниз, активность институционалов, переполненность отраслей и факторы в стиле Alpha101 — каждый протестирован локально на данных A-акций с контролем point-in-time и T+1.
Что за функция «легендарного трейдера» («牛散»)?Это набор из 7 ролей, выведенных из известных реальных китайских частных инвесторов, с которыми можно беседовать, получая идеи для выбора акций; любое возникшее решение автоматически уходит в конвейер форвард-валидации пяти пулов, а не исполняется напрямую.
Можно менять поведение системы без перекомпиляции?Да — динамическая плагинная система Cordis позволяет ИИ патчить поведение рантайма на ходу через модуль harness без пересборки кодовой базы.
Для чего нужны 12 файлов Skill?Это предзагруженные методические файлы и ресурсы, которые ИИ подгружает по мере необходимости: workflows майнинга факторов, профили дистилляции «легендарных трейдеров» и знания по обслуживанию системы.
Size
1.7 MB
Stars
253
Age
2mo
Commits · 90 Days