settings.ini 与 local.ini：哪份该你改，哪份别乱动

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

工具用得越久越会碰到同一个问题：到底该动哪个文件。桌面尺寸、吸附比例、轮询间隔这些，改了马上有感；可登录状态、头像、机器码这些，你根本找不到它写在哪儿。答案很简单——它们本就分在两个文件里。

一、两份配置，两种归属

对比项	settings.ini	local.ini
位置	程序 exe 同目录	%LocalAppData%\ApkGallary\ 下
读者	给人改的参数	程序自己记的账
内容	尺寸 / 占屏比例 / 间隙 / 轮询间隔 / 开关 / 主题	登录缓存 / 头像 / 机器码 / 登录方式
换机器时	可以整份拷走，配置跟着走	不该跟着走：机器码属于这台机器

为什么非要分两份？因为“抄配置”太常见了。把程序目录拷给同事、或换台电脑重装，settings.ini 跟着走是好事——你调好的手感还在；但机器码和登录缓存要是也跟着走，新机器在服务端眼里就变成了“原来那台”。分开放，是让该跟的跟、不该跟的不跟。

二、settings.ini 是怎么被读进来的

这个文件第一次运行时会自动生成，而且是带注释的：每一段参数上面都有几行以分号开头的说明，写清这个值是干什么的、什么场景该改。它希望你打开看一眼就懂，而不是去翻文档。

读取的过程刻意做得“抗造”：逐行找等号，空行、以分号或井号开头的注释行、方括号包起来的节名一律跳过；键名不区分大小写；某一项的值解析不出来（比如把数字写成了字母），只让这一项退回默认值，不牵连别的项；就算整份文件损坏，程序也照常启动，用默认参数跑。换句话说，你手改配置的风险，被限制在“这一项不生效”这个量级。

布尔值的写法很宽容：true / 1 / yes / on 都算开，false / 0 / no / off 都算关；写别的就当没写、用默认值。

三、写回去有两种方式，这解释了一个“玄学”

很多人有过这种体验：在「参数设置」页改了一项、保存，再打开 settings.ini，发现自己写的注释全都还在。这不是巧合——它写回文件时是“只改那一行”的：逐行找键，找到就把这一行的值换掉，其他行（包括注释和空行）原样保留；文件里没有这个键，才追加到末尾。

“整份重写”只发生在一处：文件不存在时生成带注释的默认配置。理解这两条，就能放心把 settings.ini 当长期维护的文本：想加备注就加，程序改参数时不会擦掉它。

一句话记住分工：settings.ini 里的每一行，都可以问一句“我希望它长期这样吗”——希望，就写进去；local.ini 里的每一行，问的是“这台机器上的我，是谁”。

四、local.ini 里到底记了什么

它躺在 %LocalAppData%\ApkGallary\local.ini，内容放在一个统一的节里，主要是这几类：

记的东西	用来干什么
机器码	首次算出后存本机，之后一直用同一个值，服务端靠它认设备
登录缓存	加密保存的登录信息，重启程序还是登录状态
登录方式	区分账号登录与扫码登录，据此决定是否给「找回密码」入口
头像	服务端头像地址与本机头像副本，重启后不闪空
更新待办	记下一次没装成功的强制更新，下次启动直接弹出来

机器码的算法值得一提：优先取主板 UUID，取不到退回网卡 MAC，再不行用随机串，最后统一做一次摘要后落盘。算一次就固定下来，之后每次都用它——它既是“机器的指纹”，也是一份本机缓存。

这也带来两个直接可用的操作：想退出登录，把登录缓存那一行清掉即可（程序内退出登录做的也是同一件事）；而不要随手改机器码——改了在服务端眼里就是另一台设备，你会把自己弄成“陌生机器”。

五、改完要不要重启：一个原则，两个例外

原则很明确：settings.ini 里的值，改完要重启程序才生效——它是在启动时读一次的。窗口初始尺寸、吸附比例、轮询间隔这些都符合这条。

例外一：主题。在「参数设置」页点一下配色，立刻换色、不用重启。原理不是“改颜色”，而是换字典：界面颜色来自一支调色板资源字典，加载后里面的值会被冻结、改不动；换主题的做法是整支替换那本字典，触发界面引用重新解析——所以是即时的。

例外二：详情页那两个勾选项（打包完自动保存到桌面、打包后自动运行）。勾选状态会写回 settings.ini，下次打开还是这样——你在界面上点的勾，其实就是在替你改配置。

六、值得调的键，与三条手改纪律

键	什么时候值得改
ScreenWidthShare / Gap	想让两窗合计不止占 3/4，或要留一条缝
TickIntervalMs	吸附想更跟手（默认 5ms，建议 4~10 之间）
SnapBackDelayMs	被拖走后多久自动吸回（默认 260ms）
FitToWorkArea	屏幕不够高、窗口被系统截短时打开它
VerboseLog	排查吸附问题时打开，会写详细吸附日志
ShowUsageTips	嫌底部技巧提示条轮换打扰时关掉（点它的关闭按钮也会写这一项）

七、两个自家改包实例：配置在这儿怎么起作用

实例一：自家门店营销 App，一次做三个活动包

以前怎么做：三个渠道各改一遍，命令行反编译、换活动 banner、改文案，再把三个产物分别改名归档；勾选项每次重新设，桌面上的“最终版 (2).apk”越攒越多。

现在一句话：三个渠道各建一个项目，需求统一写「活动 banner 换成附件图，文案改为『门店季』」。三个项目分别点「立刻修改」，AI 改完自动回编、对齐、签名、校验。

改完怎么验证：把「打包完自动保存到桌面」勾上（勾选状态记在 settings.ini 的打包 / 预览一节里，下次打开还是这样），产物默认名“应用名_版本号_signed.apk”，一眼分得清；装到设备上逐项核对 banner 与文案。

实例二：自家内部培训 App，换名字 + 去掉自家开屏广告

以前怎么做：改 strings.xml 里的应用名、动开屏那段逻辑，然后手工回编、对齐、签名、安装，一步都不能错；顺手想调一下窗口手感，还得去翻自己记的命令。

现在一句话：需求框里写「应用名改为『培训助手』；移除自家的开屏广告，保留版本更新提示」，点「立刻修改」交给 AI。改完顺手把 TickIntervalMs 从 5 改成 4、把 ShowUsageTips 关掉，重启一次程序，手感与界面都按你的喜好定型。

改完怎么验证：打包后装到设备上拉起，逐项核对名字、开屏与更新提示；重启程序后确认轮询间隔与提示条状态；出包时间、账号、机器码、应用名、包名等编码在包里那枚标记里，事后能对得上号。

八、用户怎么说

两份文件、两种归属，其实是一套很朴素的规矩：给人改的写清楚、给程序记的管严实。知道每一项该落在哪、什么时候生效，配置就不再是“玄学”，而是手上的一排旋钮。

这正是「安卓修改大师智改工坊」想给你的手感——只需说话，就能让应用变成你想要的样子，而工具自己的脾气，随时可以被你写进那两个文本文件里。介绍页 https://www.apkeditor.cn/ai-version.aspx，官网 www.apkeditor.cn。