前言¶

在 DeepSeek Harness（DSH）里写智能体或看对话时，若需要对照晶体结构、布拉维格子或原子轨道，常见做法是切到教材截图、独立桌面程序或浏览器里的另一个站点。上下文来回切换，讲解和模型很难留在同一块界面里联动。

@nashihang777/dsh-solids-world（社区名 dsh-solids-world，维护者 nashihang777）把桌面应用 solids-world 的渲染层迁入 Harness Web 页面：侧栏增加晶体图标，主面板整页展示图鉴，分步讲解、测验与笔记与 3D 舞台同屏完成。下文介绍定位、能力与安装方式；事实以 GitHub 仓库 README 与 SkillHub 目录页 为准。当前 npm 包版本为 1.0.1，许可证 MIT。

这是什么¶

本插件是 DSH 客户端类 bundle：占用两个现成插槽，表现为 Harness 的一等页面，而不是挂件。宿主半侧几乎不参与图鉴逻辑（index.js）；交互与 3D 在构建产物 client.js 中加载，平台为 web，并按包内 dsh.client.immediately 配置即时挂载。

核心问题：在 Harness 内提供本地、可交互的固体物理与原子物理 3D 图鉴——模型由公式实时生成，不依赖外部模型文件，图鉴浏览与联网解析 CIF 均在页面内完成（CIF 词法、语法与结构提取本地执行）。

核心功能¶

图鉴内容与结构¶

• 53 个中英双语条目，分五个板块：晶体结构（12）、布拉维格子（14）、原子与轨道（11）、对称性（11）、晶格动力学（5）。
• 程序化 3D：球体、化学键、晶胞线框、等值面与动画等按物理公式实时生成。
• 分步讲解：步骤联动镜头对焦与标注高亮；每条附带小测验，通过后与讲解进度一并记入该条目。
• 学习笔记：逐条记录、汇总浏览，一键导出 Markdown（下载 .md）。
• 图鉴画廊：总览全部条目及讲解 / 测验状态。

检索与操控¶

• 搜索：中文、英文、别名与拼音；按 / 聚焦搜索框。
• 3D 操控：1×/2× 超胞、成键开关、原子标签、剖切平面、自旋、复位 / 对焦 / 缩放；轨道类条目另有等值面阈值、相位模式、不透明度、波节面与径向范围；对称与动力学类另有播放、暂停、调速、单步与参数滑块。
• CIF 导入：将 .cif 拖到面板，或使用顶栏「打开 CIF」；语法错误、未知空间群、超出体积上限会有明确提示。
• 双语与主题：中英切换、明暗主题，并遵循系统「减少动态效果」设置。
• 键盘（作用域在面板内，不抢占 Harness 外壳）：方向键切换条目、/ 搜索、F 聚焦舞台、Ctrl/⌘+D 随机一条、Esc 关闭最上层。

与桌面版的差异（迁到 Harness 后）¶

• 移除依赖 react-three-fiber composer 的后处理（如 N8AO、bloom）；postfx 主要决定渲染分辨率档位。
• Electron 菜单改为顶栏按钮；笔记导出为浏览器下载而非原生保存对话框。
• 宽屏窄面板内三栏布局仍保持桌面比例断点逻辑。

设置与笔记保存在页面 localStorage，重启后保留，并与本 profile 其它数据相互独立。

安装与启用¶

插件以当前 DSH 进程与页面权限运行；安装前建议查看 源码 与 MIT 许可及 NOTICE 中的 solids-world 归属说明。

图形界面¶

在 DeepSeek Harness 中依次打开：插件 → 添加插件，写入：

@nashihang777/dsh-solids-world

再选择 安装插件。安装完成后，在侧栏面板区打开「固体世界」（图标位于内置面板图标之后）。

工作区命令行（README 原文）¶

在包含插件目录的工作区内，任选一种：

从 npm 安装（包发布后即可用）：

plugin_manager action=install_bundle target=@nashihang777/dsh-solids-world

从本地目录安装（目录以链接方式装入，改源码后无需重装）：

plugin_manager action=install_bundle target=<本目录的绝对路径>

重新生成 client.js 后需刷新页面或重启 Harness 以加载新的客户端模块。

典型用法¶

1. 安装后从侧栏进入「固体世界」，在画廊或搜索中选定条目。
2. 按分步讲解转动、缩放舞台；必要时打开成键、标签或剖切等控件理解结构。
3. 完成条目内小测验；在笔记区记录要点，需要时导出 Markdown。
4. 若有晶体结构文件，拖到面板或通过「打开 CIF」导入，在本地完成解析与建模（注意体积上限与错误提示）。

开发与构建场景（仅改源码时需要）：在插件目录执行 node scripts/build.mjs 再生 client.js；运行插件本身不需要 npm install 或克隆上游，因 client.js 自包含。仓库还提供 node scripts/smoke.mjs 与 node scripts/check-content.mjs 用于无头检查（见 README「验证」一节）。

适用场景与注意¶

适合：在 DSH 内自学或备课固体物理、材料学、原子物理相关内容；需要与对话上下文同屏对照 3D 模型、走完讲解与测验流程的用户。

注意：

• 插件为客户端 bundle，3D 依赖宿主页面的 WebGL；无 WebGL 的环境只会看到降级提示（仓库 smoke 测试在 jsdom 中即如此）。
• 社区目录 SkillHub 与 DeepSeek / 幻方无官方从属关系；DSH 生态理念是「一切皆插件」，本介绍不构成官方背书。
• 星标与排名以各平台当时数据为准；GitHub 仓库公开信息显示维护者为 nashihang777，包作者字段为 世界航海。

结尾¶

@nashihang777/dsh-solids-world 把 solids-world 的 53 条双语 3D 图鉴、分步测验、笔记与 CIF 导入搬进 Harness 主面板，适合希望「讲、看、记」留在同一 Web 界面里的开发者与学习者。

• 目录页：https://www.skillhub.cn/plugins/nashihang777/dsh-solids-world
• GitHub：https://github.com/nashihang777/dsh-solids-world
• npm：@nashihang777/dsh-solids-world（当前资料版本 1.0.1）