dsh-m 0.2.12 → 0.2.14

package/docs/DESIGN.md

@@ -39,7 +39,7 @@
       "id": "dsh-skins",              // slug，唯一
       "name": "DSH Skins",
       "description": "中文描述",        // v1 只有中文
-      "category": "ui",               // market|tools|ui|search|media|other 六选一
+      "category": "ui",               // market|tools|ui|search|other 五选一
       "tags": ["主题"],
       "source": "github",             // npm|github
       "npm": "可选；source=npm 时必填",
@@ -59,6 +59,9 @@
 4. npm 条目可查；GitHub 条目 repo 存在；`icon`/`homepage` URL 可达（icon 允许为空）。
 自定义 registry 不经过官方 CI——设置页对自定义源展示未校验信任提示。
 
+### 2.4 收录文案（registry-copy-guide 定稿）
+`description`/`tags` 的写法另见 [`docs/registry-copy-guide.md`](./registry-copy-guide.md)：全条 ≤60 全角当量（对齐卡片收起态两行截断）、统一前置/依赖/兼容三种句式、依赖关系不入 tags。CI 对文案超限打软警告不阻断（§2.3 第 4 步之后追加）。
+
 ## 3. 安装 / 卸载 / 升级 / 重启
 
 底层原语（本机实证）：`dsh plugin --profile web add|remove|update`（转发 pnpm，作用于 `$DSH_HOME/profiles/web`）。**profile 的 `package.json` 就是唯一事实源**——不引入任何额外状态文件。

package/lib/client.js

@@ -604,6 +604,8 @@ var ZH = {
   "warn.unlink": "\u5378\u8F7D\u53EA\u79FB\u9664 profile \u5BF9\u672C\u5730\u76EE\u5F55\u7684\u5F15\u7528\uFF08{path}\uFF09\uFF0C\u4E0D\u4F1A\u5220\u9664\u76EE\u5F55\u672C\u8EAB\u3002",
   "warn.core": "\u8FD9\u662F file: \u5B89\u88C5\u7684\u6838\u5FC3/\u5F52\u6863\u5305\uFF0C\u5378\u8F7D\u53EF\u80FD\u5F71\u54CD DSH \u529F\u80FD\uFF0C\u4E14\u9700\u8981\u624B\u52A8\u6062\u590D\u3002",
   "profile.hint": "web profile\uFF1A{path}",
+  "dsh.chip.copyhint": "\u70B9\u51FB\u590D\u5236\u7248\u672C\u53F7",
+  "dsh.chip.copied": "\u5DF2\u590D\u5236 \u2713",
   "title.panel": "\u63D2\u4EF6\u5E02\u573A",
   "title.full": "DeepSeek Harness \u63D2\u4EF6\u5E02\u573A"
 };
@@ -770,6 +772,8 @@ var EN = {
   "warn.unlink": "Uninstalling only removes the profile's reference to the local directory ({path}); the directory itself is kept.",
   "warn.core": "This is a core/archive package installed via file:. Uninstalling may affect DSH features and requires manual restore.",
   "profile.hint": "web profile: {path}",
+  "dsh.chip.copyhint": "Click to copy version",
+  "dsh.chip.copied": "Copied \u2713",
   "title.panel": "Plugin Marketplace",
   "title.full": "DeepSeek Harness Plugin Marketplace"
 };
