dsh-manage-session 2.0.3 → 2.0.5

package/src/client/panel.tsx

@@ -1,131 +1,131 @@
-/**
- * 会话管理面板壳：一个侧边栏入口，两个页签（管理=主页面 / 体检=备用）。
- *
- * 2026-10-20 页面调整（用户定标）：「养老院」页签取消——管理台已覆盖其全部
- * 动作面（archive/unarchive/purge + 归档域筛选），独立页签属重复入口；
- * 历史文件组件（history-panel.tsx）随摘除，宿主侧 history 路由与配置字段
- * （historyFiles）保留不动，字典键留用以备回迁。
- *
- * 页签可见性由开关决定：`search=false` 时「管理」消失（退到体检），
- * `healthCheck=false` 时「体检」消失；两者都关时进入面板直接显示空壳提示
- * （客户端也会隐藏入口）。
- */
-import { createElement, useEffect, useState, type ReactElement } from 'react'
-import { createPortal } from 'react-dom'
-import { HealthPanel } from './health-panel.tsx'
-import { ManageConsole } from './manage.tsx'
-import { translate, type LocaleKey } from './locales.ts'
-
-/** 面板字典面。 */
-export type PanelTranslate = (key: LocaleKey, params?: Record<string, unknown>) => string
-
-/** 页签 id（导出供测试断言）。 */
-export const TAB_HEALTH = 'dms-tab-health'
-export const TAB_MANAGE = 'dms-tab-manage'
-
-/** 面板入参。 */
-export interface StewardPanelProps {
-  t?: PanelTranslate
-  /** 健康检查子域是否可见（关掉只剩管理页签）。 */
-  healthCheck: boolean
-  /** 打开会话（管理台行点击;apply 侧经 openSessionThrough 解析）。 */
-  openSession?: (sessionId: string) => void
-  onClose: () => void
-  /**
-   * 壳形态：`dialog`（缺省）= 背景遮罩上的浮动对话框（底栏入口用）；
-   * `page` = 填满主栏的整页（顶栏工具行入口用，无遮罩 / 无圆角阴影）。
-   */
-  variant?: 'dialog' | 'page'
-}
-
-/** 会话管理对话框 / 整页。 */
-export function StewardPanel({ t, healthCheck, openSession, onClose, variant = 'dialog' }: StewardPanelProps): ReactElement {
-  // 主页面=管理（会话管理台）；体检是备用页签。
-  const [tab, setTab] = useState<'health' | 'manage'>('manage')
-
-  // 开关变化后收敛到仍然可见的页签（体检关掉→回管理）。
-  useEffect(() => {
-    if (tab === 'health' && !healthCheck) setTab('manage')
-  }, [tab, healthCheck])
-
-  useEffect(() => {
-    const onKey = (event: KeyboardEvent): void => { if (event.key === 'Escape') onClose() }
-    document.addEventListener('keydown', onKey)
-    return () => { document.removeEventListener('keydown', onKey) }
-  }, [onClose])
-
-  const tabs: ReactElement[] = []
-  tabs.push(createElement('button', {
-    key: TAB_MANAGE,
-    id: TAB_MANAGE,
-    type: 'button',
-    className: `dms_tab${tab === 'manage' ? ' dms_tabActive' : ''}`,
-    'aria-selected': tab === 'manage',
-    onClick: () => { setTab('manage') },
-  }, translate(t, 'panel.tab.manage')))
-  if (healthCheck) {
-    tabs.push(createElement('button', {
-      key: TAB_HEALTH,
-      id: TAB_HEALTH,
-      type: 'button',
-      className: `dms_tab${tab === 'health' ? ' dms_tabActive' : ''}`,
-      'aria-selected': tab === 'health',
-      onClick: () => { setTab('health') },
-    }, translate(t, 'panel.tab.health')))
-  }
-
-  const body: ReactElement = tab === 'manage'
-    ? createElement('div', { style: { display: 'flex', flexDirection: 'column', flex: '1 1 auto', minHeight: 0 } },
-        createElement(ManageConsole, { open: openSession ?? (() => {}) }))
-    : createElement(HealthPanel, { t, onClose })
-
-  const panelEl = createElement('div', {
-    key: 'panel',
-    className: variant === 'page' ? 'dms_panel dms_panelPage' : 'dms_panel',
-    role: variant === 'page' ? 'region' : 'dialog',
-    'aria-label': translate(t, 'panel.title'),
-    style: { display: 'flex', flexDirection: 'column' },
-  }, [
-    createElement('div', { key: 'head', className: 'dms_dialogHead' }, [
-      createElement('span', { key: 'title', className: 'dms_dialogTitle' }, translate(t, 'panel.title')),
-      createElement('span', { key: 'tabs', className: 'dms_tabRow' }, tabs),
-      createElement('button', {
-        key: 'close',
-        type: 'button',
-        className: 'dms_actBtn',
-        onClick: onClose,
-      }, translate(t, 'panel.close')),
-    ]),
-    body,
-  ])
-
-  // 整页形态直接占用主栏（宿主已给页容器，不再叠遮罩 / 传送门）。
-  if (variant === 'page') return panelEl
-  return createPortal(createElement('div', { key: 'steward-root' }, [
-    createElement('div', { key: 'backdrop', className: 'dms_backdrop', onClick: onClose }),
-    panelEl,
-  ]), document.body)
-}
-
-/** 侧边栏脚部入口：宽栏带文案成行控件，收起轨道退化为 36x36 图标钮。 */
-export function StewardFooter(props: {
-  onClick?: () => void
-  title?: string
-  label?: string
-  wide?: boolean
-}): ReactElement {
-  const wide = props.wide === true
-  return createElement('button', {
-    type: 'button',
-    className: wide ? 'dms_footerEntry' : 'dms_footerEntry dms_footerEntryRail',
-    title: props.title,
-    'aria-label': props.title,
-    onClick: props.onClick,
-  }, [
-    createElement('span', { key: 'icon', className: 'dms_footerIcon', 'aria-hidden': true }, '🧭'),
-    // 收起轨道里 36px 装不下文案，标签与宽栏同条件出现，与搜索入口一致。
-    wide && props.label !== undefined
-      ? createElement('span', { key: 'label', className: 'dms_footerLabel' }, props.label)
-      : null,
-  ])
-}
+/**
+ * 会话管理面板壳：一个侧边栏入口，两个页签（管理=主页面 / 体检=备用）。
+ *
+ * 2026-10-20 页面调整（用户定标）：「养老院」页签取消——管理台已覆盖其全部
+ * 动作面（archive/unarchive/purge + 归档域筛选），独立页签属重复入口；
+ * 历史文件组件（history-panel.tsx）随摘除，宿主侧 history 路由与配置字段
+ * （historyFiles）保留不动，字典键留用以备回迁。
+ *
+ * 页签可见性由开关决定：`search=false` 时「管理」消失（退到体检），
+ * `healthCheck=false` 时「体检」消失；两者都关时进入面板直接显示空壳提示
+ * （客户端也会隐藏入口）。
+ */
+import { createElement, useEffect, useState, type ReactElement } from 'react'
+import { createPortal } from 'react-dom'
+import { HealthPanel } from './health-panel.tsx'
+import { ManageConsole } from './manage.tsx'
+import { translate, type LocaleKey } from './locales.ts'
+
+/** 面板字典面。 */
+export type PanelTranslate = (key: LocaleKey, params?: Record<string, unknown>) => string
+
+/** 页签 id（导出供测试断言）。 */
+export const TAB_HEALTH = 'dms-tab-health'
+export const TAB_MANAGE = 'dms-tab-manage'
+
+/** 面板入参。 */
+export interface StewardPanelProps {
+  t?: PanelTranslate
+  /** 健康检查子域是否可见（关掉只剩管理页签）。 */
+  healthCheck: boolean
+  /** 打开会话（管理台行点击;apply 侧经 openSessionThrough 解析）。 */
+  openSession?: (sessionId: string) => void
+  onClose: () => void
+  /**
+   * 壳形态：`dialog`（缺省）= 背景遮罩上的浮动对话框（底栏入口用）；
+   * `page` = 填满主栏的整页（顶栏工具行入口用，无遮罩 / 无圆角阴影）。
+   */
+  variant?: 'dialog' | 'page'
+}
+
+/** 会话管理对话框 / 整页。 */
+export function StewardPanel({ t, healthCheck, openSession, onClose, variant = 'dialog' }: StewardPanelProps): ReactElement {
+  // 主页面=管理（会话管理台）；体检是备用页签。
+  const [tab, setTab] = useState<'health' | 'manage'>('manage')
+
+  // 开关变化后收敛到仍然可见的页签（体检关掉→回管理）。
+  useEffect(() => {
+    if (tab === 'health' && !healthCheck) setTab('manage')
+  }, [tab, healthCheck])
+
+  useEffect(() => {
+    const onKey = (event: KeyboardEvent): void => { if (event.key === 'Escape') onClose() }
+    document.addEventListener('keydown', onKey)
+    return () => { document.removeEventListener('keydown', onKey) }
+  }, [onClose])
+
+  const tabs: ReactElement[] = []
+  tabs.push(createElement('button', {
+    key: TAB_MANAGE,
+    id: TAB_MANAGE,
+    type: 'button',
+    className: `dms_tab${tab === 'manage' ? ' dms_tabActive' : ''}`,
+    'aria-selected': tab === 'manage',
+    onClick: () => { setTab('manage') },
+  }, translate(t, 'panel.tab.manage')))
+  if (healthCheck) {
+    tabs.push(createElement('button', {
+      key: TAB_HEALTH,
+      id: TAB_HEALTH,
+      type: 'button',
+      className: `dms_tab${tab === 'health' ? ' dms_tabActive' : ''}`,
+      'aria-selected': tab === 'health',
+      onClick: () => { setTab('health') },
+    }, translate(t, 'panel.tab.health')))
+  }
+
+  const body: ReactElement = tab === 'manage'
+    ? createElement('div', { style: { display: 'flex', flexDirection: 'column', flex: '1 1 auto', minHeight: 0 } },
+        createElement(ManageConsole, { open: openSession ?? (() => {}) }))
+    : createElement(HealthPanel, { t, onClose })
+
+  const panelEl = createElement('div', {
+    key: 'panel',
+    className: variant === 'page' ? 'dms_panel dms_panelPage' : 'dms_panel',
+    role: variant === 'page' ? 'region' : 'dialog',
+    'aria-label': translate(t, 'panel.title'),
+    style: { display: 'flex', flexDirection: 'column' },
+  }, [
+    createElement('div', { key: 'head', className: 'dms_dialogHead' }, [
+      createElement('span', { key: 'title', className: 'dms_dialogTitle' }, translate(t, 'panel.title')),
+      createElement('span', { key: 'tabs', className: 'dms_tabRow' }, tabs),
+      createElement('button', {
+        key: 'close',
+        type: 'button',
+        className: 'dms_actBtn',
+        onClick: onClose,
+      }, translate(t, 'panel.close')),
+    ]),
+    body,
+  ])
+
+  // 整页形态直接占用主栏（宿主已给页容器，不再叠遮罩 / 传送门）。
+  if (variant === 'page') return panelEl
+  return createPortal(createElement('div', { key: 'steward-root' }, [
+    createElement('div', { key: 'backdrop', className: 'dms_backdrop', onClick: onClose }),
+    panelEl,
+  ]), document.body)
+}
+
+/** 侧边栏脚部入口：宽栏带文案成行控件，收起轨道退化为 36x36 图标钮。 */
+export function StewardFooter(props: {
+  onClick?: () => void
+  title?: string
+  label?: string
+  wide?: boolean
+}): ReactElement {
+  const wide = props.wide === true
+  return createElement('button', {
+    type: 'button',
+    className: wide ? 'dms_footerEntry' : 'dms_footerEntry dms_footerEntryRail',
+    title: props.title,
+    'aria-label': props.title,
+    onClick: props.onClick,
+  }, [
+    createElement('span', { key: 'icon', className: 'dms_footerIcon', 'aria-hidden': true }, '🧭'),
+    // 收起轨道里 36px 装不下文案，标签与宽栏同条件出现，与搜索入口一致。
+    wide && props.label !== undefined
+      ? createElement('span', { key: 'label', className: 'dms_footerLabel' }, props.label)
+      : null,
+  ])
+}

