settings.ini与local.ini：配置文件分层的设计内核与调参手册

用桌面软件的人，多半都跟配置文件打过交道。有人喜欢打开软件的目录翻一翻，看到一堆 .ini 文件就犯怵：到底哪份能改、哪份不能碰？安卓修改大师智改工坊（经典版）在这件事上做了一个很克制的设计 —— 它把配置故意拆成了两份：一份叫 settings.ini，是留给你改的；另一份叫 local.ini，是程序自己记的。它的介绍页在 https://www.apkeditor.cn/ai-version.aspx，官网是 www.apkeditor.cn。

别小看"拆成两份"这四个字。配置文件写在一起的软件，用久了都会遇到同一个噩梦：你想改一个窗口大小，手抖动了不该动的一行，下次登录状态没了；或者程序自动写状态的时候，顺手把你手写的注释冲掉了。分开存放之后，"人改的"和"程序记的"各过各的，谁也不踩谁。这篇文章就把这份"分层设计"讲透：为什么要分、settings.ini 里每一项都是干什么的、local.ini 里哪些东西你别乱动、命令行参数怎么做到"不改文件就临时覆盖"、工具链体检和一键补齐怎么用，最后附两个自家应用的实战例子。

一、为什么要把配置拆成两份

先想清楚一个问题：一个桌面软件运行时，磁盘上要记的东西天然分成两类。一类是"偏好" —— 窗口想摆多大、两窗占屏多少、喜欢什么主题、启动时要不要顺手把 AI 工作区窗口也加载出来。这类东西的特点是：由人来定，定一次就长期不变，而且希望程序在文件里留好注释，方便以后自己翻回来改。

另一类是"状态" —— 你这次登录用的是微信扫码还是账号密码、头像缓存在哪个地址、这台机器的机器码是多少。这类东西的特点正好相反：由程序自己读写，人根本不需要看，更不应该手改；它每次运行都可能变，而且写得很频繁。

如果把这两类塞进同一份文件，问题立刻来了。最典型的一个：你为了调窗口大小打开文件，注释读得正仔细，程序在后台把你刚登录的状态也写进同一个文件 —— 两个写入动作要是没配合好，你的注释可能被冲掉，或者你手动保存时把程序刚写的状态覆盖了。更要命的是排障：登录出问题时你想把"状态文件"整个删掉重来，结果连自己调好的窗口参数一起删了。

这样分完，两边的写入路径完全隔离：你编辑 settings.ini 时，程序只在启动和退出时读它，不会在中间抢着写；程序更新 local.ini 时，碰都不碰 settings.ini 里你写的注释。出了问题也好分诊 —— 布局不对，去翻 settings.ini；登录不对，去动 local.ini（或者直接删掉让它重新登录）。一份文件一个责任，排查路径短了一大半。

这个分层还有一个常被忽略的好处：备份和迁移变得简单。 你换了台电脑，要带过去的是什么？是 settings.ini 里那套调好的偏好（窗口比例、主题、开关），仅此而已 —— 它是纯文本，几行字，拷过去就能用。而 local.ini 不用带，新机器重新登录一次即可；你的真资产（各个项目）本来就在 Project 目录里，整个拷过去就齐了。三份东西各过各的，迁移时拎得清拎什么、扔什么。

二、settings.ini：留给你的调参手册（逐项讲）

settings.ini 是这个软件里你唯一应该常翻的配置文件。它的每一项都带中文注释，写清了这个值会怎么影响界面。下面按"你会调到什么"把主要项过一遍 —— 改完之后重启程序生效。

配置项	管什么	怎么调
两窗口合计占屏比例	主窗口与 AI 工作区窗口加起来占工作区宽的几成	默认约 0.75；想两边更宽松调到 0.65，想右边更宽调到 0.85
两窗间隙	两扇窗口之间留多宽的缝	默认贴合；想看出"是两个程序"加 6~12 像素
轮询间隔	主窗口多久去看一眼 AI 改完没	默认 2 秒；不建议低于 1 秒
主窗口最小宽高	窗口能拖到多小	小屏笔记本可适当调小
启动是否加载 AI 工作区窗口	开机就并排待命，还是手动再开	常开改包就开着；偶尔用就关掉加快启动
退出是否关闭 AI 工作区进程	关主程序时顺手清掉 AI 窗口吗	默认关；想下次接着用可留着
配色主题	10 套配色里用哪一套	也能在「参数设置」页点一下直接换

占屏比例到底怎么算：拿一台 1080p 屏幕算给你看

