给自家应用换一套视觉，常见的经过是这样：图标先给，AI 改一版；过两天想起启动页，再提一次；字体和色板又在第三、第四次补上。每提一次，AI 都要重新理解一遍项目，你也要重新检查一遍上一轮的改动。更糟的是，改到一半才发现某个文件是 0 字节，或者字体根本不含中文字形。

智能修改电脑版的附件系统，就是为这种场景准备的：一次可以多选多个文件，每个文件写清用途，系统先做可用性校验，再把“序号 + 路径 + 说明”随需求一起交给 AI。素材一次给全，需求一次说清，后面只剩回编、签名和验收。你不需要懂代码，也不需要记命令，照着流程走即可。

下面按八个步骤完整走一遍：准备素材清单、附件多选、给每个文件写用途、校验文件可用性、写需求四要素、等 AI 修改、回编与签名、装机验收。中间穿插两个自家应用的真实做法，一个是完整的品牌换肤，一个是内部工具换启动页加字体。最后还有一份可以直接照着打勾的验收清单。

先说环境：智能修改电脑版运行在 Windows 10 或 Windows 11 的 64 位系统上，需要 .NET Framework 4.6.2 或更高版本。准备一台用于验收的 Android 手机或模拟器，再准备一个装着四类素材的本地文件夹，就可以开始。本文所有示例都只针对自家应用或已获得明确授权的应用。

第一步：准备素材清单，四类文件先凑齐

附件系统再顺手，也救不了“素材本身不对”。在打开软件之前，先把图标、启动页、字体、色板四类文件放到同一个文件夹里，按 01、02、03、04 编号。编号不是形式主义：附件列表会按顺序拼成序号，编号一致，你在需求里说“附件 2”时就不会指错。

图标：一张主图，别把圆角焊死在图片里

桌面图标建议准备 1024×1024 的 PNG，透明背景，主体居中，四周留出约 10% 的安全边。不要提前把圆角、阴影、白底“做进图片”：不同厂商的桌面会用不同形状的遮罩，你焊死的圆角会被再裁一次，边缘就容易出现毛边。

如果应用使用自适应图标，画布是 108×108dp，真正可见的区域约 72×72dp，重要元素要放在直径约 66dp 的安全区内，否则被圆形、方形、水滴形遮罩裁掉一角是常事。这种情况最好同时给前景层和背景层两张图，并在用途里写清楚，而不是只给一张方图。

密度方面，Android 桌面图标常见五档：mdpi 48、hdpi 72、xhdpi 96、xxhdpi 144、xxxhdpi 192，单位是像素。你可以自己导出五档，也可以给一张 1024 的大图，让 AI 按现有目录结构补齐。软件用 aapt 解析图标时会取最高密度的原图，所以原图越清晰，最终效果越稳。这里有个容易误解的点：aapt 里的 65534 是“任意密度”的标记值，不是最高密度，别把它当成一张超高清图，也不要因为它而误判图标质量。

启动页：比例优先，内容其次

启动页最容易犯的错，是“拿一张好看的图直接塞进去”。先看原启动图或原背景的尺寸：常见的有 1080×1920（9:16）、1080×2340（约 9:19.5）。新图按原比例做，主体居中，上下留出可裁切的余量。比例不一致，到了长屏手机上要么被拉伸，要么上下出现大片留白。

如果原启动页是“纯色背景 + 居中 logo”的分层结构，最好给两张：一张背景色或背景图，一张透明底 logo。只给一张已经排好版的截图，AI 很难在不破坏版式的前提下适配不同屏幕。给分层素材，改起来余地更大，验收时也更容易判断问题出在背景还是主体。

还有一个边界要提前知道：Android 12 及以上，冷启动画面可能由系统启动画面接管，只替换一张图片未必能看到变化，往往还要同时调整主题里的窗口背景与图标。验收时要用目标系统版本的真机看，不要只在旧手机上确认。旧手机上通过、新手机上没变化，是启动页改造最常见的“假成功”。

字体：先看授权，再看字形

字体只收 ttf 或 otf，不要给字体安装包、网页字体包，或者从别处截的图。中文字体体积通常有几 MB 到十几 MB，如果只用于标题，可以做子集，只保留用到的字，减小包体。子集做完要实际打开界面检查生僻字和标点，不要只测“首页”两个字就交差。

替换前确认三件事：授权是否允许嵌入应用；字体是否覆盖界面里的全部汉字、标点和数字；原应用用的是哪个字体文件、在哪个目录。第三点最容易被忽略：Android 应用可能把字体放在资源字体目录，也可能放在 assets 里由代码加载，路径不同，替换方式也不同。你不需要自己找，但要在用途里说清“替换标题字体”，并把字体文件名写对。

尽量用静态字重的 ttf。可变字体在旧版本系统上兼容性不稳，标题可能出现字重不对，或者直接回退系统字体。字体效果不是“装上就完事”，还要看系统字体放大、加粗、深色模式下的表现，这些都会在验收阶段展开。

色板：给 HEX，也给语义

不要只说“改成蓝色”。准备一个 txt 或 md，一行一个颜色，写成“语义名 + HEX”，例如：主色 #1F6FEB、主色上的文字 #FFFFFF、页面背景 #F7F9FC、卡片背景 #FFFFFF、正文 #1F2937、次要文字 #6B7280、分割线 #E5E7EB、成功 #16A34A、警告 #D97706、错误 #DC2626。颜色有名字，AI 才知道哪个该用在哪里。

