@dsh-workbench/shared 0.1.18 → 0.2.1

package/dist/i18n/zh.d.ts

@@ -7,6 +7,8 @@ export declare const zh: {
     readonly 'project.none': "未选择项目";
     readonly 'project.empty': "还没有项目。用下面的「添加项目」选一个目录。";
     readonly 'project.add': "添加项目…";
+    readonly 'project.add.busy': "正在新建工作区…";
+    readonly 'project.add.failed': "新建工作区没成功";
     readonly 'project.search.label': "搜索工作区";
     readonly 'project.search.placeholder': "搜索工作区（目录名 / 中文名 / 路径）";
     readonly 'project.search.empty': "没有匹配「{query}」的工作区。";
@@ -40,13 +42,22 @@ export declare const zh: {
     readonly 'time.hours': "{n} 小时前";
     readonly 'time.days': "{n} 天前";
     readonly 'panels.title': "面板模块";
-    readonly 'panels.reset': "恢复默认";
+    readonly 'panels.groupBoardless': "无看板模块";
+    readonly 'panels.groupPlugins': "opencli 插件";
+    readonly 'panels.market.defaultHint': "打开后所有工作区默认开启，也可在工作区面板配置中单独关闭";
+    readonly 'panels.market.defaultLabel': "全局默认开启";
+    readonly 'panels.market.defaultLocked': "这份现在用不了，先更新或卸载";
+    readonly 'panels.followAll': "全部恢复默认";
+    readonly 'panels.followAllConfirmTitle': "全部恢复默认？";
+    readonly 'panels.followAllConfirmDetail': "这个工作区里改过的每一行都会清掉，之后都跟随全局。";
+    readonly 'panels.followAllConfirmAck': "我明白：清掉之后，想再按这个工作区配，得一行一行重新改。";
+    readonly 'panels.followAllConfirmYes': "恢复默认";
+    readonly 'panels.followAllConfirmNo': "取消";
     readonly 'panels.enabled': "这个项目已启用";
     readonly 'panels.disabled': "这个项目未启用";
     readonly 'panels.choose': "选择模块";
     readonly 'panels.buildModule': "造一个模块";
     readonly 'panels.failed': "改配置失败了，再试一次。";
-    readonly 'panels.hintEffect': "停用 = agent 拿不到相关数据";
     readonly 'panels.dragHint': "拖动调整顺序";
     readonly 'panels.unknownStep': "这一层没有套件提供";
     readonly 'panels.labelWithHint': "{label}（{hint}）";
@@ -60,7 +71,9 @@ export declare const zh: {
     readonly 'panels.noneInstalled': "这些模块要的插件都还没装";
     readonly 'panels.noneInstalledHint': "装好之后它们会回到这里，再由你决定放哪几个上板。";
     readonly 'panels.market.installed': "已安装";
-    readonly 'panels.market.outdated': "要更新";
+    readonly 'panels.market.notActive': "未生效";
+    readonly 'panels.market.notUsable': "不可用";
+    readonly 'panels.market.broken': "装坏了";
     readonly 'panels.market.hasNew': "有新版本";
     readonly 'panels.market.missing': "未装";
     readonly 'panels.market.unchecked': "状态未知";
@@ -68,7 +81,7 @@ export declare const zh: {
     readonly 'panels.market.sectionInstalled': "已安装模块";
     readonly 'panels.market.sectionPending': "未安装";
     readonly 'panels.market.sectionShared': "共用依赖";
-    readonly 'panels.market.sharedUsedBy': "供 {modules} 使用";
+    readonly 'panels.market.sharedUsedBy': "供 {modules} 模块使用";
     readonly 'panels.market.listSeparator': "、";
     readonly 'panels.market.sharedMissing': "未装";
     readonly 'panels.market.sharedOutdated': "有新版";
@@ -90,22 +103,24 @@ export declare const zh: {
     readonly 'panels.market.confirmNo': "取消";
     readonly 'panels.market.failed': "没成功：{reason}";
     readonly 'panels.market.needEnv': "先在启动工作台的终端里设 {env}";
+    readonly 'panels.market.needCommands': "缺这几条命令：{commands}";
+    readonly 'panels.market.localMark': "本地";
+    readonly 'panels.market.localHint': "本机那份（不从源上取）。";
     readonly 'panels.market.noSource': "这个模块没声明怎么装，只能自己动手";
     readonly 'panels.market.badSource': "安装方式没写全，只能自己动手";
     readonly 'panels.market.empty': "暂无可用模块";
-    readonly 'panels.market.sectionLocal': "本地模块";
-    readonly 'panels.market.sectionUnlisted': "不是从市场装的";
     readonly 'panels.market.sectionPlugins': "已安装 opencli 插件";
     readonly 'panels.market.moduleOutdated': "有新版";
-    readonly 'panels.market.moduleRefused': "这个模块是给旧版本的工作台写的，现在用不了。更新它，或者卸载。";
+    readonly 'panels.market.moduleRefused': "模块版本与工作台不匹配，暂时无法使用";
     readonly 'panels.market.moduleRefusedDetail': "装不上的原因：{reason}";
-    readonly 'panels.market.moduleRestartHint': "装好了但还没生效 —— 重启一次 dsh 就会出来";
+    readonly 'panels.market.moduleRestartHint': "重启后生效";
+    readonly 'panels.market.workbenchName': "工作台";
+    readonly 'panels.market.workbenchLocal': "这份是本仓正在开发的那一份，不从源上取。";
     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.pluginBroken': "这份装坏了：看不出它是个插件。可以卸载，或者直接跟 agent 说：用 workbench_modules 的 install-bundle 按包名再装一次。";
     readonly 'panels.market.restartNeeded': "新版装好了，重启一次才生效。";
     readonly 'panels.market.foot': "装好后到那个项目的面板页勾选它，模块才会出现。";
     readonly 'panels.market.recheck': "重新检查更新";
@@ -114,7 +129,7 @@ export declare const zh: {
     readonly 'panels.market.justNow': "刚刚";
     readonly 'panels.market.minutesAgo': "{n} 分钟前";
     readonly 'panels.market.hoursAgo': "{n} 小时前";
-    readonly 'panels.market.add.description': "输入模块的包名、Git 仓库地址或本地目录路径。";
+    readonly 'panels.market.add.description': "输入模块或 opencli 插件的包名、Git 仓库地址或本地目录路径。";
     readonly 'panels.market.add.specPlaceholder': "例如 @dsh-workbench/module-hello";
     readonly 'panels.market.add.guideToggle': "模块安装引导和示例";
     readonly 'panels.market.add.guideHide': "收起引导";
@@ -153,11 +168,13 @@ 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}。要是它其实是个 opencli 插件，请改用包名（例如 opencli-plugin-cmdb）或者本地目录 —— 从 git 地址和 tarball 判断不出它是什么。";
+    readonly 'panels.market.add.problemNotBundle': "这个包装不进这里：{reason}。这个入口按包名认工作台模块和 opencli 插件，两种都能装；但 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.pluginPreview': "这是一份 opencli 插件：装进 opencli 的插件区，装完就能用，不用重启。";
+    readonly 'panels.market.add.pluginAlias': "插件名：{name}";
     readonly 'panels.market.add.problemNetwork': "无法连接模块源，请检查网络后重试";
     readonly 'panels.market.add.problemUnknown': "无法获取模块信息：{reason}";
     readonly 'panels.market.add.failureNetwork': "网络连接失败";
@@ -188,7 +205,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.classifying': "检测中…";
     readonly 'panels.market.add.change': "改一下";
     readonly 'panels.market.add.previewTitle': "将要安装";
     readonly 'panels.market.add.fieldName': "包名";

package/dist/i18n/zh.js

@@ -7,6 +7,8 @@ export const zh = {
     'project.none': '未选择项目',
     'project.empty': '还没有项目。用下面的「添加项目」选一个目录。',
     'project.add': '添加项目…',
+    'project.add.busy': '正在新建工作区…',
+    'project.add.failed': '新建工作区没成功',
     'project.search.label': '搜索工作区',
     'project.search.placeholder': '搜索工作区（目录名 / 中文名 / 路径）',
     'project.search.empty': '没有匹配「{query}」的工作区。',
@@ -40,13 +42,22 @@ export const zh = {
     'time.hours': '{n} 小时前',
     'time.days': '{n} 天前',
     'panels.title': '面板模块',
-    'panels.reset': '恢复默认',
+    'panels.groupBoardless': '无看板模块',
+    'panels.groupPlugins': 'opencli 插件',
+    '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.hintEffect': '停用 = agent 拿不到相关数据',
     'panels.dragHint': '拖动调整顺序',
     'panels.unknownStep': '这一层没有套件提供',
     'panels.labelWithHint': '{label}（{hint}）',
@@ -60,7 +71,9 @@ export const zh = {
     'panels.noneInstalled': '这些模块要的插件都还没装',
     'panels.noneInstalledHint': '装好之后它们会回到这里，再由你决定放哪几个上板。',
     'panels.market.installed': '已安装',
-    'panels.market.outdated': '要更新',
+    'panels.market.notActive': '未生效',
+    'panels.market.notUsable': '不可用',
+    'panels.market.broken': '装坏了',
     'panels.market.hasNew': '有新版本',
     'panels.market.missing': '未装',
     'panels.market.unchecked': '状态未知',
@@ -68,7 +81,7 @@ export const zh = {
     'panels.market.sectionInstalled': '已安装模块',
     'panels.market.sectionPending': '未安装',
     'panels.market.sectionShared': '共用依赖',
-    'panels.market.sharedUsedBy': '供 {modules} 使用',
+    'panels.market.sharedUsedBy': '供 {modules} 模块使用',
     'panels.market.listSeparator': '、',
     'panels.market.sharedMissing': '未装',
     'panels.market.sharedOutdated': '有新版',
@@ -90,22 +103,24 @@ export const zh = {
     'panels.market.confirmNo': '取消',
     'panels.market.failed': '没成功：{reason}',
     'panels.market.needEnv': '先在启动工作台的终端里设 {env}',
+    'panels.market.needCommands': '缺这几条命令：{commands}',
+    'panels.market.localMark': '本地',
+    'panels.market.localHint': '本机那份（不从源上取）。',
     'panels.market.noSource': '这个模块没声明怎么装，只能自己动手',
     'panels.market.badSource': '安装方式没写全，只能自己动手',
     'panels.market.empty': '暂无可用模块',
-    'panels.market.sectionLocal': '本地模块',
-    'panels.market.sectionUnlisted': '不是从市场装的',
     'panels.market.sectionPlugins': '已安装 opencli 插件',
     'panels.market.moduleOutdated': '有新版',
-    'panels.market.moduleRefused': '这个模块是给旧版本的工作台写的，现在用不了。更新它，或者卸载。',
+    'panels.market.moduleRefused': '模块版本与工作台不匹配，暂时无法使用',
     'panels.market.moduleRefusedDetail': '装不上的原因：{reason}',
-    'panels.market.moduleRestartHint': '装好了但还没生效 —— 重启一次 dsh 就会出来',
+    'panels.market.moduleRestartHint': '重启后生效',
+    'panels.market.workbenchName': '工作台',
+    'panels.market.workbenchLocal': '这份是本仓正在开发的那一份，不从源上取。',
     'panels.market.pluginKeptInUse': '文件先留着：{names} 还要用它。',
     'panels.market.pluginKeptUnsure': '文件先留着：这台机器上还有模块看不出用了什么，说不准谁在用它。',
     'panels.market.pluginKeptHeld': '文件留着：你自己装的那一份，模块放手不动它。',
     'panels.market.pluginKeptUnnamed': '文件先留着：看不出这是哪个插件，说不准谁在用它。',
-    'panels.market.pluginAlsoKnownAs': '包名是 {pkg}（更新与卸载按它来）',
-    'panels.market.pluginBroken': '这份装坏了：看不出它是个插件。可以卸载，或者去上面按包名再装一次。',
+    'panels.market.pluginBroken': '这份装坏了：看不出它是个插件。可以卸载，或者直接跟 agent 说：用 workbench_modules 的 install-bundle 按包名再装一次。',
     'panels.market.restartNeeded': '新版装好了，重启一次才生效。',
     'panels.market.foot': '装好后到那个项目的面板页勾选它，模块才会出现。',
     'panels.market.recheck': '重新检查更新',
@@ -114,7 +129,7 @@ export const zh = {
     'panels.market.justNow': '刚刚',
     'panels.market.minutesAgo': '{n} 分钟前',
     'panels.market.hoursAgo': '{n} 小时前',
-    'panels.market.add.description': '输入模块的包名、Git 仓库地址或本地目录路径。',
+    'panels.market.add.description': '输入模块或 opencli 插件的包名、Git 仓库地址或本地目录路径。',
     'panels.market.add.specPlaceholder': '例如 @dsh-workbench/module-hello',
     'panels.market.add.guideToggle': '模块安装引导和示例',
     'panels.market.add.guideHide': '收起引导',
@@ -153,11 +168,13 @@ export const zh = {
     'panels.market.add.problemInstalled': '该模块已安装',
     'panels.market.add.problemNotFound': '未找到相关模块',
     'panels.market.add.problemNotPackage': '该路径不存在或不是有效的模块包',
-    'panels.market.add.problemNotBundle': '这个包装不进这里：{reason}。要是它其实是个 opencli 插件，请改用包名（例如 opencli-plugin-cmdb）或者本地目录 —— 从 git 地址和 tarball 判断不出它是什么。',
+    'panels.market.add.problemNotBundle': '这个包装不进这里：{reason}。这个入口按包名认工作台模块和 opencli 插件，两种都能装；但 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.pluginPreview': '这是一份 opencli 插件：装进 opencli 的插件区，装完就能用，不用重启。',
+    'panels.market.add.pluginAlias': '插件名：{name}',
     'panels.market.add.problemNetwork': '无法连接模块源，请检查网络后重试',
     'panels.market.add.problemUnknown': '无法获取模块信息：{reason}',
     'panels.market.add.failureNetwork': '网络连接失败',
@@ -188,7 +205,7 @@ export const zh = {
     'panels.market.add.registryPnpm': 'pnpm 自己配的源',
     'panels.market.add.check': '预检',
     'panels.market.add.checking': '正在预检…',
-    'panels.market.add.classifying': '判定中…',
+    'panels.market.add.classifying': '检测中…',
     'panels.market.add.change': '改一下',
     'panels.market.add.previewTitle': '将要安装',
     'panels.market.add.fieldName': '包名',

package/dist/index.d.ts

@@ -40,6 +40,7 @@ export * from './i18n/merge.js';
 export * from './i18n/zh.js';
 export * from './lib/blocker-action.js';
 export * from './lib/busy.js';
+export * from './lib/panel-state.js';
 export * from './lib/react.js';
 export * from './lib/text.js';
 export * from './lib/ui.js';

package/dist/index.js

@@ -40,6 +40,7 @@ export * from './i18n/merge.js';
 export * from './i18n/zh.js';
 export * from './lib/blocker-action.js';
 export * from './lib/busy.js';
+export * from './lib/panel-state.js';
 export * from './lib/react.js';
 export * from './lib/text.js';
 export * from './lib/ui.js';

package/dist/lib/panel-state.d.ts

@@ -0,0 +1,60 @@
+export type PanelCardPhase = 'idle' | 'loading' | 'ready' | 'error';
+export interface PanelCardError {
+    readonly code: string;
+    readonly message: string;
+}
+export interface PanelCardRead {
+    readonly unit: string;
+    readonly route: string;
+    readonly phase: PanelCardPhase;
+    readonly at: number;
+    readonly error?: PanelCardError;
+}
+export interface PanelCardCrash {
+    readonly unit: string;
+    readonly reason: string;
+    readonly at: number;
+    readonly count: number;
+}
+export interface PanelUnitReport {
+    readonly unit: string;
+    readonly at: number;
+    readonly okAt: number | null;
+    readonly cards: readonly PanelCardRead[];
+    readonly crash?: PanelCardCrash;
+}
+export interface PanelWorkspaceReport {
+    readonly workspace: string | null;
+    readonly at: number;
+    readonly units: readonly PanelUnitReport[];
+}
+export interface PanelCardsReport {
+    readonly workspace: string;
+    readonly cards: readonly PanelCardRead[];
+}
+export interface PanelCrashReport {
+    readonly workspace: string;
+    readonly unit: string;
+    readonly reason: string;
+    readonly at: number;
+}
+export interface PanelStateStore {
+    cards(report: PanelCardsReport): void;
+    crash(report: PanelCrashReport): void;
+    snapshot(workspace: string | null): PanelWorkspaceReport;
+}
+export declare const PANEL_STATE_MAX_UNITS = 64;
+export declare const PANEL_STATE_MAX_CARDS = 12;
+export declare const PANEL_STATE_MAX_REPORTS = 32;
+export declare const PANEL_STATE_CRASH_WINDOW_MS = 600000;
+export declare const PANEL_STATE_MAX_TEXT = 2000;
+export type PanelParse<T> = {
+    readonly ok: true;
+    readonly value: T;
+} | {
+    readonly ok: false;
+    readonly message: string;
+};
+export declare function parseCardsReport(payload: unknown): PanelParse<PanelCardsReport>;
+export declare function parseCrashReport(payload: unknown): PanelParse<PanelCrashReport>;
+export declare function createPanelStateStore(): PanelStateStore;

package/dist/lib/panel-state.js

@@ -0,0 +1,146 @@
+export const PANEL_STATE_MAX_UNITS = 64;
+export const PANEL_STATE_MAX_CARDS = 12;
+export const PANEL_STATE_MAX_REPORTS = 32;
+export const PANEL_STATE_CRASH_WINDOW_MS = 600000;
+export const PANEL_STATE_MAX_TEXT = 2000;
+const PHASES = ['idle', 'loading', 'ready', 'error'];
+function asRecord(value) {
+    return typeof value === 'object' && value !== null ? value : undefined;
+}
+function textOf(value, max) {
+    if (typeof value !== 'string')
+        return '';
+    const trimmed = value.trim();
+    return trimmed.length > max ? trimmed.slice(0, max) : trimmed;
+}
+function atOf(value) {
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        return null;
+    if (value < 0)
+        return null;
+    return Math.trunc(value);
+}
+function errorOf(raw) {
+    const record = asRecord(raw);
+    if (record === undefined)
+        return undefined;
+    const code = textOf(record['code'], 120);
+    const message = textOf(record['message'], PANEL_STATE_MAX_TEXT);
+    if (code === '' && message === '')
+        return undefined;
+    return { code: code === '' ? 'unknown' : code, message };
+}
+export function parseCardsReport(payload) {
+    const record = asRecord(payload);
+    if (record === undefined)
+        return { ok: false, message: '请求体要是一个对象' };
+    const workspace = textOf(record['workspace'], PANEL_STATE_MAX_TEXT);
+    if (workspace === '')
+        return { ok: false, message: 'workspace 不能是空的 —— 面板按工作区存' };
+    const raw = record['cards'];
+    if (!Array.isArray(raw))
+        return { ok: false, message: 'cards 要是一个数组' };
+    const cards = [];
+    for (const item of raw.slice(0, PANEL_STATE_MAX_REPORTS)) {
+        const card = asRecord(item);
+        if (card === undefined)
+            continue;
+        const unit = textOf(card['unit'], 200);
+        const route = textOf(card['route'], 400);
+        const phase = textOf(card['phase'], 20);
+        const at = atOf(card['at']);
+        if (unit === '' || route === '' || at === null || !PHASES.includes(phase))
+            continue;
+        const error = errorOf(card['error']);
+        cards.push({ unit, route, phase, at, ...(error === undefined ? {} : { error }) });
+    }
+    if (cards.length === 0)
+        return { ok: false, message: 'cards 里没有一条能认的（unit / route / phase / at 都要有）' };
+    return { ok: true, value: { workspace, cards } };
+}
+export function parseCrashReport(payload) {
+    const record = asRecord(payload);
+    if (record === undefined)
+        return { ok: false, message: '请求体要是一个对象' };
+    const workspace = textOf(record['workspace'], PANEL_STATE_MAX_TEXT);
+    const unit = textOf(record['unit'], 200);
+    const reason = textOf(record['reason'], PANEL_STATE_MAX_TEXT);
+    if (workspace === '')
+        return { ok: false, message: 'workspace 不能是空的' };
+    if (unit === '')
+        return { ok: false, message: 'unit 不能是空的' };
+    if (reason === '')
+        return { ok: false, message: 'reason 不能是空的（没有原因的崩溃没法查）' };
+    return { ok: true, value: { workspace, unit, reason, at: atOf(record['at']) ?? Date.now() } };
+}
+export function createPanelStateStore() {
+    const workspaces = new Map();
+    function trim(entry, max) {
+        while (entry.size > max) {
+            const oldest = entry.keys().next();
+            if (oldest.done === true)
+                return;
+            entry.delete(oldest.value);
+        }
+    }
+    function workspaceEntryOf(workspace) {
+        const existing = workspaces.get(workspace);
+        if (existing !== undefined)
+            return existing;
+        const created = { at: 0, units: new Map() };
+        workspaces.set(workspace, created);
+        trim(workspaces, PANEL_STATE_MAX_UNITS);
+        return created;
+    }
+    function unitEntryOf(entry, unit) {
+        const existing = entry.units.get(unit);
+        if (existing !== undefined)
+            return existing;
+        const created = { at: 0, cards: new Map() };
+        entry.units.set(unit, created);
+        return created;
+    }
+    return {
+        cards(report) {
+            const entry = workspaceEntryOf(report.workspace);
+            for (const card of report.cards) {
+                const unit = unitEntryOf(entry, card.unit);
+                unit.cards.delete(card.route);
+                unit.cards.set(card.route, card);
+                trim(unit.cards, PANEL_STATE_MAX_CARDS);
+                if (card.at > unit.at)
+                    unit.at = card.at;
+                if (card.at > entry.at)
+                    entry.at = card.at;
+            }
+        },
+        crash(report) {
+            const entry = workspaceEntryOf(report.workspace);
+            const unit = unitEntryOf(entry, report.unit);
+            const previous = unit.crash;
+            const counted = previous !== undefined &&
+                previous.reason === report.reason &&
+                report.at >= previous.at &&
+                report.at - previous.at <= PANEL_STATE_CRASH_WINDOW_MS;
+            unit.crash = { unit: report.unit, reason: report.reason, at: report.at, count: counted ? previous.count + 1 : 1 };
+            if (report.at > unit.at)
+                unit.at = report.at;
+            if (report.at > entry.at)
+                entry.at = report.at;
+        },
+        snapshot(workspace) {
+            if (workspace === null)
+                return { workspace: null, at: 0, units: [] };
+            const entry = workspaces.get(workspace);
+            if (entry === undefined)
+                return { workspace, at: 0, units: [] };
+            const units = [...entry.units.entries()].map(([unit, one]) => {
+                const cards = [...one.cards.values()].sort((a, b) => a.route.localeCompare(b.route));
+                const okAt = cards.reduce((best, card) => (card.phase === 'ready' && (best === null || card.at > best) ? card.at : best), null);
+                return { unit, at: one.at, okAt, cards, ...(one.crash === undefined ? {} : { crash: one.crash }) };
+            });
+            units.sort((a, b) => b.at - a.at || a.unit.localeCompare(b.unit));
+            return { workspace, at: entry.at, units };
+        },
+    };
+}

package/package.json

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

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

@@ -0,0 +1,38 @@
+import { describe, expect, it } from 'vitest';
+import { hasEnvSupply, type UnitManifest } from '../unit.js';
+
+function manifest(env?: UnitManifest['env']): UnitManifest {
+  return {
+    id: 'issues',
+    card: { titleKey: 'issues.mine', order: 10 },
+    tools: [],
+    host: { inject: [] },
+    ...(env === undefined ? {} : { env }),
+  };
+}
+
+describe('hasEnvSupply（缺来源时那条回退口径，宿主与浏览器共用一份）', () => {
+  it('声明了插件或库 → 有供给', () => {
+    expect(hasEnvSupply(manifest({ plugins: [{ name: 'coding', commands: ['x'] }] }))).toBe(true);
+    expect(
+      hasEnvSupply(
+        manifest({
+          libs: [
+            {
+              name: 'opencli-workflow',
+              registryEnv: 'WB_NPM',
+              registryDefault: 'https://registry.example/',
+              purpose: '夹具',
+            },
+          ],
+        }),
+      ),
+    ).toBe(true);
+  });
+
+  it('★ 只有基座命令（无卡片模块那种）不算供给 —— 它不是市场门槛，只是缺来源时的回退', () => {
+    expect(hasEnvSupply(manifest({ command: 'gitops' }))).toBe(false);
+    expect(hasEnvSupply(manifest({ plugins: [], libs: [] }))).toBe(false);
+    expect(hasEnvSupply(manifest())).toBe(false);
+  });
+});

package/src/api/unit.ts

@@ -55,3 +55,7 @@ export interface UnitManifest {
   readonly host: UnitHostNeeds;
   readonly env?: UnitEnvNeeds;
 }
+
+export function hasEnvSupply(manifest: UnitManifest): boolean {
+  return (manifest.env?.plugins ?? []).length > 0 || (manifest.env?.libs ?? []).length > 0;
+}

package/src/api/workbench-contract.ts

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

package/src/components/CardBoundary.tsx

@@ -8,6 +8,7 @@ export interface CardBoundaryProps {
   readonly unit: string;
   readonly resetKey: string;
   readonly t: Translate;
+  readonly onFailure?: ((reason: string) => void) | undefined;
   readonly children?: ReactNode | undefined;
 }
 
@@ -28,7 +29,9 @@ export class CardBoundary extends Component<CardBoundaryProps, CardBoundaryState
   }
 
   override componentDidCatch(error: unknown): void {
-    console.error(`[dsh-workbench] 模块 ${this.props.unit} 渲染失败：${errorReasonOf(error)}`, error);
+    const reason = errorReasonOf(error);
+    console.error(`[dsh-workbench] 模块 ${this.props.unit} 渲染失败：${reason}`, error);
+    this.props.onFailure?.(reason);
   }
 
   override componentDidUpdate(previous: CardBoundaryProps): void {

package/src/components/board-module.ts

@@ -50,7 +50,7 @@ export interface BoardModule {
 
 export interface UnitClientFace {
   readonly unit: string;
-  readonly card: (props: BoardModuleProps) => ReactNode;
+  readonly card?: (props: BoardModuleProps) => ReactNode;
   readonly steps?: Readonly<Record<string, UnitStep>>;
   readonly messages?: Dictionaries;
   readonly approval?:

package/src/components/icons.tsx

@@ -56,6 +56,44 @@ export function IconBrandMark({ size = 24 }: IconProps) {
   );
 }
 
+export function IconOpencli({ size = 16 }: IconProps) {
+  return (
+    <Shell size={size} viewBox="0 0 64 64">
+      <defs>
+        <linearGradient id="opencli-mark" x1="0%" y1="0%" x2="100%" y2="100%">
+          <stop offset="0%" stopColor="#00e5a0" />
+          <stop offset="50%" stopColor="#00b4d8" />
+          <stop offset="100%" stopColor="#7b61ff" />
+        </linearGradient>
+      </defs>
+      <rect width={64} height={64} rx={14} fill="#0a0a0f" />
+      <text
+        x="50%"
+        y="54%"
+        dominantBaseline="middle"
+        textAnchor="middle"
+        fontFamily="monospace"
+        fontWeight={700}
+        fontSize={28}
+        fill="url(#opencli-mark)"
+      >
+        &gt;_
+      </text>
+    </Shell>
+  );
+}
+
+export function IconNpm({ size = 16 }: IconProps) {
+  return (
+    <Shell size={size} viewBox="0 0 1024 1024">
+      <path
+        d="M64 337.76h896v298.72H512v49.792H312.896v-49.824H64z m49.792 248.928h99.552v-149.376h49.76v149.344h49.792v-199.104H113.792z m248.896-199.136v248.928h99.552v-49.792h99.552v-199.136z m99.552 49.792H512v99.584h-49.792z m149.344-49.792v199.136h99.552v-149.376h49.792v149.344h49.792v-149.344h49.792v149.344h49.792v-199.104z"
+        fill="#CB3837"
+      />
+    </Shell>
+  );
+}
+
 export function IconModules({ size = 16 }: IconProps) {
   return (
     <svg width={size} height={size} viewBox="0 0 16 16" fill="none" aria-hidden="true">

package/src/config/constants.ts

@@ -9,6 +9,10 @@ export const ACTIONS_PREFIX = `${API_PREFIX}/actions`;
 
 export const PROVISION_PREFIX = `${API_PREFIX}/provision`;
 
+export const PANEL_STATE_PATH = "panel-state";
+
+export const PANEL_STATE_PREFIX = `${API_PREFIX}/${PANEL_STATE_PATH}`;
+
 export const OPENCLI_PIN = "1.8.8";
 
 export const CODING_ISSUES_SERVICE = "workbenchCodingIssues";
@@ -17,6 +21,8 @@ export const PANELS_SERVICE = "workbenchPanels";
 
 export const UNITS_SERVICE = "workbenchUnits";
 
+export const PANEL_STATE_SERVICE = "workbenchPanelState";
+
 export const PANEL_LIST_LIMIT = 50;
 
 export const OPENCLI_TIMEOUT_MS = 120_000;