dsh-plugin-versions 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ACGNnsj
+
+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,52 @@
-# Temporary Holding Version
+# 插件版本一览 · dsh-plugin-versions
 
-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.
+给 DeepSeek Harness 的「插件」页加一个标签页：列出所有已安装组合包的版本，标出哪些能更新，点一行直接跳到官方组合包详情页的「版本」区块完成更新。
+
+## 它解决什么
+
+DSH 官方的「版本」区块和更新按钮只出现在 **从 registry 安装、且被 Host 标为 `updatable`** 的第三方组合包详情页里。想确认「我这堆插件哪个该更新」，得逐个点进去看。这个插件把这件事摊平成一屏。
+
+## 功能
+
+- 插件页新增第 4 个标签页「版本一览」（`plugins.tab`，`order: 40`）
+- 先渲染本地版本，再逐行后台查 registry；只查 `updatable && !official` 的行，串行执行，避免同时打出一堆 pnpm 子进程
+- 状态分档：`可更新到 x` / `已是最新` / `随 DSH 更新` / `无官方版本区块` / 检查中… / 检查失败（附错误原文前 300 字）
+- 可更新的行排前面，其余按包名排序
+- 点一行 → `openPackage(name)` 打开官方组合包详情页，并自动滚到底，直接落在「版本」区块
+- 详情页底部追加「↑ 回到顶部」（`plugins.detail.section`，`order: 999`）
+
+更新动作本身完全走官方界面，本插件不实现任何更新流程。
+
+## 安装
+
+仓库即 bundle。二选一：
+
+```bash
+# 已在本机：用 DSH 的插件管理器装这个目录
+plugin_manager install_bundle target=<绝对路径>/dsh-plugin-versions
+```
+
+或作为 npm 包安装到 profile（需先发到 registry）。注册靠 `cordis.patch.yml` 的 `- insert:` 一行，插件不会改写 profile 的任何文件。
+
+## 结构
+
+```
+package.json          清单：dsh.bundle.patch / dsh.client / exports ./client
+cordis.patch.yml      注册一行：- insert: [{ id, name }]
+index.js              Host half（空实现，只为满足 bundle 契约）
+client.js             浏览器半：纯 JS，window.__ModuleLoader__.load 懒加载工厂
+locale/{zh,en}.json   显示元数据 meta.title / meta.description
+icon.svg              列表图标
+```
+
+## 开发
+
+客户端没有构建步骤：`client.js` 直接是产物，改完在「插件」页点刷新即可生效（`Ctrl+R` 在桌面端不触发重载）。渲染逻辑可以用 `vm` + 假 React 离线自证。
+
+## 数据来源与权限
+
+只读调用 Host 的 `pluginManager.listBundles()` 与 `pluginManager.listVersions(name, {})`。前者不触网；后者每个包最多打 2 个 registry（含 fallback 镜像），单包最坏约 140 秒，因此必须串行且只查可更新的行。
+
+## 许可
+
+MIT

package/client.js

