dsh-device-fleet 0.1.0-dev.1 → 0.1.0-dev.11

package/README.md

@@ -7,7 +7,48 @@ DeepSeek Harness 的设备联邦插件：把登录同一账号、且都安装本
 - ✅ **网络层 v1**：设备身份、邀请、端到端加密安全通道、直连（手动地址）、UDP 组播发现
 - ✅ **网络层 v2**：自建 Relay（fleetKey 鉴权的信令 + TCP 拼接数据面，不做 NAT 打洞）
 - ✅ **Host 插件 + 直调 MVP（代码完成、单测通过，待真实 DSH 安装联调）**：`fleet_list` / `fleet_tools` / `fleet_call` + `fleet_read` / `fleet_fetch` / `fleet_run`、Tool Policy、Execution Slot、审批 fail-closed
-- ⏳ Room / Room Board、委派、审批收件箱 UI、设备页/配对/房间 UI（下一步）
+- ✅ **审批收件箱逻辑层（dev.7）**：`fleet_approvals` / `fleet_approve` / `fleet_deny`，ask 档排队、超时 fail-closed、once/ttl 授权、`fleet_simulate_request` 本机演练；Client 审批面板待做
+- ✅ **Room 逻辑层（dev.8，单机模拟）**：`room_create` / `room_add_local` / `room_send` / `room_messages` / `room_status` / `room_task_*` / `room_close`；本地真实 agent 参与者、寻址唤醒、Room Board 串行交接；单机仿真验证通过
+- ✅ **审批面板 UI（dev.10）**：Host `/device-fleet/approvals` HTTP 数据面 + Client `shell.overlay` 浮动审批按钮/面板（允许一次/15 分钟/拒绝）；单测 14/14；刷新页面后可见
+- ⏳ 远程参与者传输、房间视图、插件重载 rehydrate、SSE 推送（下一步）
+
+## 安装（开发版）
+
+已发布到 npm：**`dsh-device-fleet@0.1.0-dev.3`**（dist-tag `dev`）。
+
+```sh
+# CLI / web profile
+dsh plugin --profile web add dsh-device-fleet@dev
+
+# 桌面 app：先完全退出 app，再安装，然后重新打开
+dsh plugin --profile desktop add dsh-device-fleet@dev
+
+# 离线安装包（拷到另一台设备）
+dsh plugin --profile desktop add C:/path/to/dsh-device-fleet-0.1.0-dev.3.tgz
+```
+
+两台设备的 **DSH 版本与插件版本必须一致**（ADR-0024）；不一致会在握手时直接拒绝。
+
+### 配对（Fleet 入网）
+
+1. 设备 A：对 agent 说“生成 Fleet 邀请码” → 模型调用 `fleet_invite`，拿到一次性邀请码（含 fleetKey，注意保密）。
+2. 设备 B：安装并重启后，对 agent 说“加入 Fleet：`<code>`” → `fleet_join` 把邀请排队；**重启 DSH** 后生效。
+3. 两台设备各自在 profile patch 里配置 `policy.allowedRoots` 与 `execution.cwd`（不配时直调读取一律被拒）。
+4. 设备 B：`fleet_list` 看到设备 A → `fleet_read(device=A, path="A 允许根内的文件")` 验证。
+
+```yaml
+# 两个 profile 的 cordis.patch.yml 里给 device-fleet 行追加 config：
+- id: device-fleet
+  config:
+    deviceName: desktop
+    execution:
+      cwd: D:/work
+      agentPreset: standard
+    policy:
+      allowedRoots: [D:/work]
+```
+
+`fleet_run` 默认需要目标设备本机审批；审批收件箱 UI 尚未实现（当前 fail-closed）。第一阶段建议先用 `fleet_read` / `fleet_fetch` 验证链路。
 
 ## 设计文档
 

package/client.js

