dsh-plugin-tether 0.1.2 → 0.1.4

package/CHANGELOG.md

@@ -0,0 +1,53 @@
+# 更新日志
+
+本文件记录面向用户的变化。每个版本的这一节会原样作为该版本 Release 的说明。
+
+## 0.1.4
+
+### 兼容性
+
+- **确认支持 dsh `0.1.0-rc.8`**。已在 rc.8 环境下逐项核对本插件依赖的上游接触面:patch 引用的三个包名仍存在且 patch 实际生效(`--dump-config` 可见 `directory-picker` 已停用、两个 browse 条目已挂上);窄屏样式依赖的布局 class 未变;`sidebar.footer.action` 与 `settings.trigger` 两个插槽仍在;插件的三条 HTTP 路由均正常且跨站请求仍被拒。
+- `peerDependencies` 由精确的 `0.1.0-rc.7` 放宽为 `>=0.1.0-rc.7`。此前的精确版本号会让 rc.8 用户在安装时收到 unmet peer 警告,而两个版本实测都可用。
+
+## 0.1.3
+
+### 新增
+
+- **电脑端可以查看并移除已配对的手机**。侧栏「连接手机」弹出的配对串下方新增列表,显示每台手机的名字、ID 前 8 位与在线状态,可逐台移除。
+  此前白名单只增不减,而手机每重装一次 App 就会生成一把新的身份密钥,旧的那把仍留在白名单里持有访问权,电脑端却没有任何入口能看见或撤销它们——只能手工编辑 `paired.json`。
+  移除会同时断开该手机当前的连接:白名单只在握手时读取一次,若不主动断开,正连着的那台要等它自己下线才真正失效。
+- 手机端「我的电脑」页脚的项目主页链接现在可用,由系统浏览器打开。此前该链接为空,不显示。
+
+### 文档
+
+- 补上 LINUX DO 社区链接与徽章。
+- 32 位 APK 的实际文件名是 `arm` 而非 `armv7`,文档按实际产出更正。
+- 移除配对章节中包含真实配对串的截图。
+
+## 0.1.2
+
+### 新增
+
+- **APK 改为四个 CPU 架构全量构建**:`arm64`、`arm`、`x86`、`x86_64`。此前只构建 `aarch64`,而产物却被命名为 `universal`——那是「不按 ABI 拆分」这个构建变体的名字,不代表包含所有架构;解包可见其中只有 `arm64-v8a`。
+- APK 文件名改为 `dsh-tether-<版本>-<架构>.apk`,此前是不含版本号的 `app-universal-release.apk`。
+
+### 移除
+
+- 删除 `dsh-tunnel`——插件化之前的独立隧道原型,其能力已由 `tether-host --proxy-target` 覆盖。
+
+## 0.1.1
+
+### 新增
+
+- **新增 `linux-arm64` 平台子包**。主包的 `optionalDependencies` 本已声明五个平台,构建矩阵却只产出四个;缺失的那个按 npm 的可选依赖语义被静默跳过,安装期毫无提示,直到运行时才会发现找不到二进制。
+- 打 tag 时自动发布到 npm,先发平台子包再发主包。
+
+## 0.1.0
+
+首个发布版本。
+
+- DeepSeek Harness 插件 + Android App,通过 iroh P2P 直连,中间不经过任何服务器。
+- 手机上显示的是 DSH 自身的完整 Web 界面,窄屏下注入最小样式适配(侧栏改抽屉、设置页导航横排)。
+- 6 位配对码,10 分钟有效,每窗口 3 次尝试上限;配对后凭手机的 iroh 公钥授权。
+- 手机端可保存多台电脑并切换;agent 等待审批时推送系统通知。
+- 平台子包覆盖 win32-x64、darwin-x64、darwin-arm64、linux-x64。

package/README.md

@@ -17,7 +17,7 @@
   <a href="../../releases"><img src="https://img.shields.io/github/downloads/zexadev/dsh-tether/total?style=flat&label=downloads&color=4D6BFE" alt="Downloads"></a>
   <a href="../../stargazers"><img src="https://img.shields.io/github/stars/zexadev/dsh-tether?style=flat&label=%E2%98%85&color=08C" alt="Stars"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-2EA44F?style=flat" alt="MIT"></a>
