@dsh-workbench/shared 0.1.9 → 0.1.10

package/dist/api/blocker-table.js

@@ -99,6 +99,16 @@ export function blockerOfCapability(capability, t) {
         ...(sourceUnknown ? [{ kind: 'open-market', label: t('blocker.market.open'), unit: capability.unit }] : []),
         ...(capability.command === undefined || sourceUnknown ? [] : [copyAction(t, capability.command)]),
     ];
+    if (capability.status === 'failed') {
+        return {
+            id: 'unit-mount-failed',
+            severity: 'block',
+            title: t('env.unit.failed'),
+            hint: t('env.unit.failedHint'),
+            ...(capability.detail === undefined ? {} : { detail: capability.detail }),
+            actions: [retryAction(t)],
+        };
+    }
     if (capability.status === 'missing-plugin') {
         return {
             id: 'unit-missing-plugin',

package/dist/api/dsh-client.d.ts

@@ -99,12 +99,15 @@ export interface DshUiWorkspace {
     startSession(workspaceId: string): void;
     pickDirectory(): Promise<string | null>;
 }
+export interface DshWorkspaceWritten {
+    readonly workspaceId?: string;
+    readonly title?: string;
+}
 export interface DshWorkspaces {
     create(request: {
         path: string;
-    }): Promise<{
-        workspaceId?: string;
-    } | undefined>;
+    }): Promise<DshWorkspaceWritten | undefined>;
+    rename(workspaceId: string, title: string): Promise<DshWorkspaceWritten>;
 }
 export interface DshReferenceInsert {
     readonly source: string;

package/dist/api/workbench-contract.d.ts

@@ -10,7 +10,7 @@ export interface PluginStatePayload {
 }
 export interface CapabilityPayload {
     readonly unit: string;
-    readonly status: 'ok' | 'missing-commands' | 'missing-plugin' | 'unchecked';
+    readonly status: 'ok' | 'failed' | 'missing-commands' | 'missing-plugin' | 'unchecked';
     readonly plugin?: string;
     readonly required: readonly string[];
     readonly missing: readonly string[];

package/dist/components/ApprovalDetail.js

@@ -1,5 +1,6 @@
 import { h } from '../lib/react.js';
 import { CodeBlock } from '@deepseek-ai/dsh-client-ui-primitives';
+import { CardBoundary } from './CardBoundary.js';
 import './ApprovalDetail.css';
 function callOf(snapshot, callId) {
     if (callId === undefined)
@@ -29,8 +30,11 @@ export function ApprovalDetail(props) {
     const input = { tool: call?.name ?? '', args };
     const command = typeof args.command === 'string' ? args.command : '';
     const owner = (props.units ?? []).find((face) => face.approval?.tools.includes(input.tool) === true);
-    if (owner?.approval !== undefined)
-        return h(owner.approval.render, { input: input, t: t });
+    if (owner?.approval !== undefined) {
+        const Render = owner.approval.render;
+        return (h(CardBoundary, { unit: owner.manifest.id, resetKey: props.callId ?? '', t: t },
+            h(Render, { input: input, t: t })));
+    }
     if (command === '')
         return null;
     return (h(CodeBlock, { code: command, className: "wb-approvalCommand", copyLabel: t('blocker.copy'), copiedLabel: t('env.copied') }));

package/dist/components/CardBoundary.d.ts

@@ -0,0 +1,21 @@
+import type { Translate } from '../api/dsh-client.js';
+import type { ReactNode } from '../lib/react.js';
+import { Component } from '../lib/react.js';
+export interface CardBoundaryProps {
+    readonly unit: string;
+    readonly resetKey: string;
+    readonly t: Translate;
+    readonly children?: ReactNode | undefined;
+}
+export interface CardBoundaryState {
+    readonly reason: string | null;
+}
+export declare function errorReasonOf(error: unknown): string;
+export declare class CardBoundary extends Component<CardBoundaryProps, CardBoundaryState> {
+    state: CardBoundaryState;
+    static getDerivedStateFromError(error: unknown): CardBoundaryState;
+    componentDidCatch(error: unknown): void;
+    componentDidUpdate(previous: CardBoundaryProps): void;
+    private readonly retry;
+    render(): ReactNode;
+}

package/dist/components/CardBoundary.js

@@ -0,0 +1,34 @@
+import { Button } from '@deepseek-ai/dsh-client-ui-primitives';
+import { Component, h } from '../lib/react.js';
+import { Note } from './Note.js';
+export function errorReasonOf(error) {
+    if (error instanceof Error)
+        return error.message;
+    return typeof error === 'string' ? error : JSON.stringify(error) ?? String(error);
+}
+export class CardBoundary extends Component {
+    state = { reason: null };
+    static getDerivedStateFromError(error) {
+        return { reason: errorReasonOf(error) };
+    }
+    componentDidCatch(error) {
+        console.error(`[dsh-workbench] 模块 ${this.props.unit} 渲染失败：${errorReasonOf(error)}`, error);
+    }
+    componentDidUpdate(previous) {
+        if (previous.resetKey !== this.props.resetKey && this.state.reason !== null) {
+            this.setState({ reason: null });
+        }
+    }
+    retry = () => {
+        this.setState({ reason: null });
+    };
+    render() {
+        const { reason } = this.state;
+        if (reason === null)
+            return this.props.children;
+        return (h(Note, { tone: "problem" },
+            h("span", null, this.props.t('panels.cardBroken', { unit: this.props.unit, reason })),
+            ' ',
+            h(Button, { type: "button", variant: "outline", size: "sm", onClick: this.retry }, this.props.t('panels.cardRetry'))));
+    }
+}

package/dist/host/unit-libs.d.ts

@@ -23,7 +23,7 @@ export interface UnitPluginState {
 }
 export interface UnitCapability {
     readonly unit: string;
-    readonly status: "ok" | "missing-commands" | "missing-plugin" | "unchecked";
+    readonly status: "ok" | "failed" | "missing-commands" | "missing-plugin" | "unchecked";
     readonly plugin?: string;
     readonly required: readonly string[];
     readonly missing: readonly string[];

package/dist/i18n/en.js

@@ -7,6 +7,20 @@ export const en = {
     'project.none': 'No project',
     'project.empty': 'No projects yet. Use “Add project” below.',
     'project.add': 'Add project…',
+    'project.search.label': 'Search workspaces',
+    'project.search.placeholder': 'Search workspaces (folder / name / path)',
+    'project.search.empty': 'No workspace matches “{query}”.',
+    'project.rename.row': 'Rename “{name}”',
+    'project.rename.current': 'Give this workspace a display name…',
+    'project.rename.title': 'Give “{name}” a display name',
+    'project.rename.description': 'Shown after the folder name. It renames the workspace itself.',
+    'project.rename.field': 'Display name',
+    'project.rename.placeholder': 'e.g. Workbench shell',
+    'project.rename.hint': 'Empty = folder name only',
+    'project.rename.save': 'Save',
+    'project.rename.saving': 'Saving…',
+    'project.rename.cancel': 'Cancel',
+    'project.rename.failed': 'Rename failed. Try again.',
     'session.new': 'New session',
     'session.new.label': 'Start a session in the current project',
     'session.empty': 'No sessions in this project yet.',
@@ -35,6 +49,7 @@ export const en = {
     'panels.dragHint': 'Drag to reorder',
     'panels.unknownStep': 'No suite provides this view',
     'panels.labelWithHint': '{label} ({hint})',
+    'panels.dep.failed': '⚠ failed to start',
     'panels.dep.missingPlugin': '⚠ not ready yet',
     'panels.dep.missingCommands': '⚠ needs an update',
     'panels.dep.unchecked': '⚠ cannot check',
@@ -228,6 +243,8 @@ export const en = {
     'blocker.exec.hint': 'Make sure opencli is installed and on PATH (which opencli).',
     'blocker.unknown.title': 'Something went wrong',
     'panels.reading': 'Reading the panel setup…',
+    'panels.cardBroken': 'This module will not render: {unit} ({reason})',
+    'panels.cardRetry': 'Retry',
     'panels.empty': 'No modules on the panel yet',
     'panels.emptyHint': 'You can also just tell the agent: “add a module to the panel”.',
     'env.title': 'Preparing the workbench',
@@ -266,6 +283,8 @@ export const en = {
     'env.step.warm': 'Warming up site sessions',
     'env.warm.done': '{n} site(s) warmed up',
     'env.warm.short': 'Not warmed this time — harmless; the panel heals on first read',
+    'env.unit.failed': 'This module cannot start',
+    'env.unit.failedHint': 'It failed while assembling itself; other modules are unaffected.',
     'env.unit.missingPlugin': 'This module is not ready yet',
     'env.unit.missingCommandsHint': 'Updating it should fix this.',
     'env.unit.unchecked': 'Cannot check: no shell channel',

package/dist/i18n/index.d.ts

@@ -9,6 +9,20 @@ export declare const dictionaries: {
         readonly 'project.none': "未选择项目";
         readonly 'project.empty': "还没有项目。用下面的「添加项目」选一个目录。";
         readonly 'project.add': "添加项目…";
+        readonly 'project.search.label': "搜索工作区";
+        readonly 'project.search.placeholder': "搜索工作区（目录名 / 中文名 / 路径）";
+        readonly 'project.search.empty': "没有匹配「{query}」的工作区。";
+        readonly 'project.rename.row': "改「{name}」的中文名";
+        readonly 'project.rename.current': "改当前工作区的中文名…";
+        readonly 'project.rename.title': "给「{name}」配一个中文名";
+        readonly 'project.rename.description': "显示在目录名后面。改的是工作区本身的名字。";
+        readonly 'project.rename.field': "中文名";
+        readonly 'project.rename.placeholder': "例如：工作台外壳";
+        readonly 'project.rename.hint': "留空 = 只显示目录名";
+        readonly 'project.rename.save': "保存";
+        readonly 'project.rename.saving': "保存中…";
+        readonly 'project.rename.cancel': "取消";
+        readonly 'project.rename.failed': "改名失败了，再试一次。";
         readonly 'session.new': "新会话";
         readonly 'session.new.label': "在当前项目新建会话";
         readonly 'session.empty': "这个项目还没有会话。";
@@ -37,6 +51,7 @@ export declare const dictionaries: {
         readonly 'panels.dragHint': "拖动调整顺序";
         readonly 'panels.unknownStep': "这一层没有套件提供";
         readonly 'panels.labelWithHint': "{label}（{hint}）";
+        readonly 'panels.dep.failed': "⚠ 起不来";
         readonly 'panels.dep.missingPlugin': "⚠ 还没装好";
         readonly 'panels.dep.missingCommands': "⚠ 需要更新";
         readonly 'panels.dep.unchecked': "⚠ 检测不了";
@@ -230,6 +245,8 @@ export declare const dictionaries: {
         readonly 'blocker.exec.hint': "确认 opencli 已安装且在 PATH 里（which opencli）。";
         readonly 'blocker.unknown.title': "出了点问题";
         readonly 'panels.reading': "正在读取面板配置…";
+        readonly 'panels.cardBroken': "这个模块起不来：{unit}（{reason}）";
+        readonly 'panels.cardRetry': "重试";
         readonly 'panels.empty': "面板里还没有模块";
         readonly 'panels.emptyHint': "也可以直接跟 agent 说：「把某个模块加到面板」。";
         readonly 'env.title': "准备工作台";
@@ -268,6 +285,8 @@ export declare const dictionaries: {
         readonly 'env.step.warm': "预热站点登录态";
         readonly 'env.warm.done': "已预热 {n} 个站点";
         readonly 'env.warm.short': "这次没热上 —— 不影响用，面板第一次读取会自己补";
+        readonly 'env.unit.failed': "这个模块起不来";
+        readonly 'env.unit.failedHint': "它自己装配时报了错，别的模块不受影响。";
         readonly 'env.unit.missingPlugin': "这个模块还没装好";
         readonly 'env.unit.missingCommandsHint': "更新之后就能用了。";
         readonly 'env.unit.unchecked': "检测不了：拿不到执行通道";
@@ -290,7 +309,7 @@ export declare const dictionaries: {
         readonly 'panel.conversation': "对话";
         readonly 'panels.label': "全局面板";
     };
-    en: Record<"time.now" | "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.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" | "session.new" | "session.new.label" | "session.empty" | "session.noProject" | "session.pinned" | "session.actions" | "status.idle" | "status.running" | "status.waitingApproval" | "status.planReview" | "status.waitingAnswer" | "status.completed" | "status.subagentsRunning.one" | "status.subagentsRunning.other" | "panels.title" | "panels.reset" | "panels.enabled" | "panels.disabled" | "panels.choose" | "panels.failed" | "panels.hintEffect" | "panels.dragHint" | "panels.unknownStep" | "panels.labelWithHint" | "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.outdated" | "panels.market.hasNew" | "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.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.noSource" | "panels.market.badSource" | "panels.market.empty" | "panels.market.installedSection" | "panels.market.moduleOutdated" | "panels.market.moduleRestartHint" | "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.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.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.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.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.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" | "coding.notARepo.title" | "error.unknown" | "board.title" | "panel.conversation" | "panels.label", string>;
+    en: Record<"time.now" | "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.search.label" | "project.search.placeholder" | "project.search.empty" | "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.pinned" | "session.actions" | "status.idle" | "status.running" | "status.waitingApproval" | "status.planReview" | "status.waitingAnswer" | "status.completed" | "status.subagentsRunning.one" | "status.subagentsRunning.other" | "panels.title" | "panels.reset" | "panels.enabled" | "panels.disabled" | "panels.choose" | "panels.failed" | "panels.hintEffect" | "panels.dragHint" | "panels.unknownStep" | "panels.labelWithHint" | "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.outdated" | "panels.market.hasNew" | "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.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.noSource" | "panels.market.badSource" | "panels.market.empty" | "panels.market.installedSection" | "panels.market.moduleOutdated" | "panels.market.moduleRestartHint" | "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.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.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.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.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" | "coding.notARepo.title" | "error.unknown" | "board.title" | "panel.conversation" | "panels.label", string>;
 };
 export type { WorkbenchMessages };
 export interface Dictionaries {

package/dist/i18n/merge.d.ts

@@ -4,3 +4,12 @@ export interface MessagesContribution {
     readonly messages?: Dictionaries | undefined;
 }
 export declare function mergeMessages(base: Dictionaries, contributions: readonly MessagesContribution[]): Dictionaries;
+export interface MessagesProblem {
+    readonly unit: string;
+    readonly reason: string;
+}
+export interface MessagesMerge {
+    readonly dictionaries: Dictionaries;
+    readonly problems: readonly MessagesProblem[];
+}
+export declare function mergeMessagesSkipping(base: Dictionaries, contributions: readonly MessagesContribution[]): MessagesMerge;

package/dist/i18n/merge.js

@@ -38,3 +38,25 @@ export function mergeMessages(base, contributions) {
     }
     return { zh, en };
 }
+function reasonOf(error) {
+    if (error instanceof Error)
+        return error.message;
+    return typeof error === 'string' ? error : String(error);
+}
+export function mergeMessagesSkipping(base, contributions) {
+    let dictionaries = base;
+    const accepted = [];
+    const problems = [];
+    for (const item of contributions) {
+        if (item.messages === undefined)
+            continue;
+        try {
+            dictionaries = mergeMessages(base, [...accepted, item]);
+            accepted.push(item);
+        }
+        catch (error) {
+            problems.push({ unit: item.unit, reason: reasonOf(error) });
+        }
+    }
+    return { dictionaries, problems };
+}

package/dist/i18n/zh.d.ts

@@ -7,6 +7,20 @@ export declare const zh: {
     readonly 'project.none': "未选择项目";
     readonly 'project.empty': "还没有项目。用下面的「添加项目」选一个目录。";
     readonly 'project.add': "添加项目…";
+    readonly 'project.search.label': "搜索工作区";
+    readonly 'project.search.placeholder': "搜索工作区（目录名 / 中文名 / 路径）";
+    readonly 'project.search.empty': "没有匹配「{query}」的工作区。";
+    readonly 'project.rename.row': "改「{name}」的中文名";
+    readonly 'project.rename.current': "改当前工作区的中文名…";
+    readonly 'project.rename.title': "给「{name}」配一个中文名";
+    readonly 'project.rename.description': "显示在目录名后面。改的是工作区本身的名字。";
+    readonly 'project.rename.field': "中文名";
+    readonly 'project.rename.placeholder': "例如：工作台外壳";
+    readonly 'project.rename.hint': "留空 = 只显示目录名";
+    readonly 'project.rename.save': "保存";
+    readonly 'project.rename.saving': "保存中…";
+    readonly 'project.rename.cancel': "取消";
+    readonly 'project.rename.failed': "改名失败了，再试一次。";
     readonly 'session.new': "新会话";
     readonly 'session.new.label': "在当前项目新建会话";
     readonly 'session.empty': "这个项目还没有会话。";
@@ -35,6 +49,7 @@ export declare const zh: {
     readonly 'panels.dragHint': "拖动调整顺序";
     readonly 'panels.unknownStep': "这一层没有套件提供";
     readonly 'panels.labelWithHint': "{label}（{hint}）";
+    readonly 'panels.dep.failed': "⚠ 起不来";
     readonly 'panels.dep.missingPlugin': "⚠ 还没装好";
     readonly 'panels.dep.missingCommands': "⚠ 需要更新";
     readonly 'panels.dep.unchecked': "⚠ 检测不了";
@@ -228,6 +243,8 @@ export declare const zh: {
     readonly 'blocker.exec.hint': "确认 opencli 已安装且在 PATH 里（which opencli）。";
     readonly 'blocker.unknown.title': "出了点问题";
     readonly 'panels.reading': "正在读取面板配置…";
+    readonly 'panels.cardBroken': "这个模块起不来：{unit}（{reason}）";
+    readonly 'panels.cardRetry': "重试";
     readonly 'panels.empty': "面板里还没有模块";
     readonly 'panels.emptyHint': "也可以直接跟 agent 说：「把某个模块加到面板」。";
     readonly 'env.title': "准备工作台";
@@ -266,6 +283,8 @@ export declare const zh: {
     readonly 'env.step.warm': "预热站点登录态";
     readonly 'env.warm.done': "已预热 {n} 个站点";
     readonly 'env.warm.short': "这次没热上 —— 不影响用，面板第一次读取会自己补";
+    readonly 'env.unit.failed': "这个模块起不来";
+    readonly 'env.unit.failedHint': "它自己装配时报了错，别的模块不受影响。";
     readonly 'env.unit.missingPlugin': "这个模块还没装好";
     readonly 'env.unit.missingCommandsHint': "更新之后就能用了。";
     readonly 'env.unit.unchecked': "检测不了：拿不到执行通道";

package/dist/i18n/zh.js

@@ -7,6 +7,20 @@ export const zh = {
     'project.none': '未选择项目',
     'project.empty': '还没有项目。用下面的「添加项目」选一个目录。',
     'project.add': '添加项目…',
+    'project.search.label': '搜索工作区',
+    'project.search.placeholder': '搜索工作区（目录名 / 中文名 / 路径）',
+    'project.search.empty': '没有匹配「{query}」的工作区。',
+    'project.rename.row': '改「{name}」的中文名',
+    'project.rename.current': '改当前工作区的中文名…',
+    'project.rename.title': '给「{name}」配一个中文名',
+    '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': '这个项目还没有会话。',
@@ -35,6 +49,7 @@ export const zh = {
     'panels.dragHint': '拖动调整顺序',
     'panels.unknownStep': '这一层没有套件提供',
     'panels.labelWithHint': '{label}（{hint}）',
+    'panels.dep.failed': '⚠ 起不来',
     'panels.dep.missingPlugin': '⚠ 还没装好',
     'panels.dep.missingCommands': '⚠ 需要更新',
     'panels.dep.unchecked': '⚠ 检测不了',
@@ -228,6 +243,8 @@ export const zh = {
     'blocker.exec.hint': '确认 opencli 已安装且在 PATH 里（which opencli）。',
     'blocker.unknown.title': '出了点问题',
     'panels.reading': '正在读取面板配置…',
+    'panels.cardBroken': '这个模块起不来：{unit}（{reason}）',
+    'panels.cardRetry': '重试',
     'panels.empty': '面板里还没有模块',
     'panels.emptyHint': '也可以直接跟 agent 说：「把某个模块加到面板」。',
     'env.title': '准备工作台',
@@ -266,6 +283,8 @@ export const zh = {
     'env.step.warm': '预热站点登录态',
     'env.warm.done': '已预热 {n} 个站点',
     'env.warm.short': '这次没热上 —— 不影响用，面板第一次读取会自己补',
+    'env.unit.failed': '这个模块起不来',
+    'env.unit.failedHint': '它自己装配时报了错，别的模块不受影响。',
     'env.unit.missingPlugin': '这个模块还没装好',
     'env.unit.missingCommandsHint': '更新之后就能用了。',
     'env.unit.unchecked': '检测不了：拿不到执行通道',

package/dist/index.d.ts

@@ -14,6 +14,7 @@ export * from './components/Activity.js';
 export * from './components/ApprovalDetail.js';
 export * from './components/ApprovalPlan.js';
 export * from './components/Card.js';
+export * from './components/CardBoundary.js';
 export * from './components/CardHead.js';
 export * from './components/ChoiceGroup.js';
 export * from './components/LongTaskRow.js';

package/dist/index.js

@@ -14,6 +14,7 @@ export * from './components/Activity.js';
 export * from './components/ApprovalDetail.js';
 export * from './components/ApprovalPlan.js';
 export * from './components/Card.js';
+export * from './components/CardBoundary.js';
 export * from './components/CardHead.js';
 export * from './components/ChoiceGroup.js';
 export * from './components/LongTaskRow.js';

package/dist/lib/react.d.ts

@@ -1,6 +1,7 @@
 import type * as ReactTypes from 'react';
 export declare const h: typeof ReactTypes.createElement;
 export declare const Fragment: ReactTypes.ExoticComponent<ReactTypes.FragmentProps>;
+export declare const Component: typeof ReactTypes.Component;
 export declare const useState: typeof ReactTypes.useState;
 export declare const useEffect: typeof ReactTypes.useEffect;
 export declare const useLayoutEffect: typeof ReactTypes.useLayoutEffect;

package/dist/lib/react.js

@@ -1,6 +1,7 @@
 const react = require('react');
 export const h = react.createElement;
 export const Fragment = react.Fragment;
+export const Component = react.Component;
 export const useState = react.useState;
 export const useEffect = react.useEffect;
 export const useLayoutEffect = react.useLayoutEffect;

package/package.json

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

package/src/api/__tests__/blocker-table.test.ts

@@ -141,6 +141,19 @@ describe('blockerOfCapability', () => {
     expect(blockerOfCapability(capability({ status: 'ok', plugin: 'coding' }), t)).toBeUndefined();
   });
 
+  it('★ 起不来（模块自己装配炸了）→ 只说"起不来" + 把宿主给的原因原样附上，不给装/卸的按钮', () => {
+    const blocker = blockerOfCapability(
+      capability({ status: 'failed', detail: '模块自己的 bug：kit.components.StateBlock 取不到' }),
+      t,
+    );
+
+    expect(blocker?.id).toBe('unit-mount-failed');
+    expect(blocker?.title).toBe('env.unit.failed');
+    expect(blocker?.detail).toBe('模块自己的 bug：kit.components.StateBlock 取不到');
+    expect(blocker?.hint).toBe('env.unit.failedHint');
+    expect(blocker?.actions.map((action) => action.kind)).toEqual(['retry']);
+  });
+
   it('★ 没装好 → 标题只说"这个模块还没装好"，**不点名插件**（用户不认识插件）', () => {
     const blocker = blockerOfCapability(
       capability({

package/src/api/blocker-table.ts

@@ -122,6 +122,17 @@ export function blockerOfCapability(capability: CapabilityPayload, t: Translate)
     ...(capability.command === undefined || sourceUnknown ? [] : [copyAction(t, capability.command)]),
   ];
 
+  if (capability.status === 'failed') {
+    return {
+      id: 'unit-mount-failed',
+      severity: 'block',
+      title: t('env.unit.failed'),
+      hint: t('env.unit.failedHint'),
+      ...(capability.detail === undefined ? {} : { detail: capability.detail }),
+      actions: [retryAction(t)],
+    };
+  }
+
   if (capability.status === 'missing-plugin') {
     return {
       id: 'unit-missing-plugin',

package/src/api/dsh-client.ts

@@ -113,8 +113,14 @@ export interface DshUiWorkspace {
   pickDirectory(): Promise<string | null>;
 }
 
+export interface DshWorkspaceWritten {
+  readonly workspaceId?: string;
+  readonly title?: string;
+}
+
 export interface DshWorkspaces {
-  create(request: { path: string }): Promise<{ workspaceId?: string } | undefined>;
+  create(request: { path: string }): Promise<DshWorkspaceWritten | undefined>;
+  rename(workspaceId: string, title: string): Promise<DshWorkspaceWritten>;
 }
 
 export interface DshReferenceInsert {

package/src/api/workbench-contract.ts

@@ -21,7 +21,7 @@ export interface PluginStatePayload {
 
 export interface CapabilityPayload {
   readonly unit: string;
-  readonly status: 'ok' | 'missing-commands' | 'missing-plugin' | 'unchecked';
+  readonly status: 'ok' | 'failed' | 'missing-commands' | 'missing-plugin' | 'unchecked';
   readonly plugin?: string;
   readonly required: readonly string[];
   readonly missing: readonly string[];

package/src/components/ApprovalDetail.tsx

@@ -2,6 +2,7 @@ import type { Translate } from '../api/dsh-client.js';
 import type { ApprovalInput, UnitClientFace } from '../components/board-module.js';
 import { h } from '../lib/react.js';
 import { CodeBlock } from '@deepseek-ai/dsh-client-ui-primitives';
+import { CardBoundary } from './CardBoundary.js';
 import './ApprovalDetail.css';
 
 interface ToolCallRoot {
@@ -53,7 +54,14 @@ export function ApprovalDetail(props: ApprovalDetailProps) {
   const command = typeof args.command === 'string' ? args.command : '';
 
   const owner = (props.units ?? []).find((face) => face.approval?.tools.includes(input.tool) === true);
-  if (owner?.approval !== undefined) return <owner.approval.render input={input} t={t} />;
+  if (owner?.approval !== undefined) {
+    const Render = owner.approval.render;
+    return (
+      <CardBoundary unit={owner.manifest.id} resetKey={props.callId ?? ''} t={t}>
+        <Render input={input} t={t} />
+      </CardBoundary>
+    );
+  }
 
   if (command === '') return null;
   return (

package/src/components/CardBoundary.tsx

@@ -0,0 +1,56 @@
+import { Button } from '@deepseek-ai/dsh-client-ui-primitives';
+import type { Translate } from '../api/dsh-client.js';
+import type { ReactNode } from '../lib/react.js';
+import { Component, h } from '../lib/react.js';
+import { Note } from './Note.js';
+
+export interface CardBoundaryProps {
+  readonly unit: string;
+  readonly resetKey: string;
+  readonly t: Translate;
+  readonly children?: ReactNode | undefined;
+}
+
+export interface CardBoundaryState {
+  readonly reason: string | null;
+}
+
+export function errorReasonOf(error: unknown): string {
+  if (error instanceof Error) return error.message;
+  return typeof error === 'string' ? error : JSON.stringify(error) ?? String(error);
+}
+
+export class CardBoundary extends Component<CardBoundaryProps, CardBoundaryState> {
+  override state: CardBoundaryState = { reason: null };
+
+  static getDerivedStateFromError(error: unknown): CardBoundaryState {
+    return { reason: errorReasonOf(error) };
+  }
+
+  override componentDidCatch(error: unknown): void {
+    console.error(`[dsh-workbench] 模块 ${this.props.unit} 渲染失败：${errorReasonOf(error)}`, error);
+  }
+
+  override componentDidUpdate(previous: CardBoundaryProps): void {
+    if (previous.resetKey !== this.props.resetKey && this.state.reason !== null) {
+      this.setState({ reason: null });
+    }
+  }
+
+  private readonly retry = (): void => {
+    this.setState({ reason: null });
+  };
+
+  override render(): ReactNode {
+    const { reason } = this.state;
+    if (reason === null) return this.props.children;
+    return (
+      <Note tone="problem">
+        <span>{this.props.t('panels.cardBroken', { unit: this.props.unit, reason })}</span>{' '}
+        <Button type="button" variant="outline" size="sm" onClick={this.retry}>
+          {this.props.t('panels.cardRetry')}
+        </Button>
+      </Note>
+    );
+  }
+}

package/src/host/unit-libs.ts

@@ -27,7 +27,7 @@ export interface UnitPluginState {
 
 export interface UnitCapability {
   readonly unit: string;
-  readonly status: "ok" | "missing-commands" | "missing-plugin" | "unchecked";
+  readonly status: "ok" | "failed" | "missing-commands" | "missing-plugin" | "unchecked";
   readonly plugin?: string;
   readonly required: readonly string[];
   readonly missing: readonly string[];

package/src/i18n/en.ts

@@ -10,6 +10,20 @@ export const en: Record<keyof WorkbenchMessages, string> = {
   'project.none': 'No project',
   'project.empty': 'No projects yet. Use “Add project” below.',
   'project.add': 'Add project…',
+  'project.search.label': 'Search workspaces',
+  'project.search.placeholder': 'Search workspaces (folder / name / path)',
+  'project.search.empty': 'No workspace matches “{query}”.',
+  'project.rename.row': 'Rename “{name}”',
+  'project.rename.current': 'Give this workspace a display name…',
+  'project.rename.title': 'Give “{name}” a display name',
+  'project.rename.description': 'Shown after the folder name. It renames the workspace itself.',
+  'project.rename.field': 'Display name',
+  'project.rename.placeholder': 'e.g. Workbench shell',
+  'project.rename.hint': 'Empty = folder name only',
+  'project.rename.save': 'Save',
+  'project.rename.saving': 'Saving…',
+  'project.rename.cancel': 'Cancel',
+  'project.rename.failed': 'Rename failed. Try again.',
   'session.new': 'New session',
   'session.new.label': 'Start a session in the current project',
   'session.empty': 'No sessions in this project yet.',
@@ -40,6 +54,7 @@ export const en: Record<keyof WorkbenchMessages, string> = {
   'panels.dragHint': 'Drag to reorder',
   'panels.unknownStep': 'No suite provides this view',
   'panels.labelWithHint': '{label} ({hint})',
+  'panels.dep.failed': '⚠ failed to start',
   'panels.dep.missingPlugin': '⚠ not ready yet',
   'panels.dep.missingCommands': '⚠ needs an update',
   'panels.dep.unchecked': '⚠ cannot check',
@@ -235,6 +250,8 @@ export const en: Record<keyof WorkbenchMessages, string> = {
   'blocker.exec.hint': 'Make sure opencli is installed and on PATH (which opencli).',
   'blocker.unknown.title': 'Something went wrong',
   'panels.reading': 'Reading the panel setup…',
+  'panels.cardBroken': 'This module will not render: {unit} ({reason})',
+  'panels.cardRetry': 'Retry',
   'panels.empty': 'No modules on the panel yet',
   'panels.emptyHint': 'You can also just tell the agent: “add a module to the panel”.',
   'env.title': 'Preparing the workbench',
@@ -273,6 +290,8 @@ export const en: Record<keyof WorkbenchMessages, string> = {
   'env.step.warm': 'Warming up site sessions',
   'env.warm.done': '{n} site(s) warmed up',
   'env.warm.short': 'Not warmed this time — harmless; the panel heals on first read',
+  'env.unit.failed': 'This module cannot start',
+  'env.unit.failedHint': 'It failed while assembling itself; other modules are unaffected.',
   'env.unit.missingPlugin': 'This module is not ready yet',
   'env.unit.missingCommandsHint': 'Updating it should fix this.',
   'env.unit.unchecked': 'Cannot check: no shell channel',

package/src/i18n/merge.test.ts

@@ -1,5 +1,5 @@
 import { describe, expect, it } from 'vitest';
-import { mergeMessages } from './merge.js';
+import { mergeMessages, mergeMessagesSkipping } from './merge.js';
 
 const base = { zh: { 'board.title': '看板' }, en: { 'board.title': 'Board' } };
 
@@ -58,3 +58,64 @@ describe('mergeMessages', () => {
     ).toThrow(/是空的/);
   });
 });
+
+describe('mergeMessagesSkipping', () => {
+  const good = {
+    unit: 'issues',
+    messages: { zh: { 'issues.mine': '我的缺陷' }, en: { 'issues.mine': 'My defects' } },
+  };
+  const bad = {
+    unit: 'cmdb',
+    messages: { zh: { 'wrong.prefix': '错了' }, en: { 'wrong.prefix': 'nope' } },
+  };
+  const later = {
+    unit: 'builds',
+    messages: { zh: { 'builds.recent': '最近构建' }, en: { 'builds.recent': 'Recent builds' } },
+  };
+
+  it('★ 一份坏文案只废它自己：好的照并、坏的报出来', () => {
+    const { dictionaries, problems } = mergeMessagesSkipping(base, [good, bad, later]);
+
+    expect(dictionaries.zh).toEqual({
+      'board.title': '看板',
+      'issues.mine': '我的缺陷',
+      'builds.recent': '最近构建',
+    });
+    expect(dictionaries.en['builds.recent']).toBe('Recent builds');
+    expect(problems).toHaveLength(1);
+    expect(problems[0]?.unit).toBe('cmdb');
+    expect(problems[0]?.reason).toMatch(/必须以 "cmdb\." 开头/);
+  });
+
+  it('★ 坏的在前、好的在后：后面那份不受影响（不会因为前者坏就整批拒收）', () => {
+    const { dictionaries, problems } = mergeMessagesSkipping(base, [bad, good]);
+
+    expect(dictionaries.zh['issues.mine']).toBe('我的缺陷');
+    expect(problems.map((item) => item.unit)).toEqual(['cmdb']);
+  });
+
+  it('都好时与 mergeMessages 逐字一致、没有问题', () => {
+    const { dictionaries, problems } = mergeMessagesSkipping(base, [good, later]);
+
+    expect(dictionaries).toEqual(mergeMessages(base, [good, later]));
+    expect(problems).toEqual([]);
+  });
+
+  it('与外壳自己的键撞名的那份被跳过，且报的是撞名的双方', () => {
+    const clash = {
+      unit: 'board',
+      messages: { zh: { 'board.title': '看板改' }, en: { 'board.title': 'Board!' } },
+    };
+    const { dictionaries, problems } = mergeMessagesSkipping(base, [clash]);
+
+    expect(dictionaries.zh['board.title']).toBe('看板');
+    expect(problems[0]?.reason).toMatch(/文案键冲突：board\.title 由 外壳 与 board/);
+  });
+
+  it('没带文案的那份直接跳过，不算问题', () => {
+    const { dictionaries, problems } = mergeMessagesSkipping(base, [{ unit: 'nothing' }]);
+
+    expect(dictionaries).toEqual(base);
+    expect(problems).toEqual([]);
+  });
+});

package/src/i18n/merge.ts

@@ -52,3 +52,39 @@ export function mergeMessages(
 
   return { zh, en };
 }
+
+export interface MessagesProblem {
+  readonly unit: string;
+  readonly reason: string;
+}
+
+export interface MessagesMerge {
+  readonly dictionaries: Dictionaries;
+  readonly problems: readonly MessagesProblem[];
+}
+
+function reasonOf(error: unknown): string {
+  if (error instanceof Error) return error.message;
+  return typeof error === 'string' ? error : String(error);
+}
+
+export function mergeMessagesSkipping(
+  base: Dictionaries,
+  contributions: readonly MessagesContribution[],
+): MessagesMerge {
+  let dictionaries = base;
+  const accepted: MessagesContribution[] = [];
+  const problems: MessagesProblem[] = [];
+
+  for (const item of contributions) {
+    if (item.messages === undefined) continue;
+    try {
+      dictionaries = mergeMessages(base, [...accepted, item]);
+      accepted.push(item);
+    } catch (error) {
+      problems.push({ unit: item.unit, reason: reasonOf(error) });
+    }
+  }
+
+  return { dictionaries, problems };
+}

package/src/i18n/zh.ts

@@ -8,6 +8,20 @@ export const zh = {
   'project.none': '未选择项目',
   'project.empty': '还没有项目。用下面的「添加项目」选一个目录。',
   'project.add': '添加项目…',
+  'project.search.label': '搜索工作区',
+  'project.search.placeholder': '搜索工作区（目录名 / 中文名 / 路径）',
+  'project.search.empty': '没有匹配「{query}」的工作区。',
+  'project.rename.row': '改「{name}」的中文名',
+  'project.rename.current': '改当前工作区的中文名…',
+  'project.rename.title': '给「{name}」配一个中文名',
+  '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': '这个项目还没有会话。',
@@ -38,6 +52,7 @@ export const zh = {
   'panels.dragHint': '拖动调整顺序',
   'panels.unknownStep': '这一层没有套件提供',
   'panels.labelWithHint': '{label}（{hint}）',
+  'panels.dep.failed': '⚠ 起不来',
   'panels.dep.missingPlugin': '⚠ 还没装好',
   'panels.dep.missingCommands': '⚠ 需要更新',
   'panels.dep.unchecked': '⚠ 检测不了',
@@ -231,6 +246,8 @@ export const zh = {
   'blocker.exec.hint': '确认 opencli 已安装且在 PATH 里（which opencli）。',
   'blocker.unknown.title': '出了点问题',
   'panels.reading': '正在读取面板配置…',
+  'panels.cardBroken': '这个模块起不来：{unit}（{reason}）',
+  'panels.cardRetry': '重试',
   'panels.empty': '面板里还没有模块',
   'panels.emptyHint': '也可以直接跟 agent 说：「把某个模块加到面板」。',
   'env.title': '准备工作台',
@@ -269,6 +286,8 @@ export const zh = {
   'env.step.warm': '预热站点登录态',
   'env.warm.done': '已预热 {n} 个站点',
   'env.warm.short': '这次没热上 —— 不影响用，面板第一次读取会自己补',
+  'env.unit.failed': '这个模块起不来',
+  'env.unit.failedHint': '它自己装配时报了错，别的模块不受影响。',
   'env.unit.missingPlugin': '这个模块还没装好',
   'env.unit.missingCommandsHint': '更新之后就能用了。',
   'env.unit.unchecked': '检测不了：拿不到执行通道',

package/src/index.ts

@@ -14,6 +14,7 @@ export * from './components/Activity.js';
 export * from './components/ApprovalDetail.js';
 export * from './components/ApprovalPlan.js';
 export * from './components/Card.js';
+export * from './components/CardBoundary.js';
 export * from './components/CardHead.js';
 export * from './components/ChoiceGroup.js';
 export * from './components/LongTaskRow.js';

package/src/lib/react.ts

@@ -6,6 +6,8 @@ export const h = react.createElement;
 
 export const Fragment = react.Fragment;
 
+export const Component = react.Component;
+
 export const useState = react.useState;
 export const useEffect = react.useEffect;
 export const useLayoutEffect = react.useLayoutEffect;