@dsh-workbench/shared 0.3.3 → 0.3.5

package/dist/config/constants.d.ts

@@ -1,37 +1,82 @@
+/** 外壳插件的包名：浏览器模块表与宿主按它注册、认领这枚插件。 */
 export declare const PLUGIN_ID = "@dsh-workbench/core";
+/** 与外壳同批发布的兄弟包名：`release.ts` 用它判一版三包是否都已在源上。 */
 export declare const RELEASE_SIBLINGS: readonly ["@dsh-workbench/shared", "@dsh-workbench/module-tools"];
+/** 外壳宿主 HTTP API 的根前缀；prefs / actions / provision 等路由都挂在它下面。 */
 export declare const API_PREFIX = "/workbench/api";
+/** 模块偏好读写的路由前缀，挂在外壳 API 下：走写通道，拒写回 write-refused。 */
 export declare const PREFS_PREFIX = "/workbench/api/prefs";
+/** 事实（facts）SSE 事件流的端点路径；前端 `EventSource` 按它带 `since` 游标续传。 */
 export declare const EVENTS_PATH = "/workbench/events";
+/** 写动作的路由前缀，挂在外壳 API 下：模块的写通道 POST 到这里。 */
 export declare const ACTIONS_PREFIX = "/workbench/api/actions";
+/** 机器供给（provision）的路由前缀：只收 POST，装机时用它铺一份运行环境。 */
 export declare const PROVISION_PREFIX = "/workbench/api/provision";
+/** 面板运行态上报的路径段：崩溃与卡片收尾分别 POST 到 `panel-state/crash`、`panel-state/cards`。 */
 export declare const PANEL_STATE_PATH = "panel-state";
+/** DIY 调试动作的路径段；宿主按它登记 `/workbench/api/diy-debug` 前缀。 */
 export declare const DIY_DEBUG_PATH = "diy-debug";
+/** 调试动作的子路径（`diy-debug/act`）；仓内暂无调用点，动作现走 `DIY_DEBUG_SERVICE`。 */
 export declare const DIY_DEBUG_ACT_PATH = "diy-debug/act";
+/** DIY 录制交接的路径段；宿主按它登记 `/workbench/api/diy-record` 前缀。 */
+export declare const DIY_RECORD_PATH = "diy-record";
+/** 录制动作的子路径（`diy-record/act`）；仓内暂无调用点，录制现走 `DIY_RECORD_SERVICE`。 */
+export declare const DIY_RECORD_ACT_PATH = "diy-record/act";
+/** 面板运行态的路由前缀，挂在外壳 API 下：上报口用它，拒报回 report-refused。 */
 export declare const PANEL_STATE_PREFIX = "/workbench/api/panel-state";
+/** 钉住的 opencli 插件版本：`opencli-runtime` 按它校验、取那一份。 */
 export declare const OPENCLI_PIN = "1.8.8";
+/** 缺陷看板套件的 dsh 服务名（`workbenchCodingIssues`）：套件照它登记自己那份服务。 */
 export declare const CODING_ISSUES_SERVICE = "workbenchCodingIssues";
+/** 面板套件的 dsh 服务名（`workbenchPanels`）：宿主经它取套件公布的清单与订阅。 */
 export declare const PANELS_SERVICE = "workbenchPanels";
+/** 单元花名册服务的 dsh 服务名（`workbenchUnits`）：模块经它认领自己的单元。 */
 export declare const UNITS_SERVICE = "workbenchUnits";
+/** 面板运行态服务的 dsh 服务名（`workbenchPanelState`）：宿主注册，读口按它取。 */
 export declare const PANEL_STATE_SERVICE = "workbenchPanelState";
+/** DIY 调试约定服务的 dsh 服务名（`workbenchDiyDebug`）：调试动作走它，不走 HTTP。 */
 export declare const DIY_DEBUG_SERVICE = "workbenchDiyDebug";
+/** DIY 录制交接服务的 dsh 服务名（`workbenchDiyRecord`）：`diy-acts.ts` 经它收发录制三拍。 */
+export declare const DIY_RECORD_SERVICE = "workbenchDiyRecord";
+/** 会话投影服务的 dsh 服务名（`sessionProjections`）：宿主经 `stateOf(session, 'agentPreset')` 读那一档。 */
+export declare const SESSION_PROJECTIONS_SERVICE = "sessionProjections";
+/** 面板清单一次取回的行数上限（条）：外部模块拿它当 opencli `--pageSize`。 */
 export declare const PANEL_LIST_LIMIT = 50;
