一个以数据口径、已知答案、独立核账和实验留痕为基础的量化研究项目。当前是 v0.4 验收基底，尚未完成真实历史策略收益验证，也没有券商交易功能。
本项目复用现有引擎，研究规范与证据留在引擎外：数据/协议 → 仪器验收 → 主回测路径 → 独立核账/基准 → 向前验证。
- 严格研究配置：未知条件显式保留，拒绝重复 JSON 字段、非有限数字和不支持的运行目的。
- 净账户指标与开发段风险校准：现金流、初始证券、未定义比率、双边换手及费用口径；12个指标控制随统一入口运行，101个合成风险校准点保留。
- 独立运行目录、输入与源码快照、哈希封存、全部开始/结束记录、复跑指纹和篡改检测。
- 39 项合成参照控制；有限时点、费用、分红应收/支付、拆股与结算样例，含独立事件回放。
- 可选的本机 Vibe US-equity 路径对照：21 个共同合成样例；显式账户适配涵盖分红应收/支付、整数拆股、现金与股票结算，并经独立核账。
- 冻结的四 ETF 毛总收益/SMA10信号与 S/B0/BR/BC 合成账户路径；11个分配/完整路径样例和2个未来扰动控制。逐笔买单、先前成交量约束及缺开盘时的过去估值已显式建模。
- 已有 S02 四 ETF 快照的本地审计适配器；原始/派生数据不随仓库发布。
- 发布前的文件范围与凭证/私有路径检查。
macOS/Linux，Python 3.12+。默认命令只用标准库，不需要行情账号或安装交易框架。
python -B -m unittest discover -s tests -v
python -B -m research_base run --spec examples/validation.json --output runs-local命令输出具体运行目录。将它传给封存检查：
python -B -m research_base verify PATH_TO_RUN --registry runs-local/registry.jsonl已有 Vibe 环境时，可用该环境的 Python 运行：
python -B -m research_base run --spec examples/validation.json --output runs-local --vibe-controls这条可选路径不会自动安装依赖或获取行情。被测引擎源码哈希、numpy/pandas版本和逐事件差异会保存到本地。兼容性以实际来源和控制记录为准。
默认测试环境执行65项测试，另9项Vibe集成测试明确跳过；已有Vibe的本机环境执行全部74项。GitHub默认CI不安装Vibe，不能据此宣称引擎集成已在远端验证。见账户适配模型、指标口径、完整协议路径与配对月度检验。
固定配对月度增长与循环区块bootstrap程序已接入统一入口，归档6个合成账户验收、4个坏输入拒绝及完整抽样位置/结果。它保留破产和缺月，不能从一个窗口或合成区间推导策略支持。
每次运行另输出历史研究预检，把不可变快照声明、本轮测量和D01–D06剩余条件分别记录。合成验收、完整性哈希或手改“ready”标签都不能授权历史试验。
VALIDATION_COMPLETED_WITH_GAPS 表示有限检查完成且仍有缺口。它不代表数据已适合历史研究、策略盈利或账户可执行。运行错误、配置拒绝和策略表现分别分类。
- G1 共同入口：契约、冻结输入、复现和全部试验记录。
- G2 数据与仪器：来源/单位/时点/公司行动审计，控制沿真实使用路径验收。
- G3 首个研究：冻结的四 ETF 低频规则，与同口径简单持有和风险匹配基准比较；条件缺失时明确报告，不能制造结果。
- G4 可持续公开：代码、合成数据、方法和可发布证据持续交付；私有研究分离。
默认运行结果不进入 Git。凭证、账户材料、受限行情、潜在高价值因子、参数、信号和可反推出规则的结果，放在仓库外。只手工审核后导出允许公开的材料。忽略文件不是保密边界；详见发布政策。
本仓库不包含真实供应商数据、不自动采集，也不把合成控制统计解释为投资收益。
本项目代码采用 MIT。外部框架、数据和来源资料的许可分别适用；本项目许可不授予它们的使用或再分发权。