@mu-cabin/muc-cli 0.5.2 → 0.5.4

package/README.md

@@ -141,7 +141,7 @@ npx skills add <everything-cli 仓库地址>/packages/muc/skills -y -g
 
 ### Skill 的行为规则
 
-- **首次 TCP 命令前**：Skill 会弹 `AskUserQuestion` 提示槽位风险，等你确认后再执行。
+- **首次直连 TCP 命令前**：Skill 只提醒“同账号 iPad 可能被踢”，不再等待槽位确认，随后直接执行。
 - **不确定发给谁**：先用 `muc search` 缩小候选名单，通过 `AskUserQuestion` 让你选，不会猜。
 - **非自身目标**：必须经过你显式确认，不会偷偷给真实联系人发消息。
 - **token 过期**：自动用 `--token-pwd` 静默续登，续登失败才要求你手动 `muc login`。
@@ -232,25 +232,23 @@ muc withdraw --mid <mid> --to-self                   # 撤回自己发出的消
 
 ---
 
-## 和桌面端 / 手机端共存
+## 和桌面端 / 手机端 / iPad 共存
 
 REST 命令（`search`、`history`、`whois`、`groups` 等）**永远可以共存**，与桌面端、手机端同时在线互不影响。
 
-聊天通道命令（`send*`、`withdraw`、`sync`、`search-team`、`team-members`）受 MUC **单点登录**规则约束：每个账号在 **PC 端**和**移动端**各只允许**一个**在线设备，同一端登第二个会把第一个挤下线（和"在另一台 Mac 上登 MUC 就把当前这台顶掉"是一回事）。CLI 通过 `--os` 决定自己算哪一端：
+聊天通道命令（`send*`、`withdraw`、`sync`、`search-team`、`team-members`）进入 MUC 实时通道。每个账号有 **PC、Mobile、iPad 三个独立槽位**；同槽后登录会把前一个挤下线。CLI 继续沿用 `--os` 选槽位，其中 `iPad` 是逻辑值：线上报文实际发送 `os:"iOS"` 和 `browser:"iPad"`。
 
 | 算作哪端 | 对应的 `--os` 取值 |
 |---|---|
 | PC 端 | `Windows` / `OS X` / `Mac`（Mac 桌面端登录时上报的是 `OS X`） |
-| 移动端 | `iOS`（CLI 默认）/ `Android` |
+| 移动端 | `iOS` / `Android` |
+| iPad 端 | `iPad`（CLI 默认；线上报文为 `os:iOS + browser:iPad`） |
 
-> ⚠️ **默认发送消息会使移动端下线，谨慎使用。** CLI 默认 `--os iOS`，算"移动端"。
-> 只要跑了 `send` / `withdraw` 等聊天通道命令，**正在登录 MUC 的 iPhone 会被立刻挤下线**
-> （`accessToken` 不失效，但要重新打开 App 才能继续收实时消息）。
+> ⚠️ CLI 默认使用 **iPad 槽位**。PC 桌面端和手机端可以继续在线；如果同账号正登录 iPad，iPad 可能被挤下线，重新打开 App 即可恢复，`accessToken` 不失效。
 >
 > - 测试或跑通流程时，先用 `muc send --to-self ...` 发给自己。
-> - 真要 `--peer` / `--team` 发出去之前，确认**没人在等 iPhone 上 MUC 的实时消息**。
-> - 如果手机 MUC 必须保持在线，**整段流程改用 REST 命令**（`history`、`search`、`groups`…），别碰聊天通道。
-> - **不要**显式传 `--os Windows / OS X / Mac`——那会把 Mac 桌面端 MUC 也顶下去。
+> - `--os iOS/Android` 会改占 Mobile 槽位，可能踢手机；`--os Windows/OS X/Mac` 会改占 PC 槽位，可能踢桌面端。
+> - Skill 对默认 iPad 风险只做非阻塞提醒，不再要求预先确认槽位；发送给真实联系人、撤回等业务确认仍保留。
 
 `muc tcp-ping` 只做 TCP 连接和 NEGOTIATE，**不发登录帧**，不占任何在线名额，纯连通性测试，可以随时跑。
 
@@ -280,7 +278,8 @@ packages/muc/                  （everything-cli 工作区中的一个包）
 ├── scripts/build.mjs           esbuild 打包脚本（→ dist/muc.mjs）
 ├── bin/muc                     tsx 入口（零构建直接跑 src/）
 ├── README.md                   本文件
-└── REFERENCE.md                完整命令 / 协议参考
+├── REFERENCE.md                完整命令 / 协议参考
+└── NATIVE_API.md               MUC 原生协议全景 / CLI 实现状态
 ```
 
 > 协议研究文档与抓包脚本保留在内部源码研究仓库，未随本包导入；下文"协议抓包 /
@@ -311,7 +310,7 @@ python3 analyze_api.py flows.ndjson --host muc.example.com
 ### 改动后测试流程
 
 1. `pnpm run typecheck`（在 `packages/muc` 下）— 先过类型检查。
-2. 按内部 `TEST_CASES.md` 从头到尾跑一遍（§1 REST 读 + §2 `tcp-ping` 无条件跑；Mac 桌面 + iPhone 同时在线时跳过 §3 §4）。
+2. 按内部 `TEST_CASES.md` 从头到尾跑一遍；实时命令默认走 iPad 槽位，实机验证前确认没有需要保持在线的同账号 iPad。
 3. 任何一项失败：把 `--json` 原始信封贴给用户，停下来，不要"修一修再跑"。
 
 ### 协议层参考（内部文档）
@@ -323,6 +322,6 @@ python3 analyze_api.py flows.ndjson --host muc.example.com
 ### 红线
 
 - **绝不入库** `accessToken`、`tokenPwd`、明文密码、`clientSecret`、`pfxPass`、`bsSecretKey`、`encrypt_key`，以及租户密钥（`APP_KEY` / `sign secrets`）。
-- **CLI 默认会顶掉同账号的 iPhone 端 MUC**（默认 `--os iOS`，单点登录规则）；显式传 PC 类 `--os` 会顶 Mac 桌面端；桌面 + 手机都需要保持在线时，整段流程退到 REST 命令。
+- **CLI 默认占用同账号的 iPad 槽位**（`--os iPad` → `os:iOS + browser:iPad`），可能顶掉真实 iPad；显式传 Mobile/PC 类 `--os` 才会影响手机/桌面端。
 - **CLI 发的消息所有参与方都可见。** 非自身目标必须带 `--yes-not-self`，先用 `--to-self` 测。
 - **不要擅自改 Surge 配置文件**（`~/Library/Application Support/Surge/Profiles/*.conf`）。要加 MITM hostname 让用户在 Surge UI 里加。