@allbluecn/web-app 0.18.2 → 0.19.0

package/src/lib/collab/use-share-presence.ts

@@ -0,0 +1,561 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+// 分享页 presence join hook（§9 R4）——share:{shareToken} room 全部 view。
+//
+// 数据流（与 use-presence-report.ts 同构，分组维度换 kind 字段）：
+//   ① join：createSharePresenceTicketFn（密码保护的 share 从 sessionStorage
+//      现有 share_pwd_{designId}_{designver|'main'} key 读密码随请求带上——
+//      与 SharePasswordGate/design-share-client 写入侧逐字对齐；无密码不传）
+//   ② 身份：ticket 是唯一身份源（登录与否仅服务端可知）。客户端解码 JWT
+//      payload（不验签——connect 时服务端 verifyTicket 才是安全边界）取
+//      sub/name/kind/avatarBrief/room，room 名取自 ticket（零命名漂移）
+//   ③ 上报：awareness.setLocalState({ user, kind, ts })（§9 schema）+
+//      15s 心跳续报（同 use-presence-report：挂机不被 pruneStale 误摘）
+//   ④ 接收：awareness 'update' → 全量快照 → parseSharePresenceState
+//      校验（fail-closed）→ store；自身（clientID 命中）不排除——presence
+//      bar 要显示「我」并高亮
+//   ⑤ 清理：卸载 → setLocalState(null)（他人侧 removed）+ 定时器清理 +
+//      引用计数归零才 destroyProvider（share 页多组件共用一条连接，
+//      单例 join 状态机 + refCount；join 未完成即卸载由 cancelled 旗标
+//      承接，异步续段不再建连/建了即拆）
+//
+// 降级（§9 no-op 不报错）：协同不可用 / shareToken 未就绪 / ticket 签发
+// 被拒（含 room 上限 50 服务端拒签）→ 状态 offline、分组恒空、console.warn
+// 级别记录，绝不 throw。服务端连接计数上限本期 deferred（apps/collab 无
+// onConnect 先例），客户端 no-op 兜底对拒连场景已闭环。
+//
+// 访客身份持久化：昵称 + 自选颜色各一个 localStorage key（颜色首次从固定
+// 色板随机选一次后持久化，无编辑 UI——P5 增强），key 常量导出供测试对账。
+
+import { useEffect, useMemo } from 'react'
+import { Store } from '@tanstack/store'
+import { useStore } from '@tanstack/react-store'
+import { m } from '@/paraglide/messages.js'
+import { createSharePresenceTicketFn } from '@/server/serverFns/collab'
+import { destroyProvider, getOrCreateProvider } from './provider'
+import { isCollabEnabled } from './env'
+import type { CollabAwareness } from './provider'
+
+// ---------------------------------------------------------------------------
+// 常量与类型（§9 awareness state schema）
+// ---------------------------------------------------------------------------
+
+/** 心跳间隔（对齐 use-presence-report：15s，30s 摘除窗口内至少 1-2 次续报） */
+export const SHARE_PRESENCE_HEARTBEAT_MS = 15_000
+
+/** prune 兜底轮询间隔（awareness 协议内建超时 30s 的第二道防线） */
+const PRUNE_INTERVAL_MS = 30_000
+
+/** store 侧过期口径：对齐 awareness 协议内建超时 */
+const SHARE_PRESENCE_STALE_MS = 30_000
+
+/** 访客昵称持久化 key（localStorage；无编辑 UI，P5 增强） */
+export const GUEST_NICKNAME_STORAGE_KEY = 'share_guest_nickname'
+
+/** 访客自选颜色持久化 key（localStorage；首次从色板随机选一次） */
+export const GUEST_COLOR_STORAGE_KEY = 'share_guest_color'
+
+/**
+ * 访客头像色板（数据值而非主题色：同 UserAvatar bgColor 契约——存储的
+ * 就是任意 hex，渲染端原样上底色 + 白字，暗黑模式无需变量化）。
+ */
+export const GUEST_BG_COLORS: readonly string[] = [
+  '#7c6cf0',
+  '#e8734a',
+  '#2fa37c',
+  '#3b82d6',
+  '#c94f7c',
+  '#8a8f29',
+  '#b06fc9',
+  '#4a9fe8',
+]
+
+/** 分享页在场者（awareness client 粒度：同人双 tab 是两个 client） */
+export interface SharePresencePerson {
+  /** awareness clientID（React key + 「我」判定） */
+  clientId: number
+  /** member userId / guest:{uuid}（每次签发独立，§4.2） */
+  id: string
+  name: string
+  kind: 'member' | 'guest'
+  avatarConfig?: Record<string, number> | null
+  bgShape?: string | null
+  bgColor?: string | null
+  ts: number
+}
+
+export type SharePresenceStatus = 'connecting' | 'synced' | 'offline'
+
+interface SharePresenceStoreState {
+  status: SharePresenceStatus
+  /** 全部在场 client（含自身；分组由消费方按 kind 派生） */
+  people: ReadonlyMap<number, SharePresencePerson>
+  /** 自身 awareness clientID（「我」高亮；未加入为 null） */
+  selfClientId: number | null
+}
+
+const INITIAL_STATE: SharePresenceStoreState = {
+  status: 'offline',
+  people: new Map(),
+  selfClientId: null,
+}
+
+/** 全局单例（presence-store 同款 module-level store 惯例） */
+const sharePresenceStore = new Store<SharePresenceStoreState>(INITIAL_STATE)
+
+function setStatus(status: SharePresenceStatus): void {
+  sharePresenceStore.setState((prev) => {
+    if (prev.status === status) return prev
+    // offline 清空（§9 降级不显示）；connecting 保留等待快照重建
+    if (status === 'offline') {
+      return { ...prev, status, people: new Map() }
+    }
+    return { ...prev, status }
+  })
+}
+
+function syncPeople(states: readonly SharePresencePerson[]): void {
+  const byClient = new Map<number, SharePresencePerson>()
+  for (const person of states) byClient.set(person.clientId, person)
+  sharePresenceStore.setState((prev) => ({ ...prev, people: byClient }))
+}
+
+/** store 侧过期兜底：摘除 ts 早于窗口的条目（awareness 超时事件丢失时） */
+function pruneStale(): void {
+  const cutoff = Date.now() - SHARE_PRESENCE_STALE_MS
+  sharePresenceStore.setState((prev) => {
+    let changed = false
+    const people = new Map(prev.people)
+    for (const [clientId, person] of people) {
+      if (person.ts < cutoff) {
+        people.delete(clientId)
+        changed = true
+      }
+    }
+    return changed ? { ...prev, people } : prev
+  })
+}
+
+/** 测试隔离：清单例 + 恢复初始状态（不构成公开 API 契约） */
+export function __resetSharePresenceForTests(): void {
+  if (joinState) teardown()
+  sharePresenceStore.setState(() => ({
+    status: INITIAL_STATE.status,
+    people: new Map(INITIAL_STATE.people),
+    selfClientId: INITIAL_STATE.selfClientId,
+  }))
+}
+
+// ---------------------------------------------------------------------------
+// ticket 解码（身份源；connect 时服务端 verifyTicket 才是安全边界）
+// ---------------------------------------------------------------------------
+
+interface ShareTicketIdentity {
+  sub: string
+  name: string
+  room: string
+  kind: 'member' | 'guest'
+  avatarConfig: Record<string, number> | null
+  bgShape: string | null
+  bgColor: string | null
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === 'object' && value !== null
+}
+
+function isAvatarConfig(value: unknown): value is Record<string, number> {
+  return (
+    isRecord(value) && Object.values(value).every((v) => typeof v === 'number')
+  )
+}
+
+/** base64url → UTF-8 JSON（jsdom/浏览器 atob 均可用；仅客户端路径执行） */
+function decodeBase64UrlJson(segment: string): Record<string, unknown> | null {
+  try {
+    const b64 = segment.replace(/-/g, '+').replace(/_/g, '/')
+    const binary = atob(b64 + '='.repeat((4 - (b64.length % 4)) % 4))
+    const json = new TextDecoder().decode(
+      Uint8Array.from(binary, (ch) => ch.charCodeAt(0)),
+    )
+    const parsed: unknown = JSON.parse(json)
+    return isRecord(parsed) ? parsed : null
+  } catch {
+    return null
+  }
+}
+
+/**
+ * 解码 share presence ticket payload。字段缺失/kind 非法返回 null
+ * （fail-closed：身份不明不上报）。
+ */
+function decodeShareTicket(ticket: string): ShareTicketIdentity | null {
+  const payload = decodeBase64UrlJson(ticket.split('.')[1] ?? '')
+  if (!payload) return null
+  const { sub, name, room, kind, avatarBrief } = payload
+  if (typeof sub !== 'string' || sub.length === 0) return null
+  if (typeof name !== 'string') return null
+  if (typeof room !== 'string' || room.length === 0) return null
+  if (kind !== 'member' && kind !== 'guest') return null
+  let avatarConfig: Record<string, number> | null = null
+  let bgShape: string | null = null
+  let bgColor: string | null = null
+  if (isRecord(avatarBrief)) {
+    if (isAvatarConfig(avatarBrief.avatarConfig)) {
+      avatarConfig = avatarBrief.avatarConfig
+    }
+    if (typeof avatarBrief.bgShape === 'string' && avatarBrief.bgShape) {
+      bgShape = avatarBrief.bgShape
+    }
+    if (typeof avatarBrief.bgColor === 'string' && avatarBrief.bgColor) {
+      bgColor = avatarBrief.bgColor
+    }
+  }
+  return { sub, name, room, kind, avatarConfig, bgShape, bgColor }
+}
+
+// ---------------------------------------------------------------------------
+// 远端 state 校验（不可信，fail-closed——presence-store 同口径）
+// ---------------------------------------------------------------------------
+
+function parseSharePresenceState(
+  raw: unknown,
+  clientId: number,
+): SharePresencePerson | null {
+  if (!isRecord(raw)) return null
+  const user = raw.user
+  if (!isRecord(user)) return null
+  if (typeof user.id !== 'string' || user.id.length === 0) return null
+  if (typeof user.name !== 'string') return null
+  if (raw.kind !== 'member' && raw.kind !== 'guest') return null
+  if (typeof raw.ts !== 'number' || !Number.isFinite(raw.ts)) return null
+  const person: SharePresencePerson = {
+    clientId,
+    id: user.id,
+    name: user.name,
+    kind: raw.kind,
+    ts: raw.ts,
+  }
+  if (isAvatarConfig(user.avatarConfig)) {
+    person.avatarConfig = user.avatarConfig
+  }
+  if (typeof user.bgShape === 'string' && user.bgShape) person.bgShape = user.bgShape
+  if (typeof user.bgColor === 'string' && user.bgColor) person.bgColor = user.bgColor
+  return person
+}
+
+// ---------------------------------------------------------------------------
+// 访客身份（localStorage 持久化）
+// ---------------------------------------------------------------------------
+
+function readGuestNickname(): string {
+  try {
+    const stored = localStorage.getItem(GUEST_NICKNAME_STORAGE_KEY)?.trim()
+    return stored || m.presence_share_guestDefault()
+  } catch {
+    return m.presence_share_guestDefault()
+  }
+}
+
+function readGuestColor(): string {
+  const pick = () =>
+    GUEST_BG_COLORS[Math.floor(Math.random() * GUEST_BG_COLORS.length)]!
+  try {
+    const stored = localStorage.getItem(GUEST_COLOR_STORAGE_KEY)
+    if (stored && GUEST_BG_COLORS.includes(stored)) return stored
+    const picked = pick()
+    localStorage.setItem(GUEST_COLOR_STORAGE_KEY, picked)
+    return picked
+  } catch {
+    // localStorage 不可用（隐私模式等）：每次随机，不入库
+    return pick()
+  }
+}
+
+/**
+ * 密码保护的 share 从 sessionStorage 读密码（写入侧 SharePasswordGate：
+ * `share_pwd_${designId}_${designver || 'main'}`，与 design-share-client
+ * sessionKey 逐字对齐）。无 key（无密码 / 未过门禁）返回 undefined。
+ */
+function readSharePassword(
+  designId?: string,
+  designver?: string | null,
+): string | undefined {
+  if (!designId) return undefined
+  try {
+    return (
+      sessionStorage.getItem(`share_pwd_${designId}_${designver || 'main'}`) ??
+      undefined
+    )
+  } catch {
+    return undefined
+  }
+}
+
+// ---------------------------------------------------------------------------
+// 单例 join 状态机（share 页多组件共用一条连接；一次一个 share room）
+// ---------------------------------------------------------------------------
+
+interface JoinState {
+  shareToken: string
+  designId?: string
+  designver?: string | null
+  /** ticket 解码后回填（teardown 销毁 provider / awareness 用） */
+  roomName: string | null
+  refCount: number
+  /** join 未完成即卸载：异步续段不再建连，建了即拆 */
+  cancelled: boolean
+  wiring: AwarenessWiring | null
+}
+
+let joinState: JoinState | null = null
+
+interface AwarenessWiring {
+  awareness: CollabAwareness
+  onUpdate: () => void
+  heartbeatTimer: ReturnType<typeof setInterval> | null
+  pruneTimer: ReturnType<typeof setInterval> | null
+  unsubscribeStatus: () => void
+}
+
+function teardown(): void {
+  if (!joinState) return
+  const { roomName, wiring } = joinState
+  joinState.cancelled = true
+  joinState = null
+  if (wiring) {
+    wiring.awareness.off('update', wiring.onUpdate)
+    // 离场协议语义：置 null 使他人侧 awareness 触发 removed 摘除
+    wiring.awareness.setLocalState(null)
+    if (wiring.heartbeatTimer) clearInterval(wiring.heartbeatTimer)
+    if (wiring.pruneTimer) clearInterval(wiring.pruneTimer)
+    wiring.unsubscribeStatus()
+  }
+  if (roomName) destroyProvider(roomName)
+  setStatus('offline')
+}
+
+/** 组装 awareness local state 并上报（ts=「最后活跃」，心跳续报刷新） */
+function reportSelf(awareness: CollabAwareness, identity: ShareTicketIdentity): void {
+  awareness.setLocalState({
+    user: {
+      id: identity.sub,
+      name: identity.name,
+      avatarConfig: identity.avatarConfig,
+      bgShape: identity.bgShape ?? '',
+      bgColor: identity.bgColor ?? '',
+    },
+    kind: identity.kind,
+    ts: Date.now(),
+  })
+}
+
+/**
+ * 发起 share room join（ticket → 解码身份 → provider → awareness 接线）。
+ * 全链路失败 no-op 不报错（console.warn 级别，§9 降级为「不显示」）。
+ */
+function startJoin(state: JoinState): void {
+  void (async () => {
+    try {
+      const { ticket } = await createSharePresenceTicketFn({
+        data: {
+          shareToken: state.shareToken,
+          // member 身份由服务端 session 判定（nickname 仅 guest 生效）
+          nickname: readGuestNickname(),
+          ...(readSharePassword(state.designId, state.designver)
+            ? { password: readSharePassword(state.designId, state.designver) }
+            : {}),
+        },
+      })
+      if (state.cancelled) return
+
+      const identity = decodeShareTicket(ticket)
+      if (!identity) {
+        console.warn('[share-presence] ticket 解码失败，presence 降级不显示')
+        setStatus('offline')
+        return
+      }
+      state.roomName = identity.room
+
+      // 访客自选颜色：ticket avatarBrief 无色（空串）时用本地持久化色
+      if (!identity.bgColor) identity.bgColor = readGuestColor()
+
+      const provider = getOrCreateProvider(identity.room, {
+        // 重连重取（token 为 async 函数，每次 onOpen 重新执行）：昵称/密码
+        // 读最新值；服务端拒签走 provider 鉴权失败退避 → offline
+        getTicket: async () => {
+          const fresh = await createSharePresenceTicketFn({
+            data: {
+              shareToken: state.shareToken,
+              nickname: readGuestNickname(),
+              ...(readSharePassword(state.designId, state.designver)
+                ? {
+                    password: readSharePassword(
+                      state.designId,
+                      state.designver,
+                    ),
+                  }
+                : {}),
+            },
+          })
+          return fresh.ticket
+        },
+      })
+      if (state.cancelled) {
+        destroyProvider(identity.room)
+        return
+      }
+      const awareness = provider.awareness
+      if (!awareness) {
+        console.warn(
+          '[share-presence] 协同不可用（noop provider），presence 降级不显示',
+        )
+        setStatus('offline')
+        return
+      }
+
+      const wiring: AwarenessWiring = {
+        awareness,
+        onUpdate: () => {
+          const people: SharePresencePerson[] = []
+          for (const [clientId, raw] of awareness.getStates()) {
+            const parsed = parseSharePresenceState(raw, clientId)
+            if (parsed) people.push(parsed)
+          }
+          syncPeople(people)
+          pruneStale()
+        },
+        heartbeatTimer: null,
+        pruneTimer: null,
+        unsubscribeStatus: provider.onStatusChange((status) => {
+          setStatus(status)
+          // 重连恢复后重放本机身份（detach/attach 往返可能丢 local state）
+          if (status === 'synced') reportSelf(awareness, identity)
+        }),
+      }
+      state.wiring = wiring
+      awareness.on('update', wiring.onUpdate)
+      wiring.heartbeatTimer = setInterval(() => {
+        reportSelf(awareness, identity)
+      }, SHARE_PRESENCE_HEARTBEAT_MS)
+      wiring.pruneTimer = setInterval(() => {
+        pruneStale()
+      }, PRUNE_INTERVAL_MS)
+      // 引导完成即上报（进房互见不等下一次事件）
+      reportSelf(awareness, identity)
+      wiring.onUpdate()
+      sharePresenceStore.setState((prev) => ({
+        ...prev,
+        selfClientId: awareness.clientID,
+      }))
+    } catch (error: unknown) {
+      // §9 no-op：share 失效 / 密码门禁未过 / room 上限 50 服务端拒签等
+      // 全部静默降级为「不显示」，console.warn 留排查线索，绝不 throw
+      console.warn(
+        '[share-presence] presence 不可用（分享失效/密码未过/房间已满），降级不显示:',
+        error instanceof Error ? error.message : error,
+      )
+      setStatus('offline')
+    }
+  })()
+}
+
+// ---------------------------------------------------------------------------
+// hook
+// ---------------------------------------------------------------------------
+
+export interface UseSharePresenceOptions {
+  /** share token（路由数据未就绪传 null → no-op） */
+  shareToken: string | null | undefined
+  /** 密码 sessionStorage key 的 designId 段（version 分享路由可选） */
+  designId?: string
+  /** 密码 sessionStorage key 的 designver 段（与 SharePasswordGate 对齐） */
+  designver?: string | null
+}
+
+export interface SharePresenceGroups {
+  status: SharePresenceStatus
+  members: SharePresencePerson[]
+  guests: SharePresencePerson[]
+  /** 自身 awareness clientID（「我」高亮；未加入为 null） */
+  selfClientId: number | null
+}
+
+/**
+ * 分享页 presence join。share room 全部 view（§9）：成员/访客都只读，
+ * hook 全程只请求 share presence ticket，绝不触实体 ticket。
+ */
+export function useSharePresence(
+  options: UseSharePresenceOptions,
+): SharePresenceGroups {
+  const { shareToken, designId, designver } = options
+
+  useEffect(() => {
+    if (!isCollabEnabled() || !shareToken) return
+
+    // 单例 acquire：不同 share room（跨链接导航）先拆旧连接；同 room
+    // 复用进行中/已完成的 join（多组件同挂载只建一条连接）
+    if (joinState && joinState.shareToken !== shareToken) teardown()
+    if (!joinState) {
+      const state: JoinState = {
+        shareToken,
+        designId,
+        designver,
+        roomName: null,
+        refCount: 0,
+        cancelled: false,
+        wiring: null,
+      }
+      joinState = state
+      setStatus('connecting')
+      startJoin(state)
+    }
+    joinState.refCount += 1
+
+    return () => {
+      if (!joinState) return
+      joinState.refCount -= 1
+      if (joinState.refCount <= 0) teardown()
+    }
+  }, [shareToken, designId, designver])
+
+  const state = useStore(sharePresenceStore, (s) => s)
+
+  const { members, guests } = useMemo(() => {
+    const members: SharePresencePerson[] = []
+    const guests: SharePresencePerson[] = []
+    for (const person of state.people.values()) {
+      if (person.kind === 'member') members.push(person)
+      else guests.push(person)
+    }
+    // 展示序确定性：先来后到（ts 升序，同毫秒按 clientID）——awareness
+    // getStates 迭代序是 clientID 序但无业务语义，不做展示契约
+    const byJoin = (a: SharePresencePerson, b: SharePresencePerson) =>
+      a.ts - b.ts || a.clientId - b.clientId
+    members.sort(byJoin)
+    guests.sort(byJoin)
+    return { members, guests }
+  }, [state.people])
+
+  return {
+    status: state.status,
+    members,
+    guests,
+    selfClientId: state.selfClientId,
+  }
+}

