QuantAll 1.0.0__py3-none-any.whl

QuantAll/LICENSE.txt

@@ -0,0 +1,79 @@
+QuantAll许可证 v1.0
+
+版权所有 (c) 2026 CMF
+
+一、授权范围
+
+1.1 在您遵守本许可证全部条款的前提下，CMF（以下简称"许可方"）授予您一项
+     非独占、不可转让、不可再许可的有限授权，允许您：
+     （a）在个人或非商业性目的下，下载、安装、使用本软件；
+     （b）在您个人或所在非商业组织内部，为内部信息分析目的使用本软件。
+
+1.2 本授权仅限于您个人或您所在非商业组织内部使用。
+
+二、禁止行为
+
+2.1 您不得对本软件的全部或部分源代码、目标代码进行复制、修改、反向工程、
+     反编译、反汇编或以其他方式尝试推导出源代码。
+
+2.2 您不得将本软件或其任何副本以任何形式（包括但不限于出售、出租、出借、
+     分发、转让、再许可、作为服务提供等）提供给任何第三方。
+
+2.3 您不得将本软件用于任何商业目的。商业目的包括但不限于：
+     （a）将本软件作为产品或服务的一部分出售或出租；
+     （b）使用本软件为第三方提供商业性质的数据分析服务；
+     （c）将本软件集成到商业产品或服务中进行销售或分发。
+
+     如需将本软件用于商业目的，您必须事先获得许可方的书面授权，并另行
+     签署商业许可协议。
+
+2.4 您不得移除或篡改本软件中包含的任何版权声明、商标或其他专有标识。
+
+三、免责声明
+
+3.1 数据免责声明
+     本软件包内包含的示例数据（如 Test.duckdb 等）仅供功能测试和演示使用，
+     不具有任何实际参考价值。本软件不提供任何实时或历史金融数据服务。
+     用户在使用本软件进行实际金融分析时，须自行准备数据源，并对所使用
+     数据的准确性、完整性和合法性承担全部责任。因用户使用错误或不准确的
+     数据所导致的任何损失或后果，许可方概不负责。
+
+3.2 投资风险免责声明
+     本软件仅为金融分析工具，供用户进行技术研究和策略测试使用。本软件
+     不构成任何投资建议、交易建议或财务建议，不涉及任何实际交易环节。
+     用户使用本软件做出的任何投资或交易决策，均由用户自行承担全部风险
+     和后果。无论盈亏，用户均应自行对交易结果负责，许可方不承担任何责任。
+
+3.3 责任限额
+     在适用法律允许的最大范围内，无论基于何种法律理论（包括但不限于合同、
+     侵权、过失、严格责任或其他理论），许可方因本软件或本许可证所产生
+     的全部累计赔偿责任，均不超过用户为获取本软件所实际支付的授权费用。
+     因本软件当前以免费形式提供，故该上限金额为人民币零元（¥0）。
+     本限额适用于任何损害、索赔或损失，包括但不限于直接损失、间接损失、
+     附带损失、特殊损失或惩罚性赔偿。
+
+3.4 本软件按"现状"（AS IS）提供，许可方不作任何明示或暗示的担保，
+     包括但不限于对适销性、特定用途适用性、准确性、安全性及不侵犯
+     第三方权利的暗示担保。您自行承担使用本软件的全部风险。
+
+四、许可终止
+
+4.1 如果您违反本许可证的任何条款，本授权将自动终止，无需另行通知。
+
+4.2 许可终止后，您必须立即停止使用本软件，并销毁您所持有的全部副本。
+
+五、商业授权
+
+5.1 任何未经许可方书面授权的商业使用行为均构成侵权，许可方保留追究
+     法律责任的全部权利。
+
+5.2 如需获取商业授权，请联系许可方协商具体条款和费用。
+
+六、一般条款
+
+6.1 本许可证构成双方就本软件许可事宜的完整协议，取代所有先前或同期的
+     口头或书面沟通。
+
+6.2 如果本许可证的任何条款被认定为无效或不可执行，其余条款仍应完全有效。
+
+6.3 本许可证的解释、效力和执行，均适用许可方所在地的法律。

QuantAll/README.md

