@konnga/dsh-hud 0.9.0 → 0.9.1

package/lib/index.js

@@ -20,6 +20,10 @@
  *   - `image { cwd, path, origPath?, side?, sha? }` → 图片改动**两侧**的字节与像素尺寸
  *     （`kind` 为 `image` / `too-large` / `not-image` / `missing`），给二进制预览用；
  *     单侧上限 `MAX_IMAGE_BYTES`，超限只回报字节数。
+ *   - `session-time { sessionId }` → 该会话的创建时刻与累计墙钟（`llmMs` / `toolMs` /
+ *     `turns` / `steps`，来自内置 `sessionStats` 投影；服务缺失时 `available: false`）。
+ *   - `prompt-history { sessionId, limit? }` → 该会话的用户 prompt（**新的在前**，来自内置
+ *     `turnOutline` 投影；相邻重复只留一条，默认最多 100 条）。
  *   - `log { cwd, count? }` → 最近提交（短 sha、作者、日期、refs、标题），条数钳制 1..50。
  *   - `commit { cwd, sha }` → 某次提交的元信息与改动清单（相对**第一个父提交**，
  *     合并提交也按第一父提交看），清单形状与 `status.changes` 一致。
@@ -276,6 +280,90 @@ export async function readStatus(cwd) {
 /** 一次最多看多少个工作区（多个会话可能共用一个目录，按目录去重之后再算）。 */
 const ROW_STATUS_MAX_WORKTREES = 8
 
+/**
+ * 一个会话的用户 prompt 历史，**新的在前**（给输入框的 `↑` 召回用）。
+ *
+ * 来源是内置 `turnOutline` 投影的每条 `prompt` —— 也就是会话日志里真正的用户消息，
+ * 不是我们自己记的一份。截断到 `limit` 条，相邻重复（同一句连发两次）只留一条。
+ * 投影没注册、会话不在（还没恢复进存储 / 已归档）时回 `available: false` 与空列表。
+ *
+ * @param sessionId - 会话 id。
+ * @param limit - 最多返回多少条（1..200，默认 {@link PROMPT_HISTORY_MAX}）。
+ */
+export function readPromptHistory(sessionId, limit = PROMPT_HISTORY_MAX) {
+  const empty = { available: false, sessionId, prompts: [] }
+  if (typeof sessionId !== 'string' || sessionId.length === 0) return empty
+  const max = typeof limit === 'number' && Number.isFinite(limit) ? Math.min(200, Math.max(1, Math.trunc(limit))) : PROMPT_HISTORY_MAX
+
+  const sessionStore = sessionsService()
+  if (sessionStore === null) return empty
+  let live = []
+  try {
+    live = sessionStore.list()
+  } catch {
+    return empty
+  }
+  const session = live.find(item => item && item.header && item.header.id === sessionId)
+  if (session === undefined) return empty
+
+  const outline = sessionOutlineReader === null ? null : sessionOutlineReader(session)
+  const turns = outline !== null && Array.isArray(outline.turns) ? outline.turns : null
+  if (turns === null) return empty
+
+  const prompts = []
+  for (let index = turns.length - 1; index >= 0 && prompts.length < max; index -= 1) {
+    const turn = turns[index]
+    const raw = turn && typeof turn.prompt === 'string' ? turn.prompt.trim() : ''
+    if (raw.length === 0) continue
+    if (prompts.length > 0 && prompts[prompts.length - 1] === raw) continue
+    prompts.push(raw)
+  }
+  return { available: true, sessionId, prompts }
+}
+
+/**
+ * 一个会话的"运行时长"事实：创建时刻 + 内置 `sessionStats` 的累计数字。
+ *
+ * 与 codex-hud 的会话时长口径一致：**挂钟时长 = 现在 − 会话创建时刻**（含等待与空闲），
+ * 另外把"真的在干活"的两段（模型墙钟 `llmMs`、工具墙钟 `toolMs`）一并给出，让胶囊的悬停
+ * 能说清"74 小时里其实只有 1 小时 52 分在跑"。
+ *
+ * 只读；`sessions` 服务没到齐或会话已不在（归档、子会话已回收）时回 `available: false`，
+ * 客户端据此不画这枚胶囊。
+ *
+ * @param sessionId - 会话 id。
+ * @returns `{ available, sessionId, createdAt, turns, steps, llmMs, toolMs, now }`。
+ */
+export function readSessionTime(sessionId) {
+  const now = Date.now()
+  const empty = { available: false, sessionId, createdAt: null, turns: null, steps: null, llmMs: null, toolMs: null, now }
+  if (typeof sessionId !== 'string' || sessionId.length === 0) return empty
+
+  const sessionStore = sessionsService()
+  if (sessionStore === null) return empty
+  let live = []
+  try {
+    live = sessionStore.list()
+  } catch {
+    return empty
+  }
+  const session = live.find(item => item && item.header && item.header.id === sessionId)
+  if (session === undefined) return empty
+
+  const createdAt = typeof session.header.createdAt === 'number' ? session.header.createdAt : null
+  const stats = sessionStatsReader === null ? null : sessionStatsReader(session)
+  return {
+    available: true,
+    sessionId,
+    createdAt,
+    turns: stats === null ? null : stats.turns,
+    steps: stats === null ? null : stats.steps,
+    llmMs: stats === null ? null : stats.llmMs,
+    toolMs: stats === null ? null : stats.toolMs,
+    now,
+  }
+}
+
 /**
  * 会话一览：每个活着的会话 → （它那个工作区的 git 摘要）+（这个会话自己的改动计数）。
  *
@@ -284,10 +372,11 @@ const ROW_STATUS_MAX_WORKTREES = 8
  * 不用再问 git）。**不返回 `changes`**：这一行只要摘要，别把清单也拖过来。
  */
 export async function readSessionOverview() {
-  if (hostSessions === null) return { sessions: [], unavailable: true, truncated: false, worktrees: 0 }
+  const sessionStore = sessionsService()
+  if (sessionStore === null) return { sessions: [], unavailable: true, truncated: false, worktrees: 0 }
   let live = []
   try {
-    live = hostSessions.list()
+    live = sessionStore.list()
   } catch {
     return { sessions: [], unavailable: true, truncated: false, worktrees: 0 }
   }
@@ -1386,11 +1475,46 @@ const pendingChangeIntents = new Map()
  * 归因照常工作 —— 绝不因为少一个服务把整块降级掉。
  */
 let sessionTurnReader = null
+/**
+ * `sessionStats` 投影的读数器（内置 `@deepseek-ai/dsh-session-stats` 提供）。
+ *
+ * 会话计时胶囊要的是"这个会话跑了多久、模型/工具各占多少"—— 这些正是它的字段，
+ * 而且是**从完整持久日志折叠**出来的，分页/压实都不会让数字跳变。
+ * 同样是软依赖：这个键没注册（插件没装/被组合掉）就回 null，胶囊只显示挂钟时长。
+ */
+let sessionStatsReader = null
+/**
+ * `turnOutline` 投影的读数器：每条 turn 都带着原始 `prompt`。
+ *
+ * 这是 prompt 历史最好的来源 —— 比在客户端自己记一份可靠：分页、压实、重启、换设备都不影响，
+ * 因为它就是会话日志折叠出来的。同样是软依赖（投影没注册就回 null，功能整个不启用）。
+ */
+let sessionOutlineReader = null
+
+/** prompt 历史的条数上限（与客户端的 `↑` 召回共用这一个数）。 */
+export const PROMPT_HISTORY_MAX = 100
 /**
  * 宿主 `sessions` 服务（枚举所有活着的会话）—— 同样是软依赖：拿不到时
  * `session-statuses` 端点报"不可用"，侧栏那枚 chip 就不画，其余功能照旧。
  */
 let hostSessions = null
+/**
+ * 宿主 ctx 的引用。用于**兜底**取 `sessions`：注入回调没到齐、或者被别的挂载实例的
+ * 卸载清掉时（模块级状态 + 每个挂载各自 return 清理，本来就有这个缝），
+ * 按内置契约用 `ctx.get("sessions")` 再问一次（Service 目录里写明的可选取法）。
+ */
+let hostContext = null
+
+/** 会话服务：先信注入给的那份，再按契约兜底问 ctx。两个调用方共用这一处。 */
+function sessionsService() {
+  if (hostSessions !== null) return hostSessions
+  try {
+    const fallback = hostContext !== null && typeof hostContext.get === 'function' ? hostContext.get('sessions') : undefined
+    return fallback === undefined ? null : fallback
+  } catch {
+    return null
+  }
+}
 
 /** 这次调用发生在第几回合（拿不到就是 null，界面据此不显示回合信息）。 */
 function currentTurnOf(exec) {
@@ -1854,6 +1978,29 @@ function trackSessionChanges(ctx) {
         }))
       }
       stops.push(ctx.inject(['sessionProjections'], (scope) => {
+        sessionOutlineReader = (session) => {
+          try {
+            const state = scope.sessionProjections.stateOf(session, 'turnOutline')
+            return state === undefined || state === null ? null : state
+          } catch {
+            return null
+          }
+        }
+        sessionStatsReader = (session) => {
+          try {
+            const state = scope.sessionProjections.stateOf(session, 'sessionStats')
+            if (state === undefined || state === null) return null
+            const num = value => (typeof value === 'number' && Number.isFinite(value) ? value : 0)
+            return {
+              turns: num(state.turns),
+              steps: num(state.steps),
+              llmMs: num(state.llmMs),
+              toolMs: num(state.toolMs),
+            }
+          } catch {
+            return null
+          }
+        }
         sessionTurnReader = (session) => {
           try {
             const state = scope.sessionProjections.stateOf(session, 'turnBoundary')
@@ -1865,6 +2012,8 @@ function trackSessionChanges(ctx) {
         }
         return () => {
           sessionTurnReader = null
+          sessionStatsReader = null
+          sessionOutlineReader = null
         }
       }))
     }
@@ -1905,6 +2054,20 @@ const ENDPOINTS = {
     return readSessionOverview()
   },
 
+  /** 一个会话的 prompt 历史（新的在前）—— 给输入框的 `↑` 召回用。 */
+  async 'prompt-history'(args) {
+    const input = args && typeof args === 'object' ? args : {}
+    const sessionId = typeof input.sessionId === 'string' && input.sessionId.length > 0 ? input.sessionId : null
+    return readPromptHistory(sessionId, input.limit)
+  },
+
+  /** 一个会话的运行时长（挂钟 + 模型/工具墙钟）—— 给会话计时胶囊用。 */
+  async 'session-time'(args) {
+    const input = args && typeof args === 'object' ? args : {}
+    const sessionId = typeof input.sessionId === 'string' && input.sessionId.length > 0 ? input.sessionId : null
+    return readSessionTime(sessionId)
+  },
+
   async diff(args) {
     const input = args && typeof args === 'object' ? args : {}
     const cwd = validateCwd(input.cwd)
@@ -2157,6 +2320,7 @@ async function handleRequest(ctx, req, res) {
  * @param ctx - 已注入 webServer 与 connection 的 Cordis 上下文。
  */
 export function apply(ctx) {
+  hostContext = ctx
   trackSessionChanges(ctx)
   ctx.effect(() => ctx.webServer.register({
     kind: 'prefix',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@konnga/dsh-hud",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "DeepSeek Harness 的只读工作区 Git 面板：分支、ahead/behind、改动清单与差异，外加「这个会话改过哪些文件、审到哪了、跑了什么工具」。A read-only workspace Git panel for DeepSeek Harness — branch, changed files, diffs, plus per-session change attribution, review progress, and tool activity.",
   "type": "module",
   "main": "lib/index.js",
@@ -13,6 +13,7 @@
     "lib",
     "cordis.patch.yml",
     "README.md",
+    "README.en.md",
     "LICENSE",
     "docs/images"
   ],
@@ -33,7 +34,15 @@
     "review",
     "sidebar",
     "floating-panel",
-    "web-gui"
+    "web-gui",
+    "deepseek",
+    "diff",
+    "image-diff",
+    "session-timer",
+    "prompt-history",
+    "review-progress",
+    "tool-activity",
+    "dock"
   ],
   "license": "MIT",
   "author": "konnga",