认路径不认名字：被吸附程序的开机清理与两段式退出

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

但今天不聊 AI 怎么改包，聊它右边那个「被吸附的程序」——负责和 AI 对话改包、被磁吸在主窗口右边：两窗高度对齐，宽度合计占屏幕工作区 3/4。它不是你写的代码，却每天被你开合十几轮。这篇只讲一件事：工具在它身上做主的边界画在哪，以及为什么画在这。

一、先立个规矩：认窗口只认 exe 路径

假设机器上同时跑着两个程序：一个是官方发行、装在程序目录里的 ZCode.exe；另一个是工具自带的、放在工作目录 tools\zcode\zcode.exe 的那份。它们进程名忽略大小写完全一样。磁吸该吸哪个？清理残留又该杀哪个？

答案很硬：只认窗口所属进程的可执行文件镜像路径，和配置里那个路径做一次不区分大小写的完整比对，对不上就返回「不是它」。还有一条刻意设计——不做进程名兜底。早先那句「读不到路径就按进程名比」看着是容错，实际是坑：一旦走到那一支，吸附、叫醒、强杀重开会全作用到另一个程序身上。现在路径读不到就当它不是，宁可这轮认不到，也绝不认错。

为什么必须这么严？因为把需求送进对方输入框走的是「剪贴板 + Ctrl+V + Enter」的键盘模拟，而键盘事件只会进前台窗口。认错窗口不是「发送失败」，是把你要改包的那段中文需求，原封不动敲进了别人的输入框。

平时你感觉不到这条规矩，直到界面上多出一句「叫醒的窗口不属于配置里那个被吸附的程序，已放弃发送」——那不是故障，是纪律在替你把关。

二、启动先清残留：它不是「一个程序」，是十几个进程

工具启动时会做一件事，而且排在最前面：先按 exe 路径把上一轮残留的被吸附程序彻底结束，再开始磁吸（配置项 KillTargetOnStartup，默认开启）。为什么较真？因为这类程序多是 Electron 应用——一个主进程，外加一堆同名的渲染进程、GPU 进程、工具进程，实测能到十几个；只杀主进程会留下孤儿进程，既占内存，还可能自己再弹窗口。

「残留」是常态，不是意外。它们通常来自三处：

• 上一轮退出时缩在托盘里没关干净；
• 被强杀之后留下的子进程；
• 你手工强退过——窗口关了，进程还在。

不先清，最典型的现象就是两个实例抢同一个窗口：你以为在吸 A，实际吸到的是 B。

「没找到」「没启动」「查找中」为什么分三档

右侧程序没起来时，状态栏不会只挂一句没信息量的「查找中」：文件不在就把「未找到」和应放的路径写出来；在但没跑就提示「还没运行」，并告诉你右边那个按钮能打开它并吸附；都正常才显示「正在查找…」。查盘与扫进程有开销，这个判断每隔 1.5 秒才真做一次，中间的轮询沿用上次结论。

三、退出为什么「先优雅，再彻底」

关掉主程序时，对被吸附程序的收尾分两步走，顺序不能颠倒。

第一步，优雅关闭。先发标准关闭请求，不行再补一条 WM_CLOSE 消息，然后等它自己收尾，默认给 4 秒（TargetCloseTimeoutMs）。这 4 秒有讲究：对方可能正在跑一轮 AI 改包，或输入框里留着你的草稿，一刀切掉丢的是你的东西。

第二步，彻底结束。不管第一步成没成，再按 exe 路径把所有相关进程扫一遍全杀掉——主进程、渲染进程、GPU 进程一个不留（ForceKillTargetOnExit 默认开启）。为什么优雅过了还要补这一刀？因为这类托盘应用收到关闭请求，很多时候只是把窗口藏起来，进程根本没退——任务管理器里还躺着一排，下次启动又变成「残留」。

一个容易忽略的细节：这一步不要求「必须是我吸上的」——哪怕是你自己手动开着它、磁吸一直没成功，退出时照样按配置把它关干净。收工就该是干净的。

四、叫不醒的时候：隐藏窗口也认，最后才考虑强杀重开

托盘是这类程序最爱的藏身处，也是各种「吸不上」的源头。缩在托盘里的程序是把窗口隐藏（hide）掉，而不是最小化——隐藏之后，常规的「主窗口句柄」查询返回 0，按可见窗口去认领的那条路就永远认不到它。

所以「叫醒」走另一条路：枚举该程序的顶层窗口（隐藏的也算），找到就直接用；进程真没跑，就按配置路径启动它，最多等 15 秒让新窗口出来。连这条路都堵死时（进程卡死、窗口状态坏了、托盘里点不开），才用最后一招：按路径清掉它、重新打开（RestartTargetWhenUnreachable 默认开启）。代价很直白：它正在跑的任务会中断；不想承担就关掉。

