侧栏刷新按钮 Woeful001/dsh-refresh

dsh-refresh

DSH 桌面插件 · 侧边栏底部放一个「刷新」按钮 —— 刷新插件清单并重载页面，让新安装的插件立即生效，不用重启桌面应用。

功能简介

dsh-refresh 在 DSH 桌面应用的侧边栏底部操作区（Settings 按钮旁边）注入一个圆形 刷新 图标按钮。点击它：

1. 通过宿主插件管理器的远端接口刷新插件清单（pluginManager.listBundles() + listPlugins()）；
2. 随后自动重载整个页面（window.location.reload()）。

页面重载时，DSH 宿主会按照当前的 cordis.patch.yml / 已激活 bundle 动态重渲 index.html（包含最新的 boot manifest），客户端据此重新引导并执行新加入的客户端 bundle —— 让新安装的插件立即生效，全程无需重启桌面应用。

为什么需要它

DSH 桌面应用通过 cordis.patch.yml + 已安装 bundle 生成每次页面请求的 boot manifest。安装新插件后，客户端需要重新读取这个 manifest 才能真正加载新插件的客户端 bundle —— 过去这往往需要手动重启整个应用。

DSH 内部其实已经有这些机制：

- HMR（热加载）：dsh-hmr / dsh-client-hmr 会在插件集合变化时推送新的 bundle graph；
- 内建插件管理器：自带"刷新"按钮，调 pluginManager.listBundles() + listPlugins()；
- bootstrap 替换约束：dsh-client-modules 规定替换 bootstrap module 必须整页刷新（window.location.reload()）。

本插件把"刷新插件清单"和"重载页面"这两件事合并成一次点击，并且以整页重载兜底：即使插件管理器远端不可用或调用失败，重载本身也会重新读取 boot graph 并加载新 bundle。

安装

方式一：从 npm / registry 安装（推荐）

dsh plugin --profile desktop add dsh-refresh

方式二：从源码目录（link）安装

如果你克隆了本仓库，可用本地路径安装：

dsh plugin --profile desktop add /path/to/dsh-refresh

或通过 pnpm 直接 link（会绕过 dsh plugin 的 registry 校验）：

pnpm --dir ~/.dsh/profiles/desktop add "link:/path/to/dsh-refresh" --config.fetch-retries=0

说明：直接 link 安装后，需要把 dsh-refresh 加入 profile 的 dsh.profile.bundles 激活清单（~/.dsh/profiles/desktop/package.json）。

方式三：手动补充到 profile

把 dsh-refresh 加入 dsh.profile.bundles 数组，并确保它以依赖形式安装到 profile 的 node_modules。

使用

安装并刷新页面后，侧边栏底部会多出一个圆形 刷新 图标按钮：

1. 点击刷新图标；
2. 弹出确认框（防止误触导致页面重载）；
3. 确认后，插件会先刷新插件清单，再在 200ms 后重载页面。

说明：对于 DSH 内建插件管理器已支持"应用即生效"的场景，本按钮提供快捷入口；对于经 CLI dsh plugin add 安装、或需整页重载才可见的插件，这个按钮就是一次点击的"手动重启替代品"。

兼容性

- DSH: 0.2.0-rc.2 桌面版（desktop profile）
- 平台: web（dsh.client.platform）
- 要求: 客户端需提供 remote + remote.pluginManager 服务（内建插件管理器所在的环境均有）
- Node: >= 20
- Peer deps: @deepseek-ai/cordis ^4.0.2, react ^18.2.0, react-dom ^18.2.0

目录结构

dsh-refresh/
├── lib/
│ ├── index.js # Node half（占位，无操作，供 cordis 提供可加载入口） │ └── client.js # 全部功能：注入 slots/locale/remote/remote.pluginManager ├── cordis.patch.yml # bundle 补丁，把插件加入清单 ├── package.json # dsh.client.inject / dsh.bundle.patch 声明 └── README.md

工作原理

lib/client.js 通过 window.__ModuleLoader__.load({ id, factory }) 注册客户端 bundle，并向 sidebar.footer.action 槽位注入刷新按钮。组件通过 ctx.remote.pluginManager 刷新插件清单，然后触发 window.location.reload()。宿主在每次页面请求时按当前的 boot manifest 重渲 index.html，客户端据此重新引导并执行新 bundle。

License

MIT

dsh-refresh 是 DSH 桌面插件，在侧边栏页脚加一个刷新按钮。按下后会刷新插件清单并重新加载页面，这样新安装的插件无需重启桌面应用即可生效。

功能

- 在 sidebar.footer.action 插槽（设置旁边）加一个圆形刷新图标按钮。
- 通过宿主插件管理器的 remote（listBundles() + listPlugins()）刷新插件清单。
- 重新加载页面，让宿主用新的客户端 bundle 重新渲染启动清单。
- 有确认对话框，防止误触重新加载页面。
- 中英双语界面，根据当前 locale 自动选择。

为什么需要它

DSH 每次页面请求都会生成一份新的启动清单。安装插件后，只有重新加载页面，客户端才能「看到」它。这个插件把内置的 HMR + 插件管理器刷新变成一键可达，并以整页重新加载作为兜底。

安装

dsh plugin --profile desktop add dsh-refresh

也可以从本地源码目录用 pnpm link 安装（见上文安装）。

兼容性

- DSH 0.2.0-rc.2 桌面版（desktop 配置档），web 平台。
- 需要 remote + remote.pluginManager（凡是有内置插件管理器的地方都有）。
- Node >= 20；peer 依赖：@deepseek-ai/cordis ^4.0.2、react ^18.2.0、react-dom ^18.2.0。

许可证

MIT