This commit is contained in:
2025-10-05 01:34:22 +08:00
parent 7b139d404e
commit aa8fcccf7d
4 changed files with 48 additions and 6 deletions

View File

@@ -11,6 +11,9 @@
- [API 文档](#api-文档)
- [使用示例](#使用示例)
- [故障排查](#故障排查)
- [使用限制](#使用限制)
- [安全考虑](#安全考虑)
- [配置](#配置)
## 概述
@@ -25,6 +28,7 @@
- ✅ 权限控制(必须有一个超管)
- ✅ 房间人数限制(最多 2 人)
- ✅ 离线检测和自动清理
- 🖥️ 仅支持桌面端(移动端不可用)
## 技术栈
@@ -617,6 +621,41 @@ setTimeout(() => {
}, AWARENESS_SYNC_DELAY)
```
## 使用限制
### 平台支持
协同编辑功能**仅支持桌面端**,移动端不可用。
**原因:**
1. **屏幕空间限制**
- 移动端屏幕较小,难以同时显示光标位置和多用户状态
- 协同编辑的用户信息标签需要足够的显示空间
2. **交互体验**
- 移动端触摸输入与协同编辑的光标跟随机制不够友好
- 桌面端的键盘和鼠标操作更适合代码编辑协作
3. **性能考虑**
- WebRTC 连接在移动设备上可能不够稳定
- 移动端的网络切换WiFi/4G/5G可能影响连接质量
**检测逻辑:**
```vue
<!-- Form.vue -->
<IconButton
v-if="isDesktop && userStore.isAuthed"
:icon="isSynced ? '...' : '...'"
@click="toggleSync"
/>
<template v-if="isDesktop && props.isSynced">
<n-tag>同步状态</n-tag>
</template>
```
## 安全考虑
### 1. 权限控制