dsh-gitbash-shell 0.14.0 → 0.16.0

package/README.md

@@ -144,9 +144,30 @@ preset 会被插件自动清理;宿主 shell 回退为 PowerShell。
 > 切换生效后若 `ptc-cordis` 目录已存在且被旧版本物化,删除
 > `~/.dsh/.agent-presets/ptc-cordis` 并重启,即由新逻辑重新物化。
 
-## POSIX 路径指示(v0.7.0)
-
-Windows 上本插件把宿主 shell 换成 Git Bash 的同时,会向**每个会话的系统提示**注入一条全局指示(仅 Win32,走 `systemPrompt.context`,不影响任何 preset/组合文本):**bash 命令里一律用 POSIX 风格路径**(`/c/Users/...`、`/c/Program Files/...`),不要 `C:/...` 或 `C:\...`。这样模型在工具调用里不会再拿 Windows 盘符路径喂给 Git Bash——标准/极简/PTC/创造及用户自建模式全部覆盖,无需任何模式单独改。
+## POSIX 路径方言(v0.7.0 引入,受 `posixPaths` 开关门控)
+
+Windows 上本插件把宿主 shell 换成 Git Bash 的同时,让**模型看到的路径**统一成 MSYS 盘根
+POSIX 形式(`/c/Users/...`、`/c/Program Files/...`)。开关是 settings 命名空间
+`gitbash-shell` 的布尔字段 `posixPaths`,**默认开启**(v0.10.0 起),可在 **设置 → 插件**
+里本插件的「Git Bash 路径方言」卡片上随时切换;不修改任何 preset / 组合文件,标准/极简/
+PTC/创造及用户自建模式一律覆盖。
+
+开启时(仅 Win32),`posixPaths` 门控以下全部行为:
+
+- **提示词源头替换**:组装期(`system-prompt/assemble`)把官方提示词 sections / contexts /
+  variables 里的 Windows 绝对路径**原位**改写成 `/c/...`——不增删任何内容、不动工具 schema;
+- **一句话指示**:经 `systemPrompt.context`(order 126)注入全局指示——shell 是 Git for
+  Windows bash,路径用 MSYS 盘根,所有工具都直接接受这种写法;
+- **参数翻译**:`tools/execute` 上把文件工具的路径参数(`file_path` / `path` / `workdir`)由
+  `/c/...` 翻回 `C:/...` 交给 Node 文件工具;bash 的 `command` 字段不动——那是 Git Bash 母语;
+- **结果回流**:成功结果里的路径元数据(`read`/`write`/`edit` 的 `path`、`glob` 的 `paths[]`、
+  `grep` 的 `matches[].path`)改写回 MSYS 形式;文件内容与错误结果不动;
+- **运行时事实**:向官方 `dsh-shell-env` 注册表贡献 `DSH_PATH_DIALECT=msys`,模型可在执行时
+  核验(随开关实时生效)。
+
+关闭后回到 dsh 原生行为:指示文本为空(组装期直接丢弃,零提示噪声),路径参数与结果元数据
+都不再改写,文件工具收 Windows 路径。**bash 始终是 Git Bash,不受此开关影响**——它只决定
+跨工具的路径方言。
 
 ## 与 dsh-better-sidebar 联动
 
@@ -158,4 +179,4 @@ Windows 上本插件把宿主 shell 换成 Git Bash 的同时,会向**每个会
 
 ## 许可
 