@@ -0,0 +1,331 @@
+window.__ModuleLoader__.load({
+  id: "dsh-plugin-versions",
+  factory: (require) => {
+    const ReactMod = require("react");
+    const React = (ReactMod && ReactMod.createElement) ? ReactMod : ((ReactMod && ReactMod.default && ReactMod.default.createElement) ? ReactMod.default : ReactMod);
+    const h = React.createElement;
+
+    const S = {
+      root: { display: "flex", flexDirection: "column", gap: "10px", padding: "4px 2px", fontSize: "13px", lineHeight: 1.5, color: "inherit" },
+      bar: { display: "flex", alignItems: "center", gap: "8px" },
+      muted: { opacity: 0.62 },
+      table: { display: "flex", flexDirection: "column", border: "1px solid rgba(128,128,128,0.22)", borderRadius: "8px", overflow: "hidden" },
+      row: { display: "grid", gridTemplateColumns: "minmax(180px,1.6fr) 110px 120px minmax(110px,1fr)", gap: "8px", padding: "9px 12px", borderTop: "1px solid rgba(128,128,128,0.16)", alignItems: "center" },
+      head: { fontWeight: 600, background: "rgba(128,128,128,0.07)", borderTop: "none" },
+      name: { fontWeight: 600, overflow: "hidden", textOverflow: "ellipsis", whiteSpace: "nowrap" },
+      badge: { display: "inline-block", padding: "1px 7px", borderRadius: "999px", fontSize: "12px", border: "1px solid currentColor" },
+      upd: { color: "#2f9e63" },
+      btn: { font: "inherit", color: "inherit", background: "transparent", border: "1px solid rgba(128,128,128,0.35)", borderRadius: "6px", padding: "2px 9px", cursor: "pointer" },
+      err: { color: "#d9534f" },
+      click: { cursor: "pointer" }
+    };
+
+    function describe(b) {
+      if (b.updatable) return "可更新";
+      if (!b.installed) return "未安装";
+      if (b.official) return "跟随 DSH";
+      if (b.optional) return "按需安装";
+      return "来源不支持更新";
+    }
+
+    function latestText(slot) {
+      if (!slot) return "—";
+      if (slot.status === "loading") return "检查中…";
+      if (slot.status === "error") return "检查失败";
+      const list = slot.list;
+      if (!list) return "—";
+      if (list.status === "refused") return list.problem === "not-updatable" ? "—" : "无法检查";
+      const first = list.versions && list.versions[0];
+      return first ? first.version : "已是最新";
+    }
+
+    class TabBoundary extends React.Component {
+      constructor(props) {
+        super(props);
+        this.state = { err: null };
+      }
+      static getDerivedStateFromError(err) {
+        return { err: err };
+      }
+      render() {
+        if (this.state.err) {
+          return h("div", { style: { color: "#d9534f", whiteSpace: "pre-wrap", fontSize: "12px" } }, "渲染失败：" + String((this.state.err && this.state.err.stack) || this.state.err));
+        }
+        return this.props.children;
+      }
+    }
+
+    function scrollPluginPageToBottom() {
+      const scrollables = () => {
+        const out = [];
+        const all = document.querySelectorAll("div, main, section, article");
+        for (let i = 0; i < all.length; i += 1) {
+          const el = all[i];
+          if (el.scrollHeight - el.clientHeight <= 60) continue;
+          const cs = window.getComputedStyle(el);
+          if (!/(auto|scroll)/.test(cs.overflowY)) continue;
+          const r = el.getBoundingClientRect();
+          if (r.width < 400 || r.left < 180) continue;
+          out.push(el);
+        }
+        return out;
+      };
+      const attempt = () => {
+        try {
+          const els = scrollables();
+          els.sort((a, b) => (b.clientHeight * b.clientWidth) - (a.clientHeight * a.clientWidth));
+          if (els.length > 0) els[0].scrollTop = els[0].scrollHeight;
+          const doc = document.scrollingElement || document.documentElement;
+          if (doc) doc.scrollTop = doc.scrollHeight;
+        } catch (e) { /* 忽略：滚动只是锦上添花 */ }
+      };
+      setTimeout(attempt, 120);
+      setTimeout(attempt, 400);
+      setTimeout(attempt, 900);
+    }
+
+    function scrollPluginPageToTop() {
+      const attempt = () => {
+        try {
+          const all = document.querySelectorAll("div, main, section, article");
+          const out = [];
+          for (let i = 0; i < all.length; i += 1) {
+            const el = all[i];
+            if (el.scrollHeight - el.clientHeight <= 60) continue;
+            const cs = window.getComputedStyle(el);
+            if (!/(auto|scroll)/.test(cs.overflowY)) continue;
+            const r = el.getBoundingClientRect();
+            if (r.width < 400 || r.left < 180) continue;
+            out.push(el);
+          }
+          out.sort((a, b) => (b.clientHeight * b.clientWidth) - (a.clientHeight * a.clientWidth));
+          if (out.length > 0) out[0].scrollTop = 0;
+          const doc = document.scrollingElement || document.documentElement;
+          if (doc) doc.scrollTop = 0;
+        } catch (e) { /* 忽略：滚动失败不影响页面 */ }
+      };
+      attempt();
+      setTimeout(attempt, 80);
+    }
+
+    function BackToTopSection(props) {
+      const subject = props && props.subject;
+      if (subject && subject.kind && subject.kind !== "bundle") return null;
+      return h("div", { style: { display: "flex", justifyContent: "flex-end", padding: "10px 0 6px" } },
+        h("button", {
+          type: "button",
+          style: {
+            background: "transparent",
+            border: "1px solid currentColor",
+            borderRadius: "6px",
+            color: "inherit",
+            cursor: "pointer",
+            fontSize: "12px",
+            opacity: 0.72,
+            padding: "4px 10px"
+          },
+          onClick: () => scrollPluginPageToTop()
+        }, "↑ 回到顶部")
+      );
+    }
+
+    function VersionsTab(props) {
+      const ctx = props.ctx;
+      const openPackage = props.openPackage;
+      const [state, setState] = React.useState({ status: "loading", bundles: [], error: null });
+      const [rows, setRows] = React.useState({});
+      const [nonce, setNonce] = React.useState(0);
+      const [pmState, setPmState] = React.useState(null);
+
+      React.useEffect(() => {
+        let cancelled = false;
+        let timer = null;
+        let tries = 0;
+
+        const describe = (err) => {
+          let r = null;
+          try { r = ctx && ctx.remote; } catch (e) { return "取 ctx.remote 抛错：" + String(e && e.message || e); }
+          if (!r) return "ctx.remote 为空" + (err ? "；" + String(err && err.message || err) : "");
+          let keys = [];
+          try { keys = Object.keys(r); } catch (e) { keys = ["<Object.keys 抛错:" + String(e && e.message || e) + ">"]; }
+          return "ctx.remote 的命名空间: [" + keys.join(", ") + "]" + (err ? "；取 pluginManager 抛错: " + String(err && err.message || err) : "");
+        };
+
+        const load = (pm) => {
+          setPmState(pm);
+          setState({ status: "loading", bundles: [], error: null });
+          setRows({});
+          Promise.resolve().then(() => pm.listBundles()).then((res) => {
+            if (cancelled) return;
+            if (res && res.ok === false) {
+              const e = res.error || {};
+              setState({ status: "error", bundles: [], error: String(e.message || e.code || "listBundles 失败") });
+              return;
+            }
+            const value = res && res.ok === true ? res.value : res;
+            setState({ status: "ready", bundles: Array.isArray(value) ? value : [], error: null });
+          }).catch((err) => {
+            if (cancelled) return;
+            setState({ status: "error", bundles: [], error: String((err && err.message) || err) });
+          });
+        };
+
+        const attempt = () => {
+          if (cancelled) return;
+          let pm = null;
+          let err = null;
+          try { pm = ctx && ctx.remote && ctx.remote.pluginManager; } catch (e) { err = e; }
+          if (pm) { load(pm); return; }
+          tries += 1;
+          if (tries < 12) { timer = setTimeout(attempt, 250); return; }
+          const why = describe(err);
+          setState({ status: "error", bundles: [], error: "拿不到 pluginManager。" + why });
+        };
+
+        setState({ status: "loading", bundles: [], error: null });
+        attempt();
+        return () => { cancelled = true; if (timer) clearTimeout(timer); };
+      }, [nonce]);
+
+      React.useEffect(() => {
+        if (state.status !== "ready" || !pmState) return undefined;
+        let cancelled = false;
+        const queue = state.bundles.filter((b) => b && b.installed && b.name && b.updatable && !b.official);
+        (async () => {
+          for (const b of queue) {
+            if (cancelled) return;
+            setRows((prev) => Object.assign({}, prev, { [b.name]: { status: "loading" } }));
+            let next;
+            try {
+              const res = await pmState.listVersions(b.name, {});
+              if (res && res.ok === false) {
+                const e = res.error || {};
+                next = { status: "error", error: String(e.message || e.code || "listVersions 失败") };
+              } else {
+                next = { status: "ready", list: (res && res.ok === true ? res.value : res) || null };
+              }
+            } catch (err) {
+              next = { status: "error", error: String((err && err.message) || err) };
+            }
+            if (cancelled) return;
+            setRows((prev) => Object.assign({}, prev, { [b.name]: next }));
+          }
+        })();
+        return () => { cancelled = true; };
+      }, [state.status, state.bundles, pmState]);
+
+      const installed = state.bundles.filter((b) => b && b.installed === true);
+      const checked = installed.filter((b) => rows[b.name] && rows[b.name].status === "ready" && rows[b.name].list && rows[b.name].list.status === "listed");
+      const newer = checked.filter((b) => (rows[b.name].list.versions || []).length > 0).length;
+      const failed = installed.filter((b) => rows[b.name] && rows[b.name].status === "error").length;
+      const pending = installed.filter((b) => b.updatable === true && b.official !== true && !rows[b.name]).length;
+      const header = h("div", { style: S.bar },
+        h("span", { style: { opacity: 0.45, fontSize: "11px" } }, "版本一览 v10"),
+        h("span", { style: S.muted },
+          state.status === "loading" ? "正在读取已安装组合包…" :
+          state.status === "error" ? "读取失败" :
+          ((newer > 0 ? newer + " 个可更新" : (pending > 0 ? "正在检查…" : "全部已是最新")) + (failed > 0 ? " · " + failed + " 个检查失败" : "") + " · 共 " + installed.length + " 个已安装")),
+        h("span", { style: { flex: "1 1 auto" } }),
+        h("button", { style: S.btn, onClick: () => setNonce(nonce + 1), disabled: state.status === "loading" }, "刷新")
+      );
+
+      if (state.status === "error") {
+        return h("div", { style: S.root }, header, h("div", { style: S.err }, state.error));
+      }
+      if (state.status === "loading") {
+        return h("div", { style: S.root }, header, h("div", { style: S.muted }, "加载中…"));
+      }
+      if (state.bundles.length === 0) {
+        return h("div", { style: S.root }, header, h("div", { style: S.muted }, "没有已安装的组合包。"));
+      }
+
+      const head = h("div", { style: Object.assign({}, S.row, S.head) },
+        h("span", null, "组合包"), h("span", null, "当前版本"), h("span", null, "最新版本"), h("span", null, "状态"));
+
+      const ordered = installed.slice().sort((a, b) => {
+        const ua = rows[a.name] && rows[a.name].list && (rows[a.name].list.versions || []).length > 0;
+        const ub = rows[b.name] && rows[b.name].list && (rows[b.name].list.versions || []).length > 0;
+        if (ua === ub) return String(a.name).localeCompare(String(b.name));
+        return ua ? -1 : 1;
+      });
+      const list = ordered.map((b) => {
+        const slot = rows[b.name] || null;
+        const canCheck = b.updatable === true && b.official !== true;
+        const canOpen = typeof openPackage === "function" && canCheck;
+        const listed = slot && slot.status === "ready" && slot.list && slot.list.status === "listed" ? slot.list : null;
+        const newest = listed && Array.isArray(listed.versions) && listed.versions.length > 0 ? listed.versions[0] : null;
+        let latestCell = "—";
+        let latestTitle = "";
+        let statusText = "";
+        let tone = null;
+        if (b.official === true) {
+          statusText = "随 DSH 更新";
+        } else if (b.updatable !== true) {
+          statusText = "无官方版本区块";
+          latestTitle = "这个包不是从 registry 安装的，官方不给版本区块";
+        } else if (!slot) {
+          statusText = "检查中…";
+          latestCell = "…";
+        } else if (slot.status === "error") {
+          statusText = "检查失败";
+          latestCell = String(slot.error || "未知错误").slice(0, 34);
+          latestTitle = String(slot.error || "未知错误");
+          tone = S.upd;
+        } else if (!listed) {
+          const pr = slot.list && slot.list.problem;
+          statusText = pr === "network" ? "网络不可达" : pr === "not-found" ? "注册表未找到" : pr === "not-updatable" ? "无可查版本" : "无法查询";
+          latestTitle = (slot.list && slot.list.reason) || "";
+        } else if (newest) {
+          statusText = "可更新到 " + newest.version;
+          latestCell = newest.version;
+          tone = S.upd;
+        } else {
+          statusText = "已是最新";
+        }
+        const badge = Object.assign({}, S.badge, tone || {});
+        return h("div", {
+          key: b.name,
+          style: Object.assign({}, S.row, canOpen ? S.click : {}),
+          title: (b.description || b.name) + (latestTitle ? " · " + latestTitle : ""),
+          onClick: canOpen ? () => { openPackage(b.name); scrollPluginPageToBottom(); } : undefined
+        },
+          h("span", { style: S.name }, b.name),
+          h("span", null, b.version || "—"),
+          h("span", { title: latestTitle || undefined }, latestCell),
+          h("span", null, h("span", { style: badge }, statusText))
+        );
+      });
+
+      const firstErr = installed.map((b) => rows[b.name]).filter((r) => r && r.status === "error")[0];
+      return h("div", { style: S.root },
+        header,
+        h("div", { style: S.table }, head, list),
+        h("div", { style: S.muted }, "点一行打开官方组合包页面；更新在官方的「版本」区块里完成。"),
+        firstErr ? h("div", { style: Object.assign({}, S.muted, { color: "#e06c75", whiteSpace: "pre-wrap" }) }, "首个错误原文：" + String(firstErr.error || "").slice(0, 300)) : null
+      );
+    }
+
+    return {
+      inject: ["slots", "remote", "remote.pluginManager"],
+      apply(ctx) {
+        ctx.slots.inject("plugins.tab", () => {
+          const off = ctx.slots.register({
+            name: "plugins.tab",
+            id: "dsh-plugin-versions",
+            order: 40,
+            label: () => "版本一览"
+          }, (ownerProps) => h(TabBoundary, null, h(VersionsTab, Object.assign({ ctx }, ownerProps || {}))));
+          return typeof off === "function" ? off : () => {};
+        });
+        ctx.slots.inject("plugins.detail.section", () => {
+          const off = ctx.slots.register({
+            name: "plugins.detail.section",
+            id: "dsh-plugin-versions-top",
+            order: 999
+          }, (ownerProps) => h(BackToTopSection, ownerProps || {}));
+          return typeof off === "function" ? off : () => {};
+        });
+      }
+    };
+  }
+});

