dsh-quick-restart 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-quick-restart contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,75 @@
-# Temporary Holding Version
+# dsh-quick-restart
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+![标题栏上的「重载插件」与「重启」按钮](images/titlebar.png)
+
+给 **DeepSeek Harness（DSH）** 标题栏加两个按钮：**重载插件代码**（不用关程序）和 **重启 DSH**。
+
+> 中文为主，末尾有简短的 English 说明。
+
+## 它解决什么问题
+
+DSH 的第三方插件改了代码之后，默认要**完全退出再打开**才生效（刷新页面没用，热重载也不会自动发生）。
+这个插件在标题栏菜单栏加两个按钮，把这件事变成点一下：
+
+- **重载** —— 只重新加载第三方插件，主进程和会话都不动，实测 8/8 成功；
+- **重启** —— 关掉并重开 DSH（需要另外安装 [`dsh-hot-restart`](https://github.com/InariNGT-Ofiicial/dsh-hot-restart) 提供重启引擎，没装就只有"重载"可用）。
+
+## 安装
+
+### 方式一：从 GitHub Release 装（已发布）
+
+```
+https://github.com/a994903574/dsh-quick-restart/releases/download/v0.1.1/dsh-quick-restart-0.1.1.tgz
+```
+
+把这个地址填进 DSH 的插件安装入口即可（和装其它第三方插件一样）。
+
+### 方式二：从 npm 市场装（尚未发布，等账号开通）
+
+DSH 设置页 →「插件」→ 搜索 `dsh-quick-restart` → 安装 → **完全退出 DSH 再打开**（首次必须，按钮要用宿主启动时的注入表）。
+
+或者手动：
+
+```bash
+cd <你的 DSH profile 目录>
+pnpm add dsh-quick-restart
+```
+
+并在 profile 的 `package.json` 里把它加进 `dsh.profile.bundles`。
+
+## 用起来什么效果
+
+标题栏菜单栏（文件/编辑那一条的右侧）多出两个小按钮：**重载**、**重启**。
+点"重载"后，按钮会短暂显示结果；如果有插件重载失败，鼠标悬停能看到是哪个包、什么错误。
+
+## 边界（老实说）
+
+- **只重载第三方插件**。`@deepseek-ai/*`（宿主内置，在 app.asar 里）和 `cordis:*`（虚拟分组）会被跳过——碰它们必然失败。
+- **前端 bundle 不会跟着换**。插件如果带前端界面，重载后界面那段还是旧的，得重启程序。这是宿主机制，不是本插件的问题。
+- **重启按钮依赖 `dsh-hot-restart`**。没装也能用"重载"，只是重启那颗点了没反应。
+- 仅测试于 **Windows 桌面版**。其他平台未验证。
+
+## 卸载
+
+```bash
+pnpm remove dsh-quick-restart
+```
+再从 `dsh.profile.bundles` 里删掉对应条目，重启 DSH。
+
+## 它是怎么做的（给好奇的人）
+
+桌面壳的 `index.html` 直接读安装包里的静态 dist，不走 `renderIndex`，所以 `webServer.tapIndex` 无效。
+唯一可用的通道是宿主启动时**一次性收集**的 `webserver/index-inject` 注入表——所以插件里不能写对象级 `inject = ['webServer']`，
+否则 `apply()` 会推迟到 webServer 就绪之后，错过那次收集，界面上永远看不到按钮。这一点已在代码注释里写明。
+
+重载本身是：取 loader 的 entries → 清掉该包在 `loader.internal.loadCache` 里的模块 → 重新 import → 用新插件替换旧的 fiber。
+
+## English (short)
+
+**dsh-quick-restart** adds two titlebar buttons to DeepSeek Harness: **reload** third-party plugins without restarting the app, and **restart** DSH
+(the latter requires `dsh-hot-restart`). Built-in `@deepseek-ai/*` plugins and front-end bundles are intentionally not hot-reloaded — that's a host limitation.
+Tested on Windows desktop only. MIT licensed.
+
+## License
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+# dsh-quick-restart bundle patch
+- insert:
+    - id: dsh-quick-restart
+      name: dsh-quick-restart

package/lib/client.js

@@ -0,0 +1,101 @@
+(function () {
+  var BAR = "[data-windows-menu]"
+  var ID_RELOAD = "dsh-quick-restart-reload"
+  var ID_RESTART = "dsh-quick-restart-restart"
+  // 样式照抄外壳菜单栏原生 button 规则（app.asar lib/preload-app.cjs: installWindowsMenu）
+  var CSS = "height:28px;padding:0 10px;border:0;border-radius:6px;background:transparent;" +
+    "color:var(--dsw-alias-label-secondary,inherit);font-family:inherit;font-size:13px;" +
+    "font-weight:400;line-height:28px;cursor:default;-webkit-app-region:no-drag"
+  function menuBar() {
+    try {
+      var hosts = document.querySelectorAll(BAR)
+      for (var i = 0; i < hosts.length; i++) {
+        var shadow = hosts[i].shadowRoot
+        if (!shadow) continue
+        var bar = shadow.querySelector("[role=menubar]")
+        if (bar) return bar
+      }
+    } catch (e) { }
+    return null
+  }
+  // 隐藏 dsh-hot-restart 自带的浮动按钮（我们只借用它的重启引擎，界面用标题栏这颗）
+  function hideTheirs() {
+    try {
+      var id = "dsh-hot-restart-hide"
+      if (document.getElementById(id)) return
+      var st = document.createElement("style")
+      st.id = id
+      st.textContent = "#dsh-hr-btn{display:none !important}"
+      ;(document.head || document.documentElement).appendChild(st)
+    } catch (e) { }
+  }
+  function hoverStyle(bar) {
+    try {
+      var root = bar.getRootNode()
+      if (!root || typeof root.querySelector !== "function") return
+      if (root.querySelector("#dsh-quick-restart-hover")) return
+      var st = document.createElement("style")
+      st.id = "dsh-quick-restart-hover"
+      st.textContent = "#" + ID_RELOAD + ":hover,#" + ID_RESTART + ":hover{background:var(--dsw-alias-interactive-bg-hover,rgba(127,127,127,.18)) !important;color:var(--dsw-alias-label-primary,inherit) !important}"
+      ;(root.nodeType === 11 ? root : (document.head || document.documentElement)).appendChild(st)
+    } catch (e) { }
+  }
+  function fire(kind, btn, text) {
+    btn.disabled = true
+    btn.textContent = kind === "reload" ? "重载中…" : "重启中…"
+    function done(msg) { btn.textContent = msg; setTimeout(function () { btn.textContent = text; btn.disabled = false }, 4000) }
+    if (kind === "reload") {
+      fetch("/dsh-quick-restart/reload", { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify({ confirm: true }) })
+        .then(function (r) { return r.json() })
+        .then(function (j) {
+          if (!j.ok) throw new Error(j.error || "failed")
+          var list = j.result || []
+          var bad = list.filter(function (x) { return !x.ok })
+          if (bad.length) { btn.title = bad.map(function (b) { return b.pkg + ": " + b.error }).join("\n") }
+          done(bad.length ? ("失败 " + bad.length + "/" + list.length) : ("已重载 " + list.length + " 个"))
+        })
+        .catch(function (e) { done("失败: " + String((e && e.message) || e)) })
+      return
+    }
+    // 重启：借 dsh-hot-restart 的引擎（vbs 助手，已验证过）
+    fetch("/dsh-hot-restart/restart", {
+      method: "POST",
+      credentials: "same-origin",
+      headers: { "content-type": "application/json", "x-dsh-hot-restart": "1" },
+      body: JSON.stringify({ at: Date.now(), ua: navigator.userAgent })
+    })
+      .then(function (r) { return r.json().catch(function () { return {} }).then(function (j) { return { ok: r.ok, j: j } }) })
+      .then(function (x) {
+        if (!x.ok || !x.j || x.j.ok !== true) throw new Error((x.j && x.j.error) || "HTTP")
+        btn.textContent = "重启中…"
+      })
+      .catch(function (e) { done("失败: " + String((e && e.message) || e)) })
+  }
+  function makeButton(id, text, kind) {
+    var b = document.createElement("button")
+    b.type = "button"
+    b.id = id
+    b.setAttribute("role", "menuitem")
+    b.tabIndex = -1
+    b.setAttribute("style", CSS)
+    b.textContent = text
+    b.title = kind === "reload" ? "重载插件代码，不动主进程" : "关闭并重开 DSH（dsh-hot-restart 引擎）"
+    b.addEventListener("pointerdown", function (e) { e.preventDefault() })
+    b.addEventListener("mousedown", function (e) { e.preventDefault() })
+    b.addEventListener("click", function (e) { e.preventDefault(); e.stopPropagation(); fire(kind, b, text) })
+    return b
+  }
+  function mount() {
+    hideTheirs()
+    var bar = menuBar()
+    if (!bar) return false
+    hoverStyle(bar)
+    if (bar.querySelector("#" + ID_RELOAD)) return true
+    bar.appendChild(makeButton(ID_RELOAD, "重载插件", "reload"))
+    bar.appendChild(makeButton(ID_RESTART, "重启", "restart"))
+    return true
+  }
+  var tries = 0
+  var timer = setInterval(function () { tries += 1; hideTheirs(); if (mount() || tries > 240) clearInterval(timer) }, 500)
+  mount()
+})();

package/lib/index.js

@@ -0,0 +1,145 @@
+// dsh-quick-restart — 宿主侧：注入标题栏脚本 + 两条路由（重载 / 重启）
+// 关键：**不写对象级 inject**。桌面端（Electron）的注入表是宿主启动时一次性收集的
+// （collectIndexInjections → IPC → 渲染层逐行应用），对象级 inject 会把 apply() 推迟到
+// webServer 就绪之后，订阅晚于那次收集，界面就永远不出现。
+// 另外：桌面壳的 index.html 从安装包静态 dist 读盘，不经过 renderIndex()，tapIndex 无效；
+// 唯一通道是 webserver/index-inject 的结构化 script 行。
+import { spawn } from 'node:child_process'
+import { fileURLToPath } from 'node:url'
+import { dirname, join } from 'node:path'
+import { existsSync, readFileSync } from 'node:fs'
+
+export const name = 'dsh-quick-restart'
+
+const HERE = dirname(fileURLToPath(import.meta.url))
+const SELF = 'dsh-quick-restart'
+const CLIENT_ROUTE = '/dsh-quick-restart/client.js'
+const JSON_HEADERS = { 'content-type': 'application/json; charset=utf-8' }
+// 内联加载器：自己建 <script src> 并吞掉 onerror —— 路由在就加载，不在也不影响页面启动
+const LOADER = 'var s=document.createElement("script");s.src="' + CLIENT_ROUTE + '";s.onerror=function(){};document.body.appendChild(s);'
+
+function pkgOf(spec) {
+  if (!spec) return null
+  const parts = String(spec).split('/')
+  return parts[0].startsWith('@') ? parts.slice(0, 2).join('/') : parts[0]
+}
+
+function readBody(req) {
+  return new Promise((resolve) => {
+    let raw = ''
+    req.on('data', (c) => { raw += c; if (raw.length > 1e6) req.destroy() })
+    req.on('end', () => { try { resolve(raw ? JSON.parse(raw) : {}) } catch { resolve({}) } })
+  })
+}
+
+function json(res, code, obj) {
+  try { res.writeHead(code, JSON_HEADERS); res.end(JSON.stringify(obj)) } catch { /* 忽略 */ }
+}
+
+export function apply(ctx, config = {}) {
+  try { applyInner(ctx, config) } catch (e) {
+    try { ctx.logger?.error?.('dsh-quick-restart 装载失败: ' + String((e && e.stack) || e)) } catch { /* 忽略 */ }
+  }
+}
+
+function applyInner(ctx, config = {}) {
+  const appExe = config.appExe || process.execPath
+  const log = (m) => { try { ctx.logger?.info?.(m) } catch { /* 忽略 */ } }
+  let port = 0
+  const webPort = () => { try { if (Number.isSafeInteger(ctx.webServer?.port)) return ctx.webServer.port } catch { /* 忽略 */ } return port }
+
+  // ① 注入表（必须尽早订阅，且不能依赖 webServer）
+  try {
+    ctx.on('webserver/index-inject', (table) => {
+      if (!Array.isArray(table)) return
+      if (table.some((row) => row && typeof row.text === 'string' && row.text.indexOf(CLIENT_ROUTE) >= 0)) return
+      table.push({ kind: 'script', placement: 'body', text: LOADER })
+    })
+  } catch (e) { log('index-inject 订阅失败: ' + String((e && e.message) || e)) }
+
+  function resolveUrl(internal, specifier, parentURL) {
+    const attrs = {}
+    if (internal.version === 'v2' && typeof internal.resolveSync === 'function') return internal.resolveSync(parentURL, { specifier, attributes: attrs })
+    if (typeof internal.resolve === 'function') return internal.resolve(specifier, parentURL, attrs)
+    if (typeof internal.resolveSync === 'function') return internal.resolveSync(parentURL, { specifier, attributes: attrs })
+    throw new Error('loader.internal 没有解析器')
+  }
+
+  function invalidateDir(internal, url) {
+    let dir = dirname(fileURLToPath(url))
+    let root = null
+    for (;;) {
+      if (existsSync(join(dir, 'package.json'))) { root = dir; break }
+      const parent = dirname(dir)
+      if (parent === dir) break
+      dir = parent
+    }
+    const prefix = root ? root.replace(/\\/g, '/').toLowerCase() : null
+    let n = 0
+    try {
+      for (const key of [...internal.loadCache.keys()]) {
+        const k = String(key).replace(/\\/g, '/').toLowerCase()
+        if (prefix ? k.indexOf(prefix) >= 0 : false) { try { Map.prototype.delete.call(internal.loadCache, key); n += 1 } catch { /* 忽略 */ } }
+      }
+    } catch { /* 忽略 */ }
+    return n
+  }
+
+  async function reloadOne(loader, internal, entry) {
+    const specifier = entry?.options?.name
+    const parentURL = entry?.parent?.tree?.ctx?.baseUrl ?? ctx.baseUrl
+    const oldFiber = entry?.fiber
+    const oldPlugin = oldFiber?.runtime?.callback
+    if (!oldPlugin) throw new Error('没有活动的 fiber')
+    const resolved = await resolveUrl(internal, specifier, parentURL)
+    const url = typeof resolved === 'string' ? resolved : (resolved && resolved.url ? String(resolved.url) : String(resolved))
+    invalidateDir(internal, url)
+    const newPlugin = loader.unwrapExports(await loader.import(url, () => []))
+    if (!newPlugin) throw new Error('重新 import 没有导出插件')
+    oldFiber.parent.registry.delete(oldPlugin)
+    oldFiber.parent.registry.plugin(newPlugin, oldFiber._config, () => [])
+  }
+
+  async function reloadTargets(only) {
+    const loader = ctx.get('loader')
+    const internal = loader?.internal
+    if (!loader || typeof loader.entries !== 'function') throw new Error('loader 不可用')
+    if (!internal || !internal.loadCache) throw new Error('loader.internal 不可用，无法清缓存')
+    const seen = new Set()
+    const out = []
+    for (const entry of [...loader.entries()]) {
+      if (entry?.disabled || entry?.options?.group || !entry?.fiber?.runtime) continue
+      const pkg = pkgOf(entry?.options?.name)
+      if (!pkg || pkg === SELF) continue
+      // 宿主内置插件（@deepseek-ai/*）在 app.asar 里，热重载必然失败，别去碰
+      if (pkg.startsWith('@deepseek-ai/')) continue
+      if (pkg.startsWith('cordis:')) continue // 虚拟分组条目，没有可重载的模块
+      if (only && only.length && !only.includes(pkg)) continue
+      if (seen.has(pkg)) continue
+      seen.add(pkg)
+      try { await reloadOne(loader, internal, entry); out.push({ pkg, ok: true }) }
+      catch (e) { out.push({ pkg, ok: false, error: String((e && e.message) || e) }) }
+    }
+    return out
+  }
+
+    // ② 路由（等 webServer）
+  ctx.inject(['webServer'], (c) => {
+    try { port = Number(c.webServer?.port) || 0 } catch { /* 忽略 */ }
+    const route = (path, handler) => c.effect(() => c.webServer.register({ kind: 'exact', path, handler }))
+    route(CLIENT_ROUTE, (req, res) => {
+      try {
+        const js = readFileSync(join(HERE, 'client.js'), 'utf8')
+        res.writeHead(200, { 'content-type': 'application/javascript; charset=utf-8', 'cache-control': 'no-store' })
+        res.end(js)
+      } catch (e) { res.writeHead(404); res.end('missing client') }
+    })
+    route('/dsh-quick-restart/info', (req, res) => json(res, 200, { ok: true, name: SELF, pid: process.pid, port: webPort() }))
+    route('/dsh-quick-restart/reload', async (req, res) => {
+      const b = await readBody(req)
+      if (b.confirm !== true) return json(res, 400, { ok: false, error: '需要 confirm:true' })
+      try { const result = await reloadTargets(Array.isArray(b.packages) ? b.packages : null); log('quick-restart 重载: ' + JSON.stringify(result)); return json(res, 200, { ok: true, result }) }
+      catch (e) { return json(res, 500, { ok: false, error: String((e && e.message) || e) }) }
+    })
+  })
+}

package/package.json

@@ -1,6 +1,44 @@
 {
   "name": "dsh-quick-restart",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "type": "module",
+  "description": "DeepSeek Harness 插件：标题栏加两个按钮——重载第三方插件（不用重启宿主）、重启 DSH。",
+  "keywords": [
+    "deepseek",
+    "deepseek-harness",
+    "dsh",
+    "dsh-plugin",
+    "plugin",
+    "restart",
+    "hot-reload"
+  ],
+  "license": "MIT",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/a994903574/dsh-quick-restart.git"
+  },
+  "homepage": "https://github.com/a994903574/dsh-quick-restart#readme",
+  "bugs": {
+    "url": "https://github.com/a994903574/dsh-quick-restart/issues"
+  },
+  "author": "a994903574"
+}