jbc-dssi 0.0.0-stage → 1.0.0

package/cordis.patch.yml

@@ -0,0 +1,69 @@
+# jbc-dssi —— 手机桥接插件（鲸编程）
+#
+# 默认 disabled：装进来但完全不激活，对现有 dsh web 零影响。
+# 要用的时候由 profile 层的 patch 把它打开并填入配对信息。
+#
+# 两条通路（profile 里二选一）：
+#
+#   ① 中继模式（鲸编程的推荐形态）
+#      插件**主动往外连**中继，手机也连中继。
+#      用户不需要公网 IP、不需要端口映射、不需要 IPv6。
+#      配置见 config.relay 那一段。
+#
+#   ② 直连模式（鲸编程的形态，保留作本机调试兜底）
+#      插件监听端口等手机连进来。
+#      配置见 config.host/port/token。
+#
+# 两种模式跑的是同一份业务代码（会话 attach / 帧分发 / 审批瀑布 / 文件上传），
+# 差别只在"管道另一头是谁"。
+- insert:
+    - id: jbc-dssi
+      name: 'jbc-dssi'
+      disabled: true
+      config:
+        # ---- 通路开关 ----
+        # 填了 relay 就**只走中继**，host/port 不再生效（避免两条路同时开、
+        # 出现一个会话被两处 attach 的怪状态）。
+        relay:
+          enabled: true
+          # 中继地址。末尾必须是 /ws/desktop（插件侧），手机侧是 /ws/mobile。
+          url: 'wss://jbc.dssi.top/ws/desktop'
+          # 下面三项**可以留空**：留空时插件会自己生成一份、注册到中继、
+          # 落盘到 ~/.dsh/jbc-dssi/pairing.json，并在终端打出二维码。
+          # 也可以在 DSH 里跑 `node cli/pair.mjs` 手动生成后填在这里
+          # （填了就以此为准，插件不会覆盖你填的）。
+          # 手编错了的表现是"连上了但什么都收不到"，很难查 —— 优先留空自动生成。
+          pairId: ''
+          deviceToken: ''
+          # 端到端加密的根密钥（32 字节 hex）。
+          # ★ 它**从不发给中继** —— 只存在于二维码、手机内存、和这台电脑上。
+          preset: ''
+          # 配对码怎么交给用户（无需配置，这里只说明行为）：
+          #   插件每次启动都会在 ~/.dsh/jbc-dssi/pairing-qr.png 生成二维码，
+          #   并**自动弹出一个配对网页** —— 手机对着屏幕扫即可。
+          #   终端里**不再**画 ASCII 二维码：实测两轮都扫不出，因为终端字符的
+          #   宽高比随字体而变（并非标准 1:2），码被拉成长方形，手机识别不出来。
+          #   扫不出来时，终端里那行手工码是兜底（App 里「手工输入配对码」粘贴）。
+          #
+          # DSH Web 界面的端口（默认 3080）。
+          # 用途只有一个：**等 DSH 自己的工作页面先弹出来**，我们再弹配对页。
+          # 反过来的话（实测如此）配对页先弹、DSH 界面后弹并把它盖住，
+          # 用户看不见二维码，以为没出。dsh web 如果用了 --port 改端口，
+          # 这里要跟着填，否则等不到就超时兜底（配对页照样打开，只是顺序不保证）。
+          dshWebPort: 3080
+
+        # ---- 直连模式（relay.enabled 为 false 时才用）----
+        host: '::'
+        port: 18443
+        token: ''
+
+        # 是否转发 process-local 的 assistant 流式增量帧。
+        # 关掉就只剩持久事件（会丢掉逐字流式感），默认开。
+        assistantStream: true
+
+        # 打开快照只取最近这么多条消息。
+        # 不加限制的话，老会话的快照可能有几 MB —— 在 4G 上就是几秒白等。
+        snapshotMessages: 80
+
+        # 审批链路自测开关。默认关；验证审批时临时打开。
+        allowSelfTest: false