如果应用有深色模式，再给一套深色值。只给一套浅色，深色模式下很可能出现白底白字。色板文件本身就是附件之一，用途写“按文件内语义名替换全局颜色”，比在需求里堆十几个 HEX 更清楚，也方便你下次复用。

素材	推荐格式	关键规格	用途说明要点
应用主图标	PNG	1024×1024，透明底，主体居中，圆角不焊死	替换主图标与圆形图标，补齐各密度
自适应前景层	PNG	108×108dp 比例，透明底，主体在中心安全区	只换前景层，不动背景层与遮罩逻辑
启动页	PNG 或 JPG	与原图同比例，常见 1080×1920 或 1080×2340	冷启动第一屏，保持比例居中，不要拉伸
字体	TTF 或 OTF	静态字重，含中文字形，授权允许嵌入	只替换标题字体，保留原文件名
色板	TXT 或 MD	语义名 + HEX，浅色与深色各一套	按语义名替换全局颜色，不改图片内颜色
版式参考图	PNG 或 JPG	清晰、无遮挡、标注为参考	仅参考排版与间距，不把截图放进应用

打开软件前，逐项打勾：

• ☐ 四类文件在同一个本地文件夹，不在网盘占位，不在压缩包里
• ☐ 文件名以 01 到 04 开头，没有特殊符号
• ☐ 图标是透明底，圆角没有提前焊死
• ☐ 启动图比例与原图一致，主体居中
• ☐ 字体有嵌入授权，覆盖界面里的中文
• ☐ 色板写成“语义名 + HEX”，深色模式另有一套
• ☐ 应用是自家版权或已经获得授权

第二步：附件多选，一次交付而不是分四次

素材齐了，打开智能修改电脑版，把 APK 拖进主窗口。反编译完成后进入详情页，找到附件入口。点开文件选择框，按住 Ctrl 逐个点选，或者按住 Shift 选连续一段，把 01 到 04 一次选中。确认后，附件会以列表形式出现在需求区域旁边。

这里的核心原则只有一句：同一轮视觉改造，所有素材一次给完。不要“先给图标试一版，满意了再给启动页”。分四次提，等于让 AI 在四个不完整的上下文里做四次判断：第一轮不知道有品牌色，第二轮不知道字体已经换了，第三轮可能把上一轮的图标又改回去。最后你得到的不是一套视觉，而是四次互相对不上的修改。

一次多选，换来的是“互相参照”

图标、启动页、字体、色板不是四个孤立文件，它们要一起构成一个品牌印象。同一批附件进入同一条需求，AI 才有机会做一致性判断：启动页的背景色和色板主色是否接近，标题字体的气质和图标线条是否匹配，图标的主色有没有在按钮上复现。分批次给，这种参照关系就断了。

另外，附件列表会按顺序编号，和需求一起发出。一次给全，编号稳定，你在需求里写“附件 1 用于桌面图标、附件 4 用于全局色板”，指向明确；分多次给，编号每轮重排，旧需求里的“附件 2”到了新一轮可能变成另一张图，翻旧记录时很容易看错。

附件列表里，什么该放、什么不该放

内容	放不放	说明
新图标、启动图、字体、色板	放	每一件都写清用途，越具体越好
版式参考截图	有条件放	用途必须写“仅参考，不使用图片本身”
旧版界面截图	可放	用于对比改前改后，说明只做参照
他人的商业应用素材	不放	涉及版权，也超出本工具的使用范围
字体安装包、网页压缩包	不放	只给 ttf 或 otf，安装包里的字体不能直接用
需求文字、验收标准	不放	写进需求正文，附件只放素材

把“参考图”和“要用的素材”混在一起，是新手最常见的翻车点。AI 看到一张精美的参考截图，很可能把它当成启动页直接放进去，结果应用里出现一张带状态栏、带别人界面元素的截图。用途里写死“仅参考排版，不要使用图片本身”，能省掉一轮返工。

路径和文件状态，也会影响附件

附件记录的是文件路径，不是把文件复制进项目。选完之后，别移动、别改名、别把 U 盘拔掉，也别让网盘同步把本地文件变成“仅在线”。AI 开工时按路径去读，路径失效，轻则读不到，重则用到旧版本。素材不多时，这一点很容易被忽略，等到报错才想起来“刚才好像整理过文件夹”。

路径尽量短，避免特殊符号和过深的目录。比如把素材层层套在“2026 / 品牌 / 最终版 / 图标 / 改后 / 新”这样的目录里，不如统一放在 D:\brand\01-icon.png 这种短路径下。中文路径本身不是问题，但短路径能让排错简单很多，复制路径给同事时也不容易断行。

如果你同时改两个应用，给每个应用单独建素材文件夹。附件列表不会替你做项目隔离，文件名又都叫 01-icon.png 时，很容易把 A 应用的图标发给 B 应用。命名里带上应用缩写，比如 jz-icon.png、tools-splash.png，比纯数字更保险；编号仍然保留，方便排序。

多选前再确认一遍：

• ☐ APK 已成功导入并完成反编译
• ☐ 四类文件在同一个文件夹，编号连续
• ☐ 参考图与正式素材分开命名，参考图加 ref 前缀
• ☐ 文件不在网盘占位状态，也不在压缩包里
• ☐ 选完后不再移动、改名或删除

