dsh-manage-session 0.5.4 → 0.5.7

package/src/client/search/locales.ts

@@ -64,6 +64,11 @@ export const zh = {
   'panel.noContent': '没有匹配的内容。',
   'panel.contentHint': '输入内容关键词开始搜索。',
   'panel.noText': '(无文本)',
+  'panel.delete': '删除',
+  'panel.delete.confirm': '确认删除',
+  'panel.delete.hint': '删除该会话（不可逆，与管理端同款链路）',
+  'panel.delete.done': '已删除会话 {n} 个',
+  'panel.delete.failed': '删除失败：{error}',
   'panel.untitled': '(未命名)',
   'panel.openSession': '打开会话',
   'panel.footer.invoke': '唤出',
@@ -77,6 +82,10 @@ export const zh = {
   'sort.time': '时间',
   'sort.relevance.hint': '按匹配强度排序（默认）。',
   'sort.time.hint': '按会话最后活动时间倒序，更新的排前面；同一时间再按匹配强度。',
+  'group.merge': '合并',
+  'group.expand': '分开',
+  'group.merge.hint': '每个会话只显示最强的一条命中（默认）。',
+  'group.expand.hint': '同一会话的多条命中分行显示（每行仍是可跳转的独立命中）。',
   'type.user/message': '用户',
   'type.assistant/message': '回复',
   'type.tool/call': '工具调用',
@@ -180,6 +189,11 @@ export const en: Dict = {
   'panel.noContent': 'No matching content.',
   'panel.contentHint': 'Type keywords to search content.',
   'panel.noText': '(no text)',
+  'panel.delete': 'Delete',
+  'panel.delete.confirm': 'Confirm delete',
+  'panel.delete.hint': 'Delete this session (irreversible, same pipeline as the manage view)',
+  'panel.delete.done': 'Deleted {n} session(s)',
+  'panel.delete.failed': 'Delete failed: {error}',
   'panel.untitled': '(untitled)',
   'panel.openSession': 'Open session',
   'panel.footer.invoke': 'Open',
@@ -193,6 +207,10 @@ export const en: Dict = {
   'sort.time': 'Time',
   'sort.relevance.hint': 'Order by match strength (default).',
   'sort.time.hint': 'Order by session last-activity, newest first; ties break on match strength.',
+  'group.merge': 'Merge',
+  'group.expand': 'Expand',
+  'group.merge.hint': 'Show only the strongest hit per session (default).',
+  'group.expand.hint': 'List every hit of a session as its own row (each row is a jump target).',
   'type.user/message': 'User',
   'type.assistant/message': 'Reply',
   'type.tool/call': 'Tool call',
@@ -292,6 +310,11 @@ export const ja: Partial<Dict> = {
   'panel.noContent': '一致するコンテンツがありません。',
   'panel.contentHint': 'キーワードを入力してコンテンツを検索。',
   'panel.noText': '（テキストなし）',
+  'panel.delete': '削除',
+  'panel.delete.confirm': '削除を確認',
+  'panel.delete.hint': 'このセッションを削除（不可逆、管理画面と同じ経路）',
+  'panel.delete.done': 'セッション {n} 件を削除しました',
+  'panel.delete.failed': '削除に失敗：{error}',
   'panel.untitled': '（無題）',
   'panel.openSession': 'セッションを開く',
   'panel.footer.invoke': '開く',
@@ -305,6 +328,10 @@ export const ja: Partial<Dict> = {
   'sort.time': '時間',
   'sort.relevance.hint': '一致強度順に並べ替え（デフォルト）。',
   'sort.time.hint': 'セッション最終活動日時の降順、同着時は一致強度順。',
+  'group.merge': 'まとめる',
+  'group.expand': '展開',
+  'group.merge.hint': 'セッションごとに最強の一致1件のみ表示（デフォルト）。',
+  'group.expand.hint': '同一セッションの複数一致を行ごとに展開（各行が個別のジャンプ先）。',
   'type.user/message': 'ユーザー',
   'type.assistant/message': '返信',
   'type.tool/call': 'ツール呼び出し',
@@ -368,6 +395,11 @@ export const ko: Partial<Dict> = {
   'panel.noContent': '일치하는 콘텐츠가 없습니다.',
   'panel.contentHint': '키워드를 입력하여 콘텐츠를 검색하세요.',
   'panel.noText': '(텍스트 없음)',
+  'panel.delete': '삭제',
+  'panel.delete.confirm': '삭제 확인',
+  'panel.delete.hint': '이 세션 삭제(되돌릴 수 없음, 관리 화면과 동일한 경로)',
+  'panel.delete.done': '세션 {n}개 삭제됨',
+  'panel.delete.failed': '삭제 실패: {error}',
   'panel.untitled': '(제목 없음)',
   'panel.openSession': '세션 열기',
   'panel.footer.invoke': '열기',
@@ -381,6 +413,10 @@ export const ko: Partial<Dict> = {
   'sort.time': '시간',
   'sort.relevance.hint': '일치 강도순 정렬(기본값).',
   'sort.time.hint': '세션 마지막 활동 시간 내림차순, 동률 시 일치 강도순.',
+  'group.merge': '병합',
+  'group.expand': '분할',
+  'group.merge.hint': '세션별 최강 일치 1건만 표시(기본값).',
+  'group.expand.hint': '같은 세션의 여러 일치를 각 행으로 표시(각 행이 개별 이동 대상).',
   'type.user/message': '사용자',
   'type.assistant/message': '답변',
   'type.tool/call': '도구 호출',
@@ -444,6 +480,11 @@ export const fr: Partial<Dict> = {
   'panel.noContent': 'Aucun contenu correspondant.',
   'panel.contentHint': 'Saisissez des mots-clés pour rechercher dans le contenu.',
   'panel.noText': '(pas de texte)',
+  'panel.delete': 'Supprimer',
+  'panel.delete.confirm': 'Confirmer la suppression',
+  'panel.delete.hint': 'Supprimer cette session (irréversible, même pipeline que la gestion)',
+  'panel.delete.done': '{n} session(s) supprimée(s)',
+  'panel.delete.failed': 'Échec de suppression : {error}',
   'panel.untitled': '(sans titre)',
   'panel.openSession': 'Ouvrir la session',
   'panel.footer.invoke': 'Ouvrir',
@@ -457,6 +498,10 @@ export const fr: Partial<Dict> = {
   'sort.time': 'Temps',
   'sort.relevance.hint': 'Trier par force de correspondance (par défaut).',
   'sort.time.hint': 'Trier par dernière activité, plus récent d\'abord ; à égalité, par force de correspondance.',
+  'group.merge': 'Fusionner',
+  'group.expand': 'Détailler',
+  'group.merge.hint': 'Une seule correspondance la plus forte par session (par défaut).',
+  'group.expand.hint': 'Afficher chaque correspondance de la session sur sa propre ligne (chacune est une cible de saut).',
   'type.user/message': 'Utilisateur',
   'type.assistant/message': 'Réponse',
   'type.tool/call': 'Appel d\'outil',
@@ -520,6 +565,11 @@ export const de: Partial<Dict> = {
   'panel.noContent': 'Kein passender Inhalt.',
   'panel.contentHint': 'Geben Sie Stichwörter ein, um Inhalte zu durchsuchen.',
   'panel.noText': '(kein Text)',
+  'panel.delete': 'Löschen',
+  'panel.delete.confirm': 'Löschen bestätigen',
+  'panel.delete.hint': 'Diese Sitzung löschen (unwiderruflich, gleiche Pipeline wie die Verwaltung)',
+  'panel.delete.done': '{n} Sitzung(en) gelöscht',
+  'panel.delete.failed': 'Löschen fehlgeschlagen: {error}',
   'panel.untitled': '(unbenannt)',
   'panel.openSession': 'Sitzung öffnen',
   'panel.footer.invoke': 'Öffnen',
@@ -533,6 +583,10 @@ export const de: Partial<Dict> = {
   'sort.time': 'Zeit',
   'sort.relevance.hint': 'Nach Übereinstimmungsstärke sortieren (Standard).',
   'sort.time.hint': 'Nach letzter Sitzungsaktivität, neueste zuerst; bei Gleichstand nach Übereinstimmungsstärke.',
+  'group.merge': 'Zusammen',
+  'group.expand': 'Aufklappen',
+  'group.merge.hint': 'Nur der stärkste Treffer je Sitzung (Standard).',
+  'group.expand.hint': 'Jeden Treffer einer Sitzung als eigene Zeile anzeigen (jede Zeile ist ein Sprungziel).',
   'type.user/message': 'Benutzer',
   'type.assistant/message': 'Antwort',
   'type.tool/call': 'Werkzeugaufruf',
@@ -596,6 +650,11 @@ export const it: Partial<Dict> = {
   'panel.noContent': 'Nessun contenuto corrispondente.',
   'panel.contentHint': 'Inserisci parole chiave per cercare nel contenuto.',
   'panel.noText': '(nessun testo)',
+  'panel.delete': 'Elimina',
+  'panel.delete.confirm': 'Conferma eliminazione',
+  'panel.delete.hint': 'Elimina questa sessione (irreversibile, stessa pipeline della gestione)',
+  'panel.delete.done': 'Eliminate {n} sessione/i',
+  'panel.delete.failed': 'Eliminazione non riuscita: {error}',
   'panel.untitled': '(senza titolo)',
   'panel.openSession': 'Apri sessione',
   'panel.footer.invoke': 'Apri',
@@ -609,6 +668,10 @@ export const it: Partial<Dict> = {
   'sort.time': 'Tempo',
   'sort.relevance.hint': 'Ordina per forza di corrispondenza (predefinito).',
   'sort.time.hint': 'Ordina per ultima attività, più recente prima; a parità, per forza di corrispondenza.',
+  'group.merge': 'Unisci',
+  'group.expand': 'Espandi',
+  'group.merge.hint': 'Mostra solo il risultato più forte per sessione (predefinito).',
+  'group.expand.hint': 'Mostra ogni corrispondenza della sessione su riga propria (ogni riga è una destinazione).',
   'type.user/message': 'Utente',
   'type.assistant/message': 'Risposta',
   'type.tool/call': 'Chiamata strumento',
@@ -672,6 +735,11 @@ export const ru: Partial<Dict> = {
   'panel.noContent': 'Нет подходящего содержимого.',
   'panel.contentHint': 'Введите ключевые слова для поиска по содержимому.',
   'panel.noText': '(без текста)',
+  'panel.delete': 'Удалить',
+  'panel.delete.confirm': 'Подтвердить удаление',
+  'panel.delete.hint': 'Удалить эту сессию (необратимо, тот же конвейер, что и в администраторе)',
+  'panel.delete.done': 'Удалено сессий: {n}',
+  'panel.delete.failed': 'Ошибка удаления: {error}',
   'panel.untitled': '(без названия)',
   'panel.openSession': 'Открыть сессию',
   'panel.footer.invoke': 'Открыть',
@@ -685,6 +753,10 @@ export const ru: Partial<Dict> = {
   'sort.time': 'Время',
   'sort.relevance.hint': 'Сортировать по силе совпадения (по умолчанию).',
   'sort.time.hint': 'Сортировать по последней активности, сначала новые; при равенстве — по силе совпадения.',
+  'group.merge': 'Объединить',
+  'group.expand': 'Развернуть',
+  'group.merge.hint': 'По одному сильнейшему совпадению на сессию (по умолчанию).',
+  'group.expand.hint': 'Каждое совпадение сессии — отдельной строкой (каждая строка — цель перехода).',
   'type.user/message': 'Пользователь',
   'type.assistant/message': 'Ответ',
   'type.tool/call': 'Вызов инструмента',
@@ -748,6 +820,11 @@ export const es: Partial<Dict> = {
   'panel.noContent': 'Sin contenido coincidente.',
   'panel.contentHint': 'Escriba palabras clave para buscar contenido.',
   'panel.noText': '(sin texto)',
+  'panel.delete': 'Eliminar',
+  'panel.delete.confirm': 'Confirmar borrado',
+  'panel.delete.hint': 'Eliminar esta sesión (irreversible, misma ruta que la gestión)',
+  'panel.delete.done': '{n} sesión(es) eliminadas',
+  'panel.delete.failed': 'Error de borrado: {error}',
   'panel.untitled': '(sin título)',
   'panel.openSession': 'Abrir sesión',
   'panel.footer.invoke': 'Abrir',
@@ -761,6 +838,10 @@ export const es: Partial<Dict> = {
   'sort.time': 'Tiempo',
   'sort.relevance.hint': 'Ordenar por fuerza de coincidencia (predeterminado).',
   'sort.time.hint': 'Ordenar por última actividad, más reciente primero; en caso de empate, por fuerza de coincidencia.',
+  'group.merge': 'Unir',
+  'group.expand': 'Desplegar',
+  'group.merge.hint': 'Solo la coincidencia más fuerte por sesión (predeterminado).',
+  'group.expand.hint': 'Mostrar cada coincidencia de la sesión en su propia fila (cada fila es un destino).',
   'type.user/message': 'Usuario',
   'type.assistant/message': 'Respuesta',
   'type.tool/call': 'Llamada de herramienta',

package/src/client/search/locate.ts

@@ -0,0 +1,330 @@
+/**
+ * 命中定位臂（B 路线 v3，T7.4）：内容搜索点击打开会话后，把宿主会话视图 DOM
+ * 里对应的那一行滚进视口并瞬时高亮。
+ *
+ * 前提实证（0.2.1 宿主前端包扫描）：会话列表**无虚拟化**（无 virtuoso/
+ * react-window 指纹，IntersectionObserver 仅做 sticky 标题与入视口激活），
+ * 打开会话后历史行全量在 DOM。宿主导航接口面无消息锚点
+ * （uiWorkspace.openSession(SessionTarget) 全签名），DOM 文本匹配是唯一通路；
+ * 一切失败静默退化为「仅打开」（绝不抛、绝不遮主流程）。
+ *
+ * v2 教训（真机「还停在底部」）：一次性 scrollIntoView 会被宿主会话打开后
+ * 的贴底/滚动恢复覆盖——v3 改「巡逻-驻留」模型：每 TICK 重定位+补滚，
+ * 目标行稳定驻留视口 STICK_MS 后才打高亮；用户手动滚动立即让位。
+ *
+ * v4 根因修正（宿主接口面实锤）：dsh-client-ui-conversation 的 IConversation
+ * 暴露 loadOlder()（"Pull one older history page"）——历史是**分页**的，
+ * 首轮视口外找不到的真实原因是目标行根本没挂载。巡逻循环每 N tick 调
+ * 一次 loadOlder 往回翻页，直到目标 turn 的行进入 DOM 再驻留跳转；
+ * 翻页能力经 configureLocator 由 client apply 注入（本模块不持 ctx）。
+ *
+ * 数据面：同源 GET /api/dsh-reference-session-collector?op=session&session=<id>
+ * ——行含 seq/text/search_text/surface_text/on_surface/compressed：
+ * - on_surface=0（被替换原文行）：GUI 不渲染该文本 → 放弃定位（不是失败）；
+ * - compressed=1：GUI 渲染的是链解析后的 surface_text（替身文本）；
+ * - 其余行优先 search_text（已剥宿主注入样板段=用户可见文本），退化 text。
+ */
+import type { HostContentHit } from './host-api.ts'
+
+/** DRS fenced 路由（同源相对路径，与 dsh-reference-session-collector DRS_API_PATH 字面一致）。 */
+const DRS_ROUTE = '/api/dsh-reference-session-collector'
+
+/** 定位总超时（打开会话后 DOM 渲染窗口）。 */
+const LOCATE_TIMEOUT_MS = 8_000
+
+/** 高亮驻留时长后自动摘除。 */
+const FLASH_MS = 6_000
+
+/** needle 下限——短于此值的行（"好的"）歧义面太大，不值得定位。 */
+const MIN_NEEDLE_CHARS = 12
+
+/** needle 上限——取前缀足够唯一，过长整串匹配反而更易被渲染差异打断。 */
+const MAX_NEEDLE_CHARS = 80
+
+/** 驻留确认窗口：目标行在视口内稳定停留这么久才算跳转成功。 */
+const STICK_MS = 900
+
+/** 翻页上限：24 页 × 宿主页宽足够任何真机会话；防无限拉页。 */
+const MAX_OLDER_PAGES = 24
+
+/** 硬封顶：带翻页的定位窗口上限。 */
+const HARD_DEADLINE_MS = 30_000
+
+/** 巡逻间隔：会话重渲染会换 DOM 节点，每轮重新定位。 */
+const TICK_MS = 350
+
+/** 定位行在视口内的判定余量（顶部允许略出屏，代码块开头行高度不定）。 */
+const VISIBILITY_SLACK = 40
+
+/** 归一化/取 needle 用的一个 DRS 段行（wire 蛇形，只声明消费字段）。 */
+export interface LocateRowFace {
+  seq: number
+  /** 行归属 turn（阅读模式 [data-reader-turn] 直接寻址键）。 */
+  turn?: number
+  text?: string
+  search_text?: string
+  on_surface?: number
+  compressed?: number
+  surface_text?: string | null
+}
+
+/** markdown 结构符与空白——DOM 渲染后不含这些，两侧同抹才能对上。 */
+const MATCH_NOISE_RE = /[\s`*_~#>|[\]()!，。：；、"'\\{}-]+/gu
+
+/** 归一化比对文本：去空白与 markdown 噪声字符。 */
+export function normalizeForMatch(text: string): string {
+  return text.replace(MATCH_NOISE_RE, '')
+}
+
+/**
+ * 从段行选一条可定位 needle（按纯函数导出，供单测）。
+ * @returns 归一化 needle；null=该行不可定位（被替换原文/无有效文本/过短歧义）。
+ */
+export function resolveNeedle(row: LocateRowFace | undefined): string | null {
+  if (row === undefined) return null
+  if (Number(row.on_surface ?? 1) === 0) return null
+  const sources: (string | null | undefined)[] = Number(row.compressed ?? 0) === 1
+    ? [row.surface_text, row.search_text, row.text]
+    : [row.search_text, row.text]
+  for (const source of sources) {
+    if (typeof source !== 'string' || source === '') continue
+    // 行首段优先：渲染可能截断长行/拆段，首行完整命中概率最高。
+    const firstLine = source.split('\n').find(line => line.trim() !== '') ?? source
+    const needle = normalizeForMatch(firstLine).slice(0, MAX_NEEDLE_CHARS)
+    if (needle.length >= MIN_NEEDLE_CHARS) return needle
+    // 首行太短（"好的"）时退整段拼接再试一次，仍短则换下一来源。
+    const whole = normalizeForMatch(source).slice(0, MAX_NEEDLE_CHARS)
+    if (whole.length >= MIN_NEEDLE_CHARS) return whole
+  }
+  return null
+}
+
+/** 正文候选标签：只取消息渲染会用的块级/内联代码标签——不含 div/span，
+ * 否则搜索面板自己的结果行（dsws_snippet 的 span，文本就含 needle 前缀）会抢先命中。 */
+const MESSAGE_TAGS = 'p, li, pre, blockquote, h1, h2, h3, h4, td, code'
+
+/** 阅读线偏移（dsh-tidy-display conversation-scroll.ts READING_LINE_OFFSET_PX 同值）。 */
+const READING_LINE_OFFSET_PX = 24
+
+/** 有布局才叫可见：未挂载页签（display:none）的 rect 全 0，旧视口判定会误判驻留。 */
+function hasLayout(el: Element): boolean {
+  return (el as HTMLElement).offsetHeight > 0 || (el as HTMLElement).offsetWidth > 0
+}
+
+/** 祖先滚动盒（tidy-display 官方选择子）；缺席时退化窗口滚动。 */
+function scrollerOf(el: Element): HTMLElement | null {
+  return el.closest('[data-conversation-scroll]')
+}
+
+/** 在滚动窗口坐标系里把行着陆到顶部偏读线位——**绝不 scrollIntoView**
+ * （dsh-tidy-display 实锤：它会爬祖先 scroller 把 sticky composer 抬离底部，
+ * 随后宿主回贴 = 「还停在底部」）；与阅读模式 landTurn 同款 scrollTop 数学。 */
+function landRow(el: Element, offsetPx = READING_LINE_OFFSET_PX): void {
+  const html = el as HTMLElement
+  const port = scrollerOf(html) ?? (el.ownerDocument.scrollingElement as HTMLElement | null) ?? html
+  if (port === html) {
+    html.scrollIntoView({ block: 'start', behavior: 'auto' })
+    return
+  }
+  port.scrollTop += html.getBoundingClientRect().top - port.getBoundingClientRect().top - offsetPx
+}
+
+/** 行在**其滚动窗口**内是否已就位（驻留判定也用窗口系，不用视口系）。 */
+function landedInPort(el: Element): boolean {
+  const html = el as HTMLElement
+  if (!hasLayout(html)) return false
+  const port = scrollerOf(html)
+  if (port === null) {
+    const rect = html.getBoundingClientRect()
+    const vh = html.ownerDocument.defaultView?.innerHeight ?? 0
+    return rect.top >= -VISIBILITY_SLACK && rect.bottom <= vh + VISIBILITY_SLACK
+  }
+  const flow = html.getBoundingClientRect().top - port.getBoundingClientRect().top
+  return flow >= -VISIBILITY_SLACK && flow <= port.clientHeight + VISIBILITY_SLACK
+}
+
+/** 阅读模式优先：命中行若落在 [data-reader-turn] 段内，直接返该段（turn 级
+ * 锚点由插件自标，比文本匹配稳）；env.turn 给定时还能直接按 turn 号选段。 */
+function findReaderRow(root: ParentNode, needle: string, turn: number | undefined): Element | null {
+  if (turn !== undefined && turn > 0) {
+    const direct = root.querySelector(`[data-reader-turn="${String(turn)}"]`)
+    if (direct !== null && hasLayout(direct)) return direct
+  }
+  for (const el of Array.from(root.querySelectorAll(MESSAGE_TAGS))) {
+    if (!hasLayout(el)) continue
+    if (el.closest('[class*="dsws_"], [role="dialog"]') !== null) continue
+    const text = el.textContent
+    if (text === null || !normalizeForMatch(text).includes(needle)) continue
+    const section = el.closest('[data-reader-turn]')
+    if (section !== null && hasLayout(section)) return section
+    return el
+  }
+  return null
+}
+
+/**
+ * 找正文行：多义时取 DOM 最深者（段落本体而非包裹层）；**排除插件自家
+ * 子树**（dsws_ 前缀类与任何 role=dialog 弹层）——面板行/管理台行都是
+ * 目标文本的镜像，绝不允许当作跳转目的地。
+ */
+function findMessageElement(root: ParentNode, needle: string, turn?: number): Element | null {
+  // 阅读模式（dsh-tidy-display）在场时优先进其 turn 锚点体系；缺席自动走官方会话视图。
+  const reader = findReaderRow(root, needle, turn)
+  if (reader !== null) return reader
+  let best: Element | null = null
+  let bestDepth = -1
+  for (const el of Array.from(root.querySelectorAll(MESSAGE_TAGS))) {
+    if (!hasLayout(el)) continue // 未激活页签里的隐藏行不参与匹配（防驻留误判/跳错页签）
+    const text = el.textContent
+    if (text === null) continue
+    if (el.closest('[class*="dsws_"], [role="dialog"]') !== null) continue
+    if (!normalizeForMatch(text).includes(needle)) continue
+    const section = el.closest('[data-reader-turn]')
+    if (section !== null) continue // 段级已由 findReaderRow 处理，这里只收散行
+    let depth = 0
+    for (let n: Node | null = el.parentElement; n !== null; n = n.parentElement) depth += 1
+    if (depth > bestDepth) {
+      best = el
+      bestDepth = depth
+    }
+  }
+  return best
+}
+
+/** 瞬时高亮：类切换（不写 inline 样式——真机教训：prepend 历史后 React 复用
+ * 节点，定时器迟到把旧样式写在不相干元素上）。首次使用时惰性注入样式表。 */
+const FLASH_CLASS = 'dss-located-flash'
+let flashCssReady = false
+
+function ensureFlashCss(doc: Document): void {
+  if (flashCssReady) return
+  flashCssReady = true
+  const style = doc.createElement('style')
+  style.textContent = `.${FLASH_CLASS}{outline:2px solid var(--dsw-alias-accent,#4a9eff);outline-offset:2px;transition:outline 120ms ease}`
+  doc.head.appendChild(style)
+}
+
+function flashElement(el: Element): void {
+  if (el.ownerDocument !== null) ensureFlashCss(el.ownerDocument)
+  el.setAttribute('data-dss-located', '1')
+  el.classList.add(FLASH_CLASS)
+  setTimeout(() => {
+    el.classList.remove(FLASH_CLASS)
+    el.removeAttribute('data-dss-located')
+  }, FLASH_MS)
+}
+
+/** 定位执行面（测试可注入假环境；缺省走真浏览器）。 */
+export interface LocateEnv {
+  fetchImpl?: typeof fetch
+  doc?: Document
+  win?: Window
+  timeoutMs?: number
+  log?: (message: string) => void
+  /** 覆盖注入的翻页供给（测试用）；缺省走 configureLocator 的全局注入。 */
+  loadOlder?: () => Promise<boolean>
+}
+
+/** 外部能力注入面：client apply 期接线宿主会话服务，模块自身零 ctx 依赖。 */
+export interface LocatorDeps {
+  /** 拉一页更早历史；true=已发起（行数可能增），false=服务缺席/报错。 */
+  loadOlder?: () => Promise<boolean>
+}
+
+let injectedDeps: LocatorDeps = {}
+
+/** 接线点：client apply 调一次；未接线时定位退化为 v3 纯 DOM 巡逻。 */
+export function configureLocator(deps: LocatorDeps): void {
+  injectedDeps = deps
+}
+
+/** 目标行是否基本完整落在**其滚动窗口**内由 landedInPort 判定；旧视口函数已废弃。 */
+
+/**
+ * 主管线：拉 DRS 段行 → 选 needle → 巡逻宿主 DOM 补滚 → 驻留后高亮。
+ * fire-and-forget 语义：任何一步不满足都 resolve(false)，从不抛。
+ */
+export async function locateSearchHit(hit: HostContentHit, env: LocateEnv = {}): Promise<boolean> {
+  const fetchImpl = env.fetchImpl ?? globalThis.fetch
+  const doc = env.doc ?? (typeof document === 'undefined' ? undefined : document)
+  if (doc === undefined) return false
+  const win = env.win ?? doc.defaultView ?? (typeof window === 'undefined' ? undefined : window)
+  if (win === undefined) return false
+  const log = env.log ?? ((message: string): void => { console.debug(`[dsh-manage-session] ${message}`) })
+  try {
+    const response = await fetchImpl(`${DRS_ROUTE}?op=session&session=${encodeURIComponent(hit.sessionId)}`)
+    if (!response.ok) { log(`locate: drs http ${String(response.status)}`); return false }
+    const body = await response.json() as { ok?: boolean; rows?: LocateRowFace[] }
+    if (body.ok !== true || !Array.isArray(body.rows)) { log('locate: drs envelope shape'); return false }
+    const row = body.rows.find(r => Number(r.seq) === Number(hit.seq))
+    const needle = resolveNeedle(row)
+    if (needle === null) { log(`locate: skip row seq=${String(hit.seq)} (shadowed/短文本/无行)`); return false }
+    const targetTurn = typeof row?.turn === 'number' ? row.turn : undefined
+
+    const startedAt = Date.now()
+    let deadline = startedAt + (env.timeoutMs ?? LOCATE_TIMEOUT_MS)
+    const hardDeadline = startedAt + HARD_DEADLINE_MS
+    let lastScrollAt = 0
+    let userTookOver = false
+    // 翻页供给：client apply 注入（IConversation.loadOlder 包装），env 可覆盖供测试。
+    const pullOlder = env.loadOlder ?? injectedDeps.loadOlder
+    let pagesPulled = 0
+    let pullInFlight = false
+    let lastPullAt = 0
+    // pointerdown 必收：真机教训——巡逻窗口内用户点「加载更早记录」等页内按钮，
+    // 不收手则我们的补滚与宿主 prepend 后的滚动锚定对打，画面错乱。
+    const USER_EVENTS = ['wheel', 'touchstart', 'keydown', 'pointerdown'] as const
+    const onUser = (): void => { userTookOver = true }
+
+    return await new Promise<boolean>((resolve) => {
+      const finish = (ok: boolean, why: string): void => {
+        clearInterval(ticker)
+        for (const ev of USER_EVENTS) win.removeEventListener(ev, onUser)
+        log(`${why}: seq=${String(hit.seq)} ${hit.sessionId.slice(0, 12)} +${String(Date.now() - startedAt)}ms`)
+        resolve(ok)
+      }
+      for (const ev of USER_EVENTS) win.addEventListener(ev, onUser, { passive: true, once: true })
+      const ticker = setInterval(() => {
+        if (userTookOver) { finish(false, 'yield user'); return }
+        if (Date.now() >= deadline) { finish(false, `locate timeout (pages=${String(pagesPulled)})`); return }
+        const el = findMessageElement(doc.body ?? doc, needle, targetTurn)
+        if (el === null) {
+          // 目标行不在 DOM：历史分页面（IConversation.loadOlder）——没找到就
+          // 往回拉页，每拉一页给 2s 渲染窗口；拉满/拉尽则维持原超时。
+          if (pullOlder !== undefined && !pullInFlight && pagesPulled < MAX_OLDER_PAGES
+            && deadline < hardDeadline && Date.now() - lastPullAt >= TICK_MS * 2) {
+            pullInFlight = true
+            lastPullAt = Date.now()
+            void Promise.resolve().then(() => pullOlder()).then((pulled) => {
+              if (pulled) {
+                pagesPulled += 1
+                deadline = Math.min(hardDeadline, Date.now() + 2_000 + (env.timeoutMs ?? LOCATE_TIMEOUT_MS) / 2)
+              } else {
+                deadline = Math.min(deadline, Date.now()) // 服务缺席：不再等待
+              }
+            }).catch(() => {}).finally(() => { pullInFlight = false })
+          }
+          return // DOM 未就绪/会话还在切换：下一轮再找
+        }
+        if (landedInPort(el)) {
+          // 从未滚过且本来就可见（同会话当前视口）=直达；否则须驻留过 STICK 窗。
+          if (lastScrollAt === 0 || Date.now() - lastScrollAt >= STICK_MS) {
+            flashElement(el)
+            finish(true, 'located')
+          }
+          return
+        }
+        // 目标不在滚动窗口内：若距上次补滚超一个 tick，重新着陆（landRow 只写
+        // scroller.scrollTop，绝不 scrollIntoView——后者会抬走 sticky composer
+        // 并触发宿主回贴底部，tidy-display 实锤）。会话重渲染换节点也走这条。
+        if (Date.now() - lastScrollAt >= TICK_MS) {
+          landRow(el)
+          lastScrollAt = Date.now()
+        }
+      }, TICK_MS)
+    })
+  } catch (err) {
+    log(`locate error(silent): ${String(err instanceof Error ? err.message : err)}`)
+    return false
+  }
+}

package/src/client/search/manage.tsx

@@ -35,6 +35,8 @@ function injectManageStyles(): () => void {
 .dsws_batchBar{flex:none;display:flex;align-items:center;gap:8px;flex-wrap:wrap;padding:8px 10px;border-top:1px solid var(--dsw-alias-border-l1)}
 .dsws_batchInfo{flex:1 1 auto;min-width:0;color:var(--dsw-alias-label-secondary);font-size:12px;line-height:18px}
 .dsws_btnDanger{border-color:var(--dsw-alias-state-error-primary);color:var(--dsw-alias-state-error-primary)}
+.dsws_btnDangerSolid{background:var(--dsw-alias-state-error-primary);border-color:var(--dsw-alias-state-error-primary);color:#fff;font-weight:600}
+.dsws_btnDangerSolid:hover{background:var(--dsw-alias-state-error-primary);filter:brightness(1.08);color:#fff}
 .dsws_manageHint{color:var(--dsw-alias-label-tertiary);font-size:12px;line-height:18px;padding:8px 10px 0}
 .dsws_chips{display:flex;align-items:center;gap:6px;padding:8px 10px 0;flex:none;flex-wrap:wrap}
 .dsws_chip{height:24px;box-sizing:border-box;border:1px solid var(--dsw-alias-border-l2);background:transparent;color:var(--dsw-alias-label-secondary);cursor:pointer;border-radius:999px;padding:0 10px;font-size:12px;font-weight:500;line-height:22px;white-space:nowrap}
@@ -370,8 +372,10 @@ export function ManageConsole({ t, open }: { t?: ManageTranslate; open: (session
         onClick: () => { runBatch('unarchive') },
       }, translate(t, 'manage.batch.unarchive')),
       createElement('button', {
-        key: 'purge', type: 'button', className: `dsws_actBtn dsws_btnDanger`, disabled: batch.busy,
-        style: confirmPurge ? { background: 'var(--dsw-alias-state-error-primary)', color: 'var(--dsw-specific-tip)' } : undefined,
+        key: 'purge', type: 'button',
+        // 两步确认的第二步：红底白字实心（对齐宿主原生危险按钮，用户定标
+        // 2026-10-20）——白字不赌主题令牌（tip 色在亮色主题下对比度不足）。
+        className: `dsws_actBtn${confirmPurge ? ' dsws_btnDangerSolid' : ' dsws_btnDanger'}`, disabled: batch.busy,
         onClick: () => { runBatch('purge') },
       }, confirmPurge ? translate(t, 'manage.batch.confirm') : translate(t, 'manage.batch.delete')),
       batch.busy && createElement('span', { key: 'busy', className: 'dsws_batchInfo' }, translate(t, 'manage.batch.working')),