DSH Plugins Marketplace

DSH Plugins

Plugins

/

Tools & Capabilities

/

dsh-polymcrystal-blender

d

dsh-polymcrystal-blender

Manifest valid

Crystallography bridge to Blender for DSH — loads CIF/POSCAR/LAMMPS polymer crystals, unwraps periodic bonds via an isolated Python sidecar, and renders ball-and-stick models in a live Blender 4.2+ GU

hasBundlePatch

SPDX-License-Identifier: GPL-3.0-or-later

dsh-plugin-polycrystal-bridge / PolyCrystal Blender bridge

npm version npm downloads License

DSH × Blender 聚合物晶体结构桥接插件(GPL-3.0-or-later)。加载 CIF/POSCAR/LAMMPS 聚合物晶体,经隔离 Python PBC 引擎处理周期性边界,推送到 Blender 4.2+ GUI(已在 5.3 上端到端验证)供人与 AI 实时协同编辑与出版级渲染。

  • src/ — DSH 宿主插件(纯 ESM JS):环境探测、sidecar venv、127.0.0.1:39888 网关、5 个模型工具。
  • sidecar/ — 隔离 Python 晶体学引擎(pymatgen/spglib/gemmi/ase/vesin):周期键图同调、PBC 聚类展开(默认 pbc_cluster)、bundle.npz 输出。
  • extension/ — Blender 4.2+ 扩展 dsh_polycrystal_ext:反向拨号、N 面板、Geometry Nodes。
  • skills/polymer-crystallography/ — 指导模型的标准操作技能。
  • scripts/ — 扩展打包(pack_extension.py)与 headless 冒烟测试(test_blender_ext.py)。

预览

正交晶体视角球棍近景晶胞框
正交晶体视角球棍近景晶胞框

特性(0.3.1)

  • PBC 聚类展开(默认)。侧车按最小镜像成键、连通分量聚类、沿生成树展开(polycrystal_core/polymer_unwrap.py),链/分子在写出 bundle 前就是连贯实体;ghost、boundary_pad、half_bond 全为 0,渲染键长 ≤ 3.5 Å。periodic_clipped / chain_continuous / hkl_lamella 作为显式回退。
  • 超胞默认 [1,1,1]。输入 CIF 通常已是扩胞结构;需要沿链轴拉伸时显式传 "auto"。
  • 正交相机默认。frame_camera 对 evaluated 几何精确装箱(fill 默认 0.92),支持 azimuth 绕世界 Z 偏航与 a/b/c/chain_axis 晶轴视角;perspective=true 可切回透视。
  • 球面精度默认 3。icosphere 320 面/球(162 顶点),近景轮廓无棱线。
  • 单材质属性着色。一个 DSH_PolyCrystal_Surface 材质,颜色/透明度/自发光/粗糙度/清漆由 col/alpha/glow/rough/coat 几何属性驱动,规避 Blender 5.x Join Geometry 的材质索引重排。
  • 晶胞独立对象。PolyCrystal_UnitCell 只含 12 条晶胞边,设 visible_shadow=False,不再在球面上投出环状阴影条。
  • 默认观感。ghost 原子默认隐藏;自适应三点光 + PolyCrystal_Spec 小面光;竖向渐变世界;AgX Medium High Contrast;球棍 Atom Scale 0.36 / Bond Radius 0.15。
  • 宿主工具。polycrystal_env/load/modify/inspect/render,支持实时改样式、回读 N 面板状态、EEVEE/Cycles 出版级渲染。

改动历史见 CHANGELOG.md,架构与 5.x 兼容细节见 docs/DETAIL.md,开发命令见 AGENTS.md。

安装

  1. DSH 中安装本插件目录(Plugins > Add plugin)。
  2. 首轮对话模型会自动调用 polycrystal_env(action="doctor"),完成 sidecar .venv 构建与 Blender 扩展安装;也可手动执行:
# 打包扩展(仅标准库,无需 Blender)
python scripts/pack_extension.py

# 安装到 Blender 用户扩展目录(非破坏式)
"C:/Program Files/Blender Foundation/Blender 5.3/blender.exe" --command extension install-file \
  -r user_default -e extension/dist/dsh_polycrystal_ext.zip

# 可选:侧车可编辑安装
"<venv>/Scripts/python.exe" -m pip install -e sidecar
  1. polycrystal_env(action="launch_gui") 打开 Blender GUI,之后 polycrystal_load 加载结构。

快速上手