第三步：每个文件写用途，10 个字是底线

选完文件，真正决定 AI 理解程度的，是每个文件后面的用途说明。系统要求每个附件写不少于 10 个字；这不是故意刁难，而是在逼你把“这是什么、用在哪、怎么处理”说清楚。少于 10 个字，AI 只能猜：一张 png 可能是图标，也可能是启动图；一个 ttf 可能是标题字体，也可能是正文字体。猜错一次，就是一轮返工。

10 个字是底线，不是目标。实际写的时候，建议写到 15 到 30 个字，用一句话覆盖四件事：这是什么，用在哪里，怎么处理，有什么限制。四件事不一定要按顺序出现，但缺一件，说明就会留下模糊空间。

只写这几个字	为什么会出问题	改成这样写
图标	只有两个字，不知道替换哪一套图标	新版桌面图标，替换主图标和圆形图标，保留透明背景
启动页	不知道分辨率、比例和显示位置	冷启动第一屏背景，1080×1920，保持比例居中，不要拉伸
字体	不知道替换标题还是正文，也不知道文件名	品牌标题字体，只替换首页大标题使用的字体文件，保留原文件名
颜色	没有色值也没有用途，AI 只能按感觉猜	新色板文件，按文件内语义名替换主色、背景、正文与分割线
参考	很可能把参考截图直接放进应用	版式参考图，仅参考间距和留白，不要把截图放进应用
logo	不知道放哪一层，也不知道要不要透明底	自适应图标前景层，透明底，主体位于中心安全区

看第三列会发现，好的用途说明都有动词：替换、保留、居中、不要。动词是给 AI 的边界，形容词只是氛围。“高级一点”“大气一点”不是用途，AI 无法验证；“保留透明背景”“不要拉伸”才是可执行、可验收的要求。

一个文件一条说明，不要把四件事塞进一行

四个附件就应该有四条说明，各自对应。不要在第一行写“这四个文件分别是图标、启动页、字体和色板”，后面三行空着。附件和说明是一对一关系，一条说明对应一个路径，混在一起，AI 只能按顺序猜。猜对了是运气，猜错了就是又一轮返工。

如果一个文件承担多个用途，比如一张 logo 同时用于启动页和关于页，就在这一条里列全：“透明底 logo，用于冷启动页居中显示和关于页顶部，不要加白底”。不要为了省字拆成两条重复附件，也不要把两个不同文件写成同一条说明。说明和文件对不上，后面校验、打包、验收都会跟着乱。

色板文件里写什么

色板附件建议用 txt，内容一行一个语义名，等号左边写用途，右边写 HEX：

主色 primary = #1F6FEB
主色上的文字 on-primary = #FFFFFF
页面背景 background = #F7F9FC
卡片背景 surface = #FFFFFF
正文 text-primary = #1F2937
次要文字 text-secondary = #6B7280
分割线 divider = #E5E7EB
成功 success = #16A34A
警告 warning = #D97706
错误 error = #DC2626

用途说明写：“新色板清单，按文件内语义名替换全局颜色，深色模式另附深色值”。这样 AI 拿到的不只是十个 HEX，而是每个颜色的职责。只给一串没有名字的色值，它只能猜哪个是主色、哪个是背景、哪个是错误提示。

提交前，把每条说明读一遍，按下面几项自检：

• ☐ 每行不少于 10 个字，最好在 15 到 30 个字之间
• ☐ 有明确动词，比如替换、保留、居中、不要
• ☐ 写清了目标位置或目标文件
• ☐ 参考图注明“仅参考，不使用图片本身”
• ☐ 一个文件一条说明，没有把四个文件混成一句
• ☐ 色板说明指向文件内的语义名，而不是只报一个色值

第四步：附件校验，四关全过才算“可用”

附件加完、用途写完，点提交之前，系统会先做一轮校验。四个条件：文件存在、不是目录、不是 0 字节、可读。任何一条不过，这一轮就不会把附件发出去。校验发生在 AI 开工之前，目的是把“素材层面的错误”挡在“改包层面的返工”之前。

第一关：存在

你选文件时它还在，不等于提交时还在。常见情况：选完把文件从下载目录剪切到桌面；网盘同步把本地副本清掉；U 盘或移动硬盘被拔；临时目录被清理。校验在这一关失败，说明路径已经指不到文件。处理很简单：把文件放回固定位置，重新选择。不要试图在需求里写“如果找不到就去桌面找”，AI 不会替你搜盘。

第二关：不是目录

有些文件选择框允许你把整个文件夹选进来，或者拖拽时误拖了文件夹。文件夹没有内容可读，AI 拿到路径也打不开。看到这一关报错，展开路径看看最后一段是不是文件夹名，重新选里面的具体文件。素材文件夹套娃越深，越容易在这一关出错。

第三关：不是 0 字节

0 字节最隐蔽：文件图标正常、名字正常，打开却是空白。设计软件导出中断、网盘“仅在线”占位、复制过程被中断、脚本生成失败，都会留下 0 字节文件。字体 0 字节，打包时才会报错；图片 0 字节，AI 读图时才发现。与其到打包阶段再回头，不如在这一关拦住。

第四关：可读

文件存在、不是目录、也有大小，但仍然可能读不了：被设计软件独占打开、被同步工具锁定、权限不足、所在网络盘断开、路径过长。这一关失败，先把文件复制到本地普通目录，关闭占用它的程序，再重新添加。复制一份再选，通常比研究权限更快。

