@dsh-workbench/shared 0.3.4 → 0.3.6

package/dist/i18n/index.d.ts

@@ -1,4 +1,5 @@
 import { type WorkbenchMessages } from './zh.js';
+/** 外壳自带的两份词表（`zh` 为基准、`en` 同构）：`client.tsx` 拿它当合并各套件词表的底座。 */
 export declare const dictionaries: {
     zh: {
         readonly 'brand.name': "工作台";
@@ -410,20 +411,19 @@ export declare const dictionaries: {
         readonly 'configSync.noSource': "这台机器上只有工作台这一个 profile，没有可同步的来源";
         readonly 'configSync.emptyProviders': "工作台还没有任何模型供应商 —— 去「配置同步」从某个 profile 把 llm- 那几行搬过来，或自己去「模型」里配。";
         readonly 'configSync.failed': "同步没成功，再试一次。";
-        readonly 'debug.status': "工作台 DIY 开发调试中";
-        readonly 'debug.status.trouble': "工作台 DIY 开发调试异常";
-        readonly 'debug.stalled': "工作台 DIY 调试暂停";
+        readonly 'debug.workspace': "这个工作区";
+        readonly 'debug.status': "「{title}」调试中";
+        readonly 'debug.status.trouble': "调试要你看一眼（{title}）";
+        readonly 'debug.stalled': "调试已暂停（{title}）";
         readonly 'debug.act.pause': "暂停调试";
         readonly 'debug.act.resume': "继续调试";
         readonly 'debug.act.stop': "结束调试";
         readonly 'debug.act.stop.ask': "确认结束";
-        readonly 'debug.card.here.title': "当前工作台 DIY 开发调试中";
+        readonly 'debug.card.here.title': "正在调试「{title}」";
         readonly 'debug.card.here.note': "请勿切换工作区和操作面板";
-        readonly 'debug.card.away.title': "工作台 DIY 开发调试中";
-        readonly 'debug.card.away.note': "请切换到工作台 DIY 工作区";
+        readonly 'debug.card.away.note': "请切回「{title}」那一屏";
         readonly 'debug.card.paused.note': "已暂停";
-        readonly 'debug.card.hidden.note': "请切换到工作台面板";
-        readonly 'debug.back': "回到工坊那一屏";
+        readonly 'debug.card.hidden.note': "请切回工作台面板";
         readonly 'record.waiting': "取证交接 · 等你出手";
         readonly 'record.waiting.note': "请在那一页按「开始录制」，做完按「结束录制」（录完不替你切回来）";
         readonly 'record.recording': "录制中";
@@ -438,10 +438,14 @@ export declare const dictionaries: {
         readonly 'approval.record.noUrl': "没给站点地址（这次会被当场拒）";
         readonly 'approval.record.oneAction': "一次操作";
         readonly 'approval.record.noSwitch': "录完不会替你切回来（左栏底部会亮一条状态）";
+        readonly 'approval.longTask.what': "要停的那一趟";
+        readonly 'approval.longTask.signal': "停了只是让外壳发出中断信号 —— 平台侧那趟活儿的收尾看模块自己";
     };
-    en: Record<"time.now" | "time.ago" | "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.add.busy" | "project.add.failed" | "project.search.label" | "project.search.placeholder" | "project.search.empty" | "project.group.workspaces" | "project.group.defaultWorkspace" | "project.group.workshop" | "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.list.label" | "session.copy" | "session.pinned" | "session.actions" | "status.idle" | "status.running" | "status.waitingApproval" | "status.planReview" | "status.waitingAnswer" | "status.compact.approval" | "status.compact.planReview" | "status.compact.answer" | "status.completed" | "status.subagentsRunning.one" | "status.subagentsRunning.other" | "project.attention.warning.one" | "project.attention.warning.other" | "project.attention.running.one" | "project.attention.running.other" | "project.attention.done.one" | "project.attention.done.other" | "project.attention.state.warning" | "project.attention.state.running" | "project.attention.state.done" | "hover.copied" | "time.short.minutes" | "time.short.hours" | "time.short.days" | "time.short.months" | "time.short.years" | "panels.title" | "panels.groupBoardless" | "panels.groupPlugins" | "panels.market.defaultHint" | "panels.market.defaultLabel" | "panels.market.defaultLocked" | "panels.followAll" | "panels.followAllConfirmTitle" | "panels.followAllConfirmDetail" | "panels.followAllConfirmAck" | "panels.followAllConfirmYes" | "panels.followAllConfirmNo" | "panels.enabled" | "panels.disabled" | "panels.choose" | "panels.buildModule" | "panels.failed" | "panels.dragHint" | "panels.unknownStep" | "panels.labelWithHint" | "panels.hintJoin" | "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.notActive" | "panels.market.notUsable" | "panels.market.broken" | "panels.market.hasNew" | "panels.market.hasProblem" | "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.swapSlow" | "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.needCommands" | "panels.market.localMark" | "panels.market.localHint" | "panels.market.noSource" | "panels.market.badSource" | "panels.market.empty" | "panels.market.sectionPlugins" | "panels.market.moduleOutdated" | "panels.market.moduleRefused" | "panels.market.moduleRefusedDetail" | "panels.market.moduleRestartHint" | "panels.market.pendingRestart" | "panels.market.workbenchName" | "panels.market.workbenchLocal" | "panels.market.pluginKeptInUse" | "panels.market.pluginKeptUnsure" | "panels.market.pluginKeptHeld" | "panels.market.pluginKeptUnnamed" | "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.pluginPreview" | "panels.market.add.pluginAlias" | "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.failureInstalled" | "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.restartWhy" | "panels.market.add.restartWhy.no-hmr" | "panels.market.add.restartWhy.package-moved" | "panels.market.add.restartWhy.host-module" | "panels.market.add.restartWhy.unmanaged-plugin" | "panels.market.add.restartWhy.module-comparison" | "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" | "configSync.nav" | "configSync.lead" | "configSync.source" | "configSync.sourceBroken" | "configSync.sourceRows" | "configSync.sourceDead" | "configSync.refresh" | "configSync.loading" | "configSync.readHint" | "configSync.tag.new" | "configSync.tag.differs" | "configSync.conflictNote" | "configSync.code.lang" | "configSync.code.copy" | "configSync.code.copied" | "configSync.code.wrap" | "configSync.code.unwrap" | "configSync.code.collapse" | "configSync.code.collapseAria" | "configSync.code.expandAria" | "configSync.code.expand" | "configSync.missing" | "configSync.apply" | "configSync.applyNone" | "configSync.applying" | "configSync.applied" | "configSync.appliedIds" | "configSync.skippedIds" | "configSync.nothing" | "configSync.unreadable" | "configSync.noSource" | "configSync.emptyProviders" | "configSync.failed" | "debug.status" | "debug.status.trouble" | "debug.stalled" | "debug.act.pause" | "debug.act.resume" | "debug.act.stop" | "debug.act.stop.ask" | "debug.card.here.title" | "debug.card.here.note" | "debug.card.away.title" | "debug.card.away.note" | "debug.card.paused.note" | "debug.card.hidden.note" | "debug.back" | "record.waiting" | "record.waiting.note" | "record.recording" | "record.recording.note" | "record.finished" | "record.finished.note" | "record.act.cancel" | "record.act.halt" | "approval.record.site" | "approval.record.what" | "approval.record.lands" | "approval.record.noUrl" | "approval.record.oneAction" | "approval.record.noSwitch", string>;
+    en: Record<"time.now" | "time.ago" | "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.add.busy" | "project.add.failed" | "project.search.label" | "project.search.placeholder" | "project.search.empty" | "project.group.workspaces" | "project.group.defaultWorkspace" | "project.group.workshop" | "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.list.label" | "session.copy" | "session.pinned" | "session.actions" | "status.idle" | "status.running" | "status.waitingApproval" | "status.planReview" | "status.waitingAnswer" | "status.compact.approval" | "status.compact.planReview" | "status.compact.answer" | "status.completed" | "status.subagentsRunning.one" | "status.subagentsRunning.other" | "project.attention.warning.one" | "project.attention.warning.other" | "project.attention.running.one" | "project.attention.running.other" | "project.attention.done.one" | "project.attention.done.other" | "project.attention.state.warning" | "project.attention.state.running" | "project.attention.state.done" | "hover.copied" | "time.short.minutes" | "time.short.hours" | "time.short.days" | "time.short.months" | "time.short.years" | "panels.title" | "panels.groupBoardless" | "panels.groupPlugins" | "panels.market.defaultHint" | "panels.market.defaultLabel" | "panels.market.defaultLocked" | "panels.followAll" | "panels.followAllConfirmTitle" | "panels.followAllConfirmDetail" | "panels.followAllConfirmAck" | "panels.followAllConfirmYes" | "panels.followAllConfirmNo" | "panels.enabled" | "panels.disabled" | "panels.choose" | "panels.buildModule" | "panels.failed" | "panels.dragHint" | "panels.unknownStep" | "panels.labelWithHint" | "panels.hintJoin" | "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.notActive" | "panels.market.notUsable" | "panels.market.broken" | "panels.market.hasNew" | "panels.market.hasProblem" | "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.swapSlow" | "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.needCommands" | "panels.market.localMark" | "panels.market.localHint" | "panels.market.noSource" | "panels.market.badSource" | "panels.market.empty" | "panels.market.sectionPlugins" | "panels.market.moduleOutdated" | "panels.market.moduleRefused" | "panels.market.moduleRefusedDetail" | "panels.market.moduleRestartHint" | "panels.market.pendingRestart" | "panels.market.workbenchName" | "panels.market.workbenchLocal" | "panels.market.pluginKeptInUse" | "panels.market.pluginKeptUnsure" | "panels.market.pluginKeptHeld" | "panels.market.pluginKeptUnnamed" | "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.pluginPreview" | "panels.market.add.pluginAlias" | "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.failureInstalled" | "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.restartWhy" | "panels.market.add.restartWhy.no-hmr" | "panels.market.add.restartWhy.package-moved" | "panels.market.add.restartWhy.host-module" | "panels.market.add.restartWhy.unmanaged-plugin" | "panels.market.add.restartWhy.module-comparison" | "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" | "configSync.nav" | "configSync.lead" | "configSync.source" | "configSync.sourceBroken" | "configSync.sourceRows" | "configSync.sourceDead" | "configSync.refresh" | "configSync.loading" | "configSync.readHint" | "configSync.tag.new" | "configSync.tag.differs" | "configSync.conflictNote" | "configSync.code.lang" | "configSync.code.copy" | "configSync.code.copied" | "configSync.code.wrap" | "configSync.code.unwrap" | "configSync.code.collapse" | "configSync.code.collapseAria" | "configSync.code.expandAria" | "configSync.code.expand" | "configSync.missing" | "configSync.apply" | "configSync.applyNone" | "configSync.applying" | "configSync.applied" | "configSync.appliedIds" | "configSync.skippedIds" | "configSync.nothing" | "configSync.unreadable" | "configSync.noSource" | "configSync.emptyProviders" | "configSync.failed" | "debug.workspace" | "debug.status" | "debug.status.trouble" | "debug.stalled" | "debug.act.pause" | "debug.act.resume" | "debug.act.stop" | "debug.act.stop.ask" | "debug.card.here.title" | "debug.card.here.note" | "debug.card.away.note" | "debug.card.paused.note" | "debug.card.hidden.note" | "record.waiting" | "record.waiting.note" | "record.recording" | "record.recording.note" | "record.finished" | "record.finished.note" | "record.act.cancel" | "record.act.halt" | "approval.record.site" | "approval.record.what" | "approval.record.lands" | "approval.record.noUrl" | "approval.record.oneAction" | "approval.record.noSwitch" | "approval.longTask.what" | "approval.longTask.signal", string>;
 };
+/** 中文词表的键类型（从 `zh.ts` 转出）：`en` 与模块词表都得覆盖同一批键。 */
 export type { WorkbenchMessages };
+/** 一份按语言分的词表：`zh` / `en` 必须同键，另可带模块自己那份语言。 */
 export interface Dictionaries {
     readonly zh: Readonly<Record<string, string>>;
     readonly en: Readonly<Record<string, string>>;

package/dist/i18n/index.js

@@ -1,3 +1,4 @@
 import { en } from './en.js';
 import { zh } from './zh.js';
+/** 外壳自带的两份词表（`zh` 为基准、`en` 同构）：`client.tsx` 拿它当合并各套件词表的底座。 */
 export const dictionaries = { zh, en };

package/dist/i18n/merge.d.ts

@@ -1,15 +1,20 @@
 import type { Dictionaries } from './index.js';
+/** 一个套件交上来的词表：`unit` 是套件 id（也是键前缀），`messages` 缺省表示这次不参与合并。 */
 export interface MessagesContribution {
     readonly unit: string;
     readonly messages?: Dictionaries | undefined;
 }
+/** 把各套件的词表合到外壳底座上：键必须以 `<unit>.` 开头、不许撞已有键，违规当场抛错。 */
 export declare function mergeMessages(base: Dictionaries, contributions: readonly MessagesContribution[]): Dictionaries;
+/** 一条没合进去的贡献：哪个套件 + 为什么被拒（人话原因）。 */
 export interface MessagesProblem {
     readonly unit: string;
     readonly reason: string;
 }
+/** 合并结果：合出来的词表 + 被跳过的贡献；`problems` 为空即全部合上了。 */
 export interface MessagesMerge {
     readonly dictionaries: Dictionaries;
     readonly problems: readonly MessagesProblem[];
 }
+/** 逐份试合、坏的跳过：一份贡献不合规只记进 `problems`，不影响其余套件与已有词表。 */
 export declare function mergeMessagesSkipping(base: Dictionaries, contributions: readonly MessagesContribution[]): MessagesMerge;

package/dist/i18n/merge.js

@@ -14,6 +14,7 @@ function assertSelfConsistent(unit, messages) {
         }
     }
 }
+/** 把各套件的词表合到外壳底座上：键必须以 `<unit>.` 开头、不许撞已有键，违规当场抛错。 */
 export function mergeMessages(base, contributions) {
     const zh = { ...base.zh };
     const en = { ...base.en };
@@ -43,6 +44,7 @@ function reasonOf(error) {
         return error.message;
     return typeof error === 'string' ? error : String(error);
 }
+/** 逐份试合、坏的跳过：一份贡献不合规只记进 `problems`，不影响其余套件与已有词表。 */
 export function mergeMessagesSkipping(base, contributions) {
     let dictionaries = base;
     const accepted = [];

package/dist/i18n/zh.d.ts

@@ -1,3 +1,4 @@
+/** 外壳自带的中文词表（命名空间 `workbench`）：`en` 与它逐键对齐，模块那份在它之上合并。 */
 export declare const zh: {
     readonly 'brand.name': "工作台";
     readonly 'toggle.open': "打开侧边栏";
@@ -408,20 +409,19 @@ export declare const zh: {
     readonly 'configSync.noSource': "这台机器上只有工作台这一个 profile，没有可同步的来源";
     readonly 'configSync.emptyProviders': "工作台还没有任何模型供应商 —— 去「配置同步」从某个 profile 把 llm- 那几行搬过来，或自己去「模型」里配。";
     readonly 'configSync.failed': "同步没成功，再试一次。";
-    readonly 'debug.status': "工作台 DIY 开发调试中";
-    readonly 'debug.status.trouble': "工作台 DIY 开发调试异常";
-    readonly 'debug.stalled': "工作台 DIY 调试暂停";
+    readonly 'debug.workspace': "这个工作区";
+    readonly 'debug.status': "「{title}」调试中";
+    readonly 'debug.status.trouble': "调试要你看一眼（{title}）";
+    readonly 'debug.stalled': "调试已暂停（{title}）";
     readonly 'debug.act.pause': "暂停调试";
     readonly 'debug.act.resume': "继续调试";
     readonly 'debug.act.stop': "结束调试";
     readonly 'debug.act.stop.ask': "确认结束";
-    readonly 'debug.card.here.title': "当前工作台 DIY 开发调试中";
+    readonly 'debug.card.here.title': "正在调试「{title}」";
     readonly 'debug.card.here.note': "请勿切换工作区和操作面板";
-    readonly 'debug.card.away.title': "工作台 DIY 开发调试中";
-    readonly 'debug.card.away.note': "请切换到工作台 DIY 工作区";
+    readonly 'debug.card.away.note': "请切回「{title}」那一屏";
     readonly 'debug.card.paused.note': "已暂停";
-    readonly 'debug.card.hidden.note': "请切换到工作台面板";
-    readonly 'debug.back': "回到工坊那一屏";
+    readonly 'debug.card.hidden.note': "请切回工作台面板";
     readonly 'record.waiting': "取证交接 · 等你出手";
     readonly 'record.waiting.note': "请在那一页按「开始录制」，做完按「结束录制」（录完不替你切回来）";
     readonly 'record.recording': "录制中";
@@ -436,5 +436,8 @@ export declare const zh: {
     readonly 'approval.record.noUrl': "没给站点地址（这次会被当场拒）";
     readonly 'approval.record.oneAction': "一次操作";
     readonly 'approval.record.noSwitch': "录完不会替你切回来（左栏底部会亮一条状态）";
+    readonly 'approval.longTask.what': "要停的那一趟";
+    readonly 'approval.longTask.signal': "停了只是让外壳发出中断信号 —— 平台侧那趟活儿的收尾看模块自己";
 };
+/** 中文词表的键类型：`en` 与模块词表都得覆盖同一批键。 */
 export type WorkbenchMessages = typeof zh;

package/dist/i18n/zh.js

@@ -1,3 +1,4 @@
+/** 外壳自带的中文词表（命名空间 `workbench`）：`en` 与它逐键对齐，模块那份在它之上合并。 */
 export const zh = {
     'brand.name': '工作台',
     'toggle.open': '打开侧边栏',
@@ -408,20 +409,19 @@ export const zh = {
     'configSync.noSource': '这台机器上只有工作台这一个 profile，没有可同步的来源',
     'configSync.emptyProviders': '工作台还没有任何模型供应商 —— 去「配置同步」从某个 profile 把 llm- 那几行搬过来，或自己去「模型」里配。',
     'configSync.failed': '同步没成功，再试一次。',
-    'debug.status': '工作台 DIY 开发调试中',
-    'debug.status.trouble': '工作台 DIY 开发调试异常',
-    'debug.stalled': '工作台 DIY 调试暂停',
+    'debug.workspace': '这个工作区',
+    'debug.status': '「{title}」调试中',
+    'debug.status.trouble': '调试要你看一眼（{title}）',
+    'debug.stalled': '调试已暂停（{title}）',
     'debug.act.pause': '暂停调试',
     'debug.act.resume': '继续调试',
     'debug.act.stop': '结束调试',
     'debug.act.stop.ask': '确认结束',
-    'debug.card.here.title': '当前工作台 DIY 开发调试中',
+    'debug.card.here.title': '正在调试「{title}」',
     'debug.card.here.note': '请勿切换工作区和操作面板',
-    'debug.card.away.title': '工作台 DIY 开发调试中',
-    'debug.card.away.note': '请切换到工作台 DIY 工作区',
+    'debug.card.away.note': '请切回「{title}」那一屏',
     'debug.card.paused.note': '已暂停',
-    'debug.card.hidden.note': '请切换到工作台面板',
-    'debug.back': '回到工坊那一屏',
+    'debug.card.hidden.note': '请切回工作台面板',
     'record.waiting': '取证交接 · 等你出手',
     'record.waiting.note': '请在那一页按「开始录制」，做完按「结束录制」（录完不替你切回来）',
     'record.recording': '录制中',
@@ -436,4 +436,6 @@ export const zh = {
     'approval.record.noUrl': '没给站点地址（这次会被当场拒）',
     'approval.record.oneAction': '一次操作',
     'approval.record.noSwitch': '录完不会替你切回来（左栏底部会亮一条状态）',
+    'approval.longTask.what': '要停的那一趟',
+    'approval.longTask.signal': '停了只是让外壳发出中断信号 —— 平台侧那趟活儿的收尾看模块自己',
 };

package/dist/index.d.ts

@@ -20,8 +20,11 @@ export * from './components/CardBoundary.js';
 export * from './components/CardHead.js';
 export * from './components/ChoiceGroup.js';
 export * from './components/Field.js';
+export * from './components/Form.js';
 export * from './components/FormActions.js';
+export * from './components/FormNodes.js';
 export * from './components/FormRows.js';
+export * from './components/FormTypes.js';
 export * from './components/Link.js';
 export * from './components/LongTaskRow.js';
 export * from './components/Note.js';
@@ -29,6 +32,7 @@ export * from './components/ResourceStates.js';
 export * from './components/Rows.js';
 export * from './components/SaveBar.js';
 export * from './components/SelectField.js';
+export * from './components/SelectFieldNodes.js';
 export * from './components/SettingsSection.js';
 export * from './components/Spinner.js';
 export * from './components/Stack.js';
@@ -43,11 +47,11 @@ export * from './i18n/index.js';
 export * from './i18n/merge.js';
 export * from './i18n/zh.js';
 export * from './lib/blocker-action.js';
-export * from './lib/busy.js';
-export * from './lib/form-problem.js';
 export * from './lib/board-fact.js';
+export * from './lib/busy.js';
 export * from './lib/diy-debug.js';
 export * from './lib/diy-record.js';
+export * from './lib/form-problem.js';
 export * from './lib/panel-state.js';
 export * from './lib/react.js';
 export * from './lib/text.js';

package/dist/index.js

@@ -20,8 +20,11 @@ export * from './components/CardBoundary.js';
 export * from './components/CardHead.js';
 export * from './components/ChoiceGroup.js';
 export * from './components/Field.js';
+export * from './components/Form.js';
 export * from './components/FormActions.js';
+export * from './components/FormNodes.js';
 export * from './components/FormRows.js';
+export * from './components/FormTypes.js';
 export * from './components/Link.js';
 export * from './components/LongTaskRow.js';
 export * from './components/Note.js';
@@ -29,6 +32,7 @@ export * from './components/ResourceStates.js';
 export * from './components/Rows.js';
 export * from './components/SaveBar.js';
 export * from './components/SelectField.js';
+export * from './components/SelectFieldNodes.js';
 export * from './components/SettingsSection.js';
 export * from './components/Spinner.js';
 export * from './components/Stack.js';
@@ -43,11 +47,11 @@ export * from './i18n/index.js';
 export * from './i18n/merge.js';
 export * from './i18n/zh.js';
 export * from './lib/blocker-action.js';
-export * from './lib/busy.js';
-export * from './lib/form-problem.js';
 export * from './lib/board-fact.js';
+export * from './lib/busy.js';
 export * from './lib/diy-debug.js';
 export * from './lib/diy-record.js';
+export * from './lib/form-problem.js';
 export * from './lib/panel-state.js';
 export * from './lib/react.js';
 export * from './lib/text.js';

package/dist/lib/blocker-action.d.ts

@@ -1,13 +1,35 @@
+/**
+ * 阻断态取词：i18n 的 `(key) => 文案` 那一半；那几颗钮的「重试中…」等临时说法都从它来。
+ */
 export type BlockerLabelTranslate = (key: string) => string;
+/**
+ * 阻断态上一颗钮的形状：`kind` 定行为（`retry` / `copy` 等），`label` 是它平时的文案。
+ */
 export interface BlockerActionShape {
     readonly kind: string;
     readonly label: string;
     readonly text?: string | undefined;
 }
+/**
+ * 这颗钮此刻的运行态：是否正在重试、哪一支正在跑（按 label 认）、刚复制过哪段文本。
+ */
 export interface BlockerLabelState {
     readonly retrying: boolean;
     readonly running: string | null;
     readonly copied: string | null;
 }
+/**
+ * 这颗钮此刻该不该按成等待态：这一轮忙还没收，或有一支正在跑。
+ * @param busy - 这一轮忙是不是还在。
+ * @param running - 正在跑的那一支的 label；没有就给 `null`。
+ * @returns 该等待给 `true`，否则 `false`。
+ */
 export declare function blockerPending(busy: boolean, running: string | null): boolean;
+/**
+ * 这颗钮此刻该显示什么字：正在重试说「重试中…」，正在跑的那一支说「修复中…」，刚复制过的说「已复制」，其余原样。
+ * @param action - 这颗钮的形状（行为 + 平时文案）。
+ * @param state - 此刻的运行态。
+ * @param t - i18n 取词函数。
+ * @returns 要显示的文案；三种临时态都不成立时就是 `action.label`。
+ */
 export declare function blockerActionLabel(action: BlockerActionShape, state: BlockerLabelState, t: BlockerLabelTranslate): string;

package/dist/lib/blocker-action.js

@@ -1,6 +1,19 @@
+/**
+ * 这颗钮此刻该不该按成等待态：这一轮忙还没收，或有一支正在跑。
+ * @param busy - 这一轮忙是不是还在。
+ * @param running - 正在跑的那一支的 label；没有就给 `null`。
+ * @returns 该等待给 `true`，否则 `false`。
+ */
 export function blockerPending(busy, running) {
     return busy || running !== null;
 }
+/**
+ * 这颗钮此刻该显示什么字：正在重试说「重试中…」，正在跑的那一支说「修复中…」，刚复制过的说「已复制」，其余原样。
+ * @param action - 这颗钮的形状（行为 + 平时文案）。
+ * @param state - 此刻的运行态。
+ * @param t - i18n 取词函数。
+ * @returns 要显示的文案；三种临时态都不成立时就是 `action.label`。
+ */
 export function blockerActionLabel(action, state, t) {
     if (action.kind === 'retry' && state.retrying)
         return t('blocker.retry.running');

package/dist/lib/board-fact.d.ts

@@ -1,5 +1,14 @@
+/**
+ * 椅面（右栏那块画板）此刻归属哪一类：`workshop` 本工坊、`other` 别家、`hidden` 没画出来、`unknown` 探不到。
+ */
 export type BoardFactState = 'workshop' | 'other' | 'hidden' | 'unknown';
+/**
+ * 左栏底部「调试」那条状态要说的档位：`ok` 在板上、`off-workspace` 切去了别的项目、`panel-closed` 面板没开、`other-board` 画的是别家的板、`unknown` 探不到。
+ */
 export type BoardSituation = 'ok' | 'off-workspace' | 'panel-closed' | 'other-board' | 'unknown';
+/**
+ * 一次页面探针的读数：外壳在不在、探的是哪个工作区、右栏开没开、板上挂的路径、椅面画出来没有。
+ */
 export interface BoardProbe {
     readonly workbench: boolean;
     readonly where: string;
@@ -8,6 +17,24 @@ export interface BoardProbe {
     readonly open: boolean;
     readonly drawn: boolean;
 }
+/**
+ * 判一个路径落不落在这个工作区里（按路径前缀比，不是字符串包含）。
+ * @param root - 工作区根路径。
+ * @param target - 要判的路径。
+ * @returns 同一个路径或在其下给 `true`；`root` 末尾带不带斜杠都认（`/a` 不匹配 `/ab`）。
+ */
 export declare function insideWorkshop(root: string, target: string): boolean;
+/**
+ * 把一次探针读数归成椅面归属。
+ * @param probe - 探针读数。
+ * @param workshop - 当前工作区根路径；`null` 表示还不知道当前是哪个工作区。
+ * @returns 外壳不在、或板路径与工作区缺一 → `unknown`；右栏没开或没画出来 → `hidden`；板在本工作区 → `workshop`，否则 `other`。
+ */
 export declare function boardFactOf(probe: BoardProbe, workshop: string | null): BoardFactState;
+/**
+ * 把探针读数归成左栏那句人话的档位。
+ * @param probe - 探针读数。
+ * @param workshop - 当前工作区根路径；`null` 一律 `unknown`。
+ * @returns 椅面画着 → 本板 `ok` / 别板 `other-board`；没画着 → 页面已走 `off-workspace`，否则 `panel-closed`。
+ */
 export declare function boardSituation(probe: BoardProbe, workshop: string | null): BoardSituation;

package/dist/lib/board-fact.js

@@ -1,9 +1,21 @@
+/**
+ * 判一个路径落不落在这个工作区里（按路径前缀比，不是字符串包含）。
+ * @param root - 工作区根路径。
+ * @param target - 要判的路径。
+ * @returns 同一个路径或在其下给 `true`；`root` 末尾带不带斜杠都认（`/a` 不匹配 `/ab`）。
+ */
 export function insideWorkshop(root, target) {
     if (target === root)
         return true;
     const base = root.endsWith('/') ? root : `${root}/`;
     return target.startsWith(base);
 }
+/**
+ * 把一次探针读数归成椅面归属。
+ * @param probe - 探针读数。
+ * @param workshop - 当前工作区根路径；`null` 表示还不知道当前是哪个工作区。
+ * @returns 外壳不在、或板路径与工作区缺一 → `unknown`；右栏没开或没画出来 → `hidden`；板在本工作区 → `workshop`，否则 `other`。
+ */
 export function boardFactOf(probe, workshop) {
     if (!probe.workbench)
         return 'unknown';
@@ -13,6 +25,12 @@ export function boardFactOf(probe, workshop) {
         return 'unknown';
     return insideWorkshop(workshop, probe.board) ? 'workshop' : 'other';
 }
+/**
+ * 把探针读数归成左栏那句人话的档位。
+ * @param probe - 探针读数。
+ * @param workshop - 当前工作区根路径；`null` 一律 `unknown`。
+ * @returns 椅面画着 → 本板 `ok` / 别板 `other-board`；没画着 → 页面已走 `off-workspace`，否则 `panel-closed`。
+ */
 export function boardSituation(probe, workshop) {
     if (!probe.workbench || workshop === null)
         return 'unknown';

package/dist/lib/busy.d.ts

@@ -1,5 +1,15 @@
+/**
+ * 忙态按下限收尾的判据结果：还该不该显示（`visible`），以及还要按住多少毫秒（`releaseInMs`，0 = 立刻可收）。
+ */
 export interface BusyHold {
     readonly visible: boolean;
     readonly releaseInMs: number;
 }
+/**
+ * 按「至少显示 floorMs」算这一轮忙此刻该不该收：没到下限就继续显示，并给出剩余时长供调用方起定时器。
+ * @param since - 这一轮忙开始的时间戳；`null`（没开过这一轮）一律不显示。
+ * @param now - 当前时间戳。
+ * @param floorMs - 至少显示的时长（毫秒）。
+ * @returns 还该不该显示 + 剩余毫秒；到点或已过下限给不显示，时钟倒退按「刚开头」算（剩余 = 下限，不给负数）。
+ */
 export declare function holdBusy(since: number | null, now: number, floorMs: number): BusyHold;

package/dist/lib/busy.js

@@ -1,3 +1,10 @@
+/**
+ * 按「至少显示 floorMs」算这一轮忙此刻该不该收：没到下限就继续显示，并给出剩余时长供调用方起定时器。
+ * @param since - 这一轮忙开始的时间戳；`null`（没开过这一轮）一律不显示。
+ * @param now - 当前时间戳。
+ * @param floorMs - 至少显示的时长（毫秒）。
+ * @returns 还该不该显示 + 剩余毫秒；到点或已过下限给不显示，时钟倒退按「刚开头」算（剩余 = 下限，不给负数）。
+ */
 export function holdBusy(since, now, floorMs) {
     if (since === null)
         return { visible: false, releaseInMs: 0 };

package/dist/lib/diy-debug.d.ts

@@ -1,26 +1,54 @@
+/**
+ * 调试约定的两个相位：`debugging` 正占着用户的屏，`paused` 已暂停但仍持着约定。
+ */
 export type DebugPhase = 'debugging' | 'paused';
+/**
+ * 调试约定收得下的三个人话动作：暂停 / 继续 / 结束。
+ */
 export type DebugIntent = 'pause' | 'resume' | 'stop';
+/**
+ * 把工具入参收成人话动作。
+ * @param value - 任意入参值。
+ * @returns `'pause'` / `'resume'` / `'stop'` 原样；别的值（含 `undefined`、多余空白、大小写不同）给 `null`，由调用方拒。
+ */
 export declare function parseDebugIntent(value: unknown): DebugIntent | null;
+/**
+ * 调试约定的有效期（4 小时，毫秒）：超过它没动静的约定算过期、当场让人。
+ */
 export declare const DEBUG_STALE_MS: number;
+/**
+ * 一份活着的调试约定：相位 + 谁的会话 + 哪个工作区 / 板 / 单元 + 起于何时（`at` 是最后一次动作）。
+ */
 export interface DebugState {
     readonly phase: DebugPhase;
     readonly sessionId: string;
-    readonly workspace: string;
+    readonly workspacePath: string;
+    readonly title: string;
     readonly board: string;
     readonly unit: string;
     readonly name: string;
     readonly startedAt: number;
     readonly at: number;
 }
+/**
+ * 建立约定要交的那几件：会话、工作区、板、单元、名字，以及此刻的时间戳。
+ */
 export interface DebugPact {
     readonly sessionId: string;
-    readonly workspace: string;
+    readonly workspacePath: string;
+    readonly title: string;
     readonly board: string;
     readonly unit: string;
     readonly name: string;
     readonly now: number;
 }
+/**
+ * 约定被拒的原因码：自己已持有 / 别人持着 / 不是持有者 / 没有约定 / 已暂停 / 已在调试。
+ */
 export type DebugRefusal = 'already-held' | 'held-by-other' | 'not-owner' | 'none' | 'already-paused' | 'already-debugging';
+/**
+ * 一次约定动作的结果：成功带新状态，失败带拒绝码。
+ */
 export type DebugMove = {
     readonly ok: true;
     readonly state: DebugState;
@@ -28,6 +56,9 @@ export type DebugMove = {
     readonly ok: false;
     readonly code: DebugRefusal;
 };
+/**
+ * 调试约定的存取口（外壳持有一份）：`live` 取当前有效的约定，`begin` / `pause` / `resume` / `stop` 推相位。
+ */
 export interface DebugStore {
     live(now: number): DebugState | null;
     begin(pact: DebugPact): DebugMove;
@@ -36,5 +67,14 @@ export interface DebugStore {
     stop(sessionId: string, now: number): DebugMove;
     settle?(): Promise<void>;
 }
+/**
+ * 造一份新的调试约定存储（进程内存，同一时刻只可能有一份有效约定）。
+ * @returns 存取口；动作成不成都在返回的 `DebugMove` 里，不抛异常。
+ */
 export declare function createDebugStore(): DebugStore;
+/**
+ * 「谁还占着」的一句话，用于别人来抢时说清现况。
+ * @param state - 当前有效的那份约定。
+ * @returns 形如「会话 x（自 HH:mm:ssZ 起在调试 y）」的中文串。
+ */
 export declare function debugOwnerText(state: DebugState): string;

package/dist/lib/diy-debug.js

@@ -1,6 +1,14 @@
+/**
+ * 把工具入参收成人话动作。
+ * @param value - 任意入参值。
+ * @returns `'pause'` / `'resume'` / `'stop'` 原样；别的值（含 `undefined`、多余空白、大小写不同）给 `null`，由调用方拒。
+ */
 export function parseDebugIntent(value) {
     return value === 'pause' || value === 'resume' || value === 'stop' ? value : null;
 }
+/**
+ * 调试约定的有效期（4 小时，毫秒）：超过它没动静的约定算过期、当场让人。
+ */
 export const DEBUG_STALE_MS = 4 * 60 * 60 * 1000;
 function alive(state, now) {
     if (state === null)
@@ -13,6 +21,10 @@ function ownerOf(state, sessionId, now) {
         return 'none';
     return held.sessionId === sessionId ? held : 'not-owner';
 }
+/**
+ * 造一份新的调试约定存储（进程内存，同一时刻只可能有一份有效约定）。
+ * @returns 存取口；动作成不成都在返回的 `DebugMove` 里，不抛异常。
+ */
 export function createDebugStore() {
     let held = null;
     const live = (now) => alive(held, now);
@@ -26,7 +38,8 @@ export function createDebugStore() {
             const state = {
                 phase: 'debugging',
                 sessionId: pact.sessionId,
-                workspace: pact.workspace,
+                workspacePath: pact.workspacePath,
+                title: pact.title,
                 board: pact.board,
                 unit: pact.unit,
                 name: pact.name,
@@ -65,6 +78,11 @@ export function createDebugStore() {
         },
     };
 }
+/**
+ * 「谁还占着」的一句话，用于别人来抢时说清现况。
+ * @param state - 当前有效的那份约定。
+ * @returns 形如「会话 x（自 HH:mm:ssZ 起在调试 y）」的中文串。
+ */
 export function debugOwnerText(state) {
     return `会话 ${state.sessionId}（自 ${new Date(state.startedAt).toISOString().slice(11, 19)}Z 起在调试 ${state.unit}）`;
 }