安卓修改大师 · 智改工坊

设备预览、附件说明、历史回填、打包标记：四个被用户"用"出来的能力

用户遇到什么问题 · 于是有了什么能力 · 两个自家应用实例

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

今天不聊"它有哪些功能"，聊一个更有意思的问题：这些功能是怎么长出来的。因为一款工具的成长史，往往比功能表更能说明它到底为谁而做。

一、功能有两条来路：想出来的，和用出来的

功能表由两种东西拼成。一种是设计时"想"出来的：看着合理、写进需求、画进原型，上线后却没什么人点。另一种是使用中"用"出来的：用户被某个环节反复硌到，忍不住说一句"这一步能不能你来"，然后它就成了功能。前者靠想象，后者靠摩擦——摩擦出来的功能通常更耐用。而智改工坊面对的场景，恰好是最容易产生摩擦的那种：你自己拥有版权或已获授权的应用，要改图标、改名称、改文案、换启动页，或者给内部版本加个后缀。需求不复杂，却高频得让人烦躁；也正因为高频，才有一批能力被"用"了出来。

要复盘的四条链路：包改完还得自己装上设备 → 设备预览；AI 不知道附件是干什么的 → 附件说明；上次那条需求写得挺好 → 历史回填；几个包分不清哪轮 → 打包标记。它们遵循同一个句式：用户遇到什么问题，于是有了什么能力。

二、设备预览：用户说"还要我自己装一遍，那前面不白省了？"

改包有个微妙的心理落差：你花力气把需求说清楚、等 AI 改完、看四步打包跑完，终于拿到 signed.apk——然后呢？然后你要自己把包拷进手机、记住包名、在满屏图标里翻出它、点开看效果。前面省下的力气，最后一段又还回去了一部分。

更烦的是"装"这一步的隐性失败：adb 没连上、设备没授权、模拟器端口不对、装上了却没拉起来——每一步都得你亲手排查，而这些排查跟"你想改什么"毫无关系。

于是有了设备预览：打包完成之后，程序用 adb 找到你的手机或模拟器，把刚出的包装上，并直接把应用拉起来。手机连着时用 scrcpy 把屏幕投到电脑，模拟器则把窗口提到最前。听起来只是多了一步，但里面有几个被用户逼出来的讲究。

第一个讲究：拉起用 am start，不用 monkey——新版安卓镜像里已经没有 monkey 了；而且它失败时退出码仍然是 0，只看退出码就会把失败当成功，那种"看着成功了、其实没起来"的假象比直接报错更耽误事。

第二个讲究：启动页组件名三档查找——优先用项目 config.ini 里的 LaunchableActivity，取不到就问设备 resolve-activity，再取不到才退回 monkey。第三个讲究：装完用 dumpsys 看一眼前台应用是不是它——不是"我发了启动命令"就算数，而是确认它真的到了前台。

设备侧的坑也一并填了：没授权会提示去手机上点「允许 USB 调试」；模拟器装了没开，会搜出安装路径问你要不要现在打开；常见国内模拟器（雷电 / MuMu / 夜神等）装了却没连上，会自动扫端口连上——都是用户踩过一次后，希望"下次别再问我"的地方。

一句"装上去看一眼"，背后是六个原本要你自己做的动作。这就是"用出来的功能"的典型形态：它不炫技，只是把摩擦一段一段抹平。

三、附件说明：用户说"AI 不知道我传的图是干嘛的"

用中文写需求，最怕的不是你说不清，而是 AI 把附件用错。比如你写"把启动页背景换成新图"，同时传了新背景图、旧图备份与一份配置文件——AI 只能看文件名猜；一旦文件名是 image_new_final2.png 这种，猜错的代价就是整轮重来。

于是有了附件说明：点「选择附件」可以一次挑多个文件，并且给每个文件写一句"它是干什么用的"。这些说明会拼成「序号. 文件路径 —— 用途说明」跟着需求一起发给 AI，附件从"一堆文件"变成"一张有备注的清单"。

配套的两个校验也是用户提出来的：一是文件现在能不能用（存在、不是目录、不是 0 字节、能读出来）；二是说明不少于 10 个字——"新图""字体"这类备注，写的人觉得写清了，看的人（这里是 AI）其实什么也没得到。

实际发出去的形式是这样一行：1. D:\素材\巡检助手_启动图_新.png —— 新版启动页背景图，用于替换 splash 页旧背景。

还有个细节：需求原文会进 history.ini，但附件说明不进历史，历史里只留用户原话。这是被用出来的取舍——历史是拿来"照上次再改一遍"的，混进附件说明反而看不清哪句是需求。两种信息分开存，回填时更干净。

四、历史回填：用户说"上次那句写得挺好，能再用一次吗"

改包是有"周期"的：每周换一次活动图、每次迭代改一次应用名。同一类需求反复出现，以前只能翻聊天记录、翻记事本、翻上次发出去的消息，找到那条需求复制一遍，还要小心别漏了限定条件。

