dsh-plugin 1.6.10 → 1.6.12

package/lib/services/install/registry-check.js

@@ -0,0 +1,78 @@
+/**
+ * DSH Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
+ * 官方 registry 存在性复核：用官方源（绕开本机镜像）复查 404 的包，产出标记行区分
+ * 「profile 残留依赖」「插件依赖在官方源也不存在（作者侧）」「本机镜像未同步」三种情形；
+ * 标记由 task-queue 追加到任务输出，前端按标记归类。fetch 与 profile 目录可注入，便于单测。
+ */
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+/** pnpm 输出里 scope 包是 URL 编码形态（`@scope%2Fname`）：比较依赖名、拼查询 URL 前先还原成
+ *  `@scope/name`。 */
+function decodePackageName(raw) {
+    return raw.replace(/%40/gi, '@').replace(/%2f/gi, '/');
+}
+/** 从失败输出里提取「registry 上不存在的包名」（含 scope，如 `@scope/name`）：读 404 行的请求路径。
+ *  提取不到返回 null。 */
+export function missingPackageOf(output) {
+    for (const line of output.split(/\r?\n/)) {
+        if (!/ERR_PNPM_FETCH_404|404/.test(line))
+            continue;
+        const m = line.match(/GET\s+https?:\/\/[^\s/]+\/((?:@[^/\s:]+\/)?[^/\s:]+)/);
+        if (m)
+            return decodePackageName(m[1]);
+    }
+    return null;
+}
+/** 读 profile 自己声明的依赖名（profile 目录下 package.json 的 dependencies 键）。读不到返回空数组。 */
+export function profileDependencyNames(profileDir) {
+    try {
+        const raw = JSON.parse(readFileSync(join(profileDir, 'package.json'), 'utf8'));
+        return Object.keys(raw.dependencies ?? {});
+    }
+    catch {
+        return [];
+    }
+}
+/** 官方 registry 上是否存在该包：明确 404 → false（不存在），2xx → true，其余（限流/网络异常）→ null
+ *  —— 判不了就不判，绝不妄下结论。 */
+async function existsOnOfficialRegistry(name, fetchImpl, timeoutMs) {
+    // scope 包的路径要编码：`@scope/name` → `%40scope%2Fname`
+    const url = `https://registry.npmjs.org/${name.replace('@', '%40').replace('/', '%2F')}`;
+    try {
+        const res = await fetchImpl(url, {
+            headers: { accept: 'application/vnd.npm.install-v1+json' },
+            signal: AbortSignal.timeout(timeoutMs),
+        });
+        if (res.status === 404)
+            return false;
+        return res.ok ? true : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 产出「包不存在」失败的责任方标记行；判不了返回 null（前端维持既有提示）。
+ * - `[registry-missing]`     缺的包在官方源上也不存在 → 作者侧问题（前端引导投作者）
+ * - `[registry-mirror-lag]`  官方源上有 → 本机镜像源未同步（前端提示换源，不投任何一方）
+ */
+export async function registryMissingMarker(output, opts) {
+    const name = missingPackageOf(output);
+    if (name === null)
+        return null;
+    // ① profile 自己声明的残留依赖（#73）：用户环境问题，交给既有的 pnpmMissingDep 提示（该提示就是
+    // 教用户删 profile 里那条依赖），这里不再产出标记、不改归属
+    if (profileDependencyNames(opts.profileDir).some((dep) => dep.toLowerCase() === name.toLowerCase()))
+        return null;
+    const exists = await existsOnOfficialRegistry(name, opts.fetchImpl ?? fetch, opts.timeoutMs ?? 8000);
+    if (exists === false) {
+        return `[registry-missing] ${name} is not published on the official npm registry (registry.npmjs.org) — a dependency of this plugin is missing or was removed; author-side issue`;
+    }
+    if (exists === true) {
+        return `[registry-mirror-lag] ${name} exists on the official npm registry — the configured registry or mirror has not synced it; local environment issue`;
+    }
+    return null;
+}

package/lib/services/install/task-queue.js

@@ -13,6 +13,7 @@ import { existsSync, readFileSync, statSync } from 'node:fs';
 import { dirname, join, resolve } from 'node:path';
 import { CAPTURE_LIMIT_BYTES, MAX_TASKS, MAX_TASK_LINES } from './install-types.js';
 import { npmTooLowMarker } from './npm-check.js';
+import { registryMissingMarker } from './registry-check.js';
 import { backfillOperationLog } from './operation-log.js';
 import { cleanLine, estimateProgress } from '../profile/progress.js';
 import { hasClientUi, isDshPlugin, mountLoadedEntry, removeLoadedEntry } from '../loader.js';
@@ -131,6 +132,12 @@ function pushLine(task, line) {
         task.progress = Math.max(task.progress, 6 + Math.min(79, task.lines.length * 2));
     }
 }
+/** spawn 的 cwd：profile 目录（asar 路径不能作 cwd）；目录不存在时回退进程工作目录，
+ *  否则 Node 报的是 `spawn <file> ENOENT`，与「可执行文件不存在」无法区分。 */
+function spawnCwdFor(profile) {
+    const dir = profileDirectory(profile);
+    return existsSync(dir) ? dir : process.cwd();
+}
 function cliInvocation(profile) {
     const entry = process.argv[1];
     if (entry !== undefined) {
@@ -144,8 +151,8 @@ function cliInvocation(profile) {
             return {
                 file: process.execPath,
                 prefixArgs: ['--expose-internals', bootstrap],
-                // 工作目录用 profile 目录（真实存在的目录）：asar 内的路径不能作为 spawn 的 cwd
-                cwd: profileDirectory(profile),
+                // cwd 用 profile 目录（asar 路径不能作 cwd），不存在时由 spawnCwdFor 回退
+                cwd: spawnCwdFor(profile),
                 useShell: false,
                 // Electron 可执行文件只有带这个变量才按 Node 运行引导脚本
                 env: { ELECTRON_RUN_AS_NODE: '1' },
@@ -426,15 +433,20 @@ function spawnMutation(options) {
             });
         }
         catch (error) {
+            const detail = error instanceof Error ? error.message : String(error);
+            // 宿主自身入口起不来 → 补标记，前端据此归因
+            const marker = hostSpawnMarker(invocation, error);
             if (task) {
                 task.status = 'failed';
                 task.exitCode = null;
-                pushLine(task, `[error] ${error instanceof Error ? error.message : String(error)}`);
+                pushLine(task, `[error] ${detail}`);
+                if (marker !== null)
+                    pushLine(task, marker);
             }
             resolveOnce({
                 exitCode: null,
                 timedOut: false,
-                error: error instanceof Error ? error.message : String(error),
+                error: marker === null ? detail : `${detail}\n${marker}`,
                 stdout,
                 stderr,
             });
@@ -514,12 +526,16 @@ function spawnMutation(options) {
             }, 3_000);
         });
         child.once('error', (error) => {
+            // 同同步抛出那条路径：宿主自身入口起不来 → 补标记
+            const marker = hostSpawnMarker(invocation, error);
             if (task && task.status !== 'cancelled') {
                 task.status = 'failed';
                 task.exitCode = null;
                 pushLine(task, `[error] ${error.message}`);
+                if (marker !== null)
+                    pushLine(task, marker);
             }
-            settleOnce({ exitCode: null, timedOut: false, error: error.message, stdout, stderr });
+            settleOnce({ exitCode: null, timedOut: false, error: marker === null ? error.message : `${error.message}\n${marker}`, stdout, stderr });
         });
         child.once('close', (code) => {
             settleOnce({ exitCode: code, timedOut, error: null, stdout, stderr });
@@ -681,6 +697,32 @@ function annotateNpmTooLow(result, options) {
         pushLine(options.task, line);
     return { ...result, stderr: `${result.stderr}\n${line}`, error: result.error ? `${result.error}\n${line}` : line };
 }
+/** 安装失败且日志含 404 时，用官方源复查一次并注入标记（逻辑见 registry-check.ts）。
+ *  异步是因为要联网；只在失败路径上发生。 */
+async function annotateRegistryMissing(result, options) {
+    if (options.action === 'remove' || result.exitCode === 0 || result.timedOut)
+        return result;
+    const line = await registryMissingMarker(`${result.stderr}\n${result.stdout}`, {
+        profileDir: profileDirectory(options.profile),
+    });
+    if (line === null)
+        return result;
+    if (options.task && options.task.status !== 'cancelled')
+        pushLine(options.task, line);
+    return { ...result, stderr: `${result.stderr}\n${line}`, error: result.error ? `${result.error}\n${line}` : line };
+}
+/**
+ * 宿主自身 CLI 调不起来时的 ASCII 标记行：spawn 我们解析出的宿主入口报 ENOENT 时返回
+ * `[host-spawn]`，供前端单独归因、不引导提 Issue。PATH 上的 dsh/npm 各有自己的标记，返回 null。
+ * 导出供单测覆盖判据。
+ */
+export function hostSpawnMarker(invocation, error) {
+    if (error?.code !== 'ENOENT')
+        return null;
+    if (invocation.file === 'dsh' || invocation.file === 'npm')
+        return null;
+    return `[host-spawn] the DSH host could not be launched (${invocation.file}: ENOENT)`;
+}
 /**
  * Run a plugin mutation with one recovery path: when `add` fails because
  * pnpm's allowBuilds gate blocks a build script — either the git-hosted
@@ -765,6 +807,8 @@ export async function runPluginMutation(options) {
             result = { ...result, stderr: `${result.stderr}\n${backfilled}` };
         }
     }
+    // 包在 registry 不存在（404）→ 官方源复查，区分「作者的依赖缺失/包被删」与「本机镜像源滞后」
+    result = await annotateRegistryMissing(result, options);
     // npm arborist edgesOut 崩溃 + 本机 npm 版本过低 → 追加 [npm-too-low] 标记，前端据此给准确原因
     return annotateNpmTooLow(result, options);
 }

package/lib/types/services/install/registry-check.d.ts

@@ -0,0 +1,15 @@
+/** 从失败输出里提取「registry 上不存在的包名」（含 scope，如 `@scope/name`）：读 404 行的请求路径。
+ *  提取不到返回 null。 */
+export declare function missingPackageOf(output: string): string | null;
+/** 读 profile 自己声明的依赖名（profile 目录下 package.json 的 dependencies 键）。读不到返回空数组。 */
+export declare function profileDependencyNames(profileDir: string): string[];
+/**
+ * 产出「包不存在」失败的责任方标记行；判不了返回 null（前端维持既有提示）。
+ * - `[registry-missing]`     缺的包在官方源上也不存在 → 作者侧问题（前端引导投作者）
+ * - `[registry-mirror-lag]`  官方源上有 → 本机镜像源未同步（前端提示换源，不投任何一方）
+ */
+export declare function registryMissingMarker(output: string, opts: {
+    profileDir: string;
+    fetchImpl?: typeof fetch;
+    timeoutMs?: number;
+}): Promise<string | null>;

package/lib/types/services/install/task-queue.d.ts

@@ -1,4 +1,4 @@
-import type { InstallResult, InstallTask } from './install-types.ts';
+import type { InstallResult, InstallTask, Invocation } from './install-types.ts';
 import type { LoaderHandle } from '../loader.ts';
 /** Snapshot of a task (keeps the live object untouched by consumers). */
 export declare function getTask(id: number): InstallTask | undefined;
@@ -78,6 +78,12 @@ export declare function verifyInstalledEntry(profile: string, target: string): {
     name: string | null;
     missing: string | null;
 };
+/**
+ * 宿主自身 CLI 调不起来时的 ASCII 标记行：spawn 我们解析出的宿主入口报 ENOENT 时返回
+ * `[host-spawn]`，供前端单独归因、不引导提 Issue。PATH 上的 dsh/npm 各有自己的标记，返回 null。
+ * 导出供单测覆盖判据。
+ */
+export declare function hostSpawnMarker(invocation: Invocation, error: unknown): string | null;
 /**
  * Run a plugin mutation with one recovery path: when `add` fails because
  * pnpm's allowBuilds gate blocks a build script — either the git-hosted

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin",
-  "version": "1.6.10",
+  "version": "1.6.12",
   "description": "A community plugin marketplace for DeepSeek Harness, built to the official plugin spec — browse, search and install 10000+ human-curated community plugins without leaving the app. · DeepSeek Harness 社区插件市场（遵循官方开发规范）：10000+ 人工精选社区插件，每日更新。",
   "type": "module",
   "main": "lib/index.js",

package/src/client/components/PluginHubSection.tsx

@@ -27,7 +27,7 @@ import { HubUpdateModal } from './modals/HubUpdateModal.tsx'
 import { InstalledDetailModal } from './modals/InstalledDetailModal.tsx'
 import { NotificationsModal } from './modals/NotificationsModal.tsx'
 import { addFailure, addSuccess, addUpdateNotice, clearNotifications, ignoreUpdate, loadIgnoredUpdates, loadNotifications, removeNotification, removeUpdateNotice } from '../logic/failures.ts'
-import type { NotificationRecord } from '../logic/failures.ts'
+import type { FailureAction, NotificationRecord } from '../logic/failures.ts'
 import { CatalogHeader } from './layout/CatalogHeader.tsx'
 import { MarketView } from './views/MarketView.tsx'
 import { SectionTabs } from './layout/SectionTabs.tsx'
@@ -114,8 +114,8 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
   const [uninstallNeedsReload, setUninstallNeedsReload] = useState(false)
   /** 结果视图「立即重启」：请求宿主重启后进入等待，服务回来后整页刷新 */
   const [restarting, setRestarting] = useState(false)
-  /** 操作失败完整信息 + 所属插件仓库 + 失败类型（决定弹窗标题「安装失败/卸载失败」）+ 实际执行的安装命令 + 尝试过的安装方式（issue 预填用） */
-  const [errorMsg, setErrorMsg] = useState<{ message: string; repo: string | null; kind: 'install' | 'uninstall'; command?: string; attempts?: string[] } | null>(null)
+  /** 操作失败信息 + 归属仓库 + 动作（决定弹窗标题与上报措辞）+ 命令与尝试记录（issue 预填用） */
+  const [errorMsg, setErrorMsg] = useState<{ message: string; repo: string | null; action: FailureAction; command?: string; attempts?: string[] } | null>(null)
   /** 通知中心记录：localStorage 持久化，每次安装/卸载任务成败都留痕（启动时读回） */
   const [notifications, setNotifications] = useState<NotificationRecord[]>(() => loadNotifications())
   /** 通知中心弹窗：一级导航「设置」tab 后边的铃铛入口按钮打开 */
@@ -173,7 +173,8 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
       // 提 Issue 目标先反查仓库身份：npm 包名能在已安装表/目录里反查到 owner/repo 才保留，
       // 反查不到置 null —— 错误弹窗据此不显示「一键提 Issue」按钮（防提到错误仓库）
       const issueRepo = issueRepoOf(repo ?? '', catalog.installedItems, catalog.plugins)
-      setErrorMsg({ message, repo: issueRepo, kind, command, attempts })
+      // 动作：更新失败要显示「更新失败」，其余按安装/卸载
+      setErrorMsg({ message, repo: issueRepo, action: update ? 'update' : kind, command, attempts })
       // 失败自动写入通知记录：任务在后台结束时没人盯着也能留痕。
       // 存原始 repo（可能只是裸包名）而非反查结果 —— 反查只服务于提 Issue，
       // 通知中心的展示反查由 NotificationsModal 做、查不到会回退显示原始值，
@@ -793,7 +794,7 @@ export function PluginHubSection({ t: _hostT, locale }: SectionProps) {
     errorMsg && h(ErrorModal, {
       message: errorMsg.message,
       repo: errorMsg.repo,
-      kind: errorMsg.kind,
+      action: errorMsg.action,
       command: errorMsg.command,
       attempts: errorMsg.attempts,
       t,

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

@@ -18,7 +18,7 @@ import type { MouseEvent } from 'react'
 import styles from '../../styles/Modal.module.css'
 import type { EnvInfo, Translate } from '../../types.ts'
 import type { NotificationRecord } from '../../logic/failures.ts'
-import { classifyFailure, missingRegistryPackageOf, npmTooLowVersion, pnpmPolicyHintOf, pnpmPolicyHintParams, unreachableTargetOf, registryHostOf } from '../../logic/failures.ts'
+import { actionOfRecord, classifyFailure, missingRegistryPackageOf, npmTooLowVersion, pnpmPolicyHintOf, pnpmPolicyHintParams, registryMissingHintOf, unreachableTargetOf, registryHostOf } from '../../logic/failures.ts'
 import type { PendingRestart, QueueTask } from '../../hooks/useTaskQueue.ts'
 import { pluginIssueUrl, pluginSiteUrl, hubIssueUrl } from '../../logic/urls.ts'
 import { CloseIcon } from '../ui/icons.tsx'
@@ -255,6 +255,9 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                   // 卡片不展示错误日志预览，完整日志靠「复制完整日志」按钮带走，避免每条卡片被日志撑高
                   !r.ok && (() => {
                     const kind = classifyFailure(r.message)
+                    // 动作词：该条提示与上报正文按真实动作取词
+                    const action = actionOfRecord(r)
+                    const actionWord = t(action === 'uninstall' ? 'actionUninstall' : action === 'update' ? 'actionUpdate' : 'actionInstall')
                     if (kind === 'npmTooOld') {
                       // npm 内部崩溃（edgesOut）＋ 本机 npm 版本过低：npm 自身已知缺陷，不是插件问题 ——
                       // 直接给升级指引，不引导提 Issue
@@ -311,7 +314,24 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                       const pkg = missingRegistryPackageOf(r.message)
                       return h('div', null, [
                         pkg ? h('div', { className: styles.failNetworkTarget }, t('failPnpmMissingDepTarget', { pkg })) : null,
-                        h('div', { className: styles.failPrepareHint }, t('failPnpmMissingDepHint')),
+                        h('div', { className: styles.failPrepareHint }, t(registryMissingHintOf(r.message))),
+                      ])
+                    }
+                    if (kind === 'pluginMissingDep') {
+                      // 服务端用**官方** registry 复核过：插件依赖树里的包在官方源上也不存在，且不是用户
+                      // profile 的残留依赖 → 作者侧问题（依赖没发布/已被删除），引导到插件作者仓库提 Issue
+                      //（判据是源上的客观存在性，不是我们的启发式判断，故不设「市场误判」次要入口）
+                      const pkg = missingRegistryPackageOf(r.message)
+                      return h('div', null, [
+                        pkg ? h('div', { className: styles.failNetworkTarget }, t('failPluginMissingDepTarget', { pkg })) : null,
+                        h('div', { className: styles.failPrepareHint }, t('failPluginMissingDepHint')),
+                        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,
                       ])
                     }
                     if (kind === 'registryVersionStale') {
@@ -356,7 +376,7 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                         // registry 被指向内网/自定义源（tarball 从非官方源下载失败）：直接给出换源指引，
                         // 否则用户外网是通的会困惑「为什么连不上」
                         (() => { const host = registryHostOf(r.message); return host ? h('div', { className: styles.failPrepareHint }, t('failNetworkRegistryHint', { host })) : null })(),
-                        h('div', { className: styles.failPrepareHint }, t('failNetworkHint')),
+                        h('div', { className: styles.failPrepareHint }, t('failNetworkHint', { action: actionWord })),
                         onRunDiagnostics ? h('button', {
                           className: styles.failDiagBtn,
                           onClick: onRunDiagnostics,
@@ -370,7 +390,7 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                         h('div', { className: styles.failPrepareHint }, /\[packaging\]/i.test(r.message) ? t('failPackagingHint') : t('failPrepareHint')),
                         r.repo && shownRepo ? h('a', {
                           className: styles.failBigIssue,
-                          href: pluginIssueUrl(shownRepo, r.message, env, r.command, r.attempts),
+                          href: pluginIssueUrl(shownRepo, r.message, env, r.command, r.attempts, action),
                           target: '_blank',
                           rel: 'noopener noreferrer',
                           title: t('failIssueHint'),
@@ -381,7 +401,7 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                           h('div', { className: styles.failPrepareHint }, t('failMisjudgeHint')),
                           h('a', {
                             className: styles.failMisjudgeLink,
-                            href: hubIssueUrl(shownRepo, r.message, env, r.command, r.attempts, 'misjudge'),
+                            href: hubIssueUrl(shownRepo, r.message, env, r.command, r.attempts, 'misjudge', action),
                             target: '_blank',
                             rel: 'noopener noreferrer',
                             title: t('failHubIssueHint'),
@@ -392,7 +412,7 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                     if (kind === 'hubState') {
                       // 插件中心的列表状态已过期（安装器自身守卫消息）：非插件问题、也不是 bug，只给可行动提示，不引导提 Issue
                       return h('div', null, [
-                        h('div', { className: styles.failPrepareHint }, t('failHubStateHint')),
+                        h('div', { className: styles.failPrepareHint }, t('failHubStateHint', { action: actionWord })),
                       ])
                     }
                     if (kind === 'timeout') {
@@ -404,17 +424,23 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                     if (kind === 'profileLock') {
                       // DSH 写 profile 的锁超时（同一 profile 被别的 dsh/安装任务占着）：只给可行动提示，不引导提 Issue
                       return h('div', null, [
-                        h('div', { className: styles.failPrepareHint }, t('failProfileLockHint')),
+                        h('div', { className: styles.failPrepareHint }, t('failProfileLockHint', { action: actionWord })),
+                      ])
+                    }
+                    if (kind === 'hostCliSpawn') {
+                      // 宿主自身入口起不来：环境问题，给提示、不引导提 Issue
+                      return h('div', null, [
+                        h('div', { className: styles.failPrepareHint }, t('failHostCliSpawnHint')),
                       ])
                     }
                     // pnpm allowBuilds 拦截与未知失败：不归到插件作者，改为引导到插件中心仓库排查
                     return h('div', null, [
                       kind === 'pnpmIgnoredBuild'
                         ? h('div', { className: styles.failPrepareHint }, t('failIgnoredBuild'))
-                        : h('div', { className: styles.failPrepareHint }, t('failUnclassifiedHint')),
+                        : 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),
+                        href: hubIssueUrl(shownRepo || r.repo, r.message, env, r.command, r.attempts, 'triage', action),
                         target: '_blank',
                         rel: 'noopener noreferrer',
                         title: t('failHubIssueHint'),

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

@@ -17,7 +17,8 @@ import { CloseIcon, ConfirmIcon, CopyIcon, LinkIcon } from '../ui/icons.tsx'
 import { ProgressView } from './ProgressView.tsx'
 import { installCommandOf } from '../../logic/install-command.ts'
 import { pluginDetailUrl, pluginIssueUrl, pluginSiteUrl, hubIssueUrl } from '../../logic/urls.ts'
-import { classifyFailure, missingRegistryPackageOf, npmTooLowVersion, pnpmPolicyHintOf, pnpmPolicyHintParams, unreachableTargetOf, registryHostOf } from '../../logic/failures.ts'
+import { classifyFailure, missingRegistryPackageOf, npmTooLowVersion, pnpmPolicyHintOf, pnpmPolicyHintParams, registryMissingHintOf, unreachableTargetOf, registryHostOf } from '../../logic/failures.ts'
+import type { FailureAction } from '../../logic/failures.ts'
 
 /** 完成结果视图：绿色对勾 + 标题/描述；
  *  终态只有两种：
@@ -336,12 +337,11 @@ export function UninstallModal(props: UninstallModalProps) {
   )
 }
 
-/** 预填插件仓库的 GitHub Issue 链接：标题带插件名，正文附完整错误信息，方便用户一键反馈。 */
-/** 安装/卸载失败弹窗：布局与失败记录一致（类型徽标 + 仓库超链接 + 隐蔽复制按钮），报错完整展示，底部一键提交 Issue。 */
-export function ErrorModal({ message, repo, kind, command, attempts, t, env, onCopy, onClose, onRunDiagnostics }: {
+/** 安装/更新/卸载失败弹窗：标题、徽标、提示文案与 issue 正文都按传入的动作取词。 */
+export function ErrorModal({ message, repo, action, command, attempts, t, env, onCopy, onClose, onRunDiagnostics }: {
   message: string
   repo: string | null
-  kind: 'install' | 'uninstall'
+  action: FailureAction
   command?: string
   /** 尝试过的安装方式（npm 反查 + 实际执行命令）：issue 预填一并贴给作者，便于反推正确的 npm 包名 */
   attempts?: string[]
@@ -354,6 +354,8 @@ export function ErrorModal({ message, repo, kind, command, attempts, t, env, onC
 }) {
   // 失败归类：当前安装通道（npm/git）装不上 = 插件分发/依赖的问题，一律引导提 Issue
   const failureKind = classifyFailure(message)
+  // 动作词：标题、徽标与提示里的 {action} 统一取这一个词
+  const actionWord = t(action === 'uninstall' ? 'actionUninstall' : action === 'update' ? 'actionUpdate' : 'actionInstall')
   // 服务端 [npm-too-low] 标记里带的本机 npm 版本（无标记为 null，提示文案降级为「怀疑」）
   const npmVersion = npmTooLowVersion(message)
   // 复制完整错误：实际执行/尝试过的安装命令（如有）+ 完整错误正文。
@@ -372,8 +374,9 @@ export function ErrorModal({ message, repo, kind, command, attempts, t, env, onC
   },
     h('div', { className: styles.errorModal, role: 'dialog', 'aria-modal': 'true' },
       h('div', { className: styles.modalHead },
-        // 标题按操作类型明确区分：安装失败 / 卸载失败
-        h('div', { className: styles.errorTitle }, kind === 'install' ? t('errorTitleInstall') : t('errorTitleUninstall')),
+        // 标题按动作明确区分：安装失败 / 更新失败 / 卸载失败
+        h('div', { className: styles.errorTitle },
+          t(action === 'uninstall' ? 'errorTitleUninstall' : action === 'update' ? 'errorTitleUpdate' : 'errorTitleInstall')),
         h('button', {
           className: styles.modalClose,
           'aria-label': t('errorClose'),
@@ -385,8 +388,8 @@ export function ErrorModal({ message, repo, kind, command, attempts, t, env, onC
         h('div', { className: styles.failRow },
           h('div', { className: styles.failHead },
             h('span', {
-              className: kind === 'install' ? styles.failKindInstall : styles.failKindUninstall,
-            }, kind === 'install' ? t('install') : t('uninstall')),
+              className: action === 'install' ? styles.failKindInstall : styles.failKindUninstall,
+            }, actionWord),
             // 仓库地址（用户名/仓库）统一显示为可点击超链接，跳转到官网详情页（含插件收录信息），而非直接跳 GitHub
             repo ? h('a', {
               className: styles.failRepo,
@@ -444,7 +447,25 @@ export function ErrorModal({ message, repo, kind, command, attempts, t, env, onC
                   const pkg = missingRegistryPackageOf(message)
                   return pkg ? h('div', { className: styles.failNetworkTarget }, t('failPnpmMissingDepTarget', { pkg })) : null
                 })(),
-                h('div', { className: styles.failPrepareHint }, t('failPnpmMissingDepHint')),
+                h('div', { className: styles.failPrepareHint }, t(registryMissingHintOf(message))),
+              ])
+              : failureKind === 'pluginMissingDep'
+              // 服务端用**官方** registry 复核过：插件依赖树里的某个包在官方源上也不存在，且不是用户
+              // profile 的残留依赖 → 作者侧问题（依赖没发布/已被删除）。判据是源上的客观存在性，
+              // 不是我们的启发式判断，故不给「市场误判」次要入口，直接引导到插件作者仓库提 Issue。
+              ? h('div', null, [
+                (() => {
+                  const pkg = missingRegistryPackageOf(message)
+                  return pkg ? h('div', { className: styles.failNetworkTarget }, t('failPluginMissingDepTarget', { pkg })) : null
+                })(),
+                h('div', { className: styles.failPrepareHint }, t('failPluginMissingDepHint')),
+                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,
               ])
               : failureKind === 'registryVersionStale'
               // 要装的版本在「实际执行安装的那个源」里查不到（ERR_PNPM_NO_MATCHING_VERSION / ETARGET）：
@@ -480,7 +501,7 @@ export function ErrorModal({ message, repo, kind, command, attempts, t, env, onC
                 // registry 被指向内网/自定义源（tarball 从非官方源下载失败）：直接给出换源指引，
                 // 否则用户外网是通的会困惑「为什么连不上」
                 (() => { const host = registryHostOf(message); return host ? h('div', { className: styles.failPrepareHint }, t('failNetworkRegistryHint', { host })) : null })(),
-                h('div', { className: styles.failPrepareHint }, t('failNetworkHint')),
+                h('div', { className: styles.failPrepareHint }, t('failNetworkHint', { action: actionWord })),
                 onRunDiagnostics ? h('button', {
                   className: styles.failDiagBtn,
                   onClick: onRunDiagnostics,
@@ -493,7 +514,7 @@ export function ErrorModal({ message, repo, kind, command, attempts, t, env, onC
                 h('div', { className: styles.failPrepareHint }, /\[packaging\]/i.test(message) ? t('failPackagingHint') : t('failPrepareHint')),
                 repo ? h('a', {
                   className: styles.failBigIssue,
-                  href: pluginIssueUrl(repo, message, env, command, attempts),
+                  href: pluginIssueUrl(repo, message, env, command, attempts, action),
                   target: '_blank',
                   rel: 'noopener noreferrer',
                   title: t('failIssueHint'),
@@ -505,7 +526,7 @@ export function ErrorModal({ message, repo, kind, command, attempts, t, env, onC
                   h('div', { className: styles.failPrepareHint }, t('failMisjudgeHint')),
                   h('a', {
                     className: styles.failMisjudgeLink,
-                    href: hubIssueUrl(repo, message, env, command, attempts, 'misjudge'),
+                    href: hubIssueUrl(repo, message, env, command, attempts, 'misjudge', action),
                     target: '_blank',
                     rel: 'noopener noreferrer',
                     title: t('failHubIssueHint'),
@@ -515,7 +536,7 @@ export function ErrorModal({ message, repo, kind, command, attempts, t, env, onC
               : failureKind === 'hubState'
               ? h('div', null, [
                 // 插件中心的列表状态已过期（安装器自身守卫消息）：不是插件问题、也不是 bug，只给可行动提示，不引导提 Issue
-                h('div', { className: styles.failPrepareHint }, t('failHubStateHint')),
+                h('div', { className: styles.failPrepareHint }, t('failHubStateHint', { action: actionWord })),
               ])
               : failureKind === 'timeout'
               ? h('div', null, [
@@ -525,16 +546,21 @@ export function ErrorModal({ message, repo, kind, command, attempts, t, env, onC
               : failureKind === 'profileLock'
               ? h('div', null, [
                 // DSH 写 profile 的锁超时（同一 profile 被别的 dsh/安装任务占着）：给可行动提示，不引导提 Issue
-                h('div', { className: styles.failPrepareHint }, t('failProfileLockHint')),
+                h('div', { className: styles.failPrepareHint }, t('failProfileLockHint', { action: actionWord })),
+              ])
+              : failureKind === 'hostCliSpawn'
+              ? h('div', null, [
+                // 宿主自身入口起不来：环境问题，给提示、不引导提 Issue
+                h('div', { className: styles.failPrepareHint }, t('failHostCliSpawnHint')),
               ])
               : h('div', null, [
                 // pnpm allowBuilds 拦截与未知失败：不归到插件作者，改为引导到插件中心仓库排查
                 failureKind === 'pnpmIgnoredBuild'
                   ? h('div', { className: styles.failPrepareHint }, t('failIgnoredBuild'))
-                  : h('div', { className: styles.failPrepareHint }, t('failUnclassifiedHint')),
+                  : h('div', { className: styles.failPrepareHint }, t('failUnclassifiedHint', { action: actionWord })),
                 h('a', {
                   className: styles.failBigIssue,
-                  href: hubIssueUrl(repo, message, env, command, attempts),
+                  href: hubIssueUrl(repo, message, env, command, attempts, 'triage', action),
                   target: '_blank',
                   rel: 'noopener noreferrer',
                   title: t('failHubIssueHint'),