Files
2026-08-03 18:42:47 +08:00

38 lines
1.7 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 已完成。