settings.ini 里最常被调的就是占屏比例，拿一台 1920×1080 的显示器代进去算一遍你就有数了。默认比例 0.75，意思是两扇窗口加起来占工作区宽度的 75%，也就是合计约 1440 像素。主窗口按默认宽度 600 算，右侧 AI 工作区窗口自动拿到剩下的 840 像素 —— 这个宽度看 AI 输出的代码块基本不用横向滚动。你把主窗口拖宽到 900，右边就变成 540；拖到 1000，右边还剩 440，看代码就得频繁左右挪了。判断标准只有一条：右边那扇至少要能完整展开 AI 的代码块。

那小屏笔记本怎么办？1366×768 的本子，0.75 折下来两窗合计才 1024 像素，主窗再拿走 600，右边只剩 424，确实挤。这时候别光调比例，顺手把主窗口最小宽高调小一点（比如 360），再把比例提到 0.8 —— 右边立刻宽敞不少。反过来，你在 2K 屏（2560 宽）上用 0.75，两窗合计 1920，右边轻轻松松一千多像素，默认值就很舒服，根本不用动。

轮询间隔这一项上一篇我们专门讲过 —— 它管的是主窗口多久去项目目录看一眼"AI 改完没"。默认 2 秒，是响应速度和系统开销的平衡点。你在机械硬盘的老机器上觉得目录查询拖累界面，把它放大到 3~4 秒毫无体感损失；想更跟手可以往小调，但别低于 1 秒，不然就是拿 CPU 换两秒感知不出来的及时。

把这些项按"你遇到什么情况"汇成一张速查表，日常调参照着查就行：

你的诉求	动哪一项	建议做法
右边 AI 窗口太窄看不全代码	占屏比例	调到 0.80~0.85，或拖窄主窗口
旁边还要放别的程序	占屏比例	降到 0.60~0.66
两窗贴着看不出分界	两窗间隙	加 6~12 像素
老机器觉得等得慢	轮询间隔	放大到 3~4 秒即可
想启动快一点	启动是否加载 AI 工作区窗口	关掉，用时再开
临时演示一次特殊布局	命令行参数	--share / --gap，仅本次生效

这里有个设计细节值得单独说：界面上的「参数设置」页和这份文件是同一套参数的两个入口。 你在设置页里改工作目录、点主题、做工具链体检，程序只会更新 settings.ini 里对应的那一行 —— 你手写在文件里的注释不会被动。反过来，你直接在文件里改完重启，设置页读到的也是同一份。两个入口改的是同一个真相，不会出现"界面一套、文件一套"的分裂。这就是为什么把"人改的"集中在一份文件里 —— 单一事实来源，界面和文件都只是它的镜子。

再补一个容易被忽略的项：首页底部那条使用技巧提示条。它每 12 秒轮换一条，内置了 191 条"怎么用这个软件"的技巧。看多了想清静，可以在设置里把它关掉。这类"显示层"的偏好也都收在 settings.ini 里 —— 凡是"你看着办"的东西，基本都在这儿。

三、local.ini：程序自己的笔记本（别乱动）

说完了"你改的"，再看"程序记的"。local.ini 这份文件，你的角色是旁观者。里面主要是这几样东西：

为什么这份"别乱动"？因为它是程序的内部状态，不是偏好。你手改机器码，等于告诉程序"这是另一台机器"，登录状态就对不上了；你删了登录缓存，最严重的后果不过是下次重新扫一次码 —— 这反而是它唯一的"正确用法"。你甚至不需要知道这些字段叫什么名字，程序自己会在合适的时候把它们写进去、读出来、更新掉。所以对 local.ini 的正确态度是：平时不打开；登录出问题、想重置状态时，把它删掉让程序重新登录。 它是程序的笔记本，不是你的调参手册。

反过来想，这份"别乱动"其实也是一种保护。机器码这种东西和你的账号体系是绑定的，它记录的是"这台机器是哪台"，不是"你想让它是哪台"。你手改它，等于人为制造一台"新机器"，结果就是登录态对不上、用户中心的资料卡读不出来。正确的做法永远是让程序自己写、自己更新；你需要做的唯一操作，是在登录出问题时把它整个删掉重来 —— 这比在里面挑挑拣拣安全得多。

顺带说清一件和配置无关但常被问的事：大师币不足时，导入 APK、编辑项目都不受影响，只有在详情页点「立刻修改」和「去打包」时才会提示充值。也就是说，你本地的布局、主题这些配置偏好，和你充没充值完全是两条线 —— 这也是把"偏好"和"账号状态"分开存放的实际好处之一：账号侧的状态变化，永远不会弄脏你调好的界面。

