前言¶

在 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）