在本机完成 A 股数据管理、模型训练与下一周 Top-5 组合研究
中文桌面应用 · Windows / Linux · 本地运行 · 零遥测
Quintara 把数据更新、CSV 检查、股票池管理、环境诊断、训练、预测和结果解释整合到一个 独立桌面应用中。日常操作都在应用内完成，不必在浏览器和命令行之间切换。
Important
Quintara 是本地研究工具，输出为模型推荐组合与预测排名，不代表收益承诺或交易指令。
发布安装包已经包含 Python、Qt、LightGBM 和应用运行环境，Windows 用户无需另行安装 Python、Git 或开发工具。
从 Quintara Releases 下载最新正式版。 发布页会同时提供两种 Windows 版本：
| 版本 | 适合场景 | 下载 |
|---|---|---|
| 安装版 | 正常安装，可创建开始菜单和桌面快捷方式 | 下载 Windows 安装程序 |
| 便携版 | 无需安装，在下载位置直接运行 | 下载 Windows 便携版 |
上述链接始终指向最新正式版，不需要查找 Actions 构建记录或解压 Artifact。
安装向导可创建开始菜单和桌面快捷方式。安装包目前未使用数字签名， Windows SmartScreen 可能显示发布者提示。请核对下载地址与构建来源，然后在“更多信息”中继续安装。
从桌面或开始菜单打开 Quintara，依次完成：
- 阅读并确认本地研究声明；
- 查看系统、CPU、内存、磁盘和 NVIDIA 环境诊断；
- 更新 BaoStock 数据，或导入自己的 CSV；
- 选择 PIT 基准股票池或自定义股票池；
- 选择训练年限与策略，开始训练并查看 Top-5 结果。
安装器本身不携带历史行情。行情由用户首次启动时直接从 BaoStock 下载到自己的电脑。
flowchart LR
A[环境诊断] --> B[更新数据或导入 CSV]
B --> C[选择股票池]
C --> D[训练与预测]
D --> E[Top-5 组合]
E --> F[排名、解释与风险指标]
在“数据”页面点击更新后，Quintara 会登录 BaoStock，拉取行情和 extra features，完成校验， 再发布新的不可变数据版本。下载中断或校验失败时，当前有效版本保持原状。
导入前会检查编码、字段、代码、日期、重复键、OHLC、数值范围、历史长度和单位声明。 Quintara 保留源文件，不替用户修改或填补原始数据；检查结果会给出中文说明和问题样本。
字段定义、单位及模板说明见 docs/CSV_FIELD_DICTIONARY.md。
“股票池”页面支持：
- 输入单只或多只股票代码；
- 从 CSV 批量追加代码；
- 通过 BaoStock 搜索代码或名称后添加；
- 查看当前股票清单；
- 从当前股票池删除代码；
- 创建并保存多个命名股票池。
自定义池至少包含 100 只沪、深、北交易所 A 股普通股。自定义静态股票池的结果会明确提示 幸存者偏差，其模型和结果与 PIT 路线相互隔离。命名股票池的激活切换也可通过 CLI 完成。
结果首页展示：
- 模型推荐的五只股票；
- 固定组合权重
40% / 25% / 15% / 12% / 8%； - 数据截止日和下一实际交易周；
- 股票池路线和数据新鲜度；
- 清晰的入选解释。
高级详情还包含完整排名、模型分数、主要特征贡献、20/60/120 日风险指标、相关性和来源信息。 每次结果都与数据版本、股票池、模型配置和运行环境 identity 绑定，便于复查和复现。
| 路线 | 适合场景 | Quintara 的处理方式 |
|---|---|---|
PIT_BASELINE |
按历史时点研究沪深 300 | 使用经过校验的历史成员有效区间 |
CUSTOM_UNIVERSE |
研究用户定义的 A 股池 | 使用独立静态池，显著标记幸存者偏差 |
NON_PIT_FALLBACK |
使用当前成分回看历史 | 仅在用户显式确认后建立，并永久显示提示 |
BaoStock 的单次成分查询是指定日期的快照。进入 PIT_BASELINE 时，成员数据需要包含
stock_id,index_code,start_date,end_date 有效区间；当前静态成分快照始终作为
NON_PIT_FALLBACK 单独标记和存储。
- 默认预测标签：
close(T+5) / open(T+1) - 1，只按实际交易日计数； - 训练年限：3–10 年；
- 策略选择：
aggressive、balanced、conservative； - 组合权重保持固定，策略主要调整模型容量与正则；
- CPU 是权威结果路径；NVIDIA GPU 在诊断通过后作为实验加速路径。
Linux 发布包支持 Ubuntu 22.04/24.04 与 Debian 12/13 x86-64。下载 Linux x86-64 最新正式版 并运行：
tar -xzf Quintara-Linux-x86_64.tar.gz
chmod +x Quintara
./Quintara --version
./Quintara gui如果希望安装到当前用户的 $HOME/.local，在源码目录构建 bundle 后运行：
uv sync --locked --all-groups
uv run python packaging/build_release.py
./packaging/install_linux.sh无桌面 Linux、自动化和排错场景可以使用 CLI。GUI 与 CLI 共用同一套数据、训练和结果逻辑。
# 环境诊断
quintara doctor
# 更新数据
quintara data update --start-date 2015-01-01 --pit-membership-csv ./pit_membership.csv
# 显式建立当前快照研究路线
quintara data update --allow-non-pit
# 训练并输出结果
quintara run --strategy balanced --years 5
# 查看运行历史和结果
quintara runs
quintara results RUN_ID --details自定义股票池也可以通过 CLI 编辑：
quintara universe list
quintara universe add CUSTOM_UNIVERSE_ID 600000,000001
quintara universe remove CUSTOM_UNIVERSE_ID codes.csv| 系统 | 默认位置 |
|---|---|
| Windows | %LOCALAPPDATA%\Quintara |
| Linux | ~/.local/share/quintara |
主要目录：
data/generations/ 不可变数据版本
universes/ 股票池定义
models/ 模型文件
results/RUN_ID/ 组合、完整排名、解释和 provenance
registry.sqlite3 本地运行索引
diagnostics/ 用户主动导出的脱敏诊断包
卸载应用时默认保留这些用户数据，重新安装后可继续使用。
- 永久关闭自动遥测、崩溃上传和使用统计；
- 环境信息、日志、股票池、模型和结果只保存在本机；
- 用户点击数据更新时连接 BaoStock；
- 用户启用版本检查后，只请求 GitHub Releases 的版本信息；
- 诊断包由用户主动生成并保存在本地，默认排除原始行情。
详情见 docs/PRIVACY.md。
面向开发者的源码环境需要 Python 3.12 和 uv：
git clone git@github.com:Telecaster2147/quintara.git
cd quintara
uv sync --locked --all-groups
uv run quintara doctor
uv run quintara gui运行质量门：
uv run ruff check src tests packaging
uv run python packaging/typecheck.py
uv run pytest
uv build| 文档 | 内容 |
|---|---|
docs/FIRST_USE.md |
首次启动与完整操作流程 |
docs/CSV_FIELD_DICTIONARY.md |
CSV 字段、单位和验证规则 |
docs/OPERATIONS.md |
数据恢复、运行维护和排错 |
docs/ERROR_CATALOG.md |
中文错误索引与处理建议 |
docs/PRIVACY.md |
本地数据、联网和隐私原则 |
docs/LEGAL_NOTICE.md |
数据与研究边界声明 |
docs/THIRD_PARTY_NOTICES.md |
第三方组件、许可证与数据来源 |
Issue 和 Pull Request 均可用于提交问题、体验反馈和功能改进。开发约定见
CONTRIBUTING.md。
Quintara 使用 MIT License。第三方组件、许可证与数据来源说明见
docs/THIRD_PARTY_NOTICES.md。