@michengai/dsh-codex-ui 0.2.108 → 0.2.110

package/CHANGELOG.md

@@ -4,6 +4,17 @@
 
 This changelog records recent releases of DSH Codex UI and its one-click installer. Earlier changes remain available in the [Git history](https://github.com/MichengAI/dsh-codex-ui/commits/main).
 
+## 0.2.110 - 2026-09-08
+
+### Fixed
+
+- Distinguished standalone DSH Web installation failures from Desktop errors, directing users to stop and restart the current Web host instead of quitting DSH Desktop.
+- Added localized recovery guidance for locked plugin files, pnpm store conflicts, and otherwise unrecognized DSH Web installation failures.
+
+### Tests
+
+- Added regression coverage for Web-specific installer errors and their Simplified Chinese and English localization.
+
 ## suite-installer-v0.1.27 - 2026-09-07
 
 - Updated the bundled Codex UI to `0.2.108`, including group rename/delete menus and aligned group counts; refreshed exact member versions from the official npm registry.

package/CHANGELOG.zh-CN.md

@@ -4,6 +4,17 @@
 
 本日志记录 DSH Codex UI 及其一键安装器的最近发布；更早的变更可查看 [Git 提交历史](https://github.com/MichengAI/dsh-codex-ui/commits/main)。
 
+## 0.2.110 - 2026-09-08
+
+### 修复
+
+- 区分独立 DSH Web 与 Desktop 的插件安装失败：Web 环境将提示停止并重启当前 Web 宿主，不再错误要求退出 DSH Desktop。
+- 为被占用的插件文件、pnpm 仓库不一致和未识别的 DSH Web 安装失败提供本地化恢复指引。
+
+### 测试
+
+- 新增 Web 专属安装错误及其简体中文、英文文案的回归覆盖。
+
 ## suite-installer-v0.1.27 - 2026-09-07
 
 - 将套件中的 Codex UI 更新至 `0.2.108`，包含分组重命名、删除菜单和数量对齐优化；从官方 npm 刷新并锁定成员版本。

package/lib/client.js

@@ -1955,7 +1955,10 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 		};
 		const INSTALL_ERROR_KEYS = [
 			[/没有进入当前 Profile|did not enter this profile/i, "about.installUnchanged"],
+			[/pnpm 仓库不一致.*停止当前 DSH Web|pnpm store do not match.*stop the current DSH Web/i, "about.installStoreMismatchWeb"],
+			[/停止当前 DSH Web|stop the current DSH Web/i, "about.installExitWeb"],
 			[/完全退出桌面端|无法覆盖正在运行的插件文件|running plugin files|quit DSH Desktop/i, "about.installExitDesktop"],
+			[/DSH Web 终端输出|DSH Web terminal/i, "about.installWebFailed"],
 			[/pnpm 仓库不一致|pnpm store do not match/i, "about.installStoreMismatch"],
 			[/构建脚本策略|build-script policy/i, "about.installBuildPolicy"],
 			[/找不到 pnpm|pnpm (?:is )?not (?:available|found)/i, "about.installPnpmMissing"],
@@ -6823,6 +6826,9 @@ html[data-dcu-official-turn-navigator-supported=true] .dcu-turn-navigator,html:h
 			"about.installUnchanged": "安装命令已结束，但插件没有进入当前 Profile。请重试。",
 			"about.installExitDesktop": "请先完全退出 DSH Desktop，再重新打开后更新。",
 			"about.installStoreMismatch": "插件目录与 pnpm 仓库不一致。请完全退出 DSH Desktop 后再更新。",
+			"about.installExitWeb": "无法覆盖正在运行的插件文件。请停止当前 DSH Web 后，在终端更新插件，再重新启动 DSH Web。",
+			"about.installStoreMismatchWeb": "插件目录与 pnpm 仓库不一致。请停止当前 DSH Web 后重试；仍失败时重新安装该 Profile 的依赖。",
+			"about.installWebFailed": "插件更新失败。请查看 DSH Web 终端输出后重试。",
 			"about.installBuildPolicy": "插件依赖的 pnpm 构建脚本策略尚未确认，请更新 Profile 配置后重试。",
 			"about.installPnpmMissing": "当前环境找不到 pnpm，请安装 pnpm 并重启 DSH 后重试。",
 			"about.installTimeout": "插件安装超时，请检查网络后重试。",
@@ -7026,6 +7032,9 @@ html[data-dcu-official-turn-navigator-supported=true] .dcu-turn-navigator,html:h
 			"about.installUnchanged": "The install command finished, but the plugin did not enter this profile. Try again.",
 			"about.installExitDesktop": "Quit DSH Desktop completely, reopen it, and try the update again.",
 			"about.installStoreMismatch": "The plugin directory and pnpm store do not match. Quit DSH Desktop completely and try again.",
+			"about.installExitWeb": "Running plugin files cannot be replaced. Stop the current DSH Web host, update the plugin from a terminal, then restart DSH Web.",
+			"about.installStoreMismatchWeb": "The plugin directory and pnpm store do not match. Stop the current DSH Web host and try again; if it persists, reinstall this Profile's dependencies.",
+			"about.installWebFailed": "Plugin update failed. Check the DSH Web terminal output and try again.",
 			"about.installBuildPolicy": "The pnpm build-script policy for this plugin is not configured. Update the Profile configuration and try again.",
 			"about.installPnpmMissing": "pnpm is not available. Install pnpm, restart DSH, and try again.",
 			"about.installTimeout": "Plugin installation timed out. Check the network and try again.",

package/lib/index.mjs

@@ -515,13 +515,14 @@ async function waitUntilPluginMounted(packageName, version, runtime, timeoutMs =
 	}
 	throw pluginUnchangedError();
 }
-function pluginCommandError(stderr) {
+function pluginCommandError(stderr, environmentKind = "desktop") {
 	const detail = stderr.replace(/\s+/g, " ").trim();
-	if (/EPERM|EBUSY|EACCES|unable to unlink|ERR_PNPM_LOCKED|Lock/i.test(detail)) return /* @__PURE__ */ new Error("无法覆盖正在运行的插件文件。请先完全退出桌面端，再重新打开后更新。");
-	if (/UNEXPECTED_STORE|Unexpected store location/i.test(detail)) return /* @__PURE__ */ new Error("插件目录和 pnpm 仓库不一致。请完全退出桌面端后再更新。");
+	const isWeb = environmentKind === "cli";
+	if (/EPERM|EBUSY|EACCES|unable to unlink|ERR_PNPM_LOCKED|Lock/i.test(detail)) return /* @__PURE__ */ new Error(isWeb ? "无法覆盖正在运行的插件文件。请停止当前 DSH Web 后，在终端更新插件，再重新启动 DSH Web。" : "无法覆盖正在运行的插件文件。请先完全退出桌面端，再重新打开后更新。");
+	if (/UNEXPECTED_STORE|Unexpected store location/i.test(detail)) return /* @__PURE__ */ new Error(isWeb ? "插件目录与 pnpm 仓库不一致。请停止当前 DSH Web 后重试；仍失败时重新安装该 Profile 的依赖。" : "插件目录和 pnpm 仓库不一致。请完全退出桌面端后再更新。");
 	if (/ERR_PNPM_IGNORED_BUILDS|Ignored build scripts/i.test(detail)) return /* @__PURE__ */ new Error("插件依赖的 pnpm 构建脚本策略尚未确认。请更新 Profile 的 allowBuilds 配置后重试。");
 	if (/pnpm not found|未找到 pnpm/i.test(detail)) return /* @__PURE__ */ new Error("当前环境找不到 pnpm。请确认已安装 pnpm 后重启 DSH 再试。");
-	return /* @__PURE__ */ new Error("无法在应用运行时更新插件。请先完全退出桌面端，再重新打开后更新。");
+	return /* @__PURE__ */ new Error(isWeb ? "插件更新失败。请查看 DSH Web 终端输出后重试。" : "无法在应用运行时更新插件。请先完全退出桌面端，再重新打开后更新。");
 }
 /**
 * 图形界面或桌面启动往往没有 shell PATH。把 pnpm 常见安装目录补进去，
@@ -606,7 +607,7 @@ function disposeDependencyInstaller() {
 	for (const child of activePluginChildren) terminatePluginChild(child);
 	for (const handle of activeDesktopPluginHandles) handle.cancel();
 }
-function monitorPluginChild(child, timeoutMs = PLUGIN_INSTALL_TIMEOUT_MS) {
+function monitorPluginChild(child, timeoutMs = PLUGIN_INSTALL_TIMEOUT_MS, environmentKind = "cli") {
 	return new Promise((resolvePromise, reject) => {
 		activePluginChildren.add(child);
 		let output = "";
@@ -629,7 +630,7 @@ function monitorPluginChild(child, timeoutMs = PLUGIN_INSTALL_TIMEOUT_MS) {
 			finish(/* @__PURE__ */ new Error("无法启动 DSH 插件安装命令。请确认 Node.js 与 pnpm 可用后重试。"));
 		});
 		child.once("exit", (code) => {
-			finish(code === 0 ? void 0 : pluginCommandError(output));
+			finish(code === 0 ? void 0 : pluginCommandError(output, environmentKind));
 		});
 		const timeout = setTimeout(() => {
 			terminatePluginChild(child);
@@ -666,9 +667,9 @@ function monitorDesktopPlugin(handle, timeoutMs = PLUGIN_INSTALL_TIMEOUT_MS) {
 			finish(/* @__PURE__ */ new Error("无法读取 DSH Desktop 插件安装输出。"));
 		});
 		handle.done.then((outcome) => {
-			finish(outcome.exitCode === 0 && outcome.signal === null ? void 0 : pluginCommandError(output));
+			finish(outcome.exitCode === 0 && outcome.signal === null ? void 0 : pluginCommandError(output, "desktop"));
 		}, () => {
-			finish(pluginCommandError(output));
+			finish(pluginCommandError(output, "desktop"));
 		});
 		const timeout = setTimeout(() => {
 			handle.cancel();
@@ -697,7 +698,7 @@ function runDshPlugin(args, runtime = resolveDependencyRuntime(), timeoutMs = PL
 			"pipe",
 			"pipe"
 		]
-	}), timeoutMs);
+	}), timeoutMs, runtime.environmentKind);
 }
 /** 并发安装互斥：pnpm 锁文件竞争会触发 EPERM/EBUSY，同一时间只允许一个安装进程。 */
 let installing = false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@michengai/dsh-codex-ui",
-  "version": "0.2.108",
+  "version": "0.2.110",
   "description": "以 Codex 风格重构 DSH Web 侧栏的独立客户端插件",
   "license": "Apache-2.0",
   "publishConfig": {