package/src/lib/collab/user-color.ts

@@ -0,0 +1,40 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+
+// 协作用户光标颜色（规格 §6）：userId 哈希到固定 8 色板——
+// 同一用户在任何协作者视角下恒同色（确定性），且与 avatar bgColor 体系
+// 区分（光标/选中框/名牌直接上色，数据值 hex，暗黑模式无需变量化）。
+// 同构纯函数，客户端/服务端均可 import。
+
+/** 协作者光标固定 8 色板（色相错开，浅色底上可辨识） */
+export const COLLAB_USER_COLORS: readonly string[] = [
+  '#7c6cf0',
+  '#e8734a',
+  '#2fa37c',
+  '#3b82f6',
+  '#d64570',
+  '#0ea5e9',
+  '#a855f7',
+  '#c98a2d',
+] as const
+
+/** FNV-1a 32 位哈希（确定性、跨端一致，无碰撞聚集处理需求——仅取色） */
+function hashUserId(userId: string): number {
+  let hash = 0x811c9dc5
+  for (let i = 0; i < userId.length; i++) {
+    hash ^= userId.charCodeAt(i)
+    hash = Math.imul(hash, 0x01000193)
+  }
+  return hash >>> 0
+}
+
+/** userId → 固定色板色（确定性映射；空串安全，落在板内） */
+export function getUserColor(userId: string): string {
+  return COLLAB_USER_COLORS[hashUserId(userId) % COLLAB_USER_COLORS.length]!
+}