+/** 单次 opencli 调用的默认超时（毫秒）；调用点没传 `timeoutMs` 时按它算。 */
 export declare const OPENCLI_TIMEOUT_MS = 120000;
+/** 同时最多几条 opencli 在跑（条）：`opencli.ts` 超出就排队。 */
 export declare const OPENCLI_MAX_CONCURRENT = 4;
+/** 启动预热站点那一跳的超时（毫秒）；超时按未热对待，不挡面板。 */
 export declare const WARM_TIMEOUT_MS = 20000;
+/** 装 / 卸模块包的超时（毫秒）：pnpm 与取包内容都按它算。 */
 export declare const INSTALL_TIMEOUT_MS = 300000;
+/** 查 registry 版本那一次请求的超时（毫秒）。 */
 export declare const VERSION_CHECK_TIMEOUT_MS = 10000;
+/** 版本查询结果的缓存有效期（毫秒）：期内不发第二次请求。 */
 export declare const VERSION_CHECK_TTL_MS = 600000;
+/** 单元探测结果的缓存有效期（毫秒）。 */
 export declare const PROBE_TTL_MS = 30000;
+/** 加载态至少显示多久（毫秒）：一瞬完成的读写也得让用户看见那一下。 */
 export declare const MIN_BUSY_MS = 500;
+/** 工具读出来的值交给面板后的保留时长（毫秒）：过期就不再算这一拍。 */
 export declare const HANDOFF_TTL_MS = 15000;
+/** 跑本地 git 命令的超时（毫秒）；短于对外的 `OPENCLI_TIMEOUT_MS`。 */
 export declare const GIT_TIMEOUT_MS = 10000;
+/** 面板轮询事实的间隔（毫秒）：SSE 断了走这条兜底轮询。 */
 export declare const PANEL_POLL_MS = 2000;
+/** 没起中文名的工作区默认标题：左栏按它分组、显示。 */
 export declare const DEFAULT_WORKSPACE_TITLE = "default-workspace";
+/** 记住当前项目的 localStorage 键。 */
 export declare const STORAGE_KEY_PROJECT = "dsh-workbench.project";
+/** 记住右栏展开与否的 localStorage 键。 */
 export declare const STORAGE_KEY_RIGHTBAR = "dsh-workbench.rightbar.expanded";
+/** 记住右栏当前列的 localStorage 键。 */
 export declare const STORAGE_KEY_RIGHTBAR_COLUMN = "dsh-workbench.rightbar.column";
+/** 记住右栏宽度（像素数字的字符串）的 localStorage 键。 */
 export declare const STORAGE_KEY_RIGHTBAR_WIDTH = "dsh-workbench.rightbar.width";
+/** 右栏宽度达到或超过多少像素就按全屏对待（阈值，像素）。 */
 export declare const RIGHTBAR_FULLSCREEN_WIDTH = 768;
+/** dsh i18n 的命名空间：词表都注册在它下面，`ctx.locale.register` / `bind` 按它取。 */
 export declare const LOCALE_NS = "workbench";
+/** 外壳支持的语言标识，顺序即回退顺序：首项是基准，其余词表必须与它逐键同构。 */
 export declare const LOCALES: readonly ["zh", "en"];

package/dist/config/constants.js

@@ -1,40 +1,85 @@
+/** 外壳插件的包名：浏览器模块表与宿主按它注册、认领这枚插件。 */
 export const PLUGIN_ID = "@dsh-workbench/core";
+/** 与外壳同批发布的兄弟包名：`release.ts` 用它判一版三包是否都已在源上。 */
 export const RELEASE_SIBLINGS = [
     "@dsh-workbench/shared",
     "@dsh-workbench/module-tools",
 ];
+/** 外壳宿主 HTTP API 的根前缀；prefs / actions / provision 等路由都挂在它下面。 */
 export const API_PREFIX = "/workbench/api";
+/** 模块偏好读写的路由前缀，挂在外壳 API 下：走写通道，拒写回 write-refused。 */
 export const PREFS_PREFIX = `${API_PREFIX}/prefs`;
