@dsh-workbench/shared 0.2.0 → 0.2.2

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,18 +45,22 @@ export const zh = {
   'time.days': '{n} 天前',
 
   'panels.title': '面板模块',
-  'panels.market.defaultNote': '这份默认给所有没在这一行改过的工作区；改过的保持自己的选择。',
-  'panels.market.changedBy': '{count} 个工作区已在这一行改过',
-  'panels.market.defaultLabel': '开启后所有工作区默认启用',
-  'panels.followGlobal': '默认',
-  'panels.followGlobalHint': '这一行跟着默认板走（右边那颗开关显示的就是默认的状态）。点一下开关 = 改成这个项目自己定。',
+  '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}）',
@@ -67,9 +73,10 @@ export const zh = {
   'panels.browseMarket': '浏览模块市场',
   'panels.noneInstalled': '这些模块要的插件都还没装',
   'panels.noneInstalledHint': '装好之后它们会回到这里，再由你决定放哪几个上板。',
-  'panels.rowPlugin': '插件',
   'panels.market.installed': '已安装',
-  'panels.market.outdated': '要更新',
+  'panels.market.notActive': '未生效',
+  'panels.market.notUsable': '不可用',
+  'panels.market.broken': '装坏了',
   'panels.market.hasNew': '有新版本',
   'panels.market.missing': '未装',
   'panels.market.unchecked': '状态未知',
@@ -99,16 +106,17 @@ 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} 还要用它。',
@@ -202,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([]);
+  });
+});

package/src/lib/panel-state.ts

@@ -0,0 +1,209 @@
+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 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: readonly PanelCardPhase[] = ['idle', 'loading', 'ready', 'error'];
+
+interface UnitEntry {
+  at: number;
+  cards: Map<string, PanelCardRead>;
+  crash?: PanelCardCrash;
+}
+
+interface WorkspaceEntry {
+  at: number;
+  units: Map<string, UnitEntry>;
+}
+
+export type PanelParse<T> =
+  | { readonly ok: true; readonly value: T }
+  | { readonly ok: false; readonly message: string };
+
+function asRecord(value: unknown): Record<string, unknown> | undefined {
+  return typeof value === 'object' && value !== null ? (value as Record<string, unknown>) : undefined;
+}
+
+function textOf(value: unknown, max: number): string {
+  if (typeof value !== 'string') return '';
+  const trimmed = value.trim();
+  return trimmed.length > max ? trimmed.slice(0, max) : trimmed;
+}
+
+function atOf(value: unknown): number | null {
+  if (typeof value !== 'number' || !Number.isFinite(value)) return null;
+  if (value < 0) return null;
+  return Math.trunc(value);
+}
+
+function errorOf(raw: unknown): PanelCardError | undefined {
+  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: unknown): PanelParse<PanelCardsReport> {
+  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: PanelCardRead[] = [];
+  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) as PanelCardPhase;
+    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: unknown): PanelParse<PanelCrashReport> {
+  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(): PanelStateStore {
+  const workspaces = new Map<string, WorkspaceEntry>();
+
+  function trim(entry: Map<string, unknown>, max: number): void {
+    while (entry.size > max) {
+      const oldest = entry.keys().next();
+      if (oldest.done === true) return;
+      entry.delete(oldest.value);
+    }
+  }
+
+  function workspaceEntryOf(workspace: string): WorkspaceEntry {
+    const existing = workspaces.get(workspace);
+    if (existing !== undefined) return existing;
+    const created: WorkspaceEntry = { at: 0, units: new Map() };
+    workspaces.set(workspace, created);
+    trim(workspaces, PANEL_STATE_MAX_UNITS);
+    return created;
+  }
+
+  function unitEntryOf(entry: WorkspaceEntry, unit: string): UnitEntry {
+    const existing = entry.units.get(unit);
+    if (existing !== undefined) return existing;
+    const created: UnitEntry = { 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]): PanelUnitReport => {
+        const cards = [...one.cards.values()].sort((a, b) => a.route.localeCompare(b.route));
+        const okAt = cards.reduce<number | null>(
+          (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 };
+    },
+  };
+}