@dsh-workbench/core 0.2.11 → 0.2.12

package/dist/types/app/client.d.ts

@@ -5,7 +5,6 @@ import * as apiModule from '@dsh-workbench/shared';
 import * as chipsModule from '../shared/api/context-chips';
 import * as apiResourceModule from '../shared/hooks/use-api-resource';
 import * as cardSummaryModule from '../shared/hooks/use-card-summary';
-import * as fixturePickModule from '../shared/hooks/use-fixture-pick';
 import * as hostWriteModule from '../shared/hooks/use-host-write';
 import * as longTaskModule from '../shared/hooks/use-long-task';
 import * as capabilityGateModule from '../shared/hooks/use-capability-gate';
@@ -23,8 +22,6 @@ export declare const kit: {
             readonly fixture?: apiModule.CapabilityPayload | undefined;
         }): capabilityGateModule.CapabilityGate;
         useCapabilityMap(refreshToken: number): capabilityGateModule.CapabilityMapView;
-        mockModeOn(search: string): boolean;
-        crashModeOn(search: string): boolean;
         useLongTask<T extends {
             readonly id: string;
             readonly status: apiModule.LongTaskStatus;
@@ -39,7 +36,6 @@ export declare const kit: {
         useFactRevision(fact: string): number;
         subscribeFactRevision(fact: string, listener: () => void): () => void;
         useFactInvalidate(): (fact?: string) => void;
-        useFixturePick<T extends fixturePickModule.PickableFixture>(options: fixturePickModule.FixturePickOptions<T>): fixturePickModule.FixturePick<T>;
         useCardSummary(onSummary: (summary: cardSummaryModule.CardSummary) => void, summary: {
             readonly refreshing: boolean;
             readonly at: number | null | undefined;
@@ -114,20 +110,6 @@ export declare const kit: {
         CardHead({ t, title, meta, refreshing, onRefresh, gear, gearOpen, onToggleGear, platformHref, platform, platformTitle, }: apiModule.CardHeadProps): JSX.Element;
         ChoiceGroup(props: apiModule.ChoiceGroupProps): JSX.Element;
         LongTaskRow(props: apiModule.LongTaskRowProps): JSX.Element;
-        MockStrip({ mocks, index, onPick, note, real, }: {
-            readonly mocks: readonly {
-                readonly id: string;
-                readonly label: string;
-            }[];
-            readonly index: number;
-            readonly onPick: (next: number) => void;
-            readonly note?: string;
-            readonly real?: {
-                readonly label: string;
-                readonly active: boolean;
-                readonly onPick: () => void;
-            } | undefined;
-        }): JSX.Element;
         Note({ tone, as, role, children }: apiModule.NoteProps): JSX.Element;
         SkeletonRows({ rows }: {
             rows?: number;
@@ -1101,20 +1083,6 @@ export declare const kit: {
         CardHead({ t, title, meta, refreshing, onRefresh, gear, gearOpen, onToggleGear, platformHref, platform, platformTitle, }: apiModule.CardHeadProps): JSX.Element;
         ChoiceGroup(props: apiModule.ChoiceGroupProps): JSX.Element;
         LongTaskRow(props: apiModule.LongTaskRowProps): JSX.Element;
-        MockStrip({ mocks, index, onPick, note, real, }: {
-            readonly mocks: readonly {
-                readonly id: string;
-                readonly label: string;
-            }[];
-            readonly index: number;
-            readonly onPick: (next: number) => void;
-            readonly note?: string;
-            readonly real?: {
-                readonly label: string;
-                readonly active: boolean;
-                readonly onPick: () => void;
-            } | undefined;
-        }): JSX.Element;
         Note({ tone, as, role, children }: apiModule.NoteProps): JSX.Element;
         SkeletonRows({ rows }: {
             rows?: number;
@@ -2083,20 +2051,6 @@ export declare const kit: {
         CardHead({ t, title, meta, refreshing, onRefresh, gear, gearOpen, onToggleGear, platformHref, platform, platformTitle, }: apiModule.CardHeadProps): JSX.Element;
         ChoiceGroup(props: apiModule.ChoiceGroupProps): JSX.Element;
         LongTaskRow(props: apiModule.LongTaskRowProps): JSX.Element;
-        MockStrip({ mocks, index, onPick, note, real, }: {
-            readonly mocks: readonly {
-                readonly id: string;
-                readonly label: string;
-            }[];
-            readonly index: number;
-            readonly onPick: (next: number) => void;
-            readonly note?: string;
-            readonly real?: {
-                readonly label: string;
-                readonly active: boolean;
-                readonly onPick: () => void;
-            } | undefined;
-        }): JSX.Element;
         Note({ tone, as, role, children }: apiModule.NoteProps): JSX.Element;
         SkeletonRows({ rows }: {
             rows?: number;

package/dist/types/app/layouts/rightbar/board-mock.d.ts

@@ -1,5 +1,5 @@
 import type { UnitManifest } from '@dsh-workbench/shared';
-import type { BoardShape } from './board-plan';
+import type { BoardShape } from './board-shape';
 export interface BoardMockExpect {
     readonly cards: number;
     readonly empty: boolean;

package/dist/types/app/layouts/rightbar/board-plan.d.ts

@@ -1,18 +1,6 @@
 import type { BoardModule } from '@dsh-workbench/shared';
-export type BoardShape = {
-    readonly kind: 'real';
-} | {
-    readonly kind: 'empty';
-} | {
-    readonly kind: 'unread';
-} | {
-    readonly kind: 'kit';
-} | {
-    readonly kind: 'all';
-} | {
-    readonly kind: 'copies';
-    readonly count: number;
-};
+import type { BoardShape } from './board-shape';
+export type { BoardShape };
 export interface RealBoard {
     readonly modules: readonly BoardModule[];
     readonly configRead: boolean;

package/dist/types/app/layouts/rightbar/board-shape.d.ts

@@ -0,0 +1,14 @@
+export type BoardShape = {
+    readonly kind: 'real';
+} | {
+    readonly kind: 'empty';
+} | {
+    readonly kind: 'unread';
+} | {
+    readonly kind: 'kit';
+} | {
+    readonly kind: 'all';
+} | {
+    readonly kind: 'copies';
+    readonly count: number;
+};

package/dist/types/dev/MockStrip.d.ts

@@ -0,0 +1,15 @@
+import '@/shared/styles/mock-strip.css';
+export declare function MockStrip({ mocks, index, onPick, note, real, }: {
+    readonly mocks: readonly {
+        readonly id: string;
+        readonly label: string;
+    }[];
+    readonly index: number;
+    readonly onPick: (next: number) => void;
+    readonly note?: string;
+    readonly real?: {
+        readonly label: string;
+        readonly active: boolean;
+        readonly onPick: () => void;
+    } | undefined;
+}): JSX.Element;

package/dist/types/dev/surface-types.d.ts

@@ -0,0 +1,53 @@
+import type { ReactNode } from 'react';
+import type { BoardModule, UnitManifest } from '@dsh-workbench/shared';
+import type { PreflightSnapshot } from '../shared/api/host/preflight';
+import type { BoardShape } from '../app/layouts/rightbar/board-shape';
+import type { AddModuleMock } from '../app/layouts/market/add-module-mock';
+import type { AddModuleState } from '../app/layouts/market/use-add-module';
+export interface DevPickable {
+    readonly id: string;
+    readonly label: string;
+}
+export interface DevPickOptions<T extends DevPickable> {
+    readonly fixtures: readonly T[];
+    readonly selected?: string | null | undefined;
+    readonly onSelect?: ((id: string | null) => void) | undefined;
+    readonly enabled?: boolean | undefined;
+    readonly initial?: string | null | undefined;
+}
+export interface DevPick<T extends DevPickable> {
+    readonly enabled: boolean;
+    readonly active: string | null;
+    readonly current: T | undefined;
+    readonly nonce: number;
+    readonly index: number;
+    pick(id: string | null): void;
+}
+export interface DevStrips<T extends DevPickable> {
+    readonly pick: DevPick<T>;
+    readonly current: T | undefined;
+    readonly enabled: boolean;
+    readonly strip: ReactNode;
+}
+export interface DevBoard {
+    readonly shape: BoardShape;
+    readonly seed: readonly BoardModule[];
+    readonly strip: (show: boolean) => ReactNode;
+    readonly mode: boolean;
+}
+export type DevStripSite = 'panel' | 'market' | 'addModule';
+export interface DevSurface {
+    on(search: string): boolean;
+    crash(search: string): boolean;
+    useBoard(input: {
+        readonly manifests: readonly UnitManifest[];
+        readonly all: readonly BoardModule[];
+        readonly search: string;
+    }): DevBoard;
+    useStrips<T extends DevPickable>(site: DevStripSite, manifests: readonly UnitManifest[]): DevStrips<T>;
+    addModuleState(base: AddModuleState, mock: AddModuleMock): AddModuleState;
+    gateStrip(options: {
+        readonly onPick: (snapshot: PreflightSnapshot | null) => void;
+    }): HTMLElement | null;
+    readonly kitModule: BoardModule | null;
+}

package/dist/types/dev/surface.d.ts

@@ -0,0 +1,2 @@
+import type { DevSurface } from './surface-types';
+export declare const devSurface: DevSurface;

package/dist/types/dev/surface.stub.d.ts

@@ -0,0 +1,2 @@
+import type { DevSurface } from './surface-types';
+export declare const devSurface: DevSurface;

package/package.json

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

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

@@ -119,4 +119,4 @@
 
 - 数据源写在**宿主半侧**，卡片只消费它的返回；
 - 只读路由出错时回 `{ ok: false, error: { code, message, hint? } }`（HTTP 仍是 200，外壳原样转发）；
-- 验收时把「正常 / 空 / 出错」三条路都走一遍 —— 真机上造不出来的那几条，写清怎么才能看到（**评审夹具不是必做的**）。
+- 验收时把「正常 / 空 / 出错」三条路都走一遍 —— 真机上造不出来的那几条，写清**怎么才能真看到**（换个空目录、换个不存在的路径那种），别为它写夹具（**2026-10-16 起模板与指引都不带评审夹具**）。

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

@@ -99,7 +99,7 @@ kit 有上面这几件；手写的会拿到浏览器默认样式，而且**判
 - **`Stack`** —— 竖排 + 统一间距（懒得分组时的默认容器）。
 - **`BlockerState`** —— 阻断屏：要登录 / 没权限 / 能力没装好那一类（`blocker` / `t` / `onRetry` / `onOpenMarket`）。
 - **`Tip`** —— Tooltip：图标钮与只有图的地方**必须**有它（或 `aria-label`）。
-- **`MockStrip`** —— 夹具条（`?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` 把五态各喂一遍就够（门禁只问"空数据画不画得出"）。
 
 ### 7.1 图例就是把屏幕画成 ASCII
 
@@ -187,7 +187,7 @@ agent 那一侧也要能通过模块自己的能力读到同一份偏好。
 - **用真字**：图里的文案用界面上真实那句（例「没有指派给你的缺陷。」），别写"一句空态文案"。
 - **别拿图标代替画面**：给状态起个名字、配个 `⛔` 这类符号，用户还是分不清；一眼能认的是**形状**（整卡换掉 vs 多一行）与**位置**（行首的点、行尾的两颗）。
 - **画不成的才写词**：动作、agent 的下一步、时间性的"不变 / 自己变"，写成词并说清意思。
-- **真机上造不出来的状态**：沟通时照样画（画的是设计意图）；实现时有 `?wbMock=1` 那一套就顺手造出来给人切 —— **不是必做**。
+- **真机上造不出来的状态**：沟通时照样画（画的是设计意图）；实现时**要让它能用真实输入走到**（换个空目录、换个坏路径、先不选），而不是给它写夹具 —— 2026-10-16 起模板与指引都不带评审夹具，模块自己的 `plugin.test.ts` 把五态各喂一遍就够。
 
 ## 8 范例（真实产出的形状）