dsh-my-observability 0.1.6 → 0.3.0

package/CHANGELOG.md

@@ -2,6 +2,32 @@
 
 本文件记录 dsh-my-observability 的所有版本变更。格式遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [0.3.0] - 2026-09-07
+
+### 变更
+
+- feat(observability): #155 错误上报统一——plugin_error 事件类型 + /errors API (#177)
+- feat(observability): #155 资源监控扩展——新增 $DSH_HOME 目录总大小监控 (#176)
+- feat(observability): #155 插件状态查询聚合——统一 status-query 事件 + /plugin-status API (#170)
+- chore(plugins): #165 清理失效的 dsh.client.inject 声明（13 插件） (#167)
+
+## [0.2.0] - 2026-09-07
+
+### 变更
+
+- feat(observability): #155 错误上报统一——plugin_error 事件类型 + /errors API (#177)
+- feat(observability): #155 资源监控扩展——新增 $DSH_HOME 目录总大小监控 (#176)
+- feat(observability): #155 插件状态查询聚合——统一 status-query 事件 + /plugin-status API (#170)
+- chore(plugins): #165 清理失效的 dsh.client.inject 声明（13 插件） (#167)
+
+## [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,57 @@ 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
+  const { type, data } = buildPluginEventData(name, payload)
+  record({ type, sessionId, data })
+}
+
+function buildPluginEventData(name, payload) {
+  const data = {
+    plugin: pluginNameOf(name),
+    event: eventNameOf(name),
+    action: truncate(String(payload?.action ?? '')),
+    reason: truncate(String(payload?.reason ?? '')),
+    params: summarizeParams(payload),
+  }
+  const error = typeof payload?.error === 'string' && payload.error !== '' ? truncate(payload.error) : null
+  if (error !== null) data.error = error
+  return { type: error !== null ? 'plugin_error' : 'plugin_event', data }
+}
+
 /**
  * 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/resource-monitor.js

@@ -14,7 +14,9 @@
  * 采样自身开销：15s 一次 process.cpuUsage/memoryUsage + fs.stat（<0.01% CPU、
  * 零分配大对象），远低于「监控不能放大被监控对象」的护栏（resource-budget-review）。
  */
-import { statSync } from 'node:fs'
+import { statSync, readdirSync } from 'node:fs'
+import { join } from 'node:path'
+import { homedir } from 'node:os'
 import { evaluateResourceAlerts, shouldEnterDegrade, shouldExitDegrade, DEFAULT_LIMITS } from './resource-rules.js'
 import { jsonlFile } from './store-persist.js'
 
@@ -31,6 +33,7 @@ export function createResourceMonitor(ctx, options = {}) {
   const state = {
     timer: null,
     file: jsonlFile(),
+    dshHome: process.env.DSH_HOME || join(homedir(), '.dsh'),
     lastSample: null,
     lastCpu: process.cpuUsage(),
     history: [],
@@ -59,6 +62,12 @@ function sample(state, limits, onDegrade, onRecover) {
   } catch {
     // 审计文件尚未创建：字节为 0
   }
+  let homeBytes = 0
+  try {
+    homeBytes = dshHomeSize(state.dshHome)
+  } catch {
+    // $DSH_HOME 不可达
+  }
   const prev = state.lastSample
   if (prev !== null) {
     const deltaMs = Math.max(now - prev.time, 1)
@@ -66,7 +75,7 @@ function sample(state, limits, onDegrade, onRecover) {
     const cpuPercent = (cpuDelta / 1000 / deltaMs) * 100
     const byteDelta = fileBytes - prev.fileBytes
     const writeRateBytesPerHour = byteDelta > 0 ? (byteDelta / deltaMs) * 3600 * 1000 : 0
-    const sample = { time: now, cpuPercent, memoryBytes, fileBytes, writeRateBytesPerHour }
+    const sample = { time: now, cpuPercent, memoryBytes, fileBytes, writeRateBytesPerHour, homeBytes }
     state.history.push(sample)
     if (state.history.length > MAX_HISTORY) state.history.splice(0, state.history.length - MAX_HISTORY)
     state.lastSample = sample
@@ -78,7 +87,7 @@ function sample(state, limits, onDegrade, onRecover) {
       degraded: state.degraded,
     }
   }
-  state.lastSample = { time: now, fileBytes, memoryBytes, cpuPercent: 0, writeRateBytesPerHour: 0 }
+  state.lastSample = { time: now, fileBytes, memoryBytes, cpuPercent: 0, writeRateBytesPerHour: 0, homeBytes }
   return { ...state.lastSample, history: [...state.history], alerts: [], degraded: state.degraded }
 }
 
@@ -116,3 +125,25 @@ function stopMonitor(state) {
     state.timer = null
   }
 }
+
+/** 递归计算目录总字节（best-effort，跳过不可达文件）。 */
+function dshHomeSize(dir) {
+  let total = 0
+  try {
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+      const full = join(dir, entry.name)
+      if (entry.isDirectory()) {
+        total += dshHomeSize(full)
+      } else if (entry.isFile()) {
+        try {
+          total += statSync(full).size
+        } catch {
+          // 文件不可达
+        }
+      }
+    }
+  } catch {
+    // 目录不可达
+  }
+  return total
+}

