dsh-m 0.2.11 → 0.2.13

package/README.en.md

@@ -40,7 +40,7 @@ The default registry includes DSH Skins, ModSearch, the Lark / QQ / Weixin / WeC
 | **Installed** | What your web profile actually has, annotated "via market / non-market"; update badges, upgrade, two-step confirm uninstall; 📖 README preview (64KB cap) |
 | **Settings** | Registry address draft with "Validate & apply / Restore default / Download default registry.json / Check entries reachability"; configured vs active address and status at a glance; force refresh; dsh-m self-update |
 
-After any mutation a "⚡ Restart" banner appears — under systemd, the DSH launcher's `appExit` hook hands the restart back to a unit configured with `Restart=on-failure` or `Restart=always`, avoiding a `systemctl` helper inside the unit cgroup that is about to stop; if `appExit` is unavailable, the fallback uses a manager-owned transient `systemd-run` service and only then a detached helper. The client confirms the replacement by boot id and dismisses the banner, leaving DSH Web's own background connection recovery in control; it does not force a full-page reload during the auth/route handoff. The current DSH Web `0.1.5-rc.1` runtime has now live-loaded dsh-m `0.2.11`; `/dshm` ping returned version `0.2.11`, and an authenticated page request completed `303 → 200`. The reported 404 was not reproducible once the service stabilized; journal evidence showed repeated `status=75/TEMPFAIL` restarts during the incident. Live DSH `0.1.2-rc.1`, transient-fallback, and repeated install/uninstall E2E experiments remain pre-release gaps. Installs stream live pnpm progress (resolve → download → link → build).
+After any mutation, the already-open Market and Installed views refresh the profile state together, keeping badges and cards in sync without closing and reopening the marketplace; a "⚡ Restart" banner appears — under systemd, the DSH launcher's `appExit` hook hands the restart back to a unit configured with `Restart=on-failure` or `Restart=always`, avoiding a `systemctl` helper inside the unit cgroup that is about to stop; if `appExit` is unavailable, the fallback uses a manager-owned transient `systemd-run` service and only then a detached helper. The client confirms the replacement by boot id and dismisses the banner, leaving DSH Web's own background connection recovery in control; it does not force a full-page reload during the auth/route handoff. The current DSH Web `0.1.5-rc.1` runtime has now live-loaded dsh-m `0.2.11`; `/dshm` ping returned version `0.2.11`, and an authenticated page request completed `303 → 200`. The reported 404 was not reproducible once the service stabilized; journal evidence showed repeated `status=75/TEMPFAIL` restarts during the incident. Live DSH `0.1.2-rc.1`, transient-fallback, and repeated install/uninstall E2E experiments remain pre-release gaps. Installs stream live pnpm progress (resolve → download → link → build).
 
 ## Agent tools (7)
 

package/README.md

@@ -40,7 +40,7 @@
 | **已装** | web profile 实装列表，标注「市场安装 / 非市场安装」；可升级徽标、升级、两段式确认卸载；📖 README 预览（64KB 截断） |
 | **设置** | registry 地址草稿 +「校验并应用 / 恢复默认 / 下载默认 registry.json / 检查条目可达性」；配置地址、生效来源与状态一目了然；强制刷新；dsh-m 自更新 |
 
