@caozeal/dsh-next-git 0.0.0-stage → 0.1.0

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Git Manager",
+    "description": "Sidebar Git panel: switch branches, stage changes, commit / push / pull, AI commit messages, commit graph and diffs."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Git 管理",
+    "description": "侧边栏 Git 面板：分支切换、变更暂存、提交 / 推送 / 拉取、AI 生成提交信息、提交图与 diff 查看。"
+  }
+}

package/package.json

@@ -1,6 +1,70 @@
 {
   "name": "@caozeal/dsh-next-git",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "DSH Git 管理插件：分支切换、变更暂存、提交/推送/拉取、AI 提交信息、提交图与 diff 查看",
+  "type": "module",
+  "main": "index.js",
+  "exports": {
+    ".": "./index.js",
+    "./client": "./lib/client.js",
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./icon.svg",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "index.js",
+    "src",
+    "lib/client.js",
+    "cordis.patch.yml",
+    "locale/*.json",
+    "icon.svg",
+    "icon.png"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "immediately": true,
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-renderer",
+        "@deepseek-ai/dsh-api-session-controller",
+        "@deepseek-ai/dsh-client-ui-layout",
+        "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-sidebar-right",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-sidebar"
+      ]
+    }
+  },
+  "scripts": {
+    "test": "node --test test/*.test.mjs"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/caozeal/dsh-plugins.git",
+    "directory": "dsh-next-git"
+  },
+  "homepage": "https://github.com/caozeal/dsh-plugins/tree/main/dsh-next-git#readme",
+  "bugs": {
+    "url": "https://github.com/caozeal/dsh-plugins/issues"
+  },
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "deepseek",
+    "plugin",
+    "bundle",
+    "git",
+    "web-ui"
+  ],
+  "author": "caozeal",
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/ai-commit.js

