@konnga/dsh-hud 0.8.0 → 0.9.1

package/lib/index.js

@@ -17,6 +17,13 @@
  *   - `diff { cwd, path, origPath? }` → 一个改动文件的**两侧** unified diff
  *     （工作区 / 已暂存），已解析成带行号的 rows；未跟踪文件与 `--no-index` 对齐，
  *     文本按行截断、行数有上限，二进制只报 `binary`。
+ *   - `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` 一致。
@@ -273,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 摘要）+（这个会话自己的改动计数）。
  *
@@ -281,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 }
   }
@@ -916,6 +1008,270 @@ export async function readCommitDiff(cwd, sha, file, origFile = null) {
   }
 }
 
+/* --------------------------------------------- 二进制预览（图片，只读） */
+
+/**
+ * 单侧图片预览的字节上限。
+ *
+ * 超限不等于"看不了这个改动"：仍然回报真实字节数，只是不把内容塞进 JSON
+ * （base64 还要再涨 1/3，RPC 体量必须有界）。
+ */
+export const MAX_IMAGE_BYTES = 4 * 1024 * 1024
+
+/** PNG 的签名（8 字节）。 */
+const PNG_SIGNATURE = Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a])
+
+/**
+ * 从**内容**而不是扩展名认图片类型（扩展名会骗人：`.png` 里放 gif 很常见）。
+ *
+ * @param buffer - 文件头若干字节。
+ * @returns MIME 字符串，认不出返回 null。
+ */
+export function sniffImageMime(buffer) {
+  if (!Buffer.isBuffer(buffer) || buffer.length < 12) return null
+  if (buffer.length >= 8 && buffer.subarray(0, 8).equals(PNG_SIGNATURE)) return 'image/png'
+  if (buffer[0] === 0xff && buffer[1] === 0xd8 && buffer[2] === 0xff) return 'image/jpeg'
+  const gif = buffer.subarray(0, 6).toString('latin1')
+  if (gif === 'GIF87a' || gif === 'GIF89a') return 'image/gif'
+  if (buffer.subarray(0, 4).toString('latin1') === 'RIFF' && buffer.subarray(8, 12).toString('latin1') === 'WEBP') return 'image/webp'
+  if (buffer.subarray(0, 2).toString('latin1') === 'BM') return 'image/bmp'
+  return null
+}
+
+/** PNG：IHDR 紧跟签名，宽高各 4 字节大端。 */
+function pngSize(buffer) {
+  if (buffer.length < 24) return null
+  return { width: buffer.readUInt32BE(16), height: buffer.readUInt32BE(20) }
+}
+
+/** GIF：逻辑屏幕描述符，宽高各 2 字节小端。 */
+function gifSize(buffer) {
+  if (buffer.length < 10) return null
+  return { width: buffer.readUInt16LE(6), height: buffer.readUInt16LE(8) }
+}
+
+/**
+ * JPEG：从头扫段，找 SOFn（C0–CF，但 C4/C8/CC 不是）里的高/宽。
+ *
+ * 段长字段是**含自身两字节**的长度，所以下一段起点是 `index + 2 + length`；
+ * 填充 0xFF、TEM 与 RSTn 都没有长度字段，只前进一字节。
+ */
+function jpegSize(buffer) {
+  let index = 2
+  while (index + 9 < buffer.length) {
+    if (buffer[index] !== 0xff) {
+      index += 1
+      continue
+    }
+    const marker = buffer[index + 1]
+    if (marker === 0xff || marker === 0x01 || (marker >= 0xd0 && marker <= 0xd9)) {
+      index += 1
+      continue
+    }
+    const isFrame = marker >= 0xc0 && marker <= 0xcf && marker !== 0xc4 && marker !== 0xc8 && marker !== 0xcc
+    if (isFrame) return { width: buffer.readUInt16BE(index + 7), height: buffer.readUInt16BE(index + 5) }
+    const length = buffer.readUInt16BE(index + 2)
+    if (length < 2) return null
+    index += 2 + length
+  }
+  return null
+}
+
+/** WebP：VP8X 是 24 位减一、VP8（有损）内嵌 14 位、VP8L（无损）打包在 32 位里。 */
+function webpSize(buffer) {
+  if (buffer.length < 30) return null
+  const chunk = buffer.subarray(12, 16).toString('latin1')
+  if (chunk === 'VP8X') return { width: buffer.readUIntLE(24, 3) + 1, height: buffer.readUIntLE(27, 3) + 1 }
+  if (chunk === 'VP8 ' && buffer[23] === 0x9d && buffer[24] === 0x01 && buffer[25] === 0x2a) {
+    return { width: buffer.readUInt16LE(26) & 0x3fff, height: buffer.readUInt16LE(28) & 0x3fff }
+  }
+  if (chunk === 'VP8L' && buffer[20] === 0x2f) {
+    const packed = buffer.readUInt32LE(21)
+    return { width: (packed & 0x3fff) + 1, height: ((packed >> 14) & 0x3fff) + 1 }
+  }
+  return null
+}
+
+/** BMP：BITMAPINFOHEADER 的宽为有符号、高可为负（自上而下）。 */
+function bmpSize(buffer) {
+  if (buffer.length < 26) return null
+  const width = buffer.readInt32LE(18)
+  const height = buffer.readInt32LE(22)
+  if (width <= 0 || height === 0) return null
+  return { width, height: Math.abs(height) }
+}
+
+/**
+ * 读出图片的像素尺寸。纯函数，只读头部，认不出返回 `null`（绝不抛）。
+ *
+ * @param buffer - 文件内容（头部足够即可，但这里拿的是完整内容）。
+ * @param mime - `sniffImageMime` 的结果。
+ * @returns `{ width, height }` 或 null。
+ */
+export function readImageSize(buffer, mime) {
+  try {
+    if (mime === 'image/png') return pngSize(buffer)
+    if (mime === 'image/jpeg') return jpegSize(buffer)
+    if (mime === 'image/gif') return gifSize(buffer)
+    if (mime === 'image/webp') return webpSize(buffer)
+    if (mime === 'image/bmp') return bmpSize(buffer)
+    return null
+  }
+  catch {
+    return null
+  }
+}
+
+/**
+ * `runGit` 的字节版。
+ *
+ * `cat-file blob` 的输出是任意二进制，按 utf8 解码会毁掉它（非法序列变成 U+FFFD，
+ * 再编码回去就不是原文件了），所以这条路径必须单独走 buffer 编码。
+ */
+function runGitBytes(cwd, args, maxBytes) {
+  return new Promise((resolve) => {
+    execFile(
+      'git',
+      args,
+      { cwd, timeout: GIT_TIMEOUT_MS, maxBuffer: maxBytes, windowsHide: true, encoding: 'buffer' },
+      (error, stdout, stderr) => {
+        if (!error) {
+          resolve({ ok: true, stdout })
+          return
+        }
+        resolve({
+          ok: false,
+          stdout,
+          stderr: stderr ? stderr.toString('utf8') : '',
+          killed: Boolean(error.killed) || Boolean(error.signal),
+          code: typeof error.code === 'number' ? error.code : (error.code ?? null),
+          message: error instanceof Error ? error.message : String(error),
+        })
+      },
+    )
+  })
+}
+
+/** 一个 git 对象的字节数；对象不存在（新文件还没有索引副本）返回 null。 */
+async function gitBlobSize(repoRoot, spec) {
+  const result = await runGit(repoRoot, ['cat-file', '-s', spec])
+  if (!result.ok) return null
+  const size = Number.parseInt(result.stdout.trim(), 10)
+  return Number.isFinite(size) && size >= 0 ? size : null
+}
+
+/** 判断一侧的内容：能预览就带上 base64 与像素尺寸，否则只说"为什么不能"。 */
+function describeSide(buffer) {
+  const bytes = buffer.length
+  const mime = sniffImageMime(buffer)
+  if (mime === null) return { kind: 'not-image', bytes }
+  const size = readImageSize(buffer, mime)
+  return {
+    kind: 'image',
+    mime,
+    bytes,
+    width: size === null ? null : size.width,
+    height: size === null ? null : size.height,
+    base64: buffer.toString('base64'),
+  }
+}
+
+/** 读工作区里的一个文件；不是普通文件、或超过上限，都只回报状态。 */
+async function readWorktreeSide(repoRoot, file) {
+  const full = path.resolve(repoRoot, file)
+  const rootPrefix = repoRoot.endsWith(path.sep) ? repoRoot : repoRoot + path.sep
+  // validateDiffPath 已经挡掉绝对路径与 `..`；这里再确认落在仓库内（软链接不越界）。
+  if (!full.startsWith(rootPrefix)) return { kind: 'missing' }
+  let stats
+  try {
+    stats = await fs.promises.stat(full)
+  }
+  catch {
+    return { kind: 'missing' }
+  }
+  if (!stats.isFile()) return { kind: 'missing' }
+  if (stats.size > MAX_IMAGE_BYTES) return { kind: 'too-large', bytes: stats.size, limit: MAX_IMAGE_BYTES }
+  try {
+    return describeSide(await fs.promises.readFile(full))
+  }
+  catch {
+    return { kind: 'missing' }
+  }
+}
+
+/** 读一个 git 对象（`<rev>:<path>`，rev 为空串即索引）：不存在即 missing，超限只回报字节数。 */
+async function readGitSide(repoRoot, rev, file) {
+  const spec = `${rev}:${file}`
+  const size = await gitBlobSize(repoRoot, spec)
+  if (size === null) return { kind: 'missing' }
+  if (size > MAX_IMAGE_BYTES) return { kind: 'too-large', bytes: size, limit: MAX_IMAGE_BYTES }
+  const result = await runGitBytes(repoRoot, ['cat-file', 'blob', spec], MAX_IMAGE_BYTES + 64 * 1024)
+  if (!result.ok) {
+    if (result.killed) throw Object.assign(new Error('git cat-file timed out'), { code: 'timeout' })
+    return { kind: 'missing' }
+  }
+  return describeSide(result.stdout)
+}
+
+/**
+ * 读一个二进制（图片）改动的两侧字节与像素尺寸，全部只读。
+ *
+ * `side` 与文本 diff 的两枚页签一一对应，这样"未暂存 / 已暂存"在两个视图里指的是同一件事：
+ *   - `worktree`（未暂存）：基线 = 索引 `:<path>`，新 = 工作区文件；
+ *   - `index`（已暂存）：基线 = `HEAD`，新 = 索引 `:<path>`；
+ *   - 给了 `sha`（提交明细）：基线 = 第一父提交（根提交则为空），新 = 该提交。
+ *
+ * 两侧各自回答"能不能预览"：`kind` 为 `image` / `too-large` / `not-image` / `missing`。
+ * 任一侧不可预览都不算失败 —— 另一侧照样能看。
+ *
+ * @param cwd - 会话工作区（绝对路径）。
+ * @param file - 仓库内相对路径。
+ * @param origFile - 重命名/复制的原路径，可选。
+ * @param side - `'worktree'` | `'index'`，给了 sha 时忽略。
+ * @param sha - 提交 sha（提交明细用），可选。
+ * @returns `{ repo, path, origPath, side, sha, before, after }`。
+ */
+export async function readImagePair(cwd, file, origFile = null, side = 'worktree', sha = null) {
+  const base = { path: file, origPath: origFile ?? null, side: sha === null ? side : 'commit', sha }
+  const empty = { repo: null, ...base, before: { kind: 'missing' }, after: { kind: 'missing' } }
+
+  if (sha !== null) {
+    const commit = await resolveCommit(cwd, sha)
+    if (!commit.repo) return empty
+    return {
+      repo: commit.repo,
+      shortSha: commit.shortSha,
+      ...base,
+      before: commit.base === null ? { kind: 'missing' } : await readGitSide(commit.repo, commit.base, origFile ?? file),
+      after: await readGitSide(commit.repo, commit.sha, file),
+    }
+  }
+
+  const root = await runGit(cwd, ['rev-parse', '--show-toplevel'])
+  if (!root.ok) {
+    if (root.killed) throw Object.assign(new Error('git rev-parse timed out'), { code: 'timeout' })
+    if (root.code === 'ENOENT' && !fs.existsSync(cwd)) throw Object.assign(new Error('cwd does not exist'), { code: 'no-cwd' })
+    if (root.code === 'ENOENT') throw Object.assign(new Error('git executable not found'), { code: 'git-missing' })
+    return empty
+  }
+
+  const repoRoot = root.stdout.split('\n')[0].trim()
+  if (side === 'index') {
+    return {
+      repo: repoRoot,
+      ...base,
+      before: await readGitSide(repoRoot, 'HEAD', origFile ?? file),
+      after: await readGitSide(repoRoot, '', file),
+    }
+  }
+  return {
+    repo: repoRoot,
+    ...base,
+    before: await readGitSide(repoRoot, '', origFile ?? file),
+    after: await readWorktreeSide(repoRoot, file),
+  }
+}
+
 /* ------------------------------------------------- 会话改动（按会话归因） */
 
 /**
@@ -1119,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) {
@@ -1587,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')
@@ -1598,6 +2012,8 @@ function trackSessionChanges(ctx) {
         }
         return () => {
           sessionTurnReader = null
+          sessionStatsReader = null
+          sessionOutlineReader = null
         }
       }))
     }
@@ -1638,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)
@@ -1655,6 +2085,36 @@ const ENDPOINTS = {
     return readDiff(cwd.value, file.value, origFile)
   },
 
+  /**
+   * 图片预览：一个二进制改动两侧的字节与像素尺寸。
+   *
+   * `diff` 对二进制只回一句 `binary: true`（文本 diff 里没有可看的东西），
+   * 浏览器半靠这个端点把"改了哪张图、尺寸变没变"画出来。只读，不写 index / 工作区。
+   */
+  async image(args) {
+    const input = args && typeof args === 'object' ? args : {}
+    const cwd = validateCwd(input.cwd)
+    if (!cwd.ok) throw Object.assign(new Error(cwd.message), { code: cwd.code })
+    const file = validateDiffPath(input.path)
+    if (!file.ok) throw Object.assign(new Error(file.message), { code: file.code })
+
+    let origFile = null
+    if (input.origPath !== undefined && input.origPath !== null && input.origPath !== '') {
+      const checked = validateDiffPath(input.origPath, 'origPath')
+      if (!checked.ok) throw Object.assign(new Error(checked.message), { code: checked.code })
+      origFile = checked.value
+    }
+
+    let sha = null
+    if (input.sha !== undefined && input.sha !== null && input.sha !== '') {
+      const checked = validateCommitSha(input.sha)
+      if (!checked.ok) throw Object.assign(new Error(checked.message), { code: checked.code })
+      sha = checked.value
+    }
+
+    return readImagePair(cwd.value, file.value, origFile, input.side === 'index' ? 'index' : 'worktree', sha)
+  },
+
   async log(args) {
     const input = args && typeof args === 'object' ? args : {}
     const cwd = validateCwd(input.cwd)
@@ -1860,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.8.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",