+/** 事实（facts）SSE 事件流的端点路径；前端 `EventSource` 按它带 `since` 游标续传。 */
 export const EVENTS_PATH = "/workbench/events";
+/** 写动作的路由前缀，挂在外壳 API 下：模块的写通道 POST 到这里。 */
 export const ACTIONS_PREFIX = `${API_PREFIX}/actions`;
+/** 机器供给（provision）的路由前缀：只收 POST，装机时用它铺一份运行环境。 */
 export const PROVISION_PREFIX = `${API_PREFIX}/provision`;
+/** 面板运行态上报的路径段：崩溃与卡片收尾分别 POST 到 `panel-state/crash`、`panel-state/cards`。 */
 export const PANEL_STATE_PATH = "panel-state";
+/** DIY 调试动作的路径段；宿主按它登记 `/workbench/api/diy-debug` 前缀。 */
 export const DIY_DEBUG_PATH = "diy-debug";
+/** 调试动作的子路径（`diy-debug/act`）；仓内暂无调用点，动作现走 `DIY_DEBUG_SERVICE`。 */
 export const DIY_DEBUG_ACT_PATH = `${DIY_DEBUG_PATH}/act`;
+/** DIY 录制交接的路径段；宿主按它登记 `/workbench/api/diy-record` 前缀。 */
+export const DIY_RECORD_PATH = "diy-record";
+/** 录制动作的子路径（`diy-record/act`）；仓内暂无调用点，录制现走 `DIY_RECORD_SERVICE`。 */
+export const DIY_RECORD_ACT_PATH = `${DIY_RECORD_PATH}/act`;
+/** 面板运行态的路由前缀，挂在外壳 API 下：上报口用它，拒报回 report-refused。 */
 export const PANEL_STATE_PREFIX = `${API_PREFIX}/${PANEL_STATE_PATH}`;
+/** 钉住的 opencli 插件版本：`opencli-runtime` 按它校验、取那一份。 */
 export const OPENCLI_PIN = "1.8.8";
+/** 缺陷看板套件的 dsh 服务名（`workbenchCodingIssues`）：套件照它登记自己那份服务。 */
 export const CODING_ISSUES_SERVICE = "workbenchCodingIssues";
+/** 面板套件的 dsh 服务名（`workbenchPanels`）：宿主经它取套件公布的清单与订阅。 */
 export const PANELS_SERVICE = "workbenchPanels";
+/** 单元花名册服务的 dsh 服务名（`workbenchUnits`）：模块经它认领自己的单元。 */
 export const UNITS_SERVICE = "workbenchUnits";
+/** 面板运行态服务的 dsh 服务名（`workbenchPanelState`）：宿主注册，读口按它取。 */
 export const PANEL_STATE_SERVICE = "workbenchPanelState";
+/** DIY 调试约定服务的 dsh 服务名（`workbenchDiyDebug`）：调试动作走它，不走 HTTP。 */
 export const DIY_DEBUG_SERVICE = "workbenchDiyDebug";
+/** DIY 录制交接服务的 dsh 服务名（`workbenchDiyRecord`）：`diy-acts.ts` 经它收发录制三拍。 */
+export const DIY_RECORD_SERVICE = "workbenchDiyRecord";
+/** 会话投影服务的 dsh 服务名（`sessionProjections`）：宿主经 `stateOf(session, 'agentPreset')` 读那一档。 */
+export const SESSION_PROJECTIONS_SERVICE = "sessionProjections";
+/** 面板清单一次取回的行数上限（条）：外部模块拿它当 opencli `--pageSize`。 */
 export const PANEL_LIST_LIMIT = 50;
+/** 单次 opencli 调用的默认超时（毫秒）；调用点没传 `timeoutMs` 时按它算。 */
 export const OPENCLI_TIMEOUT_MS = 120_000;
+/** 同时最多几条 opencli 在跑（条）：`opencli.ts` 超出就排队。 */
 export const OPENCLI_MAX_CONCURRENT = 4;
+/** 启动预热站点那一跳的超时（毫秒）；超时按未热对待，不挡面板。 */
 export const WARM_TIMEOUT_MS = 20_000;
