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

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-workbench contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,97 @@
+# @dsh-workbench/shared
+
+工作台与模块共用的**契约与纯代码**：类型、纯函数、哑组件、i18n、宿主侧工具。
+它不持有状态、不依赖外壳运行时、不产生全局副作用 —— 所以外壳和每个模块都可以各自打一份，
+不会打架。
+
+对模块作者来说，这里是「不用自己重画」的那一层：卡片壳、行、表单、链接、加载态都在
+`components/`，契约类型都在 `api/`。**dsh 有的原语走 kit，工作台自己的视觉用这里的组件**，
+两者拼出面板，不要从 DOM + CSS 重写一遍。
+
+## 三个入口
+
+| 入口 | 谁用 | 有什么 |
+|---|---|---|
+| `@dsh-workbench/shared` | 浏览器侧 | 契约类型、纯函数、哑组件（样式随组件）、i18n、读通道 `apiGet` / `factOfRoute` |
+| `@dsh-workbench/shared/host` | 宿主侧（Node） | 数据根、opencli 运行时、git、http、面板状态、单元声明、请求配方 composer、公共通道插件计划等，**有 `node:*`** |
+| `@dsh-workbench/shared/testing` | 测试 | 宿主侧假件、从 `package.json` 读模块声明 |
+
+两条硬边界：
+
+- **根入口是浏览器安全的**：不许出现 `node:*`。宿主侧取运行值只走 `/host`。
+- **模块源码对根入口只许 `import type`**：取运行值会在浏览器里打进第二份实例，也会让
+  `dist/host.js` 在 Node 里 import 不进来。这条由 module-tools 的 `source` 判据盯着。
+
+组件样式与组件同目录（`X.css` / `X.module.css`），构建时原样搬到 `dist/` —— 消费方不用另配
+CSS 处理。
+
+## 收录判据
+
+进这个包的东西要同时满足三条，缺一条就留在外壳里：
+
+1. **无模块级可变状态**：顶层 `let` / `var`、被写入的顶层 `Map` / `Set` 都不行。共享包会被每个
+   消费者各打一份，带状态就是各说各话。`scripts/check-state.mjs` 守这一条。
+2. **不依赖外壳运行时**：不 import 外壳的代码、不假设自己在哪一列里渲染。
+3. **不产生全局副作用**：import 即注册、改全局、读环境都不行；要环境就从参数或 `/host` 进。
+
+判断不了就问一句：**这份东西被复制成两份，会有什么坏结果？** 答案不是「没有」就别放进来。
+
+## 目录
+
+| 落点 | 是什么 |
+|---|---|
+| `src/api/` | 契约：单元清单、卡片面、读通道、写通道、长任务、审批、面板状态 |
+| `src/components/` | 哑组件：`Card` / `CardHead` / `Rows` / `Form` / `FormRow(s)` / `FormActions` / `Link` / `Stack` / 各态块 |
+| `src/config/` | 常量与存储键 |
+| `src/i18n/` | zh / en 字典、合并与设置 |
+| `src/lib/` | 纯函数：文本、忙碌态、表单问题、看板事实 |
+| `src/host/` | 宿主侧内核与领域：http、facts、面板状态、workspace、单元声明 |
+| `src/testing/` | 测试假件与声明读取 |
+
+`src/index.ts` 与 `src/host.ts` 是**生成的 barrel**：新增文件后跑 `pnpm run barrels`，别手抄。
+它会拦重名导出（`export *` 会静默丢掉其中一个）。
+
+## 怎么用
+
+```ts
+// 外壳
+import { Card, Rows, type UnitManifest } from '@dsh-workbench/shared';
+import { workbenchRoot } from '@dsh-workbench/shared/host';
+
+// 模块
+import type { UnitClientFace } from '@dsh-workbench/shared';
+import { kit } from '@dsh-workbench/core/client';
+```
+
+规矩按调用方分：
+
+- **外壳自己**从根入口取运行值（组件、`apiGet`…），它是这份代码的主人。
+- **模块**的组件从 kit 取：`import { kit } from '@dsh-workbench/core/client'`，根入口只许
+  `import type`。宿主侧要运行值走 `/host`，浏览器侧要纯函数走 kit —— 两侧都不该从根入口取，
+  否则浏览器会打进第二份实例、宿主侧会让 `dist/host.js` 在 Node 里 import 不进来。
+- 模块里只取类型时写成单独一行 `import type { … }`，别和运行值混在一条语句里 ——
+  `source` 判据按语句判「是不是只取类型」。
+
+组件是**哑的**：props 进、界面出，不取数、不读宿主、不自己决定什么时候刷新。取数在外壳的
+hooks 或模块自己的 `model/` 里，所以同一张卡片在真数据和夹具下长得一样。
+
+## 开发
+
+```bash
+pnpm --filter @dsh-workbench/shared run build      # tsc + 搬 CSS
+pnpm --filter @dsh-workbench/shared run test
+pnpm --filter @dsh-workbench/shared run selfcheck  # check-state：无模块级可变状态
+```
+
+两个 barrel 用 `pnpm run barrels` 重生成；`pnpm run arch` 跑这个包自己的分层配置。
+代码零注释，只有公开成员的导出 JSDoc 例外（它会进 `.d.ts`，是给消费方看的）。
+
+## 相关文档
+
+| 想了解 | 读 |
+|---|---|
+| 层序、两个运行时、槽位、数据通路 | [ARCHITECTURE.md](../../ARCHITECTURE.md) |
+| 组件怎么选、kit 里有什么 | [KIT.md](../core/skills/workbench-module-diy/KIT.md) |
+| 模块的构建与门禁 | [module-tools](../module-tools/README.md) |
+| 最小模块样本 | [module-hello](../module-hello/README.md) |
+| 环境与提交 | [CONTRIBUTING.md](../../CONTRIBUTING.md) |

