dsh-mega-chat-nav 0.1.1

package/src/search.ts

@@ -0,0 +1,291 @@
+// host 半：全量搜索 lite 路由（读持久化日志，三级快路径 + LRU；不触客户端扩窗）
+import type { Context } from '@deepseek-ai/cordis'
+
+export interface SearchHit {
+  key: string
+  seq: number
+  time: number
+  role: string
+  /** 命中消息所在轮次（turn/start 计数；未定位为 0） */
+  turn: number
+  /** 命中是否来自更早历史（非当前已加载窗口） */
+  historic: boolean
+  snippet: string
+  hitStart: number
+  hitLen: number
+}
+
+interface EventLike {
+  type?: string
+  seq?: number
+  time?: number
+  data?: { id?: string; content?: unknown; message?: { id?: string; content?: unknown }; source?: { kind?: string } }
+}
+
+function eventText(ev: EventLike): string {
+  if (ev.type === 'tool/call') {
+    // 工具调用：name + 参数 JSON 前段（可被搜索命中）
+    const d = ev.data as { name?: unknown; arguments?: unknown } | undefined
+    const name = typeof d?.name === 'string' ? d.name : ''
+    const args = typeof d?.arguments === 'string' ? d.arguments : ''
+    return name.length === 0 && args.length === 0 ? '' : name + ' ' + args.slice(0, 200)
+  }
+  if (ev.type !== 'user/message' && ev.type !== 'assistant/message') return ''
+  const msg = ev.type === 'user/message' ? ev.data : ev.data?.message
+  const content = msg?.content
+  if (typeof content === 'string') return content
+  if (Array.isArray(content)) {
+    const parts: string[] = []
+    for (const b of content) {
+      if (b && typeof b === 'object' && (b as { type?: string }).type === 'text') {
+        const txt = (b as { text?: unknown }).text
+        if (typeof txt === 'string') parts.push(txt)
+      }
+    }
+    return parts.join(' ')
+  }
+  return ''
+}
+
+function roleOf(ev: EventLike): string {
+  if (ev.type === 'user/message') {
+    const kind = ev.data?.source?.kind
+    return kind === 'steering' ? 'steering' : 'user'
+  }
+  if (ev.type === 'tool/call') return 'tool'
+  return 'assistant'
+}
+
+function keyOf(ev: EventLike): string {
+  const id = ev.type === 'user/message' ? ev.data?.id : ev.data?.message?.id
+  return typeof id === 'string' && id.length > 0 ? id : 'seq:' + (ev.seq ?? 0)
+}
+
+function snippetAround(text: string, q: string, radius = 40): { snippet: string; hitStart: number; hitLen: number } | null {
+  const idx = text.toLowerCase().indexOf(q.toLowerCase())
+  if (idx < 0) return null
+  const start = Math.max(0, idx - radius)
+  const end = Math.min(text.length, idx + q.length + radius)
+  const pre = start > 0 ? '…' : ''
+  const post = end < text.length ? '…' : ''
+  return { snippet: pre + text.slice(start, end) + post, hitStart: idx - start + (start > 0 ? 1 : 0), hitLen: q.length }
+}
+
+function makeLru<T>(capacity = 32) {
+  const map = new Map<string, T>()
+  return {
+    get(k: string): T | undefined {
+      const v = map.get(k)
+      if (v !== undefined) { map.delete(k); map.set(k, v) }
+      return v
+    },
+    set(k: string, v: T): void {
+      map.delete(k); map.set(k, v)
+      if (map.size > capacity) {
+        const first = map.keys().next().value
+        if (first !== undefined) map.delete(first)
+      }
+    },
+  }
+}
+
+const searchCache = makeLru<{ hits: SearchHit[]; truncated: boolean }>()
+
+/** 访问可选服务：未注入的 cordis 服务在属性读取时抛错，捕获后按缺失处理 */
+function tryGet<T>(getter: () => T): T | undefined {
+  try { return getter() } catch { return undefined }
+}
+
+function readBody(req: unknown): Promise<string> {
+  return new Promise((resolve, reject) => {
+    const r = req as { on?(ev: 'data' | 'end' | 'error', cb: (chunk?: unknown) => void): void }
+    const chunks: Buffer[] = []
+    r.on?.('data', (chunk) => {
+      if (typeof chunk === 'string') chunks.push(Buffer.from(chunk))
+      else if (chunk instanceof Uint8Array) chunks.push(Buffer.from(chunk))
+    })
+    r.on?.('end', () => resolve(Buffer.concat(chunks).toString('utf8')))
+    r.on?.('error', reject)
+  })
+}
+
+interface SessionsLike { get(id: string): { events?: readonly unknown[] } | undefined }
+interface PersistenceLike { readRaw(id: string): unknown }
+interface QueryLike { readSession(id: string): { events?: readonly unknown[] } }
+
+/** 事件 + 来源标注 */
+interface SourcedEvent {
+  ev: EventLike
+  /** 来自更早历史（持久化日志 / sessionQuery），而非当前已加载窗口 */
+  historic: boolean
+}
+
+/**
+ * 读取会话事件：合并「已加载窗口」（live）与「更早历史」（持久化日志 →
+ * sessionQuery 兜底），按 seq 去重（历史中与 live 重复的丢弃），整体按 seq 排序。
+ */
+function readEventSources(
+  sessionId: string,
+  sessions: SessionsLike | undefined,
+  persistence: PersistenceLike | undefined,
+  query: QueryLike | undefined,
+): SourcedEvent[] {
+  const live = (sessions?.get(sessionId)?.events ?? []) as unknown as EventLike[]
+  const liveSeqs = new Set<number>()
+  for (const ev of live) {
+    if (typeof ev?.seq === 'number') liveSeqs.add(ev.seq)
+  }
+  let historic: readonly EventLike[] = []
+  try {
+    const raw = persistence?.readRaw(sessionId)
+    if (Array.isArray(raw)) historic = raw as unknown as EventLike[]
+  } catch { /* 下一级 */ }
+  if (historic.length === 0) {
+    const q = query?.readSession(sessionId)
+    if (q && Array.isArray(q.events)) historic = q.events as unknown as EventLike[]
+  }
+  const out: SourcedEvent[] = live.map((ev) => ({ ev, historic: false }))
+  for (const ev of historic) {
+    if (typeof ev?.seq === 'number' && liveSeqs.has(ev.seq)) continue
+    out.push({ ev, historic: true })
+  }
+  return out.sort((a, b) => (a.ev.seq ?? 0) - (b.ev.seq ?? 0))
+}
+
+/**
+ * 命中锚点：直接按消息 kind 拼出完整 DOM 锚点 key（对齐 conversationContextKey 公式）：
+ *   - 用户/steering 消息 → '13:input-message' + id
+ *   - assistant 消息 → '14:assistant-step' + turn + ':' + step（assistant-step 定义见
+ *     dsh-client-ui-conversation；id 为 turn:step 组合）
+ * AI 命中的方向判定 seq 取所属轮用户消息序号（AI 行紧跟其用户提问，位置近似）。
+ */
+/** 事件 → 搜索内容范围 */
+function scopeOf(ev: EventLike): 'user' | 'assistant' | 'tool' {
+  if (ev.type === 'tool/call') return 'tool'
+  if (ev.type === 'assistant/message') return 'assistant'
+  return 'user'
+}
+
+export function searchEvents(events: readonly SourcedEvent[], q: string, limit: number, scopes: readonly string[] = ['user', 'assistant', 'tool']): { hits: SearchHit[]; truncated: boolean } {
+  const hits: SearchHit[] = []
+  const needle = q.toLowerCase()
+  let turn = 0
+  let lastUserSeq = 0
+  for (const { ev, historic } of events) {
+    if (ev.type === 'turn/start') {
+      const t = (ev as { data?: { turn?: unknown } }).data?.turn
+      if (typeof t === 'number') turn = t
+      continue
+    }
+    if (ev.type === 'user/message') lastUserSeq = ev.seq ?? 0
+    const text = eventText(ev)
+    if (!text || !text.toLowerCase().includes(needle)) continue
+    if (!scopes.includes(scopeOf(ev))) continue
+    const role = roleOf(ev)
+    const isAssistant = role === 'assistant'
+    const isTool = ev.type === 'tool/call'
+    const anchorKey = isTool
+      ? '9:tool-call' + String((ev as { data?: { callId?: unknown } }).data?.callId ?? '')
+      : isAssistant
+        ? '14:assistant-step' + turn + ':' + (ev as { data?: { step?: unknown } }).data?.step
+        : '13:input-message' + keyOf(ev)
+    const anchorSeq = isAssistant || isTool ? lastUserSeq : ev.seq ?? 0
+    const snip = snippetAround(text, q)
+    hits.push({
+      key: anchorKey,
+      seq: anchorSeq,
+      time: ev.time ?? 0,
+      role,
+      turn,
+      historic,
+      snippet: snip ? snip.snippet : text.slice(0, 60),
+      hitStart: snip ? snip.hitStart : -1,
+      hitLen: snip ? snip.hitLen : 0,
+    })
+    if (limit > 0 && hits.length >= limit) break
+  }
+  return { hits, truncated: limit > 0 && hits.length >= limit }
+}
+
+export function registerSearchRoute(ctx: Context): void {
+  ctx.inject(['webServer', 'sessions'], (scoped) => {
+    const webServer = (scoped as unknown as {
+      webServer?: { register(opts: { kind: 'prefix'; path: string; handler(req: unknown, res: unknown): Promise<void> | void }): unknown }
+    }).webServer
+    const sessions = (scoped as unknown as { sessions?: SessionsLike }).sessions
+    if (!webServer || !sessions) return
+    ctx.inject(['settings'], (settingsCtx) => {
+      const settingsService = (settingsCtx as unknown as {
+        settings?: { update(ns: string, patch: object, expectedRevision?: number): Promise<void> }
+      }).settings
+      if (!settingsService) return
+      ctx.effect(() => {
+        const dispose = webServer.register({
+          kind: 'prefix',
+          path: '/mega-chat-nav',
+          handler: async (req, res) => {
+            const httpRes = res as { statusCode?: number; setHeader?(k: string, v: string): void; end(s: string): void }
+            const httpReq = req as { url?: string; method?: string }
+            const write = (code: number, body: unknown) => {
+              httpRes.statusCode = code
+              httpRes.setHeader?.('Content-Type', 'application/json; charset=utf-8')
+              httpRes.end(JSON.stringify(body))
+            }
+            try {
+              const url = new URL(httpReq.url ?? '/', 'http://localhost')
+              // 嵌套配置写回：scope.set 仅支持 section 内标量，嵌套 section 必须走 host 桥
+              if (url.pathname === '/mega-chat-nav/settings') {
+                if ((httpReq.method ?? 'GET') !== 'POST') { write(405, { ok: false, error: 'POST required' }); return }
+                const raw = await readBody(req)
+                let patch: unknown
+                let revision: unknown
+                try {
+                  const body = JSON.parse(raw) as { patch?: unknown; revision?: unknown }
+                  patch = body.patch
+                  revision = body.revision
+                } catch {
+                  write(400, { ok: false, error: 'bad json' }); return
+                }
+                if (typeof patch !== 'object' || patch === null || Array.isArray(patch)) {
+                  write(400, { ok: false, error: 'patch must be an object' }); return
+                }
+                try {
+                  await settingsService.update('mega-chat-nav', patch, typeof revision === 'number' ? revision : undefined)
+                } catch (e) {
+                  write(409, { ok: false, error: 'settings conflict: ' + String(e) }); return
+                }
+                write(200, { ok: true })
+                return
+              }
+              if (url.pathname !== '/mega-chat-nav/search') { write(404, { ok: false, error: 'not found' }); return }
+              const sessionId = url.searchParams.get('session') ?? ''
+              const q = (url.searchParams.get('q') ?? '').trim()
+              // limit<=0（含未传）→ 不限条数，返回全部命中
+              const rawLimit = url.searchParams.get('limit')
+              const limit = rawLimit === null || rawLimit === ''
+                ? 0
+                : Math.max(0, Math.min(Number(rawLimit) || 0, 500))
+              if (!sessionId || q.length < 1) { write(400, { ok: false, error: 'session & q required' }); return }
+            // 搜索内容范围（多选）；缺省全选；user 必选强制保留
+            const rawScopes = (url.searchParams.get('scopes') ?? '').split(',').map((s) => s.trim()).filter(Boolean)
+            const scopes = rawScopes.length > 0
+              ? [...new Set(['user', ...rawScopes])].filter((s) => s === 'user' || s === 'assistant' || s === 'tool')
+              : ['user', 'assistant', 'tool']
+            const cacheKey = sessionId + '|' + q + '|' + limit
+            const cached = searchCache.get(cacheKey)
+            if (cached) { write(200, { ok: true, ...cached }); return }
+            const persistence = tryGet(() => (scoped as unknown as { sessionPersistence?: PersistenceLike }).sessionPersistence)
+            const query = tryGet(() => (scoped as unknown as { sessionQuery?: QueryLike }).sessionQuery)
+            const result = searchEvents(readEventSources(sessionId, sessions, persistence, query), q, limit, scopes)
+            searchCache.set(cacheKey, result)
+            write(200, { ok: true, ...result })
+          } catch (e) {
+            write(500, { ok: false, error: String(e) })
+          }
+        },
+      })
+      return dispose as unknown as () => void
+      })
+    })
+  })
+}

