安卓修改大师 · 智改工坊

现象 → 原因 → 动作：一页看完，自己就能修

装不上 · 连不上 · 币不足 · 找不到产物 · 反编译失败 · 窗口关不掉

先亮出这篇的主标语：出问题不可怕，怕的是不知道下一步点哪里。这张表就是把"下一步"写死的那张纸。

本文主角是安卓修改大师智改工坊：一款 Windows 桌面工具，把"改 APK"从技术活变成一句话——拖入安装包，用中文写需求，AI 改包，改完自动回编 / 对齐 / 签名 / 校验，一键装到手机或模拟器看效果。产品介绍页在 https://www.apkeditor.cn/ai-version.aspx，官网 www.apkeditor.cn。

这篇不讲方法论，只给一张表：左边是你在屏幕上看到的现象，中间是最可能的原因，右边是现在该做的动作。建议存成书签，出问题先扫一眼，再决定要不要翻日志。

一、这张表怎么用：先把"现象"说准

排障慢，往往慢在第一步：现象描述得太粗。"装不上"这三个字，背后至少三种不同的原因——签名冲突、改动越界、版本号没动；三条对应的动作完全不同，走错一条就白折腾半小时。所以用表之前，先把现象校准到能复述给同事听的程度。

三步校准法：① 谁出问题——手机还是模拟器？② 卡在哪一步——装上没装、起来没起来？③ 屏幕上原话是什么——提示冲突、找不到文件，还是干脆没反应？这三句写清楚，再往下查表，命中率会高很多。

还有个习惯值得养成：先看日志，再猜原因。程序把关键过程都写进了日志——诊断日志在 %LocalAppData%\ApkGallary\dock.log（吸附过程、打包过程），异常日志是 error.log，单个环节还有自己的现场记录（例如反编译失败给的是 apktool.log 路径）。有日志在手，下面的表只是"翻译"。

二、装不上、打不开：安装与启动类

三、连不上：设备与模拟器类

• 现象：设备列表里看不到手机。
  原因：手机没有授权 USB 调试。
  动作：按提示在手机上点「允许 USB 调试」，然后重新连接。
• 现象：模拟器开着，adb 里却没有它。
  原因：模拟器的 adb 端口没对上。
  动作：常见国内模拟器（雷电 / MuMu / 夜神等）装了但 adb 没连上时，程序会自动扫端口连上。
• 现象：模拟器装了，但根本没开。
  原因：只装了没启动。
  动作：程序会搜出它的安装路径，并问你要不要现在帮你打开。
• 现象：应用装上了，但没被拉起来。
  原因：启动页组件名没找到（同上）。
  动作：走三档查找；拉起用的是 am start（不是 monkey——新版安卓镜像已没有 monkey，且它失败时退出码还是 0，容易误判成功）。
• 现象：想在电脑大屏上验收。
  原因：手机小屏看不清图标、色差、启动页。
  动作：手机走 scrcpy 投屏到电脑；模拟器则把窗口提到最前面。
• 现象：两个窗口总是粘在一起。
  原因：双窗口磁吸默认是开启的。
  动作：在设置里调（两窗宽度合计占屏比例、间隙、启动是否吸附），或用命令行参数 --no-dock 只对本次运行生效。

四、改不动：反编译、AI 与打包类

• 现象：反编译失败。
  原因：工具链缺件，或这个包本身有特殊情况。
  动作：别慌——反编译失败不影响项目本身，配置、图标、源包已经落地；按提示的原因处理，日志路径是 apktool.log；先去参数设置跑工具链体检，缺件点「立刻更新」。
• 现象：点了「立刻修改」，半天没动静。
  原因：需求已送进右侧 AI 窗口，正在改。
  动作：需求原文与修改日期已写进 history.ini；AI 改完会在项目目录留一个标志文件 ai_done.flag，主窗口每 2 秒轮询一次，读到就自动弹打包窗口——盯一眼右侧窗口的输出。
• 现象：打包窗口关不掉。
  原因：这是故意的，避免你以为没在跑。
  动作：四步跑完（回编 → 对齐 → 签名 → 校验）它自己收尾，过程写进项目目录的 pack.log。
• 现象：找不到产物在哪。
  原因：不知道文件落到哪个目录。
  动作：项目目录的 build 下：unsigned.apk / aligned.apk / signed.apk；点「保存 APK」（默认名 应用名_版本号_signed.apk）或「打开所在文件夹」。
• 现象：不确定签名到底签上没有。
  原因：前三步只看退出码，看不出"签没签上"。
  动作：四步里专门多做了一步校验——apksigner verify 说了算。
• 现象：反编译很慢，像卡住了。
  原因：包大，或环境确实异常。
  动作：实测 12MB 的包反编译约 3 秒；超过 10 分钟会主动中断并报错，省得你白等一个假进度。
• 现象：想按上次那条再改一遍。
  原因：记不住当时的原话。
  动作：详情页历史里点「选择」把那条需求填回输入框；history.ini 里按"记录1、记录2"递增，删某一节就是删那条记录。

五、卡在账号与大师币上：登录、充值、权限类

• 现象：一导入 APK 就要求先登录。
  原因：导入 APK、编辑项目、充值都需要先登录。
  动作：登录窗口支持微信扫码 / QQ 扫码 / 账号密码，底部可以去注册与找回密码。
• 现象：大师币不足，以为全都干不了。
  原因：大师币只卡"用 AI 改"和"出包"这两个动作。
  动作：导入 APK、编辑项目不受影响，只有详情页点「立刻修改」和「去打包」时才提示充值——可以先把项目、附件、需求都准备好。
• 现象：充值付完了，界面没立刻变。
  原因：支付是在外部浏览器里完成的。
  动作：支付用外部浏览器打开支付宝 / 微信，程序每 3 秒轮询一次付款结果，稍等片刻即可。
• 现象：密码忘了，或想改密码。
  原因：账号信息需要自己维护。
  动作：登录窗口底部有找回密码；用户中心里能改密码，还能看项目数量、修改总次数、占用空间与所在磁盘剩余。
• 现象：磁盘空间紧张，想换地方放项目。
  原因：项目与产物都落在工作目录里。
  动作：到「参数设置」改工作目录；默认启动时按 D → E → F → G → C 挑第一个能读写且剩余空间 ≥1GB 的盘。

六、两个自家应用：照着表走一遍

表是死的，场景是活的。两个我们自己的例子，看"查表"省掉了什么。

七、用的人怎么说

八、把这张表贴在显示器边上

排障能力不是"记住所有原因"，而是知道去哪查下一步。这张表把"装不上"拆成三种原因，把"没反应"翻译成"去哪看日志"，把"不敢点"变成"点了会怎样"。三件事都做到，出问题就不再是事故，而是一道有答案的题。

呼应开头那句主标语：出问题不可怕，怕的是不知道下一步点哪里。把这篇存下来，下次屏幕上再冒出那句看不懂的提示，先扫一扫表，再回到安卓修改大师智改工坊里继续——拖入安装包、写一句中文需求，剩下的回编 / 对齐 / 签名 / 校验与装到设备，它自己会走完。产品介绍页：https://www.apkeditor.cn/ai-version.aspx；官网 www.apkeditor.cn。