package/src/lib/collections/index.ts

@@ -15,7 +15,6 @@
 // You should have received a copy of the GNU Affero General Public License
 // along with this program. If not, see <https://www.gnu.org/licenses/>.
 
-export { getTagsCollection } from '@/components/tags/tags-collection'
 export { projectsCollection } from './reference/projects-collection'
 export { usersBriefCollection } from './reference/users-brief-collection'
 export { labelsCollection } from './reference/labels-collection'

package/src/lib/collections/reference/bookmark-categories-collection.ts

@@ -17,7 +17,7 @@
 
 import { createCollection } from '@tanstack/db'
 import { queryCollectionOptions } from '@tanstack/query-db-collection'
-import { listBookmarkCategoriesFn } from '@/server/serverFns/knowledge-public/bookmarks/categories'
+import { listBookmarkCategoriesFn } from '@/server/serverFns/knowledge/public/bookmarks/categories'
 import { getQueryClient } from '@/lib/query-client-seam'
 
 export const bookmarkCategoriesCollection = createCollection(

package/src/lib/commands/__tests__/registry.test.ts

@@ -28,11 +28,8 @@ const KNOWN_ROUTES = new Set([
   "/design",
   "/test-cases",
   "/bugs",
-  "/acceptance-criteria",
-  "/debrief",
   "/knowledge",
   "/apps/anyhub",
-  "/tags",
   "/workspaces",
   "/settings",
 ])
@@ -78,8 +75,8 @@ describe("COMMAND_REGISTRY", () => {
     expect(new Set(pairs).size).toBe(pairs.length)
   })
 
-  it("导航命令 16 条 + 操作命令 5 条", () => {
-    expect(COMMAND_REGISTRY.filter((c) => c.group === "navigation")).toHaveLength(16)
+  it("导航命令 13 条 + 操作命令 5 条", () => {
+    expect(COMMAND_REGISTRY.filter((c) => c.group === "navigation")).toHaveLength(13)
     expect(COMMAND_REGISTRY.filter((c) => c.group === "action")).toHaveLength(5)
   })
 })

package/src/lib/commands/registry.ts

@@ -29,11 +29,8 @@ export const COMMAND_REGISTRY: CommandDefinition[] = [
   { id: "goto-design", title: m.common_command_gotoDesign, icon: "penTool", group: "navigation", action: { kind: "navigate", to: "/design" }, keywords: ["设计", "design", "sj"], shortcut: ["G", "E"] },
   { id: "goto-test-cases", title: m.common_command_gotoTestCases, icon: "flaskConical", group: "navigation", action: { kind: "navigate", to: "/test-cases" }, keywords: ["测试用例", "test case", "csyl"], shortcut: ["G", "T"] },
   { id: "goto-bugs", title: m.common_command_gotoBugs, icon: "bug", group: "navigation", action: { kind: "navigate", to: "/bugs" }, keywords: ["缺陷", "漏洞", "bug", "qx"], shortcut: ["G", "B"] },
-  { id: "goto-acceptance", title: m.common_command_gotoAcceptance, icon: "circleCheckBig", group: "navigation", action: { kind: "navigate", to: "/acceptance-criteria" }, keywords: ["验收标准", "acceptance", "ysbz"], shortcut: ["G", "Q"] },
-  { id: "goto-debrief", title: m.common_command_gotoDebrief, icon: "speech", group: "navigation", action: { kind: "navigate", to: "/debrief" }, keywords: ["汇报", "总结", "debrief", "hb"], shortcut: ["G", "R"] },
   { id: "goto-knowledge", title: m.common_command_gotoKnowledge, icon: "database", group: "navigation", action: { kind: "navigate", to: "/knowledge" }, keywords: ["知识库", "knowledge", "ks"], shortcut: ["G", "K"] },
   { id: "goto-anyhub", title: m.common_command_gotoAnyhub, icon: "package", group: "navigation", action: { kind: "navigate", to: "/apps/anyhub" }, keywords: ["应用中心", "hub", "yyzx"], shortcut: ["G", "H"] },
-  { id: "goto-tags", title: m.common_command_gotoTags, icon: "cart", group: "navigation", action: { kind: "navigate", to: "/tags" }, keywords: ["标签", "tag", "bq"], shortcut: ["G", "L"] },
   { id: "goto-workspaces", title: m.common_command_gotoWorkspaces, icon: "building2", group: "navigation", action: { kind: "navigate", to: "/workspaces" }, keywords: ["工作空间", "workspace", "gzkj"], shortcut: ["G", "W"] },
   { id: "goto-settings", title: m.common_command_gotoSettings, icon: "settings", group: "navigation", action: { kind: "navigate", to: "/settings" }, keywords: ["设置", "settings", "sz"], shortcut: ["G", "M"] },
 

package/src/lib/commands/types.ts

@@ -28,7 +28,7 @@ export interface CommandDefinition {
   group: CommandGroup
   action: CommandAction
   keywords?: string[]
-  /** 序列键（如 ["G","D"]），注册为 useHotkeySequences */
+  /** 序列键（如 ["G","D"]），注册为 useHotkeys */
   shortcut?: string[]
   /** 组合键（如 ["Mod","Shift","L"]），仅用于面板展示 */
   chord?: string[]