dsh-bash-terminal-ts 0.6.2 → 0.6.4

package/README.en.md

@@ -1,4 +1,4 @@
-# dsh-bash-terminal
+# dsh-bash-terminal-ts
 
 > Community: [LINUX DO](https://linux.do) · [GitHub](https://github.com/drscrewdriver/dsh-bash-terminal-ts)
 
@@ -10,7 +10,7 @@ A DeepSeek Harness (DSH) plugin: one `shell` tool that runs commands through **P
 >
 > | Branch | DSH segment | Package name | Status |
 > |--------|-------------|--------------|--------|
-> | `ts/0.1.5` | 0.1.5-alpha.1 – 0.1.5-rc.x | `dsh-bash-terminal` | this branch; `build` / `unit` / `apply` / `client` / `terminal` green locally |
+> | `ts/0.1.5` | 0.1.5-alpha.1 – 0.1.5-rc.x | `dsh-bash-terminal-ts` | this branch; `build` / `unit` / `apply` / `client` / `terminal` green locally |
 > | `main` | 0.1.2-alpha.1 – 0.1.2-rc.x | `dsh-bash-terminal-ts` | the TypeScript rewrite's mainline |
 >
 > The two lines **deliberately use different package names**, so they install side by side without overwriting each other. Pick the branch that covers your DSH build.
@@ -37,11 +37,11 @@ The **Default terminal** row in Settings -> General: the user picks PowerShell /
 
 ## Install
 
-The package ships the official `dsh.bundle` manifest (its own `cordis.patch.yml`): listing `dsh-bash-terminal` in a profile's `dsh.profile.bundles` auto-applies the mount — no manual profile edits.
+The package ships the official `dsh.bundle` manifest (its own `cordis.patch.yml`): listing `dsh-bash-terminal-ts` in a profile's `dsh.profile.bundles` auto-applies the mount — no manual profile edits.
 
 ```powershell
-npm install -g dsh-bash-terminal
-dsh plugin --profile web add dsh-bash-terminal        # adds to profile bundles + applies the patch
+npm install -g dsh-bash-terminal-ts
+dsh plugin --profile web add dsh-bash-terminal-ts        # adds to profile bundles + applies the patch
 powershell -ExecutionPolicy Bypass -File install.ps1 install   # patches the DSH settings-UI allowlist (see below)
 # restart dsh web
 ```

package/README.md

@@ -1,4 +1,4 @@
-# dsh-bash-terminal
+# dsh-bash-terminal-ts
 
 > 🌐 [English](README.en.md) · 社区交流：[LINUX DO](https://linux.do) · [GitHub](https://github.com/drscrewdriver/dsh-bash-terminal-ts)
 
@@ -10,7 +10,7 @@ DSH（DeepSeek Harness）插件：一个 `shell` 工具，在 Windows 上统一
 >
 > | 分支 | DSH 段 | 包名 | 状态 |
 > |------|--------|------|------|
-> | `ts/0.1.5` | 0.1.5-alpha.1 – 0.1.5-rc.x | `dsh-bash-terminal` | 本分支；`build` / `unit` / `apply` / `client` / `terminal` 本机全绿 |
+> | `ts/0.1.5` | 0.1.5-alpha.1 – 0.1.5-rc.x | `dsh-bash-terminal-ts` | 本分支；`build` / `unit` / `apply` / `client` / `terminal` 本机全绿 |
 > | `main` | 0.1.2-alpha.1 – 0.1.2-rc.x | `dsh-bash-terminal-ts` | TypeScript 重写主线 |
 >
 > **两条线刻意使用不同包名**，因此可以并存安装、互不覆盖。请按你的 DSH 版本选分支。
@@ -46,8 +46,8 @@ DSH（DeepSeek Harness）插件：一个 `shell` 工具，在 Windows 上统一
 
 ```powershell
 # 1. 安装插件包
-npm install -g dsh-bash-terminal
-dsh plugin --profile web add dsh-bash-terminal   # 自动加进 profile 的 bundles 并应用 patch
+npm install -g dsh-bash-terminal-ts
+dsh plugin --profile web add dsh-bash-terminal-ts   # 自动加进 profile 的 bundles 并应用 patch
 
 # 2. patch DSH 设置白名单（DSH 限制，见下方说明）
 powershell -ExecutionPolicy Bypass -File install.ps1 install
@@ -55,21 +55,21 @@ powershell -ExecutionPolicy Bypass -File install.ps1 install
 # 3. 重启 dsh web
 ```
 
-> 已用临时 profile 实测：`bundles: [dsh-bash-terminal]` → dump-config 自动出现 `tool-bash-terminal` entry。
+> 已用临时 profile 实测：`bundles: [dsh-bash-terminal-ts]` → dump-config 自动出现 `tool-bash-terminal` entry。
 
 ### 本地开发安装（junction 直连，改源码即时生效）
 
 ```powershell
 # 1. 链接插件包到 profile 的 node_modules（junction，改源码即时生效）
 $profile = "$env:USERPROFILE\.dsh\profiles\web"
-New-Item -ItemType Junction -Path "$profile\node_modules\dsh-bash-terminal" -Target "D:\workspace\projects\dsh-bash-terminal" | Out-Null
+New-Item -ItemType Junction -Path "$profile\node_modules\dsh-bash-terminal-ts" -Target "D:\workspace\projects\dsh-bash-terminal-ts" | Out-Null
 
 # 2. 让插件能解析 @deepseek-ai/* 依赖（junction 到 profile 的依赖树，插件与宿主共用同一份模块实例）
-New-Item -ItemType Junction -Path "D:\workspace\projects\dsh-bash-terminal\node_modules\@deepseek-ai" -Target "$profile\..\node_modules\@deepseek-ai" | Out-Null
+New-Item -ItemType Junction -Path "D:\workspace\projects\dsh-bash-terminal-ts\node_modules\@deepseek-ai" -Target "$profile\..\node_modules\@deepseek-ai" | Out-Null
 
-# 3. 让 profile 通过官方 bundle 挂载插件（install.ps1 install 会自动做；等价于在 dsh.profile.bundles 加 "dsh-bash-terminal"）
+# 3. 让 profile 通过官方 bundle 挂载插件（install.ps1 install 会自动做；等价于在 dsh.profile.bundles 加 "dsh-bash-terminal-ts"）
 # 4. （仅修改前端源码后）重新打包 client bundle:
-#    cd D:\workspace\projects\dsh-bash-terminal && node scripts/build-client.mjs
+#    cd D:\workspace\projects\dsh-bash-terminal-ts && node scripts/build-client.mjs
 # 5. 重启 dsh web
 ```
 
@@ -84,12 +84,12 @@ New-Item -ItemType Junction -Path "D:\workspace\projects\dsh-bash-terminal\node_
 > 另：0.1.5 的 Web 设置面改为 `settings.describe()` 动态枚举，**不再有 namespace 白名单**
 > （`settings-not-exposed` 已不存在），`install.ps1` 里的白名单 patch 只是历史遗留、可忽略。
 
-> 当前已不再需要手动改 profile 的 `cordis.patch.yml`：插件包内自带 `dsh.bundle.patch`（包内 `cordis.patch.yml`），只要 profile 的 `dsh.profile.bundles` 里有 `dsh-bash-terminal`，DSH 就会自动挂载。
+> 当前已不再需要手动改 profile 的 `cordis.patch.yml`：插件包内自带 `dsh.bundle.patch`（包内 `cordis.patch.yml`），只要 profile 的 `dsh.profile.bundles` 里有 `dsh-bash-terminal-ts`，DSH 就会自动挂载。
 
 验证组合树（无需重启）：
 
 ```powershell
-node "$env:APPDATA\nvm\<node-version>\node_modules\@deepseek-ai\dsh\lib\bin.js" --profile web --dump-config | Select-String dsh-bash-terminal
+node "$env:APPDATA\nvm\<node-version>\node_modules\@deepseek-ai\dsh\lib\bin.js" --profile web --dump-config | Select-String dsh-bash-terminal-ts
 ```
 
 ## 使用
@@ -132,7 +132,7 @@ node "$env:APPDATA\nvm\<node-version>\node_modules\@deepseek-ai\dsh\lib\bin.js"
 npm 账号已启用 2FA 发布验证，需一次性验证码：
 
 ```powershell
-cd D:\workspace\projects\dsh-bash-terminal
+cd D:\workspace\projects\dsh-bash-terminal-ts
 npm publish --otp <验证码>   # 验证码来自你的认证器
 ```
 
@@ -146,9 +146,9 @@ npm publish --otp <验证码>   # 验证码来自你的认证器
 powershell -ExecutionPolicy Bypass -File install.ps1 uninstall
 ```
 
-它会删除 junction、恢复设置白名单、清理旧版遗留的 `cordis.patch.yml` 挂载块，并从 `dsh.profile.bundles` 移除 `dsh-bash-terminal`。之后重启 dsh web 即可。
+它会删除 junction、恢复设置白名单、清理旧版遗留的 `cordis.patch.yml` 挂载块，并从 `dsh.profile.bundles` 移除 `dsh-bash-terminal-ts`。之后重启 dsh web 即可。
 
-手动卸载时，除了删除 `node_modules\dsh-bash-terminal`，还要记得从 profile `package.json` 的 `dsh.profile.bundles` 中移除 `dsh-bash-terminal`。
+手动卸载时，除了删除 `node_modules\dsh-bash-terminal-ts`，还要记得从 profile `package.json` 的 `dsh.profile.bundles` 中移除 `dsh-bash-terminal-ts`。
 
 ## 交互式终端（terminal 工具）
 
@@ -194,7 +194,7 @@ powershell -ExecutionPolicy Bypass -File install.ps1 uninstall
 ## 测试
 
 ```powershell
-cd D:\workspace\projects\dsh-bash-terminal
+cd D:\workspace\projects\dsh-bash-terminal-ts
 npm install          # 安装依赖（含 typescript）
 npm run build        # tsc 编译 src/*.ts → lib/*.js；client.tsx → lib/client.js + dist/client.js；test/*.ts → test-dist/
 npm test             # node test-dist/unit.js → apply.js → client.js → terminal.js

package/cordis.patch.yml

@@ -1,5 +1,5 @@
-# dsh-bash-terminal bundle layer — applied automatically when a profile lists
+# dsh-bash-terminal-ts bundle layer — applied automatically when a profile lists
 # this package in dsh.profile.bundles (dsh.bundle.patch declaration).
 - insert:
     - id: tool-bash-terminal
-      name: 'dsh-bash-terminal'
+      name: 'dsh-bash-terminal-ts'

package/dist/client.core.js

@@ -33,7 +33,7 @@ var SHELLS = ["powershell", "gitbash", "msys2", "wsl"];
 var ROW_CSS = ".btRow{border-bottom:1px solid var(--dsw-alias-border-l2);align-items:center;gap:8px;padding:16px 0;display:flex}.btRowText{flex-direction:column;flex:1;gap:4px;min-width:0;padding-right:48px;display:flex}.btTitle{color:var(--dsw-alias-label-primary);font-size:14px;font-weight:400;line-height:22px}.btDesc{color:var(--dsw-alias-label-tertiary);font-size:12px;font-weight:400;line-height:18px}.btSelector{background:var(--dsw-alias-bg-module-platform);height:36px;font:inherit;color:var(--dsw-alias-label-primary);cursor:pointer;border:none;border-radius:18px;align-items:center;gap:12px;padding:0 14px;font-size:14px;line-height:22px;display:inline-flex}.btSelector:hover{background:var(--dsw-alias-interactive-bg-hover)}.btChevron{flex:none}";
 if (typeof document !== "undefined" && document.querySelector('style[data-plugin-css="bash-terminal-row"]') === null) {
   const tag = document.createElement("style");
-  tag.dataset.plugin = "dsh-bash-terminal";
+  tag.dataset.plugin = "dsh-bash-terminal-ts";
   tag.dataset.pluginCss = "bash-terminal-row";
   tag.textContent = ROW_CSS;
   document.head.appendChild(tag);
@@ -44,7 +44,8 @@ var zh = {
   "shell.powershell": "PowerShell",
   "shell.gitbash": "Git Bash",
   "shell.msys2": "MSYS2",
-  "shell.wsl": "WSL"
+  "shell.wsl": "WSL",
+  "shell.unavailable": "\u8BBE\u7F6E\u9762\u4E0D\u53EF\u7528\uFF1A\u5BBF\u4E3B\u672A\u63D0\u4F9B\u672C\u63D2\u4EF6\u7684 configForms \u6761\u76EE\uFF08\u68C0\u67E5 cordis.patch.yml \u7684 entry id\uFF09"
 };
 var en = {
   "shell.title": "Default terminal",
@@ -52,14 +53,22 @@ var en = {
   "shell.powershell": "PowerShell",
   "shell.gitbash": "Git Bash",
   "shell.msys2": "MSYS2",
-  "shell.wsl": "WSL"
+  "shell.wsl": "WSL",
+  "shell.unavailable": "Settings unavailable: the host exposes no configForms entry for this plugin (check the cordis.patch.yml entry id)"
 };
 var inject = ["slots", "locale", "configForms"];
 function ShellPreferenceRow({ t, useStore, setShell }) {
   const shell = useStore((s) => s.shell);
   const writable = useStore((s) => s.writable);
+  const status = useStore((s) => s.status);
   const [open, setOpen] = (0, import_react.useState)(false);
   const items = SHELLS.map((id) => ({ id, label: t("shell." + id) }));
+  if (status === "unavailable") {
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "btRow", children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "btRowText", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "btTitle", children: t("shell.title") }),
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "btDesc", children: t("shell.unavailable") })
+    ] }) });
+  }
   return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "btRow", children: [
     /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "btRowText", children: [
       /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "btTitle", children: t("shell.title") }),