@@ -0,0 +1,237 @@
+# QuantAll（全A解析）
+
+[![Python](https://img.shields.io/badge/Python-3.10%2B-blue)](https://www.python.org/)
+[![Platform](https://img.shields.io/badge/Platform-Windows-lightgrey)]()
+
+A股全市场向量化并行计算引擎。支持 5000+ 股票的**全市场因子计算**、**策略回测**、**因子 IC 分析**及 **GPU 多维可视化**。
+
+核心价值：为 AI 配置本地计算引擎，让 AI 从「数据搬运工」升级为「数据分析师」—— 不再只是查询信息，而是用代码算出客观结果。
+
+---
+
+## 安装
+
+```bash
+pip install quantall
+```
+
+安装后，包内自带以下内置资源：
+
+| 内置资源 | 说明 |
+|----------|------|
+| `ai_prompts.toml` | AI 提示词配置，用于 MCP 工具语义理解 |
+| `Test.duckdb` | 测试数据库（沪深300近两年行情），开箱即用 |
+
+> **注意**：仅支持 Windows 平台（依赖 PySide6 GUI 和 PyOpenGL GPU 渲染）。
+
+---
+
+## 快速开始
+
+### 第一步：创建启动脚本
+
+在项目目录下创建 `Start_QuantAll.py`：
+
+```python
+"""
+QuantAll 启动入口
+
+说明：
+- Start_main() 需要传入项目路径
+- 项目路径下会自动查找 DB_setting.json、数据库文件、data/ 目录
+- 如果需要修改数据库路径，编辑 DB_setting.json 中的 db_path 字段
+- 注意：文件名不要用 "QuantAll.py"，可能与包名冲突
+"""
+import os
+from QuantAll import Start_main
+
+print("全A解析启动中...")
+# 将 os.path.dirname(__file__) 替换为你的项目路径
+# Start_main("C:/your/project/path")
+Start_main(os.path.dirname(__file__))
+```
+
+### 第二步：配置数据库连接
+
+在启动脚本同级目录创建 `DB_setting.json`：
+
+```json
+{
+  "db_path": "你的数据库路径/data.duckdb",
+  "days": 730,
+  "ex_do": true,
+  "stock_index": "stock_index",
+  "map_stock_index": {
+    "trade_date": "trade_date", "symbol": "symbol",
+    "open": "open", "high": "high", "low": "low",
+    "close": "close", "pre_close": "pre_close",
+    "vol": "vol", "voe": "voe"
+  },
+  "stock": "stock",
+  "map_stock": {
+    "trade_date": "trade_date", "symbol": "symbol",
+    "open": "open", "high": "high", "low": "low",
+    "close": "close", "pre_close": "pre_close",
+    "vol": "vol", "voe": "voe"
+  },
+  "stock_basic": "stock_basic",
+  "map_stock_basic": {
+    "symbol": "symbol", "name": "name",
+    "check": ["industry", "business_scope", "main_business",
+              "province", "city", "act_ent_type", "concept"]
+  },
+  "stock_factor": "stock_factor",
+  "map_stock_factor": {"symbol": "symbol", "trade_date": "trade_date"},
+  "stock_forecast": "stock_forecast",
+  "map_stock_forecast": {"symbol": "symbol", "ann_date": "ann_date"},
+  "stock_dividend": "stock_dividend",
+  "map_stock_dividend": {"symbol": "symbol", "ann_date": "ann_date", "ex_date": "ex_date"},
+  "stock_report": "stock_report",
+  "map_stock_report": {"symbol": "symbol", "ann_date": "ann_date"},
+  "_": "_",
+  "map__": {}
+}
+```
+
+| 关键参数 | 类型 | 说明 |
+|----------|------|------|
+| `db_path` | string | **DuckDB 数据库文件的绝对路径**（必改项） |
+| `days` | int | 加载交易天数，默认 730（约2年） |
+| `ex_do` | bool | 是否启用除权除息处理 |
+| `map_*` | object | 各表字段名映射，可将自定义数据库字段映射到标准名 |
+
+> **测试体验**：若只是想快速体验，将 `db_path` 指向包内自带的 `Test.duckdb`（安装后在 `site-packages/QuantAll/Test.duckdb`），内含沪深300近两年基础行情数据。
+
+### 第三步：启动服务
+
+```bash
+python Start_QuantAll.py
+```
+
+启动后，QuantAll 在 `http://127.0.0.1:8686/mcp` 提供 HTTP MCP 服务。
+
+---
+
+## 功能概览
+
+QuantAll 提供 **11 个 MCP 工具**，覆盖量化研究的完整工作流：
+
+| 工具 | 类型 | 功能说明 |
+|------|------|----------|
+| `strategy_backtest` | 回测 | 全市场策略回测，输出收益率、夏普比率、最大回撤、胜率等指标 |
+| `factor_analysis` | 因子 | 因子 IC 分析，支持 summary/daily/scatter 三种模式，输出 IC均值、IR、多空收益差 |
+| `new_layer_from_code` | 图层 | 自定义散点图层，支持 shift 平移分析标记日前后的数据分布 |
+| `move_by_code` | 统计 | 坐标轴平移，按因子/特征给散点着色生成热力图 |
+| `weight_by_code` | 统计 | 权重赋值，对选中集合做加权分布统计 |
+| `select_by_code` | 集合 | 集合操作（交/并/差/补等 6 种模式），筛选股票 |
+| `heat_map` | 矩阵 | 多维热力图统计，支持 x_y / x / y 三种模式 |
+| `get_user_selection` | 交互 | 获取 GUI 可视化界面中用户框选的股票列表 |
+| `available_data` | 数据 | 查看当前数据库及图层中可用字段列表 |
+| `ping` | 系统 | 健康检查，确认服务正常 |
+| `MCP_Close` | 系统 | 关闭 QuantAll 服务 |
+
+---
+
+## 数据准备
+
+QuantAll 依赖本地 **DuckDB** 数据库运行，需要包含以下数据表：
+
+| 表名 | 内容 |
+|------|------|
+| `stock` / `stock_index` | 日线行情（OHLCV） |
+| `stock_basic` | 股票基本信息（名称、行业、省份、概念等） |
+| `stock_factor` | 日频因子（换手率、PE、PB、市值等） |
+| `stock_forecast` | 业绩预告 |
+| `stock_dividend` | 分红送转 |
+| `stock_report` | 财务报表（153个指标） |
+
+**获取数据有两种方式**：
+
+### 方式一：通过 UpdateStock 自动管理（推荐）
+
+搭配 [UpdateStock] AI技能，可通过 AI 助手一键建库、全量/增量更新：
+
+- **全量更新**：需 tushare 2000+ 积分，覆盖所有历史数据
+- **增量更新**：需 tushare 200 积分，仅更新最近数据（免费注册即可获得）
+
+> tushare 注册地址：https://tushare.pro
+
+### 方式二：自行准备数据库
+
+按 `DB_setting.json` 配置的表结构和字段映射，自行准备 DuckDB 数据库。字段名可通过 `map_*` 配置灵活映射，无需严格匹配默认字段名。
+
+---
+
+## AI 助手集成
+
+QuantAll 是一个 **MCP（Model Context Protocol）服务**，可接入 WorkBuddy、Claude Desktop 等支持 MCP 的 AI 助手。
+
+### WorkBuddy 配置
+
+在 `~/.workbuddy/mcp.json` 中添加：
+
+```json
+{
+  "mcpServers": {
+    "全A解析": {
+      "url": "http://127.0.0.1:8686/mcp",
+      "disabled": false
+    }
+  }
+}
+```
+
+### 其他 MCP 客户端
+
+任何支持 HTTP MCP 协议的客户端均可通过 `http://127.0.0.1:8686/mcp` 连接。
+
+---
+
+## 代码执行环境
+
+QuantAll 内置 Python 向量化计算环境，AI 可直接编写策略代码执行。环境提供：
+
+- **`d`**：`dict[str, DataFrame]`，所有可用数据（字段名 -> 全市场 DataFrame）
+- **`col_attrs`**：`dict[str, Series]`，各字段属性（分组、分类信息等）
+- **`np`**、**`pd`**：numpy、pandas 直接可用
+
+> **约束**：代码必须向量化（禁止 for 循环、`df.apply()`、`lambda`），最后一行用 `out = ...` 输出结果。
+
+---
+
+## 激活
+
+QuantAll 目前不激活可以正常使用。启动需要同意用户协议，激活代表永久同意，后续启动不再弹出用户协议弹窗。
+
+---
+
+## 依赖
+
+核心依赖（`pip install quantall` 时自动安装）：
+
+```
+mcp>=1.26.0        # MCP 协议
+pandas>=2.3.3      # 数据计算
+numpy>=1.24.0      # 数值运算
+duckdb>=1.5.2      # 数据库引擎
+PySide6>=6.10.1    # GUI 可视化
+PyOpenGL>=3.1.9    # GPU 渲染
+cryptography>=46.0.3  # 安全与激活
+openpyxl>=3.1.5    # Excel 导出
+pywin32>=311       # Windows 系统集成
+```
+
+> Python 版本要求：**3.10+**，测试通过版本：3.12、3.13。
+
+---
+
+## 许可
+
+QuantAll（全A解析）为商业软件，使用需获得授权许可。
+
+---
+
+## 联系方式
+
+- PyPI: [https://pypi.org/project/quantall/](https://pypi.org/project/quantall/)
+- 问题反馈：请在对应平台提交 Issue

QuantAll/__init__.py

@@ -0,0 +1,30 @@
+import sys
+from .W_S import Start_main
+
+__version__ = "1.0.0"
+
+def version():
+    """返回当前包的版本号。"""
+    return __version__
+
+def help():
+    """帮助文件"""
+    return """
+1.启动时需要传入项目路径，第一次启动会在项目路径上创建data文件夹，代码如下：
+import os
+from QuantAll import Start_main
+Start_main(os.path.dirname(__file__))
+
+2.软件需要本地数据库，数据库的路径设置在项目文件夹的'DB_setting.json'。
+第一次启动会自动创建，会先找显目路径里面的Test.duckdb，
+缺失会使用quantall里面的测试数据库Test.duckdb，测试数据库只有少量数据。
+
+3.软件需要AI提示词，优先查找项目路径\\data\\ai_prompts.toml，
+缺失时会使用quantall里面的ai_prompts.toml。
+
+4.软件支持数据库列名翻译，优化AI理解数据库里面的内容。翻译文件需要放在项目路径\\data\\db_translate.json。
+缺失不翻译，另外翻译文件里面翻译后的名称应该具备唯一性，应避免不同列翻译成重复名称。
+"""
+
+
+__all__ = ['Start_main', 'help', 'version', '__version__']  # 可选，__version__ 通常不需要显式加入 __all__