dsh-hot-refresh面板一键热刷新
30.7/100
综合分
1
GitHub 星标
—
npm 周下载
—/5
用户评分
数据截至 2026/10/17 · 周下载取自 npm 全网(含 CI / 镜像),非本站安装数;综合分由星标、活跃度与兼容性检查合成。
自动兼容检查有告警:未发布到 npm registry,仅可从源码安装。
安装命令 · 需先装 dsh CLI 引擎
dsh plugin --profile web add liuhaolong16/dsh-hot-refresh该包不可直接 npm 安装,改从 GitHub 源安装(明细见下方安装检查)
状态速览
判定依据:实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态信任档位:待复验
是什么
dsh 原生插件 · dev
安全吗
本站尚未对该插件做风险分级
暂未覆盖,不等同于无风险
还在维护吗
活跃:最近一次提交在 16 天前
档位由哪些信号合成
本站实装验证(真实安装 L4 覆盖全站;L5 为运行时冒烟或实机截图,覆盖范围小于 L4) · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。 下方各区块是它的证据明细。
社区实装还没有人打卡 · 装过的第一个就是你
安装兼容性检查⚠ 装前注意未发布到 npm registry,仅可从源码安装
展开查看检查明细 ↓
以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。
✗npm 包dsh-hot-refresh(未发布到 npm,仅可源码安装)
✓Node 引擎要求 >=20 · 基线 Node 22.19 满足
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明
验证方式:npm registry 存在性 + package.json 静态校验 · 最后检查 2026/10/16 04:09:24
安全扫描自动 · 静态分析源码v2.7.0🔵 扫描:含敏感能力尚无人工评估展开查看扫描说明与证据 ↓
安全扫描自动 · 静态分析源码
v2.7.0静态扫描发现插件具备触达本地系统的能力:执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量(至少其一)。这是能力清单,不是危险判定——具体能力项与证据见下方,安装前请自行判断是否需要。
可执行外部命令读写/删除本地文件发起外部网络请求
查看扫描证据(共 11 处,展示前 11 条)
- 读取本地文件lib/index.js:19
const raw = readFileSync(new URL('../package.json', import.meta.url), 'utf8') - 发起网络请求lib/client.js:68
var p = fetch(path, { method: 'POST' }); - 发起网络请求lib/client.js:80
var p = fetch('/hot-refresh/report', { method: 'POST', headers: { 'content-type': 'application/json' }, body: body }); - 发起网络请求lib/client.js:89
var p = fetch('/hot-refresh/health'); - 读取本地文件_check-client.cjs:20
const src = fs.readFileSync(path.join(__dirname, 'lib/client.js'), 'utf8'); - 读取本地文件_preflight.cjs:24
function pkg() { try { return JSON.parse(fs.readFileSync(path.join(ROOT, 'package.json'), 'utf8')) } catch (e) { return null } } - 读取本地文件_preflight.cjs:25
function readVersion(file, re) { try { const m = fs.readFileSync(path.join(ROOT, file), 'utf8').match(re); return m ? m[1] : null } catch (e) { return - 读取本地文件_preflight.cjs:68
const entry = fs.readFileSync(path.join(ROOT, 'lib/index.js'), 'utf8'); - 读取本地文件_preflight.cjs:78
const pkg2 = JSON.parse(fs.readFileSync(path.join(__dirname, 'package.json'), 'utf8')); - 执行外部命令来自配置/变量_preflight.cjs:87
const r = cp.spawnSync(process.execPath, ['--check', path.join(ROOT, f)], { encoding: 'utf8' }); - 执行外部命令来自配置/变量_preflight.cjs:93
const fx = cp.spawnSync(process.execPath, [path.join(ROOT, '_check-client.cjs')], { encoding: 'utf8' });
扫描于 2026/10/31(1 天前) · 范围 入口闭包 + 发布文件清单 · 来源 GitHub 仓库
静态扫描只反映源码中出现的调用,不构成安全背书;人工评估与自动扫描相互独立、互不覆盖。
给这个插件打分还没有人投票↓
用户评分
还没有人投票,来当第一个
DeepSeek Harness 客户端插件一键热刷新:检测哪些插件包有变化,只重载这些插件;整图重载需显式开启标志;暴露重放计数器。
README
由 DeepSeek 最新模型翻译生成dsh-hot-refresh(面板一键热刷新)
把 DSH 官方的客户端插件热重载链路做成面板上的一键入口:客户端插件改完不必按 F5。
逆向来源(本机 app.asar,均为官方包,MIT)
| 包 | 职责 |
| @deepseek-ai/dsh-client-hmr v0.2.0-rc.2 | 宿主半体每 pollIntervalMs(默认 500ms)stat 轮询每个客户端 bundle 的 {mtimeMs, ctimeMs, size};一变就 ctx.clientModules.rebuilt(id),并经 SSE /plugins/events 推 rebuilt 帧。浏览器半体订阅该 SSE,收到帧就交给客户端模块系统。 |
| @deepseek-ai/dsh-client-modules | 浏览器侧模块表:invalidate → prefetch → refresh,ctx.modules.entries.sync(graph) 全量同步、entries.reload(id, rev) 单条就地重载。 |
| @deepseek-ai/dsh-hmr | 宿主侧热重载(模块替换 / Include 刷新 / profile 配置变更共用一个串行队列)。文档明写:「直接通过 Plugin Manager 发起的操作无需等待文件事件即可应用」。
展开完整文档(README 剩余 1 节)
dsh-hot-refresh(面板一键热刷新)
把 DSH 官方的客户端插件热重载链路做成面板上的一键入口:客户端插件改完不必按 F5。
逆向来源(本机 app.asar,均为官方包,MIT)
| 包 | 职责 |
| @deepseek-ai/dsh-client-hmr v0.2.0-rc.2 | 宿主半体每 pollIntervalMs(默认 500ms)stat 轮询每个客户端 bundle 的 {mtimeMs, ctimeMs, size};一变就 ctx.clientModules.rebuilt(id),并经 SSE /plugins/events 推 rebuilt 帧。浏览器半体订阅该 SSE,收到帧就交给客户端模块系统。 |
| @deepseek-ai/dsh-client-modules | 浏览器侧模块表:invalidate → prefetch → refresh,ctx.modules.entries.sync(graph) 全量同步、entries.reload(id, rev) 单条就地重载。 |
| @deepseek-ai/dsh-hmr | 宿主侧热重载(模块替换 / Include 刷新 / profile 配置变更共用一个串行队列)。文档明写:「直接通过 Plugin Manager 发起的操作无需等待文件事件即可应用」。 |
本插件做什么
- POST /hot-refresh/reload?id=<rowId>:直接调 clientModules.rebuilt(id) —— 立即推帧,不必等 500ms 轮询、也不必先改文件。
- POST /hot-refresh/reload?ids=a,b,c(v0.4.0):精确重载一小组行。客户端记住「上次见过的每行 rev」,据 /health.graph 差分出自上次后变了的那几个 ⇒ 按钮显示「⟳ 热刷新 · N 个已变」并只重载它们(常用情况下不必整图重载、不丢整图 React 状态)。含未知 id ⇒ 503 且一条都不重载(先校验后执行);?ids= 为空 ⇒ 400 need-explicit-all(空列表不得被当成「全部」)。
- POST /hot-refresh/reload?all=1:整图重载(会丢所有插件的 React 状态)——必须显式,否则 400 并告知影响面(行数)。
- GET /hot-refresh/health:只读自检(clientModules 是否可用、图里有多少行、graph:[{id,rev}]、applies 重放计数、最近客户端自报)。
- POST /hot-refresh/report:客户端自报(按过没有、成没成、宿主是哪个版本)。
- 面板入口:设置旁边的「⟳ 热刷新」(sidebar.footer.action;有变化=只重载变化行;无变化=首点待确认、5 秒内再点=整图重载)· 插件详情页头部的「⟳ 就地重载」(plugins.detail.actions,单行即时)。
兼容闸门(v0.4.0)
客户端只在宿主版本 ≥ 0.4.0 时才发 ?ids=。理由:旧宿主(例如仍在跑的 0.1.0)不认识该参数,会退回「整图重载」,等于一声不响把整页状态抹掉。旧宿主下客户端继续走「二次确认 + ?all=1」的老路(对旧宿主是显式意图)。版本比较按数值段(0.10.0 > 0.9.0),空/未知版本一律视为更旧(安全侧)。
本插件不自己实现模块替换(那会与官方机制打架),只负责触发与可观测。
已知边界(官方文档明写 + 本机实测)
本机实测(2026-10-15,两次对照)
| 场景 | 结果 |
| 新装本插件(install_bundle link:…) | 宿主半体当场生效(/health 200 · clientModules:true · 图 86 行),未重启 |
| 改已装插件的 lib/client.js | 客户端半体自己热更(500ms stat → rebuilt 帧 → 就地替换),未刷新页面 |
| 改已装插件的 lib/index.js(宿主)后停用+启用(set_bundle,两次 application: applied) | 仍是旧代码(/health 照旧旧版本号;连新增的 entry/applies 字段都没有)⇒ 宿主半体换不上 |
| 同上,再把入口换文件名并改 exports(换 URL)后停用+启用 | 仍是旧代码 ⇒ Node ESM 按 URL 缓存 + toggle 不重新导入,换文件名也没用 |
⇒ 结论:客户端半体的代码变更可热更;宿主半体的代码变更在本机需要重启 App。 本插件只把「客户端热更」做成按钮,不去伪装能热换宿主。
(lib/index.js 保留了「按 package.json 版本号动态导入 lib/host/impl.js」的薄入口:它不改上述结论,只是保险 —— 将来任何会重新导入入口的组合路径都能自动拿到新版实现;版本没变则命中缓存,不会重复注册。)
对照社区成熟实现(dshmarket v1.66.8,本机 node_modules/dshmarket)
- 它对「一键安装」的承诺原话是「多数插件刷新页面即可用,无需重启」—— 社区语境里的「装完就能直接刷新」指的是刷页面,不是宿主热重载。
- 它的热禁用/启用是往 profile 的 cordis.patch.yml 写 - id: … + disabled: true|false,靠 DSH 的 HMR 约 1 秒内重新组合(机制移植自 dsh-plugin-hub)——这不是「重新导入已加载的模块」,所以它同样换不掉已装插件的宿主代码。
- 对真正换不掉的变更,它给的是一键重启(POST /dsh-market/restart,仅本机同源;lib/restart.js 会重放原入口/参数/环境/工作目录,lib/recovery.js 提供「重启没起来」时的恢复页)。但它在受监督宿主上自动隐藏该按钮(systemd 主进程、被调试进程等)——本机是桌面外壳(受监督宿主),一键重启不适用,必须由用户关窗再开。
- 它的插件目录来自社区精选表 awesome-dsh-plugin。
其它官方限制
- 替换已安装包的版本仍需要重启("包安装在该队列之外执行")。
- 重载是粗粒度的:被重载插件内的 React 状态会丢失(数据层不受影响)。
安装
plugin_manager install_bundle link:E:\DeepSeek\skills\hot-refresh\bundle
plugin_manager set_bundle target=dsh-hot-refresh enabled=true
升级前先跑门:node _preflight.cjs(14 项:包元数据 / 版本一致 / 薄入口契约 / 语法 / 客户端形状 / 路由注册 / health / 整图护栏 / 单行 / 显式整图 / 未知 id / apply 重放 / 敌意 ctx)。预览分享卡片长什么样 ↓
分享 · DeepSeek Harness Hub
liuhaolong16/dsh-hot-refresh
dsh-hot-refresh面板一键热刷新
相关插件 · 开发 / 工程
隐私简历生成器reactive-resume/reactive-resume
Reactive Resume 已迁至 GitHub 上的…
★ 45,125已汉化MCP
71.7
AI 架构文档生成器sopaco/deepwiki-rs
🚀 Litho 已进化为 Terrain —— 给你的 AI 智能体一张会呼吸的代码库地图。
★ 3,157已汉化DSH
70.8
长时任务执行闭环AMAP-ML/LongHorizon-Harness
面向 Computer-Use Agent 的 Loop Engineering
★ 1,764已汉化DSH
70.5
AI 编程纪律方法包GanyuanRan/Aegis
让 AI 编程 agent 变得可信:少返工、更安全、说“完成”前先给证据。
★ 1,384已汉化DSH
69.6
多代理编排运行时Enderfga/claw-orchestrator
面向编程智能体的运行时。把 Claude Code、Codex、Antigravity、Grok…
★ 586已汉化MCP
69.4
记忆进化插件csyangwen/dsh-memory-evolve
dsh-memory-evolve 使用场景指南
★ 461已汉化DSH
67.9