@mzzsfy/dsh-shell-select 0.4.1 → 0.4.4

package/README.md

@@ -1,16 +1,17 @@
 # @mzzsfy/dsh-shell-select
 
-Windows shell 链接管:禁用官方 `pwsh` 工具与执行器,替换为可配置多客户端的 `shell` 工具——pwsh / git bash / cmd / WSL / 任意第三方实现,自定义路径,多个客户端并存,设默认,模型经工具参数按名选择。
+Windows 宿主 shell 链接管:接管根组合中的官方 `pwsh` 工具与执行器，提供可配置多客户端的 `shell` 工具——pwsh / git bash / cmd / WSL / 任意第三方实现，自定义路径，多个客户端并存，设默认，模型经工具参数按名选择。执行器活跃且会话可见 `shell` 时，模型工具定义不再暴露 `pwsh`，包括官方预设内的同名工具。
 
-**宿主要求 ≥ 0.1.7-rc.1**:预设面用 preset-* 声明行(patch 引用 `@deepseek-ai/dsh-agent-preset`,0.1.7 起提供);装到更旧宿主会因该包缺失导致组合树加载失败——0.1.5 及以下请勿安装本包。
+**宿主要求 ≥ 0.1.7-rc.1**:保留现有 settings/行配置契约的最低版本要求。已移除会话预设声明和 `@deepseek-ai/dsh-agent-preset` 依赖，不扩大旧宿主兼容范围。
 
 ## 工作方式
 
-- **运行时接管**:bundle 补丁不静态禁用官方 `tool-pwsh`、`pwsh-sandbox` 两行——boot 期官方 pwsh 链先服务,主行(`ctx.shell` 执行器 + `shell` 工具 + systemPrompt 段)apply 落定后经 `entry.update` 运行时禁用官方两行(dsh-market 同款,内存态不持久),再挂载执行器接管。本包任意死法(import 崩/apply 崩/被禁/卸载)下官方行保持启用,官方 pwsh 链自服务,系统不出现 shell 全灭窗口;重启后由行树声明态收敛。web 行(设置页数据通道,`inject: ['webServer', 'settings']` 声明式门控——服务就绪才激活)与 guard 哨兵行同 patch 插入。
-- 配置事实源 = 主行 Config(dsh 0.1.7 settings 面以 profile 条目为存储,ns `shell-select`);自带设置页经 `settings.configure({ auto: false })` 抑制原生自动页,写路径 `settings.replace`,配置变更由 cordis 行重载活生效(工具描述随行重建即时更新)。
+- **运行时接管**:bundle 补丁不静态禁用官方 `tool-pwsh`、`pwsh-sandbox` 两行——boot 期官方 pwsh 链先服务,主行(`ctx.shell` 执行器 + `shell` 工具 + systemPrompt 段)apply 落定后经 `entry.update` 运行时禁用官方两行(dsh-market 同款,内存态不持久),再挂载执行器接管。本包任意死法(import 崩/apply 崩/被禁/卸载)下官方行保持启用,官方 pwsh 链自服务,系统不出现 shell 全灭窗口;重启后由行树声明态收敛。web 行(`/api/shell-select/*` 数据通道,`inject: ['webServer', 'settings']` 声明式门控——服务就绪才激活)与 guard 哨兵行同 patch 插入。
+- 配置事实源 = 主行 Config(dsh 0.1.7 settings 面以 profile 条目为存储,ns `shell-select`);设置中的 **Shell 管理** 页面经现有 API 读写宿主 settings,写路径 `settings.replace` 后刷新执行面(工具描述与默认客户端即时更新),也可通过宿主配置编辑器维护。
 - client 半区 `dsh.client.inject` 声明(官方机制,dsh-client-file-upload 等官方包同款):保证 client 运行时模块表中 `primitives`/`slots` 面在场;primitives 另有 try/catch 降级自绘兜底。
 - 本包执行器完整实现官方 `ctx.shell` seam(`resolve`/`run`/`start`/`runFor`/`startFor`/`entryFor`/`sandboxMode`),结构官方 PwshLocalExecutor 同构(实例状态/方法全公有——cordis 服务代理会把经 `ctx.shell` 调用的方法 `this` 重定向到阴影对象,`#` 私有触发品牌检查错误)。
