手机服务器（小米10 Pro · cmi · LineageOS 23.2 + 自编译内核）#

SSH 密钥见 credentials.local.md §手机（不入库）。2026-09-26/27 完成 HyperOS → LOS 迁移 + 自编译内核 + 墨账首个完整项目部署。2026-10-04 docker 存储驱动 vfs → overlay2（变更实录见「存储驱动」节与 CHANGELOG）。本文档 = 最终架构 + 全部踩坑实录。

📋 2026-10-06 全面评估（容器 / 程序全景、逻辑连接与耦合图、冗余与风险登记、面向「小龙虾连接万物」的收敛路线）见 docs/phone-assessment-2026-10-06.md。评估要点：容器守卫漏 openclaw/registry、周日 prune -af 风险、gateway 无 token、口令复用、deck 持 docker.sock、动作面缺失。 ⚠️ 该评估里的「10 容器 / 9 程序」是当日在场数；2026-10-21 实况 = 9 容器（8 running + n8n 停车）+ 13 supervisord 程序，openclaw / searxng 已于 10-20 退役。

🔧 2026-10-06（晚间）墨账大修：本文已按最新事实就地更新（架构 / 墨账部署 / 备份体系 / 遗留清单各节）；变更明细、证据与回滚见 CHANGELOG.md 当日「墨账大修」篇。本文只描述现状，不再堆日期流水。

设备信息#

项目	信息
型号	小米 10 Pro（M2001J1C，cmi），骁龙865 · 12G / 512G（2026-09-27 `free` 实测 11569MB 修正，此前误记 16G）
用户数据分区	f2fs（/dev/block/dm-41，465G，chroot 根与 docker 数据同盘）；⚠️ /tmp 是 tmpfs（内存盘）——overlay 实验勿放 /tmp
存储驱动	overlay2（2026-10-04 起），daemon.json 显式配置；docker 数据 /var/lib/docker 8.3G→2.0G，整机占用 17G→8.5G；f2fs 不在 docker 官方支持矩阵，启动会打 "Backing filesystem unsupported" 警告，功能正常属预期
系统	LineageOS 23.2（Android 16） nightly 2026-09-25 · 官方维护者 luffitys。2026-10-21 实读 `/proc/1/root/system/build.prop`：`ro.build.version.release=16`、`ro.build.display.id=BP4A.251205.006`、`ro.build.flavor=lineage_cmi-userdebug`、`ro.lineage.device=cmi`、`ro.product.system.name=lineage_cmi`、`ro.build.version.security_patch=2026-09-01`。⚠️ 该 build 没有 `ro.lineage.version`（`/system/etc/` 下也没有 `*.prop`）⇒ 「23.2」这个小版本号无法数值核实，只能由 Android 16 推断为 LOS 23.x
内核	4.19.325-cip131-st15-perf（自编译） = LOS 官方配置 + SYSVIPC/PID_NS/IPC_NS/POSIX_MQUEUE =y。2026-09-26 永久刷入 boot（Image 24MB）。原版 LOS 内核四项 =n —— 是 postgres/npm/容器隔离全家障碍的根因
内核重建	源码 `android_kernel_xiaomi_sm8250` lineage-23.2 分支（209MB tarball）+ PC staging `kernel/kconfig` 基线 + 云端 clang18 交叉编译（kbuild.sh ≈25 分钟，增量秒级）
回退	HyperOS 线刷包（用户持）+ 分区备份：PC `staging/backups/mi10p-backup/` + 云 `backups/mi10p/hyperos-boot/`（boot/dtbo/recovery/vbmeta）
Root	Magisk 30.7（TWRP 卡刷 magisk.zip）。无 KSU/SusFS/PIF（服务器场景零损失）。2026-10-21 实测 `util_functions.sh` 内 `MAGISK_VER='30.7'` / `MAGISK_VER_CODE=30700` 确认；`/data/adb/modules/` 只有 `mi10p_server` 一个模块
网络	内网 `192.168.10.199`，设备 MAC `e0:cc:f8:8a:6f:92`（LOS 后真实硬件 MAC）；静态租约在路由器 `/etc/config/dhcp`；⚠️ 2026-10-20 起路由器无代理，`devctl` 已删除 —— 本机出网是纯直连，需要代理只能在本机自己跑客户端
⚠️ 作废	192.168.10.226 / MAC c6:f0:57:01:9e:22 为 HyperOS 时代
adb	⚠️ HyperOS/LOS 每次重启后 USB 调试自动关闭——运维走 LAN SSH/云隧道两条通道，不依赖 adb

runc：1.1.12-stock-seccomp2（原版零补丁）#

⚠️ 裸 go build 必带：-tags seccomp + libseccomp-dev，否则容器报 "seccomp not supported"。二进制：手机 /usr/bin/runc、云 backups/mi10p/、PC staging。手机可自重建（goproxy.cn + TUNA Go）。

存储驱动：overlay2（2026-10-04 切换实录）#

项	值
前置	自编译内核本就含 `CONFIG_OVERLAY_FS=y`（当年被迫 vfs 只是 daemon.json 显式写死，非内核缺能力）；切换前实测 f2fs 上 overlay 挂载+写入 OK
变更	daemon.json `"storage-driver": "vfs"` → `"overlay2"`（仅此一词，mirrors 等其余字段不动）+ 清空 `/var/lib/docker/*`（8.3G）+ 重拉 6 镜像 + rm+run 重建 6 容器
数据安全	全部真数据在 bind 卷（/data/pg、/data/portal、/data/vw、/data/ntfy、/data/backups），物理上在 /var/lib/docker 之外，零波及；切换前手动跑了一次 backup-push.sh（127KB dump 已推云）
实测收益	docker 8.3G→2.0G、整机 17G→8.5G；vfs 时代「每次部署整层落盘+容器深拷」的膨胀类问题根除，周日 04:20 prune 从必须降级为保险
数据核验	账本 9 表原封（psql information_schema 计数）、指挥舱 deck.db 200、vault healthy、ntfy/canary 正常
云端验收	云上 `--resolve` 六路由：canary/portal/acctbk/deckapi/vault 全过；旧 APK 路径已随 Capacitor 壳退役，不再检查
回滚	daemon.json 改回 vfs + `rm -rf /var/lib/docker/*` + 同参重建（镜像在云 registry；不到万不得已不回，vfs 膨胀问题会复发）
副产物	overlay2 就位后手机本地 `docker build` 缓存机制成立——npm 那个 "Exit handler never called"（约束 #7）是否 vfs 相关值得重测，通了手机即有第三条构建路径（原生 arm64 免 qemu）

架构（最终版）#

启动链：Magisk 存根模块 mi10p_server（一行调 service.sh；模块永不再改，逻辑全在
        普通文件可热改） + /data/adb/service.d 双触发
        → service.sh（wakelock + WiFi 省电关 + 限充看门狗 v2 + chroot-boot.sh v7）
        → pivot ns v7：busybox unshare -m → make-rprivate → bind /data/linux →
          pivot_root → sysfs + cgroup v2 主机层级 bind → umount old_root → 清 docker.pid
        → supervisord 程序（**2026-10-30 实测 16 个，全 RUNNING**；fortune-json / ds-proxy 已随退役移除）：sshd / dockerd /
          **tunnel-core + tunnel-panels**（autossh；2026-10-06 由「单进程 5 条 -R」拆分——
          core = 15222 SSH / 15301 墨账 / 15303 vault，
          panels = 15300 canary / 15302 指挥舱 / **15304 运维可视化**；
          拆分原因：任一转发失败曾导致全部公网入口一起掉）/ cron /
          backup-sidecar / status-api(:3011) / **jdguard(:3013)** / tunnel-jdguard / rtr-syslog /
          **desktop(:3014 手机桌面) 已于 2026-10-21 12:23 退役**（程序从 conf 注释、源码归档 `/root/archive/`）
          （ntfy-relay 已于 10-05 退役，10-06 从 conf 移除）

容器：  phone-portal（指挥舱 Flask+SQLite，host 网络 :3002，带 healthcheck）★ 2026-09-27 上线
          ★ **2026-10-21 v2.4.0 界面改版**（future-design：令牌/对比度/字阶收敛、线性 SVG 图标、异常明细弹层、轮询熔断、移动端无溢出）；镜像经「云端 save → PC → 手机 load」投递，**手机 localhost:5000 是手机自己的 registry，不要用 pull 部署**
        phone-opsviz（**运维可视化** Flask+SQLite，host 网络 **127.0.0.1:3006**，带 healthcheck）
          ★ 2026-10-06 上线；内容由 PC 侧 publish.py 推入 /data/opsviz/content，按 mtime 热加载
        phone-accountbook-postgres（postgres:16-alpine，/data/pg bind，127.0.0.1:5432，
          **TZ=Asia/Shanghai**、healthcheck、内存上限 1G）★ 2026-10-06 重建
        phone-accountbook-app（`localhost:5000/accountbook:20261031-47078ff`，host 网络 **127.0.0.1:3001**，
          **TZ=CST-8**、healthcheck 打 `/accountbook/api/health`、内存上限 512M）★ 2026-10-06 重建
        phone-mozhang-v2-postgres（postgres:16-alpine，**/data/pg-v2** bind，127.0.0.1:**5544**，
          DB `mozhang_v2`，TZ=Asia/Shanghai、healthcheck、内存上限 512M）★ 2026-11-03 新建
        phone-mozhang-v2-app（`mozhang-v2-api:2.1.0`，host 网络 **127.0.0.1:3015**，
          TZ=Asia/Shanghai、healthcheck 打 `/api/v1/health`、内存上限 512M）★ 2026-11-03 新建
        phone-demo（金丝雀 :3000；**失败重试版**，防端口被短暂占用即 bind 失败退出）★ 2026-10-06 加固
        phone-registry（registry:2 私有镜像仓，host 网络 :5000，/data/registry bind，LAN-only）★ 2026-10-04
        phone-ntfy（ntfy v2.28.0 通知总线，host 网络 :3003，LAN-only 不上公网）★ 2026-09-27
        phone-searxng（SearXNG 私有搜索 + JSON API，host 网络 :3005，LAN-only）★ 2026-10-05  ❌ **2026-10-20 已删除**（容器/镜像/数据）
        ~~phone-n8n~~（n8n 2.41.6，:3004）★ 2026-10-05  ❌ **2026-10-21 已删除**（容器/镜像/数据/备份 cron/入口）
        phone-vaultwarden（密码库，host 网络 ROCKET_ADDRESS=127.0.0.1:8222）★ 2026-09-27
        openclaw（🦞 微信 ClawBot 智能体，host 网络，gateway loopback:18789 **+ auth.token**，  ❌ **2026-10-20 已退役删除**（容器/镜像/数据；通知改走 Server酱 直推）
          日志配额 20m×3 / LOG_LEVEL=info / 内存上限 5G）★ 2026-10-05
镜像：  localhost:5000/accountbook:latest → **即 `accountbook:20261031-47078ff`**（2026-11-01 00:05 部署；
        `/accountbook/api/health` 回显 version=20261031-47078ff / commit=47078ff / migrations 11/11）
        回滚标签链（均由 v20 之后逐版留存，共 14 个至 10-30）：`20261005-v20` → `20261006-obs2c` →
        `20261010-datefix` `20261010-carbon` `20261010-p0fix` `20261010-apkfix` `20261010-f12` →
        `20261011-ui-align` `20261011-ui-align2` `20261011-brand` `20261011-motion` `20261011-motion2` →
        `20261021-2446799` → `20261028-353600f` → `20261030-0cbeb87` → **`20261031-47078ff`（latest）**
        本地镜像共 25 个（docker system df：镜像 2.39GB，其中 602MB 可回收）
        localhost:5000/phone-portal:latest（云端 qemu arm64 构建，见 server-ops/dashboard/）

对外：  https://phone.zmlr.top/ → 指挥舱（全栈监控台，隧道 15302 → 手机:3002）
        https://ops.zmlr.top/ → **运维可视化**（设备档案/拓扑/变更记录，隧道 15304 → 手机:3006）
        https://phone.zmlr.top/accountbook/login → 墨账（隧道 15301 → 手机:3001）
        https://mozhang.zmlr.top/api/v1/health → **墨账 v2**（隧道 15312 → 手机:3015，独立库）
        https://phone.zmlr.top/accountbook/api/health → 墨账健康探针（免鉴权；回显版本/迁移数）
        https://phone.zmlr.top/canary → 金丝雀探针（隧道 15300 → 手机:3000）
        https://phone.zmlr.top/vault/ → Vaultwarden 密码库（隧道 15303 → 手机:8222）
        链路：云 nginx(TLS，已加 nosniff/SAMEORIGIN/no-referrer/HSTS) → 隧道 15300-15303 → 手机容器
        ⚠️ 隧道数据端口 15300-15303 在云端已用 iptables 限制**仅 docker 网段**可达（10-06 加固）
        规则原文：`-A INPUT ! -s 172.16.0.0/12 -p tcp -m tcp --dport 153xx -j DROP`
        **云端排查三条量具铁律（2026-10-27 实测踩坑，八荣八耻第 2 条）**：
        1. 因为那条 DROP，**在云上 `curl 127.0.0.1:15302` 必然 `000` 超时，那是量具错不是故障**；
           本机验隧道要用 `curl --interface 172.17.0.1 http://172.17.0.1:15302/`，
           最省事的是 PC 侧直接打 `https://ops.zmlr.top/`。
        2. 云 `GatewayPorts yes` 会把 `-R 172.17.0.1:153xx` 提升成 `0.0.0.0:153xx`，
           所以 `ss -tln | grep '172.17.0.1:15'` 数出 0 个属**量具错**，要 `grep -E ':(15222|1530[0-6])\s'`。
        3. `curl` 一结束就关 socket，事后 `ss -tn` 看不到连接**不代表没连过**；要抓过程得让 curl 后台跑再采样。
备份：  每日 03:40 墨账 pg_dump / 04:10 vw sqlite 快照 → **加密后**（openssl enc）推 云/backups/（*.gz.enc）
        本地明文只留 /data/backups（指挥舱与探针读它）；PC 每日拉密文 + 月度自动恢复演练——详见「备份体系」节
维护：  每周日 04:20 `docker image prune -f`（原 `-af` 会吃掉回滚资产，10-06 已改；日志 /var/log/docker-prune.log）
        daemon.json 全局日志配额 20m×3（10-06 起，对新建容器生效）；指挥舱自身数据库在 bind 卷 /data/portal
管理：  ssh -i ~/.ssh/mi10p_ed25519 root@192.168.10.199（= chroot/pivot 世界）
        隧道恢复：`bash /root/tunnels.sh restart`（= `supervisorctl restart tunnel-core tunnel-panels tunnel-jdguard`）
        **隧道真正的守护者是 supervisord**（`/etc/supervisor/supervisord.conf` 三个 program：
        tunnel-core 15222/15301/15303、tunnel-panels 15300/15302/15304/15306、tunnel-jdguard 15305；
        `autostart=true autorestart=true startsecs=10 startretries=999`）。
        🕳️ **supervisord 盲区（2026-10-27 实锤，16 小时零重启就是它）**：supervisord 只判「进程是否退出」，
        **autossh 父进程活着、ssh 子进程反复失败**时状态永远是 RUNNING，`autorestart` 永不触发。
        这次 10-26 12:17 → 10-27 04:06 的静默断线就是：云端旧 sshd 会话占着 153xx，
        `ExitOnForwardFailure` 让每次重连立即失败，父进程空转，supervisord 看它「健康」。
        ⇒ **半死只能靠 `supervisorctl restart tunnel-core tunnel-panels tunnel-jdguard` 治好**
        （或 pkill 父进程让 supervisord 看到 exit 再自己 spawn）。杀完 supervisord 会自己拉新一批，
        但**别 pkill 完自己再 setsid 起一份 autossh** —— 双份抢 `-R` 端口就是 `remote port forwarding failed` 的来源。
        ⇒ 判据：`supervisorctl status | grep tunnel` 全 RUNNING **≠** 隧道通；
        必须看手机 `ss -tnp | grep ':22 '` 有 3 条 ESTAB + PC 侧公网入口 200，才算真通。
         🔁 **端到端自愈 cron（2026-10-27 04:30 装，实测 04:30:01 自动执行成功，兜住上面这个盲区）**：
         `/root/tunnel-health.sh` 每 2 分钟探测五组公网入口 —— tunnel-core→`https://phone.zmlr.top/vault/`、
         tunnel-panels→`https://ops.zmlr.top/`、tunnel-jdguard→`https://phone.zmlr.top/jd/`、
         tunnel-pcwake→`https://wake.zmlr.top/health`、**tunnel-startpage→`https://start.zmlr.top/`（2026-11-01 新增）**；
         判据是「curl 返回码 **非 000 且非 5xx**」，**不能写成 =200**：`ops.zmlr.top` 在手机侧本来就 302 → /login。
         任一组连续 3 次（≈6 分钟）不健康 → `supervisorctl restart <program>`，之后 10 分钟冷却
         （`/tmp/tunnel-health.cool`）；健康时完全静默，只在失败 / 恢复 / 重启时写 `/var/log/tunnel-health.log`，
         每次运行 touch `/tmp/tunnel-health.last` —— **验证 cron 是否活着看这个 mtime，健康时日志没有新行是正常的**。
         cron 行：`*/2 * * * * /root/tunnel-health.sh >/dev/null 2>&1`；
         回退：`crontab -l | grep -v tunnel-health | crontab -`。
         ⚠️ **cron 真实 spool = `/var/spool/cron/crontabs/root`**（cronie，`cron -f` 由 supervisord 管）；
         `/var/spool/cron/root`（1114 B，mtime 10-20）是**孤儿文件，改了不生效**；`/etc/crontabs/root` 本机**不存在**。
         验证过：04:30:01 由 cron 自动执行（`/tmp/tunnel-health.last` 时间戳对上 `*/2` 触发点），当时三组状态文件均 0；2026-11-01 扩到五组后 startpage 手动跑一次状态 0；
         04:31 用假探针**真实触发过一次重启** —— `tunnel-jdguard: stopped / started`，25 s 后新 pid 21531、
         `/jd` 恢复 200，另两组未被动（只重启失败那组）。
