dsh-adb 0.2.0 → 1.1.0

package/README.md

@@ -14,9 +14,13 @@ dsh plugin --profile web add dsh-adb
 
 Or install directly from GitHub: `dsh plugin --profile web add github:SamXiaBing/dsh-adb`
 
+## Web device panel (v1.1.0)
+
+A "设备" tab in the conversation view ring (next to chat / trajectory / automation): device list with status, package autocomplete (fuzzy search), live streaming logcat window (level/keyword/package/pid filters, pause/clear/auto-scroll), device info card, process list, and performance snapshot — plus harness synergy: **send any logcat/snapshot to the conversation** (the agent analyzes it), a live strip of the agent's adb operations, and a registered **crash-analysis skill** (`dsh-adb-crash-analysis`) for automation pipelines. Data flows over the package RPC channel; install into a web profile and restart the GUI (see `scripts/restart-web.ps1` for a one-click restart).
+
 ## Ecosystem
 
-- ✅ [npm](https://www.npmjs.com/package/dsh-adb) — `dsh-adb` published (latest: 0.1.5)
+- ✅ [npm](https://www.npmjs.com/package/dsh-adb) — `dsh-adb` published (latest: 1.0.0)
 - ✅ [awesome-deepseek-harness#87](https://github.com/0xsline/awesome-deepseek-harness/pull/87) — **merged**
 - ✅ [awesome-dsh-plugin#85](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/85) — **merged**
 - ✅ [awesome-DSH-plugin#29](https://github.com/Alex-Yanggg/awesome-DSH-plugin/pull/29) — **merged**

package/README.zh-CN.md

@@ -14,9 +14,13 @@ dsh plugin --profile web add dsh-adb
 
 或从 GitHub 直装：`dsh plugin --profile web add github:SamXiaBing/dsh-adb`
 
+## Web 设备面板（v1.0.0）
+
+会话视图页签「设备」（与 chat/轨迹/任务管理并列）：设备列表/状态、按包名的性能快照（内存/帧率/电量）、过滤 logcat 尾部。数据走 Package RPC；需装入 web profile 并重启 GUI 生效。
+
 ## 生态收录
 
-- ✅ [npm](https://www.npmjs.com/package/dsh-adb) — `dsh-adb` 已发布（latest: 0.1.5）
+- ✅ [npm](https://www.npmjs.com/package/dsh-adb) — `dsh-adb` 已发布（latest: 1.0.0）
 - ✅ [awesome-deepseek-harness#87](https://github.com/0xsline/awesome-deepseek-harness/pull/87) — **已合并**
 - ✅ [awesome-dsh-plugin#85](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/85) — **已合并**
 - ✅ [awesome-DSH-plugin#29](https://github.com/Alex-Yanggg/awesome-DSH-plugin/pull/29) — **已合并**

package/client.js

@@ -0,0 +1,468 @@
+/* dsh-adb Web device panel (client half, v1.1.3) — plain JS, no build step.
+ * Registers a "设备" tab in conversation.view and talks to the Host half over
+ * the package RPC channel /dsh-adb. Uses only client builtins: React, ctx.
+ * v1.1.3: i18n (follows harness locale via the slots `locale:` seat) + state
+ * survives tab switches (defineStore declared at register).
+ * Dual-mode: browser registers via __ModuleLoader__; Node (tests via node:vm
+ * with a fake `module`) exports the pure helpers + dictionary.
+ */
+'use strict'
+
+// ---- Pure helpers (shared by the panel and the unit tests) ----
+
+function nodeArrayOf(snapshot) {
+  try {
+    const nodes = snapshot && snapshot.chat && snapshot.chat.nodes
+    if (!nodes) return []
+    if (typeof nodes.values === 'function') return Array.from(nodes.values())
+    if (Array.isArray(nodes)) return nodes
+    return []
+  } catch {
+    return []
+  }
+}
+
+/** Extract recent adb_* tool calls from conversation nodes: [{name, time}]. */
+function extractAdbActivity(nodes) {
+  const out = []
+  const list = Array.isArray(nodes) ? nodes : []
+  for (const node of list) {
+    if (!node || node.kind !== 'tool-call') continue
+    const root = node.root
+    const name = root && typeof root.name === 'string' ? root.name : ''
+    if (!name.startsWith('adb_')) continue
+    out.push({ name, time: root.time })
+  }
+  return out.slice(-8).reverse()
+}
+
+/** Format a logcat entry list into a send-to-conversation text block. */
+function formatLogcatBlock(entries) {
+  const lines = (Array.isArray(entries) ? entries : [])
+    .map((e) => `${e.time} ${e.pid} ${e.tid} ${e.level} ${e.tag}: ${e.message}`)
+  return [`以下是从设备面板抓取的 logcat 片段（${lines.length} 条），请分析：`, '```log', ...lines, '```'].join('\n')
+}
+
+/** Format a perf snapshot into a send-to-conversation text block. */
+function formatSnapshotBlock(snapshot) {
+  const rows = []
+  const m = snapshot && snapshot.meminfo
+  const g = snapshot && snapshot.gfxinfo
+  const b = snapshot && snapshot.battery
+  if (m) rows.push(`内存 PSS=${m.totalPssKb}KB RSS=${m.totalRssKb}KB JavaHeap=${m.javaHeapKb}KB NativeHeap=${m.nativeHeapKb}KB`)
+  if (g) rows.push(`帧=${g.totalFrames} 卡顿=${g.jankyFrames}(${g.jankyPercent}%) P50=${g.percentile50Ms}ms P90=${g.percentile90Ms}ms P95=${g.percentile95Ms}ms P99=${g.percentile99Ms}ms MissedVsync=${g.missedVsync}`)
+  if (b) rows.push(`电量=${b.levelPercent}% 温度=${b.temperatureC}°C`)
+  return ['以下是从设备面板抓取的性能快照，请分析：', ...rows.map((r) => '- ' + r)].join('\n')
+}
+
+/** Panel dictionary: zh is the key-set source of truth, en mirrors it. */
+const DICTIONARY = {
+  zh: {
+    'panel.title': 'ADB 设备',
+    'refresh': '刷新',
+    'noDevices': '未连接设备',
+    'deviceInfo': '设备信息',
+    'package': '包名',
+    'packagePlaceholder': '输入或选择包名',
+    'snapshot': '性能快照',
+    'sendToChat': '发送到对话',
+    'processes': '进程（{n}）— 点击按 pid 过滤 logcat',
+    'logcat': 'logcat',
+    'keywordFilter': '关键字过滤',
+    'packageFilter': '包名过滤（按进程）',
+    'resume': '继续',
+    'pause': '暂停',
+    'clear': '清空',
+    'autoScroll': '自动滚动',
+    'shownCount': '已显示 {n} 条',
+    'refreshing': '每 1.5s 增量刷新',
+    'paused': '已暂停',
+    'waitingLog': '（等待日志…）',
+    'agentActivity': 'agent 的 adb 操作',
+    'noData': '（无数据）',
+    'model': '型号', 'manufacturer': '厂商', 'android': 'Android', 'api': 'API',
+    'resolution': '分辨率', 'memTotal': '内存总量',
+    'memPss': '内存 PSS (KB)', 'memRss': '内存 RSS (KB)', 'javaHeap': 'Java Heap (KB)', 'nativeHeap': 'Native Heap (KB)',
+    'frames': '总帧数', 'janky': '卡顿帧 / %', 'p50p90': 'P50/P90 (ms)', 'p95p99': 'P95/P99 (ms)',
+    'battery': '电量', 'temp': '温度 (°C)', 'pkg': '包=', 'pid': 'pid=',
+  },
+  en: {
+    'panel.title': 'ADB Devices',
+    'refresh': 'Refresh',
+    'noDevices': 'No device connected',
+    'deviceInfo': 'Device Info',
+    'package': 'Package',
+    'packagePlaceholder': 'Type or pick a package',
+    'snapshot': 'Perf Snapshot',
+    'sendToChat': 'Send to chat',
+    'processes': 'Processes ({n}) — click to filter logcat by pid',
+    'logcat': 'logcat',
+    'keywordFilter': 'Keyword filter',
+    'packageFilter': 'Package filter (by process)',
+    'resume': 'Resume',
+    'pause': 'Pause',
+    'clear': 'Clear',
+    'autoScroll': 'Auto-scroll',
+    'shownCount': '{n} entries shown',
+    'refreshing': 'incremental 1.5s refresh',
+    'paused': 'paused',
+    'waitingLog': '(waiting for logs…)',
+    'agentActivity': "Agent's adb activity",
+    'noData': '(no data)',
+    'model': 'Model', 'manufacturer': 'Manufacturer', 'android': 'Android', 'api': 'API',
+    'resolution': 'Resolution', 'memTotal': 'Total memory',
+    'memPss': 'PSS (KB)', 'memRss': 'RSS (KB)', 'javaHeap': 'Java Heap (KB)', 'nativeHeap': 'Native Heap (KB)',
+    'frames': 'Total frames', 'janky': 'Janky / %', 'p50p90': 'P50/P90 (ms)', 'p95p99': 'P95/P99 (ms)',
+    'battery': 'Battery', 'temp': 'Temp (°C)', 'pkg': 'pkg=', 'pid': 'pid=',
+  },
+}
+
+// ---- Browser entry ----
+
+if (typeof window !== 'undefined' && typeof window.__ModuleLoader__ === 'object') {
+  window.__ModuleLoader__.load({
+    id: 'dsh-adb',
+    factory: (require) => {
+      const module = { exports: {} }
+
+      const React = require('react')
+      const { defineStore } = require('@deepseek-ai/dsh-client-runtime/client')
+      const CHANNEL = '/dsh-adb'
+
+      function unwrap(value) {
+        if (typeof value !== 'object' || value === null || !('ok' in value)) {
+          throw new Error('dsh-adb host returned an invalid response.')
+        }
+        if (value.ok === true && 'value' in value) return value.value
+        if (value.ok === false && value.error) {
+          throw new Error(value.error.message ?? 'dsh-adb request failed.')
+        }
+        throw new Error('dsh-adb host returned an invalid response.')
+      }
+
+      function createRuntime(rpc) {
+        const call = (endpoint, payload) => rpc.call(CHANNEL, endpoint, payload).then(unwrap)
+        return {
+          listDevices: () => call('listDevices', {}),
+          listPackages: (payload) => call('listPackages', payload),
+          deviceInfo: (payload) => call('deviceInfo', payload),
+          processList: (payload) => call('processList', payload),
+          logcatDelta: (payload) => call('logcatDelta', payload),
+          perfSnapshot: (payload) => call('perfSnapshot', payload),
+        }
+      }
+
+      const h = React.createElement
+      const ROW = { display: 'flex', alignItems: 'center', gap: 8, padding: '4px 0', flexWrap: 'wrap' }
+      const BTN = { padding: '3px 10px', cursor: 'pointer' }
+      const INPUT = { padding: '3px 6px' }
+      const SECTION = { marginTop: 14, borderTop: '1px solid var(--dsh-border, #ddd)', paddingTop: 10 }
+      const DROPDOWN = {
+        position: 'absolute', top: '100%', left: 0, right: 0, maxHeight: 180, overflowY: 'auto',
+        background: 'var(--dsh-bg, #ffffff)', color: 'inherit',
+        border: '1px solid var(--dsh-border, #ccc)', borderRadius: 4, zIndex: 20, boxShadow: '0 2px 8px rgba(0,0,0,.2)',
+      }
+      const DROPDOWN_ITEM = { padding: '4px 8px', cursor: 'pointer', overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap' }
+
+      function MetricRows({ rows }) {
+        if (!rows || rows.length === 0) return h('div', null, '（无数据）')
+        return h('table', { style: { borderCollapse: 'collapse' } },
+          rows.map((row) => h('tr', { key: row[0] },
+            h('td', { style: { padding: '2px 12px 2px 0', color: 'var(--dsh-text-secondary, #888)' } }, row[0]),
+            h('td', { style: { padding: '2px 0' } }, String(row[1])),
+          )),
+        )
+      }
+
+      function PackageCombobox({ packages, value, placeholder, onChange }) {
+        const [query, setQuery] = React.useState('')
+        const [open, setOpen] = React.useState(false)
+        const shown = open
+          ? packages.filter((name) => query === '' || name.toLowerCase().includes(query.toLowerCase())).slice(0, 60)
+          : []
+        return h('div', { style: { position: 'relative', flex: 1, minWidth: 220 } },
+          h('input', {
+            style: { ...INPUT, width: '100%', boxSizing: 'border-box' },
+            value: query,
+            placeholder: value || placeholder || '',
+            onChange: (e) => { setQuery(e.target.value); setOpen(true) },
+            onFocus: () => setOpen(true),
+            onBlur: () => setTimeout(() => { setOpen(false); setQuery('') }, 150),
+            onKeyDown: (e) => {
+              if (e.key === 'Enter' && shown.length > 0) { onChange(shown[0]); setQuery(''); setOpen(false) }
+            },
+          }),
+          open && shown.length > 0 && h('div', { style: DROPDOWN },
+            shown.map((name) => h('div', {
+              key: name,
+              onMouseDown: () => { onChange(name); setQuery(''); setOpen(false) },
+              onMouseEnter: (e) => { e.currentTarget.style.background = 'var(--dsh-accent-soft, rgba(66,133,244,.12))' },
+              onMouseLeave: (e) => { e.currentTarget.style.background = 'transparent' },
+              style: DROPDOWN_ITEM,
+            }, name))),
+        )
+      }
+
+      function DeviceView(props) {
+        const runtime = props.runtime
+        const t = props.t || ((key) => DICTIONARY.zh[key] ?? key)
+        const st = props.useStore((s) => s)
+        const actions = props.actions
+        const [busy, setBusy] = React.useState(false)
+        const logRef = React.useRef(null)
+        const stateRef = React.useRef(st)
+        stateRef.current = st
+
+        const adbActivity = props.useSession
+          ? props.useSession((snap) => extractAdbActivity(nodeArrayOf(snap)))
+          : []
+        const sendToChat = (text) => {
+          if (props.inputActions && typeof props.inputActions.setDraft === 'function') {
+            props.inputActions.setDraft(text)
+          }
+        }
+
+        const fail = (e) => actions.setError(String((e && e.message) || e))
+
+        const refresh = () => {
+          setBusy(true); actions.setError(null)
+          runtime.listDevices()
+            .then((value) => actions.setDevices(value.devices ?? []))
+            .catch(fail)
+            .finally(() => setBusy(false))
+        }
+        React.useEffect(refresh, [])
+
+        const selectDevice = (device) => {
+          actions.setSelected(device)
+          actions.setInfo(null); actions.setSnapshot(null); actions.setProcesses([])
+          actions.clearLog()
+          setBusy(true); actions.setError(null)
+          Promise.all([
+            runtime.deviceInfo({ serial: device.serial }).then(actions.setInfo),
+            runtime.listPackages({ serial: device.serial }).then((v) => actions.setPackages(v.packages ?? [])),
+          ]).catch(fail).finally(() => setBusy(false))
+        }
+
+        const loadProcesses = (pkgName) => {
+          const device = stateRef.current.selected
+          if (!device) return
+          runtime.processList({ serial: device.serial, package: pkgName })
+            .then((v) => actions.setProcesses(v.processes ?? []))
+            .catch(fail)
+        }
+        React.useEffect(() => { if (st.selected) loadProcesses(st.pkg) }, [st.pkg]) // eslint-disable-line react-hooks/exhaustive-deps
+
+        const runSnapshot = () => {
+          const device = stateRef.current.selected
+          if (!device) return
+          setBusy(true); actions.setError(null)
+          runtime.perfSnapshot({ serial: device.serial, package: st.pkg })
+            .then(actions.setSnapshot)
+            .catch(fail)
+            .finally(() => setBusy(false))
+        }
+
+        const applyPackageFilter = (name) => {
+          actions.setLogPkg(name)
+          actions.clearLog()
+          if (name === '') { actions.setLogPids([]); return }
+          const device = stateRef.current.selected
+          if (!device) return
+          runtime.processList({ serial: device.serial, package: name })
+            .then((v) => actions.setLogPids((v.processes ?? []).map((p) => p.pid)))
+            .catch(fail)
+        }
+
+        const applyLogFilters = (level, keyword, pids) => {
+          actions.setLogLevel(level)
+          actions.setLogKeyword(keyword)
+          actions.setLogPids(pids)
+          actions.clearLog()
+        }
+
+        React.useEffect(() => {
+          if (!st.selected || st.logPaused) return
+          const timer = setInterval(() => {
+            const s = stateRef.current
+            runtime.logcatDelta({
+              serial: s.selected.serial,
+              since: s.logSince,
+              level: s.logLevel,
+              keyword: s.logKeyword || undefined,
+              tail: 200,
+            }).then((value) => {
+              let entries = value.entries ?? []
+              if (s.logPids.length > 0) entries = entries.filter((e) => s.logPids.includes(e.pid))
+              if (entries.length > 0) {
+                actions.appendLog(entries)
+                actions.setLogSince(entries[entries.length - 1].time)
+              }
+            }).catch(() => { /* transient poll errors are ignored */ })
+          }, 1500)
+          return () => clearInterval(timer)
+        }, [st.selected, st.logPaused]) // eslint-disable-line react-hooks/exhaustive-deps
+
+        React.useEffect(() => {
+          const el = logRef.current
+          if (el && st.logAuto) el.scrollTop = el.scrollHeight
+        }, [st.logEntries, st.logAuto])
+
+        const snapshotRows = []
+        if (st.snapshot) {
+          const m = st.snapshot.meminfo; const g = st.snapshot.gfxinfo; const b = st.snapshot.battery
+          if (m) snapshotRows.push([t('memPss'), m.totalPssKb], [t('memRss'), m.totalRssKb], [t('javaHeap'), m.javaHeapKb], [t('nativeHeap'), m.nativeHeapKb])
+          if (g) snapshotRows.push([t('frames'), g.totalFrames], [t('janky'), `${g.jankyFrames} / ${g.jankyPercent}%`], [t('p50p90'), `${g.percentile50Ms} / ${g.percentile90Ms}`], [t('p95p99'), `${g.percentile95Ms} / ${g.percentile99Ms}`])
+          if (b) snapshotRows.push([t('battery'), `${b.levelPercent}%`], [t('temp'), b.temperatureC])
+        }
+        const infoRows = st.info
+          ? [[t('model'), st.info.model], [t('manufacturer'), st.info.manufacturer], [t('android'), st.info.release], [t('api'), st.info.sdk], [t('resolution'), st.info.resolution], [t('memTotal'), st.info.memTotalKb ? `${Math.round(st.info.memTotalKb / 1024)} MB` : undefined]].filter((r) => r[1] !== undefined && r[1] !== null)
+          : []
+
+        const pidsLabel = st.logPids.length > 0 ? ` · ${t('pid')}${st.logPids.join(',')}` : ''
+        const statusText = `${t('shownCount').replace('{n}', String(st.logEntries.length))}${st.logPkg ? ` · ${t('pkg')}${st.logPkg}` : ''}${pidsLabel}${st.logPaused ? ` · ${t('paused')}` : ` · ${t('refreshing')}`}`
+
+        return h('div', { style: { padding: 12, fontFamily: 'inherit', fontSize: 13 } },
+          h('div', { style: { ...ROW, justifyContent: 'space-between' } },
+            h('strong', null, t('panel.title')),
+            h('button', { style: BTN, onClick: refresh, disabled: busy }, busy ? '…' : t('refresh')),
+          ),
+          st.error !== null && h('div', { style: { color: '#e5484d', margin: '6px 0', wordBreak: 'break-all' } }, String(st.error)),
+          st.devices.length === 0
+            ? h('div', { style: { color: 'var(--dsh-text-secondary, #888)', margin: '8px 0' } }, t('noDevices'))
+            : h('div', null, st.devices.map((d) =>
+                h('button', {
+                  key: d.serial,
+                  onClick: () => selectDevice(d),
+                  style: { ...BTN, display: 'block', width: '100%', textAlign: 'left', margin: '2px 0',
+                    background: st.selected && st.selected.serial === d.serial ? 'var(--dsh-accent-soft, rgba(66,133,244,.15))' : 'transparent' },
+                }, `${d.serial} · ${d.state}${d.model ? ' · ' + d.model : ''}`),
+              )),
+
+          adbActivity.length > 0 && h('div', { style: SECTION },
+            h('strong', null, t('agentActivity')),
+            h('div', { style: { marginTop: 4, fontSize: 12, color: 'var(--dsh-text-secondary, #888)' } },
+              adbActivity.map((a, i) => h('div', { key: `${a.name}-${i}` }, `• ${a.name}${a.time ? '  @ ' + a.time : ''}`))),
+          ),
+
+          st.selected !== null && h('div', { style: { marginTop: 14 } },
+            st.info !== null && infoRows.length > 0 && h('div', { style: SECTION },
+              h('strong', null, t('deviceInfo')),
+              h(MetricRows, { rows: infoRows }),
+            ),
+
+            h('div', { style: SECTION },
+              h('div', { style: ROW },
+                h('label', null, t('package')),
+                h(PackageCombobox, { packages: st.packages, value: st.pkg, placeholder: t('packagePlaceholder'), onChange: (name) => actions.setPkg(name) }),
+                h('button', { style: BTN, onClick: runSnapshot, disabled: busy }, t('snapshot')),
+                st.snapshot && h('button', { style: BTN, onClick: () => sendToChat(formatSnapshotBlock(st.snapshot)) }, t('sendToChat')),
+              ),
+              st.snapshot && h('div', { style: { marginTop: 8 } }, h(MetricRows, { rows: snapshotRows })),
+
+              st.processes.length > 0 && h('div', { style: { marginTop: 8 } },
+                h('div', { style: { color: 'var(--dsh-text-secondary, #888)' } }, t('processes').replace('{n}', String(st.processes.length))),
+                h('div', { style: { display: 'flex', flexWrap: 'wrap', gap: 4, marginTop: 4 } },
+                  st.processes.map((p) => {
+                    const active = st.logPids.length === 1 && st.logPids[0] === p.pid
+                    return h('button', {
+                      key: p.pid,
+                      onClick: () => { const next = active ? [] : [p.pid]; applyLogFilters(st.logLevel, st.logKeyword, next) },
+                      style: { ...BTN, fontSize: 11, background: active ? 'var(--dsh-accent-soft, rgba(66,133,244,.15))' : 'transparent' },
+                    }, `${p.pid} ${p.name}`)
+                  })),
+              ),
+            ),
+
+            h('div', { style: SECTION },
+              h('div', { style: ROW },
+                h('label', null, t('logcat')),
+                h('select', { style: INPUT, value: st.logLevel, onChange: (e) => applyLogFilters(e.target.value, st.logKeyword, st.logPids) },
+                  ['V', 'D', 'I', 'W', 'E', 'F'].map((lv) => h('option', { key: lv, value: lv }, lv))),
+                h('input', { style: { ...INPUT, minWidth: 130 }, placeholder: t('keywordFilter'), value: st.logKeyword, onChange: (e) => applyLogFilters(st.logLevel, e.target.value, st.logPids) }),
+                h('div', { style: { flex: 1, minWidth: 180 } },
+                  h(PackageCombobox, { packages: st.packages, value: st.logPkg, placeholder: st.logPkg || t('packageFilter'), onChange: applyPackageFilter })),
+                h('button', { style: BTN, onClick: () => actions.setLogPaused(!st.logPaused) }, st.logPaused ? t('resume') : t('pause')),
+                h('button', { style: BTN, onClick: () => actions.clearLog() }, t('clear')),
+                h('button', { style: BTN, onClick: () => sendToChat(formatLogcatBlock(st.logEntries)), disabled: st.logEntries.length === 0 }, t('sendToChat')),
+                h('label', { style: { fontSize: 12, display: 'flex', alignItems: 'center', gap: 4 } },
+                  h('input', { type: 'checkbox', checked: st.logAuto, onChange: (e) => actions.setLogAuto(e.target.checked) }), ' ', t('autoScroll')),
+              ),
+              h('div', { style: { color: 'var(--dsh-text-secondary, #888)', margin: '4px 0', fontSize: 12 } }, statusText),
+              h('div', { ref: logRef, style: { maxHeight: 300, overflowY: 'auto', fontFamily: 'monospace', fontSize: 12, whiteSpace: 'pre-wrap', border: '1px solid var(--dsh-border, #ccc)', padding: 6 } },
+                st.logEntries.length === 0
+                  ? h('div', { style: { color: 'var(--dsh-text-secondary, #888)' } }, t('waitingLog'))
+                  : st.logEntries.map((e) => h('div', { key: `${e.time}-${e.pid}-${e.tid}-${e.message}` },
+                      `${e.time} ${e.pid} ${e.tid} ${e.level} ${e.tag}: ${e.message}`))),
+            ),
+          ),
+        )
+      }
+
+      function apply(ctx) {
+        const slots = ctx.get('slots')
+        const connection = ctx.get('connection')
+        if (slots === undefined || connection === undefined || connection.rpc === undefined) return
+        const runtime = createRuntime(connection.rpc)
+
+        // i18n: register the panel dictionary under the harness locale system.
+        const locale = ctx.get('locale')
+        if (locale && typeof locale.register === 'function') {
+          ctx.effect(() => locale.register('dsh-adb', DICTIONARY))
+        }
+
+        // Store: declared at register, so state survives view tab switches.
+        const panelStore = defineStore({
+          init: () => ({
+            devices: [], selected: null, info: null, packages: [], pkg: 'com.android.systemui',
+            snapshot: null, processes: [], logEntries: [], logSince: '',
+            logLevel: 'V', logKeyword: '', logPkg: '', logPids: [], logPaused: false, logAuto: true, error: null,
+          }),
+          actions: {
+            setDevices: (d, v) => { d.devices = v },
+            setSelected: (d, v) => { d.selected = v },
+            setInfo: (d, v) => { d.info = v },
+            setPackages: (d, v) => { d.packages = v },
+            setPkg: (d, v) => { d.pkg = v },
+            setSnapshot: (d, v) => { d.snapshot = v },
+            setProcesses: (d, v) => { d.processes = v },
+            setError: (d, v) => { d.error = v },
+            appendLog: (d, entries) => {
+              const seen = new Set(d.logEntries.map((e) => `${e.time}:${e.pid}:${e.message}`))
+              const fresh = entries.filter((e) => !seen.has(`${e.time}:${e.pid}:${e.message}`))
+              d.logEntries = [...d.logEntries, ...fresh].slice(-500)
+            },
+            setLogSince: (d, v) => { d.logSince = v },
+            setLogLevel: (d, v) => { d.logLevel = v },
+            setLogKeyword: (d, v) => { d.logKeyword = v },
+            setLogPkg: (d, v) => { d.logPkg = v },
+            setLogPids: (d, v) => { d.logPids = v },
+            setLogPaused: (d, v) => { d.logPaused = v },
+            setLogAuto: (d, v) => { d.logAuto = v },
+            clearLog: (d) => { d.logEntries = []; d.logSince = '' },
+          },
+        })
+
+        slots.inject('conversation.view', () => slots.register(
+          {
+            name: 'conversation.view',
+            id: 'devices',
+            order: 30,
+            label: () => {
+              const loc = ctx.get('locale')
+              return loc && typeof loc.getLocale === 'function' && loc.getLocale().active === 'en' ? 'Devices' : '设备'
+            },
+            store: panelStore,
+            locale: 'dsh-adb',
+          },
+          (props) => h(DeviceView, { ...props, runtime }),
+        ))
+      }
+
+      module.exports = { apply }
+      return module.exports
+    },
+  })
+} else if (typeof module !== 'undefined' && module.exports) {
+  module.exports = { formatLogcatBlock, formatSnapshotBlock, extractAdbActivity, nodeArrayOf, DICTIONARY }
+}

package/lib/index.js

@@ -7,6 +7,8 @@ import { registerInstallTool } from './tools/install.js';
 import { registerLogcatTool } from './tools/logcat.js';
 import { registerPerfTool } from './tools/perf.js';
 import { registerPerfBaselineTool } from './tools/perf-baseline.js';
+import { registerRpc } from './rpc.js';
+import { registerSkills } from './skill.js';
 export const name = 'dsh-adb';
 /** The tool registry is a hard dependency: every tool registers through it. */
 export const inject = ['tools'];
@@ -25,5 +27,10 @@ export function apply(ctx, config) {
     registerPerfTool(ctx, cfg);
     registerPerfBaselineTool(ctx, cfg, config.baselineDir ?? DEFAULT_BASELINE_DIR);
     registerCrashReportTool(ctx, cfg);
-    ctx.logger.info('[dsh-adb] loaded: adb_devices / adb_connect / adb_disconnect / adb_logcat / adb_install / adb_file / adb_perf_snapshot / adb_perf_baseline / adb_crash_report');
+    registerSkills(ctx);
+    // The RPC channel needs the client connection, which mounts after this
+    // plugin starts in web compositions; register lazily so headless profiles
+    // (no connection) stay unaffected.
+    ctx.inject(['connection'], (readyCtx) => registerRpc(readyCtx, cfg));
+    ctx.logger.info('[dsh-adb] loaded: 9 tools + web device panel rpc');
 }

package/lib/parsers/sysinfo.d.ts

@@ -0,0 +1,16 @@
+/** Pure parsers for device-system info (packages, getprop, processes, meminfo, wm). */
+export declare function parsePackageList(text: string): string[];
+export declare function parseGetprop(text: string): Record<string, string>;
+export interface ProcessEntry {
+    pid: string;
+    name: string;
+}
+/** Parse `ps -A` output (Android toybox: USER PID PPID VSZ RSS WCHAN ADDR S NAME). */
+export declare function parseProcessList(text: string): ProcessEntry[];
+/** Parse /proc/meminfo "MemTotal: 123456 kB" into KB. */
+export declare function parseMemTotal(text: string): number | undefined;
+/** Parse `wm size` -> "Physical size: 1080x2400". */
+export declare function parseWmSize(text: string): {
+    width: number;
+    height: number;
+} | undefined;

package/lib/parsers/sysinfo.js

@@ -0,0 +1,54 @@
+/** Pure parsers for device-system info (packages, getprop, processes, meminfo, wm). */
+export function parsePackageList(text) {
+    const names = [];
+    for (const rawLine of text.split(/\r?\n/)) {
+        const line = rawLine.trim();
+        if (!line.startsWith('package:'))
+            continue;
+        const name = line.slice('package:'.length);
+        if (name !== '')
+            names.push(name);
+    }
+    return names;
+}
+export function parseGetprop(text) {
+    const props = {};
+    for (const rawLine of text.split(/\r?\n/)) {
+        const match = /^\[([^\]]+)\]:\s*\[([^\]]*)\]$/.exec(rawLine.trim());
+        if (match === null)
+            continue;
+        props[match[1]] = match[2];
+    }
+    return props;
+}
+/** Parse `ps -A` output (Android toybox: USER PID PPID VSZ RSS WCHAN ADDR S NAME). */
+export function parseProcessList(text) {
+    const entries = [];
+    for (const rawLine of text.split(/\r?\n/)) {
+        const line = rawLine.trim();
+        if (line === '' || /^USER\s+PID/.test(line))
+            continue;
+        const parts = line.split(/\s+/);
+        // Android ps: index 1 = PID, last = NAME (comm may be in brackets)
+        if (parts.length < 2)
+            continue;
+        const pid = parts[1];
+        const name = parts[parts.length - 1];
+        if (pid !== undefined && name !== undefined && /^\d+$/.test(pid)) {
+            entries.push({ pid, name });
+        }
+    }
+    return entries;
+}
+/** Parse /proc/meminfo "MemTotal: 123456 kB" into KB. */
+export function parseMemTotal(text) {
+    const match = /^MemTotal:\s+(\d+)\s*kB/im.exec(text);
+    return match === null ? undefined : Number(match[1]);
+}
+/** Parse `wm size` -> "Physical size: 1080x2400". */
+export function parseWmSize(text) {
+    const match = /Physical size:\s+(\d+)x(\d+)/.exec(text);
+    if (match === null)
+        return undefined;
+    return { width: Number(match[1]), height: Number(match[2]) };
+}

package/lib/rpc.d.ts

@@ -0,0 +1,18 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { AdbConfig } from './adb.js';
+export type RpcEndpointResult = {
+    ok: true;
+    value: unknown;
+} | {
+    ok: false;
+    error: {
+        message: string;
+    };
+};
+export declare function handleRpcEndpoint(ctx: Context, cfg: AdbConfig, endpoint: string, raw: unknown, signal: AbortSignal): Promise<RpcEndpointResult>;
+/**
+ * Register the Package-private Client↔Host RPC for the Web device panel
+ * (conversation.view tab "设备"). Called lazily once the client connection
+ * mounts; headless compositions (no connection) stay unaffected.
+ */
+export declare function registerRpc(ctx: Context, cfg: AdbConfig): void;

package/lib/rpc.js

@@ -0,0 +1,142 @@
+import { readFileSync, unlinkSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { classifyFailure, runAdb } from './adb.js';
+import { parseDevices } from './parsers/devices.js';
+import { matchesKeyword, matchesLevel, parseLogcat } from './parsers/logcat.js';
+import { parseGetprop, parseMemTotal, parsePackageList, parseProcessList, parseWmSize, } from './parsers/sysinfo.js';
+import { capturePerfSnapshot } from './tools/perf.js';
+async function requireDevice(ctx, cfg, argv, options) {
+    const result = await runAdb(ctx, cfg, argv, { signal: options.signal, serial: options.serial, maxBytes: options.maxBytes });
+    if (result.exitCode !== 0)
+        throw classifyFailure(result);
+    return result.stdout;
+}
+function serialOf(payload) {
+    return typeof payload.serial === 'string' ? payload.serial : undefined;
+}
+export async function handleRpcEndpoint(ctx, cfg, endpoint, raw, signal) {
+    try {
+        const payload = (raw ?? {});
+        switch (endpoint) {
+            case 'listDevices': {
+                const stdout = await requireDevice(ctx, cfg, ['devices', '-l'], { signal });
+                return { ok: true, value: { server: 'ok', devices: parseDevices(stdout) } };
+            }
+            case 'listPackages': {
+                const stdout = await requireDevice(ctx, cfg, ['shell', 'pm', 'list', 'packages'], {
+                    signal,
+                    serial: serialOf(payload),
+                    maxBytes: 4 * 1024 * 1024,
+                });
+                return { ok: true, value: { packages: parsePackageList(stdout) } };
+            }
+            case 'deviceInfo': {
+                const serial = serialOf(payload);
+                const getprop = parseGetprop(await requireDevice(ctx, cfg, ['shell', 'getprop'], { signal, serial, maxBytes: 2 * 1024 * 1024 }));
+                const size = parseWmSize(await requireDevice(ctx, cfg, ['shell', 'wm', 'size'], { signal, serial }));
+                const memTotalKb = parseMemTotal(await requireDevice(ctx, cfg, ['shell', 'cat', '/proc/meminfo'], { signal, serial }));
+                return {
+                    ok: true,
+                    value: {
+                        model: getprop['ro.product.model'],
+                        manufacturer: getprop['ro.product.manufacturer'],
+                        release: getprop['ro.build.version.release'],
+                        sdk: getprop['ro.build.version.sdk'],
+                        resolution: size === undefined ? undefined : `${size.width}x${size.height}`,
+                        memTotalKb,
+                    },
+                };
+            }
+            case 'processList': {
+                const stdout = await requireDevice(ctx, cfg, ['shell', 'ps', '-A'], {
+                    signal,
+                    serial: serialOf(payload),
+                    maxBytes: 2 * 1024 * 1024,
+                });
+                let processes = parseProcessList(stdout);
+                const pkg = typeof payload.package === 'string' ? payload.package : undefined;
+                if (pkg !== undefined)
+                    processes = processes.filter((entry) => entry.name.includes(pkg));
+                processes = processes.slice(0, 100);
+                return { ok: true, value: { total: processes.length, processes } };
+            }
+            case 'logcatTail':
+            case 'logcatDelta': {
+                const serial = serialOf(payload);
+                const stdout = await requireDevice(ctx, cfg, ['logcat', '-v', 'threadtime', '-d'], {
+                    signal,
+                    serial,
+                    maxBytes: 8 * 1024 * 1024,
+                });
+                const since = typeof payload.since === 'string' ? payload.since : undefined;
+                const level = typeof payload.level === 'string' ? payload.level : undefined;
+                const keyword = typeof payload.keyword === 'string' ? payload.keyword : undefined;
+                const pid = typeof payload.pid === 'string' ? payload.pid : undefined;
+                const tail = typeof payload.tail === 'number' && payload.tail > 0 ? Math.floor(payload.tail) : 200;
+                let entries = parseLogcat(stdout);
+                // threadtime timestamps ("MM-DD HH:MM:SS.mmm") sort lexicographically.
+                if (since !== undefined)
+                    entries = entries.filter((entry) => entry.time > since);
+                if (level !== undefined)
+                    entries = entries.filter((entry) => matchesLevel(entry, level));
+                if (keyword !== undefined)
+                    entries = entries.filter((entry) => matchesKeyword(entry, keyword));
+                if (pid !== undefined)
+                    entries = entries.filter((entry) => entry.pid === pid);
+                const capped = entries.slice(-tail);
+                return { ok: true, value: { total: entries.length, truncated: entries.length > tail, entries: capped } };
+            }
+            case 'perfSnapshot': {
+                const pkg = typeof payload.package === 'string' ? payload.package : undefined;
+                if (pkg === undefined)
+                    throw new Error('perfSnapshot requires a string "package"');
+                const snapshot = await capturePerfSnapshot(ctx, cfg, signal, { package: pkg, serial: serialOf(payload) });
+                return { ok: true, value: snapshot };
+            }
+            case 'screenshot': {
+                const serial = serialOf(payload);
+                const devicePath = `/data/local/tmp/dsh-shot-${Date.now()}.png`;
+                const localPath = join(tmpdir(), `dsh-shot-${Date.now()}.png`);
+                try {
+                    await requireDevice(ctx, cfg, ['shell', 'screencap', '-p', devicePath], { signal, serial });
+                    await requireDevice(ctx, cfg, ['pull', devicePath, localPath], { signal, serial });
+                    const bytes = readFileSync(localPath);
+                    return { ok: true, value: { mime: 'image/png', bytes: bytes.length, dataUrl: `data:image/png;base64,${bytes.toString('base64')}` } };
+                }
+                finally {
+                    try {
+                        unlinkSync(localPath);
+                    }
+                    catch { /* temp cleanup is best-effort */ }
+                }
+            }
+            case 'perfSample': {
+                const pkg = typeof payload.package === 'string' ? payload.package : undefined;
+                if (pkg === undefined)
+                    throw new Error('perfSample requires a string "package"');
+                const snapshot = await capturePerfSnapshot(ctx, cfg, signal, { package: pkg, serial: serialOf(payload), metrics: ['meminfo', 'battery'] });
+                return { ok: true, value: { package: pkg, meminfo: snapshot.meminfo, battery: snapshot.battery } };
+            }
+            default:
+                return { ok: false, error: { message: `unknown endpoint: ${endpoint}` } };
+        }
+    }
+    catch (error) {
+        return { ok: false, error: { message: error instanceof Error ? error.message : String(error) } };
+    }
+}
+/**
+ * Register the Package-private Client↔Host RPC for the Web device panel
+ * (conversation.view tab "设备"). Called lazily once the client connection
+ * mounts; headless compositions (no connection) stay unaffected.
+ */
+export function registerRpc(ctx, cfg) {
+    const connection = ctx.get('connection');
+    const rpc = connection?.rpc;
+    if (rpc === undefined)
+        return;
+    ctx.effect(() => rpc.handle('/dsh-adb', (endpoint, raw, signal) => handleRpcEndpoint(ctx, cfg, endpoint, raw, signal), 
+    // Browser-only channel: accept requests from the loopback web GUI.
+    { authority: 'loopback' }));
+}

package/lib/skill.d.ts

@@ -0,0 +1,9 @@
+import type { Context } from '@deepseek-ai/cordis';
+/** Runtime skill: automated crash-scene collection + analysis for automotive/Android devices. */
+export declare const CRASH_ANALYSIS_SKILL: {
+    name: string;
+    description: string;
+    whenToUse: string;
+    content: string;
+};
+export declare function registerSkills(ctx: Context): void;

package/lib/skill.js

@@ -0,0 +1,40 @@
+/** Runtime skill: automated crash-scene collection + analysis for automotive/Android devices. */
+export const CRASH_ANALYSIS_SKILL = {
+    name: 'dsh-adb-crash-analysis',
+    description: '采集车机/安卓设备崩溃现场（crash buffer / dropbox / 进程 / 内存）并输出结构化分析报告',
+    whenToUse: '遇到车机应用崩溃、ANR、无响应，或需要系统性采集崩溃上下文做稳定性分析时',
+    content: `# 车机崩溃现场分析
+
+用 dsh-adb 采集崩溃现场并给出结构化结论。适合实车/台架联调与稳定性回归。
+
+## 流程
+
+1. **确认设备**：调用 \`adb_devices\` 拿到设备 serial；多设备时用 \`-s <serial>\` 显式指定。
+2. **采集崩溃现场**：调用 \`adb_crash_report\`（package 为目标应用，如 com.example.hmi），一次拿到：
+   - crashBuffer：logcat crash 缓冲区的结构化条目（AndroidRuntime 堆栈、native crash）
+   - dropbox：系统 dropbox 的崩溃条目摘录
+   - processes：当前进程状态摘录
+   - meminfo：目标应用内存摘要（PSS/堆）
+3. **定位主崩溃**：从 crashBuffer 里找 \`FATAL EXCEPTION\` 或 \`AndroidRuntime\` E 级条目；提取崩溃线程、异常类型（如 NullPointerException / RuntimeException / SIGSEGV）、首次出现时间与最后出现时间。
+4. **交叉验证**：
+   - 有堆栈 → 结合进程状态判断是否仍在运行/重启循环
+   - 内存异常（PSS 过高/持续增长）→ 用 \`adb_perf_snapshot\` 补充 meminfo/gfxinfo
+   - dropbox 有 \`SYSTEM_TOMBSTONE\`/ANR 条目 → 一并纳入
+5. **输出报告**（结构化）：
+   - 崩溃进程与包名、时间线（首现/末现）、异常类型与关键堆栈（截断到可读）
+   - 根因线索（代码位置、资源、并发、内存）与置信度
+   - 建议动作（修代码 / 加防护 / 复测方案）
+
+## 与定时任务组合（dsh-automation）
+
+在 dsh-automation 中建每日/每版本任务，prompt 指向本流程：
+「按 dsh-adb-crash-analysis 流程，对 <设备> 上 <包名> 采集崩溃现场并输出分析报告，保留可审计历史。」
+配合 \`adb_crash_report\` 的 since 参数可只采集指定时间窗口之后的崩溃。
+`,
+};
+export function registerSkills(ctx) {
+    const skills = ctx.get('skills');
+    if (skills === undefined)
+        return;
+    ctx.effect(() => skills.register(CRASH_ANALYSIS_SKILL));
+}

package/lib/tools/crash-report.js

@@ -96,7 +96,7 @@ export function registerCrashReportTool(ctx, cfg) {
                 if (args.package === undefined) {
                     throw new AdbError('ARGS_INVALID', 'meminfo section requires a package');
                 }
-                const snapshot = await capturePerfSnapshot(ctx, cfg, exec, {
+                const snapshot = await capturePerfSnapshot(ctx, cfg, exec.signal, {
                     package: args.package,
                     serial: args.serial,
                     metrics: ['meminfo'],

package/lib/tools/perf-baseline.js

@@ -62,7 +62,7 @@ export function registerPerfBaselineTool(ctx, cfg, baselineDir) {
                 throw new AdbError('ARGS_INVALID', `${args.command} requires a package`);
             }
             if (args.command === 'save') {
-                const snapshot = await capturePerfSnapshot(ctx, cfg, exec, {
+                const snapshot = await capturePerfSnapshot(ctx, cfg, exec.signal, {
                     package: args.package,
                     serial: args.serial,
                     metrics: args.metrics,
@@ -83,7 +83,7 @@ export function registerPerfBaselineTool(ctx, cfg, baselineDir) {
             if (baseline === undefined) {
                 throw new AdbError('BASELINE_NOT_FOUND', `no baseline for device ${device} package ${args.package}${args.id !== undefined ? ` (id ${args.id})` : ''}; save one with command=save first`);
             }
-            const current = await capturePerfSnapshot(ctx, cfg, exec, {
+            const current = await capturePerfSnapshot(ctx, cfg, exec.signal, {
                 package: args.package,
                 serial: args.serial,
                 metrics: args.metrics,

package/lib/tools/perf.d.ts

@@ -1,5 +1,4 @@
 import type { Context } from '@deepseek-ai/cordis';
-import type { ToolExecution } from '@deepseek-ai/dsh-tools';
 import { type AdbConfig } from '../adb.js';
 import { parseBattery, parseGfxinfo, parseMeminfo } from '../parsers/perf.js';
 export type PerfMetric = 'meminfo' | 'gfxinfo' | 'battery';
@@ -11,7 +10,7 @@ export interface PerfSnapshot {
     battery?: ReturnType<typeof parseBattery>;
 }
 /** Shared capture: dumpsys meminfo / gfxinfo / battery for one app. */
-export declare function capturePerfSnapshot(ctx: Context, cfg: AdbConfig, exec: ToolExecution, args: {
+export declare function capturePerfSnapshot(ctx: Context, cfg: AdbConfig, signal: AbortSignal, args: {
     package: string;
     serial?: string;
     metrics?: PerfMetric[];

package/lib/tools/perf.js

@@ -1,7 +1,7 @@
 import { classifyFailure, jsonOutput, runAdb } from '../adb.js';
 import { parseBattery, parseGfxinfo, parseMeminfo } from '../parsers/perf.js';
 /** Shared capture: dumpsys meminfo / gfxinfo / battery for one app. */
-export async function capturePerfSnapshot(ctx, cfg, exec, args) {
+export async function capturePerfSnapshot(ctx, cfg, signal, args) {
     const metrics = args.metrics ?? ['meminfo', 'gfxinfo', 'battery'];
     const result = { package: args.package, metrics: [...metrics] };
     for (const metric of metrics) {
@@ -10,7 +10,7 @@ export async function capturePerfSnapshot(ctx, cfg, exec, args) {
             ? ['shell', 'dumpsys', 'battery']
             : ['shell', 'dumpsys', metric, args.package];
         const output = await runAdb(ctx, cfg, argv, {
-            signal: exec.signal,
+            signal,
             serial: args.serial,
             maxBytes: 4 * 1024 * 1024,
         });
@@ -46,7 +46,7 @@ export function registerPerfTool(ctx, cfg) {
         },
         output: jsonOutput(),
         async execute(args, exec) {
-            return capturePerfSnapshot(ctx, cfg, exec, args);
+            return capturePerfSnapshot(ctx, cfg, exec.signal, args);
         },
     });
 }

package/package.json

@@ -1,11 +1,17 @@
 {
   "name": "dsh-adb",
-  "version": "0.2.0",
-  "description": "ADB device & bench operations for DeepSeek Harness: device discovery, structured logcat, apk install, file pull/push, performance snapshots, perf baselines, crash reports",
+  "version": "1.1.0",
+  "description": "ADB device & bench operations for DeepSeek Harness: device discovery, structured logcat, apk install, file pull/push, performance snapshots, perf baselines, crash reports, web device panel (autocomplete, live logcat, profiler)",
   "type": "module",
   "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./client.js",
+    "./package.json": "./package.json"
+  },
   "files": [
     "lib",
+    "client.js",
     "cordis.patch.yml"
   ],
   "keywords": [
@@ -21,6 +27,9 @@
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web"
     }
   },
   "scripts": {