-- preset 面收口(0.1.7 架构):agent 面整体移入会话预设(preset-* 声明行内联 roster,web 表面在根组合树禁用全部 agent 工具行)。本包 patch insert 自带预设 `shell-select`(standard 内联 roster 全量 − tool-pwsh 行,逐项同构官方 standard.patch.yml)并覆写 `agent-preset-registry` 的 default:win32 默认预设切到本包预设(POSIX 保持 standard,行为与上游一致)。用户显式选择其他预设恒优先——官方 minimal/cordis/ptc 预设自带 persistent pwsh 终端链,显式选用时不在接管范围。上游预设漂移由 `test/preset-drift.test.mjs` 逐行守卫,升级后按官方实文对表。
+- **不管理会话预设**:bundle 补丁仅插入主行、guard、web，不声明 `shell-select` 预设，不覆写 `agent-preset-registry` 默认值。宿主及用户选择的预设保持原样，已存活代理及其子代理可继续持有旧预设修订；部署若显式指定已删除的 `shell-select` 预设，应通过宿主预设选择入口改选现存预设，本包不保留别名或迁移路径。
+- **只隐藏模型展示，不禁执行能力**:执行器生命周期内通过官方 `system-prompt/assemble` 最终投影删除 `pwsh` 工具 schema 与重复的 `tool:pwsh` 段；native/both 移除模型工具 schema，PTC/both 重建 TypeScript/Python SDK，SDK 使用宿主公开 renderer 重建，不改官方预设、不添加禁止调用提示词。下一次模型步骤重新组装时生效，已发送请求不追溯修改。工具注册和 PowerShell 执行契约仍保留，旧/在途调用及历史卡不受影响；这是减少模型选择与提示成本的展示策略，不是硬拒绝，模型仍可能凭历史猜名调用。若该代理看不到 `shell`（如子代理工具允许集仅保留 `pwsh`），原展示保持不变，避免失去唯一终端；SDK renderer 不可用时整体不改并告警。执行器卸载自动移除投影监听。
 - 沙箱语义官方同构:`danger-full-access` 直跑;受限模式经 `ctx.sandbox.confine` 包装并按官方方言分类拒绝/runner 失败,权限模型不变。
 - 死态自愈:用户 patch 层禁用主行的窗口(接管中 runtime-disable 残留)内,guard 哨兵(id 含 `/`,市场不写该层)代挂官方 `dsh-tool-pwsh` + `dsh-pwsh-sandbox` 恢复 host 面服务与 boot 组合(预载失败退避重试,至多 3 次),任一方复活先卸代挂。哨兵/复活让位语义逐项同构 `dsh-llm-pi-gateway`。边界:cordis 服务按 fiber 树解析,代挂对 agent preset 作用域不可见,死态窗口新会话的 preset tool-pwsh 行拒挂(报错清晰)属预期。
 - escape hatch(用户想用官方 pwsh 链):market 禁用 shell-select 或 user patch 写 `- id: shell-select / disabled: true`——主行退场后官方行保持启用自服务,重启后官方自然回归;删除禁行重启即恢复接管。(官方两行带平台表达式,行级 `disabled: false` 与宿主默认启用同形,不作让位信号。)
@@ -21,6 +22,7 @@ Windows shell 链接管:禁用官方 `pwsh` 工具与执行器,替换为可配
 `shell` 工具(官方 `pwsh` 工具逐调用镜像):
 
 - 参数:`command`、`description`、`shell`(客户端 id,缺省用默认)、`timeoutMs`、`workdir`、`run_in_background`,沙箱升权面与官方一致。