通知：  ntfy :3003 仅作事件总线（中继已退役，不再直达微信）；**人类告警走 Server酱直推**
        （`/root/direct-push.sh`，异常才推）；容器守卫 + 电池心跳 cron 每 5 分钟，新鲜度守卫每小时的 17 分

端口总表（权威 · 2026-10-21 实测收口）🔌#

规矩：凡只经隧道对外的一律绑 127.0.0.1；绑 0.0.0.0 的必须有「为什么必须 LAN 直连」的理由。云侧反向转发一律指向 172.17.0.1:15xxx，从不直连手机端口。

端口	绑定	归属	用途	对外路径
22	0.0.0.0	sshd	管理 SSH + 承载全部 `-R` 反向隧道	LAN；云 `15222`（安全组不放行）
3000	`*`	phone-demo（busybox httpd）	金丝雀探针	云 `/canary`（15300）
3001	127.0.0.1	phone-accountbook-app	墨账旧版	云 `/accountbook`（15301）
3015	127.0.0.1	phone-mozhang-v2-app	墨账 v2	云 `mozhang.zmlr.top`（15312）
5544	127.0.0.1	phone-mozhang-v2-postgres	墨账 v2 数据库	内部
3002	127.0.0.1	phone-portal（gunicorn）	指挥舱	云 `/`（15302）
3003	`*`	phone-ntfy	通知总线	LAN only（云 `/ntfy` 302 回内网）
3006	127.0.0.1	phone-opsviz	运维可视化	云 `ops.zmlr.top`（15304）
3011	127.0.0.1	status-api	指挥舱的数据底座	内部
3013	0.0.0.0	jdguard	京东挂机面板	云 `/jd/`（15305）+ LAN 直连（故必须绑 0.0.0.0）
3021	127.0.0.1	apigoto	COMMAND CODE 管理台（2026-11-14 由 OPENCODE 版原地替换；程序名/端口沿用旧值，Node 单文件 + supervisord）	云 `apigoto.zmlr.top`（15306）
3022	127.0.0.1	startpage	启动页（2026-10-30 上线；2026-11-01 起纯标准库静态服 + `/api/wallpaper`/`/api/favicon`/`/healthz`，站点根 `/srv/startpage/site/` 12 文件）	云 `start.zmlr.top`（15308）
3020	0.0.0.0	旧 pc_wake_server.py（legacy）	最早的 PC 唤醒按钮页（仅 LAN，token `43545644db3f`），保留只为旧书签不 404；06:26 定时已停用，功能性维护全部转到 3030	LAN only
3030	0.0.0.0	pcwake	PC 遥控台（2026-10-29 上线，纯标准库 Python 单文件 `/srv/pcwake/app.py`，含登录口令）	云 `wake.zmlr.top`（15307）+ LAN 直连（故绑 0.0.0.0）
~~3014~~	~~0.0.0.0~~	~~phone-desktop~~	已退役 2026-10-21 12:23（桌面本身不恢复；「把桌面里有用的小卡片并进指挥舱」留待后续单独决定）	无监听
5000	`*`	phone-registry	私有镜像仓 push/pull	LAN
5432	127.0.0.1	phone-accountbook-postgres	墨账数据库	内部
8222	127.0.0.1	phone-vaultwarden	Vaultwarden 密码库	云 `/vault/`（15303）

已退役（2026-10-21 实测无监听）：3004 n8n · 3005 SearXNG · 3010 fortune-json（n8n 运势桥）· 3012 ds-proxy（OpenClaw 计量）· 18789 OpenClaw gateway。 隧道 ↔ 本地端口：15222→22 · 15300→3000 · 15301→3001 · 15302→3002 · 15303→8222 · 15304→3006 · 15305→3013 · 15306→3021 · 15307→3030（pcwake）· 15308→3022（startpage） · 15312→3015（墨账 v2）。

文件结构地图 ⭐（chroot 世界内，防覆盖必读）#

路径	归属	说明
`/data/linux/`	chroot 根	Android 侧 pivot 世界根，勿动
`/data/pg/`	墨账 postgres	bind 卷，数据真身
`/data/pg-v2/`	墨账 v2 postgres	独立 bind 卷；`mozhang_v2` 库，端口 5544
`/data/mozhang-v2/`	墨账 v2 应用	`backups/`（服务端快照）、`releases/`（APK + manifest）、`import-report.json`
`/data/backups/`	墨账+Vaultwarden 备份	accountbook_*.dump.gz 留 14 份 + latest.dump.gz；vw/ 留 14 份 tar.gz
`/data/portal/`	指挥舱	deck.db（SQLite 正本）+ WAL
`/data/opsviz/`	运维可视化（2026-10-06 起）	content/content.json（PC 发布器写，mtime 热加载）+ ops.db（密码哈希/会话密钥/审计）
`/data/notify/`	小爱通知出口队列（2026-10-06 起）	`target`(600 收件人) + `outbox/`（生产者扔 JSON，应用零特权）+ `pending.jsonl`（重试≤3）+ `dead.jsonl`（死信）	；2026-10-20 起主通道小爱已退役：ops_notify.py 先探测容器，不在则直接走 Server酱兜底。🚩 2026-10-21：`dead.jsonl` 已 `shred -u -z -n 2` 销毁 —— 它 0666 全可读，3 条死信里 2 条是「每周口令轮换完成」通知正文，含墨账/运维可视化/指挥舱当前在线口令明文（轮换 10-19 已退役 ⇒ 不会自动换）；销毁前全盘查重（`/data /root /srv /etc /var/log /tmp`）确认口令串只此一处命中、`outbox/` 为空；追溯副本 `/root/archive/dead.jsonl.bak-20261021`（600 root-only，md5 `2024f17c…`），同批删 `report-guard.state` 残留（另备份 600）。现目录只剩 `outbox/ seen.jsonl target`
~~`/data/rotate/`~~	口令轮换状态（2026-10-06 起，700）	原 `state.json`(600)：三服务当前口令 + 上一版 + 轮换时间与验证结果	；❌ 2026-10-19 随口令轮换退役删除（2026-10-21 实测目录不存在），归档在 `/root/archive/rotate-retired-20261019/`
`/srv/status-api/`	状态 API + 调用计量 + 401 错误账	`status_api.py`（:3011 状态台数据底座）；`usage.jsonl`=成功调用账，`usage_errors.jsonl`=非 200 上游响应账（🚩 2026-10-07 新增，专抓 401）；回滚资产 `ds_proxy.py.bak-20261007-pre-errolog`	；❌ 2026-10-21 已移除 `ds_proxy.py` 的 supervisord 程序（唯一消费者 openclaw 于 10-20 退役，:3012 无监听），文件留档在 `/data/backups/retire-20261021/`
`/srv/jdguard/`	京东挂机守护 jdguard（2026-10-16 上线）	`app/` 10 文件（store/jdpanel/guard/notify/webapp/wskey/config/jdguard/crypto + panel.html，另有 4 个 `probe_.js` 与 `scripts/`、`logs/`）+ `.env`(600：站点账号 + v2 的 `SECRET_KEY`/`ALLOWED_USERS`/`ADMIN_PHONE` + `NTFY_URL`/`WECHAT_PUSH`) + `jdguard.db`(users 表 = phone/secret_enc/token/token_exp/sendkey_enc/created_at/last_login_at/wxpusher_enc（2026-10-26 起；pushplus_enc* 留作孤儿列），账号/wskey/事件，v2 起带 owner 归属)；supervisord `[program:jdguard]` → LAN :3013，20 分钟一轮巡检；配套 `[program:tunnel-jdguard]` → 云 `172.17.0.1:15305`。2026-10-21 实测 users=5 / accounts=16 / events=2535
`/srv/startpage/`	启动页 startpage（2026-10-30 上线；2026-11-01 第 1–4 批优化）	`app.py`（10629B / 310 行，纯标准库 `ThreadingHTTPServer`：`ROOT=/srv/startpage/site`、绑 127.0.0.1:3022、`.webmanifest`→`application/manifest+json`、图标 `max-age=604800` 其余 `no-cache`、禁目录列表 + nosniff；新增 `/api/wallpaper`（picsum 缓存）、`/api/favicon`（内网图标代抓：仅字面私有 IP/固定路径/512KB/2s/240 次每分钟/重定向限私有 IP/响应 `CSP: sandbox`）、`/healthz`）+ `site/` 12 文件（index.html / assets/{app.css,app.js,boot.js} / data/sites.js / sw.js / manifest.webmanifest / icons×5）；supervisord `[program:startpage]` → :3022、`[program:tunnel-startpage]` → 云 `172.17.0.1:15308`（autossh 已加 `-C`，日志 `/var/log/tunnel-startpage.log` 2MB×3），startpage 日志 `/var/log/startpage.log`（2MB×3）。PC 正本 `D:Projects手机服务器startpage`（git 已初始化，提交 `c1529f5`/`acc125e`/`b2c49ff`）；发版 = `python deploy.py --yes`（前端）/ `python deploy.py --server --yes`（含 app.py，自动备份+重启+校验）；缓存版本自动按内容哈希生成（当前 `startpage-ace36ed9`）；备份 `/srv/startpage/backups/`（站点 tar + app.py，各留 10 份）；2026-11-05：首页长按拖拽排序上线（纯前端，提交 `151f245`）
`/srv/apigoto/`	COMMAND CODE 管理台（2026-11-14 原地替换 OPENCODE 版；目录名与 supervisord 程序名沿用，避免动 Caddy/隧道）	两文件：`service.js`（703 行，零依赖 Node：口令登录 + `/api/state` 聚合 + `/api/raw` 白名单代理 + 每分钟采样 `/alpha/billing/credits` + 阈值事件）+ `index.html`（974 行单页前端，四个 tab：概览/用量/密钥/设置）。`data -> /data/apigoto`（auth.json 沿用旧口令、commandcode.json 存 API Key 与账号快照、history.json 采样点、settings.json 阈值、events.json 事件）。supervisord `[program:apigoto]` → 绑 127.0.0.1:3021，`PORT/HOST/TRUST_PROXY` 走 environment，日志 `/var/log/apigoto.log`（10MB×3）；前端改动不用重启（每请求 readFileSync 读 index.html）· 回滚备份 `/srv/apigoto.ccbak-20261114-2107` 与 `/data/apigoto.ccbak-20261114-2107`，旧 opencode 数据归档在 `/data/apigoto/_opencode-20261114-2107/`
`/srv/pcwake/`	PC 遥控台 pcwake（2026-10-29 上线）	单文件 `app.py`（约 805 行，纯标准库：WoL 魔术包 / 定时唤醒 / 手机状态 / Server酱通知 / 口令登录）；状态 `/data/pcwake/state.json`（settings + schedules + logs，含 pwd_hash；口令见 credentials §手机服务器）；supervisord `[program:pcwake]` → 0.0.0.0:3030，`[program:tunnel-pcwake]` → 云 `172.17.0.1:15307`；日志 `/var/log/pcwake.log`。PC 正本 `D:Projects本机PCpcwakeapp.py`（发版 = scp → `supervisorctl restart pcwake`）
`/data/apigoto/`	apigoto 数据（0700 root）	auth.json(600，salt/hash，口令 sha256(salt+'	'+pw)，两次换版未动) / commandcode.json(600，Command Code API Key 明文 + 账号快照) / history.json(采样点，上限 8640) / settings.json(阈值) / events.json(事件) / sessions.json；归档 `_legacy-20261106-205023/`（APIGOTO 时代）、`_opencode-20261114-2107/`（OPENCODE 时代）。未纳入任何备份机制
~~`/srv/desktop/`~~	手机桌面 phone-desktop（2026-10-21 12:23 退役）	整目录已移走归档：`/root/archive/desktop-src-20261021/`（含 10-21 01:03–01:16 更新的 `index.html` 35821B / `_shell.js` 7623B / `server.py` 5499B，各留 `.old-20261021`），另有压缩包 `desktop-20261021.tar.gz`（200,586B，md5 `81f7add1d38a1752c27c843681cca1fb`，25 条目）；supervisord `[program:desktop]` 段已 `# DISABLED-20261021` 注释；PC 正本 `D:ProjectsPCphone-desktop`（`app/` 仍是 10-19 版，如恢复请用归档版）
`/data/ntfy/`	ntfy 通知总线	etc/（server.yml + client.yml）+ cache/（消息缓存 72h）
`/data/vw/`	Vaultwarden	db.sqlite3 + rsa_key.pem + attachments（密码库正本）
`/data/registry/`	phone-registry 镜像仓（2026-10-04 起）	docker build push 的落点；内含 10-04 双向验收的 test-alpine 残留（~3MB，可忽略）
`/data/searxng/`	SearXNG 私有搜索（2026-10-05 起）	settings.yml（bind 到容器 /etc/searxng；首启 entrypoint 会 FORCE_OWNERSHIP chown 为容器内 searxng 用户，root 可正常编辑）	；❌ 2026-10-20 已随退役删除
~~`/data/n8n/`~~	n8n 自动化中枢（2026-10-05 起）	❌ 2026-10-21 已删除（归档 `/data/backups/retire-20261021/n8n-data.tar.gz`，10 项）
~~`/data/n8n-bridge/`~~	n8n 运势数据桥（2026-10-05 起）	❌ 2026-10-21 已删除（连同 :3010 暴露进程；归档 `n8n-bridge.tar.gz`）
`/data/openclaw/`	OpenClaw 小龙虾（2026-10-05 起）	openclaw.json（provider 配置：现役 Command Code → `deepseek-v4.1-flash`；GLM coding 端点已随 10-07 下线失效）+ state/openclaw.sqlite（凭据档案 authProfiles.store + cron 任务 + 用量状态，2026-10-15 补档）+ 微信凭据；uid 1000 属主	；❌ 2026-10-20 已随退役删除
`/usr/local/bin/ntfy`	ntfy 中继二进制	v2.28.0 arm64（chroot 内，supervisord ntfy-relay 用）
`/usr/local/bin/serverchan.sh`	Server酱推送脚本	中继回调；日志写 /var/log/serverchan-relay.log
~~`/srv/portal/`~~	已删除	静态门户旧方案残留，2026-10-04 随遗留清理移除
~~`/var/log/fortune.log`~~	每日运势日志	❌ 2026-10-21 随服务退役（`/srv/fortune` 已删，归档 7.1 MB）
`/etc/supervisor/supervisord.conf`	supervisord	十六程序（2026-10-30 02:28，+startpage / tunnel-startpage）：sshd / dockerd / cron / backup-sidecar / status-api / rtr-syslog / tunnel-core / tunnel-panels / jdguard / tunnel-jdguard / apigoto / pcwake / tunnel-pcwake（fortune-json、ds-proxy、desktop 已于 10-21 退役移除；ntfy-relay 已退役；`tunnel` 于 10-06 拆 core/panels 两进程）；`.bak-deck-20260927` / `.bak-ntfy-20260927` / `.bak-vw-20260927` / `.bak-reg-20261004` 为各次改动前备份；2026-10-21 12:23 实测 10 程序全部 RUNNING（desktop 退役后），`/root/` 下另有 `supervisord.conf.bak-20261018` 与 `.bak-20261018-before-clean`（10-18 清理前留）；2026-11-01：`[program:tunnel-startpage]` 加 `-C` 与 `/var/log/tunnel-startpage.log` 2MB×3（备份 `.bak-20261101-tunnel-startpage`），实测 16 程序全 RUNNING
`/root/openclaw-up.sh`	OpenClaw 唯一拉起脚本	改 openclaw 容器参数（env/内存/日志配额）一律改这里再跑，别手敲 `docker run`；2026-10-15 起含 NODE_OPTIONS，备份 `.bak-20261015-1835`	；❌ 2026-10-20 移入 /data/backups/openclaw-retire-20261020-1944/root-scripts/
`/root/{ops_flush.py, ops_notify.py}`	通知两件套（2026-10-13 起；原「三件套」含 ops_rotate）	ops_flush 每分钟（`* * * * *`）排空 /data/notify 队列；日志 `/var/log/ops-{flush,notify}.log`	；❌ `ops_rotate.py` 2026-10-19 已删（口令轮换退役，2026-10-21 实测 `/root` 无此文件、crontab 无轮换行）
`/root/opsviz_puller.sh`	opsviz content.json 分片拉取安装（2026-10-19 建，长期保留）	出生证原文：「publish.py 的 SFTP 在这台手机上不可用时的替代发布手法」。PC 侧把 content.json 切成 12000 字节分片 + `manifest.txt` + `expected.txt`，起 `python -m http.server 8098`；手机跑 `bash /root/opsviz_puller.sh`（`B=http://192.168.10.111:8098`、`D=/data/opsviz/_chunks`，8 次重试 + md5 校验）；背景见踩坑 #23
`/root/report_guard.py`	日报投递守卫（2026-10-13 起，cron 每日 06:45）	判当天日报是否已投递，未投递即走兜底通道补发（10-14 实测小爱→Server酱兜底成功）；日志 `/var/log/report-guard.log`	；❌ 2026-10-20 已移除（早报整体迁 PC DSH 定时任务；手机侧 06:30 cron 已于 10-19 停用）
`/root/{router_syslog.py, openclaw-ws-backup.sh, openclaw-ws-commit.sh}`	路由器 syslog 收存 + OpenClaw 工作区备份/提交	rtr-syslog 由 supervisord 常驻 → `/var/log/router-syslog.log`；ws-backup 每日 04:30、ws-commit 每 10 分钟	；openclaw-ws-backup / openclaw-ws-commit 两脚本 2026-10-20 已移除
`/root/{vps_deal_watch.py, vps_deal_state.json}`	VPS 折扣每日值守 · 只采不推（2026-10-18 起，cron 每日 10:00）	抓 4 源（大鸟笔记优惠列表 + `?s=VMISS` + `?s=OrangeVPS` + 主机格调 cnvps）→ 与 state 基线比对 → 写摘要 `/var/log/vps-deal-digest/vps-deal-digest-<ts>.txt`（留 14 份），默认不推给主人（用户 2026-10-18：「每天推送没用…只要你能看懂就行」）；判定与回报由 DSH 定时任务 `VPS 折扣巡检`（每天 10:15）读摘要后筛出「能买的」才报；加 `--notify` 可恢复推送；日志 `/var/log/vps-deal-watch.log`；回滚 `python -u scriptsdeploy-vps-watch.py --rollback`（PC 侧 `D:ProjectsPCvps-watch`）
`/var/log/`	各程序日志	router-syslog / ds-proxy / backup-push / report-guard / ops-notify / ops-rotate / openclaw-ws-backup / openclaw-ws-commit / docker-prune / freshness-guard / vps-deal-watch 等；`ntfy-relay.err.log` 自 10-04 起静止（退役件）
`/root/.ssh/`	隧道密钥	id_ed25519 → 云 authorized_keys（command 限制）

