前言¶
DSH 的理念是「一切皆插件」：把工具、流程和上下文封裝成可組合的能力。社區目錄是獨立站點，與 DeepSeek、幻方無官方從屬關係，也不是官方應用商店。對於要在 DSH 中操作 SCNet 超級計算集羣的場景，SSH 配置、Slurm 作業、集羣探測和計算節點診斷常常分散在手工步驟裏。lql341/dsh-scnet 把這些能力打包成 DSH bundle，供 dsh 調用。
這是什麼¶
dsh-scnet 是 lql341 維護的社區 DSH bundle，用於操作 SCNet 超級計算集羣。它屬於聯網工具類插件，提供 profile 化 SSH、Slurm 作業生成、集羣探測和計算節點診斷等能力。
它是獨立社區項目，兼容 DeepSeek Harness，但不是官方 DeepSeek 產品，也不暗示背書、合作或授權。許可證爲 MIT。
核心能力¶
下面介紹已包含的能力：
scnet-hpcskill：爲 SSH、Slurm、離線計算節點和加速器驗證提供 profile 化操作指導。scnet_list_clusters：列出打包的集羣 profile。scnet_show_cluster：在報告資源約束前讀取所選 profile。scnet_generate_job：生成適配 profile 的加速器或純 CPU Slurm 腳本。scnet_setup_ssh：經顯式用戶確認後配置本地 SSH 密鑰和 host 條目。scnet_probe_cluster：基於只讀登錄節點探測生成初始 profile。scnet_refresh_cluster：刷新時效性 profile 字段，計算探測爲可選。scnet_run_compute_probe：提交最小計算節點能力探測。
安裝與啓用¶
先通過 dsh 將 bundle 安裝到 web profile：
dsh plugin --profile web add dsh-scnet
安裝完成後，檢查 bundle 層是否出現在當前 profile 配置中：
dsh --profile web --dump-config
這兩步分別完成安裝和確認。
運行環境¶
使用它需要滿足以下條件：
- Node.js 22.19 或更高版本
- DeepSeek Harness
dsh - Linux 或 macOS 原生 shell 執行
- Windows 需通過 WSL2；捆綁 Bash 腳本不支持原生 Windows
- 遠程操作需要 SCNet 賬戶和集羣憑證
本地同步與驗證¶
如果需要從本地路徑同步 scnet-hpc 相關內容，可以執行：
./sync.sh --src ../scnet-hpc
這一步用於從指定目錄同步內容，避免手工維護重複材料。
在本地做包檢查時，可以執行：
npm install --no-package-lock --ignore-scripts
npm run validate
npm pack --dry-run
這些命令分別用於安裝依賴、驗證包和做 dry-run 打包檢查。
典型工作流¶
可以先按以下順序理解使用路徑：
1、用 scnet_list_clusters 列出打包的集羣 profile。
2、用 scnet_show_cluster 讀取所選 profile，再判斷資源約束。
3、用 scnet_generate_job 生成適配 profile 的加速器或純 CPU Slurm 腳本。
4、用 scnet_setup_ssh 在顯式用戶確認後配置本地 SSH 密鑰和 host 條目。
5、用 scnet_probe_cluster 基於只讀登錄節點探測生成初始 profile。
6、用 scnet_refresh_cluster 刷新時效性 profile 字段；如需計算探測，再啓用可選計算探測。
7、用 scnet_run_compute_probe 提交最小計算節點能力探測。
安全邊界¶
使用這些能力時需要關注：
- 倉庫和 npm 包不得包含私鑰、token、用戶名、私有端點或本地探測緩存。
- SSH 配置、遠程探測和 Slurm 提交屬於狀態變更操作，需要明確目標和用戶授權。
- 生成的 Slurm 文件可能包含本地用戶名，並被 Git 忽略。
- 集羣規格和調度策略因 profile 而異，需要對照目標環境驗證。
- MIT 許可證要求再分發時保留版權聲明和 MIT 許可證聲明；軟件按原樣提供。
由於它隨當前 dsh 會話執行，會受當前 dsh 進程權限影響。安裝前建議檢查源碼、依賴、許可證和目標 profile。
適用場景¶
它適合：
- 在 DSH 中操作 SCNet 集羣
- 需要生成適配 profile 的 Slurm 作業
- 需要查看集羣 profile 和做登錄節點探測
- 需要提交最小計算節點能力探測
它不適合：
- 期待 DeepSeek 官方產品背書
- 在原生 Windows 上直接運行捆綁 Bash 腳本
- 目標集羣規格未驗證就按固定配置執行
