Repository navigation
v0.19.0 — 正式版:适配 DSH 0.1.5-rc.1(仅支持 0.1.5-rc.1+)/ stable release for DSH 0.1.5-rc.1+
⚠️ 通道说明 / Channel note
本版本为 正式版(npm latest),DSH 基线 = 0.1.5-rc.1+(peer 下限 ^0.1.5-rc.1,CI 钉 @deepseek-ai/dsh@0.1.5-rc.1;rc.1 在 npm 上同时是 latest 与 next,即 0.1.5 线的首个候选版本)。DSH 0.1.5-alpha.2 及更早不再支持——alpha.2 用户请固定 dsh-better-sidebar@0.19.0-alpha.1;DSH 0.1.2-rc.1 稳定线继续用 0.18.1。
无破坏性改动:本版只把基线推进到 rc.1,并恢复 rc.1 重新引入的可选说明字段。
This is the stable release (npm latest) with the DSH baseline moved to 0.1.5-rc.1+ (peer floor ^0.1.5-rc.1; rc.1 is both the latest and next dist-tag on npm — the 0.1.5 line's first release candidate). DSH 0.1.5-alpha.2 and earlier are no longer supported — stay pinned to dsh-better-sidebar@0.19.0-alpha.1 for alpha.2; the DSH 0.1.2-rc.1 stable line keeps using 0.18.1.
No breaking change: this release only moves the baseline to rc.1 and restores an optional description field rc.1 brought back.
Summary / 摘要
自 v0.19.0-alpha.1 以来:rc.1 相对 alpha.2 的 delta 很小(373 个变更文件,绝大多数是上游各包版本号、原生右侧栏预览 UI 打磨与测试快照),只有两条与本插件相关,其中一条需要适配。
Since v0.19.0-alpha.1: the upstream delta from alpha.2 is small (373 changed files — overwhelmingly package version bumps, sidebar preview polish and test snapshots), and only two of them concern this plugin.
✨ 新功能 / Features
新建标签页列表恢复可选说明(#613)
- 📝 DSH 0.1.5-rc.1 让
SidebarRightGuideEntry.description回归(可选)。插件随之恢复TabDescriptor.description,六个内置类型各写回一条说明(文件 / 文件变动 / 任务管理 / 侧边对话 / 终端 / 浏览器),guideDesc*词条回到 20 份词典。 ⚠️ 宿主的原生指南只在列出的条目 ≤ 4 条时渲染说明(上游MAX_DESCRIBED_ENTRIES = 4,更长的列表是整列丢弃而不是截断)。插件默认贡献 6 个 guide 条目,所以默认组合下看不到说明;只有在插件设置页关掉足够多的 tab 类型、把指南压到 ≤ 4 条时才会出现。别把关键信息只放在这一行。- 🧹 未声明说明的条目仍是单行「图标 + 标题」:宿主没有兜底句,插件也不恢复旧的
nativeGuideDesc通用句(那种句子在所有页面上长得一样,纯噪音)。缺icon的条目由宿主补方块占位。 - 🎨 上游把指南胶囊的
min-height从 48px 调到 56px,并把内置files类型的指南字形改成彩色文件夹(该 kind 由插件接管,故只影响观感)。
🐛 修复 / Fixes
- 无。
packages/util/workspace-path(文件地址语法)只动了版本号,ui-dockkit的.paneBody契约、全局主面板模型、core / agent / session / subagent 宿主 API 与ui-primitives导出面均未变——这些是本次逐项核对后确认「无需适配」的部分。
🧰 CI 与内部 / CI & internals
- 基线推进到 DSH 0.1.5-rc.1+:peer 下限、23 个
@deepseek-ai/*devDependency 钉版、CI 挂载车道与dsh.plugin.json的engines.dsh同步;pnpm peers check干净(rc.1 未新增失配的传递 peer)。 - 恢复
@deepseek-ai/dsh-client-ui-primitives@0.1.5-rc.1仍不声明dependencies(其 bundle 仍裸 importanser/shiki/@shikijs/langs/*/mdast-util-*/micromark-*/katex)——上一版提升进 devDependencies 的那组包继续保留。 - 挂载冒烟新增**「指南 ≤4 条时说明才渲染」**的真机断言:先用插件自己的
settings.get/settings.update把启用集合压到 3 个类型(仅 scratch profile),断言files胶囊出现说明行、被禁用的条目离开指南,最后显式恢复每个动过的键(settings 路由的 patch 是逐键合并,把原始空 map 发回清不掉临时写下的false——这个坑会连累同车道的 perf 巡检,已修)。
验证:typecheck / lint / check:consumer-types 全绿;单测 124 files · 1296 passed · 9 skipped;真机挂载冒烟(真实 DSH 0.1.5-rc.1)7 passed;本地 3080 实测:guide 六行「图标 + 标题」、文件树点击落到插件编辑器、sidechat 输入框贴底(962 == 962,composer 8px)、底部工作台与中心列边缘重合、pageerror 0。