package/dist/api/blocker-table.d.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 { ModuleBlocker } from './blocker.js';
+import type { ModuleBlocker } from '../contract/blocker.js';
 /**
  * 把一次读失败翻成一张卡住态，交给卡片直接渲染。
  * @param error 读口回的错误；undefined 表示连错误都没拿到（多半是网络断，回「原因未知」）。

package/dist/api/blocker-table.js

@@ -98,20 +98,23 @@ export function blockerOfError(error, t, context = {}) {
 export function blockerOfCapability(capability, t) {
     if (capability.status === 'ok')
         return undefined;
-    const fixAction = capability.fix === undefined
+    const problem = capability.needs.find((need) => need.status !== 'ok');
+    const fix = problem?.provision === 'ready' ? 'install' : undefined;
+    const fixAction = 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 = [
         ...(fixAction === undefined ? [] : [fixAction]),
         ...(sourceUnknown ? [{ kind: 'open-market', 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 {
             id: 'unit-mount-failed',
@@ -122,32 +125,53 @@ export function blockerOfCapability(capability, t) {
             actions: [retryAction(t)],
         };
     }
-    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/dist/api/dsh.d.ts

@@ -115,7 +115,7 @@ export interface DshHostContext {
             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;
@@ -222,6 +222,24 @@ export interface DshToolRunContext {
         } | undefined;
     } | 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/dist/api/host-write.d.ts

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

package/dist/api/host-write.js

@@ -1,35 +1 @@
-/**
- * 由通道与资源拼出写路由。
- * @param channel 写通道。
- * @param resource 该通道下的资源名。
- * @returns 路由字符串；provision 只有一段，其余是 channel/resource。
- */
-export function writeRoute(channel, resource) {
-    if (channel === 'provision')
-        return 'provision';
-    return `${channel}/${resource}`;
-}
-/**
- * 把写通道的响应翻成 WriteOutcome。
- * @param response 写口回的响应；null 表示请求本身没成（网络断了，宿主没答）。
- * @param networkText 拿不到任何服务端文案时兜底的那句。
- * @returns 失败时 message 优先用服务端自己的话，没有才用响应正文或 networkText。
- */
-export function writeOutcomeOf(response, networkText) {
-    if (response === null)
-        return { ok: false, message: networkText };
-    if (!response.ok) {
-        const box = response;
-        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 };
-}
+export {};

package/dist/api/workbench-client.js

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

package/dist/components/Activity.css

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

package/dist/components/ApprovalDetail.css

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

package/dist/components/ApprovalDetail.d.ts

@@ -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 { type ReactNode } from '../lib/react.js';
 import './ApprovalDetail.css';

package/dist/components/ApprovalPlan.css

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

package/dist/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/dist/components/Card.d.ts

