@dsh-workbench/shared 0.2.14 → 0.2.16

package/dist/lib/diy-debug.d.ts

@@ -0,0 +1,39 @@
+export type DebugPhase = 'debugging' | 'paused';
+export type DebugIntent = 'pause' | 'resume' | 'stop';
+export declare function parseDebugIntent(value: unknown): DebugIntent | null;
+export declare const DEBUG_STALE_MS: number;
+export interface DebugState {
+    readonly phase: DebugPhase;
+    readonly sessionId: string;
+    readonly workspace: string;
+    readonly board: string;
+    readonly unit: string;
+    readonly name: string;
+    readonly startedAt: number;
+    readonly at: number;
+}
+export interface DebugPact {
+    readonly sessionId: string;
+    readonly workspace: string;
+    readonly board: string;
+    readonly unit: string;
+    readonly name: string;
+    readonly now: number;
+}
+export type DebugRefusal = 'already-held' | 'held-by-other' | 'not-owner' | 'none' | 'already-paused' | 'already-debugging';
+export type DebugMove = {
+    readonly ok: true;
+    readonly state: DebugState;
+} | {
+    readonly ok: false;
+    readonly code: DebugRefusal;
+};
+export interface DebugStore {
+    live(now: number): DebugState | null;
+    begin(pact: DebugPact): DebugMove;
+    pause(sessionId: string, now: number): DebugMove;
+    resume(sessionId: string, now: number): DebugMove;
+    stop(sessionId: string, now: number): DebugMove;
+}
+export declare function createDebugStore(): DebugStore;
+export declare function debugOwnerText(state: DebugState): string;

package/dist/lib/diy-debug.js