package/src/config.ts

@@ -1,43 +1,43 @@
-/**
- * dsh-manage-session 的共享配置面（会话管理器：归档 + 体检）。
- *
- * 与 host 半身（schemastery schema 在 src/index.ts）以及浏览器半身共用同一形状，
- * 使一处 admitted 的值在另一处也 admitted。
- *
- * 设置命名空间只有一个：`manage-session`（enabled/historyFiles/healthCheck/directDelete）。
- * 搜索/索引子域已拆回 dsh-search-index，本包不再持有 `search` 开关、索引目录、
- * 语料源（DRS）等字段——DRS 依赖也随搜索一起迁回那边。
- */
-
-/** 会话管理运行时配置（设置命名空间 + 组合入口）。 */
-export interface StewardConfig {
-  /** 插件总开关（关闭后不注册任何子域路由）。 */
-  enabled: boolean
-  /** 会话历史文件（归档浏览与清理）。关闭后不注册 history 路由。 */
-  historyFiles?: boolean
-  /** 会话健康检查（体检 → 处方 → 出院）。关闭后不注册 health 路由、不渲染「体检」页签。 */
-  healthCheck?: boolean
-  /**
-   * 直接删除入口（2026-10-20 用户定标）：开启后侧栏会话菜单出现「删除」行
-   * （两步确认，走管理端同款 session-history-purge 链路）。
-   * **缺省关**——破坏性入口不默认铺开；管理端批量删除不受本开关限制。
-   */
-  directDelete?: boolean
-}
-
-/** 缺省值。 */
-export const DEFAULT_CONFIG: Required<StewardConfig> = {
-  enabled: true,
-  historyFiles: true,
-  healthCheck: true,
-  directDelete: false,
-}
-
-/** host 半身注册的设置命名空间（与 src/index.ts 保持一致）。 */
-export const STEWARD_SETTINGS_NAMESPACE = 'manage-session'
-
-/** 侧边栏入口 id（客户端注册 id）。 */
-export const STEWARD_ENTRY_ID = 'dsh-manage-session'
-
-/** host 路由前缀（管理 + 体检，方法名一律 `session-*`）。 */
-export const STEWARD_API_PREFIX = '/manage-session/api'
+/**
+ * dsh-manage-session 的共享配置面（会话管理器：归档 + 体检）。
+ *
+ * 与 host 半身（schemastery schema 在 src/index.ts）以及浏览器半身共用同一形状，
+ * 使一处 admitted 的值在另一处也 admitted。
+ *
+ * 设置命名空间只有一个：`manage-session`（enabled/historyFiles/healthCheck/directDelete）。
+ * 搜索/索引子域已拆回 dsh-search-index，本包不再持有 `search` 开关、索引目录、
+ * 语料源（DRS）等字段——DRS 依赖也随搜索一起迁回那边。
+ */
+
+/** 会话管理运行时配置（设置命名空间 + 组合入口）。 */
+export interface StewardConfig {
+  /** 插件总开关（关闭后不注册任何子域路由）。 */
+  enabled: boolean
+  /** 会话历史文件（归档浏览与清理）。关闭后不注册 history 路由。 */
+  historyFiles?: boolean
+  /** 会话健康检查（体检 → 处方 → 出院）。关闭后不注册 health 路由、不渲染「体检」页签。 */
+  healthCheck?: boolean
+  /**
+   * 直接删除入口（2026-10-20 用户定标）：开启后侧栏会话菜单出现「删除」行
+   * （两步确认，走管理端同款 session-history-purge 链路）。
+   * **缺省关**——破坏性入口不默认铺开；管理端批量删除不受本开关限制。
+   */
+  directDelete?: boolean
+}
+
+/** 缺省值。 */
+export const DEFAULT_CONFIG: Required<StewardConfig> = {
+  enabled: true,
+  historyFiles: true,
+  healthCheck: true,
+  directDelete: false,
+}
+
+/** host 半身注册的设置命名空间（与 src/index.ts 保持一致）。 */
+export const STEWARD_SETTINGS_NAMESPACE = 'manage-session'
+
+/** 侧边栏入口 id（客户端注册 id）。 */
+export const STEWARD_ENTRY_ID = 'dsh-manage-session'
+
+/** host 路由前缀（管理 + 体检，方法名一律 `session-*`）。 */
+export const STEWARD_API_PREFIX = '/manage-session/api'