@@ -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 './Card.css';
 /**
  * `Card` 的契约：标题、刷新、卡片体，以及可整块替换的卡头。

package/dist/components/CardBoundary.d.ts

@@ -1,4 +1,4 @@
-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 } from '../lib/react.js';
 /**

package/dist/components/CardHead.css

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

package/dist/components/CardHead.d.ts

@@ -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 './CardHead.css';
 /**
  * `CardHead` 的契约：标题、补充、刷新，外加齿轮与平台跳转两格。

package/dist/components/ChoiceGroup.css

@@ -1,4 +1,3 @@
-
 .wb-choiceMenu {
   display: flex;
   flex-direction: column;
@@ -180,4 +179,4 @@
 .wb-radio:focus-visible {
   outline: var(--dsw-focus-ring-width, var(--wb-len-2)) solid var(--dsw-focus-ring-color, var(--dsw-alias-state-business-primary));
   outline-offset: 2px;
-}
+}

package/dist/components/ConfirmBar.d.ts

@@ -23,7 +23,7 @@ export interface ConfirmBarProps {
 }
 /**
  * 「先问一句再动手」那一条：标题 + 说明 + 键值 + 失败那句 + 动作区，形状一次收口。
- * **要不要问**归调用点（ADR-0054 §2 规则三），这一件只回答"问的时候长什么样"。
+ * **要不要问**归调用点，这一件只回答"问的时候长什么样"。
  * @param props.title - 那一句问话（"发布到 prod？"）。
  * @param props.hint - 标题下面那句说明或正文；不给不占位。
  * @param props.rows - 键值两格（键值列宽与分隔线归 `Rows` / `Row`）；不给或空数组不渲染。值那一格可以放控件。

package/dist/components/ConfirmBar.js

@@ -5,7 +5,7 @@ import { Row, Rows } from './Rows.js';
 import './ConfirmBar.css';
 /**
  * 「先问一句再动手」那一条：标题 + 说明 + 键值 + 失败那句 + 动作区，形状一次收口。
- * **要不要问**归调用点（ADR-0054 §2 规则三），这一件只回答"问的时候长什么样"。
+ * **要不要问**归调用点，这一件只回答"问的时候长什么样"。
  * @param props.title - 那一句问话（"发布到 prod？"）。
  * @param props.hint - 标题下面那句说明或正文；不给不占位。
  * @param props.rows - 键值两格（键值列宽与分隔线归 `Rows` / `Row`）；不给或空数组不渲染。值那一格可以放控件。

package/dist/components/Form.css

@@ -3,4 +3,4 @@
   flex-direction: column;
   gap: var(--wb-len-12);
   width: 100%;
-}
+}

package/dist/components/FormActions.js

@@ -17,7 +17,7 @@ function reportExtraPrimaries(actions) {
     if (keys.length < 2)
         return;
     console.error(`[dsh-workbench] FormActions 一个区里出现了 ${keys.length} 颗 primary（${keys.join('、')}）—— ` +
-        '一个区只许一颗主操作（ADR-0054 §2 规则二）：多余的这颗该改成 default');
+        '一个区只许一颗主操作：多余的这颗该改成 default');
 }
 function variantOf(kind) {
     if (kind === 'primary')

package/dist/components/LongTaskRow.css

@@ -1,4 +1,3 @@
-
 .wb-longTask {
   padding-top: var(--wb-len-12);
   border-top: 0.5px solid var(--dsw-alias-border-l2);
@@ -97,4 +96,4 @@
   line-height: var(--wb-line-16);
   color: var(--dsw-alias-state-error-primary);
   overflow-wrap: anywhere;
-}
+}

package/dist/components/LongTaskRow.d.ts

@@ -1,4 +1,4 @@
-import { type LongTaskStatus } from '../api/long-task.js';
+import { type LongTaskStatus } from '../contract/long-task.js';
 import './LongTaskRow.css';
 /**
  * 长任务行尾的一个链接：地址与文字。

package/dist/components/LongTaskRow.js

@@ -1,4 +1,4 @@
-import { longTaskDot, longTaskStopPress, longTaskStopStage, LONG_TASK_STOP_ARM_MS } from '../api/long-task.js';
+import { longTaskDot, longTaskStopPress, longTaskStopStage, LONG_TASK_STOP_ARM_MS } from '../contract/long-task.js';
 import { Link } from './Link.js';
 import { Fragment, h, useEffect, useState } from '../lib/react.js';
 import { CodeBlock, DisclosureRow, IconCodeOutlineRegular, IconFlatListOutlineRegular, IconStopFillRegular, StateDot, } from '@deepseek-ai/dsh-client-ui-primitives';

package/dist/components/Note.css

@@ -1,4 +1,3 @@
-
 .wb-note {
   margin: 0;
   font-size: var(--dsw-font-xxs-12-font-size);

package/dist/components/ResourceStates.css

@@ -1,4 +1,3 @@
-
 .wb-centered.wb-centeredCompact {
   flex: none;
   min-height: 0;

package/dist/components/SettingsSection.css

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

package/dist/components/Spinner.css

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

package/dist/components/Stack.css

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

package/dist/components/StateBlock.css

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

package/dist/components/board-module.d.ts

@@ -1,7 +1,7 @@
 import type { ReactNode } from 'react';
-import type { SessionsSnapshot, Translate, WorkspaceSnapshot, WorkspaceView } from '../api/dsh-client.js';
-import type { UnitManifest } from '../api/unit.js';
-import type { CapabilityPayload } from '../api/workbench-contract.js';
+import type { SessionsSnapshot, Translate, WorkspaceSnapshot, WorkspaceView } from '../lib/dsh-client.js';
+import type { UnitManifest } from '../contract/unit.js';
+import type { CapabilityPayload } from '../contract/workbench-contract.js';
 import type { Dictionaries } from '../i18n/index.js';
 /**
  * 面板要跳去的一格：只用 `kind` 说去哪，具体负载由各 unit 自己约定。

package/dist/components/icons.d.ts

@@ -11,7 +11,7 @@ export interface IconProps {
  */
 export declare function IconConversation({ size }: IconProps): JSX.Element;
 /**
- * 品牌标：侧栏顶上那枚工作台方块标；默认 24px（它是品牌物，别拿它当通用图标）。
+ * 品牌标：一台显示器里放着 dsh 的鲸鱼尾巴；默认 24px（它是品牌物，别拿它当通用图标）。
  * @param props.size - 边长像素，同时给 `width` 与 `height`。
  * @returns 一枚 `aria-hidden` 的 svg。
  */
