先把主标语放在首屏：拖进去的是一个安装包，留下来的是一条查得下去的线索链——每份文件都只回答一个问题。项目目录不是程序的"缓存角落"，而是你随时能翻、能对照、能复盘的工作台面。

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

一、为什么先讲目录：每个疑问都对应一份文件

用工具改包的人，疑问往往集中在几句：上次改成什么了？原始版长什么样？为什么这版装不上？这些问题看着都要"回头重想一遍"，其实每一句都有对应的文件可以直接回答。

• "上次改了什么"——history.ini 按记录 1、记录 2 递增存着需求原文，详情页也直接列出，最新在最上。
• "原始版什么样"——导入时自动拷的 source.apk 就在项目目录里，它不参与修改，是永远可回头的参照物。
• "为什么装不上"——pack.log 记录打包全过程；反编译阶段就没过的话，程序会把原因与 apktool.log 路径一起给你。

二、目录从哪来：自动挑盘、tools 与 Project

程序启动时自动挑盘：按 D → E → F → G → C 的顺序，取第一个能读写、剩余空间不小于 1GB 的盘，拼成 <盘符>:\AiApkEditor 作为工作目录。下面固定两个子目录：tools（java、aapt、apktool、7z、zipalign、apksigner 等，自动递归搜索，不用登记路径）与 Project（所有项目的家）。签名密钥 testkey.pk8 与 testkey.x509.pem 放在工作目录根目录，位置固定，也可以替换成你自己的。

每个项目一个 8 位随机字符串目录：导入时建目录、自动写 config.ini、拷一份 source.apk 进去，反编译输出放进 apktool 目录。用随机串而不是应用名当目录名，是为了不重名、不怕中文路径、不怕同一个应用导入两次互相覆盖；认项目请在项目列表里认，那里显示的是解析出来的应用名和图标。

两个细节值得先记住：解析与反编译跑在后台线程，界面不卡，实测 12MB 的包反编译约 3 秒，超过 10 分钟会中断并报错；反编译失败不影响项目本身，配置、图标、源包已经落地，程序提示原因并给出 apktool.log 路径。

三、总览：每个位置各管什么

这张表回答同一个问题的不同变体：我现在要做什么，该看哪份文件。

四、config.ini 与 source.apk：项目的两个底座

导入之后，程序用工作目录里的 aapt 解析出图标、应用名、包名、版本号、最低与目标 SDK、启动页，结果写进 config.ini 并显示在详情页。它至少有三个用处：

• 核对"改的是不是这个包"。手上有好几个相似版本时，看一眼包名和版本号，比翻文件夹快。
• 给拉起应用提供启动页组件名。打包后自动运行时组件名分三档查找：先读 config.ini 的 LaunchableActivity → 再问设备 resolve-activity → 最后才退回 monkey。
• 确认图标对不对。图标是从包里取出的原图按最高密度挑选——aapt 报的 65534 是"任意密度"哨兵值，不会挑到小图。

source.apk 的价值在于"不动"：AI 改的是 apktool 目录里的工程，回编产物进 build 目录，它从头到尾不参与。改坏了拿它当基准重新来过；想把改前改后摆在一起看，只需比这两个位置。

五、history.ini 与 apktool 目录：改了什么、改在哪

点「立刻修改」的那一刻，需求原文与修改日期写进 history.ini，按记录 1、记录 2 递增。这个文件有三个特性：

• 只留用户原话。附件的用途说明不进历史，历史里就是你当初写的那段话。
• 删一节即删一条。哪条记录不要了，把对应那一节删掉即可。
• 入口不止一个。详情页直接列出修改历史（最新在最上），每条显示 #序号 + 时间 + 需求原文，完整显示不截断；右侧「选择」能把那条需求填回输入框；项目列表每条的「历史」按钮打开独立历史窗口。

反编译输出落在项目里的 apktool 目录，smali 与资源都在这棵树里——AI 改的就是它。想自己补一处细节，你知道去哪儿改；想知道"AI 到底改了哪几个文件"，把它和 source.apk 解出来的版本对照即可。

六、build 产物与 pack.log：四步出包的现场

打包是四个固定动作连成的一条线：回编（apktool b）→ 对齐（zipalign -p 4）→ 签名（apksigner + testkey）→ 校验（apksigner verify）。前三步只看退出码，而"到底签没签上"要第四步 verify 说了算——多跑一步只花几秒钟，换来的是"确认成功"而不是"看起来成功"。