四、命令行参数：不改文件的一次性覆盖

settings.ini 改起来要重启，有没有"只这一次、改完就恢复"的办法？有，就是命令行参数。它们和 settings.ini 管的是同一批参数，但只对本次运行生效，绝不写回配置文件。这特别适合演示、临时排错、或者只想为某一次任务换个布局。

参数	作用
--target	本次启动指向指定目标（项目）
--title / --width / --height	本次窗口的标题与初始宽高
--share / --gap	本次临时覆盖占屏比例与两窗间隙
--dock / --no-dock	本次启动是否让 AI 工作区窗口并排待命
--acrylic / --no-acrylic	本次是否用毛玻璃质感窗口背景
--fit / --verbose	本次启动贴合工作区 / 打开详细诊断输出

举个用法：给同事演示时你想让两扇窗口临时占满屏幕九成、中间留出明显的缝，就不用去翻 settings.ini，直接这样启动，演示完关掉程序，下次启动一切照旧：

几个参数再展开说说。--target 适合"开机直奔某个项目"：你平时只改那一个内部应用，用它把启动目标直接指过去，省去登录后再翻项目列表这一步。--acrylic / --no-acrylic 控制窗口那层毛玻璃质感 —— 老电脑显卡吃力、窗口发虚的时候，用 --no-acrylic 关掉它立刻轻快；想在好看和性能之间换口味，切一下就行。--verbose 打开详细诊断输出，排查"为什么布局不对、为什么窗口没并排"的时候，日志里的信息会比平时多不少。

一句话记住命令行参数的定位：settings.ini 是"长期的你"，命令行参数是"今天的你"。长期偏好写进文件，临时状态交给参数 —— 别为了省一次重启，把只想用一次的布局硬写进永久配置里。

这里的"覆盖优先级"是很清爽的：命令行参数 > settings.ini > 内置默认值。也就是说，你文件里写着 0.75，命令行给个 0.9，这次就用 0.9；命令行没给的项，才回落到文件里的值。没有那种"命令行和文件打架不知道听谁的"的灰色地带 —— 本次运行一切以命令行为准，结束就忘。

五、工具链体检与一键补齐：环境不齐怎么办

配置讲完了，说一个更底层的问题：这个软件改包靠的不是自己一个人，它身后站着一整套命令行工具 —— aapt 解析包信息、apktool 反编译回编、zipalign 对齐、apksigner 签名校验、还有 java 运行环境。这些工具放在工作目录的 tools 子目录里，程序会自动递归搜索，不用你手动登记路径。问题是：万一哪台新机器上这套工具不全呢？

「参数设置」页里有一项专门的工具链体检：它会把 aapt、java、apktool、zipalign、apksigner 这几个组件逐个检查一遍，每个都报"就绪/缺失"，并给出找到的完整路径。哪一环红着、路径在哪儿，一眼看清，不用你翻目录瞎找。这比"改了包但打不出来、然后对着黑窗口发呆"强太多 —— 体检页就是把可能出问题的环节一次性摊开给你看。

体检页把每个组件的角色和它干的活摆在一起，你一看就懂谁是谁：

组件	在改包流程里干什么	缺了会怎样
aapt	解析包信息：图标、应用名、包名、版本号、SDK、启动页	建项目时读不出包信息
java	运行环境，apktool / apksigner 都靠它跑	反编译和签名直接起不来
apktool	反编译解包、改完再回编成 APK	改包和出包都无从谈起
zipalign	出包前做 4 字节对齐	对齐这一步过不去
apksigner	签名 + 最后 verify 复核签没签上	包签不了也验不了

为什么多此一举逐个体检，而不是"跑不起来再说"？因为这套工具是链条式的 —— 一个环节缺了，你可能要等到点「立刻修改」、回编失败时才发现，前面拖包、写需求的时间全白花了。体检页把整条链提前摊开，让你在动手之前就知道哪里缺、缺的东西点一下就能补。这就是它和"事后报错"的区别：把故障拦在开始之前，而不是流程中间。

再往上一层，连"工作目录放哪个盘"都替你想好了。程序启动会自动挑盘：依次尝试 D、E、F、G 盘，取第一个能读写、且剩余空间不少于 1GB 的盘，都不行才退回 C 盘，然后在这个盘下拼出固定的工作目录（形如 盘符:\AiApkEditor）。目录里就两个子目录：tools 放那套工具，Project 放你的各个项目。为什么系统盘放最后？因为系统盘权限限制多、空间也常紧张 —— 这就是为什么你有时候会发现工程被放到了 D 盘而不是 C 盘，这不是 bug，是它在替你挑。

