kongdeqiang
2026-10-12 285bf234bd50ce54fcae7bb777f8fa579b91266e
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
import { ref, watch } from 'vue'
 
/**
 * 折叠状态这类**纯视图偏好**的读写。
 *
 * 为什么不存到数据库:点一下折叠就发一个写请求,既没必要也容易失败
 * (网络抖一下折叠状态就和眼睛看到的不一致了)。这类状态属于「这台机器的
 * 这个浏览器窗口」,放 localStorage 正好,刷新后仍然保持。
 *
 * key 里会带上用户 id:同一台机器上换账号登录时,两个用户的分组折叠状态
 * 不该互相影响。
 */
 
const PREFIX = 'webui_ui_'
 
function storageKey(key) {
  // 从 localStorage 里已保存的用户信息取 id 做后缀。
  // 不 import authStore:那会形成 utils → store 的反向依赖,
  // 而这里只需要一个稳定的标识符。
  let who = 'anon'
  try {
    const raw = localStorage.getItem('webui_user')
    if (raw) {
      const user = JSON.parse(raw)
      who = user?.id ?? user?.username ?? 'anon'
    }
  } catch {
    // 解析失败就用 anon,不影响功能
  }
  return `${PREFIX}${who}_${key}`
}
 
/**
 * 一个会持久化到 localStorage 的布尔开关。
 *
 * @param {string} key 状态名(会自动加上用户前缀)
 * @param {boolean} defaultValue 没有存过时的默认值
 * @returns {{ collapsed: import('vue').Ref<boolean>, toggle: Function, set: Function }}
 */
export function usePersistentFlag(key, defaultValue = false) {
  const storage = storageKey(key)
  let initial = defaultValue
  try {
    const raw = localStorage.getItem(storage)
    if (raw === '1') initial = true
    else if (raw === '0') initial = false
  } catch {
    // 隐私模式下 localStorage 可能不可用,退回默认值即可
  }
 
  const state = ref(initial)
  watch(state, (value) => {
    try {
      localStorage.setItem(storage, value ? '1' : '0')
    } catch {
      // 存不进去不影响使用,只是刷新后不记得
    }
  })
 
  return {
    // 字段名就叫 collapsed:之前这里叫 value,调用方按 `{ collapsed }` 解构,
    // 拿到的是 undefined,导致「折叠了但界面没反应」——
    // 名字必须和它的语义一致,别让人猜。
    collapsed: state,
    toggle: () => { state.value = !state.value },
    set: (v) => { state.value = !!v }
  }
}
 
/**
 * 一组「分组各自的折叠状态」,同样持久化。
 *
 * 存的是一张 map:{ [groupId]: true/false },
 * 默认展开 —— 收藏起来的对话列表默认收起会让人以为分组是空的。
 */
export function usePersistentMap(key) {
  const storage = storageKey(key)
  let initial = {}
  try {
    const raw = localStorage.getItem(storage)
    if (raw) initial = JSON.parse(raw) || {}
  } catch {
    initial = {}
  }
 
  const state = ref(initial)
  watch(state, (value) => {
    try {
      localStorage.setItem(storage, JSON.stringify(value))
    } catch {
      // 同上,静默忽略
    }
  }, { deep: true })
 
  return {
    /**
     * 默认**展开**:只有显式存过 true 才算收起。
     *
     * 这里踩过一次自己的坑:一开始把「收起」定义为存 false,
     * 而 toggle 写成 `!(next[id] === false)` —— 缺省值 undefined 会让它算出 true,
     * 也就是「第一次点击反而写入了展开状态」,结果折叠永远不生效。
     * 判定与写入必须严格互逆:存 true = 收起,缺省 = 展开。
     */
    isCollapsed: (id) => state.value[id] === true,
    toggle(id) {
      const next = { ...state.value }
      next[id] = !(next[id] === true)
      state.value = next
    }
  }
}