@mzzsfy/dsh-shell-select 0.4.1 → 0.4.3

package/src/client.js

@@ -1,6 +1,8 @@
-// dsh-shell-select Client 半区:设置页卡片(shells 列表管理 + 默认客户端 + 路径探测)。
+// dsh-shell-select Client 半区:tool.call.toolview shell 族卡片(官方 BashRow/
+// terminalCardModel 同构 + 复制/折行/客户端徽章增强)。
 // 以 DSH client-modules 自注册格式发布:__ModuleLoader__.load({id, factory});
-// 数据经 webServer 路由 /api/shell-select/* 读写宿主 settings 节(照 dsh-maintain 双端模式)。
+// 客户端名册经 webServer 路由 /api/shell-select/config 读取(配置写入走宿主
+// settings JSON,浏览器侧无设置页)。
 
 window.__ModuleLoader__.load({
   id: '@mzzsfy/dsh-shell-select',
@@ -48,15 +50,6 @@ window.__ModuleLoader__.load({
 
     const API = {
       config: '/api/shell-select/config',
-      probe: '/api/shell-select/probe',
-      detect: '/api/shell-select/detect',
-    }
-    const KINDS = ['pwsh', 'bash', 'cmd', 'wsl']
-    const KIND_LABELS = {
-      pwsh: 'PowerShell',
-      bash: 'POSIX bash(git bash / msys2 / cygwin)',
-      cmd: 'CMD',
-      wsl: 'WSL bash',
     }
 
     async function api(path, options) {
@@ -93,37 +86,122 @@ window.__ModuleLoader__.load({
     }
     // LOGIC-END clientDisplayName
 
+    // 仅在宿主明确报告 Windows 后,把可识别的 MSYS 路径映射回宿主文件路径。
+    // 文件地址本身不经 URL round-trip,避免改写未识别的编码与后缀。
+    // LOGIC-BEGIN msysToHostPath
+    function msysToHostPath(value, facts) {
+      if (typeof value !== 'string' || value === '') return value
+      const env = facts ?? {}
+      if (env.home && (value === '~' || value.startsWith('~/'))) {
+        return value === '~' ? env.home : `${env.home}/${value.slice(2)}`
+      }
+      const drive = /^\/([a-z])\/(.*)$/i.exec(value)
+      if (drive !== null) return `${drive[1].toUpperCase()}:/${drive[2]}`
+      const bareDrive = /^\/([a-z])$/i.exec(value)
+      if (bareDrive !== null) return `${bareDrive[1].toUpperCase()}:/`
+      if (env.tmpDir && (value === '/tmp' || value.startsWith('/tmp/'))) {
+        return value === '/tmp' ? env.tmpDir : env.tmpDir + value.slice(4)
+      }
+      return value
+    }
+    // LOGIC-END msysToHostPath
+
+    // LOGIC-BEGIN rescueFileAddress
+    function rescueFileAddress(address, msysToHostPath, facts) {
+      const prefix = 'dsh-resource://file/'
+      if (typeof address !== 'string' || !address.startsWith(prefix)) return address
+      const tail = address.slice(prefix.length)
+      const cut = tail.search(/[?#]/)
+      const suffix = cut === -1 ? '' : tail.slice(cut)
+      const parts = (cut === -1 ? tail : tail.slice(0, cut)).split('/')
+      const scope = parts.shift()
+      if (scope !== 'session' && scope !== 'absolute') return address
+      const sessionId = scope === 'session' ? parts.shift() : undefined
+      if (scope === 'session' && (!sessionId || parts.length === 0)) return address
+      let decodedSessionId = sessionId
+      if (scope === 'session') {
+        try {
+          decodedSessionId = decodeURIComponent(sessionId)
+        } catch {
+          return address
+        }
+      }
+      let segments
+      try {
+        segments = parts.map(decodeURIComponent)
+      } catch {
+        return address
+      }
+      if (scope === 'absolute' && segments[0] === '' && segments.length > 1) return address
+      const path = scope === 'absolute' ? `/${segments.join('/')}` : segments.join('/')
+      const translated = msysToHostPath(path, facts)
+      if (translated === path) return address
+      const encoded = translated.split('/').map((segment) => encodeURIComponent(segment).replace(/%3A/gi, ':')).join('/')
+      const rebuilt = scope === 'session'
+        ? `${prefix}session/${encodeURIComponent(decodedSessionId)}/${encoded}`
+        : `${prefix}absolute/${encoded.replace(/^\/+/, '')}`
+      return rebuilt + suffix
+    }
+    // LOGIC-END rescueFileAddress
+
+    const PATHMAP_URL = '/api/shell-select/pathmap'
+    let pathMap = null
+    let pathMapRequested = false
+    function loadPathMap() {
+      if (pathMapRequested) return
+      pathMapRequested = true
+      fetch(PATHMAP_URL, { headers: { accept: 'application/json' } })
+        .then((response) => response.ok ? response.json() : null)
+        .then((facts) => {
+          if (facts && typeof facts.platform === 'string') pathMap = facts
+          else pathMapRequested = false
+        })
+        .catch((error) => {
+          pathMapRequested = false
+          console.warn('shell-select: pathmap fetch failed', error)
+        })
+    }
+    // LOGIC-END loadPathMap
+
+    function installPathRescue(ctx) {
+      if (typeof ctx.inject !== 'function') return
+      loadPathMap()
+      ctx.inject(['sidebarRight'], (sctx) => {
+        const controller = sctx?.sidebarRight
+        if (!controller || controller.shellSelectPathRescue === true || typeof controller.openResource !== 'function') return
+        if (typeof sctx.effect !== 'function') return
+        const openResource = controller.openResource
+        const openResourceIn = controller.openResourceIn
+        let active = true
+        const rescue = (address) => {
+          if (!active) return address
+          if (pathMap === null) loadPathMap()
+          return pathMap?.platform === 'win32'
+            ? rescueFileAddress(address, msysToHostPath, pathMap)
+            : address
+        }
+        controller.openResource = function openResourceWithPathRescue(address, options) {
+          return openResource.call(this, rescue(address), options)
+        }
+        const wrappedOpenResource = controller.openResource
+        if (typeof openResourceIn === 'function') {
+          controller.openResourceIn = function openResourceInWithPathRescue(sessionId, address, options) {
+            return openResourceIn.call(this, sessionId, rescue(address), options)
+          }
+        }
+        const wrappedOpenResourceIn = controller.openResourceIn
+        controller.shellSelectPathRescue = true
+        const restore = () => {
+          active = false
+          if (controller.openResource === wrappedOpenResource) controller.openResource = openResource
+          if (typeof openResourceIn === 'function' && controller.openResourceIn === wrappedOpenResourceIn) controller.openResourceIn = openResourceIn
+          if (controller.shellSelectPathRescue === true) delete controller.shellSelectPathRescue
+        }
+        sctx.effect(() => restore, 'shell-select sidebar path rescue')
+      })
+    }
+
     const CSS = [
-      '.sls-card { display:flex; flex-direction:column; gap:10px; }',
-      '.sls-row { display:flex; align-items:center; gap:8px; flex-wrap:wrap; }',
-      '.sls-entry { display:flex; flex-direction:column; gap:6px; padding:10px; border:1px solid var(--sls-border, rgba(128,128,128,.35)); border-radius:8px; }',
-      '.sls-entry__head { display:flex; align-items:center; gap:8px; }',
-      '.sls-grid { display:grid; grid-template-columns: 90px 1fr; gap:4px 8px; align-items:center; }',
-      '.sls-grid__label { opacity:.75; font-size:12px; }',
-      '.sls-input { padding:4px 8px; border-radius:6px; border:1px solid var(--sls-border, rgba(128,128,128,.35)); background:transparent; color:inherit; min-width:0; }',
-      '.sls-input--wide { width:100%; }',
-      '.sls-btn { padding:3px 10px; border-radius:6px; border:1px solid var(--sls-border, rgba(128,128,128,.35)); background:transparent; color:inherit; cursor:pointer; font-size:12px; }',
-      '.sls-btn:disabled { opacity:.5; cursor:default; }',
-      '.sls-btn--primary { border-color: transparent; background: var(--sls-accent, #4b7bcc); color:#fff; }',
-      '.sls-badge { font-size:11px; padding:1px 8px; border-radius:999px; border:1px solid var(--sls-border, rgba(128,128,128,.35)); opacity:.85; }',
-      '.sls-badge--ok { color:#2e9e5b; border-color:#2e9e5b; }',
-      '.sls-badge--bad { color:#c44; border-color:#c44; }',
-      '.sls-badge--default { color:#fff; background:var(--sls-accent, #4b7bcc); border-color:transparent; }',
-      '.sls-hint { font-size:12px; opacity:.7; }',
-      '.sls-error { font-size:12px; color:#c44; white-space:pre-wrap; }',
-      '.sls-args { font-size:12px; font-family:var(--sls-mono, monospace); }',
-      // 命令黑名单:逐条规则编辑器(每条规则独立行,行级即时校验)
-      '.sls-rules { display:flex; flex-direction:column; gap:6px; padding:10px; border:1px solid var(--sls-border, rgba(128,128,128,.35)); border-radius:8px; }',
-      '.sls-rules__head { display:flex; align-items:center; gap:8px; }',
-      '.sls-rules__title { font-weight:500; }',
-      '.sls-rules__note { font-size:12px; opacity:.7; }',
-      '.sls-rule { display:flex; align-items:center; gap:6px; }',
-      '.sls-rule__no { flex:none; width:18px; text-align:right; font-size:12px; opacity:.45; user-select:none; }',
-      '.sls-rule__input { flex:1; min-width:0; padding:4px 8px; border-radius:6px; border:1px solid var(--sls-border, rgba(128,128,128,.35)); background:transparent; color:inherit; font-size:12px; font-family:var(--sls-mono, monospace); }',
-      '.sls-rule__input:focus { outline:none; border-color:var(--sls-accent, #4b7bcc); }',
-      '.sls-rule--bad .sls-rule__input { border-color:#c44; }',
-      '.sls-rule__err { flex:none; max-width:40%; font-size:11px; color:#c44; overflow:hidden; text-overflow:ellipsis; white-space:nowrap; }',
-      '.sls-rule__del { flex:none; padding:2px 8px; }',
       // tool.call.toolview 卡片(key 'shell'):官方 terminal 行同构 + 复制/折行增强。
       // 色彩对齐官方 ToolRow:标题 label-secondary、icon 盒 label-tertiary(实证自
       // 官方行 computed style);token 缺失时回退 inherit 不致不可读
@@ -147,6 +225,7 @@ window.__ModuleLoader__.load({
       '.sls-tv__head { display:flex; align-items:center; gap:8px; padding:6px 10px; border-bottom:1px solid rgba(128,128,128,.18); background:rgba(128,128,128,.05); }',
       // 头部单行片段禁折行:cwd 行宽不足时收缩出省略号,徽章不收缩不折行
       '.sls-tv__cwd { font-family:var(--sls-mono, monospace); font-size:12px; opacity:.7; white-space:nowrap; overflow:hidden; text-overflow:ellipsis; }',
+      '.sls-tv__takeover { font-size:11px; padding:0 7px; border-radius:999px; border:1px solid currentColor; opacity:.75; flex:none; white-space:nowrap; }',
       '.sls-tv__badge { font-size:11px; padding:0 7px; border-radius:999px; border:1px solid rgba(128,128,128,.35); opacity:.85; flex:none; white-space:nowrap; }',
       '.sls-tv__pill { font-size:12px; color:#d4553f; flex:none; white-space:nowrap; }',
       '.sls-tv__pill--bg { color:var(--dsw-alias-label-tertiary, inherit); }',
@@ -165,380 +244,13 @@ window.__ModuleLoader__.load({
       '.sls-tv__out { margin:0; padding:8px 10px; border-top:1px solid rgba(128,128,128,.18); font-family:var(--sls-mono, monospace); font-size:12.5px; white-space:pre; overflow-x:auto; max-height:320px; overflow-y:auto; }',
       '.sls-tv__inspect { display:flex; align-items:center; gap:4px; padding:4px 10px; border:none; border-top:1px solid rgba(128,128,128,.18); background:transparent; color:inherit; opacity:.6; cursor:pointer; font-size:12px; }',
       '.sls-tv__inspect:hover { opacity:1; }',
-      // 开关:隐藏原生 checkbox,选中态 track 与 thumb 位移用过渡呈现(仓库 client 规约)
-      '.sls-switch { display:inline-flex; align-items:center; cursor:pointer; }',
-      '.sls-switch input[type="checkbox"] { position:absolute; opacity:0; width:0; height:0; }',
-      '.sls-switch__track { position:relative; width:34px; height:19px; border-radius:999px; box-sizing:border-box;',
-      '  background:var(--sls-track, rgba(128,128,128,0.35));',
-      '  border:1px solid var(--sls-border, rgba(128,128,128,0.35));',
-      '  transition:background 0.15s, border-color 0.15s; }',
-      '.sls-switch__thumb { position:absolute; top:50%; left:2px; width:13px; height:13px; border-radius:50%;',
-      '  background:var(--sls-thumb, rgba(128,128,128,0.6));',
-      '  transform:translateY(-50%); transition:left 0.15s, background 0.15s; }',
-      '.sls-switch:hover .sls-switch__track { border-color:var(--sls-accent, #4b7bcc); }',
-      '.sls-switch input[type="checkbox"]:checked + .sls-switch__track { background:var(--sls-accent, #4b7bcc); border-color:var(--sls-accent, #4b7bcc); }',
-      '.sls-switch input[type="checkbox"]:checked + .sls-switch__track .sls-switch__thumb { left:17px; background:var(--sls-bg-base, #fff); }',
-      '.sls-switch input[type="checkbox"]:focus-visible + .sls-switch__track { outline:2px solid var(--sls-accent, #4b7bcc); outline-offset:1px; }',
     ].join('\n')
 
-    // 开关的 checkbox + 轨道对,checkbox 语义保留仅视觉隐藏
-    function switchToggle(props) {
-      return [
-        h('input', { type: 'checkbox', ...props }),
-        h('span', { className: 'sls-switch__track' }, h('span', { className: 'sls-switch__thumb' })),
-      ]
-    }
-
     function h(type, props) {
       const children = Array.prototype.slice.call(arguments, 2)
       return React.createElement.apply(React, [type, props || null].concat(children))
     }
 
-    // 保存负载:仅取设置 schema 字段,剥离探测态
-    function toSection(entries, defaultId, denyRules) {
-      return {
-        shells: entries.map((entry) => ({
-          id: entry.id.trim(),
-          kind: entry.kind,
-          path: entry.path.trim(),
-          args: entry.argsText.split(/\s+/).filter((item) => item.length > 0),
-          login: entry.kind === 'bash' ? entry.login === true : false,
-          distro: entry.distro ?? '',
-          env: parseEnvText(entry.envText),
-        })),
-        default: defaultId,
-        deny: denyRules.filter((rule) => rule.length > 0),
-      }
-    }
-
-    // 逐条规则的正则校验:返回非法条目 [{index, error}](index 为规则序,供行级标错与保存拦截复用)
-    // LOGIC-BEGIN denyPatternIssues
-    function denyPatternIssues(rules) {
-      const issues = []
-      for (let index = 0; index < rules.length; index += 1) {
-        if (rules[index].length === 0) continue
-        try {
-          new RegExp(rules[index])
-        } catch (error) {
-          issues.push({ index, error: String(error?.message ?? error) })
-        }
-      }
-      return issues
-    }
-    // LOGIC-END denyPatternIssues
-
-    // 环境文本(每行 K=V)→ 记录;空行与缺 = 的行忽略,值保留原样含空格与 =。
-    // LOGIC-BEGIN parseEnvText
-    function parseEnvText(text) {
-      const env = {}
-      for (const line of String(text ?? '').split('\n')) {
-        const separator = line.indexOf('=')
-        if (separator <= 0) continue
-        const key = line.slice(0, separator).trim()
-        if (key.length === 0) continue
-        env[key] = line.slice(separator + 1)
-      }
-      return env
-    }
-    // LOGIC-END parseEnvText
-
-    // 环境文本中被忽略的行(空行以外):缺 = 的行在保存校验时报错,防静默丢数据
-    // LOGIC-BEGIN invalidEnvLines
-    function invalidEnvLines(text) {
-      return String(text ?? '').split('\n')
-        .map((line) => line.trim())
-        .filter((line) => line.length > 0 && line.indexOf('=') <= 0)
-    }
-    // LOGIC-END invalidEnvLines
-
-    // 服务器清单 → 编辑态(argsText 汇成一串便于编辑;envText 每行 K=V;deny 为逐条规则数组)
-    function toEntries(section) {
-      return section.shells.map((entry) => ({
-        id: entry.id,
-        kind: entry.kind,
-        path: entry.path,
-        argsText: (entry.args ?? []).join(' '),
-        login: entry.login === true,
-        distro: entry.distro ?? '',
-        envText: Object.entries(entry.env ?? {}).map(([key, value]) => `${key}=${value}`).join('\n'),
-        available: entry.available,
-        resolved: entry.path,
-      }))
-    }
-
-    // 名单数组 → 编辑态数组(去空白行;加载侧解析)
-    function patternText(list) {
-      return (Array.isArray(list) ? list : []).map((rule) => String(rule).trim()).filter((rule) => rule.length > 0)
-    }
-
-    function ShellSelectApp() {
-      const [entries, setEntries] = useState(null)
-      const [defaultId, setDefaultId] = useState('')
-      const [dirty, setDirty] = useState(false)
-      const [notice, setNotice] = useState(null)
-      const [busy, setBusy] = useState(false)
-      const [denyRules, setDenyRules] = useState([])
-
-      useEffect(() => {
-        let disposed = false
-        api(API.config).then((section) => {
-          if (disposed) return
-          setEntries(toEntries(section))
-          setDefaultId(section.default)
-          setDenyRules(patternText(section.deny))
-        }).catch((error) => {
-          if (!disposed) setNotice('加载失败:' + error.message)
-        })
-        return () => {
-          disposed = true
-        }
-      }, [])
-
-      const patchEntry = (index, changes) => {
-        setDirty(true)
-        setEntries(entries.map((entry, at) => (at === index ? { ...entry, ...changes } : entry)))
-      }
-
-      const addEntry = () => {
-        setDirty(true)
-        setEntries([...entries, { id: '', kind: 'bash', path: '', argsText: '', login: false, distro: '', envText: '', available: undefined, resolved: undefined }])
-      }
-
-      const removeEntry = (index) => {
-        const target = entries[index]
-        setDirty(true)
-        setEntries(entries.filter((_, at) => at !== index))
-        if (defaultId === target.id) setDefaultId(entries.length > 1 ? entries[0].id : '')
-      }
-
-      const patchRule = (index, value) => {
-        setDirty(true)
-        setDenyRules(denyRules.map((rule, at) => (at === index ? value : rule)))
-      }
-
-      const addRule = () => {
-        setDirty(true)
-        setDenyRules([...denyRules, ''])
-      }
-
-      const removeRule = (index) => {
-        setDirty(true)
-        setDenyRules(denyRules.filter((_, at) => at !== index))
-      }
-
-      const save = async () => {
-        setBusy(true)
-        setNotice(null)
-        try {
-          const section = toSection(entries, defaultId, denyRules)
-          const ids = section.shells.map((entry) => entry.id)
-          if (ids.some((id) => id.length === 0)) throw new Error('存在空 id 条目')
-          if (new Set(ids).size !== ids.length) throw new Error('id 重复:' + ids.join(', '))
-          if (!ids.includes(section.default)) throw new Error('默认客户端不在列表中')
-          const invalid = entries.map((entry) => ({ entry, lines: invalidEnvLines(entry.envText) }))
-            .find(({ lines }) => lines.length > 0)
-          if (invalid !== undefined) throw new Error(`环境变量行缺少 =(条目 ${invalid.entry.id || '(未命名)'}):${invalid.lines.join(' ; ')}`)
-          const issue = denyPatternIssues(section.deny)[0]
-          if (issue !== undefined) {
-            throw new Error(`命令黑名单第 ${issue.index + 1} 条正则非法:${issue.error}`)
-          }
-          const payload = await api(API.config, { method: 'POST', body: JSON.stringify(section) })
-          setEntries(toEntries({ shells: payload.resolved.shells }))
-          setDefaultId(payload.resolved.default)
-          setDenyRules(patternText(payload.resolved.deny))
-          setDirty(false)
-          setNotice('已保存,工具描述与默认客户端即时生效')
-        } catch (error) {
-          setNotice('保存失败:' + error.message)
-        } finally {
-          setBusy(false)
-        }
-      }
-
-      const probe = async (index) => {
-        const target = entries[index]
-        setBusy(true)
-        setNotice(null)
-        try {
-          const payload = await api(API.probe, { method: 'POST', body: JSON.stringify({ path: target.path }) })
-          patchEntry(index, { available: payload.exists, resolved: target.path })
-        } catch (error) {
-          setNotice('探测失败:' + error.message)
-        } finally {
-          setBusy(false)
-        }
-      }
-
-      const detect = async (kind) => {
-        setBusy(true)
-        setNotice(null)
-        try {
-          const payload = await api(API.detect, { method: 'POST', body: JSON.stringify({ kinds: [kind] }) })
-          setNotice(payload.found.length > 0
-            ? kind + ' 候选:' + payload.found.map((item) => item.path).join(' ; ')
-            : kind + ' 未发现候选')
-        } catch (error) {
-          setNotice('探测失败:' + error.message)
-        } finally {
-          setBusy(false)
-        }
-      }
-
-      if (entries === null) {
-        return h('div', { className: 'sls-card' },
-          h('span', { className: 'sls-hint' }, notice ?? '加载中…'))
-      }
-
-      return h('div', { className: 'sls-card' },
-        h('div', { className: 'sls-row' },
-          h('span', { className: 'sls-hint' }, '命令行客户端清单。路径留空自动探测;模型可通过工具的 shell 参数选择任一条目,缺省用默认。'),
-        ),
-        entries.map((entry, index) => h('div', { className: 'sls-entry', key: index },
-          h('div', { className: 'sls-entry__head' },
-            h('label', { className: 'sls-row' },
-              h('input', {
-                type: 'radio',
-                name: 'sls-default',
-                checked: defaultId === entry.id && entry.id.length > 0,
-                onChange: () => {
-                  setDirty(true)
-                  setDefaultId(entry.id)
-                },
-                disabled: entry.id.trim().length === 0,
-                title: '设为默认客户端(模型缺省 shell 参数时使用)',
-              }),
-              h('span', { className: 'sls-hint' }, '默认'),
-            ),
-            h('span', {
-              className: 'sls-badge' + (entry.available === true ? ' sls-badge--ok' : entry.available === false ? ' sls-badge--bad' : ''),
-              title: entry.resolved !== undefined && entry.resolved.length > 0 ? '解析路径:' + entry.resolved : '路径尚未解析',
-            }, entry.available === true ? '可用' : entry.available === false ? '不可用' : '未知'),
-            entry.id === defaultId && entry.id.length > 0 ? h('span', { className: 'sls-badge sls-badge--default' }, '默认') : null,
-            h('span', { style: { flex: 1 } }),
-            h('button', {
-              className: 'sls-btn',
-              disabled: busy || entry.path.trim().length === 0,
-              title: '检查该路径是否存在',
-              onClick: () => void probe(index),
-            }, '探测路径'),
-            h('button', {
-              className: 'sls-btn',
-              disabled: busy,
-              title: '移除该条目',
-              onClick: () => removeEntry(index),
-            }, '移除'),
-          ),
-          h('div', { className: 'sls-grid' },
-            h('span', { className: 'sls-grid__label' }, 'id'),
-            h('input', {
-              className: 'sls-input',
-              value: entry.id,
-              placeholder: 'pwsh / git-bash / …(模型看到的 shell 参数值,亦作显示名)',
-              onChange: (event) => patchEntry(index, { id: event.target.value }),
-            }),
-            h('span', { className: 'sls-grid__label' }, '形态'),
-            h('div', { className: 'sls-row' },
-              h('select', {
-                className: 'sls-input',
-                value: entry.kind,
-                onChange: (event) => patchEntry(index, { kind: event.target.value }),
-              }, KINDS.map((kind) => h('option', { value: kind, key: kind }, KIND_LABELS[kind]))),
-              h('button', {
-                className: 'sls-btn',
-                disabled: busy,
-                title: '扫描本机常见安装位置',
-                onClick: () => void detect(entry.kind),
-              }, '扫描本机'),
-            ),
-            h('span', { className: 'sls-grid__label' }, '路径'),
-            h('input', {
-              className: 'sls-input sls-input--wide',
-              value: entry.path,
-              placeholder: '留空自动探测,如 C:\\Program Files\\Git\\bin\\bash.exe',
-              onChange: (event) => patchEntry(index, { path: event.target.value }),
-            }),
-            h('span', { className: 'sls-grid__label' }, '参数'),
-            h('input', {
-              className: 'sls-input sls-input--wide sls-args',
-              value: entry.argsText,
-              placeholder: '留空用形态默认;自定义模板以空格分隔,{command} 为命令占位',
-              onChange: (event) => patchEntry(index, { argsText: event.target.value }),
-            }),
-            ...(entry.kind === 'bash' ? [
-              h('span', { className: 'sls-grid__label' }, '登录壳'),
-              h('label', { className: 'sls-row sls-switch', title: '-lc 登录壳拉起 /etc/profile(只注入 /usr/bin;/mingw64/bin 需在下方的环境里配 MSYSTEM=MINGW64)' },
-                ...switchToggle({
-                  checked: entry.login === true,
-                  onChange: (event) => patchEntry(index, { login: event.target.checked }),
-                }),
-                h('span', { className: 'sls-hint' }, '-lc 登录壳'),
-              ),
-            ] : []),
-            ...(entry.kind === 'wsl' ? [
-              h('span', { className: 'sls-grid__label' }, '发行版'),
-              h('input', {
-                className: 'sls-input',
-                value: entry.distro ?? '',
-                placeholder: '留空用默认发行版,如 Ubuntu-22.04',
-                onChange: (event) => patchEntry(index, { distro: event.target.value }),
-              }),
-            ] : []),
-            h('span', { className: 'sls-grid__label' }, '环境'),
-            h('textarea', {
-              className: 'sls-input sls-args',
-              rows: 2,
-              value: entry.envText,
-              placeholder: '每行 K=V,如 MSYSTEM=MINGW64;wsl 形自动经 WSLENV 透传',
-              onChange: (event) => patchEntry(index, { envText: event.target.value }),
-            }),
-          ),
-        )),
-        h('div', { className: 'sls-rules' },
-          h('div', { className: 'sls-rules__head' },
-            h('span', { className: 'sls-rules__title' }, '命令黑名单'),
-            h('span', { className: 'sls-badge' + (denyRules.length > 0 ? ' sls-badge--ok' : ' sls-badge--bad') },
-              denyRules.length > 0 ? denyRules.length + ' 条规则' : '未生效'),
-          ),
-          h('span', { className: 'sls-rules__note' },
-            '每条规则为一条正则,对整条命令全文匹配(大小写不敏感),命中即拒,无豁免;精细放行写在模式内用前瞻,如 rm -rf\\s+(?!\\S*node_modules)。'),
-          denyRules.length === 0
-            ? h('span', { className: 'sls-rules__note' }, '未配置,命中拦截不生效,模型可执行任意命令。')
-            : denyRules.map((rule, index) => {
-              const issue = denyPatternIssues([rule])[0]
-              return h('div', { className: 'sls-rule' + (issue !== undefined ? ' sls-rule--bad' : ''), key: index },
-                h('span', { className: 'sls-rule__no' }, index + 1),
-                h('input', {
-                  className: 'sls-rule__input',
-                  value: rule,
-                  placeholder: '正则,如 ^format\\s',
-                  onChange: (event) => patchRule(index, event.target.value),
-                }),
-                issue !== undefined ? h('span', { className: 'sls-rule__err', title: issue.error }, issue.error) : null,
-                h('button', {
-                  className: 'sls-btn sls-rule__del',
-                  title: '删除该条规则',
-                  onClick: () => removeRule(index),
-                }, '删除'),
-              )
-            }),
-          h('div', { className: 'sls-row' },
-            h('button', { className: 'sls-btn', onClick: addRule }, '添加规则'),
-          ),
-        ),
-        h('div', { className: 'sls-row' },
-          h('button', { className: 'sls-btn', disabled: busy, onClick: addEntry }, '添加客户端'),
-          h('span', { style: { flex: 1 } }),
-          dirty ? h('span', { className: 'sls-hint' }, '有未保存改动') : null,
-          h('button', {
-            className: 'sls-btn sls-btn--primary',
-            disabled: busy || !dirty,
-            onClick: () => void save(),
-          }, '保存'),
-        ),
-        notice !== null ? h('div', { className: 'sls-hint' }, notice) : null,
-      )
-    }
-
     // ── tool.call.toolview 卡片(key 'shell')──────────────────────────────
     // 官方 BashRow/terminalCardModel 的 shellCall 白名单只认 bash|pwsh,无法复用,
     // 模型派生自带:数据自 argsRaw + 结果文本尾部退出标记派生(官方 block 无
@@ -657,22 +369,23 @@ window.__ModuleLoader__.load({
       }
 
       const contentText = (block.content ?? []).map((part) => (part.type === 'text' ? part.text : '')).filter((text) => text !== '').join('\n')
+      const intercepted = toolKey === 'pwsh' && (block.content ?? []).some((part) => part.type === 'shell-select-takeover' && part.tool === 'pwsh')
       const shellName = shellNameOf(parseShellMark(contentText))
       const outputText = stripShellMark(contentText)
       // 后台 ack:独立卡呈现命令全文与任务号徽标,ack 原文作输出(不再落 generic 简版行)
       if (args.run_in_background === true) {
         const jobId = /started background job (\S+)/.exec(contentText)?.[1]
-        return { kind: 'background', status: 'background', command, description, cwdDir, cwdFull, shellName, output: outputText, jobId }
+        return { kind: 'background', status: 'background', command, description, cwdDir, cwdFull, shellName, intercepted, output: outputText, jobId }
       }
       // 空结果落 generic:官方 singleResultText 无文本即回通用卡,避免空输出伪 done 终端卡;
       // isError/error 块带 alert(错误红点语义),其余(空输出/无描述/截断)中性无状态点
       if (outputText === '' || block.isError === true || block.error !== undefined || description === undefined || hasSpillNotice(contentText)) {
         const alert = block.isError === true || block.error !== undefined ? 'error' : undefined
-        return { kind: 'generic', command, summary: description, output: outputText, running: false, alert }
+        return { kind: 'generic', command, summary: description, output: outputText, running: false, alert, intercepted }
       }
       const tail = parseExitTail(outputText)
       const status = tail.signal !== undefined ? 'signaled' : tail.exitCode !== 0 ? 'failed' : 'done'
-      return { kind: 'terminal', status, command, description, cwdDir, cwdFull, shellName, output: tail.output, exitCode: tail.exitCode, signal: tail.signal, code: undefined }
+      return { kind: 'terminal', status, command, description, cwdDir, cwdFull, shellName, intercepted, output: tail.output, exitCode: tail.exitCode, signal: tail.signal, code: undefined }
     }
     // LOGIC-END shellCardModel
 
@@ -789,6 +502,7 @@ window.__ModuleLoader__.load({
           h('span', { className: 'sls-tv__title' }, 'Shell'),
           summary !== '' ? h('span', { className: 'sls-tv__sep', 'aria-hidden': true }) : null,
           summary !== '' ? h('span', { className: 'sls-tv__sum' + (status === 'generic-error' ? ' sls-tv__sum--err' : '') }, summary) : null,
+          model.intercepted ? h(TakeoverBadge, { en }) : null,
           status === 'running' ? h('span', { className: 'sls-tv__pulse' }, en ? 'running…' : '运行中…') : null,
         ),
         open && expandable ? h('pre', { className: 'sls-tv__out', style: { border: '1px solid rgba(128,128,128,.28)', borderRadius: 8 } }, model.command + (model.output !== null && model.output !== '' ? `\n${model.output}` : '')) : null,
@@ -796,6 +510,10 @@ window.__ModuleLoader__.load({
       )
     }
 
+    function TakeoverBadge({ en }) {
+      return h('span', { className: 'sls-tv__takeover', title: en ? 'Direct pwsh call handled by shell-select' : '直接 pwsh 调用由 shell-select 接管' }, en ? 'Intercepted' : '插件接管')
+    }
+
     function CommandBody({ command }) {
       const lines = command === '' ? [''] : command.split('\n')
       const width = String(lines.length).length
@@ -823,6 +541,7 @@ window.__ModuleLoader__.load({
           ),
           model.cwdDir !== undefined ? h('span', { className: 'sls-tv__cwd', title: 'pwd: ' + (model.cwdFull ?? model.cwdDir) }, model.cwdDir) : null,
           model.shellName !== undefined ? h('span', { className: 'sls-tv__badge', title: en ? 'Shell client' : 'Shell 客户端' }, model.shellName) : null,
+          model.intercepted ? h(TakeoverBadge, { en }) : null,
           h('span', { className: 'sls-tv__sp' }),
           pill !== undefined ? h('span', { className: 'sls-tv__pill' + (meta.pillTone === 'bg' ? ' sls-tv__pill--bg' : '') }, pill) : null,
           h('span', { className: 'sls-tv__copy' },
@@ -885,6 +604,7 @@ window.__ModuleLoader__.load({
           h('span', { className: 'sls-tv__title' }, 'Shell'),
           h('span', { className: 'sls-tv__sep', 'aria-hidden': true }),
           h('span', { className: 'sls-tv__sum' + (failed ? ' sls-tv__sum--err' : '') }, summary),
+          model.intercepted ? h(TakeoverBadge, { en }) : null,
           model.status === 'running' ? h(RunningDuration, { startedAt: model.startedAt, en }) : null,
           model.status === 'background' && model.jobId !== undefined
             ? h('span', { className: 'sls-tv__badge', title: en ? 'Background job' : '后台任务' }, en ? `bg ${model.jobId}` : `后台 ${model.jobId}`)
@@ -897,6 +617,7 @@ window.__ModuleLoader__.load({
     return {
       inject: ['slots'],
       apply(ctx) {
+        installPathRescue(ctx)
         ctx.effect(() => {
           const style = document.createElement('style')
           // 自带 data-plugin:缺失时宿主 claimStyles 会误收,插件 HMR 重建即误删
@@ -905,11 +626,6 @@ window.__ModuleLoader__.load({
           document.head.appendChild(style)
           return () => style.remove()
         }, 'shell-select styles')
-        ctx.slots.inject('settings.section', () =>
-          ctx.slots.register(
-            { name: 'settings.section', id: 'shell-select', order: 82, label: 'Shell 管理' },
-            () => React.createElement(ShellSelectApp),
-          ))
         // 替换 shell 族工具行渲染:keyed hit 优先于 GenericToolCard 兜底;
         // priority -1 阴影官方同 key 注册(低值先渲染)。pwsh/bash 为官方工具
         // 名(死态窗口 guard 代挂官方 tool-pwsh 时,其调用行同样获得增强卡);