指挥舱（phone-portal，2026-09-27 上线）#

项	值
形态	Docker 容器 `phone-portal`，host 网络 :3002，`--restart unless-stopped`
镜像	`localhost:5000/phone-portal:latest`（云端 qemu arm64 构建，源码在 server-ops 仓库 `dashboard/app/`）
依赖	bind：docker.sock + supervisor.sock（只读探针）、/data/backups:ro、/data/portal（DB）
功能	实时监控（电池/温度/负载/内存/磁盘/容器/进程/隧道回环）、24h 曲线（60s 采样留 7 天）、项目入口速览、24h 内事件审计
异常徽章口径 ⭐	计数 = `services`（supervisord 非 RUNNING）+ `checks`（项目 `check_url` 探活失败）+ `devices`（`online=false`）；`backup.age_h>26` 只算「注意」不算异常。2026-10-21 修两处：① `probe_state()` 原先吃全部项目（含 `enabled=0`）→ 已下线的死入口会永久计入异常，改为只探 `enabled` 项目（容器内 `/app/deck/api.py:54` 与源码 `dashboard/app/deck/api.py` 同步改；⚠️ 改的是镜像内文件，容器重建会回退，重建前以源码为准）；② 清掉 `accout-cloud`（域名 404）、`daidai`（盒下线→502）两条 disabled 项目行与已下线的魔百盒设备行 → 徽章恢复「全部正常」	—— ⚠️ 2026-10-06 起「项目/设备/历史」三页签下线，内容由运维可视化（ops.zmlr.top）接管；后端 `/deck/api/` 路由与 DB 三表保留未删*（归档，恢复页签只需还原 index.html + app.js 各两处）
鉴权	游客只读；管理员密码见 credentials §手机服务器（首次部署自动生成）
API	`/deck/api/`（⚠️ 勿用 `/api/`，已被墨账占用）；`GET /deck/api/export` = 注册表快照
双维护	页面 DB 为正本 → `python server-ops/dashboard/deploy.py sync` 回写仓库 `dashboard/data.json`（⚠️ 2026-10-06 用户指令：sync 暂停，恢复以用户指令为准）

运维可视化（phone-opsviz，2026-10-06 上线）🚩#

把静态的 server-ops-handbook.html 变成真前后端项目，并让指挥舱「项目/设备/历史」三页签退役 —— 这个模块本身就是本仓库档案的另一个阅读端：改档案即改站点，双维护问题被结构性消除。源码 server-ops/opsviz/（README 有完整架构与运维速查）。

项	值
访问	https://ops.zmlr.top/ · 全站密码保护（🔑 §运维可视化）；未登录 `/api/*` 一律 401、页面 302 → `/login`
形态	Docker 容器 `phone-opsviz`，host 网络只绑 127.0.0.1:3006（局域网无法直连，一律走云端 HTTPS 边缘），`--restart unless-stopped`、内存上限 256M、日志配额 20m×3
镜像	`phone-opsviz:1.0.0`（本地标签，回滚资产）← `localhost:5000/phone-opsviz` ← PC WSL2 `tools/build-arm64.sh` 构建推送
数据	`/data/opsviz/`：`content/content.json`（PC 发布器写）+ `ops.db`（密码哈希 / 会话密钥 / 审计）
内容来源	本仓库：`index.md` · `devices/*.md` · `SKILL.md` · `CHANGELOG.md`（白名单，`credentials.local.md` 永不入选）
发布	`python opsviz/publish.py`（PC）→ 白名单 + 凭据闸门 → content.json → SFTP 原子写；已装 git post-commit/post-merge 钩子，提交即发布；容器按 mtime 热加载，不重启
安全	凭据闸门命中即中止不落盘（明文凭据永不出 PC）；手机不 clone 私有仓库（PAT 不出 PC）
隧道	`tunnel-panels` 追加 `-R 172.17.0.1:15304:127.0.0.1:3006`；云端 15304 已入 iptables 限制（仅 docker 网段）+ `edge-firewall.sh` 持久化 + `edge-guard.sh` 两处端口表
验收	云侧 `--resolve` 14 项断言全绿（登录页 200 / 未登录 401 / health 200 / http→https 301 / 证书 SAN / 端口规则 / 既有路由回归）；本地另有 29 项端到端自检与 26 项 pytest
改动/回滚	见 CHANGELOG 2026-10-06「运维可视化上线」篇；回滚 = `docker rm -f phone-opsviz`（数据在 bind 卷）+ nginx/隧道/防火墙各自的 `.bak-opsv-20261006`
版本	当前 1.0.3（1.0.2 起多挂 `/data/notify` 与 `/data/rotate` 并补 `TZ=Asia/Shanghai`）。⚠️ 宿主 `/data/rotate` 2026-10-19 已删，容器仍带这条 bind mount（容器内为空目录，2026-10-21 实测 `total 0`）；清理需重建容器，未做

口令轮换 · 小爱通知 · 权限收紧（2026-10-06 深夜建成）🔐；❌ 口令轮换已于 2026-10-19 永久下线，2026-10-21 残留清零归档（`/data/rotate`、`/root/ops_rotate.py`、crontab 轮换行早已移除；残留统一收进 `/root/archive/ops-rotate-retired-20261021/`，700，内含 `ops_rotate.py` + `crontab.bak-rotate-off-20261019` + `RETIRED.md`，旧目录 `rotate-retired-20261019/` 已并入后移除）；⚠️ 小爱通道 2026-10-20 已退役，通知改 Server酱直推。本节全部内容属历史，系统内已无任何自动轮换#

用户三条要求：改密要微信告知 / 所有项目口令每周自动轮换 / 小爱执行命令需批准但查数据不需要。设计、命令与坑见 ops/README.md，源码在仓库 ops/。

项	值
轮换目标	运维可视化（改 `ops.db` 哈希）· 指挥舱（改 `deck.db` 哈希）· 墨账（`PUT /accountbook/api/settings`，需旧口令）。Vaultwarden 主密码与外部 API key 不可自动轮换
轮换节奏	~~root crontab 周日 05:00 `python3 /root/ops_rotate.py --apply`~~ → ❌ 2026-10-19 起已取消（2026-10-21 实测 crontab 无此行、脚本已删）。退役前逻辑：逐服务"改 → 新口令可登录 → 旧口令失效"双向验证，任一失败只报异常不影响其它服务
通知出口	生产者只往 `/data/notify/outbox/` 扔 JSON（应用零特权，不需要 docker.sock/网关 token）；root crontab 每分钟 `/root/ops_flush.py --once` 消费 → `ops_notify.py` → `docker exec openclaw openclaw message send`	；2026-10-20 起：容器不在即直接走 Server酱
微信调用	`--target` 必须裸 id（带 `openclaw-weixin:` 前缀会 `ret=-3`）；成功判据只看 `deliveryStatus: sent`（rc=0 与 `"stage":"platform_send"` 在失败回执里同样出现）
失败兜底	单条最多重试 1 次 → 进 `pending.jsonl`（队列再试 ≤3 次）→ `dead.jsonl` 并放弃；flusher 有 flock 防重入 + 单轮 120s 预算
口令四落点	~~①线上服务 ②手机 `state.json`(600) ③PC `credentials.local.md` ④主人微信~~ → 现只剩两处：①线上（哈希库：`/data/opsviz/ops.db` 的 `settings.password_hash`、`/data/portal/deck.db` 同名字段、postgres 表 `ai_configs` 的 `access_password` 列）②`credentials.local.md`（唯一权威登记）。改密＝手工改线上 + 手工写档案，无自动追平
PC 回写	❌ 2026-10-21 退役：计划任务 `Ops-Secrets-Sync` 已 `schtasks /DISABLE`，回读 `Status: Disabled` / `Next Run: N/A` / 最后运行 10-21 09:20:01 `Last Result=1`；`ops/secrets_sync.py` 保留但文件头已标退役（备份 `secrets_sync.py.bak-20261021`），它读的 `/data/rotate/state.json` 已不存在 ⇒ 结构性失效。墓碑文档 `ops/README-retired.md`
小爱权限	`ask=on-miss` + 34 个只读可执行白名单（curl/opsq/cat/ls/grep/df/ps/stat/…）；`docker/rm/mv/chmod/sh/bash/python3` 等一律弹审批到微信，无人批准即拒（`askFallback=deny`）	（随小爱退役失效）
卡死兜底	`tools.exec.timeoutSeconds=60`（到点杀进程）+ `approvalRunningNoticeMs=5000`（审批通过后显示进行中）
只读助手	`/data/openclaw/workspace/bin/opsq`（status/trend/health/ntfy/today/search）—— 放在小爱 workspace 里是因为它是 bind 挂载，容器重建也不丢；容器内路径 `~/.openclaw/workspace/bin/opsq`	（/data/openclaw 已删除）
备份位置	权限改动前：`/root/archive/ops-20261006/{openclaw.json.pre-ops,approvals-get.pre-ops.txt,exec_approvals_config.pre-ops.txt}`
回滚	~~`python3 /root/claw_policy.py --rollback`（回免批准）+ crontab 去掉两行 + PC `schtasks /delete /tn Ops-Secrets-Sync /f`~~ → 三项已随退役失效；PC 任务故意保留不删（Disabled，可查历史），要复活才 `/ENABLE`（不建议，见 `ops/README-retired.md`）
验收	`python ops/deploy.py verify` 14 项全绿；轮换真跑 `round=3` 三服务 `verified=True`；公网改密 → 30s 内微信收到；测试 75 项通过

⚠️ 与小爱的既有约定相关：她的 workspace/AGENTS.md 与 06:30 早报 prompt 里用的是 curl，而 curl 在只读白名单里 → 收紧后它们照常工作，无需改动。若日后给她新命令（尤其任何写操作），记得同步加白名单或接受"每次要主人批准"。 ⚠️ ln -s 类命令若在小爱会话里跑，注意她的 workspace 是 bind 挂载，写进去的文件宿主可见。

ntfy 通知总线 + Server酱中继（2026-09-27 上线 · 10-05 起微信实时推送退役）#

⚠️ 2026-10-05 起：ntfy-relay（→Server酱→微信）已停用（autostart=false，conf 备份 .bak-relay-off-20261005）——全部通知收敛进 OpenClaw 小龙虾 06:30 日报（2026-10-07 由 07:35 前移）。ntfy 容器保留（内部缓存 72h 事件 = 小龙虾日报的数据源，备份/告警/心跳脚本照常发 ntfy）；回滚=supervisord conf 恢复备份 + reread/update。

项	值
服务端	容器 `phone-ntfy`（binwiederhier/ntfy v2.28.0），host 网络 :3003，LAN-only 不上公网、无认证
中继	supervisord 程序 `ntfy-relay`：`/usr/local/bin/ntfy subscribe --config=/data/ntfy/etc/client.yml --from-config`
推送	`/usr/local/bin/serverchan.sh` → Server酱（SendKey 在 supervisord environment + credentials §Server酱，年费会员）
主题	`mi10p-backup`（每日备份结果→微信）/ `mi10p-alert`（异常告警→微信）/ `mi10p-heartbeat`（充电状态翻转→同样推微信，2026-09-27 复盘②起接入中继）/ `mi10p-daily`（每日 07:30 早安运势→微信，2026-10-03 起）
定时器	cron 每 5 分钟：`/root/container-guard.sh`（2026-10-21 实测 EXPECTED = 8 容器：portal / accountbook-postgres / accountbook-app / demo / ntfy / vaultwarden / registry / opsviz——opsviz 自 10-06 上线起一直漏守，10-21 已补进 `EXPECTED`（见遗留 #22）；n8n 停车故移出；另守 supervisor 程序，v2 awk 状态键去重）、`/root/battery-heartbeat.sh`（状态翻转心跳 / ≤30% 未充电告警；电流口径正=充电 / 负=放电，与指挥舱一致）
消息缓存	/data/ntfy/cache（72h，中继掉线不丢消息）
日志	/var/log/serverchan-relay.log（⚠️ ntfy 不转发子命令 stdout，脚本日志必须写文件）

每日运势 fortune-daily（2026-10-03 上线 → 2026-10-21 服务端整体退役删除）#

❌ 2026-10-21 已删：/srv/fortune（25 MB，含 venv）+ 每日 06:00 的 fortune.compute cron + :3010 桥 + 指挥舱入口。退役原因：推送链 10-05 已交给 n8n，而 n8n 依赖的 SearXNG 与 OpenClaw 相继退役 ⇒ 数据每天算但无人消费。归档 /data/backups/retire-20261021/fortune-srv.tar.gz（1781 项）。以下为历史。

✅ 排盘正本改在 PC：D:\Projects\PC\fortune-daily（scripts/pc-compute.sh → out/today.json）。每日 06:30 早报的配方（v8）在 D:\Projects\PC\dsh-wechat-review\docs\openclaw服务清单与继承计划.md §五 + 定时任务提示词（DSH schedule.json schedule-e01d2e6f…）；排盘失败不要回退手机 3010（已删，curl code=000）。

⚠️ 2026-10-05 起：每日 07:30 微信推送改由 n8n「AI 早报」工作流承担（搜索+整合路线，同主题 mi10p-daily）。本节保留为回滚档案：代码仍在 /srv/fortune/，crontab 行已注释（恢复=取消注释）。

项	值
形态	无容器：chroot 裸 Python 脚本 + root crontab（`30 7 * * * /srv/fortune/run.sh >> /var/log/fortune.log 2>&1`）
代码	本地仓库 `D:ProjectsPCfortune-daily`（git）→ SFTP 同步至 `/srv/fortune/`；`run.sh` = `cd /srv/fortune && venv/bin/python -m fortune.daily`
环境	`python3-venv`（2026-10-03 apt 装，chroot 原无 pip）+ venv，依赖仅 lunar-python；HTTP 全走标准库 urllib
内容	农历2000-03-19辰时八字（庚辰庚辰辛亥壬辰，lunar-python+sxtwl 双库验证）当日排盘 + 梅花易数起卦 + 塔罗每日一牌（日期种子幂等）+ 金牛座指数 + Open-Meteo 溧阳天气 → GLM 写生活化文案
LLM	智谱 GLM（key 在 `/srv/fortune/config.local.json` + credentials §每日运势）；默认 glm-4.5-flash（thinking disabled），备用 glm-4-flash；3 次重试后仍失败 → 本地模板兜底，保证每日必达
通知	ntfy 主题 `mi10p-daily`（client.yml 已订阅，⚠️ title 中文走 URL 参数 quote，不走 HTTP 头）
已踩坑	lunar_python.util.LunarUtil.ZHI 为 1-based（[0] 空占位）——年支序直接 `ZHI.index(支)`，勿再 +1（首日曾双重偏移致卦错）

SearXNG 私有搜索引擎（2026-10-05 上线 → 2026-10-20 弃用 / 10-21 入口清零） —— 容器/镜像/数据 2026-10-20 已删除；指挥舱入口 2026-10-21 已删#

❌ 已弃用，不要再用、不要当检索入口（用户 2026-10-20：「SearXNG 已经全面弃用」）。检索一律走 DSH 自带的 dsh-free-search 插件（web_search / multi_search / research / web_fetch）。容器与数据暂时保留未删（docker start 可回），但出网仍钉着已消失的路由器 7893，恢复运行也不会通国外引擎。本节以下内容仅作历史参考。

