前言¶
在 DSH Web 的文件浏览器中，原始的文本预览对于生物分子或小分子文件来说往往缺乏直观性。dsh-file-explorer-preview-molstar 插件通过覆盖默认预览行为，为 .cif、.pdb 等格式提供了交互式的 3D 模型渲染能力。
插件简介¶
这是一个 DSH Web 插件，由 wolfsonliu 维护。它基于 Mol* 技术栈，在文件浏览器中为结构生物学数据提供可视化支持，替代原本的纯文本展示。
核心功能¶
- 3D 查看器：基于
molstar构建，使用PluginContext和最小画布，不包含完整的 Mol* UI。 - 表示与颜色：支持 Auto、Cartoon、Ball & Stick、Molecular surface 等表示预设。颜色选项包括默认、按链、按实体。
- 交互控制：支持重置相机、旋转开关，并跟随 DSH 的深色/浅色背景切换。
- 状态栏：显示格式徽章以及原子、残基、链的数量统计。
- 本地化：工具栏和状态栏支持中文/英文切换。
- 大文件处理：支持超过 2 MiB 的文本文件（
text-large类型）以及二进制.bcif文件，通过readRawFile获取原始字节。
安装与启用¶
安装该插件需要先确保已安装并启用了 dsh-file-explorer 核心插件（版本 v0.1.0 或更高）。
dsh plugin --profile web add github:wolfsonliu/dsh-file-explorer-preview-molstar
dsh web
典型用法¶
- 在文件浏览器中选中
.cif、.pdb或支持的格式文件。 - 预览面板将渲染出交互式 3D 模型。
- 通过菜单中的 “Open with…” 选项打开模型。
- 使用 “spin toggle” 功能旋转模型。
注意事项¶
- 浏览器要求：需要支持 WebGL 的浏览器。
- 权限：只读预览，不支持编辑。
- 文件范围：轨迹和密度图（
.dcd,.nc,.map）不在支持范围内。 - 依赖版本：必须配合
dsh-file-explorerv0.1.0 或更高版本使用。
总结¶
该插件通过集成 Mol* 引擎，极大地提升了 DSH Web 在处理生物结构数据时的可视化体验。开发者可以通过 GitHub 仓库查看源码或提交问题。
