Skip to content

Releases

v0.7.2

Choose a tag to compare

@github-actions github-actions released this 17 Nov 10:11

Full Changelog: v0.7.1...v0.7.2

v0.7.1

Choose a tag to compare

@github-actions github-actions released this 16 Nov 22:30

Full Changelog: v0.7.0...v0.7.1

v0.7.0 — 临时会话可靠性版本

Choose a tag to compare

@YONAN1269 YONAN1269 released this 16 Nov 16:30

0.7.0: P1 locked-session no longer leaks; P2 MAX_KEPT active protection + POST-only mutating routes; P3 guard diagnostics + opt-in compat test. See CHANGELOG.md.

v0.6.1 — 配置迁出插件包,定时清理交给 ctx.effect

Choose a tag to compare

@YONAN1269 YONAN1269 released this 13 Nov 13:05

0.6.1 — 采纳社区收录评审的两条建议

来自 dsh-community-plugins PR #105 的 APPROVED 评审(该 PR 已合并,社区索引条目不受影响):

后续版本可顺手把 lib/temp-session-host.mjs 的 temp-session-config.txt 迁到 /home/zcl/.dsh 数据目录(避免升级覆盖)并把定时清理挂到 ctx.effect。

两条都做了。评审里的 /home/zcl/.dsh 是维护者本机路径,落到通用规则就是 DSH 的 ~/.dsh(可用 DSH_HOME 覆盖)。

1. 配置文件搬出插件包,升级不再冲掉设置

  • 实际读写路径改为 ~/.dsh/dsh-sidebar-suite/temp-session-config.txt(Windows:C:\Users\<你>\.dsh\dsh-sidebar-suite\temp-session-config.txt),与跟踪库 temp-sessions.json 同目录。
  • 包内同名文件仍随包发布,但降级为出厂模板:只在数据目录还没有配置时复制一次,此后再也不写。详情页开关与记事本手改都只落数据目录那份。
  • status / config / probe 新增 configFile(真实完整路径)、configMigrated、configTemplate;详情页底部显示的就是这个路径。
  • ⚠️ 一次性说明:如果以前手改的是包内那个文件,pnpm add 升级那一刻可能已经把它换成新模板,旧值救不回来 —— 在详情页把开关重设一次即可,从 0.6.1 起不会再丢。

2. 定时清理交给宿主生命周期

register() 改用 bindSchedulerEffect(hostCtx):宿主提供 ctx.effect 时由它注册定时器,插件 dispose / 重新 apply 时通过 disposer 调 stopScheduler(),不再留游离的 setInterval,重复 apply 也不会叠加。旧宿主 / 测试替身自动回退到原来的独立定时器,行为不变;schedule.managed 标明当前用的是哪种。

升级与生效

cd ~/.dsh/profiles/desktop
pnpm add dsh-sidebar-suite@0.6.1

这次改的是宿主端 lib/temp-session-host.mjs,装完要从托盘彻底退出 DSH 再打开一次才生效(关窗口只收进托盘,进程还在)。客户端这次没有功能性改动,只同步了一句说明文案。

0.3.0 已弃用,请勿安装;0.6.1 可直接从 0.5.1 / 0.6.0 升级。

回归

  • 新增 tests/test_039.mjs(33 项):路径落在 DSH home、首次启动从模板播种、写入不碰包内文件、二次启动不覆盖用户值、切换 DSH_HOME、effect disposer 能停表、重复 apply 不叠加。
  • test_022 / test_024 / test_028 改为在临时 DSH_HOME 里准备配置副本,不再改写工作副本。
  • 全套 npm test(含 test_039)与 npm run check 通过;npm pack 仍是 21 个文件。

附件:.tgz 为 npm 包内容,.zip 为同一批文件、外层带 dsh-sidebar-suite/ 目录,方便直接解压查看。

v0.6.0 — 临时按钮改挂宿主官方插槽

Choose a tag to compare

