@dsh-workbench/core 0.2.12 → 0.2.13

package/dist/host/index.js

@@ -435,84 +435,6 @@ function createPanelStateStore() {
 	};
 }
 //#endregion
-//#region ../shared/dist/host/cli-error.js
-function unquote(raw) {
-	const value = raw.trim();
-	if (value.length >= 2 && (value.startsWith("\"") && value.endsWith("\"") || value.startsWith("'") && value.endsWith("'"))) return value.slice(1, -1);
-	return value;
-}
-function joinBlock(previous, line, fold) {
-	if (previous === "") return line;
-	return fold ? `${previous} ${line}` : `${previous}\n${line}`;
-}
-function parseCliErrorEnvelope(text) {
-	if (text === void 0 || text.trim() === "") return void 0;
-	const lines = text.split("\n");
-	const start = lines.findIndex((line) => /^error:\s*$/.test(line.trim()) || /^error:\s*\S/.test(line.trim()));
-	if (start === -1) return void 0;
-	const scalars = {};
-	let current;
-	let block;
-	const errorIndent = lines[start]?.search(/\S/) ?? 0;
-	for (const line of lines.slice(start + 1)) {
-		if (line.trim() === "") continue;
-		const indent = line.search(/\S/);
-		if (block !== void 0 && indent > block.indent) {
-			scalars[block.key] = joinBlock(scalars[block.key] ?? "", line.trim(), block.fold);
-			continue;
-		}
-		block = void 0;
-		if (indent <= errorIndent) break;
-		const match = /^\s*(code|message|help|exitCode):\s*(.*)$/.exec(line);
-		if (match === null) {
-			if (current !== void 0) scalars[current] = `${scalars[current] ?? ""} ${line.trim()}`.trim();
-			continue;
-		}
-		const [, key, value] = match;
-		if (key === void 0) continue;
-		const raw = (value ?? "").trim();
-		const marker = /^([|>])[0-9]*([+-]?)$/.exec(raw);
-		if (marker !== null) {
-			scalars[key] = "";
-			block = {
-				key,
-				fold: marker[1] === ">",
-				indent
-			};
-			current = key;
-			continue;
-		}
-		scalars[key] = unquote(raw);
-		current = key;
-	}
-	const code = scalars["code"];
-	const message = scalars["message"];
-	if (code === void 0 || code === "") return void 0;
-	const exitCode = scalars["exitCode"];
-	return {
-		code,
-		message: message ?? code,
-		...scalars["help"] === void 0 || scalars["help"] === "" ? {} : { help: scalars["help"] },
-		...exitCode === void 0 || Number.isNaN(Number(exitCode)) ? {} : { exitCode: Number(exitCode) }
-	};
-}
-function helpUrlOf(envelope) {
-	return /https?:\/\/[^\s"'`]+/.exec(envelope.help ?? "")?.[0];
-}
-//#endregion
-//#region ../shared/dist/host/data-root.js
-function dshHome() {
-	const configured = process.env.DSH_HOME?.trim();
-	if (configured !== void 0 && configured !== "") return configured;
-	return `${process.env.HOME ?? ""}/.dsh`;
-}
-function workbenchRoot() {
-	return `${dshHome()}/workbench`;
-}
-function workspacesRoot() {
-	return `${workbenchRoot()}/workspaces`;
-}
-//#endregion
 //#region ../shared/dist/host/opencli-window.js
 var OPENCLI_WINDOW_ENV = "OPENCLI_WINDOW=background";
 function backgroundPrefix() {
@@ -1023,6 +945,84 @@ async function browserFind(options) {
 	};
 }
 //#endregion
+//#region ../shared/dist/host/cli-error.js
+function unquote(raw) {
+	const value = raw.trim();
+	if (value.length >= 2 && (value.startsWith("\"") && value.endsWith("\"") || value.startsWith("'") && value.endsWith("'"))) return value.slice(1, -1);
+	return value;
+}
+function joinBlock(previous, line, fold) {
+	if (previous === "") return line;
+	return fold ? `${previous} ${line}` : `${previous}\n${line}`;
+}
+function parseCliErrorEnvelope(text) {
+	if (text === void 0 || text.trim() === "") return void 0;
+	const lines = text.split("\n");
+	const start = lines.findIndex((line) => /^error:\s*$/.test(line.trim()) || /^error:\s*\S/.test(line.trim()));
+	if (start === -1) return void 0;
+	const scalars = {};
+	let current;
+	let block;
+	const errorIndent = lines[start]?.search(/\S/) ?? 0;
+	for (const line of lines.slice(start + 1)) {
+		if (line.trim() === "") continue;
+		const indent = line.search(/\S/);
+		if (block !== void 0 && indent > block.indent) {
+			scalars[block.key] = joinBlock(scalars[block.key] ?? "", line.trim(), block.fold);
+			continue;
+		}
+		block = void 0;
+		if (indent <= errorIndent) break;
+		const match = /^\s*(code|message|help|exitCode):\s*(.*)$/.exec(line);
+		if (match === null) {
+			if (current !== void 0) scalars[current] = `${scalars[current] ?? ""} ${line.trim()}`.trim();
+			continue;
+		}
+		const [, key, value] = match;
+		if (key === void 0) continue;
+		const raw = (value ?? "").trim();
+		const marker = /^([|>])[0-9]*([+-]?)$/.exec(raw);
+		if (marker !== null) {
+			scalars[key] = "";
+			block = {
+				key,
+				fold: marker[1] === ">",
+				indent
+			};
+			current = key;
+			continue;
+		}
+		scalars[key] = unquote(raw);
+		current = key;
+	}
+	const code = scalars["code"];
+	const message = scalars["message"];
+	if (code === void 0 || code === "") return void 0;
+	const exitCode = scalars["exitCode"];
+	return {
+		code,
+		message: message ?? code,
+		...scalars["help"] === void 0 || scalars["help"] === "" ? {} : { help: scalars["help"] },
+		...exitCode === void 0 || Number.isNaN(Number(exitCode)) ? {} : { exitCode: Number(exitCode) }
+	};
+}
+function helpUrlOf(envelope) {
+	return /https?:\/\/[^\s"'`]+/.exec(envelope.help ?? "")?.[0];
+}
+//#endregion
+//#region ../shared/dist/host/data-root.js
+function dshHome() {
+	const configured = process.env.DSH_HOME?.trim();
+	if (configured !== void 0 && configured !== "") return configured;
+	return `${process.env.HOME ?? ""}/.dsh`;
+}
+function workbenchRoot() {
+	return `${dshHome()}/workbench`;
+}
+function workspacesRoot() {
+	return `${workbenchRoot()}/workspaces`;
+}
+//#endregion
 //#region ../shared/dist/host/facts.js
 function createFactLog(options = {}) {
 	const epoch = options.epoch ?? `e${Date.now().toString(36)}${Math.random().toString(36).slice(2, 8)}`;

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

@@ -88,13 +88,13 @@ export declare const kit: {
         gateOf(capability: apiModule.CapabilityPayload | null, mode: apiModule.GateMode): apiModule.UnitGate;
         splitBlocker(candidates: readonly (apiModule.ModuleBlocker | undefined)[]): apiModule.UnitBlockers;
         probeKeyOf(error: apiModule.ApiError | undefined): string | null;
-        hasEnvSupply(manifest: apiModule.UnitManifest): boolean;
         declarationProblemsOf(subject: string, raw: unknown): readonly string[];
         readDeclaration(subject: string, raw: unknown): apiModule.DeclarationRead;
         WORKBENCH_API_VERSION: 1;
         SUPPORTED_API_VERSIONS: readonly number[];
         DECLARATION_KEYS: readonly string[];
         DECLARATION_REQUIRED_KEYS: readonly string[];
+        hasEnvSupply(manifest: apiModule.UnitManifest): boolean;
         apiGet<T>(route: string, query?: apiModule.Query, options?: apiModule.ApiGetOptions): Promise<apiModule.ApiResponse<T>>;
         apiPost<T>(route: string, body: Record<string, unknown>): Promise<apiModule.ApiResponse<T>>;
         ActivityBlock({ head, children }: apiModule.ActivityBlockProps): JSX.Element;
@@ -109,6 +109,10 @@ export declare const kit: {
         CardBoundary: typeof apiModule.CardBoundary;
         CardHead({ t, title, meta, refreshing, onRefresh, gear, gearOpen, onToggleGear, platformHref, platform, platformTitle, }: apiModule.CardHeadProps): JSX.Element;
         ChoiceGroup(props: apiModule.ChoiceGroupProps): JSX.Element;
+        Field({ label, hint, children }: apiModule.FieldProps): JSX.Element;
+        FormRows({ children }: apiModule.FormRowsProps): JSX.Element;
+        FormRow({ label, hint, problem, layout, children }: apiModule.FormRowProps): JSX.Element;
+        Link({ href, children, title, external, className }: apiModule.LinkProps): JSX.Element;
         LongTaskRow(props: apiModule.LongTaskRowProps): JSX.Element;
         Note({ tone, as, role, children }: apiModule.NoteProps): JSX.Element;
         SkeletonRows({ rows }: {
@@ -123,7 +127,6 @@ export declare const kit: {
         Rows({ children }: apiModule.RowsProps): JSX.Element;
         Row({ label, value }: apiModule.RowProps): JSX.Element;
         SaveBar({ busy, disabled, labels, onCancel, onSave }: apiModule.SaveBarProps): JSX.Element;
-        SettingsSection({ label, title, action, children }: apiModule.SettingsSectionProps): JSX.Element;
         searchTextOf(option: apiModule.SelectFieldOption): string;
         defaultSelectFilter(option: apiModule.SelectFieldOption, query: string): boolean;
         filterSelectOptions(options: readonly apiModule.SelectFieldOption[], query: string, filter?: (option: apiModule.SelectFieldOption, query: string) => boolean): readonly apiModule.SelectFieldOption[];
@@ -131,11 +134,11 @@ export declare const kit: {
         stepSelectCursor(shown: readonly apiModule.SelectFieldOption[], cursor: number | null, step: 1 | -1): number | null;
         selectEntries(shown: readonly apiModule.SelectFieldOption[], emptyText: string | undefined): readonly import("@deepseek-ai/dsh-client-ui-primitives").MenuEntry[];
         SelectField(props: apiModule.SelectFieldProps): apiModule.ReactNode;
+        SettingsSection({ label, title, action, children }: apiModule.SettingsSectionProps): JSX.Element;
+        Spinner({ size, label }: apiModule.SpinnerProps): JSX.Element;
         Stack({ children }: apiModule.StackProps): JSX.Element;
         StateBlock({ title, dot, hint, actions, resolving, children }: apiModule.StateBlockProps): JSX.Element;
         TextField({ invalid, className, ...rest }: apiModule.TextFieldProps): JSX.Element;
-        Field({ label, hint, children }: apiModule.FieldProps): JSX.Element;
-        Link({ href, children, title, external, className }: apiModule.LinkProps): JSX.Element;
         IconConversation({ size }: apiModule.IconProps): JSX.Element;
         IconBrandMark({ size }: apiModule.IconProps): JSX.Element;
         IconOpencli({ size }: apiModule.IconProps): JSX.Element;
@@ -989,6 +992,8 @@ export declare const kit: {
         blockerPending(busy: boolean, running: string | null): boolean;
         blockerActionLabel(action: apiModule.BlockerActionShape, state: apiModule.BlockerLabelState, t: apiModule.BlockerLabelTranslate): string;
         holdBusy(since: number | null, now: number, floorMs: number): apiModule.BusyHold;
+        firstProblemOf(root: ParentNode): Element | null;
+        revealFirstProblem(root: ParentNode): boolean;
         parseCardsReport(payload: unknown): apiModule.PanelParse<apiModule.PanelCardsReport>;
         parseCrashReport(payload: unknown): apiModule.PanelParse<apiModule.PanelCrashReport>;
         createPanelStateStore(): apiModule.PanelStateStore;
@@ -1061,13 +1066,13 @@ export declare const kit: {
         gateOf(capability: apiModule.CapabilityPayload | null, mode: apiModule.GateMode): apiModule.UnitGate;
         splitBlocker(candidates: readonly (apiModule.ModuleBlocker | undefined)[]): apiModule.UnitBlockers;
         probeKeyOf(error: apiModule.ApiError | undefined): string | null;
-        hasEnvSupply(manifest: apiModule.UnitManifest): boolean;
         declarationProblemsOf(subject: string, raw: unknown): readonly string[];
         readDeclaration(subject: string, raw: unknown): apiModule.DeclarationRead;
         WORKBENCH_API_VERSION: 1;
         SUPPORTED_API_VERSIONS: readonly number[];
         DECLARATION_KEYS: readonly string[];
         DECLARATION_REQUIRED_KEYS: readonly string[];
+        hasEnvSupply(manifest: apiModule.UnitManifest): boolean;
         apiGet<T>(route: string, query?: apiModule.Query, options?: apiModule.ApiGetOptions): Promise<apiModule.ApiResponse<T>>;
         apiPost<T>(route: string, body: Record<string, unknown>): Promise<apiModule.ApiResponse<T>>;
         ActivityBlock({ head, children }: apiModule.ActivityBlockProps): JSX.Element;
@@ -1082,6 +1087,10 @@ export declare const kit: {
         CardBoundary: typeof apiModule.CardBoundary;
         CardHead({ t, title, meta, refreshing, onRefresh, gear, gearOpen, onToggleGear, platformHref, platform, platformTitle, }: apiModule.CardHeadProps): JSX.Element;
         ChoiceGroup(props: apiModule.ChoiceGroupProps): JSX.Element;
+        Field({ label, hint, children }: apiModule.FieldProps): JSX.Element;
+        FormRows({ children }: apiModule.FormRowsProps): JSX.Element;
+        FormRow({ label, hint, problem, layout, children }: apiModule.FormRowProps): JSX.Element;
+        Link({ href, children, title, external, className }: apiModule.LinkProps): JSX.Element;
         LongTaskRow(props: apiModule.LongTaskRowProps): JSX.Element;
         Note({ tone, as, role, children }: apiModule.NoteProps): JSX.Element;
         SkeletonRows({ rows }: {
@@ -1096,7 +1105,6 @@ export declare const kit: {
         Rows({ children }: apiModule.RowsProps): JSX.Element;
         Row({ label, value }: apiModule.RowProps): JSX.Element;
         SaveBar({ busy, disabled, labels, onCancel, onSave }: apiModule.SaveBarProps): JSX.Element;
-        SettingsSection({ label, title, action, children }: apiModule.SettingsSectionProps): JSX.Element;
         searchTextOf(option: apiModule.SelectFieldOption): string;
         defaultSelectFilter(option: apiModule.SelectFieldOption, query: string): boolean;
         filterSelectOptions(options: readonly apiModule.SelectFieldOption[], query: string, filter?: (option: apiModule.SelectFieldOption, query: string) => boolean): readonly apiModule.SelectFieldOption[];
@@ -1104,11 +1112,11 @@ export declare const kit: {
         stepSelectCursor(shown: readonly apiModule.SelectFieldOption[], cursor: number | null, step: 1 | -1): number | null;
         selectEntries(shown: readonly apiModule.SelectFieldOption[], emptyText: string | undefined): readonly import("@deepseek-ai/dsh-client-ui-primitives").MenuEntry[];
         SelectField(props: apiModule.SelectFieldProps): apiModule.ReactNode;
+        SettingsSection({ label, title, action, children }: apiModule.SettingsSectionProps): JSX.Element;
+        Spinner({ size, label }: apiModule.SpinnerProps): JSX.Element;
         Stack({ children }: apiModule.StackProps): JSX.Element;
         StateBlock({ title, dot, hint, actions, resolving, children }: apiModule.StateBlockProps): JSX.Element;
         TextField({ invalid, className, ...rest }: apiModule.TextFieldProps): JSX.Element;
-        Field({ label, hint, children }: apiModule.FieldProps): JSX.Element;
-        Link({ href, children, title, external, className }: apiModule.LinkProps): JSX.Element;
         IconConversation({ size }: apiModule.IconProps): JSX.Element;
         IconBrandMark({ size }: apiModule.IconProps): JSX.Element;
         IconOpencli({ size }: apiModule.IconProps): JSX.Element;
@@ -1962,6 +1970,8 @@ export declare const kit: {
         blockerPending(busy: boolean, running: string | null): boolean;
         blockerActionLabel(action: apiModule.BlockerActionShape, state: apiModule.BlockerLabelState, t: apiModule.BlockerLabelTranslate): string;
         holdBusy(since: number | null, now: number, floorMs: number): apiModule.BusyHold;
+        firstProblemOf(root: ParentNode): Element | null;
+        revealFirstProblem(root: ParentNode): boolean;
         parseCardsReport(payload: unknown): apiModule.PanelParse<apiModule.PanelCardsReport>;
         parseCrashReport(payload: unknown): apiModule.PanelParse<apiModule.PanelCrashReport>;
         createPanelStateStore(): apiModule.PanelStateStore;
@@ -2029,13 +2039,13 @@ export declare const kit: {
         gateOf(capability: apiModule.CapabilityPayload | null, mode: apiModule.GateMode): apiModule.UnitGate;
         splitBlocker(candidates: readonly (apiModule.ModuleBlocker | undefined)[]): apiModule.UnitBlockers;
         probeKeyOf(error: apiModule.ApiError | undefined): string | null;
-        hasEnvSupply(manifest: apiModule.UnitManifest): boolean;
         declarationProblemsOf(subject: string, raw: unknown): readonly string[];
         readDeclaration(subject: string, raw: unknown): apiModule.DeclarationRead;
         WORKBENCH_API_VERSION: 1;
         SUPPORTED_API_VERSIONS: readonly number[];
         DECLARATION_KEYS: readonly string[];
         DECLARATION_REQUIRED_KEYS: readonly string[];
+        hasEnvSupply(manifest: apiModule.UnitManifest): boolean;
         apiGet<T>(route: string, query?: apiModule.Query, options?: apiModule.ApiGetOptions): Promise<apiModule.ApiResponse<T>>;
         apiPost<T>(route: string, body: Record<string, unknown>): Promise<apiModule.ApiResponse<T>>;
         ActivityBlock({ head, children }: apiModule.ActivityBlockProps): JSX.Element;
@@ -2050,6 +2060,10 @@ export declare const kit: {
         CardBoundary: typeof apiModule.CardBoundary;
         CardHead({ t, title, meta, refreshing, onRefresh, gear, gearOpen, onToggleGear, platformHref, platform, platformTitle, }: apiModule.CardHeadProps): JSX.Element;
         ChoiceGroup(props: apiModule.ChoiceGroupProps): JSX.Element;
+        Field({ label, hint, children }: apiModule.FieldProps): JSX.Element;
+        FormRows({ children }: apiModule.FormRowsProps): JSX.Element;
+        FormRow({ label, hint, problem, layout, children }: apiModule.FormRowProps): JSX.Element;
+        Link({ href, children, title, external, className }: apiModule.LinkProps): JSX.Element;
         LongTaskRow(props: apiModule.LongTaskRowProps): JSX.Element;
         Note({ tone, as, role, children }: apiModule.NoteProps): JSX.Element;
         SkeletonRows({ rows }: {
@@ -2064,7 +2078,6 @@ export declare const kit: {
         Rows({ children }: apiModule.RowsProps): JSX.Element;
         Row({ label, value }: apiModule.RowProps): JSX.Element;
         SaveBar({ busy, disabled, labels, onCancel, onSave }: apiModule.SaveBarProps): JSX.Element;
-        SettingsSection({ label, title, action, children }: apiModule.SettingsSectionProps): JSX.Element;
         searchTextOf(option: apiModule.SelectFieldOption): string;
         defaultSelectFilter(option: apiModule.SelectFieldOption, query: string): boolean;
         filterSelectOptions(options: readonly apiModule.SelectFieldOption[], query: string, filter?: (option: apiModule.SelectFieldOption, query: string) => boolean): readonly apiModule.SelectFieldOption[];
@@ -2072,11 +2085,11 @@ export declare const kit: {
         stepSelectCursor(shown: readonly apiModule.SelectFieldOption[], cursor: number | null, step: 1 | -1): number | null;
         selectEntries(shown: readonly apiModule.SelectFieldOption[], emptyText: string | undefined): readonly import("@deepseek-ai/dsh-client-ui-primitives").MenuEntry[];
         SelectField(props: apiModule.SelectFieldProps): apiModule.ReactNode;
+        SettingsSection({ label, title, action, children }: apiModule.SettingsSectionProps): JSX.Element;
+        Spinner({ size, label }: apiModule.SpinnerProps): JSX.Element;
         Stack({ children }: apiModule.StackProps): JSX.Element;
         StateBlock({ title, dot, hint, actions, resolving, children }: apiModule.StateBlockProps): JSX.Element;
         TextField({ invalid, className, ...rest }: apiModule.TextFieldProps): JSX.Element;
-        Field({ label, hint, children }: apiModule.FieldProps): JSX.Element;
-        Link({ href, children, title, external, className }: apiModule.LinkProps): JSX.Element;
         IconConversation({ size }: apiModule.IconProps): JSX.Element;
         IconBrandMark({ size }: apiModule.IconProps): JSX.Element;
         IconOpencli({ size }: apiModule.IconProps): JSX.Element;
@@ -2930,6 +2943,8 @@ export declare const kit: {
         blockerPending(busy: boolean, running: string | null): boolean;
         blockerActionLabel(action: apiModule.BlockerActionShape, state: apiModule.BlockerLabelState, t: apiModule.BlockerLabelTranslate): string;
         holdBusy(since: number | null, now: number, floorMs: number): apiModule.BusyHold;
+        firstProblemOf(root: ParentNode): Element | null;
+        revealFirstProblem(root: ParentNode): boolean;
         parseCardsReport(payload: unknown): apiModule.PanelParse<apiModule.PanelCardsReport>;
         parseCrashReport(payload: unknown): apiModule.PanelParse<apiModule.PanelCrashReport>;
         createPanelStateStore(): apiModule.PanelStateStore;

package/dist/types/app/layouts/__tests__/kit-preview-nav.test.d.ts

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

package/dist/types/app/layouts/rightbar/kit-preview-frame.d.ts

@@ -1,4 +1,8 @@
 import type { ReactNode } from '@dsh-workbench/shared';
+export declare function KitNavProvider({ children }: {
+    readonly children?: ReactNode;
+}): JSX.Element;
+export declare function KitNav(): JSX.Element | null;
 export declare function Section({ title, note, children, }: {
     readonly title: string;
     readonly note?: string;

package/dist/types/app/layouts/rightbar/kit-preview-hash.d.ts

@@ -0,0 +1 @@
+export declare function hashTargetsSection(anchor: string, hash: string): boolean;

package/dist/types/app/layouts/rightbar/kit-preview-rows.d.ts

@@ -1,4 +1,5 @@
 export declare function RowsSection(): JSX.Element;
+export declare function FormSection(): JSX.Element;
 export declare function ActivitySection(): JSX.Element;
 export declare function LongTaskSection(): JSX.Element;
 export declare function IconSection(): JSX.Element;

package/package.json

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

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

@@ -82,7 +82,7 @@ h(Field, { label: t('myunit.mode'), hint: t('myunit.modeHint') },
 ```
 
 **`TextField`** —— 单行输入（`invalid` 标红；其余是原生 input 的 props）。
-**`ChoiceGroup`** —— 单选 / 多选（`multi` 区分；`value` 或 `values` + `onChange`；选项 `{ value, label, hint?, disabled? }`）。
+**`ChoiceGroup`** —— 单选 / 多选（`multi` 区分；`value` 或 `values` + `onChange`；选项 `{ value, label, description? }`；`disabled` 在整组上）。
 **`SelectField`** —— 下拉：默认是**常规下拉框**（跟 `TextField` 一套），无边框那种给 `variant: 'ghost'`；
 搜索、分组、禁用项、加载态、空态、页脚都是它的 prop。
 **`SaveBar`** —— 设置面底下那条"取消 / 保存"（`busy` / `disabled` / `labels` / `onCancel` / `onSave`）。
@@ -91,7 +91,57 @@ h(Field, { label: t('myunit.mode'), hint: t('myunit.modeHint') },
 kit 有上面这几件；手写的会拿到浏览器默认样式，而且**判据会红**（`check:style`）。
 `<textarea>` 例外（dsh 与 kit 都没有多行输入）——真要用就直接写，其余形态别开这个口子。
 
-## 5 别的
+控件怎么排成一行（标签位置、错误态、尺寸）见 §5。
+
+## 5 表单这一层：面 → 行 → 控件
+
+表单三层：**面**（`SettingsSection` / `SaveBar`）→ **行**（`FormRows` + `FormRow`）→
+**控件**（`TextField` / `SelectField` / `ChoiceGroup`）。**一行一个字段**，行这一层只有一个出处。
+
+```tsx
+h(FormRows, null,
+  h(FormRow, { label: t('myunit.mode'), hint: t('myunit.modeHint') },
+    h(SelectField, { value, options, onChange: setMode })),
+  h(FormRow, { label: t('myunit.env'), problem: problemOfEnv },
+    h(ChoiceGroup, { label: t('myunit.env'), name: 'env', options, value: env, onChange: setEnv })))
+```
+
+- **标签归 `FormRow`**（`label`）：默认标签在左，`layout: 'stacked'` 才是上下堆叠（等于原来的 `Field`）。
+  **控件只给数据与语义 prop**，不写外观类名（§7 第 1 条）。进了 `FormRow` 就别再给控件自己的
+  `label` / `hint`（`SelectField` 那两件是没 `FormRow` 时的兜底，重复给会多一个标签、还退回上下堆叠）。
+- **`hint` 与 `problem` 二选一**：给了 `problem` 就不画 `hint` —— 同一格不叠两段话，有错先显示错。
+
+**错误态**：位置与长相由 `FormRow.problem` + 控件的 `invalid` 定（`SelectField` / `TextField` 同形，
+`ChoiceGroup` 见它自己的档）。**校验逻辑留在模块**：只写"算错误"的纯函数与文案
+（例：cmdb 的 `CmdbFormProblem` 那类），**别指望外壳给校验引擎**（不做 `rules` / `validate`、
+不做联动、不持有值）。提交失败后调 `kit.lib.revealFirstProblem(root)`（`root` = 表单容器）——
+把第一处错误带进视口、并聚焦它里面的控件。
+
+**选择类用哪件**：候选多 / 要搜索 / 要分组 / 名单可能读不到 ⇒ `SelectField`（`search` 默认开、
+`emptyText`、`loading` + `loadingText`、`fallback`、`variant: 'boxed' | 'ghost'`）；
+候选少、要一眼看全 / 多选 ⇒ `ChoiceGroup`（`multi`、`variant`、`loading` + `loadingText`、
+`emptyText`、`options[].description`）。两件的 `loading` / `loadingText` / `emptyText` / `variant`
+是一个意思；**loading 那颗一律是 `Spinner`**（`h(Spinner, { size: 14 })`）—— **别自己写转圈**。
+
+**尺寸口径**：字段控件默认 **28**（dsh 紧凑档），**别自己调高**；行距**只有一档**、归 `FormRow(s)`，
+模块里不该出现管行距的 `gap` / `margin`（横向的、卡片/清单网格的不算）。
+
+**反例（别这么写）**：
+
+```tsx
+h('span', { className: styles.label }, t('myunit.mode'))   // ← 紧邻控件的手写标签行：check:style 红
+h('div', { className: styles.form }, …)                    // ← .form { gap: 8px }：自己管行距也红
+```
+
+`<span className={styles.label}>` 紧邻控件、或给表单容器自己写 `gap` —— 这正是 `check:style` 那条
+棘轮（F1 手写行 / F2 自己管行距）盯的东西；`FORM_ROW_EXEMPT` 是**等外壳发版后要清空的历史账**
+（"迁一处删一行"），**不是"可以继续这么写"的许可**。
+
+**时点**：这一层随外壳**发版**后模块才能用 —— 模块的 `peerDependencies` 下限得先有它
+（`check:kit` 拿 peer 下限那份外壳比，不抬必红）；迁移步骤见
+[ADR-0052](../../../../docs/adr/0052-the-form-row-is-one-component.md) §10。
+
+## 6 别的
 
 - **`Link`** —— **唯一**的外链写法：`h(Link, { href, children })`。自带新窗口 + `rel="noopener noreferrer"`
   + 正文色 + hover 下划线 + 那颗小箭头。**别去掉箭头、别在文案里自带 `→`、别手写 `<a>`**（判据红）。
@@ -103,7 +153,7 @@ kit 有上面这几件；手写的会拿到浏览器默认样式，而且**判
 - **图标** —— `IconPanelScreen`（面板/卡片那类）、`IconModuleMark`（我们的模块类型标）、
   `IconNpm` / `IconOpencli`（包类型）；其余图形一律从 dsh 的 `Icon*Regular` 拿，**别自己画图标**。
 
-## 6 三条纪律
+## 7 三条纪律
 
 1. **调用点只给数据与语义**：`h(Card, { title, refreshing, onRefresh }, …)`。别从外面塞外观类名
    —— 只有布局槽例外（通栏、外边距、网格位置）。
@@ -114,7 +164,7 @@ kit 有上面这几件；手写的会拿到浏览器默认样式，而且**判
 3. **自己写 CSS 只写布局**（flex / grid / gap / 对齐）。要一个新的"长得像控件"的东西时，
    先问一句：kit 里是不是已经有了？
 
-## 7 kit 里没有、但你确定要标准控件
+## 8 kit 里没有、但你确定要标准控件
 
 见 [PANEL.md](PANEL.md) §9：可以引 dsh 的客户端原语，但**只在浏览器侧**、并在
 `package.json` 的 `dsh.client.external` 里声明 `@deepseek-ai/dsh-client-ui-primitives`

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

@@ -15,7 +15,7 @@
 | `standalone` | "只有工作台源码在场才编得过" ⇒ 发布出去就散架 | `build 在外壳源码不在场时失败` / `typecheck 在外壳源码不在场时失败` | 别引用工作台源码；`tsconfig` 里 `paths` 的值必须是**相对路径**（`"./src/*"`，不是 `"src/*"`） |
 | `markers` | 内网域名 / 企业内部名泄进要公开发布的包 | `命中内网 npm 源` / `命中内网域名` | 那些值不该写进包里；要配就落到模块自己的配置面，或走用户自己声明的来源 |
 | `alias` | `@/` 伸进工作台源码 ⇒ 装的人手上没有那份源码 | `…指向外壳源码` | `@/` 只许指自己的 `src/`；跨包的东西走包名 |
-| `style` | 模块定义 `.wb-*` 去覆盖外壳的类（全局类名，两份规则按注入顺序打架） | `定义了外壳前缀 wb-* 的 CSS 规则` / `借用了契约里没有的类` | 自己的样式走 `*.module.css`（类名**不带** `wb-` 前缀，构建时按文件路径哈希）；外壳给的类只能用契约里列出的那些，要借就写 `:global(.wb-…)` |
+| `style` | 模块定义 `.wb-*` 去覆盖外壳的类（全局类名，两份规则按注入顺序打架） | `定义了外壳前缀 wb-* 的 CSS 规则` / `借用了契约里没有的类` | 自己的样式走 `*.module.css`（类名**不带** `wb-` 前缀，构建时按文件路径哈希）；外壳给的类只能用契约里列出的那些，要借就写 `:global(.wb-…)`；被 `样式归属` 判红的手写「标签+控件」行或模块自己管的行距 ⇒ 改用 `FormRow(s)`（[KIT.md](KIT.md) §5） |
 
 ## 什么时候该怀疑门禁本身