@dsh-workbench/shared 0.3.10 → 1.0.0-beta.0

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

@@ -1,6 +1,7 @@
 import { describe, expect, it } from 'vitest';
-import type { Translate } from '../dsh-client.js';
-import type { CapabilityPayload } from '../workbench-contract.js';
+import type { Translate } from '../../lib/dsh-client.js';
+import type { CapabilityPayload } from '../../contract/workbench-contract.js';
+import type { NeedState } from '../../contract/unit-capability.js';
 import { blockerOfCapability, blockerOfError } from '../blocker-table.js';
 
 const t: Translate = (key, params) => (params === undefined ? key : `${key}(${JSON.stringify(params)})`);
@@ -8,7 +9,7 @@ const t: Translate = (key, params) => (params === undefined ? key : `${key}(${JS
 describe('blockerOfError', () => {
   it('未登录 + 有登录页地址 → 行内「去登录 ↗」+ 一颗手动「重试」（不安排自动重试）', () => {
     const blocker = blockerOfError(
-      { code: 'auth-required', message: '未登录 CODING', helpUrl: 'https://x.coding.net/login' },
+      { code: 'auth-required', message: '未登录 Acme', helpUrl: 'https://example.com/login' },
       t,
     );
 
@@ -18,7 +19,7 @@ describe('blockerOfError', () => {
       {
         kind: 'open-url',
         label: 'blocker.login.go',
-        url: 'https://x.coding.net/login',
+        url: 'https://example.com/login',
         inline: true,
       },
       { kind: 'retry', label: 'blocker.retry' },
@@ -27,20 +28,20 @@ describe('blockerOfError', () => {
   });
 
   it('平台名由**调用方**给（同一个"未登录"能服务不同平台）', () => {
-    const coding = blockerOfError(
-      { code: 'auth-required', message: '未登录', helpUrl: 'https://x.coding.net/login' },
+    const demo = blockerOfError(
+      { code: 'auth-required', message: '未登录', helpUrl: 'https://example.com/login' },
       t,
-      { platform: 'Coding' },
+      { platform: 'Acme' },
     );
-    const cmdb = blockerOfError(
-      { code: 'auth-required', message: '未登录', helpUrl: 'https://cmdb.example.cn/login' },
+    const inventory = blockerOfError(
+      { code: 'auth-required', message: '未登录', helpUrl: 'https://inventory.example.cn/login' },
       t,
-      { platform: 'CMDB' },
+      { platform: 'Inventory' },
     );
 
-    expect(coding.title).toContain('"platform":"Coding"');
-    expect(cmdb.title).toContain('"platform":"CMDB"');
-    expect(cmdb.actions[0]).toMatchObject({ kind: 'open-url', url: 'https://cmdb.example.cn/login' });
+    expect(demo.title).toContain('"platform":"Acme"');
+    expect(inventory.title).toContain('"platform":"Inventory"');
+    expect(inventory.actions[0]).toMatchObject({ kind: 'open-url', url: 'https://inventory.example.cn/login' });
   });
 
   it('没给平台名 → 用不带名字的文案（不猜平台）', () => {
@@ -58,15 +59,15 @@ describe('blockerOfError', () => {
 
   it('权限不足 → block，主动作「打开权限页」（地址同样来自信封）', () => {
     const blocker = blockerOfError(
-      { code: 'permission-denied', message: '没有权限', helpUrl: 'https://x.coding.net/p/x/settings' },
+      { code: 'permission-denied', message: '没有权限', helpUrl: 'https://example.com/p/x/settings' },
       t,
-      { platform: 'Coding' },
+      { platform: 'Acme' },
     );
 
     expect(blocker.id).toBe('permission-denied');
     expect(blocker.severity).toBe('block');
-    expect(blocker.title).toContain('"platform":"Coding"');
-    expect(blocker.actions[0]).toMatchObject({ kind: 'open-url', url: 'https://x.coding.net/p/x/settings' });
+    expect(blocker.title).toContain('"platform":"Acme"');
+    expect(blocker.actions[0]).toMatchObject({ kind: 'open-url', url: 'https://example.com/p/x/settings' });
   });
 
   it('权限不足但没有地址 → 只给重试（不编一个页面出来）', () => {
@@ -102,33 +103,38 @@ describe('blockerOfError', () => {
   });
 });
 
+function needOf(patch: Partial<NeedState> & { kind: NeedState['kind']; name: string }): NeedState {
+  return { id: patch.id ?? `${patch.kind}:${patch.name}`, status: 'ok', detail: '', ...patch };
+}
+
 function capability(patch: Partial<CapabilityPayload>): CapabilityPayload {
-  return {
-    unit: 'issues',
-    status: 'ok',
-    required: [],
-    missing: [],
-    detail: '',
-    ...patch,
-  };
+  return { unit: 'issues', status: 'ok', needs: [], ...patch };
 }
 
 describe('blockerOfCapability', () => {
   it('就绪 → 没有阻断', () => {
     expect(blockerOfCapability(capability({}), t)).toBeUndefined();
-  });
-
-  it('就绪 → 没有阻断（**没有**"能凑合用但提示一下"的中间态了，见 ADR-0016）', () => {
-    expect(blockerOfCapability(capability({ status: 'ok', plugin: 'coding' }), t)).toBeUndefined();
+    expect(
+      blockerOfCapability(
+        capability({ needs: [needOf({ kind: 'extension', name: 'demo', status: 'ok' })] }),
+        t,
+      ),
+    ).toBeUndefined();
   });
 
   it('★ 缺哪些命令只出现在 detail（排障区），标题里没有命令名', () => {
     const blocker = blockerOfCapability(
       capability({
-        status: 'missing-commands',
-        plugin: 'coding',
-        missing: ['issue-detail'],
-        detail: '1 份安装都在（缺必需：issue-detail）',
+        status: 'missing',
+        needs: [
+          needOf({
+            kind: 'extension',
+            name: 'demo',
+            status: 'missing',
+            missing: ['issue-detail'],
+            detail: '1 份安装都在（缺必需：issue-detail）',
+          }),
+        ],
       }),
       t,
     );
@@ -137,11 +143,7 @@ describe('blockerOfCapability', () => {
     expect(blocker?.detail).toContain('issue-detail');
   });
 
-  it('降级那一档已经不存在（`ok` 就是没阻断）', () => {
-    expect(blockerOfCapability(capability({ status: 'ok', plugin: 'coding' }), t)).toBeUndefined();
-  });
-
-  it('★ 起不来（模块自己装配炸了）→ 只说"起不来" + 把宿主给的原因原样附上，不给装/卸的按钮', () => {
+  it('★ 起不来（模块自己装配炸了）→ 只说"起不来" + 原样附原因，不给装/卸按钮', () => {
     const blocker = blockerOfCapability(
       capability({ status: 'failed', detail: '模块自己的 bug：kit.components.StateBlock 取不到' }),
       t,
@@ -154,46 +156,99 @@ describe('blockerOfCapability', () => {
     expect(blocker?.actions.map((action) => action.kind)).toEqual(['retry']);
   });
 
-  it('★ 没装好 → 标题只说"这个模块还没装好"，**不点名插件**（用户不认识插件）', () => {
+  it('★ 未知 kind（模块跑在更新的工作台上）→ 单独一档，叫升级工作台，不猜怎么修', () => {
+    const blocker = blockerOfCapability(
+      capability({ status: 'unsupported', detail: 'needs[0].kind 不认识 —— "dsh-bundle"' }),
+      t,
+    );
+
+    expect(blocker?.id).toBe('unit-unsupported');
+    expect(blocker?.title).toBe('env.unit.unsupported');
+    expect(blocker?.severity).toBe('block');
+    expect(blocker?.actions.map((action) => action.kind)).toEqual(['retry']);
+  });
+
+  it('★ 可选的没装（required: false）→ notice，不挡卡片', () => {
+    const blocker = blockerOfCapability(
+      capability({
+        status: 'degraded',
+        needs: [needOf({ kind: 'bin', name: 'gitops', status: 'missing', detail: '这台机器上找不到 gitops' })],
+      }),
+      t,
+    );
+
+    expect(blocker?.id).toBe('unit-degraded');
+    expect(blocker?.severity).toBe('notice');
+    expect(blocker?.detail).toContain('gitops');
+  });
+
+  it('★ 缺二进制命令 → 标题按 kind 出（不是"缺插件"），并给复制命令', () => {
     const blocker = blockerOfCapability(
       capability({
-        status: 'missing-plugin',
-        plugin: 'coding',
-        missing: ['issues'],
-        command: 'opencli plugin install <coding 插件源>',
+        status: 'missing',
+        needs: [needOf({ kind: 'bin', name: 'gitops', status: 'missing', command: 'brew install gitops' })],
       }),
       t,
     );
 
-    expect(blocker?.id).toBe('unit-missing-plugin');
-    expect(blocker?.title).toBe('env.unit.missingPlugin');
-    expect(blocker?.title).not.toContain('coding');
-    expect(blocker?.hint).not.toContain('插件');
+    expect(blocker?.id).toBe('unit-need-bin-missing');
+    expect(blocker?.title).toBe('env.need.bin.missing');
     expect(blocker?.actions.map((action) => action.kind)).toEqual(['copy', 'retry']);
   });
 
-  it('能一键修时，主动作是「帮我升级」并带上 { action, unit }（命令由宿主侧决定）', () => {
+  it('extension 装了但版本旧 → 标题是「版本旧了」那一档，不是「没装」', () => {
+    const blocker = blockerOfCapability(
+      capability({
+        status: 'outdated',
+        needs: [needOf({ kind: 'extension', name: 'demo', status: 'outdated' })],
+      }),
+      t,
+    );
+
+    expect(blocker?.id).toBe('unit-need-extension-outdated');
+    expect(blocker?.title).toBe('env.need.extension.outdated');
+  });
+
+  it('来源解析得出 → 主动作是「帮我安装」+ 复制命令', () => {
     const blocker = blockerOfCapability(
-      capability({ status: 'missing-commands', plugin: 'coding', missing: ['issue-detail'], fix: 'update' }),
+      capability({
+        status: 'missing',
+        needs: [
+          needOf({
+            kind: 'extension',
+            name: 'demo',
+            status: 'missing',
+            provision: 'ready',
+            command: 'opencli plugin install /some/path',
+          }),
+        ],
+      }),
       t,
     );
 
+    expect(blocker?.actions.map((action) => action.kind)).toEqual(['run-fix', 'copy', 'retry']);
     expect(blocker?.actions[0]).toEqual({
       kind: 'run-fix',
-      label: 'blocker.fix.update',
+      label: 'blocker.fix.install',
       unit: 'issues',
-      fix: 'update',
+      fix: 'install',
     });
   });
 
-  it('★ 来源解析不出（宿主给了 install 但不是 ready）→ 给「去模块市场」，不给注定失败的按钮', () => {
+  it('★ 来源解析不出（provision 不是 ready）→ 给「去模块市场」，不给注定失败的按钮', () => {
     for (const install of ['env-missing', 'not-declared', 'malformed'] as const) {
       const blocker = blockerOfCapability(
         capability({
-          status: 'missing-plugin',
-          plugin: 'coding',
-          command: 'opencli plugin install <coding 插件源>',
-          install,
+          status: 'missing',
+          needs: [
+            needOf({
+              kind: 'extension',
+              name: 'demo',
+              status: 'missing',
+              command: 'opencli plugin install <demo 插件源>',
+              provision: install,
+            }),
+          ],
         }),
         t,
       );
@@ -203,57 +258,52 @@ describe('blockerOfCapability', () => {
     }
   });
 
-  it('来源解析得出时仍然给「帮我安装」+ 复制命令（open-market 不该抢戏）', () => {
+  it('共用依赖版本不对 → 那一档标题', () => {
     const blocker = blockerOfCapability(
       capability({
-        status: 'missing-plugin',
-        plugin: 'coding',
-        command: 'opencli plugin install /some/path',
-        install: 'ready',
-        fix: 'install',
+        status: 'missing',
+        needs: [needOf({ kind: 'lib', name: 'opencli-workflow', status: 'unsatisfied' })],
       }),
       t,
     );
 
-    expect(blocker?.actions.map((action) => action.kind)).toEqual(['run-fix', 'copy', 'retry']);
+    expect(blocker?.title).toBe('env.need.lib.unsatisfied');
   });
 
-  it('缺插件且有来源 → 主动作是「帮我安装」', () => {
+  it('环境变量没设 → 只提醒，不给复制值', () => {
     const blocker = blockerOfCapability(
-      capability({ status: 'missing-plugin', plugin: 'coding', fix: 'install' }),
-      t,
-    );
-
-    expect(blocker?.actions[0]?.kind).toBe('run-fix');
-    expect(blocker?.actions[0]?.label).toBe('blocker.fix.install');
-    expect(blocker?.actions[0]).toMatchObject({ fix: 'install', unit: 'issues' });
-  });
-
-  it('缺命令（版本旧）→ 也给「帮我升级」', () => {
-    const blocker = blockerOfCapability(
-      capability({ status: 'missing-commands', plugin: 'coding', missing: ['issue-detail'], fix: 'update' }),
+      capability({
+        status: 'missing',
+        needs: [needOf({ kind: 'env', name: 'DSH_TOKEN', status: 'missing' })],
+      }),
       t,
     );
 
-    expect(blocker?.actions[0]?.kind).toBe('run-fix');
-    expect(blocker?.actions[0]?.label).toBe('blocker.fix.update');
+    expect(blocker?.title).toBe('env.need.env.missing');
+    expect(blocker?.actions.map((action) => action.kind)).toEqual(['retry']);
   });
 
-  it('缺命令 → 列出缺哪几个，并提示多半是版本旧', () => {
+  it('★ 只看第一条非 ok 的 need（顺序即优先级）', () => {
     const blocker = blockerOfCapability(
-      capability({ status: 'missing-commands', plugin: 'coding', missing: ['issue-detail'] }),
+      capability({
+        status: 'missing',
+        needs: [
+          needOf({ kind: 'bin', name: 'gitops', status: 'missing' }),
+          needOf({ kind: 'extension', name: 'demo', status: 'missing' }),
+        ],
+      }),
       t,
     );
 
-    expect(blocker?.id).toBe('unit-missing-commands');
-    expect(blocker?.title).toBe('env.unit.missingCommands');
-    expect(blocker?.title).not.toContain('issue-detail');
-    expect(blocker?.hint).toBe('env.unit.missingCommandsHint');
+    expect(blocker?.title).toBe('env.need.bin.missing');
   });
 
   it('探不动 → notice，**绝不**说成缺命令/缺插件，也不给"复制安装命令"', () => {
     const blocker = blockerOfCapability(
-      capability({ status: 'unchecked', plugin: 'coding', missing: ['issues', 'issue-detail'], detail: '拿不到执行通道' }),
+      capability({
+        status: 'unchecked',
+        needs: [needOf({ kind: 'extension', name: 'demo', status: 'unchecked', detail: '拿不到执行通道' })],
+      }),
       t,
     );
 
@@ -261,6 +311,5 @@ describe('blockerOfCapability', () => {
     expect(blocker?.severity).toBe('notice');
     expect(blocker?.title).toBe('env.unit.unchecked');
     expect(blocker?.actions.map((action) => action.kind)).toEqual(['retry']);
-    expect(blocker?.title).not.toContain('issue-detail');
   });
 });

package/src/api/blocker-table.ts

@@ -1,7 +1,7 @@
-import type { Translate } from './dsh-client.js';
-import type { CapabilityPayload } from './workbench-contract.js';
+import type { Translate } from '../lib/dsh-client.js';
+import type { CapabilityPayload } from '../contract/workbench-contract.js';
 import type { ApiError } from './workbench-client.js';
-import type { BlockerAction, ModuleBlocker } from './blocker.js';
+import type { BlockerAction, ModuleBlocker } from '../contract/blocker.js';
 import { shortenPath } from '../lib/ui.js';
 
 function retryAction(t: Translate): BlockerAction {
@@ -119,21 +119,24 @@ export function blockerOfError(
 export function blockerOfCapability(capability: CapabilityPayload, t: Translate): ModuleBlocker | undefined {
   if (capability.status === 'ok') return undefined;
 
+  const problem = capability.needs.find((need) => need.status !== 'ok');
+  const fix = problem?.provision === 'ready' ? 'install' : undefined;
   const fixAction: BlockerAction | undefined =
-    capability.fix === undefined
+    fix === undefined
       ? undefined
       : {
           kind: 'run-fix',
-          label: capability.fix === 'install' ? t('blocker.fix.install') : t('blocker.fix.update'),
+          label: t('blocker.fix.install'),
           unit: capability.unit,
-          fix: capability.fix,
+          fix,
         };
-  const sourceUnknown = capability.fix === undefined && capability.install !== undefined && capability.install !== 'ready';
+  const sourceUnknown = problem?.provision !== undefined && problem.provision !== 'ready';
   const install: readonly BlockerAction[] = [
     ...(fixAction === undefined ? [] : [fixAction]),
     ...(sourceUnknown ? [{ kind: 'open-market' as const, label: t('blocker.market.open'), unit: capability.unit }] : []),
-    ...(capability.command === undefined || sourceUnknown ? [] : [copyAction(t, capability.command)]),
+    ...(problem?.command === undefined || sourceUnknown ? [] : [copyAction(t, problem.command)]),
   ];
+  const detail = problem?.detail ?? capability.detail;
 
   if (capability.status === 'failed') {
     return {
@@ -146,34 +149,57 @@ export function blockerOfCapability(capability: CapabilityPayload, t: Translate)
     };
   }
 
-  if (capability.status === 'missing-plugin') {
+  if (capability.status === 'unsupported') {
     return {
-      id: 'unit-missing-plugin',
+      id: 'unit-unsupported',
       severity: 'block',
-      title: t('env.unit.missingPlugin'),
-      hint: t('env.unit.hint'),
-      ...(capability.detail === undefined ? {} : { detail: capability.detail }),
-      actions: [...install, retryAction(t)],
+      title: t('env.unit.unsupported'),
+      hint: t('env.unit.unsupportedHint'),
+      ...(detail === undefined ? {} : { detail }),
+      actions: [retryAction(t)],
     };
   }
 
-  if (capability.status === 'missing-commands') {
+  if (capability.status === 'degraded') {
     return {
-      id: 'unit-missing-commands',
-      severity: 'block',
-      title: t('env.unit.missingCommands'),
-      hint: t('env.unit.missingCommandsHint'),
+      id: 'unit-degraded',
+      severity: 'notice',
+      title: t('env.unit.degraded'),
+      hint: t('env.unit.degradedHint'),
+      ...(detail === undefined ? {} : { detail }),
+      actions: [retryAction(t)],
+    };
+  }
+
+  if (problem === undefined) {
+    return {
+      id: 'unit-unchecked',
+      severity: 'notice',
+      title: t('env.unit.unchecked'),
+      hint: t('env.unit.uncheckedHint'),
       ...(capability.detail === undefined ? {} : { detail: capability.detail }),
-      actions: [...install, retryAction(t)],
+      actions: [retryAction(t)],
+    };
+  }
+
+  if (problem.status === 'unchecked') {
+    return {
+      id: 'unit-unchecked',
+      severity: 'notice',
+      title: t('env.unit.unchecked'),
+      hint: t('env.unit.uncheckedHint'),
+      ...(detail === undefined ? {} : { detail }),
+      actions: [retryAction(t)],
     };
   }
 
+  const kindTitle = `env.need.${problem.kind}.${problem.status}`;
   return {
-    id: 'unit-unchecked',
-    severity: 'notice',
-    title: t('env.unit.unchecked'),
-    hint: t('env.unit.uncheckedHint'),
-    ...(capability.detail === undefined ? {} : { detail: capability.detail }),
-    actions: [retryAction(t)],
+    id: `unit-need-${problem.kind}-${problem.status}`,
+    severity: 'block',
+    title: t(kindTitle),
+    hint: t(`env.need.${problem.kind}.hint`),
+    ...(detail === undefined ? {} : { detail }),
+    actions: [...install, retryAction(t)],
   };
 }

package/src/api/dsh.ts

@@ -126,7 +126,7 @@ export interface DshHostContext {
       ) => Promise<{ kind: string; messages?: readonly unknown[] }>,
     ): (() => void) | undefined;
   };
-  get<T = unknown>(name: string): T | undefined;
+  get<T = unknown>(name: string, strict?: boolean): T | undefined;
   provide(name: string, value: unknown): () => void;
   effect(effect: () => void | (() => void), label?: string): () => void;
   inject(names: readonly string[], effect: (scoped: DshHostContext) => void): () => void;
@@ -229,6 +229,22 @@ export interface DshToolRunContext {
     | undefined;
 }
 
+/**
+ * dsh 的审批服务（服务名 `approval`）：读一个会话此刻生效的审批策略。
+ * 方法可选：服务缺席或老版本没有它时，调用方必须当成「不知道」而不是「已关闭」。
+ */
+export interface DshApprovalService {
+  effectivePolicy?(session: unknown): 'ask' | 'never' | undefined;
+}
+
+/**
+ * dsh 的沙箱策略服务（服务名 `sandboxPolicy`）：按会话解析这次调用生效的文件边界。
+ * 方法可选：服务缺席或老版本没有它时，调用方必须当成「不知道」而不是「完全放行」。
+ */
+export interface DshSandboxPolicy {
+  resolve?(request?: { readonly session?: unknown }): { readonly mode?: string } | undefined;
+}
+
 /**
  * dsh 的工具表；register 回的清理函数负责在插件卸载时摘掉这条工具。
  */

package/src/api/host-write.ts

@@ -1,5 +1,3 @@
-import type { ApiResponse } from './workbench-client.js';
-
 /**
  * 宿主写口的五条通道（偏好、动作、供给、工坊调试、工坊录制），是写路由的第一段。
  */
@@ -10,17 +8,6 @@ export type WriteChannel =
   | 'diy-debug'
   | 'diy-record';
 
-/**
- * 由通道与资源拼出写路由。
- * @param channel 写通道。
- * @param resource 该通道下的资源名。
- * @returns 路由字符串；provision 只有一段，其余是 channel/resource。
- */
-export function writeRoute(channel: WriteChannel, resource: string): string {
-  if (channel === 'provision') return 'provision';
-  return `${channel}/${resource}`;
-}
-
 /**
  * 写通道统一的结果：成了带值，没成带一句能给人看的话（可选明细与帮助链接）。
  */
@@ -32,33 +19,3 @@ export type WriteOutcome<T> =
       readonly detail?: string;
       readonly helpUrl?: string;
     };
-
-/**
- * 把写通道的响应翻成 WriteOutcome。
- * @param response 写口回的响应；null 表示请求本身没成（网络断了，宿主没答）。
- * @param networkText 拿不到任何服务端文案时兜底的那句。
- * @returns 失败时 message 优先用服务端自己的话，没有才用响应正文或 networkText。
- */
-export function writeOutcomeOf<T>(response: ApiResponse<T> | null, networkText: string): WriteOutcome<T> {
-  if (response === null) return { ok: false, message: networkText };
-  if (!response.ok) {
-    const box = response as {
-      readonly error?:
-        | { readonly message?: unknown; readonly detail?: unknown; readonly helpUrl?: unknown }
-        | undefined;
-      readonly text?: unknown;
-    };
-    const own = typeof box.error?.message === 'string' && box.error.message !== '' ? box.error.message : undefined;
-    const fallback = typeof box.text === 'string' && box.text !== '' ? box.text : networkText;
-    const detail = typeof box.error?.detail === 'string' ? box.error.detail : undefined;
-    const helpUrl =
-      typeof box.error?.helpUrl === 'string' && box.error.helpUrl !== '' ? box.error.helpUrl : undefined;
-    return {
-      ok: false,
-      message: own ?? fallback,
-      ...(detail === undefined ? {} : { detail }),
-      ...(helpUrl === undefined ? {} : { helpUrl }),
-    };
-  }
-  return { ok: true, value: response };
-}

package/src/api/workbench-client.test.ts

@@ -66,11 +66,11 @@ describe('apiGet', () => {
 
   it('宿主的 {ok:false} 信封原样返回，不抛异常', async () => {
     stubFetch({
-      body: { ok: false, error: { code: 'coding-not-logged-in', message: '登录态失效' } },
+      body: { ok: false, error: { code: 'demo-not-logged-in', message: '登录态失效' } },
     });
     const result = await apiGet('issues');
     expect(result.ok).toBe(false);
-    expect(result.ok === false && result.error.code).toBe('coding-not-logged-in');
+    expect(result.ok === false && result.error.code).toBe('demo-not-logged-in');
   });
 
   it('HTTP 非 2xx 也走结构化错误（不读 body）', async () => {

package/src/api/workbench-client.ts

@@ -46,8 +46,9 @@ export async function apiGet<T>(
     if (value !== undefined) search.set(key, String(value));
   }
   const suffix = search.toString();
+  const target = suffix === '' ? `${API_PREFIX}/${route}` : `${API_PREFIX}/${route}?${suffix}`;
 
-  const response = await fetch(`${API_PREFIX}/${route}${suffix ? `?${suffix}` : ''}`, {
+  const response = await fetch(target, {
     method: 'GET',
     headers: { accept: 'application/json' },
     ...(signal === undefined ? {} : { signal }),

package/src/components/Activity.css

@@ -1,4 +1,3 @@
-
 .wb-activityBlock {
   display: flex;
   flex-direction: column;

package/src/components/ApprovalDetail.css

@@ -1,4 +1,3 @@
-
 .wb-approvalCommand {
   max-width: 100%;
-}
+}

package/src/components/ApprovalDetail.tsx

@@ -1,4 +1,4 @@
-import type { Translate } from '../api/dsh-client.js';
+import type { Translate } from '../lib/dsh-client.js';
 import type { ApprovalInput, UnitClientFace } from '../components/board-module.js';
 import { Fragment, h, type ReactNode } from '../lib/react.js';
 import { CodeBlock } from '@deepseek-ai/dsh-client-ui-primitives';

package/src/components/ApprovalPlan.css

@@ -1,4 +1,3 @@
-
 .wb-approvalPlan {
   display: flex;
   flex-direction: column;

package/src/components/Card.css

@@ -1,4 +1,3 @@
-
 .wb-card {
   border: 0.5px solid var(--dsw-alias-border-l3);
   border-radius: var(--dsw-radius-xl);

package/src/components/Card.tsx

@@ -1,5 +1,5 @@
 import type { ReactNode } from '../lib/react.js';
-import type { Translate } from '../api/dsh-client.js';
+import type { Translate } from '../lib/dsh-client.js';
 import { h } from '../lib/react.js';
 import { CardHead } from './CardHead.js';
 import './Card.css';

package/src/components/CardAnchor.test.tsx

@@ -31,6 +31,6 @@ describe('外壳给每张卡盖的锚点', () => {
   it('★ 名字由 unit 拼出来：空 unit 不给 id（一个页面里 id 必须唯一）', () => {
     expect(cardIdOf(null)).toBeUndefined();
     expect(cardIdOf('')).toBeUndefined();
-    expect(cardIdOf('cmdb')).toBe('wb-card-cmdb');
+    expect(cardIdOf('inventory')).toBe('wb-card-inventory');
   });
 });

package/src/components/CardBoundary.tsx

@@ -1,5 +1,5 @@
 import { Button } from '@deepseek-ai/dsh-client-ui-primitives';
-import type { Translate } from '../api/dsh-client.js';
+import type { Translate } from '../lib/dsh-client.js';
 import type { ReactNode } from '../lib/react.js';
 import { Component, h } from '../lib/react.js';
 import { Note } from './Note.js';

package/src/components/CardHead.css

@@ -1,4 +1,3 @@
-
 .wb-cardHead {
   display: flex;
   align-items: center;

package/src/components/CardHead.tsx

@@ -1,5 +1,5 @@
 import type { ReactNode } from '../lib/react.js';
-import type { Translate } from '../api/dsh-client.js';
+import type { Translate } from '../lib/dsh-client.js';
 import {
   Button,
   IconRefreshOutlineRegular,