+- 模型主描述先说明当前默认 `shell`,再按配置逐项列出客户端 id 与工作环境(WSL 附已配置发行版,不可用项标记 `unavailable`);存在可用 Bash 时统一追加 Windows 路径提示。主描述只讲常规调用,不包含拒绝重试流程;系统提示保留退出失败与 Windows 中断处理纪律,不重复客户端选择和独立进程说明。拒绝返回及权限执行契约不变。
 - 输出标记与官方逐字同构:`[exit code: N]`、`[killed by signal: X]`、`[timed out after …]`、`[sandbox: …]`、截断 spill 提示;terminal 卡退出 pill 照常复原。
 
 ## 会话卡(tool.call.toolview)
@@ -29,6 +31,7 @@ Windows shell 链接管:禁用官方 `pwsh` 工具与执行器,替换为可配
 
 - 折叠行:状态点(失败红/中断黄/其余工具图标)+ `Shell` 标题 + 描述首行摘要,失败摘要红显。
 - 展开卡:状态点 + cwd 末段目录 + 客户端名徽标 + 失败 pill(退出码/信号)+ 复制命令/复制输出按钮 + 命令折行带行号 + 输出区(横向滚动,竖向限高)。徽章忠实于执行事实:每次调用结果尾附 `[shell: <id>]` 标记(模型可见,官方退出标记同族),卡片按标记回放实际生效的客户端——缺省调用在配置事后变更或跨宿主查看时不被查看时读数改写;无标记的历史块回退显式参数 → 当前 default 推导。`pwsh`/`bash` 官方工具的调用无标记无 shell 参数,徽章按工具名钉死(客户端即工具名),永不落 default 读数。
+- **直接 pwsh 接管徽章**:模型直接调用 `pwsh` 且由本包执行器处理、结果落定并记录接管事实后，折叠行与展开卡显示独立「插件接管」徽章，客户端徽章仍为 `pwsh`。接管事实通过独立结构化结果块持久化，不进入模型文本、不改命令输出；未记录接管事实的历史调用不补标，stdout 中的相似文案不会冒充接管事实。普通 `shell` 调用（含 `shell: pwsh`）不显示该徽章。
 - 非终端意图回退简版行:摘要 + 可展开原文 + 检查按钮。
 - 图标取官方 `dsh-client-ui-primitives`(StateDot/IconApi/IconInspect),模块表缺席时降级自绘。行首无展开箭头,与官方组件一致,可展开性由指针与整行点击承载。
 
@@ -56,7 +59,7 @@ shell-select:
   default: pwsh
 ```
 
-出厂默认即上述三客户端;浏览器「设置 → Shell 管理」页可增删改、探测路径、扫描本机、编辑发行版与环境变量(环境编辑态每行一条 `K=V`)。第三方实现:任意可执行文件 + 自定义 args 模板。
+出厂默认即上述三客户端。设置中的 **Shell 管理** 沿用客户端卡片：在卡片内单选默认客户端，可添加/移除条目、探测路径及扫描本机、配置登录壳与 WSL 发行版。参数为空格分隔的文本，含空格的单项用引号包裹，例如 `-c "echo hello" {command}`，普通引号中的 Windows 反斜线不解码为控制字符，控制字符参数使用显式 `$'…'` 转义。环境按每行 `K=V` 编辑，普通值可含空格、等号和反斜线；含换行或以双引号开头的值显示为双引号字符串，仅此形式解析 `\n` 等转义。命令黑名单逐条添加/删除并显示行级正则错误，非法正则阻止保存；保留模式原有空白与换行，空字符串规则不参与拦截。没有编辑时保存按钮禁用；保存不会拆分未编辑的参数、改写正则或把自动探测路径写回声明值。保存后回读完整配置，执行预算保持不变，回读失败明确提示已保存但刷新失败。第三方实现:任意可执行文件 + 自定义 args 模板。
 
 env 优先级(同键高右):内置覆盖集(NO_COLOR/PAGER/GIT_PAGER)< 条目 `env` < 调用方环境(spec.env + 会话 `DSH_*` 事实)。wsl 形把条目 env 与调用方环境全部键(WSLENV 本身除外)追加进 WSLENV 白名单,过 WSL 边界不静默失效。
 
@@ -64,8 +67,8 @@ env 优先级(同键高右):内置覆盖集(NO_COLOR/PAGER/GIT_PAGER)< 条目 `e
 
 - 配置节顶层 `deny`:正则字符串数组,对模型提交的整条命令文本匹配(大小写不敏感),命中即拒绝——**deny 绝对,无豁免语义**;空数组 = 不拦截(出厂默认)。
 - 精细放行在模式内用正则前瞻表达:`deny: ['rm -rf\\s+(?!\\S*node_modules)']` 禁 rm -rf 但放行清依赖目录;默认放行系统下独立 allow 列表的唯一语义就是覆盖 deny,与"deny 绝对"矛盾,故不设。