项	值
容器	`phone-searxng`，host 网络 + `SEARXNG_PORT=3005`，`--restart unless-stopped`
镜像	`searxng/searxng:latest`（官方多架构 arm64；2026-10 版为 granian 服务器，端口旋钮 `SEARXNG_PORT`，旧 `SEARXNG_BIND_ADDRESS` 已废弃不生效；挂载必须是目录，entrypoint 会 FORCE_OWNERSHIP chown）
用途	元搜索聚合（261 引擎，含 baidu/google/bing/ddg）+ JSON API（`?format=json`，已开启）——PC 侧 AI 助手检索、脚本/n8n 调用、浏览器默认搜索引擎 `http://192.168.10.199:3005/search?q=%s`
MCP 封装	PC 侧 `C:UsersAmor.zcodemcpsearxng-mcp.py`（FastMCP，mcp<2）→ ~~ZCode 用户级工具 `web_search`~~（注册 `~/.zcode/cli/config.json`，10-05 起）。⏸ 2026-10-07 ZCode 永久下线 → 该 MCP 注册闲置；SearXNG 服务与 JSON API 照常，PC 侧改用 DSH 自带检索工具
出网	⚠️ 2026-10-20 起失灵：`settings.yml` 里 `outgoing.proxies: {all://: [http://192.168.10.1:7893]}` 指向的路由器 mihomo 7893 已不存在（代理栈全量下线）⇒ 该上游连不上，国外引擎（google/bing/ddg 等）全部请求失败，实际只剩国内引擎可用。修法二选一：① 把 `outgoing.proxies` 删掉（纯直连，国外引擎仍不可用）；② 改指向手机自己能连的代理（例如在手机侧起一个客户端，或指向 PC 的 `192.168.10.111:7892`——需客户端允 LAN 接入）。改完 `docker restart phone-searxng`。⚠️ 新版 schema 只收 str/dict，列表写法直接 ValueError 拒启
访问	LAN-only 不上公网；limiter=false 无 valkey；改 settings.yml 后 `docker restart phone-searxng` 生效
已知行为	ahmia/torch（onion）引擎加载失败=常态噪音；单引擎被风控（百度 CAPTCHA 实测过）自动 Suspended 不拖累整体
验收	healthz 200；JSON 中英文查询有结果（2026-10-20 之后：国内查询应正常，国外查询预期变差——这是代理下线后的已知降级，不是新故障）
回滚	`docker rm -f phone-searxng && rm -rf /data/searxng`（无状态）；PC 副本 `D:ProjectsPCsearxng-deploy`（settings.yml + 部署脚本）

n8n 自动化中枢（2026-10-05 上线 → 2026-10-21 删除）#

❌ 2026-10-21 已删：容器 phone-n8n（Exited 2 周）、镜像 n8nio/n8n:latest（1.04 GB）、/data/n8n、每周日 04:25 备份 cron + /root/n8n-backup.sh、指挥舱入口。唯一工作流「AI 早报」上游（SearXNG / fortune 桥 / OpenClaw）全部退役 ⇒ 无复活价值。归档 n8n-data.tar.gz（10 项）+ n8n-backup.sh.retired。以下为历史。

项	值
容器	`phone-n8n`（n8nio/n8n 2.41.6），host 网络 + `N8N_PORT=3004`，`--restart unless-stopped`
数据	/data/n8n bind（→ 容器 /home/node/.n8n，SQLite；⚠️ 目录必须 `chown 1000:1000`，容器内 node 用户 uid=1000）
关键 env	`N8N_SECURE_COOKIE=false`（http 访问必需，否则登录死循环）/ `N8N_ENCRYPTION_KEY`（🔑 §手机服务器，丢了所有已存凭据不可解）/ `WEBHOOK_URL=http://192.168.10.199:3004/` / `GENERIC_TIMEZONE=Asia/Shanghai`（工作流 cron 时区）/ `N8N_RUNNERS_ENABLED=true`
访问	LAN-only http://192.168.10.199:3004（owner 🔑 §手机服务器）；公网 webhook 待需要时再挂隧道 /n8n（届时改 WEBHOOK_URL）
⚠️ 2.x 内部 API 坑	登录 `POST /rest/login` 字段 `emailOrLdapLoginId`；更新工作流 = PATCH（PUT/POST 均无此路由）；激活 = `POST /{id}/activate` body 需 {versionId}（每次 PATCH 后变）；所有响应包 `{data:...}`；executions 列表在 `data.results`
⚠️ Schedule Trigger 2.x 坑	days 模式分钟字段是 `triggerAtMinute`（单数）——沿用 1.x 的 `triggerAtMinutes` 被静默忽略=每天整点触发且注册即错过（表象是"定时永远不响"）；interval 模式 `minutesInterval` 未改名故正常；n8n 内部 API 操作工作流全流程脚本：PC `D:ProjectsPCsearxng-deployn8n-wf.py`
备份	`/root/n8n-backup.sh` 每日 04:25（crontab）：sqlite3 .backup 安全快照 + config + 密钥文件 → tar → /data/backups/n8n 留14 → scp 云 backups/phone-n8n/ → ntfy 通知（结构照抄 vw-backup.sh，脚本 600）
用途	可视化自动化工作流：定时/Webhook 触发 → HTTP/Postgres/GLM 处理 → ntfy→微信推送；候选：AI 早报（指挥舱 API+天气→GLM→微信）、告警防轰炸、消费周报
验收	healthz 200（秒级）；登录页 200；内存 ~390MB；guard 空跑零告警；备份实测推云成功
工作流	「AI 早报（运势+天气+趣闻）」 id `CSN7zcknF54tE7ND` · active · Schedule(days 07:30, `triggerAtMinute` 单数) → GET `127.0.0.1:3010/today.json`（本地排盘）→ SearXNG 天气/趣闻(time_range=day) → Code 汇总（忠实排盘硬约束 + emoji 轻松风 prompt，temperature 0.6）→ GLM(glm-4.5-flash，凭据「GLM 智谱」) → ntfy POST mi10p-daily（title 带 🌅）。10-05 实测：农历/卦名/塔罗/星座全部忠实+emoji 达标
运势数据桥	每日 06:00 cron（2026-10-07 由 07:05 前移）：`python -m fortune.compute`（fortune 仓库新增入口，只算不推）→ 写 `/data/n8n-bridge/today.json` → n8n 容器只读挂载 `/mnt/bridge` → HTTP 暴露 = supervisord 程序 `fortune-json`（`python3 -m http.server 3010 --bind 127.0.0.1`，conf 备份 `.bak-fortune-json-20261005`）；compute 有 argv 默认值 bug 修复史（见 fortune 仓库）
⚠️ 坑补充（v2 实战）	① `executeCommand` 节点在 2.41 不存在（activate 报 Unrecognized node type）→ 用 http.server 桥代替；② httpRequest 节点输出直接是 json（executeCommand 才有 stdout 字段）——换节点类型记得改下游引用；③ GLM 忠实度必须 prompt 硬约束（排盘值原样引用）+ temperature≤0.6，否则会自编运势

OpenClaw 小龙虾（2026-10-05 上线 · 微信官方 ClawBot 插件） —— 2026-10-20 已退役删除#

🔄 2026-10-20 起：功能在逐步迁移，OpenClaw 不再是终点。 用户定的新链路：DSH 自动化任务 → DSH 连微信 → 微信连手机（即由 DSH 侧的定时任务负责触发与编排，经微信触达手机，逐步取代小龙虾承担的日报/巡检/问答）。现状：容器与 06:30 日报仍在跑，但 ds_proxy 依赖的路由器 7893 已不存在，需实测确认还通；docker exec openclaw openclaw … 仍是当前唯一的微信外发通道（/data/notify 队列就靠它）。 迁移完成前不要停 openclaw 容器，否则微信推送整条链断。 ✅ 2026-10-20 20:00 已完成退役：容器 + 镜像 + /data/openclaw + 5 个 /root 脚本 + 3 条 cron 全部删除；通知出口改 Server酱（ops_notify.py 已加容器探测，不在即直推）；完整备份在手机 /data/backups/openclaw-retire-20261020-1944/（29M，含 28M 数据 tar）。以下表格仅作历史参考。

项	值
容器	`openclaw`（`openclaw/openclaw:latest` arm64 3.42GB），host 网络，env：`OPENCLAW_NO_RESPAWN=1`（必需！否则 doctor 后 handoff 退出 0 → 崩溃循环）、`NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache`、TZ
数据	/data/openclaw bind → 容器 /home/node/.openclaw（openclaw.json + state/ + weixin 凭据 + agents/）
大脑	Command Code GOAT 套餐 → `deepseek/deepseek-v4.1-flash`（2026-10-06 起；经本地 ds_proxy :3012 转发计量）。⚠️ 2026-10-20 起原 `固定走路由器 7893` 已失效（代理栈下线）⇒ ds_proxy 必须改成直连上游（它本来就是"失败回落直连"，但固定代理那一步会先超时，白等一轮）——尚未实测改造，小龙虾当前可能已不可用。回退只剩直连 DeepSeek（`deepseek-flash`，key 🔑 §DeepSeek）
状态 API	127.0.0.1:3011（supervisord 程序 `status-api`，/srv/status-api/status_api.py，PC 副本 searxng-deploy/）：`/status` 全量（mem/disk/battery+trend24h 48点/containers 含每容器 mem+cpu（docker stats）/backups/services 探活/tunnel 语义=autossh 进程）/`/trend`/`/healthz`；小爱"设备详情/图表"的数据底座。2026-10-06 修 current_ma 单位/符号（原直读 sysfs µA 当 mA 标 = "54000mA" 荒谬；现 `-current_now/1000`，与心跳口径统一为「正=充电」）
调用计量	`ds-proxy` :3012（同目录 ds_proxy.py）：本地捕获代理，旁路落 `/srv/status-api/usage.jsonl`（time/model/elapsed_ms/prompt/cache_hit/cache_miss/completion/via）并给可见回复自动追加脚注。2026-10-06 上游由 api.deepseek.com 切到 Command Code，兼容 DeepSeek 式与 OpenAI 式 usage 形状。⚠️ 2026-10-20：里面钉死的 `PROXY=http://192.168.10.1:7893` 已不存在，需改成直连（或指向新客户端）后才恢复正常时延
缓存提示词	workspace `/data/openclaw/workspace/`：AGENTS.md（常用查询映射：设备详情/部署项目/图表/备份状态 → :3011 + 原则）+ IDENTITY.md（小爱/🦞🐾/直来直去）+ OpenClaw 自建 SOUL/USER/MEMORY；isolated 会话（如 cron）同样吃这套文件
瘦身与提示词（2026-10-06）	插件 43→9 enabled（关 34：语音×5 / computer / canvas / geolocation / file-transfer / github / google / talk-voice / tts-local-cli + 21 个未用 provider；保留 weixin/deepseek/openai/memory-core/web-readability/browser/document-extract/linux-node/device-pair）；AGENTS.md 追加三段（ntfy 告警/备份/充放电映射 · SearXNG 检索映射 · containers.mem/cpu 出处澄清）。实测账（每次全新会话）：固定 prompt 12,460；移走 AGENTS.md 反而 12,812 → 补丁零成本；关插件不降 prompt（14.6k→14.5k 噪声级）→ 提速杠杆在会话历史（200kb 压缩阈值已把曾达 87k 的会话压回 ~19k）。回滚：`/root/archive/retire-20261006/{openclaw.json.pre-slim,AGENTS.md.pre-patch}`
微信	官方插件 `@tencent-weixin/openclaw-weixin` v2.4.8（腾讯 iLink 协议，出站连腾讯中转，无需公网暴露，家里 NAT 直接可用）；渠道 `openclaw-weixin` enabled/configured/running；owner=`openclaw-weixin:o9cq8095Gn9_i15OxkQa68nJuMAE@im.wechat`（commands.ownerAllowFrom 已设，微信内可管理）
端口/安全	gateway 127.0.0.1:18789 loopback only（配置 gateway.bind=loopback + gateway.mode=local）；控制走 `docker exec openclaw openclaw ...`；gateway.auth token 未设（loopback 下暂可接受，入待办）
已踩坑	① 手写 openclaw.json 缺 `gateway.mode:"local"` → start blocked → 容器 exit0 崩溃循环；② 缺 `OPENCLAW_NO_RESPAWN=1` → doctor 后网关 handoff 退出；③ provider 失败有 1 分钟 billing 冷却（跨重启持久，自动恢复，勿慌）；④ 用户手机代理 app 会劫持 ClawBot→iLink 连接（"暂无法连接"元凶之一），手机代理需把微信放直连；⑤ 绑定 QR 限时，过期重跑 `/tmp/wx-start-login.sh`（写 /tmp/wx-login.txt 含链接）；⑥ `message send` 必须带 `--channel openclaw-weixin`，漏掉报 `Channel is required` 而静默不发（2026-10-07 实证，微信端什么都收不到）；⑦ 每日 401 的真因＝状态库里残留的 DeepSeek 平台废 key 档案 `deepseek:default`（2026-10-15 定位并删除，详见下表「凭据档案」行 + CHANGELOG 同日篇）。旧档案把同一现象记成「中转偶发抖动」，方向错了 —— 真因是该档案排第一，而 provider baseUrl 早已换成 Command Code（只认 `user_`）→ 必然 401，`rotate_profile` 只是兜住重试；连带伤害是 03:00 memory-core dreaming 无下一候选、每天叙事生成降级失败*（`decision=candidate_failed … reason=auth next=none`）。量化：日志 `reason=auth` 38 次 / `usage_errors.jsonl` 47 条（10-07→10-15）
凭据档案 ⭐（2026-10-15 补档）	档案不在 agent 库：真身是共享状态库 `/data/openclaw/state/openclaw.sqlite` → 表 `config_machine_state` → `state_key='authProfiles.store'`（agent 级 `agents/main/agent/openclaw-agent.sqlite.auth_profile_store` 是空的，别找错）。`models auth order get --provider deepseek --agent main` 返 `override: none`＝自动顺序。档案必须与 provider baseUrl 匹配：现役 baseUrl 走 ds_proxy→Command Code，*只认 `user_`**。本次已删除残留的 `deepseek:default`（`sk-…`，35 字符；删前备份 600 至 `/data/openclaw/authProfiles.backup-20261015-1835.json`）。排查三连：`docker exec openclaw openclaw models auth list` / `models status` / `models auth order get --provider deepseek --agent main`
启动脚本 ⭐	`/root/openclaw-up.sh` 是唯一正确拉起方式（`docker rm -f openclaw` → `docker run …` → sleep 18 + 双 curl 自检 + 打印日志配额/内存上限）。2026-10-15 起含 `-e NODE_OPTIONS=--max-old-space-size=4096`；改前版本 `/root/openclaw-up.sh.bak-20261015-1835`。⚠️ 该脚本停机约 60s 才 ready
内存阈值	压力告警阈值＝内置常量算出：`rssWarningBytes = min(max(1536MB, 0.5×heap_size_limit), 0.5×min(cgroup, physical))`（`/app/dist/diagnostic-.mjs`，同类告警 5 分钟一条）。改前 heap_size_limit 2240MiB → 阈值 1.5 GiB，而 RSS 常 1.5–1.71 GiB → 9 天 1987 条噪音；改后 heap_size_limit 4288MiB → 阈值 2144 MiB（2.09 GiB）*。⚠️ 这只是把噪音抬到真水位之上：RSS 若真涨破 2.09 GiB，那条告警是真信号
思考档位 ⭐（2026-10-15 修复，默认 off）	改前不是「调不低」，而是档位从未到达上游：模型行缺 `compat.supportsReasoningEffort` → 捕获实测 `default` / `--thinking off` / `--thinking high` 三种档位的出站体完全一样且不含任何思考参数（`{"model":"deepseek/deepseek-v4.1-flash","stream":true,"n_messages":3,"n_tools":11}`），上游遂按自身默认思考跑（重推理题 78–155 reasoning token 白烧）。上游只认 `reasoning_effort`，合法值 off / low / medium / high / xhigh / max（minimal 与 none 均 400）；`thinking:{"type":"disabled"}` 会被静默忽略（仍吐 reasoning_content）。已加三处：`agents.defaults.thinkingDefault:"off"`、`agents.defaults.compaction.thinkingLevel:"off"`、`models.providers.deepseek.models[0].compat={"supportsReasoningEffort":true,"supportedReasoningEfforts":["off","low","medium","high","xhigh","max"]}`；`openclaw config validate` 通过，网关热加载生效（`[reload] config hot reload applied … revision 1 accepted`，无需重启）。改后验收：出站体带 `reasoning_effort:"off"`、重推理题 reasoning_tokens 0（改前 78/155）、`--thinking high` → 出站 `"high"`。备份 `/data/openclaw/openclaw.json.bak-thinkingoff-20261015-192358`；回滚＝覆盖回该文件（同样热加载）
记忆检索（2026-10-15 新发现，未处置）	`openclaw doctor` 报 `Memory search provider is set to "openai" but no API key was found` —— embedding 指向 openai 而无凭据 → 记忆语义检索不可用。处置二选一：配 openai key，或 `openclaw config set memory.search.enabled false`
定时推送	小龙虾版 AI 早报已上线：OpenClaw cron `AI 早报 06:30`（id 23ecd51f…，cron `30 6 * * ` exact，isolated+light-context，announce→openclaw-weixin→主人微信，model `deepseek/deepseek/deepseek-v4.1-flash`＝Command Code GOAT，2026-10-06 起）——2026-10-07 由 07:35 前移到 06:30，与排盘刷新同步前移（07:05→06:00），否则日报第 0 步「数据新鲜度硬校验」会天天判定旧排盘、运势整节降级；prompt 正文 2309 字符未动。prompt 存档 `D:ProjectsPCsearxng-deploymb-prompt.txt`（数据源：curl 127.0.0.1:3010/today.json + SearXNG 天气/资讯两路 + ntfy 三主题夜报）。n8n 版（07:30）已停车*（2026-10-06，容器保留）
日报加固（2026-10-06）	① 数据新鲜度硬校验：prompt 第 0 步核对 `today.json.date` 是否今天，否则禁止引用排盘并显式标注"⚠️ 排盘数据未刷新"（堵住"旧排盘配新日期"，根因是彩排早于 07:05 刷新时模型自行补日期）② 正文归档 `workspace/reports/YYYY-MM-DD.md`（机读可审计，此前 isolated 会话不留正文）③ prompt v2.2：700-900 字、每节 2-4 句 + 俏皮点评、资讯改国内实用向、纯文本禁 Markdown（微信不渲染）、夜报只报当天 00:00 后事件。装法：`cron_jobs.job_json` 的 `.payload.message`（非 jobs.json 文件、`cron edit --message` 会被 schema 拒）；回滚备份 `/root/archive/retire-20261006/job-json.pre-{guard,v2,v21,v22,v23}.txt`。试跑忠实度 8/8，报告路径 4 轮 / 模型侧 ~71s（待 `/events` 聚合优化）
⚠️ n8n 备份执行位事故（2026-10-06）	`/root/n8n-backup.sh` 权限曾是 600（无 +x） → cron 04:25 连续两天 `Permission denied` 静默失败（09-25 同款坑复发：脚本经 mv/复制安装丢执行位）。处置：`chmod +x` + 补跑成功（`n8n-20261006_054323.tar.gz` 488K，云端已推）。新增例行动作：遍历 crontab 引用脚本查执行位（本次其余 4 个均 755 正常）
回滚	`docker rm -f openclaw && rm -rf /data/openclaw`；微信端插件页解绑
回滚	`docker rm -f phone-n8n && rm -rf /data/n8n`；guard 备份 `.bak-n8n-20261005`；crontab 删 04:25 行；fortune 回滚=crontab 取消注释

