dsh-plugin 1.6.12 → 2.0.0

package/src/client/components/modals/NotificationsModal.tsx

@@ -3,15 +3,11 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Notification-center dialog: a persistent log of every settled install /
- * remove task — successes and failures alike.
+ * 通知中心弹窗：每个已结算的安装/卸载任务（成功与失败）的持久化清单。
  *
- * Records are written to localStorage at settle time (see logic/failures.ts),
- * so a result is never lost even when the dialog was dismissed or the user
- * was away. Each entry carries a circular status badge (green check for
- * success, red cross for failure) with white glyph and message text;
- * failures keep their copy / fix / file-an-issue actions. Opened from the
- * header entry button (after the Settings tab).
+ * 记录在结算时写入 localStorage（见 logic/failures.ts），即使弹窗被关闭或用户离开，
+ * 结果也不会丢失。每条带圆形状态徽标（成功绿勾、失败红叉，白色图形）与消息文本；
+ * 失败项保留复制/修复/提 Issue 动作。由头部入口按钮（「设置」tab 之后）打开。
  */
 import { createElement as h, useState } from 'react'
 import type { MouseEvent } from 'react'
@@ -336,7 +332,7 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                     }
                     if (kind === 'registryVersionStale') {
                       // 要装的版本在「实际执行安装的那个源」里查不到（ERR_PNPM_NO_MATCHING_VERSION / ETARGET）：
-                      // 常见于镜像滞后 —— 反查包名走设置里的 npmRegistry，实际安装沿用本机 ~/.npmrc 的源；
+                      // 常见于镜像滞后 —— 实际安装沿用本机 ~/.npmrc 的源；
                       // 也可能只是版本号写错。与插件作者无关 —— 给对齐源 / 显式走官方源 / 离线包指引，不引导提 Issue
                       return h('div', { className: styles.failPrepareHint }, t('failRegistryVersionStaleHint'))
                     }
@@ -367,7 +363,7 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                       return h('div', { className: styles.failPrepareHint }, t('failOriginRejectedHint', { profile: env?.profile ?? '<profile>' }))
                     }
                     if (kind === 'network') {
-                      // 安装前预检 / 安装日志里的连接失败（[network] / git fetch 超时 / DNS / TLS）：
+                      // 安装前网络探测 / 安装日志里的连接失败（[network] / git fetch 超时 / DNS / TLS）：
                       // 是本机网络不通或代理有问题，不是插件问题 —— 提示检查网络 + 直达「系统诊断」，
                       // 不引导提 Issue
                       return h('div', null, [
@@ -384,7 +380,7 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                       ])
                     }
                     if (kind === 'pluginPrepare') {
-                      // [packaging]（预检/装后校验拦截：git 分发缺产物）与
+                      // [packaging]（装后校验拦截：分发缺产物）与
                       // prepare 构建脚本实际执行失败：唯一确有证据的插件打包分发问题 —— 引导到插件仓库提 Issue
                       return h('div', null, [
                         h('div', { className: styles.failPrepareHint }, /\[packaging\]/i.test(r.message) ? t('failPackagingHint') : t('failPrepareHint')),
@@ -395,7 +391,7 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                           rel: 'noopener noreferrer',
                           title: t('failIssueHint'),
                         }, t('failIssueBig')) : null,
-                        // 次要入口：这条分支的判据（[packaging] 预检/装后校验、prepare 摘要）是插件中心
+                        // 次要入口：这条分支的判据（[packaging] 装后校验、prepare 摘要）是插件中心
                         // 自己产出的，不是 pnpm 原文 —— 判错时用户会被送去作者仓库、我们永远收不到反馈
                         r.repo && shownRepo ? h('div', null, [
                           h('div', { className: styles.failPrepareHint }, t('failMisjudgeHint')),
@@ -433,11 +429,34 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                         h('div', { className: styles.failPrepareHint }, t('failHostCliSpawnHint')),
                       ])
                     }
