batch update

src/oj/composables/syncStatus.ts

@@ -1,4 +1,9 @@
-// 同步状态管理 composable
+import { ref, provide, inject } from "vue"
+
+/**
+ * 同步状态管理 composable
+ * 使用 provide/inject 模式在组件树中共享状态
+ */
 
 export interface SyncStatusState {
   otherUser?: { name: string; isSuperAdmin: boolean }
@@ -8,7 +13,10 @@ export interface SyncStatusState {
 // 提供/注入的 key
 export const SYNC_STATUS_KEY = Symbol("syncStatus")
 
-// 创建同步状态
+/**
+ * 创建同步状态实例
+ * 每次调用创建新的状态实例
+ */
 export function createSyncStatus() {
   const otherUser = ref<{ name: string; isSuperAdmin: boolean }>()
   const hadConnection = ref(false)
@@ -33,14 +41,20 @@ export function createSyncStatus() {
   }
 }
 
-// 提供同步状态
+/**
+ * 提供同步状态到子组件
+ * 在父组件中调用
+ */
 export function provideSyncStatus() {
   const syncStatus = createSyncStatus()
   provide(SYNC_STATUS_KEY, syncStatus)
   return syncStatus
 }
 
-// 注入同步状态
+/**
+ * 注入同步状态
+ * 在子组件中调用，获取父组件提供的状态
+ */
 export function injectSyncStatus() {
   const syncStatus =
     inject<ReturnType<typeof createSyncStatus>>(SYNC_STATUS_KEY)