polycrystal_env(action="doctor")
polycrystal_load(file_path="PCLtrue.cif")                 # pbc_cluster + [1,1,1]
polycrystal_modify(style_mode=0, color_scheme=1, highlight_chain_ids=[0])
polycrystal_inspect(include_viewport_capture=true)        # 回读人类在 N 面板的调整
polycrystal_render(resolution=[1600,1200], fill=0.92, orthographic_crystal_axis="c")

N 面板(N → PolyCrystal)提供同样的样式/着色/PBC 开关、AI 编辑暂停、相机与材质锁;AI 每轮修改前应先 polycrystal_inspect。

工具与参数

polycrystal_env

参数类型默认说明
actionenum必填doctor / setup_sidecar / install_blender_ext / launch_gui / list_sessions / claim_session
session_idstring—claim_session 时要认领的实例;省略则认领第一个活跃实例

polycrystal_load

参数类型默认说明
file_pathstring必填.cif / POSCAR / CONTCAR / .xyz / .pdb / LAMMPS .data
supercellint[3] | "auto"[1,1,1]显式扩胞;"auto" 沿链轴扩到至少 2 个周期
pbc_modeenumpbc_clusterpbc_cluster / periodic_clipped / chain_continuous / hkl_lamella
boundary_padnumber[3][0.05,0.05,0.05]legacy 模式的边界填充比例
disorder_filterenumdefaultdefault / all / group_2
backendenumnative_gnnative_gn / batoms / molecularnodes
structure_idstring自动结构稳定 id(默认由文件+参数哈希派生)
session_idstring—目标 Blender 实例

polycrystal_modify

参数类型说明
structure_id / session_idstring目标结构与实例
style_modeint0 球棍 / 1 范德华 / 2 甘草 / 3 主链管+侧链棍
color_schemeint0 CPK / 1 链号 / 2 主链-侧链 / 3 无序组
hide_hydrogensbool隐藏氢及其键
show_backbone_tubebool主链平滑管
show_ghost_atomsbool显示周期边界 ghost 原子(默认关)
show_half_bondsbool显示半键端帽(legacy 模式)
show_unit_cellbool显示晶胞线框
atom_scale / bond_radiusnumber原子缩放 / 键半径
highlight_chain_idsint[]高亮链号
hkl_planenumber[4][h,k,l,shift] 晶面叠加
supercellint[3]新超胞,触发 sidecar 重建
pbc_modeenum新 PBC 模式,触发 sidecar 重建
respect_locksbool默认 true,遵守人类相机/材质锁

polycrystal_inspect

参数类型默认说明
include_viewport_capturebooltrue附带视口 PNG 截图
session_idstring—目标实例

polycrystal_render

参数类型默认说明
engineenumBLENDER_EEVEE_NEXTBLENDER_EEVEE_NEXT / BLENDER_EEVEE / CYCLES(5.x 自动映射到 BLENDER_EEVEE)
samplesint64(E) / 128(C)采样数
resolutionint[2][1600,1200]输出分辨率
orthographic_crystal_axisenumcurrent_user_viewa / b / c / chain_axis / current_user_view
transparentboolfalse透明背景
refitbooltrue分辨率变化后重新装箱(相机锁定时跳过)
fillnumber0.92主体到达画面边缘的比例(0.4–0.98)
output_pathstringstaging/rendersPNG 输出路径
session_idstring—目标实例

测试与打包

# sidecar 单测(20 条)
<venv>/Scripts/python.exe -m pytest sidecar/tests -q

# 扩展 headless 冒烟(49 checks)
"C:/Program Files/Blender Foundation/Blender 5.3/blender.exe" -b --factory-startup \
  --python-exit-code 1 -P scripts/test_blender_ext.py

# 打包扩展 zip -> extension/dist/dsh_polycrystal_ext.zip
python scripts/pack_extension.py

宿主插件本身不打包 Blender,也不向 Blender 内置 Python 安装任何包。

node_modules(宿主包内联)