-                    // pnpm allowBuilds 拦截与未知失败：不归到插件作者，改为引导到插件中心仓库排查
+                    if (kind === 'pnpmIgnoredBuild') {
+                      // 插件的依赖需要在用户机器上编译原生模块，pnpm 默认拦住；我们已自动放行
+                      // allowBuilds 并重试过一次，仍失败说明任何用户都装不上 —— 属作者侧（发预构建产物 / 走 release 包）
+                      return h('div', null, [
+                        h('div', { className: styles.failPrepareHint }, t('failIgnoredBuild')),
+                        r.repo && shownRepo ? h('a', {
+                          className: styles.failBigIssue,
+                          href: pluginIssueUrl(shownRepo, r.message, env, r.command, r.attempts, action),
+                          target: '_blank',
+                          rel: 'noopener noreferrer',
+                          title: t('failIssueHint'),
+                        }, t('failIssueBig')) : null,
+                        // 这条判定里也有我们的动作（自动放行过 allowBuilds），判错时得留一条回到插件中心的路
+                        r.repo && shownRepo ? h('div', null, [
+                          h('div', { className: styles.failPrepareHint }, t('failMisjudgeHint')),
+                          h('a', {
+                            className: styles.failMisjudgeLink,
+                            href: hubIssueUrl(shownRepo, r.message, env, r.command, r.attempts, 'misjudge', action),
+                            target: '_blank',
+                            rel: 'noopener noreferrer',
+                            title: t('failHubIssueHint'),
+                          }, t('failMisjudgeLink')),
+                        ]) : null,
+                      ])
+                    }
+                    // 未知失败：不归到插件作者，改为引导到插件中心仓库排查
                     return h('div', null, [
-                      kind === 'pnpmIgnoredBuild'
-                        ? h('div', { className: styles.failPrepareHint }, t('failIgnoredBuild'))
-                        : h('div', { className: styles.failPrepareHint }, t('failUnclassifiedHint', { action: actionWord })),
+                      h('div', { className: styles.failPrepareHint }, t('failUnclassifiedHint', { action: actionWord })),
                       h('a', {
                         className: styles.failBigIssue,
                         href: hubIssueUrl(shownRepo || r.repo, r.message, env, r.command, r.attempts, 'triage', action),

package/src/client/components/modals/ProgressView.tsx

@@ -3,10 +3,9 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Inline progress block shared by the install and uninstall dialogs:
- * a real percentage bar (server-estimated, client-polled). No live terminal
- * window — pnpm emits nothing during git clone/build, so a log pane would be
- * empty for most of the run; failures surface their full output in ErrorModal.
+ * 安装与卸载弹窗共用的内联进度块：真实百分比进度条（服务端估算、客户端轮询）。
+ * 不做实时终端窗口 —— pnpm 在 git clone/构建期间几乎无输出，日志面板大部分时间是空的；
+ * 失败时完整输出在 ErrorModal 里展示。
  */
 import { createElement as h } from 'react'
 import styles from '../../styles/Modal.module.css'

package/src/client/components/modals/modals.tsx

@@ -3,11 +3,9 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Dialog layer for the Plugin Hub: the install-confirm dialog, the uninstall
- * dialog and the global toast. Both dialogs lock themselves while a mutation
- * is running, then switch to a result view with a single action — "done" for
- * the common case (the page refreshes on close so the change applies), or a
- * single "restart now" for the rare changes a refresh cannot pick up.
+ * 插件中心的弹窗层：安装确认弹窗、卸载弹窗与全局 Toast。两个弹窗在变更执行期间
+ * 自我锁定，随后切到只有一个动作的结果视图 —— 常见情况给「完成」（关闭时刷新页面即生效），
+ * 刷新解决不了的少数情况才给单个「立即重启」。
  */
 import { createElement as h } from 'react'
 import type { MouseEvent } from 'react'
@@ -343,7 +341,7 @@ export function ErrorModal({ message, repo, action, command, attempts, t, env, o
   repo: string | null
   action: FailureAction
   command?: string
-  /** 尝试过的安装方式（npm 反查 + 实际执行命令）：issue 预填一并贴给作者，便于反推正确的 npm 包名 */
+  /** 实际执行/重试过的安装命令：issue 预填一并贴给作者 */
   attempts?: string[]
   t: Translate
   env: EnvInfo | null
@@ -352,7 +350,7 @@ export function ErrorModal({ message, repo, action, command, attempts, t, env, o
   /** 网络不通时的「去系统诊断」直达按钮：跳到设置 → 系统诊断跑连通性检测（由宿主提供） */
   onRunDiagnostics?: () => void
 }) {
-  // 失败归类：当前安装通道（npm/git）装不上 = 插件分发/依赖的问题，一律引导提 Issue
+  // 失败归类：装不上 = 插件分发/依赖的问题，一律引导提 Issue
   const failureKind = classifyFailure(message)
   // 动作词：标题、徽标与提示里的 {action} 统一取这一个词
   const actionWord = t(action === 'uninstall' ? 'actionUninstall' : action === 'update' ? 'actionUpdate' : 'actionInstall')
@@ -469,7 +467,7 @@ export function ErrorModal({ message, repo, action, command, attempts, t, env, o
               ])
               : failureKind === 'registryVersionStale'
               // 要装的版本在「实际执行安装的那个源」里查不到（ERR_PNPM_NO_MATCHING_VERSION / ETARGET）：
-              // 常见于镜像滞后 —— 反查包名走设置里的 npmRegistry，实际安装沿用本机 ~/.npmrc 的源，
+              // 常见于镜像滞后 —— 实际安装沿用本机 ~/.npmrc 的源，
               // 官方源刚发布而镜像还没同步；也可能只是版本号写错。与插件作者无关 ——
               // 给「对齐源 / 那一次显式走官方源 / 用离线包」的指引，不引导提 Issue
               ? h('div', { className: styles.failPrepareHint }, t('failRegistryVersionStaleHint'))
@@ -492,7 +490,7 @@ export function ErrorModal({ message, repo, action, command, attempts, t, env, o
               // 安装流程，与插件无关 —— 引导从本机地址重新打开市场，不引导提 Issue
               ? h('div', { className: styles.failPrepareHint }, t('failOriginRejectedHint', { profile: env?.profile ?? '<profile>' }))
               : failureKind === 'network'
-              // 安装前预检 / 安装日志里的连接失败（[network] / git fetch 超时 / DNS / TLS）：
+              // 安装前网络探测 / 安装日志里的连接失败（[network] / git fetch 超时 / DNS / TLS）：
               // 是本机网络不通或代理有问题，不是插件问题 —— 提示检查网络 + 直达「系统诊断」，
               // 不引导提 Issue
               ? h('div', null, [
@@ -509,7 +507,7 @@ export function ErrorModal({ message, repo, action, command, attempts, t, env, o
               ])
               : failureKind === 'pluginPrepare'
               ? h('div', null, [
-                // [packaging]（预检/装后校验拦截：git 分发缺产物）与
+                // [packaging]（装后校验拦截：分发缺产物）与
                 // prepare 构建脚本实际执行失败：唯一确有证据的插件打包分发问题 —— 引导到插件仓库提 Issue
                 h('div', { className: styles.failPrepareHint }, /\[packaging\]/i.test(message) ? t('failPackagingHint') : t('failPrepareHint')),
                 repo ? h('a', {
@@ -519,7 +517,7 @@ export function ErrorModal({ message, repo, action, command, attempts, t, env, o
                   rel: 'noopener noreferrer',
                   title: t('failIssueHint'),
                 }, t('failIssueBig')) : null,
-                // 次要入口：这条分支的判据（[packaging] 预检/装后校验、prepare 摘要）是插件中心
+                // 次要入口：这条分支的判据（[packaging] 装后校验、prepare 摘要）是插件中心
                 // 自己产出的，不是 pnpm 原文 —— 判错时用户会被送去作者仓库、我们永远收不到反馈，
                 // 故另给一条「可能是市场误判」的反馈通道（正文自我说明它来自哪条分支）
                 repo ? h('div', null, [
@@ -553,11 +551,33 @@ export function ErrorModal({ message, repo, action, command, attempts, t, env, o
                 // 宿主自身入口起不来：环境问题，给提示、不引导提 Issue
                 h('div', { className: styles.failPrepareHint }, t('failHostCliSpawnHint')),
               ])
+              : failureKind === 'pnpmIgnoredBuild'
+              // 该类型的插件依赖需要在用户机器上编译原生模块，pnpm 默认拦住；我们已自动放行
+              // allowBuilds 并重试过一次，仍失败说明任何用户都装不上 —— 属作者侧（发预构建产物 / 走 release 包）。
+              ? h('div', null, [
+                h('div', { className: styles.failPrepareHint }, t('failIgnoredBuild')),
+                repo ? h('a', {
+                  className: styles.failBigIssue,
+                  href: pluginIssueUrl(repo, message, env, command, attempts, action),
+                  target: '_blank',
+                  rel: 'noopener noreferrer',
+                  title: t('failIssueHint'),
+                }, t('failIssueBig')) : null,
+                // 这条判定里也有我们的动作（我们自动放行过 allowBuilds），判错时得留一条回到插件中心的路
+                repo ? h('div', null, [
+                  h('div', { className: styles.failPrepareHint }, t('failMisjudgeHint')),
+                  h('a', {
+                    className: styles.failMisjudgeLink,
+                    href: hubIssueUrl(repo, message, env, command, attempts, 'misjudge', action),
+                    target: '_blank',
+                    rel: 'noopener noreferrer',
+                    title: t('failHubIssueHint'),
+                  }, t('failMisjudgeLink')),
+                ]) : null,
+              ])
               : h('div', null, [
-                // pnpm allowBuilds 拦截与未知失败：不归到插件作者，改为引导到插件中心仓库排查
-                failureKind === 'pnpmIgnoredBuild'
-                  ? h('div', { className: styles.failPrepareHint }, t('failIgnoredBuild'))
-                  : h('div', { className: styles.failPrepareHint }, t('failUnclassifiedHint', { action: actionWord })),
+                // 未分类（hub）：不归到插件作者，改为引导到插件中心仓库分诊
+                h('div', { className: styles.failPrepareHint }, t('failUnclassifiedHint', { action: actionWord })),
                 h('a', {
                   className: styles.failBigIssue,
                   href: hubIssueUrl(repo, message, env, command, attempts, 'triage', action),

package/src/client/components/ui/Dropdown.tsx

@@ -3,13 +3,11 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Button-style dropdown (native <select> replacement).
+ * 按钮式下拉框（替代原生 <select>）。
  *
- * The trigger is a compact toolbar button — hairline border + subtle grey
- * fill + current value + chevron — so it sits naturally next to the other
- * toolbar buttons and takes a single slot of horizontal space. Clicking
- * outside or pressing Esc closes the panel; options get a hover fill and
- * the active one a brand highlight, all driven by the --hub-* tokens.
+ * 触发器是紧凑的工具栏按钮 —— 细边框 + 淡灰填充 + 当前值 + 箭头 —— 与其它工具栏按钮
+ * 并排自然，只占一格横向空间。点击外部或按 Esc 关闭面板；选项有 hover 填充、
+ * 激活项为品牌高亮，全部由 --hub-* 变量驱动。
  */
 import { createElement as h, useEffect, useRef, useState } from 'react'
 import type { JSX } from 'react'

package/src/client/components/ui/Toggle.tsx

@@ -3,9 +3,8 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Compact switch used by the settings rows. Native-button based so it is
- * keyboard focusable and announces state via aria-checked; styling driven
- * by the --hub-* tokens (on = brand fill, off = neutral track).
+ * 设置行用的紧凑开关。基于原生 button，可键盘聚焦并通过 aria-checked 播报状态；
+ * 样式由 --hub-* 变量驱动（开 = 品牌填充，关 = 中性轨道）。
  */
 import { createElement as h } from 'react'
 import styles from '../../styles/Toggle.module.css'

package/src/client/components/ui/icons.tsx

@@ -3,8 +3,7 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Inline SVG icons used across the client. Icons inherit currentColor so
- * they adapt to themes and disabled states automatically.
+ * 客户端各处使用的内联 SVG 图标。图标继承 currentColor，自动适配主题与禁用态。
  */
 import { createElement as h } from 'react'
 import headerStyles from '../../styles/Header.module.css'

package/src/client/components/views/CustomInstallView.tsx

@@ -3,18 +3,12 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Custom install view: a standalone top-level section for manually
- * installing npm packages or GitHub sources outside the catalog. Three
- * installer cards, one per channel — npm package (bare name or a full
- * npm/pnpm install command, including the official global `npm install -g`),
- * GitHub source and the official `dsh plugin ... add <target>` command —
- * each with a placeholder example above the input and its own format check.
- * The cards stay separate so a user never has to guess which format goes
- * where. Finished installs surface in the Installed view, marked as custom.
+ * 自定义安装视图：独立一级板块，用于手动安装目录之外的 npm 包。安装卡片接受裸包名或完整的
+ * npm/pnpm 安装命令（含官方全局 `npm install -g`），输入框上方带示例并自带格式校验。
+ * 装完的插件出现在「已安装」视图，标记为自定义安装。
  *
- * Pure presentational: owns only the three local input/error states; the
- * actual install (custom source, gated by the security toggles) bubbles up
- * via onInstallCustom.
+ * 纯展示组件：只持有本地输入/错误状态；真正的安装（custom 源，受安全开关控制）经
+ * onInstallCustom 上抛。
  */
 import { createElement as h, useState } from 'react'
 import type { FormEvent, MouseEvent } from 'react'
@@ -23,27 +17,14 @@ import modal from '../../styles/Modal.module.css'
 import type { InstallChannel, Translate } from '../../types.ts'
 import { CloseIcon, HelpIcon } from '../ui/icons.tsx'
 
-/* —— 自定义安装输入预检 ——
- * 提交前校验「输入是否符合该通道格式」，识别不了的输入不发请求，就地提示推荐格式。
- * 三个通道严格分开：npm 框认裸包名或完整 npm/pnpm 安装命令（含全局 `npm install -g`），
- * git 框只认 GitHub 地址，命令框只认官方 `dsh plugin --profile <name> <add|update> <target>`
- * （--profile 必填，无 -p 简写；update = 更新已安装目标到最新）。
+/* —— 自定义安装输入校验 ——
+ * 提交前校验「输入是否符合格式」，识别不了的输入不发请求，就地提示推荐格式。
+ * npm 框认裸包名或完整 npm/pnpm 安装命令（含全局 `npm install -g`）。
  * 这里只做格式校验，真正归一化/安装由服务端完成。 */
 
-/** GitHub 地址（带前缀形态）：github:、https://github.com/、git+https://github.com/、git@github.com: */
-const GITHUB_URL_RE = /^(?:github:|https?:\/\/github\.com\/|git\+https?:\/\/github\.com\/|git@github\.com:)([A-Za-z0-9._-]+)\/([A-Za-z0-9._-]+?)(?:\.git)?$/
-/** 裸 owner/repo（npm 包名只有 @scope/pkg 才带斜杠，无 @ 前缀的 a/b 一定是 GitHub 仓库） */
-const GITHUB_BARE_RE = /^[A-Za-z0-9._-]+\/[A-Za-z0-9._-]+$/
 /** npm 包名（含 @scope/pkg） */
 const NPM_PACKAGE_RE = /^(?:@[a-z0-9._-]+\/)?[a-z0-9._-]+$/
 
-/** DSH 命令行前缀（官方唯一形式 `dsh plugin --profile <name> <add|update> <target>`）—— 提取其中的动作与目标。
- * 官方 CLI（apps/cli/src/args.ts，commander）：--profile 为必填长选项（无 -p 简写，省略即报错），
- * 支持 `--profile=<name>` 等号形式；命令大小写不敏感。update = 已安装目标覆盖更新到最新；
- * remove 不走这里（卸载由「已安装」列表的卸载按钮执行，命令框不认卸载动词）。
- * 与 server 端 installTargetOf 口径一致。 */
-const DSH_PLUGIN_CMD_RE = /^dsh\s+plugin\s+--profile(?:\s+|=)\S+\s+(add|update)\s+(.+)$/i
-
 /** npm 全局安装命令（官方 README 格式，如 `npm install -g @deepseek-ai/dsh @deepseek-harness-tui/dsh-tui`）——
  * 提取 -g 之后的包列表；任一包名非法返回 null（交给格式错误提示）。与 server 端 globalNpmPackagesOf 口径一致。 */
 const NPM_GLOBAL_CMD_RE = /^npm\s+(?:install|i)\s+(?:-g|--global)\s+(.+)$/i
@@ -52,14 +33,6 @@ const NPM_GLOBAL_CMD_RE = /^npm\s+(?:install|i)\s+(?:-g|--global)\s+(.+)$/i
  * 提取命令后的包列表；包列表在 splitPackages 里逐个校验。 */
 const NPM_INSTALL_CMD_RE = /^(?:npm\s+(?:install|i)|pnpm\s+(?:add|i|install))\s+(.+)$/i
 
-/** 解析 DSH 命令：返回 { action, target }；非官方命令返回 null（交给格式错误提示）。 */
-function parseDshCommand(raw: string): { action: 'add' | 'update'; target: string } | null {
-  const input = raw.trim()
-  const match = DSH_PLUGIN_CMD_RE.exec(input)
-  if (match === null) return null
-  return { action: match[1].toLowerCase() as 'add' | 'update', target: match[2].trim() }
-}
-
 /** 空格分隔的包列表：逐个按 npm 包名语法校验 + 拒绝以 - 开头的 token（npm 会把 --xxx 当参数而非包名），
  * 任一非法返回 null（交给格式错误提示）。与 server 端 globalNpmPackagesOf 同口径。 */
 function splitPackages(raw: string): string[] | null {
@@ -96,46 +69,28 @@ function parseNpmInput(raw: string): NpmInputParse | null {
   return null
 }
 
-function isGitHubInput(raw: string): boolean {
-  const input = raw.trim()
-  return GITHUB_URL_RE.test(input) || GITHUB_BARE_RE.test(input)
-}
-
-/** 卡片标题旁的「帮助」弹窗：三块卡片各自的标题与格式清单语言包 key。 */
+/** 卡片标题旁的「帮助」弹窗：该卡片的标题与格式清单语言包 key。 */
 const HELP_CARDS = {
   npm: { titleKey: 'npmInstallLabel', contentKey: 'npmInstallHelp' },
-  git: { titleKey: 'gitInstallLabel', contentKey: 'gitInstallHelp' },
-  cmd: { titleKey: 'dshCmdLabel', contentKey: 'dshCmdHelp' },
 } as const
 
 type HelpTarget = keyof typeof HELP_CARDS
 
-export function CustomInstallView({ t, onInstallCustom, enableNpm, enableGit, enableDsh, onOpenSettings, profile }: {
+export function CustomInstallView({ t, onInstallCustom, enableNpm, onOpenSettings }: {
   t: Translate
-  /** 命令行安装：输入 npm 包名 / npm、pnpm 安装命令 / GitHub 地址 / dsh plugin 命令即装
-   *  （custom 源，受安全设置开关控制）。installChannel 必填 = 入口渠道（三张卡片之一）：
-   *  服务端日志/报错提示据此溯源「从哪个入口发起」；opts.globalNpm 表示官方 npm 全局安装
-   *  命令（npm install -g），附带解析出的包列表（仍属 NPM 包入口）。 */
+  /** 命令行安装：输入 npm 包名 / npm、pnpm 安装命令即装（custom 源，受安全设置开关控制）。
+   *  installChannel 必填 = 入口渠道（NPM 包卡片）：服务端日志/报错提示据此溯源「从哪个入口发起」；
+   *  opts.globalNpm 表示官方 npm 全局安装命令（npm install -g），附带解析出的包列表。 */
   onInstallCustom: (raw: string, opts: { installChannel: InstallChannel; globalNpm?: string[] }) => void
-  /** 安全信任三通道开关：关掉后对应输入卡片禁用（不提交），并引导去设置打开 */
+  /** 安全信任开关：关掉后输入卡片禁用（不提交），并引导去设置打开 */
   enableNpm: boolean
-  enableGit: boolean
-  enableDsh: boolean
   /** 引导去「设置 → 安全信任」打开被关闭的通道开关 */
   onOpenSettings: () => void
-  /** 当前 dsh profile 名（宿主 /env 快照）：一键插入的更新命令用它拼 --profile */
-  profile: string
 }) {
   /** 自定义安装：NPM 包输入与格式错误（'' = 无错误） */
   const [npmQuery, setNpmQuery] = useState('')
   const [npmError, setNpmError] = useState('')
-  /** 自定义安装：GitHub 源码输入与格式错误（'' = 无错误） */
-  const [gitQuery, setGitQuery] = useState('')
-  const [gitError, setGitError] = useState('')
-  /** 自定义安装：DSH 命令输入与格式错误（'' = 无错误） */
-  const [cmdQuery, setCmdQuery] = useState('')
-  const [cmdError, setCmdError] = useState('')
-  /** 卡片标题旁「帮助」弹窗：null = 未打开；'npm' | 'git' | 'cmd' = 打开对应卡片的格式清单 */
+  /** 卡片标题旁「帮助」弹窗：null = 未打开；'npm' = 打开该卡片的格式清单 */
   const [helpFor, setHelpFor] = useState<HelpTarget | null>(null)
 
   /** 通道关闭提示行：开关关掉后替代示例与输入行，引导去设置打开 */
@@ -148,9 +103,8 @@ export function CustomInstallView({ t, onInstallCustom, enableNpm, enableGit, en
     }, t('goToSettings')),
   )
 
-  // 三个通道分开校验 —— 识别不了的输入不发请求，就地提示推荐写法。
-  // NPM 框认裸包名或完整 npm/pnpm 命令（含全局 npm install -g，走 globalNpm 通道）；
-  // 命令框只认官方 dsh plugin 命令，提交时剥成裸目标发给服务端。
+  // 只做格式校验 —— 识别不了的输入不发请求，就地提示推荐写法。
+  // NPM 框认裸包名或完整 npm/pnpm 命令（含全局 npm install -g，走 globalNpm 通道）。
   const submitNpm = () => {
     const raw = npmQuery.trim()
     if (!raw) return
@@ -164,36 +118,12 @@ export function CustomInstallView({ t, onInstallCustom, enableNpm, enableGit, en
     setNpmQuery('')
     setNpmError('')
   }
-  const submitGit = () => {
-    const target = gitQuery.trim()
-    if (!target) return
-    if (!isGitHubInput(target)) { setGitError(t('gitInstallInvalid')); return }
-    onInstallCustom(target, { installChannel: 'git' })
-    setGitQuery('')
-    setGitError('')
-  }
-  const submitCmd = () => {
-    const raw = cmdQuery.trim()
-    if (!raw) return
-    const parsed = parseDshCommand(raw)
-    if (parsed === null) { setCmdError(t('dshCmdInvalid', { profile })); return }
-    // add / update 统一走安装流程：目标已安装时弹窗自动转「更新」覆盖重装（服务端 mode=update 放行），
-    // 未安装时即为普通安装 —— 粘贴 `dsh plugin --profile web update dsh-plugin` 这类命令即可更新到最新
-    onInstallCustom(parsed.target, { installChannel: 'dsh' })
-    setCmdQuery('')
-    setCmdError('')
-  }
-  /** 一键插入 DSH Plugin Hub 自身的更新命令：按当前 profile 拼官方命令填进输入框，用户确认后提交 */
-  const insertHubUpdate = () => {
-    setCmdQuery(`dsh plugin --profile ${profile} update dsh-plugin`)
-    setCmdError('')
-  }
 
   return h('div', { className: styles.root },
     // 页面说明：独立一级导航，交代「装完去哪看」
     h('p', { className: styles.desc }, t('customViewDesc')),
-    // 三块卡片（一行一个）：label + 文本框上方示例 + 输入行 + 错误区；
-    // 安全信任开关关掉对应通道时，卡片禁用并显示「前往设置」提示行
+    // NPM 包卡片：label + 文本框上方示例 + 输入行 + 错误区；
+    // 安全信任开关关掉时，卡片禁用并显示「前往设置」提示行
     h('div', { className: styles.installCards },
       // NPM 包：输入包名或原生 npm/pnpm 安装命令即装（含官方全局 npm install -g）
       h('div', { className: enableNpm ? styles.installCard : `${styles.installCard} ${styles.installCardDisabled}` },
@@ -239,94 +169,6 @@ export function CustomInstallView({ t, onInstallCustom, enableNpm, enableGit, en
             npmError ? h('div', { className: styles.installError }, npmError) : null,
           ],
       ),
-      // GitHub 源码：输入仓库地址即装
-      h('div', { className: enableGit ? styles.installCard : `${styles.installCard} ${styles.installCardDisabled}` },
-        h('div', { className: styles.installCardHead },
-          h('span', { className: styles.installLabel }, t('gitInstallLabel')),
-          h('button', {
-            type: 'button',
-            className: styles.installHelpBtn,
-            title: t('installHelp'),
-            'aria-label': t('installHelp'),
-            onClick: () => setHelpFor('git'),
-          }, h(HelpIcon)),
-        ),
-        !enableGit
-          ? channelOffRow
-          : [
-            h('div', { className: styles.installExample }, t('gitInstallExample')),
-            h('div', { className: styles.installRow },
-              h('input', {
-                className: gitError ? `${styles.installInput} ${styles.installInputError}` : styles.installInput,
-                type: 'text',
-                placeholder: t('gitInstallPlaceholder'),
-                value: gitQuery,
-                spellCheck: false,
-                onInput: (e: FormEvent<HTMLInputElement>) => {
-                  setGitQuery((e.target as HTMLInputElement).value)
-                  setGitError('')
-                },
-                onKeyDown: (e: KeyboardEvent) => { if (e.key === 'Enter') submitGit() },
-              }),
-              h('button', {
-                className: styles.installBtn,
-                type: 'button',
-                disabled: gitQuery.trim() === '',
-                onClick: submitGit,
-              }, t('installCliBtn')),
-            ),
-            gitError ? h('div', { className: styles.installError }, gitError) : null,
-          ],
-      ),
-      // 命令卡片：粘贴官方 dsh plugin 命令即装/即更新 —— 只认完整命令
-      // （--profile 必填，可含 = 等号，动词 add/update，剥成裸目标走安装流程）
-      h('div', { className: enableDsh ? styles.installCard : `${styles.installCard} ${styles.installCardDisabled}` },
-        h('div', { className: styles.installCardHead },
-          h('span', { className: styles.installLabel }, t('dshCmdLabel')),
-          h('button', {
-            type: 'button',
-            className: styles.installHelpBtn,
-            title: t('installHelp'),
-            'aria-label': t('installHelp'),
-            onClick: () => setHelpFor('cmd'),
-          }, h(HelpIcon)),
-          // 一键插入 Hub 自身的更新命令：按当前 profile 拼 `dsh plugin --profile <p> update dsh-plugin`
-          // 填入输入框（命令卡片被安全开关禁用时不显示，插入后也提交不了）
-          enableDsh
-            ? h('button', {
-              type: 'button',
-              className: styles.installInsertBtn,
-              onClick: insertHubUpdate,
-            }, t('dshCmdInsertHubUpdate'))
-            : null,
-        ),
-        !enableDsh
-          ? channelOffRow
-          : [
-            h('div', { className: styles.installExample }, t('dshCmdExample', { profile })),
-            h('div', { className: styles.installRow },
-              h('input', {
-                className: cmdError ? `${styles.installInput} ${styles.installInputError}` : styles.installInput,
-                type: 'text',
-                placeholder: t('dshCmdPlaceholder'),
-                value: cmdQuery,
-                spellCheck: false,
-                onInput: (e: FormEvent<HTMLInputElement>) => {
-                  setCmdQuery((e.target as HTMLInputElement).value)
-                  setCmdError('')
-                },
-                onKeyDown: (e: KeyboardEvent) => { if (e.key === 'Enter') submitCmd() },
-              }),
-              h('button', {
-                className: styles.installBtn,
-                type: 'button',
-                disabled: cmdQuery.trim() === '',
-                onClick: submitCmd,
-              }, t('installCliBtn')),
-            ),
-            cmdError ? h('div', { className: styles.installError }, cmdError) : null,
-          ],
-      ),
     ),
     // 帮助弹窗：点卡片标题旁的问号打开 —— 宽窗（720px）把该通道支持的命令格式整行展示，防止折行
     helpFor !== null
@@ -346,7 +188,7 @@ export function CustomInstallView({ t, onInstallCustom, enableNpm, enableGit, en
           h('div', { className: modal.modalBody },
             // 格式清单：一行一条；`命令\t说明` 的说明跟在命令后，纯说明行以 \t 开头
             h('div', { className: styles.helpBody },
-              t(HELP_CARDS[helpFor].contentKey, { profile }).split('\n').map((line, i) => {
+              t(HELP_CARDS[helpFor].contentKey).split('\n').map((line, i) => {
                 const [cmd, note] = line.split('\t')
                 return h('div', { key: i, className: styles.helpLine },
                   cmd !== '' ? h('span', { className: styles.helpCmd }, cmd) : null,

package/src/client/components/views/DiagnosticsView.tsx

@@ -3,12 +3,9 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * System diagnostics list: one row per connectivity channel (npm registry /
- * GitHub API / catalog site), each with a live status badge — 200 OK in
- * green, Unreachable in red, Checking… while probing. The list runs
- * automatically when the page opens; every row is a button that re-probes
- * just that channel, so a click always yields visible feedback
- * (row pulses → badge flips → latency refreshes).
+ * 系统诊断列表：每个连通性通道（npm registry / GitHub API / 目录站点）一行，各带实时
+ * 状态徽标 —— 200 OK 绿、不可达红、探测中显示「检测中…」。页面打开时自动跑一轮；
+ * 每行都是按钮，点击只重测该通道，因此点击总有可见反馈（行脉冲 → 徽标翻转 → 延迟刷新）。
  */
 import { createElement as h, useCallback, useEffect, useRef, useState } from 'react'
 import styles from '../../styles/DiagnosticsView.module.css'

package/src/client/components/views/InstalledView.tsx

@@ -3,18 +3,13 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Installed view: manages the plugins installed into the current profile.
- * Follows the mainstream extension-manager pattern (VSCode Installed tab) —
- * a searchable, sortable list of installed entries that mixes catalog
- * plugins (full metadata) and custom command installs (outside the catalog,
- * only runtime info, tagged with a custom badge). The toolbar carries a
- * search box plus two segmented radio-button groups: source filter
- * (all / catalog / custom) and sort (name / recently installed / stars / forks).
- * Each row carries restart (when pending), update and uninstall actions
- * and opens a detail modal with the full install metadata.
+ * 已安装视图：管理安装进当前 profile 的插件。沿用主流扩展管理器模式（VSCode 已安装 tab）——
+ * 可搜索、可排序的已安装清单，混排目录插件（完整元数据）与命令行自定义安装（目录之外，
+ * 只有运行时信息，打「自定义」徽标）。工具栏含搜索框与两组分段单选：来源筛选
+ * （全部/目录/自定义）与排序（名称/最近安装/Star/Fork）。每行带重启（待重启时）、更新与
+ * 卸载动作，并打开含完整安装元数据的详情弹窗。
  *
- * Pure presentational: owns only local search/sort state; the InstalledItem
- * model arrives from the catalog hook and actions bubble up via callbacks.
+ * 纯展示组件：只持有本地搜索/排序状态；InstalledItem 模型来自目录 hook，动作经回调上抛。
  */
 import { createElement as h, useMemo, useState } from 'react'
 import type { FormEvent, MouseEvent, ReactNode } from 'react'

package/src/client/components/views/MarketView.tsx

@@ -3,10 +3,8 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Market view: the browse experience for the catalog — category tabs,
- * search/sort/install-state controls and the plugin list. Owns nothing;
- * it wires catalog state (query/sort/filter/category) to the small
- * presentational components so PluginHubSection stays free of view internals.
+ * 市场视图：目录的浏览体验 —— 分类 Tab、搜索/排序/安装状态控件与插件列表。自身不持有状态，
+ * 只把目录状态（query/sort/filter/category）接到小型展示组件上，让 PluginHubSection 不掺视图细节。
  */
 import { createElement as h, Fragment } from 'react'
 import type { HubPlugin, LocaleId } from '../../types.ts'