dsh-plugin-labels 0.0.0-stage → 0.8.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 qyy2005
+
+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,177 @@
-# Temporary Holding Version
-
-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.
+# dsh-plugin-labels
+
+[![CI](https://github.com/qyy2005/dsh-plugin-labels/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/qyy2005/dsh-plugin-labels/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+给 DSH（DeepSeek Harness）**已安装插件**配「中文名 + 一句话说明」：官方「插件」页的已安装插件行、插件包卡片与详情页都会**原地显示中文名与中文描述**（由 host 覆盖显示元数据）；新装插件会在启动后自动翻译。**本插件没有任何 UI 入口**（没有 tab、没有设置项），管理通过 loopback HTTP API 或让 AI 代改。
+
+- 当前版本：**0.8.0**（本仓库即源码目录；通过 `plugin_manager install_bundle` 从 GitHub 或 npm 安装到 DSH profile）
+- 只支持 DSH 桌面版 Web GUI（开发验证版本 0.2.1-rc.2）
+
+## 功能
+
+- **中文名 + 一句话说明**：每个插件一条中文名（≤10 字）和一句说明（≤80 字）；说明必须写清**怎么用**，不只是“是什么”（见下方「标签格式」）。
+- **官方页原地中文**：官方「插件」页的已安装插件行、点开的详情页，以及插件包卡片（`listBundles`）都会直接显示中文名与中文描述；未翻译的插件回退英文。默认开启。
+- **自动翻译新插件**：host 启动约 4 秒后自动补一次缺失标签（每次最多 20 条，只补空缺、不覆盖手改），不用点任何按钮；可用 `DSH_PLUGIN_LABELS_AUTO_TRANSLATE=0` 关闭。
+- **手改优先**：手动设置的标签不会被自动翻译覆盖；显式“重翻”才会覆盖。
+- **无 UI 管理入口**：通过 4 个 loopback HTTP API（见「使用」）或让 AI/脚本直接调用它们来翻译、手改、重翻、导入导出。
+- **导出 / 导入 API**：导出带 `source`（`ai` / `manual`）的 JSON，导入时保留来源，只接受已安装插件名（≤64KB）。
+- **缓存 v2**：标签缓存在 `<DSH_HOME>/plugin-labels.json`，UTF-8 无 BOM、原子写，旧 v1 数据可迁移读取。
+
+### 标签格式
+
+- **中文名**：≤10 个汉字，命名它“做什么”，不直译包名、不用营销词。
+- **一句话说明**：≤80 字，必须同时回答：①这插件解决什么问题；②在 DSH 里从哪里进入 / 怎么操作（例如：设置 → 某个分区、侧栏 → 某个页面、在对话里下指令、装好自动生效）；③必要时给一句可执行的第一步。
+- 模型无法从包名/描述判断入口时，会被要求写「**入口以界面为准**」并给出用户能做的第一步；**不会编造不存在的菜单或按钮**。
+
+## 界面
+
+官方「插件」页的已安装插件行、插件包卡片与详情页直接显示中文名与中文描述（v0.6.0+，v0.7.0 起补上包级卡片）：
+
+![官方插件页的中文名](https://raw.githubusercontent.com/qyy2005/dsh-plugin-labels/main/docs/official-page.png)
+
+v0.7.0 起插件**没有任何 UI 入口**：没有「中文名」tab，也没有设置项。中文名由 host 覆盖官方显示元数据实现，管理与编辑走 HTTP API（见「使用」）。
+
+## 官方插件页原地显示中文
+
+v0.6.0 起，host 半边会在运行时包装宿主内部的显示元数据，把标签缓存里的中文名与一句话说明作为 `{en, zh}` 覆盖到官方页面上。**这是纯显示层覆盖**：不改任何插件包文件，也不影响包身份、安装、更新与卸载；**默认开启**。v0.6.1 起改用 symbol 标记识别 wrapper（Cordis 的 `ctx.get` 返回 traceable Proxy、函数引用每次不同），修复了 `patched` 状态误判与重复包装；v0.7.0 起同时包装 `pluginManager.listBundles()`，让插件包卡片也显示中文。
+
+- **两处覆盖**：`pluginPackages.metaOf()`（官方「插件」页的已安装插件行 + 详情页标题/描述）和 `pluginManager.listBundles()`（插件包卡片，它本来直接读 `readPluginMeta`）。
+- **效果**：官方页面上的英文名原地显示为中文名，描述显示中文一句话；没有标签的插件回退英文（与原行为一致）。
+- **原理**：官方页面通过 `pluginPackages.metaOf(specifier, parentURL)` 读取每个包的显示元数据（它会读该包 `locale/*.json` 的 `meta`，缺省回退 `package.json` 的 name/description）；插件包卡片则由 `pluginManager.listBundles()` 直接 `readPluginMeta`。官方没有行级扩展点，所以这里在进程内包装这两个方法，用标签缓存补上 `title`/`description` 的 `{en, zh}` 语言映射，其余字段（如 `icon`、`error`）原样保留。
+- **失败安全**：拿不到服务、方法不是函数、赋值失败或读缓存失败时，全部静默 warn 并回退宿主原返回值；包装可被 disposer 恢复，也能在服务实例被替换（HMR/刷新）后重新包装。
+- **限制**：依赖 DSH 内部服务，DSH 升级后可能失效（失效时自动回退英文，插件其它功能不受影响）；仅影响显示，不影响包身份/安装/更新；若某些页面直接读 `package.json` 而不走这两个方法，则不受影响。
+- **关闭方式**：启动 DSH 前设置环境变量 `DSH_PLUGIN_LABELS_OFFICIAL_META=0`，然后重启 DSH（会同时关闭上述两处覆盖）。未设置、设为 `1` 或其它值都保持默认开启。
+- **生效方式**：host 代码在进程启动时安装，**需要重启 DSH 一次**；重启后 `GET /api/plugin-labels/list` 的响应里 `officialMeta` 字段（`{enabled, patched, service, bundles}`）可确认两处覆盖是否已生效，默认应为 `enabled:true, patched:true, bundles:true`。
+
+## 自动翻译新插件
+
+host 启动约 **4 秒**后会自动补一次缺失标签：
+
+- 默认开启；每次启动最多翻译 **20** 条（`MAX_PENDING_PER_CALL`），只补空缺、**不会覆盖手改标签**，剩余的下次启动/手动调用再补。
+- 关闭方式：启动 DSH 前设置 `DSH_PLUGIN_LABELS_AUTO_TRANSLATE=0`，然后重启 DSH；未设置/`1`/其它值均为开启。
+- 与手动翻译共用同一个单飞锁与 120 秒超时；失败只写日志（warn），不抛错、不阻塞启动。
+- 手动补翻译：`POST /api/plugin-labels/translate`（见「使用」）。
+
+## 安装
+
+### 方式一：npm 包（推荐，`npm publish` 后）
+
+在 DSH 插件页 → 添加插件 → 填包名 `dsh-plugin-labels`；或在创造模式会话里 `plugin_manager` → `install_bundle` → `target: "dsh-plugin-labels"`。发布后 profile 依赖形如
+`"dsh-plugin-labels": "dsh-plugin-labels@^0.8.0"`。
+
+### 方式二：从 Git 仓库安装
+
+在 DSH 插件页 → 添加插件 → 填本仓库的 Git 地址（`https://github.com/qyy2005/dsh-plugin-labels`），DSH 会拉取并安装；此时 profile 依赖形如 `github:qyy2005/dsh-plugin-labels`。私有仓库需具备相应访问权限。
+
+### 方式三：本机目录安装（开发用，`link:` 形式）
+
+用 `plugin_manager` → `install_bundle` → `target` 填本目录绝对路径，profile 依赖形如 `link:<本机插件目录绝对路径>`，`node_modules/dsh-plugin-labels` 是指向本目录的符号链接。
+
+- 适合开发：源码即已装内容，改完刷新/重启即可；**源码目录不可删除或移动**。
+- 改 host `lib/index.js` 后需重启 DSH 才生效（v0.7.0 起 client 已无 UI）。
+- 不建议手工编辑 profile 的 `package.json` 来安装（易被 pnpm 清理）。
+
+## 使用
+
+v0.7.0 起没有 UI 入口，全部通过 4 个 loopback HTTP API 操作（也可以让 AI/脚本代改）：
+
+```powershell
+# 查看已装插件 + 标签 + 诊断字段（officialMeta）
+Invoke-WebRequest -UseBasicParsing http://127.0.0.1:<端口>/api/plugin-labels/list
+
+# 补翻译（无参 = 只补空缺；最多 20 条/次）
+Invoke-RestMethod -Method Post -ContentType 'application/json' `
+  -Body '{}' http://127.0.0.1:<端口>/api/plugin-labels/translate
+
+# 显式重翻指定插件
+Invoke-RestMethod -Method Post -ContentType 'application/json' `
+  -Body '{"names":["@linxin666/dsh-remote-web-ui"]}' http://127.0.0.1:<端口>/api/plugin-labels/translate
+
+# 手改一条（source=manual），或恢复 AI：{"name":"...","action":"reset"}
+Invoke-RestMethod -Method Post -ContentType 'application/json' `
+  -Body '{"name":"@linxin666/dsh-remote-web-ui","title":"远程网页访问","oneLine":"扫码配对手机和电脑共用网页界面。"}' `
+  http://127.0.0.1:<端口>/api/plugin-labels/label
+
+# 导入导出的 JSON（只保留已装插件名，保留 ai/manual 来源）
+Invoke-RestMethod -Method Post -ContentType 'application/json' -InFile labels.json `
+  http://127.0.0.1:<端口>/api/plugin-labels/import
+```
+
+端口就是当前 DSH Web GUI 的端口；这些路由只接受 loopback 请求且必须是 POST（`/list` 为 GET）。自动翻译会替你补空缺，手改过的条目不会被自动覆盖。
+
+## 插件速查文档
+
+`node scripts/gen-doc.mjs` 会在**本地**生成 `PLUGINS.zh.md` 与 `PLUGINS.zh.html`：中文名、原始包名、一句话作用、版本、说明（AI 生成 / 手改 / 待翻译）。HTML 是单文件、内联样式、可搜索、随系统深浅色，双击即可打开，无需联网。内容来自你本机的标签缓存与已装插件清单，**默认不提交到仓库**（已 gitignore）。
+
+重新生成（装/卸插件，或翻译/手改标签之后）：
+
+```powershell
+node scripts/gen-doc.mjs                # 默认读取 $env:DSH_HOME（或 ~/.dsh）的 desktop profile
+node scripts/gen-doc.mjs --home "$env:DSH_HOME" --profile desktop
+npm run docs                            # 等价于 node scripts/gen-doc.mjs
+```
+
+生成器只读本地标签缓存与 profile 清单，产物不含本机路径、`DSH_HOME`、用户名或 token；生成的两个文件只留在本地（已 gitignore），**不要手工编辑**。
+
+## 兼容性
+
+- DSH 桌面版 **0.2.1-rc.2**（Web GUI）；依赖官方 client 基座模块与 host 服务，只 `require("react")`。
+- 本插件不依赖任何 UI slot：显示覆盖包装宿主的 `pluginPackages.metaOf()`（官方页行/详情）与 `pluginManager.listBundles()`（插件包卡片），client 只注册 `locale` 字典。
+- 拿不到这些内部服务时静默回退：不显示中文（回退英文），插件其它功能与 API 仍可用。
+
+## 开发说明
+
+- **无构建步骤**：host 是 ESM 的 `lib/index.js`（`inject: ["webServer"]`）；client 是手写的 `__ModuleLoader__` bundle `lib/client.js`（v0.7.0 起只注册 locale，无 UI），仅 `require("react")`。
+- **管理 API**（client 已无 UI，脚本/AI 直接调用）：
+  - `GET  /api/plugin-labels/list`
+  - `POST /api/plugin-labels/translate`（无参=补空缺；`{names:[...]}`=显式重翻）
+  - `POST /api/plugin-labels/label`（`{name,title,oneLine}` 或 `{name,action:"reset"}`）
+  - `POST /api/plugin-labels/import`
+- **自动翻译**：`apply` 里注册一个 4 秒后执行一次的定时器（`unref`），调用 `translatePending` 补空缺；可用 `DSH_PLUGIN_LABELS_AUTO_TRANSLATE=0` 关闭；异常只 warn。
+- **显示覆盖**：`installOfficialMeta` / `installBundleMeta` 用 symbol 标记识别 wrapper，幂等、可 dispose、服务替换后重打、失败静默回退。`DSH_PLUGIN_LABELS_OFFICIAL_META=0` 同时关闭两处覆盖。
+- **安全围栏**：loopback 校验、`sec-fetch-site` 跨站拒绝、POST-only、翻译单飞锁（并发 409）、`AbortSignal.timeout(120s)`、未预期异常统一 500 不泄漏路径。
+- **缓存**：`<DSH_HOME>/plugin-labels.json`，UTF-8 无 BOM，临时文件 + `rename` 原子写；缓存 `version: 2`，旧 v1 数据可迁移读取，单条非法条目丢弃。
+- **验证**：`node --check lib/index.js`、`node --check lib/client.js`；host 可用桩 `ctx` 跑冒烟。
+- 修改 host 后需重启 DSH 生效（本插件已没有需要刷新页面的 UI 改动）。
+
+## 目录结构
+
+```
+dsh-plugin-labels/
+├─ .gitignore              # 忽略 node_modules、日志与本地内部文档
+├─ .github/
+│  ├─ ISSUE_TEMPLATE/      # Bug / Feature 的 issue forms
+│  └─ workflows/ci.yml     # GitHub Actions：node --check + JSON/BOM 校验
+├─ docs/
+│  └─ official-page.png    # 官方「插件」页原地显示中文名的截图
+├─ package.json            # manifest（dsh.bundle 组合 patch、dsh.client 平台与 inject）
+├─ cordis.patch.yml        # bundle 组合 patch
+├─ lib/
+│  ├─ index.js             # host：HTTP API + 显示覆盖 + 自动翻译 + 标签缓存
+│  └─ client.js            # client：模块骨架，仅注册 locale（v0.7.0 起无 UI）
+├─ locale/
+│  ├─ zh.json              # 插件元数据（中文）
+│  └─ en.json              # 插件元数据（英文）
+├─ icon.svg                # 插件图标
+├─ scripts/
+│  └─ gen-doc.mjs          # 生成 PLUGINS.zh.* 速查文档（本地生成，已 gitignore）
+├─ README.md
+└─ LICENSE
+```
+
+## License
+
+MIT，见 [LICENSE](LICENSE)。Copyright (c) 2026 qyy2005
+
+---
+
+## English summary
+
+`dsh-plugin-labels` is a DSH (DeepSeek Harness) plugin that gives every installed plugin a Chinese name and a one-line explanation. The labels are shown **in place** on the official Plugins page: the installed-plugin rows, the detail pages and the plugin package cards (`pluginManager.listBundles`) all display the Chinese name and description, falling back to English for plugins without a label. **The plugin has no UI entry point** (no tab, no settings item): labels are managed through four loopback HTTP routes (or by an AI/script calling them), and results are cached under `<DSH_HOME>/plugin-labels.json` with manual edits never overwritten by automatic translation.
+
+Each label is a Chinese name (≤10 characters) plus a one-line explanation (≤80 characters) that must explain **how to use** the plugin: the problem it solves, where in DSH the user enters or operates it, and a concrete first step. When the entry point cannot be inferred, the model is instructed to write 入口以界面为准 instead of inventing menus.
+
+Newly installed plugins are translated automatically: about 4 seconds after host startup one pass fills up to 20 missing labels (set `DSH_PLUGIN_LABELS_AUTO_TRANSLATE=0` and restart DSH to disable it). The display overrides can be disabled together with `DSH_PLUGIN_LABELS_OFFICIAL_META=0`; `GET /api/plugin-labels/list` reports `officialMeta: {enabled, patched, service, bundles}` for diagnostics. Both overrides require one DSH restart after installation.
+
+The client half is a hand-written `__ModuleLoader__` bundle with no build step that only requires `react` (v0.7.0: locale registration only, no UI); the host half is an ESM plugin exposing four loopback-only HTTP routes plus the display overrides and the startup auto-translate. Verified on DSH desktop 0.2.1-rc.2. MIT licensed.

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+# dsh-plugin-labels — mount the host half when this package is a profile bundle.
+- insert:
+    - id: plugin-labels
+      name: "dsh-plugin-labels"

package/icon.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="Plugin Labels">
+  <rect x="6" y="14" width="52" height="36" rx="8" fill="#4D6BFE" opacity="0.16"/>
+  <rect x="6" y="14" width="52" height="36" rx="8" fill="none" stroke="#4D6BFE" stroke-width="2"/>
+  <path d="M20 26h24M20 33h18M20 40h12" stroke="#4D6BFE" stroke-width="3" stroke-linecap="round"/>
+</svg>

package/lib/client.js

@@ -0,0 +1,407 @@
+/**
+ * dsh-plugin-labels — browser half (v0.7.0: no UI).
+ *
+ * This bundle no longer renders a tab anywhere. The Chinese names are shown in
+ * place by the host half, which wraps the official display metadata: the
+ * Plugins page rows/detail pages (`pluginPackages.metaOf`) and the plugin
+ * package cards (`pluginManager.listBundles`). Management (translate / edit /
+ * re-translate / import / export) happens through the host's loopback HTTP API,
+ * e.g. by an AI agent or a script.
+ *
+ * What remains is the module skeleton: the factory returns `{ inject, apply }`,
+ * registers the `plugin-labels` locale dictionaries and has no side effects.
+ * Only `react` is required. The row component below is kept as reference for
+ * the removed tab: it is not registered anywhere and never renders.
+ */
+
+window.__ModuleLoader__.load({
+	id: "dsh-plugin-labels",
+	factory(require) {
+		const React = require("react");
+
+		const API_LIST = "/api/plugin-labels/list";
+		const API_TRANSLATE = "/api/plugin-labels/translate";
+		const API_LABEL = "/api/plugin-labels/label";
+		const API_IMPORT = "/api/plugin-labels/import";
+
+		const dictZh = {
+			title: "插件中文名",
+			tabLabel: "中文名",
+			subtitle: "给已装插件配中文名与一句话说明，侧栏插件页与设置里都能查看。只有点翻译才会花 token，翻过就缓存，可手动编辑。",
+			loading: "读取中…",
+			ready: "已装",
+			translated: "已翻译",
+			pending: "未翻译",
+			translate: "翻译未翻译的",
+			translating: "翻译中…",
+			nonePending: "全部已翻译",
+			untranslated: "未翻译",
+			official: "官方内置",
+			manual: "手改",
+			ai: "AI",
+			edit: "编辑",
+			save: "保存",
+			cancel: "取消",
+			resetAi: "恢复AI",
+			retranslate: "重翻",
+			export: "导出",
+			import: "导入",
+			search: "搜索中文名、包名或说明…",
+			english: "英文原文",
+			noDescription: "（该插件未提供描述）",
+			saved: "已保存",
+			failed: "失败",
+			done: "完成，新增",
+			items: "条",
+			imported: "导入完成：",
+			skipped: "条跳过",
+			titlePlaceholder: "中文名（≤8字）",
+			oneLinePlaceholder: "一句话说明",
+			empty: "没有匹配的插件",
+		};
+		const dictEn = {
+			title: "Plugin Labels",
+			tabLabel: "Labels",
+			subtitle: "Chinese names and one-line explanations for installed plugins, shown on the sidebar Plugins page and in Settings. Tokens are spent only when you translate; results are cached and editable.",
+			loading: "Loading…",
+			ready: "Installed",
+			translated: "Translated",
+			pending: "Pending",
+			translate: "Translate missing",
+			translating: "Translating…",
+			nonePending: "All translated",
+			untranslated: "Untranslated",
+			official: "Built-in",
+			manual: "Edited",
+			ai: "AI",
+			edit: "Edit",
+			save: "Save",
+			cancel: "Cancel",
+			resetAi: "Reset to AI",
+			retranslate: "Re-translate",
+			export: "Export",
+			import: "Import",
+			search: "Search name, package or description…",
+			english: "English description",
+			noDescription: "(no description)",
+			saved: "Saved",
+			failed: "Failed",
+			done: "Done; added",
+			items: "items",
+			imported: "Imported:",
+			skipped: "skipped",
+			titlePlaceholder: "Chinese name (≤8 chars)",
+			oneLinePlaceholder: "One-line explanation",
+			empty: "No matching plugin",
+		};
+
+		/** Component-local styles: inherited colors only, removed on unmount. */
+		const CSS = [
+			".dsh-pl{display:flex;flex-direction:column;gap:12px;padding:6px 4px 24px;font-size:13px;line-height:1.5;max-width:100%;box-sizing:border-box}",
+			".dsh-pl-bar{display:flex;align-items:center;gap:8px;flex-wrap:wrap}",
+			".dsh-pl-search{flex:1 1 200px;min-width:160px;padding:6px 10px;font:inherit;font-size:13px;color:inherit;background:color-mix(in srgb,currentColor 4%,transparent);border:1px solid color-mix(in srgb,currentColor 16%,transparent);border-radius:8px;outline:none}",
+			".dsh-pl-search:focus{border-color:color-mix(in srgb,currentColor 40%,transparent)}",
+			".dsh-pl-btn{padding:5px 10px;font:inherit;font-size:12.5px;color:inherit;background:transparent;border:1px solid color-mix(in srgb,currentColor 18%,transparent);border-radius:8px;cursor:pointer;white-space:nowrap}",
+			".dsh-pl-btn:hover:not(:disabled){background:color-mix(in srgb,currentColor 8%,transparent)}",
+			".dsh-pl-btn:disabled{opacity:.45;cursor:not-allowed}",
+			".dsh-pl-primary{font-weight:600;border-color:color-mix(in srgb,currentColor 38%,transparent);background:color-mix(in srgb,currentColor 10%,transparent)}",
+			".dsh-pl-stats{font-size:12px;opacity:.6}",
+			".dsh-pl-notice{font-size:12px;opacity:.75}",
+			".dsh-pl-list{list-style:none;margin:0;padding:0;display:flex;flex-direction:column}",
+			".dsh-pl-row{display:flex;gap:8px 12px;align-items:flex-start;justify-content:space-between;flex-wrap:wrap;padding:11px 8px;border-bottom:1px solid color-mix(in srgb,currentColor 8%,transparent);border-radius:8px}",
+			".dsh-pl-row:hover{background:color-mix(in srgb,currentColor 4%,transparent)}",
+			".dsh-pl-main{min-width:0;flex:1 1 260px}",
+			".dsh-pl-name{font-weight:600;font-size:14px;line-height:1.4;overflow-wrap:anywhere}",
+			".dsh-pl-name.dsh-pl-empty{opacity:.45;font-weight:500}",
+			".dsh-pl-meta{margin-top:3px;font-family:ui-monospace,Consolas,monospace;font-size:11.5px;line-height:1.4;opacity:.6;display:flex;align-items:center;gap:6px;flex-wrap:wrap;overflow-wrap:anywhere}",
+			".dsh-pl-tag{font-family:inherit;font-size:11px;padding:0 6px;border:1px solid color-mix(in srgb,currentColor 22%,transparent);border-radius:99px;opacity:.85}",
+			".dsh-pl-one{margin-top:6px;font-size:12.5px;line-height:1.55;opacity:.78;overflow-wrap:anywhere}",
+			".dsh-pl-en{margin-top:6px;font-size:11.5px;opacity:.5}",
+			".dsh-pl-en summary{cursor:pointer;outline:none}",
+			".dsh-pl-en div{margin-top:2px;white-space:pre-wrap;overflow-wrap:anywhere}",
+			".dsh-pl-actions{display:flex;gap:6px;flex-wrap:wrap;justify-content:flex-end;flex:0 0 auto;margin-left:auto}",
+			".dsh-pl-act{padding:3px 8px;font:inherit;font-size:12px;color:inherit;background:transparent;border:none;border-radius:6px;cursor:pointer;opacity:.7}",
+			".dsh-pl-act:hover{background:color-mix(in srgb,currentColor 8%,transparent);opacity:1}",
+			".dsh-pl-edit{display:flex;gap:6px;flex-wrap:wrap;margin-top:6px;flex:1 1 100%}",
+			".dsh-pl-input{flex:1 1 150px;padding:4px 8px;font:inherit;font-size:12.5px;color:inherit;background:color-mix(in srgb,currentColor 4%,transparent);border:1px solid color-mix(in srgb,currentColor 28%,transparent);border-radius:7px;outline:none}",
+			".dsh-pl-hint{font-size:12px;opacity:.55;margin-top:4px}",
+		].join("");
+
+		function LabelsSection(props) {
+			const t = props && typeof props.t === "function" ? props.t : (key) => key;
+			const [state, setState] = React.useState({
+				phase: "loading",
+				plugins: [],
+				pending: 0,
+				translated: 0,
+				error: "",
+				busy: false,
+				notice: "",
+				query: "",
+				editing: null,
+				saving: false,
+				importing: false,
+			});
+			const fileRef = React.useRef(null);
+
+			const load = React.useCallback(() => {
+				return fetch(API_LIST, { headers: { accept: "application/json" }, credentials: "same-origin" })
+					.then((response) => response.json())
+					.then((data) => {
+						if (data && data.ok) {
+							setState((previous) => Object.assign({}, previous, {
+								phase: "ready",
+								plugins: Array.isArray(data.plugins) ? data.plugins : [],
+								pending: Number(data.pending) || 0,
+								translated: Number(data.translated) || 0,
+								error: "",
+							}));
+						} else {
+							setState((previous) => Object.assign({}, previous, { phase: "error", error: String((data && data.error) || "unknown") }));
+						}
+					})
+					.catch((error) => {
+						setState((previous) => Object.assign({}, previous, { phase: "error", error: String((error && error.message) || error) }));
+					});
+			}, []);
+
+			React.useEffect(() => {
+				load().catch(() => {});
+			}, [load]);
+
+			const post = (url, body) => fetch(url, {
+				method: "POST",
+				headers: { "content-type": "application/json", accept: "application/json" },
+				credentials: "same-origin",
+				body: JSON.stringify(body || {}),
+			}).then((response) => response.json());
+
+			const ok = (data) => {
+				if (data && data.ok) return data;
+				throw new Error(String((data && data.error) || "unknown"));
+			};
+
+			const run = (promise, onDone) => promise
+				.then(ok)
+				.then((data) => { onDone(data); return load(); })
+				.catch((error) => setState((previous) => Object.assign({}, previous, {
+					busy: false,
+					saving: false,
+					importing: false,
+					notice: t("failed") + "：" + String((error && error.message) || error),
+				})));
+
+			const translate = () => {
+				setState((previous) => Object.assign({}, previous, { busy: true, notice: "" }));
+				run(post(API_TRANSLATE, {}), (data) => setState((previous) => Object.assign({}, previous, {
+					busy: false,
+					notice: t("done") + " " + (Number(data.added) || 0) + " " + t("items"),
+				})));
+			};
+
+			const retranslate = (pluginName) => {
+				setState((previous) => Object.assign({}, previous, { busy: true, notice: "" }));
+				run(post(API_TRANSLATE, { names: [pluginName] }), (data) => setState((previous) => Object.assign({}, previous, {
+					busy: false,
+					notice: t("done") + " " + (Number(data.added) || 0) + " " + t("items"),
+				})));
+			};
+
+			const beginEdit = (plugin) => setState((previous) => Object.assign({}, previous, {
+				editing: { name: plugin.name, title: plugin.label ? plugin.label.title : "", oneLine: plugin.label ? plugin.label.oneLine : "" },
+				notice: "",
+			}));
+			const cancelEdit = () => setState((previous) => Object.assign({}, previous, { editing: null }));
+			const changeField = (key, value) => setState((previous) => (previous.editing ? Object.assign({}, previous, { editing: Object.assign({}, previous.editing, { [key]: value }) }) : previous));
+
+			const saveEdit = () => {
+				const editing = state.editing;
+				if (!editing) return;
+				setState((previous) => Object.assign({}, previous, { saving: true }));
+				run(post(API_LABEL, { name: editing.name, title: editing.title, oneLine: editing.oneLine }), () => setState((previous) => Object.assign({}, previous, {
+					saving: false,
+					editing: null,
+					notice: t("saved"),
+				})));
+			};
+
+			const resetLabel = (pluginName) => {
+				setState((previous) => Object.assign({}, previous, { notice: "" }));
+				run(post(API_LABEL, { name: pluginName, action: "reset" }), () => {});
+			};
+
+			const exportLabels = () => {
+				const entries = {};
+				state.plugins.forEach((plugin) => {
+					if (!plugin.label) return;
+					// Carry the origin so re-importing never promotes AI output to
+					// "manual" (or the other way around).
+					entries[plugin.name] = {
+						title: plugin.label.title,
+						oneLine: plugin.label.oneLine,
+						source: plugin.label.source === "manual" ? "manual" : "ai",
+					};
+				});
+				const text = JSON.stringify({ version: 2, exportedAt: new Date().toISOString(), entries }, null, 2);
+				const blob = new Blob([text], { type: "application/json" });
+				const url = URL.createObjectURL(blob);
+				const anchor = document.createElement("a");
+				anchor.href = url;
+				anchor.download = "plugin-labels.json";
+				anchor.click();
+				setTimeout(() => URL.revokeObjectURL(url), 1000);
+			};
+
+			const importFile = (event) => {
+				const file = event.target.files && event.target.files[0];
+				event.target.value = "";
+				if (!file) return;
+				const reader = new FileReader();
+				reader.onload = () => {
+					let parsed;
+					try {
+						parsed = JSON.parse(String(reader.result));
+					} catch (error) {
+						setState((previous) => Object.assign({}, previous, { notice: t("failed") + "：" + String((error && error.message) || error) }));
+						return;
+					}
+					setState((previous) => Object.assign({}, previous, { importing: true }));
+					run(post(API_IMPORT, parsed), (data) => setState((previous) => Object.assign({}, previous, {
+						importing: false,
+						notice: t("imported") + " " + (Number(data.applied) || 0) + " · " + (Number(data.skipped) || 0) + " " + t("skipped"),
+					})));
+				};
+				reader.readAsText(file);
+			};
+
+			const query = state.query.trim().toLowerCase();
+			const rows = state.plugins.filter((plugin) => {
+				if (query === "") return true;
+				const haystack = [plugin.name, plugin.description || "", plugin.label ? plugin.label.title : "", plugin.label ? plugin.label.oneLine : ""].join(" ").toLowerCase();
+				return haystack.indexOf(query) >= 0;
+			});
+
+			const stats = state.phase === "loading"
+				? t("loading")
+				: state.phase === "error"
+					? t("failed") + "：" + state.error
+					: t("ready") + " " + state.plugins.length + " · " + t("translated") + " " + (state.translated || 0) + " · " + t("pending") + " " + (state.pending || 0);
+
+			const canTranslate = state.phase === "ready" && !state.busy && (state.pending || 0) > 0;
+
+			const renderRow = (plugin) => {
+				const isEditing = state.editing !== null && state.editing.name === plugin.name;
+				// Third line: the Chinese one-liner, or the English description when
+				// the plugin has not been translated yet.
+				const oneLine = plugin.label && plugin.label.oneLine ? plugin.label.oneLine : (plugin.description || t("noDescription"));
+				return React.createElement(
+					"li",
+					{ key: plugin.name, className: "dsh-pl-row" },
+					React.createElement(
+						"div",
+						{ className: "dsh-pl-main" },
+						// 1) Chinese name replaces the English name as the headline.
+						plugin.label
+							? React.createElement("div", { className: "dsh-pl-name", title: plugin.label.title }, plugin.label.title)
+							: React.createElement("div", { className: "dsh-pl-name dsh-pl-empty" }, t("untranslated")),
+						// 2) Original package name + version + badges.
+						React.createElement(
+							"div",
+							{ className: "dsh-pl-meta" },
+							React.createElement("span", { className: "dsh-pl-original" }, plugin.name + (plugin.version ? "  v" + plugin.version : "")),
+							plugin.kind === "official-or-missing" ? React.createElement("span", { className: "dsh-pl-tag" }, t("official")) : null,
+							plugin.label && plugin.label.source === "manual" ? React.createElement("span", { className: "dsh-pl-tag" }, t("manual")) : null,
+							plugin.label && plugin.label.source === "ai" ? React.createElement("span", { className: "dsh-pl-tag" }, t("ai")) : null,
+						),
+						// 3) One-line Chinese explanation (edit inputs live here while
+						// editing so the actions keep their place on the right).
+						isEditing
+							? React.createElement(
+									"div",
+									{ className: "dsh-pl-edit" },
+									React.createElement("input", {
+										className: "dsh-pl-input",
+										value: state.editing.title,
+										placeholder: t("titlePlaceholder"),
+										onChange: (event) => changeField("title", event.target.value),
+									}),
+									React.createElement("input", {
+										className: "dsh-pl-input",
+										value: state.editing.oneLine,
+										placeholder: t("oneLinePlaceholder"),
+										onChange: (event) => changeField("oneLine", event.target.value),
+									}),
+								)
+							: React.createElement("div", { className: "dsh-pl-one" }, oneLine),
+						// 4) The full English description stays collapsed below the fold.
+						React.createElement(
+							"details",
+							{ className: "dsh-pl-en" },
+							React.createElement("summary", null, t("english")),
+							React.createElement("div", null, plugin.description || t("noDescription")),
+						),
+					),
+					React.createElement(
+						"div",
+						{ className: "dsh-pl-actions" },
+						isEditing
+							? [
+									React.createElement("button", { key: "save", type: "button", className: "dsh-pl-act", disabled: state.saving || state.busy, onClick: saveEdit }, t("save")),
+									React.createElement("button", { key: "cancel", type: "button", className: "dsh-pl-act", onClick: cancelEdit }, t("cancel")),
+								]
+							: [
+									React.createElement("button", { key: "edit", type: "button", className: "dsh-pl-act", disabled: state.busy, onClick: () => beginEdit(plugin) }, t("edit")),
+									React.createElement("button", { key: "retranslate", type: "button", className: "dsh-pl-act", disabled: state.busy, onClick: () => retranslate(plugin.name) }, t("retranslate")),
+									plugin.label && plugin.label.source === "manual"
+										? React.createElement("button", { key: "reset", type: "button", className: "dsh-pl-act", disabled: state.busy, onClick: () => resetLabel(plugin.name) }, t("resetAi"))
+										: null,
+								],
+					),
+				);
+			};
+
+			return React.createElement(
+				"div",
+				{ className: "dsh-pl" },
+				React.createElement("style", null, CSS),
+				React.createElement("div", { className: "dsh-pl-hint" }, t("subtitle")),
+				React.createElement(
+					"div",
+					{ className: "dsh-pl-bar" },
+					React.createElement("input", {
+						className: "dsh-pl-search",
+						value: state.query,
+						placeholder: t("search"),
+						onChange: (event) => setState((previous) => Object.assign({}, previous, { query: event.target.value })),
+					}),
+					React.createElement(
+						"button",
+						{
+							type: "button",
+							className: "dsh-pl-btn" + (canTranslate ? " dsh-pl-primary" : ""),
+							disabled: !canTranslate,
+							onClick: canTranslate ? translate : undefined,
+						},
+						state.busy ? t("translating") : (state.pending || 0) > 0 ? t("translate") + "（" + state.pending + "）" : t("nonePending"),
+					),
+					React.createElement("button", { type: "button", className: "dsh-pl-btn", onClick: exportLabels }, t("export")),
+					React.createElement("button", { type: "button", className: "dsh-pl-btn", disabled: state.importing || state.busy, onClick: () => fileRef.current && fileRef.current.click() }, state.importing ? t("loading") : t("import")),
+					React.createElement("input", { type: "file", accept: ".json,application/json", ref: fileRef, style: { display: "none" }, onChange: importFile }),
+				),
+				React.createElement("div", { className: "dsh-pl-stats" }, stats + (rows.length !== state.plugins.length ? " · " + rows.length + " / " + state.plugins.length : "")),
+				state.notice ? React.createElement("div", { className: "dsh-pl-notice" }, state.notice) : null,
+				React.createElement("ul", { className: "dsh-pl-list" }, rows.length > 0 ? rows.map(renderRow) : React.createElement("li", { className: "dsh-pl-hint" }, t("empty"))),
+			);
+		}
+
+		function apply(ctx) {
+			ctx.effect(() => ctx.locale.register("plugin-labels", { zh: dictZh, en: dictEn }), "plugin-labels: dictionaries");
+			// No slots are registered: v0.7.0 removed the last labels tab.
+		}
+
+		return {
+			inject: ["locale"],
+			apply,
+		};
+	},
+});