-  <img src="https://img.shields.io/badge/dsh-0.1.0--rc.7-4D6BFE?style=flat" alt="dsh 0.1.0-rc.7">
+  <img src="https://img.shields.io/badge/dsh-0.1.0--rc.7%20%7C%20rc.8-4D6BFE?style=flat" alt="dsh 0.1.0-rc.7 | rc.8">
   <img src="https://img.shields.io/badge/Android-4493F8?style=flat" alt="Android">
 </p>
 
@@ -46,7 +46,7 @@ If you only use your phone on the same Wi-Fi as your machine, you don't need any
 
 The plugin carries a small Rust sidecar that owns the iroh connection, shipped as one package per platform; installing pulls only the one matching your system, with nothing to choose.
 
-The phone build is split by CPU architecture. **Any Android phone from the last decade takes `arm64`**; `armv7` is for 32-bit legacy devices, and `x86` / `x86_64` are for emulators and ChromeOS. Picking the wrong one simply gets refused at install time.
+The phone build is split by CPU architecture. **Any Android phone from the last decade takes `arm64`**; `arm` is for 32-bit legacy devices, and `x86` / `x86_64` are for emulators and ChromeOS. Picking the wrong one simply gets refused at install time.
 
 You can also build the sidecar from source (needs Rust):
 
@@ -60,8 +60,6 @@ dsh plugin --profile web add .
 
 Start `dsh web` as you normally would, then click **Connect phone** at the bottom of the sidebar. You get one line to copy:
 
-<p align="center"><img src="assets/pc-pairing.png" width="620" alt="The pairing string, shown on the computer"></p>
-
 On the phone, open DSH Tether → **Add computer** → paste that whole line → name the computer → connect.
 
 From then on the app connects by itself when you open it.
@@ -104,7 +102,7 @@ From then on the app connects by itself when you open it.
 - Android only. iOS is not planned for now.
 - The app connects when you open it and holds no background connection — Android's doze would not let it anyway.
 - The interface on the phone is DSH's own; the narrow-screen fit comes from minimal injected styles, so a dsh layout change may need a follow-up here.
-- Verified against dsh **`0.1.0-rc.7`**. dsh is in developer preview — check this line before assuming a newer dsh works.
+- Verified against dsh **`0.1.0-rc.7`** and **`0.1.0-rc.8`**. dsh is in developer preview — check this line before assuming a newer dsh works.
 
 ## What has been verified
 
@@ -139,3 +137,11 @@ pnpm exec tauri android build --apk --target aarch64
 ## License
 
 MIT
