dsh-adb 0.1.3 → 0.1.5

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 xiabing7
+Copyright (c) 2026 SamXiaBing
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -64,25 +64,19 @@ npm pack --dry-run     # 校验发布包内容（lib/ + cordis.patch.yml）
 
 注意：本机若设了 `NODE_ENV=production`，npm 会跳过 devDependencies，安装时用 `npm install --include=dev`。
 
-## 真机/台架冒烟（2026-08-14，SA_DIREWOLF_IVI 台架，Android 13）
+## 测试与验证
 
-headless profile 端到端验证（`dsh --profile bench "任务"`），**7 个工具全部实测通过**：
+- 原则：**提交即测** —— 全部已提交功能均有实测覆盖（单元 + headless 端到端 + 车机台架/真机）。
+- 验证设备：Android 13 车机台架 + Android 13 真机。
+- 版本化变更与每版验证记录见 [CHANGELOG.md](CHANGELOG.md)；测试方法与覆盖现状见 [docs/TESTING.md](docs/TESTING.md)。
 
-| 工具 | 实测结果 |
-| --- | --- |
-| `adb_devices` | ✅ 返回 `f20c9b04 device msmnile_gvmq_for_arm64` |
-| `adb_connect` / `adb_disconnect` | ✅ 不可达端点正确返回 CONNECT_FAILED；disconnect 正常 |
-| `adb_logcat`（前向） | ✅ level=E tail=5 返回真实错误日志 |
-| `adb_logcat`（后台采集） | ✅ job_output 读回 43065 行/7MB 流，job_kill 正常 |
-| `adb_install` | ✅ pull 真机 apk → `install -r` → "Performing Streamed Install / Success" |
-| `adb_file` | ✅ ls / push / pull 往返字节一致 |
-| `adb_perf_snapshot` | ✅ meminfo（SystemUI PSS 131MB）+ gfxinfo（232 帧/60.78% 卡顿）解析正确；battery 空（台架无电池服务） |
-
-配置覆盖（`adbPath`/`defaultSerial`）✅ · 错误码（`ADB_NOT_FOUND`/`CONNECT_FAILED`）✅
-
-> 冒烟发现并修复两个已发布 bug：
-> - **v0.1.0 → v0.1.1**：`ctx.tools.register` 未声明 `inject: ['tools']` 导致加载失败（Cordis Guard 拒绝未声明依赖）
-> - **v0.1.1 → v0.1.2**：后台 logcat 的 `readOutput` 返回 `{added,text}` 对象，违反 jobs 契约（须返回字符串）导致 `job_output` 报 `value.text must be a string`
+## 项目文档（供 AI 对话/协作者参考）
+
+- [docs/AGENTS.md](docs/AGENTS.md) — 进项目先读：定位、铁律、命令、环境事实、文档地图
+- [docs/REQUIREMENTS.md](docs/REQUIREMENTS.md) — 目的/范围/非目标/验收标准
+- [docs/TESTING.md](docs/TESTING.md) — 测试哲学（提交即测）、三层测试方法、E2E 步骤、回归清单
+- [docs/DEVELOPMENT-LOG.md](docs/DEVELOPMENT-LOG.md) — 进度时间线、4 个已修复 bug 教训、环境/生态经验
+- [PLAN.md](PLAN.md) — 里程碑与待办
 
 ## License
 

package/lib/tools/perf.js

@@ -24,7 +24,11 @@ export function registerPerfTool(ctx, cfg) {
             const metrics = args.metrics ?? ['meminfo', 'gfxinfo', 'battery'];
             const result = { package: args.package, metrics: [...metrics] };
             for (const metric of metrics) {
-                const output = await runAdb(ctx, cfg, ['shell', 'dumpsys', metric, args.package], {
+                // dumpsys battery is device-global and takes no package argument.
+                const argv = metric === 'battery'
+                    ? ['shell', 'dumpsys', 'battery']
+                    : ['shell', 'dumpsys', metric, args.package];
+                const output = await runAdb(ctx, cfg, argv, {
                     signal: exec.signal,
                     serial: args.serial,
                     maxBytes: 4 * 1024 * 1024,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-adb",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "ADB device & bench operations for DeepSeek Harness: device discovery, structured logcat, apk install, file pull/push, performance snapshots",
   "type": "module",
   "main": "lib/index.js",
@@ -17,7 +17,7 @@
     "bench"
   ],
   "license": "MIT",
-  "author": "xiabing7",
+  "author": "SamXiaBing",
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"