@bryce3310687963/android-toolkit 1.0.51 → 1.0.56

package/README.md

@@ -82,6 +82,12 @@ Excluded:
 
 ## Clear App Cache
 
+`Device.writeCacheFile(ctx, { dirName, fileName, text })` writes text directly to
+`/data/data/<package>/cache/<dirName>/<fileName>` with root, sets app ownership,
+and returns the device path. Its ADB command arguments and raw command errors
+are redacted, including retries, so file contents do not enter logs or error
+reports. Callers that stage credentials must remove the temporary files after use.
+
 `Device.clearAppCache(ctx, packageName = ctx.packageName)` requires root ADB access.
 Stop the app before clearing its cache, then launch it again:
 
@@ -99,3 +105,24 @@ WebView cookies, and login data are outside the cleanup scope. Missing cache
 directories are skipped; invalid package names and cleanup errors fail the call.
 Each actor chooses whether to call this method; `Launch.run` does not clear caches
 automatically.
+
+## Reset Rebuildable App Databases
+
+`DeviceSQLite.reset(ctx, { dbNamePrefix })` requires root ADB access and a stopped
+app. It removes regular files beginning with the explicitly supplied prefix from
+`/data/data/<package>/databases`, including their WAL, SHM, and journal files.
+The app recreates those databases when launched. This resets entire matching
+databases, not individual table rows; use it only for databases the app can rebuild.
+Other databases, preferences, files, and login configuration are preserved.
+Missing databases are skipped. Invalid targets, symbolic links, unexpected
+directories, and deletion errors fail the call.
+
+```js
+await Device.forceStopApp(ctx);
+await Device.clearAppCache(ctx);
+await DeviceSQLite.reset(ctx, { dbNamePrefix: 'chat_database_' });
+await Device.startLauncher(ctx);
+```
+
+Database prefixes belong in actor code. Local resets do not delete cloud history;
+the app may download old conversations again after launching.

package/dist/index.cjs

@@ -912,9 +912,16 @@ async function adbExec(ctx, args, options = {}) {
   const startedAt = Date.now();
   try {
     const { stdout } = await execAdbWithRetry(adbPath, args, options);
-    Logger.useTemplate().adbExec({ duration: Logger.duration(startedAt), args: compactArgs(args) });
+    Logger.useTemplate().adbExec({ duration: Logger.duration(startedAt), args: options.sensitive ? "[REDACTED]" : compactArgs(args) });
     return stdout;
   } catch (error) {
+    if (options.sensitive) {
+      throw new CrawlerError({
+        message: "ADB command failed (sensitive content omitted)",
+        code: isAdbUnavailableError(error) ? Code.AdbUnavailable : Code.AutomationFailed,
+        context: { adbPath }
+      });
+    }
     if (isAdbUnavailableError(error)) {
       throw new CrawlerError({
         message: `adb_unavailable: ${error?.message || String(error)}`,
@@ -943,7 +950,8 @@ async function writeCacheFile(ctx, options = {}) {
   ].join(" && ");
   await Device.adbShell(ctx, [`su -c ${shellQuoteForRemote(command)}`], {
     timeoutMs: Number(options.timeoutMs || 1e4),
-    maxBuffer: Number(options.maxBuffer || 1024)
+    maxBuffer: Number(options.maxBuffer || 1024),
+    sensitive: true
   });
   return filePath;
 }
@@ -1267,8 +1275,8 @@ async function execAdbWithRetry(adbPath, args, options = {}) {
         label: options.label || "adb",
         attempt,
         attempts,
-        args: compactArgs(args),
-        message: error?.message || String(error)
+        args: options.sensitive ? "[REDACTED]" : compactArgs(args),
+        message: options.sensitive ? "sensitive ADB command failed" : error?.message || String(error)
       });
       await sleep(delayMs * attempt);
     }
@@ -1965,8 +1973,32 @@ var import_node_util2 = require("node:util");
 var execFileAsync2 = (0, import_node_util2.promisify)(import_node_child_process2.execFile);
 var DeviceSQLite = {
   query,
-  health
+  health,
+  reset
 };
+async function reset(ctx, options = {}) {
+  const packageName = requireNonEmpty2(ctx?.packageName, "packageName");
+  const dbNamePrefix = requireNonEmpty2(options.dbNamePrefix, "dbNamePrefix");
+  if (!/^[A-Za-z_]\w*(?:\.[A-Za-z_]\w*)+$/.test(packageName) || !/^[A-Za-z_][A-Za-z0-9_.-]*$/.test(dbNamePrefix)) {
+    throw new CrawlerError({ message: "invalid_request: invalid database reset target", code: Code.InvalidRequest });
+  }
+  const command = [
+    "set -e",
+    `db_dir=${shellQuote(`/data/data/${packageName}/databases`)}`,
+    'if [ -L "$db_dir" ]; then echo "refusing symlink database directory" >&2; exit 1; fi',
+    'if [ ! -d "$db_dir" ]; then exit 0; fi',
+    `for db_file in "$db_dir"/${shellQuote(dbNamePrefix)}*; do`,
+    '  [ -e "$db_file" ] || [ -L "$db_file" ] || continue',
+    '  if [ -L "$db_file" ] || [ ! -f "$db_file" ]; then echo "refusing unexpected database entry: $db_file" >&2; exit 1; fi',
+    "done",
+    // 主库和 WAL/SHM/journal 一起删除，避免旧日志在重建时恢复聊天记录。
+    `rm -f -- "$db_dir"/${shellQuote(dbNamePrefix)}*`
+  ].join("\n");
+  await adbSuShell(ctx, command, { timeoutMs: 3e4, maxBuffer: 4096 }).catch((error) => {
+    throw CrawlerError.from(error, { code: Code.AutomationFailed, context: { packageName, dbNamePrefix } });
+  });
+  Logger.info("DeviceSQLite.reset", { packageName, dbNamePrefix });
+}
 async function query(ctx, options = {}) {
   if (!options.sql) {
     throw new CrawlerError({