@ponydev/dsh-phone 0.0.0-stage → 0.2.1

package/lib/index.js

@@ -0,0 +1,184 @@
+// dsh-phone · Host 半区
+// - 挂 /phone 前缀路由（webServer.register + connection.admit 认证围栏）
+// - 纯 JSON 协议：POST /phone/<endpoint> → { ok: true, value } | { ok: false, error }
+// - 截图例外：成功时直接回 image/png 原始字节
+// - 不暴露任意 adb shell；serial 必须在最新 adb devices 列表里
+import { join } from 'node:path'
+import { homedir } from 'node:os'
+import { createTransports } from './transport.js'
+import { createTargetStore } from './targets.js'
+import { STREAM_QUALITY, createStreamer, streamSizeFor } from './stream.js'
+
+export const name = 'dsh-phone'
+
+const DEFAULTS = {
+  adbPath: 'adb',
+  pollMs: 700,
+  streamTimeLimit: 180,
+  streamBitRate: 6_000_000,
+  streamSize: '540x1200',
+}
+
+function messageOf(error) {
+  const text = error && error.message ? String(error.message) : '未知错误'
+  return text.length > 400 ? text.slice(0, 400) : text
+}
+
+function failOf(error) {
+  const code = error && typeof error.code === 'string' ? error.code : 'phone/error'
+  return { ok: false, error: { code, message: messageOf(error) } }
+}
+
+function readBody(req, cap = 1024 * 1024) {
+  return new Promise((resolve, reject) => {
+    const chunks = []
+    let size = 0
+    req.on('data', (chunk) => {
+      size += chunk.length
+      if (size > cap) {
+        reject(new Error('request body too large'))
+        req.destroy()
+        return
+      }
+      chunks.push(chunk)
+    })
+    req.on('end', () => resolve(Buffer.concat(chunks).toString('utf8')))
+    req.on('error', reject)
+  })
+}
+
+function json(res, code, payload) {
+  res.writeHead(code, {
+    'content-type': 'application/json; charset=utf-8',
+    'cache-control': 'no-store',
+  })
+  res.end(JSON.stringify(payload))
+}
+
+export function apply(ctx, rawConfig) {
+  const config = { ...DEFAULTS, ...(rawConfig || {}) }
+  const { adb } = createTransports({ adbPath: config.adbPath })
+  const home = process.env.DSH_HOME && process.env.DSH_HOME.trim() ? process.env.DSH_HOME.trim() : join(homedir(), '.dsh')
+  const targets = createTargetStore(join(home, 'phone', 'targets.json'))
+  const streamer = createStreamer(adb, {
+    timeLimit: config.streamTimeLimit,
+    bitRate: config.streamBitRate,
+    size: config.streamSize,
+  })
+
+  const ok = (value) => ({ ok: true, value })
+
+  async function handle(endpoint, payload) {
+    switch (endpoint) {
+      case 'health': {
+        try {
+          const info = await adb.resolve()
+          const { devices } = await adb.devices()
+          return ok({ adb: info, devices: devices.length })
+        } catch (error) {
+          return ok({ adb: null, devices: 0, error: messageOf(error) })
+        }
+      }
+      case 'devices': {
+        const { devices, at } = await adb.devices({ fresh: true })
+        return ok({ devices, at })
+      }
+      case 'connect': {
+        const result = await adb.connect(String(payload.address || ''))
+        await targets.record(result.address)
+        return ok(result)
+      }
+      case 'targets':
+        return ok({ targets: await targets.list() })
+      case 'targets/remove':
+        return ok({ removed: await targets.remove(String(payload.address || '')) })
+      case 'screen-info':
+        return ok(await adb.screenInfo(String(payload.serial || '')))
+      case 'disconnect':
+        return ok(await adb.disconnect(String(payload.serial || '')))
+      case 'input':
+        return ok(await adb.input(String(payload.serial || ''), payload.event || {}))
+      default:
+        return { ok: false, error: { code: 'phone/not-found', message: `未知接口: ${endpoint || '(empty)'}` } }
+    }
+  }
+
+  ctx.inject(['connection', 'webServer'], (scope) => {
+    scope.effect(
+      () =>
+        scope.webServer.register({
+          kind: 'prefix',
+          path: '/phone',
+          handler: async (req, res) => {
+            const admission = scope.connection.admit(req)
+            if ('rejection' in admission) {
+              res.writeHead(admission.rejection)
+              res.end(admission.rejection === 401 ? 'unauthorized' : 'forbidden')
+              return
+            }
+            const pathname = String(req.url || '/').split('?')[0]
+            const endpoint = pathname.replace(/^\/phone\/?/, '').replace(/\/+$/, '')
+            if (req.method !== 'POST') {
+              json(res, 405, { ok: false, error: { code: 'phone/method', message: '只接受 POST' } })
+              return
+            }
+            let payload = {}
+            try {
+              payload = JSON.parse((await readBody(req)) || '{}')
+            } catch {
+              json(res, 400, { ok: false, error: { code: 'phone/bad-body', message: '请求体不是 JSON' } })
+              return
+            }
+            if (endpoint === 'stream') {
+              const serial = String(payload.serial || '')
+              try {
+                await adb.assertReady(serial)
+              } catch (error) {
+                json(res, 200, failOf(error))
+                return
+              }
+              res.writeHead(200, {
+                'content-type': 'video/h264',
+                'cache-control': 'no-store',
+                'x-content-type-options': 'nosniff',
+                'x-accel-buffering': 'no',
+              })
+              if (typeof res.flushHeaders === 'function') res.flushHeaders()
+              const preset = STREAM_QUALITY[String(payload.quality || '')]
+              let openOptions = {}
+              if (preset) {
+                openOptions = { bitRate: preset.bitRate }
+                try {
+                  const info = await adb.screenInfo(serial)
+                  const dims = streamSizeFor(info, preset.shortSide)
+                  if (dims) openOptions.size = dims.width + 'x' + dims.height
+                } catch {}
+              }
+              streamer.open(serial, res, openOptions)
+              return
+            }
+            if (endpoint === 'shot') {
+              try {
+                const buffer = await adb.shot(String(payload.serial || ''))
+                res.writeHead(200, {
+                  'content-type': 'image/png',
+                  'content-length': buffer.length,
+                  'cache-control': 'no-store',
+                })
+                res.end(buffer)
+              } catch (error) {
+                json(res, 200, failOf(error))
+              }
+              return
+            }
+            try {
+              json(res, 200, await handle(endpoint, payload))
+            } catch (error) {
+              json(res, 200, failOf(error))
+            }
+          },
+        }),
+      'dsh-phone: route',
+    )
+  })
+}

