dsh-plugin 1.6.12 → 2.0.1

package/src/client/styles/List.module.css

@@ -2,9 +2,8 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Plugin Hub catalog list: the scrollable body, plugin cards (name, badges,
- * description, topics, stats, actions), loading / empty states and the
- * browse-all footer. Colors resolve through the --hub-* design tokens. */
+ * 插件中心目录列表：可滚动主体、插件卡片（名称、徽标、描述、标签、统计、动作）、
+ * 加载/空态与「浏览全部」页脚。颜色经 --hub-* 设计变量解析。 */
 
 .body {
   flex: 1;
@@ -273,7 +272,7 @@ body[data-ds-dark-theme] .uninstallBtn:hover {
   user-select: none;
 }
 
-/* —— states —— */
+/* —— 状态 —— */
 
 .state {
   flex: 1;
@@ -341,7 +340,7 @@ body[data-ds-dark-theme] .uninstallBtn:hover {
   background: var(--hub-brand-hover);
 }
 
-/* —— footer —— */
+/* —— 页脚 —— */
 
 .footer {
   flex-shrink: 0;

package/src/client/styles/LogsView.module.css

@@ -2,9 +2,8 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * System logs: one row per entry — time, level badge (OK green / FAIL red /
- * WARN amber / INFO grey), event code and the message. Header holds the
- * refresh / copy-all / export (.log download) actions. */
+ * 系统日志：每条一行 —— 时间、级别徽标（OK 绿 / FAIL 红 / WARN 琥珀 / INFO 灰）、
+ * 事件码与消息。头部含 刷新 / 全部复制 / 导出（.log 下载）动作。 */
 
 .panel {
   display: flex;

package/src/client/styles/Modal.module.css

@@ -2,11 +2,10 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Plugin Hub dialogs and overlays: install / uninstall modals, error dialog,
- * failure-record dialog, task-queue dialog, progress strip, inline progress
- * and the global toast. Colors resolve through the --hub-* design tokens. */
+ * 插件中心弹窗与遮罩：安装/卸载弹窗、错误弹窗、失败记录弹窗、任务队列弹窗、进度条、
+ * 内联进度与全局 Toast。颜色经 --hub-* 设计变量解析。 */
 
-/* —— modal base —— */
+/* —— 弹窗基座 —— */
 
 .overlay {
   position: fixed;
@@ -364,7 +363,7 @@
   overflow-y: auto;
 }
 
-/* —— toast —— */
+/* —— Toast 提示条 —— */
 
 /* 复制成功提示条：窗口正中央浮出，无遮罩无图标。采用反色浮层——亮色模式
    黑底白字、暗色模式白底深字（复用主按钮 token：primary-fill 与
@@ -560,7 +559,7 @@
 /* 错误信息正文：等宽字体 + 可滚动 + 保留换行，完整展示服务端报错 */
 .errorBox {
   margin: 0;
-  max-height: 240px;
+  max-height: 72px;
   overflow: auto;
   padding: 10px 12px;
   border: 1px solid var(--hub-danger-border);
@@ -1140,6 +1139,7 @@
   font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
   font-size: 12px;
   line-height: 18px;
+  /* 来源参数 ?ref=hub 只保留在 href 里，不显示 */
   color: var(--hub-brand);
   text-decoration: none;
   cursor: pointer;
@@ -1147,6 +1147,21 @@
 }
 
 .failRepo:hover {
+  text-decoration: none;
+}
+
+/* 只有真正的超链接用蓝色（同类名也用于纯文本的仓库名/更新记录） */
+a.failRepo {
+  color: #2f6feb;
+}
+
+/* 链接里的「插件详情」前缀保持正文色，只有后面的网址是蓝色 */
+.failRepoLabel {
+  color: var(--hub-text-secondary);
+}
+
+/* 下划线只加在网址上，前缀不跟着变成链接样式 */
+a.failRepo:hover .failRepoUrl {
   text-decoration: underline;
 }
 
@@ -1227,12 +1242,37 @@
   box-shadow: 0 3px 10px rgba(209, 36, 47, 0.35);
 }
 
+/* 失败主因分三层：标题（报错类型）→ 一句话原因 → 操作指引，视觉上逐层递减 */
+.failKindTitle {
+  margin-top: 10px;
+  font-size: 15px;
+  font-weight: 700;
+  line-height: 22px;
+  text-align: left;
+  color: var(--hub-danger-text);
+}
+
+.failReason {
+  margin-top: 2px;
+  font-size: 12.5px;
+  font-weight: 400;
+  line-height: 19px;
+  white-space: pre-line;
+  text-align: left;
+  color: var(--hub-text-secondary);
+}
+
 /* 插件 prepare 构建脚本失败说明：位于提 Issue 按钮上方的补充说明，同琥珀警示样式 */
 .failPrepareHint {
   margin-top: 6px;
+  /* 与下方的报错框 / 红色按钮留出呼吸空间 */
+  margin-bottom: 12px;
   padding: 8px 12px;
   font-size: 12px;
   line-height: 18px;
+  /* 提示里的 \n 按行渲染：多步骤指引一条一行，读起来不用在一段长文里找 */
+  white-space: pre-line;
+  text-align: left;
   color: var(--hub-warning);
   background: var(--hub-warning-tint);
   border: 1px solid var(--hub-warning-border);

package/src/client/styles/SectionTabs.module.css

@@ -2,10 +2,8 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Primary navigation (section tabs): an underline tab bar under the header
- * switching between Market / Installed / Settings. The active tab carries a
- * brand-colored underline; the bar itself draws a hairline bottom border so
- * the selected state reads clearly without extra chrome. */
+ * 一级导航（section tabs）：头部下方的下划线 tab 栏，在 市场 / 已安装 / 设置 间切换。
+ * 激活 tab 带品牌色下划线；栏本身画一条细底边，让选中态清晰、不多余装饰。 */
 
 .root {
   display: flex;

package/src/client/styles/SettingsView.module.css

@@ -2,11 +2,9 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Settings view: desktop-settings navigation — a fixed left sidebar lists
- * the sections (icon + label, click to switch), the right pane shows one
- * card per active section (rows: label left, control right, hairline
- * separators). High density, no whitespace waste: rows are 12px padding,
- * 28px controls, 11px descriptions. */
+ * 设置视图：桌面设置式导航 —— 固定左侧栏列出各分组（图标 + 名称，点击切换），
+ * 右侧面板每个分组一张卡片（行：标签左、控件右，细线分隔）。高密度、不浪费留白：
+ * 行内边距 12px、控件 28px、说明 11px。 */
 
 /* 整体：占满剩余高度，左导航右内容两栏 */
 .root {

package/src/client/styles/Toggle.module.css

@@ -2,10 +2,8 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Toggle switch for settings rows: a small 34×18 track with a sliding
- * knob. Off = neutral hairline track; on = brand fill. Sized for the
- * compact settings row height (18px vs the 28px input rows), so labels
- * stay vertically centered without extra whitespace. */
+ * 设置行用的开关：小号 34×18 轨道 + 滑动圆钮。关 = 中性细线轨道；开 = 品牌填充。
+ * 尺寸贴合紧凑的设置行高（18px，输入行是 28px），让标签垂直居中且无多余留白。 */
 
 .toggle,
 .toggleOn {

package/src/client/styles/tokens.module.css

@@ -2,26 +2,22 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Plugin Hub design tokens.
+ * 插件中心设计变量。
  *
- * Semantic aliases over the host's --dsw-alias-* theme tokens, each with the
- * original light-mode literal as fallback for hosts that do not define the
- * underlying token. Declared on :root and on the dark body so every theme
- * re-resolves the aliases against its own token set; the custom property is
- * then inherited by all section elements.
+ * 对宿主 --dsw-alias-* 主题变量的语义别名，各带原始浅色字面量，供未定义底层变量的宿主兜底。
+ * 声明在 :root 与暗色 body 上，让每种主题都按自己的变量集重新解析别名，再由所有板块元素继承。
  *
- * Keep raw colors out of the per-area stylesheets: reference --hub-* here so
- * new styles pick up the theme automatically. */
+ * 各区域样式表不要写颜色字面量：在此引用 --hub-*，新样式即可自动跟随主题。 */
 :root,
 body[data-ds-dark-theme] {
-  /* text */
+  /* 文本 */
   --hub-text-primary: var(--dsw-alias-label-primary, #1f2328);
   --hub-text-secondary: var(--dsw-alias-label-secondary, #6b7280);
   --hub-text-tertiary: var(--dsw-alias-label-tertiary, #8b93a1);
   --hub-text-disabled: var(--dsw-alias-label-disabled, #aab1bd);
   --hub-text-on-fill: var(--dsw-alias-label-primary-foreground, #ffffff);
 
-  /* surfaces */
+  /* 表面/背景 */
   --hub-bg-1: var(--dsw-alias-bg-layer-1, #ffffff);
   --hub-bg-2: var(--dsw-alias-bg-layer-2, rgba(128, 128, 128, 0.08));
   --hub-bg-3: rgba(128, 128, 128, 0.1);
@@ -30,13 +26,13 @@ body[data-ds-dark-theme] {
   --hub-bg-hover: var(--dsw-alias-interactive-bg-hover, rgba(128, 128, 128, 0.16));
   --hub-bg-on-fill: rgba(128, 128, 128, 0.22);
 
-  /* borders */
+  /* 边框 */
   --hub-border-1: var(--dsw-alias-border-l1, #eceef1);
   --hub-border-2: var(--dsw-alias-border-l2, #e5e7eb);
   --hub-border-ghost: var(--dsw-alias-button-ghost-active-border, rgba(79, 110, 247, 0.25));
   --hub-border-input: var(--dsw-alias-input-border, rgba(107, 114, 128, 0.25));
 
-  /* brand (fixed in both themes) */
+  /* 品牌色（两种主题固定） */
   --hub-brand: var(--dsw-alias-state-business-primary, #4f6ef7);
   --hub-brand-hover: #3b5bdb;
   --hub-brand-tint: rgba(79, 110, 247, 0.06);
@@ -44,7 +40,7 @@ body[data-ds-dark-theme] {
   --hub-brand-border: rgba(79, 110, 247, 0.35);
   --hub-brand-border-soft: rgba(79, 110, 247, 0.22);
 
-  /* purple brand accents (fixed in both themes) */
+  /* 紫色品牌点缀（两种主题固定） */
   --hub-purple-1: #4f46e5;
   --hub-purple-2: #7c3aed;
   --hub-purple-border: rgba(139, 92, 246, 0.55);
@@ -52,28 +48,28 @@ body[data-ds-dark-theme] {
   --hub-purple-shadow: rgba(79, 70, 229, 0.28);
   --hub-purple-shadow-strong: rgba(124, 58, 237, 0.42);
 
-  /* primary action button */
+  /* 主操作按钮 */
   --hub-btn-fill: var(--dsw-alias-button-primary-fill, #1f2328);
   --hub-btn-hover: var(--dsw-alias-button-primary-hover, #43454a);
 
-  /* success */
+  /* 成功 */
   --hub-success: #16a34a;
   --hub-success-tint: rgba(22, 163, 74, 0.12);
   --hub-success-border: rgba(22, 163, 74, 0.3);
 
-  /* warning (amber) */
+  /* 警告（琥珀） */
   --hub-warn: var(--dsw-alias-state-warn-primary, #b8860b);
   --hub-warn-tint: rgba(184, 134, 11, 0.08);
   --hub-warn-border: rgba(184, 134, 11, 0.35);
   --hub-warn-strong: rgba(184, 134, 11, 0.85);
 
-  /* warning (deep amber) */
+  /* 警告（深琥珀） */
   --hub-warning: var(--dsw-alias-state-warning-primary, #b45309);
   --hub-warning-hover: #92400e;
   --hub-warning-tint: rgba(180, 83, 9, 0.08);
   --hub-warning-border: rgba(180, 83, 9, 0.3);
 
-  /* danger */
+  /* 危险 */
   --hub-danger: var(--dsw-alias-state-danger-primary, #d1242f);
   --hub-danger-hover: var(--dsw-alias-state-danger-hover, #b91c1c);
   --hub-danger-strong: #b0202a;

package/src/client/types.ts

@@ -3,20 +3,20 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Shared types for the dsh-plugin browser client. Kept dependency-free so
- * any client module can import them without pulling in components or styles.
+ * dsh-plugin 浏览器客户端的共享类型。保持零依赖，任何客户端模块都能直接引入，
+ * 而不会连带拉入组件或样式。
  */
 
 export type LocaleId = 'zh' | 'en'
 
-/** 自定义安装入口渠道：三张卡片（NPM 包 / GitHub 源码 / DSH 命令）。
- * 客户端提交时显式上报，服务端落日志/报错提示据此溯源「从哪个入口发起」。 */
-export type InstallChannel = 'npm' | 'git' | 'dsh'
+/** 自定义安装入口渠道：仅 NPM 包。
+ *  客户端提交时显式上报，服务端落日志/报错提示据此溯源「从哪个入口发起」。 */
+export type InstallChannel = 'npm'
 
-/** Translation function signature shared by the host binder and the in-component dictionary. */
+/** 宿主绑定与组件内字典共用的翻译函数签名。 */
 export type Translate = (key: string, params?: Record<string, string | number>) => string
 
-/** The subset of the locale service this plugin touches. */
+/** 本插件用到的 locale 服务子集。 */
 export interface LocaleService {
   register(namespace: string, dicts: { zh: Record<string, string>; en: Record<string, string> }): unknown
   bind(namespace: string): (key: string, params?: Record<string, string | number>) => string
@@ -27,13 +27,13 @@ export interface LocaleService {
   setLocale(id: string): void
 }
 
-/** The subset of the slots service this plugin touches. */
+/** 本插件用到的 slots 服务子集。 */
 export interface SlotsService {
   inject(slot: string, register: () => unknown): void
   register(meta: Record<string, unknown>, component: () => unknown): unknown
 }
 
-/** The client cordis context shape this plugin relies on (structural). */
+/** 本插件依赖的客户端 cordis 上下文形态（结构化）。 */
 export interface HubClientContext {
   effect(callback: () => unknown, label?: string): void
   slots: SlotsService
@@ -45,7 +45,7 @@ export interface SectionProps {
   locale: LocaleService
 }
 
-/** Slim projection of the site's DirectoryPlugin entries. */
+/** 官网 DirectoryPlugin 条目的精简投影。 */
 export interface HubPlugin {
   /** 作者小写 key，与 slug 共同构成唯一身份（两级路径 /plugins/{ownerSlug}/{slug}）；可能缺省 */
   ownerSlug?: string
@@ -60,7 +60,7 @@ export interface HubPlugin {
   source?: { repo?: string; npmPackage?: string }
   /** 安装信息：能否网页一键安装（false = 仅支持命令行/专属 profile，缺省视为 true）；
    *  manualInstall = 人工干预标记（网页端一键安装替代不了终端的构建/装配，必须用户自己去终端装）；
-   *  command/githubCommand = 目录下发的权威安装命令（npm/git 通道各一条），
+   *  command/githubCommand = 目录下发的权威安装命令，
    *  仅供展示/复制 —— CLI-only 插件（如 dsh-tui）需专属 profile（--profile dsh-tui），
    *  无法从 repo/npm 包名推断，必须用目录命令。 */
   install?: { webInstallable?: boolean; manualInstall?: boolean; command?: string; githubCommand?: string }

package/src/server/http/catalog.ts

@@ -3,8 +3,7 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Catalog proxy routes: server-side caching of the directory/stats payloads
- * and profile-level installed-package reads shared with the install/task modules.
+ * 目录代理路由：目录/统计载荷的服务端缓存，以及与安装/任务模块共享的 profile 级已装包读取。
  */
 import { mkdirSync, readFileSync, writeFileSync } from 'node:fs'
 import { homedir } from 'node:os'
@@ -53,7 +52,7 @@ export function profileDirectory(profile: string): string {
   return join(process.env.DSH_HOME ?? join(homedir(), '.dsh'), 'profiles', profile)
 }
 
-/** Read non-official dependencies installed into one profile. */
+/** 读取安装进某 profile 的非官方依赖。 */
 export function readInstalled(profile: string): Record<string, string> {
   try {
     const manifest = JSON.parse(readFileSync(join(profileDirectory(profile), 'package.json'), 'utf8')) as {

package/src/server/http/diagnostics.ts

@@ -3,8 +3,7 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Diagnostics routes: streaming connectivity self-check, proxy verification,
- * and the host environment snapshot shared with the task module's /env route.
+ * 诊断路由：流式连通性自检、代理校验，以及与任务模块 /env 路由共享的宿主环境快照。
  */
 import { readFileSync } from 'node:fs'
 import { homedir, release } from 'node:os'
@@ -31,7 +30,7 @@ function hostDshVersion(): string | null {
         return manifest.version
       }
     } catch {
-      /* not a package root — keep walking up */
+      /* 不是包根，继续向上查找 */
     }
     const parent = dirname(dir)
     if (parent === dir) break
@@ -95,8 +94,8 @@ export function registerDiagnosticsRoutes(webServer: WebServerService, profile:
       path: '/dsh-plugin-hub/diagnostics',
       handler: async (request, response) => {
         if (!requireTrustedPost(request, response)) return
-        // 连通性自检：npm registry（镜像/官方）/ GitHub API / 目录站点，逐路探测并测速。
-        // 与安装通道一一对应 —— npm 反查与 npm 安装走 registry、git 源走 github、目录数据走 dsh-plugin.org。
+        // 连通性自检：npm registry（镜像/官方）/ GitHub / 目录站点，逐路探测并测速。
+        // npm 安装走 registry、目录数据走 dsh-plugin.org、GitHub 那一行用于反映插件运行时对 github.com 的可达性。
         // 流式（NDJSON）逐条上报：每个探测先发命令行，完成后发结果行，客户端以黑窗口终端实时展示。
         // 可选 body { key }：只重测指定通道（页面列表「重测」单项时用），缺省全量串行探测。
         let onlyKey = ''
@@ -112,8 +111,8 @@ export function registerDiagnosticsRoutes(webServer: WebServerService, profile:
         // npm 通道：设置里配置了镜像源就探测该镜像（安装通道吃同一个 registry）；
         // 未配置（空串）时探测官方源作为「跟随本机 npm 配置」的基础连通性参考。
         const registry = settings.npmRegistry.replace(/\/+$/, '') || 'https://registry.npmjs.org'
-        // 连通性自检直接打安装通道真实访问的轻量资源：npm 源拉包元数据、git 通道探
-        // 仓库主页、目录站探 badge 小文件，避免拉取目录全量 JSON。
+        // 连通性自检打各通道的轻量资源：npm 源拉包元数据、GitHub 行探小仓库、目录站探
+        // 小文件，避免拉取目录全量 JSON。
         // npm 行 display：配置了镜像就显示镜像地址；未配置置空 —— 客户端显示「未配置（跟随本机 npm 配置）」。
         const allChecks: Array<{ key: string; url: string; display: string; cmd: string; proxy?: string; git?: boolean }> = [
           { key: 'npm', url: `${registry}/dsh-plugin`, display: settings.npmRegistry !== '' ? registry : '', cmd: `npm view dsh-plugin version --registry ${registry}` },