package/lib/routes.js

@@ -67,6 +67,13 @@ function isMethod(method, request, name, verb) {
 
 /** 按 method 分派到具体 handler；未识别返回 false（调用方回 404）。 */
 async function dispatchMethod(method, request, response, url, ctx, store, monitor, options) {
+  const handled = await dispatchCore(method, request, response, url, ctx, store, monitor, options)
+  if (handled) return true
+  return dispatchExtended(method, request, response, url, ctx, store)
+}
+
+/** 核心路由（复杂度 ≤10）。 */
+async function dispatchCore(method, request, response, url, ctx, store, monitor, options) {
   if (isMethod(method, request, 'sessions', 'GET')) {
     writeJson(response, 200, { ok: true, value: store.sessions() })
     return true
@@ -105,6 +112,19 @@ async function dispatchMethod(method, request, response, url, ctx, store, monito
   return false
 }
 
+/** 扩展路由（#154/#155 新增）。 */
+function dispatchExtended(method, request, response, url, ctx, store) {
+  if (isMethod(method, request, 'plugin-status', 'GET')) {
+    void handlePluginStatus(ctx, response)
+    return true
+  }
+  if (isMethod(method, request, 'errors', 'GET')) {
+    handleErrors(store, url, response)
+    return true
+  }
+  return false
+}
+
 // ── handlers ───────────────────────────────────────────────────────────────
 
 /** 状态：审计统计 + 功能开关（aiReview 只暴露开关）。 */
@@ -117,6 +137,44 @@ function statusValue(store, options) {
   }
 }
 
+/**
+ * 插件状态聚合：广播 plugin:status-query 事件，收集所有插件状态。
+ * 每个插件返回 { plugin, config, running, lastActions }（config 脱敏，lastActions ≤5）。
+ * 超时 3s 未响应的插件标记为 { plugin, running: false, error: 'timeout' }。
+ */
+async function handlePluginStatus(ctx, response) {
+  const TIMEOUT_MS = 3000
+  const results = []
+  try {
+    // 广播查询事件，带超时
+    const statuses = await Promise.allSettled(
+      (ctx.bundler?.plugins ?? []).map(async (p) => {
+        const name = p.name ?? p.constructor?.name ?? 'unknown'
+        try {
+          const result = await Promise.race([
+            ctx.emit('plugin:status-query', { plugin: name }),
+            new Promise((_, reject) => setTimeout(() => reject(new Error('timeout')), TIMEOUT_MS)),
+          ])
+          return result ?? { plugin: name, running: true, config: {}, lastActions: [] }
+        } catch {
+          return { plugin: name, running: false, error: 'timeout' }
+        }
+      }),
+    )
+    for (const s of statuses) {
+      results.push(s.status === 'fulfilled' ? s.value : { plugin: 'unknown', running: false, error: 'rejected' })
+    }
+  } catch {
+    // bundler 不可用时返回空列表
+  }
+  writeJson(response, 200, { ok: true, value: results })
+}
+
+/** 错误事件查询（#155 错误上报统一）：返回 plugin_error 类型事件。 */
+function handleErrors(store, url, response) {
+  writeJson(response, 200, { ok: true, value: store.events(null, 'plugin_error', limitOf(url)) })
+}
+
 /** git status：非仓库路径 400。 */
 async function handleGitStatus(response, repoPath) {
   if (repoPath === '') {

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.3.0",
   "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",
@@ -37,10 +37,7 @@
       "patch": "./cordis.patch.yml"
     },
     "client": {
-      "platform": "web",
-      "inject": [
-        "@deepseek-ai/dsh-client-runtime"
-      ]
+      "platform": "web"
     }
   },
   "peerDependencies": {