@@ -885,6 +889,14 @@ var CSS = `
 [data-slot="sidebar.footer.action"]{display:flex!important;flex-direction:column;width:100%;min-width:0}
 [data-slot="sidebar.footer.action"]>*{flex:none;min-width:0}
 .dshm-empty{text-align:center;color:var(--dsw-alias-label-caption,#6b7280);font-size:13px;padding:32px 0}
+/* \u5934\u90E8 DSH \u7248\u672C chip\uFF1A\u7B49\u5BBD\u5C0F\u5B57\u5706\u89D2\uFF0Chover \u5C55\u5F00\u8BE6\u60C5\uFF0C\u70B9\u51FB\u590D\u5236\uFF082026-09-14 \u5B9A\u7A3F\uFF09 */
+.dshm-dshchip{position:relative;display:inline-flex;align-items:center;gap:4px;border:1px solid var(--dsw-alias-border-l2,#e5e7eb);background:var(--dsw-alias-bg-layer-1,#f5f6f8);color:var(--dsw-alias-label-secondary,#4b5563);border-radius:999px;padding:4px 10px;font:11px/1 ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;cursor:pointer;white-space:nowrap;flex:none}
+.dshm-dshchip:hover{background:var(--dsw-alias-interactive-bg-hover,rgba(38,49,72,.06));color:var(--dsw-alias-label-primary,inherit)}
+.dshm-dshchip-v{font-weight:600;color:var(--dsw-alias-label-primary,inherit)}
+.dshm-dshchip-tip{position:absolute;top:calc(100% + 7px);right:0;visibility:hidden;opacity:0;transition:opacity .12s;z-index:60;background:var(--dsw-alias-bg-overlay,#fff);border:1px solid var(--dsw-alias-border-l2,#e5e7eb);border-radius:9px;box-shadow:var(--dsw-shadow-lv1,0 2px 8px rgb(20 24 32 / 8%));padding:7px 10px;text-align:left;pointer-events:none}
+.dshm-dshchip:hover .dshm-dshchip-tip,.dshm-dshchip:focus-visible .dshm-dshchip-tip{visibility:visible;opacity:1}
+.dshm-dshchip-tiprow{font:12px/16px ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;font-weight:600;color:var(--dsw-alias-label-primary,inherit)}
+.dshm-dshchip-tipsub{display:block;margin-top:2px;font-size:10px;line-height:14px;color:var(--dsw-alias-label-caption,#9ca3af)}
 `;
 function ensureCss() {
   if (typeof document === "undefined" || document.getElementById("dshm-css")) return;
@@ -1646,10 +1658,44 @@ var TABS = [
   ["installed", "tab.installed", "installed"],
   ["settings", "tab.settings", null]
 ];
+function DshVersionChip({ version }) {
+  const [copied, setCopied] = useState(false);
+  const copy = async () => {
+    try {
+      await navigator.clipboard.writeText(version);
+      setCopied(true);
+      setTimeout(() => setCopied(false), 1600);
+    } catch {
+    }
+  };
+  return h(
+    "button",
+    { type: "button", className: "dshm-dshchip", onClick: copy, "aria-label": `DSH ${version}` },
+    "DSH ",
+    h("span", { className: "dshm-dshchip-v" }, version),
+    h(
+      "span",
+      { className: "dshm-dshchip-tip", role: "tooltip" },
+      h("span", { className: "dshm-dshchip-tiprow" }, `DSH ${version}`),
+      h("span", { className: "dshm-dshchip-tipsub" }, lookup(copied ? "dsh.chip.copied" : "dsh.chip.copyhint"))
+    )
+  );
+}
 function MarketPanel({ onClose }) {
   const [tab, setTab] = useState("market");
   const market = useMarketData();
   const installed = useAsync(() => api("installed"), []);
+  const [dshVersion, setDshVersion] = useState(null);
+  useEffect(() => {
+    let live = true;
+    api("ping").then((r) => {
+      if (live) setDshVersion(typeof r?.dshVersion === "string" && r.dshVersion ? r.dshVersion : null);
+    }).catch(() => {
+    });
+    return () => {
+      live = false;
+    };
+  }, []);
   const refreshViews = useCallback(
     () => refreshAfterMutation2({ marketReload: market.reload, installedReload: installed.reload }),
     [market.reload, installed.reload]
@@ -1707,6 +1753,7 @@ function MarketPanel({ onClose }) {
           )
         ),
         h("span", { className: "dshm-spacer" }),
+        dshVersion ? h(DshVersionChip, { version: dshVersion }) : null,
         h("button", { className: "dshm-btn", onClick: onClose }, lookup("common.close"))
       ),
       h(

package/lib/core/dsh-version.js

@@ -0,0 +1,103 @@
+/**
+ * DSH 运行版本解析（市场面板头部 chip 数据源，2026-09-14 设计定稿）。
+ *
+ * 通路（查证结论，三条免费路径已证伪）：生产 host 内 dshArgv() 以 process.argv[1]
+ * 定位 launcher entry（…/@deepseek-ai/dsh/lib/bin.js，restart.ts 拉起重启即复用同一
+ * 定位），从 entry 向上至多三级找 package.json 读 version——官方 bin.js 的 readVersion
+ * 同款做法。CLI/PATH 模式或读取失败回退 spawn `dsh --version`（短超时）。
+ *
+ * 结果进程内缓存（版本随进程恒定）；两级皆失败返回 null，客户端据此隐藏 chip。
+ * 注意：`window.__DSH_BOOT__` 只有内容哈希 rev 无 semver；settings.yaml 无版本键；
+ * .pnpm 目录名多版本残留无判据——均不走。
+ */
+import { dirname, join } from 'node:path';
+import { readFileSync } from 'node:fs';
+import { spawn } from 'node:child_process';
+import { dshArgv } from './dsh-cli.js';
+/** 从 `dsh --version` 输出提取 semver：容忍 v 前缀与前后散文，取首个命中。 */
+export function parseDshVersionOutput(text) {
+    const m = /\bv?([0-9]+\.[0-9]+\.[0-9]+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?)/.exec(text ?? '');
+    return m ? m[1] : null;
+}
+/**
+ * 生产通路：launcher entry 定位 + 就近向上找 package.json。
+ * 纯同步、无 spawn；任何一步失败返回 null（不抛）。
+ */
+export function readLauncherPackageVersion(input = {}) {
+    try {
+        const argv = dshArgv(input);
+        const entry = argv.args.length > 0 ? argv.args[argv.args.length - 1] : undefined;
+        // 与 dshArgv 同一判定：entry 必须长得像 launcher bin，否则是 CLI/PATH 模式
+        if (!entry || !/[\\/](?:bin\.(?:js|ts)|dsh)$/.test(entry))
+            return null;
+        let dir = dirname(entry);
+        for (let up = 0; up < 3; up++) {
+            try {
+                const pkg = JSON.parse(readFileSync(join(dir, 'package.json'), 'utf8'));
+                if (typeof pkg?.version === 'string' && pkg.version)
+                    return pkg.version;
+            }
+            catch {
+                /* 该级无 package.json / 不可读，继续向上一级 */
+            }
+            dir = dirname(dir);
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+function spawnDshVersion(timeoutMs) {
+    return new Promise((resolveP) => {
+        let settled = false;
+        const done = (v) => {
+            if (!settled) {
+                settled = true;
+                resolveP(v);
+            }
+        };
+        let child;
+        try {
+            child = spawn('dsh', ['--version'], { stdio: ['ignore', 'pipe', 'ignore'], shell: process.platform === 'win32' });
+        }
+        catch {
+            done(null);
+            return;
+        }
+        let out = '';
+        const timer = setTimeout(() => {
+            try {
+                child.kill('SIGKILL');
+            }
+            catch {
+                /* already dead */
+            }
+            done(null);
+        }, timeoutMs);
+        child.stdout?.on('data', (d) => {
+            out += String(d);
+        });
+        child.on('error', () => {
+            clearTimeout(timer);
+            done(null);
+        });
+        child.on('close', () => {
+            clearTimeout(timer);
+            done(parseDshVersionOutput(out));
+        });
+    });
+}
+let cache = null;
+/** 进程内缓存的一次性解析；null = 两级皆失败（调用方按「未知」处理）。 */
+export function resolveDshVersion(opts = {}) {
+    if (!cache) {
+        const direct = readLauncherPackageVersion();
+        cache = direct != null ? Promise.resolve(direct) : spawnDshVersion(opts.fallbackTimeoutMs ?? 3_000);
+    }
+    return cache;
+}
+/** 仅测试：清空进程内缓存。 */
+export function resetDshVersionCacheForTest() {
+    cache = null;
+}

package/lib/core/host-api.js

@@ -7,6 +7,7 @@
  * trustedRestartRequest host-equivalence guard → typed method/业务错误映射 → 其他 500。
  */
 import { BOOT_ID, publicInstallStatus } from './dsh-cli.js';
+import { resolveDshVersion } from './dsh-version.js';
 import { listInstalledWithMeta, listMarket, installFromRegistry, uninstallPlugin, upgradePlugin, } from './market.js';
 import { runProfileTransaction, TransactionError, makeNpmWarmPackument } from './profile-transaction.js';
 import { readInstalledPluginReadme } from './installed.js';
@@ -162,8 +163,13 @@ export function createApiDispatcher(ctx) {
         npmLatest: ctx.deps?.npmLatest ?? npmLatest,
         runTransaction: ctx.deps?.runTransaction ?? runProfileTransaction,
         scheduleRestart: ctx.deps?.scheduleRestart ?? scheduleRestart,
+        resolveDshVersion: ctx.deps?.resolveDshVersion ?? resolveDshVersion,
     };
     const cfg = () => ctx.controller.config;
+    // DSH 版本一次性解析，dispatcher 创建即预热（首个 ping 不吃 spawn 回退的延迟）
+    const dshVersionP = Promise.resolve()
+        .then(() => d.resolveDshVersion())
+        .catch(() => null);
     return async function handleApi(req, res) {
         const abort = new AbortController();
         res.once('close', () => abort.abort());
@@ -173,7 +179,14 @@ export function createApiDispatcher(ctx) {
             let payload;
             switch (method) {
                 case 'ping':
-                    payload = { plugin: ctx.pkg.name, version: ctx.pkg.version, node: process.version, boot: BOOT_ID };
+                    payload = {
+                        plugin: ctx.pkg.name,
+                        version: ctx.pkg.version,
+                        node: process.version,
+                        boot: BOOT_ID,
+                        // DSH 运行版本（头部 chip 数据源）；解析失败 → undefined → JSON 序列化时字段缺席
+                        dshVersion: (await dshVersionP) ?? undefined,
+                    };
                     break;
                 case 'self-check': {
                     try {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-m",
-  "version": "0.2.12",
-  "description": "DSH Marketplace — 个人自用的 DeepSeek Harness 插件市场：收录、安装、卸载、升级 DSH 插件",
+  "version": "0.2.14",
+  "description": "可自定义收录清单的 DSH 插件市场：收录、安装、卸载、升级一站完成，附 agent 工具与 dshm CLI。",
   "license": "MIT",
   "type": "module",
   "main": "lib/host.js",

package/registry.json

@@ -4,7 +4,7 @@
     {
       "id": "dsh-m",
       "name": "DSH Marketplace",
-      "description": "可自定义 Registry 内容的 DeepSeek Harness 插件市场：收录、安装、卸载、升级 DSH 插件，一站搞定。",
+      "description": "可自定义收录清单的 DSH 插件市场：收录、安装、卸载、升级一站完成，附 agent 工具与 dshm CLI。",
       "category": "market",
       "tags": ["市场", "插件管理"],
       "source": "npm",
@@ -15,9 +15,9 @@
     {
       "id": "dsh-skins",
       "name": "DSH Skins",
-      "description": "DeepSeek Harness Web 界面主题/皮肤管理插件，可切换多种视觉风格。",
+      "description": "DSH Web 皮肤插件：多套品牌皮肤侧栏热切换，一键回到官方界面。",
       "category": "ui",
-      "tags": ["主题", "美化"],
+      "tags": ["皮肤", "主题", "美化"],
       "source": "npm",
       "npm": "@iasiv5/dsh-skins",
       "github": "iasiv5/dsh-skins",
@@ -26,7 +26,7 @@
     {
       "id": "dsh-copilot-auth",
       "name": "DSH Copilot Auth",
-      "description": "为 DSH 内置 GitHub Copilot 提供方补上设备码（device flow）登录/注销设置页，并预置开箱即用的 Copilot 路由；凭据托管 DSH 内置凭据库，模型目录自动同步。",
+      "description": "为内置 Copilot 提供方补设备码登录/注销设置页，预置开箱路由；凭据入内置凭据库，模型目录兜底不覆盖定制。",
       "category": "tools",
       "tags": ["Copilot", "认证", "模型接入"],
       "source": "npm",
@@ -37,7 +37,7 @@
     {
       "id": "dsh-skip-browser-auth",
       "name": "DSH Skip Browser Auth",
-      "description": "在已适配版本上替换官方 Connection 提供方，跳过 BrowserAuth，不再需要输入烦人的Token。（当前已适配：0.1.2-rc.1）",
+      "description": "替换官方 Connection 提供方跳过 BrowserAuth，免输 Token；已适配 0.1.2-rc.1 与 0.1.5-rc.1/rc.2，详见仓库。",
       "category": "tools",
       "tags": ["BrowserAuth", "连接", "安全"],
       "source": "npm",
@@ -45,10 +45,21 @@
       "github": "iasiv5/dsh-skip-browser-auth",
       "homepage": "https://github.com/iasiv5/dsh-skip-browser-auth"
     },
+    {
+      "id": "dsh-surf",
+      "name": "DSH Surf",
+      "description": "网络冲浪入口：设置一级菜单一键打开自托管 Selkies/Chrome 远程桌面，视频流直连；需自建容器并挂认证反代。",
+      "category": "tools",
+      "tags": ["浏览器", "远程桌面", "Selkies", "网络冲浪"],
+      "source": "npm",
+      "npm": "@iasiv5/dsh-surf",
+      "github": "iasiv5/dsh-surf",
+      "homepage": "https://github.com/iasiv5/dsh-surf"
+    },
     {
       "id": "dsh-better-sidebar",
       "name": "DSH Better Sidebar",
-      "description": "开放的侧边栏底座，支持三方拓展注册新侧边栏页面。内置文件渲染编辑/终端/侧边对话/Git/子代理页面。",
+      "description": "开放的侧边栏底座，支持三方拓展注册侧边栏页面；内置文件编辑、终端、侧边对话、Git 与子代理页。",
       "category": "ui",
       "tags": ["侧边栏", "文件编辑", "终端", "Git"],
       "source": "npm",
@@ -70,9 +81,9 @@
     {
       "id": "dsh-docs-panel",
       "name": "DSH Docs Panel",
-      "description": "DSH 侧边栏里的「全局文档」：全局 Markdown 笔记，任何工作区随时可读，支持大纲跳转与一键转编辑器。（需先安装 dsh-better-sidebar ≥0.4.0）",
+      "description": "侧边栏「全局文档」：全局 Markdown 笔记任何工作区可读，支持大纲跳转与一键转编辑器；需 better-sidebar ≥0.4.0。",
       "category": "ui",
-      "tags": ["文档", "Markdown", "侧边栏", "需 better-sidebar"],
+      "tags": ["文档", "Markdown", "侧边栏"],
       "source": "npm",
       "npm": "dsh-docs-panel",
       "github": "mlosun/dsh-docs-panel",
@@ -81,9 +92,9 @@
     {
       "id": "dsh-server-deck",
       "name": "DSH Server Deck",
-      "description": "服务器卡片仪表盘：实时状态/CPU/内存/磁盘 + 趋势记录与可视化（1h/24h/7d/30d），点卡片进入 xterm 交互终端。可选集成 dsh-better-sidebar：装后注册为侧边栏「服务器」页签，装载顺序无关。",
+      "description": "服务器卡片仪表盘：实时 CPU/内存/磁盘与趋势图（1h~30d），点卡片进 xterm 终端；可选集成 better-sidebar。",
       "category": "tools",
-      "tags": ["服务器", "监控", "终端", "推荐 better-sidebar"],
+      "tags": ["服务器", "监控", "终端", "趋势图"],
       "source": "npm",
       "npm": "dsh-server-deck",
       "github": "meyaomiao/dsh-server-deck",
@@ -92,9 +103,9 @@
     {
       "id": "dsh-flowglass",
       "name": "DSH Flowglass",
-      "description": "流镜：实时会话流程图插件，把当前会话画成三列泳道，展示工具调用、并行分组与子代理分支，支持逐层钻取。可选集成 dsh-better-sidebar：装后注册为按会话隔离的侧边栏 Tab。",
+      "description": "流镜：把当前会话画成三列泳道流程图，展示工具调用、并行分组与子代理分支；可选集成 better-sidebar。",
       "category": "ui",
-      "tags": ["可视化", "流程图", "会话", "推荐 better-sidebar"],
+      "tags": ["可视化", "流程图", "会话"],
       "source": "npm",
       "npm": "dsh-flowglass",
       "github": "Iwctwbh/dsh-flowglass",
@@ -103,7 +114,7 @@
     {
       "id": "dsh-auth",
       "name": "DSH Auth",
-      "description": "DSH Web 管理员认证插件：Argon2id 口令、可撤销会话、双语界面，经 Caddy forward_auth 边缘保护页面/API/下载/SSE/WebSocket，Harness 保持仅回环监听。",
+      "description": "DSH Web 管理员认证：Argon2id 口令与可撤销会话，经 Caddy forward_auth 保护页面、API、下载、SSE 与 WebSocket。",
       "category": "tools",
       "tags": ["认证", "安全"],
       "source": "npm",
@@ -114,7 +125,7 @@
     {
       "id": "deepseek-harness-lark",
       "name": "DeepSeek Harness Lark",
-      "description": "飞书 / Lark 文本与图片通道插件：把飞书消息桥接进 DeepSeek Harness 对话。",
+      "description": "飞书 / Lark 通道插件：把飞书消息桥接进 DeepSeek Harness 对话，支持文本与图片收发。",
       "category": "other",
       "tags": ["飞书", "Lark", "通道"],
       "source": "npm",
@@ -125,7 +136,7 @@
     {
       "id": "deepseek-harness-qqbot",
       "name": "DeepSeek Harness QQBot",
-      "description": "QQ Bot 文本与图片通道插件：把 QQ 机器人消息桥接进 DeepSeek Harness 对话。",
+      "description": "QQ Bot 通道插件：把 QQ 机器人消息桥接进 DeepSeek Harness 对话，支持文本与图片收发。",
       "category": "other",
       "tags": ["QQ", "通道"],
       "source": "npm",
@@ -147,7 +158,7 @@
     {
       "id": "deepseek-harness-wecom",
       "name": "DeepSeek Harness WeCom",
-      "description": "企业微信 AI Bot 文本与图片通道桥，桥接进 DeepSeek Harness 对话。",
+      "description": "企业微信 AI Bot 通道插件：把企业微信消息桥接进 DeepSeek Harness 对话，支持文本与图片收发。",
       "category": "other",
       "tags": ["企业微信", "通道"],
       "source": "npm",
@@ -158,7 +169,7 @@
     {
       "id": "deepseek-harness-dingtalk",
       "name": "DeepSeek Harness DingTalk",
-      "description": "钉钉 Stream 文本与图片通道插件，桥接进 DeepSeek Harness 对话。",
+      "description": "钉钉 Stream 通道插件：把钉钉消息桥接进 DeepSeek Harness 对话，支持文本与图片收发。",
       "category": "other",
       "tags": ["钉钉", "通道"],
       "source": "npm",