关卡	典型现象	处理办法
存在	路径指向的文件已被移动或删除	放回固定目录，重新选择
非目录	选中了文件夹，不是文件	展开文件夹，选里面的具体文件
非 0 字节	文件大小为 0，打开是空白	重新导出或重新下载，确认大小
可读	提示拒绝访问，或文件正被占用	关闭占用程序，复制到本地普通目录

校验失败时，系统会指出是哪一个文件、卡在哪一关。先修文件，再重新添加，不要抱着“先提交试试”的心态跳过。最坏的情况不是报错，而是错误被带进 AI 修改和打包，最后你面对一个装不上的包，却不知道问题出在哪张图。

素材的错，最好在素材阶段解决；到了打包阶段，同样的错会被放大成十倍的时间成本。

校验通过，不等于内容正确

附件校验做的是可用性检查，不是内容审查。它能告诉你文件在不在、是不是目录、是不是 0 字节、能不能读；它不能告诉你图标是不是最新版、字体有没有授权、启动图比例对不对。可用性和正确性是两件事，前者交给软件，后者交给你。

所以提交前的人工复核不能省：双击每张图，确认不是空白、不是错图；右键属性，看大小是否合理，图标通常几百 KB 到几 MB，字体通常几 MB 起；打开色板 txt，确认没有乱码；确认参考图没有被命名成 01-icon.png；确认四个文件都在本地盘，不在压缩包里。软件负责“读得到”，你负责“给得对”。

• ☐ 每张图都能正常打开，内容与文件名一致
• ☐ 字体文件大小正常，不是 0 字节或几 KB 的占位文件
• ☐ 色板 txt 是 UTF-8 编码，打开没有乱码
• ☐ 没有把参考图当成正式素材
• ☐ 没有把另一个应用的素材混进来

第五步：需求写四要素，AI 才不会猜

附件是“料”，需求是“做法”。料给全了，做法含糊，AI 仍然会按自己的理解发挥。把需求写成四段：目标、范围、素材、验收。这四段不需要文采，只需要具体；每段一两句话，就能把大部分歧义消掉。

目标：一句话说清最终样子

目标不是“美化一下”，而是“把自家记账应用换成新品牌视觉：图标、启动页、标题字体、全局色板四处统一”。一句话里包含对象、动作、范围。对象是自家记账应用，动作是换成新品牌视觉，范围是四处。目标越具体，AI 越不会扩展到无关页面，你也越容易判断这轮有没有做成。

范围：明确“只改什么”和“不改什么”

范围要写两边。只改视觉资源；不改包名、不改版本号、不改权限、不动网络请求、不动业务逻辑、不删除任何页面。为什么强调不改？因为改包最容易出问题的不是图标，而是顺手动了不该动的地方。你把边界写死，AI 就不会为了“让图标显示”去改启动组件，也不会为了“让颜色统一”去动业务代码。

范围里最好再补一句“保留原有功能与页面结构”。这句话看起来空，实际很有用：它告诉 AI，换视觉不是重做应用，原有入口、返回逻辑、登录态都要留在原位。验收时你也能据此判断，某个页面消失到底是视觉调整还是误删。

素材：把附件编号和用途再对齐一次

素材段不用重复每条用途的全部文字，但要建立映射：“附件 1 替换桌面图标与圆形图标；附件 2 替换冷启动背景；附件 3 只替换标题字体；附件 4 按语义名替换全局色板。”编号、文件名、用途三者对得上，AI 就不会拿错文件。写映射时用附件列表里的序号，不要用“第一张图”“那个蓝色的”这种描述。

验收：提前说好怎么算成功

验收要可观察：安装到哪台设备、哪个 Android 版本；桌面图标是否清晰、圆形遮罩下是否缺角；冷启动是否拉伸；标题有没有缺字；六个主要页面颜色是否一致；打包后 verify 是否通过。把这些写在需求里，AI 在改的时候就会朝这些点靠，而不是只改完就交差。验收写得越早，返工越少。

四要素可以直接套下面这个模板，把方括号里的内容换成自己的：

目标：为自家「应用名」完成[品牌换肤/启动页更新/字体替换]，只改视觉，不改业务。
范围：替换[图标/启动页/字体/色板]，不改包名、版本号、权限、网络请求与业务代码，保留原有页面结构。
素材：附件 1 用于[用途]；附件 2 用于[用途]；附件 3 用于[用途]；附件 4 用于[用途]。
验收：安装到[设备与系统版本]；[图标清晰/启动页不拉伸/标题无缺字/页面颜色一致]；打包后 verify 通过。

把模板填完，就是一条合格的需求。下面是一个完整例子：

目标：为自家“XX 记账”做品牌换肤，只改视觉，不改业务。

范围：替换桌面图标（含圆形与自适应前景层）、冷启动页、标题字体、全局色板；不改包名、版本号、权限、网络请求与业务代码，保留原有页面结构。

素材：附件 1 图标 1024×1024；附件 2 启动页 1080×1920；附件 3 标题字体 ttf；附件 4 色板 txt，按文件内语义名替换。

验收：安装到 Android 10 与 Android 16 各一台；桌面图标清晰、启动页不拉伸、标题无缺字、六个主要页面颜色一致；打包后 verify 通过。

