@dsh-workbench/core 0.1.16 → 0.1.17

package/dist/client/index.js

@@ -422,6 +422,121 @@ function probeKeyOf(error) {
 	if (error === void 0) return null;
 	return error.code === "" ? "unknown" : error.code;
 }
+var SUPPORTED_API_VERSIONS = [1];
+var DECLARATION_KEYS = [
+	"apiVersion",
+	"unit",
+	"card",
+	"tools",
+	"host",
+	"env"
+];
+var DECLARATION_REQUIRED_KEYS = [
+	"apiVersion",
+	"unit",
+	"card",
+	"tools",
+	"host"
+];
+var CARD_KEYS = ["titleKey", "order"];
+var TOOL_KEYS = ["name", "writes"];
+var HOST_KEYS = ["inject", "optional"];
+function text(value) {
+	return typeof value === "string" ? value.trim() : "";
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function outsideKeys(value, allowed) {
+	return Object.keys(value).filter((key) => !allowed.includes(key));
+}
+function listOf(keys) {
+	return keys.map((key) => JSON.stringify(key)).join(" / ");
+}
+function stringArrayProblems(at, value) {
+	if (!Array.isArray(value)) return [`${at} 要是一串字符串，现在是 ${JSON.stringify(value)}`];
+	return value.flatMap((item, index) => text(item) === "" ? [`${at}[${index}] 不是非空字符串：${JSON.stringify(item)}`] : []);
+}
+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 —— 协议从 v1 起，写 \`"apiVersion": 1\`。缺它 = 外壳不认这个模块（ADR-0038 §2.3）`];
+	if (!Number.isInteger(version) || !SUPPORTED_API_VERSIONS.includes(version)) return [`${subject}: dsh.workbench.apiVersion 是 ${JSON.stringify(version)}，这里只认 ${SUPPORTED_API_VERSIONS.join(" / ")}（要整数）`];
+	const problems = [];
+	const unknown = outsideKeys(raw, DECLARATION_KEYS);
+	if (unknown.length > 0) problems.push(`${subject}: dsh.workbench 里有协议 v1 不认识的键 ${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 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(card.titleKey) === "") problems.push(`${subject}: dsh.workbench.card.titleKey 要是非空字符串（面板那一格的文案键）`);
+			if (typeof card.order !== "number" || !Number.isFinite(card.order)) problems.push(`${subject}: dsh.workbench.card.order 要是数字，现在是 ${JSON.stringify(card.order)}`);
+		}
+	}
+	const tools = raw.tools;
+	if (tools !== void 0) {
+		if (!Array.isArray(tools)) problems.push(`${subject}: dsh.workbench.tools 要是一串声明，现在是 ${JSON.stringify(tools)}`);
+		else {
+			const seen = /* @__PURE__ */ new Set();
+			tools.forEach((tool, index) => {
+				const at = `dsh.workbench.tools[${index}]`;
+				if (!isRecord(tool)) {
+					problems.push(`${subject}: ${at} 要是对象，现在是 ${JSON.stringify(tool)}`);
+					return;
+				}
+				const extra = outsideKeys(tool, TOOL_KEYS);
+				if (extra.length > 0) problems.push(`${subject}: ${at} 里有不认的键 ${listOf(extra)} —— tools 只有 ${listOf(TOOL_KEYS)}`);
+				const name = text(tool.name);
+				if (name === "") problems.push(`${subject}: ${at}.name 要是非空字符串`);
+				else if (seen.has(name)) problems.push(`${subject}: ${at}.name「${name}」与前面那条撞了 —— 工具名会进 dsh 的工具表，不许重`);
+				else seen.add(name);
+				if (typeof tool.writes !== "boolean") problems.push(`${subject}: ${at}.writes 要是 true / false（它是"这会写"的唯一声明，缺了审批无从认领）`);
+			});
+		}
+	}
+	const host = raw.host;
+	if (host !== void 0) {
+		if (!isRecord(host)) problems.push(`${subject}: dsh.workbench.host 要是对象，现在是 ${JSON.stringify(host)}`);
+		else {
+			const extra = outsideKeys(host, HOST_KEYS);
+			if (extra.length > 0) problems.push(`${subject}: dsh.workbench.host 里有不认的键 ${listOf(extra)} —— host 只有 ${listOf(HOST_KEYS)}`);
+			if (host.inject === void 0) problems.push(`${subject}: dsh.workbench.host.inject 没写 —— 它声明这个模块要外壳的哪几个服务，外壳靠它判"能不能挂"。一个都不要也要写 \`"inject": []\``);
+			else problems.push(...stringArrayProblems(`${subject}: dsh.workbench.host.inject`, host.inject));
+			if (host.optional !== void 0) problems.push(...stringArrayProblems(`${subject}: dsh.workbench.host.optional`, host.optional));
+		}
+	}
+	if (raw.env !== void 0 && !isRecord(raw.env)) problems.push(`${subject}: dsh.workbench.env 要是对象（command / plugins / libs）—— 语义由门禁的 env 判据查，这里只查形状`);
+	return problems;
+}
+function readDeclaration(subject, raw) {
+	const problems = declarationProblemsOf(subject, raw);
+	if (problems.length > 0) return { problems };
+	const declaration = raw;
+	const card = declaration.card;
+	return {
+		declaration,
+		problems: [],
+		manifest: {
+			id: text(declaration.unit),
+			card: card === null ? null : {
+				titleKey: text(card.titleKey),
+				order: card.order
+			},
+			tools: declaration.tools.map((tool) => ({
+				name: text(tool.name),
+				writes: tool.writes
+			})),
+			host: {
+				inject: [...declaration.host.inject ?? []],
+				...declaration.host.optional === void 0 ? {} : { optional: [...declaration.host.optional] }
+			},
+			...declaration.env === void 0 ? {} : { env: declaration.env }
+		}
+	};
+}
 //#endregion
 //#region ../shared/dist/config/constants.js
 var PLUGIN_ID = "@dsh-workbench/core";