@@ -0,0 +1,228 @@
+// Fleet approval panel (Client half).
+// The trigger lives in the native sidebar footer action row (no overlap with
+// content panels); the inbox opens as an intentional centered dialog.
+// Data comes from the Host routes registered by src/host/approval-web.js.
+window.__ModuleLoader__.load({
+  id: 'dsh-device-fleet',
+  factory(require) {
+    const React = require('react');
+    const h = React.createElement;
+    const { useEffect, useState } = React;
+
+    const POLL_MS = 2500;
+    const store = {
+      items: [],
+      open: false,
+      listeners: new Set(),
+    };
+    let pollTimer = null;
+    let polling = false;
+
+    const notify = () => {
+      for (const listener of store.listeners) listener();
+    };
+
+    const setItems = (items) => {
+      const next = Array.isArray(items) ? items : [];
+      if (next.length === store.items.length && next.every((item, index) => item.id === store.items[index].id)) return;
+      store.items = next;
+      notify();
+    };
+
+    const startPolling = () => {
+      if (polling) return () => {};
+      polling = true;
+      const tick = async () => {
+        try {
+          const response = await fetch('/device-fleet/approvals', { headers: { accept: 'application/json' } });
+          if (!response.ok) throw new Error('HTTP ' + response.status);
+          const data = await response.json();
+          setItems(data.approvals);
+        } catch {
+          setItems([]);
+        }
+        if (polling) pollTimer = setTimeout(tick, POLL_MS);
+      };
+      tick();
+      return () => {
+        polling = false;
+        if (pollTimer) clearTimeout(pollTimer);
+        pollTimer = null;
+      };
+    };
+
+    const useStore = () => {
+      const [, setVersion] = useState(0);
+      useEffect(() => {
+        const listener = () => setVersion((value) => value + 1);
+        store.listeners.add(listener);
+        return () => store.listeners.delete(listener);
+      }, []);
+      return store;
+    };
+
+    const decide = async (id, action, scope) => {
+      try {
+        await fetch('/device-fleet/approvals/decide', {
+          method: 'POST',
+          headers: { 'content-type': 'application/json' },
+          body: JSON.stringify({ id, action, ...(scope ? { scope } : {}) }),
+        });
+      } finally {
+        store.items = store.items.filter((item) => item.id !== id);
+        notify();
+      }
+    };
+
+    const dialogStyle = {
+      position: 'fixed',
+      left: '50%',
+      top: '12vh',
+      transform: 'translateX(-50%)',
+      width: 'min(440px, calc(100vw - 32px))',
+      maxHeight: '70vh',
+      overflow: 'auto',
+      zIndex: 950,
+      background: 'var(--dsw-alias-surface-raised, #1f1f1f)',
+      color: 'var(--dsw-alias-text, #e8e8e8)',
+      border: '1px solid var(--dsw-alias-border, #3a3a3a)',
+      borderRadius: 12,
+      boxShadow: '0 18px 48px rgba(0,0,0,.45)',
+      padding: 14,
+      font: '13px/1.5 system-ui, -apple-system, "Segoe UI", sans-serif',
+    };
+
+    const smallButton = (label, onClick, tone, disabled) =>
+      h(
+        'button',
+        {
+          type: 'button',
+          disabled: disabled === true,
+          onClick,
+          style: {
+            padding: '3px 9px',
+            borderRadius: 6,
+            border: '1px solid ' + (tone === 'allow' ? 'var(--dsw-alias-accent, #2f6fed)' : 'var(--dsw-alias-border, #3a3a3a)'),
+            background: tone === 'allow' ? 'var(--dsw-alias-accent, #2f6fed)' : 'transparent',
+            color: 'var(--dsw-alias-text, #e8e8e8)',
+            cursor: disabled === true ? 'default' : 'pointer',
+            opacity: disabled === true ? 0.55 : 1,
+            fontSize: 12,
+          },
+        },
+        label,
+      );
+
+    function Trigger({ wide }) {
+      const current = useStore();
+      const count = current.items.length;
+      const expanded = wide !== false;
+      return h(
+        'button',
+        {
+          type: 'button',
+          title: count > 0 ? 'Fleet 审批：' + count + ' 条待处理' : 'Fleet 审批',
+          'aria-label': 'Fleet 审批' + (count > 0 ? '（' + count + ' 条待处理）' : ''),
+          onClick: () => {
+            store.open = !store.open;
+            notify();
+          },
+          style: {
+            display: 'flex',
+            alignItems: 'center',
+            gap: 6,
+            padding: expanded ? '5px 10px' : '5px 7px',
+            borderRadius: 8,
+            border: '1px solid ' + (count > 0 ? 'var(--dsw-alias-accent, #2f6fed)' : 'var(--dsw-alias-border, #3a3a3a)'),
+            background: count > 0 ? 'var(--dsw-alias-accent, #2f6fed)' : 'transparent',
+            color: 'var(--dsw-alias-text, #e8e8e8)',
+            cursor: 'pointer',
+            fontSize: 12,
+            whiteSpace: 'nowrap',
+          },
+        },
+        h('span', { 'aria-hidden': true }, '🛰️'),
+        expanded ? h('span', null, count > 0 ? '审批 ' + count : '审批') : null,
+      );
+    }
+
+    function Panel() {
+      const current = useStore();
+      if (!current.open) return null;
+      useEffect(() => {
+        const onKey = (event) => {
+          if (event.key === 'Escape') {
+            store.open = false;
+            notify();
+          }
+        };
+        window.addEventListener('keydown', onKey);
+        return () => window.removeEventListener('keydown', onKey);
+      }, []);
+      return h(
+        'div',
+        {
+          style: { position: 'fixed', inset: 0, zIndex: 940, background: 'rgba(0,0,0,.35)' },
+          onClick: () => {
+            store.open = false;
+            notify();
+          },
+          role: 'presentation',
+        },
+        h(
+          'div',
+          { style: dialogStyle, role: 'dialog', 'aria-label': 'Fleet 待审批请求', onClick: (event) => event.stopPropagation() },
+          h(
+            'div',
+            { style: { display: 'flex', justifyContent: 'space-between', alignItems: 'center', marginBottom: 10 } },
+            h('strong', null, '待审批请求'),
+            h(
+              'button',
+              {
+                type: 'button',
+                onClick: () => {
+                  store.open = false;
+                  notify();
+                },
+                style: { background: 'transparent', border: 'none', color: 'inherit', cursor: 'pointer', fontSize: 12, opacity: 0.8 },
+              },
+              '收起',
+            ),
+          ),
+          current.items.length === 0
+            ? h('div', { style: { opacity: 0.7 } }, '暂无待审批请求')
+            : current.items.map((item) =>
+                h(
+                  'div',
+                  { key: item.id, style: { borderTop: '1px solid var(--dsw-alias-border, #333)', padding: '9px 0' } },
+                  h('div', { style: { fontWeight: 600 } }, (item.capability || 'tool') + (item.tool ? ' / ' + item.tool : '')),
+                  h('div', { style: { opacity: 0.75, fontSize: 12 } }, '来自 ' + item.fromDeviceId + ' · ' + Math.max(0, Math.round(item.expiresInMs / 1000)) + 's 后超时'),
+                  item.reason ? h('div', { style: { opacity: 0.75, fontSize: 12, marginTop: 2 } }, item.reason) : null,
+                  h('div', { style: { fontFamily: 'ui-monospace, monospace', fontSize: 11, margin: '5px 0', opacity: 0.8, wordBreak: 'break-all' } }, item.argsSummary),
+                  h(
+                    'div',
+                    { style: { display: 'flex', gap: 6, marginTop: 4, flexWrap: 'wrap' } },
+                    smallButton('允许一次', () => decide(item.id, 'approve'), 'allow'),
+                    smallButton('允许 15 分钟', () => decide(item.id, 'approve', 'ttl'), 'allow'),
+                    smallButton('拒绝', () => decide(item.id, 'deny'), 'deny'),
+                  ),
+                ),
+              ),
+        ),
+      );
+    }
+
+    return {
+      inject: ['slots'],
+      apply(ctx) {
+        ctx.effect(() => startPolling());
+        ctx.slots.inject('sidebar.footer.action', () =>
+          ctx.slots.register({ name: 'sidebar.footer.action', id: 'fleet-approvals', order: 5, label: 'Fleet 审批' }, Trigger),
+        );
+        ctx.slots.inject('shell.overlay', () =>
+          ctx.slots.register({ name: 'shell.overlay', id: 'fleet-approvals-panel', order: 10 }, Panel),
+        );
+      },
+    };
+  },
+});