@@ -0,0 +1,194 @@
+/**
+ * git-manager — AI 提交信息生成。
+ *
+ * 流程：收集「已暂存 diff（为空则工作区 diff）→ 最近提交风格 → 调用默认模型的
+ * llm.stream」→ 清理成一行提交信息。任何一步不可用都退回确定性文案（fallback），
+ * 让面板始终能拿到一个可编辑的建议。
+ */
+import { GitError } from './git.js'
+
+const MAX_DIFF_CHARS = 12000
+/** 单次生成的 token 预算：reasoning 模型会先消耗思考 token，200 太小容易截断。 */
+const MAX_OUTPUT_TOKENS = 600
+
+const SYSTEM_PROMPT = [
+  '你是一个 Git 提交信息生成器。',
+  '只输出一行提交信息，不要解释、不要代码块、不要引号、不要句号结尾。',
+  '使用 Conventional Commits 风格（如 feat:/fix:/refactor:/docs:/chore:），',
+  '不超过 72 个字符。跟随仓库最近提交的语言：最近提交多为中文就用中文，否则用英文。',
+].join('')
+
+/** 从 diff 与最近提交构造 user prompt。 */
+function buildPrompt({ diff, files, recent, hint }) {
+  const parts = []
+  if (recent.length > 0) {
+    parts.push('最近提交（仅作风格参考）：', ...recent.slice(0, 8).map((line) => `- ${line}`), '')
+  }
+  if (files.length > 0) {
+    parts.push('变更文件：', ...files.slice(0, 60).map((file) => `- ${file}`), '')
+  }
+  if (hint) parts.push(`用户补充说明：${hint}`, '')
+  parts.push('待提交的 diff：', '```diff', diff.slice(0, MAX_DIFF_CHARS), '```')
+  return parts.join('\n')
+}
+
+/** 清理模型输出为一行提交信息。 */
+export function sanitizeSubject(text) {
+  let value = String(text ?? '')
+  value = value.replace(/```[a-zA-Z]*/g, ' ')
+  const lines = value
+    .split('\n')
+    .map((line) => line.trim())
+    .filter((line) => line !== '')
+  let subject = lines[0] ?? ''
+  subject = subject.replace(/^(commit message|提交信息)\s*[:：]\s*/i, '')
+  subject = subject.replace(/^["'`“”]+|["'`“”]+$/g, '')
+  subject = subject.replace(/\s+/g, ' ').trim()
+  if (subject.length > 100) subject = subject.slice(0, 100).trim()
+  return subject
+}
+
+/** 最近提交是否以中文为主。 */
+function looksChinese(subjects) {
+  const joined = subjects.join('')
+  if (!joined) return false
+  const cjk = (joined.match(/[\u4e00-\u9fff]/g) || []).length
+  return cjk >= Math.max(1, Math.floor(joined.length * 0.2))
+}
+
+const CONVENTIONAL = /^(feat|fix|docs|style|refactor|perf|test|build|ci|chore|revert)(\([^()]+\))?!?\s*[:：]\s*\S/i
+
+/**
+ * 判断模型输出是否是一条可用的提交信息。
+ * 模型偶发会被 reasoning token 挤掉、只吐出 `fix:` 或半句话；这种输出比降级文案
+ * 更糟（用户会拿到不可提交的标题），因此宁可回退到确定性文案。
+ * @param {string} subject 清理后的一行文本
+ * @returns {boolean}
+ */
+export function looksLikeSubject(subject) {
+  if (typeof subject !== 'string') return false
+  const value = subject.trim()
+  if (value.length < 8) return false
+  if (!CONVENTIONAL.test(value)) return false
+  // 以标点/连接词结尾 = 半句话。
+  if (/[，,、；;：:（(「『"'`+\-–—]$/.test(value)) return false
+  if (/(并|和|与|及|或|然后|以及|并且|同时)$/.test(value)) return false
+  const opens = (value.match(/（|\(/g) || []).length
+  const closes = (value.match(/）|\)/g) || []).length
+  if (opens !== closes) return false
+  return true
+}
+
+/** 确定性降级文案：根据变更文件数量生成一行。 */
+export function fallbackSubject({ files, stagedCount, Chinese }) {
+  const count = files.length
+  const verb = stagedCount > 0 ? '提交' : '更新'
+  if (Chinese) {
+    if (count === 0) return 'chore: 空提交'
+    if (count === 1) return `chore: ${verb} ${files[0]}`
+    return `chore: ${verb} ${count} 个文件`
+  }
+  if (count === 0) return 'chore: empty commit'
+  if (count === 1) return `chore: update ${files[0]}`
+  return `chore: update ${count} files`
+}
+
+/**
+ * 生成一条提交信息。
+ * @param {{
+ *   runGit: (args: string[], options?: object) => Promise<{stdout: string, stderr: string, code?: number|null}>,
+ *   cwd: string,
+ *   hint?: string,
+ *   files?: string[],
+ *   stagedCount?: number,
+ *   signal?: AbortSignal,
+ *   llm?: unknown,
+ *   selection?: {provider?: string, model?: string, reasoningEffort?: string},
+ * }} options
+ * @returns {Promise<{message: string, model: string|null, fallback: boolean}>}
+ */
+export async function generateCommitMessage(options) {
+  const {
+    runGit,
+    cwd,
+    hint = '',
+    signal,
+    llm,
+    selection,
+    files = [],
+    stagedCount = 0,
+  } = options
+
+  const staged = await runGit(['diff', '--cached', '--no-color'], { cwd, signal, allowFailure: true })
+  let diff = staged.stdout
+  if (!diff.trim()) {
+    const worktree = await runGit(['diff', '--no-color'], { cwd, signal, allowFailure: true })
+    diff = worktree.stdout
+  }
+  const recentRaw = await runGit(['log', '-8', '--pretty=format:%s'], { cwd, signal, allowFailure: true })
+  const recent = String(recentRaw.stdout || '').split('\n').map((line) => line.trim()).filter(Boolean)
+
+  let changedFiles = files
+  if (changedFiles.length === 0) {
+    const statusRaw = await runGit(['status', '--porcelain'], { cwd, signal, allowFailure: true })
+    changedFiles = String(statusRaw.stdout || '')
+      .split('\n')
+      .map((line) => line.slice(3).trim())
+      .filter(Boolean)
+  }
+
+  const chinese = looksChinese(recent)
+  const model = selection && selection.provider && selection.model
+    ? `${selection.provider}/${selection.model}`
+    : null
+
+  const canUseLlm = Boolean(llm && selection && selection.provider && selection.model && diff.trim())
+  if (!canUseLlm) {
+    return {
+      message: fallbackSubject({ files: changedFiles, stagedCount, Chinese: chinese }),
+      model,
+      fallback: true,
+    }
+  }
+
+  const prompt = buildPrompt({ diff, files: changedFiles, recent, hint })
+  let text = ''
+  try {
+    const stream = llm.stream({
+      provider: selection.provider,
+      model: selection.model,
+      reasoningEffort: selection.reasoningEffort,
+      system: SYSTEM_PROMPT,
+      messages: [{ role: 'user', content: [{ type: 'text', text: prompt }] }],
+      maxTokens: MAX_OUTPUT_TOKENS,
+      temperature: 0.2,
+      signal,
+    })
+    for await (const chunk of stream) {
+      if (chunk.type === 'text-delta') text += chunk.text
+      if (chunk.type === 'finish') {
+        const kind = chunk.reason && chunk.reason.kind
+        if (kind === 'error' || kind === 'aborted') {
+          const failure = chunk.reason.failure
+          throw new GitError(`模型生成失败：${failure && failure.message ? failure.message : kind}`, {
+            code: 'ai-unavailable',
+          })
+        }
+      }
+    }
+  } catch (error) {
+    if (error instanceof GitError) throw error
+    const message = error && error.message ? error.message : String(error)
+    throw new GitError(`模型生成失败：${message}`, { code: 'ai-unavailable' })
+  }
+
+  const subject = sanitizeSubject(text)
+  if (!looksLikeSubject(subject)) {
+    return {
+      message: fallbackSubject({ files: changedFiles, stagedCount, Chinese: chinese }),
+      model,
+      fallback: true,
+    }
+  }
+  return { message: subject, model, fallback: false }
+}

package/src/git.js

@@ -0,0 +1,399 @@
+/**
+ * git-manager — git 进程执行与输出解析。
+ *
+ * 本模块只做两件事：
+ *   1. 提供 `cleanGitEnv` 与 `GitError`，由 Host 入口负责真正 spawn 进程；
+ *   2. 把 git 的文本输出解析成面板所需的纯 JSON（全部是纯函数，可单测）。
+ *
+ * 约定：所有解析函数都不抛异常（除 GitError 之外），坏行直接跳过。
+ */
+
+/** 一次 git 失败（非 0 退出、超时或解析前置失败）。 */
+export class GitError extends Error {
+  /**
+   * @param {string} message 人类可读信息（含 stderr 摘要）。
+   * @param {{code?: string, stderr?: string, stdout?: string, exitCode?: number|null}} [detail]
+   */
+  constructor(message, detail = {}) {
+    super(message)
+    this.name = 'GitError'
+    this.code = detail.code ?? 'git-failed'
+    this.stderr = detail.stderr ?? ''
+    this.stdout = detail.stdout ?? ''
+    this.exitCode = detail.exitCode ?? null
+  }
+}
+
+/**
+ * 构造子进程环境：去掉本机会话里损坏的 GIT_CONFIG_* 变量，并固定非交互行为。
+ *
+ * 注意：Host 的 subprocess provider 会把显式 env **合并**到父进程环境之上，
+ * 因此「删除」一个继承变量必须传 `undefined` 墓碑值（provider 文档明确支持），
+ * 不能只是不写这个键——否则父进程里那组损坏的 GIT_CONFIG_COUNT（有 COUNT、
+ * 缺 KEY）会原样带进子进程，git 直接 fatal `missing config key GIT_CONFIG_KEY_0`。
+ *
+ * @param {NodeJS.ProcessEnv} [env]
+ * @returns {NodeJS.ProcessEnv} 带 undefined 墓碑的环境补丁
+ */
+export function cleanGitEnv(env = process.env) {
+  /** @type {NodeJS.ProcessEnv} */
+  const out = {}
+  for (const [key, value] of Object.entries(env)) {
+    if (key === 'GIT_CONFIG_COUNT' || /^GIT_CONFIG_(KEY|VALUE)_\d+$/.test(key)) {
+      out[key] = undefined
+      continue
+    }
+    if (value !== undefined) out[key] = value
+  }
+  // 无论父环境有什么，都显式清掉可能存在的配置注入槽位。
+  for (let index = 0; index < 16; index += 1) {
+    out[`GIT_CONFIG_KEY_${index}`] = undefined
+    out[`GIT_CONFIG_VALUE_${index}`] = undefined
+  }
+  out.GIT_CONFIG_COUNT = undefined
+  out.GIT_TERMINAL_PROMPT = '0'
+  out.GIT_PAGER = 'cat'
+  out.GIT_OPTIONAL_LOCKS = '0'
+  // 固定英文输出，让下面的解析不依赖 locale。
+  out.LC_ALL = 'C'
+  out.LANG = 'C'
+  return out
+}
+
+/** 把 stderr 压成一行短消息。 */
+function brief(text, max = 2000) {
+  const trimmed = String(text || '').trim()
+  if (trimmed.length <= max) return trimmed
+  return `${trimmed.slice(0, max)}…`
+}
+
+/**
+ * 由一次 exec 结果构造 GitError。
+ * @param {string[]} argv
+ * @param {{code: number|null, stdout: string, stderr: string}} result
+ */
+export function gitFailure(argv, result) {
+  const detail = [result.stdout, result.stderr].filter(Boolean).join('\n').trim()
+  const command = argv.join(' ')
+  return new GitError(
+    `git ${argv[0] === 'git' ? argv.slice(1).join(' ') : command} 失败：${brief(detail) || '无输出'}`,
+    { code: 'git-failed', stderr: result.stderr, stdout: result.stdout, exitCode: result.code },
+  )
+}
+
+/**
+ * 解析 `git status --porcelain=v1 -z --branch` 输出。
+ * @param {string} raw
+ * @returns {{branchLine: string|null, entries: Array<{x: string, y: string, path: string, oldPath: string|null}>}}
+ */
+export function parsePorcelain(raw) {
+  const text = String(raw ?? '')
+  const parts = text.split('\0')
+  /** @type {string|null} */
+  let branchLine = null
+  /** @type {Array<{x: string, y: string, path: string, oldPath: string|null}>} */
+  const entries = []
+  for (let i = 0; i < parts.length; i += 1) {
+    const record = parts[i]
+    if (!record) continue
+    if (record.startsWith('## ')) {
+      branchLine = record.slice(3)
+      continue
+    }
+    if (record.length < 3) continue
+    const x = record[0]
+    const y = record[1]
+    let path = record.slice(3)
+    /** @type {string|null} */
+    let oldPath = null
+    // porcelain v1 -z：重命名/复制状态下，下一段记录是原路径。
+    if (x === 'R' || x === 'C' || y === 'R' || y === 'C') {
+      const next = parts[i + 1]
+      if (next !== undefined) {
+        oldPath = next
+        i += 1
+      }
+    }
+    // -z 模式下路径原样输出；去掉可能存在的尾部空格没有意义，保持原值。
+    entries.push({ x, y, path, oldPath })
+  }
+  return { branchLine, entries }
+}
+
+/**
+ * 解析 `--porcelain --branch` 的分支头。
+ * 例：`main...origin/main [ahead 1, behind 2]`、`HEAD (no branch)`。
+ * @param {string|null} line
+ * @returns {{branch: string|null, upstream: string|null, upstreamGone: boolean, ahead: number, behind: number, detached: boolean, noCommits: boolean}}
+ */
+export function parseBranchHeader(line) {
+  const out = {
+    branch: null,
+    upstream: null,
+    upstreamGone: false,
+    ahead: 0,
+    behind: 0,
+    detached: false,
+    noCommits: false,
+  }
+  if (!line) return out
+  if (line.startsWith('HEAD (no branch)') || line.startsWith('HEAD (detached')) {
+    out.detached = true
+    return out
+  }
+  const noCommits = /^No commits yet on (.+)$/.exec(line)
+  if (noCommits) {
+    out.branch = noCommits[1]
+    out.noCommits = true
+    return out
+  }
+  if (line.startsWith('Initial commit on ')) {
+    out.branch = line.slice('Initial commit on '.length).trim()
+    out.noCommits = true
+    return out
+  }
+  let head = line
+  const bracket = line.indexOf(' [')
+  if (bracket !== -1) {
+    const track = line.slice(bracket + 2, line.lastIndexOf(']'))
+    head = line.slice(0, bracket)
+    const ahead = /ahead (\d+)/.exec(track)
+    const behind = /behind (\d+)/.exec(track)
+    out.ahead = ahead ? Number(ahead[1]) : 0
+    out.behind = behind ? Number(behind[1]) : 0
+    if (track.includes('gone')) out.upstreamGone = true
+  }
+  const dots = head.indexOf('...')
+  if (dots === -1) {
+    out.branch = head.trim() || null
+    return out
+  }
+  out.branch = head.slice(0, dots).trim() || null
+  out.upstream = head.slice(dots + 3).trim() || null
+  if (out.upstream === '') out.upstream = null
+  return out
+}
+
+/**
+ * 把 porcelain 条目分类成面板的四组。
+ * @param {Array<{x: string, y: string, path: string, oldPath?: string|null}>} entries
+ */
+export function classifyEntries(entries) {
+  /** @type {{staged: Array<object>, unstaged: Array<object>, untracked: Array<object>, conflicted: Array<object>}} */
+  const out = { staged: [], unstaged: [], untracked: [], conflicted: [] }
+  for (const entry of entries) {
+    const { x, y } = entry
+    const item = {
+      path: entry.path,
+      status: x === '?' ? '?' : x,
+      oldPath: entry.oldPath ?? null,
+    }
+    const unmerged = x === 'U' || y === 'U' || (x === 'A' && y === 'A') || (x === 'D' && y === 'D')
+    if (unmerged) {
+      out.conflicted.push({ ...item, status: `${x}${y}` })
+      continue
+    }
+    if (x === '?' && y === '?') {
+      out.untracked.push({ ...item, status: '?' })
+      continue
+    }
+    if (x !== ' ' && x !== '?') out.staged.push({ ...item, status: x })
+    if (y !== ' ' && y !== '?') {
+      out.unstaged.push({ ...item, status: y })
+    }
+  }
+  return out
+}
+
+/**
+ * 解析 `git for-each-ref` 的 `%00` 分隔记录。
+ * @param {string} raw
+ * @returns {Array<object>}
+ */
+export function parseBranches(raw) {
+  /** @type {Array<object>} */
+  const branches = []
+  for (const line of String(raw ?? '').split('\n')) {
+    if (!line.trim()) continue
+    const fields = line.split('\0')
+    if (fields.length < 6) continue
+    const [refname, name, commit, upstream, track, date] = fields
+    const subject = fields.slice(6).join('\0').trim()
+    if (!refname || !name) continue
+    const kind = refname.startsWith('refs/heads/') ? 'local' : refname.startsWith('refs/remotes/') ? 'remote' : null
+    if (!kind) continue
+    if (kind === 'remote' && name.endsWith('/HEAD')) continue
+    const { ahead, behind, gone } = parseTrack(track)
+    branches.push({
+      name,
+      kind,
+      current: false,
+      upstream: upstream || null,
+      ahead,
+      behind,
+      gone,
+      commit: commit || '',
+      subject,
+      date: date || '',
+    })
+  }
+  return branches
+}
+
+/** 解析 `%(upstream:track)` 的 `[ahead 1, behind 2]` / `[gone]`。 */
+export function parseTrack(track) {
+  const out = { ahead: 0, behind: 0, gone: false }
+  if (!track) return out
+  if (track.includes('gone')) out.gone = true
+  const ahead = /ahead (\d+)/.exec(track)
+  const behind = /behind (\d+)/.exec(track)
+  if (ahead) out.ahead = Number(ahead[1])
+  if (behind) out.behind = Number(behind[1])
+  return out
+}
+
+/**
+ * 解析 `git remote -v`。
+ * @param {string} raw
+ * @returns {Array<{name: string, url: string}>}
+ */
+export function parseRemotes(raw) {
+  /** @type {Map<string, string>} */
+  const byName = new Map()
+  for (const line of String(raw ?? '').split('\n')) {
+    const match = /^(\S+)\s+(\S+)\s+\((fetch|push)\)$/.exec(line.trim())
+    if (!match) continue
+    if (!byName.has(match[1])) byName.set(match[1], match[2])
+  }
+  return [...byName.entries()].map(([name, url]) => ({ name, url }))
+}
+
+/**
+ * 解析 `git stash list --format=%gd%x00%s`。
+ * @param {string} raw
+ */
+export function parseStashes(raw) {
+  /** @type {Array<{index: number, message: string}>} */
+  const stashes = []
+  for (const line of String(raw ?? '').split('\n')) {
+    if (!line.trim()) continue
+    const [ref, ...rest] = line.split('\0')
+    const match = /^stash@\{(\d+)\}$/.exec((ref || '').trim())
+    if (!match) continue
+    stashes.push({ index: Number(match[1]), message: rest.join('\0').trim() })
+  }
+  return stashes
+}
+
+/**
+ * 解析 `git log --graph --pretty=format:%H%x1f%h%x1f%an%x1f%ar%x1f%D%x1f%s` 输出。
+ * @param {string} raw
+ * @returns {Array<{graph: string, hash: string|null, full: string|null, refs: string[], author: string, date: string, subject: string}>}
+ */
+export function parseGraph(raw) {
+  /** @type {Array<object>} */
+  const lines = []
+  for (const line of String(raw ?? '').split('\n')) {
+    if (line === '') continue
+    const fields = line.split('\x1f')
+    if (fields.length < 6) {
+      // 只有 graph 连接符的行：保留给 UI 当作骨架行。
+      lines.push({ graph: line, hash: null, full: null, refs: [], author: '', date: '', subject: '' })
+      continue
+    }
+    const head = fields[0]
+    const full = /([0-9a-f]{40})$/.exec(head)
+    if (!full) {
+      lines.push({ graph: line, hash: null, full: null, refs: [], author: '', date: '', subject: '' })
+      continue
+    }
+    const graph = head.slice(0, full.index)
+    const decorations = fields[4] ? fields[4].split(',').map((ref) => ref.trim()).filter(Boolean) : []
+    lines.push({
+      graph,
+      hash: fields[1] || full[1].slice(0, 7),
+      full: full[1],
+      refs: decorations,
+      author: fields[2] ?? '',
+      date: fields[3] ?? '',
+      subject: fields.slice(5).join('\x1f'),
+    })
+  }
+  return lines
+}
+
+/**
+ * 解析 `git log --pretty=%s` 等单行输出。
+ * @param {string} raw
+ * @returns {string[]}
+ */
+export function parseLines(raw) {
+  return String(raw ?? '')
+    .split('\n')
+    .map((line) => line.trimEnd())
+    .filter((line) => line !== '')
+}
+
+const HUNK_HEADER = /^@@ -(\d+)(?:,(\d+))? \+(\d+)(?:,(\d+))? @@(.*)$/
+
+/**
+ * 解析 unified diff，输出结构化 hunk（用于面板逐行渲染）。
+ * @param {string} raw
+ * @returns {{binary: boolean, additions: number, deletions: number, hunks: Array<{header: string, lines: Array<{kind: string, text: string, old?: number, new?: number}>}>}}
+ */
+export function parseUnifiedDiff(raw) {
+  const text = String(raw ?? '')
+  /** @type {Array<{header: string, lines: Array<{kind: string, text: string, old?: number, new?: number}>}>} */
+  const hunks = []
+  let current = null
+  let oldLine = 0
+  let newLine = 0
+  let additions = 0
+  let deletions = 0
+  let binary = false
+  for (const line of text.split('\n')) {
+    if (line.startsWith('Binary files ') && line.endsWith(' differ')) {
+      binary = true
+      continue
+    }
+    if (line.startsWith('diff --git ')) {
+      current = null
+      continue
+    }
+    const hunk = HUNK_HEADER.exec(line)
+    if (hunk) {
+      oldLine = Number(hunk[1])
+      newLine = Number(hunk[3])
+      current = { header: line, lines: [] }
+      hunks.push(current)
+      continue
+    }
+    if (!current) continue
+    if (line === '') {
+      // hunk 内空行等价于一个空的上下文行。
+      current.lines.push({ kind: 'ctx', text: '', old: oldLine, new: newLine })
+      oldLine += 1
+      newLine += 1
+      continue
+    }
+    const marker = line[0]
+    if (marker === '+') {
+      current.lines.push({ kind: 'add', text: line.slice(1), new: newLine })
+      additions += 1
+      newLine += 1
+    } else if (marker === '-') {
+      current.lines.push({ kind: 'del', text: line.slice(1), old: oldLine })
+      deletions += 1
+      oldLine += 1
+    } else if (marker === ' ') {
+      current.lines.push({ kind: 'ctx', text: line.slice(1), old: oldLine, new: newLine })
+      oldLine += 1
+      newLine += 1
+    } else if (marker === '\\') {
+      current.lines.push({ kind: 'meta', text: line })
+    } else {
+      // 例如 `index abc..def 100644`、`--- a/x`、`+++ b/x` 等文件头：忽略。
+    }
+  }
+  return { binary, additions, deletions, hunks }
+}