@@ -103,19 +112,20 @@ function apply(ctx) {
   ctx.effect(() => ctx.locale.register(SETTINGS_NS, { zh, en }), "bash-terminal: settings dictionaries");
   const scope = ctx.configForms.get(ENTRY_ID);
   const store = (0, import_dsh_client_store.defineStore)({
-    init: () => ({ shell: "powershell", revision: -1, writable: false }),
+    init: () => ({ shell: "powershell", revision: -1, writable: false, status: "loading" }),
     actions: {
-      sync: (d, shell, revision, writable) => {
+      sync: (d, shell, revision, writable, status) => {
         if (revision !== void 0 && revision <= d.revision) return;
         if (shell !== void 0) d.shell = shell;
         if (revision !== void 0) d.revision = revision;
         if (writable !== void 0) d.writable = writable;
+        if (status !== void 0) d.status = status;
       }
     }
   });
   let bound;
   const push = (snap) => {
-    bound?.sync(snap.value?.defaultShell, snap.revision, snap.writable);
+    bound?.sync(snap.value?.defaultShell, snap.revision, snap.writable, snap.status);
   };
   ctx.slots.inject(
     "dsh-family.tab",

package/dist/client.js

@@ -1,5 +1,5 @@
 window.__ModuleLoader__.load({
-	id: "dsh-bash-terminal",
+	id: "dsh-bash-terminal-ts",
 	factory: (require) => {
 		var module = { exports: {} };
 		var exports = module.exports;
@@ -38,7 +38,7 @@ var SHELLS = ["powershell", "gitbash", "msys2", "wsl"];
 var ROW_CSS = ".btRow{border-bottom:1px solid var(--dsw-alias-border-l2);align-items:center;gap:8px;padding:16px 0;display:flex}.btRowText{flex-direction:column;flex:1;gap:4px;min-width:0;padding-right:48px;display:flex}.btTitle{color:var(--dsw-alias-label-primary);font-size:14px;font-weight:400;line-height:22px}.btDesc{color:var(--dsw-alias-label-tertiary);font-size:12px;font-weight:400;line-height:18px}.btSelector{background:var(--dsw-alias-bg-module-platform);height:36px;font:inherit;color:var(--dsw-alias-label-primary);cursor:pointer;border:none;border-radius:18px;align-items:center;gap:12px;padding:0 14px;font-size:14px;line-height:22px;display:inline-flex}.btSelector:hover{background:var(--dsw-alias-interactive-bg-hover)}.btChevron{flex:none}";
 if (typeof document !== "undefined" && document.querySelector('style[data-plugin-css="bash-terminal-row"]') === null) {
   const tag = document.createElement("style");
-  tag.dataset.plugin = "dsh-bash-terminal";
+  tag.dataset.plugin = "dsh-bash-terminal-ts";
   tag.dataset.pluginCss = "bash-terminal-row";
   tag.textContent = ROW_CSS;
   document.head.appendChild(tag);
@@ -49,7 +49,8 @@ var zh = {
   "shell.powershell": "PowerShell",
   "shell.gitbash": "Git Bash",
   "shell.msys2": "MSYS2",
-  "shell.wsl": "WSL"
+  "shell.wsl": "WSL",
+  "shell.unavailable": "\u8BBE\u7F6E\u9762\u4E0D\u53EF\u7528\uFF1A\u5BBF\u4E3B\u672A\u63D0\u4F9B\u672C\u63D2\u4EF6\u7684 configForms \u6761\u76EE\uFF08\u68C0\u67E5 cordis.patch.yml \u7684 entry id\uFF09"
 };
 var en = {
   "shell.title": "Default terminal",
@@ -57,14 +58,22 @@ var en = {
   "shell.powershell": "PowerShell",
   "shell.gitbash": "Git Bash",
   "shell.msys2": "MSYS2",
-  "shell.wsl": "WSL"
+  "shell.wsl": "WSL",
+  "shell.unavailable": "Settings unavailable: the host exposes no configForms entry for this plugin (check the cordis.patch.yml entry id)"
 };
 var inject = ["slots", "locale", "configForms"];
 function ShellPreferenceRow({ t, useStore, setShell }) {
   const shell = useStore((s) => s.shell);
   const writable = useStore((s) => s.writable);
+  const status = useStore((s) => s.status);
   const [open, setOpen] = (0, import_react.useState)(false);
   const items = SHELLS.map((id) => ({ id, label: t("shell." + id) }));
+  if (status === "unavailable") {
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "btRow", children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "btRowText", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "btTitle", children: t("shell.title") }),
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "btDesc", children: t("shell.unavailable") })
+    ] }) });
+  }
   return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "btRow", children: [
     /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "btRowText", children: [
       /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "btTitle", children: t("shell.title") }),
