dsh-my-observability 0.1.5 → 0.1.7

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 本文件记录 dsh-my-observability 的所有版本变更。格式遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [0.1.7] - 2026-09-06
+
+### 变更
+
+- fix(task-reliability,observability): #165 Session.events 迁移——snapshotEvents 优先 + 旧 API 兜底 (#166)
+- feat(observability,task-reliability): #154 插件关键行为纳入事件审计（干预/ask 决策/救场/verify/恢复）+ 文件体积控制 (#158)
+- fix(observability): #142 dispose 落盘链可等待，修复 release 门禁 flaky 测试 (#148)
+
+## [0.1.6] - 2026-09-04
+
+### 变更
+
+- fix(observability): 轨迹回放会话下拉可读标题（首条用户消息）——此前只展示 UUID 清单
+
 ## [0.1.5] - 2026-09-04
 
 ### 变更

package/lib/ai.js

@@ -127,9 +127,14 @@ function extractJsonBlock(text) {
   return match !== null ? match[1].trim() : undefined
 }
 
+/** 会话事件快照：新 API snapshotEvents() 优先，旧 API events 兜底（issue #165）。 */
+function sessionEvents(session) {
+  return session?.snapshotEvents?.() ?? session?.events
+}
+
 function lastAssistantText(session) {
   try {
-    const events = session?.events
+    const events = sessionEvents(session)
     if (!Array.isArray(events)) return ''
     for (let i = events.length - 1; i >= 0; i--) {
       const text = assistantTextOf(events[i])

package/lib/audit-view.js

@@ -75,12 +75,28 @@ function toolResultParts(data) {
   return parts
 }
 
+/** 插件事件（issue #154）的搜索片段（插件名/事件名/动作/原因/参数值）。 */
+function pluginEventParts(data) {
+  const parts = []
+  if (typeof data.plugin === 'string') parts.push(data.plugin)
+  if (typeof data.event === 'string') parts.push(data.event)
+  if (typeof data.action === 'string') parts.push(data.action)
+  if (typeof data.reason === 'string') parts.push(data.reason)
+  if (data.params !== null && typeof data.params === 'object') {
+    for (const value of Object.values(data.params)) {
+      if (typeof value === 'string' && value !== '') parts.push(value)
+    }
+  }
+  return parts
+}
+
 /** 事件类型 → 搜索片段收集函数（查表消分支）。 */
 const PARTS_COLLECTORS = {
   agent_status: agentStatusParts,
   llm_stream: llmParts,
   tool_call: toolCallParts,
   tool_result: toolResultParts,
+  plugin_event: pluginEventParts,
 }
 
 /** 提取事件可用于关键词匹配的文本（工具名/参数摘要/错误信息/状态/阶段等）。 */
@@ -119,10 +135,11 @@ function normalizeCriteria(criteria) {
   return { type: criteria.type ?? '', keyword: criteria.keyword ?? '', result: criteria.result ?? '', start, end }
 }
 
-/** 类型过滤（'tool' 表示 tool_call + tool_result）。 */
+/** 类型过滤（'tool' 表示 tool_call + tool_result；'plugin' 表示 plugin_event）。 */
 function passType(type, filterType) {
   if (filterType === '') return true
   if (filterType === 'tool') return type === 'tool_call' || type === 'tool_result'
+  if (filterType === 'plugin') return type === 'plugin_event'
   return type === filterType
 }
 

package/lib/audit.js

@@ -7,6 +7,8 @@
  *                            waterfall，包装流透传全部 chunk）
  *  - `tools/pre-execute`   → `tool_call`（工具调用开始 + 参数摘要；透传 next）
  *  - `tools/execute`       → `tool_result`（工具结果 ok/失败 + 耗时；透传 next）
+ *  - 插件事件（issue #154）→ `plugin_event`（插件关键行为：干预/ask 决策/
+ *                            救场/校验/恢复，含插件名/事件名/动作/原因/参数）
  *
  * ⚠️ llm/stream 监听器必须保持同步函数：cordis waterfall 不 await listener
  * 返回值，next() 同步返回流；async listener 会让消费方（vision-toolkit 等
@@ -14,16 +16,111 @@
  */
 import { MAX_ARG_KEYS, MAX_TEXT_LEN } from './constants.js'
 
+/**
+ * 采集的插件事件名（按插件前缀显式注册，不依赖 cordis 通配符行为）。
+ * 与 dsh-task-reliability/lib/emit.js 的 PLUGIN_EVENTS 保持一致；
+ * 未来推广到其他插件（dsh-my-guardian 等）在此追加。
+ */
+const PLUGIN_EVENT_NAMES = [
+  'task-reliability/intervention',
+  'task-reliability/ask-decision',
+  'task-reliability/rescue',
+  'task-reliability/verify',
+  'task-reliability/resume',
+]
+
 /** 注册全部审计监听；返回 disposer 数组（全部经 ctx.on 注册）。 */
 export function attachAuditListeners(ctx, record) {
   return [
+    ctx.on('session/event', (session, event) => handleSessionEvent(session, event, record)),
     ctx.on('agent/status', (payload) => handleStatus(payload, record)),
     ctx.on('llm/stream', (options, next) => handleStream(options, next, record)),
     ctx.on('tools/pre-execute', (exec, next) => handlePreExecute(exec, next, record)),
     ctx.on('tools/execute', (exec, next) => handleExecute(exec, next, record)),
+    ...PLUGIN_EVENT_NAMES.map((name) => ctx.on(name, (payload) => handlePluginEvent(name, payload, record))),
   ]
 }
 
+/** 插件事件名 → 插件名（前缀补 dsh-，如 task-reliability → dsh-task-reliability）。 */
+function pluginNameOf(name) {
+  const prefix = name.split('/')[0]
+  return prefix === '' ? name : `dsh-${prefix}`
+}
+
+/** 插件事件名 → 事件名（去掉前缀，如 task-reliability/intervention → intervention）。 */
+function eventNameOf(name) {
+  const parts = name.split('/')
+  return parts.length > 1 ? parts.slice(1).join('/') : name
+}
+
+/** 插件事件 payload → 参数摘要（除 sessionId/action/reason 外的字段；字符串截断防膨胀）。 */
+function summarizeParams(payload) {
+  const params = {}
+  for (const [key, value] of Object.entries(payload ?? {})) {
+    if (key === 'sessionId' || key === 'action' || key === 'reason') continue
+    if (typeof value === 'string') params[key] = truncate(value)
+    else if (typeof value === 'number' || typeof value === 'boolean') params[key] = value
+  }
+  return params
+}
+
+/**
+ * 插件事件 → plugin_event 审计事件（与现有事件同时间线/同过滤/同导出）。
+ * 无 sessionId 的插件事件不记录（与 agent_status 等一致）。
+ */
+function handlePluginEvent(name, payload, record) {
+  const sessionId = payload?.sessionId
+  if (typeof sessionId !== 'string' || sessionId === '') return
+  record({
+    type: 'plugin_event',
+    sessionId,
+    data: {
+      plugin: pluginNameOf(name),
+      event: eventNameOf(name),
+      action: truncate(String(payload?.action ?? '')),
+      reason: truncate(String(payload?.reason ?? '')),
+      params: summarizeParams(payload),
+    },
+  })
+}
+
+/**
+ * session/event → user_message 事件（会话标题来源）。
+ * 轨迹回放面板需要"对话可读标题"而非 UUID：从每个会话真实用户的首条
+ * 消息截断生成（跳过插件注入消息），面板 sessionsOf 取最早一条作为
+ * title。不作为独立存储字段，走现有事件通路，重启后自然恢复。
+ */
+function handleSessionEvent(session, event, record) {
+  if (event === null || typeof event !== 'object' || event.type !== 'user/message') return
+  const message = event.data
+  if (isPluginMessage(message)) return
+  const sessionId = session?.id
+  if (typeof sessionId !== 'string' || sessionId === '') return
+  const text = userTextOf(message)
+  if (text === '') return
+  record({ type: 'user_message', sessionId, data: { text: truncate(text) } })
+}
+
+/** 是否为插件注入的消息（非真实用户输入，不作为标题）。 */
+function isPluginMessage(message) {
+  const source = message?.source
+  return source !== null && typeof source === 'object' && source.kind === 'plugin'
+}
+
+/** 从 user message 提取文本（content 中全部 text block 拼接）。 */
+function userTextOf(message) {
+  if (message === null || typeof message !== 'object') return ''
+  const content = message.content
+  if (!Array.isArray(content)) return ''
+  const parts = []
+  for (const block of content) {
+    if (block !== null && typeof block === 'object' && block.type === 'text' && typeof block.text === 'string') {
+      parts.push(block.text)
+    }
+  }
+  return parts.join(' ').trim()
+}
+
 /** agent/status → agent_status 事件（含顶层/子代理标记）。 */
 function handleStatus(payload, record) {
   const agent = payload?.agent

package/lib/client.js

@@ -50,10 +50,16 @@ const strings = {
   resourceMem: () => (isZh() ? '内存' : 'Memory'),
   gitTitle: () => (isZh() ? 'Git 工具' : 'Git Tools'),
   allSessions: () => (isZh() ? '全部会话' : 'All sessions'),
+  // ── 会话下拉可读性（issue #1xx：只能看到 UUID）────────────────────────
+  eventCount: (n) => (isZh() ? `${n} 事件` : `${n} events`),
+  sessionFallback: (shortId) => (isZh() ? `会话 ${shortId}` : `session ${shortId}`),
   filterAll: () => (isZh() ? '全部' : 'All'),
   filterStatus: () => (isZh() ? '状态' : 'Status'),
   filterLlm: () => (isZh() ? '模型流' : 'LLM'),
   filterTools: () => (isZh() ? '工具' : 'Tools'),
+  filterPlugin: () => (isZh() ? '插件' : 'Plugins'),
+  typePluginEvent: () => (isZh() ? '插件事件' : 'plugin event'),
+  detailReason: () => (isZh() ? '原因' : 'reason'),
   emptyEvents: () => (isZh() ? '暂无审计事件' : 'No audit events yet'),
   emptyEventsHint: () =>
     isZh()
@@ -531,12 +537,28 @@ function toolResultParts(data) {
   return parts
 }
 
+/** 插件事件（issue #154）的搜索片段（插件名/事件名/动作/原因/参数值）。 */
+function pluginEventParts(data) {
+  const parts = []
+  if (typeof data.plugin === 'string') parts.push(data.plugin)
+  if (typeof data.event === 'string') parts.push(data.event)
+  if (typeof data.action === 'string') parts.push(data.action)
+  if (typeof data.reason === 'string') parts.push(data.reason)
+  if (data.params !== null && typeof data.params === 'object') {
+    for (const value of Object.values(data.params)) {
+      if (typeof value === 'string' && value !== '') parts.push(value)
+    }
+  }
+  return parts
+}
+
 /** 事件类型 → 搜索片段收集函数（查表消分支）。 */
 const PARTS_COLLECTORS = {
   agent_status: agentStatusParts,
   llm_stream: llmParts,
   tool_call: toolCallParts,
   tool_result: toolResultParts,
+  plugin_event: pluginEventParts,
 }
 
 /** 提取事件可用于关键词匹配的文本（工具名/参数摘要/错误信息/状态/阶段等）。 */
@@ -575,10 +597,11 @@ function normalizeCriteria(criteria) {
   return { type: criteria.type ?? '', keyword: criteria.keyword ?? '', result: criteria.result ?? '', start, end }
 }
 
-/** 类型过滤（'tool' 表示 tool_call + tool_result）。 */
+/** 类型过滤（'tool' 表示 tool_call + tool_result；'plugin' 表示 plugin_event）。 */
 function passType(type, filterType) {
   if (filterType === '') return true
   if (filterType === 'tool') return type === 'tool_call' || type === 'tool_result'
+  if (filterType === 'plugin') return type === 'plugin_event'
   return type === filterType
 }
 
@@ -735,17 +758,21 @@ function typeLabel(event) {
       return strings.typeToolCall()
     case 'tool_result':
       return strings.typeToolResult()
+    case 'plugin_event':
+      return strings.typePluginEvent()
     default:
       return event.type
   }
 }
 
 /** 事件类型 → 视觉类别（徽标/图标/节点共用，颜色语义一致）：
- *  status=info / llm=warn / call=accent / result=success / fail=danger。 */
+ *  status=info / llm=warn / call=accent / result=success / fail=danger /
+ *  plugin=info（插件事件复用 info 色，图标区分）。 */
 function typeKind(event) {
   if (event.type === 'agent_status') return 'status'
   if (event.type === 'llm_stream') return 'llm'
   if (event.type === 'tool_call') return 'call'
+  if (event.type === 'plugin_event') return 'plugin'
   return event.data?.ok === false ? 'fail' : 'result'
 }
 
@@ -755,6 +782,7 @@ function typeIcon(event) {
   if (kind === 'status') return icon.clock(15)
   if (kind === 'llm') return icon.file(15)
   if (kind === 'call') return icon.external(15)
+  if (kind === 'plugin') return icon.alert(15)
   if (kind === 'fail') return icon.close(15)
   return icon.check(15)
 }
@@ -809,6 +837,12 @@ function toolResultMeta(data) {
   return `${data.name} · ${result} · ${data.ms}ms`
 }
 
+/** 插件事件摘要（插件名 · 事件名 · 动作；issue #154）。 */
+function pluginEventMeta(data) {
+  const action = typeof data.action === 'string' && data.action !== '' ? data.action : data.event
+  return `${data.plugin} · ${data.event} · ${action}`
+}
+
 /** 事件 → 摘要文本（单行，尽力而为）。 */
 function eventMeta(event) {
   const data = event.data || {}
@@ -816,17 +850,55 @@ function eventMeta(event) {
   if (event.type === 'llm_stream') return llmMeta(data)
   if (event.type === 'tool_call') return toolCallMeta(data)
   if (event.type === 'tool_result') return toolResultMeta(data)
+  if (event.type === 'plugin_event') return pluginEventMeta(data)
   return ''
 }
 
+/** 插件事件详情行（原因 + 参数键值对；非插件事件返回 null 不可展开）。 */
+function eventDetail(event) {
+  if (event?.type !== 'plugin_event') return null
+  const data = event.data || {}
+  const rows = []
+  if (typeof data.reason === 'string' && data.reason !== '') {
+    rows.push(
+      createElement(
+        'div',
+        { key: 'reason', className: 'dsh-my-observability-detail-row' },
+        createElement('span', { className: 'dsh-my-observability-detail-key' }, strings.detailReason()),
+        createElement('span', { className: 'dsh-my-observability-detail-value' }, data.reason),
+      ),
+    )
+  }
+  if (data.params !== null && typeof data.params === 'object') {
+    for (const [key, value] of Object.entries(data.params)) {
+      rows.push(
+        createElement(
+          'div',
+          { key, className: 'dsh-my-observability-detail-row' },
+          createElement('span', { className: 'dsh-my-observability-detail-key' }, key),
+          createElement('span', { className: 'dsh-my-observability-detail-value' }, String(value)),
+        ),
+      )
+    }
+  }
+  return rows.length > 0 ? rows : null
+}
+
 /** 单条事件行：节点圆点 + 类型图标 + 徽标/时间 + 摘要（hover/active 反馈）。
- *  摘要命中关键词时以 mark 高亮。 */
+ *  摘要命中关键词时以 mark 高亮；插件事件可点击展开详情（原因/参数）。 */
 function EventRow({ event, keyword }) {
   const meta = eventMeta(event)
   const kind = typeKind(event)
+  const detail = eventDetail(event)
+  const [open, setOpen] = useState(false)
   return createElement(
     'button',
-    { className: 'dsh-my-observability-event', type: 'button' },
+    {
+      className: 'dsh-my-observability-event',
+      type: 'button',
+      'aria-expanded': detail !== null ? open : undefined,
+      onClick: detail !== null ? () => setOpen(!open) : undefined,
+    },
     createElement('span', { className: `dsh-my-observability-node dsh-my-observability-node-${kind}` }),
     createElement(
       'span',
@@ -853,17 +925,19 @@ function EventRow({ event, keyword }) {
             createElement(HighlightText, { text: meta, keyword }),
           )
         : null,
+      detail !== null && open ? createElement('div', { className: 'dsh-my-observability-event-detail' }, detail) : null,
     ),
   )
 }
 
-/** 类型过滤按钮组（aria-pressed 选中态）。 */
+/** 类型过滤按钮组（aria-pressed 选中态；plugin 过滤插件事件，issue #154）。 */
 function TypeFilter({ filter, onFilter }) {
   const options = [
     ['', strings.filterAll()],
     ['agent_status', strings.filterStatus()],
     ['llm_stream', strings.filterLlm()],
     ['tool', strings.filterTools()],
+    ['plugin', strings.filterPlugin()],
   ]
   return createElement(
     'div',
@@ -907,6 +981,18 @@ async function loadReplayData(selected, currentSession, setters) {
   }
 }
 
+/** 下拉选项文案：可读标题（首条用户消息）优先，无标题回退 UUID 短显；
+ *  附加事件数与时间，用户一眼看出"哪个对话"。 */
+function sessionOptionLabel(s) {
+  const title = typeof s.title === 'string' && s.title !== '' ? s.title : strings.sessionFallback(shortId(s.sessionId))
+  return `${title} · ${strings.eventCount(s.count)}`
+}
+
+/** 会话 id 短显示（UUID 取前 8 位）。 */
+function shortId(sessionId) {
+  return typeof sessionId === 'string' && sessionId.length > 8 ? `${sessionId.slice(0, 8)}…` : sessionId || ''
+}
+
 /** 工具栏：会话选择 + 手动刷新 + 类型过滤。 */
 function ReplayToolbar({ sessions, selected, onSelect, filter, onFilter, onRefresh }) {
   return createElement(
@@ -925,7 +1011,9 @@ function ReplayToolbar({ sessions, selected, onSelect, filter, onFilter, onRefre
         },
         sessions.length === 0
           ? createElement('option', { value: '' }, strings.allSessions())
-          : sessions.map((s) => createElement('option', { key: s.sessionId, value: s.sessionId }, s.sessionId)),
+          : sessions.map((s) =>
+              createElement('option', { key: s.sessionId, value: s.sessionId }, sessionOptionLabel(s)),
+            ),
       ),
       createElement(
         'button',
@@ -1050,7 +1138,10 @@ function useResourceState(visible) {
     if (!visible) return undefined
     let alive = true
     const tick = () => {
-      if (alive) apiJson('/observability/api/resources').then(setResource).catch(() => {})
+      if (alive)
+        apiJson('/observability/api/resources')
+          .then(setResource)
+          .catch(() => {})
     }
     tick()
     const timer = setInterval(tick, RESOURCE_POLL_MS)
@@ -1085,8 +1176,14 @@ function ResourcePanel({ resource }) {
       'div',
       { className: 'dsh-my-observability-resource-grid' },
       createElement(ResourceMetric, { label: strings.resourceFile(), value: fmtResourceBytes(resource.fileBytes) }),
-      createElement(ResourceMetric, { label: strings.resourceRate(), value: `${fmtResourceBytes(resource.writeRateBytesPerHour)}/h` }),
-      createElement(ResourceMetric, { label: strings.resourceCpu(), value: `${Math.round(resource.cpuPercent ?? 0)}%` }),
+      createElement(ResourceMetric, {
+        label: strings.resourceRate(),
+        value: `${fmtResourceBytes(resource.writeRateBytesPerHour)}/h`,
+      }),
+      createElement(ResourceMetric, {
+        label: strings.resourceCpu(),
+        value: `${Math.round(resource.cpuPercent ?? 0)}%`,
+      }),
       createElement(ResourceMetric, { label: strings.resourceMem(), value: fmtResourceBytes(resource.memoryBytes) }),
     ),
     alerts.length > 0
@@ -1386,7 +1483,10 @@ function useReplayDataState(props) {
     if (!visible) return undefined
     let alive = true
     const tick = () => {
-      if (alive) apiJson('/observability/api/resources').then(setResource).catch(() => {})
+      if (alive)
+        apiJson('/observability/api/resources')
+          .then(setResource)
+          .catch(() => {})
     }
     tick()
     const timer = setInterval(tick, RESOURCE_POLL_MS)
@@ -1842,12 +1942,14 @@ const STYLES = `
 .dsh-my-observability-node-status{border-color:var(--dsw-alias-state-info-primary)}
 .dsh-my-observability-node-llm{border-color:var(--dsw-alias-state-warn-primary)}
 .dsh-my-observability-node-call{border-color:var(--dsw-alias-accent)}
+.dsh-my-observability-node-plugin{border-color:var(--dsw-alias-state-info-primary)}
 .dsh-my-observability-node-result{border-color:var(--dsw-alias-state-success-primary)}
 .dsh-my-observability-node-fail{border-color:var(--dsw-alias-state-error-primary)}
 .dsh-my-observability-event-icon{flex:none;display:flex;align-items:center;margin-top:1px}
 .dsh-my-observability-icon-status{color:var(--dsw-alias-state-info-primary)}
 .dsh-my-observability-icon-llm{color:var(--dsw-alias-state-warn-primary)}
 .dsh-my-observability-icon-call{color:var(--dsw-alias-accent)}
+.dsh-my-observability-icon-plugin{color:var(--dsw-alias-state-info-primary)}
 .dsh-my-observability-icon-result{color:var(--dsw-alias-state-success-primary)}
 .dsh-my-observability-icon-fail{color:var(--dsw-alias-state-error-primary)}
 .dsh-my-observability-event-body{flex:1;min-width:0;display:flex;flex-direction:column;gap:1px}
@@ -1856,10 +1958,17 @@ const STYLES = `
 .dsh-my-observability-badge-status{color:var(--dsw-alias-state-info-primary);background:color-mix(in srgb, var(--dsw-alias-state-info-primary) 14%, transparent)}
 .dsh-my-observability-badge-llm{color:var(--dsw-alias-state-warn-primary);background:color-mix(in srgb, var(--dsw-alias-state-warn-primary) 14%, transparent)}
 .dsh-my-observability-badge-call{color:var(--dsw-alias-accent);background:color-mix(in srgb, var(--dsw-alias-accent) 12%, transparent)}
+.dsh-my-observability-badge-plugin{color:var(--dsw-alias-state-info-primary);background:color-mix(in srgb, var(--dsw-alias-state-info-primary) 14%, transparent)}
 .dsh-my-observability-badge-result{color:var(--dsw-alias-state-success-primary);background:color-mix(in srgb, var(--dsw-alias-state-success-primary) 14%, transparent)}
 .dsh-my-observability-badge-fail{color:var(--dsw-alias-state-error-primary);background:color-mix(in srgb, var(--dsw-alias-state-error-primary) 14%, transparent)}
 .dsh-my-observability-time{flex:none;font:var(--dsw-font-xxxs-11);color:var(--dsw-alias-label-tertiary);white-space:nowrap}
 .dsh-my-observability-event-meta{font:var(--dsw-font-xxs-12);color:var(--dsw-alias-label-secondary);line-height:1.6;word-break:break-word}
+/* ── 插件事件详情展开（issue #154：原因/参数可查）── */
+.dsh-my-observability-event-detail{display:flex;flex-direction:column;gap:2px;margin-top:4px;padding:6px 8px;
+  border:1px solid var(--dsw-alias-border-l2);border-radius:6px;background:var(--dsw-alias-bg-layer-1)}
+.dsh-my-observability-detail-row{display:flex;gap:8px;font:var(--dsw-font-xxs-12);line-height:1.5;word-break:break-word}
+.dsh-my-observability-detail-key{flex:none;font:var(--dsw-font-xxxs-strong-11);color:var(--dsw-alias-label-tertiary);min-width:56px}
+.dsh-my-observability-detail-value{color:var(--dsw-alias-label-primary)}
 /* ── 状态区：loading / 空 / 错误 ── */
 .dsh-my-observability-state{display:flex;align-items:center;gap:6px;padding:8px 6px;font:var(--dsw-font-xxs-12);color:var(--dsw-alias-label-tertiary)}
 .dsh-my-observability-state svg{flex:none;animation:dsh-my-observability-spin 1s linear infinite}

package/lib/parts/i18n.js

@@ -18,10 +18,16 @@ const strings = {
   resourceMem: () => (isZh() ? '内存' : 'Memory'),
   gitTitle: () => (isZh() ? 'Git 工具' : 'Git Tools'),
   allSessions: () => (isZh() ? '全部会话' : 'All sessions'),
+  // ── 会话下拉可读性（issue #1xx：只能看到 UUID）────────────────────────
+  eventCount: (n) => (isZh() ? `${n} 事件` : `${n} events`),
+  sessionFallback: (shortId) => (isZh() ? `会话 ${shortId}` : `session ${shortId}`),
   filterAll: () => (isZh() ? '全部' : 'All'),
   filterStatus: () => (isZh() ? '状态' : 'Status'),
   filterLlm: () => (isZh() ? '模型流' : 'LLM'),
   filterTools: () => (isZh() ? '工具' : 'Tools'),
+  filterPlugin: () => (isZh() ? '插件' : 'Plugins'),
+  typePluginEvent: () => (isZh() ? '插件事件' : 'plugin event'),
+  detailReason: () => (isZh() ? '原因' : 'reason'),
   emptyEvents: () => (isZh() ? '暂无审计事件' : 'No audit events yet'),
   emptyEventsHint: () =>
     isZh()

package/lib/parts/replay.js

@@ -22,17 +22,21 @@ function typeLabel(event) {
       return strings.typeToolCall()
     case 'tool_result':
       return strings.typeToolResult()
+    case 'plugin_event':
+      return strings.typePluginEvent()
     default:
       return event.type
   }
 }
 
 /** 事件类型 → 视觉类别（徽标/图标/节点共用，颜色语义一致）：
- *  status=info / llm=warn / call=accent / result=success / fail=danger。 */
+ *  status=info / llm=warn / call=accent / result=success / fail=danger /
+ *  plugin=info（插件事件复用 info 色，图标区分）。 */
 function typeKind(event) {
   if (event.type === 'agent_status') return 'status'
   if (event.type === 'llm_stream') return 'llm'
   if (event.type === 'tool_call') return 'call'
+  if (event.type === 'plugin_event') return 'plugin'
   return event.data?.ok === false ? 'fail' : 'result'
 }
 
@@ -42,6 +46,7 @@ function typeIcon(event) {
   if (kind === 'status') return icon.clock(15)
   if (kind === 'llm') return icon.file(15)
   if (kind === 'call') return icon.external(15)
+  if (kind === 'plugin') return icon.alert(15)
   if (kind === 'fail') return icon.close(15)
   return icon.check(15)
 }
@@ -96,6 +101,12 @@ function toolResultMeta(data) {
   return `${data.name} · ${result} · ${data.ms}ms`
 }
 
+/** 插件事件摘要（插件名 · 事件名 · 动作；issue #154）。 */
+function pluginEventMeta(data) {
+  const action = typeof data.action === 'string' && data.action !== '' ? data.action : data.event
+  return `${data.plugin} · ${data.event} · ${action}`
+}
+
 /** 事件 → 摘要文本（单行，尽力而为）。 */
 function eventMeta(event) {
   const data = event.data || {}
@@ -103,17 +114,55 @@ function eventMeta(event) {
   if (event.type === 'llm_stream') return llmMeta(data)
   if (event.type === 'tool_call') return toolCallMeta(data)
   if (event.type === 'tool_result') return toolResultMeta(data)
+  if (event.type === 'plugin_event') return pluginEventMeta(data)
   return ''
 }
 
+/** 插件事件详情行（原因 + 参数键值对；非插件事件返回 null 不可展开）。 */
+function eventDetail(event) {
+  if (event?.type !== 'plugin_event') return null
+  const data = event.data || {}
+  const rows = []
+  if (typeof data.reason === 'string' && data.reason !== '') {
+    rows.push(
+      createElement(
+        'div',
+        { key: 'reason', className: 'dsh-my-observability-detail-row' },
+        createElement('span', { className: 'dsh-my-observability-detail-key' }, strings.detailReason()),
+        createElement('span', { className: 'dsh-my-observability-detail-value' }, data.reason),
+      ),
+    )
+  }
+  if (data.params !== null && typeof data.params === 'object') {
+    for (const [key, value] of Object.entries(data.params)) {
+      rows.push(
+        createElement(
+          'div',
+          { key, className: 'dsh-my-observability-detail-row' },
+          createElement('span', { className: 'dsh-my-observability-detail-key' }, key),
+          createElement('span', { className: 'dsh-my-observability-detail-value' }, String(value)),
+        ),
+      )
+    }
+  }
+  return rows.length > 0 ? rows : null
+}
+
 /** 单条事件行：节点圆点 + 类型图标 + 徽标/时间 + 摘要（hover/active 反馈）。
- *  摘要命中关键词时以 mark 高亮。 */
+ *  摘要命中关键词时以 mark 高亮；插件事件可点击展开详情（原因/参数）。 */
 function EventRow({ event, keyword }) {
   const meta = eventMeta(event)
   const kind = typeKind(event)
+  const detail = eventDetail(event)
+  const [open, setOpen] = useState(false)
   return createElement(
     'button',
-    { className: 'dsh-my-observability-event', type: 'button' },
+    {
+      className: 'dsh-my-observability-event',
+      type: 'button',
+      'aria-expanded': detail !== null ? open : undefined,
+      onClick: detail !== null ? () => setOpen(!open) : undefined,
+    },
     createElement('span', { className: `dsh-my-observability-node dsh-my-observability-node-${kind}` }),
     createElement(
       'span',
@@ -140,17 +189,19 @@ function EventRow({ event, keyword }) {
             createElement(HighlightText, { text: meta, keyword }),
           )
         : null,
+      detail !== null && open ? createElement('div', { className: 'dsh-my-observability-event-detail' }, detail) : null,
     ),
   )
 }
 
-/** 类型过滤按钮组（aria-pressed 选中态）。 */
+/** 类型过滤按钮组（aria-pressed 选中态；plugin 过滤插件事件，issue #154）。 */
 function TypeFilter({ filter, onFilter }) {
   const options = [
     ['', strings.filterAll()],
     ['agent_status', strings.filterStatus()],
     ['llm_stream', strings.filterLlm()],
     ['tool', strings.filterTools()],
+    ['plugin', strings.filterPlugin()],
   ]
   return createElement(
     'div',
@@ -194,6 +245,18 @@ async function loadReplayData(selected, currentSession, setters) {
   }
 }
 
+/** 下拉选项文案：可读标题（首条用户消息）优先，无标题回退 UUID 短显；
+ *  附加事件数与时间，用户一眼看出"哪个对话"。 */
+function sessionOptionLabel(s) {
+  const title = typeof s.title === 'string' && s.title !== '' ? s.title : strings.sessionFallback(shortId(s.sessionId))
+  return `${title} · ${strings.eventCount(s.count)}`
+}
+
+/** 会话 id 短显示（UUID 取前 8 位）。 */
+function shortId(sessionId) {
+  return typeof sessionId === 'string' && sessionId.length > 8 ? `${sessionId.slice(0, 8)}…` : sessionId || ''
+}
+
 /** 工具栏：会话选择 + 手动刷新 + 类型过滤。 */
 function ReplayToolbar({ sessions, selected, onSelect, filter, onFilter, onRefresh }) {
   return createElement(
@@ -212,7 +275,9 @@ function ReplayToolbar({ sessions, selected, onSelect, filter, onFilter, onRefre
         },
         sessions.length === 0
           ? createElement('option', { value: '' }, strings.allSessions())
-          : sessions.map((s) => createElement('option', { key: s.sessionId, value: s.sessionId }, s.sessionId)),
+          : sessions.map((s) =>
+              createElement('option', { key: s.sessionId, value: s.sessionId }, sessionOptionLabel(s)),
+            ),
       ),
       createElement(
         'button',

package/lib/parts/styles.js

@@ -42,12 +42,14 @@ const STYLES = `
 .dsh-my-observability-node-status{border-color:var(--dsw-alias-state-info-primary)}
 .dsh-my-observability-node-llm{border-color:var(--dsw-alias-state-warn-primary)}
 .dsh-my-observability-node-call{border-color:var(--dsw-alias-accent)}
+.dsh-my-observability-node-plugin{border-color:var(--dsw-alias-state-info-primary)}
 .dsh-my-observability-node-result{border-color:var(--dsw-alias-state-success-primary)}
 .dsh-my-observability-node-fail{border-color:var(--dsw-alias-state-error-primary)}
 .dsh-my-observability-event-icon{flex:none;display:flex;align-items:center;margin-top:1px}
 .dsh-my-observability-icon-status{color:var(--dsw-alias-state-info-primary)}
 .dsh-my-observability-icon-llm{color:var(--dsw-alias-state-warn-primary)}
 .dsh-my-observability-icon-call{color:var(--dsw-alias-accent)}
+.dsh-my-observability-icon-plugin{color:var(--dsw-alias-state-info-primary)}
 .dsh-my-observability-icon-result{color:var(--dsw-alias-state-success-primary)}
 .dsh-my-observability-icon-fail{color:var(--dsw-alias-state-error-primary)}
 .dsh-my-observability-event-body{flex:1;min-width:0;display:flex;flex-direction:column;gap:1px}
@@ -56,10 +58,17 @@ const STYLES = `
 .dsh-my-observability-badge-status{color:var(--dsw-alias-state-info-primary);background:color-mix(in srgb, var(--dsw-alias-state-info-primary) 14%, transparent)}
 .dsh-my-observability-badge-llm{color:var(--dsw-alias-state-warn-primary);background:color-mix(in srgb, var(--dsw-alias-state-warn-primary) 14%, transparent)}
 .dsh-my-observability-badge-call{color:var(--dsw-alias-accent);background:color-mix(in srgb, var(--dsw-alias-accent) 12%, transparent)}
+.dsh-my-observability-badge-plugin{color:var(--dsw-alias-state-info-primary);background:color-mix(in srgb, var(--dsw-alias-state-info-primary) 14%, transparent)}
 .dsh-my-observability-badge-result{color:var(--dsw-alias-state-success-primary);background:color-mix(in srgb, var(--dsw-alias-state-success-primary) 14%, transparent)}
 .dsh-my-observability-badge-fail{color:var(--dsw-alias-state-error-primary);background:color-mix(in srgb, var(--dsw-alias-state-error-primary) 14%, transparent)}
 .dsh-my-observability-time{flex:none;font:var(--dsw-font-xxxs-11);color:var(--dsw-alias-label-tertiary);white-space:nowrap}
 .dsh-my-observability-event-meta{font:var(--dsw-font-xxs-12);color:var(--dsw-alias-label-secondary);line-height:1.6;word-break:break-word}
+/* ── 插件事件详情展开（issue #154：原因/参数可查）── */
+.dsh-my-observability-event-detail{display:flex;flex-direction:column;gap:2px;margin-top:4px;padding:6px 8px;
+  border:1px solid var(--dsw-alias-border-l2);border-radius:6px;background:var(--dsw-alias-bg-layer-1)}
+.dsh-my-observability-detail-row{display:flex;gap:8px;font:var(--dsw-font-xxs-12);line-height:1.5;word-break:break-word}
+.dsh-my-observability-detail-key{flex:none;font:var(--dsw-font-xxxs-strong-11);color:var(--dsw-alias-label-tertiary);min-width:56px}
+.dsh-my-observability-detail-value{color:var(--dsw-alias-label-primary)}
 /* ── 状态区：loading / 空 / 错误 ── */
 .dsh-my-observability-state{display:flex;align-items:center;gap:6px;padding:8px 6px;font:var(--dsw-font-xxs-12);color:var(--dsw-alias-label-tertiary)}
 .dsh-my-observability-state svg{flex:none;animation:dsh-my-observability-spin 1s linear infinite}

package/lib/store.js

@@ -134,7 +134,7 @@ function eventsOf(handle, sessionId, type, limit) {
   return capped.map((event) => ({ ...event }))
 }
 
-/** 有审计事件的会话列表（按最后活动时间倒序，含事件数）。 */
+/** 有审计事件的会话列表（按最后活动时间倒序，含事件数与可读标题）。 */
 function sessionsOf(handle) {
   const entries = Object.entries(handle.store.state.bySession)
   const list = entries
@@ -142,12 +142,23 @@ function sessionsOf(handle) {
       sessionId,
       count: bucket.events.length,
       lastTime: bucket.events.length > 0 ? bucket.events[bucket.events.length - 1].time : 0,
+      title: sessionTitleOf(bucket),
     }))
     .filter((entry) => entry.count > 0)
   list.sort((a, b) => b.lastTime - a.lastTime)
   return list
 }
 
+/** 会话标题：最早一条 user_message 事件的文本（无则空串，面板回退 UUID 短显）。 */
+function sessionTitleOf(bucket) {
+  for (const event of bucket.events) {
+    if (event.type === 'user_message' && typeof event.data?.text === 'string' && event.data.text !== '') {
+      return event.data.text
+    }
+  }
+  return ''
+}
+
 /** 全部会话事件总数（O(1) 计数）。 */
 function countOf(handle) {
   return handle.total
@@ -270,7 +281,9 @@ function compactNow(handle) {
     })
 }
 
-/** 卸载冲刷：清定时器 + 回放未就绪缓冲 + 立即落盘（迁移兜底）。 */
+/** 卸载冲刷：清定时器 + 回放未就绪缓冲 + 立即落盘（迁移兜底）。
+ *  返回落盘链 promise：调用方 await 可保证冲刷完成（卸载/退出时事件
+ *  不丢）；fire-and-forget 调用亦兼容（触发后异步落盘）。 */
 function dispose(handle) {
   if (handle.flushTimer !== null) {
     clearTimeout(handle.flushTimer)
@@ -286,5 +299,5 @@ function dispose(handle) {
   }
   flushNow(handle)
   if (handle.migrated || handle.queuedLines >= COMPACT_LINES) compactNow(handle)
-  void handle.dirtyChain
+  return handle.dirtyChain
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-my-observability",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "DSH 可观测性 + Git 工程工具插件：会话轨迹回放（时间轴）、事件审计（agent 行为记录）、结构化 Git 提交（Conventional Commits）、增量 diff 审查（提交前审查）。DSH web plugin: trajectory replay timeline, event audit log, structured git commits, pre-commit incremental diff review.",
   "type": "module",
   "main": "lib/index.js",