package/cordis.patch.yml

@@ -0,0 +1,3 @@
+- insert:
+    - id: dsh-plugin-versions
+      name: 'dsh-plugin-versions'

package/icon.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" fill="none">
+  <rect x="8" y="10" width="48" height="44" rx="8" stroke="currentColor" stroke-width="3"/>
+  <path d="M18 24h18M18 32h12" stroke="currentColor" stroke-width="3" stroke-linecap="round"/>
+  <path d="M36 42l7-7 7 7" stroke="currentColor" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>

package/index.js

@@ -0,0 +1 @@
+export function apply() {}

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Plugin Versions",
+    "description": "List installed bundles with their versions and update status, and open the official update page."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "版本一览",
+    "description": "列出已安装组合包的版本与更新状态，点一行打开官方组合包页面。"
+  }
+}

package/package.json

@@ -1,6 +1,57 @@
 {
   "name": "dsh-plugin-versions",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "List installed DeepSeek Harness bundles with versions and update status, and jump straight to the official update page.",
+  "type": "module",
+  "main": "index.js",
+  "icon": "icon.svg",
+  "license": "MIT",
+  "author": "ACGNnsj",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ACGNnsj/dsh-plugin-versions.git"
+  },
+  "homepage": "https://github.com/ACGNnsj/dsh-plugin-versions#readme",
+  "bugs": {
+    "url": "https://github.com/ACGNnsj/dsh-plugin-versions/issues"
+  },
+  "keywords": [
+    "deepseek",
+    "harness",
+    "dsh",
+    "dsh-plugin",
+    "plugin-manager",
+    "versions",
+    "update"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": []
+    }
+  },
+  "exports": {
+    ".": "./index.js",
+    "./client": "./client.js",
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./icon.svg",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "LICENSE",
+    "index.js",
+    "client.js",
+    "cordis.patch.yml",
+    "locale",
+    "icon.svg",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}