@bryce3310687963/android-toolkit 1.0.50 → 1.0.55

package/README.md

@@ -99,3 +99,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

@@ -1965,8 +1965,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({