Vaultwarden 密码库（2026-09-27 上线）#

项	值
容器	`phone-vaultwarden`，host 网络 + ROCKET_ADDRESS=127.0.0.1:8222（手机 docker `-p` 映射不可靠，见踩坑 #15）
访问	https://phone.zmlr.top/vault/（DOMAIN=https://phone.zmlr.top/vault 子路径托管；Bitwarden 客户端「服务器 URL」填 https://phone.zmlr.top/vault）
管理	/vault/admin · ADMIN_TOKEN=argon2 PHC（明文备份 🔑 见 credentials.local.md §手机服务器，PHC 见 credentials §手机服务器）
注册	⚠️ 上线时 SIGNUPS_ALLOWED=true 开放注册，用户注册主账号后必须改 false 重建容器
数据	/data/vw bind（db.sqlite3 + rsa_key.pem + attachments）
备份	/root/vw-backup.sh 每日 04:10：sqlite3 .backup 安全快照 → tar（含 rsa_key/attachments）→ 本地 /data/backups/vw 留 14 → scp 云 backups/phone-vaultwarden/ → ntfy 通知

⚠️ 墨账部署专用约束（改代码/构建前必读）#

basePath：构建时 NEXT_PUBLIC_BASE_PATH=/accountbook；前端 fetch('/api/...') 为域名根相对

路径 → 由云 nginx location /api/ 兜底透传到 app 的 /accountbook/api/