+/** 装 / 卸模块包的超时（毫秒）：pnpm 与取包内容都按它算。 */
 export const INSTALL_TIMEOUT_MS = 300_000;
+/** 查 registry 版本那一次请求的超时（毫秒）。 */
 export const VERSION_CHECK_TIMEOUT_MS = 10_000;
+/** 版本查询结果的缓存有效期（毫秒）：期内不发第二次请求。 */
 export const VERSION_CHECK_TTL_MS = 600_000;
+/** 单元探测结果的缓存有效期（毫秒）。 */
 export const PROBE_TTL_MS = 30_000;
+/** 加载态至少显示多久（毫秒）：一瞬完成的读写也得让用户看见那一下。 */
 export const MIN_BUSY_MS = 500;
+/** 工具读出来的值交给面板后的保留时长（毫秒）：过期就不再算这一拍。 */
 export const HANDOFF_TTL_MS = 15_000;
+/** 跑本地 git 命令的超时（毫秒）；短于对外的 `OPENCLI_TIMEOUT_MS`。 */
 export const GIT_TIMEOUT_MS = 10_000;
+/** 面板轮询事实的间隔（毫秒）：SSE 断了走这条兜底轮询。 */
 export const PANEL_POLL_MS = 2000;
+/** 没起中文名的工作区默认标题：左栏按它分组、显示。 */
 export const DEFAULT_WORKSPACE_TITLE = "default-workspace";
+/** 记住当前项目的 localStorage 键。 */
 export const STORAGE_KEY_PROJECT = "dsh-workbench.project";
+/** 记住右栏展开与否的 localStorage 键。 */
 export const STORAGE_KEY_RIGHTBAR = "dsh-workbench.rightbar.expanded";
+/** 记住右栏当前列的 localStorage 键。 */
 export const STORAGE_KEY_RIGHTBAR_COLUMN = "dsh-workbench.rightbar.column";
+/** 记住右栏宽度（像素数字的字符串）的 localStorage 键。 */
 export const STORAGE_KEY_RIGHTBAR_WIDTH = "dsh-workbench.rightbar.width";
+/** 右栏宽度达到或超过多少像素就按全屏对待（阈值，像素）。 */
 export const RIGHTBAR_FULLSCREEN_WIDTH = 768;
+/** dsh i18n 的命名空间：词表都注册在它下面，`ctx.locale.register` / `bind` 按它取。 */
 export const LOCALE_NS = "workbench";
+/** 外壳支持的语言标识，顺序即回退顺序：首项是基准，其余词表必须与它逐键同构。 */
 export const LOCALES = ["zh", "en"];

package/dist/config/storage.d.ts

@@ -1,4 +1,8 @@
+/** 读 localStorage 里的一段文本；没有这个键、或存储不可用（隐私模式）时返回 null。 */
 export declare function readText(key: string): string | null;
+/** 写一段文本进 localStorage；`value` 为 null 时删掉这个键，写不进去就静默作罢。 */
 export declare function writeText(key: string, value: string | null): void;
+/** 读一个布尔开关：键不存在时返回 `fallback`，只有存进去的 `'true'` 算真。 */
 export declare function readFlag(key: string, fallback: boolean): boolean;
+/** 把一个布尔开关写进 localStorage（存 `'true'` / `'false'`）；失败静默。 */
 export declare function writeFlag(key: string, value: boolean): void;

package/dist/config/storage.js

