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

package/README.md

@@ -9,6 +9,44 @@ DeepSeek Harness 的设备联邦插件：把登录同一账号、且都安装本
 - ✅ **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（下一步）
 
+## 安装（开发版）
+
+已发布到 npm：**`dsh-device-fleet@0.1.0-dev.1`**（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.1.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` 验证链路。
+
 ## 设计文档
 
 - 术语表：[CONTEXT.md](./CONTEXT.md)

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/dev-release.md

@@ -0,0 +1,28 @@
+# 开发版发布记录
+
+- 包名：`dsh-device-fleet`
+- 版本：`0.1.0-dev.1`
+- 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.1.tgz>
+- 本地离线包：`dsh-device-fleet-0.1.0-dev.1.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.1`，DSH 版本也要同一发布线；
+- `fleet_run` 的 `ask` 审批目前 fail-closed（审批收件箱未实现）；
+- `fleet_fetch` 仅返回文本；
+- 首次加载会在 `$DSH_HOME/device-fleet/` 自动创建身份与独立 Fleet；加入已有 Fleet 需要先 `fleet_join` 再重启；
+- 默认 `direct.host=0.0.0.0` + UDP 组播发现；Windows 防火墙可能弹窗，需允许。

package/package.json

@@ -1,45 +1,45 @@
-{
-    "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.2",
+  "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": ">=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 && 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"
+}

package/src/plugin/index.js

@@ -8,7 +8,7 @@ import { readFileSync } from 'node:fs'
 import { fileURLToPath } from 'node:url'
 import { defineTool } from '@deepseek-ai/dsh-tools'
 import { createUserMessage } from '@deepseek-ai/dsh-llm'
-import { Schema } from '@deepseek-ai/schemastery'
+import Schema from '@deepseek-ai/schemastery'
 import { FleetNode } from '../net/fleet-node.js'
 import { accountFingerprint } from '../net/identity.js'
 import { DirectCallClient, DirectCallHost } from '../host/direct-call.js'
@@ -115,7 +115,16 @@ function withManual(definitions) {
 export function apply(ctx, config) {
   const pluginVersion = packageVersion()
   const dshVersion = process.env.DSH_CLIENT_VERSION ?? 'unknown'
-  const logger = ctx.logger ?? console
+  // Optional services: Cordis throws on direct property access for services the
+  // plugin did not inject, so every optional service goes through get().
+  const service = (name) => {
+    try {
+      return ctx.get?.(name)
+    } catch {
+      return undefined
+    }
+  }
+  const logger = service('logger') ?? console
 
   let state
   try {
@@ -140,8 +149,8 @@ export function apply(ctx, config) {
   })
 
   const policy = new ToolPolicy(config.policy)
-  const sessionController = ctx.sessionController ?? ctx.get?.('sessionController')
-  const fs = ctx.fs ?? ctx.get?.('fs')
+  const sessionController = service('sessionController')
+  const fs = service('fs')
   if (!sessionController) logger.warn?.('[device-fleet] sessionController unavailable: direct calls to stateful tools will fail')
   const slot = sessionController
     ? new ExecutionSlot({ sessionController, tools: ctx.tools, config: config.execution })
@@ -186,7 +195,7 @@ export function apply(ctx, config) {
   })
 
   // Bind the local account fingerprint when the account service is composed.
-  const account = ctx.get?.('deepseekAccount')
+  const account = service('deepseekAccount')
   if (account && typeof account.getDeviceIdentity === 'function') {
     void account
       .getDeviceIdentity()
@@ -225,7 +234,7 @@ export function apply(ctx, config) {
   for (const definition of wrapped) ctx.tools.register(definition)
 
   // Adoption layer 2: one sentence, only when the Fleet has members.
-  const systemPrompt = ctx.get?.('systemPrompt') ?? ctx.systemPrompt
+  const systemPrompt = service('systemPrompt')
   if (systemPrompt && config.promptSection !== false) {
     const order = systemPrompt.getSectionOrder?.('TOOL_SUBAGENT') ?? PROMPT_SECTION_ORDER
     ctx.effect(() =>
@@ -271,6 +280,6 @@ export function apply(ctx, config) {
     void node.close()
   })
 
-  ctx.logger?.info?.(`[device-fleet] v${pluginVersion} device ${state.identity.deviceId} (${config.deviceName})`)
+  logger.info?.(`[device-fleet] v${pluginVersion} device ${state.identity.deviceId} (${config.deviceName})`)
   void ready
 }