package/lib/stream.js

@@ -0,0 +1,111 @@
+// dsh-phone · H.264 流（P1）
+// `adb exec-out screenrecord --output-format=h264 -` 是 Annex-B 裸流，
+// 这里只负责把子进程 stdout 原样 pipe 给 HTTP 响应，并管理生命周期：
+// - 客户端断开 → kill 子进程
+// - screenrecord 单次上限（默认 180s）→ 自动重启，客户端在下个 IDR 恢复
+// - res.write 背压 → pause/resume 子进程 stdout
+import { spawn } from 'node:child_process'
+
+/** 清晰度预设：按设备实际显示的短边缩放，保持屏幕比例，不改手机分辨率。 */
+export const STREAM_QUALITY = Object.freeze({
+  low: { shortSide: 360, bitRate: 2_000_000 },
+  medium: { shortSide: 540, bitRate: 6_000_000 },
+  high: { shortSide: 720, bitRate: 10_000_000 },
+})
+
+/**
+ * 按设备分辨率算出 screenrecord 的输出尺寸：等比缩放到目标短边、宽高取偶数。
+ * 例如 Pixel 1080x2400 + 标准(540) => 540x1200；720x1280 => 540x960。
+ */
+export function streamSizeFor(info, shortSide) {
+  const width = Number(info && info.width) || 0
+  const height = Number(info && info.height) || 0
+  if (width < 2 || height < 2) return null
+  const short = Math.min(width, height)
+  const scale = Math.min(1, shortSide / short)
+  const even = (value, max) => {
+    const rounded = Math.max(2, Math.round((value * scale) / 2) * 2)
+    return Math.min(Math.floor(max / 2) * 2, rounded)
+  }
+  return { width: even(width, width), height: even(height, height) }
+}
+
+const DEFAULTS = {
+  timeLimit: 180,
+  bitRate: 6_000_000,
+  size: '540x1200',
+  restartDelayMs: 250,
+}
+
+export function createStreamer(adb, options = {}) {
+  const config = { ...DEFAULTS, ...options }
+
+  return {
+    /**
+     * 把某台设备的 H.264 流接到一个 HTTP 响应上。
+     * 调用前必须先 adb.assertReady(serial)，这里不再重复校验。
+     */
+    open(serial, res, overrides = {}) {
+      const size = overrides.size || config.size
+      const bitRate = overrides.bitRate || config.bitRate
+      let closed = false
+      let child = null
+      let restartTimer = null
+
+      const stop = () => {
+        if (closed) return
+        closed = true
+        if (restartTimer) clearTimeout(restartTimer)
+        if (child) {
+          try {
+            child.kill('SIGTERM')
+          } catch {}
+        }
+      }
+
+      const start = () => {
+        if (closed) return
+        const args = [
+          '-s',
+          serial,
+          'exec-out',
+          'screenrecord',
+          '--output-format=h264',
+          '--time-limit=' + String(config.timeLimit),
+          '--bit-rate=' + String(bitRate),
+          '--size=' + size,
+          '-',
+        ]
+        child = spawn(adb.bin, args, { stdio: ['ignore', 'pipe', 'ignore'] })
+        if (!child.stdout) {
+          stop()
+          return
+        }
+        child.stdout.on('data', (chunk) => {
+          if (closed) return
+          const ok = res.write(chunk)
+          if (!ok) {
+            child.stdout.pause()
+            res.once('drain', () => {
+              if (!closed && child && child.stdout) child.stdout.resume()
+            })
+          }
+        })
+        child.stdout.on('error', stop)
+        child.on('error', () => {
+          if (closed) return
+          restartTimer = setTimeout(start, 1000)
+        })
+        child.on('exit', () => {
+          if (closed) return
+          restartTimer = setTimeout(start, config.restartDelayMs)
+        })
+      }
+
+      res.on('close', stop)
+      res.on('error', stop)
+      start()
+      return stop
+    },
+  }
+}

