dsh-my-observability 0.1.6 → 0.1.7

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 本文件记录 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
 
 ### 变更

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,6 +16,19 @@
  */
 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 [
@@ -22,9 +37,53 @@ export function attachAuditListeners(ctx, 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：从每个会话真实用户的首条

package/lib/client.js

@@ -57,6 +57,9 @@ const strings = {
   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()
@@ -534,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,
 }
 
 /** 提取事件可用于关键词匹配的文本（工具名/参数摘要/错误信息/状态/阶段等）。 */
@@ -578,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
 }
 
@@ -738,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'
 }
 
@@ -758,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)
 }
@@ -812,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 || {}
@@ -819,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',
@@ -856,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',
@@ -1871,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}
@@ -1885,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

@@ -25,6 +25,9 @@ const strings = {
   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',

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

@@ -281,7 +281,9 @@ function compactNow(handle) {
     })
 }
 
-/** 卸载冲刷：清定时器 + 回放未就绪缓冲 + 立即落盘（迁移兜底）。 */
+/** 卸载冲刷：清定时器 + 回放未就绪缓冲 + 立即落盘（迁移兜底）。
+ *  返回落盘链 promise：调用方 await 可保证冲刷完成（卸载/退出时事件
+ *  不丢）；fire-and-forget 调用亦兼容（触发后异步落盘）。 */
 function dispose(handle) {
   if (handle.flushTimer !== null) {
     clearTimeout(handle.flushTimer)
@@ -297,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.6",
+  "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",