@lzpenguin/server 1.0.6 → 1.0.7

package/README.md

@@ -37,80 +37,6 @@ server.init({
 });
 ```
 
-## 新特性 🎉
-
-### 同步优化（v2.0+）
-
-我们对同步机制进行了全面优化，提供更可靠和高效的数据同步：
-
-#### 1. **时间戳和序列号**
-- ✅ 每条消息都包含服务器时间戳和序列号
-- ✅ 自动检测消息丢失和延迟警告
-- ✅ 确保数据按正确顺序处理
-- ✅ 实时显示网络延迟和序列号状态
-
-```javascript
-server.onData((data) => {
-  console.log('时间戳:', data.timestamp);
-  console.log('序列号:', data.sequence);
-  console.log('数据:', data.world);
-});
-```
-
-#### 2. **操作确认机制**
-- 支持回调确认每个更新操作
-- 自动超时检测（5秒）
-- 返回唯一操作ID用于追踪
-
-```javascript
-server.update({
-  world: { score: 100 }
-}, (error, result) => {
-  if (error) {
-    console.error('更新失败:', error);
-  } else {
-    console.log('更新已确认:', result);
-  }
-});
-```
-
-#### 3. **增量更新**
-- 只发送变化的数据，节省带宽
-- 支持数组追加操作
-- 特别适合笔画等增量数据
-
-```javascript
-server.updateDelta({
-  world: {
-    strokes: {
-      $append: [newStroke]  // 只追加新笔画
-    }
-  }
-}, (error, result) => {
-  console.log('增量更新完成');
-});
-```
-
-#### 4. **自适应推送频率**
-- 服务器根据活动情况动态调整推送频率
-- 高活动：50ms 推送一次
-- 中活动：100ms 推送一次
-- 低活动：200ms 推送一次
-- 无活动：500ms 推送一次
-
-#### 5. **统计信息**
-- 实时查看连接状态和同步统计
-- 监控消息丢失和延迟
-
-```javascript
-const stats = server.getStats();
-console.log('连接状态:', stats.connected);
-console.log('本地序列号:', stats.localSequence);
-console.log('最后接收序列号:', stats.lastReceivedSequence);
-console.log('待确认操作数:', stats.pendingOperations);
-console.log('更新次数:', stats.updateCount);
-```
-
 ## API
 
 ### 构造函数
@@ -168,20 +94,9 @@ server.init({
 部分更新数据（合并到现有数据，不替换）。
 
 ```javascript
-// 基本更新（不带确认）
+// 更新世界数据
 server.update({ world: { score: 200 } });
 
-// 带确认回调的更新（推荐）
-server.update({
-  world: { score: 200 }
-}, (error, result) => {
-  if (error) {
-    console.error('更新失败:', error);
-  } else {
-    console.log('更新已确认');
-  }
-});
-
 // 更新玩家数据
 server.update({
   self: {
@@ -197,12 +112,6 @@ server.update({
 });
 ```
 
-**参数：**
-- `updateData`: 要更新的数据对象
-- `callback` (可选): 确认回调函数 `(error, result) => {}`
-
-**返回值：** 操作ID（字符串），可用于追踪操作
-
 **响应数据（通过 onData 接收）：**
 ```json
 {
@@ -235,11 +144,9 @@ unsubscribe();
 **数据格式：**
 ```json
 {
-  "timestamp": 1705123456789,
-  "sequence": 42,
   "world": { "score": 200, "level": 1 },
   "self": {
-    "public": { "name": "Player1", "position": { "x": 15, y: 25 } },
+    "public": { "name": "Player1", "position": { "x": 15, "y": 25 } },
     "private": { "health": 90, "mana": 50 }
   },
   "players": [
@@ -249,74 +156,6 @@ unsubscribe();
 }
 ```
 
-**字段说明：**
-- `timestamp`: 服务器时间戳（毫秒）
-- `sequence`: 消息序列号（用于检测消息丢失）
-- `world`: 世界数据
-- `self`: 当前玩家数据
-- `players`: 其他玩家数据
-
-### 4. updateDelta() - 增量更新 ✨
-
-只发送变化的数据，适合频繁更新的场景（如画板笔画）。
-
-```javascript
-// 追加新笔画（不发送整个数组）
-const newStroke = {
-  id: 'stroke_123',
-  points: [{ x: 0, y: 0 }, { x: 10, y: 10 }],
-  color: '#FF0000',
-  width: 2
-};
-
-server.updateDelta({
-  world: {
-    strokes: {
-      $append: [newStroke]  // 使用 $append 标记表示追加
-    }
-  }
-}, (error, result) => {
-  if (!error) {
-    console.log('笔画已添加');
-  }
-});
-```
-
-**参数：**
-- `delta`: 增量数据对象（支持 `$append` 等特殊操作）
-- `callback` (可选): 确认回调函数
-
-**返回值：** 操作ID
-
-### 5. getStats() - 获取统计信息 ✨
-
-获取实时同步统计信息，用于监控和调试。
-
-```javascript
-const stats = server.getStats();
-console.log(stats);
-// {
-//   connected: true,
-//   initialized: true,
-//   localSequence: 10,
-//   lastReceivedSequence: 8,
-//   lastReceivedTimestamp: 1705123456789,
-//   pendingOperations: 2,
-//   updateCount: 10,
-//   lastUpdateTime: 1705123456789
-// }
-```
-
-**返回值：**
-- `connected`: 是否已连接
-- `initialized`: 是否已初始化
-- `localSequence`: 本地发送的序列号
-- `lastReceivedSequence`: 最后接收的序列号
-- `lastReceivedTimestamp`: 最后接收的时间戳
-- `pendingOperations`: 待确认的操作数量
-- `updateCount`: 总更新次数
-- `lastUpdateTime`: 最后更新时间
-
 **推送时机：** init 响应、定时推送（每 0.2 秒）、init/update 后立即推送
 
 ## 联机游戏示例

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lzpenguin/server",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "description": "Riffle 游戏服务器 WebSocket 客户端 SDK",
   "license": "ISC",
   "author": "lzpenguin",