dsh-plugin-mobile-gateway 0.8.1 → 0.9.0

package/PROTOCOL.md

@@ -1,6 +1,6 @@
 # dsh Mobile Gateway — WebSocket 协议参考
 
-移动端通过经过设备鉴权的 WebSocket 连接与 dsh 通信：订阅 agent 实时输出、发送文字和图片、处理 Human-in-the-loop 提问与操作审批、查询会话/工作区/历史、调整会话配置。本协议由持久化插件 `dsh-plugin-mobile-gateway` 实现。当前源码适配 DSH 0.1.7-rc.2 / Session format 4；移动端实时流接入见 [rc.2 接入说明](docs/dsh-rc2-mobile-integration.md)。
+移动端通过经过设备鉴权的 WebSocket 连接与 dsh 通信：订阅 agent 实时输出、发送文字和图片、处理 Human-in-the-loop 提问与操作审批、查询会话/工作区/历史、调整会话配置。本协议由持久化插件 `dsh-plugin-mobile-gateway` 实现。当前源码适配 DSH 0.2.0-rc.2 / Session format 4；移动端实时流接入见 [rc.2 接入说明](docs/dsh-rc2-mobile-integration.md)，插件管理见 [RC2 插件管理对接方案](docs/dsh-0.2.0-rc.2-plugin-management-mobile-integration.md)。
 
 - **本机端点**：`ws://127.0.0.1:3080/ws/mobile`（与 dsh web GUI 同端口）
 - **局域网端点**：`ws://<电脑的私有局域网 IP>:3081/ws/mobile`（插件独立监听，只提供经过鉴权的 WebSocket）
