refactor: 清理死代码/提前失败/日志/高内聚低耦合

死代码移除:
- useWhiteboard.js: 移除未使用的 suppressInput 变量及 6 处赋值;
  移除 isInputSuppressed / _getSuppressInput / _setEditor 导出;
  scheduleSend 从公开 API 降为内部函数; setStatus 移除未用 isErr 形参
- useLocale.js: 移除未用的 isZh/pick/locale 返回值及 computed 导入
- App.vue: 移除未用的 ref 导入
- i18n locales: 移除 5 个死 key (switch/copied/copiedLink/copyFailed/emptyText)

提前失败/日志:
- 7 处 silent catch (send/connect/onerror/onMessage JSON.parse/
  applyRemoteUpdate setSelectionRange/connectBoard 预取/teardownSocket)
  全部加 console.error/warn, 统一 [zWB] 前缀
- App.vue onCopyText/onCopyLink 失败 console.warn

文档:
- 新增 docs/error-handling.md, docs/integration.md
- README.md 重写为简洁版 (简介/结构/外部依赖/Ubuntu 安装使用/docs 链接)

docs/error-handling.md

@@ -0,0 +1,22 @@
+# 错误处理与日志约定
+
+zWhiteBoard 是实时同步客户端，错误处理分两层：WS 客户端 fail-fast（关键路径抛错/记日志），UI 层捕获后写控制台。
+
+## WS 客户端（src/composables/useWhiteboard.js）
+
+- `send`：`ws.send` 序列化失败 `console.error`（WS 通常是 RUNNING 状态，此分支极少触发，但记日志便于定位）。
+- `connect`：`new WebSocket()` 抛错 `console.error` + 安排重连（URL 非法或浏览器拦截时）。
+- `ws.onerror`：透传 `console.error`（浏览器仅给泛化错误，无 detail，但能标记故障时间点）。
+- `onMessage`：JSON.parse 失败 `console.warn` 后忽略（不抛错，避免单条坏消息中断后续同步）。
+- `applyRemoteUpdate`：`setSelectionRange` 失败 `console.warn`（光标修复非致命，文本已正确替换）。
+- `connectBoard`：GET `/api/wb/{id}` 预取失败 `console.warn`，仍尝试连 WS（预取仅为优化，WS init 帧会兜底下发内容）。
+- `teardownSocket`：关闭旧 WS 出错 `console.warn`（清理路径，不应阻塞切换）。
+
+## UI 层（src/App.vue）
+
+- `onCopyText` / `onCopyLink`：剪贴板 API 拒绝时 `console.warn`（HTTPS/权限策略限制，非致命，不影响同步）。
+- `onClear`：未连接直接 return（不发 clear）；用户取消确认框直接 return。
+
+## 控制台前缀
+
+所有 `[zWB]` 前缀的日志来自本子项目，便于嵌入宿主时与宿主日志区分。

docs/integration.md

@@ -0,0 +1,20 @@
+# 嵌入 mainPage
+
+zWhiteBoard 作为 [mainPage](https://git.zikai.wang/zikai/zMainPage) 的 git submodule（`third_party/zWhiteBoard`），经构建期组件 import 集成（非 iframe，与 timeTableFix / zPDF_package 同范式）。
+
+## 集成方式
+
+- mainPage 侧 `src/modules/whiteboard/Whiteboard.vue` 套 `PageShell` 并透传 `:locale` / `:boardId` props。
+- 构建期直接 `import` 本项目 `src/App.vue`，共享 mainPage 的构建与 KeepAlive 缓存。
+- 组件内 `useWhiteboard.js` 同源 fetch `/api/wb/*` 与 WS `/api/ws/wb/*`，反代第一方自动携带 cookie，无需 CORS。
+
+## 便携式设计（无 host 依赖）
+
+组件自身保持「无 host 依赖」：
+
+- 不持 `defineOptions({ name })`（避免与宿主组件名冲突）。
+- 不引 mainPage 的 i18n，仅靠 `:locale` prop 驱动自有 i18n 实例。
+- `useLocale` 直接读本子项目模块级 `i18n.global`，而非 `useI18n()`（后者嵌入时会解析到宿主实例，文案回退成 key）。
+- `App.vue` 仅经 `:boardId` prop 决定连哪个白板，不耦合宿主路由。
+
+详见 mainPage 的 `docs/submodule-zWhiteBoard.md`。