dsh-scnet 0.6.3 → 0.6.5

package/README.md

@@ -4,7 +4,12 @@
 
 DSH-SCNet (`dsh-scnet` on npm) is a community-maintained DSH bundle for operating Supercomputing Network (SCNet). It packages the source [`scnet-hpc`](https://github.com/lql341/scnet-hpc) Skill, profile-aware utilities, and bounded tools for SSH, Slurm, OpenAPI files, regional resources, and Notebook discovery.
 
-Current release: **0.6.3**
+Current release: **0.6.5**
+
+## What's new in 0.6.4
+
+- OpenAPI with AK/SK is preferred for structured cluster operations; SSH remains available for environment setup, compilation, and interactive diagnosis.
+- Ubuntu/Debian users can install `libsecret-tools` for secure local credential storage; it is optional when credentials are provided through environment variables.
 
 > This is an independent community project. It is compatible with DeepSeek Harness but is not an official DeepSeek product and does not imply endorsement, partnership, or authorization by DeepSeek.
 
@@ -130,7 +135,7 @@ synchronizes the skill and version into `dsh-scnet` and `codex-scnet-hpc`. Publi
 `dsh-scnet` npm package only after that downstream change is reviewed.
 
 For a synchronized release, run the package validation on `main`, then trigger the repository's
-`Publish DSH-SCNet` workflow with the exact value from `package.json` (currently `0.6.3`). The
+`Publish DSH-SCNet` workflow with the exact current version from `package.json`. The
 workflow verifies the package/Skill version match, runs validation, creates the tarball, publishes
 stable releases with the `latest` tag, and creates the matching Git tag. Do not bump only
 `package.json`: `skills/scnet-hpc/VERSION`, the package version, and both README release markers

package/README_CN.md

@@ -4,7 +4,12 @@
 
 <p align="center">在 DeepSeek Harness 里操作超算互联网（SCNet）：配置 SSH、管理 Slurm 作业、查询 OpenAPI 区域和文件、检查 Notebook 资源与实例，并保留海光 DCU/DTK 诊断能力。</p>
 
-当前版本：**0.6.3**
+当前版本：**0.6.5**
+
+## 0.6.4 更新
+
+- 结构化集群操作优先使用 OpenAPI AK/SK；环境配置、编译和交互式诊断仍可使用 SSH。
+- Ubuntu/Debian 可安装 `libsecret-tools` 安全保存本地凭据；通过环境变量提供 AK/SK 时无需安装。
 
 > 本项目是独立维护的社区项目，与 DeepSeek Harness 兼容，但不是 DeepSeek 官方产品，也不表示 DeepSeek 对本项目提供背书、合作或授权。
 
@@ -141,7 +146,7 @@ git 源、本地目录安装以及验证步骤见[安装说明](./docs/installat
 才能发布对应版本的 `dsh-scnet` npm 包。
 
 下游同步合并到 `main` 后，先运行本地校验，再手动触发仓库的 `Publish DSH-SCNet` workflow，
-输入 `package.json` 中的精确版本（当前为 `0.6.3`）。workflow 会校验 package 与 Skill
+输入 `package.json` 中的当前版本。workflow 会校验 package 与 Skill
 版本一致，执行验证、生成 tarball、以稳定版 `latest` 标签发布，并创建对应 Git tag。
 不要只修改 `package.json`；`skills/scnet-hpc/VERSION`、package 版本和两份 README 的版本
 标记必须保持一致。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-scnet",
-  "version": "0.6.3",
+  "version": "0.6.5",
   "description": "Community DeepSeek Harness bundle for SCNet SSH and OpenAPI jobs, files, Notebook resources, Slurm diagnostics, and Hygon DCU/DTK guidance.",
   "type": "module",
   "main": "./index.mjs",

package/skills/scnet-hpc/SKILL.md

@@ -5,8 +5,9 @@ description: Configure or operate SCNet HPC through SSH, OpenAPI, and pluggable
 
 # SCNet HPC
 
-Use the selected backend, cluster profile, and target-cluster evidence. SSH is the default;
-OpenAPI is the structured control plane. Never silently switch backends.
+Use OpenAPI AK/SK as the preferred backend for structured cluster operations. Keep SSH as the
+secondary backend for environment setup, compilation, interactive diagnosis, and operations not
+available through the API. Never silently switch backends.
 
 ## First use and selection
 
@@ -14,7 +15,7 @@ OpenAPI is the structured control plane. Never silently switch backends.
 - Advanced OpenAPI discovery: `python3 scripts/scnet.py setup`.
 - Read-only preflight: `python3 scripts/scnet.py doctor`.
 - Backend precedence: `--backend`, `SCNET_HPC_BACKEND`, saved setup choice, profile
-  `DEFAULT_BACKEND`, then `ssh`.
+  `DEFAULT_BACKEND`, then `openapi`.
 - Read `clusters/<cluster>.conf` before reporting static facts. Treat
   `clusters/.cache/<cluster>.auto.conf` as optional, time-sensitive SSH probe data.
 - With multiple profiles, require an explicit cluster before access changes, installation,

package/skills/scnet-hpc/VERSION

@@ -1 +1 @@
-0.6.3
+0.6.5

package/skills/scnet-hpc/clusters/_template.conf

@@ -12,7 +12,7 @@
 # ---- 通用与 SSH 连接 ----
 CLUSTER_ID=""                            # 短名，同时用作 ssh 别名，如 "zzeshell"
 CLUSTER_DESC=""                          # 人类可读描述，如 "海光 DCU（郑州）"
-DEFAULT_BACKEND="ssh"                    # ssh / openapi / 已注册的外部 backend
+DEFAULT_BACKEND="openapi"                # openapi（推荐）/ ssh / 已注册的外部 backend
 SSH_HOST=""                              # 如 "xxx.scnet.cn"
 SSH_PORT="22"
 HOME_BASE="/public/home"                 # 家目录父路径

package/skills/scnet-hpc/references/adding-cluster.md

@@ -142,7 +142,7 @@ Triton 是多种推理框架的运行前提；不可用时，对应的 Triton
 
 | 字段 | 谁用 | 留空的后果 |
 |---|---|---|
-| `DEFAULT_BACKEND` | `scnet.py` | 默认使用 `ssh` |
+| `DEFAULT_BACKEND` | `scnet.py` | 默认使用 `openapi` |
 | `OPENAPI_REGION_ID` | OpenAPI backend | 多区域账户需要每次显式传 `--region` |
 | `OPENAPI_SCHEDULER_ID` | OpenAPI backend | 多调度器区域需要每次显式传 `--scheduler-id` |
 | `MIN_GRES` | 文档提示 | 不提示 QOS 强制申请加速器 |

package/skills/scnet-hpc/references/backends.md

@@ -12,7 +12,7 @@ Backend precedence:
 2. `SCNET_HPC_BACKEND`;
 3. saved setup-panel `default_backend`;
 4. selected profile `DEFAULT_BACKEND`;
-5. `ssh`.
+5. `openapi`.
 
 Do not silently fall back between backends. A failed OpenAPI request must not become an SSH
 submission, and a failed SSH command must not be replayed through OpenAPI. Replaying mutations
@@ -39,7 +39,7 @@ Built-in capability summary:
 | Modules, builds, interactive diagnosis | yes | no |
 | Notebook read-only discovery | no | yes |
 
-Use OpenAPI for structured control-plane work. Use SSH for environment setup, compilation,
+Use OpenAPI as the preferred structured control-plane backend. Use SSH for environment setup, compilation,
 interactive inspection, full scheduler tooling, and operations not represented by a structured
 backend.
 
@@ -168,7 +168,7 @@ until the official interface is available and verified.
 Profiles may contain non-secret backend hints:
 
 ```bash
-DEFAULT_BACKEND="ssh"
+DEFAULT_BACKEND="openapi"
 OPENAPI_REGION_ID=""
 OPENAPI_SCHEDULER_ID=""
 OPENAPI_USERNAME=""

package/skills/scnet-hpc/references/quickstart-en.md

@@ -32,7 +32,8 @@ List available access backends:
 python3 scripts/scnet.py backends
 ```
 
-SSH is the default. Use OpenAPI for structured queue, limit, job, log, and file operations:
+OpenAPI with AK/SK is the preferred default for structured queue, limit, job, log, and file
+operations. Use SSH for environment setup and interactive shell work:
 
 ```bash
 python3 scripts/scnet.py --backend openapi clusters

package/skills/scnet-hpc/scripts/scnet.py

@@ -60,7 +60,7 @@ def build_parser() -> argparse.ArgumentParser:
         "--backend",
         help=(
             "backend name; defaults to SCNET_HPC_BACKEND, saved setup choice, "
-            "profile DEFAULT_BACKEND, then ssh"
+            "profile DEFAULT_BACKEND, then openapi"
         ),
     )
     parser.add_argument("--cluster", help="local cluster profile name")
@@ -220,7 +220,7 @@ def choose_backend(
         or os.environ.get("SCNET_HPC_BACKEND")
         or str(user_config.get("default_backend") or "")
         or profile.get("DEFAULT_BACKEND")
-        or "ssh"
+        or "openapi"
     )
 
 
@@ -943,14 +943,14 @@ def setup_panel(
     print("自动探测区域、调度器和 SSH 元数据；只要求输入必要凭据。\n")
     _print_terminal_help()
 
-    current_default = str(current.get("default_backend") or "ssh")
+    current_default = str(current.get("default_backend") or "openapi")
     if mode == "all":
         backend = _choose(
             "选择默认 backend：",
-            ["SSH（推荐，支持环境和深度诊断）", "OpenAPI（结构化控制面）"],
-            1 if current_default == "ssh" else 2,
+            ["OpenAPI（推荐，结构化控制面）", "SSH（环境配置和深度诊断）"],
+            1 if current_default == "openapi" else 2,
         )
-        default_backend = "ssh" if backend.startswith("SSH") else "openapi"
+        default_backend = "openapi" if backend.startswith("OpenAPI") else "ssh"
         configure_ssh = _ask_yes_no(
             "是否添加或更新一个 SSH 区域？", default=default_backend == "ssh"
         )

package/skills/scnet-hpc/scripts/scnet_backends/profile.py

@@ -58,7 +58,7 @@ def list_profiles(repo_root: Path) -> list[dict[str, str]]:
                 "name": path.stem,
                 "cluster_id": profile.get("CLUSTER_ID", path.stem),
                 "description": profile.get("CLUSTER_DESC", ""),
-                "default_backend": profile.get("DEFAULT_BACKEND", "ssh"),
+                "default_backend": profile.get("DEFAULT_BACKEND", "openapi"),
             }
         )
     return result

package/skills/scnet-hpc/scripts/setup.sh

@@ -345,7 +345,7 @@ case "$(uname -s)" in
             && grep -Eq '^ID=(ubuntu|debian)$' /etc/os-release; then
             printf '%s\n' \
                 "Ubuntu/Debian：在 Terminal 中使用 ↑/↓ 和 Enter，也可输入编号；Ctrl+C 可取消。" \
-                "如需安全保存 AK/SK：sudo apt install libsecret-tools" >&2
+                "本机安全保存 AK/SK 可安装 libsecret-tools（sudo apt install libsecret-tools）；使用环境变量时无需安装。" >&2
         else
             printf '%s\n' "Linux：使用 ↑/↓ 和 Enter，也可输入编号；Ctrl+C 可取消。" >&2
         fi
@@ -382,12 +382,12 @@ fi
 
 if [ -z "$BACKEND" ]; then
     BACKEND=$(choose "选择要管理的 backend：" \
+        "openapi（推荐：平台级 AK/SK 和多区域）" \
         "ssh（区域级用户名和私钥）" \
-        "openapi（平台级 AK/SK 和多区域）" \
         "both（同时管理）")
     case "$BACKEND" in
-        ssh*) BACKEND=ssh ;;
         openapi*) BACKEND=openapi ;;
+        ssh*) BACKEND=ssh ;;
         both*) BACKEND=both ;;
     esac
 fi
@@ -429,7 +429,7 @@ fi
 
 DEFAULT_BACKEND="$BACKEND"
 if [ "$BACKEND" = both ]; then
-    DEFAULT_BACKEND=$(choose "选择默认 backend：" "ssh" "openapi")
+    DEFAULT_BACKEND=$(choose "选择默认 backend：" "openapi" "ssh")
 fi
 
 if [ "$BACKEND" = ssh ] || [ "$BACKEND" = both ]; then