@dsh-workbench/core 0.1.18 → 0.2.1

package/dist/types/shared/api/host/unit-registry.d.ts

@@ -10,6 +10,8 @@ export type UnitSource = {
     readonly pkg: string;
 } | {
     readonly kind: 'owned';
+} | {
+    readonly kind: 'plugin';
 };
 export interface HostUnit {
     readonly unit: string;
@@ -21,14 +23,21 @@ export interface UnitDeclarationSource {
     readonly pkg: string;
     readonly declaration: unknown;
 }
+export declare function installableUnitsOf(registry: {
+    all(): readonly HostUnit[];
+}): readonly string[];
 export interface UnitRegistry {
     register(face: UnitModuleFace): () => void;
     registerOwned(face: UnitOwnedFace): () => void;
+    registerPlugin(face: UnitOwnedFace): () => void;
     all(): readonly HostUnit[];
     owned(): readonly string[];
     refusals(): readonly UnitRefusal[];
     manifests(): readonly UnitManifest[];
     subscribe(listener: () => void): () => void;
+    fail(unit: string, reason: string): void;
+    recovered(unit: string): void;
+    failureOf(unit: string): string | undefined;
 }
 export declare function createUnitRegistry(options: {
     declarationOf: (unit: string) => UnitDeclarationSource | undefined;

package/dist/types/shared/api/unit-manifests.d.ts

@@ -2,4 +2,5 @@ import type { UnitManifest } from '@dsh-workbench/shared';
 export declare const UNIT_MANIFESTS_ROUTE = "unit-manifests";
 export interface UnitManifestsPayload {
     readonly manifests: readonly UnitManifest[];
+    readonly installable: readonly string[];
 }

package/dist/types/shared/components/PanelFoot.d.ts

@@ -1,6 +1,6 @@
 import type { ReactNode } from '@dsh-workbench/shared';
 export interface PanelFootProps {
-    readonly text: string;
+    readonly text?: string;
     readonly size?: 'sm' | 'md';
     readonly children?: ReactNode;
 }

package/dist/types/shared/hooks/panel-state-report.d.ts

@@ -0,0 +1,13 @@
+import type { PanelCardError, PanelCardPhase } from '@dsh-workbench/shared';
+export declare function unitOfRoute(route: string): string | null;
+export declare function setPanelWorkspace(path: string | null): void;
+export declare function reportPanelRead(input: {
+    readonly unit: string;
+    readonly route: string;
+    readonly phase: PanelCardPhase;
+    readonly error?: PanelCardError | undefined;
+}): void;
+export declare function reportPanelCrash(input: {
+    readonly unit: string;
+    readonly reason: string;
+}): void;

package/dist/types/shared/hooks/panel-state-report.test.d.ts

@@ -0,0 +1 @@
+export {};

package/docs/HANDOFF.md

@@ -256,6 +256,13 @@ pnpm release:dry        # 同上，但 publish 只 dry-run：零上传，结束
 | `shared` ↔ 外壳/模块 | 依赖写的是 `workspace:*`，发布时会被改写成**当时那个版本号** → `shared` 必须先发；`shared` 升版后，用到它的包要重新发一次才会带上新范围 |
 | `module-tools` ↔ `init` 模板 | 模板里 `@dsh-workbench/core` / `module-tools` 的范围要跟着本仓版本走，否则 `init` 生成的是过期范围 —— **现在没有任何判据检查它**（上一版 release 脚本查过，换成现在这份之后这条没了），升外壳次版本时记得一起改 |
 
+> **`0.2.0` 给模块作者的一处变更**（很小，但旧写法会红）：`check:cards` 现在要求"清单说没有卡片"
+> 与"产物里登记没登记卡片"**两处说法一致** —— 声明写 `"card": null` 的模块**不要再挂占位卡**
+> （`UnitClientFace.card` 自 `0.2.0` 起可选，见 [ADR-0038 §6.20](../docs/adr/0038-module-declaration-protocol.md)）。
+> 有卡片的模块零迁移。反过来，`card: null` 的模块在**旧外壳/旧工具链**上仍按旧口径被要求交卡片 ⇒
+> 模块仓把依赖提到 `^0.2.0` 要与外壳发版**同一个窗口**做（先发 `0.2.0`，模块仓再删那张卡片函数、
+> 提范围、跑模块门禁）。
+
 ### 中断了怎么续跑（发布是可中断的）
 
 脚本把现场写进 `.release-state.json`（已进 `.gitignore`）。断了就：

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-workbench/core",
-  "version": "0.1.18",
+  "version": "0.2.1",
   "description": "个人工作台：Agent 工作台外壳（左栏 + 常驻对话 + 自研右侧数据面板）。",
   "type": "module",
   "icon": "./icon.svg",
@@ -87,7 +87,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@dsh-workbench/shared": "0.1.18"
+    "@dsh-workbench/shared": "0.2.1"
   },
   "scripts": {
     "build": "node scripts/build.mjs && node scripts/build-types.mjs",

package/preset/diy.patch.yml

@@ -16,12 +16,13 @@
           - id: persona
             name: '@deepseek-ai/dsh-persona'
             config:
-              suffix: Your working directory is {{cwd}}.
               prefix: You are a coding agent powered by the {{model}} model.
           - id: agent-instructions
             name: '@deepseek-ai/dsh-agent-instructions'
             config:
               maxBytes: 65536
+          - id: time-context
+            name: '@deepseek-ai/dsh-time-context'
           - id: tool-bash
             name: '@deepseek-ai/dsh-tool-bash'
             disabled: !!js process.platform === 'win32'
@@ -36,6 +37,8 @@
               sampleOverCapGlobResults: false
           - id: tool-jobs
             name: '@deepseek-ai/dsh-tool-jobs'
+          - id: tool-schedule
+            name: '@deepseek-ai/dsh-tool-schedule'
           - id: command-goal
             name: '@deepseek-ai/dsh-command-goal'
           - id: tool-goal
@@ -50,7 +53,7 @@
                 name: '@deepseek-ai/dsh-plan-mode'
                 config:
                   section: |
-                    You are in plan mode. Stay in plan mode until exit_plan_mode succeeds or the user switches the session mode. Imperative language to implement changes means plan the implementation, not execute it. A user's conversational agreement — including an answer confirming something you asked — approves nothing and does not end plan mode; fold the confirmed decision into the plan and submit it through exit_plan_mode.
+                    You are in plan mode. Stay in plan mode until the user approves your plan through exit_plan_mode or switches the session mode. Imperative language to implement changes means plan the implementation, not execute it. A user's conversational agreement — including an answer confirming something you asked — approves nothing and does not end plan mode; fold the confirmed decision into the plan and submit it through exit_plan_mode.
 
                     Explore first. Use non-mutating reads, searches, static analysis, and checks to ground the plan in the actual repository. Do not edit or write files, change configuration, run formatters or code generation that rewrites tracked files, commit, or otherwise carry out the plan. Prefer existing functions and patterns over new machinery.
 
@@ -94,41 +97,17 @@
                   provider: spawn
                   toolName: subagent
                   modelSelectionSettings: true
-                  backgroundMode: continuable
               - id: tool-subagent-fork
                 name: '@deepseek-ai/dsh-tool-subagent'
                 config:
                   provider: fork
                   toolName: subagent_fork
-                  backgroundMode: continuable
-              - id: tool-subagent-codex
-                name: '@deepseek-ai/dsh-tool-subagent'
-                disabled: true
-                config:
-                  provider: codex
-                  toolName: subagent_codex
-                  backgroundMode: one-shot
-                  maxDepth: provider-managed
-              - id: tool-subagent-claude-code
-                name: '@deepseek-ai/dsh-tool-subagent'
-                disabled: true
-                config:
-                  provider: claude-code
-                  toolName: subagent_claude_code
-                  backgroundMode: one-shot
-                  maxDepth: provider-managed
               - id: workflow-ptc
                 name: '@deepseek-ai/dsh-workflow-ptc'
                 config:
                   provider: spawn
               - id: tool-workflow
                 name: '@deepseek-ai/dsh-tool-workflow'
-              - id: tool-ralph
-                name: '@deepseek-ai/dsh-tool-ralph'
-                disabled: true
-                config:
-                  subagentProvider: spawn
-                  maxRounds: 64
           - id: tool-ask-user
             name: '@deepseek-ai/dsh-tool-ask-user'
           - id: tool-todo

package/skills/workbench-module-diy/REVIEW.md

@@ -31,3 +31,25 @@
 1. **装上去没反应** → 先问 `workbench_diy`（`action=status, unit=…`），别自己拼。[WIRING.md](WIRING.md) §3
 2. **改完没热换** → 宿主侧是秒级热换的；客户端侧刷新一下页面。[WIRING.md](WIRING.md) §4
 3. **"再装一遍"** → 日常迭代只重建、不重装。[WIRING.md](WIRING.md) §3
+
+## 用户说"卡片不对"时：四步取证
+
+他说"一片空白 / 一直转圈 / 数字不对"时，**先取证再改代码**，四步按顺序走；前一步有结论就停在那儿修：
+
+1. **`workbench_diy`（`action=panel`）** —— 这个工作区面板上现在是什么样：哪几张卡、每张最后一次取数
+   是读到了还是读不到（带宿主回的码与原文）、有没有崩过（原因 + 次数）。有答案就别往下走。
+2. **`workbench_diy`（`action=status, unit=…`）** —— 看"起得来：不是 —— …"那一行：模块起不来时
+   原因就在那里（装配抛的错 / 声明被拒的原文）。这一行说"都在生效"才继续第 3 步。
+3. **自己把那条读跑一遍**：卡片画的就是模块自己那条宿主路由的返回值 ——
+   `curl '<工作台地址>/workbench/api/<unit>/<route>'`（地址就是你起工作台那个，默认 `http://127.0.0.1:3081`）。
+   接口回对了而卡片不对，问题在渲染那一侧；接口就回错，问题在宿主半侧（回头照着 [DATASOURCE.md](DATASOURCE.md) 重探一次）。
+4. **最后才看用户那一页**：`opencli browser <会话> console`（**不带任何过滤** —— 第一次查用过滤会得到
+   假的"没有消息"，本仓实测踩过）、`state`（这一页是什么、有哪些可点的）、`screenshot <路径>`（截一张自己看）。
+   宿主侧热换 / 装载的报错在**起工作台那个终端**里，不在浏览器里。
+
+两条纪律：**别让用户截图或替你转述报错**（第 1 步就是干这个的）；**截图与 console 只用来定位，不用来验收** ——
+验收仍是他对着三张表走「打开哪 → 看什么 → 点什么 → 应该看到什么」。
+
+面板运行态是**用户那一页自己报上来的**（页面关了就停在最后一次，带时间与新鲜度），所以第 1 步没有内容时，
+先让他把工作台切到工坊那个工作区、刷新一次页面再看。
+

package/skills/workbench-module-diy/SKILL.md

@@ -30,7 +30,8 @@ description: 在工作台里凭需求造一个模块（面板上的一块内容
    就问工具：`workbench_diy`（`action=status, unit=<单元 id>`）会把这几件事一次说清并给出下一步 ——
    **别自己拼，也别再装一遍**；已经装过只是想上板，用 `action=open`。
 7. **验收** —— 逐条对着三张表走：「打开哪 → 看什么 → 点什么 → 应该看到什么」。
-   他说哪不对就回对话改，改完让他看**同一处**；不给他看 diff、日志、代码。
+   他说哪不对，**先取证再改**：`workbench_diy`（`action=panel`）一次看清面板上每张卡是读到了、读不到还是崩了
+   （四步取证见 [REVIEW.md](REVIEW.md)）；改完让他看**同一处**；不给他看 diff、日志、代码。
    逐条过他都说对了，再 `dsh-wb-module design accept` 把验收打勾（**没验完不许打**）。
 
 ## 每个问题都带推荐答案
@@ -52,6 +53,7 @@ description: 在工作台里凭需求造一个模块（面板上的一块内容
 | 落点、文件形状、命令、两个面 | [BUILD.md](BUILD.md) |
 | 依赖、会被拦的写法、装、热换、发布 | [WIRING.md](WIRING.md) |
 | 门禁红了、装上去没反应、改完没热换 | [REVIEW.md](REVIEW.md) |
+| 用户说"卡片不对 / 一片空白 / 一直转圈"（四步取证） | [REVIEW.md](REVIEW.md) 那一节 · `workbench_diy`（`action=panel`） |
 | 哪条纪律已经固化成工具、哪些还留给 agent | [TOOLING.md](TOOLING.md) |
 
 ## 找不到一件事的时候，按这个顺序找

package/skills/workbench-module-diy/TOOLING.md

@@ -15,6 +15,8 @@
 | 十一条判据（[REVIEW.md](REVIEW.md)） | `dsh-wb-module check`（`--only <判据>` 单跑；`--only kit` 列这份外壳的 kit 成员） |
 | 落点、文件形状、四个脚本（[BUILD.md](BUILD.md) §1–§2） | `dsh-wb-module init --template diy`（骨架带一条真读盘的数据源）+ `scripts/smoke.mjs` |
 | 装、上板、不重装（[WIRING.md](WIRING.md) §3） | `workbench_diy`（`install` / `open` / `status`）+ `workbench_panels` |
+| 它到底起得来没（装配抛的错 / 声明被拒的原文） | `workbench_diy`（`status` 的"起得来"那一行，见 [REVIEW.md](REVIEW.md) 四步取证的第二步） |
+| 面板上现在是什么样（每张卡读到没 / 崩没崩） | `workbench_diy`（`panel`：浏览器半侧上报，宿主按 unit 留最新一条；见 [ADR-0042](../../../../docs/adr/0042-panel-runtime-state-is-reported-to-the-host.md)） |
 | 空着的格就是还没定的事（[DESIGN.md](DESIGN.md) §5） | `design.json` + `design check`（点名叫出空格）/ `render` / `accept` |
 | 发货前的清单（[WIRING.md](WIRING.md) §5） | `dsh-wb-module publish`（门禁 + 打包清单 `files` 漏项，只 dry run） |
 | 干净机器上的第一脚（[SKILL.md](SKILL.md) 第 4 步） | 启动器自愈骨架 + PATH 上的 `dsh-wb-module` |