package/cordis.patch.yml

@@ -1,4 +1,4 @@
-# dsh-device-fleet bundle patch — mounts the Host plugin. The settings below are
+# dsh-device-fleet bundle patch 鈥?mounts the Host plugin. The settings below are
 # safe defaults; real values (relay address, allowed roots, execution cwd) are
 # meant to be edited in the profile or through the plugin settings page.
 - insert:
@@ -22,3 +22,5 @@
           allowedTools: []
         promptSection: true
         autoApproveAsk: false
+
+

package/docs/notes/approval-inbox-phase.md

@@ -0,0 +1,31 @@
+# 审批收件箱（逻辑层，dev.7）
+
+## 实现
+
+- `src/host/approval-inbox.js`：`ApprovalInbox`
+  - `request()`：排队、60s（可配）超时 fail-closed、事件 `request/approved/denied/expired/closed`；
+  - `list()`：待审列表（来源设备、能力、工具、参数摘要、剩余时间）；
+  - `approve(id, {scope})`：`once` / `ttl`（TTL 由 Tool Policy 的 `approvalTtlMs` 控制）；
+  - `deny(id, reason)`；`close()` 时全部失败关闭。
+- `DirectCallHost` / `DelegationHost` 的 `ask` 档改为等待收件箱结果（不再一律拒绝），批准后按 scope 写入 Tool Policy 授权。
+- 新工具：`fleet_approvals` / `fleet_approve` / `fleet_deny`；`fleet_simulate_request`（仅 `approvals.simulation: true`）用于本机无第二台设备时演练。
+- 配置：`approvals: {ttlMs, maxPending, simulation}`。
+
+## 已验证
+
+单元测试（`node test/host.test.mjs`，10/10）：
+- 收件箱排队/批准/拒绝/超时/关闭/上限；
+- DirectCallHost 在 `run=ask` 时阻塞等待收件箱批准后才执行；
+- 工具 handler 的列表/批准/拒绝/模拟。
+
+当前 DSH 环境内模拟（dev.7，无需第二台设备）：
+1. `fleet_simulate_request` 创建一条 `run/pwsh` 请求，`fleet_approvals` 显示 `58328ms left`；
+2. `fleet_approve(id, scope="ttl")` → `approved … (ttl)`，再次 `fleet_approvals` 为 `(no pending approvals)`；
+3. 再模拟一条 `delegate` 请求，`fleet_deny` → `denied …`；
+4. 对不存在的 id 调 `fleet_approve` → `Error: [unknown-request]`。
+
+## 未完成
+
+- **Client UI 审批面板/通知**（需 Client bundle）：当前只能通过工具或后续 UI 应答；Host 侧已发出 `request/approved/denied/expired` 事件，面板可直接消费；
+- `room` 级授权 scope（需 Room 概念落地后再加）；
+- 审批结果持久化审计日志（后续与 Room 事件一起做）。

