先把主标语放在最前面：附件说明不是随手写的备注，是给 AI 的施工图——写清用途，它才知道这张图该放到哪里。很多人第一次用附件功能，习惯在说明栏里敲两个字「图标」就提交，然后纳闷结果为什么不对；问题不在 AI，而在这两个字没把该说的话说完。

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

一、附件说明会被拼进需求里：它到底写给谁看

先把这条链路看清楚。点「选择附件」，可以一次挑多个文件，每挑一个，都要顺带给它写一句「它是干什么用的」。这些文件和你写的说明最后会合成一份清单——「序号. 文件路径 —— 用途说明」——跟着你的需求一起发给 AI。也就是说，说明栏里那句话不是给人看的备注，而是 AI 做判断时会读到的上下文，和你的需求原文是一个待遇。

提交前的校验只有两条，但每一条都在拦真实事故。第一条看文件本身能不能用：存在、不是目录、不是 0 字节、能读出来；第二条看说明是否不少于 10 个字。前一条拦的是「占位文件」「导出失败的空文件」「不小心拖进来的文件夹」这类素材事故；后一条拦的是更常见的一类——写了等于没写。

10 个字这个位置其实很微妙：它短到不构成负担，又刚好长到逼你把一句话说完。低于 10 个字，通常连「这是什么 + 用在哪」都装不下；而当你真的开始把话说完整，多数人自然会写到二十几个字、三十个字。所以门槛是防呆线，不是合格线——过了线只说明你不是在敷衍，离「AI 能照着放对位置」还有一段路。

二、一句合格的说明，至少要装下四件事

把附件说明当成一封给施工队的纸条，四件事缺一不可：这是什么、用在哪、覆盖什么范围、怎么算改对了。四件事未必需要四句话，但不能有意无意地漏掉其中任何一件——漏掉的那一件，AI 只能靠猜，而猜错就是一次返工。

第一件「这是什么」，说的是文件身份与版本。是图标还是背景图，是这一季的新版本还是上一季的旧文件，一句话点明，能避免拿错素材。第二件「用在哪」，是整个说明里最关键的一句：桌面图标、启动页背景、引导页某一屏、首页横幅，位置不同，处理方式完全不同，AI 需要你把落点写出来。

第三件「覆盖什么范围」是边界。哪些要点要一起换成这套图、哪些地方保持原样，属于「不许动」的范围，最好也写出来。第四件「怎么算改对了」是验收口径：看哪个界面、点哪里、看到什么算成功。写清这一句，改完你自己验证时也是照着它走。

三、三组对照：从「换图标」到能被执行的说明

下面三组对照，左边那种写法你一定眼熟。它们的共同点不是字数少，而是没有提供任何可以据以行动的信息——AI 只能按最常见的理解硬猜，猜对是运气，猜错是常态。

注意第二行的写法：一句「第 2 屏」省掉的不只是返工，还有返工过程中最贵的两样东西——来回确认的时间和「到底改了没有」的扯皮。说明里每补一个限定词，验证时就少一次「这算不算改对了」的犹豫。

对照表里的三行其实是同一件事的三种表现：把落点写具体。落点写具体还有个附带好处——它同时约束了你自己。当你必须在说明里写出「第 2 屏」的时候，你已经在脑子里把素材过了一遍，这一步预演往往能提前发现拿错了文件、或者图根本不是这一版。

四、两个自家应用的实例：说明怎么写，效果怎么验

下面两个例子都发生在自家应用上：一个是给自家门店巡检 App 换冬季版图标与启动页，一个是给自家内部培训 App 换引导页素材。重点看三个环节——以前怎么做、现在一句话怎么做、改完怎么验证。

实例一：自家「门店巡检」App 的冬季版图标与启动页

以前怎么做：换图标是个体力活。要先找到反编译目录里的一排 mipmap 密度文件夹，把新图按各档尺寸逐个替换、改名，还要小心别把带透明通道的图压坏了；换启动页背景是另一套文件。两步做完，再在命令行里回编、对齐、签名，一个晚上就过去了。素材是同事在群里发的一张图，配文只有四个字「用这个吧」。

现在一句话怎么做：把自家门店巡检 App 的安装包拖进智改工坊，等后台线程解析与反编译完成（实测 12MB 的包约 3 秒）。在详情页输入框写：「桌面图标换成附件里的冬季版图标，替换所有密度的启动图标，保留圆角与透明通道；启动页背景换成第二个附件，页面上的 logo 与文字保持原样。」点「选择附件」把两张图一起选上，图标那张写「门店巡检 App 冬季版桌面图标，替换所有密度启动图标，保留圆角与透明通道，用于冬季版本上线」，启动页那张写「门店巡检 App 启动页背景图，替换现有启动页背景，不遮挡中部 logo，冷启动可见」。点「立刻修改」，AI 改完留下 ai_done.flag，主窗口每 2 秒轮询一次，读到就自动弹出打包窗口，回编、对齐、签名、校验四步依次跑完。

