@dsh-workbench/shared 0.1.18 → 0.2.1

package/src/host/__tests__/provision.test.ts

@@ -14,6 +14,7 @@ describe('provision 请求体：每类动作各有各的目标字段', () => {
       ['update-dependency', 'id'],
       ['update-plugin', 'name'],
       ['uninstall-plugin', 'name'],
+      ['update-workbench', 'name'],
     ]);
   });
 
@@ -73,6 +74,18 @@ describe('provision 请求体：每类动作各有各的目标字段', () => {
     });
   });
 
+  it('更新工作台自己按包名认目标（界面把它自己那个包名交上来）', () => {
+    expect(parseProvisionBody({ action: 'update-workbench', name: ' @dsh-workbench/core ' })).toEqual({
+      ok: true,
+      request: { action: 'update-workbench', name: '@dsh-workbench/core' },
+    });
+    expect(parseProvisionBody({ action: 'update-workbench', unit: 'panels' })).toEqual({
+      ok: false,
+      code: 'workbench/no-name',
+      message: '缺少 name',
+    });
+  });
+
   it('拿错字段不算数（spec 动作给了 unit 也要打回）', () => {
     expect(parseProvisionBody({ action: 'install-bundle', unit: 'issues' })).toEqual({
       ok: false,

package/src/host/http.ts

@@ -1,6 +1,7 @@
 import type { DshHostContext, DshRequest, DshResponse } from '../api/dsh.js';
 import { unitFactScope } from '../api/facts.js';
-import { ACTIONS_PREFIX, API_PREFIX, PLUGIN_ID, PREFS_PREFIX, PROVISION_PREFIX } from '../config/constants.js';
+import { parseCardsReport, parseCrashReport, type PanelStateStore } from '../lib/panel-state.js';
+import { ACTIONS_PREFIX, API_PREFIX, PANEL_STATE_PREFIX, PLUGIN_ID, PREFS_PREFIX, PROVISION_PREFIX } from '../config/constants.js';
 import {
   parseProvisionBody,
   type ProvisionHandler,
@@ -298,3 +299,31 @@ export function registerActions(
     ...(wrote === undefined ? {} : { wrote }),
   });
 }
+
+export function registerPanelState(ctx: DshHostContext, store: PanelStateStore): () => void {
+  return registerPost(ctx, {
+    prefix: PANEL_STATE_PREFIX,
+    what: '面板运行态',
+    refusedCode: 'report-refused',
+    resources: [
+      {
+        resource: 'cards',
+        handle(payload) {
+          const parsed = parseCardsReport(payload);
+          if (!parsed.ok) return { ok: false, text: parsed.message };
+          store.cards(parsed.value);
+          return { ok: true, at: Date.now() };
+        },
+      },
+      {
+        resource: 'crash',
+        handle(payload) {
+          const parsed = parseCrashReport(payload);
+          if (!parsed.ok) return { ok: false, text: parsed.message };
+          store.crash(parsed.value);
+          return { ok: true, at: Date.now() };
+        },
+      },
+    ],
+  });
+}

package/src/host/provision.ts

@@ -13,6 +13,7 @@ export const PROVISION_ACTIONS = [
   'update-dependency',
   'update-plugin',
   'uninstall-plugin',
+  'update-workbench',
 ] as const satisfies readonly ProvisionAction[];
 
 export const DEPENDENCY_ACTIONS = ['update-dependency'] as const satisfies readonly ProvisionAction[];
@@ -35,6 +36,7 @@ export function provisionTargetOf(action: ProvisionAction): ProvisionTarget {
   if (action === 'install-bundle') return 'spec';
   if (action === 'remove-bundle') return 'name';
   if (action === 'update-plugin' || action === 'uninstall-plugin') return 'name';
+  if (action === 'update-workbench') return 'name';
   if (action === 'cancel-install') return 'requestId';
   return 'unit';
 }
@@ -78,6 +80,7 @@ function requestOf(action: ProvisionAction, value: string): ProvisionRequest {
   if (action === 'install-bundle') return { action, spec: value };
   if (action === 'remove-bundle') return { action, name: value };
   if (action === 'update-plugin' || action === 'uninstall-plugin') return { action, name: value };
+  if (action === 'update-workbench') return { action, name: value };
   if (action === 'cancel-install') return { action, requestId: value };
   return { action, unit: value };
 }

package/src/host/tool-approval.ts

@@ -16,6 +16,45 @@ export interface ApprovalDetail {
 
 export type ApprovalFacts = ApprovalDetail | { readonly blocked: string };
 
+export const APPROVAL_NOTE_ARG = 'approval_note';
+
+export const APPROVAL_NOTE_LIMIT = 160;
+
+const NOTE_SCHEMA: Readonly<Record<string, unknown>> = {
+  type: 'string',
+  description: '一句话说明你这次想拿它干什么（要点头的那几通会显示在审批屏上）。',
+};
+
+export function withApprovalNote(
+  parameters: Record<string, unknown>,
+  options: { readonly required?: boolean | undefined } = {},
+): Record<string, unknown> {
+  const properties = parameters['properties'];
+  if (typeof properties !== 'object' || properties === null) return parameters;
+  const map = properties as Record<string, unknown>;
+  if (APPROVAL_NOTE_ARG in map) return parameters;
+
+  const declared = Array.isArray(parameters['required']) ? parameters['required'] : [];
+  const kept = declared.filter((name) => name !== APPROVAL_NOTE_ARG);
+  const required = options.required === true ? [...kept, APPROVAL_NOTE_ARG] : kept;
+
+  return {
+    ...parameters,
+    properties: { ...map, [APPROVAL_NOTE_ARG]: NOTE_SCHEMA },
+    ...(required.length === 0 ? {} : { required }),
+  };
+}
+
+function approvalNoteOf(call: ApprovalCall): string | undefined {
+  const raw = call.arguments;
+  const value =
+    typeof raw === 'object' && raw !== null ? (raw as Record<string, unknown>)[APPROVAL_NOTE_ARG] : undefined;
+  if (typeof value !== 'string') return undefined;
+  const line = value.replace(/\s+/g, ' ').trim();
+  if (line === '') return undefined;
+  return line.length > APPROVAL_NOTE_LIMIT ? `${line.slice(0, APPROVAL_NOTE_LIMIT)}…` : line;
+}
+
 export interface ApprovalCall {
   readonly name?: string | undefined;
   readonly arguments?: unknown;
@@ -48,14 +87,17 @@ function messageOf(error: unknown): string {
 function compose(
   detail: ApprovalDetail | undefined,
   verdict: { readonly question: ApprovalDetail; readonly fallback: ApprovalDetail },
+  note: string | undefined,
 ): ApprovalDetail {
-  if (detail === undefined || typeof detail.zh !== 'string' || detail.zh.trim() === '') {
-    return verdict.fallback;
-  }
-  return {
-    en: `${detail.en} — ${verdict.question.en}`,
-    zh: `${detail.zh} —— ${verdict.question.zh}`,
-  };
+  const base =
+    detail === undefined || typeof detail.zh !== 'string' || detail.zh.trim() === ''
+      ? verdict.fallback
+      : {
+          en: `${detail.en} — ${verdict.question.en}`,
+          zh: `${detail.zh} —— ${verdict.question.zh}`,
+        };
+  if (note === undefined) return base;
+  return { en: `${base.en} — ${note}`, zh: `${base.zh} —— ${note}` };
 }
 
 export async function approvalFor(
@@ -93,5 +135,9 @@ export async function approvalFor(
   }
   if (facts !== undefined && 'blocked' in facts) return { kind: 'deny', reason: facts.blocked };
 
-  return { kind: 'ask', reason: verdict.reason, displayReason: compose(facts, verdict) };
+  return {
+    kind: 'ask',
+    reason: verdict.reason,
+    displayReason: compose(facts, verdict, approvalNoteOf(call)),
+  };
 }

package/src/host/unit-face.ts

@@ -14,6 +14,7 @@ export interface UnitMountDeps {
   readonly logger?: { info?(message: string): void; warn?(message: string): void } | undefined;
   readonly manifests: () => readonly UnitManifest[];
   readonly ownedUnits: () => readonly string[];
+  readonly installable?: (() => readonly string[]) | undefined;
   readonly opencliCommand?: string;
   readonly store: WorkspaceStore;
   readonly values?: ValueHandoff | undefined;

package/src/host.ts

@@ -6,6 +6,7 @@ export * from './api/facts.js';
 export * from './api/long-task.js';
 export * from './lib/text.js';
 export * from './lib/ui.js';
+export * from './lib/panel-state.js';
 export * from './api/blocker-table.js';
 export * from './host/cli-error.js';
 export * from './host/data-root.js';

package/src/i18n/en.ts

@@ -10,6 +10,8 @@ export const en: Record<keyof WorkbenchMessages, string> = {
   'project.none': 'No project',
   'project.empty': 'No projects yet. Use “Add project” below.',
   'project.add': 'Add project…',
+  'project.add.busy': 'Creating the workspace…',
+  'project.add.failed': 'Creating the workspace failed',
   'project.search.label': 'Search workspaces',
   'project.search.placeholder': 'Search workspaces (folder / name / path)',
   'project.search.empty': 'No workspace matches “{query}”.',
@@ -45,13 +47,22 @@ export const en: Record<keyof WorkbenchMessages, string> = {
   'time.days': '{n} d ago',
 
   'panels.title': 'Panel modules',
-  'panels.reset': 'Reset',
+  'panels.groupBoardless': 'No-board modules',
+  'panels.groupPlugins': 'opencli plugins',
+  'panels.market.defaultHint': 'When on, it is on by default in every workspace; you can also turn it off for a single workspace in Panel setup.',
+  'panels.market.defaultLabel': 'On by default everywhere',
+  'panels.market.defaultLocked': 'Unusable right now — update or uninstall it first',
+  'panels.followAll': 'Restore the default everywhere',
+  'panels.followAllConfirmTitle': 'Restore the default everywhere?',
+  'panels.followAllConfirmDetail': 'Every row changed in this workspace goes back to following the global default.',
+  'panels.followAllConfirmAck': 'I understand: to set them up for this workspace again, I will have to change them row by row.',
+  'panels.followAllConfirmYes': 'Restore',
+  'panels.followAllConfirmNo': 'Cancel',
   'panels.enabled': 'enabled in this project',
   'panels.disabled': 'not enabled in this project',
   'panels.choose': 'Choose modules',
   'panels.buildModule': 'Build a module',
   'panels.failed': 'Could not save the change. Try again.',
-  'panels.hintEffect': 'Disabling = the agent cannot reach that data',
   'panels.dragHint': 'Drag to reorder',
   'panels.unknownStep': 'No suite provides this view',
   'panels.labelWithHint': '{label} ({hint})',
@@ -65,7 +76,9 @@ export const en: Record<keyof WorkbenchMessages, string> = {
   'panels.noneInstalled': 'None of these modules has its plugin installed yet',
   'panels.noneInstalledHint': 'Once installed they come back here, and you pick which go on the panel.',
   'panels.market.installed': 'installed',
-  'panels.market.outdated': 'needs update',
+  'panels.market.notActive': 'not active',
+  'panels.market.notUsable': 'unusable',
+  'panels.market.broken': 'broken',
   'panels.market.hasNew': 'New version',
   'panels.market.missing': 'not installed',
   'panels.market.unchecked': 'unknown',
@@ -73,7 +86,7 @@ export const en: Record<keyof WorkbenchMessages, string> = {
   'panels.market.sectionInstalled': 'Installed modules',
   'panels.market.sectionPending': 'Not installed',
   'panels.market.sectionShared': 'Shared dependencies',
-  'panels.market.sharedUsedBy': 'Used by {modules}',
+  'panels.market.sharedUsedBy': 'Used by module {modules}',
   'panels.market.listSeparator': ', ',
   'panels.market.sharedMissing': 'not installed',
   'panels.market.sharedOutdated': 'update available',
@@ -97,22 +110,24 @@ export const en: Record<keyof WorkbenchMessages, string> = {
   'panels.market.confirmNo': 'Cancel',
   'panels.market.failed': 'Failed: {reason}',
   'panels.market.needEnv': 'Set {env} in the terminal that started the workbench first',
+  'panels.market.needCommands': 'Missing commands: {commands}',
+  'panels.market.localMark': 'local',
+  'panels.market.localHint': 'This is your machine’s own copy (not taken from the registry).',
   '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.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.moduleRefused': 'This module does not match this workbench, so it cannot be used for now.',
   '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.moduleRestartHint': 'restart dsh once to bring it up',
+  'panels.market.workbenchName': 'Workbench',
+  'panels.market.workbenchLocal': 'This is the copy from your working repository; it does not come from the registry.',
   'panels.market.pluginKeptInUse': 'Files kept for now: {names} still uses it.',
   'panels.market.pluginKeptUnsure': 'Files kept for now: some modules on this machine do not say what they use, so it is unclear who needs it.',
   'panels.market.pluginKeptHeld': 'Files kept: this one is yours, and a module letting go will not remove it.',
   'panels.market.pluginKeptUnnamed': 'Files kept for now: this one cannot be identified as a plugin, so it is unclear who needs it.',
-  'panels.market.pluginAlsoKnownAs': 'Its package is {pkg} (updates and uninstall use that)',
-  'panels.market.pluginBroken': 'This install is broken: it cannot be identified as a plugin. Uninstall it, or install it again by package name above.',
+  'panels.market.pluginBroken': 'This install is broken: it cannot be identified as a plugin. Uninstall it, or tell the agent to reinstall it by package name with workbench_modules (the install-bundle action).',
   'panels.market.restartNeeded': 'The new version is installed — restart once to pick it up.',
   'panels.market.foot': 'After installing, enable it in the panel page of that project.',
   'panels.market.recheck': 'Check for updates',
@@ -121,7 +136,7 @@ export const en: Record<keyof WorkbenchMessages, string> = {
   'panels.market.justNow': 'just now',
   'panels.market.minutesAgo': '{n} min ago',
   'panels.market.hoursAgo': '{n} h ago',
-  'panels.market.add.description': 'Enter a package name, a Git URL, or a path to a local directory.',
+  "panels.market.add.description": "Enter a module or opencli plugin package name, Git repository URL, or local directory path.",
   'panels.market.add.specPlaceholder': 'e.g. @dsh-workbench/module-hello',
   'panels.market.add.guideToggle': 'Install guide and examples',
   'panels.market.add.guideHide': 'Hide guide',
@@ -161,11 +176,14 @@ export const en: Record<keyof WorkbenchMessages, string> = {
   'panels.market.add.problemNotFound': 'No such module found',
   'panels.market.add.problemNotPackage': 'That path does not exist or is not a valid module package',
   'panels.market.add.problemNotBundle':
-    'This package cannot be installed here: {reason}. If it is actually an opencli plugin, use its package name (for example opencli-plugin-cmdb) or a local folder — a git URL or tarball does not reveal what it is.',
+    'This package cannot be installed here: {reason}. This entry recognises workbench modules and opencli plugins by package name, and installs either; but a git URL or a tarball does not reveal what it is — if it is really one of those two, use its package name or a local folder instead.',
   'panels.market.add.problemNotWorkbenchModule': 'This package does not match the workbench you are running, so installing it would not work. Pick another version, or ask the module author.',
   'panels.market.add.problemNotModuleOrPlugin': 'This package is neither a workbench module nor an opencli plugin, so installing it would do nothing. Pick another version, or ask the package author.',
   'panels.market.add.failureNotModuleOrPlugin': 'This package is neither a workbench module nor an opencli plugin, so installing it would do nothing',
   'panels.market.add.installedPlugin': 'Installed: the opencli plugin {name}',
+  'panels.market.add.pluginPreview':
+    'This is an opencli plugin: it goes into the opencli plugin area and works as soon as it is installed — no restart.',
+  'panels.market.add.pluginAlias': 'Plugin name: {name}',
   'panels.market.add.problemNetwork': 'Cannot reach the module source; check the network and retry',
   'panels.market.add.problemUnknown': 'Cannot fetch module information: {reason}',
   'panels.market.add.failureNetwork': 'The network connection failed',
@@ -196,7 +214,7 @@ export const en: Record<keyof WorkbenchMessages, string> = {
   'panels.market.add.registryPnpm': "pnpm's own registry",
   'panels.market.add.check': 'Check',
   'panels.market.add.checking': 'Checking…',
-  'panels.market.add.classifying': 'Working out what it is…',
+  'panels.market.add.classifying': 'Checking…',
   'panels.market.add.change': 'Edit',
   'panels.market.add.previewTitle': 'About to install',
   'panels.market.add.fieldName': 'Package',

package/src/i18n/zh.ts

@@ -8,6 +8,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}」的工作区。',
@@ -43,13 +45,22 @@ export const zh = {
   '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}）',
@@ -63,7 +74,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': '状态未知',
@@ -71,7 +84,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': '有新版',
@@ -93,22 +106,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': '重新检查更新',
@@ -117,7 +132,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': '收起引导',
@@ -157,11 +172,14 @@ export const zh = {
   'panels.market.add.problemNotFound': '未找到相关模块',
   'panels.market.add.problemNotPackage': '该路径不存在或不是有效的模块包',
   'panels.market.add.problemNotBundle':
-    '这个包装不进这里：{reason}。要是它其实是个 opencli 插件，请改用包名（例如 opencli-plugin-cmdb）或者本地目录 —— 从 git 地址和 tarball 判断不出它是什么。',
+    '这个包装不进这里：{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': '网络连接失败',
@@ -192,7 +210,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/src/index.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/src/lib/panel-state.test.ts

@@ -0,0 +1,123 @@
+import { describe, expect, it } from 'vitest';
+import {
+  PANEL_STATE_CRASH_WINDOW_MS,
+  PANEL_STATE_MAX_CARDS,
+  createPanelStateStore,
+  parseCardsReport,
+  parseCrashReport,
+} from './panel-state';
+
+function card(unit: string, route: string, phase: 'idle' | 'loading' | 'ready' | 'error', at: number) {
+  return { unit, route, phase, at };
+}
+
+describe('parseCardsReport', () => {
+  it('收下一条能认的上报', () => {
+    const parsed = parseCardsReport({
+      workspace: '/w/a',
+      cards: [{ unit: 'demo', route: 'demo/overview', phase: 'ready', at: 10 }],
+    });
+    expect(parsed.ok).toBe(true);
+    if (!parsed.ok) return;
+    expect(parsed.value.cards).toEqual([{ unit: 'demo', route: 'demo/overview', phase: 'ready', at: 10 }]);
+  });
+
+  it('不认的字段直接丢掉，认不出任何一条就拒收（不当成"面板是空的"）', () => {
+    const parsed = parseCardsReport({
+      workspace: '/w/a',
+      cards: [{ unit: 'demo', route: '', phase: 'ready', at: 1 }, { unit: 'demo', phase: 'weird' }],
+    });
+    expect(parsed.ok).toBe(false);
+  });
+
+  it('没有 workspace 就拒收（面板运行态是按工作区存的）', () => {
+    expect(parseCardsReport({ cards: [card('demo', 'demo/o', 'ready', 1)] }).ok).toBe(false);
+    expect(parseCardsReport({ workspace: '   ', cards: [] }).ok).toBe(false);
+  });
+
+  it('错误码与正文都留着，空错误对象不算错误', () => {
+    const parsed = parseCardsReport({
+      workspace: '/w/a',
+      cards: [
+        { unit: 'demo', route: 'demo/o', phase: 'error', at: 3, error: { code: 'host-500', message: '宿主炸了' } },
+        { unit: 'demo', route: 'demo/p', phase: 'ready', at: 4, error: {} },
+      ],
+    });
+    expect(parsed.ok).toBe(true);
+    if (!parsed.ok) return;
+    expect(parsed.value.cards[0]?.error).toEqual({ code: 'host-500', message: '宿主炸了' });
+    expect(parsed.value.cards[1]?.error).toBeUndefined();
+  });
+});
+
+describe('parseCrashReport', () => {
+  it('没有原因的崩溃不收（收了也查不了）', () => {
+    expect(parseCrashReport({ workspace: '/w/a', unit: 'demo', reason: ' ' }).ok).toBe(false);
+    expect(parseCrashReport({ workspace: '/w/a', reason: 'boom' }).ok).toBe(false);
+    expect(parseCrashReport({ unit: 'demo', reason: 'boom' }).ok).toBe(false);
+  });
+
+  it('没给时间就按收到的那一刻算', () => {
+    const parsed = parseCrashReport({ workspace: '/w/a', unit: 'demo', reason: 'boom' });
+    expect(parsed.ok).toBe(true);
+    if (!parsed.ok) return;
+    expect(parsed.value.at).toBeGreaterThan(0);
+  });
+});
+
+describe('createPanelStateStore', () => {
+  it('按工作区 + unit + route 记最新一条（同一 route 后报的盖掉先报的）', () => {
+    const store = createPanelStateStore();
+    store.cards({ workspace: '/w/a', cards: [card('demo', 'demo/o', 'loading', 1)] });
+    store.cards({ workspace: '/w/a', cards: [card('demo', 'demo/o', 'ready', 2)] });
+    const snapshot = store.snapshot('/w/a');
+    expect(snapshot.units).toHaveLength(1);
+    expect(snapshot.units[0]?.cards).toEqual([{ unit: 'demo', route: 'demo/o', phase: 'ready', at: 2 }]);
+    expect(snapshot.units[0]?.okAt).toBe(2);
+  });
+
+  it('别的工作区的上报不出来（面板按工作区分家）', () => {
+    const store = createPanelStateStore();
+    store.cards({ workspace: '/w/a', cards: [card('demo', 'demo/o', 'ready', 5)] });
+    expect(store.snapshot('/w/b').units).toEqual([]);
+    expect(store.snapshot(null)).toEqual({ workspace: null, at: 0, units: [] });
+  });
+
+  it('没读到过数据时 okAt 是 null（"读到过"不能靠 unit 有上报就算）', () => {
+    const store = createPanelStateStore();
+    store.cards({ workspace: '/w/a', cards: [card('demo', 'demo/o', 'error', 7)] });
+    expect(store.snapshot('/w/a').units[0]?.okAt).toBeNull();
+  });
+
+  it('同一个 unit 反复崩只留最新一条 + 次数（不刷屏）', () => {
+    const store = createPanelStateStore();
+    store.crash({ workspace: '/w/a', unit: 'demo', reason: 'boom', at: 100 });
+    store.crash({ workspace: '/w/a', unit: 'demo', reason: 'boom', at: 200 });
+    const crash = store.snapshot('/w/a').units[0]?.crash;
+    expect(crash).toEqual({ unit: 'demo', reason: 'boom', at: 200, count: 2 });
+  });
+
+  it('换了原因、或隔太久，就重新数', () => {
+    const store = createPanelStateStore();
+    store.crash({ workspace: '/w/a', unit: 'demo', reason: 'boom', at: 100 });
+    store.crash({ workspace: '/w/a', unit: 'demo', reason: 'other', at: 200 });
+    expect(store.snapshot('/w/a').units[0]?.crash?.count).toBe(1);
+    store.crash({ workspace: '/w/a', unit: 'demo', reason: 'other', at: 200 + PANEL_STATE_CRASH_WINDOW_MS + 1 });
+    expect(store.snapshot('/w/a').units[0]?.crash?.count).toBe(1);
+  });
+
+  it('一个 unit 的卡最多留这么多条（长命的页面不会把它撑成日志）', () => {
+    const store = createPanelStateStore();
+    for (let index = 0; index < PANEL_STATE_MAX_CARDS + 4; index += 1) {
+      store.cards({ workspace: '/w/a', cards: [card('demo', `demo/r${String(index)}`, 'ready', index + 1)] });
+    }
+    expect(store.snapshot('/w/a').units[0]?.cards.length).toBe(PANEL_STATE_MAX_CARDS);
+  });
+
+  it('两份 store 各记各的（工厂不是单例）', () => {
+    const one = createPanelStateStore();
+    const two = createPanelStateStore();
+    one.cards({ workspace: '/w/a', cards: [card('demo', 'demo/o', 'ready', 1)] });
+    expect(two.snapshot('/w/a').units).toEqual([]);
+  });
+});