+
+## Links
+
+- [LINUX DO](https://linux.do) — where this project is shared
+
+<p align="center">
+  <a href="https://linux.do/"><img src="https://img.shields.io/badge/%E7%A4%BE%E5%8C%BA-LINUX%20DO-4D6BFE?style=for-the-badge" alt="LINUX DO"></a>
+</p>

package/README.zh.md

@@ -17,7 +17,7 @@
   <a href="../../releases"><img src="https://img.shields.io/github/downloads/zexadev/dsh-tether/total?style=flat&label=downloads&color=4D6BFE" alt="下载量"></a>
   <a href="../../stargazers"><img src="https://img.shields.io/github/stars/zexadev/dsh-tether?style=flat&label=%E2%98%85&color=08C" alt="Stars"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-2EA44F?style=flat" alt="MIT"></a>
-  <img src="https://img.shields.io/badge/dsh-0.1.0--rc.7-4D6BFE?style=flat" alt="dsh 0.1.0-rc.7">
+  <img src="https://img.shields.io/badge/dsh-0.1.0--rc.7%20%7C%20rc.8-4D6BFE?style=flat" alt="dsh 0.1.0-rc.7 | rc.8">
   <img src="https://img.shields.io/badge/Android-4493F8?style=flat" alt="Android">
 </p>
 
@@ -46,7 +46,7 @@ DSH Tether 把 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harnes
 
 插件带一个 Rust 写的 sidecar 负责 iroh 连接,按平台拆成独立子包;安装时只会下载与你系统匹配的那一个,不用手动选。
 
-手机端按 CPU 架构分了四个包,**近十年的安卓手机都选 `arm64`**;`armv7` 给 32 位老设备,`x86` / `x86_64` 给模拟器和 ChromeOS。装错了系统会直接拒绝安装,不会装出问题。
+手机端按 CPU 架构分了四个包,**近十年的安卓手机都选 `arm64`**;`arm` 给 32 位老设备,`x86` / `x86_64` 给模拟器和 ChromeOS。装错了系统会直接拒绝安装,不会装出问题。
 
 也可以从源码构建 sidecar(需要 Rust):
 
@@ -60,8 +60,6 @@ dsh plugin --profile web add .
 
 电脑上照常启动 `dsh web`,在侧栏底部点**「连接手机」**,会给出一行配对串:
 
-<p align="center"><img src="assets/pc-pairing.png" width="620" alt="电脑上出示配对串"></p>
-
 手机上打开 DSH Tether →「添加电脑」→ 把那一整行粘进去 → 给这台电脑起个名字 → 连接。
 
 之后每次打开 App 自动连上,不用再配对。
@@ -104,7 +102,7 @@ dsh plugin --profile web add .
 - 只有 Android。iOS 暂不做。
 - App 打开时才连接,不在后台常驻——Android 的 doze 也留不住它。
 - 手机上的界面是 DSH 自己的,窄屏适配靠注入的最小样式完成;dsh 改版式时可能需要跟进。
-- 已针对 dsh **`0.1.0-rc.7`** 验证。dsh 处于 developer preview,换更新的 dsh 之前先看这一行。
+- 已针对 dsh **`0.1.0-rc.7`** 与 **`0.1.0-rc.8`** 验证。dsh 处于 developer preview,换更新的 dsh 之前先看这一行。
 
 ## 验证过什么
 
@@ -146,3 +144,11 @@ pnpm exec tauri android build --apk --target aarch64
 ## 许可证
 
 MIT
+
+## 友情链接
+
+- [LINUX DO](https://linux.do) —— 本项目在该社区分享
+
+<p align="center">
+  <a href="https://linux.do/"><img src="https://img.shields.io/badge/%E7%A4%BE%E5%8C%BA-LINUX%20DO-4D6BFE?style=for-the-badge" alt="LINUX DO"></a>
+</p>

package/index.js

@@ -21,6 +21,7 @@ const inject = ['webServer', 'settings']
 const CONFIG_DOCUMENT_PATH = '/dsh-tether/config-document'
 /** 按需开一个配对窗口,拿回配对串 */
 const PAIRING_PATH = '/dsh-tether/pairing'
+const DEVICES_PATH = '/dsh-tether/devices'
 
 /** dsh 的回环判定:localhost、IPv6 回环、以及整个 127/8 */
 function isLoopbackHostname(hostname) {
@@ -62,6 +63,24 @@ function isTrustedRequest(req) {
 }
 
 /** 未通过栅栏时统一的拒绝应答,和 dsh 的 /api 一样是裸 403,不泄露路由细节 */
+/** 读 POST body 里的 {"id": "..."};格式不对一律当作没给 */
+async function readForgetId(req) {
+  const chunks = []
+  let size = 0
+  for await (const chunk of req) {
+    size += chunk.length
+    // 请求体只可能是一个 64 位十六进制 id,超过这个量级就是异常输入
+    if (size > 4096) return undefined
+    chunks.push(chunk)
+  }
+  try {
+    const id = JSON.parse(Buffer.concat(chunks).toString('utf8')).id
+    return typeof id === 'string' && id !== '' ? id : undefined
+  } catch {
+    return undefined
+  }
+}
+
 function refuse(res) {
   res.writeHead(403, { 'content-type': 'text/plain; charset=utf-8' })
   res.end('forbidden')
@@ -97,6 +116,8 @@ function apply(ctx, config = {}) {
   let endpointId = ''
   /** 等着拿配对串的那个请求;sidecar 回 pairing 时兑现 */
   let pendingPairing
+  /** 等着拿设备列表的那些请求;sidecar 回 devices 时一并兑现 */
+  let pendingDevices = []
 
   createInterface({ input: child.stdout }).on('line', (line) => {
     let msg
@@ -138,6 +159,12 @@ function apply(ctx, config = {}) {
       case 'peer-disconnected':
         console.log('[tether] 手机已断开')
         break
+      case 'devices': {
+        const waiters = pendingDevices
+        pendingDevices = []
+        for (const w of waiters) w(msg.devices)
+        break
+      }
       default:
         console.error(`[tether] 未知 sidecar 消息: ${line}`)
     }
@@ -201,6 +228,43 @@ function apply(ctx, config = {}) {
     },
   }))
 
+  // 白名单只增不减是个安全问题:手机每重装一次 App 就换一把身份密钥,旧的那把
+  // 仍留在白名单里持有访问权,而电脑端此前没有任何入口能看见或撤销它们。
+  ctx.effect(() => ctx.webServer.register({
+    kind: 'exact',
+    path: DEVICES_PATH,
+    handler: async (req, res) => {
+      if (!isTrustedRequest(req)) return refuse(res)
+      if (req.method === 'POST') {
+        const id = await readForgetId(req)
+        if (id === undefined) {
+          res.writeHead(400, { 'content-type': 'text/plain; charset=utf-8' })
+          res.end('缺少要移除的设备 id')
+          return
+        }
+        send({ type: 'device-forget', id })
+      } else {
+        send({ type: 'device-list' })
+      }
+      const devices = await new Promise((resolve) => {
+        pendingDevices.push(resolve)
+        setTimeout(() => {
+          const at = pendingDevices.indexOf(resolve)
+          if (at === -1) return
+          pendingDevices.splice(at, 1)
+          resolve(undefined)
+        }, 5000)
+      })
+      if (devices === undefined) {
+        res.writeHead(504, { 'content-type': 'text/plain; charset=utf-8' })
+        res.end('sidecar 没有在 5 秒内返回设备列表')
+        return
+      }
+      res.writeHead(200, { 'content-type': 'application/json; charset=utf-8', 'cache-control': 'no-store' })
+      res.end(JSON.stringify({ devices }))
+    },
+  }))
+
   ctx.on('approval/request', async (req, next) => {
     send({ type: 'approval', id: req.callId, tool_name: req.toolName ?? '', reason: req.reason ?? '' })
     try {
@@ -355,7 +419,7 @@ function injectNarrowScreenCss(html) {
   // 就地渲染文件内容——只读,想改仍然去电脑上改。
   // 色值/圆角/字重全部取自 dsh 自身的实测计算值,别在人家界面里插一块不一样的东西。
   // 窄屏铺满一屏,宽屏收成居中卡片——和 dsh 的弹窗一个做法。
-  function viewer(title, body, error) {
+  function viewer(title, body, error, extraFactory) {
     var dark = matchMedia('(prefers-color-scheme: dark)').matches
     var t = dark
       ? { fg: '#f9fafb', surface: '#2c2c2e', line: 'rgba(255,255,255,.12)', muted: '#adb2b8', danger: '#f5766b' }
@@ -408,6 +472,7 @@ function injectNarrowScreenCss(html) {
     pre.textContent = error ? error : body
 
     card.append(bar, pre)
+    if (extraFactory) card.append(extraFactory(t, slim))
     mask.append(card)
     // 宽屏点遮罩关闭,窄屏没有遮罩可点
     if (!narrow.matches) mask.addEventListener('click', function (e) { if (e.target === mask) mask.remove() })
@@ -420,6 +485,90 @@ function injectNarrowScreenCss(html) {
   // 好让用户换手机、加设备时有地方拿新配对码(否则只能去删 paired.json)。
   var framed = window.parent !== window
 
+  // 已配对手机列表。白名单每条都持有访问权,而手机重装 App 会换身份密钥,
+  // 旧条目就此变成没人认识的常驻凭证——这里是撤销它们的地方。
+  function devicesBlock(t, slim) {
+    var box = document.createElement('div')
+    box.style.cssText = 'flex:none;border-top:1px solid ' + t.line + ';padding:12px 16px 14px'
+    var head = document.createElement('div')
+    head.style.cssText = 'font-size:12px;color:' + t.muted + ';padding-bottom:8px'
+    head.textContent = '已配对的手机'
+    var list = document.createElement('div')
+    box.append(head, list)
+
+    function render(devices) {
+      list.textContent = ''
+      if (!devices.length) {
+        var none = document.createElement('div')
+        none.style.cssText = 'font-size:12px;color:' + t.muted
+        none.textContent = '还没有手机配对过'
+        list.append(none)
+        return
+      }
+      devices.forEach(function (d) {
+        var row = document.createElement('div')
+        row.style.cssText = 'display:flex;align-items:center;gap:10px;padding:7px 0'
+        var dot = document.createElement('span')
+        dot.style.cssText = 'flex:none;width:7px;height:7px;border-radius:50%;background:'
+          + (d.online ? '#12b76a' : t.line)
+        dot.title = d.online ? '在线' : '离线'
+        var label = document.createElement('div')
+        label.style.cssText = 'flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap'
+        label.textContent = d.name
+        var idTag = document.createElement('span')
+        idTag.style.cssText = 'font-size:12px;color:' + t.muted
+          + ';font-family:ui-monospace,"SF Mono",Consolas,monospace;padding-left:8px'
+        idTag.textContent = d.id.slice(0, 8)
+        label.append(idTag)
+        // 不用原生 confirm:第一下改文案,第二下才真删
+        var drop = document.createElement('button')
+        drop.textContent = '移除'
+        drop.style.cssText = slim
+        var armed = false
+        drop.addEventListener('click', function () {
+          if (!armed) {
+            armed = true
+            drop.textContent = '确认移除?'
+            drop.style.color = t.danger
+            setTimeout(function () {
+              if (!armed) return
+              armed = false
+              drop.textContent = '移除'
+              drop.style.color = 'inherit'
+            }, 4000)
+            return
+          }
+          drop.disabled = true
+          drop.textContent = '移除中'
+          fetch('${DEVICES_PATH}', {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ id: d.id }),
+          })
+            .then(function (r) { return r.ok ? r.json() : r.text().then(function (x) { throw new Error(x) }) })
+            .then(function (x) { render(x.devices) })
+            .catch(function (e) {
+              drop.disabled = false
+              drop.textContent = '移除失败'
+              console.error('[dsh-tether] 移除设备失败', e)
+            })
+        })
+        row.append(dot, label, drop)
+        list.append(row)
+      })
+    }
+
+    var loading = document.createElement('div')
+    loading.style.cssText = 'font-size:12px;color:' + t.muted
+    loading.textContent = '读取中…'
+    list.append(loading)
+    fetch('${DEVICES_PATH}')
+      .then(function (r) { return r.ok ? r.json() : r.text().then(function (x) { throw new Error(x) }) })
+      .then(function (x) { render(x.devices) })
+      .catch(function (e) { loading.textContent = '读取失败: ' + (e && e.message ? e.message : e) })
+    return box
+  }
+
   function showPairing() {
     fetch('${PAIRING_PATH}')
       .then(function (r) { return r.ok ? r.json() : r.text().then(function (t) { throw new Error(t) }) })
@@ -427,6 +576,8 @@ function injectNarrowScreenCss(html) {
         viewer(
           '在手机上「添加电脑」里粘贴整行,' + Math.round(d.expiresInSec / 60) + ' 分钟内有效',
           d.pairingString,
+          undefined,
+          devicesBlock,
         )
       })
       .catch(function (e) { viewer('配对', '', String(e && e.message ? e.message : e)) })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-tether",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Reach the DeepSeek Harness on your dev machine from your phone — across networks, through no server at all (iroh P2P)",
   "keywords": [
     "dsh",
@@ -21,7 +21,8 @@
     "index.js",
     "cordis.patch.yml",
     "README.md",
-    "README.zh.md"
+    "README.zh.md",
+    "CHANGELOG.md"
   ],
   "dsh": {
     "bundle": {
@@ -29,18 +30,18 @@
     }
   },
   "peerDependencies": {
-    "@deepseek-ai/dsh-host-webserver": "0.1.0-rc.7",
-    "@deepseek-ai/dsh-user-approval": "0.1.0-rc.7"
+    "@deepseek-ai/dsh-host-webserver": ">=0.1.0-rc.7",
+    "@deepseek-ai/dsh-user-approval": ">=0.1.0-rc.7"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/dsh-host-webserver": { "optional": true },
     "@deepseek-ai/dsh-user-approval": { "optional": true }
   },
   "optionalDependencies": {
-    "dsh-tether-host-darwin-arm64": "0.1.2",
-    "dsh-tether-host-darwin-x64": "0.1.2",
-    "dsh-tether-host-linux-arm64": "0.1.2",
-    "dsh-tether-host-linux-x64": "0.1.2",
-    "dsh-tether-host-win32-x64": "0.1.2"
+    "dsh-tether-host-darwin-arm64": "0.1.4",
+    "dsh-tether-host-darwin-x64": "0.1.4",
+    "dsh-tether-host-linux-arm64": "0.1.4",
+    "dsh-tether-host-linux-x64": "0.1.4",
+    "dsh-tether-host-win32-x64": "0.1.4"
   }
 }