-安装 / 卸载 / 升级完成后出现「⚡ 一键重启」横幅——受 systemd 管理时通过 DSH launcher 的 `appExit` 交给服务的 `Restart` 策略，避免在待停止 unit 的 cgroup 内启动 `systemctl` helper；无 `appExit` 的 systemd 兜底改用 manager-owned transient `systemd-run`，最后才退回 detached-helper。客户端按 boot id 确认新进程已恢复后关闭横幅，交由 DSH Web 自身的后台连接重试恢复页面，不强制整页刷新，避免认证/路由切换期间白屏。已完成当前 DSH Web `0.1.5-rc.1` 运行时的 live 核验：web profile 已加载 dsh-m `0.2.11`，重启后 `/dshm` ping 返回 `version: 0.2.11`，携带当前认证 token 的页面请求流程为 `303 → 200`；无认证请求会被拒绝。此次白屏截图对应的 404 在服务稳定后未复现；journal 显示截图时段发生多次 `status=75/TEMPFAIL` 重启，当前暂判定为重启/认证过渡窗口现象，未发现 dsh-m Host 路由崩溃。DSH `0.1.2-rc.1` live E2E、transient fallback live E2E，以及连续安装/卸载实验仍是正式发布前的验证 gap。安装过程实时显示 pnpm 进度（解析 → 下载 → 链接 → 构建）。
+安装 / 卸载 / 升级完成后，当前已打开的市场页与已装页会一起重新读取 profile 状态并同步徽标/卡片，不需要关闭后重新打开插件市场；随后出现「⚡ 一键重启」横幅——受 systemd 管理时通过 DSH launcher 的 `appExit` 交给服务的 `Restart` 策略，避免在待停止 unit 的 cgroup 内启动 `systemctl` helper；无 `appExit` 的 systemd 兜底改用 manager-owned transient `systemd-run`，最后才退回 detached-helper。客户端按 boot id 确认新进程已恢复后关闭横幅，交由 DSH Web 自身的后台连接重试恢复页面，不强制整页刷新，避免认证/路由切换期间白屏。已完成当前 DSH Web `0.1.5-rc.1` 运行时的 live 核验：web profile 已加载 dsh-m `0.2.11`，重启后 `/dshm` ping 返回 `version: 0.2.11`，携带当前认证 token 的页面请求流程为 `303 → 200`；无认证请求会被拒绝。此次白屏截图对应的 404 在服务稳定后未复现；journal 显示截图时段发生多次 `status=75/TEMPFAIL` 重启，当前暂判定为重启/认证过渡窗口现象，未发现 dsh-m Host 路由崩溃。DSH `0.1.2-rc.1` live E2E、transient fallback live E2E，以及连续安装/卸载实验仍是正式发布前的验证 gap。安装过程实时显示 pnpm 进度（解析 → 下载 → 链接 → 构建）。
 
 ## Agent 工具（7 个）
 

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` 就是唯一事实源**——不引入任何额外状态文件。
@@ -95,7 +98,7 @@ npm 安装 / GitHub 安装 / 升级 / 自升级 / 卸载是**同一个事务模
 
 3 个视图，卡片展开式详情（不做独立详情页），**中文优先**，跟随 DSH Web 深色主题：
 
-1. **市场页**（默认）：registry 卡片流；搜索/分类为**服务端过滤**（Host 强制 `withLatest=true`、每页 50、1,000 条清单第一页只探测当前页）；`MarketPanel` 是市场/已装数据唯一 owner（请求 generation + AbortController 丢弃旧响应）；分页控件 + 超过 200 条性能提示 + 默认/自定义/缓存/不可用短提示（不含本地路径）；卡片详情保留 README markdown 预览与 npm/GitHub 官方外链。
+1. **市场页**（默认）：registry 卡片流；搜索/分类为**服务端过滤**（Host 强制 `withLatest=true`、每页 50、1,000 条清单第一页只探测当前页）；`MarketPanel` 是市场/已装数据唯一 owner（请求 generation + AbortController 丢弃旧响应）；安装/卸载/升级完成后通过统一协调器同时刷新市场与已装快照，不要求关闭并重新打开面板；分页控件 + 超过 200 条性能提示 + 默认/自定义/缓存/不可用短提示（不含本地路径）；卡片详情保留 README markdown 预览与 npm/GitHub 官方外链。
 2. **已装页**：profile 实际安装列表，标注来源（市场/非市场/未知）；registry 不可用时仍列出已装并标记；「可升级 → x.y.z」徽标 +「升级」；「卸载」。
 3. **设置页**：registry 地址草稿 +「校验并应用」（先校验候选再写 settings，失败不落盘）/「恢复默认」/「下载默认 registry.json」（不改当前配置）/「检查条目可达性」（probe 统计 + 最多 100 条 issue，只读不改配置）；同时展示配置地址、当前生效配置、生效来源与 configStatus（含 rejected/回滚原因与维护性 warnings）；完整本地路径仅在此页显示。registry 配置为 **live 生效，不出现安装类重启横幅**；安装/卸载/升级仍保留重启横幅。
 

package/lib/client.js

@@ -410,6 +410,23 @@ var init_restart_wait = __esm({
   }
 });
 
+// src/client/view-refresh.js
+var view_refresh_exports = {};
+__export(view_refresh_exports, {
+  refreshAfterMutation: () => refreshAfterMutation
+});
+async function refreshAfterMutation({ marketReload, installedReload }) {
+  await Promise.all([
+    marketReload(false),
+    installedReload()
+  ]);
+}
+var init_view_refresh = __esm({
+  "src/client/view-refresh.js"() {
+    "use strict";
+  }
+});
+
 // src/client/main.jsx
 var React = require("react");
 var rd = require("react-dom");
@@ -423,6 +440,7 @@ var { ExtLink, MdImg, renderMarkdown } = createMarkdown2(h);
 var { installedViewModel: installedViewModel2, registrySourceKey: registrySourceKey2 } = (init_installed_view(), __toCommonJS(installed_view_exports));
 var { pickPayload: pickPayload2, parseToolArgs: parseToolArgs2 } = (init_tool_view(), __toCommonJS(tool_view_exports));
 var { RESTART_POLL_MS: RESTART_POLL_MS2, RESTART_DEADLINE_MS: RESTART_DEADLINE_MS2, nextRestartWait: nextRestartWait2, isAmbiguousRestartRequestError: isAmbiguousRestartRequestError2 } = (init_restart_wait(), __toCommonJS(restart_wait_exports));
+var { refreshAfterMutation: refreshAfterMutation2 } = (init_view_refresh(), __toCommonJS(view_refresh_exports));
 var ZH = {
   "market.title": "\u63D2\u4EF6\u5E02\u573A",
   "tab.market": "\u5E02\u573A",
@@ -1056,7 +1074,7 @@ function RestartBanner({ note, onDone }) {
     phase === "idle" && !err ? h("button", { className: "dshm-btn sm", onClick: () => onDone(false) }, lookup("common.later")) : null
   );
 }
-function MarketTab({ notify, market }) {
+function MarketTab({ notify, market, onMutation }) {
   const { data, loading, error, reload, query, updateQuery } = market;
   const [openId, setOpenId] = useState(null);
   const [busyId, setBusyId] = useState(null);
@@ -1084,7 +1102,7 @@ function MarketTab({ notify, market }) {
         needsRestart: true,
         text: lookup("notify.installed", { pkg: res.pkg, version: res.version ? ` v${res.version}` : "" }) + (res.usedAllowAllBuilds ? lookup("notify.allowbuilds") : "")
       });
-      await reload(false);
+      await (onMutation ? onMutation() : reload(false));
     } catch (e) {
       notify({ kind: "err", text: lookup("failed.install", { err: e && e.message || e }) });
     } finally {
@@ -1242,7 +1260,7 @@ function ReadmeBlock({ pkg }) {
     state.truncated ? h("div", { className: "dshm-md-note" }, lookup("readme.truncated")) : null
   );
 }
-function InstalledTab({ notify, installed }) {
+function InstalledTab({ notify, installed, onMutation }) {
   const { loading, data, error, reload } = installed;
   const [openPkg, setOpenPkg] = useState(null);
   const [readmePkg, setReadmePkg] = useState(null);
@@ -1256,7 +1274,7 @@ function InstalledTab({ notify, installed }) {
         needsRestart: true,
         text: lookup("notify.uninstalled", { pkg: res.pkg }) + (res.liveDisabled ? lookup("notify.livedisabled") : "") + (res.leftovers && res.leftovers.length ? lookup("notify.leftovers", { paths: res.leftovers.join(", ") }) : "")
       });
-      await reload();
+      await (onMutation ? onMutation() : reload());
     } catch (e) {
       notify({ kind: "err", text: lookup("failed.uninstall", { err: e && e.message || e }) });
     } finally {
@@ -1276,7 +1294,7 @@ function InstalledTab({ notify, installed }) {
           to: res.version ? `v${res.version}` : res.sha ? res.sha.slice(0, 7) : "latest"
         }) + (res.usedAllowAllBuilds ? lookup("notify.upgradehint") : "")
       });
-      await reload();
+      await (onMutation ? onMutation() : reload());
     } catch (e) {
       notify({ kind: "err", text: lookup("failed.upgrade", { err: e && e.message || e }) });
     } finally {
@@ -1632,10 +1650,11 @@ function MarketPanel({ onClose }) {
   const [tab, setTab] = useState("market");
   const market = useMarketData();
   const installed = useAsync(() => api("installed"), []);
-  const onRegistryChanged = useCallback(async () => {
-    await market.reload(false);
-    await installed.reload().catch(() => void 0);
-  }, [market, installed]);
+  const refreshViews = useCallback(
+    () => refreshAfterMutation2({ marketReload: market.reload, installedReload: installed.reload }),
+    [market.reload, installed.reload]
+  );
+  const onRegistryChanged = refreshViews;
   const counts = {
     market: market.data ? market.data.total : null,
     installed: installed.data ? installed.data.items.length : null
@@ -1693,8 +1712,8 @@ function MarketPanel({ onClose }) {
       h(
         "div",
         { className: "dshm-body" },
-        tab === "market" ? h(MarketTab, { notify, market }) : null,
-        tab === "installed" ? h(InstalledTab, { notify, installed }) : null,
+        tab === "market" ? h(MarketTab, { notify, market, onMutation: refreshViews }) : null,
+        tab === "installed" ? h(InstalledTab, { notify, installed, onMutation: refreshViews }) : null,
         tab === "settings" ? h(SettingsTab, { notify, onRegistryChanged }) : null
       ),
       toast ? h(

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-m",
-  "version": "0.2.11",
-  "description": "DSH Marketplace — 个人自用的 DeepSeek Harness 插件市场：收录、安装、卸载、升级 DSH 插件",
+  "version": "0.2.13",
+  "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",