一个手感细节：从任务栏点回主窗口时，右侧那个若缩在后台，会被恢复成普通窗口并抬到最前，但用的是「不激活」方式——不抢你的焦点，否则两窗会互相抢激活、来回跳。

五、动手改：四种「我不想」的配置对照（技巧）

省心不是唯一诉求——你可能正跑着不能中断的会话，或就想让它一直开着。下表按「我想要什么」查，改的都是 exe 同目录的 settings.ini。

你的诉求	改哪一行	代价与说明
启动后不想被清	KillTargetOnStartup=false	上一轮残留会留着，可能两个实例抢窗口
退出后不想被关	CloseTargetOnExit=false	它会继续在后台跑，下次启动若开了清理仍会被结束
只要优雅关，不要强杀	ForceKillTargetOnExit=false	超时后不再管它；托盘程序很可能留着不退
多留点保存时间	TargetCloseTimeoutMs=10000	退出时会多等一会儿，换来更小的数据丢失风险
叫不醒也不许重开	RestartTargetWhenUnreachable=false	发送会失败并说明原因，但不打断它正在跑的任务
临时换个被吸附对象	启动加 --target "完整路径"	同样只对本次生效；窗口名不好认时还能配 --title 关键字

六、这些纪律，在现场是什么样：两个自家改包实例

机制讲完，看两个我们内部的例子——都是自有版权或已获授权的包。

实例一：自家门店巡检 App，改名 + 换图标，做成内测版

以前怎么做：命令行反编译整个包，翻到 res/values/strings.xml 改应用名，再把五个密度目录的图标一张张换成新 logo、补上自适应图标那几处，然后回编、对齐、签名，中间敲错一步就是二十分钟白干。

现在一句话：把安装包拖进项目，加两张附件（新 logo 图、应用名清单），需求框里写「应用名改为『巡检助手 内测版』；图标换成附件里的新 logo，五个密度都替换，保留自适应图标结构；不要动包名和签名」。点「立刻修改」，右侧窗口里的 AI 就开始改 smali 与资源。

改完怎么验证：AI 改完会在项目目录留一个标志文件，主窗口每 2 秒轮询一次，读到就自动弹打包窗口——回编、对齐、签名、校验四步走完，产物是 build 目录下的 signed.apk，全过程写进 pack.log。装到手机后看三处：桌面图标、应用名、启动页是否正常。想「照上次那条再改一遍」，去详情页的历史里点「选择」，需求原文（完整不截断）就填回输入框了。

实例二：自家培训 App，换启动页背景 + 去掉自家推广弹窗

以前怎么做：找到启动页背景图所在的资源目录按分辨率逐张替换（还可能碰上 .9.png），再去翻弹窗逻辑：哪个 Activity 弹、触发条件写在哪——改一处漏一处，装上去点两下才发现还弹。

现在一句话：附件里放新版宣传图并写明用途（说明少于 10 个字过不了校验，这不是刁难——写不清用途，AI 也猜不准），需求写「启动页背景替换为附件图；移除启动后 2 秒弹出的内部推广弹窗，保留版本更新提示」。工具会把「序号. 文件路径 —— 用途说明」拼成附录一起发给 AI。

改完怎么验证：打包完成后装到设备上拉起，看启动页、等 5 秒确认不再弹窗，再用 dumpsys 看一眼前台是不是它。若某次出包说不清是哪一版，包里那枚 name="info" 打包标记（时间、账号、机器码、程序版本、应用名、包名等编码串）能帮你回溯。

这两个例子里，被吸附的程序始终在跑 AI 那一半：每一轮改包都发生在它身上，纪律好不好，决定你会不会在半夜对着两个同名进程发呆。

七、用户怎么说

八、把纪律留给工具，把注意力留给自己

这三处机制其实在讲同一件事：工具对「别人家的程序」要有边界感。认身份只认路径，所以不会认错；开机先清残留，所以每次都是干净的一份；退出先优雅再彻底，所以既不粗暴也不留尾巴——而每条边界旁边都留了一个配置项，让你按场景改回来。

这也是「安卓修改大师智改工坊」的一贯做法：把容易踩坑的部分按默认值定好，把选择权写进配置。你只需记住那句口号——只需说话，就能让应用变成你想要的样子——剩下的开与关，交给它按纪律执行。机制全貌见介绍页 https://www.apkeditor.cn/ai-version.aspx，官网 www.apkeditor.cn 还有更多上手内容。