package/docs/notes/approval-panel-ui.md

@@ -0,0 +1,38 @@
+# 审批面板 UI（dev.9 / dev.10）
+
+## Host 数据面
+
+`src/host/approval-web.js`：
+
+- `GET /device-fleet/approvals` → `{ approvals: [...] }`（来自 ApprovalInbox.list）；
+- `POST /device-fleet/approvals/decide`，body `{ id, action: "approve"|"deny", scope?, reason? }` → 决策走 ApprovalInbox；
+- 仅注册在 DSH web 载体的本地监听上；决策仍受 ApprovalInbox 的超时/关闭/未知 id 约束；
+- 纯逻辑 `createApprovalApi` 与路由注册分离，便于单测；路由在插件卸载时 dispose。
+
+## Client 半
+
+`client.js`（闭包工厂，`window.__ModuleLoader__.load`，id = `dsh-device-fleet`）：
+
+- 注册 `shell.overlay`（root）列表项 `fleet-approvals`，右下角浮动按钮「Fleet 审批 (n)」；
+- 2.5s 轮询 `/device-fleet/approvals`，有请求时按钮高亮；点开面板显示来源设备/能力/工具/参数摘要/剩余超时；
+- 按钮：允许一次 / 允许 15 分钟（ttl）/ 拒绝，POST 到 decide 后从列表移除；
+- 使用 `--dsw-alias-*` token（带 fallback），不覆盖宿主根、不读其他插件 DOM。
+
+`package.json` 增加 `dsh.client = { platform: web, immediately: true, inject: ["@deepseek-ai/dsh-client-runtime"] }` 与 `./client` 导出、`files` 包含 client.js。
+
+## 验证
+
+- 单测：`approval HTTP API lists and decides requests, and registers two routes`（列表/决策/路由注册/GET handler）；
+- Host 单测总计 **14/14** 通过，网络层 9/9；
+- Host 路由注册：插件 dev.9/10 激活成功（无重复路由错误）；
+- Client 视觉：**未验证**（无浏览器控制；需要刷新页面加载 client bundle），`node --check client.js` 通过。
+
+## 使用
+
+刷新当前 Web 页面（F5）后，右下角应出现「Fleet 审批」浮动按钮。用 `fleet_simulate_request` 造一条请求即可看到面板内容；点击允许/拒绝后 Host 端 `fleet_approvals` 同步清空。
+
+## 限制
+
+- 面板轮询而非推送，规模大时应换 SSE/事件；
+- 路由未额外鉴权（依赖 web 载体自身的本地/会话边界）；
+- 面板不含房间视图（下一版可加 Room 时间线/看板页）。