@YONAN1269 YONAN1269 released this 13 Nov 09:05

0.6.0 — 临时按钮改挂宿主官方插槽(2026-11-13)

相对 0.5.1 只动客户端(lib/client.js),不需要从托盘退出 DSH:装完后新开一个侧栏或刷新窗口就生效。如果你是从 0.5.0 或更早升上来,包里还带着 0.5.1 的宿主侧修复(删除临时会话前的路径校验),那一项仍然要从托盘彻底退出 DSH 再开一次才生效。Client-only relative to 0.5.1; upgrading from 0.5.0 or earlier still needs one tray restart for the host-side delete-path fix.

起因:DSH 0.2.2-rc.3 给「新会话」这一行开了官方扩展位。我们原来那套「压窄新会话 → 用负边距把临时按钮拉回上一行」的做法,是按 rc.2 之前的宿主结构写的,继续留着就是每次宿主改 DOM 都要跟着修一次。0.6.0 把它换成官方插槽,同时修掉一个有失效的配置项。

宿主这次给的是什么 / What the host now offers

rc.3 的侧栏包声明了 sidebar.session.action,类型是 hoc:占用者能拿到宿主自己的「新会话」按钮(children)和 { wide }(false = 56px 折叠轨道),可以包一层、并在旁边加自己的控件。同一版里「新会话」按钮外面多包了一层 div.newSessionRow(display:flex; gap:6px),按钮从 flex:none 改成 flex:1 1 auto。

We now register an occupant for that slot and mount the Temp button into the empty seat it renders, instead of shrinking the host button and pulling our sibling back with a negative margin.

改动 / Changes

  1. 临时按钮改挂官方插槽:注册 sidebar.session.action 占用者(id: 'temp-session'),返回「宿主按钮原样 + 一个空座位」,再把按钮挂进座位。宿主行自己的 flex、gap、折叠淡入动画、宽/窄切换全部接管,我们不再改宿主的宽度和边距。
  2. 删掉两处脆弱 hack:width:calc(100% - 92px)(压窄「新会话」)和 margin:-44px(把临时按钮拉回上一行)只在旧路径保留。
  3. 旧宿主自动回退:DSH < 0.2.2-rc.3 没声明这个插槽,注册会抛错(已捕获),自动退回原来的「兄弟节点 + 负边距」路径,由 html[data-dsbs-temp-mode="dom"] 这批规则承担。同一时刻只会存在一个临时按钮,来回切也拆得干净。
  4. 修复 TEMP_BUTTON_STYLE=own 从未生效:宿主一直在下发 buttonStyle: 'own',客户端却把标记写成布尔 "true",而所有样式规则等的是 [data-dsbs-temp-style="own"]——两者永远对不上,所以这个"单独一行"的选项从 0.2.8 加进来起就是死的。现在标记写成 own 本身,并且改成让宿主行 flex-wrap:wrap、座位占满第二行,这才是 rc.3 结构下真正的一行。
  5. 折叠判断改用宿主的 wide:原来靠量宽度(< 170px)猜是不是折叠轨道,现在优先用插槽给的 wide === false,量宽度只作为旧宿主/首帧的兜底。
  6. 隐藏开关也走 <html> 标记:座位元素归 React 管,直接写在它身上的 hidden 可能在重渲染时被抹掉,所以 SHOW_TEMP_BUTTON=off 另外发一个 data-dsbs-temp-off 标记,样式以它为准。

回归 / Tests

新增 tests/test_038.mjs(28 项)盯住这次的结构契约:插槽注册带 id、挂载优先找座位、旧路径还在、calc(100% - 92px) 与 -44px 只允许出现在 dom 模式作用域里、own 标记必须是字面量 own。tests/test_023.mjs 的两条"只注册一个组件"断言随之改成两条注册(详情页卡片 + 新会话行座位)。

商店截图换成实拍 / Storefront screenshots are now real captures

