@dsh-workbench/shared 0.3.3 → 0.3.4

package/dist/api/host-write.d.ts

@@ -1,5 +1,5 @@
 import type { ApiResponse } from './workbench-client.js';
-export type WriteChannel = 'prefs' | 'actions' | 'provision' | 'diy-debug';
+export type WriteChannel = 'prefs' | 'actions' | 'provision' | 'diy-debug' | 'diy-record';
 export declare function writeRoute(channel: WriteChannel, resource: string): string;
 export type WriteOutcome<T> = {
     readonly ok: true;

package/dist/components/ApprovalDetail.d.ts

@@ -1,5 +1,6 @@
 import type { Translate } from '../api/dsh-client.js';
-import type { UnitClientFace } from '../components/board-module.js';
+import type { ApprovalInput, UnitClientFace } from '../components/board-module.js';
+import { type ReactNode } from '../lib/react.js';
 import './ApprovalDetail.css';
 interface ToolCallRoot {
     readonly callId?: string;
@@ -23,6 +24,7 @@ export interface ApprovalDetailProps {
     readonly useChat?: UseChat;
     readonly units?: readonly UnitClientFace[];
     readonly t?: Translate;
+    readonly renderShell?: ((input: ApprovalInput, t: Translate) => ReactNode) | undefined;
 }
 export declare function ApprovalDetail(props: ApprovalDetailProps): JSX.Element | null;
 export {};

package/dist/components/ApprovalDetail.js

@@ -1,4 +1,4 @@
-import { h } from '../lib/react.js';
+import { Fragment, h } from '../lib/react.js';
 import { CodeBlock } from '@deepseek-ai/dsh-client-ui-primitives';
 import { CardBoundary } from './CardBoundary.js';
 import './ApprovalDetail.css';
@@ -35,6 +35,9 @@ export function ApprovalDetail(props) {
         return (h(CardBoundary, { unit: owner.unit, resetKey: props.callId ?? '', t: t },
             h(Render, { input: input, t: t })));
     }
+    const shell = props.renderShell?.(input, t);
+    if (shell !== undefined && shell !== null)
+        return h(Fragment, null, shell);
     if (command === '')
         return null;
     return (h(CodeBlock, { code: command, className: "wb-approvalCommand", copyLabel: t('blocker.copy'), copiedLabel: t('env.copied') }));

package/dist/config/constants.d.ts

@@ -8,6 +8,8 @@ export declare const PROVISION_PREFIX = "/workbench/api/provision";
 export declare const PANEL_STATE_PATH = "panel-state";
 export declare const DIY_DEBUG_PATH = "diy-debug";
 export declare const DIY_DEBUG_ACT_PATH = "diy-debug/act";
+export declare const DIY_RECORD_PATH = "diy-record";
+export declare const DIY_RECORD_ACT_PATH = "diy-record/act";
 export declare const PANEL_STATE_PREFIX = "/workbench/api/panel-state";
 export declare const OPENCLI_PIN = "1.8.8";
 export declare const CODING_ISSUES_SERVICE = "workbenchCodingIssues";
@@ -15,6 +17,7 @@ export declare const PANELS_SERVICE = "workbenchPanels";
 export declare const UNITS_SERVICE = "workbenchUnits";
 export declare const PANEL_STATE_SERVICE = "workbenchPanelState";
 export declare const DIY_DEBUG_SERVICE = "workbenchDiyDebug";
+export declare const DIY_RECORD_SERVICE = "workbenchDiyRecord";
 export declare const PANEL_LIST_LIMIT = 50;
 export declare const OPENCLI_TIMEOUT_MS = 120000;
 export declare const OPENCLI_MAX_CONCURRENT = 4;

package/dist/config/constants.js

@@ -11,6 +11,8 @@ 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 DIY_RECORD_PATH = "diy-record";
+export const DIY_RECORD_ACT_PATH = `${DIY_RECORD_PATH}/act`;
 export const PANEL_STATE_PREFIX = `${API_PREFIX}/${PANEL_STATE_PATH}`;
 export const OPENCLI_PIN = "1.8.8";
 export const CODING_ISSUES_SERVICE = "workbenchCodingIssues";
@@ -18,6 +20,7 @@ export const PANELS_SERVICE = "workbenchPanels";
 export const UNITS_SERVICE = "workbenchUnits";
 export const PANEL_STATE_SERVICE = "workbenchPanelState";
 export const DIY_DEBUG_SERVICE = "workbenchDiyDebug";
+export const DIY_RECORD_SERVICE = "workbenchDiyRecord";
 export const PANEL_LIST_LIMIT = 50;
 export const OPENCLI_TIMEOUT_MS = 120_000;
 export const OPENCLI_MAX_CONCURRENT = 4;

package/dist/host/browser-read.d.ts

@@ -1,6 +1,7 @@
 import type { DshShell } from '../api/dsh.js';
 export declare const BROWSER_SCREEN_SESSION = "workbench";
 export declare const BROWSER_READ_SESSION = "workbench-read";
+export declare const BROWSER_RECORD_SESSION = "workbench-rec";
 export interface BrowserReadResult {
     readonly ok: boolean;
     readonly code: string;

package/dist/host/browser-read.js

@@ -3,6 +3,7 @@ import { backgroundLine } from './opencli-window.js';
 import { runShell } from './shell.js';
 export const BROWSER_SCREEN_SESSION = 'workbench';
 export const BROWSER_READ_SESSION = 'workbench-read';
+export const BROWSER_RECORD_SESSION = 'workbench-rec';
 const DEFAULT_TIMEOUT_MS = 25000;
 const DEFAULT_RETRY_MS = 1200;
 const DEFAULT_SETTLE_MS = 900;

package/dist/host/http.d.ts

@@ -44,3 +44,6 @@ export declare function registerPanelState(ctx: DshHostContext, store: PanelStat
 export declare function registerDiyDebugAct(ctx: DshHostContext, resource: PostResource, log?: {
     bump(facts: readonly string[]): unknown;
 } | undefined): () => void;
+export declare function registerDiyRecordAct(ctx: DshHostContext, resource: PostResource, log?: {
+    bump(facts: readonly string[]): unknown;
+} | undefined): () => void;

package/dist/host/http.js

@@ -1,6 +1,6 @@
 import { unitFactScope } from '../api/facts.js';
 import { parseCardsReport, parseCrashReport } from '../lib/panel-state.js';
-import { ACTIONS_PREFIX, API_PREFIX, DIY_DEBUG_PATH, PANEL_STATE_PREFIX, PLUGIN_ID, PREFS_PREFIX, PROVISION_PREFIX } from '../config/constants.js';
+import { ACTIONS_PREFIX, API_PREFIX, DIY_DEBUG_PATH, DIY_RECORD_PATH, PANEL_STATE_PREFIX, PLUGIN_ID, PREFS_PREFIX, PROVISION_PREFIX } from '../config/constants.js';
 import { parseProvisionBody, } from './provision.js';
 import { WorkbenchDataError } from '../host/opencli.js';
 import { writeResultForClient } from './write-result.js';
@@ -264,3 +264,12 @@ export function registerDiyDebugAct(ctx, resource, log) {
         wrote: () => log?.bump(['diy-debug']),
     });
 }
+export function registerDiyRecordAct(ctx, resource, log) {
+    return registerPost(ctx, {
+        prefix: `${API_PREFIX}/${DIY_RECORD_PATH}`,
+        what: '工作台 DIY 录制交接动作',
+        refusedCode: 'action-refused',
+        resources: [resource],
+        wrote: () => log?.bump(['diy-record']),
+    });
+}

package/dist/host/tool-approval.d.ts

@@ -18,6 +18,10 @@ export type ApprovalFacts = ApprovalDetail | {
 };
 export declare const APPROVAL_NOTE_ARG = "approval_note";
 export declare const APPROVAL_NOTE_LIMIT = 40;
+export declare const APPROVAL_DETAIL_LIMIT = 20;
+export declare const APPROVAL_QUESTION_LIMIT = 40;
+export declare const APPROVAL_SEPARATOR_LIMIT = 8;
+export declare const APPROVAL_HEADLINE_LIMIT: number;
 export declare function withApprovalNote(parameters: Record<string, unknown>, options?: {
     readonly required?: boolean | undefined;
 }): Record<string, unknown>;
@@ -40,6 +44,7 @@ export type ApprovalPolicy = (call: ApprovalCall) => ApprovalVerdict | undefined
 export interface ApprovalContext {
     readonly writes?: boolean | undefined;
     readonly policy?: ApprovalPolicy | undefined;
+    readonly declaredNote?: boolean | undefined;
     readonly detailOf?: ((call: ApprovalCall) => ApprovalFacts | undefined | Promise<ApprovalFacts | undefined>) | undefined;
 }
 export declare function approvalFor(call: ApprovalCall, context?: ApprovalContext): Promise<AskDecision | undefined>;

package/dist/host/tool-approval.js

@@ -1,5 +1,9 @@
 export const APPROVAL_NOTE_ARG = 'approval_note';
 export const APPROVAL_NOTE_LIMIT = 40;
+export const APPROVAL_DETAIL_LIMIT = 20;
+export const APPROVAL_QUESTION_LIMIT = 40;
+export const APPROVAL_SEPARATOR_LIMIT = 8;
+export const APPROVAL_HEADLINE_LIMIT = APPROVAL_DETAIL_LIMIT + APPROVAL_QUESTION_LIMIT + APPROVAL_NOTE_LIMIT + APPROVAL_SEPARATOR_LIMIT;
 const NOTE_SCHEMA = {
     type: 'string',
     description: '一句话说明你这次想拿它干什么（要点头时显示在审批屏上；40 字以内）。',
@@ -20,12 +24,15 @@ export function withApprovalNote(parameters, options = {}) {
         ...(required.length === 0 ? {} : { required }),
     };
 }
+function oneLine(text) {
+    return text.replace(/\s+/g, ' ').trim();
+}
 function approvalNoteOf(call) {
     const raw = call.arguments;
     const value = typeof raw === 'object' && raw !== null ? raw[APPROVAL_NOTE_ARG] : undefined;
     if (typeof value !== 'string')
         return undefined;
-    const line = value.replace(/\s+/g, ' ').trim();
+    const line = oneLine(value);
     if (line === '')
         return undefined;
     return line.length > APPROVAL_NOTE_LIMIT ? `${line.slice(0, APPROVAL_NOTE_LIMIT)}…` : line;
@@ -40,9 +47,8 @@ function compose(detail, verdict, note) {
             en: `${detail.en} — ${verdict.question.en}`,
             zh: `${detail.zh} —— ${verdict.question.zh}`,
         };
-    if (note === undefined)
-        return base;
-    return { en: `${base.en} — ${note}`, zh: `${base.zh} —— ${note}` };
+    const line = note === undefined ? base : { en: `${base.en} — ${note}`, zh: `${base.zh} —— ${note}` };
+    return { en: oneLine(line.en), zh: oneLine(line.zh) };
 }
 export async function approvalFor(call, context = {}) {
     if (context.writes !== true)
@@ -78,6 +84,6 @@ export async function approvalFor(call, context = {}) {
     return {
         kind: 'ask',
         reason: verdict.reason,
-        displayReason: compose(facts, verdict, approvalNoteOf(call)),
+        displayReason: compose(facts, verdict, context.declaredNote === true ? approvalNoteOf(call) : undefined),
     };
 }

package/dist/host.d.ts

@@ -9,6 +9,7 @@ export * from './lib/ui.js';
 export * from './lib/panel-state.js';
 export * from './lib/board-fact.js';
 export * from './lib/diy-debug.js';
+export * from './lib/diy-record.js';
 export * from './api/blocker-table.js';
 export * from './host/browser-find.js';
 export * from './host/browser-read.js';

package/dist/host.js

@@ -9,6 +9,7 @@ export * from './lib/ui.js';
 export * from './lib/panel-state.js';
 export * from './lib/board-fact.js';
 export * from './lib/diy-debug.js';
+export * from './lib/diy-record.js';
 export * from './api/blocker-table.js';
 export * from './host/browser-find.js';
 export * from './host/browser-read.js';

package/dist/i18n/en.js

@@ -422,4 +422,18 @@ export const en = {
     'debug.card.paused.note': 'Paused',
     'debug.card.hidden.note': 'Switch to the Workbench panel',
     'debug.back': 'Back to the workshop screen',
+    'record.waiting': 'Recording handoff · your turn',
+    'record.waiting.note': 'Press "Start recording" on that page, then "Stop recording" when done (it will not switch you back)',
+    'record.recording': 'Recording',
+    'record.recording.note': 'Press "Stop recording" when done; if the bar is gone press Halt so the agent grabs it first',
+    'record.finished': 'Recording finished',
+    'record.finished.note': 'This run is done — the agent will grab it and wrap up on its own',
+    'record.act.cancel': 'Cancel',
+    'record.act.halt': 'Halt',
+    'approval.record.site': 'Site',
+    'approval.record.what': 'Records',
+    'approval.record.lands': 'Lands in',
+    'approval.record.noUrl': 'no site given (this call gets refused)',
+    'approval.record.oneAction': 'one action',
+    'approval.record.noSwitch': 'it will not switch you back (the leftbar footer shows the state)',
 };

package/dist/i18n/index.d.ts

@@ -424,8 +424,22 @@ export declare const dictionaries: {
         readonly 'debug.card.paused.note': "已暂停";
         readonly 'debug.card.hidden.note': "请切换到工作台面板";
         readonly 'debug.back': "回到工坊那一屏";
+        readonly 'record.waiting': "取证交接 · 等你出手";
+        readonly 'record.waiting.note': "请在那一页按「开始录制」，做完按「结束录制」（录完不替你切回来）";
+        readonly 'record.recording': "录制中";
+        readonly 'record.recording.note': "做完按「结束录制」；浮条没了按「停」，让 agent 先取再收";
+        readonly 'record.finished': "录制完成";
+        readonly 'record.finished.note': "这一段录完了 —— agent 会自己来取并收工，不用你点";
+        readonly 'record.act.cancel': "取消";
+        readonly 'record.act.halt': "停";
+        readonly 'approval.record.site': "站点";
+        readonly 'approval.record.what': "录制功能";
+        readonly 'approval.record.lands': "落点";
+        readonly 'approval.record.noUrl': "没给站点地址（这次会被当场拒）";
+        readonly 'approval.record.oneAction': "一次操作";
+        readonly 'approval.record.noSwitch': "录完不会替你切回来（左栏底部会亮一条状态）";
     };
-    en: Record<"time.now" | "time.ago" | "time.minutes" | "time.hours" | "time.days" | "blocker.retry" | "blocker.copy" | "blocker.unknown.title" | "blocker.login.go" | "blocker.login.titleGeneric" | "blocker.login.title" | "blocker.login.manual" | "blocker.login.hint" | "blocker.forbidden.open" | "blocker.forbidden.titleGeneric" | "blocker.forbidden.title" | "blocker.forbidden.hint" | "blocker.timeout.hint" | "blocker.exec.hint" | "blocker.fix.install" | "blocker.fix.update" | "blocker.market.open" | "env.unit.failed" | "env.unit.failedHint" | "env.unit.missingPlugin" | "env.unit.hint" | "env.unit.missingCommands" | "env.unit.missingCommandsHint" | "env.unit.unchecked" | "env.unit.uncheckedHint" | "brand.name" | "toggle.open" | "toggle.collapse" | "project.label" | "workspace.section" | "project.none" | "project.empty" | "project.add" | "project.add.busy" | "project.add.failed" | "project.search.label" | "project.search.placeholder" | "project.search.empty" | "project.group.workspaces" | "project.group.defaultWorkspace" | "project.group.workshop" | "project.rename.row" | "project.rename.current" | "project.rename.title" | "project.rename.description" | "project.rename.field" | "project.rename.placeholder" | "project.rename.hint" | "project.rename.save" | "project.rename.saving" | "project.rename.cancel" | "project.rename.failed" | "session.new" | "session.new.label" | "session.empty" | "session.noProject" | "session.list.label" | "session.copy" | "session.pinned" | "session.actions" | "status.idle" | "status.running" | "status.waitingApproval" | "status.planReview" | "status.waitingAnswer" | "status.compact.approval" | "status.compact.planReview" | "status.compact.answer" | "status.completed" | "status.subagentsRunning.one" | "status.subagentsRunning.other" | "project.attention.warning.one" | "project.attention.warning.other" | "project.attention.running.one" | "project.attention.running.other" | "project.attention.done.one" | "project.attention.done.other" | "project.attention.state.warning" | "project.attention.state.running" | "project.attention.state.done" | "hover.copied" | "time.short.minutes" | "time.short.hours" | "time.short.days" | "time.short.months" | "time.short.years" | "panels.title" | "panels.groupBoardless" | "panels.groupPlugins" | "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.dragHint" | "panels.unknownStep" | "panels.labelWithHint" | "panels.hintJoin" | "panels.dep.failed" | "panels.dep.missingPlugin" | "panels.dep.missingCommands" | "panels.dep.unchecked" | "panels.tab.modules" | "panels.tab.market" | "panels.browseMarket" | "panels.noneInstalled" | "panels.noneInstalledHint" | "panels.market.installed" | "panels.market.notActive" | "panels.market.notUsable" | "panels.market.broken" | "panels.market.hasNew" | "panels.market.hasProblem" | "panels.market.missing" | "panels.market.unchecked" | "panels.market.checking" | "panels.market.sectionInstalled" | "panels.market.sectionPending" | "panels.market.sectionShared" | "panels.market.sharedUsedBy" | "panels.market.listSeparator" | "panels.market.sharedMissing" | "panels.market.sharedOutdated" | "panels.market.sharedUnsatisfied" | "panels.market.sharedOk" | "panels.market.versionArrow" | "panels.market.lead" | "panels.market.install" | "panels.market.update" | "panels.market.swapSlow" | "panels.market.uninstall" | "panels.market.uninstallLabel" | "panels.market.installing" | "panels.market.updating" | "panels.market.uninstalling" | "panels.market.confirmUninstallTitle" | "panels.market.confirmUninstallDetail" | "panels.market.confirmUninstallAck" | "panels.market.confirmYes" | "panels.market.confirmNo" | "panels.market.failed" | "panels.market.needEnv" | "panels.market.needCommands" | "panels.market.localMark" | "panels.market.localHint" | "panels.market.noSource" | "panels.market.badSource" | "panels.market.empty" | "panels.market.sectionPlugins" | "panels.market.moduleOutdated" | "panels.market.moduleRefused" | "panels.market.moduleRefusedDetail" | "panels.market.moduleRestartHint" | "panels.market.pendingRestart" | "panels.market.workbenchName" | "panels.market.workbenchLocal" | "panels.market.pluginKeptInUse" | "panels.market.pluginKeptUnsure" | "panels.market.pluginKeptHeld" | "panels.market.pluginKeptUnnamed" | "panels.market.pluginBroken" | "panels.market.restartNeeded" | "panels.market.foot" | "panels.market.recheck" | "panels.market.checkUpdates" | "panels.market.checkedAt" | "panels.market.justNow" | "panels.market.minutesAgo" | "panels.market.hoursAgo" | "panels.market.add.description" | "panels.market.add.specPlaceholder" | "panels.market.add.guideToggle" | "panels.market.add.guideHide" | "panels.market.add.guideIdTitle" | "panels.market.add.guideIdExample" | "panels.market.add.guideIdHint" | "panels.market.add.guideGitTitle" | "panels.market.add.guideGitExample" | "panels.market.add.guideGitHint" | "panels.market.add.guidePathTitle" | "panels.market.add.guidePathExample" | "panels.market.add.guidePathHint" | "panels.market.add.guideExampleLabel" | "panels.market.add.guideFill" | "panels.market.add.guideSafety" | "panels.market.add.registryLegend" | "panels.market.add.registryOfficial" | "panels.market.add.registryMirror" | "panels.market.add.registryWithHost" | "panels.market.add.registryToggle" | "panels.market.add.installVersion" | "panels.market.add.registryDefault" | "panels.market.add.registryCustom" | "panels.market.add.registryCustomPlaceholder" | "panels.market.add.registryCustomHint" | "panels.market.add.registryCustomInvalid" | "panels.market.add.run" | "panels.market.add.edit" | "panels.market.add.changeRegistry" | "panels.market.add.installingTitle" | "panels.market.add.installedTitle" | "panels.market.add.failedTitle" | "panels.market.add.cancelledTitle" | "panels.market.add.failureNetworkHost" | "panels.market.add.problemInvalid" | "panels.market.add.problemInstalled" | "panels.market.add.problemNotFound" | "panels.market.add.problemNotPackage" | "panels.market.add.problemNotBundle" | "panels.market.add.problemNotWorkbenchModule" | "panels.market.add.problemNotModuleOrPlugin" | "panels.market.add.failureNotModuleOrPlugin" | "panels.market.add.installedPlugin" | "panels.market.add.pluginPreview" | "panels.market.add.pluginAlias" | "panels.market.add.problemNetwork" | "panels.market.add.problemUnknown" | "panels.market.add.failureNetwork" | "panels.market.add.failureNotFound" | "panels.market.add.failureNoMatchingVersion" | "panels.market.add.failureDiskFull" | "panels.market.add.failurePermission" | "panels.market.add.failureBuildBlocked" | "panels.market.add.failureIntegrity" | "panels.market.add.failureTimeout" | "panels.market.add.failurePnpmMissing" | "panels.market.add.failureInstalled" | "panels.market.add.failureGeneric" | "panels.market.add.approveTitle" | "panels.market.add.approveCaution" | "panels.market.add.approveRun" | "panels.market.add.restart" | "panels.market.add.tookEffect" | "panels.market.add.details" | "panels.market.add.open" | "panels.market.add.title" | "panels.market.add.intro" | "panels.market.add.specLabel" | "panels.market.add.specHint" | "panels.market.add.exampleTitle" | "panels.market.add.exampleFill" | "panels.market.add.registryLabel" | "panels.market.add.registryProfile" | "panels.market.add.registryPnpm" | "panels.market.add.check" | "panels.market.add.checking" | "panels.market.add.classifying" | "panels.market.add.change" | "panels.market.add.previewTitle" | "panels.market.add.fieldName" | "panels.market.add.fieldVersion" | "panels.market.add.fieldDescription" | "panels.market.add.fieldSource" | "panels.market.add.install" | "panels.market.add.installing" | "panels.market.add.cancel" | "panels.market.add.close" | "panels.market.add.retry" | "panels.market.add.changeSource" | "panels.market.add.approveBuilds" | "panels.market.add.approveHint" | "panels.market.add.doneApplied" | "panels.market.add.doneRestart" | "panels.market.add.restartWhy" | "panels.market.add.restartWhy.no-hmr" | "panels.market.add.restartWhy.package-moved" | "panels.market.add.restartWhy.host-module" | "panels.market.add.restartWhy.unmanaged-plugin" | "panels.market.add.restartWhy.module-comparison" | "panels.market.add.cancelled" | "panels.market.add.failed" | "panels.market.add.removed" | "panels.market.add.supplyPending" | "panels.market.add.supplyFailed" | "panels.market.add.notModule" | "panels.market.add.removedRestart" | "panels.market.add.remove" | "panels.market.add.problem.invalidSpec" | "panels.market.add.problem.alreadyInstalled" | "panels.market.add.problem.notFound" | "panels.market.add.problem.notAPackage" | "panels.market.add.problem.notABundle" | "panels.market.add.problem.network" | "panels.market.add.problem.unknown" | "panels.market.add.reason.invalidSpec" | "panels.market.add.reason.incompatible" | "panels.market.add.reason.notBundle" | "panels.market.add.reason.notRemovable" | "panels.market.add.reason.bundleInUse" | "panels.market.add.reason.stopProfile" | "panels.market.add.reason.staleApproval" | "panels.market.add.reason.operationError" | "panels.market.add.reason.buildBlocked" | "panels.market.add.reason.pnpmMissing" | "panels.market.add.reason.noMatchingVersion" | "panels.market.add.reason.diskFull" | "panels.market.add.reason.permission" | "panels.market.add.reason.integrity" | "panels.market.add.reason.timeout" | "panels.market.add.reason.network" | "panels.market.add.reason.notFound" | "panels.market.add.reason.unknown" | "blocker.fix.running" | "blocker.fix.failed" | "blocker.retry.running" | "panels.reading" | "panels.cardBroken" | "panels.cardRetry" | "panels.empty" | "panels.emptyHint" | "env.title" | "env.checking" | "env.installing" | "env.failed" | "env.elapsed" | "env.stepFailed.install" | "env.stepFailed.path" | "env.stepFailed.shell" | "env.bridge.ok" | "env.bridge.short" | "env.bridge.why" | "env.bridge.daemon" | "env.bridge.extension" | "env.bridge.extensionLink" | "env.bridge.profile" | "env.bridge.stale" | "env.bridge.unknown" | "env.fix.title" | "env.fix.why" | "env.fix.whyPath" | "env.fix.whyShell" | "env.fix.step" | "env.fix.stepPath" | "env.fix.stepShell" | "env.fix.permission" | "env.fix.network" | "env.fix.details" | "env.retry" | "env.copyCommand" | "env.copied" | "env.step.opencli" | "env.step.codingPlugin" | "env.step.bridge" | "env.step.warm" | "env.warm.done" | "env.warm.short" | "rightbar.label" | "rightbar.expand" | "rightbar.collapse" | "rightbar.column.label" | "rightbar.column.workbench" | "rightbar.column.dsh" | "rightbar.refresh" | "rightbar.refreshing" | "rightbar.updatedAt" | "rightbar.noProject" | "rightbar.openPlatform" | "coding.notARepo.title" | "error.unknown" | "board.title" | "panel.conversation" | "panels.label" | "configSync.nav" | "configSync.lead" | "configSync.source" | "configSync.sourceBroken" | "configSync.sourceRows" | "configSync.sourceDead" | "configSync.refresh" | "configSync.loading" | "configSync.readHint" | "configSync.tag.new" | "configSync.tag.differs" | "configSync.conflictNote" | "configSync.code.lang" | "configSync.code.copy" | "configSync.code.copied" | "configSync.code.wrap" | "configSync.code.unwrap" | "configSync.code.collapse" | "configSync.code.collapseAria" | "configSync.code.expandAria" | "configSync.code.expand" | "configSync.missing" | "configSync.apply" | "configSync.applyNone" | "configSync.applying" | "configSync.applied" | "configSync.appliedIds" | "configSync.skippedIds" | "configSync.nothing" | "configSync.unreadable" | "configSync.noSource" | "configSync.emptyProviders" | "configSync.failed" | "debug.status" | "debug.status.trouble" | "debug.stalled" | "debug.act.pause" | "debug.act.resume" | "debug.act.stop" | "debug.act.stop.ask" | "debug.card.here.title" | "debug.card.here.note" | "debug.card.away.title" | "debug.card.away.note" | "debug.card.paused.note" | "debug.card.hidden.note" | "debug.back", string>;
+    en: Record<"time.now" | "time.ago" | "time.minutes" | "time.hours" | "time.days" | "blocker.retry" | "blocker.copy" | "blocker.unknown.title" | "blocker.login.go" | "blocker.login.titleGeneric" | "blocker.login.title" | "blocker.login.manual" | "blocker.login.hint" | "blocker.forbidden.open" | "blocker.forbidden.titleGeneric" | "blocker.forbidden.title" | "blocker.forbidden.hint" | "blocker.timeout.hint" | "blocker.exec.hint" | "blocker.fix.install" | "blocker.fix.update" | "blocker.market.open" | "env.unit.failed" | "env.unit.failedHint" | "env.unit.missingPlugin" | "env.unit.hint" | "env.unit.missingCommands" | "env.unit.missingCommandsHint" | "env.unit.unchecked" | "env.unit.uncheckedHint" | "brand.name" | "toggle.open" | "toggle.collapse" | "project.label" | "workspace.section" | "project.none" | "project.empty" | "project.add" | "project.add.busy" | "project.add.failed" | "project.search.label" | "project.search.placeholder" | "project.search.empty" | "project.group.workspaces" | "project.group.defaultWorkspace" | "project.group.workshop" | "project.rename.row" | "project.rename.current" | "project.rename.title" | "project.rename.description" | "project.rename.field" | "project.rename.placeholder" | "project.rename.hint" | "project.rename.save" | "project.rename.saving" | "project.rename.cancel" | "project.rename.failed" | "session.new" | "session.new.label" | "session.empty" | "session.noProject" | "session.list.label" | "session.copy" | "session.pinned" | "session.actions" | "status.idle" | "status.running" | "status.waitingApproval" | "status.planReview" | "status.waitingAnswer" | "status.compact.approval" | "status.compact.planReview" | "status.compact.answer" | "status.completed" | "status.subagentsRunning.one" | "status.subagentsRunning.other" | "project.attention.warning.one" | "project.attention.warning.other" | "project.attention.running.one" | "project.attention.running.other" | "project.attention.done.one" | "project.attention.done.other" | "project.attention.state.warning" | "project.attention.state.running" | "project.attention.state.done" | "hover.copied" | "time.short.minutes" | "time.short.hours" | "time.short.days" | "time.short.months" | "time.short.years" | "panels.title" | "panels.groupBoardless" | "panels.groupPlugins" | "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.dragHint" | "panels.unknownStep" | "panels.labelWithHint" | "panels.hintJoin" | "panels.dep.failed" | "panels.dep.missingPlugin" | "panels.dep.missingCommands" | "panels.dep.unchecked" | "panels.tab.modules" | "panels.tab.market" | "panels.browseMarket" | "panels.noneInstalled" | "panels.noneInstalledHint" | "panels.market.installed" | "panels.market.notActive" | "panels.market.notUsable" | "panels.market.broken" | "panels.market.hasNew" | "panels.market.hasProblem" | "panels.market.missing" | "panels.market.unchecked" | "panels.market.checking" | "panels.market.sectionInstalled" | "panels.market.sectionPending" | "panels.market.sectionShared" | "panels.market.sharedUsedBy" | "panels.market.listSeparator" | "panels.market.sharedMissing" | "panels.market.sharedOutdated" | "panels.market.sharedUnsatisfied" | "panels.market.sharedOk" | "panels.market.versionArrow" | "panels.market.lead" | "panels.market.install" | "panels.market.update" | "panels.market.swapSlow" | "panels.market.uninstall" | "panels.market.uninstallLabel" | "panels.market.installing" | "panels.market.updating" | "panels.market.uninstalling" | "panels.market.confirmUninstallTitle" | "panels.market.confirmUninstallDetail" | "panels.market.confirmUninstallAck" | "panels.market.confirmYes" | "panels.market.confirmNo" | "panels.market.failed" | "panels.market.needEnv" | "panels.market.needCommands" | "panels.market.localMark" | "panels.market.localHint" | "panels.market.noSource" | "panels.market.badSource" | "panels.market.empty" | "panels.market.sectionPlugins" | "panels.market.moduleOutdated" | "panels.market.moduleRefused" | "panels.market.moduleRefusedDetail" | "panels.market.moduleRestartHint" | "panels.market.pendingRestart" | "panels.market.workbenchName" | "panels.market.workbenchLocal" | "panels.market.pluginKeptInUse" | "panels.market.pluginKeptUnsure" | "panels.market.pluginKeptHeld" | "panels.market.pluginKeptUnnamed" | "panels.market.pluginBroken" | "panels.market.restartNeeded" | "panels.market.foot" | "panels.market.recheck" | "panels.market.checkUpdates" | "panels.market.checkedAt" | "panels.market.justNow" | "panels.market.minutesAgo" | "panels.market.hoursAgo" | "panels.market.add.description" | "panels.market.add.specPlaceholder" | "panels.market.add.guideToggle" | "panels.market.add.guideHide" | "panels.market.add.guideIdTitle" | "panels.market.add.guideIdExample" | "panels.market.add.guideIdHint" | "panels.market.add.guideGitTitle" | "panels.market.add.guideGitExample" | "panels.market.add.guideGitHint" | "panels.market.add.guidePathTitle" | "panels.market.add.guidePathExample" | "panels.market.add.guidePathHint" | "panels.market.add.guideExampleLabel" | "panels.market.add.guideFill" | "panels.market.add.guideSafety" | "panels.market.add.registryLegend" | "panels.market.add.registryOfficial" | "panels.market.add.registryMirror" | "panels.market.add.registryWithHost" | "panels.market.add.registryToggle" | "panels.market.add.installVersion" | "panels.market.add.registryDefault" | "panels.market.add.registryCustom" | "panels.market.add.registryCustomPlaceholder" | "panels.market.add.registryCustomHint" | "panels.market.add.registryCustomInvalid" | "panels.market.add.run" | "panels.market.add.edit" | "panels.market.add.changeRegistry" | "panels.market.add.installingTitle" | "panels.market.add.installedTitle" | "panels.market.add.failedTitle" | "panels.market.add.cancelledTitle" | "panels.market.add.failureNetworkHost" | "panels.market.add.problemInvalid" | "panels.market.add.problemInstalled" | "panels.market.add.problemNotFound" | "panels.market.add.problemNotPackage" | "panels.market.add.problemNotBundle" | "panels.market.add.problemNotWorkbenchModule" | "panels.market.add.problemNotModuleOrPlugin" | "panels.market.add.failureNotModuleOrPlugin" | "panels.market.add.installedPlugin" | "panels.market.add.pluginPreview" | "panels.market.add.pluginAlias" | "panels.market.add.problemNetwork" | "panels.market.add.problemUnknown" | "panels.market.add.failureNetwork" | "panels.market.add.failureNotFound" | "panels.market.add.failureNoMatchingVersion" | "panels.market.add.failureDiskFull" | "panels.market.add.failurePermission" | "panels.market.add.failureBuildBlocked" | "panels.market.add.failureIntegrity" | "panels.market.add.failureTimeout" | "panels.market.add.failurePnpmMissing" | "panels.market.add.failureInstalled" | "panels.market.add.failureGeneric" | "panels.market.add.approveTitle" | "panels.market.add.approveCaution" | "panels.market.add.approveRun" | "panels.market.add.restart" | "panels.market.add.tookEffect" | "panels.market.add.details" | "panels.market.add.open" | "panels.market.add.title" | "panels.market.add.intro" | "panels.market.add.specLabel" | "panels.market.add.specHint" | "panels.market.add.exampleTitle" | "panels.market.add.exampleFill" | "panels.market.add.registryLabel" | "panels.market.add.registryProfile" | "panels.market.add.registryPnpm" | "panels.market.add.check" | "panels.market.add.checking" | "panels.market.add.classifying" | "panels.market.add.change" | "panels.market.add.previewTitle" | "panels.market.add.fieldName" | "panels.market.add.fieldVersion" | "panels.market.add.fieldDescription" | "panels.market.add.fieldSource" | "panels.market.add.install" | "panels.market.add.installing" | "panels.market.add.cancel" | "panels.market.add.close" | "panels.market.add.retry" | "panels.market.add.changeSource" | "panels.market.add.approveBuilds" | "panels.market.add.approveHint" | "panels.market.add.doneApplied" | "panels.market.add.doneRestart" | "panels.market.add.restartWhy" | "panels.market.add.restartWhy.no-hmr" | "panels.market.add.restartWhy.package-moved" | "panels.market.add.restartWhy.host-module" | "panels.market.add.restartWhy.unmanaged-plugin" | "panels.market.add.restartWhy.module-comparison" | "panels.market.add.cancelled" | "panels.market.add.failed" | "panels.market.add.removed" | "panels.market.add.supplyPending" | "panels.market.add.supplyFailed" | "panels.market.add.notModule" | "panels.market.add.removedRestart" | "panels.market.add.remove" | "panels.market.add.problem.invalidSpec" | "panels.market.add.problem.alreadyInstalled" | "panels.market.add.problem.notFound" | "panels.market.add.problem.notAPackage" | "panels.market.add.problem.notABundle" | "panels.market.add.problem.network" | "panels.market.add.problem.unknown" | "panels.market.add.reason.invalidSpec" | "panels.market.add.reason.incompatible" | "panels.market.add.reason.notBundle" | "panels.market.add.reason.notRemovable" | "panels.market.add.reason.bundleInUse" | "panels.market.add.reason.stopProfile" | "panels.market.add.reason.staleApproval" | "panels.market.add.reason.operationError" | "panels.market.add.reason.buildBlocked" | "panels.market.add.reason.pnpmMissing" | "panels.market.add.reason.noMatchingVersion" | "panels.market.add.reason.diskFull" | "panels.market.add.reason.permission" | "panels.market.add.reason.integrity" | "panels.market.add.reason.timeout" | "panels.market.add.reason.network" | "panels.market.add.reason.notFound" | "panels.market.add.reason.unknown" | "blocker.fix.running" | "blocker.fix.failed" | "blocker.retry.running" | "panels.reading" | "panels.cardBroken" | "panels.cardRetry" | "panels.empty" | "panels.emptyHint" | "env.title" | "env.checking" | "env.installing" | "env.failed" | "env.elapsed" | "env.stepFailed.install" | "env.stepFailed.path" | "env.stepFailed.shell" | "env.bridge.ok" | "env.bridge.short" | "env.bridge.why" | "env.bridge.daemon" | "env.bridge.extension" | "env.bridge.extensionLink" | "env.bridge.profile" | "env.bridge.stale" | "env.bridge.unknown" | "env.fix.title" | "env.fix.why" | "env.fix.whyPath" | "env.fix.whyShell" | "env.fix.step" | "env.fix.stepPath" | "env.fix.stepShell" | "env.fix.permission" | "env.fix.network" | "env.fix.details" | "env.retry" | "env.copyCommand" | "env.copied" | "env.step.opencli" | "env.step.codingPlugin" | "env.step.bridge" | "env.step.warm" | "env.warm.done" | "env.warm.short" | "rightbar.label" | "rightbar.expand" | "rightbar.collapse" | "rightbar.column.label" | "rightbar.column.workbench" | "rightbar.column.dsh" | "rightbar.refresh" | "rightbar.refreshing" | "rightbar.updatedAt" | "rightbar.noProject" | "rightbar.openPlatform" | "coding.notARepo.title" | "error.unknown" | "board.title" | "panel.conversation" | "panels.label" | "configSync.nav" | "configSync.lead" | "configSync.source" | "configSync.sourceBroken" | "configSync.sourceRows" | "configSync.sourceDead" | "configSync.refresh" | "configSync.loading" | "configSync.readHint" | "configSync.tag.new" | "configSync.tag.differs" | "configSync.conflictNote" | "configSync.code.lang" | "configSync.code.copy" | "configSync.code.copied" | "configSync.code.wrap" | "configSync.code.unwrap" | "configSync.code.collapse" | "configSync.code.collapseAria" | "configSync.code.expandAria" | "configSync.code.expand" | "configSync.missing" | "configSync.apply" | "configSync.applyNone" | "configSync.applying" | "configSync.applied" | "configSync.appliedIds" | "configSync.skippedIds" | "configSync.nothing" | "configSync.unreadable" | "configSync.noSource" | "configSync.emptyProviders" | "configSync.failed" | "debug.status" | "debug.status.trouble" | "debug.stalled" | "debug.act.pause" | "debug.act.resume" | "debug.act.stop" | "debug.act.stop.ask" | "debug.card.here.title" | "debug.card.here.note" | "debug.card.away.title" | "debug.card.away.note" | "debug.card.paused.note" | "debug.card.hidden.note" | "debug.back" | "record.waiting" | "record.waiting.note" | "record.recording" | "record.recording.note" | "record.finished" | "record.finished.note" | "record.act.cancel" | "record.act.halt" | "approval.record.site" | "approval.record.what" | "approval.record.lands" | "approval.record.noUrl" | "approval.record.oneAction" | "approval.record.noSwitch", string>;
 };
 export type { WorkbenchMessages };
 export interface Dictionaries {

package/dist/i18n/zh.d.ts

@@ -422,5 +422,19 @@ export declare const zh: {
     readonly 'debug.card.paused.note': "已暂停";
     readonly 'debug.card.hidden.note': "请切换到工作台面板";
     readonly 'debug.back': "回到工坊那一屏";
+    readonly 'record.waiting': "取证交接 · 等你出手";
+    readonly 'record.waiting.note': "请在那一页按「开始录制」，做完按「结束录制」（录完不替你切回来）";
+    readonly 'record.recording': "录制中";
+    readonly 'record.recording.note': "做完按「结束录制」；浮条没了按「停」，让 agent 先取再收";
+    readonly 'record.finished': "录制完成";
+    readonly 'record.finished.note': "这一段录完了 —— agent 会自己来取并收工，不用你点";
+    readonly 'record.act.cancel': "取消";
+    readonly 'record.act.halt': "停";
+    readonly 'approval.record.site': "站点";
+    readonly 'approval.record.what': "录制功能";
+    readonly 'approval.record.lands': "落点";
+    readonly 'approval.record.noUrl': "没给站点地址（这次会被当场拒）";
+    readonly 'approval.record.oneAction': "一次操作";
+    readonly 'approval.record.noSwitch': "录完不会替你切回来（左栏底部会亮一条状态）";
 };
 export type WorkbenchMessages = typeof zh;

package/dist/i18n/zh.js

@@ -422,4 +422,18 @@ export const zh = {
     'debug.card.paused.note': '已暂停',
     'debug.card.hidden.note': '请切换到工作台面板',
     'debug.back': '回到工坊那一屏',
+    'record.waiting': '取证交接 · 等你出手',
+    'record.waiting.note': '请在那一页按「开始录制」，做完按「结束录制」（录完不替你切回来）',
+    'record.recording': '录制中',
+    'record.recording.note': '做完按「结束录制」；浮条没了按「停」，让 agent 先取再收',
+    'record.finished': '录制完成',
+    'record.finished.note': '这一段录完了 —— agent 会自己来取并收工，不用你点',
+    'record.act.cancel': '取消',
+    'record.act.halt': '停',
+    'approval.record.site': '站点',
+    'approval.record.what': '录制功能',
+    'approval.record.lands': '落点',
+    'approval.record.noUrl': '没给站点地址（这次会被当场拒）',
+    'approval.record.oneAction': '一次操作',
+    'approval.record.noSwitch': '录完不会替你切回来（左栏底部会亮一条状态）',
 };

package/dist/index.d.ts

@@ -47,6 +47,7 @@ export * from './lib/busy.js';
 export * from './lib/form-problem.js';
 export * from './lib/board-fact.js';
 export * from './lib/diy-debug.js';
+export * from './lib/diy-record.js';
 export * from './lib/panel-state.js';
 export * from './lib/react.js';
 export * from './lib/text.js';

package/dist/index.js

@@ -47,6 +47,7 @@ export * from './lib/busy.js';
 export * from './lib/form-problem.js';
 export * from './lib/board-fact.js';
 export * from './lib/diy-debug.js';
+export * from './lib/diy-record.js';
 export * from './lib/panel-state.js';
 export * from './lib/react.js';
 export * from './lib/text.js';

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

@@ -0,0 +1,57 @@
+export type RecordPhase = 'armed' | 'recording' | 'finished';
+export declare const RECORD_STALE_MS: number;
+export interface RecordExpect {
+    readonly method: string;
+    readonly urlContains: string;
+}
+export interface RecordState {
+    readonly phase: RecordPhase;
+    readonly sessionId: string;
+    readonly workspace: string;
+    readonly unit: string;
+    readonly name: string;
+    readonly url: string;
+    readonly title: string;
+    readonly action: string;
+    readonly expect: RecordExpect | null;
+    readonly captureFile: string;
+    readonly startedAt: number;
+    readonly t0: number | null;
+    readonly t1: number | null;
+    readonly at: number;
+}
+export interface RecordPact {
+    readonly sessionId: string;
+    readonly workspace: string;
+    readonly unit: string;
+    readonly name: string;
+    readonly url: string;
+    readonly title: string;
+    readonly action: string;
+    readonly expect: RecordExpect | null;
+    readonly captureFile: string;
+    readonly now: number;
+}
+export type RecordRefusal = 'already-held' | 'held-by-other' | 'not-owner' | 'none' | 'already-recording' | 'not-armed' | 'not-recording' | 'not-finished';
+export type RecordMove = {
+    readonly ok: true;
+    readonly state: RecordState;
+} | {
+    readonly ok: false;
+    readonly code: RecordRefusal;
+};
+export type RecordIntent = 'peek' | 'halt' | 'stop';
+export declare function parseRecordIntent(raw: unknown): RecordIntent | null;
+export interface RecordStore {
+    readonly release?: ((state: RecordState) => Promise<{
+        readonly tab: boolean;
+        readonly capture: boolean;
+    }>) | undefined;
+    live(now: number): RecordState | null;
+    begin(pact: RecordPact): RecordMove;
+    started(sessionId: string, at: number, now: number): RecordMove;
+    finished(sessionId: string, at: number, now: number): RecordMove;
+    stop(sessionId: string, now: number): RecordMove;
+}
+export declare function createRecordStore(): RecordStore;
+export declare function recordOwnerText(state: RecordState): string;

package/dist/lib/diy-record.js

@@ -0,0 +1,79 @@
+export const RECORD_STALE_MS = 15 * 60 * 1000;
+export function parseRecordIntent(raw) {
+    return raw === 'peek' || raw === 'halt' || raw === 'stop' ? raw : null;
+}
+function alive(state, now) {
+    if (state === null)
+        return null;
+    return now - state.at <= RECORD_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 createRecordStore() {
+    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: 'armed',
+                sessionId: pact.sessionId,
+                workspace: pact.workspace,
+                unit: pact.unit,
+                name: pact.name,
+                url: pact.url,
+                title: pact.title,
+                action: pact.action,
+                expect: pact.expect,
+                captureFile: pact.captureFile,
+                startedAt: pact.now,
+                t0: null,
+                t1: null,
+                at: pact.now,
+            };
+            held = state;
+            return { ok: true, state };
+        },
+        started(sessionId, at, now) {
+            const found = ownerOf(held, sessionId, now);
+            if (typeof found === 'string')
+                return { ok: false, code: found };
+            if (found.phase === 'recording')
+                return { ok: false, code: 'already-recording' };
+            if (found.phase !== 'armed')
+                return { ok: false, code: 'not-armed' };
+            const state = { ...found, phase: 'recording', t0: at, at: now };
+            held = state;
+            return { ok: true, state };
+        },
+        finished(sessionId, at, now) {
+            const found = ownerOf(held, sessionId, now);
+            if (typeof found === 'string')
+                return { ok: false, code: found };
+            if (found.phase !== 'recording')
+                return { ok: false, code: 'not-recording' };
+            const state = { ...found, phase: 'finished', t1: at, 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 recordOwnerText(state) {
+    const at = new Date(state.startedAt).toISOString().slice(11, 19);
+    return `会话 ${state.sessionId}（自 ${at}Z 起在录 ${state.unit} 的「${state.action}」）`;
+}

package/package.json

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

package/src/api/host-write.ts

@@ -4,7 +4,8 @@ export type WriteChannel =
   | 'prefs'
   | 'actions'
   | 'provision'
-  | 'diy-debug';
+  | 'diy-debug'
+  | 'diy-record';
 
 export function writeRoute(channel: WriteChannel, resource: string): string {
   if (channel === 'provision') return 'provision';

package/src/components/ApprovalDetail.tsx

@@ -1,6 +1,6 @@
 import type { Translate } from '../api/dsh-client.js';
 import type { ApprovalInput, UnitClientFace } from '../components/board-module.js';
-import { h } from '../lib/react.js';
+import { Fragment, h, type ReactNode } from '../lib/react.js';
 import { CodeBlock } from '@deepseek-ai/dsh-client-ui-primitives';
 import { CardBoundary } from './CardBoundary.js';
 import './ApprovalDetail.css';
@@ -23,6 +23,7 @@ export interface ApprovalDetailProps {
   readonly useChat?: UseChat;
   readonly units?: readonly UnitClientFace[];
   readonly t?: Translate;
+  readonly renderShell?: ((input: ApprovalInput, t: Translate) => ReactNode) | undefined;
 }
 
 function callOf(snapshot: ChatSnapshot, callId: string | undefined): { name?: string; argsRaw: string } | undefined {
@@ -63,6 +64,9 @@ export function ApprovalDetail(props: ApprovalDetailProps) {
     );
   }
 
+  const shell = props.renderShell?.(input, t);
+  if (shell !== undefined && shell !== null) return <Fragment>{shell}</Fragment>;
+
   if (command === '') return null;
   return (
     <CodeBlock

package/src/config/constants.ts

@@ -19,6 +19,9 @@ 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 DIY_RECORD_PATH = "diy-record";
+export const DIY_RECORD_ACT_PATH = `${DIY_RECORD_PATH}/act`;
+
 export const PANEL_STATE_PREFIX = `${API_PREFIX}/${PANEL_STATE_PATH}`;
 
 export const OPENCLI_PIN = "1.8.8";
@@ -33,6 +36,8 @@ export const PANEL_STATE_SERVICE = "workbenchPanelState";
 
 export const DIY_DEBUG_SERVICE = "workbenchDiyDebug";
 
+export const DIY_RECORD_SERVICE = "workbenchDiyRecord";
+
 export const PANEL_LIST_LIMIT = 50;
 
 export const OPENCLI_TIMEOUT_MS = 120_000;

package/src/host/browser-read.ts

@@ -5,6 +5,7 @@ import { runShell } from './shell.js';
 
 export const BROWSER_SCREEN_SESSION = 'workbench';
 export const BROWSER_READ_SESSION = 'workbench-read';
+export const BROWSER_RECORD_SESSION = 'workbench-rec';
 
 const DEFAULT_TIMEOUT_MS = 25000;
 const DEFAULT_RETRY_MS = 1200;

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, DIY_DEBUG_PATH, PANEL_STATE_PREFIX, PLUGIN_ID, PREFS_PREFIX, PROVISION_PREFIX } from '../config/constants.js';
+import { ACTIONS_PREFIX, API_PREFIX, DIY_DEBUG_PATH, DIY_RECORD_PATH, PANEL_STATE_PREFIX, PLUGIN_ID, PREFS_PREFIX, PROVISION_PREFIX } from '../config/constants.js';
 import {
   parseProvisionBody,
   type ProvisionHandler,
@@ -340,3 +340,17 @@ export function registerDiyDebugAct(
     wrote: () => log?.bump(['diy-debug']),
   });
 }
+
+export function registerDiyRecordAct(
+  ctx: DshHostContext,
+  resource: PostResource,
+  log?: { bump(facts: readonly string[]): unknown } | undefined,
+): () => void {
+  return registerPost(ctx, {
+    prefix: `${API_PREFIX}/${DIY_RECORD_PATH}`,
+    what: '工作台 DIY 录制交接动作',
+    refusedCode: 'action-refused',
+    resources: [resource],
+    wrote: () => log?.bump(['diy-record']),
+  });
+}

package/src/host/tool-approval.ts

@@ -20,6 +20,15 @@ export const APPROVAL_NOTE_ARG = 'approval_note';
 
 export const APPROVAL_NOTE_LIMIT = 40;
 
+export const APPROVAL_DETAIL_LIMIT = 20;
+
+export const APPROVAL_QUESTION_LIMIT = 40;
+
+export const APPROVAL_SEPARATOR_LIMIT = 8;
+
+export const APPROVAL_HEADLINE_LIMIT =
+  APPROVAL_DETAIL_LIMIT + APPROVAL_QUESTION_LIMIT + APPROVAL_NOTE_LIMIT + APPROVAL_SEPARATOR_LIMIT;
+
 const NOTE_SCHEMA: Readonly<Record<string, unknown>> = {
   type: 'string',
   description: '一句话说明你这次想拿它干什么（要点头时显示在审批屏上；40 字以内）。',
@@ -45,12 +54,16 @@ export function withApprovalNote(
   };
 }
 
+function oneLine(text: string): string {
+  return text.replace(/\s+/g, ' ').trim();
+}
+
 function approvalNoteOf(call: ApprovalCall): string | undefined {
   const raw = call.arguments;
   const value =
     typeof raw === 'object' && raw !== null ? (raw as Record<string, unknown>)[APPROVAL_NOTE_ARG] : undefined;
   if (typeof value !== 'string') return undefined;
-  const line = value.replace(/\s+/g, ' ').trim();
+  const line = oneLine(value);
   if (line === '') return undefined;
   return line.length > APPROVAL_NOTE_LIMIT ? `${line.slice(0, APPROVAL_NOTE_LIMIT)}…` : line;
 }
@@ -76,6 +89,7 @@ export type ApprovalPolicy = (call: ApprovalCall) => ApprovalVerdict | undefined
 export interface ApprovalContext {
   readonly writes?: boolean | undefined;
   readonly policy?: ApprovalPolicy | undefined;
+  readonly declaredNote?: boolean | undefined;
   readonly detailOf?:
     | ((call: ApprovalCall) => ApprovalFacts | undefined | Promise<ApprovalFacts | undefined>)
     | undefined;
@@ -97,8 +111,8 @@ function compose(
           en: `${detail.en} — ${verdict.question.en}`,
           zh: `${detail.zh} —— ${verdict.question.zh}`,
         };
-  if (note === undefined) return base;
-  return { en: `${base.en} — ${note}`, zh: `${base.zh} —— ${note}` };
+  const line = note === undefined ? base : { en: `${base.en} — ${note}`, zh: `${base.zh} —— ${note}` };
+  return { en: oneLine(line.en), zh: oneLine(line.zh) };
 }
 
 export async function approvalFor(
@@ -139,6 +153,6 @@ export async function approvalFor(
   return {
     kind: 'ask',
     reason: verdict.reason,
-    displayReason: compose(facts, verdict, approvalNoteOf(call)),
+    displayReason: compose(facts, verdict, context.declaredNote === true ? approvalNoteOf(call) : undefined),
   };
 }

package/src/host.ts

@@ -9,6 +9,7 @@ export * from './lib/ui.js';
 export * from './lib/panel-state.js';
 export * from './lib/board-fact.js';
 export * from './lib/diy-debug.js';
+export * from './lib/diy-record.js';
 export * from './api/blocker-table.js';
 export * from './host/browser-find.js';
 export * from './host/browser-read.js';

package/src/i18n/en.ts

@@ -437,4 +437,18 @@ export const en: Record<keyof WorkbenchMessages, string> = {
   'debug.card.paused.note': 'Paused',
   'debug.card.hidden.note': 'Switch to the Workbench panel',
   'debug.back': 'Back to the workshop screen',
+  'record.waiting': 'Recording handoff · your turn',
+  'record.waiting.note': 'Press "Start recording" on that page, then "Stop recording" when done (it will not switch you back)',
+  'record.recording': 'Recording',
+  'record.recording.note': 'Press "Stop recording" when done; if the bar is gone press Halt so the agent grabs it first',
+  'record.finished': 'Recording finished',
+  'record.finished.note': 'This run is done — the agent will grab it and wrap up on its own',
+  'record.act.cancel': 'Cancel',
+  'record.act.halt': 'Halt',
+  'approval.record.site': 'Site',
+  'approval.record.what': 'Records',
+  'approval.record.lands': 'Lands in',
+  'approval.record.noUrl': 'no site given (this call gets refused)',
+  'approval.record.oneAction': 'one action',
+  'approval.record.noSwitch': 'it will not switch you back (the leftbar footer shows the state)',
 };

package/src/i18n/zh.ts

@@ -432,6 +432,20 @@ export const zh = {
   'debug.card.paused.note': '已暂停',
   'debug.card.hidden.note': '请切换到工作台面板',
   'debug.back': '回到工坊那一屏',
+  'record.waiting': '取证交接 · 等你出手',
+  'record.waiting.note': '请在那一页按「开始录制」，做完按「结束录制」（录完不替你切回来）',
+  'record.recording': '录制中',
+  'record.recording.note': '做完按「结束录制」；浮条没了按「停」，让 agent 先取再收',
+  'record.finished': '录制完成',
+  'record.finished.note': '这一段录完了 —— agent 会自己来取并收工，不用你点',
+  'record.act.cancel': '取消',
+  'record.act.halt': '停',
+  'approval.record.site': '站点',
+  'approval.record.what': '录制功能',
+  'approval.record.lands': '落点',
+  'approval.record.noUrl': '没给站点地址（这次会被当场拒）',
+  'approval.record.oneAction': '一次操作',
+  'approval.record.noSwitch': '录完不会替你切回来（左栏底部会亮一条状态）',
 } as const;
 
 export type WorkbenchMessages = typeof zh;

package/src/index.ts

@@ -47,6 +47,7 @@ export * from './lib/busy.js';
 export * from './lib/form-problem.js';
 export * from './lib/board-fact.js';
 export * from './lib/diy-debug.js';
+export * from './lib/diy-record.js';
 export * from './lib/panel-state.js';
 export * from './lib/react.js';
 export * from './lib/text.js';

package/src/lib/diy-record.test.ts

@@ -0,0 +1,171 @@
+import { describe, expect, it } from 'vitest';
+import {
+  RECORD_STALE_MS,
+  createRecordStore,
+  parseRecordIntent,
+  recordOwnerText,
+  type RecordPact,
+  type RecordState,
+} from './diy-record.js';
+
+const pact = (sessionId: string, now = 1000, unit = 'demo'): RecordPact => ({
+  sessionId,
+  workspace: '/w/diy',
+  unit,
+  name: unit,
+  url: 'https://cmdb.example.com/env',
+  title: '环境 · CMDB',
+  action: '发布',
+  expect: { method: 'POST', urlContains: '/api/publish' },
+  captureFile: '/w/diy/shots/rec-demo.jsonl',
+  now,
+});
+
+const held = (move: { ok: true; state: RecordState } | { ok: false; code: string }): RecordState => {
+  if (!move.ok) throw new Error(`expected ok, got ${move.code}`);
+  return move.state;
+};
+
+describe('录制交接：一台机器一次一场，谁开谁收工', () => {
+  it('★ begin ⇒ armed，把目标、那一页、那一下、捕获文件都记下', () => {
+    const store = createRecordStore();
+    const state = held(store.begin(pact('s1', 1000)));
+
+    expect(state.phase).toBe('armed');
+    expect(state.unit).toBe('demo');
+    expect(state.url).toBe('https://cmdb.example.com/env');
+    expect(state.action).toBe('发布');
+    expect(state.expect).toEqual({ method: 'POST', urlContains: '/api/publish' });
+    expect(state.captureFile).toBe('/w/diy/shots/rec-demo.jsonl');
+    expect(state.startedAt).toBe(1000);
+    expect(state.t0).toBeNull();
+    expect(state.t1).toBeNull();
+    expect(store.live(1000)).toEqual(state);
+  });
+
+  it('★★ 另一场占着就不许再开；同一个会话再来一次 ⇒ already-held', () => {
+    const store = createRecordStore();
+    store.begin(pact('s1', 1000));
+
+    expect(store.begin(pact('s2', 1200))).toEqual({ ok: false, code: 'held-by-other' });
+    expect(store.begin(pact('s1', 1300))).toEqual({ ok: false, code: 'already-held' });
+    expect(store.live(1300)?.sessionId).toBe('s1');
+  });
+
+  it('★ 用户按「开始」⇒ recording，t0 是他按的那一刻（不是 store 收到的那一刻）', () => {
+    const store = createRecordStore();
+    store.begin(pact('s1', 1000));
+
+    const state = held(store.started('s1', 2000, 2001));
+    expect(state.phase).toBe('recording');
+    expect(state.t0).toBe(2000);
+    expect(state.at).toBe(2001);
+    expect(state.startedAt).toBe(1000);
+  });
+
+  it('★ 用户按「结束」⇒ finished，t1 落下来；再按一次「结束」⇒ not-recording', () => {
+    const store = createRecordStore();
+    store.begin(pact('s1', 1000));
+    store.started('s1', 2000, 2001);
+
+    const state = held(store.finished('s1', 5000, 5002));
+    expect(state.phase).toBe('finished');
+    expect(state.t1).toBe(5000);
+    expect(store.finished('s1', 6000, 6000)).toEqual({ ok: false, code: 'not-recording' });
+  });
+
+  it('★★ 阶段不对就说清是哪一档：还没开始就结束 / 已经开始又按开始', () => {
+    const store = createRecordStore();
+    store.begin(pact('s1', 1000));
+
+    expect(store.finished('s1', 1500, 1500)).toEqual({ ok: false, code: 'not-recording' });
+
+    store.started('s1', 2000, 2000);
+    expect(store.started('s1', 2100, 2100)).toEqual({ ok: false, code: 'already-recording' });
+
+    store.finished('s1', 3000, 3000);
+    expect(store.started('s1', 3100, 3100)).toEqual({ ok: false, code: 'not-armed' });
+  });
+
+  it('★★ 一场就一个周期：finished 之后回不去了（没有「再录一段」，要重录就重新 begin 一场）', () => {
+    const store = createRecordStore();
+    store.begin(pact('s1', 1000));
+    store.started('s1', 2000, 2000);
+    store.finished('s1', 3000, 3000);
+
+    const state = store.live(3000);
+    expect(state?.phase).toBe('finished');
+    expect(state?.t0).toBe(2000);
+    expect(state?.t1).toBe(3000);
+    expect(store.started('s1', 3100, 3100)).toEqual({ ok: false, code: 'not-armed' });
+    expect(store.finished('s1', 3200, 3200)).toEqual({ ok: false, code: 'not-recording' });
+    expect(store.live(3300)?.phase).toBe('finished');
+  });
+
+  it('★ 收工把它清干净（取消那一拍也走它）', () => {
+    const store = createRecordStore();
+    store.begin(pact('s1', 1000));
+
+    const stopped = held(store.stop('s1', 1500));
+    expect(stopped.unit).toBe('demo');
+    expect(store.live(1500)).toBeNull();
+    expect(store.stop('s1', 1600)).toEqual({ ok: false, code: 'none' });
+  });
+
+  it('★★ 别人不许动我这一场（not-owner）；没开过 ⇒ none', () => {
+    const store = createRecordStore();
+
+    expect(store.started('s1', 1000, 1000)).toEqual({ ok: false, code: 'none' });
+    expect(store.finished('s1', 1000, 1000)).toEqual({ ok: false, code: 'none' });
+    expect(store.stop('s1', 1000)).toEqual({ ok: false, code: 'none' });
+
+    store.begin(pact('s1', 1000));
+    expect(store.started('s2', 1100, 1100)).toEqual({ ok: false, code: 'not-owner' });
+    expect(store.finished('s2', 1100, 1100)).toEqual({ ok: false, code: 'not-owner' });
+    expect(store.stop('s2', 1100)).toEqual({ ok: false, code: 'not-owner' });
+    expect(store.live(1100)?.sessionId).toBe('s1');
+  });
+
+  it('★ 过期当它不存在（15 分钟没人管就放别人进来）', () => {
+    const store = createRecordStore();
+    store.begin(pact('s1', 1000));
+
+    expect(store.live(1000 + RECORD_STALE_MS)).not.toBeNull();
+    expect(store.live(1001 + RECORD_STALE_MS)).toBeNull();
+    expect(store.begin(pact('s2', 1001 + RECORD_STALE_MS)).ok).toBe(true);
+    expect(store.live(1001 + RECORD_STALE_MS)?.sessionId).toBe('s2');
+  });
+
+  it('★ 录制中不被 TTL 拽走：at 每动一次就续上（他正在那一页上操作）', () => {
+    const store = createRecordStore();
+    store.begin(pact('s1', 1000));
+
+    const late = 1000 + RECORD_STALE_MS;
+    const state = held(store.started('s1', late, late));
+    expect(state.phase).toBe('recording');
+    expect(state.startedAt).toBe(1000);
+    expect(store.live(late + RECORD_STALE_MS)).not.toBeNull();
+    expect(store.live(late + RECORD_STALE_MS + 1)).toBeNull();
+  });
+
+  it('★ 占着的那句话里有会话、时间和要录的是什么（另一场要看得懂是谁占的）', () => {
+    const store = createRecordStore();
+    const state = held(store.begin(pact('s1', 1000)));
+    const text = recordOwnerText(state);
+
+    expect(text).toContain('s1');
+    expect(text).toContain('demo');
+    expect(text).toContain('发布');
+  });
+});
+
+describe('用户在左栏按的三个键：意图词表只此一份', () => {
+  it('★ 认得出三个，其余一律 null（别把别的字当成指令）', () => {
+    expect(parseRecordIntent('peek')).toBe('peek');
+    expect(parseRecordIntent('halt')).toBe('halt');
+    expect(parseRecordIntent('stop')).toBe('stop');
+    for (const bad of ['', 'PEEK', 'Peek', 'cancel', 'kill', 'end', null, undefined, 1, {}, []]) {
+      expect(parseRecordIntent(bad)).toBeNull();
+    }
+  });
+});

package/src/lib/diy-record.ts

@@ -0,0 +1,144 @@
+export type RecordPhase = 'armed' | 'recording' | 'finished';
+
+export const RECORD_STALE_MS = 15 * 60 * 1000;
+
+export interface RecordExpect {
+  readonly method: string;
+  readonly urlContains: string;
+}
+
+export interface RecordState {
+  readonly phase: RecordPhase;
+  readonly sessionId: string;
+  readonly workspace: string;
+  readonly unit: string;
+  readonly name: string;
+  readonly url: string;
+  readonly title: string;
+  readonly action: string;
+  readonly expect: RecordExpect | null;
+  readonly captureFile: string;
+  readonly startedAt: number;
+  readonly t0: number | null;
+  readonly t1: number | null;
+  readonly at: number;
+}
+
+export interface RecordPact {
+  readonly sessionId: string;
+  readonly workspace: string;
+  readonly unit: string;
+  readonly name: string;
+  readonly url: string;
+  readonly title: string;
+  readonly action: string;
+  readonly expect: RecordExpect | null;
+  readonly captureFile: string;
+  readonly now: number;
+}
+
+export type RecordRefusal =
+  | 'already-held'
+  | 'held-by-other'
+  | 'not-owner'
+  | 'none'
+  | 'already-recording'
+  | 'not-armed'
+  | 'not-recording'
+  | 'not-finished';
+
+export type RecordMove =
+  | { readonly ok: true; readonly state: RecordState }
+  | { readonly ok: false; readonly code: RecordRefusal };
+
+export type RecordIntent = 'peek' | 'halt' | 'stop';
+
+export function parseRecordIntent(raw: unknown): RecordIntent | null {
+  return raw === 'peek' || raw === 'halt' || raw === 'stop' ? raw : null;
+}
+
+export interface RecordStore {
+  readonly release?: ((state: RecordState) => Promise<{ readonly tab: boolean; readonly capture: boolean }>) | undefined;
+  live(now: number): RecordState | null;
+  begin(pact: RecordPact): RecordMove;
+  started(sessionId: string, at: number, now: number): RecordMove;
+  finished(sessionId: string, at: number, now: number): RecordMove;
+  stop(sessionId: string, now: number): RecordMove;
+}
+
+function alive(state: RecordState | null, now: number): RecordState | null {
+  if (state === null) return null;
+  return now - state.at <= RECORD_STALE_MS ? state : null;
+}
+
+function ownerOf(state: RecordState | null, sessionId: string, now: number): RecordRefusal | RecordState {
+  const held = alive(state, now);
+  if (held === null) return 'none';
+  return held.sessionId === sessionId ? held : 'not-owner';
+}
+
+export function createRecordStore(): RecordStore {
+  let held: RecordState | null = null;
+
+  const live = (now: number): RecordState | null => 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: RecordState = {
+        phase: 'armed',
+        sessionId: pact.sessionId,
+        workspace: pact.workspace,
+        unit: pact.unit,
+        name: pact.name,
+        url: pact.url,
+        title: pact.title,
+        action: pact.action,
+        expect: pact.expect,
+        captureFile: pact.captureFile,
+        startedAt: pact.now,
+        t0: null,
+        t1: null,
+        at: pact.now,
+      };
+      held = state;
+      return { ok: true, state };
+    },
+
+    started(sessionId, at, now) {
+      const found = ownerOf(held, sessionId, now);
+      if (typeof found === 'string') return { ok: false, code: found };
+      if (found.phase === 'recording') return { ok: false, code: 'already-recording' };
+      if (found.phase !== 'armed') return { ok: false, code: 'not-armed' };
+      const state: RecordState = { ...found, phase: 'recording', t0: at, at: now };
+      held = state;
+      return { ok: true, state };
+    },
+
+    finished(sessionId, at, now) {
+      const found = ownerOf(held, sessionId, now);
+      if (typeof found === 'string') return { ok: false, code: found };
+      if (found.phase !== 'recording') return { ok: false, code: 'not-recording' };
+      const state: RecordState = { ...found, phase: 'finished', t1: at, 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 recordOwnerText(state: RecordState): string {
+  const at = new Date(state.startedAt).toISOString().slice(11, 19);
+  return `会话 ${state.sessionId}（自 ${at}Z 起在录 ${state.unit} 的「${state.action}」）`;
+}