package/docs/notes/dev-release.md

@@ -0,0 +1,67 @@
+# 开发版发布记录
+
+- 包名：`dsh-device-fleet`
+- 版本：`0.1.0-dev.3`
+- dist-tag：`dev`（同时也可用精确版本安装）
+- registry：<https://registry.npmjs.org/dsh-device-fleet>
+- tarball：<https://registry.npmjs.org/dsh-device-fleet/-/dsh-device-fleet-0.1.0-dev.3.tgz>
+- 本地离线包：`dsh-device-fleet-0.1.0-dev.3.tgz`（仓库根目录，可拷贝安装）
+- 发布时间：2026-11-09（Asia/Shanghai）
+- 内容：网络层 v1/v2 + Host 插件 + 直调 MVP（`fleet_invite/join/list/tools/call/read/fetch/run`）；Room/Board/委派/审批 UI 未包含。
+
+## 安装
+
+```sh
+dsh plugin --profile web add dsh-device-fleet@dev
+# 桌面 app：完全退出后
+dsh plugin --profile desktop add dsh-device-fleet@dev
+```
+
+发布时 npm 对新包做了短暂的处理/占位（`0.0.0-stage`），约几分钟后真实版本生效；后续版本号递增、tag 复用 `dev`。
+
+## 已知限制
+
+- 严格同版本：两台设备必须安装同一 `0.1.0-dev.3`，DSH 版本也要同一发布线；
+- `fleet_run` 的 `ask` 审批目前 fail-closed（审批收件箱未实现）；
+- `fleet_fetch` 仅返回文本；
+- 首次加载会在 `$DSH_HOME/device-fleet/` 自动创建身份与独立 Fleet；加入已有 Fleet 需要先 `fleet_join` 再重启；
+- 默认 `direct.host=0.0.0.0` + UDP 组播发现；Windows 防火墙可能弹窗，需允许。
+
+## 安装激活记录（本机 desktop profile，2026-11-09）
+
+- 第一次 install_bundle 被拒：`package.json` 带 UTF-8 BOM → 去掉 BOM 后通过；
+- 第一次 activate 失败：`@deepseek-ai/schemastery` 只有默认导出（`import Schema from ...`），改为默认导入；
+- 第二次 activate 失败：Cordis 直接访问未 inject 的服务会抛错 → 可选服务统一走 `ctx.get(name)`；
+- 最终 `set_plugin include:device-fleet enabled=true` → `application: applied`，8 个 `fleet_*` 工具出现在模型工具表，`fleet_list` 返回本机 device id，`taskui_probe` 仍为 v0.4.2 / tasks=247（与 task-list 无冲突）。
+- 已发布 `0.1.0-dev.3`（包含上述激活修复）；`0.1.0-dev.1` 会激活失败，不要使用。
+## 0.1.0-dev.3（本次）
+
+- 邀请里新增 `endpoints`（创建者的局域网/热点 IPv4 + direct 端口），加入方重启后自动向这些地址回连，绕开组播发现失败；
+- 新增 `fleet_status`（deviceId/直连端口/发现/连接/roster/hints）与 `fleet_connect(host, port)`（手动直连，成功后会从握手学到对端 deviceId）；
+- `fleet_list` 仍是本地视图；配对成功后双方 roster 会自动固定对端公钥。
+## 0.1.0-dev.10（稳定化）
+
+- 直连端口可固定（profile `direct.port`），插件重载不再换端口；
+- 连接断开后自动重试已知地址（不再只在启动时试一次）；
+- `fleet_connect` 手动地址会持久化到 `peer-hints.json`，重启后继续回连；
+- 新增 `fleet_delegate`（dev.5）：目标设备用 `SubagentProvider` + `delivery:'caller'` 跑 agent 并返回最终结果。
+## 0.1.0-dev.10（审批收件箱，逻辑层）
+
+- 新增 `ApprovalInbox`：ask 档请求排队、超时 fail-closed、approve（once/ttl）/deny、关闭时全部失败关闭；
+- 直调与委派的 ask 档改为等待本机收件箱结果（不再一律拒绝）；
+- 新工具：`fleet_approvals` / `fleet_approve` / `fleet_deny`；`fleet_simulate_request`（仅 `approvals.simulation: true`）用于本机无第二台设备时演练流程；
+- 审批面板（Client UI）与通知尚未实现，当前通过工具/后续 UI 应答。
+## 0.1.0-dev.10（Room 逻辑层，本机模拟）
+
+- `RoomService`：当前会话升级为 Room Host；本地模拟参与者（真实 DSH session/agent）；
+- 寻址消息：`room_send` 只唤醒被点名成员，Host 会话写权威 `room/message` 事件；
+- 可见性：`room_messages` 提供完整 transcript；未点名成员不运行；
+- Room Board：`room_task_add/update/list`，`dependsOn` 串行交接（前置完成时唤醒下一个 owner），无依赖任务并行不受影响；
+- 工具：`room_create / room_add_local / room_remove_member / room_send / room_messages / room_status / room_task_* / room_close`；
+- 远程参与者传输与 Client UI 未做（下一步）。
+## 0.1.0-dev.10（审批面板 UI，第一版）
+
+- Host 新增本地 HTTP 数据面：GET `/device-fleet/approvals`、POST `/device-fleet/approvals/decide`（仅本机 web 载体，决策仍走 ApprovalInbox）；
+- Client half：`client.js` 闭包工厂，注册 `shell.overlay` 浮动「Fleet 审批」按钮 + 面板，轮询待审批列表，支持允许一次 / 允许 15 分钟 / 拒绝；
+- package.json 增加 `dsh.client` 与 `./client` 导出；`files` 增加 client.js；
+- Client 视觉验证需要刷新页面；当前无浏览器控制，仅验证了 bundle 语法与 Host 路由注册。