redirect 硬编码：middleware.ts 中 /login 重定向已改为带 basePath 前缀（否则 307 丢前缀）
不开 trailingSlash（与 nginx 子路径补斜杠互相 301/308 死循环）
nginx location 模板：location ^~ /项目名 { proxy_pass http://172.17.0.1:15301; } ——

proxy_pass 不带 URI（带 URI 会触发 nginx auto-redirect 循环）；proxy_set_header 必须伴随 proxy_pass，否则该块无代理动作 → 静态 404（事故实录）

nginx 修改安全流程（强制）：python 脚本改宿主 conf → 一次性容器（--network 同生产网络）

nginx -t 预检 → 通过才 nginx -s reload（零停机）；失败自动回滚备份。禁止 docker restart 直改

deploy 脚本模式：容器异常（start EOF）时 rm + run 重建（数据在 bind 卷安全），

docker start 对旧对象会复现 EOF

npm ci 在手机 docker build 报 "Exit handler never called"（npm bug）→ **构建在云端 docker

（qemu）：构建上下文 PC 打 tar 上传 → 云 docker build --platform linux/arm64 → push localhost:5000 → 手机 pull。构建上下文必须有 .env（.dockerignore 会排除 .env，需先删该行）。 2026-10-04 注：overlay2 上位后手机本地 build 缓存机制成立，此坑值得重测；构建链亦可走 PC WSL2（见 local-pc.md）。 2026-10-05 重测判负：overlay2 下 npm ci 仍报 Exit handler never called!（一字不差复现）——vfs 已排除**，嫌疑收敛到 4.19 内核 / f2fs / npm 出网路径；构建维持 PC（本地 WSL2）+ 云（qemu）两端，手机不再尝试

supervisord 改程序命令后必须 reread + update（restart 不重读配置文件）
（2026-10-31 起作废）Capacitor WebView 壳已退役：public/account-book.apk、public/error.html、

capacitor.config.json、components/CapacitorBridge.tsx 与 @capacitor/* 依赖已从项目仓库删除； APK 改 Flutter 原生构建（app_flutter/），不再进容器层、不再随镜像分发。旧镜像的容器层可能还带 /app/public/account-book.apk，下次重建后消失；/accountbook/account-book.apk 链接不要再用，等下次改 nginx 时删掉对应 location。

墨账部署（phone-accountbook-*）#

项	值
数据库	postgres:16-alpine · `/data/pg` bind · 127.0.0.1:5432 · healthcheck(`pg_isready`) · 内存上限 1G · 集群时区 `Asia/Shanghai`（2026-10-10 ADP-1 收口：`ALTER SYSTEM` 写入 `/data/pg` 内 `postgresql.auto.conf`；此前 `postgresql.conf` 是 `timezone = UTC` ——容器 `TZ/PGTZ` 压不过它，而 `docker exec … psql` 因 `PGTZ` 假显 Asia/Shanghai，验真身只能在应用容器里问 `current_setting('TimeZone')`）
app	registry 镜像 `localhost:5000/accountbook:latest` = `accountbook:20261031-47078ff`（`/api/health` 回显 `version=20261031-47078ff` / `commit=47078ff` / `migrations 11/11`；含单世界 A、备份 v2、安全加固）；回滚标签 `accountbook:20261030-0cbeb87` 等历史 tag。容器参数（10-06 大修沿用）：免鉴权 `/api/health` 探针 · `TZ=Asia/Shanghai` · healthcheck · 内存 512M · 绑 127.0.0.1 · 无任何挂载（无状态，重建不丢数据）。构建发布＝PC WSL2/云 arm64 → push 手机 registry → rm+run 同参重建（完整参数/验收见项目仓库 `deploy/phone.md`）
版本沿革	SW v18/v19（10-04 主题语言化 + 四页重构）→ SW v20（10-05 写后新鲜窗口）→ 10-06 `obs2c` → 10-10 `datefix` → 10-30 `0cbeb87`（上级=人名 + 天数/日均口径）→ 11-01 `47078ff`（单世界 A / 备份 v2 / 安全加固 / sw v25）
迁移	线上 11/11（2026-11-01 部署执行 `0011_backup_name`，`backups.name` 已存在）；`/api/health` 校验数量达标
访问	https://phone.zmlr.top/accountbook/login（口令 2026-10-06 已轮换为强随机、scrypt 哈希，🔑 credentials §手机服务器-墨账密码）；`/accountbook/api/health` 免鉴权
安卓 App	Flutter 原生端（`app_flutter/`，唯一世界 A 夜档）；不再有 Capacitor WebView 壳，网页层改动不需要重装 APK，Flutter 页面改动必须重新出包。构建：本地 `flutter build apk --release --split-per-abi` / CI `build-apk.yml`（Flutter 3.47.8）；发布签名固定 debug keystore（🔑 §APK 签名，Secrets `APK_KEYSTORE_BASE64`），同签名可覆盖安装。分发走 TG arm64 分包（~18.5MB）；旧 `public/account-book.apk` 与 `/accountbook/account-book.apk` 下载路径已随旧壳退役。
账户余额校准（2026-10-06 23:36）	生产数据改动（唯一动刀处＝期初余额）：6 个生活账户 `initial_balance` 被校准，吸收历史漏记账造成的漂移；流水一条未动，报表口径不变。校准后期初：生活卡 1717.86 / 项目卡 2912.36 / 微信余额 −318.12 / 零钱通 7633.67 / 支付宝 758.40 / qq钱包 −25.00（负期初＝"历史上少记了这么多支出"的诚实表达，余额本身正确）。工具 `scripts/life-balance-tool.py`（PC → LAN SSH → 容器内 psql）；改动前快照 `D:ProjectsAccount Book_tmplife-accounts-before-20261006-233638.json`（回滚＝按快照抄回期初值）；流程与验收见项目 `docs/troubleshooting.md §6`

备份体系 v2（2026-09-27 重构 · 09-28 复盘③统一）#

路径A（应用内快照）：点击「同步备份」→ backups 表快照（应用内，30 天）
  · 2026-10-31 起 JSON 备份为七段完整快照（项目/项目流水/生活账户/生活分类/生活流水/周期模板/上级），
    导出名 `mozhang-backup-v2-YYYYMMDD-HHmmss.json`、快照名 `mozhang-snapshot-v2-YYYYMMDD-HHmmss`；
    新格式导入=整体替换（backups 历史与访问密码不动），旧格式=合并。实现 `lib/backup-format.ts`。
  → backup-sidecar（supervisord 常驻，10s 轮询监测新快照行）
  → 三路分发：① /data/backups/（留14，明文）② 加密后 scp 云 backups/phone-accountbook/*.dump.gz.enc ③ latest.dump.gz
路径B（cron 主备份，均为北京时间）：
  03:40 backup-push.sh：pg_dump → ① /data/backups 留14 + latest.dump.gz（指挥舱读此目录）
        → ② openssl 加密 → scp 云 *.dump.gz.enc → ③ ntfy 事件总线
  03:50 **mz-v2-backup.sh（2026-11-03）**：pg_dump mozhang_v2 → ① /data/backups/mozhang-v2 留14
        → ② openssl 加密 → scp 云 backups/mozhang-v2/ → ③ latest.dump.gz
  04:10 vw-backup.sh：sqlite 安全快照 + rsa_key/attachments → 本地留14（明文）→ 加密推云 *.tar.gz.enc
🔐 加密（2026-10-06 A3）：openssl enc -aes-256-cbc -pbkdf2 -iter 100000 -md sha256，口令 /root/.backup-pass（600）
   —— 明文只留手机；**云端只有密文**；口令另存 credentials §备份加密（建议也存一份进 Vaultwarden）
PC 第三副本 + 自动演练（2026-10-06 重建，脚本在项目仓库 scripts/）：
  · 任务 AccountBook-PhonePull 每日 09:00 → pull-backup.py → D:\Backups\account-book（留 90 天；拉的是密文）
  · 任务 AccountBook-RestoreDrill 每日 10:00（脚本自判「距上次成功满 30 天才真跑」）→ restore-drill-pc.py
    = 解密 → 一次性 postgres 容器**真恢复** → 逐表与线上对账 → 通过写 .drill-last；失败/不一致直推 Server酱
  · 任务 AccountBook-PullGuard 每周日 10:30 → ensure-pull-task.ps1（任务缺失即自动重建 + 心跳超 30h 告警）
  · 10-06 实测：加密 → 解密 → 恢复，9 表与线上完全一致（当时 platforms=30 / daily_records=238 / life_records=268）
🔎 2026-10-21 实测：`latest.dump.gz` = 200,993B @03:40:01（与 `accountbook_20261021_034001.dump.gz` 同尺寸）；
  `/data/backups/vw/` 04:10 刷新；每日 dump 10-11→10-21 连续 11 份（185K→200K 递增，无缺口）；
  backup-push.log 尾行 `[Wed Oct 21 03:40:03 CST 2026] 推送完成（云端为加密件）`、vw-backup.log `[Wed Oct 21 04:10:02 CST 2026] vw 推送完成`；
  周日 04:25 n8n-backup.log = 10-18（对得上周日）、04:20 docker-prune.log = 10-18 `Total reclaimed space: 167.6MB`；
🔎 2026-10-21 23:53 再核：**现存备份只有 2 类** —— 墨账 `accountbook_20261021_213502.dump.gz`（2.3h 前，197KB）+ 密码库 `vw-20261021_041001.tar.gz`（19.7h 前，27KB）。**「三份备份」的旧说法作废**：第三份是 n8n 周备份，随 n8n 2026-10-21 删除已不存在；状态 API 的 backups 数组也只列 2 条。⇒ 早报/巡检口径统一为「**有几份报几份**，某类 >24h 或缺失要点出来」。
  `freshness-guard.log` 最后一行仍是 **2026-10-06 19:20 的 ALERT**（此后 15 天无新行 = 无异常，符合「异常才推、正常静默」）

🔔 告警链路（10-06 起，都是「异常才推、正常静默」）：
  手机 freshness-guard（每小时 17 分：备份新鲜度 / 登录页 / 金丝雀 / 磁盘）
  + container-guard、battery-heartbeat（每 5 分钟）→ 异常直推 Server酱（/root/direct-push.sh）
  云端 edge-guard（每 15 分钟：证书剩余天数 / certbot 定时器 / 边缘 4 路由 / health 穿透 / 隧道端口 / 防火墙规则 / 磁盘）
已取消：云 root cron backup.sh（备旧库无意义）、PC 旧 AccountBook-BackupPull（旧路径 D:\Backups\account-book-phone 已废）
备份密钥：/root/.ssh/backup_key ↔ 云 authorized_keys（mi10p-backup，无限制）；备份加密口令见上
恢复：gunzip -c xxx.dump.gz | docker exec -i phone-accountbook-postgres pg_restore -U account -d account_book --clean --if-exists
  密文先解密：openssl enc -d -aes-256-cbc -pbkdf2 -iter 100000 -md sha256 -pass file:/root/.backup-pass -in x.gz.enc -out x.gz

限充看门狗 v3（2026-10-05 起 80/40）#

LOS 电池框架周期性重置 input_suspend（HyperOS 不会）→ 每 20s 重写目标值。 v3 阈值（用户指令"区间放大"）：≥80% 或 ≥45°C 断充；≤40% 且 ≤40°C 恢复（原 v2 为 70/60，每天充 2-3 次 → 现 80→40 放电约 30h，约一天一充）。文件：Android 侧 /data/adb/mi10p-server/charge-watchdog.sh（sh 常驻进程；改阈值不能原地 sed——running sh 按字节偏移读文件会错乱，正确姿势：备份 → 写 .new → mv 换名 → 用旧进程 /proc/<pid>/root chroot 出 Android 根启动新实例 → 杀旧 pid，全程充电保护不断档）。备份：charge-watchdog.sh.bak-8040-20261005（v2=70/60，回滚即换回+同法重启）。日志：同目录 watchdog.log。 ⚠️ 代价知悉：停电 UPS 预留 60%→40%（放电率约 1.33%/h，40% 约可撑一天）；40% 下限对电池健康无害。

📋 18 天运行体检（2026-10-15，uptime 18d14h）🚩#

采样 2026-10-15 17:59 CST（用户 m00001 指令）。全套数值与两个真缺陷的根因/修复/回滚见 CHANGELOG 同日「18 天运行体检」篇。

面	实测（2026-10-15）
连续性	18d14h 无重启（开机 2026-09-27 03:45 CST）；11 容器 RestartCount 全 0；supervisord 十程序全 RUNNING
硬指标	load 0.49/0.22/0.18 · Mem available 6688MB/11569MB · 磁盘 15G/465G=4% · CPU 30–31℃ · 电池 66%/30.1℃/health=Good/循环 145/charge_full 76%
内核压力	`/proc/pressure/memory` some 16.7s、full 11.2s（开机累计）→ 无实质停顿
数据链	03:40 墨账备份 ✅ · 04:10 Vaultwarden ✅ · 04:30 openclaw-ws ✅ · 06:45 日报守卫「无需动作」✅ —— 9 天无缺
监控	指挥舱 metrics 7 天无断点（disk 恒 3.1–3.2%）；公网 7 路由全通；云侧证书最短剩余 38 天；云 iptables 5 条 DROP 命中 0
揭露的两个真缺陷	① OpenClaw 每日 401（废凭据档案 `deepseek:default`，已删）② 内存压力告警噪音 1987 条（阈值 1.5→2.09 GiB，已抬）—— 均当日修复并当场验收
未覆盖面	Android 侧 dmesg/logcat 需 adb（chroot 取不到）；指标窗口只有 7 天

📋 全流程审计（2026-09-30，上线第 4 天）#

总评：1 年以上稳定运行潜力高。 连续运行 3d17h 零重启（跨越全部部署窗口）；6 程序/6 容器零异常重启（restarts=0）；温度 3 天极值 26.8–33.0°C；监控采样 60s/点无断点（1440 点/天，容器重建期间未丢）；备份链准时（03:40/04:10 北京时间）+ 微信通知全通；事件审计 53 条仅 3 次 auth-fail（限速在位）；公网暴露面仅云端 22/80/443，手机零公网入站，LAN 暴露面 3000-3003（可信内网）。

维度	实测	判定
系统稳定	uptime 3d17h；dmesg 无 panic/OOM；wakelock 稳定持有；无线充放循环 2 轮正常	✅
服务	六程序全绿（3 个"重启"均为有意配置变更）；容器 restarts=0；内存 25-26% 稳定无泄漏趋势	✅
链路	autossh 3d4h 稳定；云端 6 隧道端口全在线；证书 85 天 + certbot 自动续期	✅
🔴 磁盘斜率	~~头号嫌疑 LOS Updater~~ 10-02 复盘改判：真因是 chroot 内 docker vfs 堆积（vfs 无层共享，每次部署整层落盘+容器深拷，9-26~28 容器反复重建期泄漏 67 个孤儿层目录，/var/lib/docker 涨到 15GB）。10-02 已 `docker image prune -af` 回收 8GB（24G→16G）+ 周日 04:20 自动 prune 护栏。当时「chroot 仅 ~150MB」的测量漏了 /var/lib/docker，LOS Updater 误诊——Android 侧实际 ~7GB 静态	✅ 已闭环
🟡 电池计量	仪表健康度 76.8%（3455/4500mAh）疑为 gauge 漂移：60-70% 微循环到不了满充终点无法重学习；139 循环真实衰减应 90%+。影响停电续航显示准确性（服务器停电时靠电池 ride-through，计量准确性有实际意义）	⚠️ P1
🟡 云端磁盘	59%（build cache 10GB 可回收 ~3GB + journals 483MB），季度巡检清理	⚠️ P1

处置项：P0 = 手机上查 LOS Updater（设置→系统→更新）关自动下载/删已下载包，或下次 adb 时 pm disable-user org.lineageos.updater；处置后看指挥舱 disk_pct 曲线应走平。P1 电池 = 每月暂停看门狗充满一次校准 gauge（停 service.sh 看门狗 → 充满 → 恢复）。P1 云端 = 季度 docker builder prune + journal vacuum。 长期保障既有项：70% 限充 + 45°C 断充 + 低温实测 ✓；重启自愈链已实测 ✓；停电自带电池 ride-through ✓；备份三路分发 ✓；日志全部有界（<100KB）✓；docker vfs 无 json 日志膨胀 ✓。

京东挂机守护 jdguard（2026-10-16 上线 · 2026-10-17 定为长期维护项目，地位等同墨账）🚩#

干什么：替站点（xdlogin.124689.xyz，京东 wskey 代挂）做无人值守巡检 —— 每 20 分钟查一次账号 cookie 是否失效；失效就用已存的同一个 wskey自动重新提交；补登后下一轮复检确认「已恢复」。需要人工的（情形②：旧 key 提交要验证 / 从未存 key）转人工并推 Server酱。
最大的坑（写死在实现里）：站点按标签自动识别粘贴内容 —— pin=jd_xxx;wskey=AAJ…; 才走后端转换；写成 pt_pin=jd_xxx;pt_key=AAJ…; 会被当成「现成 cookie」直接存下、永不转换（站点回 ok:true 但账号永远失效）。app/wskey.to_site_format() 负责产出正确格式。
入口：局域网 http://192.168.10.199:3013/；远程 https://phone.zmlr.top/jd/（云 nginx location = /jd 301 + ^~ /jd/ → http://172.17.0.1:15305/ → 手机 :3013）。15305 必须在 edge-firewall.sh 与 edge-guard.sh 两处都放行。v2（同日 23:00）起登录用被托管站点自己的手机号+密码（是站点说了算，不是本地口令），入口白名单 ALLOWED_USERS；站点密码与各人的 Server酱 key 用 SECRET_KEY 加密后存 users 表；旧的共享口令 PANEL_PASSWORD 已废弃（口令与站点凭据见 credentials.local.md §京东 wskey 挂机站点）。
通知：ntfy 主题 mi10p-alert（事件总线；非 ASCII 标题走 RFC2047，app/notify.py 已修）+ /root/direct-push.sh（Server酱，给人看的）+ WxPusher（第 4 通道，2026-10-25 上线 / 10-26 定稿，替代已停用的 PushPlus；出处 = 项目 deploy/README.md §13）：每人可填自己的 token（users.wxpusher_enc，与 sendkey_enc 同款 SECRET_KEY 加密），Server酱与 WxPusher 可同时配、两个都推；两种 token = SPT_…（极简推送）/ UID_…（标准接口，需手机 .env 的 WXPUSHER_APPTOKEN）。⚠️ PushPlus 已于 2026-10-26 从代码 / 面板 / 推送逻辑整套删除，老库 users.pushplus_enc 只是孤儿列；2026-10-28 线上实测：app/notify.py 里 wxpusher 44 处、PushPlus 仅 1 处注释，panel.html WxPusher 9 处。凭据小节见 credentials.local.md §WxPusher。
v3.5 补记（2026-10-18 / 10-20，档案此前未登记）：notify.py(11863B) store.py(17494B) panel.html(46553B) webapp.py(44835B) 均 10-18 16:27–16:34 更新（PushPlus 落地），config.py 10-18 10:15；jdpanel.py(17066B) 10-20 07:12 再改一次（改前备份 /root/jdpanel.py.bak-20261020，DB 备份 /root/jdguard.db.bak-20261018-pushplus）。2026-10-21 实测巡检正常：巡检完成 {'checked': 16, 'invalid': 0, 'requests': 16, 'errors': 0, 'users': 5}。
账号层级（2026-10-21 用户纠正，务必分清）：users = 面板登录账号（5 个：18063033278 是我，18912349920 / 18912349930 / 18651975717 / 17358288586 是朋友的）；accounts = 同步来的京东号，owner 指回面板账号。我名下 3 个京东号（尾号 3278 / 3928 / 6216），不是 1 个 —— 早报/汇报只算这 3 个，别把面板账号 18063033278 当成京东号，也别把朋友 4 个账号的京东号算进来。
早报用的只读汇总脚本 /root/jd_brief.py（2026-10-21 建立）：#!/usr/bin/env python3，以 file:/srv/jdguard/jdguard.db?mode=ro 打开库，按 select … from accounts where owner=? 汇总，参数默认 18063033278；输出形如 面板 18063033278｜3 个京东号｜今日 +489 豆｜昨日 +390｜累计 6377｜全部正常｜更新 2026-10-21 23:46 + 第二行 尾号6216 +275｜尾号3278 +152｜尾号3928 +62；有 needs_manual=1 或连续失败时追加「⚠️ 尾号 X 需处理：原因」。部署 = ssh … "cat > /root/jd_brief.py && chmod 755 /root/jd_brief.py" < 本地文件。
已知边界：3928（jd_OuesIiYGiena）从未存过 wskey，长期停在「需人工」；情形②不硬试（客户端没法过京东验证码）。
v2 多用户（同日 23:00）：users 表（phone/secret_enc/token/token_exp/sendkey_enc/created_at/last_login_at）+ accounts.owner / events.owner；每人只看、只推自己名下的号（跨用户一律 404）；填了 SendKey 才推，不填完全不推；踢人 = DELETE FROM users WHERE phone='…'（对方会话立刻失效）。
⚠️ 换 SECRET_KEY = 所有人的站点密码与 SendKey 都解不开：进程会跳过该用户并在事件里留一条 client_skip（每进程只记一次），需各自重新登录一次。
v3 面板改版（2026-10-17，commit 7b1f9c9）：摘掉「剩余登录位」+ 实时倒计时（面板不再直接打站点，/api/state 从 ~1.5s 降到 ~30ms）；账号区「批量贴 key」下线，改成「＋新增账号」「删除账号」（删除 = 先站点 POST /api/auth/unbind-account 解绑、成功再删本地行 + 该号 state 键，弹层二次确认）；新增账号支持裸 AAJ key + 用户名框，并补上站点第二步 POST /api/auth/bind-account（commit 5061937）。
⚠️ 站点「新增账号」是两步契约：POST /api/login/manual/wskey（content: pin=jd_xxx;wskey=AAJ…;）只做「提交 + 解析身份」，不绑定；必须再 POST /api/auth/bind-account（jd_username = pt_pin、phone_last4 = 手机尾 4 位）才真绑定。只调第一步的症状 = 站点回 ok:true 但 my-accounts 里永远不出现该号（2026-10-17 面板「新增账号」加不回来的真凶）。
⚠️ 面板新增账号仍必须知道 pt_pin：京东 key 里没有 pin，站点自己贴裸 key 也会弹「请输入用户名」；面板做法 = 文本框（可裸 key）+ 用户名输入（候选来自现有账号与事件流里的 pt_pin=）。
服务端加固（2026-10-17，commit 6141a01）：登录限流（同 IP/号 10 分钟内 5 次失败 → 429 锁 10 分钟，落 login_fail / login_blocked 事件）；来源 IP 改读 X-Real-IP（隧道下 address_string() 恒 127.0.0.1）；log_message 回到 INFO（此前压到 DEBUG = 无访问日志）；请求体上限 64KB（413）+ Handler timeout=30；notifier 工厂按 owner memoize（此前面板读的是另一个实例 → 推送失败计数长期显示 0）；housekeep() 每轮清 events / 孤儿 state 键；面板轮询自适应（空闲 5 分钟、巡检前后 30 秒）。
⚠️ 面板自动刷新曾长期静默失效：refreshAll() 漏 return ok → boot 的 refreshAll().then(ok=>{if(ok) startPoll()}) 恒不成立（只有登录那一次会起轮询，刷新页面后再不自动刷）。2026-10-17 已修，探针实测空闲节奏 = 20s / 20s / 300s。
测试与验收（2026-10-17）：python -u -m pytest tests -q = 192 passed；手机 192.168.10.199:3013 五文件 md5 两侧一致 + supervisorctl status jdguard RUNNING；真机 6216 链：删除（站点与本地都消失）→ 用新 key 新增 → 回执 ok:true / remark_set:true / valid:true、DB 回读 is_valid=1、账号数 16→15→16。
回滚：见 server-ops CHANGELOG.md 2026-10-16（深夜）篇；v2 升级与回滚步骤见 D:\Projects\手机服务器\jd\deploy\README.md §6。
源码仓库分支与在途工作（2026-10-28 登记）：仓库 D:\Projects\手机服务器\jd（远程 = GitHub 私有 Amor-ai/jd-wskey-guard，2026-10-28 23:40 建、两支已推、upstream 已设）现有两支 —— master（＝线上正本，HEAD 8e67eea）＋ feat/jdlogin-fast（京东登录「换 key」提速链路，5 提交，头 e9b499b 2026-10-18 10:05，分叉点 5061937 10-17；领先 master 5 / 落后 4，至今未合并）。分支内容 = app/vision.py（视觉大模型解题）＋app/jdauto.py（点选自动解）＋ worker 新增 drag/type/key/finish op ＋面板 MJPEG 帧流 / 本地跟手 / 松手一次性回放 / 本地合成滑块画布＋认证魔方语音验证码＋转人工通知（同人 180s 去重）＋ #jd 深链接续；手册在分支版 deploy/README.md §11/§12。⚠️ 合并时必须重排章节号：分支 §11/§12 与 master §11（PushPlus，已停用）/§12（keep-alive 加固）/§13（WxPusher）撞号。基线：2026-10-28 用 git worktree 独立跑分支 pytest tests -q = 229 passed in 25.93s。⚠️ 测试实例状态：2026-10-28 23:36 实测已被清掉（目录无、ERROR (no such process)、3014 未监听）→ 23:47 按 §11 重建成功并验证（app 解包、.env 换新 SECRET_KEY、库中和 next_round_at*=2099 ＋ 3 个 push 列置 NULL、node 20.20.2 装到 /opt/node20、playwright-core 1.64.1、chromium-1248、supervisor [program:jdguard-test]、:3014 起、首页 200、未登录 API 401、稳定实例未动）→ 23:48 因链路作废 stop。坑复盘：① node_modules 必须随 app 在位；② 换 SECRET_KEY 后旧密文全解不开（日志「用户 0 个」），必须重登；③ playwright 1.64 要 Node ≥ 20，手机自带 node 只有 18.20.4，得另装 /opt/node20（nodejs.org/dist 手机能直连）；chromium 用 PLAYWRIGHT_DOWNLOAD_HOST=https://npmmirror.com/mirrors/playwright 下载（120M，成功）。视觉网关键（.env，留空＝自动解不可用）：VISION_BASE/VISION_MODEL/VISION_EFFORT/VISION_MAX_TOKENS/VISION_UA/VISION_KEY、PANEL_URL、AUTO_TRIES；点选题单次命中率仅 1/3–1/2（§12.1 有失败样本与「别再走」的改法），靠 retry 换题＋最多 6 轮＋转人工兜底。
⛔ 2026-10-28 用户定：整条「京东账号密码登录 + 验证码识别/破解」链路弃置，不合并、不恢复。 用户原话：「关于手机账号密码的验证码破解相关内容早就被弃用啊」。jdguard 只走 wskey 补登 + 巡检，面板不做密码登录（2026-10-17 已按用户指令删净该功能，commit 8a7b15b；分支 feat/jdlogin-fast 是 10-18 的「提速重做」实验，同样作废，仅作历史留档）。据此：① feat/jdlogin-fast 不合并；② 3014 测试实例 23:47 按 §11 重建 → 23:48 stop → 23:52 按用户「相关的全清」删净：/srv/jdguard-test(15M)、/opt/node20(162M)、/root/.cache/ms-playwright(680M)、/var/log/jdguard-test*.log、supervisord.conf 里 [program:jdguard-test] 段（摘前 cp -a 备份 .bak-YYYYmmdd-HHMM；supervisorctl status 已无该项，jdguard RUNNING pid 31984 + :3013 照旧，df / 465G 用 11G）；③ 分支两端都清：远端 DELETE git/refs/heads/feat/jdlogin-fast → HTTP 204（git ls-remote --heads origin 只剩 master），本地删前先 git bundle 留档 → D:\Projects\手机服务器\_归档\jd-feat-jdlogin-fast-20261028.bundle（411,107 B，git bundle verify = records a complete history），然后 git branch -D（was e9b499b），现 git branch -vv 只有 master [origin/master]、git worktree list 只有主树。

手机桌面 phone-desktop（2026-10-19 上线 · 2026-10-21 12:23 退役）⭐#

用户判断「桌面太多余，指挥舱完善一下比它好很多」→ 选「都不搬、先下线、后面再考虑如何完善」。本节保留为历史档案 + 恢复手册，日常运维不再涉及。

项	值
现状（2026-10-21 12:23）	supervisord `desktop` 已停并从 conf 注释（`# DISABLED-20261021`）；`:3014` 无监听（`ss` 计数 0、`curl` 000）；`/srv/desktop` 已移走；归档 `desktop-20261021.tar.gz` 200,586B / md5 `81f7add1d38a1752c27c843681cca1fb` + 解包目录 `desktop-src-20261021/`；退役后 supervisor 10 程序全 RUNNING、手机内存占用归零
恢复方法	`cd /root/archive && tar xzf desktop-20261021.tar.gz -C /srv && sed -i 's/^# DISABLED-20261021 (退役手机桌面) //' /etc/supervisor/supervisord.conf && supervisorctl reread && supervisorctl update`（先确认 `:3014` 空闲）
入口	局域网 http://192.168.10.199:3014/（无鉴权，仅 LAN，未开公网隧道）
形态	浏览器里的一台「米色塑料小机器」：桌面 8 个实体按键图标 + 可拖拽窗口 + 底部深色键条；打开页面自动弹出「监视器」窗口
前端	`index.html`（单页无框架；Braun Analog 风：点阵纸纹底 + 凸起按键 + 打印纸带）+ `_shell.js`（窗口内核 `window.SHELL`：open/close/min/max/focus/boot，pointer 拖拽）；字体 Barlow/Archivo 本地 woff2
后端	`server.py`（仅标准库 ThreadingHTTPServer，绑 `0.0.0.0:3014`）：`/api/snapshot` 返回聚合快照，其余走静态；内存缓存 docker 20s / services 30s / cron 60s / ports 120s / fortune 30s / hostinfo 3600s
数据源	`127.0.0.1:3011/status`（电量/内存/磁盘/负载/24h 电量序列）+ `docker ps` + `supervisorctl status` + `crontab -l` + `ss -tln`（过滤 `:30xx`）+ `/data/n8n-bridge/today.json`（今日签）+ `/sys/class/power_supply/battery/*`
八个程序	监视器（刻度尺 + 打印纸带 24h 电量曲线）、程序（9 容器）、网络（10 端口）、任务计划（cron）、备份、待办（`todos.json`）、今日签（收据样式）、关于（主机信息）；前端每 15s 轮询重绘
托管	supervisord 程序 `desktop`：`/usr/bin/python3 -u /srv/desktop/server.py`，directory `/srv/desktop`，autostart/autorestart，日志 `/var/log/desktop.log`
PC 正本	`D:ProjectsPCphone-desktop`（`app/` 生产版、`design/` 方向稿、`deploy/`、`scripts/`、`docs/`）；部署/更新/回滚全流程见该目录 `docs/部署与运维.md`
已知边界	无鉴权（仅 LAN）；手机 `/sys/class/thermal/thermal_zone*` 为空 ⇒ 「温区」一栏改为「系统」（内核/容器/服务/端口）；15s 轮询非推送
⚠️ 版本漂移（2026-10-21 实测）	`/srv/desktop/` 三文件于 10-21 01:03–01:16 被更新（`index.html` 29556→35821B、`_shell.js` 7355→7623B、`server.py` 5194→5499B，`server.py.old` 仍带 `-rwxr-xr-x` 可执行位），supervisord `desktop` 进程自 10-21 01:20 起（`uptime 8:11:44` 于 09:28 采样）。PC 正本 `phone-desktop/app/` 仍是 10-19 版（27933/7355/5194B）⇒ 下次按文档从 `app/` 部署 = 会把 10-21 的改动回滚掉。要保新版先从手机拉回 PC 再部署。
🚩 新版外送已备（2026-10-21 10:23）	大文件通道断的情况下，已把 10-21 版原样备到两处并逐文件核 md5（与 `/srv/desktop/` 源 `mismatch_count=0`）：① `/tmp/desktop-1021/`（12 文件 188,989B + `MANIFEST.txt`）；② MTP 可取 `/proc/1/root/storage/emulated/0/Download/desktop-1021/`（＝手机「内部共享存储空间/Download/desktop-1021」，附 `md5.txt`，`md5sum -c md5.txt` 12 项 OK）。逐文件大小+md5 清单落 PC：`D:ProjectsPCops-audit-20261021outdesktop-1021-manifest.txt`。未拉回前 PC `app/` 仍是 10-19 版，别部署

USB / MTP 通道（2026-10-21 实测 · 大文件传输断时的唯一生路）🔌#

项	实测值
连接状态	真实连着 PC 的 USB。PC 侧 WPD 枚举到设备 `Mi 10 Pro`，路径含 `vid_18d1&pid_4ee2` —— 与手机 gadget `idVendor/idProduct = 0x18d1/0x4ee2` 完全一致（同一台、同一路）
gadget（configfs）	`/proc/1/root/config/usb_gadget/g1/`：`UDC=a600000.dwc3`（已绑定）、`configs/b.1` 下 `function0 → ffs.mtp`、`function1 → ffs.adb`（当前生效＝MTP+ADB）；`g2/` 无 functions、无 UDC（空壳）
内核视角	`/sys/class/udc/a600000.dwc3/state = configured`；`/sys/class/android_usb/android0/state = CONFIGURED`、`android1 = DISCONNECTED`
getprop	`sys.usb.config = adb`、`persist.sys.usb.config = adb`、`sys.usb.ffs.ready = 1`、`sys.usb.controller = a600000.dwc3`、`sys.usb.configfs = 2` ⚠️ chroot 内没有 `getprop`，必须 `chroot /proc/1/root /system/bin/getprop <key>`（直接跑 `/proc/1/root/system/bin/getprop` 会报 `cannot execute: required file not found` —— 动态链接器路径是绝对 `/system/bin/linker64`）
供电	`power_supply/battery status=Charging current_now=-433000`（负=放电口径，此处表示在充电中）；`power_supply/usb online=0` 属这台机 `pc_port` 的口径，不代表没插线
共享存储在哪	chroot 内没有 `/sdcard`、`/storage`、`/data/media/0`（`/data` 是分目录 bind，媒体库没挂进来）。唯一可达路径：`/proc/1/root/storage/emulated/0/`（Android 命名空间，属主 `root:9997 0770`），`/proc/1/root/sdcard → /storage/self/primary → /storage/emulated/0`
能不能写	能。SELinux `Enforcing` 下 root 经该路径直写 `Download/` 成功（1 字节探测文件写入+删除均 OK）。属主惯例照 `Download` 现有 `.apk`：目录 `root:9997 0770` / 文件 `root:9997 0660`
MTP 可见性	落盘后 `chroot /proc/1/root /system/bin/am broadcast -a android.intent.action.MEDIA_SCANNER_SCAN_FILE -d file:///storage/emulated/0/...` → `Broadcast completed: result=0`；PC 侧当场即可浏览（`desktop-1021` folder=True，6 个子项齐全）。注意：`content query` 在 chroot 里查不到（`/system/bin/content` 是 135B shell wrapper，依赖 app_process ⇒ 静默无输出），`sqlite3` 直连 `com.android.providers.media.module/databases/external.db` 报 `unable to open database file`（SELinux）。验收别用这两个，用 PC 侧 WPD 枚举
PC 侧 MTP 验收姿势	`Shell.Application.Namespace(17)` 找设备 → `FolderItem.GetFolder` 逐层下钻（`Namespace(<MTP path>)` 对「内部共享存储空间」返回 null，别用）；adb 本机未装

# 常用：把任意目录送到 MTP 可取的 Download（chroot 内执行）
DEST=/proc/1/root/storage/emulated/0/Download/<名>; mkdir -p "$DEST"
cp -a /srv/<东西>/. "$DEST"/ && find "$DEST" -type d -exec chown 0:9997 {} + -exec chmod 0770 {} + \
  && find "$DEST" -type f -exec chown 0:9997 {} + -exec chmod 0660 {} +
chroot /proc/1/root /system/bin/am broadcast -a android.intent.action.MEDIA_SCANNER_SCAN_FILE -d "file:///storage/emulated/0/Download/<名>"

操作手册 runbook#

# 状态（PC）
ssh -i ~/.ssh/mi10p_ed25519 root@192.168.10.199 'supervisorctl status; docker ps'
docker info | grep "Storage Driver"        # 应显示 overlay2（2026-10-04 起）
curl -s http://127.0.0.1:5000/v2/_catalog  # 手机本地 registry 目录（2026-10-04 起）
ss -tlnp                                   # 端口归属排查（netstat 在 chroot 看不全）
curl https://phone.zmlr.top/canary         # phone-demo-ok
curl -L https://phone.zmlr.top/accountbook # 墨账 200
curl https://phone.zmlr.top/               # 指挥舱 200（全栈监控台）
curl https://phone.zmlr.top/deck/api/status # 实时状态 JSON

# 指挥舱运维
cd ~/.agents/skills/server-ops/dashboard
python deploy.py build   # 云端重建 arm64 镜像 + push registry（改代码后）
python deploy.py phone   # 手机 pull + 重建容器（DB 在 bind 卷，数据不丢）
python deploy.py sync    # 拉注册表快照回写仓库 data.json（页面编辑后）

# 容器异常（start EOF）→ rm + run 重建（数据在 bind 卷安全）
# 新项目部署：见「部署管线」+ cloud/ab-img-build3.py 模板
# 手动备份：chroot 内 bash /root/backup-push.sh（墨账）/ bash /root/vw-backup.sh（Vaultwarden）
# ntfy 测试：curl -s -H "Title: 测试" 127.0.0.1:3003/mi10p-alert -d "hello" → 微信收到即链路通
# 每日运势：/srv/fortune/run.sh --dry-run（只打印不推送）· /srv/fortune/run.sh（实推）· 日志 /var/log/fortune.log
# 运势链路测试：curl -s -m 5 -H "Title: t" 127.0.0.1:3003/mi10p-daily -d hello → 微信收到即链路通
# vault 验收：curl -sL https://phone.zmlr.top/vault/ 应 200（云侧 --resolve 为权威）
# SearXNG：curl -s -m 5 http://127.0.0.1:3005/healthz（应 200）· JSON API：curl -s -m 30 'http://127.0.0.1:3005/search?q=关键词&format=json'
# n8n：curl -s -m 5 http://127.0.0.1:3004/healthz（应 200）· Web UI http://192.168.10.199:3004 · 手动备份 bash /root/n8n-backup.sh
# 守卫/心跳：/root/container-guard.sh · /root/battery-heartbeat.sh（cron 每 5 分钟）
# 守卫 EXPECTED 回读：grep -n '^EXPECTED=' /root/container-guard.sh（2026-10-21 起 8 个，含 phone-opsviz）；只验不改语法：bash -n /root/container-guard.sh
# 守卫「只检查不告警」验法（脚本无 dry-run）：NEWLIST=$(bash -c 'eval "$(grep "^EXPECTED=" /root/container-guard.sh)"; echo $EXPECTED'); for c in $NEWLIST; do docker ps --format '{{.Names}}' | grep -qx "$c" || MISSING="$MISSING $c"; done; echo "MISSING=[$MISSING]"  ← 期望 [<none>]
# 大文件外送（传输断时）：落到 MTP 可取处 —— DEST=/proc/1/root/storage/emulated/0/Download/<名>；见「USB / MTP 通道」节
# MTP 落盘后立刻可见：chroot /proc/1/root /system/bin/am broadcast -a android.intent.action.MEDIA_SCANNER_SCAN_FILE -d file:///storage/emulated/0/Download/<名>
# MTP 自校验：cd /proc/1/root/storage/emulated/0/Download/<名> && md5sum -c md5.txt
# USB 现状只读核对：cat /sys/class/udc/*/state · readlink /proc/1/root/config/usb_gadget/g1/configs/b.1/function0 · chroot /proc/1/root /system/bin/getprop sys.usb.config
# ⚠️ 2026-10-20 起以下 OpenClaw 命令全部失效（容器已删）；仅作恢复历史参考：
#   备份：/data/backups/openclaw-retire-20261020-1944/（含 root-scripts/ 与原 cron-list.json）
# OpenClaw 重启（改 openclaw-up.sh 后）：bash /root/openclaw-up.sh（停机约 60s；后台：nohup bash /root/openclaw-up.sh > /root/openclaw-up-<TS>.log 2>&1 & 再轮询 tail）
# OpenClaw 凭据自检：docker exec openclaw openclaw models auth list · models status · models auth order get --provider deepseek --agent main
# OpenClaw 最小验收：docker exec openclaw openclaw agent exec --json --thinking off "只回复两个字：pong"（期望 ok:true；同时 tail /srv/status-api/usage.jsonl 应落一笔）
# 401 账本：grep -c 401 /srv/status-api/usage_errors.jsonl · tail -5 /srv/status-api/usage_errors.jsonl
# 内存阈值核对：docker inspect openclaw --format "{{json .Config.Env}}" | grep NODE_OPTIONS · docker exec openclaw node -e "console.log(require('v8').getHeapStatistics().heap_size_limit)"
# OpenClaw 思考档位：docker exec openclaw openclaw config get agents.defaults.thinkingDefault（现 off）· 模型 compat：config get models.providers.deepseek.models · 出站体核对法（baseUrl 临时指向本机捕获服务再原样转发 :3012）见 CHANGELOG 2026-10-15 19:30 篇
# jdguard 状态：supervisorctl status jdguard tunnel-jdguard · 端口 ss -tlnp | grep :3013 · 日志 tail -20 /var/log/jdguard.err.log
# jdguard 验收（本地）：curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1:3013/api/state（401=活着且要鉴权）· 面板 http://192.168.10.199:3013/
# jdguard 验收（远程，权威）：云上 docker exec account-book-nginx wget -qO- http://172.17.0.1:15305/api/state → 401；curl -s -o /dev/null -w '%{http_code}' https://phone.zmlr.top/jd/ → 200
`# jdguard 面板改版验收（2026-10-17 起）：登录后 GET /api/state 应无 slots 键且 ~30ms（此前 ~1.5s）；新增账号走 POST /api/account（可裸 key + 用户名），删除走 POST /api/account/delete`
# jdguard 发版：PC `D:\Projects\手机服务器\jd\deploy\README.md`（tar 传 app/ → chown root → supervisorctl restart jdguard → 回读端口/日志）
# jdguard v2 登录验收：curl -s -X POST -H 'Content-Type: application/json' -d '{"phone":"18063033278","password":"<站点密码>"}' http://127.0.0.1:3013/api/login → 200 + Set-Cookie；白名单外的手机号 → 403
# jdguard v2 用户表：ssh … "python3 -c \"import sqlite3;c=sqlite3.connect('/srv/jdguard/jdguard.db');print(c.execute('select phone,last_login_at from users').fetchall())\""
# 手机桌面（已退役 2026-10-21）：确认没在跑 → supervisorctl status | grep -c desktop（应 0）· ss -tlnp | grep -c :3014（应 0）
# 手机桌面恢复：仅当要复活时 → /root/archive/desktop-20261021.tar.gz（md5 81f7add1…）解到 /srv + 取消 conf 注释 + supervisorctl update
# 十程序状态：supervisorctl status

📒 踩坑全实录（2026-09-26/27 迁移+部署，防复发）#

toolbox tar 解压大 gzip 静默残缺（145MB 包解出缺 gpgv/cputable/server.js，无报错退出码）→ 一律 busybox tar + 解压后 ls 关键文件验证
adb push 推旧包（本地 /tmp 同名旧文件）→ push 前核对字节数
dpkg "Error reading the CPU table" = 缺 /usr/share/dpkg/cputable（docker-export 极简底子缺文件）→ strace 定位 → 从标准镜像补表；apt 随之完全可用
npm ci "Exit handler never called"（手机 docker build）→ npm bug → 构建移云端
registry 三步（2026-09-27 原始方案，-L 5000 转发已于 2026-10-04 退役——registry 迁到手机本地后，autossh 的本地转发会抢占回环 5000 致 phone-registry 无限重启；迁移时备份 supervisord.conf.bak-reg-20261004，sed 移除 -L 段后 reread+update。云 registry 本体保留作回滚后路）
supervisord restart 不重读配置 → 改 conf 必须 reread + update（15301 转发曾因此消失）
nginx bind 单文件配置：宿主 sed/python 改文件 → 容器内 docker cp 会写容器层（污染）→ 正确姿势 = 改宿主文件 + docker restart（重启重挂）或直接 exec nginx -s reload（读宿主当前文件）——不要 docker cp
nginx location 无 proxy_pass = 静态 404（153 字节 nginx 404 页）：proxy_set_header 块孤儿会静默吞请求 → 每次 reload 后必须 curl 全路由验收
两个同名 server 块（conflicting server name）nginx 取第一个 → 多轮脚本插入残留重复块时，先 grep 计数清重
strace -f 是终极武器：docker-untar ENOENT / runc nsexec EINVAL 全靠 strace 定位（今天用了 4 次，每次都直指真相）
PC 侧公网测试被 OpenClash fake-ip 干扰（198.18.x 解析，000 假失败）→ 权威验收用云侧 curl --resolve phone.zmlr.top:443:127.0.0.1（TLS+SNI 完整模拟）
备份密钥 scp 静默失败：目标目录不存在 → scp 报 "dest open No such file"，先建目录
docker cp 写 bind 路径在 vfs 下行为怪（写进容器层非 bind 源）→ 配置分发走宿主文件，不走 docker cp
假象识别：curl 000 ≠ 服务器故障（可能是 PC 代理链路）；supervisorctl BACKOFF ≠ 立即失败（先看 stderr 日志再动作）
手机 docker -p 端口映射不可靠：docker-proxy 正常 LISTEN 但转发永久挂起（curl 无超时会 hang 死，2026-09-27 vaultwarden 实测）→ 对外容器一律 host 网络 + 应用自身绑 127.0.0.1（如 ROCKET_ADDRESS）；SSH 会话里的 curl 一律加 -m
ntfy v2.28 移除 client 子命令（官方镜像/官方二进制均报 "No help topic for 'client'"）→ 服务模式用 subscribe --config=X --from-config；client.yml 没有 per-topic server: 键 → 用 default-host（否则静默订阅到公网 ntfy.sh！）；官方镜像无 curl → 中继改 chroot 二进制 + supervisord 程序（复用系统 curl）
ntfy 不转发子命令 stdout → serverchan.sh 的 Server酱响应日志必须自己写文件（/var/log/serverchan-relay.log），否则推送成功与否完全无观测
host 网络容器的进程可能逃过 dockerd 停止 + /var/lib/docker 清盘（10-04 实证）：老 phone-demo 的 busybox httpd（Sep 27 起，pid 4785）在 dockerd stop 后仍存活并霸占 3000 端口，新容器 bind 失败无限 Restarting；它的工作目录已被清盘删除，对外回 404 更具迷惑性。排查用 ss -tlnp（netstat -tlnp 在 chroot 看不全）；kill（SIGTERM）被无视，kill -9 才死。教训：清 /var/lib/docker 前先 ss -tlnp 核对监听端口归属
容器可写层里有东西 ≠ 可以清：旧 account-book.apk 曾在容器层（约束 #9），2026-10-31 起旧壳退役、该文件不再进容器。清 /var/lib/docker 前仍要对每个容器回答「它的数据在哪」（bind / 镜像 / 容器层）——容器层 = 会丢。
PC 侧 Git Bash → wsl.exe 内联长命令必炸（引号/\U 被双层转译吃掉，实证 printf 写出隐形 0x0B 字符）→ 一律脚本文件执行，详见 devices/local-pc.md
配置项写了 ≠ 生效：校验参数要抓「出站请求体」，不是看配置值（2026-10-15 OpenClaw 思考档位实证）—— 模型行少了 compat.supportsReasoningEffort 时，CLI/界面上的思考档位（--thinking off / high）被静默丢弃：三种档位发出的请求体一模一样。定位手法（20 行 Python 即可，比读 dist 源码快）：把 provider 的 baseUrl 临时指向本机捕获服务（捕获后原样转发给真上游），打印请求体。同族教训：回读「配置里的值」≠ 回读「实际生效的值」；凡「配了不生效」，先抓线路上真实字节（八荣八耻 ①⑤）

覆盖全屏的透明窗口层会吞掉下层点击（2026-10-19 手机桌面实证）：[data-wm=layer]{position:fixed;inset:0 0 68px 0;z-index:6} 盖住 #desk（z-index 2）⇒ 桌面图标与收据全点不动，只有底栏（z 9）正常。修法 = 图层 pointer-events:none + .win{pointer-events:auto}。验收别靠肉眼：页面内置 #diag 哈希把 getComputedStyle 的 pointer-events 与一次真实 click() 结果写进 DOM 再截图（实测输出 PE=none WIN=opened）。
这台手机「收」大文件会卡死或被 reset —— 必须切小片传（2026-10-19 连续复现）：scp、tar cf - | ssh、paramiko SFTP 全部中途 Connection reset by peer；反方向（手机→PC）正常（200KB / 5s）。改成「PC 起 python -m http.server 8098 --directory <目录>、手机 curl 拉」仍不够：单次拉 765KB 只有 827 B/s（240 秒才收到 52KB）。实测可用方案 = 切成 12KB 小片，每片独立 curl -fsS --max-time 45 + 最多 8 次重试并核对字节数；24 片（286KB gzip）25 秒传完。顺序：拉 manifest.txt（片名+字节数）→ 逐片下 → 全部齐了才 cat 拼接 → md5 对 expected.txt → gunzip → python 解析校验 json → 原子 mv 到目标。8098 用完立刻关（否则下次部署在旧进程上误判成功）。
supervisord 没有 conf.d include：把 desktop.conf 放进 /etc/supervisor/conf.d/ 后 reread 报 desktop: ERROR (no such process)，程序必须追加进 /etc/supervisor/supervisord.conf 再 reread/update（改前备份到 /root/archive/）。
chroot 里没有 /sdcard —— 共享存储只能从 /proc/1/root/storage/emulated/0/ 进（2026-10-21 实证）：ls /sdcard /storage /data/media/0 全部 No such file（/data 是分目录 bind，媒体库没挂进来），而 Android 命名空间里的 /proc/1/root/storage/emulated/0 可读可写（root 直写 Download/ 成功，SELinux Enforcing 也放行）。属主照 Download 现有 .apk 对齐：目录 0:9997 0770、文件 0:9997 0660（不是 1023:1023，那是旧版 sdcard_rw 的 GID 习惯）。写完之后必须 chroot /proc/1/root /system/bin/am broadcast -a android.intent.action.MEDIA_SCANNER_SCAN_FILE -d file:///storage/emulated/0/...，MTP 才立刻看得见；PC 侧 WPD 用 FolderItem.GetFolder 下钻（Shell.Application.Namespace(<MTP path>) 对「内部共享存储空间」返回 null，别用）。
别用 content / sqlite3 在 chroot 里验 MediaProvider（2026-10-21 三连失败）：/system/bin/content 是 135B shell wrapper，靠 app_process，在 chroot 里静默无输出（连已知的 magisk.apk 都查不到，别误判成「没登记」）；sqlite3 直连 com.android.providers.media.module/databases/external.db 报 Error: unable to open database file（SELinux 挡，文件本身 10153:10153 0660）；/proc/1/root/system/bin/getprop 直接执行报 cannot execute: required file not found（动态链接器路径为绝对 /system/bin/linker64），必须 chroot /proc/1/root /system/bin/getprop <key>。真正的验收在 PC 侧 WPD 枚举。

📌 遗留清单（2026-10-21 更新）#

#	事项	状态
1	~~Phase B：手机本地 registry:2~~	✅ 2026-10-04 完成（host 网络 :5000，/data/registry bind，LAN-only；PC push ✓ 手机 pull ✓；连带退役 tunnel -L 5000 转发，见踩坑 #5）
2	~~垃圾清理：/data/docker（29MB 实验残留）、/srv/portal~~	✅ 2026-10-04 已删除
3	LOS Updater 禁用（审计 P0：`pm disable-user org.lineageos.updater`，需 adb；重启后 adb 自动关 → 攒到下次 USB 调试时做）	✅ 2026-10-21 复查：已无此包目录 —— `/system/app`、`/system/priv-app`、`/product/app`、`/product/priv-app`、`/system_ext/app`、`/data/app` 六处 `grep -i updater` 全无匹配（`ls -d Updater` 亦 No such file）。磁盘同期 15G→12G(3%)。⚠️ 严格说没跑 `pm list packages`（chroot 内无 adb），属「APK 不在」而非「包已禁用」
4	~~APK 恢复（约束 #9，用户拍板暂缓）~~	✅ 2026-10-31 注销：Capacitor 旧壳退役，APK 改 Flutter 原生构建、走 TG 分包；`public/account-book.apk` 与旧下载路径不再使用，本债不再存在
5	npm build 手机本地重测	❌ 10-05 判负：overlay2 下 npm ci 仍复现 Exit handler never called（vfs 排除；疑 4.19 内核/f2fs/npm 网络），构建维持 PC/云两端，手机不再尝试
6	电池 gauge 月度校准（审计 P1：停看门狗充满一次）	月度例行动作
7	墨账回滚镜像 `a87ef4334c37`（SW v20 的上一版）2026-10-06 被误删——清理 npm 残留时裸跑 `docker image prune -f` 连带回收了它	✅ 10-06 晚间已补齐回滚资产：现役镜像打了标签 `accountbook:20261005-v20`（= `8062088d1b96`）并推入 registry；`latest` 指向 `20261006-obs2c`；旧 `obs2/obs2b` 已回收。铁律不变：手机上禁止裸跑 `docker image prune -f`，未打标签的旧镜像就是回滚资产
8	overlay2 空间账复验（2026-10-06）：`du -sh /var/lib/docker/overlay2` 报 14G 是假象（du 会钻进运行中容器的 `merged/` 联合挂载重复计数）；`--exclude=merged` 后 6.8G = docker 自账（镜像 5.79G + 容器层 1.03G），120 个层目录零孤儿	✅ 已闭环，属测量假象而非膨胀/泄漏，勿再当 P0 处置
9	守卫误报（2026-10-06 发现已修）：`container-guard.sh` 把"非 RUNNING 的 supervisord 程序"一律算异常，而 ntfy-relay 自 10-05 停用 → 长期处于 `进程:[ntfy-relay=STOPPED]` 告警态（真告警被混淆、恢复通知永不触发）。处置：整块移除退役的 ntfy-relay program + `EXPECTED` 补 openclaw/phone-registry（原先漏守！）/移出已停车的 n8n	✅ 已闭环（守卫复跑全绿、无告警态）
10	n8n 停车（2026-10-06，D1 + 用户拍板选项 A）：唯一工作流 active=0 却仍运行 346MiB → `docker stop phone-n8n`（容器与数据保留，`docker start` 即回）；备份 cron 由每日降为每周日 04:25（数据静态；执行位事故已修，见下行）。判断依据：n8n＝确定性数据管道工具，与小龙虾的 LLM 编排互补而非替代 → 观察期至 2026-11-05；复活条件与彻底下线清单见 CHANGELOG 当日	⏸ 停车观察中
11	实验残留清理（2026-10-06）：`/data/pg2`(39M 旧 pg) `/data/pgtest` `/data/pgcfg` `/data/local/tmp/abapp`(27M) → 打包 `/root/archive/residue-20261006.tar.gz`(13M,3302 项) 后删除；LOS 期 43 个仪式脚本归档 `/root/archive/retire-20261006/los-era/`	✅ 已闭环（/data 由 16 目录降到干净集合）
12	`/root` 残骸二次清理（10-06 晚间）：删 `accountbook-src`(64M，含明文凭据字段) / `ab-v3.tar.gz` / `accountbook-compose.yml`；`accountbook-latest.dump` 与 runc 源码树（29M）归档入 `/root/archive/retire-20261006/`	✅ 已闭环（`/root` 仅剩在役脚本 + archive）
13	`15222`（手机 SSH 的公网入口）收紧方式待定：云端 `sshd GatewayPorts yes` 让手机 `-R` 转发绑 `0.0.0.0`，`15222` 从公网可达（仅密钥、root 禁口令，风险中低）。三个选项：保留现状 / 限制来源 IP / 改 `clientspecified`（转发只绑 172.17.0.1，届时需先登云主机）——等用户决定。数据端口 15300-15303 已于 10-06 用 iptables 限制为仅 docker 网段	⏳ 待用户拍板
14	小龙虾工具权限收口（CLW-2，原 CLW-1 的补强）：10-06 已加 `gateway.auth.token`，但实测 loopback 绑定下不改变本机进程可达性（官方语义：非 loopback 才强制 auth）。真正手段在 `/gateway/config-tools/tool-policy`（`tools.allow/deny`、`bySender`、`elevated`）或把容器从 host 网络隔离——任选其一都需先副本验证，避免影响 06:30 早报	⏳ 待排期
15	中转 401 频次量化（10-07 起埋点 `usage_errors.jsonl`）	✅ 2026-10-15 已闭环（真相＝残留废档案，不是中转抖动）：状态库 `authProfiles.store` 里 `deepseek:default`（`sk-…`，与 Command Code baseUrl 不匹配）排第一 → 每天 03:00/06:30 首轮必 401（日志 `reason=auth` 38 次 / `usage_errors.jsonl` 47 条），且 03:00 dreaming 因 `next=none` 每天降级。已 `models auth logout` 删除 + 备份，当场最小轮次 `ok:true` 验收，重启后 401 计数 0。判据修正：401 ≠ 中转抖动，先查凭据档案	✅ 已闭环
16	`heartbeat skipped: no-route` 每 30 分钟刷一次 `failed`（02:54/03:24/…/04:54 连续）：Heartbeat(main) 无投递路由 → 持续污染 `task_runs`，会淹没真故障。处置选项：给它指定路由，或改为不落 failed	⏳ 待排期
17	openclaw 内存压力（10-07 实测 1.57–2.01 GiB vs 阈值 1.5 GiB）	✅ 2026-10-15 已处置：阈值＝内置常量 `min(max(1536MB, 0.5×heap_size_limit), 0.5×cgroup)`，在 `/root/openclaw-up.sh` 加 `NODE_OPTIONS=--max-old-space-size=4096` → heap_size_limit 2240→4288 MiB → 阈值 1.5→2.09 GiB；重建后告警 0 条。⚠️ 仍需观察 RSS 是否单调上行（真涨破 2.09 GiB 属真信号，配合 #14 容器隔离评估）	⏳ 观察中（阈值已抬）
18	OpenClaw 记忆检索无 key（2026-10-15 doctor 发现）：`memory.search.provider=openai` 而库内无 openai 凭据 → 语义检索不可用；不影响聊天/日报，但影响记忆召回	⏳ 待排期（配 key 或 `config set memory.search.enabled false`）	→ 随退役关闭，不再处置
19	03:00 dreaming 恢复验证：删档后第一次自然跑批＝2026-10-16 03:00，需确认 `memory-core` 叙事生成不再 `next=none` 降级、`dreaming promotion complete` 的 `narrativesPending` 归零	⏳ 待 10-16 晨验收
20	LOS Updater 仍待禁（＝#3，2026-10-15 体检复见 `org.lineageos.updater` 常驻 RSS 156MB；`pm disable-user` 需 adb）	✅ 2026-10-21 复查已无 Updater APK（六个 app 目录全无匹配），磁盘 3% ⇒ 此条可注销；日后若 RSS 里再出现 org.lineageos.updater 再处置
21	OpenClaw 思考档位（reasoning_effort）从未生效（2026-10-15 发现）：模型行缺 `compat` → 档位静默丢弃、上游按默认思考跑（重推理题 78–155 token）。处置＝`agents.defaults.thinkingDefault:"off"` + 模型 `compat.supportsReasoningEffort`（详见 OpenClaw 段「思考档位」行 + CHANGELOG 同日 19:30 篇）	✅ 已闭环（19:24 热加载生效，改后 reasoning_tokens 0；备份 `/data/openclaw/openclaw.json.bak-thinkingoff-20261015-192358`）。⚠️ 该默认 off 同时作用于 03:00 dreaming 与 06:30 日报等 isolated 跑批（省 token）；若后续发现叙事/日报质量下降，用备份回滚或单次 `--thinking high` 对比	→ 随退役关闭（修复过程已并入历史，见 OpenClaw 节）
22	`container-guard.sh` 的 EXPECTED 漏 `phone-opsviz`（2026-10-21 巡查发现）：现为 7 容器 `phone-portal phone-accountbook-postgres phone-accountbook-app phone-demo phone-ntfy phone-vaultwarden phone-registry` —— opsviz 自 10-06 上线起就没进守卫，而它是容器、supervisord 侧发现不了	✅ 2026-10-21 已闭环（用户授权「7 看你自己」）：备份 `/root/archive/container-guard.sh.bak-20261021`（600，md5 `eaca59ec88f20323b4317b2346fa161e` = 原文件）→ `sed` 唯一命中追加 `phone-opsviz` → 现为 8 容器（`…phone-vaultwarden phone-registry phone-opsviz`）→ `bash -n` rc=0 → `diff` 仅第 6 行一处 → 只跑比对循环（不推送告警）`EXPECTED_COUNT=8` / `MISSING=[<none>]` / `OPSVIZ_RECOGNIZED=yes` → 文件 1441B/755、crontab `*/5` 未变
23	`/data/notify/dead.jsonl` 里存着历史「口令轮换完成」通知的明文口令（2026-10-21 发现）：3 条死信中有 2 条是轮换通知正文（墨账/运维可视化/指挥舱口令原文），文件权限 0666 全可读	✅ 2026-10-21 已闭环（用户授权）：先就地提取 4 个 20 位口令串（不落到 PC 脚本里）全盘查重 → `/data /root /srv /etc /var/log /tmp` 只有 `dead.jsonl` 一处命中、`outbox/` 空；再 `cp -p` 备份（md5 一致 `2024f17cddf71f8e1fde8dc4a8d95c40`）并把备份降到 600 root-only；然后 `shred -u -z -n 2`（rc=0）+ `rm -f report-guard.state`（另备份 600）→ 回读两文件均 `GONE`；shred 后二次全盘扫 4 个串零命中。⚠️ 残留原为 `/root/archive/dead.jsonl.bak-20261021`（600 root-only）—— 该备份已于 2026-10-21 10:57 销毁（详见 #24）
24	口令轮换退役尾巴（10-19 退役、10-21 彻底清零）：手机侧 crontab 轮换行、`/root/ops_rotate.py`、`/data/rotate/` 早已移除；PC 侧任务是否已停当时未核	✅ 2026-10-21 已闭环（用户授权「相关功能下线」）：① 手机残留收进 `/root/archive/ops-rotate-retired-20261021/`（700；`ops_rotate.py` 600 sha `2dd81225…d10e3`、`crontab.bak-rotate-off-20261019` 600 sha `8dfa6454…8a5de`、`RETIRED.md` 938B），旧空目录 `rotate-retired-20261019/` 移除；② 复核 crontab 14 行 0 条 rotate、supervisord 13 程序无轮换项、`/etc/cron.d` 无、无 systemd timer（chroot）、`/var/log/ops-rotate` 不存在；③ 归档外 `grep -rIl ops_rotate` 零引用（`/data/opsviz/content/content.json` 仅正文文本提及）；④ `dead.jsonl.bak-20261021`（sha `10a893db…cdf1c`，788B）经不可逆校验确认为旧口令*（文件内 4 串 0 命中线上哈希，凭据档三口令 100% MATCH）→ `shred -u -z -n 2` rc=0，回读 GONE、全盘二次扫 0 命中；⑤ PC `Ops-Secrets-Sync` 回读 `Disabled/N/A`，新增 `ops/README-retired.md`，`secrets_sync.py` 头注释已标退役（备份 `…bak-20261021`，sha `87576320…00e9c`）。⚠️ 遗留：`phone-opsviz` 容器 bind mount `/data/rotate` 需重建容器才能清（未做）	✅ 已完成（2026-10-21）
25	手机桌面 PC 正本滞后（2026-10-21 发现）：`/srv/desktop/` 三文件 10-21 01:03–01:16 更新（index 35821B / _shell 7623B / server 5499B），而 `D:ProjectsPCphone-desktopapp` 仍是 10-19 版（27933/7355/5194B）⇒ 照文档从 `app/` 部署会把 10-21 的改动回滚掉	🔶 待拉回（2026-10-21 已备好，等取件）：新版 12 文件（188,989B）已原样备到 ① `/tmp/desktop-1021/`、② MTP 可取 `…/storage/emulated/0/Download/desktop-1021/`（含 `md5.txt`），两处与源 `mismatch_count=0`；逐文件大小+md5 清单见 `D:ProjectsPCops-audit-20261021outdesktop-1021-manifest.txt`。⚠️ 拉回并覆盖 `app/` 之前不许部署（`app/` 仍是 10-19 版，部署=回滚掉 10-21 改动）
26	零字节残留（2026-10-21 实测）：`/root/app.tgz`(0B, 10-20 07:11)、`/data/opsviz/content/content.json.tmp`(0B, 10-20 21:14，一次失败发布的残片)；`/root/openclaw-harden.sh`(2880B) 是已退役 openclaw 的脚手架仍在	低危可忽略（删文件属写操作，等用户点头）

本文目录