@dsh-workbench/core 1.0.1 → 1.1.1

package/dist/host/index.js

@@ -5,8 +5,9 @@ import { createHash, randomUUID } from "node:crypto";
 import fs, { existsSync, mkdirSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, unlinkSync, writeFileSync } from "node:fs";
 import { createRequire } from "node:module";
 import { fileURLToPath, pathToFileURL } from "node:url";
-import { deflateSync, inflateSync } from "node:zlib";
 import writeFileAtomic from "write-file-atomic";
+import { deflateSync, inflateSync } from "node:zlib";
+import { execa } from "execa";
 //#region \0rolldown/runtime.js
 var __create = Object.create;
 var __defProp = Object.defineProperty;
@@ -86,6 +87,14 @@ function encodeRef(ref) {
 //#endregion
 //#region ../shared/dist/contract/unit.js
 /**
+* 外壳替模块名合成的词表键：模块自己不必写名字键，名字直接从清单里的 title 注册进来。
+* @param unit 单元 id。
+* @returns 该单元名字在词表里的键。
+*/
+function unitTitleKey(unit) {
+	return `dsh-workbench.unit.${unit}.title`;
+}
+/**
 * 模块声明的全部环境需要（没写就是空表）。
 * @param manifest 模块清单。
 * @returns need 列表。
@@ -382,13 +391,14 @@ function boardSituation(probe, workshop) {
 /**
 * 外壳愿意认的协议版本；不在表里的模块当场被拒，不猜语义。
 */
-var SUPPORTED_API_VERSIONS = [2];
+var SUPPORTED_API_VERSIONS = [3];
 /**
 * 协议认得的全部键；写了别的键这份清单会被拒（`protocol` 判据与运行时同一套），拼错当场报出来。
 */
 var DECLARATION_KEYS = [
 	"apiVersion",
 	"unit",
+	"title",
 	"card",
 	"tools",
 	"host",
@@ -400,11 +410,13 @@ var DECLARATION_KEYS = [
 var DECLARATION_REQUIRED_KEYS = [
 	"apiVersion",
 	"unit",
+	"title",
 	"card",
 	"tools",
 	"host"
 ];
-var CARD_KEYS = ["titleKey", "order"];
+var CARD_KEYS = ["order"];
+var TITLE_KEYS = ["zh", "en"];
 var TOOL_KEYS = [
 	"name",
 	"writes",
@@ -418,6 +430,16 @@ function text$2(value) {
 function isRecord(value) {
 	return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+/**
+* 读一份声明里的协议版本；不是对象或 apiVersion 不是整数时给 undefined。
+* @param raw 清单里 dsh.workbench 那段原始值。
+* @returns 声明声明的协议版本，读不出来时 undefined。
+*/
+function declarationApiVersionOf(raw) {
+	if (!isRecord(raw)) return void 0;
+	const version = raw.apiVersion;
+	return Number.isInteger(version) ? version : void 0;
+}
 function outsideKeys(value, allowed) {
 	return Object.keys(value).filter((key) => !allowed.includes(key));
 }
@@ -437,22 +459,30 @@ function stringArrayProblems(at, value) {
 function declarationProblemsOf(subject, raw) {
 	if (!isRecord(raw)) return [`${subject}: dsh.workbench 不是一个对象 —— ${JSON.stringify(raw)}`];
 	const version = raw.apiVersion;
-	if (version === void 0) return [`${subject}: dsh.workbench 没有 apiVersion —— 协议从 v2 起，写 \`"apiVersion": 2\`。缺它 = 外壳不认这个模块`];
+	if (version === void 0) return [`${subject}: dsh.workbench 没有 apiVersion —— 协议从 v3 起，写 \`"apiVersion": 3\`。缺它 = 外壳不认这个模块`];
 	if (!Number.isInteger(version) || !SUPPORTED_API_VERSIONS.includes(version)) {
-		const hint = version === 1 ? " —— v2 把 `env` 的三张表（command / plugins / libs）换成了 `needs`：把外部需要逐条写成 `{ kind, name, purpose, ... }`（kind 是 bin / extension / lib / env），再把 apiVersion 改成 2" : "";
+		const hint = version === 2 ? " —— v3 把卡片标题挪成了顶层 `title`（`{ \"zh\": \"…\", \"en\": \"…\" }` 字面量）：把 `card.titleKey` 删掉、在顶层写 title，再把 apiVersion 改成 3" : "";
 		return [`${subject}: dsh.workbench.apiVersion 是 ${JSON.stringify(version)}，这里只认 ${SUPPORTED_API_VERSIONS.join(" / ")}（要整数）${hint}`];
 	}
 	const problems = [];
 	const unknown = outsideKeys(raw, DECLARATION_KEYS);
-	if (unknown.length > 0) problems.push(`${subject}: dsh.workbench 里有协议 v2 不认识的键 ${listOf(unknown)} —— 只有 ${listOf(DECLARATION_KEYS)}。（协议外的键会让这份清单被拒：那句声明等于没写）`);
+	if (unknown.length > 0) problems.push(`${subject}: dsh.workbench 里有协议 v3 不认识的键 ${listOf(unknown)} —— 只有 ${listOf(DECLARATION_KEYS)}。（协议外的键会让这份清单被拒：那句声明等于没写）`);
 	for (const key of DECLARATION_REQUIRED_KEYS) if (raw[key] === void 0) problems.push(`${subject}: dsh.workbench 缺 ${key}` + (key === "card" ? "（这个模块没有卡片就写 `\"card\": null`）" : ""));
+	const title = raw.title;
+	if (title !== void 0) {
+		if (!isRecord(title)) problems.push(`${subject}: dsh.workbench.title 要是对象（中英各一份），现在是 ${JSON.stringify(title)}`);
+		else {
+			const extra = outsideKeys(title, TITLE_KEYS);
+			if (extra.length > 0) problems.push(`${subject}: dsh.workbench.title 里有不认的键 ${listOf(extra)} —— title 只有 ${listOf(TITLE_KEYS)}`);
+			for (const language of TITLE_KEYS) if (text$2(title[language]) === "") problems.push(`${subject}: dsh.workbench.title.${language} 要是非空字符串（市场和面板里显示的名字）`);
+		}
+	}
 	const card = raw.card;
 	if (card !== void 0 && card !== null) {
 		if (!isRecord(card)) problems.push(`${subject}: dsh.workbench.card 要么是对象、要么是 null，现在是 ${JSON.stringify(card)}`);
 		else {
 			const extra = outsideKeys(card, CARD_KEYS);
-			if (extra.length > 0) problems.push(`${subject}: dsh.workbench.card 里有不认的键 ${listOf(extra)} —— card 只有 ${listOf(CARD_KEYS)}（卡片默认显不显示由运行期的面板配置决定，清单里没有这一位）`);
-			if (text$2(card.titleKey) === "") problems.push(`${subject}: dsh.workbench.card.titleKey 要是非空字符串（面板那一格的文案键）`);
+			if (extra.length > 0) problems.push(`${subject}: dsh.workbench.card 里有不认的键 ${listOf(extra)} —— card 只有 ${listOf(CARD_KEYS)}（名字写在顶层的 title 里；卡片默认显不显示由运行期的面板配置决定，清单里没有这一位）`);
 			if (typeof card.order !== "number" || !Number.isFinite(card.order)) problems.push(`${subject}: dsh.workbench.card.order 要是数字，现在是 ${JSON.stringify(card.order)}`);
 		}
 	}
@@ -516,15 +546,18 @@ function readDeclaration(subject, raw) {
 		warnings: needsRead.warnings
 	};
 	const card = declaration.card;
+	const id = text$2(declaration.unit);
 	return {
 		declaration,
 		problems: [],
 		manifest: {
-			id: text$2(declaration.unit),
-			card: card === null ? null : {
-				titleKey: text$2(card.titleKey),
-				order: card.order
+			id,
+			title: {
+				zh: text$2(declaration.title.zh),
+				en: text$2(declaration.title.en)
 			},
+			titleKey: unitTitleKey(id),
+			card: card === null ? null : { order: card.order },
 			tools: declaration.tools.map((tool) => ({
 				name: text$2(tool.name),
 				writes: tool.writes
@@ -1192,7 +1225,9 @@ var PROVISION_ACTIONS = [
 	"update-dependency",
 	"update-plugin",
 	"uninstall-plugin",
-	"update-workbench"
+	"update-workbench",
+	"migrate-workbench",
+	"dismiss-followup"
 ];
 var DEPENDENCY_ACTIONS = ["update-dependency"];
 function isDependencyAction(action) {
@@ -1203,7 +1238,8 @@ function provisionTargetOf(action) {
 	if (action === "install-bundle" || action === "install-version") return "spec";
 	if (action === "remove-bundle") return "name";
 	if (action === "update-plugin" || action === "uninstall-plugin") return "name";
-	if (action === "update-workbench") return "name";
+	if (action === "update-workbench" || action === "migrate-workbench") return "name";
+	if (action === "dismiss-followup") return "id";
 	if (action === "cancel-install") return "requestId";
 	return "unit";
 }
@@ -1239,10 +1275,14 @@ function requestOf$1(action, value) {
 		action,
 		name: value
 	};
-	if (action === "update-workbench") return {
+	if (action === "update-workbench" || action === "migrate-workbench") return {
 		action,
 		name: value
 	};
+	if (action === "dismiss-followup") return {
+		action,
+		id: value
+	};
 	if (action === "cancel-install") return {
 		action,
 		requestId: value
@@ -3990,6 +4030,31 @@ function refusalReason() {
 	return "这个包既不是工作台的模块，也不是 opencli 的插件，装了也用不上";
 }
 //#endregion
+//#region ../shared/dist/host/plugin-source.js
+function envValue(env, name) {
+	const value = env[name]?.trim();
+	return value === void 0 || value === "" ? { ok: false } : {
+		ok: true,
+		value
+	};
+}
+function npmRegistryOf(source, env) {
+	const name = source.registryEnv ?? "";
+	if (name !== "") {
+		const fromEnv = envValue(env, name);
+		if (fromEnv.ok) return fromEnv;
+	}
+	const fallback = source.registryDefault?.trim();
+	if (fallback === void 0 || fallback === "") return {
+		ok: false,
+		env: name
+	};
+	return {
+		ok: true,
+		value: fallback
+	};
+}
+//#endregion
 //#region ../shared/dist/host/supply-index.js
 function text$1(value) {
 	return value === void 0 ? "" : value.trim();
@@ -4015,24 +4080,28 @@ function packageOf(need) {
 function keyOf(kind, pkg) {
 	return `${kind}:${pkg}`;
 }
-function sourceCompatible(left, right) {
+function registryAddressOf(source, env) {
+	const resolved = npmRegistryOf(source, env);
+	return resolved.ok ? resolved.value : void 0;
+}
+function sourceCompatible(left, right, env) {
 	if (left.kind !== right.kind) return false;
 	if (left.kind === "npm" && right.kind === "npm") {
 		if (text$1(left.package) !== "" && text$1(right.package) !== "" && text$1(left.package) !== text$1(right.package)) return false;
-		if (text$1(left.registryEnv) !== text$1(right.registryEnv)) return false;
-		const l = text$1(left.registryDefault);
-		const r = text$1(right.registryDefault);
-		return l === "" || r === "" || l === r;
+		const l = registryAddressOf(left, env);
+		const r = registryAddressOf(right, env);
+		if (l !== void 0 && r !== void 0) return l === r;
+		return text$1(left.registryEnv) === text$1(right.registryEnv);
 	}
 	if (left.kind === "git" && right.kind === "git") return text$1(left.url) === text$1(right.url);
 	if (left.kind === "local" && right.kind === "local") return text$1(left.env) === text$1(right.env) && text$1(left.path) === text$1(right.path);
 	return false;
 }
-function sourcesCompatible(left, right) {
+function sourcesCompatible(left, right, env) {
 	if (left.length !== right.length) return false;
 	return left.every((source, index) => {
 		const other = right[index];
-		return other !== void 0 && sourceCompatible(source, other);
+		return other !== void 0 && sourceCompatible(source, other, env);
 	});
 }
 function mergedSource(left, right) {
@@ -4047,13 +4116,13 @@ function mergedSource(left, right) {
 	}
 	return left;
 }
-function mergeSources(entry, sources) {
+function mergeSources(entry, sources, env) {
 	if (!entry.declared) {
 		entry.declared = true;
 		entry.sources = [...sources];
 		return true;
 	}
-	if (!sourcesCompatible(entry.sources, sources)) {
+	if (!sourcesCompatible(entry.sources, sources, env)) {
 		entry.conflicted = true;
 		return false;
 	}
@@ -4072,7 +4141,8 @@ function addDeclarer(entry, unit, commands) {
 	if (!entry.declarers.includes(unit)) entry.declarers.push(unit);
 	for (const command of commands) if (!entry.commands.includes(command)) entry.commands.push(command);
 }
-function buildSupplyIndex(declarations) {
+function buildSupplyIndex(declarations, options = {}) {
+	const env = options.env ?? {};
 	const entries = /* @__PURE__ */ new Map();
 	const byName = /* @__PURE__ */ new Map();
 	const conflicts = [];
@@ -4103,7 +4173,7 @@ function buildSupplyIndex(declarations) {
 			entry.runtime = need.runtime;
 			addDeclarer(entry, declaration.id, need.commands ?? []);
 		} else addDeclarer(entry, declaration.id, []);
-		if (!mergeSources(entry, need.sources ?? [])) conflicts.push({
+		if (!mergeSources(entry, need.sources ?? [], env)) conflicts.push({
 			kind: "source-mismatch",
 			key: entry.key,
 			names: [...entry.names],
@@ -4477,6 +4547,7 @@ var MARKET_DISCOVER_ROUTE = "panels/market-discover";
 var MARKET_DOC_ROUTE = "panels/market-doc";
 var MARKET_PUBLISH_PREVIEW_ROUTE = "panels/market-publish-preview";
 var MARKET_SOURCES_RESOURCE = "market-sources";
+var MARKET_SOURCES_ROUTE = "panels/market-sources";
 //#endregion
 //#region ../shared/dist/lib/market-index.js
 var BRANCH = /^[A-Za-z0-9][A-Za-z0-9._/-]*$/;
@@ -5010,6 +5081,94 @@ var BUNDLE_REGISTRIES_ROUTE = "bundle-registries";
 var BUNDLE_INSPECT_ROUTE = "bundle-inspect";
 var MODULE_VERSIONS_ROUTE = "module-versions";
 //#endregion
+//#region src/shared/api/host/follow-up-dismiss.ts
+var DISMISS_FILE = "follow-ups.json";
+function fileOf$1(runtimeRoot) {
+	return join(runtimeRoot, DISMISS_FILE);
+}
+function readDismissed(runtimeRoot) {
+	try {
+		const value = JSON.parse(readFileSync(fileOf$1(runtimeRoot), "utf8"));
+		if (typeof value !== "object" || value === null) return {};
+		const dismissed = value["dismissed"];
+		if (typeof dismissed !== "object" || dismissed === null) return {};
+		return dismissed;
+	} catch {
+		return {};
+	}
+}
+function isFollowUpDismissed(runtimeRoot, id) {
+	return Object.prototype.hasOwnProperty.call(readDismissed(runtimeRoot), id);
+}
+function dismissFollowUp(runtimeRoot, id) {
+	const file = fileOf$1(runtimeRoot);
+	mkdirSync(dirname(file), { recursive: true });
+	const dismissed = {
+		...readDismissed(runtimeRoot),
+		[id]: { at: (/* @__PURE__ */ new Date()).toISOString() }
+	};
+	writeFileAtomic.sync(file, `${JSON.stringify({ dismissed }, null, 2)}\n`);
+}
+//#endregion
+//#region src/shared/api/host/migration-follow-up.ts
+var MIGRATION_FOLLOW_UP_ID = "data-root-migration";
+function hasEntries(dir) {
+	try {
+		return readdirSync(dir).some((name) => name !== ".DS_Store");
+	} catch {
+		return false;
+	}
+}
+function legacyDataIn(root) {
+	return existsSync(join(root, "storages", "workspace.json")) || hasEntries(join(root, "sessions")) || hasEntries(join(root, "attachments"));
+}
+function pathsIn(file) {
+	try {
+		const value = JSON.parse(readFileSync(file, "utf8"));
+		if (typeof value !== "object" || value === null) return /* @__PURE__ */ new Set();
+		const tables = value["tables"];
+		if (typeof tables !== "object" || tables === null) return /* @__PURE__ */ new Set();
+		const workspaces = tables["workspaces"];
+		if (typeof workspaces !== "object" || workspaces === null) return /* @__PURE__ */ new Set();
+		const paths = /* @__PURE__ */ new Set();
+		for (const entry of Object.values(workspaces)) {
+			if (typeof entry !== "object" || entry === null) continue;
+			const path = entry["path"];
+			if (typeof path === "string") paths.add(path);
+		}
+		return paths;
+	} catch {
+		return /* @__PURE__ */ new Set();
+	}
+}
+function hasMissingPaths(sourceFile, targetFile) {
+	const source = pathsIn(sourceFile);
+	if (source.size === 0) return false;
+	const target = pathsIn(targetFile);
+	for (const path of source) if (!target.has(path)) return true;
+	return false;
+}
+function migrationFollowUp(input) {
+	const runtimeRoot = input.runtimeRoot ?? join(input.home, input.profile);
+	if (resolve(runtimeRoot) === resolve(input.home)) return void 0;
+	if (isFollowUpDismissed(runtimeRoot, "data-root-migration")) return void 0;
+	if (!legacyDataIn(runtimeRoot)) return void 0;
+	const marker = join(runtimeRoot, ".data-root-shared");
+	if (!existsSync(marker)) return {
+		id: MIGRATION_FOLLOW_UP_ID,
+		kind: "data-migration",
+		hard: false
+	};
+	const source = join(runtimeRoot, "storages", "workspace.json");
+	const target = join(input.home, "storages", "workspace.json");
+	if (!existsSync(source) || !existsSync(target)) return void 0;
+	return hasMissingPaths(source, target) ? {
+		id: MIGRATION_FOLLOW_UP_ID,
+		kind: "data-migration",
+		hard: false
+	} : void 0;
+}
+//#endregion
 //#region src/shared/api/host/bundle-routes.ts
 function registryOf(search) {
 	const raw = param(search, "registry");
@@ -5033,6 +5192,25 @@ function bundleRegistriesHandler(ctx) {
 }
 var refusalLog = /* @__PURE__ */ new Map();
 var holdLog = /* @__PURE__ */ new Map();
+function updateBlockOf(raw, problems) {
+	if (problems.length === 0) return void 0;
+	const declared = declarationApiVersionOf(raw);
+	const newest = Math.max(...SUPPORTED_API_VERSIONS);
+	return declared !== void 0 && declared > newest ? "needs-workbench" : "incompatible";
+}
+function titleOf(raw) {
+	if (typeof raw !== "object" || raw === null) return void 0;
+	const title = raw.title;
+	if (typeof title !== "object" || title === null || Array.isArray(title)) return void 0;
+	const record = title;
+	const zh = typeof record.zh === "string" ? record.zh.trim() : "";
+	const en = typeof record.en === "string" ? record.en.trim() : "";
+	if (zh === "" || en === "") return void 0;
+	return {
+		zh,
+		en
+	};
+}
 async function latestIfReleaseReady(supply, input) {
 	const missing = await supply.missingReleaseParts({
 		shell: input.shell,
@@ -5075,7 +5253,8 @@ async function workbenchVersion(supply, input) {
 		installed: read.version,
 		...latest === void 0 ? {} : { latest },
 		...input.running === void 0 ? {} : { running: input.running },
-		...read.local === true ? { local: true } : {}
+		...read.local === true ? { local: true } : {},
+		...input.followUp === void 0 ? {} : { followUp: input.followUp }
 	};
 }
 function moduleVersionsHandler(ctx, shell, running, selfUpdate) {
@@ -5101,7 +5280,15 @@ function moduleVersionsHandler(ctx, shell, running, selfUpdate) {
 			});
 			const raw = supply.moduleDeclarationOf(dir, module.pkg);
 			const declared = raw === void 0 ? [] : declarationProblemsOf(module.pkg, raw);
+			const title = titleOf(raw);
 			const refused = refusals.get(module.unit) ?? (declared.length === 0 ? void 0 : declared);
+			const latestRaw = latest === void 0 || latest === module.version || shell === void 0 || registry === void 0 ? void 0 : await supply.registryDeclarationOf({
+				shell,
+				name: module.pkg,
+				registry,
+				force
+			});
+			const latestBlocked = latestRaw === void 0 ? void 0 : updateBlockOf(latestRaw, declarationProblemsOf(module.pkg, latestRaw));
 			if (refused === void 0) refusalLog.delete(module.pkg);
 			else {
 				const line = refused.join("；");
@@ -5114,18 +5301,28 @@ function moduleVersionsHandler(ctx, shell, running, selfUpdate) {
 				unit: module.unit,
 				pkg: module.pkg,
 				installed: module.version,
+				...title === void 0 ? {} : { title },
 				...latest === void 0 ? {} : { latest },
+				...latestBlocked === void 0 ? {} : { latestBlocked },
 				...module.local === true ? { local: true } : {},
 				...refused === void 0 ? {} : { refused }
 			};
 		}));
 		const selfUpdateNow = selfUpdate?.();
+		const profile = dir === null ? "" : basename(dir);
+		const home = dir === null ? void 0 : dirname(dirname(dir));
+		const followUp = profile === "" || home === void 0 ? void 0 : migrationFollowUp({
+			home,
+			profile,
+			...process.env.DSH_WORKBENCH_HOME === void 0 || process.env.DSH_WORKBENCH_HOME === "" ? {} : { runtimeRoot: process.env.DSH_WORKBENCH_HOME }
+		});
 		const workbench = await workbenchVersion(supply, {
 			dir,
 			shell,
 			fallback,
 			force,
 			...running === void 0 ? {} : { running },
+			...followUp === void 0 ? {} : { followUp },
 			logger: ctx.logger
 		});
 		return {
@@ -5402,6 +5599,7 @@ function screenOnlyToolsFor(pageDebug) {
 }
 var panelsUnit = {
 	id: "panels",
+	titleKey: "panels.title",
 	card: null,
 	tools: [...READ_TOOLS.map((name) => ({
 		name,
@@ -5929,7 +6127,7 @@ function resolvePanels(manifests, boards, owned = /* @__PURE__ */ new Set()) {
 		const order = hasCard ? rank.get(manifest.id) ?? ordered.length + declared(manifest) : 0;
 		return {
 			id: manifest.id,
-			titleKey: manifest.card?.titleKey ?? manifest.id,
+			titleKey: manifest.titleKey,
 			order,
 			shown: on,
 			source: overrideOf(boards.workspace, manifest.id) === void 0 ? "default" : "user",
@@ -8894,7 +9092,7 @@ function renderList(root, modules, shape = "bare") {
 //#endregion
 //#region src/modules/panels/model/diy-tools.ts
 var PUBLISH_TIMEOUT_MS = 18e5;
-function registerDiyTools(ctx, market, panels, debug, previewOf = () => null) {
+function registerDiyTools(ctx, market, panels, debug, previewOf = () => null, inferredAuthorOf = async () => void 0) {
 	const supply = supplyPortOf(ctx);
 	const tools = ctx.get("tools");
 	if (tools === void 0) {
@@ -9171,6 +9369,10 @@ function registerDiyTools(ctx, market, panels, debug, previewOf = () => null) {
 					type: "string",
 					description: "公开发布用的许可证（MIT / Apache-2.0 / 仓库已有 LICENSE）。"
 				},
+				author: {
+					type: "string",
+					description: "署谁的名（姓名，或 姓名 <邮箱>）；用户点了名才传，不传按模块里写的，没写用推断的署名。"
+				},
 				refresh: {
 					type: "boolean",
 					description: "只刷市集元数据（标题/作者/说明），不升版本、不重发产物。"
@@ -9190,8 +9392,10 @@ function registerDiyTools(ctx, market, panels, debug, previewOf = () => null) {
 			const target = asText(asRecord$1(raw)["target"]);
 			const version = asText(asRecord$1(raw)["version"]);
 			const license = asText(asRecord$1(raw)["license"]);
+			let author = asText(asRecord$1(raw)["author"]);
 			const verify = asRecord$1(raw)["verify"] === true;
 			const resume = asRecord$1(raw)["resume"] === true;
+			if (!verify && target !== "local" && author === "" && (previewOf(found.unit)?.author ?? "") === "") author = await inferredAuthorOf(found.unit) ?? "";
 			const argv = [
 				bin,
 				"release",
@@ -9205,6 +9409,7 @@ function registerDiyTools(ctx, market, panels, debug, previewOf = () => null) {
 			if (target !== "") argv.push("--target", target);
 			if (version !== "") argv.push("--version", version);
 			if (license !== "") argv.push("--license", license);
+			if (author !== "") argv.push("--author", author);
 			if (asRecord$1(raw)["refresh"] === true) argv.push("--refresh");
 			const result = await runShell(shell, argv.map((one) => quoteShellArg(one)).join(" "), {
 				workdir: root,
@@ -9311,17 +9516,28 @@ function selectedGitSource() {
 		return parsed.source.policy === "artifacts-in-repo" ? parsed.source : void 0;
 	}
 }
-function publishedVersionsOf(source, name) {
+function publishedEntryOf(source, name) {
 	const file = join(workbenchRoot(), "market-index", marketSourceKey(source), "worktree", source.path ?? "market.json");
 	if (!existsSync(file)) return void 0;
 	try {
 		const parsed = parseMarketIndexJson(readFileSync(file, "utf8"));
 		if (!parsed.ok) return void 0;
-		return parsed.index.plugins.find((one) => one.name === name)?.versions.map((one) => one.version) ?? [];
+		const entry = parsed.index.plugins.find((one) => one.name === name);
+		if (entry === void 0) return {
+			versions: [],
+			author: ""
+		};
+		return {
+			versions: entry.versions.map((one) => one.version),
+			author: typeof entry.author === "string" ? entry.author.trim() : ""
+		};
 	} catch {
 		return;
 	}
 }
+function publishedVersionsOf(source, name) {
+	return publishedEntryOf(source, name)?.versions;
+}
 function bumped(version, kind) {
 	const match = SEMVER.exec(version);
 	if (match === null) return version;
@@ -9358,6 +9574,71 @@ function marketOf(unit, dir, name, version) {
 		...nextVersion === void 0 ? {} : { nextVersion }
 	};
 }
+function moduleFactOf(root, unit) {
+	if (root === null || root === void 0 || unit === "") return null;
+	const found = modulesIn(root).find((one) => one.unit === unit);
+	if (found === void 0) return null;
+	let manifest;
+	try {
+		manifest = JSON.parse(readFileSync(join(found.dir, "package.json"), "utf8"));
+	} catch {
+		return null;
+	}
+	if (typeof manifest !== "object" || manifest === null) return null;
+	const record = manifest;
+	return {
+		dir: found.dir,
+		name: typeof record["name"] === "string" ? record["name"].trim() : "",
+		author: authorOf(record)
+	};
+}
+function siblingAuthorOf(root, unit) {
+	const authors = /* @__PURE__ */ new Set();
+	for (const module of modulesIn(root)) {
+		if (module.unit === unit) continue;
+		try {
+			const manifest = JSON.parse(readFileSync(join(module.dir, "package.json"), "utf8"));
+			if (typeof manifest !== "object" || manifest === null) continue;
+			const author = authorOf(manifest);
+			if (author !== "") authors.add(author);
+		} catch {
+			continue;
+		}
+	}
+	return authors.size === 1 ? [...authors][0] : void 0;
+}
+async function localGitIdentityOf(shell, dir) {
+	if (shell === void 0) return void 0;
+	const read = async (argv) => {
+		const result = await runShell(shell, `git -C ${quoteShellArg(dir)} ${argv}`, { workdir: dir });
+		return result.exitCode === 0 ? result.stdout.trim() : "";
+	};
+	const name = await read(`config ${quoteShellArg("user.name")}`);
+	if (name === "") return void 0;
+	const email = await read(`config ${quoteShellArg("user.email")}`);
+	return email === "" ? name : `${name} <${email}>`;
+}
+async function lastCommitAuthorOf(shell, dir) {
+	if (shell === void 0) return void 0;
+	const result = await runShell(shell, `git -C ${quoteShellArg(dir)} log -1 --format=${quoteShellArg("%an <%ae>")}`, { workdir: dir });
+	const author = result.exitCode === 0 ? result.stdout.trim() : "";
+	return author === "" ? void 0 : author;
+}
+async function inferredAuthorOf(root, unit, shell) {
+	const fact = moduleFactOf(root, unit);
+	if (fact === null) return void 0;
+	if (fact.author !== "") return fact.author;
+	const source = selectedGitSource();
+	if (source !== void 0 && fact.name !== "") {
+		const published = publishedEntryOf(source, fact.name)?.author ?? "";
+		if (published !== "") return published;
+	}
+	const sibling = root === null || root === void 0 ? void 0 : siblingAuthorOf(root, unit);
+	if (sibling !== void 0) return sibling;
+	const local = await localGitIdentityOf(shell, fact.dir);
+	if (local !== void 0) return local;
+	return lastCommitAuthorOf(shell, fact.dir);
+}
 function publishPreviewOf(root, unit, options = {}) {
 	if (root === null || root === void 0 || unit === "") return null;
 	const found = modulesIn(root).find((one) => one.unit === unit);
@@ -9377,7 +9658,8 @@ function publishPreviewOf(root, unit, options = {}) {
 	const registry = typeof publishConfig === "object" && publishConfig !== null ? publishConfig["registry"] : void 0;
 	const market = marketOf(found.unit, found.dir, name, version);
 	const target = targetVersionOf(version, (options.version ?? "").trim(), market);
-	const author = authorOf(record);
+	const askedAuthor = (options.author ?? "").trim();
+	const author = askedAuthor === "" ? authorOf(record) : askedAuthor;
 	return {
 		name,
 		version,
@@ -11137,7 +11419,7 @@ function findDependency(manifests, id, isReleased) {
 	const index = buildSupplyIndex(manifests.map((manifest) => ({
 		id: manifest.id,
 		needs: needsOf(manifest)
-	})));
+	})), { env: process.env });
 	const entry = parsed.kind === "extension" || parsed.kind === "lib" ? index.entryOf(parsed.kind, parsed.name) : void 0;
 	const conflict = entry?.conflicted === true ? index.conflicts.find((item) => item.names.includes(parsed.name))?.detail : void 0;
 	return {
@@ -11469,6 +11751,15 @@ async function updateModuleBundle(unit, deps) {
 		registry,
 		force: true
 	});
+	if (latest !== void 0 && deps.shell !== void 0 && registry !== void 0) {
+		const declared = await supply.registryDeclarationOf({
+			shell: deps.shell,
+			name: pkg,
+			registry,
+			force: true
+		});
+		if (declared !== void 0 && supply.declarationRefusalOf(pkg, declared).length > 0) throw new Error("源上的新版和当前这一版工作台不匹配 —— 先升级工作台，再更新这个模块。");
+	}
 	const spec = latest === void 0 ? pkg : `${pkg}@${latest}`;
 	const outcome = await replaceDshBundle(deps.routeDeps, spec, { ...registry === void 0 ? {} : { registry } });
 	await deps.sweep();
@@ -11578,6 +11869,80 @@ async function updateWorkbenchOnce(deps) {
 	};
 }
 //#endregion
+//#region src/shared/api/host/migrate-workbench.ts
+async function migrateWorkbench(input) {
+	const script = join(input.home, "profiles", input.profile, "node_modules", input.pkg, "scripts", "share-data-root.mjs");
+	if (!existsSync(script)) throw new Error(`找不到迁移脚本（${script}）—— 这一份没装全？`);
+	const runtimeRoot = process.env.DSH_WORKBENCH_HOME ?? join(input.home, input.profile);
+	const result = await input.run({
+		script,
+		env: {
+			DSH_HOME: input.home,
+			WORKBENCH_PROFILE: input.profile,
+			DSH_WORKBENCH_HOME: runtimeRoot
+		}
+	});
+	if (result.exitCode !== 0) {
+		const tail = (result.stderr || result.stdout).trim().split("\n").slice(-6).join("\n");
+		throw new Error(`迁移没成（退出码 ${result.exitCode}）${tail === "" ? "" : `：${tail}`}`);
+	}
+	return {
+		added: Number.parseInt(/新增\s+(\d+)\s+个项目/.exec(result.stdout)?.[1] ?? "0", 10),
+		files: Number.parseInt(/补了\s+(\d+)\s+个文件/.exec(result.stdout)?.[1] ?? "0", 10)
+	};
+}
+//#endregion
+//#region src/modules/panels/model/market-follow-up.ts
+function createWorkbenchFollowUps(deps) {
+	const runMigration = deps.runMigration ?? (async (input) => {
+		const result = await execa(process.execPath, [
+			input.script,
+			"--migrate",
+			"--force"
+		], {
+			env: {
+				...process.env,
+				ELECTRON_RUN_AS_NODE: "1",
+				...input.env
+			},
+			reject: false,
+			timeout: 12e4
+		});
+		return {
+			exitCode: result.exitCode ?? 1,
+			stdout: result.stdout,
+			stderr: result.stderr
+		};
+	});
+	function homeAndProfile() {
+		if (deps.dshHome === void 0 || deps.profileName === void 0) throw new Error("拿不到 DSH_HOME 或 profile 名字 —— 这一步做不了。");
+		const home = deps.dshHome();
+		const profile = deps.profileName();
+		if (profile === null || profile === "") throw new Error("拿不到 profile 名字 —— 这一步做不了。");
+		return {
+			home,
+			profile
+		};
+	}
+	return {
+		async migrateWorkbench() {
+			const { home, profile } = homeAndProfile();
+			const read = deps.workbench?.(PLUGIN_ID);
+			if (read === void 0) throw new Error(`读不到 profile 里装的 ${PLUGIN_ID} —— 迁移做不了。`);
+			return migrateWorkbench({
+				home,
+				profile,
+				pkg: read.pkg,
+				run: runMigration
+			});
+		},
+		async dismissFollowUp(id) {
+			const { home, profile } = homeAndProfile();
+			dismissFollowUp(process.env.DSH_WORKBENCH_HOME ?? join(home, profile), id);
+		}
+	};
+}
+//#endregion
 //#region src/modules/panels/model/plugin-actions.ts
 function pluginKeptOf(retention, detail) {
 	if (retention === "keep-held") return { kind: "held" };
@@ -11751,7 +12116,7 @@ function createEnvDropper(options) {
 			const index = buildSupplyIndex(catalog().filter((item) => options.isReleased?.(item.id) !== true).map((item) => ({
 				id: item.id,
 				needs: needsOf(item)
-			})));
+			})), { env: process.env });
 			const extensions = (needs ?? []).filter((need) => need.kind === "extension");
 			const libs = (needs ?? []).filter((need) => need.kind === "lib");
 			const onMachine = new Set(before.needs.filter((state) => state.kind === "extension" && state.status !== "missing").map((state) => state.name));
@@ -11870,7 +12235,7 @@ function createMarketService(options) {
 		const manifest = requireEntry(unit);
 		return {
 			unit,
-			titleKey: manifest.card?.titleKey ?? unit,
+			titleKey: manifest.titleKey,
 			needs: needsOf(manifest),
 			capability: await capabilityOf(unit, force)
 		};
@@ -12181,6 +12546,12 @@ function createMarketService(options) {
 			await reprobePlugin(pkg, outcome.name);
 			return outcome;
 		},
+		...createWorkbenchFollowUps({
+			dshHome,
+			profileName,
+			workbench,
+			...options.runMigration === void 0 ? {} : { runMigration: options.runMigration }
+		}),
 		updateDependency: updateDependencyRow$1
 	};
 	return service;
@@ -12410,6 +12781,12 @@ function marketDiscoverRoutes(discover) {
 }
 //#endregion
 //#region src/modules/panels/model/market-sources-act.ts
+function marketSourcesRoutes(store) {
+	return { [MARKET_SOURCES_ROUTE]: async () => ({
+		ok: true,
+		...store.read()
+	}) };
+}
 function asRecord(value) {
 	return typeof value === "object" && value !== null ? value : void 0;
 }
@@ -12491,13 +12868,29 @@ function marketSourcesAction(store, init) {
 }
 //#endregion
 //#region src/modules/panels/model/publish-preview-routes.ts
-function publishPreviewRoutes(workshop) {
-	return { [MARKET_PUBLISH_PREVIEW_ROUTE]: (search) => {
+function publishPreviewRoutes(workshop, inferredAuthorOf = async () => void 0) {
+	return { [MARKET_PUBLISH_PREVIEW_ROUTE]: async (search) => {
 		const unit = (param(search, "unit") ?? "").trim();
 		const version = (param(search, "version") ?? "").trim();
+		const author = (param(search, "author") ?? "").trim();
+		if (unit === "") return {
+			ok: true,
+			preview: null
+		};
+		let preview = publishPreviewOf(workshop, unit, {
+			version,
+			author
+		});
+		if (preview !== null && author === "" && (preview.author === void 0 || preview.author === "")) {
+			const inferred = await inferredAuthorOf(unit);
+			if (inferred !== void 0 && inferred !== "") preview = {
+				...preview,
+				author: inferred
+			};
+		}
 		return {
 			ok: true,
-			preview: unit === "" ? null : publishPreviewOf(workshop, unit, { version })
+			preview
 		};
 	} };
 }
@@ -12506,6 +12899,7 @@ function publishPreviewRoutes(workshop) {
 var DEFAULT_TTL_MS = 3e5;
 var DEFAULT_TIMEOUT_MS$2 = 3e4;
 var DEFAULT_MAX_BYTES$1 = 4194304;
+var GIT_NO_PROMPT = `${quoteShellArg("env")} GIT_TERMINAL_PROMPT=0`;
 function messageOf$1(error) {
 	return error instanceof Error ? error.message : String(error);
 }
@@ -12671,7 +13065,7 @@ function createMarketIndexReader(options) {
 			}
 		};
 		try {
-			const result = await runShell(shell, line, { timeoutMs });
+			const result = await runShell(shell, `${GIT_NO_PROMPT} ${line}`, { timeoutMs });
 			if (result.exitCode !== 0) return {
 				ok: false,
 				problem: classifyGitError(result.stderr, result.timedOut),
@@ -13228,6 +13622,18 @@ async function dispatchMarket(market, request) {
 		action: "cancel-install",
 		cancellation: await market.cancelInstall(request.requestId ?? "")
 	};
+	if (request.action === "migrate-workbench") return {
+		ok: true,
+		action: "migrate-workbench",
+		...await market.migrateWorkbench()
+	};
+	if (request.action === "dismiss-followup") {
+		await market.dismissFollowUp(request.id ?? "");
+		return {
+			ok: true,
+			action: "dismiss-followup"
+		};
+	}
 	if (request.action === "update-workbench") return {
 		ok: true,
 		action: "update-workbench",
@@ -14382,12 +14788,13 @@ var OWNED = [{
 				...diyDebugRoutes(debug),
 				...diyRecordRoutes(record),
 				...marketDiscoverRoutes(discover),
-				...publishPreviewRoutes(workshopPathOf(ctx))
+				...marketSourcesRoutes(marketSources),
+				...publishPreviewRoutes(workshopPathOf(ctx), (unit) => inferredAuthorOf(workshopPathOf(ctx), unit, shell))
 			},
 			registerTools: () => [
 				...registerPanelTools(ctx, panels, values),
 				...registerMarketTools(ctx, market),
-				...registerDiyTools(ctx, market, panels, debug, (unit) => publishPreviewOf(workshopPathOf(ctx), unit)),
+				...registerDiyTools(ctx, market, panels, debug, (unit) => publishPreviewOf(workshopPathOf(ctx), unit), (unit) => inferredAuthorOf(workshopPathOf(ctx), unit, shell)),
 				...registerRecordTools(ctx, record),
 				...registerLongTaskTools(ctx, longTaskRuns)
 			],