@dsh-workbench/shared 0.1.15 → 0.1.17

package/dist/i18n/index.d.ts

@@ -71,6 +71,7 @@ export declare const dictionaries: {
         readonly 'panels.market.sectionPending': "未安装";
         readonly 'panels.market.sectionShared': "共用依赖";
         readonly 'panels.market.sharedUsedBy': "供 {modules} 使用";
+        readonly 'panels.market.sharedFoot': "这一段不给卸载：它们跟着模块来，卸掉也会被装回来。要停用一份，就去关掉正在用它的那些模块。";
         readonly 'panels.market.listSeparator': "、";
         readonly 'panels.market.sharedMissing': "未装";
         readonly 'panels.market.sharedOutdated': "有新版";
@@ -98,8 +99,18 @@ export declare const dictionaries: {
         readonly 'panels.market.installedSection': "已安装";
         readonly 'panels.market.sectionLocal': "本地装的";
         readonly 'panels.market.sectionUnlisted': "不是从市场装的";
+        readonly 'panels.market.sectionPlugins': "已安装 opencli 插件";
         readonly 'panels.market.moduleOutdated': "有新版";
+        readonly 'panels.market.moduleRefused': "这个模块是给旧版本的工作台写的，现在用不了。更新它，或者卸载。";
+        readonly 'panels.market.moduleRefusedDetail': "装不上的原因：{reason}";
         readonly 'panels.market.moduleRestartHint': "装好了但还没生效 —— 重启一次 dsh 就会出来";
+        readonly 'panels.market.pluginLocalNoUpdate': "本地装的，没地方查新版，所以只给卸载";
+        readonly 'panels.market.pluginKeptInUse': "文件先留着：{names} 还要用它。";
+        readonly 'panels.market.pluginKeptUnsure': "文件先留着：这台机器上还有模块看不出用了什么，说不准谁在用它。";
+        readonly 'panels.market.pluginKeptHeld': "文件留着：你自己装的那一份，模块放手不动它。";
+        readonly 'panels.market.pluginKeptUnnamed': "文件先留着：看不出这是哪个插件，说不准谁在用它。";
+        readonly 'panels.market.pluginAlsoKnownAs': "包名是 {pkg}（更新与卸载按它来）";
+        readonly 'panels.market.pluginBroken': "这份装坏了：看不出它是个插件。可以卸载，或者去上面按包名再装一次。";
         readonly 'panels.market.restartNeeded': "新版装好了，重启一次才生效。";
         readonly 'panels.market.foot': "装好后到那个项目的面板页勾选它，模块才会出现。";
         readonly 'panels.market.recheck': "重新检查更新";
@@ -147,7 +158,11 @@ export declare const dictionaries: {
         readonly 'panels.market.add.problemInstalled': "该模块已安装";
         readonly 'panels.market.add.problemNotFound': "未找到相关模块";
         readonly 'panels.market.add.problemNotPackage': "该路径不存在或不是有效的模块包";
-        readonly 'panels.market.add.problemNotBundle': "这个包没有声明组合包，无法作为模块安装：{reason}";
+        readonly 'panels.market.add.problemNotBundle': "这个包装不进这里：{reason}。要是它其实是个 opencli 插件，请改用包名（例如 opencli-plugin-cmdb）或者本地目录 —— 从 git 地址和 tarball 判断不出它是什么。";
+        readonly 'panels.market.add.problemNotWorkbenchModule': "这个包跟现在的工作台对不上，装上也用不了。换一个版本，或者找这个模块的作者。";
+        readonly 'panels.market.add.problemNotModuleOrPlugin': "这个包既不是工作台的模块，也不是 opencli 的插件，装了也用不上。换一个版本，或者找这个包的作者。";
+        readonly 'panels.market.add.failureNotModuleOrPlugin': "这个包既不是工作台的模块，也不是 opencli 的插件，装了也用不上";
+        readonly 'panels.market.add.installedPlugin': "装上了：opencli 插件 {name}";
         readonly 'panels.market.add.problemNetwork': "无法连接模块源，请检查网络后重试";
         readonly 'panels.market.add.problemUnknown': "无法获取模块信息：{reason}";
         readonly 'panels.market.add.failureNetwork': "网络连接失败";
@@ -178,6 +193,7 @@ export declare const dictionaries: {
         readonly 'panels.market.add.registryPnpm': "pnpm 自己配的源";
         readonly 'panels.market.add.check': "预检";
         readonly 'panels.market.add.checking': "正在预检…";
+        readonly 'panels.market.add.classifying': "判定中…";
         readonly 'panels.market.add.change': "改一下";
         readonly 'panels.market.add.previewTitle': "将要安装";
         readonly 'panels.market.add.fieldName': "包名";
@@ -313,7 +329,7 @@ export declare const dictionaries: {
         readonly 'panel.conversation': "对话";
         readonly 'panels.label': "全局面板";
     };
-    en: Record<"time.now" | "time.minutes" | "time.hours" | "time.days" | "blocker.retry" | "blocker.copy" | "blocker.unknown.title" | "blocker.login.go" | "blocker.login.titleGeneric" | "blocker.login.title" | "blocker.login.manual" | "blocker.login.hint" | "blocker.forbidden.open" | "blocker.forbidden.titleGeneric" | "blocker.forbidden.title" | "blocker.forbidden.hint" | "blocker.timeout.hint" | "blocker.exec.hint" | "blocker.fix.install" | "blocker.fix.update" | "blocker.market.open" | "env.unit.failed" | "env.unit.failedHint" | "env.unit.missingPlugin" | "env.unit.hint" | "env.unit.missingCommands" | "env.unit.missingCommandsHint" | "env.unit.unchecked" | "env.unit.uncheckedHint" | "brand.name" | "toggle.open" | "toggle.collapse" | "project.label" | "workspace.section" | "project.none" | "project.empty" | "project.add" | "project.search.label" | "project.search.placeholder" | "project.search.empty" | "project.rename.row" | "project.rename.current" | "project.rename.title" | "project.rename.description" | "project.rename.field" | "project.rename.placeholder" | "project.rename.hint" | "project.rename.save" | "project.rename.saving" | "project.rename.cancel" | "project.rename.failed" | "session.new" | "session.new.label" | "session.empty" | "session.noProject" | "session.pinned" | "session.actions" | "status.idle" | "status.running" | "status.waitingApproval" | "status.planReview" | "status.waitingAnswer" | "status.completed" | "status.subagentsRunning.one" | "status.subagentsRunning.other" | "panels.title" | "panels.reset" | "panels.enabled" | "panels.disabled" | "panels.choose" | "panels.buildModule" | "panels.failed" | "panels.hintEffect" | "panels.dragHint" | "panels.unknownStep" | "panels.labelWithHint" | "panels.dep.failed" | "panels.dep.missingPlugin" | "panels.dep.missingCommands" | "panels.dep.unchecked" | "panels.tab.modules" | "panels.tab.market" | "panels.browseMarket" | "panels.noneInstalled" | "panels.noneInstalledHint" | "panels.market.installed" | "panels.market.outdated" | "panels.market.hasNew" | "panels.market.missing" | "panels.market.unchecked" | "panels.market.checking" | "panels.market.sectionInstalled" | "panels.market.sectionPending" | "panels.market.sectionShared" | "panels.market.sharedUsedBy" | "panels.market.listSeparator" | "panels.market.sharedMissing" | "panels.market.sharedOutdated" | "panels.market.sharedUnsatisfied" | "panels.market.sharedOk" | "panels.market.versionArrow" | "panels.market.lead" | "panels.market.install" | "panels.market.update" | "panels.market.uninstall" | "panels.market.uninstallLabel" | "panels.market.installing" | "panels.market.updating" | "panels.market.uninstalling" | "panels.market.confirmUninstallTitle" | "panels.market.confirmUninstallDetail" | "panels.market.confirmUninstallAck" | "panels.market.confirmYes" | "panels.market.confirmNo" | "panels.market.failed" | "panels.market.needEnv" | "panels.market.noSource" | "panels.market.badSource" | "panels.market.empty" | "panels.market.installedSection" | "panels.market.sectionLocal" | "panels.market.sectionUnlisted" | "panels.market.moduleOutdated" | "panels.market.moduleRestartHint" | "panels.market.restartNeeded" | "panels.market.foot" | "panels.market.recheck" | "panels.market.checkUpdates" | "panels.market.checkedAt" | "panels.market.justNow" | "panels.market.minutesAgo" | "panels.market.hoursAgo" | "panels.market.add.description" | "panels.market.add.specPlaceholder" | "panels.market.add.guideToggle" | "panels.market.add.guideHide" | "panels.market.add.guideIdTitle" | "panels.market.add.guideIdExample" | "panels.market.add.guideIdHint" | "panels.market.add.guideGitTitle" | "panels.market.add.guideGitExample" | "panels.market.add.guideGitHint" | "panels.market.add.guidePathTitle" | "panels.market.add.guidePathExample" | "panels.market.add.guidePathHint" | "panels.market.add.guideExampleLabel" | "panels.market.add.guideFill" | "panels.market.add.guideSafety" | "panels.market.add.registryLegend" | "panels.market.add.registryOfficial" | "panels.market.add.registryMirror" | "panels.market.add.registryWithHost" | "panels.market.add.registryToggle" | "panels.market.add.installVersion" | "panels.market.add.registryDefault" | "panels.market.add.registryCustom" | "panels.market.add.registryCustomPlaceholder" | "panels.market.add.registryCustomHint" | "panels.market.add.registryCustomInvalid" | "panels.market.add.run" | "panels.market.add.edit" | "panels.market.add.changeRegistry" | "panels.market.add.installingTitle" | "panels.market.add.installedTitle" | "panels.market.add.failedTitle" | "panels.market.add.cancelledTitle" | "panels.market.add.failureNetworkHost" | "panels.market.add.problemInvalid" | "panels.market.add.problemInstalled" | "panels.market.add.problemNotFound" | "panels.market.add.problemNotPackage" | "panels.market.add.problemNotBundle" | "panels.market.add.problemNetwork" | "panels.market.add.problemUnknown" | "panels.market.add.failureNetwork" | "panels.market.add.failureNotFound" | "panels.market.add.failureNoMatchingVersion" | "panels.market.add.failureDiskFull" | "panels.market.add.failurePermission" | "panels.market.add.failureBuildBlocked" | "panels.market.add.failureIntegrity" | "panels.market.add.failureTimeout" | "panels.market.add.failurePnpmMissing" | "panels.market.add.failureGeneric" | "panels.market.add.approveTitle" | "panels.market.add.approveCaution" | "panels.market.add.approveRun" | "panels.market.add.restart" | "panels.market.add.tookEffect" | "panels.market.add.details" | "panels.market.add.open" | "panels.market.add.title" | "panels.market.add.intro" | "panels.market.add.specLabel" | "panels.market.add.specHint" | "panels.market.add.exampleTitle" | "panels.market.add.exampleFill" | "panels.market.add.registryLabel" | "panels.market.add.registryProfile" | "panels.market.add.registryPnpm" | "panels.market.add.check" | "panels.market.add.checking" | "panels.market.add.change" | "panels.market.add.previewTitle" | "panels.market.add.fieldName" | "panels.market.add.fieldVersion" | "panels.market.add.fieldDescription" | "panels.market.add.fieldSource" | "panels.market.add.install" | "panels.market.add.installing" | "panels.market.add.cancel" | "panels.market.add.close" | "panels.market.add.retry" | "panels.market.add.changeSource" | "panels.market.add.approveBuilds" | "panels.market.add.approveHint" | "panels.market.add.doneApplied" | "panels.market.add.doneRestart" | "panels.market.add.cancelled" | "panels.market.add.failed" | "panels.market.add.removed" | "panels.market.add.supplyPending" | "panels.market.add.supplyFailed" | "panels.market.add.notModule" | "panels.market.add.removedRestart" | "panels.market.add.remove" | "panels.market.add.problem.invalidSpec" | "panels.market.add.problem.alreadyInstalled" | "panels.market.add.problem.notFound" | "panels.market.add.problem.notAPackage" | "panels.market.add.problem.notABundle" | "panels.market.add.problem.network" | "panels.market.add.problem.unknown" | "panels.market.add.reason.invalidSpec" | "panels.market.add.reason.incompatible" | "panels.market.add.reason.notBundle" | "panels.market.add.reason.notRemovable" | "panels.market.add.reason.bundleInUse" | "panels.market.add.reason.stopProfile" | "panels.market.add.reason.staleApproval" | "panels.market.add.reason.operationError" | "panels.market.add.reason.buildBlocked" | "panels.market.add.reason.pnpmMissing" | "panels.market.add.reason.noMatchingVersion" | "panels.market.add.reason.diskFull" | "panels.market.add.reason.permission" | "panels.market.add.reason.integrity" | "panels.market.add.reason.timeout" | "panels.market.add.reason.network" | "panels.market.add.reason.notFound" | "panels.market.add.reason.unknown" | "blocker.fix.running" | "blocker.fix.failed" | "blocker.retry.running" | "panels.reading" | "panels.cardBroken" | "panels.cardRetry" | "panels.empty" | "panels.emptyHint" | "env.title" | "env.checking" | "env.installing" | "env.failed" | "env.elapsed" | "env.stepFailed.install" | "env.stepFailed.path" | "env.stepFailed.shell" | "env.bridge.ok" | "env.bridge.short" | "env.bridge.why" | "env.bridge.daemon" | "env.bridge.extension" | "env.bridge.extensionLink" | "env.bridge.profile" | "env.bridge.stale" | "env.bridge.unknown" | "env.fix.title" | "env.fix.why" | "env.fix.whyPath" | "env.fix.whyShell" | "env.fix.step" | "env.fix.stepPath" | "env.fix.stepShell" | "env.fix.permission" | "env.fix.network" | "env.fix.details" | "env.retry" | "env.copyCommand" | "env.copied" | "env.step.opencli" | "env.step.codingPlugin" | "env.step.bridge" | "env.step.warm" | "env.warm.done" | "env.warm.short" | "rightbar.label" | "rightbar.expand" | "rightbar.collapse" | "rightbar.column.label" | "rightbar.column.workbench" | "rightbar.column.dsh" | "rightbar.refresh" | "rightbar.refreshing" | "rightbar.updatedAt" | "rightbar.noProject" | "rightbar.openPlatform" | "coding.notARepo.title" | "error.unknown" | "board.title" | "panel.conversation" | "panels.label", string>;
+    en: Record<"time.now" | "time.minutes" | "time.hours" | "time.days" | "blocker.retry" | "blocker.copy" | "blocker.unknown.title" | "blocker.login.go" | "blocker.login.titleGeneric" | "blocker.login.title" | "blocker.login.manual" | "blocker.login.hint" | "blocker.forbidden.open" | "blocker.forbidden.titleGeneric" | "blocker.forbidden.title" | "blocker.forbidden.hint" | "blocker.timeout.hint" | "blocker.exec.hint" | "blocker.fix.install" | "blocker.fix.update" | "blocker.market.open" | "env.unit.failed" | "env.unit.failedHint" | "env.unit.missingPlugin" | "env.unit.hint" | "env.unit.missingCommands" | "env.unit.missingCommandsHint" | "env.unit.unchecked" | "env.unit.uncheckedHint" | "brand.name" | "toggle.open" | "toggle.collapse" | "project.label" | "workspace.section" | "project.none" | "project.empty" | "project.add" | "project.search.label" | "project.search.placeholder" | "project.search.empty" | "project.rename.row" | "project.rename.current" | "project.rename.title" | "project.rename.description" | "project.rename.field" | "project.rename.placeholder" | "project.rename.hint" | "project.rename.save" | "project.rename.saving" | "project.rename.cancel" | "project.rename.failed" | "session.new" | "session.new.label" | "session.empty" | "session.noProject" | "session.pinned" | "session.actions" | "status.idle" | "status.running" | "status.waitingApproval" | "status.planReview" | "status.waitingAnswer" | "status.completed" | "status.subagentsRunning.one" | "status.subagentsRunning.other" | "panels.title" | "panels.reset" | "panels.enabled" | "panels.disabled" | "panels.choose" | "panels.buildModule" | "panels.failed" | "panels.hintEffect" | "panels.dragHint" | "panels.unknownStep" | "panels.labelWithHint" | "panels.dep.failed" | "panels.dep.missingPlugin" | "panels.dep.missingCommands" | "panels.dep.unchecked" | "panels.tab.modules" | "panels.tab.market" | "panels.browseMarket" | "panels.noneInstalled" | "panels.noneInstalledHint" | "panels.market.installed" | "panels.market.outdated" | "panels.market.hasNew" | "panels.market.missing" | "panels.market.unchecked" | "panels.market.checking" | "panels.market.sectionInstalled" | "panels.market.sectionPending" | "panels.market.sectionShared" | "panels.market.sharedUsedBy" | "panels.market.sharedFoot" | "panels.market.listSeparator" | "panels.market.sharedMissing" | "panels.market.sharedOutdated" | "panels.market.sharedUnsatisfied" | "panels.market.sharedOk" | "panels.market.versionArrow" | "panels.market.lead" | "panels.market.install" | "panels.market.update" | "panels.market.uninstall" | "panels.market.uninstallLabel" | "panels.market.installing" | "panels.market.updating" | "panels.market.uninstalling" | "panels.market.confirmUninstallTitle" | "panels.market.confirmUninstallDetail" | "panels.market.confirmUninstallAck" | "panels.market.confirmYes" | "panels.market.confirmNo" | "panels.market.failed" | "panels.market.needEnv" | "panels.market.noSource" | "panels.market.badSource" | "panels.market.empty" | "panels.market.installedSection" | "panels.market.sectionLocal" | "panels.market.sectionUnlisted" | "panels.market.sectionPlugins" | "panels.market.moduleOutdated" | "panels.market.moduleRefused" | "panels.market.moduleRefusedDetail" | "panels.market.moduleRestartHint" | "panels.market.pluginLocalNoUpdate" | "panels.market.pluginKeptInUse" | "panels.market.pluginKeptUnsure" | "panels.market.pluginKeptHeld" | "panels.market.pluginKeptUnnamed" | "panels.market.pluginAlsoKnownAs" | "panels.market.pluginBroken" | "panels.market.restartNeeded" | "panels.market.foot" | "panels.market.recheck" | "panels.market.checkUpdates" | "panels.market.checkedAt" | "panels.market.justNow" | "panels.market.minutesAgo" | "panels.market.hoursAgo" | "panels.market.add.description" | "panels.market.add.specPlaceholder" | "panels.market.add.guideToggle" | "panels.market.add.guideHide" | "panels.market.add.guideIdTitle" | "panels.market.add.guideIdExample" | "panels.market.add.guideIdHint" | "panels.market.add.guideGitTitle" | "panels.market.add.guideGitExample" | "panels.market.add.guideGitHint" | "panels.market.add.guidePathTitle" | "panels.market.add.guidePathExample" | "panels.market.add.guidePathHint" | "panels.market.add.guideExampleLabel" | "panels.market.add.guideFill" | "panels.market.add.guideSafety" | "panels.market.add.registryLegend" | "panels.market.add.registryOfficial" | "panels.market.add.registryMirror" | "panels.market.add.registryWithHost" | "panels.market.add.registryToggle" | "panels.market.add.installVersion" | "panels.market.add.registryDefault" | "panels.market.add.registryCustom" | "panels.market.add.registryCustomPlaceholder" | "panels.market.add.registryCustomHint" | "panels.market.add.registryCustomInvalid" | "panels.market.add.run" | "panels.market.add.edit" | "panels.market.add.changeRegistry" | "panels.market.add.installingTitle" | "panels.market.add.installedTitle" | "panels.market.add.failedTitle" | "panels.market.add.cancelledTitle" | "panels.market.add.failureNetworkHost" | "panels.market.add.problemInvalid" | "panels.market.add.problemInstalled" | "panels.market.add.problemNotFound" | "panels.market.add.problemNotPackage" | "panels.market.add.problemNotBundle" | "panels.market.add.problemNotWorkbenchModule" | "panels.market.add.problemNotModuleOrPlugin" | "panels.market.add.failureNotModuleOrPlugin" | "panels.market.add.installedPlugin" | "panels.market.add.problemNetwork" | "panels.market.add.problemUnknown" | "panels.market.add.failureNetwork" | "panels.market.add.failureNotFound" | "panels.market.add.failureNoMatchingVersion" | "panels.market.add.failureDiskFull" | "panels.market.add.failurePermission" | "panels.market.add.failureBuildBlocked" | "panels.market.add.failureIntegrity" | "panels.market.add.failureTimeout" | "panels.market.add.failurePnpmMissing" | "panels.market.add.failureGeneric" | "panels.market.add.approveTitle" | "panels.market.add.approveCaution" | "panels.market.add.approveRun" | "panels.market.add.restart" | "panels.market.add.tookEffect" | "panels.market.add.details" | "panels.market.add.open" | "panels.market.add.title" | "panels.market.add.intro" | "panels.market.add.specLabel" | "panels.market.add.specHint" | "panels.market.add.exampleTitle" | "panels.market.add.exampleFill" | "panels.market.add.registryLabel" | "panels.market.add.registryProfile" | "panels.market.add.registryPnpm" | "panels.market.add.check" | "panels.market.add.checking" | "panels.market.add.classifying" | "panels.market.add.change" | "panels.market.add.previewTitle" | "panels.market.add.fieldName" | "panels.market.add.fieldVersion" | "panels.market.add.fieldDescription" | "panels.market.add.fieldSource" | "panels.market.add.install" | "panels.market.add.installing" | "panels.market.add.cancel" | "panels.market.add.close" | "panels.market.add.retry" | "panels.market.add.changeSource" | "panels.market.add.approveBuilds" | "panels.market.add.approveHint" | "panels.market.add.doneApplied" | "panels.market.add.doneRestart" | "panels.market.add.cancelled" | "panels.market.add.failed" | "panels.market.add.removed" | "panels.market.add.supplyPending" | "panels.market.add.supplyFailed" | "panels.market.add.notModule" | "panels.market.add.removedRestart" | "panels.market.add.remove" | "panels.market.add.problem.invalidSpec" | "panels.market.add.problem.alreadyInstalled" | "panels.market.add.problem.notFound" | "panels.market.add.problem.notAPackage" | "panels.market.add.problem.notABundle" | "panels.market.add.problem.network" | "panels.market.add.problem.unknown" | "panels.market.add.reason.invalidSpec" | "panels.market.add.reason.incompatible" | "panels.market.add.reason.notBundle" | "panels.market.add.reason.notRemovable" | "panels.market.add.reason.bundleInUse" | "panels.market.add.reason.stopProfile" | "panels.market.add.reason.staleApproval" | "panels.market.add.reason.operationError" | "panels.market.add.reason.buildBlocked" | "panels.market.add.reason.pnpmMissing" | "panels.market.add.reason.noMatchingVersion" | "panels.market.add.reason.diskFull" | "panels.market.add.reason.permission" | "panels.market.add.reason.integrity" | "panels.market.add.reason.timeout" | "panels.market.add.reason.network" | "panels.market.add.reason.notFound" | "panels.market.add.reason.unknown" | "blocker.fix.running" | "blocker.fix.failed" | "blocker.retry.running" | "panels.reading" | "panels.cardBroken" | "panels.cardRetry" | "panels.empty" | "panels.emptyHint" | "env.title" | "env.checking" | "env.installing" | "env.failed" | "env.elapsed" | "env.stepFailed.install" | "env.stepFailed.path" | "env.stepFailed.shell" | "env.bridge.ok" | "env.bridge.short" | "env.bridge.why" | "env.bridge.daemon" | "env.bridge.extension" | "env.bridge.extensionLink" | "env.bridge.profile" | "env.bridge.stale" | "env.bridge.unknown" | "env.fix.title" | "env.fix.why" | "env.fix.whyPath" | "env.fix.whyShell" | "env.fix.step" | "env.fix.stepPath" | "env.fix.stepShell" | "env.fix.permission" | "env.fix.network" | "env.fix.details" | "env.retry" | "env.copyCommand" | "env.copied" | "env.step.opencli" | "env.step.codingPlugin" | "env.step.bridge" | "env.step.warm" | "env.warm.done" | "env.warm.short" | "rightbar.label" | "rightbar.expand" | "rightbar.collapse" | "rightbar.column.label" | "rightbar.column.workbench" | "rightbar.column.dsh" | "rightbar.refresh" | "rightbar.refreshing" | "rightbar.updatedAt" | "rightbar.noProject" | "rightbar.openPlatform" | "coding.notARepo.title" | "error.unknown" | "board.title" | "panel.conversation" | "panels.label", string>;
 };
 export type { WorkbenchMessages };
 export interface Dictionaries {

package/dist/i18n/zh.d.ts

@@ -69,6 +69,7 @@ export declare const zh: {
     readonly 'panels.market.sectionPending': "未安装";
     readonly 'panels.market.sectionShared': "共用依赖";
     readonly 'panels.market.sharedUsedBy': "供 {modules} 使用";
+    readonly 'panels.market.sharedFoot': "这一段不给卸载：它们跟着模块来，卸掉也会被装回来。要停用一份，就去关掉正在用它的那些模块。";
     readonly 'panels.market.listSeparator': "、";
     readonly 'panels.market.sharedMissing': "未装";
     readonly 'panels.market.sharedOutdated': "有新版";
@@ -96,8 +97,18 @@ export declare const zh: {
     readonly 'panels.market.installedSection': "已安装";
     readonly 'panels.market.sectionLocal': "本地装的";
     readonly 'panels.market.sectionUnlisted': "不是从市场装的";
+    readonly 'panels.market.sectionPlugins': "已安装 opencli 插件";
     readonly 'panels.market.moduleOutdated': "有新版";
+    readonly 'panels.market.moduleRefused': "这个模块是给旧版本的工作台写的，现在用不了。更新它，或者卸载。";
+    readonly 'panels.market.moduleRefusedDetail': "装不上的原因：{reason}";
     readonly 'panels.market.moduleRestartHint': "装好了但还没生效 —— 重启一次 dsh 就会出来";
+    readonly 'panels.market.pluginLocalNoUpdate': "本地装的，没地方查新版，所以只给卸载";
+    readonly 'panels.market.pluginKeptInUse': "文件先留着：{names} 还要用它。";
+    readonly 'panels.market.pluginKeptUnsure': "文件先留着：这台机器上还有模块看不出用了什么，说不准谁在用它。";
+    readonly 'panels.market.pluginKeptHeld': "文件留着：你自己装的那一份，模块放手不动它。";
+    readonly 'panels.market.pluginKeptUnnamed': "文件先留着：看不出这是哪个插件，说不准谁在用它。";
+    readonly 'panels.market.pluginAlsoKnownAs': "包名是 {pkg}（更新与卸载按它来）";
+    readonly 'panels.market.pluginBroken': "这份装坏了：看不出它是个插件。可以卸载，或者去上面按包名再装一次。";
     readonly 'panels.market.restartNeeded': "新版装好了，重启一次才生效。";
     readonly 'panels.market.foot': "装好后到那个项目的面板页勾选它，模块才会出现。";
     readonly 'panels.market.recheck': "重新检查更新";
@@ -145,7 +156,11 @@ export declare const zh: {
     readonly 'panels.market.add.problemInstalled': "该模块已安装";
     readonly 'panels.market.add.problemNotFound': "未找到相关模块";
     readonly 'panels.market.add.problemNotPackage': "该路径不存在或不是有效的模块包";
-    readonly 'panels.market.add.problemNotBundle': "这个包没有声明组合包，无法作为模块安装：{reason}";
+    readonly 'panels.market.add.problemNotBundle': "这个包装不进这里：{reason}。要是它其实是个 opencli 插件，请改用包名（例如 opencli-plugin-cmdb）或者本地目录 —— 从 git 地址和 tarball 判断不出它是什么。";
+    readonly 'panels.market.add.problemNotWorkbenchModule': "这个包跟现在的工作台对不上，装上也用不了。换一个版本，或者找这个模块的作者。";
+    readonly 'panels.market.add.problemNotModuleOrPlugin': "这个包既不是工作台的模块，也不是 opencli 的插件，装了也用不上。换一个版本，或者找这个包的作者。";
+    readonly 'panels.market.add.failureNotModuleOrPlugin': "这个包既不是工作台的模块，也不是 opencli 的插件，装了也用不上";
+    readonly 'panels.market.add.installedPlugin': "装上了：opencli 插件 {name}";
     readonly 'panels.market.add.problemNetwork': "无法连接模块源，请检查网络后重试";
     readonly 'panels.market.add.problemUnknown': "无法获取模块信息：{reason}";
     readonly 'panels.market.add.failureNetwork': "网络连接失败";
@@ -176,6 +191,7 @@ export declare const zh: {
     readonly 'panels.market.add.registryPnpm': "pnpm 自己配的源";
     readonly 'panels.market.add.check': "预检";
     readonly 'panels.market.add.checking': "正在预检…";
+    readonly 'panels.market.add.classifying': "判定中…";
     readonly 'panels.market.add.change': "改一下";
     readonly 'panels.market.add.previewTitle': "将要安装";
     readonly 'panels.market.add.fieldName': "包名";

package/dist/i18n/zh.js

@@ -69,6 +69,7 @@ export const zh = {
     'panels.market.sectionPending': '未安装',
     'panels.market.sectionShared': '共用依赖',
     'panels.market.sharedUsedBy': '供 {modules} 使用',
+    'panels.market.sharedFoot': '这一段不给卸载：它们跟着模块来，卸掉也会被装回来。要停用一份，就去关掉正在用它的那些模块。',
     'panels.market.listSeparator': '、',
     'panels.market.sharedMissing': '未装',
     'panels.market.sharedOutdated': '有新版',
@@ -96,8 +97,18 @@ export const 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': '重新检查更新',
@@ -145,7 +156,11 @@ export const 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': '网络连接失败',
@@ -176,6 +191,7 @@ export const 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': '包名',

package/dist/index.d.ts

@@ -8,6 +8,7 @@ export * from './api/host-write.js';
 export * from './api/long-task.js';
 export * from './api/unit-board.js';
 export * from './api/unit.js';
+export * from './api/unit-declaration.js';
 export * from './api/workbench-client.js';
 export * from './api/workbench-contract.js';
 export * from './components/Activity.js';

package/dist/index.js

@@ -8,6 +8,7 @@ export * from './api/host-write.js';
 export * from './api/long-task.js';
 export * from './api/unit-board.js';
 export * from './api/unit.js';
+export * from './api/unit-declaration.js';
 export * from './api/workbench-client.js';
 export * from './api/workbench-contract.js';
 export * from './components/Activity.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-workbench/shared",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "description": "工作台与模块共享的纯代码与契约类型：类型、纯逻辑、哑组件、平台解析。宿主侧的东西从 /host 进（不影响浏览器产物）。",
   "license": "MIT",
   "type": "module",

package/src/api/unit-declaration.ts

@@ -0,0 +1,227 @@
+import type { UnitEnvNeeds, UnitHostNeeds, UnitManifest } from './unit.js';
+
+export const WORKBENCH_API_VERSION = 1;
+
+export const SUPPORTED_API_VERSIONS: readonly number[] = [WORKBENCH_API_VERSION];
+
+export interface UnitCardDeclaration {
+  readonly titleKey: string;
+  readonly order: number;
+}
+
+export interface UnitToolDeclaration {
+  readonly name: string;
+  readonly writes: boolean;
+}
+
+export interface UnitDeclaration {
+  readonly apiVersion: number;
+  readonly unit: string;
+  readonly card: UnitCardDeclaration | null;
+  readonly tools: readonly UnitToolDeclaration[];
+  readonly host: UnitHostNeeds;
+  readonly env?: UnitEnvNeeds;
+}
+
+export const DECLARATION_KEYS: readonly string[] = [
+  'apiVersion',
+  'unit',
+  'card',
+  'tools',
+  'host',
+  'env',
+];
+
+export const DECLARATION_REQUIRED_KEYS: readonly string[] = [
+  'apiVersion',
+  'unit',
+  'card',
+  'tools',
+  'host',
+];
+
+const CARD_KEYS = ['titleKey', 'order'];
+const TOOL_KEYS = ['name', 'writes'];
+const HOST_KEYS = ['inject', 'optional'];
+
+function text(value: unknown): string {
+  return typeof value === 'string' ? value.trim() : '';
+}
+
+function isRecord(value: unknown): value is Readonly<Record<string, unknown>> {
+  return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+
+function outsideKeys(value: Readonly<Record<string, unknown>>, allowed: readonly string[]): string[] {
+  return Object.keys(value).filter((key) => !allowed.includes(key));
+}
+
+function listOf(keys: readonly string[]): string {
+  return keys.map((key) => JSON.stringify(key)).join(' / ');
+}
+
+function stringArrayProblems(at: string, value: unknown): string[] {
+  if (!Array.isArray(value)) return [`${at} 要是一串字符串，现在是 ${JSON.stringify(value)}`];
+  return value.flatMap((item, index) =>
+    text(item) === '' ? [`${at}[${index}] 不是非空字符串：${JSON.stringify(item)}`] : [],
+  );
+}
+
+export function declarationProblemsOf(subject: string, raw: unknown): readonly string[] {
+  if (!isRecord(raw)) return [`${subject}: dsh.workbench 不是一个对象 —— ${JSON.stringify(raw)}`];
+
+  const version = raw.apiVersion;
+  if (version === undefined) {
+    return [
+      `${subject}: dsh.workbench 没有 apiVersion —— 协议从 v${WORKBENCH_API_VERSION} 起，` +
+        `写 \`"apiVersion": ${WORKBENCH_API_VERSION}\`。缺它 = 外壳不认这个模块（ADR-0038 §2.3）`,
+    ];
+  }
+  if (!Number.isInteger(version) || !SUPPORTED_API_VERSIONS.includes(version as number)) {
+    return [
+      `${subject}: dsh.workbench.apiVersion 是 ${JSON.stringify(version)}，这里只认 ` +
+        `${SUPPORTED_API_VERSIONS.join(' / ')}（要整数）`,
+    ];
+  }
+
+  const problems: string[] = [];
+
+  const unknown = outsideKeys(raw, DECLARATION_KEYS);
+  if (unknown.length > 0) {
+    problems.push(
+      `${subject}: dsh.workbench 里有协议 v${WORKBENCH_API_VERSION} 不认识的键 ${listOf(unknown)} —— ` +
+        `只有 ${listOf(DECLARATION_KEYS)}。（拼错的键会被外壳**静默忽略**：那句声明等于没写）`,
+    );
+  }
+
+  for (const key of DECLARATION_REQUIRED_KEYS) {
+    if (raw[key] === undefined) {
+      problems.push(
+        `${subject}: dsh.workbench 缺 ${key}` +
+          (key === 'card' ? '（这个模块没有卡片就写 `"card": null`）' : ''),
+      );
+    }
+  }
+
+  const card = raw.card;
+  if (card !== undefined && 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 !== undefined) {
+    if (!Array.isArray(tools)) {
+      problems.push(`${subject}: dsh.workbench.tools 要是一串声明，现在是 ${JSON.stringify(tools)}`);
+    } else {
+      const seen = new Set<string>();
+      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 !== undefined) {
+    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 === undefined) {
+        problems.push(
+          `${subject}: dsh.workbench.host.inject 没写 —— 它声明这个模块要外壳的哪几个服务，` +
+            `外壳靠它判"能不能挂"。一个都不要也要写 \`"inject": []\``,
+        );
+      } else {
+        problems.push(...stringArrayProblems(`${subject}: dsh.workbench.host.inject`, host.inject));
+      }
+      if (host.optional !== undefined) {
+        problems.push(...stringArrayProblems(`${subject}: dsh.workbench.host.optional`, host.optional));
+      }
+    }
+  }
+
+  if (raw.env !== undefined && !isRecord(raw.env)) {
+    problems.push(
+      `${subject}: dsh.workbench.env 要是对象（command / plugins / libs）—— ` +
+        `语义由门禁的 env 判据查，这里只查形状`,
+    );
+  }
+
+  return problems;
+}
+
+export interface DeclarationRead {
+  readonly declaration?: UnitDeclaration;
+  readonly manifest?: UnitManifest;
+  readonly problems: readonly string[];
+}
+
+export function readDeclaration(subject: string, raw: unknown): DeclarationRead {
+  const problems = declarationProblemsOf(subject, raw);
+  if (problems.length > 0) return { problems };
+  const declaration = raw as UnitDeclaration;
+  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 === undefined ? {} : { optional: [...declaration.host.optional] }),
+      },
+      ...(declaration.env === undefined ? {} : { env: declaration.env }),
+    },
+  };
+}

package/src/api/unit.ts

@@ -1,7 +1,6 @@
 export interface UnitCard {
   readonly titleKey: string;
   readonly order: number;
-  readonly enabledByDefault: boolean;
 }
 
 export interface UnitTool {
@@ -51,7 +50,6 @@ export interface PluginRelease {
 
 export interface UnitManifest {
   readonly id: string;
-  readonly kind: 'board' | 'ui';
   readonly card: UnitCard | null;
   readonly tools: readonly UnitTool[];
   readonly host: UnitHostNeeds;

package/src/api/workbench-contract.ts

@@ -8,7 +8,9 @@ export type ProvisionAction =
   | 'install-bundle'
   | 'update-bundle'
   | 'remove-bundle'
-  | 'cancel-install';
+  | 'cancel-install'
+  | 'update-plugin'
+  | 'uninstall-plugin';
 
 export interface PluginStatePayload {
   readonly name: string;

package/src/components/ApprovalDetail.tsx

@@ -57,7 +57,7 @@ export function ApprovalDetail(props: ApprovalDetailProps) {
   if (owner?.approval !== undefined) {
     const Render = owner.approval.render;
     return (
-      <CardBoundary unit={owner.manifest.id} resetKey={props.callId ?? ''} t={t}>
+      <CardBoundary unit={owner.unit} resetKey={props.callId ?? ''} t={t}>
         <Render input={input} t={t} />
       </CardBoundary>
     );

package/src/components/board-module.ts

@@ -44,13 +44,12 @@ export interface BoardModule {
   readonly id: string;
   readonly titleKey: string;
   readonly order: number;
-  readonly enabledByDefault: boolean;
   readonly View: (props: BoardModuleProps) => ReactNode;
   readonly steps?: Readonly<Record<string, UnitStep>>;
 }
 
 export interface UnitClientFace {
-  readonly manifest: UnitManifest;
+  readonly unit: string;
   readonly card: (props: BoardModuleProps) => ReactNode;
   readonly steps?: Readonly<Record<string, UnitStep>>;
   readonly messages?: Dictionaries;
@@ -62,6 +61,10 @@ export interface UnitClientFace {
     | undefined;
 }
 
+export interface UnitOwnedClientFace extends UnitClientFace {
+  readonly manifest: UnitManifest;
+}
+
 export interface ApprovalInput {
   readonly tool: string;
   readonly args: Readonly<Record<string, unknown>>;

package/src/host/__tests__/plugin-ledger.test.ts

@@ -0,0 +1,94 @@
+import { describe, expect, it } from 'vitest';
+import {
+  heldEntriesOfHome,
+  heldEntryOfPlugin,
+  ledgerKeyOf,
+  parsePluginLedger,
+  pluginRetentionOf,
+  withReleasedEntry,
+  type PluginLedgerEntry,
+} from '../plugin-ledger.js';
+
+const HOME = '/h/workbench/opencli/home';
+
+function entry(over: Partial<PluginLedgerEntry> = {}): PluginLedgerEntry {
+  return {
+    opencliHome: HOME,
+    package: 'opencli-plugin-cmdb',
+    installedAt: '2026-10-14T00:00:00.000Z',
+    ...over,
+  };
+}
+
+describe('台账条目的「放手」那一笔', () => {
+  it('老文件（没有 releasedAt）读出来还是"用户持着"（读旧数据，不是垫片）', () => {
+    const parsed = parsePluginLedger({ entries: [entry()] });
+    expect(parsed).toHaveLength(1);
+    expect(parsed[0]?.releasedAt).toBeUndefined();
+    expect(heldEntriesOfHome(parsed, HOME)).toHaveLength(1);
+  });
+
+  it('★ 放手了的那一笔还在文件里（自动清得靠它认得"这是我们装的"），但不再是"持着"', () => {
+    const released = withReleasedEntry([entry()], HOME, 'opencli-plugin-cmdb', '2026-10-15T00:00:00.000Z');
+
+    expect(released).toHaveLength(1);
+    expect(released[0]?.releasedAt).toBe('2026-10-15T00:00:00.000Z');
+    expect(heldEntriesOfHome(released, HOME)).toEqual([]);
+  });
+
+  it('记两次放手不覆盖第一次的时间（第二次是重放，不是新事实）', () => {
+    const once = withReleasedEntry([entry()], HOME, 'opencli-plugin-cmdb', '2026-10-15T00:00:00.000Z');
+    const twice = withReleasedEntry(once, HOME, 'opencli-plugin-cmdb', '2026-10-16T00:00:00.000Z');
+
+    expect(twice[0]?.releasedAt).toBe('2026-10-15T00:00:00.000Z');
+  });
+
+  it('另一个 home 的那一笔不受影响（隔离 wrapper 会换 home）', () => {
+    const other = entry({ opencliHome: '/h/global/opencli/home' });
+    const released = withReleasedEntry([entry(), other], HOME, 'opencli-plugin-cmdb', '2026-10-15T00:00:00.000Z');
+
+    expect(released.find((item) => item.opencliHome !== HOME)?.releasedAt).toBeUndefined();
+    expect(heldEntriesOfHome(released, other.opencliHome)).toHaveLength(1);
+  });
+
+  it('★ 按插件名找"用户持着的"那一份：插件名与包名两边都认（§3.4 那条映射）', () => {
+    const entries = [entry({ name: 'cmdb' })];
+
+    expect(heldEntryOfPlugin(entries, HOME, 'cmdb')?.package).toBe('opencli-plugin-cmdb');
+    expect(heldEntryOfPlugin(entries, HOME, 'opencli-plugin-cmdb')?.name).toBe('cmdb');
+    expect(heldEntryOfPlugin(entries, HOME, '别的')).toBeUndefined();
+    expect(heldEntryOfPlugin(entries, HOME, '  ')).toBeUndefined();
+  });
+
+  it('放手了的那一笔不再算"用户持着"（模块放手时就可以删它了）', () => {
+    const released = withReleasedEntry([entry({ name: 'cmdb' })], HOME, 'opencli-plugin-cmdb', '2026-10-15T00:00:00.000Z');
+
+    expect(heldEntryOfPlugin(released, HOME, 'cmdb')).toBeUndefined();
+  });
+
+  it('键还是「home + 包名」（同一份文件里两个 home 不互相撒谎）', () => {
+    expect(ledgerKeyOf({ opencliHome: '/a', package: 'x' })).not.toBe(
+      ledgerKeyOf({ opencliHome: '/b', package: 'x' }),
+    );
+  });
+});
+
+describe('物理去留：由谁主张说话（动作与结果分层那条）', () => {
+  it('用户还持着 → 留着（模块放手不动它）', () => {
+    expect(pluginRetentionOf({ held: true, claimedBy: [], trustworthy: true })).toBe('keep-held');
+    expect(pluginRetentionOf({ held: true, claimedBy: ['x'], trustworthy: false })).toBe('keep-held');
+  });
+
+  it('★ 不是用户持的、引用又不可信 → 一律不删（宁可留一个孤儿，也不删别人的文件）', () => {
+    expect(pluginRetentionOf({ held: false, claimedBy: [], trustworthy: false })).toBe('keep-unsure');
+    expect(pluginRetentionOf({ held: false, claimedBy: ['x'], trustworthy: false })).toBe('keep-unsure');
+  });
+
+  it('还有模块在用 → 留着（点了卸载，文件也不动）', () => {
+    expect(pluginRetentionOf({ held: false, claimedBy: ['issues'], trustworthy: true })).toBe('keep-claimed');
+  });
+
+  it('★ 引用可信 + 没人主张 → 这才是唯一敢删的那一格', () => {
+    expect(pluginRetentionOf({ held: false, claimedBy: [], trustworthy: true })).toBe('remove');
+  });
+});