-MIT © KannaKuron。参考与致敬:[dsh-ptc-cordis-preset](https://github.com/KannaKuron/dsh-ptc-cordis-preset)。
+MIT © KannaKuron。参考与致敬:[dsh-ptc-cordis-preset](https://github.com/KannaKuron/dsh-ptc-cordis-preset)。

package/README_EN.md

@@ -83,9 +83,36 @@ the PTC preset is materialized as Git Bash automatically (tool-bash on,
 tool-pwsh off) — no extra mode, no manual edits. Without this plugin the PTC
 preset stays as its own plugin manages it.
 
-## POSIX path directive (v0.7.0)
-
-While replacing the host shell with Git Bash, this plugin also injects one global per-session system-prompt directive (Win32 only, via systemPrompt.context; no preset or composition text is touched): **always use POSIX-style paths in bash commands** (/c/Users/..., /c/Program Files/...) — never C:/... or C:\... . Every mode — standard/minimal/PTC/creation and user-authored presets — is covered; nothing needs a per-mode change.
+## POSIX path dialect (introduced in v0.7.0, gated by the `posixPaths` switch)
+
+While replacing the host shell with Git Bash on Windows, this plugin makes every path the
+model sees use the MSYS drive-root POSIX form (/c/Users/..., /c/Program Files/...). The switch
+is the `posixPaths` boolean in the `gitbash-shell` settings namespace; it is **on by default**
+(since v0.10.0) and can be toggled any time on this plugin's "Git Bash path dialect" card in
+**Settings → Plugins**. No preset or composition file is touched, and every mode —
+standard/minimal/PTC/creation and user-authored presets — is covered.
+
+While it is on (Windows only), `posixPaths` gates all of the following:
+
+- **Source-level rewrite**: during assembly (`system-prompt/assemble`) every Windows absolute
+  path in the official prompt's sections, contexts, and variables is rewritten in place to the
+  /c/... form — nothing is added or removed, and tool schemas stay untouched;
+- **One-sentence directive**: a global directive via `systemPrompt.context` (order 126) — the
+  shell is Git for Windows bash, paths use MSYS drive roots, and every tool accepts that form
+  directly;
+- **Argument translation**: on `tools/execute` the file tools' path arguments (`file_path` /
+  `path` / `workdir`) are translated from /c/... back to C:/... for the Node-backed file tools;
+  a bash command's `command` field is left alone — that is Git Bash's native form;
+- **Result round-trip**: path metadata in successful results (`path` of read/write/edit,
+  `paths[]` of glob, `matches[].path` of grep) flows back in the MSYS form; file contents and
+  error results are untouched;
+- **Runtime fact**: `DSH_PATH_DIALECT=msys` is contributed to the official `dsh-shell-env`
+  registry, so the model can verify the dialect at execution time (it follows the live switch).
+
+With the switch off, dsh-native behavior returns: the directive text is empty (dropped at
+assembly, so zero prompt noise), path arguments and result metadata are no longer rewritten, and
+the file tools receive Windows paths. **Bash stays Git Bash either way** — the switch only
+governs the cross-tool path dialect.
 
 ## Cooperation with dsh-better-sidebar
 
@@ -98,4 +125,4 @@ When [dsh-better-sidebar](https://github.com/omdsh-dev/DSH-better-sidebar) (v0.1
 ## License
 
 MIT © KannaKuron. Inspired by
-[dsh-ptc-cordis-preset](https://github.com/KannaKuron/dsh-ptc-cordis-preset).
+[dsh-ptc-cordis-preset](https://github.com/KannaKuron/dsh-ptc-cordis-preset).

package/assets/cordis-gitbash/agent.cordis.ptc.ps.yml

@@ -34,10 +34,20 @@
 
       Two planes decide where an edit belongs. The HOST composition holds the registries and anything shared across sessions — persistence, the sandbox and approval stack, the model route, the subagent registry and its backends. An AGENT PRESET holds what one session contributes to those registries: its tools, its persona, its prompt sections. A row that publishes a service belongs in the host composition, or inside an `isolate` realm if the preset genuinely owns that service and nothing outside one agent reads it.
 
-      Presets you author live one directory per preset under `${DSH_HOME:-$HOME/.dsh}/.agent-presets/<id>/`; the roster reports each preset's real path, so take the one you edit from there. NEVER edit or delete the shipped preset install (the `agent-presets` directory beside the deployment's own config): it belongs to the deployment, an upgrade overwrites it, and corrupting the `cordis` preset would disable this very mode. To change what a shipped preset does, copy its composition into a new preset directory and edit the copy.
+      Presets you author live one directory per preset under `${DSH_HOME:-$HOME/.dsh}/.agent-presets/<id>/`. Load `editing-cordis-compositions` for file discovery and copying instructions. NEVER edit or delete the shipped preset install (the `agent-presets` directory beside the deployment's own config): it belongs to the deployment, an upgrade overwrites it, and corrupting the `cordis` preset would disable this very mode. To change what a shipped preset does, copy its composition into a new preset directory and edit the copy.
 
       Load the `editing-cordis-compositions` skill before writing or changing a composition.
 
+      Use plugin_manager for persistent bundle installation, removal and enablement in the current profile. Author plugin code and configuration as ordinary workspace bundle files. Changes affect every session in that profile. Read saved-state and activation outcomes separately; restart-required means the new capability is not available yet.
+
+      In Creator mode, requests to make a visual object, decoration, or widget mean creating an installed UI plugin that displays it in this Harness Web UI, unless the user specifies another destination. Choose reasonable visual details and proceed. Load cordis-plugin-development, inspect the Client slots, build the plugin in the workspace, and install it with plugin_manager. Install a minimal working version before visual refinement; use the connected page as its preview. Verify that the open page renders it; a standalone image or HTML file does not complete an in-app creation request.
+
+      Load the cordis-plugin-development skill before authoring an installed plugin. Use cordis_inspect_list to discover Host and Client providers, then cordis_inspect_query to read exact Service, Event, Tool, Theme or Slot APIs. These tools are read-only; queries do not invoke business methods.
+
+      To connect an MCP server, create a configuration-only bundle whose patch inserts @deepseek-ai/dsh-mcp-client, then install it with plugin_manager. Load cordis-plugin-development for the package and YAML examples. After successful activation, call one of the newly available mcp__<serverName>__<tool> tools to verify the connection.
+
+      Use installed bundles for new plugin code. Package installation may require explicit user approval for build scripts. Preserve returned failures and pending states; only report success after observing the requested capability.
+
 - id: agent-instructions
   name: '@deepseek-ai/dsh-agent-instructions'
   config:

package/dsh.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "dsh-external/dsh-gitbash-shell",
-  "version": "0.14.0",
+  "version": "0.16.0",
   "main": "./src/index.js",
   "description": "Windows 全模式 Git Bash:用 Git for Windows bash 替换 PowerShell 执行器,并物化 standard/minimal/code/cordis 的 Git Bash 变体 preset。双 era 适配 dsh <= 0.1.1(内置 id 'code')与 >= 0.1.2(改名 'ptc'),启动探测自动选择,preset id 永不变。联动:dsh-ptc-cordis-preset(两者同装时 PTC 创造模式自动物化为 Git Bash 版)+ dsh-better-sidebar(终端 UI 标签与模型 terminal_* 工具自动切到 Git Bash)。",
   "engines": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-gitbash-shell",
-  "version": "0.14.0",
+  "version": "0.16.0",
   "description": "DSH plugin: run every agent shell command through Git for Windows bash on Windows instead of PowerShell. Replaces the pwsh executor with a Git Bash ctx.shell provider and materializes Git Bash variants of the standard/minimal/code/cordis agent presets into your user preset root at startup. On Windows it also adopts dsh-better-sidebar's terminal shell (UI tabs and the model-facing terminal_* tools) through the sidebar's official settings seam, and pairs with dsh-ptc-cordis-preset so the PTC Creation-mode preset materializes as its Git Bash variant. Ships both composition eras for dsh <= 0.1.1 (built-in preset id 'code') and dsh >= 0.1.2 (renamed id 'ptc') — the era is probed per boot and re-materialized automatically after a dsh upgrade, in either upgrade order; preset ids never change so pinned sessions stay valid.",
   "type": "module",
   "repository": {

package/src/client.js

@@ -21,7 +21,11 @@
  *     (react and @deepseek-ai/dsh-client-ui-primitives only, smoke-enforced);
  *   - plain React.createElement, no JSX/TS; components at module level;
  *   - dsh.client.inject in package.json lists the packages that must load
- *     first so locale / settingsScope / slots exist when this applies.
+ *     first so locale / settingsScope / slots exist when this applies;
+ *   - copy ships in three layers: zh/en inline, one LOCALES entry per third
+ *     language (each preceded by a locale marker line), every dictionary
+ *     key-aligned with zh (smoke-enforced) and read through a live lookup —
+ *     DSH's language preference switches without a page reload.
  */
 window.__ModuleLoader__.load({
 	id: "dsh-gitbash-shell",
@@ -35,6 +39,7 @@ window.__ModuleLoader__.load({
 
 		var E = React.createElement;
 		var useState = React.useState;
+		var useEffect = React.useEffect;
 
 		var TAG = "[gitbash-shell/client]";
 		/** Dictionary namespace (the plugin's own t seat). */
@@ -42,11 +47,15 @@ window.__ModuleLoader__.load({
 		/** The settings namespace the HOST half serves. */
 		var SETTINGS_NAMESPACE = "gitbash-shell";
 
-		// ── dictionaries (zh/en MUST stay key-aligned; smoke-enforced) ─────────
+		// ── dictionaries ────────────────────────────────────────────────────────
+		// zh/en stay inline; the third languages live in LOCALES below, one entry
+		// per language behind a locale marker line. EVERY shipped dictionary MUST
+		// carry zh's exact key set: a missing key falls back to English at lookup
+		// time, which reads as a half-translated card (smoke-enforced).
 
 		var zh = {
 			"title": "Git Bash 路径方言",
-			"cardDesc": "所有工具统一 /c/ POSIX 路径形式(默认关闭)",
+			"cardDesc": "所有工具统一 /c/ POSIX 路径形式(默认开启)",
 			"state.label": "当前状态",
 			"state.on": "已启用",
 			"state.off": "已关闭",
@@ -54,11 +63,13 @@ window.__ModuleLoader__.load({
 			"switch.off": "停用",
 			"error": "写入失败",
 			"hint": "启用后:所有工具(bash 命令与 workdir、read/write/edit/read_image/glob/grep 的路径参数)统一使用 MSYS 盘根 POSIX 路径(/c/Users/...);文件工具的路径参数由宿主自动翻译,模型无感。停用后恢复 dsh 原生行为(文件工具用 Windows 路径)。bash 始终是 Git Bash,不受此开关影响。",
+			"adopt.label": "接管侧栏终端",
+			"adopt.hint": "开启时把 dsh-better-sidebar 的终端 shell 写成 Git Bash(默认开启);关闭后恢复接管前的值,已手动改过的终端设置不会被碰。模型侧的 bash 工具不受此开关影响——那由插件本体提供。",
 		};
 
 		var en = {
 			"title": "Git Bash path dialect",
-			"cardDesc": "One /c/ POSIX path style for every tool (off by default)",
+			"cardDesc": "One /c/ POSIX path style for every tool (on by default)",
 			"state.label": "Current state",
 			"state.on": "Enabled",
 			"state.off": "Disabled",
@@ -66,8 +77,344 @@ window.__ModuleLoader__.load({
 			"switch.off": "Disable",
 			"error": "write failed",
 			"hint": "Enabled: every tool (bash commands and workdir, read/write/edit/read_image/glob/grep path arguments) uses MSYS drive-root POSIX paths (/c/Users/...); the host translates path fields for the file tools automatically. Disabled restores dsh-native behavior (Windows paths for file tools). Bash is always Git Bash while the plugin is installed; this switch only governs the cross-tool path dialect.",
+			"adopt.label": "Adopt sidebar terminal",
+			"adopt.hint": "On (default) writes Git Bash into dsh-better-sidebar's terminal shell; turning it off restores the pre-adoption value and never touches a manually chosen one. The model-side bash tool is unaffected — the plugin itself provides that.",
 		};
 
+		/* Third-language dictionaries: one entry per language, each preceded
+		   by a locale marker line the smoke test slices on. Adding a language is
+		   one entry here and nothing else — the dictionaries also ride the
+		   ctx.locale.register call below, so host-side consumers read the same
+		   copy the card does. Every key set MUST equal zh's exactly: a missing
+		   key falls back to English silently and the card looks half-translated.
+		   zh-hk and zh-mo ship one Cantonese-flavoured copy; zh-tw carries the
+		   Taiwan wording. */
+		var LOCALES = {
+			/* locale: ar */
+			"ar": {
+				"title": "لهجة مسارات Git Bash",
+				"cardDesc": "صيغة مسار POSIX موحّدة /c/ لكل الأدوات (مُفعَّلة افتراضيًا)",
+				"state.label": "الحالة الحالية",
+				"state.on": "مُفعَّلة",
+				"state.off": "مُعطَّلة",
+				"switch.on": "تفعيل",
+				"switch.off": "تعطيل",
+				"error": "فشل الكتابة",
+				"hint": "عند التفعيل: تستخدم كل الأدوات (أوامر bash و workdir، ومعاملات المسار في read/write/edit/read_image/glob/grep) مسارات POSIX من جذر قرص MSYS (/c/Users/...)؛ ويتولّى المضيف ترجمة حقول المسار لأدوات الملفات تلقائيًا. عند التعطيل يعود السلوك الأصلي لـ dsh (مسارات Windows لأدوات الملفات). يبقى bash دائمًا Git Bash ما دامت الإضافة مثبَّتة؛ هذا المفتاح لا يحكم سوى لهجة المسارات بين الأدوات.",
+				"adopt.label": "تبنّي طرفية الشريط الجانبي",
+				"adopt.hint": "عند التفعيل (افتراضي) تُكتب Git Bash كـ shell لطرفية dsh-better-sidebar؛ وعند التعطيل تُستعاد القيمة السابقة ولا تُلمس القيمة المختارة يدويًا أبدًا. أداة bash الخاصة بالنموذج لا تتأثر — الإضافة نفسها توفرها.",
+			},
+			/* locale: de */
+			"de": {
+				"title": "Git-Bash-Pfaddialekt",
+				"cardDesc": "Eine einheitliche /c/-POSIX-Pfadform für alle Tools (standardmäßig an)",
+				"state.label": "Aktueller Status",
+				"state.on": "Aktiviert",
+				"state.off": "Deaktiviert",
+				"switch.on": "Aktivieren",
+				"switch.off": "Deaktivieren",
+				"error": "Schreiben fehlgeschlagen",
+				"hint": "Aktiviert: Alle Tools (bash-Befehle und workdir sowie Pfadargumente von read/write/edit/read_image/glob/grep) verwenden POSIX-Pfade ab der MSYS-Laufwerkswurzel (/c/Users/...); der Host übersetzt die Pfadfelder der Dateitools automatisch. Deaktiviert stellt das dsh-native Verhalten wieder her (Windows-Pfade für Dateitools). Bash ist bei installiertem Plugin immer Git Bash; dieser Schalter steuert nur den Pfaddialekt zwischen den Tools.",
+				"adopt.label": "Sidebar-Terminal übernehmen",
+				"adopt.hint": "Ein (Standard) schreibt Git Bash als Shell des dsh-better-sidebar-Terminals; Aus stellt den vorherigen Wert wieder her und fasst nie eine manuell gewählte Einstellung an. Das bash-Werkzeug des Modells bleibt unberührt — das liefert das Plugin selbst.",
+			},
+			/* locale: fr */
+			"fr": {
+				"title": "Dialecte de chemins Git Bash",
+				"cardDesc": "Une forme de chemin POSIX /c/ unique pour tous les outils (activée par défaut)",
+				"state.label": "État actuel",
+				"state.on": "Activé",
+				"state.off": "Désactivé",
+				"switch.on": "Activer",
+				"switch.off": "Désactiver",
+				"error": "échec de l'écriture",
+				"hint": "Activé : tous les outils (commandes bash et workdir, arguments de chemin de read/write/edit/read_image/glob/grep) utilisent des chemins POSIX à racine de lecteur MSYS (/c/Users/...) ; l'hôte traduit automatiquement les champs de chemin des outils de fichiers. Désactivé rétablit le comportement natif de dsh (chemins Windows pour les outils de fichiers). Bash reste toujours Git Bash tant que le plugin est installé ; ce commutateur ne régit que le dialecte de chemins entre outils.",
+				"adopt.label": "Adopter le terminal latéral",
+				"adopt.hint": "Activé (par défaut) : écrit Git Bash comme shell du terminal dsh-better-sidebar ; désactivé : restaure la valeur davant et ne touche jamais un choix manuel. Loutil bash du modèle nest pas concerné — le plugin le fournit lui-même.",
+			},
+			/* locale: hi */
+			"hi": {
+				"title": "Git Bash पथ शैली",
+				"cardDesc": "सभी टूल के लिए एक ही /c/ POSIX पथ रूप (डिफ़ॉल्ट रूप से सक्षम)",
+				"state.label": "वर्तमान स्थिति",
+				"state.on": "सक्षम",
+				"state.off": "अक्षम",
+				"switch.on": "सक्षम करें",
+				"switch.off": "अक्षम करें",
+				"error": "लिखना विफल रहा",
+				"hint": "सक्षम होने पर: सभी टूल (bash कमांड और workdir, तथा read/write/edit/read_image/glob/grep के पथ तर्क) MSYS ड्राइव-रूट POSIX पथ (/c/Users/...) का उपयोग करते हैं; फ़ाइल टूल के पथ फ़ील्ड होस्ट स्वतः अनुवादित करता है। अक्षम करने पर dsh का मूल व्यवहार बहाल होता है (फ़ाइल टूल के लिए Windows पथ)। जब तक प्लगइन इंस्टॉल है bash हमेशा Git Bash रहता है; यह स्विच केवल टूल के बीच पथ शैली नियंत्रित करता है।",
+				"adopt.label": "साइडबार टर्मिनल अपनाएँ",
+				"adopt.hint": "चालू (डिफ़ॉल्ट) होने पर dsh-better-sidebar के टर्मिनल में Git Bash लिखा जाता है; बंद करने पर पहले वाली मान बहाल होती है और मैन्युअल चुनी गई सेटिंग कभी नहीं छुई जाती। मॉडल का bash टूल अप्रभावित रहता है — वह प्लगइन स्वयं देता है।",
+			},
+			/* locale: id */
+			"id": {
+				"title": "Dialek path Git Bash",
+				"cardDesc": "Satu bentuk path POSIX /c/ untuk semua alat (aktif secara bawaan)",
+				"state.label": "Status saat ini",
+				"state.on": "Aktif",
+				"state.off": "Nonaktif",
+				"switch.on": "Aktifkan",
+				"switch.off": "Nonaktifkan",
+				"error": "gagal menulis",
+				"hint": "Saat aktif: semua alat (perintah bash dan workdir, serta argumen path read/write/edit/read_image/glob/grep) memakai path POSIX berakar drive MSYS (/c/Users/...); host menerjemahkan bidang path untuk alat berkas secara otomatis. Saat nonaktif, perilaku asli dsh dipulihkan (path Windows untuk alat berkas). Bash selalu Git Bash selama plugin terpasang; sakelar ini hanya mengatur dialek path antaralat.",
+				"adopt.label": "Adopsi terminal sidebar",
+				"adopt.hint": "Nyala (bawaan) menulis Git Bash sebagai shell terminal dsh-better-sidebar; dimatikan memulihkan nilai sebelumnya dan tidak pernah menyentuh pilihan manual. Alat bash sisi model tak terpengaruh — plugin sendiri yang menyediakannya.",
+			},
+			/* locale: it */
+			"it": {
+				"title": "Dialetto dei percorsi Git Bash",
+				"cardDesc": "Un'unica forma di percorso POSIX /c/ per tutti gli strumenti (attivata per impostazione predefinita)",
+				"state.label": "Stato attuale",
+				"state.on": "Attivato",
+				"state.off": "Disattivato",
+				"switch.on": "Attiva",
+				"switch.off": "Disattiva",
+				"error": "scrittura non riuscita",
+				"hint": "Attivato: tutti gli strumenti (comandi bash e workdir, argomenti di percorso di read/write/edit/read_image/glob/grep) usano percorsi POSIX con radice di unità MSYS (/c/Users/...); l'host traduce automaticamente i campi di percorso degli strumenti per i file. Disattivato ripristina il comportamento nativo di dsh (percorsi Windows per gli strumenti per i file). Bash resta sempre Git Bash finché il plugin è installato; questo interruttore governa solo il dialetto dei percorsi tra gli strumenti.",
+				"adopt.label": "Adotta il terminale laterale",
+				"adopt.hint": "Attivo (predefinito) imposta Git Bash come shell del terminale di dsh-better-sidebar; disattivo ripristina il valore precedente e non tocca mai una scelta manuale. Lo strumento bash del modello non è interessato — lo fornisce il plugin stesso.",
+			},
+			/* locale: ja */
+			"ja": {
+				"title": "Git Bash パス方言",
+				"cardDesc": "すべてのツールで /c/ POSIX パス形式に統一(既定ではオン)",
+				"state.label": "現在の状態",
+				"state.on": "有効",
+				"state.off": "無効",
+				"switch.on": "有効にする",
+				"switch.off": "無効にする",
+				"error": "書き込みに失敗しました",
+				"hint": "有効にすると、すべてのツール(bash コマンドと workdir、read/write/edit/read_image/glob/grep のパス引数)が MSYS ドライブルートの POSIX パス(/c/Users/...)を使います。ファイルツールのパスフィールドはホストが自動的に変換します。無効にすると dsh 本来の動作(ファイルツールは Windows パス)に戻ります。bash はプラグインがインストールされている限り常に Git Bash で、このスイッチの影響を受けません。",
+				"adopt.label": "サイドバーターミナルを引き継ぐ",
+				"adopt.hint": "オン(既定)では dsh-better-sidebar のターミナルシェルに Git Bash を書き込みます。オフにすると以前の値へ戻し、手動で選択した設定には決して触れません。モデル側の bash ツールには影響しません——それはプラグイン本体が提供します。",
+			},
+			/* locale: ko */
+			"ko": {
+				"title": "Git Bash 경로 방언",
+				"cardDesc": "모든 도구에 하나의 /c/ POSIX 경로 형식 사용(기본값 켜짐)",
+				"state.label": "현재 상태",
+				"state.on": "사용",
+				"state.off": "사용 안 함",
+				"switch.on": "사용",
+				"switch.off": "사용 안 함",
+				"error": "쓰기 실패",
+				"hint": "켜면 모든 도구(bash 명령과 workdir, read/write/edit/read_image/glob/grep의 경로 인수)가 MSYS 드라이브 루트 POSIX 경로(/c/Users/...)를 사용합니다. 파일 도구의 경로 필드는 호스트가 자동으로 변환합니다. 끄면 dsh 기본 동작(파일 도구에 Windows 경로 사용)으로 돌아갑니다. 플러그인이 설치되어 있는 동안 bash는 항상 Git Bash이며 이 스위치의 영향을 받지 않습니다.",
+				"adopt.label": "사이드바 터미널 인수",
+				"adopt.hint": "켜짐(기본)이면 dsh-better-sidebar 터미널 셸에 Git Bash를 기록하고, 끄면 이전 값을 복원하며 수동으로 고른 설정은 절대 건드리지 않습니다. 모델 측 bash 도구에는 영향이 없습니다 — 플러그인이 직접 제공합니다.",
+			},
+			/* locale: nl */
+			"nl": {
+				"title": "Git Bash-paddialect",
+				"cardDesc": "Eén /c/ POSIX-padvorm voor alle tools (standaard aan)",
+				"state.label": "Huidige status",
+				"state.on": "Ingeschakeld",
+				"state.off": "Uitgeschakeld",
+				"switch.on": "Inschakelen",
+				"switch.off": "Uitschakelen",
+				"error": "schrijven mislukt",
+				"hint": "Ingeschakeld: alle tools (bash-opdrachten en workdir, padargumenten van read/write/edit/read_image/glob/grep) gebruiken POSIX-paden vanaf de MSYS-schijfwortel (/c/Users/...); de host vertaalt de padvelden voor de bestandstools automatisch. Uitgeschakeld herstelt het oorspronkelijke dsh-gedrag (Windows-paden voor bestandstools). Bash is altijd Git Bash zolang de plugin is geïnstalleerd; deze schakelaar bepaalt alleen het paddialect tussen de tools.",
+				"adopt.label": "Zijbalkterminal overnemen",
+				"adopt.hint": "Aan (standaard) schrijft Git Bash als shell van de dsh-better-sidebar-terminal; uit herstelt de vorige waarde en raakt nooit een handmatige keuze aan. De bash-tool van het model blijft buiten beschouwing — die levert de plugin zelf.",
+			},
+			/* locale: pl */
+			"pl": {
+				"title": "Dialekt ścieżek Git Bash",
+				"cardDesc": "Jedna postać ścieżki POSIX /c/ dla wszystkich narzędzi (domyślnie włączone)",
+				"state.label": "Bieżący stan",
+				"state.on": "Włączone",
+				"state.off": "Wyłączone",
+				"switch.on": "Włącz",
+				"switch.off": "Wyłącz",
+				"error": "zapis nie powiódł się",
+				"hint": "Po włączeniu: wszystkie narzędzia (polecenia bash i workdir oraz argumenty ścieżek w read/write/edit/read_image/glob/grep) używają ścieżek POSIX od korzenia dysku MSYS (/c/Users/...); host automatycznie tłumaczy pola ścieżek narzędzi plikowych. Wyłączenie przywraca natywne zachowanie dsh (ścieżki Windows dla narzędzi plikowych). Bash jest zawsze Git Bash, dopóki wtyczka jest zainstalowana; ten przełącznik reguluje wyłącznie dialekt ścieżek między narzędziami.",
+				"adopt.label": "Przejmij terminal boczny",
+				"adopt.hint": "Włączony (domyślnie) zapisuje Git Bash jako shell terminala dsh-better-sidebar; wyłączony przywraca poprzednią wartość i nigdy nie narusza ręcznie wybranego ustawienia. Narzędzie bash po stronie modelu jest nietknięte — zapewnia je sama wtyczka.",
+			},
+			/* locale: pt */
+			"pt": {
+				"title": "Dialeto de caminhos do Git Bash",
+				"cardDesc": "Uma única forma de caminho POSIX /c/ para todas as ferramentas (ativada por padrão)",
+				"state.label": "Estado atual",
+				"state.on": "Ativada",
+				"state.off": "Desativada",
+				"switch.on": "Ativar",
+				"switch.off": "Desativar",
+				"error": "falha ao gravar",
+				"hint": "Ativada: todas as ferramentas (comandos bash e workdir, argumentos de caminho de read/write/edit/read_image/glob/grep) usam caminhos POSIX a partir da raiz da unidade MSYS (/c/Users/...); o host traduz automaticamente os campos de caminho das ferramentas de arquivo. Desativada restaura o comportamento nativo do dsh (caminhos Windows para as ferramentas de arquivo). O bash é sempre Git Bash enquanto o plugin estiver instalado; este interruptor rege apenas o dialeto de caminhos entre ferramentas.",
+				"adopt.label": "Adotar o terminal lateral",
+				"adopt.hint": "Ligado (padrão) grava o Git Bash como shell do terminal do dsh-better-sidebar; desligado restaura o valor anterior e nunca altera uma escolha manual. A ferramenta bash do modelo não é afetada — o próprio plug-in a fornece.",
+			},
+			/* locale: ru */
+			"ru": {
+				"title": "Диалект путей Git Bash",
+				"cardDesc": "Единый POSIX-формат путей /c/ для всех инструментов (по умолчанию включено)",
+				"state.label": "Текущее состояние",
+				"state.on": "Включено",
+				"state.off": "Выключено",
+				"switch.on": "Включить",
+				"switch.off": "Выключить",
+				"error": "не удалось записать",
+				"hint": "Включено: все инструменты (команды bash и workdir, аргументы путей read/write/edit/read_image/glob/grep) используют POSIX-пути от корня диска MSYS (/c/Users/...); хост автоматически преобразует поля путей для файловых инструментов. Выключение возвращает исходное поведение dsh (пути Windows для файловых инструментов). Пока плагин установлен, bash всегда остаётся Git Bash; этот переключатель управляет только диалектом путей между инструментами.",
+				"adopt.label": "Перехватывать терминал боковой панели",
+				"adopt.hint": "Включено (по умолчанию): Git Bash записывается как shell терминала dsh-better-sidebar; выключено — восстанавливается прежнее значение, вручную выбранные настройки не трогаются. Инструмент bash у модели не затронут — его предоставляет сам плагин.",
+			},
+			/* locale: sv */
+			"sv": {
+				"title": "Git Bash-sökvägsdialekt",
+				"cardDesc": "En /c/ POSIX-sökvägsform för alla verktyg (på som standard)",
+				"state.label": "Aktuell status",
+				"state.on": "Aktiverad",
+				"state.off": "Inaktiverad",
+				"switch.on": "Aktivera",
+				"switch.off": "Inaktivera",
+				"error": "skrivning misslyckades",
+				"hint": "Aktiverad: alla verktyg (bash-kommandon och workdir, sökvägsargument för read/write/edit/read_image/glob/grep) använder POSIX-sökvägar från MSYS-enhetsroten (/c/Users/...); värden översätter sökvägsfälten för filverktygen automatiskt. Inaktiverad återställer dsh:s ursprungliga beteende (Windows-sökvägar för filverktyg). Bash är alltid Git Bash så länge insticksprogrammet är installerat; den här växeln styr bara sökvägsdialekten mellan verktygen.",
+				"adopt.label": "Överta sidolistterminal",
+				"adopt.hint": "På (standard) skriver Git Bash som terminal-shell i dsh-better-sidebar; av återställer det tidigare värdet och rör aldrig ett manuellt val. Modellens bash-verktyg påverkas inte — det tillhandahålls av pluginet självt.",
+			},
+			/* locale: th */
+			"th": {
+				"title": "รูปแบบพาธของ Git Bash",
+				"cardDesc": "ใช้รูปแบบพาธ POSIX /c/ แบบเดียวกันกับทุกเครื่องมือ (เปิดไว้เป็นค่าเริ่มต้น)",
+				"state.label": "สถานะปัจจุบัน",
+				"state.on": "เปิดใช้งาน",
+				"state.off": "ปิดใช้งาน",
+				"switch.on": "เปิดใช้งาน",
+				"switch.off": "ปิดใช้งาน",
+				"error": "เขียนไม่สำเร็จ",
+				"hint": "เมื่อเปิดใช้งาน: เครื่องมือทั้งหมด (คำสั่ง bash และ workdir รวมถึงอาร์กิวเมนต์พาธของ read/write/edit/read_image/glob/grep) ใช้พาธ POSIX จากรากไดรฟ์ของ MSYS (/c/Users/...) โฮสต์จะแปลฟิลด์พาธของเครื่องมือจัดการไฟล์ให้อัตโนมัติ เมื่อปิดใช้งานจะกลับสู่พฤติกรรมดั้งเดิมของ dsh (เครื่องมือจัดการไฟล์ใช้พาธ Windows) bash เป็น Git Bash เสมอเมื่อติดตั้งปลั๊กอินนี้ สวิตช์นี้ควบคุมเฉพาะรูปแบบพาธระหว่างเครื่องมือเท่านั้น",
+				"adopt.label": "รับช่วงเทอร์มินัลแถบข้าง",
+				"adopt.hint": "เปิด (ค่าเริ่มต้น) จะเขียน Git Bash เป็น shell ของเทอร์มินัล dsh-better-sidebar; ปิดแล้วคืนค่าเดิมและไม่แตะการตั้งค่าที่เลือกเอง เครื่องมือ bash ของโมเดลไม่กระทบ — ปลั๊กอินจัดหาเอง",
+			},
+			/* locale: tr */
+			"tr": {
+				"title": "Git Bash yol lehçesi",
+				"cardDesc": "Tüm araçlar için tek /c/ POSIX yol biçimi (varsayılan olarak açık)",
+				"state.label": "Geçerli durum",
+				"state.on": "Etkin",
+				"state.off": "Devre dışı",
+				"switch.on": "Etkinleştir",
+				"switch.off": "Devre dışı bırak",
+				"error": "yazma başarısız",
+				"hint": "Etkinleştirildiğinde: tüm araçlar (bash komutları ve workdir ile read/write/edit/read_image/glob/grep yol bağımsız değişkenleri) MSYS sürücü kökünden POSIX yolları (/c/Users/...) kullanır; ana süreç dosya araçlarının yol alanlarını otomatik olarak çevirir. Devre dışı bırakıldığında dsh yerel davranışına döner (dosya araçları için Windows yolları). Eklenti kurulu olduğu sürece bash her zaman Git Bash olarak kalır; bu anahtar yalnızca araçlar arası yol lehçesini yönetir.",
+				"adopt.label": "Kenar çubuğu terminalini devral",
+				"adopt.hint": "Açık (varsayılan) Git Bashi dsh-better-sidebar terminalinin shelli olarak yazar; kapalı önceki değeri geri getirir ve elle seçilmiş bir ayara asla dokunmaz. Model tarafındaki bash aracı etkilenmez — onu eklentinin kendisi sağlar.",
+			},
+			/* locale: vi */
+			"vi": {
+				"title": "Phương ngữ đường dẫn Git Bash",
+				"cardDesc": "Một dạng đường dẫn POSIX /c/ thống nhất cho mọi công cụ (mặc định bật)",
+				"state.label": "Trạng thái hiện tại",
+				"state.on": "Đã bật",
+				"state.off": "Đã tắt",
+				"switch.on": "Bật",
+				"switch.off": "Tắt",
+				"error": "ghi thất bại",
+				"hint": "Khi bật: mọi công cụ (lệnh bash và workdir, tham số đường dẫn của read/write/edit/read_image/glob/grep) dùng đường dẫn POSIX từ gốc ổ đĩa MSYS (/c/Users/...); máy chủ tự động chuyển đổi trường đường dẫn cho các công cụ tệp. Khi tắt, hành vi gốc của dsh được khôi phục (công cụ tệp dùng đường dẫn Windows). bash luôn là Git Bash khi plugin được cài đặt; công tắc này chỉ điều khiển phương ngữ đường dẫn giữa các công cụ.",
+				"adopt.label": "Tiếp nhận terminal thanh bên",
+				"adopt.hint": "Bật (mặc định) ghi Git Bash làm shell terminal của dsh-better-sidebar; tắt khôi phục giá trị trước đó và không bao giờ đụng tới lựa chọn thủ công. Công cụ bash phía mô hình không bị ảnh hưởng — chính plugin cung cấp nó.",
+			},
+			/* locale: zh-hk */
+			"zh-hk": {
+				"title": "Git Bash 路徑方言",
+				"cardDesc": "所有工具統一用 /c/ POSIX 路徑格式(預設開啟)",
+				"state.label": "目前狀態",
+				"state.on": "已啟用",
+				"state.off": "已關閉",
+				"switch.on": "啟用",
+				"switch.off": "停用",
+				"error": "寫入失敗",
+				"hint": "啟用後:所有工具(bash 指令同 workdir、read/write/edit/read_image/glob/grep 嘅路徑參數)統一使用 MSYS 磁碟根 POSIX 路徑(/c/Users/...);檔案工具嘅路徑參數由宿主自動翻譯,模型無感。停用後回復 dsh 原生行為(檔案工具用 Windows 路徑)。bash 永遠係 Git Bash,唔受呢個開關影響。",
+				"adopt.label": "接管側欄終端",
+				"adopt.hint": "開啟(預設)會把 dsh-better-sidebar 的終端 shell 寫成 Git Bash;關閉後還原接管前的值,手動改過的設定永不被碰。模型側的 bash 工具不受影響——由插件本身提供。",
+			},
+			/* locale: zh-mo */
+			"zh-mo": {
+				"title": "Git Bash 路徑方言",
+				"cardDesc": "所有工具統一用 /c/ POSIX 路徑格式(預設開啟)",
+				"state.label": "目前狀態",
+				"state.on": "已啟用",
+				"state.off": "已關閉",
+				"switch.on": "啟用",
+				"switch.off": "停用",
+				"error": "寫入失敗",
+				"hint": "啟用後:所有工具(bash 指令同 workdir、read/write/edit/read_image/glob/grep 嘅路徑參數)統一使用 MSYS 磁碟根 POSIX 路徑(/c/Users/...);檔案工具嘅路徑參數由宿主自動翻譯,模型無感。停用後回復 dsh 原生行為(檔案工具用 Windows 路徑)。bash 永遠係 Git Bash,唔受呢個開關影響。",
+				"adopt.label": "接管側欄終端",
+				"adopt.hint": "開啟(預設)會把 dsh-better-sidebar 的終端 shell 寫成 Git Bash;關閉後還原接管前的值,手動改過的設定永不被碰。模型側的 bash 工具不受影響——由插件本身提供。",
+			},
+			/* locale: zh-tw */
+			"zh-tw": {
+				"title": "Git Bash 路徑方言",
+				"cardDesc": "所有工具統一採用 /c/ POSIX 路徑格式(預設開啟)",
+				"state.label": "目前狀態",
+				"state.on": "已啟用",
+				"state.off": "已關閉",
+				"switch.on": "啟用",
+				"switch.off": "停用",
+				"error": "寫入失敗",
+				"hint": "啟用後:所有工具(bash 指令與 workdir,以及 read/write/edit/read_image/glob/grep 的路徑參數)統一使用 MSYS 磁碟根 POSIX 路徑(/c/Users/...);檔案工具的路徑參數由宿主自動轉譯,模型無感。停用後恢復 dsh 原生行為(檔案工具使用 Windows 路徑)。bash 一律是 Git Bash,不受此開關影響。",
+				"adopt.label": "接管側欄終端機",
+				"adopt.hint": "開啟(預設)會把 dsh-better-sidebar 的終端機 shell 寫成 Git Bash;關閉後還原接管前的值,手動改過的設定永不被碰。模型側的 bash 工具不受影響——由插件本身提供。",
+			},
+		};
+
+		// ── locale resolution (live: read per lookup, cached per tag) ───────────
+
+		function hasOwnKey(bag, key) {
+			return Object.prototype.hasOwnProperty.call(bag, key);
+		}
+
+		/* Resolve one locale tag against what this plugin ships: the exact tag,
+		   then the primary subtag, then English. Chinese is special-cased because
+		   the traditional variants are shipped while a bare zh-Hant-* is not
+		   spelled out. */
+		function dictionaryFor(active) {
+			var raw = active === undefined || active === null || active === "" ? "en" : String(active);
+			var tag = raw.toLowerCase().replace(/_/g, "-");
+			var primary = tag.split("-")[0];
+			if (primary === "zh") {
+				if (hasOwnKey(LOCALES, tag)) return LOCALES[tag];
+				if (tag.indexOf("hant") >= 0 || tag === "zh-hk" || tag === "zh-mo" || tag === "zh-tw") {
+					return hasOwnKey(LOCALES, "zh-hk") ? LOCALES["zh-hk"] : zh;
+				}
+				return zh;
+			}
+			if (hasOwnKey(LOCALES, primary)) return LOCALES[primary];
+			return en;
+		}
+
+		/* The active locale tag, read fresh every time: DSH's language preference
+		   switches live, so a value captured once at activation would keep answering
+		   in the language that happened to be active when the card loaded. The
+		   host-backed preference wins; the browser is the fallback. */
+		function activeLocaleOf(ctx) {
+			var active = "";
+			try {
+				var locale = ctx.get("locale");
+				if (locale !== undefined && typeof locale.getSnapshot === "function") {
+					var snapshot = locale.getSnapshot();
+					if (snapshot !== null && typeof snapshot === "object" && typeof snapshot.active === "string") active = snapshot.active;
+				}
+			} catch (error) { /* fall through to the browser */ }
+			if (active === "" && typeof navigator === "object" && navigator !== null && typeof navigator.language === "string") active = navigator.language;
+			return active;
+		}
+
+		/* A live lookup: the dictionary is picked per call and cached under the tag
+		   it was picked for, so a language switch costs one string compare per
+		   string. Falling back to EN — kept key-complete on purpose — means an
+		   unsupported language shows English, never a raw key. */
+		function translatorOf(ctx) {
+			var cachedTag = null;
+			var cachedDict = null;
+			return function (key) {
+				var tag = activeLocaleOf(ctx);
+				if (tag !== cachedTag) { cachedTag = tag; cachedDict = dictionaryFor(tag); }
+				if (hasOwnKey(cachedDict, key)) return cachedDict[key];
+				return hasOwnKey(en, key) ? en[key] : key;
+			};
+		}
+
 		// ── styles (gb- prefixed; tokens mirror PluginCard.module.css) ─────────
 
 		var STYLE_ID = "dsh-gitbash-shell-style";
@@ -84,6 +431,8 @@ window.__ModuleLoader__.load({
 			".gb-chevron{flex:none;color:var(--dsw-alias-label-tertiary);transition:transform .16s}",
 			".gb-chevron.gb-chevronOpen{transform:rotate(180deg)}",
 			".gb-body{display:flex;flex-direction:column;gap:12px;padding:4px 16px 16px;max-width:640px}",
+			".gb-page{max-width:640px}",
+			".gb-pageBody{display:flex;flex-direction:column;gap:12px;padding:0 0 8px}",
 			".gb-row{display:flex;align-items:baseline;gap:8px;font-size:13px;line-height:1.5;color:var(--dsw-alias-label-secondary)}",
 			".gb-rowLabel{flex:none;color:var(--dsw-alias-label-tertiary)}",
 			".gb-rowValue{min-width:0;overflow-wrap:anywhere;color:var(--dsw-alias-label-primary)}",
@@ -140,13 +489,40 @@ window.__ModuleLoader__.load({
 			return this.props.children;
 		};
 
+		// ── live locale (repaint the card on a language switch) ─────────────────
+
+		/**
+		 * Wraps the card so a language switch repaints it instead of waiting for a
+		 * page load. DSH's own components re-render on the locale snapshot, but this
+		 * card belongs to a plugin: it subscribes for itself, and it hands the card
+		 * THIS plugin's live lookup (translatorOf) — whose resolution covers the
+		 * third languages the DSH catalog does not carry. The card stays inside the
+		 * same quiet boundary as before.
+		 */
+		function LocaleLive(props) {
+			var tickState = useState(0);
+			var tick = tickState[0];
+			var setTick = tickState[1];
+			void tick;
+
+			useEffect(function () {
+				var locale = props.ctx && typeof props.ctx.get === "function" ? props.ctx.get("locale") : undefined;
+				if (locale === undefined || typeof locale.subscribe !== "function") return undefined;
+				var unsubscribe = locale.subscribe(function () { setTick(function (value) { return value + 1; }); });
+				return typeof unsubscribe === "function" ? unsubscribe : undefined;
+			}, []);
+
+			return E(QuietBoundary, null, E(GitBashCard, Object.assign({}, props.cardProps, { t: props.t })));
+		}
+
 		// ── settings card (module-level component) ───────────────────────────────
 
 		/**
-		 * The Settings → Plugins card. t arrives through the registration's
-		 * locale field; scope arrives as a PLAIN prop from the inject factory.
-		 * Snapshots are read per render; each write bumps a local tick so the
-		 * card re-reads without an external-store hook adapter.
+		 * The Settings → Plugins card. t arrives from LocaleLive (the plugin's own
+		 * live lookup, keyed on the active locale at call time); scope arrives as a
+		 * PLAIN prop from the inject factory. Snapshots are read per render; each
+		 * write bumps a local tick so the card re-reads without an external-store
+		 * hook adapter.
 		 */
 		function GitBashCard(props) {
 			var t = typeof props.t === "function" ? props.t : function (key) { return key; };
@@ -175,10 +551,11 @@ window.__ModuleLoader__.load({
 
 			var value = snap.value || {};
 			var enabled = value.posixPaths === true;
+			var adopt = value.adoptSidebar !== false;
 
-			function write(next) {
+			function writeField(key, next) {
 				setError("");
-				scope.set("posixPaths", next)
+				scope.set(key, next)
 					.then(function () { bumpTick(function (n) { return n + 1; }); })
 					.catch(function (err) {
 						bumpTick(function (n) { return n + 1; });
@@ -188,6 +565,51 @@ window.__ModuleLoader__.load({
 
 			var Chevron = icon("IconChevronDownOutline14");
 
+			// dsh 0.1.6-alpha.2: the Plugins page renders this card through the
+			// `plugins.bundle.config` slot with view="page" — the page draws the
+			// title itself, so the collapsible shell is only for the legacy seat.
+			var pageView = props.view === "page";
+
+			var bodyContent = E("div", { className: pageView ? "gb-pageBody" : "gb-body" },
+				E("div", { className: "gb-row" },
+					E("span", { className: "gb-rowLabel" }, t("state.label") + ":"),
+					E("span", { className: "gb-rowValue" }, enabled ? t("state.on") : t("state.off")),
+				),
+				E("div", { className: "gb-seg" },
+					E("button", {
+						type: "button",
+						className: "gb-segBtn" + (enabled ? " gb-segActive" : ""),
+						onClick: function () { if (!enabled) writeField("posixPaths", true); },
+					}, t("switch.on")),
+					E("button", {
+						type: "button",
+						className: "gb-segBtn" + (!enabled ? " gb-segActive" : ""),
+						onClick: function () { if (enabled) writeField("posixPaths", false); },
+					}, t("switch.off")),
+				),
+				E("p", { className: "gb-hint" }, t("hint")),
+				E("div", { className: "gb-row" },
+					E("span", { className: "gb-rowLabel" }, t("adopt.label") + ":"),
+					E("span", { className: "gb-rowValue" }, adopt ? t("state.on") : t("state.off")),
+				),
+				E("div", { className: "gb-seg" },
+					E("button", {
+						type: "button",
+						className: "gb-segBtn" + (adopt ? " gb-segActive" : ""),
+						onClick: function () { if (!adopt) writeField("adoptSidebar", true); },
+					}, t("switch.on")),
+					E("button", {
+						type: "button",
+						className: "gb-segBtn" + (!adopt ? " gb-segActive" : ""),
+						onClick: function () { if (adopt) writeField("adoptSidebar", false); },
+					}, t("switch.off")),
+				),
+				E("p", { className: "gb-hint" }, t("adopt.hint")),
+				error ? E("p", { className: "gb-error" }, error) : null,
+			);
+
+			if (pageView) return E("div", { className: "gb-page" }, bodyContent);
+
 			return E("li", { className: "gb-card" + (open ? " gb-open" : "") },
 				E("button", {
 					type: "button",
@@ -203,26 +625,7 @@ window.__ModuleLoader__.load({
 						? E(Chevron, { className: "gb-chevron" + (open ? " gb-chevronOpen" : "") })
 						: E("span", { className: "gb-chevron" + (open ? " gb-chevronOpen" : "") }, "▾"),
 				),
-				open ? E("div", { className: "gb-body" },
-					E("div", { className: "gb-row" },
-						E("span", { className: "gb-rowLabel" }, t("state.label") + ":"),
-						E("span", { className: "gb-rowValue" }, enabled ? t("state.on") : t("state.off")),
-					),
-					E("div", { className: "gb-seg" },
-						E("button", {
-							type: "button",
-							className: "gb-segBtn" + (enabled ? " gb-segActive" : ""),
-							onClick: function () { if (!enabled) write(true); },
-						}, t("switch.on")),
-						E("button", {
-							type: "button",
-							className: "gb-segBtn" + (!enabled ? " gb-segActive" : ""),
-							onClick: function () { if (enabled) write(false); },
-						}, t("switch.off")),
-					),
-					error ? E("p", { className: "gb-error" }, error) : null,
-					E("p", { className: "gb-hint" }, t("hint")),
-				) : null,
+				open ? bodyContent : null,
 			);
 		}
 
@@ -235,11 +638,17 @@ window.__ModuleLoader__.load({
 
 		exports.apply = function (ctx) {
 			var scope = ctx.settingsScope.bind({ namespace: SETTINGS_NAMESPACE });
+			/* The card's only copy entry point: a live lookup, never a captured
+			   dictionary — the language preference switches without a reload. */
+			var t = translatorOf(ctx);
 
 			ctx.effect(function () {
 				var disposers = [ensureStyles()];
 				try {
-					var disposeDict = ctx.locale.register(NS, { zh: zh, en: en });
+					/* Every shipped dictionary rides the DSH locale registry, so host-side
+					   consumers read the same copy the card does; a missing service simply
+					   means the card is the only reader. */
+					var disposeDict = ctx.locale.register(NS, Object.assign({ zh: zh, en: en }, LOCALES));
 					if (typeof disposeDict === "function") disposers.push(disposeDict);
 				} catch (error) {
 					console.warn(TAG + " dictionary registration failed:", error && error.message ? error.message : error);
@@ -261,17 +670,39 @@ window.__ModuleLoader__.load({
 					console.warn(TAG + " slots service unavailable; settings card idle");
 					return;
 				}
+				var injected = function () {
+					// The inject factory's returned members become the component's
+					// props: the bound settings scope rides here as a PLAIN member
+					// (top-level options fields do NOT reach the component).
+					return { scope: scope };
+				};
+				// Legacy seat (dsh <= 0.1.6-alpha.1): Settings → Plugins card.
 				slots.inject("settings.plugin.item", function () {
 					return slots.register({
 						name: "settings.plugin.item",
 						key: SETTINGS_NAMESPACE,
 						locale: NS,
-						// The inject factory's returned members become the component's
-						// props: the bound settings scope rides here as a PLAIN member
-						// (top-level options fields do NOT reach the component).
-						inject: function () { return { scope: scope }; },
-					}, function CardWithBoundary(props) {
-						return E(QuietBoundary, null, E(GitBashCard, props));
+						inject: injected,
+					}, function CardWithLocale(props) {
+						/* The registration's locale field also hands out the framework's own
+						   t seat; the plugin's lookup wins (21 locale tags against the catalog's
+						   zh/en), passed last so no prop merge order can override it. */
+						return E(LocaleLive, { ctx: ctx, t: t, cardProps: props });
+					});
+				});
+				// dsh 0.1.6-alpha.2+: the Plugins page's bundle configuration seat,
+				// keyed by the PACKAGE name. Each inject waits for its own slot
+				// declaration, so exactly one seat is live on any host version.
+				slots.inject("plugins.bundle.config", function () {
+					return slots.register({
+						name: "plugins.bundle.config",
+						key: "dsh-gitbash-shell",
+						locale: NS,
+						inject: injected,
+					}, function BundleConfigWithBoundary(props) {
+						/* Same LocaleLive wrap as the legacy seat: the plugin's 21-tag
+						   dictionary wins over the catalog's zh/en t seat. */
+						return E(LocaleLive, { ctx: ctx, t: t, cardProps: props });
 					});
 				});
 			} catch (error) {

package/src/index.js

@@ -427,7 +427,7 @@ function pickComposition(base, persona, available) {
 }
 
 /** Startup decision for an existing unmodified tree: 'refresh' or 'idle'. */
-function syncDecision({ state, marker, version, sourceHashes, base = 'code', persona = 'text', present = false, rows = '' }) {
+function syncDecision({ state, marker, version, sourceHashes, base = 'code', persona = 'text', present = false, pluginManager = false, rows = '' }) {
   if (state !== 'unmodified' || !marker) return 'refresh'
   if (marker.version !== version) return 'refresh'
   if (marker.base !== base) return 'refresh'
@@ -445,6 +445,10 @@ function syncDecision({ state, marker, version, sourceHashes, base = 'code', per
   // host resolves it — and a host upgrade past that point must re-materialize
   // to gain it (same marker-dimension pattern as persona).
   if ((marker.present ?? false) !== present) return 'refresh'
+  // Host-capability flip: @deepseek-ai/dsh-plugin-manager/tools first shipped
+  // with dsh 0.1.6-alpha.2 — same mount-rejection stakes and the same marker
+  // dimension pattern as present above.
+  if ((marker.pluginManager ?? false) !== pluginManager) return 'refresh'
   const recorded = {}
   for (const k of Object.keys(marker.files)) if (k.startsWith('skills/')) recorded[k] = marker.files[k]
   if (sourceHashes === null) return Object.keys(recorded).length === 0 ? 'idle' : 'refresh'
@@ -497,8 +501,48 @@ async function hostHasToolPresent() {
   return toolPresentCache
 }
 
+/*
+ * Conditional plugin-manager-row injection (v0.15.0, dsh 0.1.6-alpha.2 sync).
+ * Official ptc/standard/cordis gained `- id: tool-plugin-manager / name:
+ * '@deepseek-ai/dsh-plugin-manager/tools'` (persistent plugin management;
+ * the official ptc preset carries it DISABLED, Creation keeps it on). The
+ * package only exists from 0.1.6-alpha.2 on, so the row is injected as plain
+ * text behind a host probe — never committed into the assets — anchored
+ * after the present row when there is one, else at the tail, mirroring the
+ * official order (tool-presentation → present → tool-plugin-manager).
+ * Per-variant shape mirrors each variant's official base: code-gitbash (ptc
+ * base) DISABLED, standard/cordis-gitbash ENABLED, minimal untouched
+ * (official minimal never gained the row), code-era files frozen history.
+ */
+const PLUGIN_MANAGER_ROW_ON = "- id: tool-plugin-manager\n  name: '@deepseek-ai/dsh-plugin-manager/tools'\n"
+const PLUGIN_MANAGER_ROW_OFF = "- id: tool-plugin-manager\n  name: '@deepseek-ai/dsh-plugin-manager/tools'\n  disabled: true\n"
+const PRESENT_ROW_FULL = "\n- id: present\n  name: '@deepseek-ai/dsh-tool-present'\n"
+
+function injectPluginManagerRow(text, { enabled }) {
+  if (text.includes("'@deepseek-ai/dsh-plugin-manager/tools'")) return text
+  const body = enabled ? PLUGIN_MANAGER_ROW_ON : PLUGIN_MANAGER_ROW_OFF
+  const at = text.indexOf(PRESENT_ROW_FULL)
+  if (at !== -1) return text.slice(0, at + PRESENT_ROW_FULL.length) + body + text.slice(at + PRESENT_ROW_FULL.length)
+  return text.endsWith('\n') ? text + body : text + '\n' + body
+}
+
+
+let pluginManagerToolsCache
+/** Probe whether THIS host can resolve the plugin-manager tools package (cached per boot). */
+async function hostHasPluginManagerTools() {
+  if (pluginManagerToolsCache !== undefined) return pluginManagerToolsCache
+  try {
+    const { createRequire } = await import('node:module')
+    createRequire(import.meta.url).resolve('@deepseek-ai/dsh-plugin-manager/tools')
+    pluginManagerToolsCache = true
+  } catch {
+    pluginManagerToolsCache = false
+  }
+  return pluginManagerToolsCache
+}
+
 /** Write one preset directory from scratch. Returns 'ok' or 'no-skills-source'. */
-function materialize({ target, presetId, skillsSource, version, base = 'code', persona = 'text', present = false, rows }) {
+function materialize({ target, presetId, skillsSource, version, base = 'code', persona = 'text', present = false, pluginManager = false, rows }) {
   rmSync(target, { recursive: true, force: true })
   mkdirSync(target, { recursive: true })
 
@@ -506,6 +550,12 @@ function materialize({ target, presetId, skillsSource, version, base = 'code', p
   const compositionFile = pickComposition(base, persona, available)
   let composition = readFileSync(join(pkgDir, 'assets', presetId, compositionFile), 'utf8')
   if (present && compositionFile.includes('.ptc.')) composition = injectPresentRow(composition)
+  // v0.15.0: ptc-era files only; the ptc-based variant mirrors the official
+  // ptc DISABLED form, standard/cordis mirror their ENABLED bases, minimal is
+  // untouched (official minimal never gained the row).
+  if (pluginManager && compositionFile.includes('.ptc.') && presetId !== 'minimal-gitbash') {
+    composition = injectPluginManagerRow(composition, { enabled: presetId !== 'code-gitbash' })
+  }
   // Row-form alignment (v0.14.0): the committed assets pin one spelling of the
   // workflow-engine row, but a host renames it out from under them (dsh
   // 0.1.6-alpha.1) and a row whose module fails to import rejects the whole
@@ -531,7 +581,7 @@ function materialize({ target, presetId, skillsSource, version, base = 'code', p
     }
   }
 
-  const marker = { managedBy: MANAGED_BY, version, presetId, base, persona, present, rows: rowFingerprint(rows, presetId), files: hashTree(target) }
+  const marker = { managedBy: MANAGED_BY, version, presetId, base, persona, present, pluginManager, rows: rowFingerprint(rows, presetId), files: hashTree(target) }
   writeFileSync(join(target, MARKER_FILE), JSON.stringify(marker, null, 2) + '\n')
   return skills
 }
@@ -633,6 +683,20 @@ export function readPosixPaths(ctxLike) {
   }
 }
 
+/**
+ * Read the adoptSidebar switch (v0.15.0, default ON). Unlike posixPaths the
+ * default is on, so only an explicit false disables the takeover.
+ */
+export function readAdoptSidebar(ctxLike) {
+  try {
+    const settings = ctxLike && typeof ctxLike.get === 'function' ? ctxLike.get('settings') : undefined
+    const value = settings && typeof settings.get === 'function' ? settings.get(SETTINGS_NAMESPACE) : undefined
+    return !(value && value.adoptSidebar === false)
+  } catch {
+    return true
+  }
+}
+
 // Windows absolute path -> MSYS drive-root form, for rewriting the OFFICIAL
 // prompt text in place (v0.10.0). Two patterns keep quoted spaced paths
 // ("C:\Program Files\Git") whole while bare paths stop at whitespace or a
@@ -772,72 +836,119 @@ const SIDEBAR_NS = 'dsh-better-sidebar'
 const SIDEBAR_TRIES = 12
 const SIDEBAR_RETRY_MS = 1500
 
+// Owner scope of the gitbash-shell namespace once registered (shared with
+// the register callback so a late registration can reconcile + watch).
+let sidebarScope = undefined
+
+// Reconciler installed by adoptSidebarShell; a no-op until then.
+let reconcileSidebar = () => {}
+
 /**
- * Write the sidebar's `terminalShell` pref through the settings service.
- * Polls until the settings service (and the sidebar's namespace) are ready:
- * at boot the service may not be provided yet when this row's apply runs, so
- * the first attempt can silently see nothing — every attempt after the first
- * catches the service once it exists. Never throws; always logs the outcome.
+ * Reconcile the better-sidebar `terminalShell` takeover with the adoptSidebar
+ * setting (v0.15.0, default ON). ON writes our bashPath (remembering what was
+ * there before); OFF restores that previous value — but only while the current
+ * value is still ours, so a user's manual choice is never clobbered. The
+ * polling keeps the original ready-wait behavior: at boot the settings
+ * service may not be provided yet when this row's apply runs. Never throws.
  */
 function adoptSidebarShell(ctx, bashPath) {
+  let adopted = false
+  let previous = ''
   let tried = 0
   let timer = null
   ctx.effect(() => () => { if (timer) clearTimeout(timer) }, 'dsh-gitbash-shell: sidebar adoption polling')
-  const run = async () => {
-    tried += 1
+
+  const readShell = () => {
     const settings = ctx.get('settings')
-    const ready = settings && typeof settings.update === 'function' && typeof settings.get === 'function'
-    if (!ready) {
-      if (tried < SIDEBAR_TRIES) {
-        timer = setTimeout(run, SIDEBAR_RETRY_MS)
-        return
-      }
-      console.log(`${TAG} better-sidebar shell adoption skipped: settings service unavailable after ${tried} tries`)
-      return
-    }
-    let current
+    if (!settings || typeof settings.get !== 'function' || typeof settings.update !== 'function') return null
     try {
-      current = settings.get(SIDEBAR_NS)
+      const value = settings.get(SIDEBAR_NS)
+      return value && typeof value === 'object' && typeof value.terminalShell === 'string' ? value.terminalShell : ''
     } catch {
-      current = undefined // namespace not registered yet / sidebar absent
+      return null // namespace not registered yet / sidebar absent
     }
-    const value = current && typeof current === 'object' ? current : {}
-    const previous = typeof value.terminalShell === 'string' ? value.terminalShell : ''
-    try {
-      await settings.update(SIDEBAR_NS, { terminalShell: bashPath })
-    } catch (error) {
-      if (tried < SIDEBAR_TRIES) {
-        timer = setTimeout(run, SIDEBAR_RETRY_MS)
-        return
+  }
+
+  reconcileSidebar = (desired) => {
+    const current = readShell()
+    if (current === null) return false
+    const settings = ctx.get('settings')
+    if (desired && current !== bashPath) {
+      const was = current
+      settings.update(SIDEBAR_NS, { terminalShell: bashPath })
+        .then(() => {
+          previous = was
+          adopted = true
+          console.log(
+            `${TAG} dsh-better-sidebar terminal shell -> Git Bash (${bashPath})` +
+              (was ? ` (took over from '${was}')` : ''),
+          )
+        })
+        .catch((error) => {
+          console.log(`${TAG} better-sidebar shell adoption unavailable: ${error?.message ?? error}`)
+        })
+      return true
+    }
+    if (desired && current === bashPath) {
+      adopted = true
+      return true
+    }
+    if (!desired && adopted && current === bashPath) {
+      settings.update(SIDEBAR_NS, { terminalShell: previous })
+        .then(() => {
+          adopted = false
+          console.log(`${TAG} dsh-better-sidebar terminal shell restored ('${previous || 'sidebar default'}') — adoptSidebar off`)
+        })
+        .catch(() => {})
+      return true
+    }
+    return true
+  }
+
+  const run = () => {
+    tried += 1
+    const ok = reconcileSidebar(readAdoptSidebar(ctx))
+    if (ok) {
+      // The namespace scope may register after the settings service; hook
+      // the live watch once it exists (idempotent via the effect disposer).
+      if (sidebarScope && typeof sidebarScope.watch === 'function' && !run.watched) {
+        run.watched = true
+        try {
+          const off = sidebarScope.watch((next) => { reconcileSidebar(next && next.adoptSidebar !== false) })
+          ctx.effect(() => off, 'dsh-gitbash-shell: adoptSidebar watch (polling path)')
+        } catch { /* best effort */ }
       }
-      console.log(`${TAG} better-sidebar shell adoption unavailable: ${error?.message ?? error}`)
       return
     }
-    let reverted = false
-    ctx.effect(
-      () => () => {
-        if (reverted) return
-        reverted = true
-        const s = ctx.get('settings')
-        if (!s || typeof s.update !== 'function') return
-        let now
-        try {
-          now = s.get(SIDEBAR_NS)
-        } catch {
-          return
-        }
-        if (String(now?.terminalShell ?? '') === bashPath) {
-          s.update(SIDEBAR_NS, { terminalShell: previous }).catch(() => {})
-        }
-      },
-      'dsh-gitbash-shell: sidebar shell revert',
-    )
-    console.log(
-      `${TAG} dsh-better-sidebar terminal shell -> Git Bash (${bashPath})` +
-        (previous ? ` (took over from '${previous}')` : ''),
-    )
+    if (tried < SIDEBAR_TRIES) {
+      timer = setTimeout(run, SIDEBAR_RETRY_MS)
+      return
+    }
+    console.log(`${TAG} better-sidebar shell adoption skipped: settings service unavailable after ${tried} tries`)
   }
+  run.watched = false
   void run()
+
+  // Dispose: while we still hold the value, restore what was there before.
+  let reverted = false
+  ctx.effect(
+    () => () => {
+      if (reverted || !adopted) return
+      reverted = true
+      const s = ctx.get('settings')
+      if (!s || typeof s.update !== 'function') return
+      let now
+      try {
+        now = s.get(SIDEBAR_NS)
+      } catch {
+        return
+      }
+      if (String(now?.terminalShell ?? '') === bashPath) {
+        s.update(SIDEBAR_NS, { terminalShell: previous }).catch(() => {})
+      }
+    },
+    'dsh-gitbash-shell: sidebar shell revert',
+  )
 }
 
 // ── plugin ──────────────────────────────────────────────────────────────────
@@ -923,7 +1034,7 @@ export async function apply(ctx, config = {}) {
   const disposeGitBash = ctx.provide('gitBash', gitBashCapability)
   ctx.effect(() => disposeGitBash, 'dsh-gitbash-shell: gitBash capability')
 
-  // ── settings namespace: the posixPaths switch (default OFF) ──────────────
+  // ── settings namespace: the posixPaths switch (default ON, v0.10.0) ──────
   // Served on the host so the Plugins tab pairs it with the browser card
   // (the tab dispatches Host-served namespaces ∩ registered cards). Dynamic
   // imports keep the zero-dependency smoke path importable; the schema MUST
@@ -940,10 +1051,24 @@ export async function apply(ctx, config = {}) {
           const ns = typeof ds.settingsNamespace === 'function'
             ? ds.settingsNamespace(SETTINGS_NAMESPACE)
             : SETTINGS_NAMESPACE
-          settings.register(ns, Schema.object({
+          const scope = settings.register(ns, Schema.object({
             posixPaths: Schema.boolean().default(true),
+            adoptSidebar: Schema.boolean().default(true),
           }))
-          console.log(`${TAG} settings namespace registered: ${SETTINGS_NAMESPACE} (posixPaths default on)`)
+          sidebarScope = scope
+          console.log(`${TAG} settings namespace registered: ${SETTINGS_NAMESPACE} (posixPaths default on, adoptSidebar default on)`)
+          // A late register (settings service up after the adoption polling
+          // finished) still reconciles once, and the live watch flips the
+          // takeover when the user toggles the card switch.
+          try {
+            if (typeof scope?.watch === 'function') {
+              const off = scope.watch((next) => { reconcileSidebar(next && next.adoptSidebar !== false) })
+              ctx.effect(() => off, 'dsh-gitbash-shell: adoptSidebar watch')
+            }
+            reconcileSidebar(readAdoptSidebar(ctx))
+          } catch (error) {
+            console.log(`${TAG} adoptSidebar watch wiring failed: ${error?.message ?? error}`)
+          }
         })
         .catch((error) => {
           console.log(`${TAG} settings namespace registration FAILED: ${error && error.stack || String(error)}`)
@@ -1145,6 +1270,11 @@ export async function apply(ctx, config = {}) {
   // resolving from this plugin's own tree (covers hosts where the roster
   // probe is unavailable).
   const present = (await detectPresentSupport(ctx.agentPresets)) || (await hostHasToolPresent())
+  // v0.15.0 (dsh 0.1.6-alpha.2): official ptc/standard/cordis gained the
+  // tool-plugin-manager row; inject behind the same host-package probe as
+  // present (resolve-only is sufficient — the package cannot exist on an
+  // older host, so a roster text probe adds nothing).
+  const pluginManager = await hostHasPluginManagerTools()
   // Row spellings of the built-in presets these variants mirror: the
   // workflow-engine row was renamed and its old package deleted in dsh
   // 0.1.6-alpha.1, so the materializer copies whatever the host itself ships.
@@ -1179,12 +1309,12 @@ export async function apply(ctx, config = {}) {
     const sourceHashes = presetId === 'cordis-gitbash' ? skillsHashes(skillsSource) : null
     const marker = readMarker(target)
     const markerRows = rowFingerprint(rows, presetId)
-    if (state === 'unmodified' && syncDecision({ state, marker, version, sourceHashes, base, persona, present, rows: markerRows }) === 'idle') {
+    if (state === 'unmodified' && syncDecision({ state, marker, version, sourceHashes, base, persona, present, pluginManager, rows: markerRows }) === 'idle') {
       ctx.logger?.('gitbash-shell')?.debug?.( `preset '${presetId}' up to date (v${version}, ${base}-era${persona === 'split' ? ', persona-split' : ''}) — idle`)
       continue
     }
 
-    const skills = materialize({ target, presetId, skillsSource, version, base, persona, present, rows })
+    const skills = materialize({ target, presetId, skillsSource, version, base, persona, present, pluginManager, rows })
     const verb = state === 'absent' ? 'materialized' : 'refreshed'
     console.log(
       `${TAG} ${verb} preset '${presetId}' into ${userRootPath} (v${version}, ${base}-era composition${persona === 'split' ? ', persona-split' : ''})` +
@@ -1194,4 +1324,4 @@ export async function apply(ctx, config = {}) {
 }
 
 // Test surface: pure helpers, no Cordis context required.
-export const _internal = { PRESET_IDS, translateMsysPath, translatePathArguments, readPosixPaths, windowsToMsys, rewriteResultPaths, MARKER_FILE, classify, materialize, cleanupOnDispose, firstUserRoot, hashTree, skillsHashes, syncDecision, installRegisterShim, baseForRoster, detectBase, pickComposition, personaEraForText, detectPersonaEra, injectPresentRow, hostHasToolPresent, detectPresentSupport, rowFormOf, rowFormsOf, alignEngineRow, alignRalphRow, ROW_SOURCE }
+export const _internal = { PRESET_IDS, translateMsysPath, translatePathArguments, readPosixPaths, readAdoptSidebar, windowsToMsys, rewriteResultPaths, MARKER_FILE, classify, materialize, cleanupOnDispose, firstUserRoot, hashTree, skillsHashes, syncDecision, installRegisterShim, baseForRoster, detectBase, pickComposition, personaEraForText, detectPersonaEra, injectPresentRow, hostHasToolPresent, detectPresentSupport, injectPluginManagerRow, hostHasPluginManagerTools, rowFormOf, rowFormsOf, alignEngineRow, alignRalphRow, ROW_SOURCE }