这条需求没有一句“高级”“大气”，但每一句都能被执行、被检查。对 AI 来说，具体就是效率；对你来说，具体就是验收标准。你甚至可以把验收段原样复制到验收清单里，改完逐条打勾。

把模糊词换成可执行词

模糊说法	问题	可执行说法
弄得好看点	“好看”没有标准，无法验收	主色改为 #1F6FEB，卡片圆角 12dp，标题字号不变
换个图标	不知道换哪几套、要不要圆形	替换主图标与圆形图标，包含自适应前景层，按五档密度补齐
字体大一点	不知道大多少、大在哪里	首页大标题字号从 20sp 调到 24sp，正文与其他页面不动
启动页换掉	不知道用哪张、怎么适配屏幕	用附件 2 替换冷启动背景，保持 1080×1920 比例居中，不拉伸
颜色统一	不知道统一到哪个色、哪些控件	按钮、导航栏、链接统一用主色 #1F6FEB，正文用 #1F2937
参考这个	可能把参考图当成素材直接用	只参考附件 5 的排版间距，不要把截图放进应用

不会写？先用话术，再改三处

详情页内置了 3000 条话术，分 6 类、每类 500 条，覆盖界面美化、常规修改、插件添加等方向。点选一条会填进输入框，你再改三处：把应用名换成自己的、把附件编号对上、把验收标准补上。话术是起点，不是终点；直接原样提交，AI 只能按通用模板改，效果不会贴你的品牌。

一条需求只做一个主题。品牌换肤和改接口地址分开提。混在一起，AI 的注意力被分散，验收也说不清是哪一项没过。如果确实要一起做，也先完成视觉改造、验收通过，再提第二条。历史记录按原话保存，分开提也方便你以后回看每一步做了什么。

• ☐ 目标一句话，包含对象、动作、范围
• ☐ 范围写了“不改什么”，并保留原有页面结构
• ☐ 附件编号与用途一一对应
• ☐ 验收写到设备、页面和具体现象
• ☐ 没有“高级、大气、好看”这类无法验证的词
• ☐ 一条需求只做一个主题

第六步：AI 修改，等待、轮询与附件去向

点“立刻修改”，流程才真正开始。这一刻发生三件事：你的需求原文和日期写进项目的 history.ini；需求连同附件序号、路径、说明送进右侧 AI 工作区；AI 开始在 apktool 工程上改代码和资源。你不需要再做什么，也不需要在几个窗口之间来回切换。

AI 完成后，会在项目目录留一个 ai_done.flag。主窗口每 2 秒轮询一次，读到这个标记就删掉它，表示这一轮结束；等待上限是 1 小时。这个标记是一次性信号，读到即删，不要指望它长期留在目录里当完成记录。判断是否完成，看右侧工作区的状态和项目产物的时间，比盯着一个文件更可靠。

如果超过 1 小时还没结束，先看右侧工作区有没有报错，再看项目目录里的日志。不要连续重复点“立刻修改”：上一轮可能还在写文件，重复提交只会让状态更难判断。先确认是卡住了、失败了，还是只是包大、改得多。确认原因之后，再决定是等、是缩小需求，还是回滚重来。

附件不进 history，这是最容易踩的坑

history.ini 只保留你的需求原话和日期，不保存附件路径，也不保存每个文件的用途。这个设计很合理：历史是“你说了什么”，不是“你传了什么”。但对你来说，意味着两件事，必须提前知道。

第一，下次从历史里点“选择”回填，回填的只有文字。附件列表是空的，每条用途也没有。你必须重新选文件、重新写说明，否则 AI 会看到一条提到“附件 1、附件 2”却没有附件的需求。遇到这种情况，AI 可能按文字猜着改，结果和你预期差很远，你还以为是自己需求写错了。

第二，想把一次成功的改造复用到另一个应用，不能只靠历史。自己维护一个素材包：四类文件、一份用途说明 txt、一份需求模板。下次换应用，改文件名和包名，几分钟就能重新组织好。历史负责记话，素材包负责记料，两者分开管理。这样即使项目删了、软件重装了，你的交付方法还在。

等待期间，别动这些

• ☐ 不要移动、改名或删除附件
• ☐ 不要手动编辑 apktool 工程里的文件
• ☐ 不要在上一轮未结束时再点一次修改
• ☐ 如果后面要自动装机，保持手机连接、屏幕解锁
• ☐ 不要中途切换工作目录

反编译本身很快：12 MB 的包实测约 3 秒完成。真正耗时的是 AI 修改和回编。软件对反编译设置了 10 分钟上限，超过会中断并报错，不会无限卡住。包特别大时，先看 apktool.log 的最后几行，确认是资源太多，还是卡在某个文件。把日志的最后一段复制出来，比描述“它不动了”更有助于判断。

项目目录里有什么

每个项目在 Project 下有一个 8 位随机目录，里面有 config.ini、history.ini、source.apk、apktool 工程目录和 build 产物。config.ini 记录项目配置，history.ini 记录历史原话，source.apk 是原始包，它是你回滚的底牌，不要删。项目列表里可以查看历史、打开项目目录、删除项目；删除只允许删 Project 的直接子目录，这是为了避免误删工作目录外的东西。

日志分工：apktool.log 记反编译输出，pack.log 记打包全过程，error.log 记未处理异常，dock.log 记窗口吸附。出了问题先看对应日志的最后几十行，比反复试错快。比如回编报错看 apktool.log，签名失败看 pack.log，软件闪退看 error.log，窗口不吸附看 dock.log。

