@dsh-workbench/core 0.2.13 → 0.2.15

package/dist/types/app/layouts/sidebar/__tests__/current-workspace.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/app/layouts/sidebar/__tests__/debug-ui.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/app/layouts/sidebar/current-workspace.d.ts

@@ -0,0 +1,8 @@
+import type { SessionsSnapshot, WorkspaceView } from '@dsh-workbench/shared';
+export interface CurrentWorkspaceInput {
+    readonly items: readonly WorkspaceView[];
+    readonly sessions: SessionsSnapshot;
+    readonly panelActive: boolean;
+    readonly storedId: string | null;
+}
+export declare function resolveCurrentWorkspace(input: CurrentWorkspaceInput): WorkspaceView | null;

package/dist/types/app/layouts/sidebar/debug-footer.d.ts

@@ -0,0 +1,4 @@
+import type { DshClientContext } from '@dsh-workbench/shared';
+export declare const DEBUG_FOOTER_ID = "workbench-debug";
+export declare const DEBUG_FOOTER_ORDER = 10;
+export declare function registerDebugFooter(ctx: DshClientContext): void;

package/dist/types/app/layouts/sidebar/session-pick.d.ts

@@ -1,8 +1,9 @@
-import type { SessionsSnapshot, WorkspaceView } from '@dsh-workbench/shared';
+import type { SessionStatusSnapshot, SessionsSnapshot, WorkspaceView } from '@dsh-workbench/shared';
 export interface PickProjectInput {
     readonly workspaceId: string;
     readonly items: readonly WorkspaceView[];
     readonly sessions: SessionsSnapshot;
+    readonly statusById: SessionStatusSnapshot;
     readonly archivedIds: ReadonlySet<string>;
     readonly openSession: (sessionId: string) => void;
     readonly startSession: (workspaceId: string) => void;

package/dist/types/app/layouts/sidebar/use-attention.d.ts

@@ -0,0 +1,16 @@
+import type { SessionStatusSnapshot, SessionsSnapshot, WorkspaceView } from '@dsh-workbench/shared';
+import { type Attention } from '../../../modules/sessions';
+export interface SidebarAttentionInput {
+    readonly items: readonly WorkspaceView[];
+    readonly sessions: SessionsSnapshot;
+    readonly statusById: SessionStatusSnapshot;
+    readonly archived: readonly string[];
+    readonly storedId: string | null;
+    readonly panelActive: boolean;
+}
+export interface SidebarAttentionState {
+    readonly current: WorkspaceView | null;
+    readonly archivedIds: ReadonlySet<string>;
+    readonly attention: Attention;
+}
+export declare function useSidebarAttention(input: SidebarAttentionInput): SidebarAttentionState;

package/dist/types/app/layouts/sidebar/workspace-items.d.ts

@@ -1,10 +1,12 @@
 import type { SelectFieldOption, Translate, WorkspaceView } from '@dsh-workbench/shared';
+import type { WorkspaceAttention } from '../../../modules/sessions';
 import type { WorkspaceSectionPlan } from './workspace-groups';
 export interface WorkspaceItemsOptions {
     readonly sections: readonly WorkspaceSectionPlan<WorkspaceView>[];
     readonly currentId: string | null;
     readonly hoverId: string | null;
     readonly t: Translate;
+    readonly attention: ReadonlyMap<string, WorkspaceAttention>;
     readonly onHover: (workspaceId: string | null) => void;
     readonly onEdit: (workspace: WorkspaceView) => void;
 }

package/dist/types/modules/panels/__tests__/diy-harness.d.ts

@@ -1,5 +1,5 @@
 import type { UnitManifest } from '@dsh-workbench/shared';
-import { type PanelStateStore } from '@dsh-workbench/shared/host';
+import { type DebugStore, type PanelStateStore } from '@dsh-workbench/shared/host';
 import type { BundleInstallOutcome } from '../model/market';
 import { panelsUnit } from '../unit';
 export type Application = 'applied' | 'restart-required' | 'overridden' | 'cancelled' | 'failed';
@@ -20,10 +20,11 @@ export declare function createDiyRig(): {
     scaffold: (unit: string, description?: string) => string;
     markInstalled: (pkg: string, at: string) => void;
     outcomeOf: (application: Application) => BundleInstallOutcome;
-    diyExec: () => unknown;
+    diyExec: (sessionId?: string) => unknown;
     NORMAL_EXEC: {
         agent: {
             session: {
+                id: string;
                 header: {
                     cwd: string;
                 };
@@ -46,6 +47,7 @@ export declare function createDiyRig(): {
         }[];
         failures?: Readonly<Record<string, string>>;
         panelState?: PanelStateStore;
+        debug?: DebugStore;
     }) => {
         specs: string[];
         registered: {
@@ -59,7 +61,7 @@ export declare function createDiyRig(): {
             execute: (args: unknown, exec?: unknown) => Promise<unknown>;
         };
         ctx: {
-            get: (key: string) => PanelStateStore | {
+            get: (key: string) => DebugStore | PanelStateStore | {
                 all: () => {
                     unit: string;
                 }[];
@@ -86,6 +88,7 @@ export declare function createDiyRig(): {
         };
         panels: import("../model/service").PanelsService;
         panelState: PanelStateStore;
+        debug: DebugStore;
         registry: {
             all: () => {
                 unit: string;

package/dist/types/modules/panels/model/diy-browser.d.ts

@@ -23,6 +23,9 @@ export interface WorkbenchPage {
     readonly ok: boolean;
     readonly url: string;
     readonly title: string;
+    readonly board: string;
+    readonly open: boolean | null;
+    readonly shown: boolean;
 }
 export declare function workbenchPageOf(shell: DshShell, command: string, session: string): Promise<WorkbenchPage>;
 export declare function writeShotsDir(shell: DshShell, dir: string): Promise<boolean>;

package/dist/types/modules/panels/model/diy-debug-routes.d.ts

@@ -0,0 +1,2 @@
+import type { DebugStore, RouteTable } from '@dsh-workbench/shared/host';
+export declare function diyDebugRoutes(store: DebugStore): RouteTable;

package/dist/types/modules/panels/model/diy-debug-routes.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/modules/panels/model/diy-debug-tools.d.ts

@@ -0,0 +1,8 @@
+import type { DshHostContext, DshToolRegistry } from '@dsh-workbench/shared';
+import type { DebugRefusal, DebugState, DebugStore } from '@dsh-workbench/shared/host';
+export declare function debugRefusalText(code: DebugRefusal, held?: DebugState): string;
+export declare function renderDebugStart(state: DebugState): string;
+export declare function renderDebugPause(state: DebugState): string;
+export declare function renderDebugResume(state: DebugState): string;
+export declare function renderDebugStop(state: DebugState): string;
+export declare function registerDebugTools(ctx: DshHostContext, tools: DshToolRegistry, store: DebugStore): readonly (() => void)[];

package/dist/types/modules/panels/model/diy-debug-tools.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/modules/panels/model/diy-look.d.ts

@@ -1,4 +1,5 @@
 import type { DshHostContext, DshToolRegistry } from '@dsh-workbench/shared';
+import { type BoardState } from './diy-page';
 import { type Shot } from './diy-browser';
 import { type CardView, type PickRequest, type SlotFacts } from './diy-scripts';
 export declare function registerLookTools(ctx: DshHostContext, tools: DshToolRegistry): readonly (() => void)[];
@@ -11,4 +12,4 @@ export declare function slotLineOf(view: CardView): string;
 export declare function outlineText(view: CardView): string;
 export declare function contrastLineOf(view: CardView): string;
 export declare function renderLook(unit: string, view: CardView, shot: Shot, pick: PickRequest): string;
-export declare function renderMissingCard(unit: string, cards: number, anchored: boolean): string;
+export declare function renderMissingCard(unit: string, view: CardView, board: BoardState): string;

package/dist/types/modules/panels/model/diy-page.d.ts

@@ -1,4 +1,7 @@
 import type { DshHostContext, DshShell, DshToolRunContext } from '@dsh-workbench/shared';
+import type { DebugState } from '@dsh-workbench/shared/host';
+import { type WorkbenchPage } from './diy-browser';
+export type BoardState = 'workshop' | 'other' | 'hidden' | 'unknown';
 export interface PageHandle {
     readonly packagesDir: string;
     readonly unit: string;
@@ -7,9 +10,18 @@ export interface PageHandle {
     readonly command: string;
     readonly session: string;
     readonly bound: boolean;
+    readonly board: BoardState;
+    readonly boardPath: string;
 }
 export interface PageOptions {
     readonly requireWorkbench?: boolean | undefined;
     readonly requireUnit?: boolean | undefined;
+    readonly requireBoard?: 'workshop' | false | undefined;
+    readonly requirePact?: boolean | undefined;
 }
+export declare function debugPausedText(held: DebugState): string;
+export declare function debugForeignPactText(held: DebugState): string;
+export declare function debugStalledText(held: DebugState): string;
+export declare function boardStateOf(page: WorkbenchPage, workshop: string | null): BoardState;
+export declare function boardGateText(board: BoardState, unit: string, page: WorkbenchPage, workshop: string | null): string;
 export declare function pageAt(ctx: DshHostContext, exec: DshToolRunContext, raw: unknown, options?: PageOptions): Promise<PageHandle>;

package/dist/types/modules/panels/model/diy-scripts.d.ts

@@ -1,4 +1,4 @@
-export declare const PAGE_PROBE = "(async () => {\n  const answer = await fetch('/workbench/api/health').then((one) => one.json()).catch(() => null);\n  return JSON.stringify({\n    plugin: answer === null ? null : answer.plugin,\n    pid: answer === null ? null : answer.pid,\n    url: location.href,\n    title: document.title,\n  });\n})()";
+export declare const PAGE_PROBE = "(async () => {\n  const answer = await fetch('/workbench/api/health').then((one) => one.json()).catch(() => null);\n  const bar = document.querySelector('.wb-rightbar');\n  const board = bar === null ? '' : (bar.getAttribute('data-wb-board') ?? '');\n  const open = bar === null ? null : bar.hasAttribute('data-wb-open');\n  const shown = bar === null ? false : getComputedStyle(bar).visibility !== 'hidden';\n  return JSON.stringify({\n    plugin: answer === null ? null : answer.plugin,\n    pid: answer === null ? null : answer.pid,\n    url: location.href,\n    title: document.title,\n    board,\n    open,\n    shown,\n  });\n})()";
 export declare function cardSelectorOf(unit: string): string;
 export type DomMode = 'none' | 'outline' | 'html';
 export interface PickRequest {
@@ -18,6 +18,7 @@ export declare function pickOf(raw: Record<string, unknown>): PickRequest;
 export interface CardView {
     readonly ok: boolean;
     readonly anchored: boolean;
+    readonly visible: boolean;
     readonly width: number;
     readonly height: number;
     readonly head: string;

package/dist/types/modules/panels/model/diy-tools.d.ts

@@ -1,4 +1,5 @@
 import type { DshHostContext } from '@dsh-workbench/shared';
+import type { DebugStore } from '@dsh-workbench/shared/host';
 import type { MarketService } from './market';
 import type { PanelsService } from './service';
-export declare function registerDiyTools(ctx: DshHostContext, market: MarketService, panels: PanelsService): Array<() => void>;
+export declare function registerDiyTools(ctx: DshHostContext, market: MarketService, panels: PanelsService, debug: DebugStore): Array<() => void>;

package/dist/types/modules/panels/model/handoff.d.ts

@@ -2,6 +2,7 @@ import type { UnitCall } from '@dsh-workbench/shared/host';
 import type { HandoffEntry } from '@dsh-workbench/shared/host';
 import type { UnitManifest } from '@dsh-workbench/shared/host';
 export declare const PANELS_FACT = "panels";
+export declare const DIY_DEBUG_FACT = "diy-debug";
 export declare function panelsHandoffEntry(target?: {
     readonly path?: string | undefined;
 }): HandoffEntry | undefined;

package/dist/types/modules/panels/unit.d.ts

@@ -37,9 +37,14 @@ export declare const DIY_NET_STOP_TOOL = "workbench_diy_net_stop";
 export declare const DIY_LOGS_WATCH_TOOL = "workbench_diy_logs_watch";
 export declare const DIY_LOGS_READ_TOOL = "workbench_diy_logs_read";
 export declare const DIY_LOGS_STOP_TOOL = "workbench_diy_logs_stop";
-export declare const ALL_TOOLS: readonly ["workbench_panels_list", "workbench_panels_show", "workbench_panels_hide", "workbench_panels_move", "workbench_panels_reset", "workbench_panels_follow", "workbench_modules_list", "workbench_modules_install", "workbench_modules_update", "workbench_modules_uninstall", "workbench_modules_install_bundle", "workbench_modules_update_dependency", "workbench_modules_update_plugin", "workbench_modules_uninstall_plugin", "workbench_modules_update_workbench", "workbench_diy_list", "workbench_diy_status", "workbench_diy_panel", "workbench_diy_recon", "workbench_diy_probe", "workbench_diy_look", "workbench_diy_install", "workbench_diy_show", "workbench_diy_click", "workbench_diy_type", "workbench_diy_fill", "workbench_diy_keys", "workbench_diy_hover", "workbench_diy_select", "workbench_diy_scroll", "workbench_diy_reload", "workbench_diy_viewport", "workbench_diy_net_watch", "workbench_diy_net_read", "workbench_diy_net_stop", "workbench_diy_logs_watch", "workbench_diy_logs_read", "workbench_diy_logs_stop"];
+export declare const DIY_DEBUG_START_TOOL = "workbench_diy_debug_start";
+export declare const DIY_DEBUG_PAUSE_TOOL = "workbench_diy_debug_pause";
+export declare const DIY_DEBUG_RESUME_TOOL = "workbench_diy_debug_resume";
+export declare const DIY_DEBUG_STOP_TOOL = "workbench_diy_debug_stop";
+export declare const ALL_TOOLS: readonly ["workbench_panels_list", "workbench_panels_show", "workbench_panels_hide", "workbench_panels_move", "workbench_panels_reset", "workbench_panels_follow", "workbench_modules_list", "workbench_modules_install", "workbench_modules_update", "workbench_modules_uninstall", "workbench_modules_install_bundle", "workbench_modules_update_dependency", "workbench_modules_update_plugin", "workbench_modules_uninstall_plugin", "workbench_modules_update_workbench", "workbench_diy_list", "workbench_diy_status", "workbench_diy_panel", "workbench_diy_recon", "workbench_diy_probe", "workbench_diy_look", "workbench_diy_install", "workbench_diy_show", "workbench_diy_click", "workbench_diy_type", "workbench_diy_fill", "workbench_diy_keys", "workbench_diy_hover", "workbench_diy_select", "workbench_diy_scroll", "workbench_diy_reload", "workbench_diy_viewport", "workbench_diy_net_watch", "workbench_diy_net_read", "workbench_diy_net_stop", "workbench_diy_logs_watch", "workbench_diy_logs_read", "workbench_diy_logs_stop", "workbench_diy_debug_start", "workbench_diy_debug_pause", "workbench_diy_debug_resume", "workbench_diy_debug_stop"];
 export type PanelsToolName = (typeof ALL_TOOLS)[number];
 export declare const READ_TOOLS: readonly ["workbench_panels_list", "workbench_modules_list", "workbench_diy_list", "workbench_diy_status", "workbench_diy_panel", "workbench_diy_recon", "workbench_diy_probe", "workbench_diy_look", "workbench_diy_click", "workbench_diy_type", "workbench_diy_fill", "workbench_diy_keys", "workbench_diy_hover", "workbench_diy_select", "workbench_diy_scroll", "workbench_diy_reload", "workbench_diy_viewport", "workbench_diy_net_watch", "workbench_diy_net_read", "workbench_diy_net_stop", "workbench_diy_logs_watch", "workbench_diy_logs_read", "workbench_diy_logs_stop"];
-export declare const WRITE_TOOLS: readonly ["workbench_panels_show", "workbench_panels_hide", "workbench_panels_move", "workbench_panels_reset", "workbench_panels_follow", "workbench_modules_install", "workbench_modules_update", "workbench_modules_uninstall", "workbench_modules_install_bundle", "workbench_modules_update_dependency", "workbench_modules_update_plugin", "workbench_modules_uninstall_plugin", "workbench_modules_update_workbench", "workbench_diy_install", "workbench_diy_show"];
+export declare const WRITE_TOOLS: readonly ["workbench_panels_show", "workbench_panels_hide", "workbench_panels_move", "workbench_panels_reset", "workbench_panels_follow", "workbench_modules_install", "workbench_modules_update", "workbench_modules_uninstall", "workbench_modules_install_bundle", "workbench_modules_update_dependency", "workbench_modules_update_plugin", "workbench_modules_uninstall_plugin", "workbench_modules_update_workbench", "workbench_diy_install", "workbench_diy_show", "workbench_diy_debug_start", "workbench_diy_debug_pause", "workbench_diy_debug_resume", "workbench_diy_debug_stop"];
 export declare const DIY_TOOLS: readonly ["workbench_diy_list", "workbench_diy_status", "workbench_diy_panel", "workbench_diy_recon", "workbench_diy_probe", "workbench_diy_look", "workbench_diy_install", "workbench_diy_show", "workbench_diy_click", "workbench_diy_type", "workbench_diy_fill", "workbench_diy_keys", "workbench_diy_hover", "workbench_diy_select", "workbench_diy_scroll", "workbench_diy_reload", "workbench_diy_viewport", "workbench_diy_net_watch", "workbench_diy_net_read", "workbench_diy_net_stop", "workbench_diy_logs_watch", "workbench_diy_logs_read", "workbench_diy_logs_stop"];
+export declare const DIY_DEBUG_TOOLS: readonly ["workbench_diy_debug_start", "workbench_diy_debug_pause", "workbench_diy_debug_resume", "workbench_diy_debug_stop"];
 export declare const panelsUnit: UnitManifest;

package/dist/types/modules/sessions/index.d.ts

@@ -1,2 +1,3 @@
 export { currentSessionId, orderByRecency, sessionNode, orderSessionRows, sessionRows, workspaceOfSession, sessionStatuses, visiblePendingKind, type SessionNode, type SessionStatusDot, } from './model/session-node';
 export { scrollEdgesOf, type ScrollEdges } from './model/scroll-edges';
+export { attentionLabel, attentionOf, attentionOfSession, attentionSessionIdOf, attentionWordLabel, type Attention, type AttentionInput, type AttentionSeverity, type WorkspaceAttention, } from './model/attention';

package/dist/types/modules/sessions/model/attention.d.ts

@@ -0,0 +1,29 @@
+import type { SessionStatusSnapshot, SessionSummary, SessionsSnapshot, Translate, WorkspaceView } from '@dsh-workbench/shared';
+export type AttentionSeverity = 'warning' | 'ongoing' | 'done';
+export interface WorkspaceAttention {
+    readonly severity: AttentionSeverity;
+    readonly count: number;
+}
+export interface Attention {
+    readonly byWorkspace: ReadonlyMap<string, WorkspaceAttention>;
+    readonly elsewhere: WorkspaceAttention | null;
+    readonly overall: WorkspaceAttention | null;
+}
+export interface AttentionInput {
+    readonly workspaces: readonly WorkspaceView[];
+    readonly sessions: SessionsSnapshot;
+    readonly statusById: SessionStatusSnapshot;
+    readonly archivedIds: ReadonlySet<string>;
+    readonly currentWorkspaceId: string | null;
+}
+export declare function attentionOfSession(summary: SessionSummary, statusById: SessionStatusSnapshot, sessions: SessionsSnapshot): AttentionSeverity | undefined;
+export interface AttentionPickInput {
+    readonly workspace: WorkspaceView | null;
+    readonly sessions: SessionsSnapshot;
+    readonly statusById: SessionStatusSnapshot;
+    readonly archivedIds: ReadonlySet<string>;
+}
+export declare function attentionSessionIdOf(input: AttentionPickInput): string | null;
+export declare function attentionOf(input: AttentionInput): Attention;
+export declare function attentionLabel(attention: WorkspaceAttention, t: Translate): string;
+export declare function attentionWordLabel(attention: WorkspaceAttention, t: Translate): string;

package/dist/types/modules/sessions/model/attention.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/shared/hooks/use-api-resource.d.ts

@@ -15,4 +15,5 @@ export declare function useApiResource<T>(route: string, query: Query, refreshTo
     enabled?: boolean;
     key?: string;
     fact?: string;
+    report?: boolean;
 }): ResourceState<T>;

package/dist/types/shared/hooks/use-diy-debug.d.ts

@@ -0,0 +1,4 @@
+import type { DebugState } from '@dsh-workbench/shared';
+export declare const DIY_DEBUG_ROUTE = "panels/diy-debug";
+export declare const DIY_DEBUG_FACT = "diy-debug";
+export declare function useDiyDebugState(): DebugState | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-workbench/core",
-  "version": "0.2.13",
+  "version": "0.2.15",
   "description": "个人工作台：Agent 工作台外壳（左栏 + 常驻对话 + 自研右侧数据面板）。",
   "type": "module",
   "icon": "./icon.svg",
@@ -87,7 +87,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@dsh-workbench/shared": "0.2.13"
+    "@dsh-workbench/shared": "0.2.15"
   },
   "scripts": {
     "build": "node scripts/build.mjs && node scripts/build-types.mjs",

package/skills/workbench-module-diy/BUILD.md

@@ -145,6 +145,6 @@ export function apply(ctx) {
 "空"和"还没开始"是两件事，说错了他会去查他根本没配的东西。
 
 **卡片必须在拿不到数据时也画得出来**（第一次读、卡在审批、平台没登录）。
-空数据下抛异常的卡片 = 用户眼里的"卡片一直不出来"。这是 `check:cards` 守的那条。
+任何一种输入（待机 / 在读 / 有值 / 有值但空 / 读不到）下抛异常、屏上冒出 `undefined` / `NaN` 的卡片 = 用户眼里的"卡片一直不出来"。这是 `check:cards` 守的那条。
 
 → 拿到依赖、装上、改一行、发出去：[WIRING.md](WIRING.md)。

package/skills/workbench-module-diy/DATASOURCE.md

@@ -97,7 +97,7 @@
 | 超时 / 网络不通 | "这次没读到，稍后重试" + 重试 |
 | 站点改版、字段没了 | "读到的形状和预期不一样"（别显示空白，也别显示 0） |
 
-空数据下抛异常的卡片 = 用户眼里的"卡片一直不出来"。这条 `check:cards` 会拦（见 [REVIEW.md](REVIEW.md)）。
+任何一种输入（待机 / 在读 / 有值 / 有值但空 / 读不到）下抛异常、屏上冒出 `undefined` / `NaN` 的卡片 = 用户眼里的"卡片一直不出来"。这条 `check:cards` 会拦（见 [REVIEW.md](REVIEW.md)）。
 
 ## 错误码不是随便写的（阻断屏按它换文案）
 

package/skills/workbench-module-diy/KIT.md

@@ -86,6 +86,20 @@ h(Field, { label: t('myunit.mode'), hint: t('myunit.modeHint') },
 **`SelectField`** —— 下拉：默认是**常规下拉框**（跟 `TextField` 一套），无边框那种给 `variant: 'ghost'`；
 搜索、分组、禁用项、加载态、空态、页脚都是它的 prop。
 **`SaveBar`** —— 设置面底下那条"取消 / 保存"（`busy` / `disabled` / `labels` / `onCancel` / `onSave`）。
+**`FormActions`** —— **操作区**（一组按钮）：`actions: { key, label, kind?: 'default' | 'danger' | 'primary', onClick, disabled?, busy? }[]`。
+**顺序 / 间距 / 换行都归它** —— `primary` 永远在右、`danger` 紧挨它左侧、一个区只许一颗 `primary`、
+窄了自动折行且 `primary` 落在右下角；`busy` 自带 `Spinner`。调用点只给"有哪些动作、哪个是主要、点了做什么"：
+**别自己写 `gap` / `margin` / 顺序，也别借 `.wb-formActions` 槽类手摆**（`check:style` 的 F3 会红，没有豁免）。
+
+```tsx
+h(FormActions, { actions: [
+  { key: 'retry', label: t('myunit.retry'), onClick: onRetry, disabled: busy },
+  { key: 'confirm', label: t('myunit.confirm'), kind: 'primary', onClick: submit, disabled: busy },
+] })
+```
+
+`danger` 只标"这是破坏性的"（渲成描边 + 危险色，**永远不当填充的 `primary`**）；**二次确认那半归调用点**
+（先问一句或弹窗都行），口径见 [ADR-0054](../../../../docs/adr/0054-the-action-area-is-one-component.md) §2 规则三。
 
 **别手写 `<button>` / `<input>` / `<select>`**：dsh 有 `Button`（`variant` / `size`），
 kit 有上面这几件；手写的会拿到浏览器默认样式，而且**判据会红**（`check:style`）。
@@ -124,7 +138,9 @@ h(FormRows, null,
 是一个意思；**loading 那颗一律是 `Spinner`**（`h(Spinner, { size: 14 })`）—— **别自己写转圈**。
 
 **尺寸口径**：字段控件默认 **28**（dsh 紧凑档），**别自己调高**；行距**只有一档**、归 `FormRow(s)`，
-模块里不该出现管行距的 `gap` / `margin`（横向的、卡片/清单网格的不算）。
+模块里不该出现管行距的 `gap` / `margin`（横向的、卡片/清单网格的不算）。标签列也归它：
+**长标签不折行；同一 `FormRows` 共用一个标签列（列宽由最长的标签定），别自己给标签写宽度**
+（非行的子项，比如分组标题 `<p>`，自动通栏）。
 
 **反例（别这么写）**：
 
@@ -134,12 +150,13 @@ h('div', { className: styles.form }, …)                    // ← .form { gap:
 ```
 
 `<span className={styles.label}>` 紧邻控件、或给表单容器自己写 `gap` —— 这正是 `check:style` 那条
-棘轮（F1 手写行 / F2 自己管行距）盯的东西；`FORM_ROW_EXEMPT` 是**等外壳发版后要清空的历史账**
-（"迁一处删一行"），**不是"可以继续这么写"的许可**。
+棘轮（F1 手写行 / F2 自己管行距）盯的东西；`FORM_ROW_EXEMPT` 是这张表的历史账，**2026-10-17 已经清空**
+（外壳 0.2.13 之后按"迁一处删一行"迁完，ADR-0052 §10）—— 表空了仍然**不是"可以继续这么写"的许可**：
+现在再这么写直接红，没有豁免那一层。
 
 **时点**：这一层随外壳**发版**后模块才能用 —— 模块的 `peerDependencies` 下限得先有它
 （`check:kit` 拿 peer 下限那份外壳比，不抬必红）；迁移步骤见
-[ADR-0052](../../../../docs/adr/0052-the-form-row-is-one-component.md) §10。
+[ADR-0052](../../../../docs/adr/0052-the-form-row-is-one-component.md) §10。已迁完的包下限在 `^0.2.14`。
 
 ## 6 别的
 
@@ -149,7 +166,7 @@ h('div', { className: styles.form }, …)                    // ← .form { gap:
 - **`Stack`** —— 竖排 + 统一间距（懒得分组时的默认容器）。
 - **`BlockerState`** —— 阻断屏：要登录 / 没权限 / 能力没装好那一类（`blocker` / `t` / `onRetry` / `onOpenMarket`）。
 - **`Tip`** —— Tooltip：图标钮与只有图的地方**必须**有它（或 `aria-label`）。
-- **别给模块带夹具**：2026-10-16 起模板 / `init` 文案 / 这份指引都不带评审夹具了（`?wbMock=1` 那套、`useFixturePick` / `MockStrip` / `mockNote` 都从模板里删了）。夹具是模块作者负担里最不值的那一份 —— 而**你自己那份 `plugin.test.ts` 就能把五态各喂一遍**，门禁从来只问"空数据画不画得出"（`check:cards`）。外壳自己那套 `?wbMock=1` 夹具是给**外壳的卡片**用的，模块不必跟（机制仍在，谁想要仍然可以用，但**不是你要做的事**）。
+- **别给模块带夹具**：2026-10-16 起模板 / `init` 文案 / 这份指引都不带评审夹具了（`?wbMock=1` 那套、`useFixturePick` / `MockStrip` / `mockNote` 都从模板里删了）。夹具是模块作者负担里最不值的那一份 —— 而**你自己那份 `plugin.test.ts` 就能把五态各喂一遍**，而 `check:cards` 会拿七种外壳侧输入各喂一遍（它只问"退化得干不干净"，不断言"画的是哪一态那一屏"）。外壳自己那套 `?wbMock=1` 夹具是给**外壳的卡片**用的，模块不必跟（机制仍在，谁想要仍然可以用，但**不是你要做的事**）。
 - **图标** —— `IconPanelScreen`（面板/卡片那类）、`IconModuleMark`（我们的模块类型标）、
   `IconNpm` / `IconOpencli`（包类型）；其余图形一律从 dsh 的 `Icon*Regular` 拿，**别自己画图标**。
 

package/skills/workbench-module-diy/PANEL.md

@@ -164,7 +164,7 @@ agent 那一侧也要能通过模块自己的能力读到同一份偏好。
 - **平台没给的那一格就不占位**（不留孤零零的字段名、不留空的一行）。
 - **读不到就说读不到**，并说清为什么（例：手上这份能力太旧）；**绝不显示 0**。
 - 有确定答案就不打扰他（能按默认读出来就别弹设置面）。
-- 真机上造不出来的状态也要**在设计上**画出来（照这一格写清）—— 但**不必为它写夹具**：2026-10-16 起模板与指引都不带评审夹具，模块自己的 `plugin.test.ts` 把五态各喂一遍就够（门禁只问"空数据画不画得出"）。
+- 真机上造不出来的状态也要**在设计上**画出来（照这一格写清）—— 但**不必为它写夹具**：2026-10-16 起模板与指引都不带评审夹具，模块自己的 `plugin.test.ts` 把五态各喂一遍就够（`check:cards` 会拿**七种外壳侧输入**各喂一遍 —— 它只问"退化得干不干净"，**不断言**"画的是哪一态那一屏"）。
 
 ### 7.1 图例就是把屏幕画成 ASCII
 

package/skills/workbench-module-diy/REVIEW.md

@@ -11,7 +11,7 @@
 | `source` | 非种子词的 `@deepseek-ai/*`、宿主侧碰 dsh 的浏览器包、`@/` 指到工作台源码 | `…在宿主侧可达` / `不是平台种子词` | 宿主侧只用 Node 侧的东西；dsh 原语一律走 `kit`；`@/` 只指自己的 `src/` |
 | `primitives` | 声明了 `external` 却没有产物物证 ⇒ dsh 原语被**内联**成第二份实例 | `…用了却没声明 external` / `宿主产物里出现了` | 在 `dsh.client.external` 里显式声明它；确认产物里是 `require(...)` 而不是被打包进来 |
 | `kit` | 用了 peer 下限那份外壳**还没有**的 kit 成员 ⇒ 卡片首帧 `Element type is invalid`，整块面板被 React 卸掉 | `kit.components.X 在这份外壳里没有` / `peer 下限比 devDependency 还旧` | 只用 peer 范围里真有的成员；把 `peerDependencies` 的下限提到你实际用的那档 |
-| `cards` | 卡片拿**空数据**就抛 ⇒ 用户看到"卡片一直不出来 / 点一下白屏" | `空数据下卡片抛了` / `卡片只画出一个节点` / `卡片没套外壳的卡壳` / `清单的 card.titleKey「x」在模块字典的 en 里没有` / `…没有落点` | 让卡片在没数据时也画得出来（已有的加载 / 空 / 阻断态）；外面套 `kit.components.Card`；清单写了 `titleKey`，`registerUnit` 交的 `messages` 里 `zh` / `en` 都得有那一条（漏了面板上显示的是原始键名） |
+| `cards` | 卡片在某一种**外壳侧输入**下崩 / 空白 / 变脏 ⇒ 用户看到"卡片一直不出来 / 点一下白屏 / 屏上冒出 `undefined`"。判据拿七种输入各喂一遍（待机 / 在读 / 在读但保留旧值 / 有值 / 有值但空容器 / 读不到 / 能力闸缺插件），`zh`、`en` 各一遍；取数走**你装的那份真壳**的 `useUnitBoard` | `loading（zh） 卡片抛了` / `loading（zh） 卡片返回空` / `屏上出现了 undefined`（`NaN` / `[object Object]` / `null` 同形） / `t('x') 在 zh 里没有落点` / `卡片没套外壳的卡壳` / `清单的 card.titleKey「x」在模块字典的 en 里没有` | 让卡片在五态下都画得出来（已有的加载 / 空 / 阻断态）；外面套 `kit.components.Card`；清单写了 `titleKey`，`registerUnit` 交的 `messages` 里 `zh` / `en` 都得有那一条；**卡片与它用的 kit 组件问过的每个键也都要有落点**（判据自己当 `t`，没命中就报原始键名）。判据**不断言**"画的是哪一态那一屏" —— 那归你自己那份 `plugin.test.ts` |
 | `standalone` | "只有工作台源码在场才编得过" ⇒ 发布出去就散架 | `build 在外壳源码不在场时失败` / `typecheck 在外壳源码不在场时失败` | 别引用工作台源码；`tsconfig` 里 `paths` 的值必须是**相对路径**（`"./src/*"`，不是 `"src/*"`） |
 | `markers` | 内网域名 / 企业内部名泄进要公开发布的包 | `命中内网 npm 源` / `命中内网域名` | 那些值不该写进包里；要配就落到模块自己的配置面，或走用户自己声明的来源 |
 | `alias` | `@/` 伸进工作台源码 ⇒ 装的人手上没有那份源码 | `…指向外壳源码` | `@/` 只许指自己的 `src/`；跨包的东西走包名 |