• build\unsigned.apk：回编完成就有，用来确认"编出来了"、排查回编本身的问题。
• build\aligned.apk：对齐完成，用来确认这一步确实执行了。
• build\signed.apk：签名并 verify 通过，这就是要装的那一份；「保存 APK」默认名 应用名_版本号_signed.apk。
• pack.log：全过程记录，装机失败时靠它复盘哪一步、什么输出。

三份产物都留着、不清理，是刻意的：中间产物在排错时比最终产物更有用。如果 signed 装上后异常、而问题在回编阶段就已埋下，把最终包翻来覆去看也没用，逐层往回比却能很快定位。另外，打包过程中窗口不给关——这条链是串行的，中途关掉前面几步就白等；跑完可以「保存 APK」或「打开所在文件夹」。

七、两个自家应用实例：目录在工作里怎么被用到

实例一：自家记账 App 换图标，靠 source.apk 回头

以前怎么做：团队自研的记账 App「青禾记账」换新 logo，手动流程是把包解开，在 res 下一堆密度目录里翻图标、替换、回编、对齐、签名，再装到手机上。麻烦出在两处：密度目录挑错，桌面图标发虚，而要装到手机上才看得出来；改错了想回头，只能重新找一份原始包——很多人的原始包早就不知道存哪儿了。

现在一句话怎么做：拖入包，等后台解析与反编译完成，输入框写"把应用图标替换成附件里的新 logo，其它不动"，点「选择附件」传图并写明用途（说明不少于 10 个字才会被校验放行），点「立刻修改」。AI 改完留下 ai_done.flag，主窗口 2 秒内轮询到就自动弹打包窗口。

改完怎么验证：看设备——自动装到手机或模拟器并拉起，桌面图标当场能看到；看目录——source.apk 始终是原版，改前改后可随时并排对照；再看 build\signed.apk 与 pack.log，确认这一版确实是这条链路出来的。

实例二：内部巡检 App 改启动页，事后答得出"哪一次"

以前怎么做：团队自研的门店巡检 App「巡店通」换季要换启动页背景。改图只是开头，费劲的是事后追账：同事拿着一个包来问"这是哪一版、谁改的"，只能靠文件名和记忆猜。

现在一句话怎么做：项目导入一次就一直在，需求写"把启动页背景换成附件里的新图，保持原比例不拉伸，其它界面不动"，点「立刻修改」。这条原文与修改日期进 history.ini，详情页历史列表带着 #序号与时间完整显示，右侧「选择」还能一键填回输入框重跑一遍。

改完怎么验证：装到设备上冷启动两次看画面；要回答"哪一次"时，history.ini 给出需求原文与时间，pack.log 给出出包过程，而包内 res/values/styles.xml 里那个 name="info" 的样式写着出包时间、登录账号、机器码、机器名、系统用户名、程序版本、应用名、包名等编码后的标记——包自己就是一份身份说明。

八、场景速查、用户评价与合规提醒

把全文压成一句"遇到事翻哪页"：记不清需求翻 history.ini；要核对包名版本翻 config.ini；改坏了回 source.apk；装机失败看 pack.log 与 build 三份产物；改了没弹打包窗口，先查历史里有没有这条需求、再看 ai_done.flag；反编译失败看 apktool.log，再顺手在「参数设置」页跑一次工具链体检。另外，吸附与打包过程的诊断日志在 %LocalAppData%\ApkGallary\dock.log，异常日志是 error.log；项目列表的删除有防呆，只允许删 Project 的直接子目录。

一份内部反馈汇总也能说明大家在意什么：把"能查得到"排第一的人最多，其次是"不用记路径"，再次是"出包后能当场看到效果"——三项正好对上本文讲的目录、工具链与设备预览三块。这只是主观感受的汇总，不构成效果承诺。

回到开头那句主标语：拖进去的是一个安装包，留下来的是一条查得下去的线索链——每份文件都只回答一个问题。它不指望你记住流程，而是在你需要回头的时候，让每一步都有据可查。产品是安卓修改大师智改工坊，介绍页：https://www.apkeditor.cn/ai-version.aspx；官网 www.apkeditor.cn。