READMESource: main@b932e3c1
侧栏「更多」固定项(dsh-sidebar-more)
DSH 插件:把左侧栏「工作区」上方的插件入口收进 更多 菜单,并允许逐项固定 / 收起。
DSH 的侧栏外壳本身就提供了「更多」按钮和逐项固定回调,但官方菜单只放了
「浏览更多插件 / 创建你的插件」,没有面板行与图钉。本插件注册
sidebar.panellist.actions,把缺的那部分补齐,不修改打包的 app.asar。
交互
点开左侧栏的 更多:
- 最上方是「侧栏条目」分组,按侧栏里的顺序列出所有可自定义的面板入口 (「插件」入口由内核强制常显,永不列出)。
- 分组标题下一行是 一键收起:一次把所有入口收进「更多」,侧栏只留 「插件」常显行;全部已收起时该行置灰。
- 点行 → 打开该面板并关闭菜单。
- 点行右侧图钉 → 固定 / 收进更多:
- 图钉实心(
aria-pressed=true)= 该入口显示在侧栏; - 图钉空心 = 该入口只在「更多」里出现。
- 调整时菜单保持打开,可连续操作;主面板与当前选中态不受影响。
- 图钉实心(
- 分组下方仍是官方的「浏览更多插件 / 创建你的插件」。
安装与启用
- 在 DSH 插件管理器中从本地目录安装
dsh-sidebar-more包 (包内通过dsh.bundle.patch声明 bundle 层)。 - 启用插件。宿主会在插件管理器里直接应用组合(无需重启即可看到
include:sidebar-more为 active)。 - 刷新 Web UI(桌面上按 ⌘R);若「更多」里没有出现「侧栏条目」,再完整 重启 DSH。
已知限制
- 固定选择只在本次应用运行内有效。 侧栏外壳把「已收起」列表保存在内存里
(
createPanelPins),插件重新加载即重置,并刻意忽略旧 localStorage 值, 因此重启后所有入口会回到侧栏,需要重新收起。若要跨重启保留,只能改 app.asar 里的内核(会被自动更新覆盖,不推荐)或向上游提需求。 - 「插件」入口不可收起(内核规则);「定时任务」「插件市场」等其余入口都可以。
卸载
在插件管理器中禁用并移除本插件,重启 DSH 后侧栏与「更多」菜单恢复原状。
结构
dsh-sidebar-more/
package.json # dsh.bundle.patch + dsh.client(immediately)
cordis.patch.yml # 插入 host 行(空壳,只为承载 client 声明)
index.js # Host 半:apply() 空实现
client.js # Client 半:注册 sidebar.panellist.actions 行
locale/{zh,en}.json # 插件管理页元数据
icon.svg
test/validate.test.mjs # 清单 / slot 契约 / 脚本形态
test/render.test.mjs # 用假 React 渲染真实 client.js 的行与回调
npm test # node --test test/*.test.mjs
No comments yet. Be the first to write one.