@@ -110,6 +110,8 @@ const pairingText = Buffer.from(JSON.stringify(payload), 'utf8').toString('base6
 
 Windows/macOS PC 可从本机管理接口 `POST /mgw/cloudflare` 一键启用 Quick Tunnel：`{"enabled":true,"mode":"quick"}`，无需账户、域名或 Token；返回的随机公网地址在 `GET /mgw/status` 的 `cloudflare.publicUrl` 中，隧道重启后可能变化，App 需重新扫码确认。固定地址可用命名 Tunnel：`{"enabled":true,"mode":"named","hostname":"gateway.example.com","token":"<Tunnel Token>"}`；后续更新可省略 Token 或传空字符串以保留已保存的 Token，关闭时只需 `{"enabled":false}`。状态字段返回模式、支持状态、公开地址、本机入口端口、连接状态和错误，但绝不返回 Token。启用时网关自动切为常驻模式；配置与 Token 保存在独立的 `0600` 文件中。插件会在需要时下载并校验 Cloudflare 官方 `cloudflared` 二进制。两种模式仅在 `127.0.0.1:3082`（可配置）接受已鉴权的 `/ws/mobile` WebSocket，其他 HTTP 路径返回 404；网关关闭或插件卸载时该入口及受管进程一同停止。
 
+`POST /mgw/cloudflare/restart` 无需请求体，仅在网关与 Tunnel 均已开启时重启隧道；未开启时返回 `409`。当前移动连接会断开，Quick Tunnel 的地址可能变化，客户端需重新扫码确认。此操作不会重启 DSH Web，也不会将 `cloudflared` 自动更新到最新版本。
+
 完整配对示例、旧 App 迁移、地址信任与错误处理见 [App 对接说明](docs/multi-gateway-app-integration.md)。
 
 #### iOS 对接示例
@@ -1088,6 +1090,12 @@ Control/旧单连接接收全局模式状态增量，不受所订阅会话过滤
 - `tool/result` → `{turn, step, callId, isError, preview(≤400字符)}`
 - `turn/start|end` / `step/start|end` → `{turn, step, reason?}`
 
+### 运行中计时提示
+
+DSH Web 的“深度求索中，用时 22 秒 ···”是客户端文案，不作为独立 Host 事件或网关帧发送。移动端可用 `sessions.items[].running` 判断会话是否运行；订阅中的 `event` 帧在根节点带 `time`，`event.type: turn/start` 标记本轮开始，`turn/end` 标记结束。收到 `turn/start` 后以 `Date.now() - time` 在本地更新秒数，收到 `turn/end` 或会话 `running: false` 后停止。计时文本、单位和动画由移动端本地化渲染。
+
+重连得到的 `session-snapshot.events` 只含最近窗口，长时间运行的 Turn 可能已把 `turn/start` 挤出窗口。此时 `sessions.items[].running` 仍可用来显示“深度求索中”，但不能只凭快照推断准确的起始时间；若需要恢复精确计时，应沿 `nextBeforeSeq` 读取更早历史，找到最近尚未结束的 `turn/start`。未取得起始时间前不要从重连时刻重新计算并声称是整轮耗时。
+
 ---
 
 ## 14. 端到端示例（Postman）
@@ -1122,7 +1130,7 @@ Control/旧单连接接收全局模式状态增量，不受所订阅会话过滤
 
 | 版本 | 新增 |
 |---|---|
-| v0.8.1（当前源码） | PC 端 Cloudflare Quick / 命名 Tunnel；插件私有 `cloudflared` 缓存及校验；配对入口选择指引；网关重启与 DSH Web 停止工具 |
+| v0.9.0（当前源码） | DSH 0.2.0-rc.2 插件管理；PC 端 Cloudflare Quick / 命名 Tunnel 及独立重启；插件私有 `cloudflared` 缓存及校验；配对入口选择指引；网关重启与 DSH Web 停止工具 |
 | v0.7.2 | 独立对话/控制连接；空 Session 创建；停止生成与稍后继续；排队消息同步及编辑/删除/Steer；App 归档/重命名 Session；WebUI 归档集合和名称变化实时同步到 App |
 | v0.1.5 | workspace-create / directories / host |
 | v0.1.6 | 修复消息分发器遗漏（host/directories/workspace-create 未路由） |
@@ -1167,6 +1175,28 @@ Control/旧单连接接收全局模式状态增量，不受所订阅会话过滤
 
 rc.2 没有 `schedule/create` Remote 方法。新提醒由 Agent 的 `schedule_create` 工具创建；到期提醒作为 `source.kind: schedule` 的消息进入原 Session。Host 的无载荷 `schedule/changed` 被投影为移动端 `schedule-changed`；实现定时任务管理页面的客户端应在收到通知、重连或完成更新/删除后重新查询目录。当前移动端只接入协议请求、解码与变更帧识别，尚未提供管理页面。`hello.capabilities` 中的 `schedule-management` 表示网关支持这些请求，实际使用仍取决于 Host 是否启用定时任务。
 
+## 18. 插件管理（DSH 0.2.0-rc.2）
+
+`hello.capabilities` 包含 `plugin-management-v1`。插件请求走控制连接，必须使用已配对设备 token；即使本机调试关闭了普通连接鉴权，匿名连接也不能执行这些请求。每个请求必须有非空 `requestId`，响应回显。`plugin-catalog` 的 `managementAvailable` 决定当前 Host profile 是否实际支持管理。
+
+| 请求 type | 主要参数 | 成功响应 |
+|---|---|---|
+| `plugin-catalog` | `requestId` | 同名 kind；`managementAvailable`、`bundles`（每项含 `experimental`）、`plugins`、`officialItems`、`settingsWritable` |
+| `plugin-registries` | `requestId` | 同名 kind；`registry`、`fallbackRegistries`、`resolved` |
+| `plugin-inspect` | `requestId`, `spec`, `registry?` | `plugin-inspection`；`result` 为 accepted/refused 检查结果 |
+| `plugin-install` | `requestId`, `spec`, `enabled?`, `registry?`, `approvedBuilds?` | `plugin-install-result`；`result` 为 Host `ChangeResult` |
+| `plugin-install-status` / `plugin-install-cancel` | `requestId`, `installId` | 同名 kind；`result` 为安装结果/null 或取消状态 |
+| `plugin-bundle-set-enabled` | `requestId`, `name`, `enabled` | 同名 kind；`result` 为 `ChangeResult` |
+| `plugin-entry-set-enabled` | `requestId`, `entryId`, `enabled` | 同名 kind；`result` 为 `ChangeResult` |
+| `plugin-remove` | `requestId`, `name` | 同名 kind；`result` 为 `ChangeResult` |
+| `plugin-settings` | `requestId`, `ns?` | 同名 kind；全部 namespace 或指定的 `namespace` 视图 |
+| `plugin-settings-mutate` | `requestId`, `ns`, `expectedRevision`, `ops` | 同名 kind；返回修改后的 namespace 视图 |
+| `plugin-version-exemptions` / `plugin-version-exemption-set` | `requestId`；写入还需 `packageVersion`, `runtimeVersion`, `enabled`, `acceptRisk?` | 同名 kind；豁免列表或 `ChangeResult` |
+
+Host 的 `plugin-manager/changed` 转为 `plugins-changed`（含 `reason`），`settings/document-updated` 转为 `plugin-settings-changed`（含 `ns`、`revision`）。`plugin-manager/install-state` 和 `plugin-manager/install-log` 只发给发起安装的连接，分别转为 `plugin-install-state` 和 `plugin-install-log`；它们的 `requestId` 就是原安装请求 ID。断线后用新的请求 ID 调 `plugin-install-status`，`installId` 填原安装 ID；切勿直接重复安装。关闭/卸载网关插件自身可能先断线，再由 DSH Web/CLI 恢复。
+
+详细字段、官方/第三方页面分组、安装进度、配置 schema、错误处理和 DSH Mobile 验收步骤见 [插件管理对接方案](docs/dsh-0.2.0-rc.2-plugin-management-mobile-integration.md)。
+
 ---
 
 *协议与插件源码同源维护：`dsh-plugin-mobile-gateway/lib/index.mjs` 顶部注释即协议摘要。*

package/README.md

@@ -6,11 +6,11 @@
 
 DeepSeek Harness 的设备鉴权移动网关，支持会话与实时事件、排队消息同步及编辑/删除/Steer、Session 归档和重命名的双向同步、停止当前生成并稍后继续、任务列表和当前 Goal 同步及管理、服务端驱动的命令和技能菜单、Human-in-the-loop、图片及文件传输。安装后，Harness WebUI 左侧边栏会出现“移动设备”入口，可直接开启网关、生成配对二维码和管理可信设备。
 
-> 当前源码以 **DSH 0.1.7-rc.2** 为适配基线，使用 Session format 4；旧版历史游标需重新取得基线。
+> 当前源码以 **DSH 0.2.0-rc.2** 为适配基线，使用 Session format 4；旧版历史游标需重新取得基线。
 >
 > 实时流已改为独立 `assistant-stream` 帧，移动端需要按 [rc.2 接入说明](docs/dsh-rc2-mobile-integration.md) 更新订阅、缓存与分页处理。当前修改尚未发布。
 >
-> v0.8.1（当前源码）：PC 端可在面板开启 Cloudflare Quick / 命名 Tunnel，使用插件私有缓存中的 `cloudflared` 并校验文件；配对面板增加局域网与外网入口选择指引；工具菜单可重启网关或停止 DSH Web，重启时不再打开新标签页。
+> v0.9.0（当前源码）：新增 DSH 0.2.0-rc.2 插件管理能力；PC 端可在面板开启、重启 Cloudflare Quick / 命名 Tunnel，使用插件私有缓存中的 `cloudflared` 并校验文件；配对面板增加局域网与外网入口选择指引；工具菜单可重启网关或停止 DSH Web，重启时不再打开新标签页。
 >
 > v0.7.3：优化移动网关运行模式下拉框的箭头间距。
 >
@@ -18,7 +18,7 @@ DeepSeek Harness 的设备鉴权移动网关，支持会话与实时事件、排
 
 ## 协议与 DSH 兼容层
 
-移动端连接的是本项目维护的 `dsh-mobile-v1`，不是 DSH 的内部 Remote 协议。插件内部通过独立 Host Adapter 对接 DSH 0.1.7-rc.2 的 Remote Gateway；Session、Workspace、Settings、Commands、Goals、Schedule、Permission Presets 等 namespace 和严格参数只存在于该适配层。
+移动端连接的是本项目维护的 `dsh-mobile-v1`，不是 DSH 的内部 Remote 协议。插件内部通过独立 Host Adapter 对接 DSH 0.2.0-rc.2 的 Remote Gateway；Session、Workspace、Settings、Commands、Goals、Schedule、Permission Presets、Plugin Manager 等 namespace 和严格参数只存在于该适配层。插件管理的请求帧及 DSH Mobile 页面方案见 [RC2 插件管理对接方案](docs/dsh-0.2.0-rc.2-plugin-management-mobile-integration.md)。
 
 配对鉴权和 `dsh-mobile-v1` / `hello.protocol = 3` 保持不变。新版实时 token 不占用持久事件的 `seq`：客户端显式订阅 `assistantStream: true`，接收原子的 `session-snapshot` 和独立增量；普通 `event` 只携带持久事件。未接入新订阅的客户端只能收到持久消息。
 
@@ -195,6 +195,8 @@ http://127.0.0.1:<本地端口>
 
 Quick Tunnel 无需 Cloudflare 账户、Token 或自己的公网域名，但地址在 DSH 重启或隧道重连后可能变化。手机 App 只信任已确认的地址，因此地址变化后需在面板重新生成二维码并扫码更新配对；**仅凭 PC 在线不能保证旧地址继续可用**。Cloudflare 将 Quick Tunnel 定位于测试和开发，当前有并发请求上限且不提供可用性保证。参见 [Cloudflare Quick Tunnel 文档](https://developers.cloudflare.com/cloudflare-one/networks/connectors/cloudflare-tunnel/do-more-with-tunnels/trycloudflare/)。
 
+面板中的“更新 Tunnel 配置”保存所选模式及命名 Tunnel 参数；配置不变时不会重新连接。“重启 Tunnel”会断开当前移动连接并重建 Cloudflare 隧道，不会重启 DSH Web；Quick Tunnel 重启后可能取得新地址，旧二维码会清除，需按新地址重新扫码。此操作不会自动升级 `cloudflared` 到最新版本。
+
 ### Cloudflare 命名 Tunnel（固定地址）
 
 1. 在 [Cloudflare 控制台创建远程管理的 Tunnel](https://developers.cloudflare.com/tunnel/get-started/)，添加一个公开域名（例如 `gateway.example.com`），将该路由的 **Service URL** 设为 `http://127.0.0.1:3082`。无需安装 Cloudflare 系统服务，也无需开放路由器入站端口。

package/docs/dsh-0.2.0-rc.2-plugin-management-mobile-integration.md

@@ -0,0 +1,109 @@
+# DSH 0.2.0-rc.2 插件管理：DSH Mobile 对接方案
+
+## 范围与入口
+
+网关通过现有 `dsh-mobile-v1` WebSocket 提供与 DSH Web 插件页相同的管理数据和操作。所有请求发往 **control** 连接；单连接旧客户端也可发送。必须使用已配对设备的 token。`hello.capabilities` 包含 `plugin-management-v1` 表示网关认识这些帧，页面仍以 `plugin-catalog.managementAvailable` 判断当前 Host 能否管理插件。网关修改的是其所连接的 DSH profile，不是手机本地插件。
+
+截图中的「添加插件」对应**安装已有插件包**，不是创建源码工程。DSH RC2 的 Host 没有远程生成插件工程的接口；本方案覆盖 Web 插件页的浏览、安装、启停、卸载、配置与诊断，以及 Host 公开的插件条目控制和版本豁免。
+
+## 页面数据
+
+连接后发送：
+
+```json
+{"type":"plugin-catalog","requestId":"catalog-1"}
+```
+
+成功返回 `kind: plugin-catalog`、相同 `requestId`，以及：
+
+| 字段 | 含义 |
+|---|---|
+| `managementAvailable` | 当前 Host profile 是否支持插件管理；false 时隐藏写操作 |
+| `bundles` | Host `pluginManager/listBundles` 数组；每项额外增加网关计算的 `experimental` 布尔值 |
+| `plugins` | Host `pluginManager/listPlugins` 原始数组；用于包内条目及独立条目控制 |
+| `officialItems` | Web 的四类内置配置卡片：`shell`、`agent-loop`、`subagent`、`web-search`；每项提供当前可用的 `namespaces` |
+| `settingsWritable` | Host 设置是否允许写入 |
+
+按 Web 页面语义展示：先排除 DSH 内置 profile 包 `@deepseek-ai/dsh-base`、`@deepseek-ai/dsh-web-app`、`@deepseek-ai/dsh-headless`、`@deepseek-ai/dsh-sdk-app`、`@deepseek-ai/dsh-acp-app`、`@deepseek-ai/dsh-sdk-minimal`，再保留 `installed || optional || error` 的 bundle。其中 `optional && !installed` 放在「官方」，`installed || !optional` 放在「已安装」。内置配置卡片也放在「官方」，但没有包级启停开关，点击进入配置。`bundles` 每行有 `name`、`version?`、`meta?`、`description?`、`enabled`、`installed`、`optional`、`removable`、`readOnlyReason?`、`error?`、`rows`、`overrides`，以及网关追加的 `experimental`。DSH Web 根据包名以 `@deepseek-ai/dsh-experimental-` 开头来生成「实验性」标签；移动端直接用 `experimental: true` 显示本地化标签，不需要自行猜测。显示名称、说明和图标优先取 `meta` 的本地化字段；`meta.title` 和 `meta.description` 可以是文本或带 `en` 回退的语言映射，`meta.icon` 是图片 data URL，不作为 HTML 注入。否则回退到 `description` / `name`。`readOnlyReason` 禁用启停，`removable: false` 仅禁用卸载；官方可选包即使不可卸载仍可启停。不要用 `plugins` 推测一个 bundle 的总开关状态，以 `bundle.enabled` 为准。
+
+`managementAvailable: false` 时返回空目录和 `settingsWritable: false`。所有目录数据属于所连网关的 DSH profile；切换网关后重新请求并按 `gatewayId` 分别缓存。
+
+## 请求与响应
+
+每个插件请求都必须带本次连接内唯一的非空 `requestId`；响应原样带回。成功帧如下，`result` 均为 Host 原始结果，App 不应只凭发送成功就更新开关：
+
+| 请求 `type` | 参数 | 成功 `kind` 与字段 |
+|---|---|---|
+| `plugin-catalog` | — | `plugin-catalog`：上述目录字段 |
+| `plugin-registries` | — | `plugin-registries`：`registry`、`fallbackRegistries`、`resolved` |
+| `plugin-inspect` | `spec`, `registry?` | `plugin-inspection`：`result` 为 `accepted` 或 `refused` 的安装前检查 |
+| `plugin-install` | `spec`, `enabled?`, `registry?`, `approvedBuilds?` | `plugin-install-result`：`result` 为 `ChangeResult` |
+| `plugin-install-status` | `installId` | `plugin-install-status`：`result` 为 `ChangeResult` 或 `null` |
+| `plugin-install-cancel` | `installId` | `plugin-install-cancel`：`result.status` 为 `cancelled` / `too-late` / `not-running` |
+| `plugin-bundle-set-enabled` | `name`, `enabled` | 同名 `kind`：`result` 为 `ChangeResult` |
+| `plugin-entry-set-enabled` | `entryId`, `enabled` | 同名 `kind`：`result` 为 `ChangeResult` |
+| `plugin-remove` | `name` | 同名 `kind`：`result` 为 `ChangeResult` |
+| `plugin-settings` | `ns?` | 同名 `kind`：不传 `ns` 返回 `writable`、`hasDocument`、`namespaces`；传 `ns` 返回 `writable`、`namespace` |
+| `plugin-settings-mutate` | `ns`, `expectedRevision`, `ops` | 同名 `kind`：返回修改后的 namespace 视图 |
+| `plugin-version-exemptions` | — | 同名 `kind`：`exemptions`、`warnings` |
+| `plugin-version-exemption-set` | `packageVersion`, `runtimeVersion`, `enabled`, `acceptRisk?` | 同名 `kind`：`result` 为 `ChangeResult` |
+
+`spec` 是 DSH/pnpm 安装规格，可为包名、绝对本地路径、Git 或 tarball。`registry` 为 HTTP(S) 地址或 `null`（使用 pnpm 自身配置），省略则按 Host 当前配置。移动端先调用 `plugin-registries` 提供来源选择，再 `plugin-inspect` 展示包名、版本、来源、是否 bundle；只有 `status: accepted` 才提交安装。包内插件条目使用 `entryId`，包级操作使用 `name`，二者不可互换。
+
+### 安装与恢复
+
+```json
+{"type":"plugin-inspect","requestId":"inspect-1","spec":"some-dsh-plugin"}
+{"type":"plugin-install","requestId":"install-1","spec":"some-dsh-plugin"}
+```
+
+安装期间，同一控制连接收到：
+
+```json
+{"kind":"plugin-install-state","requestId":"install-1","phase":"installing","attempt":{"registry":null,"index":1,"total":1}}
+{"kind":"plugin-install-log","requestId":"install-1","jobId":"...","stream":"stdout","text":"..."}
+```
+
+`phase` 可为 `installing`、`cancelling`、`applying`。日志只发给发起安装的连接，包含 `jobId`、`stream`、`text` 和可选 `exitCode`；App 限制内存中日志行数，并对输出视为不可信文本。结束时收到 `plugin-install-result`。取消使用 `plugin-install-cancel`，其 `installId` 等于原安装请求的 `requestId`。断线重连后可发送 `plugin-install-status`，`installId` 仍为原安装 ID；它可能等待运行中的安装结束，`result: null` 表示 Host 无此记录，随后刷新目录。不要用新的 `plugin-install` 盲目重试。
+
+`ChangeResult.application` 可能是 `applied`、`restart-required`、`overridden`、`failed`、`cancelled`；还需查看 `changed`、`stage`、`error`、`warnings`、`pendingBuilds`、`approvedBuilds`、`packageResult`。`restart-required` 时提示重启 DSH Web 后再刷新目录。若 `pendingBuilds` 非空，只有用户明确批准这些具体包的构建脚本，才再次安装并将包名放入 `approvedBuilds`；切勿自动批准。失败或取消后刷新目录确认最终状态。
+
+### 开关、卸载与配置
+
+```json
+{"type":"plugin-bundle-set-enabled","requestId":"toggle-1","name":"some-dsh-plugin","enabled":false}
+{"type":"plugin-entry-set-enabled","requestId":"entry-1","entryId":"some-entry-id","enabled":true}
+{"type":"plugin-remove","requestId":"remove-1","name":"some-dsh-plugin"}
+```
+
+用户操作前用目录的 `readOnlyReason`、`removable` 决定控件可用性。收到结果后依 `application` 展示成功、重启要求或错误，再刷新 `plugin-catalog`。**关闭或卸载 `dsh-plugin-mobile-gateway` 自身会切断当前连接**；App 应在操作前明确提示，并把连接中断后的最终状态标为“待重连确认”，不可视作操作失败或成功。关闭后只能从 DSH Web/CLI 重新开启。
+
+配置卡片与包内配置都走 Host settings。先请求 `plugin-settings`，用 `namespace.schema` 渲染表单，展示 `value` / `base` / `user`，使用 `secrets[].set` 显示“已设置”，不得期待服务端回传密钥明文。保存时仅提交改动路径：
+
+```json
+{"type":"plugin-settings-mutate","requestId":"save-1","ns":"web-search-deepseek","expectedRevision":4,"ops":[{"op":"set","path":["provider"],"value":"example"}]}
+```
+
+`ops` 支持 `set`（需要 `value`）和 `unset`，`path` 为字符串数组，空数组表示整个配置节。移动端应优先提交字段级操作并带读取时的 `revision`；版本冲突重新获取 namespace，让用户决定如何合并。内置配置卡片的 namespace 由 `officialItems` 返回，不要把 Web UI 内部路由当成插件 ID。
+
+版本豁免属于高风险高级设置；只在用户看到 Host 的具体不兼容版本并明确接受风险时传 `acceptRisk: true`。普通插件页可以先只展示豁免情况，但协议已经支持读取与修改。
+
+## 更新通知、错误与安全
+
+| 服务端通知 | App 行为 |
+|---|---|
+| `plugins-changed`，含 `reason` (`plugin` / `bundle` / `install` / `remove`) | 重新请求 `plugin-catalog`；该通知不包含完整目录 |
+| `plugin-settings-changed`，含 `ns`、`revision` | 当前正在编辑该 namespace 时标记远端已更新，重新读取后再保存 |
+| `plugin-install-state` / `plugin-install-log` | 仅更新匹配原安装 `requestId` 的进度 UI |
+
+错误统一为 `{"kind":"error","requestType":"...","requestId":"...","code":"...","message":"..."}`。参数错误为 `bad-request`，未配对为 `authentication-required`，同 ID 安装进行中为 `plugin-install/in-progress`；Host 错误保留其 `code`。`plugin-inspect` 的业务拒绝是成功帧内 `result.status: refused`，不是传输错误。所有可执行操作只发至经过鉴权的控制连接，App 不应在未配对、只读或目录不可用时展示可用按钮。
+
+## DSH Mobile 实施顺序与验收
+
+1. 在协议模型和控制通道请求器加入上表帧；`requestId` 用 UUID，按 `(gatewayId, requestId)` 关联响应及安装事件，设置超时和断线恢复。
+2. 完成插件页：官方可选包、四个内置配置卡片、已安装第三方包；使用 Host 提供的本地化元数据、状态与只读原因。
+3. 完成「添加插件」流程：registries → inspect → 用户确认 → install → 进度/日志 → 结果/刷新；支持取消和重连查询。
+4. 完成包级启停、条目级启停、卸载和 schema 配置；对 `restart-required`、构建脚本批准、网关自身停用及配置冲突给出明确状态。
+5. 在已配对 RC2 环境验收：官方包开关、第三方包安装和卸载、配置读取/保存、安装取消、断线恢复；同时验证未配对控制连接被拒绝。
+
+网关源码的单元测试覆盖 Host Remote 参数映射、响应、校验及安装 ID；端到端的真实包安装仍应在非生产 DSH profile 中验收，避免修改用户当前运行的 Web profile。

package/lib/client.js

@@ -352,6 +352,22 @@ window.__ModuleLoader__.load({
         }
       }
 
+      const restartCloudflare = async () => {
+        if (cloudflareBusy) return
+        setCloudflareBusy(true)
+        setError(null)
+        try {
+          const data = await request('/mgw/cloudflare/restart', { method: 'POST' })
+          if (data.mode === 'quick') setQr(null)
+          setStatus((current) => ({ ...(current || {}), cloudflare: data }))
+          await refresh()
+        } catch (cause) {
+          setError(cause.message)
+        } finally {
+          setCloudflareBusy(false)
+        }
+      }
+
       const createPairing = async (endpoint) => request('/mgw/pair', {
         method: 'POST',
         headers: { 'Content-Type': 'application/json' },
@@ -563,7 +579,10 @@ window.__ModuleLoader__.load({
                   onClick: () => configureCloudflare(true),
                 }, cloudflareBusy ? '正在处理…' : status.cloudflare.enabled && cloudflareMode === status.cloudflare.mode ? '更新 Tunnel 配置' : cloudflareMode === 'quick' ? '一键开启 Quick Tunnel' : '开启命名 Tunnel'),
                 status.cloudflare.enabled
-                  ? React.createElement('button', { style: { ...styles.button, width: '100%', marginTop: 8 }, disabled: cloudflareBusy, onClick: () => configureCloudflare(false) }, '关闭 Cloudflare Tunnel')
+                  ? React.createElement(React.Fragment, null,
+                      React.createElement('button', { style: { ...styles.button, width: '100%', marginTop: 8 }, disabled: cloudflareBusy || !status.gatewayEnabled, onClick: restartCloudflare }, '重启 Tunnel'),
+                      React.createElement('button', { style: { ...styles.button, width: '100%', marginTop: 8 }, disabled: cloudflareBusy, onClick: () => configureCloudflare(false) }, '关闭 Cloudflare Tunnel'),
+                      React.createElement('p', { style: styles.muted }, '重启会短暂断开手机连接；Quick Tunnel 可能获得新地址，需要重新扫码。'))
                   : null,
                 React.createElement('div', { style: { ...styles.muted, marginTop: 9, overflowWrap: 'anywhere', color: status.cloudflare.error ? colors.danger : colors.muted } },
                   status.cloudflare.error || ({ disabled: '未开启', starting: '正在启动本机入口…', preparing: '正在准备 cloudflared（首次需下载）…', connecting: '正在连接 Cloudflare…', online: '已连接 Cloudflare', 'waiting-for-gateway': '等待移动网关开启' }[status.cloudflare.state] || status.cloudflare.state),

package/lib/cloudflare-tunnel.mjs

@@ -263,6 +263,20 @@ export function createCloudflareTunnel({ file, port = 3082, wsPath, executable =
     return snapshot()
   }
 
+  const restart = () => {
+    queue = queue.catch(() => {}).then(async () => {
+      if (!shouldRun()) {
+        const cause = new Error('请先开启移动网关和 Cloudflare Tunnel')
+        cause.status = 409
+        throw cause
+      }
+      await stop()
+      await start()
+      return snapshot()
+    })
+    return queue
+  }
+
   const dispose = () => { disposed = true; void stop() }
-  return { snapshot, configure, reconcile, dispose }
+  return { snapshot, configure, reconcile, restart, dispose }
 }

package/lib/dsh-host-adapter.mjs

@@ -13,7 +13,7 @@ function requireArray(value, endpoint) {
   return value
 }
 
-export const DSH_VERSION = '0.1.7-rc.2'
+export const DSH_VERSION = '0.2.0-rc.2'
 export const SESSION_FORMAT_VERSION = 4
 
 export function readHistoryRecords(records) {
@@ -247,12 +247,39 @@ export function createDshHostAdapter(typertGateway) {
     },
     settings: {
       describe: (_payload = {}, signal) => invoke('settings', 'describe', {}, signal),
+      mutate: (payload, signal) => invoke('settings', 'mutate', {
+        ns: payload.ns,
+        ops: payload.ops,
+        expectedRevision: payload.expectedRevision,
+      }, signal),
       update: (payload, signal) => invoke('settings', 'update', {
         ns: payload.ns,
         patch: payload.patch,
         ...(payload.expectedRevision === undefined ? {} : { expectedRevision: payload.expectedRevision }),
       }, signal),
     },
+    plugins: {
+      inventory: (_payload = {}, signal) => invoke('pluginInventory', 'list', {}, signal),
+      listBundles: (signal) => invoke('pluginManager', 'listBundles', {}, signal),
+      listPlugins: (signal) => invoke('pluginManager', 'listPlugins', {}, signal),
+      registries: (signal) => invoke('pluginManager', 'registries', {}, signal),
+      inspect: (spec, options, signal) => invoke('pluginManager', 'inspect', {
+        spec, ...(options === undefined ? {} : { options }),
+      }, signal),
+      installBundle: (spec, options) => invoke('pluginManager', 'installBundle', { spec, options }),
+      waitForInstall: (requestId) => invoke('pluginManager', 'waitForInstall', { requestId }),
+      cancelInstall: (requestId) => invoke('pluginManager', 'cancelInstall', { requestId }),
+      setBundleEnabled: (name, enabled) => invoke('pluginManager', 'setBundleEnabled', { name, enabled }),
+      setPluginEnabled: (id, enabled) => invoke('pluginManager', 'setPluginEnabled', { id, enabled }),
+      removeBundle: (name) => invoke('pluginManager', 'removeBundle', { name }),
+      listVersionExemptions: () => invoke('pluginManager', 'listVersionExemptions', {}),
+      setVersionExemption: (packageVersion, runtimeVersion, enabled, acceptRisk) => invoke(
+        'pluginManager', 'setVersionExemption', {
+          packageVersion, runtimeVersion, enabled,
+          ...(acceptRisk === undefined ? {} : { acceptRisk }),
+        },
+      ),
+    },
     permissionPresets: {
       catalog: (_payload = {}, signal) => invoke('permissionPresets', 'catalog', {}, signal),
     },

package/lib/index.mjs

@@ -68,6 +68,8 @@ import { stringifyWireFrame } from './wire-json.mjs'
 //                     { "type": "goal", "sessionId" }                -> current goal projection
 //                     { "type": "goal-edit", "sessionId", "ref", "objective"?, "maxGoalRounds"? }
 //                     { "type": "goal-pause"|"goal-resume"|"goal-clear", "sessionId", "ref" }
+//                     { "type": "plugin-catalog"|"plugin-inspect"|"plugin-install"|"plugin-settings"|..., "requestId", ... }
+//                        -> paired control connection; see PROTOCOL.md section 18
 //                     { "type": "agent-presets" }                     -> preset roster (+ isDefault)
 //                     { "type": "defaults" }                          -> default agent preset + default permission
 //                     { "type": "set-default", "target": "agent-preset"|"permission", "value" }
@@ -75,7 +77,7 @@ import { stringifyWireFrame } from './wire-json.mjs'
 //                     { "type": "question-cancel", "rpcId", "sessionId" }
 //                     { "type": "approval-response", "rpcId", "sessionId", "approvalId",
 //                       "outcome": "allowed-once"|"rejected" }
-//   server -> client: { "kind": "hello", "protocol": 3, "capabilities": ["images", "commands", "tasks", "goals", "session-cancel", "queue-control", "session-archive", "session-rename", "file-downloads"],
+//   server -> client: { "kind": "hello", "protocol": 3, "capabilities": ["images", "commands", "tasks", "goals", "plugin-management-v1", "session-cancel", "queue-control", "session-archive", "session-rename", "file-downloads"],
 //                       "authenticated", "device"?, "port", "clients" }
 //                     { "kind": "pong", "at" }
 //                     { "kind": "subscribed", "sessionId" }
@@ -130,6 +132,7 @@ import Schema from '@deepseek-ai/schemastery'
 import { WebSocketServer } from 'ws'
 import devicesModule from './devices.js'
 import { createDshHostAdapter, DSH_VERSION, SESSION_FORMAT_VERSION } from './dsh-host-adapter.mjs'
+import { handlePluginQuery, PLUGIN_REQUEST_TYPES } from './plugin-management.mjs'
 import { createSessionFollower } from './session-follower.mjs'
 import { createGatewayState, GATEWAY_MODES } from './gateway-state.mjs'
 import { createCloudflareTunnel } from './cloudflare-tunnel.mjs'
@@ -1335,7 +1338,8 @@ function parseAgentPreset(msg, requestType, required = false) {
 }
 
 // Dispatch one mobile query frame; returns the wire frame to send back.
-async function handleQuery(api, host, agentDefaultModel, msg) {
+async function handleQuery(api, host, agentDefaultModel, msg, pluginContext) {
+  if (PLUGIN_REQUEST_TYPES.has(msg.type)) return handlePluginQuery(api, msg, pluginContext)
   if (msg.type === 'session-agent-preset' || msg.type === 'select-agent-preset') {
     const session = requireSessionId(msg)
     const preset = parseAgentPreset(msg, msg.type, msg.type === 'select-agent-preset')
@@ -2196,6 +2200,7 @@ const plugin = {
       },
     })
     const clients = new Set()
+    const pluginInstallOwners = new Map()
     const pendingQuestions = new Map()
     const pendingApprovals = new Map()
     const fileTransfers = createFileTransferManager(api, options)
@@ -2722,6 +2727,9 @@ const plugin = {
             if (body.enabled && gatewayMode !== 'persistent') setGatewayMode('persistent', 'Cloudflare Tunnel enabled from management UI')
             await tunnel.reconcile()
             sendJson(res, 200, { ...tunnel.snapshot(), gatewayEnabled, gatewayMode })
+          } else if (req.method === 'POST' && p === '/mgw/cloudflare/restart') {
+            await tunnel.restart()
+            sendJson(res, 200, { ...tunnel.snapshot(), gatewayEnabled, gatewayMode })
           } else if (req.method === 'POST' && p === '/mgw/auth') {
             const body = await readBody(req)
             if (typeof body.enabled !== 'boolean') throw badRequest('enabled must be a boolean')
@@ -2944,8 +2952,23 @@ const plugin = {
                        msg.type === 'tasks' || msg.type === 'goal' || msg.type === 'goal-edit' ||
                        msg.type === 'goal-pause' || msg.type === 'goal-resume' || msg.type === 'goal-clear' ||
                        msg.type === 'schedule-catalog' || msg.type === 'schedule-list' || msg.type === 'schedule-history' ||
-                       msg.type === 'schedule-update' || msg.type === 'schedule-delete') {
-              handleQuery(api, host, agentDefaultModel, msg).then((frame) => {
+                       msg.type === 'schedule-update' || msg.type === 'schedule-delete' ||
+                       PLUGIN_REQUEST_TYPES.has(msg.type)) {
+              if (PLUGIN_REQUEST_TYPES.has(msg.type) && !ws.deviceId) {
+                sendFrame({ kind: 'error', code: 'authentication-required', requestType: msg.type,
+                  ...(typeof msg.requestId === 'string' ? { requestId: msg.requestId } : {}),
+                  message: 'Plugin management requires a paired device' })
+                return
+              }
+              if (msg.type === 'plugin-install' && pluginInstallOwners.has(msg.requestId)) {
+                sendFrame({ kind: 'error', code: 'plugin-install/in-progress', requestType: msg.type,
+                  requestId: msg.requestId, message: 'An installation already uses this requestId' })
+                return
+              }
+              handleQuery(api, host, agentDefaultModel, msg, {
+                onInstallStart: (requestId) => pluginInstallOwners.set(requestId, ws),
+                onInstallEnd: (requestId) => pluginInstallOwners.delete(requestId),
+              }).then((frame) => {
                 if (frame && ws.readyState === 1) ws.send(stringifyWireFrame(frame))
               })
             } else {
@@ -2991,6 +3014,7 @@ const plugin = {
               'tasks',
               'goals',
               'schedule-management',
+              'plugin-management-v1',
               'session-cancel',
               'queue-control',
               'session-archive',
@@ -3111,6 +3135,26 @@ const plugin = {
       if (clients.size > 0) broadcastSessionMetadataFrame({ kind: 'schedule-changed' })
     })
 
+    const disposePluginsChanged = ctx.on('plugin-manager/changed', (change) => {
+      if (clients.size > 0) broadcastSessionMetadataFrame({ kind: 'plugins-changed', reason: change?.reason })
+    })
+    const disposePluginSettingsChanged = ctx.on('settings/document-updated', (ns, revision) => {
+      if (clients.size > 0) broadcastSessionMetadataFrame({ kind: 'plugin-settings-changed', ns, revision })
+    })
+    const sendPluginInstallEvent = (kind, event) => {
+      const owner = pluginInstallOwners.get(event?.requestId)
+      if (owner?.readyState === 1) owner.send(stringifyWireFrame({ kind, ...event }))
+    }
+    const disposePluginInstallState = ctx.on('plugin-manager/install-state', (progress) => {
+      sendPluginInstallEvent('plugin-install-state', progress)
+    })
+    const disposePluginInstallLog = ctx.on('plugin-manager/install-log', (chunk) => {
+      if (!chunk?.requestId) return
+      const { requestId, jobId, stream, text, exitCode } = chunk
+      sendPluginInstallEvent('plugin-install-log', { requestId, jobId, stream, text,
+        ...(exitCode === undefined ? {} : { exitCode }) })
+    })
+
     const disposeQuestions = ctx.on('user-questions/request', (request, next) => {
       const sessionId = request?.agent?.id === undefined ? null : String(request.agent.id)
       if (!sessionId || !Array.isArray(request.questions) || !hasInteractionClient(sessionId)) return next()
@@ -3349,6 +3393,10 @@ const plugin = {
       disposeMgmt()
       disposeEvents()
       disposeScheduleChanged()
+      disposePluginsChanged()
+      disposePluginSettingsChanged()
+      disposePluginInstallState()
+      disposePluginInstallLog()
       disposeQuestions()
       disposeApprovals()
       if (lanServer) lanServer.close()
@@ -3358,6 +3406,7 @@ const plugin = {
         client.terminate()
       }
       clients.clear()
+      pluginInstallOwners.clear()
       wss.close()
       log('plugin stopped, all sockets closed')
     })

package/lib/plugin-management.mjs

@@ -0,0 +1,194 @@
+const OFFICIAL_CONFIGURATION_ITEMS = Object.freeze([
+  { id: 'shell', namespaces: ['bash-sandbox', 'pwsh-sandbox'] },
+  { id: 'agent-loop', namespaces: ['agent-loop'] },
+  { id: 'subagent', namespaces: ['subagent', 'subagent-model-selection-settings'] },
+  { id: 'web-search', namespaces: ['web-search-deepseek'] },
+])
+
+export const PLUGIN_REQUEST_TYPES = new Set([
+  'plugin-catalog',
+  'plugin-registries',
+  'plugin-inspect',
+  'plugin-install',
+  'plugin-install-status',
+  'plugin-install-cancel',
+  'plugin-bundle-set-enabled',
+  'plugin-entry-set-enabled',
+  'plugin-remove',
+  'plugin-settings',
+  'plugin-settings-mutate',
+  'plugin-version-exemptions',
+  'plugin-version-exemption-set',
+])
+
+const FLAT_RESPONSE_TYPES = new Set([
+  'plugin-catalog', 'plugin-registries', 'plugin-settings',
+  'plugin-settings-mutate', 'plugin-version-exemptions',
+])
+
+function record(value) {
+  return value !== null && typeof value === 'object' && !Array.isArray(value)
+}
+
+function nonempty(value, maxLength = 2048) {
+  return typeof value === 'string' && value.trim().length > 0 && value.length <= maxLength
+}
+
+function badRequest(type, requestId, message) {
+  return { kind: 'error', code: 'bad-request', message, requestType: type,
+    ...(requestId === undefined ? {} : { requestId }) }
+}
+
+function registryOption(msg, type, requestId) {
+  if (msg.registry === undefined) return { value: undefined }
+  if (msg.registry === null || (nonempty(msg.registry) && /^https?:\/\//i.test(msg.registry))) {
+    return { value: msg.registry }
+  }
+  return { error: badRequest(type, requestId, 'registry must be null or an HTTP(S) URL') }
+}
+
+function requireName(msg, field, type, requestId) {
+  if (!nonempty(msg[field], 512)) return { error: badRequest(type, requestId, `${field} must be a non-empty string`) }
+  return { value: msg[field].trim() }
+}
+
+async function pluginCatalog(api) {
+  const inventory = await api.plugins.inventory()
+  if (!record(inventory) || !Array.isArray(inventory.entries)) throw new Error('pluginInventory/list returned an invalid inventory')
+  if (inventory.managementAvailable !== true) {
+    return { managementAvailable: false, bundles: [], plugins: [], officialItems: [], settingsWritable: false }
+  }
+  const [bundles, plugins, settings] = await Promise.all([
+    api.plugins.listBundles(),
+    api.plugins.listPlugins(),
+    api.settings.describe(),
+  ])
+  if (!Array.isArray(bundles) || !Array.isArray(plugins) || !Array.isArray(settings?.namespaces)) {
+    throw new Error('plugin manager returned an invalid catalog')
+  }
+  const available = new Set(settings.namespaces.map(item => item.ns))
+  const officialItems = OFFICIAL_CONFIGURATION_ITEMS
+    .filter(item => item.namespaces.some(ns => available.has(ns)))
+    .map(item => ({ id: item.id, namespaces: item.namespaces.filter(ns => available.has(ns)) }))
+  return {
+    managementAvailable: true,
+    bundles: bundles.map(bundle => ({
+      ...bundle,
+      experimental: bundle.name.startsWith('@deepseek-ai/dsh-experimental-'),
+    })),
+    plugins,
+    officialItems,
+    settingsWritable: settings.writable === true,
+  }
+}
+
+/**
+ * The mobile wire owns its request names and correlation ids. The Host adapter
+ * owns Typert endpoint names and argument descriptors.
+ */
+export async function handlePluginQuery(api, msg, { onInstallStart, onInstallEnd } = {}) {
+  const type = msg?.type
+  if (!PLUGIN_REQUEST_TYPES.has(type)) return null
+  const requestId = nonempty(msg.requestId, 128) ? msg.requestId.trim() : undefined
+  if (!requestId) return badRequest(type, undefined, `${type} requires a requestId`)
+
+  try {
+    let value
+    let kind = type
+    if (type === 'plugin-catalog') {
+      value = await pluginCatalog(api)
+    } else if (type === 'plugin-registries') {
+      value = await api.plugins.registries()
+    } else if (type === 'plugin-inspect' || type === 'plugin-install') {
+      const spec = requireName(msg, 'spec', type, requestId)
+      if (spec.error) return spec.error
+      const registry = registryOption(msg, type, requestId)
+      if (registry.error) return registry.error
+      if (type === 'plugin-inspect') {
+        value = await api.plugins.inspect(spec.value, registry.value === undefined ? undefined : { registry: registry.value })
+        kind = 'plugin-inspection'
+      } else {
+        if (msg.enabled !== undefined && typeof msg.enabled !== 'boolean') {
+          return badRequest(type, requestId, 'enabled must be a boolean')
+        }
+        if (msg.approvedBuilds !== undefined && (!Array.isArray(msg.approvedBuilds)
+          || msg.approvedBuilds.length > 100 || msg.approvedBuilds.some(name => !nonempty(name, 512)))) {
+          return badRequest(type, requestId, 'approvedBuilds must be an array of package names')
+        }
+        const options = {
+          requestId,
+          ...(msg.enabled === undefined ? {} : { enabled: msg.enabled }),
+          ...(registry.value === undefined ? {} : { registry: registry.value }),
+          ...(msg.approvedBuilds === undefined ? {} : { approvedBuilds: msg.approvedBuilds }),
+        }
+        onInstallStart?.(requestId)
+        try {
+          value = await api.plugins.installBundle(spec.value, options)
+        } finally {
+          onInstallEnd?.(requestId)
+        }
+        kind = 'plugin-install-result'
+      }
+    } else if (type === 'plugin-install-status' || type === 'plugin-install-cancel') {
+      const installId = requireName(msg, 'installId', type, requestId)
+      if (installId.error) return installId.error
+      value = type === 'plugin-install-status'
+        ? await api.plugins.waitForInstall(installId.value)
+        : await api.plugins.cancelInstall(installId.value)
+    } else if (type === 'plugin-bundle-set-enabled' || type === 'plugin-entry-set-enabled') {
+      const field = type === 'plugin-bundle-set-enabled' ? 'name' : 'entryId'
+      const target = requireName(msg, field, type, requestId)
+      if (target.error) return target.error
+      if (typeof msg.enabled !== 'boolean') return badRequest(type, requestId, 'enabled must be a boolean')
+      value = type === 'plugin-bundle-set-enabled'
+        ? await api.plugins.setBundleEnabled(target.value, msg.enabled)
+        : await api.plugins.setPluginEnabled(target.value, msg.enabled)
+    } else if (type === 'plugin-remove') {
+      const name = requireName(msg, 'name', type, requestId)
+      if (name.error) return name.error
+      value = await api.plugins.removeBundle(name.value)
+    } else if (type === 'plugin-settings') {
+      const described = await api.settings.describe()
+      if (!record(described) || !Array.isArray(described.namespaces)) throw new Error('settings/describe returned an invalid response')
+      if (msg.ns !== undefined) {
+        const ns = requireName(msg, 'ns', type, requestId)
+        if (ns.error) return ns.error
+        const namespace = described.namespaces.find(item => item.ns === ns.value)
+        if (!namespace) return { kind: 'error', code: 'plugin-settings/not-found',
+          message: `settings namespace is unavailable: ${ns.value}`, requestType: type, requestId }
+        value = { writable: described.writable === true, namespace }
+      } else {
+        value = described
+      }
+    } else if (type === 'plugin-settings-mutate') {
+      const ns = requireName(msg, 'ns', type, requestId)
+      if (ns.error) return ns.error
+      if (!Number.isSafeInteger(msg.expectedRevision) || msg.expectedRevision < 0) {
+        return badRequest(type, requestId, 'expectedRevision must be a non-negative integer')
+      }
+      if (!Array.isArray(msg.ops) || msg.ops.length < 1 || msg.ops.length > 100
+        || msg.ops.some(op => !record(op) || !['set', 'unset'].includes(op.op)
+          || !Array.isArray(op.path) || op.path.some(part => !nonempty(part, 256))
+          || (op.op === 'set' && !Object.hasOwn(op, 'value')))) {
+        return badRequest(type, requestId, 'ops must contain valid set or unset path edits')
+      }
+      value = await api.settings.mutate({ ns: ns.value, ops: msg.ops, expectedRevision: msg.expectedRevision })
+    } else if (type === 'plugin-version-exemptions') {
+      value = await api.plugins.listVersionExemptions()
+    } else if (type === 'plugin-version-exemption-set') {
+      const packageVersion = requireName(msg, 'packageVersion', type, requestId)
+      const runtimeVersion = requireName(msg, 'runtimeVersion', type, requestId)
+      if (packageVersion.error || runtimeVersion.error) return packageVersion.error || runtimeVersion.error
+      if (typeof msg.enabled !== 'boolean' || (msg.acceptRisk !== undefined && typeof msg.acceptRisk !== 'boolean')) {
+        return badRequest(type, requestId, 'enabled and acceptRisk must be booleans')
+      }
+      value = await api.plugins.setVersionExemption(packageVersion.value, runtimeVersion.value,
+        msg.enabled, msg.acceptRisk)
+    }
+    return { kind, requestId, ...(FLAT_RESPONSE_TYPES.has(type) && record(value)
+      ? value : { result: value }) }
+  } catch (error) {
+    return { kind: 'error', code: error?.code || 'internal',
+      message: error?.message || String(error), requestType: type, requestId }
+  }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-plugin-mobile-gateway",
-  "version": "0.8.1",
-  "description": "Authenticated mobile gateway for DeepSeek Harness with LAN and Cloudflare Tunnel access, device pairing, and session sync",
+  "version": "0.9.0",
+  "description": "Authenticated mobile gateway for DeepSeek Harness with realtime session sync, device pairing, plugin management, and LAN or Cloudflare Tunnel access",
   "main": "lib/index.mjs",
   "files": [
     "bin",
@@ -26,7 +26,7 @@
   },
   "bin": "bin/setup-ip.mjs",
   "scripts": {
-    "test": "node test/wire-json.test.mjs && node test/setup-ip.test.mjs && node test/host-adapter.test.mjs && node test/session-preset.test.mjs && node test/session-follower.test.mjs && node test/gateway.test.mjs && node test/auth.test.mjs && node test/lan.test.mjs && node test/cloudflared-binary.test.mjs && node test/cloudflare-tunnel.test.mjs && node test/gateway-tools.test.mjs && node test/multi-gateway.test.mjs"
+    "test": "node test/wire-json.test.mjs && node test/setup-ip.test.mjs && node test/host-adapter.test.mjs && node test/plugin-management.test.mjs && node test/session-preset.test.mjs && node test/session-follower.test.mjs && node test/gateway.test.mjs && node test/auth.test.mjs && node test/lan.test.mjs && node test/cloudflared-binary.test.mjs && node test/cloudflare-tunnel.test.mjs && node test/gateway-tools.test.mjs && node test/multi-gateway.test.mjs"
   },
   "exports": {
     ".": "./lib/index.mjs",