screenshots.json 原本指向 assets/screenshots/screenshot-1~3.png,那三张是 0.2.5 时期的示意图,里面画的还是 0.5.0 已经删掉的「折叠」布局,跟插件现在的样子对不上。现在改为指向 assets/real-screenshots/ 下三张真实运行截图:浮层布局、标签页布局、控制栏特写(会话标题与账号名已打码)。

  • 旧的三张示意图已删除,历史留在 git 里;package.json 的 files 白名单从 assets/screenshots/*.png 换成 assets/real-screenshots/*.png。
  • 体积变小:新三张合计 257 KB,原来三张 514 KB;npm pack 仍是 21 个文件,包体从约 700 KB 降到 450 KB。
  • 现有页面不受影响:dsh.so 的详情页目前没有截图区块,这个字段是为以后接入截图的市场客户端和收录流程准备的。screenshots.json 的路径与文件保持一致,谁读都不会拿到 404。The field is inert today; it now points at images that actually match the current UI instead of a removed mode.

v0.5.1 — 修复临时会话删除的路径穿越

Choose a tag to compare

@YONAN1269 YONAN1269 released this 13 Nov 07:41

0.5.1 — 修复临时会话删除的路径穿越漏洞

升级后请从右下角托盘图标右键 → 退出,再重新打开 DSH —— 本次改的是宿主侧(lib/temp-session-host.mjs)代码,刷新 / 热重载不生效。
⚠️ 建议所有 0.5.0 及更早版本升级:本版修的是一个真实可触发的删除越界问题,不是可选加固。

问题是什么

临时会话的 id 会先过 normalizeId,它的字符类是 [A-Za-z0-9._:-] —— . 和 .. 都能通过。随后 join(sessionsRoot, workspace, '..') 在路径层被折叠成工作区目录本身,rm -r 于是删掉该工作区下的全部会话,而不只是目标那一条。

触发面主要在存储文件而非网页:网页路由 POST /api/dsh-temp-session.remove 要求 id 已在 state.tracked 里(否则直接返回 not a temporary session),单靠它删不掉东西;但 temp-sessions.json 是明文 JSON,里面一旦出现 ..,启动清理和退出清理会直接按该 id 执行删除,每个工作区都会被删一遍。

这个问题是维护者在收录 issue 里提醒的,我们按提示复现后确认 0.5.0 及更早版本均受影响。谢谢指出。

复现证据

新增的 tests/test_037.mjs 直接用已发布的 0.5.0 包跑:16 项检查中 8 项失败,其中「启动清理保留 ws-a / ws-b 的普通会话」两条直接挂掉 —— 两个工作区的会话目录确实被整个删除。换成修复后的代码,16/16 通过。

怎么修的(四层,lib/temp-session-host.mjs)

层 做法
id 层 isUnsafeId 把 .、..、... 以及任何含 .. 的字符串判为非法,normalizeId 先过这道检查。正常 id 是 session-<uuid>,拒绝点号组合不影响正常使用
路径层 safeSessionDir() 要求目标正好是 <sessions>/<工作区>/<id> 两层,relative() 不得以 .. 开头,工作区名本身也不能含分隔符
防替换 再用 realpath 确认解析后的真实路径仍在真实的 sessions 根内(同时挡住大小写、短文件名、junction);lstat 必须是真目录,symlink 一律跳过,避免顺着链接删到别处
统一入口 sessionDirsSync(判断哪些目录算「存在」)、removeSession、removeSessionSync 三处都只接受 safeSessionDir 的返回值;非法 id 在读取存储时就被滤掉,不会再写回文件反复重试

其他

  • package.json → 0.5.1,lib/client.js 的 VERSION 同步(有测试锁步)。
  • tests/test_036.mjs 里两条写死 0.5.0 的断言改成「≥ 0.5.0 且与 package.json 锁步」,以后补丁版不用再改测试。
  • npm test 15 套 628 项全绿;npm run check 通过;npm pack 21 个文件。

下载

  • npm:npm i dsh-sidebar-suite@0.5.1 或 dsh plugin --profile <name> add dsh-sidebar-suite@0.5.1
  • 附件:本页 dsh-sidebar-suite-0.5.1.tgz / .zip

v0.5.0 — 砍掉折叠布局,新增官方默认

Choose a tag to compare

@YONAN1269 YONAN1269 released this 12 Nov 00:41

0.5.0 — 砍掉折叠布局,新增「官方默认」,并修好控制栏位置

升级后请从右下角托盘图标右键 → 退出,再重新打开 DSH —— 本次改了注入样式表和布局状态机,刷新 / 热重载不算。
⚠️ 破坏性变更 / Breaking:mode: a(折叠)已移除,getLayout().mode 现在只返回 b / c / n,配置 schema 的合法值集合也变了,所以版本号跳到 0.5.0。配置里仍写着 a 不用手动改 —— 插件每次读取都会把它映射到新的「官方默认」n,不会报错、也不会变成另一个布局。
⚠️ 0.3.0 已弃用 / deprecated:它会让 DSH 卡在 Loading plugins…。0.4.1 及更早版本在 DSH 0.2.2-rc.2 上仍会看到布局按钮压住「工作区」标题、或跑到列表下方,本版一并修复。

Quit DSH from the tray and reopen once after upgrading. The a mode was removed; old configs open in Default. 0.3.0 is deprecated because it hangs DSH on the loading screen.

为什么砍掉第一种布局

从交互角度重新评估后,a(折叠)没有任何「有用且独有」的状态:

两个独立开关的组合 结果
两组都收起 空白侧栏 —— 可进入的死状态,用户会以为插件坏了
只留扩展 / 只留工作区 已被 b 标签页(互斥单选)完全覆盖
两组都展开 与 DSH 原生一模一样 —— 「点了等于没点」,且与新增的官方默认重复

它还带来一套与「互斥分段控件」语义冲突的双开关、窄侧栏里只能靠单 / 双箭头区分的两个图标,以及前两轮反馈的「工具条跑到列表下方」「展开合起来回跳」。所以这次直接砍掉,而不是靠提示文案或图标差异补救。

三种布局(新顺序)

模式 名字 行为
b 标签页(出厂默认) 两组共用一栏,互斥切换
c 浮层 工作区常驻,扩展按需浮出
n 官方默认 两组都常驻,插件对布局零干预 —— 不写 CSS 隐藏规则,运行时也不隐藏任何一组

官方默认下工具条不会整个消失:右侧动作按钮与竖线会隐藏,但布局胶囊始终保留。这对 showQuickSwitch: false 的用户尤其重要 —— 循环按钮本来就不显示,若连胶囊一起藏掉就只剩「去详情页改配置」一条退路,等于「进去了出不来」。

顺带修好的控制栏位置(原计划的 0.4.2)

解包 DSH app.asar 里的 SidebarRoot.tsx / SidebarRoot.module.css 后确认:div.scrollArea 是 CSS Grid,宿主把 nav.panelList 钉在 grid-row: 2、regionArea 钉在 grid-row: 4,插件注入的节点只能被排进隐式第 5 行 —— 也就是永远在列表下方;order 压不过显式的 grid-row。现在控制栏与页签条移进 grid 的父级 div.scrollRegion(稳定的 flex 列),DOM 顺序即视觉顺序;浮层定位基准同步改正。

验证

  • npm test 14 套全绿、npm run check 通过;新增 tests/test_036.mjs(47 项)覆盖模式顺序、无死状态、官方默认下两组都不隐藏、胶囊始终可见、a → n 迁移,以及「点胶囊能切回来」这条防困死断言。用已发布的 0.4.1 跑同一套测试,18 项断言失败并崩在缺失的 mode-n 按钮上。
  • 真机 CDP 实测(独立 --user-data-dir 起的第二个实例,没有干扰用户正在用的窗口):version=0.5.0;b → nav 可见 / 工作区隐藏;c → 工作区可见 / nav 隐藏;n → 两组都可见(nav 高 440px、工作区高 424px)、三个动作按钮与竖线全隐藏、胶囊可见、第三个按钮高亮;从 n 点回 b 成功。工具条始终在 wtg9ga_scrollRegion、底边 172px 与 grid 顶边严丝合缝、无裁切、无重叠。三种模式各留一张截图。

三方插件作者无需为本次改动做布局适配:registerTab() 的容器与懒挂载行为不变,只需照旧考虑窄侧栏的图标模式;唯一要留意的是 getLayout().mode 的取值集合。

v0.4.1 — 适配 DSH 0.2.2-rc.2 的网格侧栏

Choose a tag to compare

@YONAN1269 YONAN1269 released this 11 Nov 23:41

0.4.1 — 适配 DSH 0.2.2-rc.2 的网格侧栏

升级后请从托盘彻底退出 DSH 再打开一次 —— 本次改了注入的样式表,刷新 / 热重载不算。
⚠️ npm 上的 0.4.0 不含这个修复。 如果你在 DSH 0.2.2-rc.2 上看到布局按钮压住「工作区」标题,升级到 0.4.1 即可。
⚠️ 0.3.0 已弃用 / deprecated:它会让 DSH 卡在 Loading plugins…、主窗口不显示。请直接装 0.4.1。

Quit DSH from the tray and reopen once after upgrading. The published 0.4.0 does not contain this fix; 0.3.0 is deprecated because it hangs DSH on the loading screen.

修了什么

DSH 0.2.2-rc.2 把左侧栏根节点 div.wtg9ga_scrollArea 从纵向 flex 改成了三列 CSS Grid(真机实测列宽 4px 264px 6px),并把宿主自己的面板显式钉在第 2 列。

0.4.0 发布后复核时只验了「DOM 契约有没有变」——类名、data-slot、节点顺序确实都没变,所以当时下了「运行时零改动即兼容」的结论。但没验几何:插件注入的控制栏 / 页签条 / 插件面板用默认 grid-column:auto 落进了只有 4px 宽的第 1 列,按钮溢出后盖到宿主「工作区」标题上,右侧还留下一条孤零零的竖分隔线。

0.4.1 让这三个盒子统一 grid-column:1/-1 独占整行,并用 padding-left:4px / padding-right:6px 把 grid 的两条装饰列还原成左右内边距,与宿主「新会话」按钮左对齐。

  • 不改宿主节点、不依赖生成类名、不做宿主版本嗅探:grid-column 在旧版 flex 侧栏里是惰性属性,所以同一份样式在 0.2.2-rc.1 和 0.2.2-rc.2 上都能用。
  • 消费方无需适配:通过 sidebarSuite.registerTab() 注册第三方页签的插件,拿到的容器也在这条规则里,页签条和面板同样是全宽;插件作者只需要考虑窄侧栏(< 300px)下的图标模式。

DSH 0.2.2-rc.2 switched its sidebar root from a flex column to a three-column CSS Grid. The markup contract did not change, but the injected boxes fell into the 4 px decorative first column and covered the host's "Workspaces" heading. 0.4.1 spans every column; the property is inert on older flex roots, so both hosts keep working.

真机验收

CDP 连真机 14 项全通过:控制栏从 4px 恢复到 274px、scrollWidth === clientWidth、布局按钮与「工作区」标题重叠面积为 0、注册第三方 tab 后页签条与面板全宽、dispose 后无残留、root 子节点顺序不变;截图确认布局图标独占一行、与「新会话」左对齐、「工作区」完整;10 秒 CPU 增量 0–0.59 秒(启动死循环已修,无自激)。

tests/test_034.mjs 扩为 20 项,新增源码与运行时样式表断言,防止以后有人删掉这条规则;tests/test_034.mjs 同时固化换 CSS-module 哈希、纯哈希类名、缺 workspaces slot 的退化行为。全套 12 套测试全绿、npm run check 通过(21 文件 / 705.1 kB)。

附件

  • dsh-sidebar-suite-0.4.1.tgz — 发布到 npm 的包,与 registry 上的完全一致,也可用于离线安装:dsh plugin --profile desktop add <本地 .tgz 完整路径>。
  • dsh-sidebar-suite-0.4.1.zip — 本仓库在此 tag 处的源码快照(含测试与文档)。

安装 / Install:dsh plugin --profile desktop add dsh-sidebar-suite,或在插件市场搜索 dsh-sidebar-suite。

v0.4.0 — 临时会话转正 / 删除 + 修复启动死循环

Choose a tag to compare

@YONAN1269 YONAN1269 released this 11 Nov 16:03

0.4.0 — 临时会话转正 / 删除 + 修复启动死循环

⚠️ 0.3.0 已弃用 / deprecated:它会让 DSH 卡在 Loading plugins…、主窗口不显示、渲染进程 100%。npm 上已标记弃用,请升级到 0.4.0。
升级后请从托盘彻底退出 DSH 再打开一次 —— 本次改了客户端运行时,刷新 / 热重载不算。
0.3.0 hangs DSH on the loading screen with a hidden window; it has been deprecated on npm. Quit DSH from the tray and reopen once after upgrading.

⛔ 最重要的一条:修好了 0.3.0 的启动死循环

0.3.0 加入的第三方页签条被插在控制栏与宿主「扩展」面板之间,但定位控制栏的代码仍要求它紧挨着那个面板。于是每次重绘都把控制栏搬一次、页签条再搬回来;这一搬改变了被观察节点的子节点,触发插件自己的 MutationObserver → 重绘 → 再触发……微任务队列永远排不空,主线程被占死。

表现:DSH 打不开(窗口隐藏、停在 Loading plugins…、渲染进程 100%、按刷新也没反应)。

修复方式:位置判断从「必须紧邻」改成「顺序在前」;再加一道熔断——同一轮最多 16 次重绘,超了就让出主线程,将来任何类似的自激都不会再把整个应用锁死。三种布局、以及第三方页签接管侧栏的场景都做了真机验收。

The 0.3.0 tab strip sat between the control bar and the panels nav while ensureBar() still demanded adjacency, so every repaint moved the bar and fired the plugin's own observer — an endless microtask loop that hid the window on "Loading plugins…". Position checks now compare order instead of adjacency, plus a per-macrotask sync cap.

右键临时会话行:保留为正式会话 / 立即删除

之前临时会话是「要么全删、要么全留」:想留下某一个,只能把 DELETE_ON_EXIT 关掉,结果所有临时会话一起变成永久。现在单个会话可以就地处理。

  • 保留为正式会话 复用 0.2.0 就有的 POST /api/dsh-temp-session.untrack,后端零改动。
  • 立即删除 新增 POST /api/dsh-temp-session.remove?sessionId=…,复用批量清理的「删除 → 确认 → 占用则先隐藏 → 下次启动重试」阶梯;只接受临时会话 id,且在碰文件之前就拒绝非法请求。
  • 只接管临时会话那一行:右键普通会话时插件完全不碰事件,宿主和别的插件的菜单照常工作。
  • 菜单靠视口边缘自动翻转,Esc / 点外面 / 滚动 / 改窗口大小都会关掉;新增 TEMP_ROW_MENU=on/off 开关以防和别的插件抢右键。

Right-clicking a temporary row now offers both options. The handler never touches rows it does not own, and the new route refuses anything outside the tracked set before touching the filesystem.

测试与验收

  • npm test 扩为 11 套全绿、npm run check 通过。新增 tests/test_033.mjs(13 项)让 DOM 桩真的把观察器回调投递回来:修复前一次普通的宿主 DOM 变化就会撞上 200 次自激变更上限(三种布局全部中招),修复后每次重绘 0 次 root 变更、节点顺序不变。
  • 真机(重新启用插件并重启):加载页消失、主界面完整、调试命令秒回、控制栏与标签条各 1 个、root 子节点顺序连采 4 次完全一致、8 秒内各进程 CPU 增量 ≤ 0.17 秒(卡死时是 6 秒吃满 6.5 秒)。

附件 / Assets

  • dsh-sidebar-suite-0.4.0.tgz — 发布到 npm 的包,与 registry 上的完全一致。
  • dsh-sidebar-suite-0.4.0.zip — 本仓库在此 tag 处的源码快照(含测试与文档)。

v0.3.0 — 第三方插件可以注册自己的页签

Choose a tag to compare

@YONAN1269 YONAN1269 released this 11 Nov 11:12

0.3.0 — 第三方插件可以注册自己的页签 / Third-party tabs

这次改了运行时代码(lib/client.js),升级后请从托盘退出 DSH 再打开一次。
This release touches lib/client.js — quit DSH from the tray and reopen once after upgrading.

改了什么 / What changed

  • 侧栏变成可插拔的页容器 — 客户端通过 ctx.provide('sidebarSuite', …) 发布一个服务,别的插件 inject = ['sidebarSuite'] 之后就能把自己的界面挂进侧栏。
  • 给的是普通 DOM 容器,不是 React 组件 — mount(container, tab) 拿到一个空 <div>,原生 DOM / React / canvas 都行,消费方不必和本插件的框架版本对齐。
  • 懒挂载 + 自带清理 — mount 只在页签第一次被打开时执行;返回的清理函数在页签移除、消费方卸载、DSH 退出时都会调用,正好能塞进 ctx.effect。
  • 同 id 重注册 = 原地替换 — 客户端热重载会重复注册,替换保证不会叠出两个同名页签,且旧页签的清理函数先跑。
  • 失败只烂在自己那一页 — mount 抛异常时错误写进它自己的容器并 console.error 一次,侧栏其余部分照常工作。
  • 页签条按布局出现 — 布局 B 下是 [扩展][工作区][插件页…] 并排;布局 A / C 下只有插件页进条(内置两组仍由原按钮控制)。一个消费方都没有时这排页签是 hidden 的,不占高度,看到的和 0.2.9 完全一样。
  • 点了内置页签也会通知订阅者 — 布局 B 下点「扩展 / 工作区」等于把这一列从插件页手里拿走,subscribe 会像其它切换一样发出 ('active', null);反过来,在两个内置组之间来回切是静默的。没有这一条,靠订阅停表 / 停轮询的消费方会以为自己还挂在屏幕上。
  • 选中态是宿主主题色 — 当前页签底部一条 2px 强调色,跟随工作区主题;窄侧栏自动只留图标,没给图标的页签保留文字而不是变成空白方块。

给插件作者的写法 / For plugin authors

export const inject = ['sidebarSuite']

export function apply(ctx) {
  ctx.effect(() => ctx.sidebarSuite.registerTab({
    id: 'my-plugin',
    title: { zh: '我的面板', en: 'My panel' },
    icon: '<svg viewBox="0 0 16 16">…</svg>',
    order: 100,
    mount(container, tab) {
      container.textContent = 'hello'
      return () => { /* 清理 */ }
    },
  }))
}

三种布局下都是同一份代码,不需要 if (layout):容器永远是撑满侧栏那一列、自带滚动、可任意收缩的 flex 列。真正要自己处理的是窄侧栏(< 300px)下的排版,那跟布局无关。

其余方法:unregisterTab(id)、getTabs()、activateTab(id)、getActiveTab()、subscribe(fn)、getLayout()、version。

安装 / Install

dsh plugin --profile desktop add npm:dsh-sidebar-suite@0.3.0

或下载下面的 .zip(源码)/ .tgz(本地安装包)离线安装。