inkwatch

0 Fork 0

Files

T

History

jkooe 5f419bcb91 refactor(rename): pmon → inkwatch 全量改名（阶段 A：代码层，不碰数据层标识）

## 范围与边界

**本次只改代码层**：客户端包名、Android/iOS/macOS 标识、环境变量前缀、Rust crate 名、
类名/文件名、以及全部文案与注释。**数据层标识一处未动**（卷名 `pmon_pg_data`、
`POSTGRES_USER/DB`、连接串默认值），那些在阶段 B 单独做迁移，理由见下。

统计：**114 个文件、1687 处**替换 + **8 个文件/目录重命名**。

## 改了什么

| 类别 | 旧 | 新 |
|---|---|---|
| Dart 包名 | `pmon_client` | `inkwatch_client`（41 个文件的 import 同步） |
| Android namespace | `com.pmon.pmon_client` | `com.inkwatch.eink` |
| Android applicationId | `com.inkwatch.eink` | **保持不变** —— 它本来就已是新名 |
| Kotlin 包目录 | `kotlin/com/pmon/pmon_client/` | `kotlin/com/inkwatch/eink/` |
| macOS bundle | `com.pmon.pmonClient` | `com.inkwatch.eink` |
| 环境变量 | `PMON_*`（12 个） | `INKWATCH_*` |
| Rust crate | `pmon-core` / `pmon_core` | `inkwatch-core` / `inkwatch_core` |
| 动态库 | `libpmon_core.dylib` | `libinkwatch_core.dylib` |
| 类/文件 | `PmonApp` `PmonColors` `PmonChannel` `PmonCollectorService` `pmon_agent.dart` … | `Inkwatch*` / `inkwatch_*.dart` |

## 三处**必须单独说**的判断

**① applicationId 刻意没动。** `build.gradle.kts:49` 有既有说明：水墨屏专属版用
`com.inkwatch.eink`，与主干通用版**刻意不同**，为的是两版本能在同一台手机上共存
（versionCode 各自递增，同包名会互相覆盖且降级被拒装）。它已经是新名，动它反而
破坏这个设计。我改的是 `namespace`（内部分包名，只影响编译期），并把它统一到同一个
`com.inkwatch.eink`。

**② 局域网 P2P 线协议前缀一起改了**（`PMON-PUNCH:` / `PMON-PONG:` / `PMON-FRAME:` →
`INKWATCH-*`）。这**不是纯文案**：两端必须同时升级，否则新旧版本在同一局域网里互不
认。判断依据是这三个前缀只用于同一用户的两台设备直连，且当前尚未对外发布；若以后
要支持跨版本，正确做法是加协议版本协商而不是回退旧前缀。

**③ 数据层标识一处未动。** `deploy/` 下 28 个文件仍是 `pmon`，因为卷名/库名/库用户
的改动会直接导致连不上库或指向新空卷（`docker-compose.all.yml:26-29` 里写着：
改名会让 compose 去找 `inkwatch_pg_data` 这套新空卷，等于把生产清库）。实测当前
数据是 **2.5GB、128 个账号、58 台设备**，不是测试库。

## 安全网

动手前做了完整备份：
`.backup-rename-20261108/pmon_before_rename.dump`（`pg_dump -Fc`，152MB），
并记录了迁移前各表行数基线，供阶段 B 逐表比对。

## 验证

客户端全量 **595 通过 / 2 失败** —— 与改名前的数字**完全一致**，两条仍为
`libinkwatch_core.dylib` 未编译（Rust 核心未构建，环境缺口）。**数字一致**是这次
改名的核心判据：一个纯机械改名必须不改变任何测试结果，若通过数变了就说明改坏了东西。

服务端代码只动了注释与环境变量名，逻辑零改动，阶段 B 后一并回归。

2026-11-08 20:07:30 +08:00

accounts.js

feat(用户机制): 角色/邀请/自救/配额全部落地（13 项缺口关闭）

2026-10-30 12:52:51 +08:00

codec.js

rename: 项目对外名定为「墨观 InkWatch」

2026-09-16 12:09:53 +08:00

events.js

feat(events): 最小埋点 5 事件的闭环 —— 白名单、有界、写失败不阻断（M5）

2026-11-08 19:46:29 +08:00

history.js

feat(plan,history): 档位展示名与升档流程、历史窗口按档位截断、保留期换配置源（M2/M3/M7）