package/src/settings.ts

@@ -0,0 +1,169 @@
+/**
+ * Host-side durable settings for the mega-chat-nav plugin.
+ * 配置选项为本插件自有定义：host 半持有此处；client 半在
+ * src/client/settings.ts 持有同值副本（client bundle 不得依赖宿主包）。
+ *
+ * @module dsh-mega-chat-nav/settings
+ */
+
+import z from '@deepseek-ai/schemastery'
+import type { SettingsNamespace } from '@deepseek-ai/dsh-settings'
+
+/** 风格选项：简约 / codex（时间线刻度）/ deepseek（用户消息面板，常态短横折叠） */
+export const STYLE_OPTIONS = ['minimal', 'codex', 'deepseek'] as const
+export type NavStyle = typeof STYLE_OPTIONS[number]
+
+/** 停靠侧选项 */
+export const ALIGN_OPTIONS = ['left', 'right'] as const
+export type RailAlign = typeof ALIGN_OPTIONS[number]
+
+/** 节点栏条带高度档位 */
+export const BAND_OPTIONS = ['compact', 'standard', 'tall'] as const
+export type BandHeight = typeof BAND_OPTIONS[number]
+
+/** 跳转动画方式 */
+export const SCROLL_OPTIONS = ['smooth', 'instant'] as const
+export type ScrollMode = typeof SCROLL_OPTIONS[number]
+
+/** 显示策略：常显 / 悬停浮现 / 隐藏 */
+export const SHOW_OPTIONS = ['show', 'peek', 'hide'] as const
+export type ShowMode = typeof SHOW_OPTIONS[number]
+
+/** 翻页标记默认显示模式（按风格独立）：minimal 常显（历史行为）/ codex 隐藏 */
+export const DEFAULT_PAGING: Record<NavStyle, ShowMode> = {
+  minimal: 'show',
+  codex: 'hide',
+  deepseek: 'peek',
+}
+
+/** 搜索内容范围（多选；用户必选） */
+export const SEARCH_SCOPE_OPTIONS = ['user', 'assistant', 'tool'] as const
+export type SearchScope = typeof SEARCH_SCOPE_OPTIONS[number]
+export const DEFAULT_SEARCH_SCOPES: SearchScope[] = ['user', 'assistant', 'tool']
+
+/** 悬停卡片数量 */
+export const CARD_OPTIONS = [1, 3, 5] as const
+export type CardCount = typeof CARD_OPTIONS[number]
+
+/** 悬浮卡默认数量（按风格独立）：minimal 3 张 / codex 1 张 / deepseek 1 张（无悬浮卡能力，占位） */
+export const DEFAULT_CARD_COUNT: Record<NavStyle, CardCount> = {
+  minimal: 3,
+  codex: 1,
+  deepseek: 1,
+}
+
+/** 悬浮卡内容块（多选） */
+export const CARD_ITEM_OPTIONS = ['turn', 'duration', 'favorite'] as const
+export type CardItem = typeof CARD_ITEM_OPTIONS[number]
+export const DEFAULT_CARD_ITEMS: CardItem[] = ['turn', 'duration', 'favorite']
+
+/** 刻度色调：柔和（低对比）/ 深邃（高对比、清晰） */
+export const MARK_TONE_OPTIONS = ['soft', 'deep'] as const
+export type MarkTone = typeof MARK_TONE_OPTIONS[number]
+export const DEFAULT_MARK_TONE: MarkTone = 'deep'
+
+export const DEFAULT_STYLE: NavStyle = 'minimal'
+export const DEFAULT_ALIGN: RailAlign = 'left'
+export const DEFAULT_BAND: BandHeight = 'standard'
+export const DEFAULT_SCROLL: ScrollMode = 'smooth'
+export const DEFAULT_SHOW: ShowMode = 'show'
+
+/** 通用配置（全局，跨风格生效） */
+export interface NavGeneralSettings {
+  /** 当前风格 */
+  style: NavStyle
+  /** 导航条停靠侧 */
+  align: RailAlign
+  /** 跳转动画方式 */
+  scrollBehavior: ScrollMode
+  /** 轮次总数徽标显示模式（兼容旧布尔：true→show / false→hide） */
+  showCount: ShowMode | boolean
+  /** 搜索按钮显示模式（兼容旧布尔） */
+  showSearch: ShowMode | boolean
+  /** 设置按钮显示模式（兼容旧布尔） */
+  showQuickSettings: ShowMode | boolean
+  /** 收藏按钮显示模式（兼容旧布尔） */
+  showFavorites: ShowMode | boolean
+  /** 搜索内容范围（多选；用户必选，其余可关） */
+  searchScopes: SearchScope[]
+  /** 导航栏与对话列边缘的偏移距离（px，0-32，随左右对齐自适应） */
+  railOffset: number
+  /** @deprecated 旧版字段（翻页标记曾置于此处）——仅兼容存量配置，新主源在 styles.<style>.showPaging */
+  showPaging?: ShowMode | boolean
+}
+
+/** 单风格配置（每风格独立一套） */
+export interface StyleSettings {
+  /** 节点栏条带高度档位 */
+  bandHeight: BandHeight
+  /** 悬停卡片数量（1/3/5） */
+  cardCount: CardCount
+  /** 悬浮卡内容块（多选：轮次 / 用时 / 收藏） */
+  cardItems: CardItem[]
+  /** 刻度色调（codex 刻度轨使用：柔和 / 深邃） */
+  markTone: MarkTone
+  /** 翻页标记显示模式：show=常显 / peek=浮现 / hide=隐藏 */
+  showPaging: ShowMode
+}
+
+/** 风格专属配置（styles.<style> 每风格独立） */
+export interface NavStyleSettings {
+  minimal: StyleSettings
+  codex: StyleSettings
+  deepseek: StyleSettings
+}
+
+/** 持久化设置文档结构 */
+export interface NavSettings {
+  general: NavGeneralSettings
+  styles: NavStyleSettings
+}
+
+// 显示模式兼容旧布尔（true → show / false → hide）：旧 user 段里的布尔值
+// 不能导致 register 的 schema 校验失败，否则 namespace 注册失败、设置无法持久化
+const ShowModeSchema = z.union([z.boolean(), ...SHOW_OPTIONS]).default(DEFAULT_SHOW)
+
+const GeneralSchema = z.object({
+  style: z.union([...STYLE_OPTIONS]).default(DEFAULT_STYLE),
+  align: z.union([...ALIGN_OPTIONS]).default(DEFAULT_ALIGN),
+  scrollBehavior: z.union([...SCROLL_OPTIONS]).default(DEFAULT_SCROLL),
+  showCount: ShowModeSchema,
+  showSearch: ShowModeSchema,
+  showQuickSettings: ShowModeSchema,
+  showFavorites: ShowModeSchema,
+  /* 旧版 general.showPaging 残留兼容（0.9.x 曾置于此处）；新主源已迁移 styles.<style> */
+  showPaging: ShowModeSchema,
+  searchScopes: z.array(z.union([...SEARCH_SCOPE_OPTIONS])).default([...DEFAULT_SEARCH_SCOPES]),
+  railOffset: z.natural().max(32).default(8),
+})
+
+/** 风格公共字段（两风格默认一致的配置） */
+const StyleFields = {
+  bandHeight: z.union([...BAND_OPTIONS]).default(DEFAULT_BAND),
+  cardItems: z.array(z.union([...CARD_ITEM_OPTIONS])).default([...DEFAULT_CARD_ITEMS]),
+  markTone: z.union([...MARK_TONE_OPTIONS]).default(DEFAULT_MARK_TONE),
+}
+
+/** 每风格独立默认字段：悬浮卡数与翻页标记（minimal 常显 / codex 隐藏 / deepseek 浮现） */
+const StyleDefaults: Record<NavStyle, { cardCount: CardCount; showPaging: ShowMode }> = {
+  minimal: { cardCount: DEFAULT_CARD_COUNT.minimal, showPaging: DEFAULT_PAGING.minimal },
+  codex: { cardCount: DEFAULT_CARD_COUNT.codex, showPaging: DEFAULT_PAGING.codex },
+  deepseek: { cardCount: DEFAULT_CARD_COUNT.deepseek, showPaging: DEFAULT_PAGING.deepseek },
+}
+const styleSchemaFields = (style: NavStyle) => ({
+  cardCount: z.union([...CARD_OPTIONS]).default(StyleDefaults[style].cardCount),
+  showPaging: z.union([...SHOW_OPTIONS]).default(StyleDefaults[style].showPaging),
+})
+
+/** 持久化设置 schema；也是浏览器 scope 校验的 wire 信封 */
+export const NavSettingsSchema: z<NavSettings> = z.object({
+  general: GeneralSchema,
+  styles: z.object({
+    minimal: z.object({ ...StyleFields, ...styleSchemaFields('minimal') }),
+    codex: z.object({ ...StyleFields, ...styleSchemaFields('codex') }),
+    deepseek: z.object({ ...StyleFields, ...styleSchemaFields('deepseek') }),
+  }),
+})
+
+/** 本插件设置命名空间 */
+export const megaChatNavSettingsNamespace = 'mega-chat-nav' as SettingsNamespace