这里有个可以主动利用的细节：工作目录是在「参数设置」页里可以自己改的。 如果你就是想让工程和工具固定待在某个盘，不用等它自动挑，直接在设置页指定一个目录即可，指定完下次启动就按这个来。挑盘逻辑只在"你没指定"的时候兜底生效。tools 子目录里那套工具是自动递归搜索的 —— 你就算手动把某个工具的版本升级、替换进去，程序也会自己找到，不用在配置里登记路径。这也是工具链体检能"报出完整路径"的底气：它不是记一个写死的路径，而是每次真去搜一遍。

六、主题与窗口行为：随手能换的那一面

配置里最让人心情好的一项是主题。自带 10 套配色：极夜蓝、深海蓝、紫罗兰、樱花粉、烈焰红、落日橙、古铜金、青柠绿、薄荷绿、石墨灰。在「参数设置」页点一下立刻换，不用重启。白天用薄荷绿看着清爽，晚上切极夜蓝护眼睛，全凭手感。

关于 DPI 再多说一句，多屏党尤其用得上。现在不少人一块 100% 缩放的主屏、一块 150% 缩放的副屏。如果程序"全局只认一个缩放"，窗口拖到副屏上字就会忽大忽小。智改工坊是按每块显示器各自感知的 —— 你把主窗口从主屏拖到副屏，它会按副屏的缩放重新算字号和边距，两扇窗口跟着一起适配。配 --fit 用，拖到任何一块屏都先贴合它的可视高度，不会被系统截掉一截。

10 套配色各有性格，挑的时候不用纠结"哪个最对"，点一下看两秒就知道合不合眼缘 —— 极夜蓝、深海蓝偏沉稳，适合长时间盯代码；樱花粉、落日橙偏活泼，演示或自己用着开心；石墨灰最中性，什么环境都不挑。想再进一步，毛玻璃背景（acrylic）和主题是可以搭着调的：深色主题配亚克力背景，层次感会出来；老机器嫌卡就 --no-acrylic，主题照常用。

窗口本身也有几个跟配置相关的细节。它没有系统标题栏，但可以拖动、四边都能缩放 —— 你失去的是那个老式标题栏，换来的是界面整块都能用。在多显示器上，缩放和显示是按每一块显示器各自的 DPI 感知的：你把窗口从 100% 缩放的屏拖到 150% 缩放的屏，它会按那块屏的比例重新适配，不会突然变大或变小。还有一个边界：窗口高度不可能超过屏幕高度（系统会截短它），想一启动就贴合可视高度，用 --fit 让它自动收进工作区即可。

七、配置写错了怎么办

手抖把 settings.ini 改坏了怎么办？别怕，这个分层设计本身就是兜底。首先，界面上的「参数设置」页是更安全的改法 —— 它只更新对应那一行，不会引入你手滑打出来的错行。其次，几个关键数值在程序内部是有"夹取"的：比如占屏比例算出来越界，会被夹回合理区间，不会算出负宽度。

还有一类"看着像配置问题、其实是运行问题"的情况，别去翻配置文件，去翻日志。程序留了几处诊断出口：吸附与布局的自检写进 dock.log，打包全过程写进每个项目目录的 pack.log，未处理的异常写进 error.log，反编译输出写进 apktool.log。比如你觉得"两扇窗口怎么没并排"，先打开 dock.log 看一眼布局自检记了什么 —— 大多数"配置不对"的错觉，其实是某一步运行时的状态问题，日志里一眼就能看出来。配置文件管的是"你想要什么"，日志管的是"实际发生了什么"，两者分开看，才不会乱调一通。

为什么删 settings.ini 也不慌？因为它管的全是"偏好"，而你的真资产 —— 各个项目、反编译产物、修改历史、打包日志 —— 全都在 Project 目录和每个项目自己的目录里，和配置文件完全分开。删配置丢的只是"窗口想多大"这种无所谓的东西，这正是分层设计想要的安全感：把容易被你改坏的东西，和不能丢的东西，物理上就分开放。

八、一套配置多场景：两个自家应用的实战

配置是死的，用法是活的。下面两个例子都来自我们自家应用和内部工具的日常，按"以前怎么做 / 现在怎么做 / 怎么验证"走一遍。

实例一：给自家「巡检打卡工具」改包时，把双窗调得更好用。 我们日常改这个内部应用，主窗口要看需求和历史，右边 AI 工作区窗口要展示改代码的过程。以前用默认占屏比例，主窗口一栏偏窄，写长需求时输入框老得横向挪。以前的做法是用鼠标硬拖两窗边界，拖完一次记一次手感，下次重启又得重摆。

