# iOS Native 0.2.2

0.2.2 构建 7 把「分组」这个实体从应用里彻底删掉，归类只靠标签；同时完成第二轮配色与图标重构，
界面上不再出现蓝色。页面能力、上游白名单与本地数据布局见现行说明 [docs/ios-native.md](ios-native.md)，
本文只记录本次发布的变化。

## 本次变更

- 分组概念移除：删除分组视图、分组编辑器与分组仓储，实例模型不再有 `groupId`。升级后首次启动
  一次性删除 `Documents/instance-groups.json` 与偏好键 `fleet.groupMode`，本机不留死数据。
- 标签接管归类：新增「批量标签」表，批量选择后一次给多台节点贴同一个标签；每个标签显示
  「未贴 / N/M / 全部」三态覆盖度，点击即在整批上加减，也可以在同一张表里新建标签。卡片与
  标签条上的标签仍然可点，点一下即加入筛选。
- 配色重构，全应用零蓝色：主操作、选中态、进度填充一律用石墨墨色，黄铜只作图标点缀；颜色
  只保留给状态语义（危险红、告警琥珀、成功绿），健康读数回到墨色，深色主题不再整屏泛绿。
  浅色主题重做为中性冷灰画布加纯白卡片，深色主题为低明度石墨三层。
- 选中态可见性：主题切换块与状态图例胶囊原先用 10%~12% 色雾表示选中，浅色下几乎看不出来，
  改为实心主色加 `onPrimary` 文字，两套主题都一眼可读，且选中不改变控件尺寸。
- 应用图标重做：放弃立体卡与投影，改扁平石墨底加黄铜 SIM 面板，三根底部对齐的递增信号条，
  29pt 下轮廓仍可读；面板边长、圆角、切角与信号条间距可用环境变量调参后重新光栅化。
- 运行概览收紧：检测进度从读数格移进卡片副标题（`刚刚更新 · 已检测 6/6 台`）；读数栅格固定
  八格两行，温度与电量即使整群节点都没上报也保留「不可用」占位，栅格不再在七格与九格之间跳；
  概览量表健康时用墨色，只在告警与危险时上色。
- 实例详情头部重排：四项仪表从四枚嵌套小卡改为两列发丝线栅格，读数在上、进度在下，缺数据时
  保留空轨道，数据到位后卡片高度不变，修掉 0.2.1「加载完成后头部比下方窄一圈」的问题；身份摘要
  去掉内嵌底色，改用顶部发丝线分隔。
- 字段名补全：详情页里 `name`、`disk_total_bytes`、`disk_available_bytes`、`percent` 四个键
  此前直接把原始键名渲染到界面上，现补为「设备名称」「存储总量」「可用存储」「使用率」并排进
  固定顺序。
- 标签与方向胶囊中性化：`AITag` 拆成两类——不传状态色时是中性归类胶囊（浅底、发丝描边、墨色
  文字，可带图标），传状态色时才用色雾。详情页标签因此不再显示成近乎禁用的黑雾块，并与节点
  卡片同一形状同一图标；消息中心的「收件 / 发件」由绿色改回中性胶囊配上下箭头，绿色重新只
  表示健康状态。
- 批量标签表在没有任何勾选时给出「先在节点列表勾选要归类的节点」提示，不再留一行空白。
- 版本号显示去掉括号：设置页「应用信息」只显示 `0.2.2`。

## 文档同步

- 新增本文，[docs/ios-native.md](ios-native.md) 同步到 0.2.2：导航表去掉分组视图，节点总览与
  实例详情两节按实况重写，本地数据表删掉 `instance-groups.json`，设计语言一节改为石墨与墨色
  中性、颜色只留给状态、不含蓝色，偏离表新增分组一行。
- 仓库根 README 与 `apps/ios/README.md` 同步版本号、节点入口描述、目录说明与界面约定；界面
  约定里「主操作只用一种蓝色」按本次结论改写。

## 数据与安全

与 0.2.1 一致：实例信息保存在应用沙盒本地数据文件，实例密码保存在同一沙盒的私有凭据文件，
不使用 iOS Keychain，登录会话只存在于进程内存。应用仅连接用户添加的节点地址，不上传任何数据。
本次新增的唯一数据动作是删除遗留的分组文件，不改动实例、标签与凭据内容。

## 构建与安装

从仓库根目录构建：

```bash
./scripts/build-ios-ipa.sh
```

产物：

- `build/ipa/MultiSimAdmin.ipa`
- `build/ipa/MultiSimAdmin.ipa.sha256`

0.2.2 构建 7 校验值：

```text
0e4ffb74d03c2da5648e7bc039f67b14798e6d3aec723c206bce17da5b8f06fb  MultiSimAdmin.ipa
```

IPA 目标为 iOS 16.0 及以上，`arm64`，Bundle ID 为 `fun.chick.multi-simadmin`，未签名，
校验方式：

```bash
cd build/ipa && shasum -a 256 -c MultiSimAdmin.ipa.sha256
```