package/docs/notes/pairing-session-2026-11-09.md

@@ -0,0 +1,30 @@
+# 首次配对实录（2026-11-09）
+
+## 环境
+
+- 设备 A：本机（Windows，DSH desktop profile，`device-fleet` 0.1.0-dev.3）
+  - deviceId：`50fdaf90-f0aa-440e-9fa6-c60ba5051001`，deviceName：`desktop`
+  - 直连：`0.0.0.0:60506`（热点网段 `192.168.137.1:60506`）
+  - allowedRoots：`E:/Dsh_test`
+- 设备 B：另一台设备（同一热点 `192.168.137.0/24`，plugin 0.1.0-dev.3）
+  - deviceId：`c2d42572-e5f0-4d7e-9fff-c28d9a668439`
+- 热点网段内网段：A `192.168.137.1/24`，B 为客户端之一。
+
+## 过程
+
+1. dev.3 邀请携带 `endpoints`（A 的 `210.73.18.88:60506` 与 `192.168.137.1:60506`）。
+2. B 安装 dev.3 → `fleet_join` 新邀请 → 重启；插件读取 enrollment endpoints，自动回连 A。
+3. 结果：双方握手成功，roster 互固定公钥；A 侧 `fleet_list` 显示 B `online`，`fleet_status.connected` 含 B。
+4. `fleet_tools(device=B)` 成功（说明 RPC/加密通道正常）。
+5. `fleet_read(device=B, path=E:/Dsh_test/hello-from-A.txt)` 返回 `denied: no allowed roots configured on this device` —— 策略按设计拦截，B 侧尚未配置 allowedRoots。
+
+## 结论
+
+- **网络层 v1 直连 + 配对流程打通**（组播发现在该热点下不可用，邀请 endpoints 自动回连解决了问题）。
+- **Tool Policy 生效**：目标设备未配置允许根时直调被拒。
+- 待配置 B 的 `policy.allowedRoots` / `execution.cwd` 后可双向直调；`fleet_run` 待审批收件箱 UI。
+
+## 复现要点
+
+- 邀请里的 endpoints 由 `networkInterfaces()` 的非回环 IPv4 + 当前 direct port 组成；direct 端口每次插件重载会变，重载后需重新生成邀请或手动 `fleet_connect`。
+- 同一账号指纹：邀请携带 `accountFingerprint`；B 登录不同账号会在加载时被标记 mismatch 并拒绝连接。

