@michengai/dsh-codex-ui 0.2.81 → 0.2.82

package/CHANGELOG.md

@@ -4,6 +4,23 @@
 
 This changelog records the five most recent published releases of DSH Codex UI and its one-click Suite. Earlier changes remain available in the [Git history](https://github.com/MichengAI/dsh-codex-ui/commits/main).
 
+## 0.2.82 — 2026-08-24
+
+Companion release: `@michengai/dsh-codex-suite@0.1.14`.
+
+### Fixed
+
+- Replaced the Suite's recommended aggregate install with an installer that records all six members as direct profile dependencies, allowing **Settings → About** to detect and update each plugin independently.
+- Made clean custom Web profiles reuse the same `DSH_HOME` while placing DSH's built-in `dsh-web-app` before the member bundles.
+- When About encounters a legacy aggregate Suite, it now promotes all six members before removing the aggregate package instead of retaining only the clicked plugin.
+
+### Suite 0.1.14
+
+- Added the cross-platform `dsh-codex-suite` command, legacy migration, config-dump validation, and dry-run support.
+- Preserved exact member version coordination without modifying upstream DSH or creating a separate DSH Home.
+
+Published packages: [`@michengai/dsh-codex-ui@0.2.82`](https://www.npmjs.com/package/@michengai/dsh-codex-ui/v/0.2.82) and [`@michengai/dsh-codex-suite@0.1.14`](https://www.npmjs.com/package/@michengai/dsh-codex-suite/v/0.1.14).
+
 ## 0.2.81 — 2026-08-24
 
 Companion release: `@michengai/dsh-codex-suite@0.1.13`.

package/CHANGELOG.zh-CN.md

@@ -4,6 +4,23 @@
 
 本日志记录 DSH Codex UI 及其一键 Suite 最近发布的五个版本；更早的变更可查看 [Git 提交历史](https://github.com/MichengAI/dsh-codex-ui/commits/main)。
 
+## 0.2.82 — 2026-08-24
+
+配套版本：`@michengai/dsh-codex-suite@0.1.14`。
+
+### 修复
+
+- Suite 一键入口改为安装器，将六个成员写成 profile 的直接依赖，使「设置 → 关于」可以分别检测和升级每个插件。
+- 新建自定义 Web profile 时自动复用同一 `DSH_HOME`，并把 DSH 内置 `dsh-web-app` 放在成员 bundle 之前。
+- “关于”页遇到旧版聚合 Suite 时，先把全部六个成员提升为直接依赖，再移除聚合包，避免只保留本次点击的一个插件。
+
+### Suite 0.1.14
+
+- 新增跨平台 `dsh-codex-suite` 命令、旧 Suite 自动迁移、配置 dump 验证和 dry-run。
+- 保留精确成员版本组合，不修改上游 DSH，也不创建独立 DSH Home。
+
+发布包：[`@michengai/dsh-codex-ui@0.2.82`](https://www.npmjs.com/package/@michengai/dsh-codex-ui/v/0.2.82) 与 [`@michengai/dsh-codex-suite@0.1.14`](https://www.npmjs.com/package/@michengai/dsh-codex-suite/v/0.1.14)。
+
 ## 0.2.81 — 2026-08-24
 
 配套版本：`@michengai/dsh-codex-suite@0.1.13`。

package/README.md

@@ -55,7 +55,7 @@ Conversation menu: rename, pin, unread, archive, fork, copy, and delete.
 
 ## Plugin combo
 
-`@michengai/dsh-codex-suite` is the one-click combo. It installs these six plugins into the same profile:
+`@michengai/dsh-codex-suite` provides a one-click installer that adds these six plugins to the same profile as **direct dependencies**:
 
 | Plugin | npm package | Role |
 | --- | --- | --- |
@@ -68,7 +68,7 @@ Conversation menu: rename, pin, unread, archive, fork, copy, and delete.
 
 `dshmarket` stays optional. When it is installed, **Plugins** opens the market first.
 
-Do not install the suite and the individual plugins in the same profile. The two patch sets conflict.
+Direct dependencies let **Settings → About** detect and update every plugin independently. The installer also migrates the legacy aggregate Suite without leaving duplicate patches behind.
 
 ## DSH product ecosystem
 
@@ -92,7 +92,7 @@ Copy one of the sentences below into DSH, Codex, or WorkBuddy and let that agent
 From npm:
 
 ```text
-Install the latest DSH plugin suite @michengai/dsh-codex-suite into my local web profile using the official npm registry: dsh plugin --profile web add @michengai/dsh-codex-suite@latest --registry=https://registry.npmjs.org/. Then run dsh --profile web --dump-config, confirm codex-ui, agency-agents, skills-manager, archive-manager, im-connect, and dsh-automation are mounted, and remind me to restart DSH Web and hard-refresh the browser.
+Use the one-click installer to add all six DSH Codex Suite members as direct dependencies of my local web profile: npx --yes @michengai/dsh-codex-suite@latest --profile web. Confirm its configuration check succeeds, then remind me to restart DSH Web and hard-refresh the browser.
 ```
 
 UI only:
@@ -107,7 +107,7 @@ Install the latest DSH plugin @michengai/dsh-codex-ui into my local web profile
 | Codex | Send one of the sentences above to Codex and let it install locally. |
 | WorkBuddy | Send one of the sentences above to WorkBuddy. |
 
-If `dsh` is not on PATH, replace the leading `dsh` with `npx --yes @deepseek-ai/dsh`.
+The installer needs the current `dsh` on PATH. Set `DSH_BIN` when the executable lives elsewhere.
 
 ### Install the complete suite
 
@@ -116,13 +116,20 @@ This is the one-click combo. Run it from any PowerShell directory:
 ```powershell
 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
 $OutputEncoding = [System.Text.Encoding]::UTF8
-dsh plugin --profile web add @michengai/dsh-codex-suite@latest --registry=https://registry.npmjs.org/
-dsh --profile web --dump-config
+npx --yes @michengai/dsh-codex-suite@latest --profile web
 ```
 
-To pin a release, replace `@latest` with a version such as `@0.1.0`.
+The installer reads the exact member versions verified by that Suite release, adds all six members as direct profile dependencies in one `dsh plugin add`, and finishes with `dsh --profile web --dump-config`. Replace `@latest` with a Suite version to pin the whole set.
+
+Restart DSH Web and hard-refresh the browser. Existing members are aligned in place; a legacy `@michengai/dsh-codex-suite` aggregate dependency is removed only after all six direct members have been staged.
+
+Use the same command with another profile name for a clean custom Web profile:
+
+```powershell
+npx --yes @michengai/dsh-codex-suite@latest --profile codex
+```
 
-Restart DSH Web and hard-refresh the browser. If the profile already has any of the six plugins installed individually, uninstall those plugins first.
+The installer stays in the current `DSH_HOME` and places DSH's built-in `@deepseek-ai/dsh-web-app` before the member bundles. It neither creates a separate Home nor reinstalls the official Web package.
 
 ### Install Codex UI only
 

package/README.zh-CN.md

@@ -55,7 +55,7 @@
 
 ## 插件组合
 
-`@michengai/dsh-codex-suite` 是一键套件，会把下面 6 个插件装进同一个 profile：
+`@michengai/dsh-codex-suite` 提供一键安装器，会把下面 6 个插件作为**直接依赖**装进同一个 profile：
 
 | 插件 | npm 包 | 作用 |
 | --- | --- | --- |
@@ -68,7 +68,7 @@
 
 `dshmarket` 仍是可选项。已安装时，「插件」入口会优先进入市场。
 
-套件安装和单独安装互斥。同一 profile 不要同时安装两者，两套 patch 会冲突。
+直接依赖让「设置 → 关于」能够分别检测和升级每个插件。安装器也会自动迁移旧版聚合 Suite，避免聚合 patch 与独立 patch 冲突。
 
 ## DSH 产品生态
 
@@ -92,7 +92,7 @@ Codex UI 既可以独立安装，也可以随桌面端或 Web 套件一起使用
 从 npm 安装完整套件：
 
 ```text
-请把 DSH 套件 @michengai/dsh-codex-suite 最新版装进本机 web profile，使用官方 npm 源执行：dsh plugin --profile web add @michengai/dsh-codex-suite@latest --registry=https://registry.npmjs.org/。装完执行 dsh --profile web --dump-config，确认已挂载 codex-ui、agency-agents、skills-manager、archive-manager、im-connect 和 dsh-automation，并提醒我重启 DSH Web 后硬刷新浏览器。
+请用一键安装器把 DSH Codex Suite 的六个成员作为直接依赖装进本机 web profile，执行：npx --yes @michengai/dsh-codex-suite@latest --profile web。确认安装器完成配置检查，并提醒我重启 DSH Web 后硬刷新浏览器。
 ```
 
 只安装 Codex UI：
@@ -107,7 +107,7 @@ Codex UI 既可以独立安装，也可以随桌面端或 Web 套件一起使用
 | Codex | 把上面其中一句发给 Codex，让它在本机执行安装。 |
 | WorkBuddy | 把上面其中一句发给 WorkBuddy。 |
 
-未把 `dsh` 装进 PATH 时，把开头的 `dsh` 换成 `npx --yes @deepseek-ai/dsh`。
+一键安装器需要能从 PATH 找到当前 DSH；也可以用 `DSH_BIN` 指定 `dsh` 可执行文件。
 
 ### 安装完整套件
 
@@ -116,13 +116,20 @@ Codex UI 既可以独立安装，也可以随桌面端或 Web 套件一起使用
 ```powershell
 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8
 $OutputEncoding = [System.Text.Encoding]::UTF8
-dsh plugin --profile web add @michengai/dsh-codex-suite@latest --registry=https://registry.npmjs.org/
-dsh --profile web --dump-config
+npx --yes @michengai/dsh-codex-suite@latest --profile web
 ```
 
-需要钉死某一版时，把 `@latest` 换成具体版本，例如 `@0.1.0`。
+安装器会读取该 Suite 版本验证过的精确成员版本，用一次 `dsh plugin add` 将六个成员写成 profile 的直接依赖，并在最后运行 `dsh --profile web --dump-config`。需要钉死一组版本时，把 `@latest` 换成具体 Suite 版本。
+
+安装后重启 DSH Web 并硬刷新浏览器。已有成员会原地对齐版本；旧版 `@michengai/dsh-codex-suite` 聚合依赖会在六个成员提升完成后自动移除。
+
+新建自定义 Web profile 也使用同一命令，只需改 profile 名：
+
+```powershell
+npx --yes @michengai/dsh-codex-suite@latest --profile codex
+```
 
-安装后重启 DSH Web 并硬刷新浏览器。若该 profile 已单独安装上述任一插件，先卸载这些独立插件，再装套件。
+安装器会复用当前 `DSH_HOME`，并把 DSH 自带的 `@deepseek-ai/dsh-web-app` 放到成员 bundle 之前；不会创建独立 Home，也不会重新安装官方 Web 包。
 
 ### 只安装 Codex UI
 

package/dist/index.mjs

@@ -7,10 +7,10 @@ import { randomUUID } from "node:crypto";
 //#region src/dependencies.ts
 const SUITE_PACKAGE = "@michengai/dsh-codex-suite";
 const SUITE_MEMBER_PACKAGES = [
+	"@michengai/dsh-archive-manager",
 	"@michengai/dsh-codex-ui",
-	"@michengai/dsh-agency-agents",
 	"@michengai/dsh-skills-manager",
-	"@michengai/dsh-archive-manager",
+	"@michengai/dsh-agency-agents",
 	"@michengai/dsh-im-connect",
 	"@michengai/dsh-automation"
 ];
@@ -122,6 +122,15 @@ async function installedPackageVersion(packageName) {
 function isManagedPackageInstalled(input) {
 	return input.declared && input.installedVersion !== void 0 && input.installedVersion !== "";
 }
+/** 旧 Suite 对其六个成员拥有声明权；迁移成直接依赖前也应显示真实安装版本。 */
+function isManagedPackageDeclared(packageName, declared) {
+	return declared.includes(packageName) || declared.includes("@michengai/dsh-codex-suite") && SUITE_MEMBER_PACKAGES.includes(packageName);
+}
+/** 更新旧 Suite 中任一成员时，必须一次提升全部成员，避免移除 Suite 后只剩一个插件。 */
+function directPackagesForInstall(requested, declared) {
+	const migrateSuite = declared.includes("@michengai/dsh-codex-suite") && requested.some((packageName) => SUITE_MEMBER_PACKAGES.includes(packageName));
+	return [...new Set(migrateSuite ? [...SUITE_MEMBER_PACKAGES, ...requested] : requested)];
+}
 /** npm latest 查询缓存有效期：避免每次打开“关于”页都打 7 个 registry 请求。 */
 const LATEST_CACHE_TTL_MS = 3e5;
 const latestCache = /* @__PURE__ */ new Map();
@@ -227,7 +236,7 @@ async function dependencyStatuses() {
 	const declaredNames = await declaredPluginNames();
 	return Promise.all(MANAGED_DEPENDENCIES.map(async (dependency) => {
 		const version = await installedPackageVersion(dependency.packageName);
-		const declared = isOfficialRuntimePackage(dependency.packageName) || declaredNames.includes(dependency.packageName);
+		const declared = isOfficialRuntimePackage(dependency.packageName) || isManagedPackageDeclared(dependency.packageName, declaredNames);
 		if (version === void 0 || !isManagedPackageInstalled({
 			installedVersion: version,
 			declared
@@ -454,7 +463,7 @@ async function installDependenciesLocked(ids, requestHotUpdate) {
 		return dependency;
 	});
 	const declared = await declaredPluginNames();
-	const targets = await Promise.all(dependencies.map(async (dependency) => {
+	const requestedTargets = await Promise.all(dependencies.map(async (dependency) => {
 		const latestVersion = await npmLatestVersion(dependency.packageName);
 		if (latestVersion === void 0) throw new Error("无法获取 npm 最新版本，请检查网络或 npm registry 后重试。");
 		const packageName = resolveDshPluginTarget(dependency.packageName, declared);
@@ -465,6 +474,21 @@ async function installDependenciesLocked(ids, requestHotUpdate) {
 			version
 		};
 	}));
+	const requestedVersions = new Map(requestedTargets.map((target) => [target.packageName, target.version]));
+	const targetPackages = directPackagesForInstall(requestedTargets.map((target) => target.packageName), declared);
+	const targets = await Promise.all(targetPackages.map(async (packageName) => {
+		const requestedVersion = requestedVersions.get(packageName);
+		if (requestedVersion !== void 0) return {
+			packageName,
+			version: requestedVersion
+		};
+		const version = await installedPackageVersion(packageName) ?? await npmLatestVersion(packageName);
+		if (version === void 0) throw new Error("无法读取 Suite 成员版本，请检查 npm 安装后重试。");
+		return {
+			packageName,
+			version
+		};
+	}));
 	const remove = [...new Set(targets.flatMap((target) => pluginsToRemoveBeforeInstall(declared, target.packageName)))];
 	for (const target of targets) {
 		await ensureLatestReleaseAllowed(target.packageName, target.version);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@michengai/dsh-codex-ui",
-  "version": "0.2.81",
+  "version": "0.2.82",
   "description": "以 Codex 风格重构 DSH Web 侧栏的独立客户端插件",
   "license": "Apache-2.0",
   "publishConfig": {
@@ -53,6 +53,11 @@
       "platform": "web"
     }
   },
+  "scripts": {
+    "build": "tsc --noEmit && tsdown",
+    "typecheck": "tsc --noEmit",
+    "test": "pnpm run typecheck && vitest run tests/client-runtime.integration.spec.ts && tsdown && node tests/run-assertions.mjs"
+  },
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.1 <5.0.0",
     "@deepseek-ai/dsh-client-locale": ">=0.1.0-rc.0 <0.2.0",
@@ -98,10 +103,5 @@
     "tsx": "^4.22.4",
     "typescript": "^6.0.3",
     "vitest": "^4.1.8"
-  },
-  "scripts": {
-    "build": "tsc --noEmit && tsdown",
-    "typecheck": "tsc --noEmit",
-    "test": "pnpm run typecheck && vitest run tests/client-runtime.integration.spec.ts && tsdown && node tests/run-assertions.mjs"
   }
-}
+}