DSH Plugins Marketplace

DSH Plugins

Plugins

/

dsh-toolbox

A

dsh-toolbox

Manifest valid

DSH Sidebar "Toolkit" Setting: Store plugin settings pages that aren't often modified, and support in-place expansion.

UI (client)hasBundlePatch

dsh-toolbox —— 设置侧栏「工具箱」

仓库:https://github.com/AsterionZephyr/dsh-toolbox

tests

把不常改动的插件设置页从设置面板左侧导航收进一个「工具箱」页,需要时在工具箱里原位展开。 侧栏只留核心页(通用 / 模型 / 插件 / 账户),插件页默认全部收纳。

当前状态与后续动作见同目录 HANDOVER.md。

为什么需要它

设置面板导航是 settings.section 槽位账本的投影:每个插件注册一个一级页。 本机装了 12+ 个带设置页的插件,导航就被十几个「一年点两次」的页面挤满。

DSH 没有公开的「分组 / 收纳」扩展点:槽位声明即渲染授权(一个槽位只有一个声明者), 所以第三方页既不能由别人代为渲染,也没有 hidden / group 选项。本插件用两条受控机制解决:

  1. 侧栏折叠:给 SlotRegistry.prototype.entries 包一层过滤器,只对 key === 'settings.section' 剔除「已收纳」的 id。导航读 entries(),于是这些页 从侧栏消失;内容渲染读 entriesOfSlot(),不受影响。
  2. 原位展开:工具箱自己的条目声明子槽位 dsh-toolbox.page;展开某页时,把那一页 原本的组件连同它的 locale / inject / store 席位重新注册进子槽位, 再 renderSlot 出来。props 由槽位框架按原样组装,不伪造、不越权 (dsh-toolbox.page 的声明者就是工具箱自己)。

两条机制都可逆:插件卸载时还原原型、释放全部子槽位注册。

0.2.2 全量审计修复

  • 安装脚本:兼容紧凑/多行/空容器 package.json(空容器不再产生尾逗号),写入前用 Test-Json 严格校验;卸载兼容无尾逗号末项;install.cmd 透传参数与退出码;悬空 junction 自动重建;默认 Target 改为脚本所在目录。
  • 运行时代码:先注册 settings.section 成功后才装 entries 过滤器,注册冲突时不会把设置页全部折叠;子槽位 key 改为 dsh-toolbox.page;inject 回调返回幂等 disposer;过滤器卸载后直通;cascade timer 合并清理;诊断缓存监听 storage;overrides 改 null 原型。
  • 回归 16/16;安全/性能/宿主三份审计见 docs/full-audit-2026-11-18.md、docs/full-audit-security.md、docs/full-audit-perf.md、docs/full-audit-host.md。

稳定性修复(0.2.1)

针对两个实测症状:

  • 左下角设置入口消失:account 插件的 settings.launcher 条目一旦渲染崩溃会被 renderer 标记 abdicate, single 槽位于是显示空死格,设置入口不可达。0.2.1 以 priority 1 注册一个兜底齿轮: account 正常时它不显示;account 崩溃/缺席时它接管,保证设置永远点得到。
  • 工具箱空白:被收纳页或工具箱自身渲染崩溃会让 settings.section 的 list 槽位 abdicate 整个工具箱条目, 出现"导航有工具箱、内容空白"。0.2.1 给工具箱和每个展开页各加一层错误边界, 失败只显示局部警告+重试;另外监听 onEntryError,条目若仍被 abdicate 会自动重注册(限流)。

诊断块新增「设置入口」和「最近异常」两行;错误同时写入浏览器 localStorage 的 dsh-toolbox.diag.v1,可用 dsh-toolbox.lastApply.v1 确认 HMR 是否加载了新版本。 细节与残留风险见 docs/bugfix-0.2.1.md。

性能(0.2.0)

设置侧栏过滤与工具箱渲染原来的热路径是"每次调用都全量扫描账本 + 解析全部 label + 排序", 一次切换还会注册/释放一个假条目并把账本版本推 2 格。0.2.0 做了这些改动:

  • 设置页列表按 (账本数组引用, getVersion, locale revision) 缓存;过滤器复用已读到的账本, label thunk 只在账本/locale 变化时解析一次。
  • 折叠集合按 (页面列表, 偏好版本) 缓存,过滤器和渲染共用。
  • 优先用宿主内部的 ctx.slots._core.markDirty 推版本号:不动账本、不注册假条目; 宿主升级导致私有字段缺失时自动回退到旧路径(功能不变,只是回到旧成本)。
  • 偏好变更不再同步 bump(),依赖外壳 rows 重算级联渲染工具箱页,一次切换少一轮全量渲染; 另加一个宏任务自愈检查,宿主以后若把内容区 memo 化,会自动补一次渲染。
  • 展开的宿主页用 memo 隔离:切换别的行、展开别的页时不再连带重建它。
  • 顺手修掉"放回侧栏后再次收纳会自动展开"的残留展开态。

基准(bench/,Node 桩件加载真实 client.js;13 个设置页、label 全 thunk;5 轮中位数):

指标基线 0.1.00.2.0
entries('settings.section') 单次1534–1655 ns65–130 ns
每次原 entries() 调用21
每次 label thunk 调用130
一次切换的 version 增量21(有 _core)/ 2(回退)
一次切换的 register/dispose1/10/0(有 _core)/ 1/1(回退)

详细方法、局限与真机状态见 docs/perf-report.md; 复跑方式见 bench/README.md。

用法