-- 拦截点在执行器 runFor/startFor 入口:经 `ctx.shell` 代理的消费方(如 hooks 桥)与 preset 预设切换前的官方 pwsh 工具同样受管。拒绝以模型可见标记返回:`[blocked by shell-select: matches deny pattern …]`,后台任务在启动前同步拒绝,不产生僵尸任务。
-- 定位是防误触护栏而非安全边界:整文本正则挡不住间接包装(编码/嵌套壳),真正的边界始终是访问模式与沙箱。坏正则条目容错跳过,不瘫执行链;设置页为逐条规则编辑器(每条规则独立行,行级即时校验并标错,保存时按行定位拦截非法正则)。
+- 拦截点在执行器 runFor/startFor 入口:经本包 `ctx.shell` 代理的消费方(如 hooks 桥)与预设内消费该服务的官方 pwsh 工具同样受管。拒绝以模型可见标记返回:`[blocked by shell-select: matches deny pattern …]`,后台任务在启动前同步拒绝,不产生僵尸任务。
+- 定位是防误触护栏而非安全边界:整文本正则挡不住间接包装(编码/嵌套壳),真正的边界始终是访问模式与沙箱。坏正则条目容错跳过,不瘫执行链。
 
 ### bash 形探测与 msys2
 
@@ -78,7 +81,7 @@ env 优先级(同键高右):内置覆盖集(NO_COLOR/PAGER/GIT_PAGER)< 条目 `e
 
 - **受限模式 × Cygwin 系运行时**(git-bash/msys2):confine 包装后 Cygwin mmap 在受限令牌下崩溃(`CreateFileMapping … fatal error`,exit 256)。命令失败可见、错误自解释,模型可换客户端或升权重跑;危险模式与 pwsh/cmd/wsl 不受影响。与 dsh-bash-terminal-ts 观察一致,属 Cygwin 运行时限制而非本包缺陷。
 - wsl 形在未安装发行版的机器上:wsl.exe 输出 UTF-16 帮助文本,呈现为乱码;正常发行版下 bash 输出走管道为 UTF-8 不受影响。
-- 竞品来源主张的评审结论:不受配置清单约束的模型自选任意终端未采纳(本包的按名选择以设置页清单为边界,越界即报配置指引,官方升权面已覆盖安全需求);不受限 bash 危害面不做;交互式 PTY 终端本轮不做,列入路线图后续立项。
+- 竞品来源主张的评审结论:不受配置清单约束的模型自选任意终端未采纳(本包的按名选择以 settings JSON 配置清单为边界,越界即报配置指引,官方升权面已覆盖安全需求);不受限 bash 危害面不做;交互式 PTY 终端本轮不做,列入路线图后续立项。
 
 ## 组合
 
@@ -95,14 +98,4 @@ env 优先级(同键高右):内置覆盖集(NO_COLOR/PAGER/GIT_PAGER)< 条目 `e
 
 ## dsh 版本兼容
 
