@dshfly/remote-connector 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DSH Fly 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,44 @@
+# @dshfly/remote-connector
+
+DeepSeek Harness (DSH) 的 **cordis 插件**。它让手机 App(DSH Fly)能随时随地**创建并监督**跑在你 PC 上的 DSH 开发任务:
+
+- **出站反向连接**:PC 主动拨出到云端中继(绕开家庭 NAT/CGNAT)。
+- **端到端加密 (E2EE) 终点**:解手机密文 → 明文走 loopback 转 `dsh web`;把下行事件加密回手机。
+- **/dshfly 控制路由**(loopback-only):配对 QR、设备管理、二次确认。
+- **移动端插件承载**:随包内置 `ctx.mobileBridge` 服务(移动端插件规范实现)。
+
+数据面:手机 App ──E2EE──▶ 云端中继(只见密文)──E2EE──▶ 本插件──loopback──▶ `dsh web (127.0.0.1:3080)`。
+
+## 安装
+
+```bash
+# 零配置:relayUrl 内建默认 https://relay.dshfly.com + 账号自动生成
+dsh plugin --profile web add @dshfly/remote-connector
+dsh web   # 重启生效
+```
+
+配对:打开 dsh web 设置页 → **DSH Fly** → 「新建配对」→ 手机扫码 → PC 端二次确认 → 完成。手机端随即可用(工作区/会话/审批/文件浏览……)。
+
+## 要求
+
+- DSH `>= 0.1.0-rc.6`,且 `dsh web` 绑定 **loopback**(`127.0.0.1`)——配对控制路由含一次性密钥,必须 loopback-only,插件会强制校验。
+- Node `>= 22`。
+
+## 安全
+
+- **E2EE**:云端中继只路由密文,读不到会话/代码 diff;加密终点是手机与本插件。`dsh web` 恒绑 loopback,不暴露公网。
+- 设备身份密钥存 `<dshHome>/dshfly/keys.json`(0600);配对一次性码 + 公钥指纹 + 二次确认。
+- 插件是 fail-loud 宿主:配置缺失等可恢复情况会 `warn + 跳过启动`,绝不拖垮 dsh web。
+
+## 配置(可选)
+
+| 键 | 默认 | 说明 |
+|---|---|---|
+| `relayUrl` | `https://relay.dshfly.com` | 自建中继时覆盖 |
+| `deviceName` | 主机名 | 显示在手机端 |
+| `target` | `http://127.0.0.1:3080` | dsh web loopback 地址 |
+| `autoConfirm` | `false` | 测试用:跳过二次确认(生产必须 false) |
+
+## License
+
+[MIT](LICENSE)

package/config.js

@@ -0,0 +1,69 @@
+// packages/remote-connector/config.js
+// 插件配置：schemastery schema（cordis loader 用它校验/规范化 apply 的 config，
+// 以及 M3 设置页配置表单渲染）+ 默认值 + 业务校验。
+//
+// 注意（orbis 同款）：DSH profile 的 schemastery 实现没有 .optional()，
+// 字段默认可省略；required 语义留在 validateConfig（apply 里 warn+跳过，不抛错——
+// 保证未配置时 dsh web 仍能正常启动）。
+
+import z from '@deepseek-ai/schemastery';
+
+export const CONFIG_DEFAULTS = {
+  // 零配置默认值：relayUrl 内建（单机自用场景）；D1 无账号层——无 loginName。
+  relayUrl: 'https://relay.dshfly.com', // 云中继地址（可覆盖）
+  deviceName: '',      // 设备名，默认 os.hostname()
+  keysPath: '',        // 密钥文件路径，默认 <dshHome>/dshfly/keys.json（决策：不迁移旧 ~/.dshfly）
+  target: '',          // DSH 上游，默认 http://127.0.0.1:3080（自环反代）
+  autoConfirm: false,  // 测试 profile 用：配对轮询到 completed 时自动确认（生产必须 false）
+  profileDir: '',      // 移动端插件 profile 目录（M4.x-c 整合：bridge 由本插件承载）；空 = <dshHome>/profiles/web
+  profileName: 'web',  // 同上：profile 名（真实安装即 ~/.dsh/profiles/web）
+  dshBin: '',          // dsh CLI 路径（空 = 用 PATH 的 'dsh'）；一键安装插件用
+  recommendedPlugins: [ // 设置页"推荐插件"清单（白名单：一键安装只接受这里的 name）
+    {
+      name: '@dshfly/plugin-notifications', // 包名（loader.create 用）
+      spec: '@dshfly/plugin-notifications', // `dsh plugin add <spec>` 的参数（npm 名；开发期可配 file:<绝对路径>）
+      id: 'notifications',
+      title: '消息中心',
+      description: 'PC 端会话动态与待办',
+      icon: 'feather:bell',
+    },
+  ],
+};
+
+/** cordis loader 用的 schemastery schema（~standard.validate 由 cordis resolveConfig 调用）。 */
+export const Config = z.object({
+  relayUrl: z.string(),
+  deviceName: z.string(),
+  keysPath: z.string(),
+  target: z.string(),
+  autoConfirm: z.boolean(),
+  profileDir: z.string(),
+  profileName: z.string(),
+  dshBin: z.string(),
+  recommendedPlugins: z.array(z.object({
+    name: z.string(),
+    spec: z.string(),
+    id: z.string(),
+    title: z.string(),
+    description: z.string(),
+    icon: z.string(),
+  })),
+});
+
+export function resolveConfig(config = {}) {
+  const merged = { ...CONFIG_DEFAULTS, ...(config || {}) };
+  // schemastery 的 ~standard.validate 会把缺失的数组字段规范化为 []（非 undefined），
+  // 从而覆盖 CONFIG_DEFAULTS 的默认清单 → 空数组回退默认（2026-08 实测发现）。
+  if (!Array.isArray(merged.recommendedPlugins) || merged.recommendedPlugins.length === 0) {
+    merged.recommendedPlugins = CONFIG_DEFAULTS.recommendedPlugins;
+  }
+  return merged;
+}
+
+export function validateConfig(config) {
+  // relayUrl 有内建默认；仅当显式传了空串（覆盖默认）时告警。
+  // （core 用自动生成的设备账号兜底）。
+  const errors = [];
+  if (!config.relayUrl) errors.push('relayUrl 为空（云中继地址）');
+  return errors;
+}