package/src/host/health/attribution.ts

@@ -1,118 +1,118 @@
-/**
- * 归属：把投影 key 指回产出它的插件包。
- *
- * 做法是静态扫描 profile 的 `node_modules`：`<pkg>/lib/index.js` 里
- * `sessionProjections.register({ key: 'xxx' })`（或其定义工厂）会命中
- * `key:\s*['"](\w+)['"]` 正则；据此建立 `投影 key → 包名` 索引。
- * `@deepseek-ai/*` 视为内置（core）；扫不到时如实返回 `unknown`，禁止臆测。
- */
-import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs'
-import { homedir } from 'node:os'
-import { join } from 'node:path'
-import type { GateAttribution } from './gates.ts'
-
-/** 一条归属记录。 */
-export interface ProjectionOwner {
-  key: string
-  /** 包名；内置包以 `@deepseek-ai/` 前缀判定。 */
-  package: string
-  /** 'core' 表示内置包，'plugin' 表示第三方插件。 */
-  kind: 'core' | 'plugin'
-  /** 命中文件（相对 node_modules）。 */
-  entry: string
-}
-
-/** 默认扫描根：profile 的 node_modules。 */
-export function defaultProfileNodeModules(dshHome?: string): string {
-  return join(dshHome ?? join(homedir(), '.dsh'), 'profiles', 'web', 'node_modules')
-}
-
-/** 收集候选包目录（含 @scope/pkg 一层）。 */
-function candidatePackages(root: string): { name: string; dir: string }[] {
-  const out: { name: string; dir: string }[] = []
-  if (!existsSync(root)) return out
-  for (const entry of readdirSync(root, { withFileTypes: true })) {
-    if (!entry.isDirectory() && !entry.isSymbolicLink()) continue
-    if (entry.name.startsWith('.')) continue
-    const dir = join(root, entry.name)
-    if (entry.name.startsWith('@')) {
-      let scoped: string[] = []
-      try {
-        scoped = readdirSync(dir)
-      } catch { continue }
-      for (const child of scoped) {
-        out.push({ name: `${entry.name}/${child}`, dir: join(dir, child) })
-      }
-      continue
-    }
-    out.push({ name: entry.name, dir })
-  }
-  return out
-}
-
-/** 单个入口文件的最大扫描字节数（超大 bundle 直接跳过，避免无谓内存与耗时）。 */
-const MAX_SCAN_BYTES = 12 << 20
-
-/** 扫描若干候选入口文件里出现的投影 key。 */
-function keysInFile(file: string): string[] {
-  if (!existsSync(file)) return []
-  let text: string
-  try {
-    if (statSync(file).size > MAX_SCAN_BYTES) return []
-    text = readFileSync(file, 'utf8')
-  } catch {
-    return []
-  }
-  const keys = new Set<string>()
-  const pattern = /key:\s*['"]([A-Za-z_$][\w$]*)['"]/g
-  let match: RegExpExecArray | null
-  while ((match = pattern.exec(text)) !== null) {
-    const key = match[1]
-    if (key !== undefined && key !== '') keys.add(key)
-  }
-  return [...keys]
-}
-
-/**
- * 建立投影 key → 包 的索引。
- * @param nodeModulesRoot - profile 的 node_modules 根。
- * @returns 归属记录（同一 key 多包命中时保留首个并排序稳定）。
- */
-export function buildProjectionOwnerIndex(nodeModulesRoot: string): ProjectionOwner[] {
-  const records: ProjectionOwner[] = []
-  const seen = new Set<string>()
-  for (const pack of candidatePackages(nodeModulesRoot)) {
-    const lib = join(pack.dir, 'lib')
-    let entries: string[] = []
-    try {
-      if (!statSync(lib).isDirectory()) continue
-      entries = readdirSync(lib).filter(name => name.endsWith('.js'))
-    } catch {
-      continue
-    }
-    for (const name of entries) {
-      const file = join(lib, name)
-      for (const key of keysInFile(file)) {
-        if (seen.has(key)) continue
-        seen.add(key)
-        records.push({
-          key,
-          package: pack.name,
-          kind: pack.name.startsWith('@deepseek-ai/') ? 'core' : 'plugin',
-          entry: `${pack.name}/lib/${name}`,
-        })
-      }
-    }
-  }
-  return records.sort((left, right) => left.key.localeCompare(right.key))
-}
-
-/** 索引查询器。 */
-export function createAttributor(index: readonly ProjectionOwner[]): (projection: string) => GateAttribution | undefined {
-  const byKey = new Map(index.map(record => [record.key, record]))
-  return (projection: string) => {
-    const owner = byKey.get(projection)
-    if (owner === undefined) return { projection, package: 'unknown' }
-    return { projection, package: owner.package }
-  }
-}
+/**
+ * 归属：把投影 key 指回产出它的插件包。
+ *
+ * 做法是静态扫描 profile 的 `node_modules`：`<pkg>/lib/index.js` 里
+ * `sessionProjections.register({ key: 'xxx' })`（或其定义工厂）会命中
+ * `key:\s*['"](\w+)['"]` 正则；据此建立 `投影 key → 包名` 索引。
+ * `@deepseek-ai/*` 视为内置（core）；扫不到时如实返回 `unknown`，禁止臆测。
+ */
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs'
+import { homedir } from 'node:os'
+import { join } from 'node:path'
+import type { GateAttribution } from './gates.ts'
+
+/** 一条归属记录。 */
+export interface ProjectionOwner {
+  key: string
+  /** 包名；内置包以 `@deepseek-ai/` 前缀判定。 */
+  package: string
+  /** 'core' 表示内置包，'plugin' 表示第三方插件。 */
+  kind: 'core' | 'plugin'
+  /** 命中文件（相对 node_modules）。 */
+  entry: string
+}
+
+/** 默认扫描根：profile 的 node_modules。 */
+export function defaultProfileNodeModules(dshHome?: string): string {
+  return join(dshHome ?? join(homedir(), '.dsh'), 'profiles', 'web', 'node_modules')
+}
+
+/** 收集候选包目录（含 @scope/pkg 一层）。 */
+function candidatePackages(root: string): { name: string; dir: string }[] {
+  const out: { name: string; dir: string }[] = []
+  if (!existsSync(root)) return out
+  for (const entry of readdirSync(root, { withFileTypes: true })) {
+    if (!entry.isDirectory() && !entry.isSymbolicLink()) continue
+    if (entry.name.startsWith('.')) continue
+    const dir = join(root, entry.name)
+    if (entry.name.startsWith('@')) {
+      let scoped: string[] = []
+      try {
+        scoped = readdirSync(dir)
+      } catch { continue }
+      for (const child of scoped) {
+        out.push({ name: `${entry.name}/${child}`, dir: join(dir, child) })
+      }
+      continue
+    }
+    out.push({ name: entry.name, dir })
+  }
+  return out
+}
+
+/** 单个入口文件的最大扫描字节数（超大 bundle 直接跳过，避免无谓内存与耗时）。 */
+const MAX_SCAN_BYTES = 12 << 20
+
+/** 扫描若干候选入口文件里出现的投影 key。 */
+function keysInFile(file: string): string[] {
+  if (!existsSync(file)) return []
+  let text: string
+  try {
+    if (statSync(file).size > MAX_SCAN_BYTES) return []
+    text = readFileSync(file, 'utf8')
+  } catch {
+    return []
+  }
+  const keys = new Set<string>()
+  const pattern = /key:\s*['"]([A-Za-z_$][\w$]*)['"]/g
+  let match: RegExpExecArray | null
+  while ((match = pattern.exec(text)) !== null) {
+    const key = match[1]
+    if (key !== undefined && key !== '') keys.add(key)
+  }
+  return [...keys]
+}
+
+/**
+ * 建立投影 key → 包 的索引。
+ * @param nodeModulesRoot - profile 的 node_modules 根。
+ * @returns 归属记录（同一 key 多包命中时保留首个并排序稳定）。
+ */
+export function buildProjectionOwnerIndex(nodeModulesRoot: string): ProjectionOwner[] {
+  const records: ProjectionOwner[] = []
+  const seen = new Set<string>()
+  for (const pack of candidatePackages(nodeModulesRoot)) {
+    const lib = join(pack.dir, 'lib')
+    let entries: string[] = []
+    try {
+      if (!statSync(lib).isDirectory()) continue
+      entries = readdirSync(lib).filter(name => name.endsWith('.js'))
+    } catch {
+      continue
+    }
+    for (const name of entries) {
+      const file = join(lib, name)
+      for (const key of keysInFile(file)) {
+        if (seen.has(key)) continue
+        seen.add(key)
+        records.push({
+          key,
+          package: pack.name,
+          kind: pack.name.startsWith('@deepseek-ai/') ? 'core' : 'plugin',
+          entry: `${pack.name}/lib/${name}`,
+        })
+      }
+    }
+  }
+  return records.sort((left, right) => left.key.localeCompare(right.key))
+}
+
+/** 索引查询器。 */
+export function createAttributor(index: readonly ProjectionOwner[]): (projection: string) => GateAttribution | undefined {
+  const byKey = new Map(index.map(record => [record.key, record]))
+  return (projection: string) => {
+    const owner = byKey.get(projection)
+    if (owner === undefined) return { projection, package: 'unknown' }
+    return { projection, package: owner.package }
+  }
+}