dsh-bash-terminal-ts 0.6.0 → 0.6.2

package/dist/client.core.js

@@ -90,7 +90,7 @@ function ShellPreferenceRow({ t, useStore, setShell }) {
             style: !writable ? { opacity: 0.5, cursor: "not-allowed" } : void 0,
             children: [
               t("shell." + shell),
-              /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_dsh_client_ui_primitives.IconChevronDownOutline14, { className: "btChevron" })
+              /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_dsh_client_ui_primitives.IconChevronDownOutlineMedium, { className: "btChevron" })
             ]
           }
         )
@@ -98,6 +98,7 @@ function ShellPreferenceRow({ t, useStore, setShell }) {
     )
   ] });
 }
+var zhDictTitle = () => zh["shell.title"] ?? "\u7EC8\u7AEF";
 function apply(ctx) {
   ctx.effect(() => ctx.locale.register(SETTINGS_NS, { zh, en }), "bash-terminal: settings dictionaries");
   const scope = ctx.configForms.get(ENTRY_ID);
@@ -117,12 +118,13 @@ function apply(ctx) {
     bound?.sync(snap.value?.defaultShell, snap.revision, snap.writable);
   };
   ctx.slots.inject(
-    "settings.general.item",
+    "dsh-family.tab",
     () => ctx.slots.register(
       {
-        name: "settings.general.item",
+        name: "dsh-family.tab",
         id: "bash-terminal-shell",
-        order: 20,
+        order: 60,
+        label: () => zhDictTitle(),
         store,
         locale: SETTINGS_NS,
         inject: (actions) => {

package/dist/client.js

@@ -95,7 +95,7 @@ function ShellPreferenceRow({ t, useStore, setShell }) {
             style: !writable ? { opacity: 0.5, cursor: "not-allowed" } : void 0,
             children: [
               t("shell." + shell),
-              /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_dsh_client_ui_primitives.IconChevronDownOutline14, { className: "btChevron" })
+              /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_dsh_client_ui_primitives.IconChevronDownOutlineMedium, { className: "btChevron" })
             ]
           }
         )
@@ -103,6 +103,7 @@ function ShellPreferenceRow({ t, useStore, setShell }) {
     )
   ] });
 }
+var zhDictTitle = () => zh["shell.title"] ?? "\u7EC8\u7AEF";
 function apply(ctx) {
   ctx.effect(() => ctx.locale.register(SETTINGS_NS, { zh, en }), "bash-terminal: settings dictionaries");
   const scope = ctx.configForms.get(ENTRY_ID);
@@ -122,12 +123,13 @@ function apply(ctx) {
     bound?.sync(snap.value?.defaultShell, snap.revision, snap.writable);
   };
   ctx.slots.inject(
-    "settings.general.item",
+    "dsh-family.tab",
     () => ctx.slots.register(
       {
-        name: "settings.general.item",
+        name: "dsh-family.tab",
         id: "bash-terminal-shell",
-        order: 20,
+        order: 60,
+        label: () => zhDictTitle(),
         store,
         locale: SETTINGS_NS,
         inject: (actions) => {

package/dsh.plugin.json

@@ -1,7 +1,7 @@
 {
   "id": "dsh-bash-terminal",
   "name": "dsh-bash-terminal",
-  "version": "0.3.18",
+  "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 设置中选择。"
@@ -13,7 +13,7 @@
   },
   "license": "MIT",
   "engines": {
-    "dsh": ">=0.1.5-alpha.1 <0.2.0-0"
+    "dsh": ">=0.1.7-rc.1 <0.1.8-0"
   },
   "components": {
     "host": "lib/index.js",

package/lib/client.js

@@ -95,7 +95,7 @@ function ShellPreferenceRow({ t, useStore, setShell }) {
             style: !writable ? { opacity: 0.5, cursor: "not-allowed" } : void 0,
             children: [
               t("shell." + shell),
-              /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_dsh_client_ui_primitives.IconChevronDownOutline14, { className: "btChevron" })
+              /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_dsh_client_ui_primitives.IconChevronDownOutlineMedium, { className: "btChevron" })
             ]
           }
         )
@@ -103,6 +103,7 @@ function ShellPreferenceRow({ t, useStore, setShell }) {
     )
   ] });
 }