package/cordis.patch.yml

@@ -0,0 +1,6 @@
+# cordis loader patch：把 dshfly-remote-connector 插件插入 DSH profile 的插件列表。
+# 对齐 orbis（@orbisapp/remote-dsh/cordis.patch.yml）格式。M2.5 无前端注入，
+# 不替换任何 DSH 内置插件（与 orbis 的 directory-picker 替换不同）。
+- insert:
+    - id: dshfly-remote-connector
+      name: "@dshfly/remote-connector"

package/core/cloud.js

@@ -0,0 +1,55 @@
+// packages/remote-connector/core/cloud.js
+// connector 调云端控制面的 HTTP 客户端。自 services/connector/cloud.js 迁入（单一代码源）。
+// D1 方案 B（无账号层）：PC 登记纯公钥（无 token）；device token 经 device-login 或登记响应获取。
+
+export function createCloud(baseUrl) {
+  const base = baseUrl.replace(/\/$/, '');
+  async function call(method, path, { token, body } = {}) {
+    const res = await fetch(`${base}${path}`, {
+      method,
+      headers: {
+        'content-type': 'application/json',
+        ...(token ? { authorization: `Bearer ${token}` } : {}),
+      },
+      body: body ? JSON.stringify(body) : undefined,
+    });
+    const data = await res.json().catch(() => null);
+    if (!res.ok) throw new Error(`${method} ${path} -> ${res.status}: ${JSON.stringify(data)}`);
+    return data;
+  }
+  return {
+    /** D1：设备凭证（身份私钥签名换取 token；PC 未登记前登记响应已含 deviceToken，本方法供手机/换 token 用）。 */
+    deviceLogin(publicKey, ts, nonce, sig) {
+      return call('POST', '/api/v1/auth/device-login', { body: { publicKey, ts: String(ts), nonce, sig } });
+    },
+    /** D1：纯公钥登记（无鉴权，信任根 = 配对流程）。 */
+    registerDevice({ name, pk_identity, pk_transport }) {
+      return call('POST', '/api/v1/devices', { body: { name, pk_identity, pk_transport } });
+    },
+    createPairing(deviceToken) {
+      return call('POST', '/api/v1/pairings', { token: deviceToken });
+    },
+    /** B3/D2：用当前 deviceToken 换新 token（短 TTL 在线续期）。 */
+    rotateDeviceToken(deviceToken, deviceId) {
+      return call('POST', `/api/v1/devices/${deviceId}/rotate`, { token: deviceToken });
+    },
+    /** D1：getPairing 无鉴权（pairingId 一次性码即授权闸门；配对公钥非秘密）。 */
+    getPairing(id) {
+      return call('GET', `/api/v1/pairings/${id}`);
+    },
+    /** D1：complete 无 token（纯身份签名）。 */
+    completePairing(id, body) {
+      return call('POST', `/api/v1/pairings/${id}/complete`, { body });
+    },
+    confirmPairing(deviceToken, id, body) {
+      return call('POST', `/api/v1/pairings/${id}/confirm`, { token: deviceToken, body: body ?? {} });
+    },
+    rejectPairing(deviceToken, id, body) {
+      return call('POST', `/api/v1/pairings/${id}/reject`, { token: deviceToken, body: body ?? {} });
+    },
+    /** 推送：connector 触发 relay /push/notify（fire-and-forget，调用方吞错）。 */
+    notifyPush(deviceToken, body) {
+      return call('POST', '/api/v1/push/notify', { token: deviceToken, body });
+    },
+  };
+}