dsh-my-observability 0.1.5 → 0.1.6

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 本文件记录 dsh-my-observability 的所有版本变更。格式遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [0.1.6] - 2026-09-04
+
+### 变更
+
+- fix(observability): 轨迹回放会话下拉可读标题（首条用户消息）——此前只展示 UUID 清单
+
 ## [0.1.5] - 2026-09-04
 
 ### 变更

package/lib/audit.js

@@ -17,6 +17,7 @@ import { MAX_ARG_KEYS, MAX_TEXT_LEN } from './constants.js'
 /** 注册全部审计监听；返回 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)),
@@ -24,6 +25,43 @@ export function attachAuditListeners(ctx, record) {
   ]
 }
 
+/**
+ * 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,6 +50,9 @@ 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'),
@@ -907,6 +910,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 +940,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 +1067,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 +1105,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 +1412,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)

package/lib/parts/i18n.js

@@ -18,6 +18,9 @@ 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'),

package/lib/parts/replay.js

@@ -194,6 +194,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 +224,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/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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-my-observability",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "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",