-宿主要求 ≥0.1.7-rc.1:bundle patch 引用 0.1.7 才有的 @deepseek-ai/dsh-agent-preset 宿主包,更旧宿主安装即 boot 失败(2026-09-27 裁定不视为缺陷)。
-
-- 0.2.0-rc.2:完全适配(设置面通过;16 格 LLM 工具调用格因模拟模型无 tool_calls 能力登记环境不可测,历史真机记录与单元测试覆盖)
-- 0.1.7-rc.2:不崩溃底线通过(全家桶 crash-only)
-- 0.1.5-rc.3:未承诺(本包宿主要求 ≥0.1.7-rc.1,该版本不安装;全家桶在该版本不启动,详见仓库 docs/兼容性测试/逐包测试进度.md)
-
-历史验收(Round 30,2026-09-27):0.1.7-rc.2 设置面 7 格过(自动探测/自定义路径/坏路径徽标/黑名单往返含行号拦截/默认热更落盘/preset 接管入册);运行时接管(Round 29)9291 keep 宿主实证 runtime-disable→fiber 激活+INV-6 残影稳定。
-
-更细的逐包结论见仓库 `docs/兼容性测试/逐包测试进度.md` 与本包 `兼容性测试.md`。
-
-测试:`node --test "test/*.test.mjs"`(包目录内)。
+按仓库动态窗口验证(scripts/compat/window.mjs),不预置任何固定版本槽:主测 = 渠道 dist-tag 最新 rc,完全适配口径;基线 = npm latest,不崩溃底线口径;主测与基线同版时收敛单槽。本包声明 `dsh.hostMin = "0.1.7-rc.1"`:低于该代际的宿主 API 面未验证,compat 装载层自动排除。逐轮实测结论见 `docs/兼容性测试/逐包测试进度.md` 与本包 `兼容性测试.md`。

package/cordis.patch.yml