package/lib/targets.js

@@ -0,0 +1,55 @@
+// dsh-phone · 连接目标收藏（$DSH_HOME/phone/targets.json）
+// 只存地址和最近使用时间，不存任何凭据；文件权限 600。
+import { mkdir, readFile, writeFile } from 'node:fs/promises'
+import { dirname } from 'node:path'
+import { ADDRESS_RE } from './adb.js'
+
+const LIMIT = 12
+
+export function createTargetStore(file) {
+  let cache = null
+
+  async function load() {
+    if (cache !== null) return cache
+    try {
+      const parsed = JSON.parse(await readFile(file, 'utf8'))
+      const raw = Array.isArray(parsed) ? parsed : parsed && Array.isArray(parsed.targets) ? parsed.targets : []
+      cache = raw.filter((item) => item && typeof item.address === 'string' && ADDRESS_RE.test(item.address))
+    } catch {
+      cache = []
+    }
+    return cache
+  }
+
+  async function persist(list) {
+    cache = list.slice(0, LIMIT)
+    await mkdir(dirname(file), { recursive: true })
+    await writeFile(file, JSON.stringify({ version: 1, targets: cache }, null, 2) + '\n', { mode: 0o600 })
+  }
+
+  return {
+    async list() {
+      return [...(await load())]
+    },
+    /** 连接成功后记录最近使用（去重、置顶、最多 12 条）。 */
+    async record(address) {
+      if (typeof address !== 'string' || !ADDRESS_RE.test(address)) return null
+      const list = await load()
+      const index = list.findIndex((item) => item.address === address)
+      const entry = {
+        address,
+        lastSeenAt: Date.now(),
+        pinned: index >= 0 ? list[index].pinned === true : false,
+      }
+      if (index >= 0) list.splice(index, 1)
+      list.unshift(entry)
+      await persist(list)
+      return entry
+    },
+    async remove(address) {
+      const list = await load()
+      await persist(list.filter((item) => item.address !== address))
+      return true
+    },
+  }
+}

