工程改进：跨语言契约固化、日志脱敏、状态模型收敛

依据 docs/项目工程改进方案.md 实施（第五梯队 CI/协作除外）。

安全性
- Release 剥离 Log.v/d/i/w（-assumenosideeffects），保留 Log.e
- 全量频道/成员 dump、消息正文、发送者 UID 改为 BuildConfig.DEBUG 保护
  （实测 release dex 中 "Channel: id=" / "Client: id=" / selfId= 等均为 0 命中）

构建产物体积
- .gitignore 补 *.a（保留 .opus/lib 四个 ABI 预编译库）、.opus/install、
  app/libs/*.aar、dnn/torch
- git rm --cached 除名 AAR、.gradle、.opus/{build,install}、dnn/torch
  跟踪体积 50MB → 17.4MB，工作区文件不受影响

跨语言契约（本方案核心）
- 新增 go/teamspeak/contract.go：字段名常量 + BridgeContractVersion 单一事实来源
- 新增契约测试：反射断言常量与 struct tag 一致；Go/Kotlin 共用 golden 样本
- 新增 BridgeContract.kt：启动校验 AAR 契约版本，不匹配则阻止连接
- 修正文档：channel_order 是前驱频道 ID（链表指针）而非排序权重，
  按它数值排序会打乱频道树；ChannelInfo.order 在 Go 侧不存在

状态模型
- ConnectionState 增 Idle 取代 null 编码，connectionState 不再可空
- applyClients 改为按频道差分更新，避免全量刷新导致频道树整体重组
- 频道数据 freshness 统一由 Repository 维护，修复 ViewModel 与 Repository
  两份时间戳不同步导致的重复刷新

UI
- 修复 collectAsState() 在参数位置调用导致的 isSelf 快照失效
- 消除 9 处 !! 断言（ChannelListScreen）
- 硬编码 24.5/14.5dp 与 depth*24 收敛到 UiTokens.Spacing，缩进加 4 层上限

测试
- Kotlin 测试 7 → 106；Go 契约测试新增 24 个用例
- 各覆盖 InputValidator、消息送达确认、僵尸会话过滤、频道差分、
  频道顺序语义、错误分类

其他修复
- classifyError 提取为纯函数并补测试；修复 too many clones (id=521)
  未识别导致英文原文直接暴露给用户

版本号提升至 1.0.13（versionCode 13）

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

CLAUDE.md

@@ -88,8 +88,8 @@ Four routes in `NavGraph.kt`: `server_config` (connection form) → `channel_lis
 
 ### Known SDK Limitations
 
-- **No channel CRUD events**: The SDK does not fire events for channel create/update/delete. Channel list is refreshed after 5 minutes of staleness or before channel switch operations.
-- **Unreliable ChannelID in enter events**: `notifycliententerview` ChannelID is not effective per SDK docs. Client enter/leave events trigger a full `clientlist` refresh instead of incremental updates.
+- **No channel CRUD events**: The SDK does not fire events for channel create/update/delete. Channel list is refreshed after 5 minutes of staleness or before channel switch operations. Staleness is tracked by `Repository.channelsFetchedAt` and surfaced in the UI via `StaleChannelBanner`.
+- **Unreliable ChannelID in enter events**: `notifycliententerview` ChannelID is not effective per SDK docs. Client enter/leave events trigger a full `clientlist` refresh instead of incremental updates. To keep this from rebuilding the whole channel tree, `Repository.applyClients` does a **per-channel differential update** (`diffChannelClients`) that reuses unchanged list instances.
 - **Auto-reconnect disabled by default**: Frequent reconnect attempts cause server-side rate limiting/bans.
 
 ### Thread Safety
@@ -151,4 +151,38 @@ AAR not compiled or not in `android/app/libs/teamspeak.aar`. Run Step 1 of manua
 
 Run from IDE with connected device or emulator. Check Logcat in IDE for runtime logs.
 
-Go unit tests exist for the audio receive pipeline (`go/teamspeak/receive_audio_test.go`): `cd go && go test ./teamspeak/`
+```bash
+# Go：音频接收管线 + 跨语言契约
+cd go && go test ./teamspeak/
+
+# Kotlin：契约反序列化 + 纯逻辑（无需设备）
+cd android && ./gradlew testDebugUnitTest
+```
+
+### Cross-language contract
+
+Go ↔ Kotlin 的 JSON 字段约定是**编译器无法校验**的边界（改字段名只会静默拿到默认值）。
+三道机制钉住它，改动 bridge 字段时必须一起维护：
+
+| 文件 | 作用 |
+| --- | --- |
+| `go/teamspeak/contract.go` | 字段名常量的单一事实来源 + `BridgeContractVersion` |
+| `go/teamspeak/contract_test.go` / `contract_golden_test.go` | 反射断言常量与 struct tag 一致；golden 样本一致性 |
+| `android/.../data/BridgeContract.kt` | 启动时校验 AAR 契约版本，不匹配则阻止连接 |
+| `android/app/src/test/resources/contract/` | **Go 与 Kotlin 共用**的 golden 样本 |
+| `docs/bridge-contract.md` | 逐字段对照表与 targetMode 收发能力矩阵 |
+
+不兼容变更（字段改名/类型变更/删除）必须递增 `BridgeContractVersion` 并同步
+`BridgeContract.EXPECTED_VERSION` 与该文档。
+
+### Known gotchas fixed here
+
+- **`ChannelInfo.order` 在 Go 侧不存在**（`channelJSON` 无 `order` 字段），
+  恒为默认 `0`，`buildChannelTree` 的 `sortedBy { it.order }` 是 no-op。
+  频道显示顺序由 TS3 `channellist` 的响应顺序决定（已真机验证与显示一致），这是正确的。
+- **`channel_order` 不是排序权重，是前驱频道的 ID**（链表指针，`0` = 本层最前）。
+  见 `docs/teamspeak-sdk-3.5.2/doc/client/channel-sort.html`。
+  **不要按它数值排序**——那会打乱频道树。若要在客户端重建顺序，需按前驱指针串链。
+- **私聊（targetMode=1）只能收、不能发**。`TSBridge.sendTextMessage` 仅实现 `mode=2`。
+- **频道陈旧判定统一走 `Repository.isChannelDataStale()`**。
+  不要在 ViewModel 里另建时间戳——历史上两处时间戳不同步会导致重复刷新请求。