@@ -1,192 +1,6 @@
-# shell-select bundle patch:Windows shell 链零感知接管(同构 dsh-llm-pi-gateway)。
-# 官方 tool-pwsh 与 pwsh-sandbox 行【不再静态禁用】:主行 apply 落定后经
-# entry.update 运行时禁用(dsh-market 同款,内存态不持久),本包任意死法
-# (import 崩/apply 崩/被禁/卸载)下官方 pwsh 链保持启用自服务,系统不出现
-# shell 全灭窗口(不变式与场景见 运行时接管-BDD.md)。主行提供 ctx.shell
-# 执行器、shell 工具与 systemPrompt 段,web 行提供设置页数据通道,guard 行
-# 哨兵自愈(死窗=接管中主行被禁的内存残留)。
-#
-# 平台门控:本包全部 insert 行在非 win32 停用(host 半区 apply 内另有平台早退,
-# 双重防护)。POSIX 官方 bash 链(tool-bash/bash-sandbox)与本包零接触;官方
-# pwsh 两行在 POSIX 本就被 dsh-base 平台表达式停用,Linux 行为与无本包逐字
-# 一致。接管空间判定:官方两行 win32 平台默认 disabled=false(启用),与用户
-# 显式启用在行树不可区分,凡非 true 即接管空间;POSIX 显式启用场景被 apply
-# 平台早退拦截,不会越过宿主平台门控强启官方行。
-#
-# escape hatch(用户想用官方 pwsh 链):market 禁用 shell-select,或 user patch
-# 写 `- id: shell-select / disabled: true`——主行退场后官方行保持启用自服务
-# (接管中被禁由 guard 代挂),重启后官方自然回归;删除禁行重启即恢复接管。
-#
-# 哨兵自愈与复活让位语义逐项同构 packages/dsh-llm-pi-gateway 的 guard/takeover,
-# 差异仅两处:官方代挂对象为 tool-pwsh + pwsh-sandbox 两行;行配置读官方
-# `shell` settings 节(pwsh-sandbox 经其 Config 消费,保持官方 pwshPath 配置)。
-#
-# preset 面:0.1.7 起 agent 面整体移入预设(preset-* 声明行内联 roster,旧
-# agent-presets roots 挂载机制已移除)。本包 patch insert 自带预设声明
-# (standard 全量 − tool-pwsh 行,逐项同构 dsh-web-app presets/standard.patch.yml)
-# 并覆写 agent-preset-registry 的 default——win32 切到本包预设、POSIX 保持
-# standard(本包行在 POSIX 全停用,行为须与上游逐字一致)。用户显式选择恒优先;
-# 上游 standard 漂移由 test/preset-drift.test.mjs 守卫,升级后须对表。
-
-# ── 预设面(0.1.7 架构):声明本包预设并接管 default ─────────────────────────
-# 0.1.7 的 agent 面整体移入预设:web 表面在根组合树禁用全部 agent 工具行,
-# 由 preset-* 声明行(@deepseek-ai/dsh-agent-preset,config.plugins 内联 roster)
-# 决定每个会话的工具面。旧架构的 agent-presets 行(roots 目录挂载)已不存在,
-# 覆写它只会得到 "patch: entry not found" 且 default 保持 standard——standard
-# 内联 roster 的 tool-pwsh(win32 启用)即模型工具面,pwsh 未被接管。
-# 收口 = 两段:insert 本包预设声明(standard 全量 − tool-pwsh),覆写
-# agent-preset-registry 的 default(patch 语义为整体替换 config,须逐键重述)。
-# win32 default 切到本包预设;POSIX 保持 standard(本包行在 POSIX 全停用,
-# 行为须与上游逐字一致)。用户显式选择其他预设恒优先;官方 minimal/cordis/ptc
-# 预设自带 persistent pwsh 链,显式选用时不在接管范围(README 已标注)。
-
-- insert:
-    - id: preset-shell-select
-      name: '@deepseek-ai/dsh-agent-preset'
-      disabled: !!js process.platform !== 'win32'
-      config:
-        id: shell-select
-        name: Shell 管理
-        order: 2
-        plugins:
-          - id: persona
-            name: '@deepseek-ai/dsh-persona'
-            config:
-              suffix: Your working directory is {{cwd}}.
-              prefix: >-
-                You are a coding agent powered by the {{model}} model.
-          - id: agent-instructions
-            name: '@deepseek-ai/dsh-agent-instructions'
-            config:
-              maxBytes: 65536
-          - id: tool-bash
-            name: '@deepseek-ai/dsh-tool-bash'
-            disabled: !!js process.platform === 'win32'
-          - id: tool-fs
-            name: '@deepseek-ai/dsh-tool-fs'
-          - id: tool-fs-search
-            name: '@deepseek-ai/dsh-tool-fs-search'
-            config:
-              sampleOverCapGlobResults: false
-          - id: tool-jobs
-            name: '@deepseek-ai/dsh-tool-jobs'
-          - id: skill-filesystem
-            name: '@deepseek-ai/dsh-skill-filesystem'
-          - id: tool-skill
-            name: '@deepseek-ai/dsh-tool-skill'
-          - id: command-goal
-            name: '@deepseek-ai/dsh-command-goal'
-          - id: tool-goal
-            name: '@deepseek-ai/dsh-tool-goal'
-          - id: planning
-            name: cordis:group
-            group: true
-            isolate:
-              planMode: true
-            config:
-              - id: plan-mode
-                name: '@deepseek-ai/dsh-plan-mode'
-                config:
-                  section: |
-                    You are in plan mode. Stay in plan mode until exit_plan_mode succeeds or the user switches the session mode. Imperative language to implement changes means plan the implementation, not execute it. A user's conversational agreement — including an answer confirming something you asked — approves nothing and does not end plan mode; fold the confirmed decision into the plan and submit it through exit_plan_mode.
-
-                    Explore first. Use non-mutating reads, searches, static analysis, and checks to ground the plan in the actual repository. Do not edit or write files, change configuration, run formatters or code generation that rewrites tracked files, commit, or otherwise carry out the plan. Prefer existing functions and patterns over new machinery.
-
-                    The tool catalog stays the same across modes for request-cache stability. These plan-mode rules override any later tool description or guidance that suggests using mutation tools; those tools remain listed to keep the tool catalog unchanged. Do not use todo_write to track this planning phase: it tracks implementation after an approved plan, while the plan itself belongs in exit_plan_mode.
-
-                    Resolve discoverable facts by inspection. Use ask_user_question only for user-owned choices or material ambiguity that inspection cannot answer. Do not ask the user where code lives or how current behavior works when you can find out.
-
-                    Make the plan decision-complete: state the goal and success criteria; group implementation changes by subsystem; identify public API, schema, and data-flow changes; cover edge cases, failure modes, tests, acceptance criteria, and explicit assumptions. Keep it concise enough to review but detailed enough that another engineer can implement it without making design decisions.
-
-                    When ready, call exit_plan_mode with the complete plan markdown, starting with a # title. Make exit_plan_mode the only and final tool call in that assistant response: it presents the plan for approval, and implementation begins only in a later step after approval. Do not paste the final plan as a plain reply or ask "should I proceed?" through prose or ask_user_question. If review rejects it, incorporate the feedback and present again. If the review channel is unavailable or aborted, stay in plan mode and ask the user to switch modes manually; do not proceed with implementation.
-          - id: compaction
-            name: cordis:group
-            group: true
-            isolate:
-              compaction: true
-              toolResultPruner: true
-            config:
-              - id: compaction-basic
-                name: '@deepseek-ai/dsh-compaction-basic'
-              - id: command-compact
-                name: '@deepseek-ai/dsh-command-compact'
-              - id: tool-result-pruner
-                name: '@deepseek-ai/dsh-compaction-tool-result-pruner'
-                config:
-                  thresholdChars: 8192
-                  headChars: 4096
-                  tailChars: 1024
-          - id: delegation
-            name: cordis:group
-            group: true
-            isolate:
-              workflowEngine: true
-            config:
-              - id: tool-subagent-control
-                name: '@deepseek-ai/dsh-tool-subagent-control'
-              - id: tool-subagent-list-agents
-                name: '@deepseek-ai/dsh-tool-subagent-control/list-agents'
-              - id: tool-subagent
-                name: '@deepseek-ai/dsh-tool-subagent'
-                config:
-                  provider: spawn
-                  toolName: subagent
-                  modelSelectionSettings: true
-                  backgroundMode: continuable
-              - id: tool-subagent-fork
-                name: '@deepseek-ai/dsh-tool-subagent'
-                config:
-                  provider: fork
-                  toolName: subagent_fork
-                  backgroundMode: continuable
-              - id: tool-subagent-codex
-                name: '@deepseek-ai/dsh-tool-subagent'
-                disabled: true
-                config:
-                  provider: codex
-                  toolName: subagent_codex
-                  backgroundMode: one-shot
-                  maxDepth: provider-managed
-              - id: tool-subagent-claude-code
-                name: '@deepseek-ai/dsh-tool-subagent'
-                disabled: true
-                config:
-                  provider: claude-code
-                  toolName: subagent_claude_code
-                  backgroundMode: one-shot
-                  maxDepth: provider-managed
-              - id: workflow-ptc
-                name: '@deepseek-ai/dsh-workflow-ptc'
-                config:
-                  provider: spawn
-              - id: tool-workflow
-                name: '@deepseek-ai/dsh-tool-workflow'
-              - id: tool-ralph
-                name: '@deepseek-ai/dsh-tool-ralph'
-                disabled: true
-                config:
-                  subagentProvider: spawn
-                  maxRounds: 64
-          - id: tool-ask-user
-            name: '@deepseek-ai/dsh-tool-ask-user'
-          - id: tool-todo
-            name: '@deepseek-ai/dsh-tool-todo'
-            config:
-              allowParallelInProgress: true
-          - id: tool-web
-            name: '@deepseek-ai/dsh-tool-web'
-            config:
-              fetch: true
-              searchTimeoutMs: 60000
-          - id: present
-            name: '@deepseek-ai/dsh-tool-present'
-          - id: tool-plugin-manager
-            name: '@deepseek-ai/dsh-plugin-manager/tools'
-            disabled: true
-
-- id: agent-preset-registry
-  config:
-    default: !!js "process.platform === 'win32' ? 'shell-select' : 'standard'"
+# Windows 宿主 shell 链运行时接管；不声明会话预设、不修改默认预设。
+# 官方 tool-pwsh 与 pwsh-sandbox 不静态禁用：主行可服务后接管，失败回滚。
+# guard 守服务，web 提供配置通道；POSIX 全部停用，官方 bash 链不受影响。
 
 - insert:
     - id: shell-select

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mzzsfy/dsh-shell-select",
-  "description": "Windows shell 接管:替换默认 pwsh 工具为可配置多客户端的 shell 工具(git bash/WSL/cmd/pwsh,自定义路径,默认客户端,模型按名选择)",
-  "version": "0.4.1",
+  "description": "Windows shell 接管:替换默认 pwsh 工具为可配置多客户端的 shell 工具(git bash/WSL/cmd/pwsh,自定义路径,默认客户端,模型按名选择);支持命令 deny 黑名单、会话终端卡增强和直接 pwsh 接管徽章,接管失败自动回退官方 pwsh 链",
+  "version": "0.4.4",
   "type": "module",
   "main": "src/index.js",
   "exports": {
@@ -26,7 +26,14 @@
         "@deepseek-ai/dsh-client-ui-conversation"
       ]
     },