第七步：回编、对齐、签名、校验，四步一个都不能省

AI 改完，接下来是打包。智能修改电脑版把打包拆成四步，顺序固定：回编、对齐、签名、校验。四步都成功，才算一个可以安装的成品。界面上你可能只需要点一次，但每一步在做什么、失败时看哪里，值得弄清楚。

步骤	命令	作用	失败会怎样
回编	apktool b -f -o build\unsigned.apk	把工程重新编译成未签名 APK	资源引用错误、9-patch 损坏会在这里报错
对齐	zipalign -f -p 4	让未压缩数据按 4 字节边界对齐，让 .so 按页对齐	顺序错了会导致签名后校验失败或安装异常
签名	apksigner sign	写入 v1、v2、v3 签名，默认三档全开	密钥格式、别名或口令错误会失败
校验	apksigner verify --print-certs	验证签名并打印证书信息	确认“到底签没签上”，密钥格式问题只有这一步会明确报出

为什么对齐必须在签名之前

zipalign 会移动 APK 里的字节位置。v2 及以上签名是对整个 APK 文件做完整性校验，先签名再对齐，签名就对不上了。所以顺序只能是：回编、对齐、签名、校验。软件把这四步固定下来，你不需要记命令，但要知道每一步在做什么，失败时才能看懂日志。

对齐参数里的 4 表示 4 字节边界，-p 会让未压缩的 .so 库按页对齐，减少安装后加载出问题的概率。-f 表示覆盖已有输出。命令看起来短，但每一步都在改变产物，顺序错了，后面的 verify 就会用失败提醒你。

四种签名怎么选

默认签名适合内测和自用，装到自己的测试机上最省事；JKS、keystore 适合自家应用覆盖升级，前提是你手里有原来的签名文件和口令；PEM+PK8 适合已有密钥对、但格式不是 JKS 的团队；随机签名适合一次性的演示包，每次签名都不同。四种方式没有绝对好坏，只看你的交付场景。

覆盖安装有一个硬规则：新包签名必须和已安装版本一致，否则系统会拒绝升级。用默认或随机签名，先卸载旧版再装；卸载会清掉应用数据，自家应用里有本地账本、缓存、登录态的，先备份。用原 JKS 签名，就可以直接覆盖，用户数据也保得住，这也是自家应用升级最推荐的做法。

v1、v2、v3、v4 都支持，默认 v1+v2+v3。v1 照顾老系统，v2 是 Android 7 以后的主流校验，v3 支持密钥轮换。没有特殊要求，用默认组合即可。口令通过环境变量传入，不会拼进命令行，也不会写进日志；这是为了避免口令泄露，不要自己把口令写进脚本或截图里。

verify 这一步，别省

签名命令成功，不等于签得对。密钥格式错误、别名写错、证书链不完整，有些问题在签名阶段不会明确报错，到了 verify 才暴露。verify --print-certs 会打印证书主体、有效期和指纹，你能确认三件事：签名确实写进去了、证书是你以为的那一张、指纹和旧版本对得上。

如果是自家应用覆盖升级，把新包和旧包的证书指纹比一下，一致再装。不一致，说明你拿错了密钥，装上去要么升级失败，要么得卸载重装。多这一步 verify，看起来只多几秒，实际是在替你把“装不上”的风险提前拦下来。

pack.log 是打包的黑匣子

整个过程写进 pack.log：每一步的命令、输出、成功或失败。打包失败时，先打开它看最后一段。常见错误和处理如下：

现象	出问题的阶段	怎么处理
资源引用找不到	回编	检查替换是否删掉了原资源，回滚后缩小改动范围
9-patch 损坏	回编	换回原图，或重新导出正确的 .9.png
别名或口令错误	签名	核对 JKS 别名与口令，确认环境变量已设置
verify 失败	校验	检查证书链与密钥格式，重新对齐后再签名
安装时签名冲突	装机	卸载旧版，或改用原签名密钥重新打包

打包后自动装机

打包成功后，软件会自动走一遍装机：用 adb 找设备，安装 APK，再用 am start -W -n 包名/Activity 拉起。启动组件名有三档查找：先读 config.ini 里的 LaunchableActivity，找不到就用 cmd package resolve-activity --brief 解析，再不行走旧方式兜底。拉起后用 dumpsys 复核前台应用，确认真的到了你的应用，而不是停在桌面。

手机通过 scrcpy 投屏，模拟器会被提到最前。你可以在电脑上直接看启动页、图标和字体效果。自动装机失败时，先确认设备已授权调试、屏幕已解锁、包名没有被手动改过。如果手机上装的是旧签名版本，先卸载再让软件重装，否则会卡在签名冲突。

第八步：装机验收，按清单逐项打勾

装上去不等于改对了。验收要按四条线走：图标、启动页、字体、色板，再加一条功能回归。每一条都用“看什么、在哪看、什么算过”来描述，别用“感觉差不多”。验收表提前写，改完逐项勾，返工次数会明显下降。

图标：桌面、遮罩、任务切换都要看

桌面正常图标、圆形图标、自适应遮罩（方形、圆形、水滴形）各看一眼；再检查长按菜单、最近任务、设置里的应用列表、通知栏小图标。低密度设备看是否模糊，高密度设备看是否清晰，透明边缘有没有白底、黑边、被裁角。