package/docs/notes/remote-tests-2026-11-09.md

@@ -0,0 +1,33 @@
+# 跨设备调用实测（2026-11-09，dev.6）
+
+环境：A `desktop` / `50fdaf90-…`（端口固定 60580）；B `laptop` / `c2d42572-…`（dev.6，同一热点）。
+测试文件：A `E:\Dsh_test\hello-from-A.txt`；B `E:\Dsh_test\hello-from-B.txt`。
+
+## 结果
+
+| # | 调用 | 结果 | 耗时 |
+|---|---|---|---|
+| 1 | `fleet_read(B, E:/Dsh_test/hello-from-B.txt)` | ✅ 返回 `hello from device B` | 48ms |
+| 2 | `fleet_call(B, tool="read", {file_path:…hello-from-B.txt})` | ✅ 返回同一内容（原始工具直调） | 4ms |
+| 3 | `fleet_fetch(B, hello-from-B.txt)` | ✅ 返回文本 | 1ms |
+| 4 | `fleet_run(B, "echo hello-from-B")` | ⚠️ `approval_denied`（B 策略 run=ask，审批 UI 未实现，fail-closed 正确） | 即时 |
+| 5 | `fleet_delegate(B, "读取 hello-from-B.txt 并原样返回")` | ✅ B 的 agent（spawn 子会话 `1a768f89…`）读文件并回传最终文本 | 2.7s |
+| 6 | `fleet_delegate(B, "用 fleet_read 读 A 的 hello-from-A.txt 并原样返回")` | ✅ B 的 agent 反向调用 A 的 `read`，回传 `hello from device A (fleet test)`（子会话 `515f8c1b…`） | 2.5s |
+
+## 结论
+
+- v1 直连 + 端到端加密 + 配对/roster 固定公钥：**通过**；
+- 直调（typed 快捷工具 / `fleet_call` 原始工具 / fetch）：**通过**；
+- Tool Policy 与 fail-closed 审批：**按设计生效**；
+- 跨设备委派（B 的 agent 在本机执行并回传；B 的 agent 反向调 A 工具）：**通过**；
+- 遗留：审批收件箱 UI（`run`/`delegate` 的 `ask` 档目前只能拒绝或配置 auto）；Room/Room Board/设备页 UI 未开始；委派返回文本里 `[reasoning]` 是结果里的 reasoning block 展示，可后续过滤。
+
+## 复现命令（A 侧）
+
+```
+fleet_list()
+fleet_read(device="c2d42572-…", path="E:/Dsh_test/hello-from-B.txt")
+fleet_call(device="c2d42572-…", tool="read", parameters={file_path:"E:/Dsh_test/hello-from-B.txt"})
+fleet_delegate(device="c2d42572-…", task="读取 E:/Dsh_test/hello-from-B.txt 并原样返回")
+fleet_delegate(device="c2d42572-…", task="用 fleet_read 读设备 50fdaf90-… 的 E:/Dsh_test/hello-from-A.txt 并原样返回")
+```

package/docs/notes/room-logic-phase.md