@@ -1,3 +1,4 @@
+/** 读 localStorage 里的一段文本；没有这个键、或存储不可用（隐私模式）时返回 null。 */
 export function readText(key) {
     try {
         return window.localStorage.getItem(key);
@@ -6,6 +7,7 @@ export function readText(key) {
         return null;
     }
 }
+/** 写一段文本进 localStorage；`value` 为 null 时删掉这个键，写不进去就静默作罢。 */
 export function writeText(key, value) {
     try {
         if (value === null)
@@ -16,12 +18,14 @@ export function writeText(key, value) {
     catch {
     }
 }
+/** 读一个布尔开关：键不存在时返回 `fallback`，只有存进去的 `'true'` 算真。 */
 export function readFlag(key, fallback) {
     const raw = readText(key);
     if (raw === null)
         return fallback;
     return raw === 'true';
 }
+/** 把一个布尔开关写进 localStorage（存 `'true'` / `'false'`）；失败静默。 */
 export function writeFlag(key, value) {
     writeText(key, value ? 'true' : 'false');
 }

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/unit-face.d.ts

@@ -7,6 +7,10 @@ import type { UnitCapability } from './unit-libs.js';
 import type { ApprovalCall, ApprovalFacts, ApprovalPolicy } from '../host/tool-approval.js';
 import type { ValueHandoff } from '../host/value-handoff.js';
 import type { WorkspaceStore } from '../host/workspace-store.js';
+export interface ToolScopeContext {
+    readonly workspace: string | null;
+    readonly preset: string | null;
+}
 export interface UnitMountDeps {
     readonly manifest: UnitManifest;
     readonly ctx: DshHostContext;
@@ -40,7 +44,7 @@ export interface UnitMountResult {
     registerTools(): Array<() => void>;
     readonly factsOf?: ((call: UnitCall) => readonly string[] | undefined) | undefined;
     readonly gate?: {
-        deniedTools(workspace: string | null): readonly string[];
+        deniedTools(context: ToolScopeContext): readonly string[];
         subscribe(listener: () => void): () => void;
     };
     readonly context?: {

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.d.ts

@@ -1,2 +1,3 @@
 import type { WorkbenchMessages } from './zh.js';
+/** 外壳自带的英文词表：键必须与 `zh` 逐一对应，值不许为空串。 */
 export declare const en: Record<keyof WorkbenchMessages, string>;

package/dist/i18n/en.js

@@ -1,3 +1,4 @@
+/** 外壳自带的英文词表：键必须与 `zh` 逐一对应，值不许为空串。 */
 export const en = {
     'brand.name': 'Workbench',
     'toggle.open': 'Open sidebar',
@@ -408,18 +409,31 @@ export const en = {
     'configSync.noSource': 'This machine has no other profile to sync from',
     'configSync.emptyProviders': 'The workbench has no model provider yet — sync the llm- rows from some profile, or configure one under Models.',
     'configSync.failed': 'The sync did not go through; try again.',
-    'debug.status': 'Workbench DIY debugging',
-    'debug.status.trouble': 'Workbench DIY debugging needs attention',
-    'debug.stalled': 'Workbench DIY debugging paused',
+    'debug.workspace': 'this workspace',
+    'debug.status': 'Debugging “{title}”',
+    'debug.status.trouble': 'Debugging needs your attention ({title})',
+    'debug.stalled': 'Debugging paused ({title})',
     'debug.act.pause': 'Pause debugging',
     'debug.act.resume': 'Resume debugging',
     'debug.act.stop': 'Stop debugging',
     'debug.act.stop.ask': 'Confirm stop',
-    'debug.card.here.title': 'Workbench DIY debugging is on',
+    'debug.card.here.title': 'Debugging “{title}”',
     'debug.card.here.note': 'Do not switch workspaces or touch the panel',
-    'debug.card.away.title': 'Workbench DIY debugging is on',
-    'debug.card.away.note': 'Switch to the Workbench DIY workspace',
+    'debug.card.away.note': 'Switch back to “{title}”',
     'debug.card.paused.note': 'Paused',
-    'debug.card.hidden.note': 'Switch to the Workbench panel',
-    'debug.back': 'Back to the workshop screen',
+    'debug.card.hidden.note': 'Switch back to the Workbench panel',
+    '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

@@ -1,4 +1,5 @@
 import { type WorkbenchMessages } from './zh.js';
+/** 外壳自带的两份词表（`zh` 为基准、`en` 同构）：`client.tsx` 拿它当合并各套件词表的底座。 */
 export declare const dictionaries: {
     zh: {
         readonly 'brand.name': "工作台";
@@ -410,24 +411,39 @@ export declare const dictionaries: {
         readonly 'configSync.noSource': "这台机器上只有工作台这一个 profile，没有可同步的来源";
         readonly 'configSync.emptyProviders': "工作台还没有任何模型供应商 —— 去「配置同步」从某个 profile 把 llm- 那几行搬过来，或自己去「模型」里配。";
         readonly 'configSync.failed': "同步没成功，再试一次。";
-        readonly 'debug.status': "工作台 DIY 开发调试中";
-        readonly 'debug.status.trouble': "工作台 DIY 开发调试异常";
-        readonly 'debug.stalled': "工作台 DIY 调试暂停";
+        readonly 'debug.workspace': "这个工作区";
+        readonly 'debug.status': "「{title}」调试中";
+        readonly 'debug.status.trouble': "调试要你看一眼（{title}）";
+        readonly 'debug.stalled': "调试已暂停（{title}）";
         readonly 'debug.act.pause': "暂停调试";
         readonly 'debug.act.resume': "继续调试";
         readonly 'debug.act.stop': "结束调试";
         readonly 'debug.act.stop.ask': "确认结束";
-        readonly 'debug.card.here.title': "当前工作台 DIY 开发调试中";
+        readonly 'debug.card.here.title': "正在调试「{title}」";
         readonly 'debug.card.here.note': "请勿切换工作区和操作面板";
-        readonly 'debug.card.away.title': "工作台 DIY 开发调试中";
-        readonly 'debug.card.away.note': "请切换到工作台 DIY 工作区";
+        readonly 'debug.card.away.note': "请切回「{title}」那一屏";
         readonly 'debug.card.paused.note': "已暂停";
-        readonly 'debug.card.hidden.note': "请切换到工作台面板";
-        readonly 'debug.back': "回到工坊那一屏";
+        readonly 'debug.card.hidden.note': "请切回工作台面板";
+        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.workspace" | "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.note" | "debug.card.paused.note" | "debug.card.hidden.note" | "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>;
 };
+/** 中文词表的键类型（从 `zh.ts` 转出）：`en` 与模块词表都得覆盖同一批键。 */
 export type { WorkbenchMessages };
+/** 一份按语言分的词表：`zh` / `en` 必须同键，另可带模块自己那份语言。 */
 export interface Dictionaries {
     readonly zh: Readonly<Record<string, string>>;
     readonly en: Readonly<Record<string, string>>;

package/dist/i18n/index.js

@@ -1,3 +1,4 @@
 import { en } from './en.js';
 import { zh } from './zh.js';
+/** 外壳自带的两份词表（`zh` 为基准、`en` 同构）：`client.tsx` 拿它当合并各套件词表的底座。 */
 export const dictionaries = { zh, en };

package/dist/i18n/merge.d.ts

@@ -1,15 +1,20 @@
 import type { Dictionaries } from './index.js';
+/** 一个套件交上来的词表：`unit` 是套件 id（也是键前缀），`messages` 缺省表示这次不参与合并。 */
 export interface MessagesContribution {
     readonly unit: string;
     readonly messages?: Dictionaries | undefined;
 }
+/** 把各套件的词表合到外壳底座上：键必须以 `<unit>.` 开头、不许撞已有键，违规当场抛错。 */
 export declare function mergeMessages(base: Dictionaries, contributions: readonly MessagesContribution[]): Dictionaries;
+/** 一条没合进去的贡献：哪个套件 + 为什么被拒（人话原因）。 */
 export interface MessagesProblem {
     readonly unit: string;
     readonly reason: string;
 }
+/** 合并结果：合出来的词表 + 被跳过的贡献；`problems` 为空即全部合上了。 */
 export interface MessagesMerge {
     readonly dictionaries: Dictionaries;
     readonly problems: readonly MessagesProblem[];
 }
+/** 逐份试合、坏的跳过：一份贡献不合规只记进 `problems`，不影响其余套件与已有词表。 */
 export declare function mergeMessagesSkipping(base: Dictionaries, contributions: readonly MessagesContribution[]): MessagesMerge;

package/dist/i18n/merge.js

@@ -14,6 +14,7 @@ function assertSelfConsistent(unit, messages) {
         }
     }
 }
+/** 把各套件的词表合到外壳底座上：键必须以 `<unit>.` 开头、不许撞已有键，违规当场抛错。 */
 export function mergeMessages(base, contributions) {
     const zh = { ...base.zh };
     const en = { ...base.en };
@@ -43,6 +44,7 @@ function reasonOf(error) {
         return error.message;
     return typeof error === 'string' ? error : String(error);
 }
+/** 逐份试合、坏的跳过：一份贡献不合规只记进 `problems`，不影响其余套件与已有词表。 */
 export function mergeMessagesSkipping(base, contributions) {
     let dictionaries = base;
     const accepted = [];