图标是最容易被“换了个文件”骗过去的：文件名换了，桌面缓存没刷新，看到的还是旧图标。验收时先在系统设置里清桌面缓存，或者重启一次手机，再确认。换图标后桌面图标没变，先怀疑缓存，不要急着回滚。确认缓存已经清了还没变，再去看自适应前景层和圆形图标是不是漏了。

启动页：用冷启动，不用热启动

冷启动（先强行停止再打开）看第一屏，不要用热启动。长屏、宽屏各一台，看是否拉伸、留白、主体被裁。Android 12 及以上还要看系统启动画面是否覆盖了你的图。启动页到首页的过渡是否闪白、闪黑，也要在这一步一起看。

如果冷启动只闪一下系统图标就进首页，说明你的启动页没有被走到，可能是系统启动画面接管，也可能是原工程的启动页本来就很短。前者要调主题背景，后者属于正常节奏，不要为了“看清楚”强行加长启动时间，那会影响用户体感。启动页是门面，不是广告位，停留时间够用就好。

字体：中文、数字、标点一起测

标题、正文、按钮、弹窗、数字、标点都要看，中文生僻字、英文、货币符号也别漏。系统字体大小调到最大和最小，看是否截断；加粗、斜体是否正常回退；字体授权文件是否随项目归档。只测首页两个字，很容易漏掉缺字和行高问题。

“豆腐块”是字体替换最典型的失败：某个字没有字形，系统画一个方框。看到豆腐块，不要怪 AI，先确认字体本身覆盖不覆盖这个字。做子集时尤其要注意，界面里动态出现的用户昵称、地址、单位名称，往往不在你预先挑选的字表里。子集只适合字表固定的界面，动态内容多的应用，宁可多带一些字形。

色板：六个页面并排看

首页、列表、详情、弹窗、设置、登录六个页面并排看；按钮的默认、按下、禁用三态；状态栏、导航栏、分割线、输入框提示文字；深色模式如果支持，也要切过去看。图片里“焊死”的旧品牌色不会跟着色板变，需要重新导出图片。

颜色不一致最常见的来源不是色板没写，而是硬编码：代码里直接写了颜色值、图片里自带颜色、第三方 SDK 自绘控件。色板能覆盖资源里的语义颜色，覆盖不了所有角落。验收时把六个页面截图放在一起对比，比单页盯着看更容易发现漏网之鱼。发现漏色，先判断是资源色还是图片色，再决定补色板还是重做图。

功能回归：越简单越不能省

登录、核心业务操作、网络请求、返回栈、权限弹窗都走一遍；启动时间和包体大小也记录一下，换中文字体会明显增大包体。看系统日志或项目日志里有没有资源相关的异常。功能回归不需要很复杂，把日常最常用的三个操作走通，就能拦住大部分严重问题。

检查项	怎么看	不合格怎么办
图标模糊	高密度机桌面看边缘	补 xxxhdpi 原图，重新替换
圆形图标缺角	切圆形遮罩看主体	调整前景安全区，重做前景层
启动页拉伸	长屏冷启动看比例	按原比例重做，主体居中留裁切余量
标题缺字	翻到含生僻字的页面	换覆盖更全的字体，或重新做子集
颜色不一致	六个页面并排看	补色板语义，检查硬编码与图片内颜色
覆盖安装失败	安装时提示签名冲突	用原密钥重签，或卸载旧版并先备份
启动崩溃	看日志里的第一个异常	回滚 source.apk，缩小改动范围重来

至少两台设备：一台低版本（比如 Android 10），一台高版本（比如 Android 16）；一台低密度或中密度，一台高密度。条件允许再加一台平板，看启动页在大屏上的表现。只在一台手机上验收，漏掉的往往是密度和系统版本差异。设备不用多，覆盖两端就够用。

验收记录写下来：设备型号、Android 版本、检查项、通过或不通过、截图。团队交付时，这张表比“我这边没问题”有用得多。发现问题，先保留现场截图和日志，再回滚或修，不要一边改一边把证据覆盖掉。记录还有一个好处：下次改同类应用时，你知道哪些页面最容易漏。

回滚也要提前准备

每次改包前保留 source.apk 和上一版已签名 APK。新包不合格，先卸载新包，再装回旧包；签名不同不能直接覆盖，卸载前备份应用数据。source.apk 在项目目录里，别清理项目时一起删掉。回滚路径清楚，验收时才敢大胆检查，不会因为怕装不回去而放过问题。

验收不是看一眼桌面图标，而是把图标、启动页、字体、色板四条线各走一遍，再补一次功能回归。

两个实例：自家 App 品牌换肤与内部工具换启动页字体

下面两个例子都来自自家应用，一个是完整的品牌换肤，一个只换启动页和字体。每个例子按“以前、现在、验证”三段写，你可以对照自己的场景套。例子里的应用名做了泛化处理，素材和流程是真实的。

实例一：自家记账 App 做整套品牌换肤

背景：自家记账应用准备换新品牌，新 logo、新启动页、新标题字体、新色板一起上。应用是自有版权，签名密钥在自己手里，目标是覆盖升级，不丢本地数据。