@@ -108,19 +117,20 @@ function apply(ctx) {
   ctx.effect(() => ctx.locale.register(SETTINGS_NS, { zh, en }), "bash-terminal: settings dictionaries");
   const scope = ctx.configForms.get(ENTRY_ID);
   const store = (0, import_dsh_client_store.defineStore)({
-    init: () => ({ shell: "powershell", revision: -1, writable: false }),
+    init: () => ({ shell: "powershell", revision: -1, writable: false, status: "loading" }),
     actions: {
-      sync: (d, shell, revision, writable) => {
+      sync: (d, shell, revision, writable, status) => {
         if (revision !== void 0 && revision <= d.revision) return;
         if (shell !== void 0) d.shell = shell;
         if (revision !== void 0) d.revision = revision;
         if (writable !== void 0) d.writable = writable;
+        if (status !== void 0) d.status = status;
       }
     }
   });
   let bound;
   const push = (snap) => {
-    bound?.sync(snap.value?.defaultShell, snap.revision, snap.writable);
+    bound?.sync(snap.value?.defaultShell, snap.revision, snap.writable, snap.status);
   };
   ctx.slots.inject(
     "dsh-family.tab",

package/dsh.plugin.json

@@ -1,22 +1,22 @@
-{
-  "id": "dsh-bash-terminal",
-  "name": "dsh-bash-terminal",
-  "version": "0.6.1",
-  "description": {
-    "en": "One shell tool that runs commands through PowerShell, Git Bash, MSYS2 or WSL on Windows, with a user-chosen default terminal in the Web UI settings.",
-    "zh": "一个 shell 工具，可在 Windows 上通过 PowerShell / Git Bash / MSYS2 / WSL 执行命令，默认终端在 Web UI 设置中选择。"
-  },
-  "homepage": "https://github.com/drscrewdriver/dsh-bash-terminal-ts",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/drscrewdriver/dsh-bash-terminal-ts.git"
-  },
-  "license": "MIT",
-  "engines": {
-    "dsh": ">=0.1.7-rc.1 <0.1.8-0"
-  },
-  "components": {
-    "host": "lib/index.js",
-    "client": "dist/client.js"
-  }
-}
+{
+  "id": "dsh-bash-terminal-ts",
+  "name": "dsh-bash-terminal-ts",
+  "version": "0.6.4",
+  "description": {
+    "en": "One shell tool that runs commands through PowerShell, Git Bash, MSYS2 or WSL on Windows, with a user-chosen default terminal in the Web UI settings.",
+    "zh": "一个 shell 工具，可在 Windows 上通过 PowerShell / Git Bash / MSYS2 / WSL 执行命令，默认终端在 Web UI 设置中选择。"
+  },
+  "homepage": "https://github.com/drscrewdriver/dsh-bash-terminal-ts",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/drscrewdriver/dsh-bash-terminal-ts.git"
+  },
+  "license": "MIT",
+  "engines": {
+    "dsh": ">=0.1.7-rc.1 <0.1.8-0"
+  },
+  "components": {
+    "host": "lib/index.js",
+    "client": "dist/client.js"
+  }
+}

package/lib/client.js

@@ -1,5 +1,5 @@
 window.__ModuleLoader__.load({
-	id: "dsh-bash-terminal",
+	id: "dsh-bash-terminal-ts",
 	factory: (require) => {
 		var module = { exports: {} };
 		var exports = module.exports;
@@ -38,7 +38,7 @@ var SHELLS = ["powershell", "gitbash", "msys2", "wsl"];
 var ROW_CSS = ".btRow{border-bottom:1px solid var(--dsw-alias-border-l2);align-items:center;gap:8px;padding:16px 0;display:flex}.btRowText{flex-direction:column;flex:1;gap:4px;min-width:0;padding-right:48px;display:flex}.btTitle{color:var(--dsw-alias-label-primary);font-size:14px;font-weight:400;line-height:22px}.btDesc{color:var(--dsw-alias-label-tertiary);font-size:12px;font-weight:400;line-height:18px}.btSelector{background:var(--dsw-alias-bg-module-platform);height:36px;font:inherit;color:var(--dsw-alias-label-primary);cursor:pointer;border:none;border-radius:18px;align-items:center;gap:12px;padding:0 14px;font-size:14px;line-height:22px;display:inline-flex}.btSelector:hover{background:var(--dsw-alias-interactive-bg-hover)}.btChevron{flex:none}";
 if (typeof document !== "undefined" && document.querySelector('style[data-plugin-css="bash-terminal-row"]') === null) {
   const tag = document.createElement("style");
-  tag.dataset.plugin = "dsh-bash-terminal";
+  tag.dataset.plugin = "dsh-bash-terminal-ts";
   tag.dataset.pluginCss = "bash-terminal-row";
   tag.textContent = ROW_CSS;
   document.head.appendChild(tag);
@@ -49,7 +49,8 @@ var zh = {
   "shell.powershell": "PowerShell",
   "shell.gitbash": "Git Bash",
   "shell.msys2": "MSYS2",
-  "shell.wsl": "WSL"
+  "shell.wsl": "WSL",
+  "shell.unavailable": "\u8BBE\u7F6E\u9762\u4E0D\u53EF\u7528\uFF1A\u5BBF\u4E3B\u672A\u63D0\u4F9B\u672C\u63D2\u4EF6\u7684 configForms \u6761\u76EE\uFF08\u68C0\u67E5 cordis.patch.yml \u7684 entry id\uFF09"
 };
 var en = {
   "shell.title": "Default terminal",
@@ -57,14 +58,22 @@ var en = {
   "shell.powershell": "PowerShell",
   "shell.gitbash": "Git Bash",
   "shell.msys2": "MSYS2",
-  "shell.wsl": "WSL"
+  "shell.wsl": "WSL",
+  "shell.unavailable": "Settings unavailable: the host exposes no configForms entry for this plugin (check the cordis.patch.yml entry id)"
 };
 var inject = ["slots", "locale", "configForms"];
 function ShellPreferenceRow({ t, useStore, setShell }) {
   const shell = useStore((s) => s.shell);
   const writable = useStore((s) => s.writable);
+  const status = useStore((s) => s.status);
   const [open, setOpen] = (0, import_react.useState)(false);
   const items = SHELLS.map((id) => ({ id, label: t("shell." + id) }));
+  if (status === "unavailable") {
+    return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "btRow", children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "btRowText", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "btTitle", children: t("shell.title") }),
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "btDesc", children: t("shell.unavailable") })
+    ] }) });
+  }
   return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "btRow", children: [
     /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: "btRowText", children: [
       /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: "btTitle", children: t("shell.title") }),