@@ -28,12 +28,6 @@ export declare function IconOpencli({ size }: IconProps): JSX.Element;
  * @returns 一枚 `aria-hidden` 的 svg。
  */
 export declare function IconNpm({ size }: IconProps): JSX.Element;
-/**
- * 四宫格："模块"这个概念的通用单色图标（侧栏、面板那颗钮、市场节的标题）；默认 16px。
- * @param props.size - 边长像素，同时给 `width` 与 `height`。
- * @returns 一枚 `aria-hidden` 的 svg。
- */
-export declare function IconModules({ size }: IconProps): JSX.Element;
 /**
  * 模块类型标：渐变方块 + 白四宫格，用在"这是个模块"的行首；品牌物，颜色不跟主题走。默认 16px。
  * @param props.size - 边长像素，同时给 `width` 与 `height`。

package/dist/components/icons.js

@@ -11,15 +11,22 @@ export function IconConversation({ size = 16 }) {
     return (h(Shell, { size: size, strokeWidth: 1.3 },
         h("path", { d: "M2.5 7.2c0-2.3 2.1-4.2 4.8-4.2h1.4c2.7 0 4.8 1.9 4.8 4.2s-2.1 4.2-4.8 4.2H7.5l-3.2 2v-2.3c-1.1-.8-1.8-2-1.8-3.9Z", stroke: "currentColor", strokeLinejoin: "round" })));
 }
+const BRAND_FRAME = 'M10 6H54A5 5 0 0 1 59 11V43A5 5 0 0 1 54 48H10A5 5 0 0 1 5 43V11A5 5 0 0 1 10 6Z M12 10H52A3 3 0 0 1 55 13V41A3 3 0 0 1 52 44H12A3 3 0 0 1 9 41V13A3 3 0 0 1 12 10Z';
+const BRAND_TAIL = 'M8.844 13.742C8.967 12.328 8.45 10.4 8.45 9.65C8.45 8.94 8.88 8.43 9.6 8.43C11.285 8.43 12.106 8.281 12.685 8.104C13.71 7.791 14.585 6.768 15.055 5.945C15.137 5.803 14.99 5.641 14.829 5.671C13.829 5.86 12.828 5.376 11.827 4.978C10.659 4.514 9.491 4.707 8.935 4.876C8.805 4.915 8.658 4.819 8.636 4.686C8.468 3.643 7.405 2.615 5.498 2.238C4.54 2.048 3.748 1.574 3.347 1.202C3.252 1.113 3.088 1.125 3.03 1.242C2.628 2.059 2.168 3.82 5.248 6.115C5.82 6.494 6.31 6.785 6.574 7.637C6.72 8.104 6.157 9.168 6.061 9.368C5.157 11.27 5.089 12.19 4.926 13.742Z';
+const BRAND_TAIL_TRANSFORM = 'translate(14.6263 10.5853) scale(1.95)';
 /**
- * 品牌标：侧栏顶上那枚工作台方块标；默认 24px（它是品牌物，别拿它当通用图标）。
+ * 品牌标：一台显示器里放着 dsh 的鲸鱼尾巴；默认 24px（它是品牌物，别拿它当通用图标）。
  * @param props.size - 边长像素，同时给 `width` 与 `height`。
  * @returns 一枚 `aria-hidden` 的 svg。
  */
 export function IconBrandMark({ size = 24 }) {
-    return (h(Shell, { size: size, strokeWidth: 1.6, viewBox: "0 0 24 24" },
-        h("rect", { x: 3, y: 3, width: 18, height: 18, rx: 5, stroke: "currentColor" }),
-        h("path", { d: "M8 9.5h8M8 12.5h8M8 15.5h5", stroke: "currentColor", strokeLinecap: "round" })));
+    return (h(Shell, { size: size, viewBox: "0 0 64 64" },
+        h("path", { d: BRAND_FRAME, fill: "currentColor", fillRule: "evenodd" }),
+        h("rect", { x: 27.5, y: 48, width: 9, height: 4.75, fill: "currentColor" }),
+        h("rect", { x: 19, y: 52.75, width: 26, height: 4.75, rx: 2.375, fill: "currentColor" }),
+        h("g", { transform: BRAND_TAIL_TRANSFORM },
+            h("path", { d: BRAND_TAIL, fill: "currentColor" }),
+            h("circle", { cx: 6.885, cy: 13.742, r: 1.95, fill: "currentColor" }))));
 }
 /**
  * opencli 的标：包类型那一格用它；颜色写死的品牌物，不跟主题走。默认 16px。
@@ -45,18 +52,6 @@ export function IconNpm({ size = 16 }) {
     return (h(Shell, { size: size, viewBox: "0 0 1024 1024" },
         h("path", { d: "M64 337.76h896v298.72H512v49.792H312.896v-49.824H64z m49.792 248.928h99.552v-149.376h49.76v149.344h49.792v-199.104H113.792z m248.896-199.136v248.928h99.552v-49.792h99.552v-199.136z m99.552 49.792H512v99.584h-49.792z m149.344-49.792v199.136h99.552v-149.376h49.792v149.344h49.792v-149.344h49.792v149.344h49.792v-199.104z", fill: "#CB3837" })));
 }
-/**
- * 四宫格："模块"这个概念的通用单色图标（侧栏、面板那颗钮、市场节的标题）；默认 16px。
- * @param props.size - 边长像素，同时给 `width` 与 `height`。
- * @returns 一枚 `aria-hidden` 的 svg。
- */
-export function IconModules({ size = 16 }) {
-    return (h("svg", { width: size, height: size, viewBox: "0 0 16 16", fill: "none", "aria-hidden": "true" },
-        h("rect", { x: "2.5", y: "2.5", width: "4.6", height: "4.6", rx: "1.2", stroke: "currentColor", strokeWidth: "1.2" }),
-        h("rect", { x: "8.9", y: "2.5", width: "4.6", height: "4.6", rx: "1.2", stroke: "currentColor", strokeWidth: "1.2" }),
-        h("rect", { x: "2.5", y: "8.9", width: "4.6", height: "4.6", rx: "1.2", stroke: "currentColor", strokeWidth: "1.2" }),
-        h("rect", { x: "8.9", y: "8.9", width: "4.6", height: "4.6", rx: "1.2", stroke: "currentColor", strokeWidth: "1.2" })));
-}
 /**
  * 模块类型标：渐变方块 + 白四宫格，用在"这是个模块"的行首；品牌物，颜色不跟主题走。默认 16px。
  * @param props.size - 边长像素，同时给 `width` 与 `height`。

package/dist/config/constants.d.ts

@@ -26,8 +26,8 @@ export declare const DIY_RECORD_ACT_PATH = "diy-record/act";
 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 服务名（`workbenchIssues`）：套件照它登记自己那份服务。 */
+export declare const ISSUES_SERVICE = "workbenchIssues";
 /** 面板套件的 dsh 服务名（`workbenchPanels`）：宿主经它取套件公布的清单与订阅。 */
 export declare const PANELS_SERVICE = "workbenchPanels";
 /** 单元花名册服务的 dsh 服务名（`workbenchUnits`）：模块经它认领自己的单元。 */

package/dist/config/constants.js

@@ -29,8 +29,8 @@ export const DIY_RECORD_ACT_PATH = `${DIY_RECORD_PATH}/act`;
 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 服务名（`workbenchIssues`）：套件照它登记自己那份服务。 */
+export const ISSUES_SERVICE = "workbenchIssues";
 /** 面板套件的 dsh 服务名（`workbenchPanels`）：宿主经它取套件公布的清单与订阅。 */
 export const PANELS_SERVICE = "workbenchPanels";
 /** 单元花名册服务的 dsh 服务名（`workbenchUnits`）：模块经它认领自己的单元。 */