كيف نحافظ على مزامنة مثالية للحالة عبر علامات تبويب متعددة من دون WebSockets أو منطق خلفي معقد.
كيف نحافظ على مزامنة مثالية للحالة عبر علامات تبويب متعددة من دون WebSockets أو منطق خلفي معقد.
هل سبق أن فتحت علامتي تبويب لنفس التطبيق وفقدتا التزامن؟ لقد حللنا هذه المشكلة على مستوى إطار العمل.
لنفترض أنك تستخدم تطبيقاً. تفتح علامة تبويب ثانية. تجري تغييرات في علامة التبويب الأولى، لكن علامة التبويب الثانية لا تتحدث.
سيناريوهات شائعة:
أو:
تتجاهل معظم التطبيقات هذا الأمر، بينما يقوم Almadar بحله.
مزامنة الحالة عبر علامات التبويب تتطلب:
Tab 1 (Client A) Transport Tab 2 (Client B)
│ │ │
│ notifyStateChange() │ │
│──────────┐ │ │
│ ▼ │ │
│ StateSyncManager │ WebSocket/SSE │
│ │ │◄──────────────────►│
│ │ stateChange │ │
│ └──────────────►│ │
│ │ broadcast │
│ │────────────────────►│
│ │ │
│ │ receiveRemoteChange()
│ │ │
│ │◄───────────────────┘
│ │ │
│ conflict? │ │
│◄─────────────────────────┤ │// Internal: Almadar's state synchronization system
const syncManager = new StateSyncManager({
clientId: 'browser-tab-1',
conflictStrategy: 'last_write_wins',
throttleInterval: 100, // ms
maxRetries: 3,
});عندما تتغير الحالة في علامة التبويب 1:
// User creates a checkpoint
syncManager.notifyStateChange('checkpoint_created', threadId, {
checkpointId: 'chk_123',
step: 5,
timestamp: Date.now(),
});هذا يُنشئ StateChangeEvent (حدث تغيير الحالة):
interface StateChangeEvent {
type: StateChangeType;
threadId: string;
userId?: string;
timestamp: number;
payload: Record<string, unknown>;
version: VersionVector;
sourceClientId: string;
}كل تغيير يحتوي على version vector (متجه إصدار) لاكتشاف التعارضات:
interface VersionVector {
timestamp: number; // Logical time
sequence: number; // Monotonic counter
nodeId: string; // Client identifier
}مثال:
{
timestamp: 1709312400000,
sequence: 42,
nodeId: 'browser-tab-1'
}الخادم يتعامل مع النقل عبر WebSocket:
// Server-side WebSocket setup
io.on('connection', (socket) => {
const userId = socket.data.user.uid;
const clientId = socket.handshake.auth.clientId;
// Join user's room for targeted updates
socket.join(`user:${userId}`);
// Forward state changes to other tabs
socket.on('stateChange', (event) => {
socket.to(`user:${userId}`).emit('remoteChange', event);
});
});علامة التبويب 2 تستقبل التغيير:
syncManager.on('remoteChange', (event) => {
// Apply the change to local state
updateLocalState(event.type, event.payload);
// Update UI
refreshUI();
});إذا عدّلت كلتا علامتي التبويب في نفس الوقت:
// Tab 1 changes status at T1
syncManager.notifyStateChange('status_changed', threadId, {
status: 'approved'
});
// Tab 2 changes status at T2 (slightly later)
syncManager.notifyStateChange('status_changed', threadId, {
status: 'rejected'
});الاستراتيجيات:
| الاستراتيجية | كيف تعمل | الأفضل لـ |
|---|---|---|
| آخر كتابة تفوز | أحدث طابع زمني يفوز | معظم الحالات |
| الدمج | دمج التغييرات إن أمكن | التحرير التعاوني |
| يدوي | تنبيه المستخدم للحل | البيانات الحرجة |
const syncManager = new StateSyncManager({
conflictStrategy: 'last_write_wins',
});
// Handle conflicts
syncManager.on('conflictDetected', (conflicts, incoming) => {
// Show conflict resolution UI
showConflictDialog(conflicts);
});import { useEffect, useRef } from 'react';
import { io } from 'socket.io-client';
// Internal: getStateSyncManager() returns the singleton sync manager
export function useStateSync(threadId: string | null) {
const syncManagerRef = useRef(getStateSyncManager());
useEffect(() => {
if (!threadId) return;
// Connect to sync server
const socket = io('/state-sync', {
auth: {
token: getAuthToken(),
clientId: syncManagerRef.current.getConfig().clientId,
},
});
// Receive changes from other tabs
socket.on('remoteChange', (event) => {
syncManagerRef.current.receiveRemoteChange(event);
});
// Handle conflicts
syncManagerRef.current.on('conflictDetected', (conflicts) => {
console.warn('State conflict:', conflicts);
// Show UI for manual resolution
});
// Send local changes
syncManagerRef.current.on('syncRequired', (changes) => {
changes.forEach(change => {
socket.emit('stateChange', change);
});
});
return () => {
socket.disconnect();
};
}, [threadId]);
return syncManagerRef.current;
}function TaskBoard({ threadId }: { threadId: string }) {
const syncManager = useStateSync(threadId);
const [tasks, setTasks] = useState([]);
const moveTask = (taskId: string, newStatus: string) => {
// Update local state
setTasks(prev => prev.map(t =>
t.id === taskId ? { ...t, status: newStatus } : t
));
// Notify other tabs
syncManager.notifyStateChange('task_moved', threadId, {
taskId,
newStatus,
});
};
// Listen for remote changes
useEffect(() => {
const handleRemoteChange = (event: StateChangeEvent) => {
if (event.type === 'task_moved') {
setTasks(prev => prev.map(t =>
t.id === event.payload.taskId
? { ...t, status: event.payload.newStatus }
: t
));
}
};
syncManager.on('remoteChange', handleRemoteChange);
return () => {
syncManager.off('remoteChange', handleRemoteChange);
};
}, [syncManager]);
return (
<div>
{tasks.map(task => (
<TaskCard
key={task.id}
task={task}
onMove={moveTask}
/>
));
}
</div>
);
}Almadar يزامن أنواع الأحداث التالية:
type StateChangeType =
| 'checkpoint_created'
| 'checkpoint_updated'
| 'session_started'
| 'session_ended'
| 'tool_executed'
| 'memory_updated'
| 'interrupt_triggered'
| 'interrupt_resolved';كل نوع يُعيَّن لتحديث واجهة مستخدم محدد.
السيناريو: أنت تبرمج مع ذكاء اصطناعي عبر علامتي تبويب.
علامة التبويب 1: تشاهد الذكاء الاصطناعي يعمل علامة التبويب 2: تراجع التوثيق
بدون المزامنة:
مع مزامنة Almadar:
لا تزامن كل ضغطة مفتاح:
const syncManager = new StateSyncManager({
throttleInterval: 100, // Batch changes within 100ms
});للتحديثات عالية التردد:
// Internal: debounce utility for high-frequency sync events
const debouncedNotify = debounceSync(syncManager, 500);
// Called on every keystroke
debouncedNotify('document_edited', threadId, { content });
// Actually sends after 500ms of inactivityزامن فقط ما يهم:
// Sync this (important state)
syncManager.notifyStateChange('checkpoint_created', threadId, payload);
// Don't sync this (transient UI state)
// (just local React state)| الإجراء | علامة التبويب 1 | علامة التبويب 2 |
|---|---|---|
| البداية | تعرض المهمة أ | تعرض المهمة أ |
| تعديل في علامة التبويب 1 | المهمة أ مُحدّثة | المهمة أ (قديمة) |
| تعديل في علامة التبويب 2 | - | المهمة أ (تعارض!) |
| النتيجة | تعارض | تعارض |
| الإجراء | علامة التبويب 1 | علامة التبويب 2 |
|---|---|---|
| البداية | تعرض المهمة أ | تعرض المهمة أ |
| تعديل في علامة التبويب 1 | المهمة أ مُحدّثة | المهمة أ تتحدث تلقائيًا |
| تعديل في علامة التبويب 2 | تتحدث تلقائيًا | المهمة ب مُحدّثة |
| النتيجة | متزامنة | متزامنة |
حلّت مستندات Google هذه المشكلة للمستندات:
Almadar يجلب ذلك إلى أي حالة تطبيق:
مزامنة تعدد علامات التبويب صعبة. معظم التطبيقات تتجاهلها. المستخدمون يعانون.
الـ StateSyncManager في Almadar:
لأن مستخدميك لا ينبغي أن يفكروا في أي علامة تبويب هم فيها.
تعرف على المزيد حول مزامنة الحالة.
وكلاء ذكاء اصطناعي خاصّون على أجهزتك.