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.
25 KiB
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。两件关键的事实构成这版全部工作:
- 两条插件面向的硬契约收紧,且都是静默失败(§上游 delta 1/2);三条
ui-primitives破坏是编译期可见的。 - 宿主内置了插件原本自研的两个面(右列终端、右列浏览器)。继续保留就是同一面存在两套实现,并且遮蔽产品正在开发中的宿主类型。
本计划记录该 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 方言、
MarkdownTextlabels 嵌套契约、会话事件模型(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同理。
决策
-
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.20.1.6-alpha.10.1.6-alpha.20.1.6-alpha.30.1.6-rc.1^0.1.5-rc.1true false false false false ^0.1.5-rc.2true false false false false *(裸)false false false false false ^0.1.6-alpha.2false false true true true 即:0.1.5 的下限不是「保守」而是结构上不可能容纳 0.1.6 预发布;
^0.1.6-alpha.2天然容纳 0.1.6 的 alpha/rc 全线并排除 0.1.5。 -
支持线取舍: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 下限同源(同一个支持范围,两处不能分叉)。 -
终端整体让位:删除整套 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」的既定代价,不是意外,所以不补自家的替代实现。 -
浏览器让位,但保留 DOM 层链接接管。宿主不做按协议分流(https 默认交系统浏览器),那是插件唯一还能提供的能力,因此
src/client/link-intercept.ts与已发布的urlTarget机制(v0.13.0+,第三方消费插件按它声明)不动;接管目标改指宿主的browserkind(ctx.sidebarRight.openTab('browser', { params: { url } })),并保留window.open兜底——宿主没装该包时不至于点了没反应。 -
轮尾接管整体删除。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 与编辑器宿主仍在用。 -
guide 条目 id 作为类型契约落进插件侧:两个条目各自带
id(descriptor id /'files'),并加测试守护「每个 guide 条目 id 非空且互不重复」。不做运行时兜底(自动补 id 会把契约破坏变成永久沉默,正是这次最难查的形态)。 -
加一条可见的失败接缝:
registerNativeSurface新增可选reportFailure(phase, error),接到src/client/index.tsx的fail()可见诊断条;单个 descriptor 注册失败不再带走其余注册。理由就是这次的症状——整个原生承载面静默空掉,除了一行缺失的指南之外没有任何提示。 -
卡片采用宿主胶囊配方,但字重走令牌阶梯:几何/描边/填充/圆角照抄宿主
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)。 -
不接入本版新增的宿主面:
openTabs/tabsIn/registerCloseHandler/preferNewPane/ keyedguide.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 |
本计划 |
收尾偏差(核对实际文件后修正的三处口径)
这三处不是计划项,而是核对文件时发现的「提交信息与产物不符」;写在这里以免被当作已完成,也给下一版留证据:
- 安装脚本的
-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 注释),截至本文档写作时尚未提交(见「落地」)。 pnpm-workspace.yaml的allowBuilds块仍未收干净:现状是node-pty: set this to true or false(pnpm 自己写的待决占位行);原条目node-pty: true被换成该占位、protobufjs: true被移除。块本身仍在,且仍以已删除的依赖名出现——本版未处理。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-typesOK;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(HEAD5912274)之上还有一批未提交的收尾改动: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/ keyedguide.entry槽 / 全局面板)。 - 不改 DSH 源码(仓库硬约束 §1);不改
release.yml(0.20.0 无 prerelease 后缀 → 自动发latest)。