于是有了历史回填：详情页直接列出这个项目的修改历史，最新的排在最上面，每条显示 #序号 + 时间 + 需求原文，并且原文完整显示、不截断。右侧的「选择」把那条需求直接填回输入框，你要做的只是改掉这次不同的地方，然后点「立刻修改」。

"不截断"是被用户专门强调过的：需求里最值钱的往往是最后那句范围限定——"其它页面不动"。一旦被截成一行省略号，就得先点开才知道完整内容，回填的价值立刻打折。

历史从哪来？不用手动整理：点「立刻修改」时，需求原文 + 修改日期会自动写进 history.ini。它按记录1、记录2 递增，删某一节就等于删掉那条记录。项目列表里每条的「历史」按钮还能打开独立历史窗口，方便在列表页直接翻。

历史回填省下的三个动作：不用找（不必翻聊天记录）、不用抄（点「选择」直接回填，不怕漏细节）、不用猜（带 #序号 与时间，一眼看出哪一轮）。

五、打包标记：用户说"这几个包长得一样，我分不清哪轮是哪轮"

只要出包频率上来，一定会撞上这个问题：一天出三四个包，包名一样、版本号一样，装到手机上分不清哪个是上午那版、哪个是下午改过图标那版。分发给同事时更乱——"你装的是哪个？""就那个最新的。"

于是有了打包标记：每次出包之前，程序自动往 res/values/styles.xml 里写入一个 name="info" 的样式，内容是把时间、登录账号、机器码、机器名、系统用户名、程序版本、应用名、包名等信息编码后的标记。

它的妙处是"不占地方也不碍事"：作为样式项，它不改变应用行为，不用你多填字段，也不用你记得在出包前记录什么——只要包是从这里出的，标记就在里面。日后要追问"这个包是谁、在哪台机器上、什么时候打的"，包自己会回答。

要说明的是：这个标记面向内部版本管理与问题定位——同一轮内测出现两种现象时，你能立刻分辨它们是不是同一个产物；分发给同事时，也能快速对齐"你手上是第几轮"。它不用于追踪用户，也不涉及面向用户的数据采集。

一句话理解：给每个包发一张"身份证"。它不限制谁用，只让包能说清自己从哪来——而这件事在多人多机的环境里，早晚会变成刚需。

六、还有一批"小改动"，也全是被硌出来的

大能力之外，还有一批不起眼的小地方，来源同样直白——单看都不算什么，凑在一起才构成"顺手"。

• 「打包时顺手点了关闭，以为没在跑」 → 打包过程中窗口不给关；跑完可「保存 APK」或「打开所在文件夹」。
• 「出包后还得自己起名、翻目录」 → 默认名 应用名_版本号_signed.apk，一键保存或直达文件夹。
• 「先让我看看包，别一上来就拦着」 → 大师币不足时导入与编辑不受影响，只在点「立刻修改」「去打包」时提示。
• 「删项目怕删错目录」 → 删除有防呆：只允许删 Project 的直接子目录。

其中磁吸窗口那套行为，几乎每条都是被"用"出来的：拖宽主窗口，右侧自动变窄；主窗口最小化它跟着最小化，还原一起还原；两窗高度一致，宽度合计固定占屏幕（工作区）的 3/4。从任务栏点回主窗口时，右侧会被恢复成普通窗口并抬到最前，但不抢焦点——这半句就是有人抱怨"焦点会跳走"之后补上的。默认吸附目标是 tools\zcode\zcode.exe，可在 settings.ini 改。

再往下还有一层交给配置文件的自由度：settings.ini 可以改两窗口宽度合计占屏比例、间隙、轮询间隔、最小宽高、启动是否吸附、退出是否关闭被吸附程序等；命令行参数（--target / --title / --width / --height / --share / --gap / --dock / --no-dock / --verbose 等）只对本次运行生效。首页底部那条每 12 秒轮换一次的技巧提示（内置 112 条，可在设置里关掉）与 10 套配色主题，也都是从"能不能少查一次文档"这类反馈里来的。

七、两个自家应用：反馈落地之后的样子

把上面四条链路放进真实场景，感受更直接。下面两个例子都发生在我们自己的应用上。

两个例子的共同点是：省下来的并不是"改得快"，而是那些你本不该操心的动作——当改包变成每周都要做的事，这些动作会被反复收租。

八、他们怎么说：反馈本身就是产品的一部分

回到开头那句主标语：好用的功能不是设计出来的，是被用户用出来的。设备预览抹掉了"最后一段又要自己动手"的落差；附件说明让 AI 少猜一次；历史回填把"照上次那条再改一遍"从客套话变成按钮；打包标记让每个包都能说清来历。它们都不惊艳，却都是真实摩擦留下的印记。

产品是安卓修改大师智改工坊，介绍页：https://www.apkeditor.cn/ai-version.aspx；官网 www.apkeditor.cn。想验证这些能力是不是"用出来的"，最直接的办法是拿一个自家的包试一次：写一句中文需求、挂上附件并写清用途、点「立刻修改」，看它自动完成回编 / 对齐 / 签名 / 校验，再自动装到手机或模拟器上拉起。