@@ -108,19 +117,20 @@ function apply(ctx) {
   ctx.effect(() => ctx.locale.register(SETTINGS_NS, { zh, en }), "bash-terminal: settings dictionaries");
   const scope = ctx.configForms.get(ENTRY_ID);
   const store = (0, import_dsh_client_store.defineStore)({
-    init: () => ({ shell: "powershell", revision: -1, writable: false }),
+    init: () => ({ shell: "powershell", revision: -1, writable: false, status: "loading" }),
     actions: {
-      sync: (d, shell, revision, writable) => {
+      sync: (d, shell, revision, writable, status) => {
         if (revision !== void 0 && revision <= d.revision) return;
         if (shell !== void 0) d.shell = shell;
         if (revision !== void 0) d.revision = revision;
         if (writable !== void 0) d.writable = writable;
+        if (status !== void 0) d.status = status;
       }
     }
   });
   let bound;
   const push = (snap) => {
-    bound?.sync(snap.value?.defaultShell, snap.revision, snap.writable);
+    bound?.sync(snap.value?.defaultShell, snap.revision, snap.writable, snap.status);
   };
   ctx.slots.inject(
     "dsh-family.tab",

package/lib/dsh-types.d.ts

@@ -241,7 +241,7 @@ export interface ApprovalSeam {
     request(input: unknown): Promise<unknown>;
 }
 /**
- * The structural context face dsh-bash-terminal programs against: the union
+ * The structural context face dsh-bash-terminal-ts programs against: the union
  * of every `ctx.*` member touched by src/index.ts and src/terminal.ts.
  */
 export interface BashTerminalContext {

package/lib/index.js

@@ -1,4 +1,4 @@
-// dsh-bash-terminal - one shell tool, four Windows terminals.
+// dsh-bash-terminal-ts - one shell tool, four Windows terminals.
 //
 // Registers a model-facing shell tool. The terminal backend (powershell /
 // gitbash / msys2 / wsl) is chosen by the USER in the Web UI settings (default
@@ -249,7 +249,7 @@ function spawnSpec(resolved, argv, env, signal) {
 function collectedOutput(handle) {
     const { stdout, stderr } = handle.collected;
     if (!isCollectedStream(stdout) || !isCollectedStream(stderr)) {
-        throw new Error("dsh-bash-terminal: subprocess implementation dropped a requested collect stream");
+        throw new Error("dsh-bash-terminal-ts: subprocess implementation dropped a requested collect stream");
     }
     return { stdout, stderr };
 }
@@ -290,7 +290,7 @@ async function runForeground(ctx, argv, resolved, env, signal, timeoutMs) {
 function requireSubprocess(ctx) {
     const subprocess = ctx.subprocess;
     if (subprocess === null) {
-        throw new Error("dsh-bash-terminal: ctx.subprocess seam unavailable (missing inject service)");
+        throw new Error("dsh-bash-terminal-ts: ctx.subprocess seam unavailable (missing inject service)");
     }
     return subprocess;
 }
@@ -493,7 +493,7 @@ const BACKGROUND_OUTPUT_PROPERTIES = {
 // ---- plugin -------------------------------------------------------------------
 export function apply(ctx, config = {}) {
     if (process.platform !== "win32") {
-        ctx.logger?.info?.("dsh-bash-terminal: only meaningful on win32; skipping tool registration");
+        ctx.logger?.info?.("dsh-bash-terminal-ts: only meaningful on win32; skipping tool registration");
         return;
     }
     const backgroundEnabled = true;
@@ -509,7 +509,7 @@ export function apply(ctx, config = {}) {
         return typeof got === "string" ? got : DEFAULT_SHELL;
     };
     if (!SHELLS.includes(currentShell())) {
-        throw new Error(`dsh-bash-terminal: invalid defaultShell ${JSON.stringify(currentShell())}`);
+        throw new Error(`dsh-bash-terminal-ts: invalid defaultShell ${JSON.stringify(currentShell())}`);
     }
     /** Official sandbox-escalation surface (mirrors tool-bash): advertise the
      * escalation modes whenever the deployment confines. */
@@ -653,7 +653,7 @@ export function apply(ctx, config = {}) {
             const shell = currentShell();
             const argv0 = buildArgv(shell, v.command, paths, v.distro);
             if (argv0[0] === undefined) {
-                throw new Error(`dsh-bash-terminal: ${shell} backend unavailable - executable not found. Install it or set the corresponding *Path config.`);
+                throw new Error(`dsh-bash-terminal-ts: ${shell} backend unavailable - executable not found. Install it or set the corresponding *Path config.`);
             }
             // Only element 0 (the resolved executable) can be undefined; guarded above.
             const argv = argv0;

package/lib/terminal.js

@@ -1,4 +1,4 @@
-// dsh-bash-terminal: interactive terminal tool over the official PTY seam.
+// dsh-bash-terminal-ts: interactive terminal tool over the official PTY seam.
 // ctx.subprocess.spawnTerminal (node-pty under the hood) allocates a real
 // terminal; this module owns model-facing sessions: open / send / read /
 // signal (Ctrl+C etc.) / close. The backend follows the user's default

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-bash-terminal-ts",
-  "version": "0.6.2",
+  "version": "0.6.4",
   "publishConfig": {
     "tag": "dsh-0.1.7"
   },

package/scripts/build-client.mjs

@@ -1,4 +1,4 @@
-// Build the browser client bundle for dsh-bash-terminal.
+// Build the browser client bundle for dsh-bash-terminal-ts.
 // Output: lib/client.js (primary, consumed by DSH loader/reload precheck) and
 // dist/client.js (legacy compatibility) — a __ModuleLoader__.load({ id, factory })
 // wrapper around the esbuild CJS bundle; shared deps (react, @deepseek-ai/*)
@@ -33,7 +33,7 @@ await build({
 
 const core = readFileSync(join(root, "dist", "client.core.js"), "utf8");
 const wrapper = `window.__ModuleLoader__.load({
-	id: "dsh-bash-terminal",
+	id: "dsh-bash-terminal-ts",
 	factory: (require) => {
 		var module = { exports: {} };
 		var exports = module.exports;

package/src/client.tsx

@@ -1,4 +1,4 @@
-// dsh-bash-terminal client plugin: a "Default terminal" preference row in the
+// dsh-bash-terminal-ts client plugin: a "Default terminal" preference row in the
 // Web UI General settings, mirroring the shipped EnterBehaviorRow grammar
 // (row layout, capsule selector with chevron, --dsw-* tokens).
 //
@@ -33,7 +33,7 @@ const ROW_CSS =
   ".btChevron{flex:none}";
 if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=\"bash-terminal-row\"]") === null) {
   const tag = document.createElement("style");
-  tag.dataset.plugin = "dsh-bash-terminal";
+  tag.dataset.plugin = "dsh-bash-terminal-ts";
   tag.dataset.pluginCss = "bash-terminal-row";
   tag.textContent = ROW_CSS;
   document.head.appendChild(tag);
@@ -45,7 +45,8 @@ const zh: Record<string, string> = {
   "shell.powershell": "PowerShell",
   "shell.gitbash": "Git Bash",
   "shell.msys2": "MSYS2",
-  "shell.wsl": "WSL"
+  "shell.wsl": "WSL",
+  "shell.unavailable": "设置面不可用：宿主未提供本插件的 configForms 条目（检查 cordis.patch.yml 的 entry id）"
 };
 const en: Record<string, string> = {
   "shell.title": "Default terminal",
@@ -53,7 +54,8 @@ const en: Record<string, string> = {
   "shell.powershell": "PowerShell",
   "shell.gitbash": "Git Bash",
   "shell.msys2": "MSYS2",
-  "shell.wsl": "WSL"
+  "shell.wsl": "WSL",
+  "shell.unavailable": "Settings unavailable: the host exposes no configForms entry for this plugin (check the cordis.patch.yml entry id)"
 };
 
 export const inject = ["slots", "locale", "configForms"];
@@ -63,6 +65,7 @@ interface RowState {
   shell: string;
   revision: number;
   writable: boolean;
+  status: "loading" | "ready" | "unavailable";
 }
 
 interface ShellPreferenceRowProps {
@@ -74,8 +77,19 @@ interface ShellPreferenceRowProps {
 function ShellPreferenceRow({ t, useStore, setShell }: ShellPreferenceRowProps) {
   const shell = useStore((s) => s.shell);
   const writable = useStore((s) => s.writable);
+  const status = useStore((s) => s.status);
   const [open, setOpen] = useState(false);
   const items = SHELLS.map((id) => ({ id, label: t("shell." + id) }));
+  if (status === "unavailable") {
+    return (
+      <div className="btRow">
+        <div className="btRowText">
+          <div className="btTitle">{t("shell.title")}</div>
+          <div className="btDesc">{t("shell.unavailable")}</div>
+        </div>
+      </div>
+    );
+  }
   return (
     <div className="btRow">
       <div className="btRowText">
@@ -137,7 +151,7 @@ interface ClientContext {
 }
 
 interface RowStoreActions {
-  sync(shell?: string, revision?: number, writable?: boolean): void;
+  sync(shell?: string, revision?: number, writable?: boolean, status?: RowState["status"]): void;
 }
 
 interface RowStore {
@@ -150,20 +164,21 @@ const zhDictTitle = (): string => (zh as Record<string, string>)["shell.title"]
 export function apply(ctx: ClientContext): void {
   ctx.effect(() => ctx.locale.register(SETTINGS_NS, { zh, en }), "bash-terminal: settings dictionaries");
   const scope = ctx.configForms.get(ENTRY_ID);
-  const store = defineStore<RowState, { sync: (draft: RowState, shell?: string, revision?: number, writable?: boolean) => void }>({
-    init: (): RowState => ({ shell: "powershell", revision: -1, writable: false }),
+  const store = defineStore<RowState, { sync: (draft: RowState, shell?: string, revision?: number, writable?: boolean, status?: RowState["status"]) => void }>({
+    init: (): RowState => ({ shell: "powershell", revision: -1, writable: false, status: "loading" }),
     actions: {
-      sync: (d, shell, revision, writable) => {
+      sync: (d, shell, revision, writable, status) => {
         if (revision !== undefined && revision <= d.revision) return;
         if (shell !== undefined) d.shell = shell;
         if (revision !== undefined) d.revision = revision;
         if (writable !== undefined) d.writable = writable;
+        if (status !== undefined) d.status = status;
       }
     }
   });
   let bound: RowStoreActions | undefined;
   const push = (snap: SettingsSnapshot): void => {
-    bound?.sync(snap.value?.defaultShell, snap.revision, snap.writable);
+    bound?.sync(snap.value?.defaultShell, snap.revision, snap.writable, snap.status);
   };
   // 插件族共用设置 tab（dsh-thinking-levels 顶级「起子插件设置」节声明该子席位）。
   // thinking-levels 缺席时本 inject 静默等待，不阻塞客户端半。

package/src/dsh-types.ts

@@ -294,7 +294,7 @@ export interface ApprovalSeam {
 // ---- plugin context (server side) ----------------------------------------------
 
 /**
- * The structural context face dsh-bash-terminal programs against: the union
+ * The structural context face dsh-bash-terminal-ts programs against: the union
  * of every `ctx.*` member touched by src/index.ts and src/terminal.ts.
  */
 export interface BashTerminalContext {

package/src/index.ts

@@ -1,4 +1,4 @@
-// dsh-bash-terminal - one shell tool, four Windows terminals.
+// dsh-bash-terminal-ts - one shell tool, four Windows terminals.
 //
 // Registers a model-facing shell tool. The terminal backend (powershell /
 // gitbash / msys2 / wsl) is chosen by the USER in the Web UI settings (default
@@ -324,7 +324,7 @@ function spawnSpec(resolved: SpawnResolution, argv: string[], env: Record<string
 function collectedOutput(handle: { collected: { stdout: unknown; stderr: unknown } }) {
   const { stdout, stderr } = handle.collected;
   if (!isCollectedStream(stdout) || !isCollectedStream(stderr)) {
-    throw new Error("dsh-bash-terminal: subprocess implementation dropped a requested collect stream");
+    throw new Error("dsh-bash-terminal-ts: subprocess implementation dropped a requested collect stream");
   }
   return { stdout, stderr };
 }
@@ -395,7 +395,7 @@ async function runForeground(
 function requireSubprocess(ctx: BashTerminalContext) {
   const subprocess = ctx.subprocess;
   if (subprocess === null) {
-    throw new Error("dsh-bash-terminal: ctx.subprocess seam unavailable (missing inject service)");
+    throw new Error("dsh-bash-terminal-ts: ctx.subprocess seam unavailable (missing inject service)");
   }
   return subprocess;
 }
@@ -669,7 +669,7 @@ const BACKGROUND_OUTPUT_PROPERTIES: Record<string, JsonSchemaNode> = {
 
 export function apply(ctx: BashTerminalContext, config: Partial<ConfigValues> = {}): void {
   if (process.platform !== "win32") {
-    ctx.logger?.info?.("dsh-bash-terminal: only meaningful on win32; skipping tool registration");
+    ctx.logger?.info?.("dsh-bash-terminal-ts: only meaningful on win32; skipping tool registration");
     return;
   }
   const backgroundEnabled = true;
@@ -684,7 +684,7 @@ export function apply(ctx: BashTerminalContext, config: Partial<ConfigValues> =
     return typeof got === "string" ? got : DEFAULT_SHELL;
   };
   if (!(SHELLS as readonly string[]).includes(currentShell())) {
-    throw new Error(`dsh-bash-terminal: invalid defaultShell ${JSON.stringify(currentShell())}`);
+    throw new Error(`dsh-bash-terminal-ts: invalid defaultShell ${JSON.stringify(currentShell())}`);
   }
   /** Official sandbox-escalation surface (mirrors tool-bash): advertise the
    * escalation modes whenever the deployment confines. */
@@ -835,7 +835,7 @@ export function apply(ctx: BashTerminalContext, config: Partial<ConfigValues> =
       const shell = currentShell();
       const argv0 = buildArgv(shell, v.command, paths, v.distro);
       if (argv0[0] === undefined) {
-        throw new Error(`dsh-bash-terminal: ${shell} backend unavailable - executable not found. Install it or set the corresponding *Path config.`);
+        throw new Error(`dsh-bash-terminal-ts: ${shell} backend unavailable - executable not found. Install it or set the corresponding *Path config.`);
       }
       // Only element 0 (the resolved executable) can be undefined; guarded above.
       const argv = argv0 as string[];

package/src/terminal.ts

@@ -1,4 +1,4 @@
-// dsh-bash-terminal: interactive terminal tool over the official PTY seam.
+// dsh-bash-terminal-ts: interactive terminal tool over the official PTY seam.
 // ctx.subprocess.spawnTerminal (node-pty under the hood) allocates a real
 // terminal; this module owns model-facing sessions: open / send / read /
 // signal (Ctrl+C etc.) / close. The backend follows the user's default