PlantAI-dev/apps/web/af3_sandbox/MIGRATION_NOTES.md

AF3 Mol* 沙箱迁移评估

已验证且可复用

• static/af3-viewer.js：Mol* 生命周期、MolViewSpec 场景、链 A/B 着色和三种表示模式。
• static/vendor/molstar/：固定版本 Mol* 5.11.0 浏览器构建与许可证。
• main.py 中的 resolve_structure()：仅限单文件名和 .cif/.mmcif 的安全读取规则。

正式页面接入时需要适配

• 将沙箱工具栏样式改为正式 apps/web/vue3/index.html 的 Element Plus 组件；不能原样复制整个页面。
• 将沙箱的单目录结构列表改为正式 artifact resolver 返回的 job/stage scoped URL。
• 将 Vue state 绑定到正式结果弹窗的打开、切换和关闭生命周期，并在弹窗关闭时调用 dispose()。

正式 AF3 结果所需 artifacts

• *_model.cif
• *_summary_confidences.json
• *_confidences.json
• *_contacts.tsv
• 可选的 *_overall.png 与 *_interface.png

正式后端至少需要为 CIF artifact 返回可鉴权的 URL 和 chemical/x-mmcif 内容类型，同时保持 job_id、stage identity、scope 与 manifest 一致。不能接收任意服务器绝对路径。

服务影响

• 本次只启动独立 9020；没有重启或修改 9010。
• 本次没有修改 Celery，因而无需重启 Celery。
• 将来修改正式 apps/web/vue3/main.py 或 index.html 后需要重启 Web 服务；仅查看已有 CIF 不需要 Celery。

当前限制

• 沙箱只读取一个由 AF3_SANDBOX_DATA_ROOT 配置的目录。
• 沙箱不提交 AF3 任务，不进入 Celery，也不调度 GPU。
• 沙箱不自动关联 PPI、RNA-seq、PAE、pLDDT 或接触残基表。
• 沙箱不允许用户上传任意结构文件。
• 本次结果证明浏览器三维查看路径可行，不等于正式 AF3 stage 已完成。