@dsh-workbench/shared 0.1.17 → 0.1.18

package/dist/api/unit-declaration.d.ts

@@ -8,6 +8,7 @@ export interface UnitCardDeclaration {
 export interface UnitToolDeclaration {
     readonly name: string;
     readonly writes: boolean;
+    readonly key?: string;
 }
 export interface UnitDeclaration {
     readonly apiVersion: number;

package/dist/api/unit-declaration.js

@@ -16,7 +16,8 @@ export const DECLARATION_REQUIRED_KEYS = [
     'host',
 ];
 const CARD_KEYS = ['titleKey', 'order'];
-const TOOL_KEYS = ['name', 'writes'];
+const TOOL_KEYS = ['name', 'writes', 'key'];
+const TOOL_KEY_SHAPE = /^[a-z][a-zA-Z0-9]*$/;
 const HOST_KEYS = ['inject', 'optional'];
 function text(value) {
     return typeof value === 'string' ? value.trim() : '';
@@ -89,6 +90,7 @@ export function declarationProblemsOf(subject, raw) {
         }
         else {
             const seen = new Set();
+            const seenKeys = new Set();
             tools.forEach((tool, index) => {
                 const at = `dsh.workbench.tools[${index}]`;
                 if (!isRecord(tool)) {
@@ -112,6 +114,19 @@ export function declarationProblemsOf(subject, raw) {
                 if (typeof tool.writes !== 'boolean') {
                     problems.push(`${subject}: ${at}.writes 要是 true / false（它是"这会写"的唯一声明，缺了审批无从认领）`);
                 }
+                if (tool.key !== undefined) {
+                    const key = text(tool.key);
+                    if (!TOOL_KEY_SHAPE.test(key)) {
+                        problems.push(`${subject}: ${at}.key 要是 lowerCamelCase 的标识符（如 \`sync\` / \`podLogs\`），` +
+                            `现在是 ${JSON.stringify(tool.key)} —— 它会变成生成物里的键名，所以不引号、不许带点或横线`);
+                    }
+                    else if (seenKeys.has(key)) {
+                        problems.push(`${subject}: ${at}.key「${key}」与前面那条撞了 —— 生成物里的键只能有一个`);
+                    }
+                    else {
+                        seenKeys.add(key);
+                    }
+                }
             });
         }
     }

package/dist/i18n/en.js

@@ -65,11 +65,10 @@ export const en = {
     'panels.market.missing': 'not installed',
     'panels.market.unchecked': 'unknown',
     'panels.market.checking': 'checking',
-    'panels.market.sectionInstalled': 'Installed',
+    'panels.market.sectionInstalled': 'Installed modules',
     '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',
@@ -94,15 +93,13 @@ export const en = {
     'panels.market.noSource': 'This module declares no install method — install it yourself',
     'panels.market.badSource': 'The install method is incomplete — install it yourself',
     'panels.market.empty': 'No modules available',
-    'panels.market.installedSection': 'Installed',
-    'panels.market.sectionLocal': 'Linked locally',
+    'panels.market.sectionLocal': 'Local modules',
     '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.',

package/dist/i18n/index.d.ts

@@ -67,11 +67,10 @@ export declare const dictionaries: {
         readonly 'panels.market.missing': "未装";
         readonly 'panels.market.unchecked': "状态未知";
         readonly 'panels.market.checking': "检测中";
-        readonly 'panels.market.sectionInstalled': "已安装";
+        readonly 'panels.market.sectionInstalled': "已安装模块";
         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,15 +95,13 @@ export declare const dictionaries: {
         readonly 'panels.market.noSource': "这个模块没声明怎么装，只能自己动手";
         readonly 'panels.market.badSource': "安装方式没写全，只能自己动手";
         readonly 'panels.market.empty': "暂无可用模块";
-        readonly 'panels.market.installedSection': "已安装";
-        readonly 'panels.market.sectionLocal': "本地装的";
+        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': "文件留着：你自己装的那一份，模块放手不动它。";
@@ -329,7 +326,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.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>;
+    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.sectionLocal" | "panels.market.sectionUnlisted" | "panels.market.sectionPlugins" | "panels.market.moduleOutdated" | "panels.market.moduleRefused" | "panels.market.moduleRefusedDetail" | "panels.market.moduleRestartHint" | "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

@@ -65,11 +65,10 @@ export declare const zh: {
     readonly 'panels.market.missing': "未装";
     readonly 'panels.market.unchecked': "状态未知";
     readonly 'panels.market.checking': "检测中";
-    readonly 'panels.market.sectionInstalled': "已安装";
+    readonly 'panels.market.sectionInstalled': "已安装模块";
     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': "有新版";
@@ -94,15 +93,13 @@ export declare const zh: {
     readonly 'panels.market.noSource': "这个模块没声明怎么装，只能自己动手";
     readonly 'panels.market.badSource': "安装方式没写全，只能自己动手";
     readonly 'panels.market.empty': "暂无可用模块";
-    readonly 'panels.market.installedSection': "已安装";
-    readonly 'panels.market.sectionLocal': "本地装的";
+    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': "文件留着：你自己装的那一份，模块放手不动它。";

package/dist/i18n/zh.js

@@ -65,11 +65,10 @@ export const zh = {
     'panels.market.missing': '未装',
     'panels.market.unchecked': '状态未知',
     'panels.market.checking': '检测中',
-    'panels.market.sectionInstalled': '已安装',
+    'panels.market.sectionInstalled': '已安装模块',
     'panels.market.sectionPending': '未安装',
     'panels.market.sectionShared': '共用依赖',
     'panels.market.sharedUsedBy': '供 {modules} 使用',
-    'panels.market.sharedFoot': '这一段不给卸载：它们跟着模块来，卸掉也会被装回来。要停用一份，就去关掉正在用它的那些模块。',
     'panels.market.listSeparator': '、',
     'panels.market.sharedMissing': '未装',
     'panels.market.sharedOutdated': '有新版',
@@ -94,15 +93,13 @@ export const zh = {
     'panels.market.noSource': '这个模块没声明怎么装，只能自己动手',
     'panels.market.badSource': '安装方式没写全，只能自己动手',
     'panels.market.empty': '暂无可用模块',
-    'panels.market.installedSection': '已安装',
-    'panels.market.sectionLocal': '本地装的',
+    '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': '文件留着：你自己装的那一份，模块放手不动它。',

package/dist/testing/declaration.d.ts

@@ -0,0 +1,2 @@
+import type { UnitManifest } from '../api/unit.js';
+export declare function declarationOfPackage(pkg: string, packageJson: URL | string): UnitManifest;

package/dist/testing/declaration.js

@@ -0,0 +1,21 @@
+import fs from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { readDeclaration } from '../api/unit-declaration.js';
+export function declarationOfPackage(pkg, packageJson) {
+    const at = typeof packageJson === 'string' ? packageJson : fileURLToPath(packageJson);
+    let parsed;
+    try {
+        parsed = JSON.parse(fs.readFileSync(at, 'utf8'));
+    }
+    catch (error) {
+        throw new Error(`${pkg}: 读不动 ${at} —— ${String(error)}`, { cause: error });
+    }
+    const declared = typeof parsed === 'object' && parsed !== null
+        ? parsed.dsh?.workbench
+        : undefined;
+    const read = readDeclaration(pkg, declared);
+    if (read.manifest === undefined) {
+        throw new Error(`${pkg} 的 dsh.workbench 读不出来：${read.problems.join('；')}`);
+    }
+    return read.manifest;
+}

package/dist/testing.d.ts

@@ -1 +1,2 @@
 export * from './testing/host-fakes.js';
+export * from './testing/declaration.js';

package/dist/testing.js

@@ -1 +1,2 @@
 export * from './testing/host-fakes.js';
+export * from './testing/declaration.js';

package/package.json

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

package/src/api/__tests__/unit-declaration.test.ts

@@ -0,0 +1,52 @@
+import { describe, expect, it } from 'vitest';
+import { declarationProblemsOf, readDeclaration } from '../unit-declaration.js';
+
+const declared = (tools: unknown) => ({
+  apiVersion: 1,
+  unit: 'demo',
+  card: null,
+  tools,
+  host: { inject: [] },
+});
+
+describe('清单里的工具声明', () => {
+  it('key 是可选的：不给就只是没有生成物可对', () => {
+    expect(declarationProblemsOf('@t/demo', declared([{ name: 'workbench_demo_sync', writes: true }]))).toEqual([]);
+  });
+
+  it('给了 key 就得是能当代码键名的 lowerCamelCase', () => {
+    expect(
+      declarationProblemsOf('@t/demo', declared([{ name: 'workbench_demo_sync', writes: true, key: 'sync' }])),
+    ).toEqual([]);
+    expect(
+      declarationProblemsOf('@t/demo', declared([{ name: 'workbench_demo_sync', writes: true, key: 'podLogs' }])),
+    ).toEqual([]);
+
+    for (const bad of ['Sync', 'pod-logs', 'pod_logs', '1sync', '', 'pod logs', '__proto__']) {
+      const problems = declarationProblemsOf(
+        '@t/demo',
+        declared([{ name: 'workbench_demo_sync', writes: true, key: bad }]),
+      );
+      expect(problems.join('\n'), `key=${JSON.stringify(bad)} 该红`).toMatch(/\.key 要是 lowerCamelCase/);
+    }
+  });
+
+  it('★ key 撞了当场红（生成物里的键只能有一个，不然生成出来是静默覆盖）', () => {
+    const problems = declarationProblemsOf(
+      '@t/demo',
+      declared([
+        { name: 'workbench_demo_sync', writes: true, key: 'sync' },
+        { name: 'workbench_demo_apply', writes: true, key: 'sync' },
+      ]),
+    );
+
+    expect(problems.join('\n')).toMatch(/key「sync」与前面那条撞了/);
+  });
+
+  it('key 不进外壳那份清单（外壳不读它，它是给代码用的）', () => {
+    const read = readDeclaration('@t/demo', declared([{ name: 'workbench_demo_sync', writes: true, key: 'sync' }]));
+
+    expect(read.problems).toEqual([]);
+    expect(read.manifest?.tools).toEqual([{ name: 'workbench_demo_sync', writes: true }]);
+  });
+});

package/src/api/unit-declaration.ts

@@ -12,6 +12,7 @@ export interface UnitCardDeclaration {
 export interface UnitToolDeclaration {
   readonly name: string;
   readonly writes: boolean;
+  readonly key?: string;
 }
 
 export interface UnitDeclaration {
@@ -41,7 +42,9 @@ export const DECLARATION_REQUIRED_KEYS: readonly string[] = [
 ];
 
 const CARD_KEYS = ['titleKey', 'order'];
-const TOOL_KEYS = ['name', 'writes'];
+const TOOL_KEYS = ['name', 'writes', 'key'];
+
+const TOOL_KEY_SHAPE = /^[a-z][a-zA-Z0-9]*$/;
 const HOST_KEYS = ['inject', 'optional'];
 
 function text(value: unknown): string {
@@ -130,6 +133,7 @@ export function declarationProblemsOf(subject: string, raw: unknown): readonly s
       problems.push(`${subject}: dsh.workbench.tools 要是一串声明，现在是 ${JSON.stringify(tools)}`);
     } else {
       const seen = new Set<string>();
+      const seenKeys = new Set<string>();
       tools.forEach((tool, index) => {
         const at = `dsh.workbench.tools[${index}]`;
         if (!isRecord(tool)) {
@@ -153,6 +157,19 @@ export function declarationProblemsOf(subject: string, raw: unknown): readonly s
             `${subject}: ${at}.writes 要是 true / false（它是"这会写"的唯一声明，缺了审批无从认领）`,
           );
         }
+        if (tool.key !== undefined) {
+          const key = text(tool.key);
+          if (!TOOL_KEY_SHAPE.test(key)) {
+            problems.push(
+              `${subject}: ${at}.key 要是 lowerCamelCase 的标识符（如 \`sync\` / \`podLogs\`），` +
+                `现在是 ${JSON.stringify(tool.key)} —— 它会变成生成物里的键名，所以不引号、不许带点或横线`,
+            );
+          } else if (seenKeys.has(key)) {
+            problems.push(`${subject}: ${at}.key「${key}」与前面那条撞了 —— 生成物里的键只能有一个`);
+          } else {
+            seenKeys.add(key);
+          }
+        }
       });
     }
   }

package/src/i18n/en.ts

@@ -70,11 +70,10 @@ export const en: Record<keyof WorkbenchMessages, string> = {
   'panels.market.missing': 'not installed',
   'panels.market.unchecked': 'unknown',
   'panels.market.checking': 'checking',
-  'panels.market.sectionInstalled': 'Installed',
+  'panels.market.sectionInstalled': 'Installed modules',
   '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',
@@ -101,15 +100,13 @@ export const en: Record<keyof WorkbenchMessages, string> = {
   'panels.market.noSource': 'This module declares no install method — install it yourself',
   'panels.market.badSource': 'The install method is incomplete — install it yourself',
   'panels.market.empty': 'No modules available',
-  'panels.market.installedSection': 'Installed',
-  'panels.market.sectionLocal': 'Linked locally',
+  'panels.market.sectionLocal': 'Local modules',
   '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.',

package/src/i18n/zh.ts

@@ -68,11 +68,10 @@ export const zh = {
   'panels.market.missing': '未装',
   'panels.market.unchecked': '状态未知',
   'panels.market.checking': '检测中',
-  'panels.market.sectionInstalled': '已安装',
+  'panels.market.sectionInstalled': '已安装模块',
   'panels.market.sectionPending': '未安装',
   'panels.market.sectionShared': '共用依赖',
   'panels.market.sharedUsedBy': '供 {modules} 使用',
-  'panels.market.sharedFoot': '这一段不给卸载：它们跟着模块来，卸掉也会被装回来。要停用一份，就去关掉正在用它的那些模块。',
   'panels.market.listSeparator': '、',
   'panels.market.sharedMissing': '未装',
   'panels.market.sharedOutdated': '有新版',
@@ -97,15 +96,13 @@ export const zh = {
   'panels.market.noSource': '这个模块没声明怎么装，只能自己动手',
   'panels.market.badSource': '安装方式没写全，只能自己动手',
   'panels.market.empty': '暂无可用模块',
-  'panels.market.installedSection': '已安装',
-  'panels.market.sectionLocal': '本地装的',
+  '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': '文件留着：你自己装的那一份，模块放手不动它。',

package/src/testing/__tests__/declaration.test.ts

@@ -0,0 +1,48 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { afterEach, describe, expect, it } from 'vitest';
+import { declarationOfPackage } from '../declaration.js';
+
+const roots: string[] = [];
+
+function packageAt(manifest: unknown, text?: string): string {
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'wb-declaration-'));
+  roots.push(root);
+  const at = path.join(root, 'package.json');
+  fs.writeFileSync(at, text ?? JSON.stringify({ name: '@t/demo', dsh: { workbench: manifest } }), 'utf8');
+  return at;
+}
+
+afterEach(() => {
+  for (const root of roots.splice(0)) fs.rmSync(root, { recursive: true, force: true });
+});
+
+const DECLARED = {
+  apiVersion: 1,
+  unit: 'demo',
+  card: { titleKey: 'demo.cardTitle', order: 7 },
+  tools: [{ name: 'workbench_demo_list', writes: false }],
+  host: { inject: [] },
+};
+
+describe('模块作者写用例时读自己那份声明', () => {
+  it('读出来的就是外壳会拿到的那份清单', () => {
+    const manifest = declarationOfPackage('@t/demo', packageAt(DECLARED));
+
+    expect(manifest.id).toBe('demo');
+    expect(manifest.card).toEqual({ titleKey: 'demo.cardTitle', order: 7 });
+    expect(manifest.tools).toEqual([{ name: 'workbench_demo_list', writes: false }]);
+  });
+
+  it('★ 声明有毛病就当场抛，并把 problems 原样带出来（别让用例拿着半个清单继续跑）', () => {
+    expect(() => declarationOfPackage('@t/demo', packageAt({ unit: 'demo' }))).toThrow(/apiVersion/);
+    expect(() =>
+      declarationOfPackage('@t/demo', packageAt({ ...DECLARED, faces: { host: 'src/host.ts' } })),
+    ).toThrow(/faces/);
+  });
+
+  it('package.json 本身读不动时也说清是哪个文件（不是一句 JSON 语法错）', () => {
+    expect(() => declarationOfPackage('@t/demo', packageAt({}, '{ 坏掉的'))).toThrow(/读不动/);
+  });
+});

package/src/testing/declaration.ts

@@ -0,0 +1,23 @@
+import fs from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import type { UnitManifest } from '../api/unit.js';
+import { readDeclaration } from '../api/unit-declaration.js';
+
+export function declarationOfPackage(pkg: string, packageJson: URL | string): UnitManifest {
+  const at = typeof packageJson === 'string' ? packageJson : fileURLToPath(packageJson);
+  let parsed: unknown;
+  try {
+    parsed = JSON.parse(fs.readFileSync(at, 'utf8'));
+  } catch (error) {
+    throw new Error(`${pkg}: 读不动 ${at} —— ${String(error)}`, { cause: error });
+  }
+  const declared =
+    typeof parsed === 'object' && parsed !== null
+      ? (parsed as { dsh?: { workbench?: unknown } }).dsh?.workbench
+      : undefined;
+  const read = readDeclaration(pkg, declared);
+  if (read.manifest === undefined) {
+    throw new Error(`${pkg} 的 dsh.workbench 读不出来：${read.problems.join('；')}`);
+  }
+  return read.manifest;
+}

package/src/testing.ts

@@ -1 +1,2 @@
 export * from './testing/host-fakes.js';
+export * from './testing/declaration.js';