改完怎么验证：勾上「打包后自动运行」，程序用 adb 找到手机或模拟器，装上并用 am start 拉起应用，再用 dumpsys 看一眼前台应用是不是它；然后在应用抽屉里看图标——各密度的缩放在这里最直观；最后冷启动一次，看启动页是不是新背景。整套动作在一台电脑上完成，新图标没有在任何聊天工具里传过一圈。

实例二：自家「内部培训」App 的引导页第二屏与首页横幅

以前怎么做：引导页换图最怕「第几屏」说不清。素材放在共享盘，文件名还是导出时的默认数字；沟通靠一句「就那个第二张，看着换一下」。换错屏之后返工，大家还要再看一遍三屏滑动才能确认到底哪里不对。

现在一句话怎么做：同一套流程：拖入自家内部培训 App 的包，需求写「把引导页第 2 屏的背景图换成附件，第 1、3 屏不动；首页顶部横幅换成另一个附件，横幅不改变高度」。两个附件分别写清用途，例如「培训 App 引导页第 2 屏背景图，只替换第 2 屏，不使用在新手引导其它屏」，首页横幅那张写「培训 App 首页顶部横幅，替换现有活动横幅，保持原有高度与圆角」。点「立刻修改」，其余交给自动打包流水线。引导页素材的说明里把「只替换第 2 屏」和「不用于其它屏」都写明之后，这一条就再没出现过对错屏的情况。

改完怎么验证：装到模拟器，把三屏从头划到尾，只看第 2 屏；退回首页看顶部横幅的高度有没有变化。需要给别人看效果时，手机走 scrcpy 投屏到电脑，模拟器则会被提到窗口最前面；常见国内模拟器（雷电 / MuMu / 夜神等）装了但 adb 没连上时会自动扫端口连上，不用手动折腾。

五、说明写不好，会出哪五种事

把前面说的反面情况收一收，写不好的后果基本落在下面五种里。它们的共同点是：当时省下的一分钟，后面要用十倍的时间还。

1. 提交被拦下，白跑一轮。说明不足 10 个字，或者文件是 0 字节、是个目录、读不出来，校验这一关就过不去。这一种其实是最幸运的——它只是让你多写一句话，而不是让你拿到一个改错的包。
2. 素材放错位置。「图标」两个字，AI 无法区分是桌面图标还是应用内某个标识；「背景」两个字，也分不清是启动页、引导页还是首页。位置一错，等于没改。
3. 改动范围被放大。说明里没写「其它不动」，AI 可能顺手把同一类资源都换掉。多改出来的部分，验证时未必看得出来，等发现时已经出了包。
4. 多附件张冠李戴。一次挑三个文件，说明都写「用这个」，顺序一乱就对不上号。清单是按「序号. 文件路径 —— 用途说明」拼的，说明写得含糊，序号也救不了你。
5. 复现时找不到依据。历史记录里保留的是你的需求原文（附件说明不进历史），所以只写「用附件里的图」的需求，将来回看时缺一个关键信息：是哪张图、什么用途。想让某条改动一年后仍然一眼看懂，把最关键的信息写进需求原话里。

五种后果里，最容易被低估的是第五条。前四种当场就会露出马脚——被拦下、放错位置、范围变大、张冠李戴，验证时都能发现；而「复现时找不到依据」是慢性问题：当时觉得说明写得啰嗦，压缩成一句「用附件里的图」，一年后回看历史，这条需求就只剩半句话，没人记得那张图到底是什么。历史里保留的是你的需求原文，把关键信息顺手写进原话，成本最低，收益最长。

六、用户评价：他们踩过的坑，与改过来的写法

下面几位说的都是同一件事的两个方向——有人是被含糊的说明坑过，有人是把说明写规范之后尝到了甜头。

七、合规提醒与结语

还有一句要重复：无论素材是自己设计的还是委托制作的，请确认被改的应用属于你或你已获得授权，素材本身也不侵犯他人权利。说明栏里写清楚的不只是给 AI 的施工图，也是你自己的一份工作留痕。

把全文收一下：10 个字门槛的用意，是逼你把「这是什么、用在哪、覆盖什么范围、怎么算改对了」补齐；说明写清楚，AI 才知道图该放到哪里。回到那句主标语——附件说明不是随手写的备注，是给 AI 的施工图；写清用途，它才知道这张图该放到哪里。想亲手试一次，最直接的办法是拿一个自家应用的包：拖入安装包，选好附件，把说明写全，再用中文写一句需求，看它自动回编 / 对齐 / 签名 / 校验，最后一键装到手机或模拟器上看效果。

产品是安卓修改大师智改工坊，介绍页：https://www.apkeditor.cn/ai-version.aspx；官网 www.apkeditor.cn。