src/tools/*.js 以官方模式 import { defineTool } from '@deepseek-ai/dsh-tools' 注册工具,但该包未发布到 npm(安装内版本 0.2.2-rc.3),profile 安装的插件无法从 DSH 安装目录解析它。因此本仓库自带 node_modules/(MIT 许可的 @deepseek-ai/{dsh-tools,cordis,schemastery,dsh-scope,dsh-llm,dsh-util-values,cosmokit,dsh-typert-protocol,dsh-util-crypto,dsh-brand,dsh-timeout,dsh-error} + zod,共约 6.7 MB,从本机 DSH 安装 app.asar 提取,与其版本精确匹配)。升级 DSH 后需重新提取同步。若日后 @deepseek-ai/dsh-tools 正式发布,可改为常规依赖。

致谢(Acknowledgments)

本项目站在以下开源项目的肩膀上,感谢这些库的作者与社区:

平台与宿主

  • Blender — Blender Foundation,几何节点程序化建模与渲染宿主(GPL,本插件为其扩展)。
  • DeepSeek Harness (DSH) — 插件宿主与 agent 工具框架;@deepseek-ai/dsh-tools 等运行时依赖(MIT)随仓库 node_modules/ 内联分发。

科学计算核心(sidecar 直接依赖,均为宽松许可)

  • NumPy / SciPy (BSD-3) — 数值与 27 镜像邻居搜索回退。
  • NetworkX (BSD-3) — 周期键图连通分量聚类与生成树展开。

晶体学后端(可选依赖 crystal/fast extra)

  • gemmi (MPL-2.0) — CIF/结构读取与对称操作。
  • spglib (BSD-3) — 空间群识别。
  • ASE (LGPL-2.1) — 周期结构与邻居列表回退。
  • pymatgen (MIT) — 晶体结构分析与晶格操作。
  • vesin (MPL-2.0) — 高性能周期邻居列表。

借鉴与参考

  • batoms 与 Molecular Nodes — Blender 分子/结构可视化的先行者,本插件的可选渲染后端接口与其思路同源(见 interop_backends.py,当前仅作能力检测)。
  • CPK 配色约定(Corey-Pauling-Koltun) — 元素标准着色方案。
  • 单材质 + 几何属性着色的架构,是为规避 Blender 5.x Join Geometry 材质索引重排问题而独立设计;文中相关 5.x 兼容结论均为本仓库实测(见 docs/DETAIL.md)。

约束与许可

  • 不打包、不分发 Blender 本体;要求用户自装 Blender 4.2+(实测 5.3)。
  • 不污染 Blender Python;重型科学计算全部在 DSH 侧隔离 venv。
  • 专属网关 127.0.0.1:39888(可用 DSH_POLYCRYSTAL_PORT 覆盖),绝不监听 9876。
  • 禁 AGPL 代码;本仓库为 GPL-3.0-or-later。

Comments

Loading…

Similar plugins

dsh-image-bridge

by kbpoyo

DSH 插件:让纯文本模型也能看图。Web 端直接粘贴图片即可发送,无需指定图片路径;模型自主调用视觉技能查看,多模态模型原生直通,零skill绑定。

Manifest valid

★ 5

↓ 31/wk

MIT

JavaScript

Aug 14, 2026

dsh plugin --profile web add @kbpoyo/dsh-image-bridge

by Stook-404

DeepSeek Harness plugin: headless Blender modeling with previews and a sidebar panel

Manifest valid

★ 0

MIT

JavaScript

Nov 11, 2026

dsh plugin --profile web add dsh-blender-bridge

by rencl3

DSH plugin + MATLAB daemon bridging AI and MATLAB R2025b via file IPC — 20 matlab_* tools for editor code and Simulink models. No COM, no network.基于文件 IPC 的 AI ↔ MATLAB R2025b 深度交互:读写编辑器代码、创建/修改/运行 Si

Manifest valid

★ 0

MATLAB

Aug 17, 2026

dsh plugin --profile web add dsh-matlab-bridge

by lizhouai

Live balance & usage for every LLM provider, one glance away — a draggable floating ball for DeepSeek Harness / dsh 插件:可拖动悬浮用量球,一眼看清所有 Provider 余额与用量

Manifest valid

★ 4

↓ 313/wk

MIT

TypeScript

Oct 21, 2026

dsh plugin --profile web add dsh-provider-usage

by Socialist-Sister

Multi-agent collaboration suite for DeepSeek Harness: specialist roster with on-demand dispatch, roundtable, model comparison and a multimodal vision bridge — models via the official provider flow.

Workflow & AutomationManifest valid

★ 4

MIT

TypeScript

Aug 19, 2026

dsh plugin --profile web add dsh-collaboration

by Noob-stupid

DSH hardware sandbox plugin: assemble a 3D scene of ESP32 / BME280 / PIR / LED components with protocol- and voltage-checked port wiring, run real Python project code in the loop against simulated I2C

Tools & CapabilitiesManifest valid

★ 3

BSD-3-Clause

TypeScript

Oct 17, 2026

dsh plugin --profile web add @noob-stupid/dsh-breadboard