前言¶
在 DeepSeek Harness（DSH）裏做 VASP 相關智能體或工作流時，對話窗口往往被 INCAR、POSCAR、POTCAR 片段佔滿；而「選哪套 PAW 勢、ZVAL/ENMAX 是多少、ENCUT 怎麼估、MAGMOM 起始值怎麼寫」仍要反覆翻 Wiki、對照 POTCAR 頭、查 Materials Project 慣例。把這些查表動作收進側欄獨立面板，且不啓動 Python、不讀寫計算目錄，是 bowenphys/dsh-vasp-periodic-table 的定位。下面介紹它是什麼、能做什麼、如何安裝與典型用法。
這是什麼¶
@dsh-vasp/periodic-table（倉庫 bowenphys/dsh-vasp-periodic-table）是面向 VASP 用戶的 DeepSeek Harness Web 插件，維護者爲 bowenphys；在社區目錄 skillhub.cn 中分類爲「記憶」。它是純客戶端 bundle：Host 側幾乎爲空，不發起 RPC、不讀寫計算目錄；PBE PAW 數據來自 VASP Wiki「Available PAW potentials」表，並與只讀共享 POTCAR 庫的頭部（ZVAL / ENMAX / POMASS）覈對；元素基礎數據來自 pymatgen，初始磁矩參考 Materials Project MPRelaxSet 慣例。代碼以 MIT License 發佈，當前 package 版本爲 1.0.0。
激活後，左側欄會出現「元素週期表」圖標；點擊後在中央 main 面板打開週期表，不佔用對話窗口。
核心功能¶
週期表與檢索¶
118 個元素，18 族佈局並含鑭系/錒系兩行；支持按符號、中文名、英文名或原子序數搜索。表格提供五種着色：分類、磁性傾向、ENMAX、價電子數（ZVAL）、電負性（帶圖例）。插件會記住上次的着色模式、選中元素、體系構建狀態與動效檔位（localStorage）。
元素詳情與 PAW 勢¶
選中元素後可查看原子量、週期/族/區、電子排布、電負性、半徑、氧化態、熔點、密度等；右側列出該元素全部 PBE PAW 數據集，含 ZVAL、ENMAX，以及 Wiki 默認與推薦標記，點擊可切換當前數據集。
建議 ENCUT 按項目慣例計算：max(500 eV, ⌈1.3 × ENMAX⌉)，向上取整到 10 eV（500 eV 爲默認下限）。初始 MAGMOM 給出 Materials Project 慣例值及按氧化態的備選，並標註爲起始猜測而非收斂磁矩。對重元素給出 SOC「建議評估」提示，而非強制開啓。
詳情頁還提供 Canvas 原子軌道可視化（由 config 電子排布推導，並與當前 POTCAR 價電子構型對照）、POTCAR 數據集切換器、全屏軌道舞臺與 PNG 導出等；性能上 Canvas 上限 30 fps，滾出視口或頁面隱藏時暫停，prefers-reduced-motion 下可只顯示靜態幀。頂欄可切換「動效：開 / 省電」（省電模式關閉裝飾動畫，保留軌道 Canvas 與全部功能）。
可複製片段¶
一鍵複製 POSCAR 元素行、POTCAR 拼接命令、以及含 ENCUT / ISPIN / MAGMOM 等的 INCAR 片段，減少手工拼字符串。
多元素體系構建¶
用 Shift+點擊週期表單元格，或在詳情頁「加入體系」，選中多個元素並填寫各元素原子數後，可自動生成：
- POSCAR 第 6/7 行（元素順序 + 原子數）；
- 按順序、默認推薦數據集的 POTCAR 拼接命令；
- MAGMOM（
n*μB計數寫法）及 ENCUT、ISPIN 相關 INCAR 片段。
獨立插件邊界¶
不依賴 @dsh-vasp/plugin 或 VASP 計算核心；可單獨安裝與刪除。它是選勢與參數參考工具，不替代收斂測試；ENCUT 公式與初始磁矩均爲項目經驗或起始猜測。
安裝與啓用¶
倉庫已包含構建好的 lib/client.js，安裝時無需先本地構建。
方式一：DSH 插件管理器¶
在 DSH 桌面端插件管理器中選擇從本地目錄安裝，目錄指向倉庫根目錄（需包含 package.json、index.js、cordis.patch.yml）。
方式二：命令行¶
在已取得倉庫根目錄（含 package.json、index.js、cordis.patch.yml）的前提下，在命令行執行：
dsh plugin --profile <profile> add file:/絕對路徑/dsh-vasp-periodic-table
將 <profile> 換成你的 DSH profile，將 file: 後的路徑換成該倉庫在本機上的絕對路徑。
激活後左側欄出現「元素週期表」，打開即進入獨立面板。若自行修改源碼，需依次執行 node scripts/check-elements.mjs、node scripts/build-client.mjs、node scripts/smoke-client.mjs 重新生成 lib/client.js，並重啓 DSH 宿主以加載新模塊。
典型用法¶
- 在 DSH 中打開側欄「元素週期表」，進入 main 面板。
- 搜索或點擊目標元素（例如過渡金屬），在 PAW 勢表中切換數據集，對照 ZVAL、ENMAX 與推薦標記。
- 查看建議 ENCUT 與 MP 慣例 MAGMOM，按需複製 INCAR 片段或 POTCAR 拼接命令。
- 構建多元素體系：Shift+點擊多個元素，填寫原子數，複製生成的 POSCAR 行、POTCAR 命令與 MAGMOM/ENCUT 片段到實際算例目錄（插件本身不寫計算目錄）。
光標懸停週期表單元格時，HUD 信息卡可實時顯示當前 PBE 數據集、ZVAL、ENMAX、ENCUT、MAGMOM 等讀數，便於快速比對後再複製。
適用場景與注意¶
適合在 DSH 內頻繁查 PAW 勢、ENCUT 下限與 MAGMOM 起始值的 VASP 用戶，以及需要在智能體側欄快速生成 POSCAR/POTCAR/INCAR 片段的開發者。數據口徑詳見倉庫 docs/data-elements.md、docs/data-paw.md。
安裝前請自行閱讀源碼與 MIT 許可證；插件以當前 DSH 進程權限在客戶端運行，雖聲明不讀寫計算目錄、不發起 RPC，仍應對第三方插件保持常規審計習慣。DSH 社區插件目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；發現插件可依賴倉庫 GitHub topic dsh-plugin（本倉庫另含 dsh、vasp、periodic-table 等輔助 topic）。
結尾¶
dsh-vasp-periodic-table 把 VASP 日常查表——PAW 勢、ZVAL/ENMAX、MAGMOM、ENCUT 與 POTCAR 拼接——收斂到 DSH 側欄一頁，並以純客戶端方式運行。目錄頁：https://www.skillhub.cn/plugins/bowenphys/dsh-vasp-periodic-table；源碼與 README：https://github.com/bowenphys/dsh-vasp-periodic-table。
