前言¶
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 脚本
- 目标集群规格未验证就按固定配置执行