以前：设计师给一张 1024 图标，剩下的活全在本地做：手动导出 mdpi 到 xxxhdpi 五档，分别改名覆盖；圆形图标另做一份；启动页按屏幕比例反复试，拉伸一次改一次；标题字体复制到资源目录，还要找到代码里引用字体的位置；色板散落在多个颜色文件和图片里，改完一个页面，另一个页面还是旧蓝。每改一轮，回编、签名、装机，来回好几轮，最后还要逐页对颜色。

现在：把四个文件放进 D:\brand\，编号 01-icon.png、02-splash.png、03-title.ttf、04-palette.txt。打开智能修改电脑版，拖入 APK，等反编译完成；在详情页一次多选四个附件；每条用途写到 20 字以上：

• 附件 1：新版桌面图标，替换主图标与圆形图标，保留透明背景，含自适应前景层
• 附件 2：冷启动背景，1080×1920，保持比例居中，上下留裁切余量
• 附件 3：品牌标题字体，只替换首页大标题字体文件，保留原文件名
• 附件 4：全局色板，按文件内语义名替换主色、背景、正文、分割线与状态栏

需求按四要素写：目标是一套品牌视觉统一；范围是只改视觉资源，不改包名、版本号、权限和业务逻辑；素材对应四个附件；验收是 Android 10 与 Android 16 各一台，图标清晰、启动页不拉伸、标题不缺字、六个页面颜色一致、verify 通过。点“立刻修改”，等右侧工作区完成，再打包。

验证：

• 桌面正常图标与圆形图标都换成了新 logo，圆形遮罩下主体完整
• 冷启动第一屏比例正确，长屏没有拉伸，启动页到首页没有闪白
• 首页大标题使用新字体，中文、数字、标点都正常，系统字体调大后没有截断
• 首页、列表、详情、弹窗、设置、登录六页主色一致，按钮禁用态没有变成旧色
• 覆盖安装成功，说明签名与旧版一致；verify 打印的证书指纹与旧包一致
• 登录、记账、导出账单三个核心操作正常

这次和以前最大的差别，不是某一步变快了，而是四个文件在同一轮里互相参照：启动页背景和色板主色一致，标题字体和图标线条风格接近，不会出现“图标换了、启动页还是旧品牌”的半成品。一次交付带来的是一致性，不只是省事。

实例二：自家内部工具换启动页和标题字体

背景：内部工具有一个旧版启动页和系统默认字体，想统一成部门的新视觉，但不改任何业务逻辑和接口地址。只给两个附件：启动图、标题字体。

以前：先在资源目录里翻启动图，找到一张和当前屏幕比例不一致的图，替换后在大屏手机上被拉伸；字体复制进 assets，还要找到代码里加载字体的位置，改完回编，装到两台测试机，一台正常一台回退系统字体，再回头查原因。整个流程要懂资源目录和代码引用，对非开发同事不友好。

现在：准备 02-splash.png（1080×2340，和原图同比例）和 03-title.ttf（有授权、含中文、静态字重）。附件用途分别写：“冷启动背景，保持 1080×2340 比例居中，不要拉伸”；“标题字体，只替换工具首页标题使用的字体，保留原文件名”。需求里明确：只改启动页与标题字体，不动业务逻辑、接口地址、权限和包名；验收是 Android 10 与 Android 16 各一台，冷启动不拉伸、标题无缺字、核心查询功能正常。

验证：

• Android 10 与 Android 16 冷启动都不拉伸，主体居中
• 首页标题字体生效，中文与数字正常，没有豆腐块
• 系统字体调到最大，标题没有截断，按钮文字没有溢出
• 内部查询、提交、导出三个功能正常，接口地址没有被改动
• verify 通过，签名指纹与上一版一致，同事可以覆盖安装

两个例子的共同点：附件数量不多，但每个都有明确用途；需求范围写死了“不改什么”；验收提前写进需求，改完按表打勾。素材一次给全，不是让你一次给很多，而是让同一轮里的文件互相说得上话。第二个例子只给两个文件，同样成立，因为这两个文件就是这一轮的全部素材。

用户评价与合规提醒

下面是几位用户在使用附件系统后的反馈，场景不同，共同点是“一次说清”带来的确定性。评价为个人使用体验，效果会因项目、素材和设备而异。

“以前给自家 App 换一套视觉，图标、启动页、字体、颜色分四次提，AI 每次都要重新理解。现在四个文件一次附上，每个写清用途，一轮就对齐了。”

—— 阿澄 · 独立开发者

“我最怕客户临时加一张启动图。附件校验会先把 0 字节和打不开的文件挡下来，省得打包到一半才发现。”

—— 老周 · 外包团队视觉

“色板我直接写成 txt，主色、背景、文字色一行一个，再在用途里说明用在哪。改完六个页面颜色是统一的，不用逐页盯。”

—— 米粒 · 电商运营

“内部工具只换启动页和标题字体，需求里写死‘不动业务逻辑’，交付后 verify 和装机检查都过了，给同事装也没出岔子。”

—— 陈工 · 企业内部 IT

“第一次用不知道用途说明怎么写，照着‘这是什么、用在哪、怎么处理、有什么限制’四段式写，十个字很快就够了。”

—— 小北 · 设计专业学生

素材一次给全，需求一次说清，验收一次走完，这三件事做到，改包就从“反复试”变成“按流程交付”。安卓修改大师智改工坊会继续把这类手把手流程写清楚。只需说话，就能让应用变成你想要的样子。

了解更多：智能修改电脑版介绍与下载，官网 www.apkeditor.cn。