现在翻一次 settings.ini：把两窗合计占屏比例从默认的 0.75 调到 0.8，再把两窗间隙加 8 像素让"是两个程序"这件事更清楚。改完重启一次，之后每次开机都是这个舒服的配比，不用再拖。验证很简单：主窗口写一句"把打卡成功提示改成『已签到』"点「立刻修改」，看右边窗口宽度够不够铺开 AI 输出的代码块、两窗顶边底边齐不齐 —— 满意就长期用，想临时演示更宽，下次加个 --share 0.9 参数就行，不动文件。

这个例子里最有意思的，是"调一次、长期用"和"临时覆盖、用完就忘"两种用法同时出现了：日常靠 settings.ini 沉淀舒服的配比，演示靠命令行参数临时拔高，互不干扰。如果你只在文件里死磕一个比例，要么平时将就不舒服，要么演示时手忙脚乱去改文件再改回来 —— 分层设计把这两种需求彻底分开了。

实例二：一台新机器，第一次跑通整个改包。 新同事领了台新电脑装软件，最担心的就是"工具链不齐、改了包打不出来"。以前我们得手动确认 java、apktool、aapt 这些在不在，缺了一个个找版本、配路径，折腾半天。

现在的流程顺得多：打开「参数设置」页，先跑一次工具链体检 —— 哪几项报缺失、各自路径是什么，一目了然；缺的项直接点「立刻更新」，程序自动下载解压工具包，装完重新检测，几项全部变"就绪"。顺便让程序自动挑好工作目录（D 盘 AiApkEditor），tools 和 Project 两个子目录就位。然后把自家的「资产盘点 APP」安装包拖进来，写一句"把底部按钮文字改成『提交盘点』"，点「立刻修改」 —— 等 AI 改完、自动出包，第一次改包就跑通了。验证：体检页五项全绿 + 打包出了 signed.apk + 装到测试机上按钮文字是新的，三件事齐了，环境就算彻底配好。

回头看这次"第一次跑通"，真正花时间的其实只有写需求和等出包那一下 —— 环境准备被压缩成了"看一眼体检页、点一次立刻更新"。这就是配置分层和工具链体检合在一起的价值：把"装环境"这种最劝退新人的环节，从一上午的手动摸索，变成几分钟的自动补齐。 新同事当天就能开始改自己的内部应用，而不是还在跟 java 版本和 apktool 路径搏斗。对我们这种要频繁给团队发新版的工作流来说，省下来的就是实打实的迭代速度。

这两个例子合起来说明一件事：配置分层的最终目的，是让"环境"和"偏好"都变成可一键体检、可一键恢复、可一次性覆盖的东西。 你不用记任何秘密路径，哪里不对翻哪份文件，改坏了也有退路。这就是我们想要的调参体验 —— 调的时候有得选，出问题的时候有得退。

九、用户评价、合规提醒与结语

再补一句心态上的建议：别一上来就把 settings.ini 从头调到尾。 默认值已经是大多数人舒服的档位，先用一两天，哪里真的别扭了再去动那一项 —— 一次只动一个值，动完重启看效果，不满意就改回来。调参这件事和改包一样，靠的是"小步验证"，不是"一次到位"。参数表、命令行、体检页这三件工具，各自管"长期、临时、环境"三件事，用对了地方，配置就再也不是负担。

把这篇收成一句：settings.ini 是你的，local.ini 是程序的，命令行参数是借的，工具链体检是兜底的。 四份东西各管一段，你只需要动第一份，剩下的交给程序自己记、自己体检、自己补齐。调参这件事，本来就该这么省心。

最后再划一次重点，方便你照着上手：日常只碰 settings.ini 和「参数设置」页，想临时换布局就用命令行参数，新机器先跑工具链体检、缺了点立刻更新，登录出问题才去动 local.ini。就这四条，覆盖了你和配置文件之间的全部关系。剩下的，交给程序自己记。你越不碰 local.ini，它就越稳；你越会用命令行参数做临时覆盖，settings.ini 里的长期配置就越干净。这就是分层设计想培养出来的手感。愿你调得顺手，改得顺心。

这也是安卓修改大师智改工坊想让你待的状态：只需说话，就能让应用变成你想要的样子 —— 连配置都给你分好层了，你只管写中文需求。产品介绍页与下载入口：https://www.apkeditor.cn/ai-version.aspx（官网 www.apkeditor.cn）。