设置 → 工具箱:

  • 自动收纳第三方插件页(默认开):核心页留在侧栏,其余插件页全部收起。
  • 每行右侧胶囊按钮:已收纳 / 在侧栏,点一下切换。
  • 已收纳的行点标题可原地展开,直接改那一页的设置。
  • 全部收纳 / 全部放回:一键切换(「全部放回」会同时关掉自动模式)。
  • 诊断:过滤器是否装上、当前模式、页数统计。

偏好存浏览器 localStorage(键 dsh-toolbox.prefs.v1),不写宿主配置文档。

安装 / 卸载

走 bundle 通道(与本机 dsh-ustc-usage / dsh-desktop-hand / dsh-ustc-image 一致): 插件包内 cordis.patch.yml 声明挂载行 → profile package.json 的 dsh.profile.bundles 收录 → profile node_modules 的 junction 提供包名解析。不写 profile 的 cordis.patch.yml (那是「手工通道」,与 bundle 通道同时用会双重挂载)。

# 双击 install.cmd,或:
pwsh -File install.ps1

# 卸载(删 junction 与 package.json 两行;插件目录保留)
pwsh -File install.ps1 -Uninstall

bundle 通道在运行中会被重新组合(0.2.2-rc.1 实测:宿主启动后安装/改动插件也能出现在 /plugins/events 的客户端图里),不一定要重启 DSH。改 lib/client.js 后由 dsh-client-hmr 轮询发现并热重启插件;若页面的 /plugins/events 事件流断开(DevTools 里成排 ERR_FAILED), 刷新一次页面即可拿到新图。设置里出现「工具箱」即成功。

已知边界

  • 独占 store 的页展开会新建实例:共享 store handle 会复用同一实例;若插件用 store: () => handle 的独占 factory,展开后的表单状态可能与侧栏页不同(这是槽位框架语义,不是数据丢失)。
  • 折叠只影响导航:页面的注册本身不动;插件热重载/卸载后列表跟着重算。
  • 正在看的那一页被收起时,内容仍留在面板里,但侧栏不再有高亮项;点别的导航即可。
  • 若某个页自己声明了子槽位(子槽位只能有一个声明者),无法重复声明,展开时显示 「这个页暂不能内嵌」而不是崩掉。目前第三方插件里没有这种页。
  • 依赖 SlotRegistry.prototype.entries 这一层实现细节;DSH 升级后若该方法改名或改签名, 工具箱会自动降级:诊断里显示「过滤器未安装」,折叠失效但不会崩。

文件

文件作用
lib/index.js宿主半边(空壳):只为占一个 Loader 条目,让 dsh-client-modules 发现 dsh.client
lib/client.js全部行为:侧栏过滤器、工具箱页、原位展开、图标、样式
cordis.patch.ymlbundle patch:insert 一行 id: toolbox / name: dsh-toolbox
install.ps1 / install.cmd安装/卸载(复制 + junction + package.json 两行,幂等)
HANDOVER.md交接文档:现状、机制、验证清单、回滚
bench/Node 桩件基准台 + 16 条行为回归(不依赖 DSH)
docs/宿主源码调研、性能优化报告、复核记录、真机验证证据

回滚

  1. pwsh -File install.ps1 -Uninstall(或手工删 junction + package.json 两行)。
  2. 重启 DSH。
  3. 浏览器 localStorage 键 dsh-toolbox.prefs.v1 可留可删,不影响其他插件。

插件本体只读设置侧栏的槽位账本,不改任何插件的配置与数据。

Comments

Loading…

Similar plugins

dsh-sidebar-more

by seanjin0513

DSH 插件:把左侧栏「工作区」上方的插件入口收进「更多」菜单,并可逐项固定 / 收起

Manifest valid

★ 0

MIT

JavaScript

Nov 12, 2026

dsh plugin --profile web add dsh-sidebar-more

by Alail691

把 DSH 侧栏的「插件」整体收进设置:在「设置 → 插件」里新增一个「插件管理」标签页,内嵌官方插件面板的全部能力(浏览 / 安装 / 开关 / 卸载)。Bring the sidebar's Plugins page into Settings as a tab, embedding the official plugin manager.

Terminal & ClientsManifest valid

★ 0

MIT

JavaScript

Oct 16, 2026

dsh plugin --profile web add dsh-plugins-in-settings

by eighteentang

DSH 开发工具箱:按 Alt 悬浮查看界面元素归属、把踩过的坑记进随插件分发的经验库、开发模式下自动注入动手前的自检清单。

Terminal & ClientsManifest valid

★ 0

MIT

JavaScript

Nov 6, 2026

dsh plugin --profile web add dsh-plugin-dev-tools

by Lstalu

DSH 插件:给左侧栏「全局面板」与「工作区」之间加一条可拖动分界线,塞不下的面板行逐行进「更多」,工作区不再被挤没

Manifest valid

★ 0

MIT

JavaScript

Nov 13, 2026

dsh plugin --profile web add dsh-sidebar-fit

by zizhongfeiyang

A DeepSeek Harness web UI plugin for customizing and managing the settings navigation drawer. DeepSeek Harness 设置抽屉插件,用于自定义和管理设置页左侧导航栏,可隐藏/显示各设置栏目,修改即时生效。

UI & ExperienceDevelopment & InfrastructureManifest valid

★ 3

MIT

JavaScript

Sep 30, 2026

dsh plugin --profile web add dsh-settings-drawer

by linguiyii

DeepSeek Harness 客户端插件:把设置入口放到侧边栏底部,一键打开设置页。 / A DSH client plugin that puts a settings button at the bottom of the sidebar.

Development & InfrastructureManifest valid

★ 1

MIT

JavaScript

Oct 18, 2026

dsh plugin --profile web add dsh-sidebar-settings