@@ -0,0 +1,70 @@
+export function parseDebugIntent(value) {
+    return value === 'pause' || value === 'resume' || value === 'stop' ? value : null;
+}
+export const DEBUG_STALE_MS = 4 * 60 * 60 * 1000;
+function alive(state, now) {
+    if (state === null)
+        return null;
+    return now - state.at <= DEBUG_STALE_MS ? state : null;
+}
+function ownerOf(state, sessionId, now) {
+    const held = alive(state, now);
+    if (held === null)
+        return 'none';
+    return held.sessionId === sessionId ? held : 'not-owner';
+}
+export function createDebugStore() {
+    let held = null;
+    const live = (now) => alive(held, now);
+    return {
+        live,
+        begin(pact) {
+            const current = alive(held, pact.now);
+            if (current !== null) {
+                return { ok: false, code: current.sessionId === pact.sessionId ? 'already-held' : 'held-by-other' };
+            }
+            const state = {
+                phase: 'debugging',
+                sessionId: pact.sessionId,
+                workspace: pact.workspace,
+                board: pact.board,
+                unit: pact.unit,
+                name: pact.name,
+                startedAt: pact.now,
+                at: pact.now,
+            };
+            held = state;
+            return { ok: true, state };
+        },
+        pause(sessionId, now) {
+            const found = ownerOf(held, sessionId, now);
+            if (typeof found === 'string')
+                return { ok: false, code: found };
+            if (found.phase === 'paused')
+                return { ok: false, code: 'already-paused' };
+            const state = { ...found, phase: 'paused', at: now };
+            held = state;
+            return { ok: true, state };
+        },
+        resume(sessionId, now) {
+            const found = ownerOf(held, sessionId, now);
+            if (typeof found === 'string')
+                return { ok: false, code: found };
+            if (found.phase === 'debugging')
+                return { ok: false, code: 'already-debugging' };
+            const state = { ...found, phase: 'debugging', at: now };
+            held = state;
+            return { ok: true, state };
+        },
+        stop(sessionId, now) {
+            const found = ownerOf(held, sessionId, now);
+            if (typeof found === 'string')
+                return { ok: false, code: found };
+            held = null;
+            return { ok: true, state: found };
+        },
+    };
+}
+export function debugOwnerText(state) {
+    return `会话 ${state.sessionId}（自 ${new Date(state.startedAt).toISOString().slice(11, 19)}Z 起在调试 ${state.unit}）`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-workbench/shared",
-  "version": "0.2.14",
+  "version": "0.2.16",
   "description": "工作台与模块共享的纯代码与契约类型：类型、纯逻辑、哑组件、平台解析。宿主侧的东西从 /host 进（不影响浏览器产物）。",
   "license": "MIT",
   "type": "module",

package/src/api/dsh.ts

@@ -151,7 +151,12 @@ export interface DshToolDefinition {
 export interface DshToolRunContext {
   readonly agent?:
     | {
-        readonly session?: { readonly header?: { readonly cwd?: string } | undefined } | undefined;
+        readonly session?:
+          | {
+              readonly id?: string;
+              readonly header?: { readonly cwd?: string } | undefined;
+            }
+          | undefined;
       }
     | undefined;
 }

package/src/api/host-write.ts

@@ -1,6 +1,10 @@
 import type { ApiResponse } from './workbench-client.js';
 
-export type WriteChannel = 'prefs' | 'actions' | 'provision';
+export type WriteChannel =
+  | 'prefs'
+  | 'actions'
+  | 'provision'
+  | 'diy-debug';
 
 export function writeRoute(channel: WriteChannel, resource: string): string {
   if (channel === 'provision') return 'provision';

package/src/components/FormRows.css

@@ -18,10 +18,6 @@
   row-gap: var(--wb-len-8);
 }
 
-.wb-formRows > .wb-formRow {
-  grid-template-columns: subgrid;
-}
-
 .wb-formRow[data-layout='stacked'] {
   grid-template-columns: minmax(0, 1fr);
   align-items: stretch;
@@ -67,3 +63,13 @@
 .wb-formRow:has(:disabled) .wb-formLabel {
   opacity: 0.4;
 }
+
+.wb-formRows > .wb-formRow {
+  grid-template-columns: subgrid;
+}
+
+@supports not (grid-template-columns: subgrid) {
+  .wb-formRows > .wb-formRow {
+    grid-template-columns: minmax(72px, max-content) minmax(0, 1fr);
+  }
+}

package/src/components/Rows.css

@@ -1,14 +1,10 @@
-
-.wb-row:has(> [data-wb-dot]) {
-  grid-template-columns: 84px minmax(0, 1fr);
-}
 .wb-rows {
   display: flex;
   flex-direction: column;
 }
 .wb-row {
   display: grid;
-  grid-template-columns: 56px minmax(0, 1fr);
+  grid-template-columns: minmax(72px, max-content) minmax(0, 1fr);
   align-items: baseline;
   gap: var(--wb-len-8);
   padding: var(--wb-len-4) 0;
@@ -17,6 +13,7 @@
   border-top: 0.5px solid var(--dsw-alias-border-l2);
 }
 .wb-rowKey {
+  white-space: nowrap;
   font-size: var(--dsw-font-xxxs-11-font-size);
   line-height: var(--wb-line-16);
   color: var(--dsw-alias-label-tertiary);
@@ -28,3 +25,13 @@
   color: var(--dsw-alias-label-primary);
   overflow-wrap: anywhere;
 }
+
+.wb-rows > .wb-row {
+  grid-template-columns: subgrid;
+}
+
+@supports not (grid-template-columns: subgrid) {
+  .wb-rows > .wb-row {
+    grid-template-columns: minmax(72px, max-content) minmax(0, 1fr);
+  }
+}

package/src/components/SelectField.css

@@ -61,6 +61,26 @@
   box-shadow: none;
 }
 
+.wb-selectIconOnly {
+  width: var(--wb-len-36);
+  height: var(--wb-len-36);
+  min-height: 0;
+  gap: 0;
+  padding: 0;
+  justify-content: center;
+}
+
+.wb-selectReveal {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+}
+
+.wb-selectIconOnly .wb-selectIcon {
+  width: 100%;
+  height: 100%;
+}
+
 .wb-selectAnchor {
   display: block;
   width: 100%;

package/src/components/SelectField.test.tsx

@@ -2,6 +2,7 @@ import { describe, expect, it, vi } from 'vitest';
 
 let states: unknown[] = [];
 vi.mock('../lib/react.js', () => ({
+  Fragment: Symbol.for('react.fragment'),
   h: (type: unknown, props: unknown, ...children: unknown[]) => ({ type, props, children }),
   useEffect: () => {},
   useMemo: (compute: () => unknown) => compute(),
@@ -53,6 +54,10 @@ function elementsOf(root: unknown): readonly AnyElement[] {
   return collect(root);
 }
 
+function marked(nodes: readonly AnyElement[]): boolean {
+  return nodes.some((one) => one.props?.['data-wb-select-reveal'] === '');
+}
+
 function menuOf(root: unknown): AnyElement {
   const menu = elementsOf(root).find((one) => one.type === Menu);
   if (menu === undefined) throw new Error('没有渲染出 Menu');
@@ -113,6 +118,38 @@ describe('SelectField：工作区那套下拉的公共形状', () => {
     expect(inputOf(menu.props['anchor'])?.props['value']).toBe('');
   });
 
+  it('★ 只显示图标那一档（折叠左栏那个工作区钮）：没有值也没有箭头，读屏名字只能来自 ariaLabel', () => {
+    const icon = { type: 'i', props: {}, children: [] };
+    const trigger = elementsOf(
+      menuOf(render({ variant: 'ghost', iconOnly: true, icon, ariaLabel: '切换项目' })).props['anchor'],
+    ).find((one) => one.type === 'button');
+
+    expect(trigger?.props['className']).toBe('wb-selectTrigger wb-selectGhost wb-selectIconOnly');
+    expect(trigger?.props['aria-label']).toBe('切换项目');
+    expect(JSON.stringify(trigger?.children)).not.toContain('wb-selectValue');
+    expect(JSON.stringify(trigger?.children)).not.toContain('wb-selectChevron');
+    expect(elementsOf(trigger?.children).some((one) => one.props['className'] === 'wb-selectIcon')).toBe(true);
+  });
+
+  it('不给 iconOnly 时一个字节都不变（宽态那套触发器照旧）', () => {
+    const trigger = elementsOf(menuOf(render({ variant: 'ghost' })).props['anchor']).find(
+      (one) => one.type === 'button',
+    );
+
+    expect(trigger?.props['className']).toBe('wb-selectTrigger wb-selectGhost');
+    expect(JSON.stringify(trigger?.children)).toContain('wb-selectValue');
+  });
+
+  it('★ search=false：锚点仍是触发钮（折叠左栏那个下拉要的就是"点开直接是列表"）', () => {
+    const root = render({ search: false });
+    const anchor = elementsOf(menuOf(root).props['anchor']);
+
+    expect(anchor.some((one) => one.type === 'button')).toBe(true);
+    const classes = anchor.map((one) => one.props?.['className']).filter((one) => typeof one === 'string');
+    expect(classes).not.toContain('wb-selectSearch');
+    expect(inputOf(menuOf(root).props['anchor'])).toBeUndefined();
+  });
+
   it('禁用：触发钮真的 disabled（压暗交给样式，别只在视觉上假装）', () => {
     const root = render({ disabled: true });
     const trigger = elementsOf(menuOf(root).props['anchor']).find((one) => one.type === 'button');
@@ -239,6 +276,32 @@ describe('SelectField：工作区那套下拉的公共形状', () => {
     expect(defaultSelectFilter(option, 'nope')).toBe(false);
   });
 
+  it('★ revealId：只给那一行的图标裹上标记（开列表时靠它滚进可视区），别行一个字节不变', () => {
+    const items = selectEntries(
+      [
+        { value: 'a', label: '甲', icon: <span>甲</span> },
+        { value: 'b', label: '乙', icon: <span>乙</span> },
+      ],
+      undefined,
+      'b',
+    );
+    const iconOf = (id: string): unknown =>
+      (items.find((one) => (one as { id?: string }).id === id) as { icon?: unknown } | undefined)?.icon;
+
+    expect(marked(elementsOf(iconOf('a')))).toBe(false);
+    expect(marked(elementsOf(iconOf('b')))).toBe(true);
+  });
+
+  it('★ revealId 撞上没有图标的行：退而标记它的文字（标记只落一处）', () => {
+    const items = selectEntries([{ value: 'a', label: '甲' }], undefined, 'a');
+    const row = items.find((one) => (one as { id?: string }).id === 'a') as
+      | { label?: unknown; icon?: unknown }
+      | undefined;
+
+    expect(row?.icon).toBeUndefined();
+    expect(marked(elementsOf(row?.label))).toBe(true);
+  });
+
   it('条目构造：图标与禁用照传，分组标题只在换组时出现一次', () => {
     const items = selectEntries(
       [

package/src/components/SelectField.tsx

@@ -1,15 +1,10 @@
 import type { KeyboardEvent as ReactKeyboardEvent, ReactNode, RefObject } from 'react';
 import type { MenuEntry, MenuItem } from '@deepseek-ai/dsh-client-ui-primitives';
 import { h, useEffect, useMemo, useRef, useState } from '../lib/react.js';
-import {
-  IconChevronDownOutlineRegular,
-  IconSearchOutlineRegular,
-  Menu,
-  TextShimmer,
-} from '@deepseek-ai/dsh-client-ui-primitives';
+import { IconSearchOutlineRegular, Menu } from '@deepseek-ai/dsh-client-ui-primitives';
+import { selectLoadingNode, selectTriggerNode } from './SelectFieldNodes.js';
 import { Field } from './Field.js';
 import { TextField } from './TextField.js';
-import { Spinner } from './Spinner.js';
 import './SelectField.css';
 
 export interface SelectFieldOption {
@@ -56,6 +51,8 @@ export interface SelectFieldProps {
   readonly onFooter?: (() => void) | undefined;
   readonly selection?: 'check' | 'fill' | undefined;
   readonly variant?: 'ghost' | 'boxed' | undefined;
+  readonly iconOnly?: boolean | undefined;
+  readonly revealId?: string | undefined;
   readonly ariaLabel?: string | undefined;
   readonly title?: string | undefined;
   readonly id?: string | undefined;
@@ -71,75 +68,54 @@ function mergeClass(...parts: readonly (string | undefined)[]): string {
   return parts.filter((one) => one !== undefined && one !== '').join(' ');
 }
 
-function itemOf(option: SelectFieldOption): MenuItem {
+function triggerClassOf(variantClass: string | undefined, iconOnly: boolean): string {
+  return mergeClass('wb-selectTrigger', variantClass, iconOnly ? 'wb-selectIconOnly' : undefined);
+}
+
+function itemOf(option: SelectFieldOption, revealId: string | undefined): MenuItem {
+  const mark = option.value === revealId;
+  if (!mark) {
+    return {
+      id: option.value,
+      label: option.label,
+      ...(option.icon === undefined ? {} : { icon: option.icon }),
+      ...(option.disabled === true ? { disabled: true } : {}),
+    };
+  }
+  const revealed = (node: ReactNode): ReactNode => (
+    <span className="wb-selectReveal" data-wb-select-reveal="">
+      {node}
+    </span>
+  );
   return {
     id: option.value,
-    label: option.label,
-    ...(option.icon === undefined ? {} : { icon: option.icon }),
+    label: option.icon === undefined ? revealed(option.label) : option.label,
+    ...(option.icon === undefined ? {} : { icon: revealed(option.icon) }),
     ...(option.disabled === true ? { disabled: true } : {}),
   };
 }
 
-function triggerNode(args: {
-  readonly id: string | undefined;
-  readonly className: string;
-  readonly disabled: boolean;
-  readonly invalid: boolean;
-  readonly open: boolean;
-  readonly ariaLabel: string | undefined;
-  readonly title: string | undefined;
-  readonly icon: ReactNode | undefined;
-  readonly value: ReactNode;
-  readonly onOpen: () => void;
-}): ReactNode {
-  return (
-    <button
-      type="button"
-      id={args.id}
-      className={args.className}
-      disabled={args.disabled}
-      aria-haspopup="listbox"
-      aria-expanded={args.open}
-      aria-invalid={args.invalid || undefined}
-      aria-label={args.ariaLabel}
-      title={args.title}
-      onClick={args.onOpen}
-    >
-      {args.icon === undefined ? null : <span className="wb-selectIcon">{args.icon}</span>}
-      <span className="wb-selectValue">{args.value}</span>
-      <span className="wb-selectChevron">
-        <IconChevronDownOutlineRegular size={14} />
-      </span>
-    </button>
-  );
+function revealNode(): HTMLElement | null {
+  const found = document.querySelector('[data-wb-select-reveal]');
+  return found instanceof HTMLElement ? found : null;
 }
 
-function loadingNode(args: {
-  readonly id: string | undefined;
-  readonly className: string;
-  readonly invalid: boolean;
-  readonly ariaLabel: string | undefined;
-  readonly loadingText: string | undefined;
-}): ReactNode {
-  return (
-    <button
-      type="button"
-      id={args.id}
-      className={`${args.className} wb-selectLoading`}
-      disabled
-      aria-busy="true"
-      aria-invalid={args.invalid || undefined}
-      aria-label={args.ariaLabel}
-      title={args.loadingText}
-    >
-      <span className="wb-selectValue">
-        <TextShimmer active>{args.loadingText ?? '…'}</TextShimmer>
-      </span>
-      <span className="wb-selectChevron">
-        <Spinner size={14} />
-      </span>
-    </button>
-  );
+function useRevealOnOpen(open: boolean, revealId: string | undefined): void {
+  useEffect(() => {
+    if (!open || revealId === undefined) return;
+    revealNode()?.scrollIntoView({ block: 'nearest' });
+  }, [open, revealId]);
+}
+
+function selectValueNode(
+  current: SelectFieldOption | undefined,
+  renderValue: SelectFieldProps['renderValue'],
+  placeholder: ReactNode,
+): ReactNode {
+  if (current === undefined) {
+    return <span className="wb-selectPlaceholder">{placeholder ?? '—'}</span>;
+  }
+  return renderValue === undefined ? current.label : renderValue(current);
 }
 
 function searchNode(args: {
@@ -269,6 +245,7 @@ export function stepSelectCursor(
 export function selectEntries(
   shown: readonly SelectFieldOption[],
   emptyText: string | undefined,
+  revealId?: string | undefined,
 ): readonly MenuEntry[] {
   if (shown.length === 0) {
     return emptyText === undefined ? [] : [{ type: 'label', id: EMPTY_ID, text: emptyText }];
@@ -280,7 +257,7 @@ export function selectEntries(
       out.push({ type: 'label', id: `__wb-select-group-${String(out.length)}`, text: option.group });
       group = option.group;
     }
-    out.push(itemOf(option));
+    out.push(itemOf(option, revealId));
   }
   return out;
 }
@@ -368,6 +345,8 @@ export function SelectField(props: SelectFieldProps) {
     fallback,
     selection = 'fill',
     variant = 'boxed',
+    iconOnly = false,
+    revealId,
     ariaLabel,
     title,
     id,
@@ -377,15 +356,17 @@ export function SelectField(props: SelectFieldProps) {
   } = props;
   const state = useSelectState(props);
   const current = options.find((option) => option.value === value);
+
+  useRevealOnOpen(state.open, revealId);
   const variantClass = variant === 'ghost' ? 'wb-selectGhost' : undefined;
-  const triggerClass = mergeClass('wb-selectTrigger', variantClass);
+  const triggerClass = triggerClassOf(variantClass, iconOnly);
 
   if (loading) {
     return framed(
       label,
       hint,
       className,
-      loadingNode({ id, className: triggerClass, invalid, ariaLabel, loadingText }),
+      selectLoadingNode({ id, className: triggerClass, invalid, ariaLabel, loadingText }),
     );
   }
 
@@ -406,7 +387,7 @@ export function SelectField(props: SelectFieldProps) {
     );
   }
 
-  const trigger = triggerNode({
+  const trigger = selectTriggerNode({
     id,
     className: triggerClass,
     disabled,
@@ -415,14 +396,8 @@ export function SelectField(props: SelectFieldProps) {
     ariaLabel,
     title,
     icon,
-    value:
-      current === undefined ? (
-        <span className="wb-selectPlaceholder">{placeholder ?? '—'}</span>
-      ) : renderValue === undefined ? (
-        current.label
-      ) : (
-        renderValue(current)
-      ),
+    value: selectValueNode(current, renderValue, placeholder),
+    iconOnly,
     onOpen: () => state.setOpen(true),
   });
 
@@ -469,7 +444,7 @@ export function SelectField(props: SelectFieldProps) {
       anchor,
       selection,
       selectedId: selectCursorValue(state.shown, state.cursor) ?? undefined,
-      items: selectEntries(state.shown, state.empty),
+      items: selectEntries(state.shown, state.empty, revealId),
       footer:
         footer === undefined
           ? undefined

package/src/components/SelectFieldNodes.tsx

@@ -0,0 +1,77 @@
+import type { ReactNode } from 'react';
+import { Fragment, h } from '../lib/react.js';
+import {
+  IconChevronDownOutlineRegular,
+  TextShimmer,
+} from '@deepseek-ai/dsh-client-ui-primitives';
+import { Spinner } from './Spinner.js';
+
+export function selectTriggerNode(args: {
+  readonly id: string | undefined;
+  readonly className: string;
+  readonly disabled: boolean;
+  readonly invalid: boolean;
+  readonly open: boolean;
+  readonly ariaLabel: string | undefined;
+  readonly title: string | undefined;
+  readonly icon: ReactNode | undefined;
+  readonly value: ReactNode;
+  readonly iconOnly: boolean;
+  readonly onOpen: () => void;
+}): ReactNode {
+  return (
+    <button
+      type="button"
+      id={args.id}
+      className={args.className}
+      disabled={args.disabled}
+      aria-haspopup="listbox"
+      aria-expanded={args.open}
+      aria-invalid={args.invalid || undefined}
+      aria-label={args.ariaLabel}
+      title={args.title}
+      onClick={args.onOpen}
+    >
+      {args.iconOnly ? (
+        <span className="wb-selectIcon">{args.icon}</span>
+      ) : (
+        <Fragment>
+          {args.icon === undefined ? null : <span className="wb-selectIcon">{args.icon}</span>}
+          <span className="wb-selectValue">{args.value}</span>
+          <span className="wb-selectChevron">
+            <IconChevronDownOutlineRegular size={14} />
+          </span>
+        </Fragment>
+      )}
+    </button>
+  );
+}
+
+export function selectLoadingNode(args: {
+  readonly id: string | undefined;
+  readonly className: string;
+  readonly invalid: boolean;
+  readonly ariaLabel: string | undefined;
+  readonly loadingText: string | undefined;
+}): ReactNode {
+  return (
+    <button
+      type="button"
+      id={args.id}
+      className={`${args.className} wb-selectLoading`}
+      disabled
+      aria-busy="true"
+      aria-invalid={args.invalid || undefined}
+      aria-label={args.ariaLabel}
+      title={args.loadingText}
+    >
+      <span className="wb-selectValue">
+        <TextShimmer active>{args.loadingText ?? '…'}</TextShimmer>
+      </span>
+      <span className="wb-selectChevron">
+        <Spinner size={14} />
+      </span>
+    </button>
+  );
+}
+

package/src/config/constants.ts

@@ -16,6 +16,9 @@ export const PROVISION_PREFIX = `${API_PREFIX}/provision`;
 
 export const PANEL_STATE_PATH = "panel-state";
 
+export const DIY_DEBUG_PATH = "diy-debug";
+export const DIY_DEBUG_ACT_PATH = `${DIY_DEBUG_PATH}/act`;
+
 export const PANEL_STATE_PREFIX = `${API_PREFIX}/${PANEL_STATE_PATH}`;
 
 export const OPENCLI_PIN = "1.8.8";
@@ -28,6 +31,8 @@ export const UNITS_SERVICE = "workbenchUnits";
 
 export const PANEL_STATE_SERVICE = "workbenchPanelState";
 
+export const DIY_DEBUG_SERVICE = "workbenchDiyDebug";
+
 export const PANEL_LIST_LIMIT = 50;
 
 export const OPENCLI_TIMEOUT_MS = 120_000;

package/src/host/http.ts

@@ -1,7 +1,7 @@
 import type { DshHostContext, DshRequest, DshResponse } from '../api/dsh.js';
 import { unitFactScope } from '../api/facts.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 { ACTIONS_PREFIX, API_PREFIX, DIY_DEBUG_PATH, PANEL_STATE_PREFIX, PLUGIN_ID, PREFS_PREFIX, PROVISION_PREFIX } from '../config/constants.js';
 import {
   parseProvisionBody,
   type ProvisionHandler,
@@ -300,8 +300,7 @@ export function registerActions(
   });
 }
 
-export function registerPanelState(ctx: DshHostContext, store: PanelStateStore): () => void {
-  return registerPost(ctx, {
+export function registerPanelState(ctx: DshHostContext, store: PanelStateStore): () => void {  return registerPost(ctx, {
     prefix: PANEL_STATE_PREFIX,
     what: '面板运行态',
     refusedCode: 'report-refused',
@@ -327,3 +326,17 @@ export function registerPanelState(ctx: DshHostContext, store: PanelStateStore):
     ],
   });
 }
+
+export function registerDiyDebugAct(
+  ctx: DshHostContext,
+  resource: PostResource,
+  log?: { bump(facts: readonly string[]): unknown } | undefined,
+): () => void {
+  return registerPost(ctx, {
+    prefix: `${API_PREFIX}/${DIY_DEBUG_PATH}`,
+    what: '工作台 DIY 调试动作',
+    refusedCode: 'action-refused',
+    resources: [resource],
+    wrote: () => log?.bump(['diy-debug']),
+  });
+}