+var zhDictTitle = () => zh["shell.title"] ?? "\u7EC8\u7AEF";
 function apply(ctx) {
   ctx.effect(() => ctx.locale.register(SETTINGS_NS, { zh, en }), "bash-terminal: settings dictionaries");
   const scope = ctx.configForms.get(ENTRY_ID);
@@ -122,12 +123,13 @@ function apply(ctx) {
     bound?.sync(snap.value?.defaultShell, snap.revision, snap.writable);
   };
   ctx.slots.inject(
-    "settings.general.item",
+    "dsh-family.tab",
     () => ctx.slots.register(
       {
-        name: "settings.general.item",
+        name: "dsh-family.tab",
         id: "bash-terminal-shell",
-        order: 20,
+        order: 60,
+        label: () => zhDictTitle(),
         store,
         locale: SETTINGS_NS,
         inject: (actions) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-bash-terminal-ts",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "publishConfig": {
     "tag": "dsh-0.1.7"
   },
@@ -29,7 +29,7 @@
   ],
   "engines": {
     "node": ">=22",
-    "dsh": ">=0.1.7-rc.1 <0.2.0-0"
+    "dsh": ">=0.1.7-rc.1 <0.1.8-0"
   },
   "type": "module",
   "main": "lib/index.js",
@@ -74,17 +74,17 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-tools": ">=0.1.7-rc.1 <0.2.0-0",
-    "@deepseek-ai/dsh-settings": ">=0.1.7-rc.1 <0.2.0-0",
-    "@deepseek-ai/dsh-llm": ">=0.1.7-rc.1 <0.2.0-0",
-    "@deepseek-ai/dsh-shell": ">=0.1.7-rc.1 <0.2.0-0",
-    "@deepseek-ai/dsh-sandbox": ">=0.1.7-rc.1 <0.2.0-0",
-    "@deepseek-ai/dsh-timeout": ">=0.1.7-rc.1 <0.2.0-0",
-    "@deepseek-ai/dsh-client-store": ">=0.1.7-rc.1 <0.2.0-0",
-    "@deepseek-ai/dsh-client-locale": ">=0.1.7-rc.1 <0.2.0-0",
-    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.7-rc.1 <0.2.0-0",
-    "@deepseek-ai/dsh-client-ui-slots": ">=0.1.7-rc.1 <0.2.0-0",
-    "@deepseek-ai/dsh-client-ui-primitives": ">=0.1.7-rc.1 <0.2.0-0",
+    "@deepseek-ai/dsh-tools": ">=0.1.7-rc.1 <0.1.8-0",
+    "@deepseek-ai/dsh-settings": ">=0.1.7-rc.1 <0.1.8-0",
+    "@deepseek-ai/dsh-llm": ">=0.1.7-rc.1 <0.1.8-0",
+    "@deepseek-ai/dsh-shell": ">=0.1.7-rc.1 <0.1.8-0",
+    "@deepseek-ai/dsh-sandbox": ">=0.1.7-rc.1 <0.1.8-0",
+    "@deepseek-ai/dsh-timeout": ">=0.1.7-rc.1 <0.1.8-0",
+    "@deepseek-ai/dsh-client-store": ">=0.1.7-rc.1 <0.1.8-0",
+    "@deepseek-ai/dsh-client-locale": ">=0.1.7-rc.1 <0.1.8-0",
+    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.7-rc.1 <0.1.8-0",
+    "@deepseek-ai/dsh-client-ui-slots": ">=0.1.7-rc.1 <0.1.8-0",
+    "@deepseek-ai/dsh-client-ui-primitives": ">=0.1.7-rc.1 <0.1.8-0",
     "react": "^18.2.0"
   },
   "dependencies": {
@@ -93,23 +93,27 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-client-locale": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-store": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-settings": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-slots": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-llm": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-sandbox": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-settings": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-shell": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-timeout": "0.1.5-rc.2",
-    "@deepseek-ai/dsh-tools": "0.1.5-rc.2",
+    "@deepseek-ai/dsh-client-locale": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-store": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-llm": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-sandbox": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-settings": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-shell": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-timeout": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-tools": "0.1.7-rc.2",
     "@types/node": "^22.10.0",
     "@types/react": "^18.2.0",
     "@types/react-dom": "^18.2.0",
     "esbuild": "^0.28.2",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
-    "typescript": "^5.9.0"
+    "typescript": "^5.9.0",
+    "@deepseek-ai/dsh-scope": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-subprocess": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-sandbox-policy": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-http-proxy": "0.1.7-rc.2"
   }
 }

