ScottZt/jin-ce-zhi-suan

【金策智算】➡️不靠情绪买卖、不追小道消息，专注用客观数据辅助决策。我们仅提供本地化私有行情数据服务与历史回测工具，帮你把主观想法变成可验证的交易规则，用历史数据检验方法有效性，通过指标监控约束随意操作、控制回撤风险，让交易更有纪律、更落地。本产品为纯量化工具，不荐股、不指导买卖、不预测行情、不承诺收益，所有决策由用户自主判断，只为你提供客观的数据支撑与AI辅助。作者【硅基流码】

📈 金策智算 – 智能投研决策系统

一个基于 Python 的定量交易平台，将整个工作流（策略生成 → 风险检查 → 执行）围绕一个受唐代官僚制度启发的 “三省六部” 模型进行结构化。提供 Web 仪表盘（FastAPI + HTML），支持回测、策略管理，尤其具备 AI 驱动的自然语言股票筛选功能，可将中文描述自动转化为可执行的过滤规则。

🎯 项目功能

功能	你将获得
回测引擎	历史数据摄入、信号执行、绩效报告、一致性检查。
多策略管理	内置策略外加用户自定义策略的插件点；支持批量、组合及“BLK/TDX”公式导入。
风险优先工作流	“守门省”可基于止损、回撤、仓位限制等条件否决交易。
AI 条件筛选	输入中文规则如 “五日内有涨停，涨停后缩量至一半以下，RSI 处于超卖区间”；系统调用大模型 API，解析意图，自动创建结构化过滤器 + 执行规则。
可配置数据源	AkShare、Tushare、通用 REST API、MySQL 或 PostgreSQL 后端。
Web UI	FastAPI 服务器（`server.py`）提供 `dashboard.html`，可选择策略、设置参数、启动单票回测或启动全规模“策略进化”看板。
策略进化看板	生成、评估并迭代策略（README 称为 Evolution），适用于自动化优化。

🏗️ 架构概览

三省（决策链）
1. 太子院（Crown Prince） – 数据验证与分发。
2. 中书省（Zhongshu Sheng） – 策略信号生成。
3. 门下省（Menxia Sheng） – 风险审查；可否决交易。
4. 尚书省（Shangshu Sheng） – 执行与结算。
六部（功能模块）
- 吏部 – 策略注册与生命周期管理。
- 户部 – 资金、成本与 NAV 会计。
- 礼部 – 绩效报告与排名。
- 兵部 – 订单匹配与交易管理。
- 刑部 – 违规日志与风险事件。
- 工部 – 市场数据清洗与指标计算。

代码结构

src/
  core/            # 省级协调
  ministries/      # 部门实现
  strategies/      # 内置及用户策略
  strategy_intent/ # AI 意图解析
  utils/           # 配置、数据适配器、指标
dashboard.html    # UI
server.py          # FastAPI 入口
main.py, run_*.py  # 回测/实时监控用 CLI 辅助脚本

🚀 快速入门（5分钟指南）

安装 – pip install -r requirements.txt（Python 3.8+）。
添加私有配置 – 创建 config.private.json，填入你的 Tushare/LLM API 密钥（参见 README 示例）。
运行服务器 – python server.py（如需，脚本会自动安装缺失依赖）。
打开仪表盘（通常为 http://127.0.0.1:8000）。
选择策略，填写 股票代码、日期范围 和 初始资金，点击 单票回测 查看首个结果。
如需批量运行、BLK/TDX 导入或策略进化，请使用 UI 中的 操作工作台 链接。

🤖 AI 条件筛选工作流

用中文输入自然语言股票选股想法。
平台调用配置的 LLM（llm_api_key 在私有配置中）。
模型返回 JSON 格式结构，分离 过滤条件 与 交易执行规则。
过滤器在选定数据源上运行，生成候选池；回测引擎使用执行规则模拟交易。

📜 许可证与商业条款

个人、学术或本地使用（非商业）免费 – 可学习代码、运行回测、修改。
商业使用需作者书面许可（邮箱：zthx410@163.com）。包括 SaaS 服务、软件销售或任何盈利性部署。
仓库包含完整免责声明：本工具 非投资建议，用户承担全部交易风险。

🙋‍♀️ 贡献方式

Fork → 分支 → PR。
保持核心脚本可运行。
在 PR 描述中记录测试步骤。

📌 总结

金策智算 是一个较为完整的开源定量研究平台，融合传统回测与由大语言模型驱动的自然语言转策略管道。适合 Python 开发者或量化爱好者，可快速实验策略构思、风险控制与 AI 辅助选股，同时仍可深入底层代码。