Files
apes-sidebar/docs/plans/2026-09-21-dsh-0.1.6-alpha.2-adaptation.md
T
Menghuan1918 de99fd4cfb docs: record the 0.1.6-alpha.2 adaptation and resync the user docs
Adds the per-version adaptation record (docs/plans/2026-09-21-…-adaptation.md),
rewrites AGENTS.md §3 for the new baseline (the two silent contract breaks, the
terminal/browser handoff, the new official plugin-manager surface, the three
ui-primitives breaks, the widened primitives bare-import set), and updates both
READMEs and the integration guide for the v0.20.0 feature set.

Also retires the support text the terminal deletion made false: the install
flow is one step again (no build-script approval), the FAQ's two node-pty rows
collapse into one pointing at DSH's own terminal, the platform note no longer
promises prebuilt native binaries (there are no native deps left), and the
installers drop the -Repair mode and their allowBuilds writes along with
pnpm-workspace.yaml's now-empty allowBuilds block. Removes the dead
browserNoSandboxWarning locale key (its setting went with the plugin's browser)
and tightens theme.spec's capsule guard so a literal colour fails it.

The e2e resolver now refuses a PATH  that is not on the baseline line:
this machine's PATH  is 0.1.6-alpha.1, and running the mount lane against
it fails at 'the bundle was not registered' with a zero exit from the CLI —
a misleading dead end worth one explicit error instead.
2026-09-21 21:00:09 +08:00

25 KiB
Raw Blame History

DSH 0.1.6-alpha.2 适配(v0.20.0 基线)

日期:2026-09-21 分支:feat/dsh-0.1.6-alpha.2

背景

DSH dsh-v0.1.5-rc.2..dsh-v0.1.6-alpha.2(上游 1687 个 commit,中间还有 dsh-v0.1.6-alpha.1;git diff --shortstat = 5420 个变更文件 / +878 484 / −63 637)是 0.1.6 线的第二个预发布版,也是本插件自 rc.1 以来第一次遇到真实破坏的 delta。两件关键的事实构成这版全部工作:

  1. 两条插件面向的硬契约收紧,且都是静默失败(§上游 delta 1/2);三条 ui-primitives 破坏是编译期可见的。
  2. 宿主内置了插件原本自研的两个面(右列终端、右列浏览器)。继续保留就是同一面存在两套实现,并且遮蔽产品正在开发中的宿主类型。

本计划记录该 delta、逐项结论与子系统级落点;上一版记录见 2026-09-10-dsh-0.1.5-rc.2-adaptation.md,仓库级适配要点同步到 AGENTS.md §3(本版整体重写,是该节的权威摘要)。

本版由三条 commit 组成(git log --oneline -4,git show --stat <sha>):

# commit 主题 规模
1 58ba17d fix(native): meet DSH 0.1.6-alpha.2 guide-id and turn-tail contracts 17 files,+135 / −611
2 d608998 chore(baseline): target DSH 0.1.6-alpha.2 and drop 0.1.5-rc support 27 files,+448 / −350
3 5912274 feat: yield the terminal and browser to DSH 0.1.6's own sidebar types 79 files,+381 / −9 464

上游 delta(rc.2 → alpha.2,影响本插件的部分)

所有 alpha.2 结论都用 tag 取证(git -C /tmp/dsh-0162 diff dsh-v0.1.5-rc.2 dsh-v0.1.6-alpha.2 -- <path> / git show dsh-v0.1.6-alpha.2:<path>),不引用工作树、不引用记忆。

# 上游变更 上游文件(alpha.2) 对插件的影响
1 SidebarRightGuideEntry.id 变必填且同一 provider 内唯一;注册时 new Set(entries.map(e => e.id)).size !== entries.length 抛 duplicate guide entry id packages/client/ui-sidebar-right/src/client/tab-registry.ts(抛点 :251,接口定义 :61 起;单测 tests/tab-registry.client.spec.ts:302) 破坏(静默):插件两个 guide 条目都在 undefined 上相撞 → register 抛错 → 抛点在本插件 ctx.inject(['sidebarRightTabs'], cb) 的回调体内被 cordis 吞掉 → 整个原生承载面空掉(指南无条目、openTab 全拒)。→ §决策 6
2 conversation.chat.turnTail 由 chain 改 list;list 槽要求 options.id,缺则抛 list slot "…" requires options.id packages/client/ui-chat/src/client/contract/slots.ts:213;抛点在 packages/client/ui-slots/src/index.ts:1230 破坏(静默):插件传 select 直接抛(同样被吞)。语义也变了——chain 的 select 让一个条目替换宿主产物行,list 只能追加。→ §决策 5
3 ui-primitives 三处导出面变化:IconSendOutline16 不再导出(只剩 IconSendOutline14);TerminalBlockLabels 新增必填 noExitCode;ConnectionIndicator 删掉 reconnectLabel packages/client/ui-primitives/src/icons/index.tsx(IconSendOutline16 在 rc.2 有、alpha.2 无)、src/**(git diff … -- packages/client/ui-primitives/src 里 −reconnectLabel / +noExitCode) 破坏(编译期):适配见 §改动清单「基线」
4 宿主自带右列终端:ui-sidebar-terminal + api-terminal-controller;模型侧等价物 packages/terminal/tool-terminal(包名 @deepseek-ai/dsh-tool-terminal)未被任何 shipped bundle 挂载 packages/client/ui-sidebar-terminal/**、packages/api/terminal-controller/**、packages/terminal/tool-terminal/** 让位 → 插件整套 PTY 栈删除。证据:git grep -rn tool-terminal -- packages/bundle/ 在 alpha.2 只有 1 处命中且是注释(packages/bundle/web-app/cordis.patch.yml:404,讨论后台 job 注册表的生产者),没有任何 bundle 行挂载该包
5 宿主自带 browser kind,且 ui-chat 已内置把正文 http(s) 链接委派给它 packages/client/ui-sidebar-browser/**;packages/client/ui-chat/src/client/apply.ts:147(ctx.get('sidebarRightTabs')?.get('browser') 守卫后 ctx.sidebarRight.openTab('browser', { params: { url } })) 让位 → 插件 browser tab 类型与宿主 browser.probe 路由删除;DOM 层链接接管保留(宿主不做按协议分流)
6 原生右列布局现在持久化:localStorage 的 dsh.sidebar-right.v1.<sessionId>(zod 校验,tab 体渲染前恢复) packages/client/ui-sidebar-right/src/client/persistence.ts(sidebarPersistence = 'dsh.sidebar-right.v1')、README.zh.md:72 §3.10 里「原生布局只在内存,不做持久化」的旧说法对 0.1.6 起已失效;插件不接入、只用现成面
7 sidebar-right 新增面:SidebarRightTabDefinition.multiple?、SidebarRightPlacement.preferNewPane?、class 上的 openTabs / tabsIn(sessionId) / registerCloseHandler(kind, handler)(不在 ISidebarRight 接口里)、keyed 槽 sidebar.right.tab.guide.entry tab-registry.ts:103、contract/slots.ts:117、service.ts:218/228/261/387 插件只用到 multiple;其余仅保证不破坏
8 官方管控面:新增 packages/boot/plugin-manager(ctx.pluginManager + plugin_manager 工具)与 packages/client/ui-plugin-manager(Web Plugins 页);dsh.profile.patchReload 在 alpha.2 已从代码与文档整体消失(rc.2 由 apps/cli/src/plugin.ts / profile-boot.ts 读取 + 4 份 apps/cli/** 文档 10 处说明;alpha.2 在 packages/ + apps/ 上 0 命中,只剩 .agents/notes 的陈旧文本);HMR 归 packages/boot/hmr 同上 零额外声明:两者都会接管任何已声明 dsh.bundle.patch 的包(本插件 package.json 的 dsh.bundle.patch = ./cordis.patch.yml),本插件无需适配。patchReload 本插件从未消费(grep -rn patchReload src tests scripts 零命中),因此删除对本插件零影响
9 依赖形状:ui-primitives 仍不声明 dependencies(peerDependencies 只有 @deepseek-ai/cordis),bundle 新增裸 import diff(src/DiffBlock.tsx:3)与 simple-icons(src/SiteGlyph.tsx:44,全新 3 万余品牌图标集);packages/code-runtime 整包消失(rc.2 还在,npm 上停在 0.1.5-alpha.2) packages/client/ui-primitives/package.json、packages/client/ui-primitives/src/* devDependencies 提升 diff / simple-icons;移除 @deepseek-ai/dsh-code-runtime

明确未变(不必再核):

  • 指南「列出的条目 ≤ 4 条才渲染说明」的规则仍在:MAX_DESCRIBED_ENTRIES = 4(packages/client/ui-sidebar-right/src/client/tabs/guide/GuideBody.tsx:40)。
  • 一次性 token 鉴权、斜杠 RPC 方言、MarkdownText labels 嵌套契约、会话事件模型(assistant/assistant-stream 瞬时帧):全部沿用 0.1.5 线结论,本版零改动。
  • 插件的承载面用法不变:仍由 ctx.inject(['sidebarRightTabs'], cb) 驱动类型注册(不能等槽声明),仍只经 ctx.sidebarRight.openTab/openResource/close 与具体类上的 openTabIn/… 操作。
  • 宿主仍有 chain 槽(如 conversation.composer、sidebar.right.tab.guide),但本插件从未注册它们——插件的槽面只有三处:conversation.session.header.utilities(底部工作台开关)、settings.section、原生 sidebar.right.pane.tab / .title;唯一用过的「整行接管」型贡献(轮尾产物行)随 turnTail 改 list 而删除(#2)。
  • dsh.plugin.json 不是 DSH 契约:git grep -n 'dsh\.plugin\.json' 在 dsh-v0.1.5-rc.2 与 dsh-v0.1.6-alpha.2 上均 0 命中。它只服务第三方 registry(社区市场)通道,lib/client-registry.js 同理。

决策

  1. peer 下限必须动:^0.1.5-rc.1 → ^0.1.6-alpha.2。semver 的预发布规则要求比较子与候选版本同 [major,minor,patch] 元组,^0.1.5-rc.1 在数学上永远容纳不下任何 0.1.6-* 预发布版。实测(用仓库树内的真实 semver@7.8.5):

    range \ candidate 0.1.5-rc.2 0.1.6-alpha.1 0.1.6-alpha.2 0.1.6-alpha.3 0.1.6-rc.1
    ^0.1.5-rc.1 true false false false false
    ^0.1.5-rc.2 true false false false false
    *(裸) false false false false false
    ^0.1.6-alpha.2 false false true true true

    即:0.1.5 的下限不是「保守」而是结构上不可能容纳 0.1.6 预发布;^0.1.6-alpha.2 天然容纳 0.1.6 的 alpha/rc 全线并排除 0.1.5。

  2. 支持线取舍:0.1.5-rc.* 用户停留在 v0.19.1。rc.2 → alpha.2 有真实破坏(#1/#2),按本仓库先例(v0.19.0 抬到 0.1.5-rc.1 时直接桥掉 0.1.2 线)不写运行时兼容层;0.1.5-alpha.2 及更早同样停留在旧版。engines.dsh 与 peer 下限同源(同一个支持范围,两处不能分叉)。

  3. 终端整体让位:删除整套 PTY 栈(见改动清单),宿主 ui-sidebar-terminal 成为唯一提供者。接受模型侧代价并写进 README:插件原有的 8 个 terminal_* 工具(terminal_create/list/send/read/wait/resize/signal/close,默认关)是模型唯一的跨调用持久终端,而上游等价物 @deepseek-ai/dsh-tool-terminal 未被任何 shipped bundle 默认挂载,删除后模型只剩一次性 bash / pwsh——这是「不维护第二套 PTY」的既定代价,不是意外,所以不补自家的替代实现。

  4. 浏览器让位,但保留 DOM 层链接接管。宿主不做按协议分流(https 默认交系统浏览器),那是插件唯一还能提供的能力,因此 src/client/link-intercept.ts 与已发布的 urlTarget 机制(v0.13.0+,第三方消费插件按它声明)不动;接管目标改指宿主的 browser kind(ctx.sidebarRight.openTab('browser', { params: { url } })),并保留 window.open 兜底——宿主没装该包时不至于点了没反应。

  5. 轮尾接管整体删除。list 只能追加,插件再注册一行只会与宿主的产物卡重复;上游是有意选 list(「An additive list lets both plugins contribute without either knowing the other's data or rendering」,.agents/notes/implemented/feature/2026-09-17-persistent-plan-cards.md:27)。产物行交回宿主,它开文件走宿主 openFile → 本插件的 editor,行为不变。文件打开的那一半(sidebar-file.ts)与路径助手(paths.ts 的 resolveSidebarPath)保留,因为文件变动 tab 与编辑器宿主仍在用。

  6. guide 条目 id 作为类型契约落进插件侧:两个条目各自带 id(descriptor id / 'files'),并加测试守护「每个 guide 条目 id 非空且互不重复」。不做运行时兜底(自动补 id 会把契约破坏变成永久沉默,正是这次最难查的形态)。

  7. 加一条可见的失败接缝:registerNativeSurface 新增可选 reportFailure(phase, error),接到 src/client/index.tsx 的 fail() 可见诊断条;单个 descriptor 注册失败不再带走其余注册。理由就是这次的症状——整个原生承载面静默空掉,除了一行缺失的指南之外没有任何提示。

  8. 卡片采用宿主胶囊配方,但字重走令牌阶梯:几何/描边/填充/圆角照抄宿主 GuideBody.module.css 的 .entry(0.5px --dsw-alias-border-l4 / 24px 圆角 / --dsw-alias-bg-layer-1 / min-height: 56px / padding: 14px 20px),标签字号不抄宿主那里的裸 font-size: 15px(它背后没有令牌),改用阶梯最近一档 --dsw-font-s-strong-14(14px medium)。皮肤契约要求插件侧零豁免面(AGENTS.md §5)。

  9. 不接入本版新增的宿主面:openTabs / tabsIn / registerCloseHandler / preferNewPane / keyed guide.entry 槽 / 全局面板——插件只用到 multiple 与既有面。

改动清单(子系统级)

子系统 文件 变更
基线 package.json version → 0.20.0;15 个 @deepseek-ai/* peer 下限 ^0.1.5-rc.1 → ^0.1.6-alpha.2;devDependencies 同步钉 0.1.6-alpha.2;移除 @deepseek-ai/dsh-code-runtime(上游整包消失);新增 diff ^9.0.0、simple-icons ^16.32.0(ui-primitives 裸 import,不走 devDependencies 就 Cannot find package)
基线 dsh.plugin.json version → 0.20.0;engines.dsh → >=0.1.6-alpha.2
基线 pnpm-lock.yaml 锁文件对齐 alpha.2(646 行变动)
基线 .github/workflows/ci.yml mount 车道钉 @deepseek-ai/dsh@0.1.6-alpha.2;注释改为「alpha.2 是 npm 的 alpha dist-tag,latest 仍是 0.1.5 线」
基线 scripts/e2e-common.sh 回退 npx 显式钉版:新增 DSH_NPX_SPEC(缺省 @deepseek-ai/dsh@0.1.6-alpha.2)——不钉就会解析 latest,而 latest 仍是插件已不支持的 0.1.5 线
基线 src/client/service.ts SIDEBAR_SERVICE_VERSION → 0.20.0(tests/service.spec.ts 断言它 === package.json 的 version)
基线 src/client/SideChatView.tsx IconSendOutline16 → IconSendOutline14 size={16}(保住原 16px 视觉尺寸);TerminalBlockLabels 补必填 noExitCode: t('sideChatBlockNoExitCode');ConnectionIndicator 去掉 reconnectLabel
基线 src/client/locales.ts + 19 份 locales-*.ts(共 20 份词典) 新增 sideChatBlockNoExitCode(zh「已结束(无退出码)」/ en「Ended without an exit code」+ 各语言);sideChatConnDisconnected 改口径为「连接已断开,点击立即重连」——断线标签现在自身命名重试动作,跟随宿主文案
Tab 契约 src/client/native/index.ts 两个 guide 条目各带 id(descriptor id / 接管条目 'files');NativeSurfaceDeps 新增可选 reportFailure?: (phase: string, error: unknown) => void,wrapper 内 try/catch 上报(单个 descriptor 失败不再带走其余注册)
Tab 契约 src/client/index.tsx fail() 诊断条上移到 apply() 前部,并以 reportFailure: (phase, error) => fail(\native ${phase}`, error)注入registerNativeSurface`
Tab 契约 tests/native-surface.spec.ts +15 行:遍历注册到的全部 guide 条目,断言每个 id 是 string、总数 > 0、new Set(ids).size === ids.length
轮尾 src/client/intercept.tsx(−131)、src/client/produced-files.ts(−120)、tests/turn-tail-intercept.spec.ts(−200)、tests/produced-files.spec.ts(−56) 轮尾接管整体删除;src/client/sidebar.module.css 的接管样式随之删(−46)
轮尾 src/client/sidebar-file.ts(新增 30)、src/client/paths.ts(+13) 文件打开的那一半存活(文件变动 tab 与编辑器宿主仍用);resolveSidebarPath 移进同胞路径助手模块(绝对路径判定镜像宿主:POSIX 根 / 盘符 / UNC 都不拼 cwd)
终端 删除 src/pty-manager.ts(−548)、src/agent-pty.ts(−722)、src/pty-deps.ts(−240)、src/tools.ts(−500)、src/client/TerminalView.tsx(−477)、src/client/TerminalWaitBanner.tsx、src/client/terminal-font.ts(−255)、src/client/terminal-links.ts(−194)、src/client/chunks/terminal.tsx、src/client/pinned.ts(−177)、src/client/sidebar/use-pinned-tabs.ts(−147) 整套 PTY 栈、xterm 视图、字体/链接助手、chunk 入口与跨会话固定终端全部下线
终端 src/index.ts(+14 / −560)、src/config.ts(−48)、src/prefs-shared.ts、src/client/prefs.ts(−26)、src/client/api.ts(−40)、src/client/state.ts(+11 / −244)、src/client/TabBar.tsx(+20 / −76)、src/client/Sidebar.tsx(+16 / −91)、src/client/icons.tsx(−11) 终端设置项(terminalShell / terminalShellArgs / terminalFontFamily / terminalFontSize / agentTerminalTools / bottomPanelAutoTerminal)、宿主路由 terminal.deps、clampTerminalFontSize,以及被删特性留下的死状态(SidebarTab.pin / nextTerminal / agentWaits / bottomOpenedOnce / agent-tab helpers / pinned-tab memo key)一并清除
终端 package.json node-pty ^1.1.0 离开 dependencies;@xterm/xterm、@xterm/addon-fit 离开 devDependencies;files 去掉 lib/client-terminal.js
终端 pnpm-workspace.yaml 原 allowBuilds: {node-pty: true, protobufjs: true} 收缩(块未整块删除,见「收尾偏差」2)
终端 tsdown.config.ts、src/bundle-route.ts、src/client/chunk-loader.ts、scripts/package-registry.mjs、package.json 的 files、tests/{bundle-route,chunk-loader,chunk-artifact,manifest-consistency,lazy-chunk}.spec.* chunk 名由 ['editor','mermaid','locale','terminal'] 收敛为 ['editor','mermaid','locale'](AGENTS.md §5 列出的镜像处全部同步)
终端 删除 13 个 spec agent-pty / agent-terminal-reconcile / agent-wait-badge / bottom-auto-terminal / open-when-sized / pinned / pty-deps / pty-helpers / terminal-deps-banner / terminal-font / terminal-links / terminal-wait-banner / tools
浏览器 删除 src/client/BrowserView.tsx(−289)、src/client/browser.ts(−167)、src/browser-probe.ts(−26)、tests/browser.spec.ts、tests/browser-probe.spec.ts;src/client/builtins/tabs.tsx(+13 / −175)删 browser descriptor 插件 browser tab 类型下线,宿主 browser kind 独占嵌入页(两条 commit 合计删 15 个 spec:终端 13 + 浏览器 2)
浏览器 src/index.ts(删宿主 browser.probe 路由)、src/prefs-shared.ts / src/client/prefs.ts(删 browserNoSandbox / browserAllowedLoopback)、src/config.ts 只配置插件自家 iframe 的两个设置项随它们喂养的宿主路由一并删除(宿主 browser kind 不进插件注册表)
浏览器 src/client/link-intercept.ts、src/client/sidebar/use-host-feeds.ts:128 保留 DOM 层 http(s) 接管,目标改宿主 browser kind(ctx.sidebarRight.openTab('browser', { params: { url } }) + window.open 兜底);urlTarget 机制与匹配顺序(matchUrlTarget)不变
卡片 src/client/sidebar.module.css .paneCard 采用宿主 guide 胶囊配方:min-height: 56px / padding: 14px 20px / border: 0.5px solid var(--dsw-alias-border-l4) / border-radius: 24px / background: var(--dsw-alias-bg-layer-1) / font: var(--dsw-font-s-strong-14) / hover 用 --dsw-alias-interactive-bg-hover
卡片 tests/theme.spec.ts(+23) 守护 .paneCard 的几何与「每条 paint 都解析到 var(--dsw-」,并断言不得出现上游专有拼写 --dsw-alias-bg-l1 / --dsw-alias-bg-l2(证据:alpha.2 全树 4 处声明、0 处定义,全在 packages/client/ui-sidebar-terminal/src/client/*.module.css,故上游那 4 条 background 实际被丢弃)
挂载冒烟 tests/e2e/mount.e2e.ts 指南 sweep 拆成「插件自有 4 条(files / git / subagent / sidechat)+ 宿主自有 2 条(terminal / browser,各恰好 1 条——多 1 条即插件又在遮蔽宿主)」;说明表断言从「关 3 个 tab 类型」改「关 2 个」(宿主终端条目已不在插件注册表内)
聚合冒烟 scripts/e2e-aggregate-mount.sh 真方法哨兵从已删的 terminal.deps 改为 settings.get(理由写进脚本注释:/sidebar/api 是插件自己 fence 的 prefix 路由,未注册方法统统 404,{"ok":true} 只可能来自真实注册的 handler)
文档 AGENTS.md §3 重写为「DSH 0.1.6-alpha.2 适配要点(0.1.6-alpha.2+ 基线)」:支持线 + 两条硬契约 + 两处让位 + 「本版还需知道的」9 条
文档 README.md v0.20.0 段落、终端/浏览器「交还宿主」说明、支持版本徽章;终端卡片内写明模型侧代价与自行插入 tool-terminal 行的指引
文档 docs/plans/2026-09-21-dsh-0.1.6-alpha.2-adaptation.md 本计划

收尾偏差(核对实际文件后修正的三处口径)

这三处不是计划项,而是核对文件时发现的「提交信息与产物不符」;写在这里以免被当作已完成,也给下一版留证据:

  1. 安装脚本的 -Repair 模式:5912274 的提交信息与 README.md 都称它已随终端删除,但三条 commit 都没有触碰这两个文件——git diff --stat HEAD~3..HEAD -- scripts/ 只有 e2e-aggregate-mount.sh / e2e-common.sh / package-registry.mjs 三个。scripts/install.sh(--repair,改动前行号 15/19/54/57/75/82/180)与 scripts/install.ps1(-Repair,改动前行号 22/26/51/175)当时完整保留了 node-pty 修复流程与 issue #140 文案。该偏差已在本分支工作树修掉(两个安装脚本 + e2e-common.sh 里 scratch profile 的 allowBuilds 块 + package-registry.mjs 的 node-pty 注释),截至本文档写作时尚未提交(见「落地」)。
  2. pnpm-workspace.yaml 的 allowBuilds 块仍未收干净:现状是 node-pty: set this to true or false(pnpm 自己写的待决占位行);原条目 node-pty: true 被换成该占位、protobufjs: true 被移除。块本身仍在,且仍以已删除的依赖名出现——本版未处理。
  3. browserNoSandboxWarning 成了死键:20 份 src/client/locales*.ts(词典 locales.ts + 19 份第三方语言)里仍在,而它描述的 browserNoSandbox 设置项已删,代码侧除词典外零消费——本版未处理。

验证

  • 门禁(本版分支 HEAD 5912274,macOS arm64):pnpm install --registry=https://registry.npmjs.org(必须显式指定 registry——机器默认的 npmmirror 源滞后,对 @deepseek-ai/dsh-code-runtime 报 404);pnpm peers check = No peer dependency issues found;pnpm typecheck 干净;pnpm lint 干净;pnpm check:consumer-types OK;pnpm test = 110 files / 1085 passed / 9 skipped;pnpm build 恰好产出三个 chunk(client-editor.js / client-mermaid.js / client-locale.js)。
  • 写本文档时复核过的两条:pnpm peers check = No peer dependency issues found、pnpm test = 110 files / 1085 passed / 9 skipped,与上条一致(复核时工作树只有文档改动,测试文件与 HEAD 一致,因此数字对应 HEAD 的测试面;此后工作树又改动了 tests/theme.spec.ts 等收尾文件,未重跑)。typecheck / lint / check:consumer-types / build 未重跑(本节记录的是门禁那一次的结果)。
  • 真机挂载冒烟(DSH 0.1.6-alpha.2):未执行。pnpm test:mount 与 pnpm test:mount:aggregate 在本版分支上没有跑过——这是本版最大的未验证面:指南「插件 4 条 + 宿主 terminal/browser 各恰好 1 条」、聚合哨兵改 settings.get、卡片新几何,目前只有单测与 e2e 代码,没有真机结论。
  • 3080 实例 GUI 人工验证:未执行。
  • 上游事实的取证方式:本文每条 alpha.2 结论都来自 tag(git -C /tmp/dsh-0162 diff dsh-v0.1.5-rc.2 dsh-v0.1.6-alpha.2 -- <path> / git show dsh-v0.1.6-alpha.2:<path>),关键抛点原文为 sidebarRight: duplicate guide entry id in "<id>"(tab-registry.ts:251)与 list slot "<name>" requires options.id(ui-slots/src/index.ts:1230)。semver 表用仓库树内的 semver@7.8.5 实测。
  • 未验证的推断(明确标注,不作为结论):「模型只剩一次性 bash / pwsh」是按两条已验证事实推出的——① @deepseek-ai/dsh-tool-terminal 未被任何 shipped bundle 挂载(packages/bundle/ 零挂载行);② 插件删除的 src/tools.ts 确实注册了 8 个 terminal_* 工具。没有在真机上对模型可见工具清单做过实测。

落地

  • 分支:feat/dsh-0.1.6-alpha.2,三条 commit(HEAD 5912274)之上还有一批未提交的收尾改动:AGENTS.md §3 重写、README.md / README_EN.md、docs/external-plugin-guide.md、scripts/install.sh / install.ps1(删 -Repair / --repair)、scripts/e2e-common.sh / e2e-aggregate-mount.sh / package-registry.mjs(node-pty 残迹)、tests/theme.spec.ts(卡片守护加强,见「收尾偏差」1)。
  • 其余(PR、真机挂载冒烟、3080 GUI 验证、发版结论):待回填——本节不预填未经执行的结论。

不做

  • 不为 0.1.5-rc.* 写运行时/类型层兼容层(本版是有意的支持线断裂,与 v0.19.0 桥掉 0.1.2 线同一先例)。
  • 不把 peer 下限留在 ^0.1.5-rc.1 或写成「宽松范围」——它在数学上容不下任何 0.1.6 预发布版(§决策 1 的表),留着只会让消费方装上一个必然崩的宿主。
  • 不补自家的终端替代实现(不上第二套 PTY、不为模型侧持久终端另造工具);上游 tool-terminal 未被 bundle 挂载是上游的取舍,README 给指引即可。
  • 不恢复被删的轮尾产物行:list 槽只能追加,重新注册只会与宿主产物卡重复。
  • 不接入本版新增宿主面(openTabs / tabsIn / registerCloseHandler / preferNewPane / keyed guide.entry 槽 / 全局面板)。
  • 不改 DSH 源码(仓库硬约束 §1);不改 release.yml(0.20.0 无 prerelease 后缀 → 自动发 latest)。