@@ -0,0 +1,31 @@
+# Room 逻辑层实测（2026-11-09，dev.8，单机模拟参与者）
+
+在当前这台 DSH 内，用两个**真实本地 session/agent** 充当 Room 参与者，验证寻址唤醒与看板串行交接，不依赖第二台设备。
+
+## 流程与结果
+
+1. `room_create` → roomId = 当前会话 `session-269260c9-…`，host 成员 `host:session-269260c9-…`。
+2. `room_add_local(name="worker-a", cwd=E:/Dsh_test)` → 真实 session `session-d063026e-…`。
+3. `room_send(to=[worker-a], text="读取 hello-from-A.txt 并用 room_send 回复 host")` → `woke worker-a`；
+   - worker-a 的 agent 真实跑了一轮模型 + 本机 `read`，并在 3.4s 内调用 `room_send` 回传 `hello from device A (fleet test)`；
+   - transcript 两条消息，完整可见。
+4. `room_add_local(name="worker-b")`；看板：
+   - taskA `读取 hello-from-A.txt` owner=worker-a；
+   - taskB `汇总读取结果` owner=worker-b，`dependsOn=[taskA]`；
+   - taskC `并行：独立检查` owner=worker-a，无依赖。
+5. `room_task_update(taskA, done)` → 返回 `handed off to worker-b`；worker-b 被点名唤醒，30s 内完成汇总并 `room_send` 给 host（内容含前序结果、交叉校验、并行任务仍 pending 的说明），同时把自己 taskB 置为 running。
+6. `room_task_list`：taskA done、taskB running、taskC pending（并行任务未被串行交接影响）。
+7. `room_close`。
+
+## 结论
+
+- Room 生命周期、成员管理、寻址消息、未点名不唤醒、host 权威日志：单机逻辑通过；
+- Room Board `dependsOn` 串行交接 / 并行任务不阻塞：真实 agent 验证通过；
+- 参与者使用的都是真实 DSH agent（各自 session），不是 mock。
+
+## 限制（下一步）
+
+- 远程参与者传输（把 local participant 换成远端设备成员）尚未接入；
+- Client 面板/房间视图未做（用户无法在 GUI 直接看 room 时间线/看板）；
+- 房间状态在插件内存 + host session 事件里，插件重载后需要 rehydrate（未实现）；
+- 房间策略仅存储，尚未强制（invite/join/maxMembers 中 maxMembers 已生效）。

package/package.json

@@ -1,45 +1,54 @@
-{
-    "name":  "dsh-device-fleet",
-    "version":  "0.1.0-dev.1",
-    "description":  "DeepSeek Harness device fleet: enroll devices, direct-call remote tools, shared Rooms with lazy-woken agents, and delegated subagents across devices.",
-    "type":  "module",
-    "main":  "src/plugin/index.js",
-    "exports":  {
-                    ".":  "./src/plugin/index.js",
-                    "./net":  "./src/net/index.js",
-                    "./host":  "./src/host/index.js",
-                    "./package.json":  "./package.json"
-                },
-    "engines":  {
-                    "node":  "\u003e=22"
-                },
-    "dsh":  {
-                "bundle":  {
-                               "patch":  "./cordis.patch.yml"
-                           }
-            },
-    "peerDependencies":  {
-                             "@deepseek-ai/cordis":  "~4.1.0",
-                             "@deepseek-ai/dsh-tools":  "^0.2.2-rc.1",
-                             "@deepseek-ai/dsh-llm":  "^0.2.2-rc.1",
-                             "@deepseek-ai/schemastery":  "~3.19.0"
-                         },
-    "scripts":  {
-                    "test":  "node test/net.test.mjs \u0026\u0026 node test/host.test.mjs",
-                    "test:net":  "node test/net.test.mjs",
-                    "test:host":  "node test/host.test.mjs"
-                },
-    "files":  [
-                  "src",
-                  "cordis.patch.yml",
-                  "README.md",
-                  "CONTEXT.md",
-                  "docs",
-                  "LICENSE"
-              ],
-    "publishConfig":  {
-                          "access":  "public",
-                          "tag":  "dev"
-                      },
-    "license":  "MIT"
-}
+{
+  "name": "dsh-device-fleet",
+  "version": "0.1.0-dev.11",
+  "description": "DeepSeek Harness device fleet: enroll devices, direct-call remote tools, shared Rooms with lazy-woken agents, and delegated subagents across devices.",
+  "type": "module",
+  "main": "src/plugin/index.js",
+  "exports": {
+    ".": "./src/plugin/index.js",
+    "./client": "./client.js",
+    "./net": "./src/net/index.js",
+    "./host": "./src/host/index.js",
+    "./package.json": "./package.json"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "immediately": true,
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime"
+      ]
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "~4.1.0",
+    "@deepseek-ai/dsh-tools": "^0.2.2-rc.1",
+    "@deepseek-ai/dsh-llm": "^0.2.2-rc.1",
+    "@deepseek-ai/schemastery": "~3.19.0"
+  },
+  "scripts": {
+    "test": "node test/net.test.mjs && node test/host.test.mjs",
+    "test:net": "node test/net.test.mjs",
+    "test:host": "node test/host.test.mjs"
+  },
+  "files": [
+    "src",
+    "client.js",
+    "cordis.patch.yml",
+    "README.md",
+    "CONTEXT.md",
+    "docs",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "tag": "dev"
+  },
+  "license": "MIT"
+}