dsh-harness-manager 0.1.0

package/README.md

@@ -0,0 +1,124 @@
+# dsh-harness-manager
+
+在 DSH 的 Web 界面左下角加一个「管理器」胶囊按钮,一键打开桌面版
+[DeepSeek Harness Manager](https://github.com/sss-1012/DeepSeek-Harness-Manager)。
+
+管理器是本仓库提供的 Windows 控制中心:环境检测与安装、插件搜索/安装/启停、
+多 profile 启停、诊断中心、余额查询、版本更新与回滚。
+
+- 已安装管理器 → 显示**绿点**,点击直接启动(管理器是单实例,已在运行会前置窗口)。
+- 未检测到 → 显示**黄点**,点击前往 Releases 下载页。
+- 胶囊可关闭,偏好记录在 `localStorage`(键 `dshm.panel.hidden`)。
+
+## 安装
+
+```bash
+dsh plugin --profile web add dsh-harness-manager
+```
+
+安装后重启 `dsh web`(或在管理器里重启该 profile)生效。
+
+本地开发安装(不发布 npm,直接链接目录):
+
+```bash
+dsh plugin --profile web add link:E:\Work\DeepSeek-Harness-Manager\plugin
+```
+
+卸载:
+
+```bash
+dsh plugin --profile web remove dsh-harness-manager
+```
+
+## 管理器程序是怎么找到的
+
+按以下顺序探测,任一路径存在即可用:
+
+1. 环境变量 `DSH_MANAGER_EXE`(指向 `DeepSeek-Harness-Manager.exe`)
+2. `~/.dsh-manager/install.json` 中的 `exe` 字段 —— 管理器每次启动时自注册,
+   同时写入 `version` 与 `updatedAt`
+3. 常见安装位置:
+   - `%LOCALAPPDATA%\Programs\DeepSeek-Harness-Manager\DeepSeek-Harness-Manager.exe`
+   - `%LOCALAPPDATA%\DeepSeek-Harness-Manager\DeepSeek-Harness-Manager.exe`
+   - `%ProgramFiles%\DeepSeek-Harness-Manager\DeepSeek-Harness-Manager.exe`
+
+未安装也不影响 DSH 本身:插件只提供一个入口,不含任何业务逻辑。
+
+## 提供的路由
+
+宿主侧通过 `ctx.webServer` 注册三个只读/本地路由,不会向外发请求:
+
+| 路径 | 方法 | 说明 |
+| --- | --- | --- |
+| `/dsh-manager/status.json` | GET | `{ installed, exe, version, source, downloadUrl }` |
+| `/dsh-manager/launch` | POST | 以 detached 方式启动管理器进程 |
+| `/dsh-manager/panel.js` | GET | 左下角入口的客户端脚本 |
+
+## 目录结构
+
+```
+plugin/
+  package.json         # dsh.bundle 声明 + keywords(dsh-plugin)
+  cordis.patch.yml     # 把插件挂进 profile 配置树
+  lib/index.js         # 宿主侧:路由 + tapIndex 注入
+  lib/panel.js         # 客户端:左下角胶囊按钮
+  test/host.test.js    # 无依赖自检(mock ctx,13 项)
+  test/boot-check.mjs  # 真实启动自检(隔离环境,9 项)
+  test/resolve-check.mjs  # 只读:bundle 解析 + 依赖树完整度
+```
+
+## 自检
+
+```bash
+node plugin/test/host.test.js        # 快:mock 宿主上下文,校验路由/注入/分支
+node plugin/test/boot-check.mjs      # 慢(约 1 分钟):真实 dsh web 端到端
+node plugin/test/resolve-check.mjs web --deep   # 只读:检查某 profile 的 bundle 是否都能解析、依赖树是否完整
+```
+
+`boot-check.mjs` 会在 `.dshm-plugin-check/` 下**用独立的 DSH_HOME 与非默认端口**(默认 3099)
+创建测试 profile,不读写真实的 `~/.dsh`、`~/.dsh-manager`,也不影响正在运行的服务;
+结束时会自动清理(若目录仍被刚退出的子进程占用,会交给后台进程稍后删除)。
+
+## 发布到 npm(可选)
+
+发布后即可 `dsh plugin --profile web add dsh-harness-manager`,不必再用 `link:`。
+
+```bash
+cd plugin
+npm login
+npm publish --access public
+```
+
+若账号开启了 2FA,npm 会要求一次性验证码,否则报
+`E403 ... Two-factor authentication or granular access token with bypass 2fa enabled is required`。两种解法:
+
+1. 带验证码发布:`npm publish --access public --otp=<验证器里的 6 位码>`;
+   若提示需要 web 认证,先执行 `npm login --auth-type=web` 再发布。
+2. 生成**勾选 Bypass 2FA** 的 granular token(包权限 Read and write),设置
+   `npm config set //registry.npmjs.org/:_authToken <token>` 后再发布。
+   该 token 等同免 2FA 的发布权限,不要提交进仓库,用完可撤销。
+
+## 提交到 awesome-dsh-plugin
+
+上游要求(见其 `contributing.md`):`package.json` 声明 `dsh.bundle` 且同级有 `cordis.patch.yml`、
+仓库创建满 1 天、仓库带 [`dsh-plugin`](https://github.com/topics/dsh-plugin) topic、描述必须与代码相符。
+本插件位于子目录,按「monorepo 子包」形式提交:`url` 指向子目录,`name` 用 `owner/repo#subname`,
+文件名 `owner__repo--<子路径>.yml`。
+
+在 [awesome-dsh-plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin) 添加**一个文件**
+`data/plugins/sss-1012__DeepSeek-Harness-Manager--plugin.yml`:
+
+```yaml
+url: https://github.com/sss-1012/DeepSeek-Harness-Manager/tree/main/plugin
+name: sss-1012/DeepSeek-Harness-Manager#plugin
+category: dev
+description:
+  en: "Launcher pill in the DSH web UI that opens DeepSeek Harness Manager, a Windows desktop app which installs Node/pnpm/dsh, manages plugins and profiles, diagnoses failures, and updates or rolls back the dsh CLI."
+  zh: "DSH 界面左下角的入口胶囊,一键打开 DeepSeek Harness Manager —— Windows 控制中心:装环境(Node/pnpm/dsh)、管插件与 profile、诊断故障,以及 dsh CLI 的更新与回滚。"
+```
+
+不要手改生成出来的两个 README;`category` 只能取上游列出的固定值之一(`dev` 为同类启动器常用的分类)。
+
+## License
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,18 @@
+# ============================================================================
+# dsh-harness-manager —— DSH bundle patch
+# ============================================================================
+# 挂载声明:把「打开 DSH Manager」入口插入 Web profile 的配置树。
+#
+# 安装:
+#   dsh plugin --profile web add dsh-harness-manager
+# 本地/开发安装(直接链接本目录):
+#   dsh plugin --profile web add link:<本目录绝对路径>
+# 安装后重启 dsh web 生效。
+#
+# 卸载:
+#   dsh plugin --profile web remove dsh-harness-manager
+# ============================================================================
+
+- insert:
+    - id: dsh-harness-manager
+      name: dsh-harness-manager

package/lib/index.js

@@ -0,0 +1,149 @@
+import fs from 'node:fs'
+import os from 'node:os'
+import path from 'node:path'
+import { spawn } from 'node:child_process'
+import { fileURLToPath } from 'node:url'
+
+// dsh-harness-manager —— 在 DSH 界面里一键打开 DeepSeek Harness Manager。
+// 由 manager 仓库提供;安装:
+//   dsh plugin --profile web add dsh-harness-manager
+//   dsh plugin --profile web add link:<repo>/plugin      (本地开发)
+const name = 'dsh-harness-manager'
+const inject = ['webServer']
+
+const PACKAGE_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
+const MANAGER_HOME = process.env.DSH_MANAGER_HOME || path.join(os.homedir(), '.dsh-manager')
+const EXE_NAME = 'DeepSeek-Harness-Manager.exe'
+const DOWNLOAD_URL = 'https://github.com/sss-1012/DeepSeek-Harness-Manager/releases/latest'
+
+const JSON_HEADERS = {
+  'Content-Type': 'application/json; charset=utf-8',
+  'Cache-Control': 'no-store',
+}
+
+function candidatePaths() {
+  const list = []
+  if (process.env.DSH_MANAGER_EXE) list.push(process.env.DSH_MANAGER_EXE)
+  const local = process.env.LOCALAPPDATA || ''
+  const pf = process.env.ProgramFiles || 'C:\\Program Files'
+  const pf86 = process.env['ProgramFiles(x86)'] || ''
+  if (local) {
+    list.push(path.join(local, 'Programs', 'DeepSeek-Harness-Manager', EXE_NAME))
+    list.push(path.join(local, 'DeepSeek-Harness-Manager', EXE_NAME))
+  }
+  list.push(path.join(pf, 'DeepSeek-Harness-Manager', EXE_NAME))
+  if (pf86) list.push(path.join(pf86, 'DeepSeek-Harness-Manager', EXE_NAME))
+  return list
+}
+
+// manager 启动时会写 install.json(自注册),优先采用;否则回退到常见安装路径
+function locateManager() {
+  try {
+    const raw = fs.readFileSync(path.join(MANAGER_HOME, 'install.json'), 'utf8')
+    const info = JSON.parse(raw.replace(/^\uFEFF/, ''))
+    if (info && typeof info.exe === 'string' && fs.existsSync(info.exe)) {
+      return { exe: info.exe, version: info.version || null, source: 'install.json' }
+    }
+  } catch { /* 未自注册 */ }
+  for (const p of candidatePaths()) {
+    try { if (p && fs.existsSync(p)) return { exe: p, version: null, source: 'path' } } catch { /* 忽略 */ }
+  }
+  return null
+}
+
+function readBody(req, limit = 64 * 1024) {
+  return new Promise((resolve, reject) => {
+    let size = 0
+    const chunks = []
+    req.on('data', (c) => {
+      size += c.length
+      if (size > limit) { reject(new Error('body too large')); req.destroy(); return }
+      chunks.push(c)
+    })
+    req.on('end', () => resolve(Buffer.concat(chunks).toString('utf8')))
+    req.on('error', reject)
+  })
+}
+
+function apply(ctx) {
+  const disposers = []
+  if (!ctx || !ctx.webServer) return
+
+  const panelJs = fs.readFileSync(path.join(PACKAGE_ROOT, 'lib', 'panel.js'), 'utf8')
+
+  // 状态:是否已安装、版本、下载地址
+  disposers.push(ctx.webServer.register({
+    kind: 'exact',
+    path: '/dsh-manager/status.json',
+    handler: (req, res) => {
+      const found = locateManager()
+      res.writeHead(200, JSON_HEADERS)
+      res.end(JSON.stringify({
+        ok: true,
+        installed: Boolean(found),
+        exe: found ? found.exe : null,
+        version: found ? found.version : null,
+        source: found ? found.source : null,
+        downloadUrl: DOWNLOAD_URL,
+      }))
+    },
+  }))
+
+  // 启动管理器(单实例锁会让已在运行的窗口前置)
+  disposers.push(ctx.webServer.register({
+    kind: 'exact',
+    path: '/dsh-manager/launch',
+    handler: async (req, res) => {
+      if (req.method !== 'POST') {
+        res.writeHead(405, JSON_HEADERS)
+        res.end(JSON.stringify({ ok: false, error: 'POST only' }))
+        return
+      }
+      try { await readBody(req) } catch { /* 忽略 body */ }
+      const found = locateManager()
+      if (!found) {
+        res.writeHead(200, JSON_HEADERS)
+        res.end(JSON.stringify({ ok: false, code: 'NOT_INSTALLED', downloadUrl: DOWNLOAD_URL }))
+        return
+      }
+      try {
+        const child = spawn(found.exe, [], { detached: true, stdio: 'ignore', windowsHide: false })
+        child.unref()
+        res.writeHead(200, JSON_HEADERS)
+        res.end(JSON.stringify({ ok: true, exe: found.exe }))
+      } catch (err) {
+        res.writeHead(200, JSON_HEADERS)
+        res.end(JSON.stringify({ ok: false, code: 'LAUNCH_FAILED', error: String((err && err.message) || err).slice(0, 200) }))
+      }
+    },
+  }))
+
+  // 客户端脚本
+  disposers.push(ctx.webServer.register({
+    kind: 'exact',
+    path: '/dsh-manager/panel.js',
+    handler: (req, res) => {
+      res.writeHead(200, {
+        'Content-Type': 'application/javascript; charset=utf-8',
+        'Cache-Control': 'no-store',
+      })
+      res.end(panelJs)
+    },
+  }))
+
+  // 注入到 Web UI
+  disposers.push(ctx.webServer.tapIndex((html) => {
+    if (html.indexOf('/dsh-manager/panel.js') !== -1) return html
+    const tag = '<script defer src="/dsh-manager/panel.js"></script>'
+    if (html.indexOf('</body>') !== -1) return html.replace('</body>', tag + '</body>')
+    return html + tag
+  }))
+
+  ctx.effect(() => () => {
+    for (const d of disposers) {
+      try { d() } catch { /* 忽略 */ }
+    }
+  })
+}
+
+export { name, inject, apply }

package/lib/panel.js

@@ -0,0 +1,113 @@
+// dsh-harness-manager 客户端脚本:在 DSH Web UI 左下角放一个管理器入口。
+// 纯浏览器脚本,由宿主以 /dsh-manager/panel.js 提供。
+(function () {
+  if (window.__dshManagerPanel) return
+  window.__dshManagerPanel = true
+
+  var HIDE_KEY = 'dshm.panel.hidden'
+  var API = '/dsh-manager'
+  var state = null
+
+  function el(tag, style, text) {
+    var node = document.createElement(tag)
+    if (style) node.setAttribute('style', style)
+    if (text != null) node.textContent = text
+    return node
+  }
+
+  function toast(message) {
+    var box = el('div',
+      'position:fixed;left:18px;bottom:74px;z-index:2147482000;max-width:320px;' +
+      'padding:10px 14px;border-radius:10px;font:13px/1.5 system-ui,-apple-system,"Segoe UI",sans-serif;' +
+      'background:rgba(17,24,39,.94);color:#f9fafb;box-shadow:0 8px 24px rgba(0,0,0,.28);' +
+      'opacity:0;transition:opacity .18s ease;pointer-events:none;')
+    box.textContent = message
+    document.body.appendChild(box)
+    requestAnimationFrame(function () { box.style.opacity = '1' })
+    setTimeout(function () {
+      box.style.opacity = '0'
+      setTimeout(function () { if (box.parentNode) box.parentNode.removeChild(box) }, 220)
+    }, 2600)
+  }
+
+  function build(status) {
+    var wrap = el('div',
+      'position:fixed;left:18px;bottom:18px;z-index:2147482000;display:flex;align-items:center;gap:8px;')
+    wrap.id = 'dshm-panel'
+
+    var btn = el('button',
+      'display:inline-flex;align-items:center;gap:8px;padding:9px 14px;' +
+      'border:1px solid rgba(148,163,184,.45);border-radius:999px;cursor:pointer;' +
+      'font:600 13px/1 system-ui,-apple-system,"Segoe UI",sans-serif;' +
+      'background:rgba(255,255,255,.94);color:#111827;backdrop-filter:blur(8px);' +
+      'box-shadow:0 6px 18px rgba(15,23,42,.16);')
+    var dot = el('span',
+      'width:8px;height:8px;border-radius:50%;flex:0 0 auto;background:' +
+      (status.installed ? '#16a34a' : '#f59e0b') + ';')
+    var text = el('span', null, status.installed ? '管理器' : '安装管理器')
+    btn.appendChild(dot)
+    btn.appendChild(text)
+
+    btn.addEventListener('mouseenter', function () { btn.style.boxShadow = '0 10px 24px rgba(15,23,42,.24)' })
+    btn.addEventListener('mouseleave', function () { btn.style.boxShadow = '0 6px 18px rgba(15,23,42,.16)' })
+
+    btn.title = status.installed
+      ? '打开 DeepSeek Harness Manager' + (status.version ? ' v' + status.version : '') + '\n' + (status.exe || '')
+      : '尚未检测到管理器,点击前往下载'
+
+    btn.addEventListener('click', function () {
+      if (!state || !state.installed) {
+        window.open((state && state.downloadUrl) || 'https://github.com/sss-1012/DeepSeek-Harness-Manager/releases/latest', '_blank', 'noopener')
+        return
+      }
+      btn.disabled = true
+      fetch(API + '/launch', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: '{}' })
+        .then(function (r) { return r.json() })
+        .then(function (data) {
+          if (data && data.ok) { toast('DeepSeek Harness Manager 已启动'); return }
+          if (data && data.code === 'NOT_INSTALLED') {
+            state.installed = false
+            toast('未找到管理器程序,正在打开下载页')
+            window.open((data && data.downloadUrl) || (state && state.downloadUrl) || '', '_blank', 'noopener')
+            return
+          }
+          toast('启动失败:' + ((data && data.error) || '未知错误'))
+        })
+        .catch(function (err) { toast('启动失败:' + (err && err.message ? err.message : err)) })
+        .then(function () { btn.disabled = false })
+    })
+
+    var close = el('button',
+      'width:26px;height:26px;line-height:1;padding:0;border:1px solid rgba(148,163,184,.45);' +
+      'border-radius:50%;cursor:pointer;background:rgba(255,255,255,.9);color:#64748b;' +
+      'font:14px/1 system-ui,sans-serif;box-shadow:0 4px 12px rgba(15,23,42,.12);',
+      '×')
+    close.title = '隐藏(在浏览器控制台执行 localStorage.removeItem("' + HIDE_KEY + '") 可恢复)'
+    close.addEventListener('click', function () {
+      try { localStorage.setItem(HIDE_KEY, '1') } catch (e) { /* 忽略 */ }
+      if (wrap.parentNode) wrap.parentNode.removeChild(wrap)
+    })
+
+    wrap.appendChild(btn)
+    wrap.appendChild(close)
+    return wrap
+  }
+
+  function mount(status) {
+    state = status
+    var old = document.getElementById('dshm-panel')
+    if (old && old.parentNode) old.parentNode.removeChild(old)
+    document.body.appendChild(build(status))
+  }
+
+  function boot() {
+    try { if (localStorage.getItem(HIDE_KEY) === '1') return } catch (e) { /* 忽略 */ }
+    fetch(API + '/status.json', { headers: { Accept: 'application/json' } })
+      .then(function (r) { return r.json() })
+      .then(function (data) { mount(data || { installed: false }) })
+      .catch(function () { mount({ installed: false, downloadUrl: 'https://github.com/sss-1012/DeepSeek-Harness-Manager/releases/latest' }) })
+  }
+
+  if (document.readyState === 'loading') document.addEventListener('DOMContentLoaded', boot)
+  else boot()
+})()

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "dsh-harness-manager",
+  "version": "0.1.0",
+  "description": "在 DSH 界面里一键打开 DeepSeek Harness Manager(Windows 控制中心:环境/插件/诊断/更新回滚)",
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "manager",
+    "windows",
+    "diagnostics"
+  ],
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": {
+      "default": "./lib/index.js"
+    },
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sss-1012/DeepSeek-Harness-Manager.git",
+    "directory": "plugin"
+  },
+  "homepage": "https://github.com/sss-1012/DeepSeek-Harness-Manager/tree/main/plugin",
+  "bugs": {
+    "url": "https://github.com/sss-1012/DeepSeek-Harness-Manager/issues"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "MIT"
+}