运行隔离与入口整合¶
环境可复现需要同时核对解释器、实际包版本、安装来源和传递依赖。虚拟环境若继承基础site-packages，清单中的版本可能没有实际生效，审计也会包含其他项目使用的库。项目内独立环境、固定哈希及启动前预检共同约束这个边界。
Web、模型和Qlib是不同依赖集合。当前验收将Web/CPU模型组合安装在同一个独立环境，Qlib信号分析通过单独解释器进程执行，避免Pandas等版本冲突。模型依赖按需加载不等于已隔离到另一个进程；完整QlibWorkflow也不能由信号分析结果替代。
版本告警与实际可利用性需要分别记录。先核对公告条件和调用入口，再决定升级、隔离或限制。当前Pillow受Gradio约束仍有告警，不能通过忽略记录或破坏依赖一致性来取得清零结果。锁文件固定的是经过验证的组合，不是永久安全承诺。
一个职责对应一个完整编辑入口¶
研报、论文与知识资料共用检索/入库组件；RAG共享会话、引用及模型失败状态。因子监控与挖掘共用同一研究页面。AI中的轻量操作从同一服务读取状态，完整编辑回到系统管理或资料库。
回测入口可以不同，但任务ID、参数快照、执行成本及结果来源保持唯一。一键回测提交后跳到同一结果页，图形画布保留节点过程。归因统一按来源与账户标识读取，回测、模拟和实盘的账本不合并。
兼容路由与按需构建¶
旧模块和视图在进入页面前归一化；研报/论文子页、任务ID和分析来源显式传递。页面组件完成挂载后才选择子页，防止首次加载时丢失目标；同一导航事件只应用一次输入，避免后台更新覆盖用户的新编辑。
一级入口整合保留模块延迟构建及浏览器缓存上限。相同组件源码可以复用，历史接口可以保留，但不在主导航中复制完整表单。减少菜单和控件只能说明结构收敛，性能仍须用配置体积、构建时间、切换及后台任务验证。
自动预检与图片入口¶
预检接入三个正常启动入口，先验证解释器、声明版本、继承配置及包来源，再打印可用地址。默认Web角色避免把可选训练依赖变为所有功能的前提；严格模式失败即退出，兼容调试必须显式选择warn并保留偏差。帮助和远程客户端查询保持离线可用。
图片校验通过项目内Pillow13独立进程执行，Web只读取受限字节和校验结果，不使用Pillow12解码。按批传递有界内容，实际格式、完整解码、像素、帧和内存估算均校验；父进程对整批设置超时。通过后的内容快照供API编码或CLI副本使用，原文件变化不会换入未校验字节。此隔离减少业务图片入口风险，不等同于操作系统沙箱或主Gradio依赖告警清零。
定位状态与只读报告¶
每个模块/视图拥有独立的上下文、嵌套页签、冻结版本和定位序号。上下文白名单在导航YAML声明；普通切页只取目标自己的状态，历史跳转重建相应定位。子页共享嵌入式/独立窗口定位程序，挂载等待有上限，切页立即取消旧观察器与延迟动作，重复消息不会覆盖已应用字段。
报告库只在首次进入、显式刷新或筛选时读取目录，不增加轮询或模型调用。筛选保留有效选择，时间按时区排序；异常记录和损坏事件行跳过并记日志。原状态、HTML可用性和过程可用性分开显示，文件缺失既不生成替代报告，也不产生有效下载链接。