-    "hostMin": "0.1.7-rc.1"
+    "hostMin": "0.1.7-rc.1",
+    "compatibility": {
+      "dshReleases": {
+        "0.2.0-rc.1": "unknown",
+        "0.2.0-rc.2": "compatible",
+        "0.2.1-alpha.1": "unknown"
+      }
+    }
   },
   "scripts": {
     "test": "node --test \"test/*.test.mjs\"",
@@ -42,7 +49,6 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-agent-preset": ">=0.1.7-rc.1",
     "@deepseek-ai/dsh-http-proxy": ">=0.1.5-rc.2",
     "@deepseek-ai/dsh-jobs": ">=0.1.5-rc.2",
     "@deepseek-ai/dsh-llm": ">=0.1.5-rc.2",

package/src/api.mjs

@@ -61,7 +61,7 @@ function readBody(req) {
 /**
  * 挂载配置/探测路由。可写操作(settings.update)在 settings 缺席时由闭包抛错归一 400。
  * @param {object} ctx cordis context
- * @param {{listShells: Function, readConfig: Function, updateConfig: Function, detect: Function, probe: Function}} faces
+ * @param {{listShells: Function, readConfig: Function, updateConfig: Function, detect: Function, probe: Function, pathMap: Function}} faces
  */
 export function mountRoutes(ctx, faces) {
   const webServer = ctx.get('webServer')
@@ -94,6 +94,12 @@ export function mountRoutes(ctx, faces) {
         sendJson(res, 200, { exists: faces.probe(candidatePath) })
       }),
     },
+    {
+      path: `${API_ROOT}/pathmap`,
+      handler: route('GET', async (req, res) => {
+        sendJson(res, 200, faces.pathMap())
+      }),
+    },
     {
       path: `${API_ROOT}/detect`,
       handler: route('POST', async (req, res) => {