QUINE 是基于 EA 确定性引擎构建、仍在开发中的本地优先 Mac 量化研究应用。 欢迎通过 fork、Issue 和 draft PR 参与改进。当前目标是源码协作；此预览版尚不是 成熟的交易产品，也不是公开发行的桌面安装包。项目原创代码采用 MIT 许可， 适用范围见许可说明。
源码已包含下述 v3 研究实现。源码合入不代表已完成用户亲自操作的原生应用验收， 也不代表已有可分发的安装包。产品目标是 Apple Silicon Mac 桌面应用；浏览器预览用于辅助开发。
| 入口或功能 | 已有能力 | 当前限制 |
|---|---|---|
原生 v3 /studio（apps/web/src/studio-real.tsx） |
保存研究、导入和检查 CSV、绑定策略与数据、编辑草稿、预览并明确确认本地引擎实验、读取冻结报告、选择下次启动的工作空间 | 开发候选版本；最终原生应用验收尚未完成 |
| 研究助手与模型连接 | 创建、编辑、取消或保存连接，设定工作区默认或选择本研究连接；明确发送才调用模型，Apply 只修改草稿 | 保存不验证认证；真实模型服务调用尚未完成验收 |
| 实验停止与恢复 | 请求停止并读取所有者状态；未知记录提供已有的恢复准备与活动槽释放入口 | stopping 不等于已停止；释放保留未知结果、冻结输入与已用预算，新实验仍需独立确认 |
离线设计预览（apps/web/studio/） |
可重置的合成场景，用于布局和交互开发 | 不调用真实引擎、模型服务、账户或交易所；演示结果不是研究证据 |
| 留出验证 | 从成功报告选择兼容且严格更晚的输入，独立确认一次 core-owned 运行，重开关联与两份冻结报告 | 时间先后不代表未见数据、泛化能力或自动晋级 |
| 人工研究候选 | 从明确选定的已完成留出创建 EVALUATED，查看冻结证据并填写理由接受或拒绝；历史与报告重开可读 | 证据完整不代表统计有效或盈利；接受不启动实验或模拟 |
| 模拟、Live、批量实验 | 仓库保留已有的引擎与 Paper 工具 | 这些流程尚未接入原生 v3；不支持外部券商或实盘交易 |
历史 EA 0.2.0 是当前软件包版本，也是早期离线预发布版本，不是新的 QUINE 发行版。 项目不承诺实时行情覆盖、盈利、投资适用性或实盘交易能力。回测只描述其冻结输入下的结果， 不保证未来收益。
准备 Git 和 Node.js 24 / npm（与 CI 使用的版本系列一致）。这个合成数据预览 不需要模型密钥或 Python 服务：
git clone --branch main https://github.com/jayjcc8-cloud/ea-quant.git quine
cd quine
npm --prefix apps/web ci
npm --prefix apps/web run dev:studio打开 http://127.0.0.1:4176/，按 Ctrl-C 停止。端口被占用时命令会失败，不会替换已有服务。 v3 预览说明介绍了重置、持久化和定向检查。 此预览不执行真实研究。
要体验真实本地研究流程，请在 Apple Silicon macOS 上按照源码构建要求与开发命令操作。
原生窗口打开 /studio，复用已有 Python 服务，由 Rust 管理实验执行。
请从上述源码目录构建并选择新的数据根目录；旧的已安装应用不会自动获得新代码。
保存研究或运行仓库自带的合成数据引擎实验，不需要付费模型调用。
- 保存研究想法，在草稿中绑定已注册的策略与数据。使用自己的 CSV 时，说明来源及使用权， 先预览，再明确发布并选择其不可变版本。
- 检查参数、资金费率、币种和成本假设。应用提案只修改草稿。预览输入后，明确确认一次本地实验。
- 阅读冻结报告及其来源标识。结果未知时查询原请求，不要盲目重发。 报告或 Candidate 决策不构成交易授权。
不要将私有数据集、凭据、工作空间数据库，以及含私密内容的日志和截图提交到 Git 或公开 Issue。 复现问题请使用仓库自带的合成测试数据。不要把 API 密钥粘贴到研究文本中，也不要提交模型设置。 本地 Python 策略插件属于受信任的可执行代码；项目没有用于运行不受信任策略的通用沙箱。
从贡献指南开始：选择一个小问题，复现问题，运行相关检查，
再从你的 fork 提交 draft PR。欢迎改进首次使用体验、无障碍支持、可复现缺陷、测试与文档。
维护者负责集成和必要审查；参与社区贡献不代表获得 main 的直接写入权限。
签名、公证、全新 Mac 安装和 Paper 连续 72 小时／7 天运行属于独立的安装包或运行验收工作， 不是贡献源码的前置条件。STATUS中仍未验证的项目，不应被宣传为已完成。
项目原创源代码采用 MIT 许可证，Copyright (c) 2026 JayJcc。 第三方代码、依赖及声明保留原有许可和署名。本源码许可不会重新授权第三方素材， 也不代表将个人文案、图片、品牌或商标一概声明为 MIT。 npm 锁文件中的依赖许可字段描述的是对应依赖，不代表已完成全面的第三方许可审计。
当前状态 · Mac 开发与工作空间规则 · 工程流程 · 桌面产品边界