package/lib/transport.js

@@ -0,0 +1,55 @@
+// dsh-phone · transport 层
+// 把「设备从哪来、画面怎么取、输入怎么发」抽成一个接口。
+// 现在只有 adb；以后加 hdc（鸿蒙）或 iOS（idb / WDA）时，各实现一个 transport，UI 不变。
+//
+// interface PhoneTransport {
+//   id: 'adb' | 'hdc' | 'ios'
+//   label: string
+//   resolve(): Promise<unknown>
+//   list(): Promise<Device[]>
+//   connect(target: string): Promise<unknown>
+//   disconnect(serial: string): Promise<unknown>
+//   shot(serial: string): Promise<Buffer>
+//   input(serial: string, event: object): Promise<unknown>
+// }
+import { Adb } from './adb.js'
+
+export class AdbTransport {
+  constructor(adb) {
+    this.id = 'adb'
+    this.label = 'adb'
+    this.adb = adb
+  }
+
+  resolve() {
+    return this.adb.resolve()
+  }
+
+  async list() {
+    const { devices } = await this.adb.devices()
+    return devices.map((device) => ({ ...device, transport: this.id }))
+  }
+
+  connect(address) {
+    return this.adb.connect(address)
+  }
+
+  disconnect(serial) {
+    return this.adb.disconnect(serial)
+  }
+
+  shot(serial) {
+    return this.adb.shot(serial)
+  }
+
+  input(serial, event) {
+    return this.adb.input(serial, event)
+  }
+}
+
+export function createTransports(options = {}) {
+  const adb = new Adb({ path: options.adbPath })
+  const transports = new Map()
+  transports.set('adb', new AdbTransport(adb))
+  return { adb, transports }
+}

package/package.json

@@ -1,6 +1,67 @@
 {
   "name": "@ponydev/dsh-phone",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.1",
+  "description": "DSH Web 插件：右侧栏预览并点按控制已连接的 Android 设备（adb）",
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "android",
+    "adb",
+    "phone",
+    "mirror",
+    "scrcpy"
+  ],
+  "license": "MIT",
+  "author": "Pony <205503242+jmaubay7@users.noreply.github.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/PonyDevAI/dsh-phone.git"
+  },
+  "bugs": {
+    "url": "https://github.com/PonyDevAI/dsh-phone/issues"
+  },
+  "homepage": "https://github.com/PonyDevAI/dsh-phone#readme",
+  "type": "module",
+  "files": [
+    "lib",
+    "docs",
+    "cordis.patch.yml",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE",
+    "AGENTS.md",
+    "CONTRIBUTING.md",
+    "RELEASE.md"
+  ],
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js"
+  },
+  "engines": {
+    "dsh": ">=0.2.0-rc.2 <0.3.0",
+    "node": ">=22.5"
+  },
+  "scripts": {
+    "check": "node --check lib/adb.js && node --check lib/targets.js && node --check lib/stream.js && node --check lib/transport.js && node --check lib/index.js && node --check lib/client.js && node scripts/check-i18n.mjs",
+    "smoke": "node scripts/smoke.mjs",
+    "check-i18n": "node scripts/check-i18n.mjs",
+    "release-notes": "node scripts/release-notes.mjs",
+    "test-ui": "node scripts/render-test.mjs"
+  },
+  "dsh": {
+    "manifestVersion": 1,
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "immediately": true,
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-sidebar-right",
+        "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-locale"
+      ]
+    }
+  }
+}