package/screenshots.json

@@ -1,5 +1,5 @@
-{
-  "screenshots": [
-    "assets/shells.png"
-  ]
-}
+{
+  "screenshots": [
+    "assets/shells.png"
+  ]
+}

package/src/client.tsx

@@ -1,186 +1,192 @@
-// dsh-bash-terminal 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).
-//
-// The row offers one entry per host shell id — powershell / gitbash / msys2 /
-// wsl — in the same order as SHELLS in ./index.ts.
-//
-// DSH >= 0.1.5: the browser module table (PLATFORM_MODULES) seeds react,
-// @deepseek-ai/cordis, @deepseek-ai/dsh-client-store, @deepseek-ai/dsh-client-ui-slots,
-// @deepseek-ai/dsh-client-ui-primitives and @deepseek-ai/dsh-client-ui-dockkit by
-// exact bare specifier. The old dsh-client-runtime name is gone from that table
-// (and so is its /client subpath), so this bundle requests dsh-client-store.
-
-import { useState } from "react";
-import { defineStore } from "@deepseek-ai/dsh-client-store";
-import { IconChevronDownOutline14, Menu } from "@deepseek-ai/dsh-client-ui-primitives";
-
-const SETTINGS_NS = "settings.bash-terminal";
-/** Entry id of this plugin in the active profile (cordis.patch.yml). */
-const ENTRY_ID = "tool-bash-terminal";
-const SHELLS = ["powershell", "gitbash", "msys2", "wsl"] as const;
-
-type ShellOption = (typeof SHELLS)[number];
-
-// Injected once when the browser loads the bundle (node tests guard on document).
-const 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.pluginCss = "bash-terminal-row";
-  tag.textContent = ROW_CSS;
-  document.head.appendChild(tag);
-}
-
-const zh: Record<string, string> = {
-  "shell.title": "默认终端",
-  "shell.description": "shell 工具执行命令时使用的终端",
-  "shell.powershell": "PowerShell",
-  "shell.gitbash": "Git Bash",
-  "shell.msys2": "MSYS2",
-  "shell.wsl": "WSL"
-};
-const en: Record<string, string> = {
-  "shell.title": "Default terminal",
-  "shell.description": "Terminal used by the shell tool",
-  "shell.powershell": "PowerShell",
-  "shell.gitbash": "Git Bash",
-  "shell.msys2": "MSYS2",
-  "shell.wsl": "WSL"
-};
-
-export const inject = ["slots", "locale", "configForms"];
-
-/** Row state snapshot served through the settings store. */
-interface RowState {
-  shell: string;
-  revision: number;
-  writable: boolean;
-}
-
-interface ShellPreferenceRowProps {
-  t: (key: string) => string;
-  useStore: <S>(selector: (state: RowState) => S) => S;
-  setShell: (id: string) => void;
-}
-
-function ShellPreferenceRow({ t, useStore, setShell }: ShellPreferenceRowProps) {
-  const shell = useStore((s) => s.shell);
-  const writable = useStore((s) => s.writable);
-  const [open, setOpen] = useState(false);
-  const items = SHELLS.map((id) => ({ id, label: t("shell." + id) }));
-  return (
-    <div className="btRow">
-      <div className="btRowText">
-        <div className="btTitle">{t("shell.title")}</div>
-        <div className="btDesc">{t("shell.description")}</div>
-      </div>
-      <Menu
-        open={open}
-        onClose={() => setOpen(false)}
-        items={items}
-        selectedId={shell}
-        onSelect={(id) => {
-          setOpen(false);
-          setShell(id);
-        }}
-        align="end"
-        portal
-        anchor={
-          <button
-            type="button"
-            className="btSelector"
-            aria-haspopup="menu"
-            aria-expanded={open}
-            disabled={!writable}
-            onClick={() => setOpen(!open)}
-            style={!writable ? { opacity: 0.5, cursor: "not-allowed" } : undefined}
-          >
-            {t("shell." + shell)}
-            <IconChevronDownOutline14 className="btChevron" />
-          </button>
-        }
-      />
-    </div>
-  );
-}
-
-interface SettingsSnapshot {
-  status: "loading" | "ready" | "unavailable";
-  value?: { defaultShell?: string };
-  revision: number | undefined;
-  writable: boolean;
-}
-
-interface ConfigFormBinding {
-  getSnapshot(): SettingsSnapshot;
-  subscribe(fn: () => void): () => void;
-  set(field: string, value: string): Promise<boolean>;
-  unset(field: string): Promise<boolean>;
-}
-
-interface ClientContext {
-  effect(fn: () => unknown, name?: string): unknown;
-  locale: { register(ns: string, dicts: Record<string, Record<string, string>>): unknown };
-  configForms: { get(entryId: string): ConfigFormBinding };
-  slots: {
-    inject(slot: string, fn: () => unknown, name?: string): void;
-    register(options: Record<string, unknown>, Component: unknown): Record<string, unknown>;
-  };
-}
-
-interface RowStoreActions {
-  sync(shell?: string, revision?: number, writable?: boolean): void;
-}
-
-interface RowStore {
-  actions: RowStoreActions;
-}
-
-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 }),
-    actions: {
-      sync: (d, shell, revision, writable) => {
-        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;
-      }
-    }
-  });
-  let bound: RowStoreActions | undefined;
-  const push = (snap: SettingsSnapshot): void => {
-    bound?.sync(snap.value?.defaultShell, snap.revision, snap.writable);
-  };
-  ctx.slots.inject(
-    "settings.general.item",
-    () =>
-      ctx.slots.register(
-        {
-          name: "settings.general.item",
-          id: "bash-terminal-shell",
-          order: 20,
-          store,
-          locale: SETTINGS_NS,
-          inject: (actions: unknown) => {
-            bound = actions as RowStoreActions;
-            push(scope.getSnapshot());
-            return { setShell: (value: string) => void scope.set("defaultShell", value) };
-          }
-        },
-        ShellPreferenceRow
-      ),
-    "bash-terminal: settings row"
-  );
-  ctx.effect(() => scope.subscribe(() => push(scope.getSnapshot())), "bash-terminal: settings watch");
-}
+// dsh-bash-terminal 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).
+//
+// The row offers one entry per host shell id — powershell / gitbash / msys2 /
+// wsl — in the same order as SHELLS in ./index.ts.
+//
+// DSH >= 0.1.5: the browser module table (PLATFORM_MODULES) seeds react,
+// @deepseek-ai/cordis, @deepseek-ai/dsh-client-store, @deepseek-ai/dsh-client-ui-slots,
+// @deepseek-ai/dsh-client-ui-primitives and @deepseek-ai/dsh-client-ui-dockkit by
+// exact bare specifier. The old dsh-client-runtime name is gone from that table
+// (and so is its /client subpath), so this bundle requests dsh-client-store.
+
+import { useState } from "react";
+import { defineStore } from "@deepseek-ai/dsh-client-store";
+import { IconChevronDownOutlineMedium, Menu } from "@deepseek-ai/dsh-client-ui-primitives";
+
+const SETTINGS_NS = "settings.bash-terminal";
+/** Entry id of this plugin in the active profile (cordis.patch.yml). */
+const ENTRY_ID = "tool-bash-terminal";
+const SHELLS = ["powershell", "gitbash", "msys2", "wsl"] as const;
+
+type ShellOption = (typeof SHELLS)[number];
+
+// Injected once when the browser loads the bundle (node tests guard on document).
+const 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.pluginCss = "bash-terminal-row";
+  tag.textContent = ROW_CSS;
+  document.head.appendChild(tag);
+}
+
+const zh: Record<string, string> = {
+  "shell.title": "默认终端",
+  "shell.description": "shell 工具执行命令时使用的终端",
+  "shell.powershell": "PowerShell",
+  "shell.gitbash": "Git Bash",
+  "shell.msys2": "MSYS2",
+  "shell.wsl": "WSL"
+};
+const en: Record<string, string> = {
+  "shell.title": "Default terminal",
+  "shell.description": "Terminal used by the shell tool",
+  "shell.powershell": "PowerShell",
+  "shell.gitbash": "Git Bash",
+  "shell.msys2": "MSYS2",
+  "shell.wsl": "WSL"
+};
+
+export const inject = ["slots", "locale", "configForms"];
+
+/** Row state snapshot served through the settings store. */
+interface RowState {
+  shell: string;
+  revision: number;
+  writable: boolean;
+}
+
+interface ShellPreferenceRowProps {
+  t: (key: string) => string;
+  useStore: <S>(selector: (state: RowState) => S) => S;
+  setShell: (id: string) => void;
+}
+
+function ShellPreferenceRow({ t, useStore, setShell }: ShellPreferenceRowProps) {
+  const shell = useStore((s) => s.shell);
+  const writable = useStore((s) => s.writable);
+  const [open, setOpen] = useState(false);
+  const items = SHELLS.map((id) => ({ id, label: t("shell." + id) }));
+  return (
+    <div className="btRow">
+      <div className="btRowText">
+        <div className="btTitle">{t("shell.title")}</div>
+        <div className="btDesc">{t("shell.description")}</div>
+      </div>
+      <Menu
+        open={open}
+        onClose={() => setOpen(false)}
+        items={items}
+        selectedId={shell}
+        onSelect={(id) => {
+          setOpen(false);
+          setShell(id);
+        }}
+        align="end"
+        portal
+        anchor={
+          <button
+            type="button"
+            className="btSelector"
+            aria-haspopup="menu"
+            aria-expanded={open}
+            disabled={!writable}
+            onClick={() => setOpen(!open)}
+            style={!writable ? { opacity: 0.5, cursor: "not-allowed" } : undefined}
+          >
+            {t("shell." + shell)}
+            <IconChevronDownOutlineMedium className="btChevron" />
+          </button>
+        }
+      />
+    </div>
+  );
+}
+
+interface SettingsSnapshot {
+  status: "loading" | "ready" | "unavailable";
+  value?: { defaultShell?: string };
+  revision: number | undefined;
+  writable: boolean;
+}
+
+interface ConfigFormBinding {
+  getSnapshot(): SettingsSnapshot;
+  subscribe(fn: () => void): () => void;
+  set(field: string, value: string): Promise<boolean>;
+  unset(field: string): Promise<boolean>;
+}
+
+interface ClientContext {
+  effect(fn: () => unknown, name?: string): unknown;
+  locale: { register(ns: string, dicts: Record<string, Record<string, string>>): unknown };
+  configForms: { get(entryId: string): ConfigFormBinding };
+  slots: {
+    inject(slot: string, fn: () => unknown, name?: string): void;
+    register(options: Record<string, unknown>, Component: unknown): Record<string, unknown>;
+  };
+}
+
+interface RowStoreActions {
+  sync(shell?: string, revision?: number, writable?: boolean): void;
+}
+
+interface RowStore {
+  actions: RowStoreActions;
+}
+
+/** 账本 label：从 zh/en 字典取「默认终端」标题（无宿主 locale 依赖）。 */
+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 }),
+    actions: {
+      sync: (d, shell, revision, writable) => {
+        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;
+      }
+    }
+  });
+  let bound: RowStoreActions | undefined;
+  const push = (snap: SettingsSnapshot): void => {
+    bound?.sync(snap.value?.defaultShell, snap.revision, snap.writable);
+  };
+  // 插件族共用设置 tab（dsh-thinking-levels 顶级「起子插件设置」节声明该子席位）。
+  // thinking-levels 缺席时本 inject 静默等待，不阻塞客户端半。
+  ctx.slots.inject(
+    "dsh-family.tab",
+    () =>
+      ctx.slots.register(
+        {
+          name: "dsh-family.tab",
+          id: "bash-terminal-shell",
+          order: 60,
+          label: () => zhDictTitle(),
+          store,
+          locale: SETTINGS_NS,
+          inject: (actions: unknown) => {
+            bound = actions as RowStoreActions;
+            push(scope.getSnapshot());
+            return { setShell: (value: string) => void scope.set("defaultShell", value) };
+          }
+        },
+        ShellPreferenceRow
+      ),
+    "bash-terminal: settings row"
+  );
+  ctx.effect(() => scope.subscribe(() => push(scope.getSnapshot())), "bash-terminal: settings watch");
+}