@@ -609,7 +724,7 @@ function ApprovalDetail(props) {
 	if (owner?.approval !== void 0) {
 		const Render = owner.approval.render;
 		return h(CardBoundary, {
-			unit: owner.manifest.id,
+			unit: owner.unit,
 			resetKey: props.callId ?? "",
 			t
 		}, h(Render, {
@@ -1114,6 +1229,7 @@ var en = {
 	"panels.market.sectionPending": "Not installed",
 	"panels.market.sectionShared": "Shared dependencies",
 	"panels.market.sharedUsedBy": "Used by {modules}",
+	"panels.market.sharedFoot": "These cannot be uninstalled here: they come with modules, and would be reinstalled anyway. To stop using one, turn off the modules that use it.",
 	"panels.market.listSeparator": ", ",
 	"panels.market.sharedMissing": "not installed",
 	"panels.market.sharedOutdated": "update available",
@@ -1141,8 +1257,18 @@ var en = {
 	"panels.market.installedSection": "Installed",
 	"panels.market.sectionLocal": "Linked locally",
 	"panels.market.sectionUnlisted": "Not from the market",
+	"panels.market.sectionPlugins": "Installed opencli plugins",
 	"panels.market.moduleOutdated": "update available",
+	"panels.market.moduleRefused": "This module was built for an older version of the workbench, so it does not work here. Update it, or uninstall.",
+	"panels.market.moduleRefusedDetail": "Why it cannot be used: {reason}",
 	"panels.market.moduleRestartHint": "installed but not active — restart dsh once to bring it up",
+	"panels.market.pluginLocalNoUpdate": "Installed from a local folder, so there is nowhere to check for a newer version — uninstall only",
+	"panels.market.pluginKeptInUse": "Files kept for now: {names} still uses it.",
+	"panels.market.pluginKeptUnsure": "Files kept for now: some modules on this machine do not say what they use, so it is unclear who needs it.",
+	"panels.market.pluginKeptHeld": "Files kept: this one is yours, and a module letting go will not remove it.",
+	"panels.market.pluginKeptUnnamed": "Files kept for now: this one cannot be identified as a plugin, so it is unclear who needs it.",
+	"panels.market.pluginAlsoKnownAs": "Its package is {pkg} (updates and uninstall use that)",
+	"panels.market.pluginBroken": "This install is broken: it cannot be identified as a plugin. Uninstall it, or install it again by package name above.",
 	"panels.market.restartNeeded": "The new version is installed — restart once to pick it up.",
 	"panels.market.foot": "After installing, enable it in the panel page of that project.",
 	"panels.market.recheck": "Check for updates",
@@ -1190,7 +1316,11 @@ var en = {
 	"panels.market.add.problemInstalled": "This module is already installed",
 	"panels.market.add.problemNotFound": "No such module found",
 	"panels.market.add.problemNotPackage": "That path does not exist or is not a valid module package",
-	"panels.market.add.problemNotBundle": "This package declares no bundle, so it cannot be installed as a module: {reason}",
+	"panels.market.add.problemNotBundle": "This package cannot be installed here: {reason}. If it is actually an opencli plugin, use its package name (for example opencli-plugin-cmdb) or a local folder — a git URL or tarball does not reveal what it is.",
+	"panels.market.add.problemNotWorkbenchModule": "This package does not match the workbench you are running, so installing it would not work. Pick another version, or ask the module author.",
+	"panels.market.add.problemNotModuleOrPlugin": "This package is neither a workbench module nor an opencli plugin, so installing it would do nothing. Pick another version, or ask the package author.",
+	"panels.market.add.failureNotModuleOrPlugin": "This package is neither a workbench module nor an opencli plugin, so installing it would do nothing",
+	"panels.market.add.installedPlugin": "Installed: the opencli plugin {name}",
 	"panels.market.add.problemNetwork": "Cannot reach the module source; check the network and retry",
 	"panels.market.add.problemUnknown": "Cannot fetch module information: {reason}",
 	"panels.market.add.failureNetwork": "The network connection failed",
@@ -1221,6 +1351,7 @@ var en = {
 	"panels.market.add.registryPnpm": "pnpm's own registry",
 	"panels.market.add.check": "Check",
 	"panels.market.add.checking": "Checking…",
+	"panels.market.add.classifying": "Working out what it is…",
 	"panels.market.add.change": "Edit",
 	"panels.market.add.previewTitle": "About to install",
 	"panels.market.add.fieldName": "Package",
@@ -1429,6 +1560,7 @@ var zh = {
 	"panels.market.sectionPending": "未安装",
 	"panels.market.sectionShared": "共用依赖",
 	"panels.market.sharedUsedBy": "供 {modules} 使用",
+	"panels.market.sharedFoot": "这一段不给卸载：它们跟着模块来，卸掉也会被装回来。要停用一份，就去关掉正在用它的那些模块。",
 	"panels.market.listSeparator": "、",
 	"panels.market.sharedMissing": "未装",
 	"panels.market.sharedOutdated": "有新版",
@@ -1456,8 +1588,18 @@ var zh = {
 	"panels.market.installedSection": "已安装",
 	"panels.market.sectionLocal": "本地装的",
 	"panels.market.sectionUnlisted": "不是从市场装的",
+	"panels.market.sectionPlugins": "已安装 opencli 插件",
 	"panels.market.moduleOutdated": "有新版",
+	"panels.market.moduleRefused": "这个模块是给旧版本的工作台写的，现在用不了。更新它，或者卸载。",
+	"panels.market.moduleRefusedDetail": "装不上的原因：{reason}",
 	"panels.market.moduleRestartHint": "装好了但还没生效 —— 重启一次 dsh 就会出来",
+	"panels.market.pluginLocalNoUpdate": "本地装的，没地方查新版，所以只给卸载",
+	"panels.market.pluginKeptInUse": "文件先留着：{names} 还要用它。",
+	"panels.market.pluginKeptUnsure": "文件先留着：这台机器上还有模块看不出用了什么，说不准谁在用它。",
+	"panels.market.pluginKeptHeld": "文件留着：你自己装的那一份，模块放手不动它。",
+	"panels.market.pluginKeptUnnamed": "文件先留着：看不出这是哪个插件，说不准谁在用它。",
+	"panels.market.pluginAlsoKnownAs": "包名是 {pkg}（更新与卸载按它来）",
+	"panels.market.pluginBroken": "这份装坏了：看不出它是个插件。可以卸载，或者去上面按包名再装一次。",
 	"panels.market.restartNeeded": "新版装好了，重启一次才生效。",
 	"panels.market.foot": "装好后到那个项目的面板页勾选它，模块才会出现。",
 	"panels.market.recheck": "重新检查更新",
@@ -1505,7 +1647,11 @@ var zh = {
 	"panels.market.add.problemInstalled": "该模块已安装",
 	"panels.market.add.problemNotFound": "未找到相关模块",
 	"panels.market.add.problemNotPackage": "该路径不存在或不是有效的模块包",
-	"panels.market.add.problemNotBundle": "这个包没有声明组合包，无法作为模块安装：{reason}",
+	"panels.market.add.problemNotBundle": "这个包装不进这里：{reason}。要是它其实是个 opencli 插件，请改用包名（例如 opencli-plugin-cmdb）或者本地目录 —— 从 git 地址和 tarball 判断不出它是什么。",
+	"panels.market.add.problemNotWorkbenchModule": "这个包跟现在的工作台对不上，装上也用不了。换一个版本，或者找这个模块的作者。",
+	"panels.market.add.problemNotModuleOrPlugin": "这个包既不是工作台的模块，也不是 opencli 的插件，装了也用不上。换一个版本，或者找这个包的作者。",
+	"panels.market.add.failureNotModuleOrPlugin": "这个包既不是工作台的模块，也不是 opencli 的插件，装了也用不上",
+	"panels.market.add.installedPlugin": "装上了：opencli 插件 {name}",
 	"panels.market.add.problemNetwork": "无法连接模块源，请检查网络后重试",
 	"panels.market.add.problemUnknown": "无法获取模块信息：{reason}",
 	"panels.market.add.failureNetwork": "网络连接失败",
@@ -1536,6 +1682,7 @@ var zh = {
 	"panels.market.add.registryPnpm": "pnpm 自己配的源",
 	"panels.market.add.check": "预检",
 	"panels.market.add.checking": "正在预检…",
+	"panels.market.add.classifying": "判定中…",
 	"panels.market.add.change": "改一下",
 	"panels.market.add.previewTitle": "将要安装",
 	"panels.market.add.fieldName": "包名",
@@ -1812,6 +1959,8 @@ var dist_exports = /* @__PURE__ */ __exportAll({
 	CenteredState: () => CenteredState,
 	ChoiceGroup: () => ChoiceGroup,
 	Component: () => Component,
+	DECLARATION_KEYS: () => DECLARATION_KEYS,
+	DECLARATION_REQUIRED_KEYS: () => DECLARATION_REQUIRED_KEYS,
 	DEFAULT_WORKSPACE_TITLE: () => DEFAULT_WORKSPACE_TITLE,
 	EVENTS_PATH: () => EVENTS_PATH,
 	EmptyState: () => EmptyState,
@@ -1850,6 +1999,7 @@ var dist_exports = /* @__PURE__ */ __exportAll({
 	STORAGE_KEY_PROJECT: () => STORAGE_KEY_PROJECT,
 	STORAGE_KEY_RIGHTBAR: () => STORAGE_KEY_RIGHTBAR,
 	STORAGE_KEY_RIGHTBAR_COLUMN: () => STORAGE_KEY_RIGHTBAR_COLUMN,
+	SUPPORTED_API_VERSIONS: () => SUPPORTED_API_VERSIONS,
 	SaveBar: () => SaveBar,
 	SettingsSection: () => SettingsSection,
 	SkeletonRows: () => SkeletonRows,
@@ -1860,6 +2010,7 @@ var dist_exports = /* @__PURE__ */ __exportAll({
 	VERSION_CHECK_TIMEOUT_MS: () => VERSION_CHECK_TIMEOUT_MS,
 	VERSION_CHECK_TTL_MS: () => VERSION_CHECK_TTL_MS,
 	WARM_TIMEOUT_MS: () => WARM_TIMEOUT_MS,
+	WORKBENCH_API_VERSION: () => 1,
 	apiGet: () => apiGet,
 	apiPost: () => apiPost,
 	blockerActionLabel: () => blockerActionLabel,
@@ -1869,6 +2020,7 @@ var dist_exports = /* @__PURE__ */ __exportAll({
 	buildMarker: () => buildMarker,
 	createFactChannel: () => createFactChannel,
 	cx: () => cx,
+	declarationProblemsOf: () => declarationProblemsOf,
 	decodeRef: () => decodeRef,
 	dictionaries: () => dictionaries,
 	en: () => en,
@@ -1892,6 +2044,7 @@ var dist_exports = /* @__PURE__ */ __exportAll({
 	parseMarkers: () => parseMarkers,
 	probeKeyOf: () => probeKeyOf,
 	quoteShellArg: () => quoteShellArg,
+	readDeclaration: () => readDeclaration,
 	readFlag: () => readFlag,
 	readText: () => readText,
 	relativeTime: () => relativeTime,
@@ -2004,6 +2157,7 @@ function createAdaptiveTransport() {
 //#endregion
 //#region src/shared/hooks/use-facts.ts
 var use_facts_exports = /* @__PURE__ */ __exportAll({
+	subscribeFactRevision: () => subscribeFactRevision,
 	useFactInvalidate: () => useFactInvalidate,
 	useFactRevision: () => useFactRevision
 });
@@ -2011,6 +2165,9 @@ var channel = createFactChannel({ transport: createAdaptiveTransport() });
 function useFactRevision(fact) {
 	return useSyncExternalStore(useCallback((listener) => channel.subscribe(fact, listener), [fact]), useCallback(() => channel.revisionOf(fact), [fact]));
 }
+function subscribeFactRevision(fact, listener) {
+	return channel.subscribe(fact, listener);
+}
 function useFactInvalidate() {
 	return useCallback((fact) => channel.refresh(fact), []);
 }
@@ -2535,8 +2692,7 @@ function buildMarketMocks(roster) {
 				...mine,
 				card: {
 					titleKey: "一个名字特别特别长的模块用来验证省略号会不会把按钮挤下去",
-					order: 10,
-					enabledByDefault: true
+					order: 10
 				}
 			}],
 			capabilities: probe$1(id, "ok"),
@@ -2640,6 +2796,24 @@ function buildMarketMocks(roster) {
 				installedActions: ["update-bundle", "remove-bundle"]
 			}
 		},
+		{
+			id: "installed-client-refused",
+			label: "本机装了，但浏览器这半没挂上（拒因由客户端报告）",
+			manifests: [found],
+			capabilities: {},
+			installed: [{
+				unit: id,
+				pkg: "@dsh-workbench/module-one",
+				installed: "0.1.2",
+				clientRefused: [`宿主没有担保 unit「${id}」的清单 —— 这个包要么没装进这份 profile，要么它的 dsh.workbench 没通过校验。卡片先不挂：清单只有一处真相（ADR-0038 §2.2）`]
+			}],
+			expect: {
+				rows: 0,
+				installed: 1,
+				installedActions: ["remove-bundle"],
+				installedNote: true
+			}
+		},
 		{
 			id: "installed-confirm",
 			label: "卸载本机模块（Modal 确认，标题带模块名）",
@@ -2688,6 +2862,95 @@ function buildMarketMocks(roster) {
 				actions: ["uninstall"]
 			}
 		},
+		{
+			id: "plugin-outdated",
+			label: "用户装的 opencli 插件：有新版（给更新 / 卸载）",
+			manifests: [],
+			capabilities: {},
+			plugins: [{
+				pkg: "opencli-plugin-cmdb",
+				name: "cmdb",
+				installed: "1.0.24",
+				latest: "1.0.25"
+			}],
+			expect: {
+				rows: 0,
+				plugins: 1,
+				pluginActions: ["update-plugin", "uninstall-plugin"]
+			}
+		},
+		{
+			id: "plugin-local",
+			label: "本地目录装的 opencli 插件：没有版本源（只给卸载，行上说清为什么）",
+			manifests: [],
+			capabilities: {},
+			plugins: [{
+				pkg: "/Users/me/my-local-plugin",
+				name: "my-local-plugin",
+				local: true
+			}],
+			expect: {
+				rows: 0,
+				plugins: 1,
+				pluginActions: ["uninstall-plugin"],
+				pluginNote: true,
+				pluginNoteKey: "panels.market.pluginLocalNoUpdate"
+			}
+		},
+		{
+			id: "plugin-alias",
+			label: "插件名 ≠ 包名：行上两个都写出来（更新 / 卸载按包名）",
+			manifests: [],
+			capabilities: {},
+			plugins: [{
+				pkg: "opencli-plugin-cmdb",
+				name: "cmdb",
+				installed: "1.0.24",
+				latest: "1.0.25"
+			}],
+			expect: {
+				rows: 0,
+				plugins: 1,
+				pluginActions: ["update-plugin", "uninstall-plugin"],
+				pluginNoteKey: "panels.market.pluginAlsoKnownAs"
+			}
+		},
+		{
+			id: "plugin-broken",
+			label: "装坏了的那一份（目录在但看不出是个插件）：行上直说，给卸载与指路",
+			manifests: [],
+			capabilities: {},
+			plugins: [{
+				pkg: "opencli-plugin-cmdb",
+				name: "cmdb",
+				installed: "1.0.24",
+				broken: true
+			}],
+			expect: {
+				rows: 0,
+				plugins: 1,
+				pluginActions: ["uninstall-plugin"],
+				pluginNoteKey: "panels.market.pluginBroken"
+			}
+		},
+		{
+			id: "plugin-kept",
+			label: "卸掉用户装的插件，但还有模块在用：文件先留着（行上给一句为什么）",
+			manifests: [],
+			capabilities: {},
+			plugins: [{
+				pkg: "opencli-plugin-cmdb",
+				name: "cmdb",
+				installed: "1.0.24"
+			}],
+			notice: "文件先留着：cmdb、argocd 还要用它。",
+			expect: {
+				rows: 0,
+				plugins: 1,
+				pluginActions: ["uninstall-plugin"],
+				notice: true
+			}
+		},
 		{
 			id: "empty",
 			label: "市场空态",
@@ -2745,7 +3008,6 @@ function createBoardRegistry() {
 			};
 		},
 		all: () => sorted,
-		visible: () => sorted.filter((module) => module.enabledByDefault),
 		byId: (id) => index.get(id),
 		stepOwner: (kind) => steps.get(kind),
 		subscribe(listener) {
@@ -2757,20 +3019,21 @@ function createBoardRegistry() {
 }
 //#endregion
 //#region src/app/units/registry.ts
-function toBoardModule(face) {
+function toBoardModule(face, manifest) {
 	return {
-		id: face.manifest.id,
-		titleKey: face.manifest.card?.titleKey ?? face.manifest.id,
-		order: face.manifest.card?.order ?? 100,
-		enabledByDefault: face.manifest.card?.enabledByDefault ?? false,
+		id: manifest.id,
+		titleKey: manifest.card?.titleKey ?? manifest.id,
+		order: manifest.card?.order ?? 100,
 		View: face.card,
 		...face.steps === void 0 ? {} : { steps: face.steps }
 	};
 }
-function createClientUnitRegistry() {
-	const faces = [];
+function createClientUnitRegistry(options = {}) {
+	const registrations = [];
+	const refusals = [];
 	const listeners = /* @__PURE__ */ new Set();
 	const board = createBoardRegistry();
+	let known = /* @__PURE__ */ new Map();
 	let revision = 0;
 	let manifestsCache;
 	function notify() {
@@ -2781,28 +3044,86 @@ function createClientUnitRegistry() {
 			console.warn(`[dsh-workbench] 套件注册的订阅者报错（不影响其它订阅者与这次注册）：${String(error)}`);
 		}
 	}
+	function warnRefusal(unit, reasons) {
+		refusals.push({
+			unit,
+			reasons
+		});
+		console.warn(`[dsh-workbench] ${unit === "" ? "这个模块" : unit} 的卡片没挂上：${reasons.join("；")}`);
+	}
+	function takeBackRefusal(unit) {
+		for (let at = refusals.length - 1; at >= 0; at -= 1) if (refusals[at]?.unit === unit) refusals.splice(at, 1);
+	}
+	function attach(entry) {
+		const manifest = known.get(entry.unit);
+		if (manifest === void 0) return false;
+		entry.mounted = {
+			manifest,
+			unmount: board.register(toBoardModule(entry.face, manifest))
+		};
+		takeBackRefusal(entry.unit);
+		return true;
+	}
+	function detach(entry) {
+		entry.mounted?.unmount();
+		entry.mounted = null;
+	}
 	return {
 		register(face) {
-			const id = face.manifest.id;
-			if (faces.some((item) => item.manifest.id === id)) throw new Error(`套件 id 重复：${id}（id 会进持久化配置，不能撞）`);
-			const unregisterBoard = board.register(toBoardModule(face));
-			faces.push(face);
+			const unit = typeof face?.unit === "string" ? face.unit.trim() : "";
+			if (unit === "") {
+				warnRefusal("", ["registerUnit({ unit, card }) 里的 unit 是空的 —— U1b 之前的旧形状是 registerUnit({ manifest, card })；现在清单由外壳从**已装清单**读出来、按 unit 交给浏览器（ADR-0038 §2.2）"]);
+				notify();
+				return () => {};
+			}
+			if (registrations.some((entry) => entry.unit === unit)) throw new Error(`套件 id 重复：${unit}（id 会进持久化配置，不能撞）`);
+			const entry = {
+				face,
+				unit,
+				mounted: null
+			};
+			registrations.push(entry);
 			manifestsCache = void 0;
+			if (!attach(entry)) {
+				warnRefusal(unit, [`宿主没有担保 unit「${unit}」的清单 —— 这个包要么没装进这份 profile，要么它的 dsh.workbench 没通过校验。卡片先不挂：清单只有一处真相（ADR-0038 §2.2）`]);
+				options.onUnknownUnit?.(unit);
+			}
 			notify();
 			return () => {
-				const at = faces.findIndex((item) => item.manifest.id === id);
+				const at = registrations.indexOf(entry);
 				if (at < 0) return;
-				faces.splice(at, 1);
+				registrations.splice(at, 1);
+				detach(entry);
+				takeBackRefusal(unit);
 				manifestsCache = void 0;
-				unregisterBoard();
 				notify();
 			};
 		},
-		all: () => faces,
+		all: () => registrations.map((entry) => entry.face),
 		manifests: () => {
-			manifestsCache ??= faces.map((face) => face.manifest);
+			manifestsCache ??= registrations.flatMap((entry) => entry.mounted === null ? [] : [entry.mounted.manifest]);
 			return manifestsCache;
 		},
+		refusals: () => refusals,
+		setManifests(manifests) {
+			known = new Map(manifests.map((manifest) => [manifest.id, manifest]));
+			let changed = false;
+			for (const entry of registrations) {
+				const next = known.get(entry.unit);
+				if (entry.mounted === null) {
+					if (next !== void 0 && attach(entry)) changed = true;
+					continue;
+				}
+				if (next === void 0) {
+					detach(entry);
+					warnRefusal(entry.unit, [`宿主不再担保 unit「${entry.unit}」的清单（模块被卸了？）—— 这张卡片先摘下来`]);
+					changed = true;
+				}
+			}
+			if (!changed) return;
+			manifestsCache = void 0;
+			notify();
+		},
 		board,
 		subscribe(listener) {
 			listeners.add(listener);
@@ -2837,11 +3158,9 @@ var messages = {
 };
 var manifest = {
 	id: FIXTURE_UNIT_ID,
-	kind: "board",
 	card: {
 		titleKey: KEY.cardTitle,
-		order: 900,
-		enabledByDefault: true
+		order: 900
 	},
 	tools: [],
 	host: { inject: [] }
@@ -2864,6 +3183,7 @@ function FixtureCard({ t, onRefresh }) {
 	}))));
 }
 var FIXTURE_FACE = {
+	unit: FIXTURE_UNIT_ID,
 	manifest,
 	messages,
 	card: FixtureCard
@@ -2884,11 +3204,9 @@ var crashMessages = {
 };
 var crashManifest = {
 	id: CRASH_UNIT_ID,
-	kind: "board",
 	card: {
 		titleKey: CRASH_KEY.cardTitle,
-		order: 899,
-		enabledByDefault: true
+		order: 899
 	},
 	tools: [],
 	host: { inject: [] }
@@ -2897,6 +3215,7 @@ function CrashingCard() {
 	throw new Error("夹具：这张卡片按 wbCrash=1 故意渲染失败（守「一张卡片崩溃不带走面板」）");
 }
 var CRASH_FACE = {
+	unit: CRASH_UNIT_ID,
 	manifest: crashManifest,
 	messages: crashMessages,
 	card: CrashingCard
@@ -2909,8 +3228,8 @@ function fixtureRoster(roster) {
 	return hasCard(roster) ? roster : SAMPLE_ROSTER;
 }
 function fixtureSeed(roster, all, crash = false) {
-	const base = hasCard(roster) ? all : [toBoardModule(FIXTURE_FACE)];
-	return crash ? [toBoardModule(CRASH_FACE), ...base] : base;
+	const base = hasCard(roster) ? all : [toBoardModule(FIXTURE_FACE, FIXTURE_FACE.manifest)];
+	return crash ? [toBoardModule(CRASH_FACE, CRASH_FACE.manifest), ...base] : base;
 }
 //#endregion
 //#region src/app/layouts/rightbar/market-rows.ts
@@ -2930,6 +3249,25 @@ var MARKET_DOT = {
 	unchecked: "idle",
 	unknown: "idle"
 };
+function marketRowTitle(row, t) {
+	return row.label ?? t(row.titleKey);
+}
+function withClientRefusals(modules, refusals) {
+	if (refusals.length === 0) return modules;
+	const byUnit = new Map(refusals.map((one) => [one.unit, one.reasons]));
+	return modules.map((module) => {
+		const reasons = byUnit.get(module.unit);
+		return reasons === void 0 ? module : {
+			...module,
+			clientRefused: reasons
+		};
+	});
+}
+function refusalReasons(host, client) {
+	const reported = host ?? [];
+	if (reported.length > 0) return reported;
+	return [...new Set(client ?? [])];
+}
 function mergeTitles(known, manifests) {
 	let next = null;
 	for (const manifest of manifests) {
@@ -2948,11 +3286,16 @@ function installedRows(modules, manifests, listed, known) {
 		const latest = module.latest;
 		const outdated = latest !== void 0 && latest !== module.installed;
 		const loaded = titles.has(module.unit);
+		const refused = refusalReasons(module.refused, module.clientRefused);
 		rows.push({
 			id: module.unit,
 			titleKey: titles.get(module.unit) ?? known?.get(module.unit) ?? module.pkg,
 			state: outdated ? "outdated" : "installed",
-			...loaded ? {} : { hint: "panels.market.moduleRestartHint" },
+			...loaded || refused.length > 0 ? {} : { hint: "panels.market.moduleRestartHint" },
+			...refused.length === 0 ? {} : { note: {
+				key: "panels.market.moduleRefused",
+				params: { reason: refused.join("；") }
+			} },
 			...module.local === true ? { local: true } : {},
 			pkg: module.pkg,
 			canInstall: false,
@@ -2971,6 +3314,7 @@ function installedRows(modules, manifests, listed, known) {
 	return rows;
 }
 function marketActions$1(row) {
+	if (row.plugin === true) return [...row.canUpdate ? ["update-plugin"] : [], ...row.canUninstall ? ["uninstall-plugin"] : []];
 	return [
 		...row.canInstall ? ["install"] : [],
 		...row.moduleUpdate === void 0 ? row.canUpdate ? ["update"] : [] : ["update-bundle"],
@@ -2994,7 +3338,7 @@ function envNameOf(source) {
 	if (source.kind === "npm") return source.registryEnv;
 	return "";
 }
-function noteOf(state, install, manifest) {
+function noteOf$1(state, install, manifest) {
 	if (state === "installed") return void 0;
 	if (install === "env-missing") return {
 		key: "panels.market.needEnv",
@@ -3053,7 +3397,7 @@ function marketRows(manifests, capabilities, updates = {}) {
 		const capability = capabilities?.[manifest.id];
 		const install = capability?.install;
 		const state = capabilities === null ? "checking" : stateOf(capability);
-		const note = noteOf(state, install, manifest);
+		const note = noteOf$1(state, install, manifest);
 		const onMachine = isOnMachine(state);
 		const reAdopt = capability?.released === true && install === void 0;
 		const entry = updates[manifest.id];
@@ -3225,6 +3569,63 @@ function useHostWrite(options) {
 	};
 }
 //#endregion
+//#region src/app/layouts/rightbar/market-plugin-rows.ts
+function installedPluginKept(value) {
+	if (typeof value !== "object" || value === null) return void 0;
+	const kept = value.kept;
+	if (typeof kept !== "object" || kept === null) return void 0;
+	const kind = kept.kind;
+	if (kind === "held") return { key: "panels.market.pluginKeptHeld" };
+	if (kind === "unnamed") return { key: "panels.market.pluginKeptUnnamed" };
+	if (kind === "unsure") return { key: "panels.market.pluginKeptUnsure" };
+	if (kind !== "claimed") return void 0;
+	const raw = kept.by;
+	const names = Array.isArray(raw) ? raw.filter((item) => typeof item === "string") : [];
+	return names.length === 0 ? { key: "panels.market.pluginKeptUnsure" } : {
+		key: "panels.market.pluginKeptInUse",
+		names
+	};
+}
+function noteOf(plugin) {
+	if (plugin.broken === true) return {
+		key: "panels.market.pluginBroken",
+		params: {}
+	};
+	if (plugin.local === true) return {
+		key: "panels.market.pluginLocalNoUpdate",
+		params: {}
+	};
+	if (plugin.name !== void 0 && plugin.name !== plugin.pkg) return {
+		key: "panels.market.pluginAlsoKnownAs",
+		params: { pkg: plugin.pkg }
+	};
+}
+function installedPluginRows(plugins) {
+	return plugins.map((plugin) => {
+		const name = plugin.name ?? plugin.pkg;
+		const outdated = plugin.installed !== void 0 && plugin.latest !== void 0 && plugin.latest !== plugin.installed;
+		const note = noteOf(plugin);
+		return {
+			id: `plugin:${plugin.pkg}`,
+			titleKey: plugin.pkg,
+			label: name,
+			plugin: true,
+			state: outdated ? "outdated" : "installed",
+			canInstall: false,
+			canUpdate: outdated,
+			canUninstall: true,
+			...plugin.local === true ? { local: true } : {},
+			...plugin.broken === true ? { broken: true } : {},
+			...note === void 0 ? {} : { note },
+			pkg: plugin.pkg,
+			...plugin.installed === void 0 ? {} : { version: {
+				installed: plugin.installed,
+				...plugin.latest === void 0 ? {} : { latest: plugin.latest }
+			} }
+		};
+	});
+}
+//#endregion
 //#region src/app/layouts/market/add-module-text.ts
 var GUIDE_ITEMS = [
 	{
@@ -3343,17 +3744,23 @@ var PROBLEM_KEYS = {
 	"not-found": "panels.market.add.problemNotFound",
 	"not-a-package": "panels.market.add.problemNotPackage",
 	"not-a-bundle": "panels.market.add.problemNotBundle",
+	"not-a-workbench-module": "panels.market.add.problemNotWorkbenchModule",
+	"not-a-module-or-plugin": "panels.market.add.problemNotModuleOrPlugin",
 	network: "panels.market.add.problemNetwork",
 	unknown: "panels.market.add.problemUnknown"
 };
 function problemKey(problem) {
 	return PROBLEM_KEYS[problem] ?? PROBLEM_KEYS.unknown;
 }
+function heldWizardPhase(phase, classifying) {
+	return classifying && (phase === "preview" || phase === "idle") ? "inspecting" : phase;
+}
 var FAILURE_KEYS = {
 	network: "panels.market.add.failureNetwork",
 	"spec-host": "panels.market.add.failureNetworkHost",
 	"not-found": "panels.market.add.failureNotFound",
 	"no-matching-version": "panels.market.add.failureNoMatchingVersion",
+	"not-a-module-or-plugin": "panels.market.add.failureNotModuleOrPlugin",
 	"disk-full": "panels.market.add.failureDiskFull",
 	permission: "panels.market.add.failurePermission",
 	"build-blocked": "panels.market.add.failureBuildBlocked",
@@ -3450,6 +3857,16 @@ function MarketChecking({ t }) {
 function MarketEmpty({ t }) {
 	return /* @__PURE__ */ h("div", { className: MarketPage_module_default.marketEmpty }, /* @__PURE__ */ h("div", { className: MarketPage_module_default.marketEmptyTitle }, t("panels.market.empty")));
 }
+var PanelFoot_module_default = {
+	foot: "_foot_1us83_1",
+	footText: "_footText_1us83_12",
+	footTextMd: "_footTextMd_1us83_17"
+};
+//#endregion
+//#region src/shared/components/PanelFoot.tsx
+function PanelFoot({ text, size = "sm", children }) {
+	return /* @__PURE__ */ h("footer", { className: PanelFoot_module_default.foot }, /* @__PURE__ */ h("span", { className: size === "md" ? PanelFoot_module_default.footTextMd : PanelFoot_module_default.footText }, text), children ?? null);
+}
 //#endregion
 //#region src/app/layouts/rightbar/market-view-text.ts
 var PROGRESS_KEY = {
@@ -3458,7 +3875,9 @@ var PROGRESS_KEY = {
 	"update-bundle": "panels.market.updating",
 	"remove-bundle": "panels.market.uninstalling",
 	uninstall: "panels.market.uninstalling",
-	"update-dependency": "panels.market.updating"
+	"update-dependency": "panels.market.updating",
+	"update-plugin": "panels.market.updating",
+	"uninstall-plugin": "panels.market.uninstalling"
 };
 var ACTION_LABEL_KEY = {
 	install: "panels.market.install",
@@ -3466,7 +3885,9 @@ var ACTION_LABEL_KEY = {
 	"update-bundle": "panels.market.update",
 	"remove-bundle": "panels.market.uninstall",
 	uninstall: "panels.market.uninstall",
-	"update-dependency": "panels.market.update"
+	"update-dependency": "panels.market.update",
+	"update-plugin": "panels.market.update",
+	"uninstall-plugin": "panels.market.uninstall"
 };
 //#endregion
 //#region src/app/layouts/rightbar/SharedSection.tsx
@@ -3514,21 +3935,18 @@ function SharedSection({ t, rows, pending, failureOf, act }) {
 		pending,
 		failure: failureOf(row.id),
 		onAct: (action) => void act(row.id, action)
-	}))));
-}
-var PanelFoot_module_default = {
-	foot: "_foot_1us83_1",
-	footText: "_footText_1us83_12",
-	footTextMd: "_footTextMd_1us83_17"
-};
-//#endregion
-//#region src/shared/components/PanelFoot.tsx
-function PanelFoot({ text, size = "sm", children }) {
-	return /* @__PURE__ */ h("footer", { className: PanelFoot_module_default.foot }, /* @__PURE__ */ h("span", { className: size === "md" ? PanelFoot_module_default.footTextMd : PanelFoot_module_default.footText }, text), children ?? null);
+	}))), /* @__PURE__ */ h(PanelFoot, {
+		size: "md",
+		text: t("panels.market.sharedFoot")
+	}));
 }
 //#endregion
 //#region src/app/layouts/rightbar/MarketView.tsx
-var CONFIRM_UNINSTALL = ["uninstall", "remove-bundle"];
+var CONFIRM_UNINSTALL = [
+	"uninstall",
+	"remove-bundle",
+	"uninstall-plugin"
+];
 var CONFIRM_REMOVE = ["remove-bundle"];
 function MarketLine({ t, row, pending, failure, onAct }) {
 	const running = pending !== null && pending.id === row.id ? pending : null;
@@ -3538,7 +3956,7 @@ function MarketLine({ t, row, pending, failure, onAct }) {
 	return /* @__PURE__ */ h("li", { className: MarketPage_module_default.marketRow }, /* @__PURE__ */ h("span", {
 		className: MarketPage_module_default.marketIcon,
 		"aria-hidden": "true"
-	}, /* @__PURE__ */ h(IconModules, { size: 18 })), /* @__PURE__ */ h("div", { className: MarketPage_module_default.marketMain }, /* @__PURE__ */ h("span", { className: MarketPage_module_default.marketName }, t(row.titleKey), row.version === void 0 ? null : /* @__PURE__ */ h("span", { className: MarketPage_module_default.marketVersion }, row.version.installed !== void 0 && row.version.latest !== void 0 && row.version.installed !== row.version.latest ? t("panels.market.versionArrow", {
+	}, /* @__PURE__ */ h(IconModules, { size: 18 })), /* @__PURE__ */ h("div", { className: MarketPage_module_default.marketMain }, /* @__PURE__ */ h("span", { className: MarketPage_module_default.marketName }, marketRowTitle(row, t), row.version === void 0 ? null : /* @__PURE__ */ h("span", { className: MarketPage_module_default.marketVersion }, row.version.installed !== void 0 && row.version.latest !== void 0 && row.version.installed !== row.version.latest ? t("panels.market.versionArrow", {
 		from: row.version.installed,
 		to: row.version.latest
 	}) : row.version.installed ?? row.version.latest ?? "")), /* @__PURE__ */ h("span", {
@@ -3563,11 +3981,14 @@ function MarketLine({ t, row, pending, failure, onAct }) {
 			variant: action === "install" ? "primary" : "outline",
 			className: danger ? "wb-dangerAction" : void 0,
 			icon: danger ? /* @__PURE__ */ h(IconTrashOutlineRegular, { size: 13 }) : void 0,
-			"aria-label": danger ? t("panels.market.uninstallLabel", { name: t(row.titleKey) }) : void 0,
+			"aria-label": danger ? t("panels.market.uninstallLabel", { name: marketRowTitle(row, t) }) : void 0,
 			disabled: locked,
 			onClick: () => onAct(action)
 		}, t(ACTION_LABEL_KEY[action]));
-	}))), row.note === void 0 ? null : /* @__PURE__ */ h("div", { className: MarketPage_module_default.marketNote }, t(row.note.key, row.note.params)), failure === null ? null : /* @__PURE__ */ h("div", { className: MarketPage_module_default.marketFailure }, failure));
+	}))), row.note === void 0 ? null : /* @__PURE__ */ h("div", {
+		className: MarketPage_module_default.marketNote,
+		title: row.note.params.reason === void 0 ? void 0 : t("panels.market.moduleRefusedDetail", row.note.params)
+	}, t(row.note.key, row.note.params)), failure === null ? null : /* @__PURE__ */ h("div", { className: MarketPage_module_default.marketFailure }, failure));
 }
 function ConfirmUninstall({ t, name, onConfirm, onCancel }) {
 	const [acknowledged, setAcknowledged] = useState(false);
@@ -3596,7 +4017,48 @@ function MarketSection({ t, titleKey, rows, pending, failureOf, act, confirmActi
 		onAct: (action) => confirmActions.includes(action) ? onConfirming(row.id) : void act(row.id, action)
 	}))));
 }
-function MarketView({ t, manifests, capabilities, freshness, onChanged, updates, installed, installedRead, settling, mock }) {
+function MarketBody({ t, shown, pluginList, installedList, shared, pending, failed, notice, act, onConfirming }) {
+	const failureOf = (id) => failed?.id === id ? failed.message : null;
+	return /* @__PURE__ */ h(Fragment, null, notice === null ? null : /* @__PURE__ */ h("div", { className: MarketPage_module_default.marketNote }, notice), marketSections(shown).map((section) => /* @__PURE__ */ h(MarketSection, {
+		key: section.id,
+		t,
+		titleKey: section.titleKey,
+		rows: section.rows,
+		pending,
+		failureOf,
+		act,
+		confirmActions: CONFIRM_UNINSTALL,
+		onConfirming
+	})), /* @__PURE__ */ h(MarketSection, {
+		t,
+		titleKey: "panels.market.sectionPlugins",
+		rows: pluginList,
+		pending,
+		failureOf,
+		act,
+		confirmActions: CONFIRM_UNINSTALL,
+		onConfirming
+	}), /* @__PURE__ */ h(MarketSection, {
+		t,
+		titleKey: installedList.length > 0 && installedList.every((row) => row.local === true) ? "panels.market.sectionLocal" : "panels.market.sectionUnlisted",
+		rows: installedList,
+		pending,
+		failureOf,
+		act,
+		confirmActions: CONFIRM_REMOVE,
+		onConfirming
+	}), /* @__PURE__ */ h(PanelFoot, {
+		size: "md",
+		text: t("panels.market.foot")
+	}), /* @__PURE__ */ h(SharedSection, {
+		t,
+		rows: shared,
+		pending,
+		failureOf,
+		act
+	}));
+}
+function MarketView({ t, manifests, capabilities, freshness, onChanged, updates, installed, installedRead, plugins, settling, mock }) {
 	const [titles, setTitles] = useState(/* @__PURE__ */ new Map());
 	useEffect(() => {
 		if (mock === void 0) setTitles((known) => mergeTitles(known, manifests));
@@ -3613,6 +4075,7 @@ function MarketView({ t, manifests, capabilities, freshness, onChanged, updates,
 	});
 	const [confirming, setConfirming] = useState(mock?.confirming ?? null);
 	const [failed, setFailed] = useState(mock?.failure ?? null);
+	const [notice, setNotice] = useState(mock?.notice ?? null);
 	const removing = pending !== null && pending.action === "remove-bundle" && failed?.id !== pending.id ? pending.id : null;
 	const installedList = installedRows((mock?.installed ?? installed ?? []).filter((module) => !(settling?.has(module.unit) ?? false) && module.unit !== removing), catalog, new Set(rows.map((row) => row.id)), titles);
 	const pendingRow = removing === null || pending === null || rows.some((row) => row.id === removing) ? void 0 : {
@@ -3626,7 +4089,12 @@ function MarketView({ t, manifests, capabilities, freshness, onChanged, updates,
 		...pending.version === void 0 ? {} : { version: { installed: pending.version } }
 	};
 	const shown = pendingRow === void 0 ? rows : [...rows, pendingRow];
-	const rowById = new Map([...shown, ...installedList].map((row) => [row.id, row]));
+	const pluginList = installedPluginRows(mock?.plugins ?? plugins ?? []);
+	const rowById = new Map([
+		...shown,
+		...installedList,
+		...pluginList
+	].map((row) => [row.id, row]));
 	const confirmingRow = confirming === null ? void 0 : rowById.get(confirming);
 	const act = async (id, action) => {
 		if (mock !== void 0) return;
@@ -3640,13 +4108,15 @@ function MarketView({ t, manifests, capabilities, freshness, onChanged, updates,
 		});
 		setConfirming(null);
 		setFailed(null);
+		if (action !== "uninstall-plugin") setNotice(null);
 		const dependency = action === "update-dependency";
+		const byName = action === "remove-bundle" || action === "update-plugin" || action === "uninstall-plugin";
 		const outcome = await provision.send(dependency ? {
 			action,
 			id
-		} : action === "remove-bundle" ? {
+		} : byName ? {
 			action,
-			name: rowById.get(id)?.pkg ?? ""
+			name: row?.pkg ?? ""
 		} : {
 			action,
 			unit: id
@@ -3660,6 +4130,10 @@ function MarketView({ t, manifests, capabilities, freshness, onChanged, updates,
 			});
 			return;
 		}
+		if (action === "uninstall-plugin") {
+			const kept = installedPluginKept(outcome.value);
+			setNotice(kept === void 0 ? null : t(kept.key, kept.names === void 0 ? {} : { names: kept.names.join(t("panels.market.listSeparator")) }));
+		}
 		const reason = changeFailure(changeOf(outcome.value), t);
 		onChanged();
 		if (reason !== void 0) setFailed({
@@ -3667,46 +4141,32 @@ function MarketView({ t, manifests, capabilities, freshness, onChanged, updates,
 			message: t("panels.market.failed", { reason })
 		});
 	};
-	if (!(freshness.loaded && installedRead !== false) || (settling?.size ?? 0) > 0 && shown.length === 0 && installedList.length === 0) return /* @__PURE__ */ h(MarketChecking, { t });
-	if (shown.length === 0 && installedList.length === 0) return /* @__PURE__ */ h(MarketEmpty, { t });
-	return /* @__PURE__ */ h(Fragment, null, marketSections(shown).map((section) => /* @__PURE__ */ h(MarketSection, {
-		key: section.id,
-		t,
-		titleKey: section.titleKey,
-		rows: section.rows,
-		pending,
-		failureOf: (id) => failed?.id === id ? failed.message : null,
-		act,
-		confirmActions: CONFIRM_UNINSTALL,
-		onConfirming: setConfirming
-	})), /* @__PURE__ */ h(MarketSection, {
+	const settled = freshness.loaded && installedRead !== false;
+	const nothing = shown.length === 0 && installedList.length === 0 && pluginList.length === 0;
+	if (!settled || (settling?.size ?? 0) > 0 && shown.length === 0 && installedList.length === 0) return /* @__PURE__ */ h(MarketChecking, { t });
+	if (nothing) return /* @__PURE__ */ h(MarketEmpty, { t });
+	return /* @__PURE__ */ h(Fragment, null, /* @__PURE__ */ h(MarketBody, {
 		t,
-		titleKey: installedList.length > 0 && installedList.every((row) => row.local === true) ? "panels.market.sectionLocal" : "panels.market.sectionUnlisted",
-		rows: installedList,
+		shown,
+		pluginList,
+		installedList,
+		shared,
 		pending,
-		failureOf: (id) => failed?.id === id ? failed.message : null,
+		failed,
+		notice,
 		act,
-		confirmActions: CONFIRM_REMOVE,
 		onConfirming: setConfirming
-	}), /* @__PURE__ */ h(PanelFoot, {
-		size: "md",
-		text: t("panels.market.foot")
-	}), /* @__PURE__ */ h(SharedSection, {
-		t,
-		rows: shared,
-		pending,
-		failureOf: (id) => failed?.id === id ? failed.message : null,
-		act
 	}), /* @__PURE__ */ h(ConfirmUninstall, {
 		key: confirming ?? "",
 		t,
-		name: confirmingRow === void 0 ? null : t(confirmingRow.titleKey),
+		name: confirmingRow === void 0 ? null : marketRowTitle(confirmingRow, t),
 		onCancel: () => setConfirming(null),
 		onConfirm: () => {
 			const id = confirming;
 			setConfirming(null);
 			if (id === null) return;
-			act(id, rowById.get(id)?.pkg === void 0 ? "uninstall" : "remove-bundle");
+			const row = rowById.get(id);
+			act(id, row?.plugin === true ? "uninstall-plugin" : row?.pkg === void 0 ? "uninstall" : "remove-bundle");
 		}
 	}));
 }
@@ -3716,6 +4176,9 @@ var BUNDLE_REGISTRIES_ROUTE = "bundle-registries";
 var BUNDLE_INSPECT_ROUTE = "bundle-inspect";
 var MODULE_VERSIONS_ROUTE = "module-versions";
 //#endregion
+//#region src/shared/api/installed-plugins.ts
+var INSTALLED_PLUGINS_ROUTE = "panels/plugins";
+//#endregion
 //#region src/shared/hooks/bundle-queries.ts
 function readBundleRegistries() {
 	return apiGet(BUNDLE_REGISTRIES_ROUTE);
@@ -3729,10 +4192,14 @@ function readBundleInspection(spec, registry) {
 function readModuleVersions(force = false) {
 	return apiGet(MODULE_VERSIONS_ROUTE, force ? { force: "1" } : void 0);
 }
+function readInstalledPlugins(force = false) {
+	return apiGet(INSTALLED_PLUGINS_ROUTE, force ? { force: "1" } : void 0);
+}
 //#endregion
 //#region src/app/layouts/market/use-module-versions.ts
 var state = {
 	modules: null,
+	plugins: null,
 	read: false,
 	checkedAt: null
 };
@@ -3757,10 +4224,13 @@ function runModuleVersionsRead(force = false) {
 	if (inFlight !== null && inFlight.force === force) return inFlight.promise;
 	const seq = readSeq += 1;
 	if (force) newestForceSeq = seq;
-	const promise = readModuleVersions(force).catch(() => null).then((response) => {
+	const promise = Promise.all([readModuleVersions(force), readInstalledPlugins(force)]).catch(() => null).then((responses) => {
 		if (!force && seq < newestForceSeq) return;
+		const versions = responses?.[0];
+		const plugins = responses?.[1];
 		publish({
-			modules: response?.ok === true ? response.modules : state.modules,
+			modules: versions?.ok === true ? versions.modules : state.modules,
+			plugins: plugins?.ok === true ? plugins.plugins : state.plugins,
 			read: true,
 			checkedAt: Date.now()
 		});
@@ -3792,6 +4262,7 @@ function useModuleVersions() {
 	}, []);
 	return {
 		modules: value.modules,
+		plugins: value.plugins,
 		read: value.read,
 		checkedAt: value.checkedAt,
 		reload
@@ -4010,7 +4481,7 @@ function AddModulePending({ t, kind }) {
 	})), /* @__PURE__ */ h("h2", {
 		className: AddModule_module_default.pendingTitle,
 		role: "status"
-	}, kind === "inspecting" ? t("panels.market.add.checking") : t("panels.market.add.installingTitle"))));
+	}, kind === "inspecting" ? t("panels.market.add.classifying") : t("panels.market.add.installingTitle"))));
 }
 function AddModulePreview({ t, state }) {
 	const preview = state.preview;
@@ -4028,6 +4499,7 @@ function AddModuleResult({ t, state }) {
 	const restart = outcome.change.application === "restart-required";
 	const cancelled = outcome.change.application === "cancelled";
 	const notModule = outcome.supply.state === "not-a-module";
+	const plugin = outcome.plugin;
 	const name = outcome.module.kind === "module" ? outcome.module.unit : outcome.module.pkg;
 	return /* @__PURE__ */ h("div", { className: AddModule_module_default.body }, /* @__PURE__ */ h("div", { className: AddModule_module_default.hero }, /* @__PURE__ */ h("span", {
 		className: AddModule_module_default.heroIcon,
@@ -4039,7 +4511,7 @@ function AddModuleResult({ t, state }) {
 	}) : /* @__PURE__ */ h(IconCheckCircleFillRegular, { size: 28 })), /* @__PURE__ */ h("h2", {
 		className: AddModule_module_default.wizardTitle,
 		role: failed ? "alert" : "status"
-	}, failed ? t("panels.market.add.failedTitle") : cancelled ? t("panels.market.add.cancelledTitle") : t("panels.market.add.installedTitle"))), /* @__PURE__ */ h("div", { className: AddModule_module_default.subject }, /* @__PURE__ */ h("p", { className: AddModule_module_default.subjectName }, outcome.module.pkg), name === outcome.module.pkg ? null : /* @__PURE__ */ h("p", { className: AddModule_module_default.subjectMeta }, name), outcome.module.version === void 0 ? null : /* @__PURE__ */ h("p", { className: AddModule_module_default.subjectMeta }, t("panels.market.add.installVersion", { version: outcome.module.version }))), failed ? /* @__PURE__ */ h("p", {
+	}, failed ? t("panels.market.add.failedTitle") : cancelled ? t("panels.market.add.cancelledTitle") : t("panels.market.add.installedTitle"))), /* @__PURE__ */ h("div", { className: AddModule_module_default.subject }, /* @__PURE__ */ h("p", { className: AddModule_module_default.subjectName }, outcome.module.pkg), name === outcome.module.pkg ? null : /* @__PURE__ */ h("p", { className: AddModule_module_default.subjectMeta }, name), outcome.module.version === void 0 ? null : /* @__PURE__ */ h("p", { className: AddModule_module_default.subjectMeta }, t("panels.market.add.installVersion", { version: outcome.module.version }))), plugin !== void 0 ? /* @__PURE__ */ h("p", { className: AddModule_module_default.result }, t("panels.market.add.installedPlugin", { name: plugin.name ?? plugin.pkg })) : failed ? /* @__PURE__ */ h("p", {
 		className: AddModule_module_default.resultWarn,
 		role: "alert"
 	}, t("panels.market.add.failed", { reason })) : restart ? /* @__PURE__ */ h("p", { className: AddModule_module_default.resultWarn }, t("panels.market.add.doneRestart")) : cancelled || notModule ? null : /* @__PURE__ */ h("p", { className: AddModule_module_default.result }, t("panels.market.add.tookEffect")), builds.length === 0 ? null : /* @__PURE__ */ h("div", { className: AddModule_module_default.approval }, /* @__PURE__ */ h("p", { className: AddModule_module_default.approvalTitle }, t("panels.market.add.approveTitle")), /* @__PURE__ */ h("p", { className: AddModule_module_default.approvalText }, t("panels.market.add.approveHint", { packages: builds.join("、") })), /* @__PURE__ */ h("p", { className: AddModule_module_default.approvalCaution }, t("panels.market.add.approveCaution"))), supply === void 0 || outcome.supply.state !== "failed" && (failed || cancelled) ? null : /* @__PURE__ */ h("p", { className: supplyTone(outcome.supply.state) }, t(supply, { reason: outcome.supply.reason ?? "" })), state.failure === null ? null : /* @__PURE__ */ h("p", { className: AddModule_module_default.problem }, state.failure), outcome.change.errorDetail === void 0 ? null : /* @__PURE__ */ h(Fragment, null, /* @__PURE__ */ h("p", { className: AddModule_module_default.detailLabel }, t("panels.market.add.details")), /* @__PURE__ */ h("p", { className: AddModule_module_default.detail }, outcome.change.errorDetail)));
@@ -4110,6 +4582,7 @@ var ADD_MODULE_MOCKS = [
 	refused("not-found"),
 	refused("not-a-package"),
 	refused("not-a-bundle"),
+	refused("not-a-module-or-plugin", "这个包既不是工作台的模块，也不是 opencli 的插件，装了也用不上"),
 	refused("network", "getaddrinfo ENOTFOUND registry.example.com"),
 	refused("unknown", "pnpm 的返回码是 1"),
 	{
@@ -4191,6 +4664,25 @@ var ADD_MODULE_MOCKS = [
 		spec: "@dsh-workbench/module-hello",
 		outcome: outcome({})
 	},
+	{
+		id: "done-plugin",
+		label: "装好了（opencli 插件）",
+		phase: "result",
+		spec: "opencli-plugin-cmdb",
+		outcome: {
+			change: change({ target: "opencli-plugin-cmdb" }),
+			module: {
+				kind: "unknown",
+				pkg: "opencli-plugin-cmdb"
+			},
+			supply: { state: "no-needs" },
+			plugin: {
+				kind: "opencli-plugin",
+				pkg: "opencli-plugin-cmdb",
+				name: "cmdb"
+			}
+		}
+	},
 	{
 		id: "done-restart",
 		label: "装好了（要重启）",
@@ -4285,6 +4777,42 @@ function stateOfMock(base, mock) {
 	};
 }
 //#endregion
+//#region src/shared/hooks/use-visible-busy.ts
+var use_visible_busy_exports = /* @__PURE__ */ __exportAll({
+	busyView: () => busyView,
+	heldPhase: () => heldPhase,
+	useVisibleBusy: () => useVisibleBusy
+});
+function heldPhase(phase, refreshing) {
+	return refreshing && phase === "ready" ? "loading" : phase;
+}
+function busyView(active, visible) {
+	return {
+		busy: visible,
+		settling: visible && !active
+	};
+}
+function useVisibleBusy(active, floorMs) {
+	const [visible, setVisible] = useState(active);
+	const since = useRef(null);
+	useEffect(() => {
+		if (active) {
+			if (since.current === null) since.current = Date.now();
+			setVisible(true);
+			return;
+		}
+		const held = holdBusy(since.current, Date.now(), floorMs);
+		since.current = null;
+		if (!held.visible) {
+			setVisible(false);
+			return;
+		}
+		const timer = setTimeout(() => setVisible(false), held.releaseInMs);
+		return () => clearTimeout(timer);
+	}, [active, floorMs]);
+	return busyView(active, visible);
+}
+//#endregion
 //#region src/app/layouts/market/use-add-module.ts
 function newRequestId() {
 	return `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
@@ -4307,6 +4835,7 @@ function useAddModule(options) {
 	const [failure, setFailure] = useState(null);
 	const generationRef = useRef(0);
 	const requestIdRef = useRef("");
+	const { busy: classifying } = useVisibleBusy(phase === "inspecting", 500);
 	const write = useHostWrite({
 		channel: "provision",
 		networkText: failedText
@@ -4404,7 +4933,8 @@ function useAddModule(options) {
 			setOutcome({
 				change: value.change,
 				module: value.module,
-				supply: value.supply
+				supply: value.supply,
+				...value.plugin === void 0 ? {} : { plugin: value.plugin }
 			});
 			setPhase("result");
 			if (value.change.application === "applied" || value.change.application === "restart-required") onInstalled();
@@ -4449,7 +4979,7 @@ function useAddModule(options) {
 		custom,
 		registryOpen,
 		guideOpen,
-		phase,
+		phase: heldWizardPhase(phase, classifying),
 		choices,
 		problem,
 		preview,
@@ -4607,10 +5137,10 @@ function makeMarketEntryIcon(units) {
 function MarketPanel({ t, units }) {
 	const manifests = useLiveManifests(units);
 	const { capabilities, checkedAt, checking, forceProbe, reload: reloadCapability } = useCapabilityMap(0);
-	const { modules, read: installedRead, reload: reloadVersions } = useModuleVersions();
+	const { modules, plugins, read: installedRead, reload: reloadVersions } = useModuleVersions();
 	const [adding, setAdding] = useState(false);
 	const updates = useMemo(() => marketUpdatesOf(modules), [modules]);
-	const installed = modules ?? void 0;
+	const installed = modules === null ? void 0 : withClientRefusals(modules, units.refusals());
 	const reload = useCallback(() => {
 		reloadCapability();
 		reloadVersions();
@@ -4699,6 +5229,7 @@ function MarketPanel({ t, units }) {
 		updates,
 		installed,
 		installedRead: mock === void 0 ? installedRead : mock.installedRead ?? true,
+		plugins,
 		settling: mock === void 0 ? settling : void 0,
 		mock
 	}), /* @__PURE__ */ h(AddModuleDialog, {
@@ -4754,6 +5285,41 @@ var CLIENT_UNITS = [];
 function assembleClientUnits(registry) {
 	for (const face of CLIENT_UNITS) registry.register(face);
 }
+//#endregion
+//#region src/shared/api/unit-manifests.ts
+var UNIT_MANIFESTS_ROUTE = "unit-manifests";
+//#endregion
+//#region src/app/units/manifests.ts
+function createUnitManifestLoader(options = {}) {
+	let inFlight = false;
+	let queued = false;
+	let watching = false;
+	const subscribeFacts = options.subscribeFacts ?? subscribeFactRevision;
+	const load = async (registry) => {
+		if (inFlight) {
+			queued = true;
+			return;
+		}
+		inFlight = true;
+		try {
+			const response = await apiGet(UNIT_MANIFESTS_ROUTE).catch(() => null);
+			if (response?.ok === true && Array.isArray(response.manifests)) registry.setManifests(response.manifests);
+		} finally {
+			inFlight = false;
+			if (queued) {
+				queued = false;
+				load(registry);
+			}
+		}
+	};
+	return (registry) => {
+		if (!watching) {
+			watching = true;
+			subscribeFacts(factOfRoute(UNIT_MANIFESTS_ROUTE), () => void load(registry));
+		}
+		load(registry);
+	};
+}
 var BootGate_module_default = {
 	actions: "_actions_jlw8j_1",
 	progress: "_progress_jlw8j_2",
@@ -7431,42 +7997,6 @@ function useLongTask(options) {
 	return { runs };
 }
 //#endregion
-//#region src/shared/hooks/use-visible-busy.ts
-var use_visible_busy_exports = /* @__PURE__ */ __exportAll({
-	busyView: () => busyView,
-	heldPhase: () => heldPhase,
-	useVisibleBusy: () => useVisibleBusy
-});
-function heldPhase(phase, refreshing) {
-	return refreshing && phase === "ready" ? "loading" : phase;
-}
-function busyView(active, visible) {
-	return {
-		busy: visible,
-		settling: visible && !active
-	};
-}
-function useVisibleBusy(active, floorMs) {
-	const [visible, setVisible] = useState(active);
-	const since = useRef(null);
-	useEffect(() => {
-		if (active) {
-			if (since.current === null) since.current = Date.now();
-			setVisible(true);
-			return;
-		}
-		const held = holdBusy(since.current, Date.now(), floorMs);
-		since.current = null;
-		if (!held.visible) {
-			setVisible(false);
-			return;
-		}
-		const timer = setTimeout(() => setVisible(false), held.releaseInMs);
-		return () => clearTimeout(timer);
-	}, [active, floorMs]);
-	return busyView(active, visible);
-}
-//#endregion
 //#region src/shared/hooks/use-unit-board.ts
 var use_unit_board_exports = /* @__PURE__ */ __exportAll({ useUnitBoard: () => useUnitBoard });
 function useUnitBoard(options) {
@@ -7680,7 +8210,7 @@ var kit = {
 };
 function messagesOf(units) {
 	return units.map((face) => ({
-		unit: face.manifest.id,
+		unit: face.unit,
 		...face.messages === void 0 ? {} : { messages: face.messages }
 	}));
 }
@@ -7721,12 +8251,14 @@ function apply(ctx) {
 	}
 }
 function mount(ctx) {
-	const units = createClientUnitRegistry();
+	const loadUnitManifests = createUnitManifestLoader();
+	const units = createClientUnitRegistry({ onUnknownUnit: () => loadUnitManifests(units) });
 	ctx.provide(UNITS_SERVICE, {
 		registerUnit: (face) => units.register(face),
 		manifests: () => units.manifests()
 	});
 	assembleClientUnits(units);
+	loadUnitManifests(units);
 	const store = rightbarStore;
 	const observable = {
 		getSnapshot: () => store.getSnapshot(),