dsh-asuta-git-diff 0.0.0-stage → 0.1.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Asuta and contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,7 @@
-# Temporary Holding Version
+# Git Diff Sidebar
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Read-only Git changes panel in the right sidebar. The button appears at the right end of the conversation view tabs when multiple views are open, or in the conversation header for a single view. It opens four comparison ranges: uncommitted (HEAD to working tree, including untracked files), unstaged (index to working tree), staged (HEAD to index), and branch (merge base of a selected local/remote branch to HEAD). Branch comparison does not include working tree changes. Refresh updates the file list and line diff. No Git state is changed.
+
+Install with `dsh plugin --profile desktop add <plugin-directory>`. The conversation must have a Git working directory.
+
+The Changes toolbar provides an optional `data-git-diff-actions` mount keyed by session ID. Worktree Control uses it to place its environment commands immediately to the right of Changes; neither plugin requires the other to be enabled.

package/client.js

@@ -0,0 +1,210 @@
+window.__ModuleLoader__.load({
+  id: 'dsh-asuta-git-diff',
+  factory(require) {
+    const React = require('react'), h = React.createElement
+    const TAB_ID = 'dsh-asuta-git-diff/panel', KIND = 'git-diff'
+    const SCOPES = [['uncommitted', '未提交'], ['unstaged', '未暂存'], ['staged', '已暂存'], ['branch', '分支']]
+    const CSS = [
+      '.gd-panel{display:flex;flex-direction:column;height:100%;min-height:0;color:var(--dsw-alias-label-primary);font:13px/1.5 var(--dsw-font-family),system-ui,sans-serif}',
+      '.gd-header{padding:14px;border-bottom:1px solid var(--dsw-alias-border-l2);display:flex;gap:8px;align-items:center;flex-wrap:wrap}.gd-header strong{flex:1}.gd-scroll{overflow:auto;min-height:0;flex:1;padding:12px 14px}',
+      '.gd-panel button,.gd-panel select{color:inherit;font:inherit;cursor:pointer}.gd-panel button:focus-visible,.gd-panel select:focus-visible,.gd-trigger:focus-visible{outline:2px solid var(--dsw-alias-state-business-primary);outline-offset:2px}',
+      '.gd-tabs{display:flex;gap:5px;flex-wrap:wrap}.gd-tabs button,.gd-refresh,.gd-file,.gd-trigger{border:1px solid var(--dsw-alias-border-l2);border-radius:7px;background:transparent;padding:5px 8px}.gd-tabs button[aria-pressed=true]{background:var(--dsw-alias-interactive-bg-hover);border-color:var(--dsw-alias-state-business-primary)}',
+      '.gd-select{max-width:100%;min-width:0;padding:6px;border-radius:7px;background:var(--dsw-specific-sidebar-fill,transparent);border:1px solid var(--dsw-alias-border-l2)}.gd-muted{color:var(--dsw-alias-label-secondary);font-size:12px;overflow-wrap:anywhere}.gd-error{color:#e88e82;overflow-wrap:anywhere}',
+      '.gd-file{width:100%;display:flex;gap:8px;align-items:center;text-align:left;margin-top:6px}.gd-file span:first-child{flex:1;min-width:0;overflow-wrap:anywhere}.gd-add{color:#75c788}.gd-del{color:#df8a80}',
+      '.gd-patch{white-space:pre;overflow:auto;font:12px/1.5 ui-monospace,Consolas,monospace;margin:0 0 10px;padding:8px;border:1px solid var(--dsw-alias-border-l2);border-top:0;border-radius:0 0 7px 7px}.gd-line{display:block;min-height:18px}.gd-line[data-kind=add]{background:#2f7a3230}.gd-line[data-kind=remove]{background:#aa353530}',
+      '.gd-toolbar{display:inline-flex;align-items:center;gap:6px;flex:none;align-self:flex-start;margin:-6px 16px 0 auto;-webkit-app-region:no-drag}.gd-toolbar-fallback{align-self:auto;margin:0}header:has([data-conversation-tabs]) .gd-toolbar-fallback{display:none}.gd-toolbar-actions{display:inline-flex;align-items:center}.gd-toolbar-actions:empty{display:none}.gd-trigger{display:inline-flex;align-items:center;gap:5px;flex:none;margin:0;color:var(--dsw-alias-label-secondary);-webkit-app-region:no-drag}.gd-trigger:hover,.gd-file:hover,.gd-refresh:hover{background:var(--dsw-alias-interactive-bg-hover)}',
+    ].join('\n')
+    async function call(action, body, signal) {
+      const response = await fetch('/git-diff/api/' + action, { method: 'POST', credentials: 'same-origin', headers: { 'content-type': 'application/json' }, body: JSON.stringify(body), signal })
+      const result = await response.json()
+      if (!response.ok || !result.ok) throw new Error(result.error || '读取 Git 差异失败。')
+      return result.value
+    }
+    function useSnapshot(store) { return React.useSyncExternalStore(store.subscribe, store.getSnapshot, store.getSnapshot) }
+    function Patch({ patch }) {
+      return h('pre', { className: 'gd-patch' }, patch.split('\n').map((line, index) => h('span', {
+        className: 'gd-line', key: index,
+        'data-kind': line.startsWith('+') && !line.startsWith('+++') ? 'add' : line.startsWith('-') && !line.startsWith('---') ? 'remove' : undefined,
+      }, line)))
+    }
+    function Panel({ ctx }) {
+      const sessionId = useSnapshot(ctx.sidebarRight.mounted)
+      const [scope, setScope] = React.useState('uncommitted'), [ref, setRef] = React.useState('')
+      const [catalog, setCatalog] = React.useState(null), [result, setResult] = React.useState(null)
+      const [error, setError] = React.useState(''), [loading, setLoading] = React.useState(false)
+      const [revision, refresh] = React.useReducer(value => value + 1, 0)
+      const [expanded, setExpanded] = React.useState('')
+      const previousSession = React.useRef(null)
+      React.useEffect(() => {
+        if (previousSession.current !== sessionId) {
+          previousSession.current = sessionId
+          setRef(''); setScope('uncommitted')
+        }
+        setCatalog(null); setResult(null); setError(''); setExpanded('')
+        if (!sessionId) return
+        const controller = new AbortController()
+        call('catalog', { sessionId }, controller.signal).then(value => {
+          setCatalog(value)
+          setRef(previous => previous && value.branches.includes(previous) ? previous : value.upstream && value.branches.includes(value.upstream) ? value.upstream : value.branches[0] || '')
+        }).catch(cause => { if (!controller.signal.aborted) setError(cause.message) })
+        return () => controller.abort()
+      }, [sessionId, revision])
+      React.useEffect(() => {
+        setResult(null); setExpanded('')
+        if (!sessionId || !catalog || (scope === 'branch' && !ref)) return
+        const controller = new AbortController()
+        setLoading(true); setError('')
+        call('inspect', { sessionId, scope, ref }, controller.signal).then(value => {
+          setResult(value)
+          if (scope === 'uncommitted') window.dispatchEvent(new CustomEvent('git-diff:updated', { detail: { sessionId, value } }))
+        }).catch(cause => { if (!controller.signal.aborted) setError(cause.message) }).finally(() => { if (!controller.signal.aborted) setLoading(false) })
+        return () => controller.abort()
+      }, [sessionId, catalog, scope, ref, revision])
+      if (!sessionId) return h('div', { className: 'gd-panel gd-scroll' }, '请先打开有工作目录的对话。')
+      return h('div', { className: 'gd-panel', 'data-plugin': 'dsh-asuta-git-diff' },
+        h('div', { className: 'gd-header' }, h('strong', null, '变更'), h('button', { type: 'button', className: 'gd-refresh', onClick: () => refresh(), 'aria-label': '刷新差异' }, '刷新')),
+        h('div', { className: 'gd-scroll' },
+          h('div', { className: 'gd-muted' }, catalog?.root || '正在读取仓库…', catalog ? ' · ' + (catalog.branch || 'detached HEAD') : ''),
+          h('div', { className: 'gd-tabs', role: 'group', 'aria-label': '比较范围' }, SCOPES.map(([id, title]) => h('button', { key: id, type: 'button', 'aria-pressed': scope === id, onClick: () => setScope(id) }, title))),
+          scope === 'branch' && catalog ? h('label', null, h('div', { className: 'gd-muted' }, '与所选分支的共同祖先比较当前提交'), h('select', { className: 'gd-select', 'aria-label': '对比分支', value: ref, onChange: event => setRef(event.target.value) }, catalog.branches.map(branch => h('option', { key: branch, value: branch }, branch)))) : null,
+          error ? h('p', { role: 'alert', className: 'gd-error' }, error) : null,
+          loading ? h('p', { className: 'gd-muted' }, '正在读取差异…') : null,
+          result ? h(React.Fragment, null,
+            h('p', { className: 'gd-muted' }, result.files.length + ' 个文件 · ', h('span', { className: 'gd-add' }, '+' + result.additions), ' ', h('span', { className: 'gd-del' }, '-' + result.deletions)),
+            result.files.length === 0 ? h('p', null, '此范围没有改动。') : result.files.map(file => h('div', { key: file.path },
+              h('button', { type: 'button', className: 'gd-file', 'aria-expanded': expanded === file.path, onClick: () => setExpanded(expanded === file.path ? '' : file.path) },
+                h('span', null, file.path, file.untracked ? ' · 未跟踪' : ''), h('span', { className: 'gd-add' }, '+' + file.additions), h('span', { className: 'gd-del' }, '-' + file.deletions)),
+              expanded === file.path ? file.skipped ? h('p', { className: 'gd-muted' }, file.skipped) : h(Patch, { patch: file.patch || '无文本差异' }) : null,
+            )),
+          ) : null,
+        ),
+      )
+    }
+    function Trigger({ ctx }) {
+      const sessionId = useSnapshot(ctx.sidebarRight.mounted)
+      const [value, setValue] = React.useState(null)
+      React.useEffect(() => {
+        setValue(null)
+        if (!sessionId) return
+        const controller = new AbortController()
+        const update = event => { if (event.detail?.sessionId === sessionId) setValue(event.detail.value) }
+        window.addEventListener('git-diff:updated', update)
+        call('summary', { sessionId }, controller.signal).then(setValue).catch(() => {})
+        return () => { controller.abort(); window.removeEventListener('git-diff:updated', update) }
+      }, [sessionId])
+      if (!sessionId) return null
+      return h('div', { className: 'gd-toolbar gd-toolbar-fallback' },
+        h('button', { type: 'button', className: 'gd-trigger', title: '查看 Git 变更', 'aria-label': '查看 Git 变更', onClick: () => ctx.sidebarRight.openTabIn(sessionId, KIND) },
+        '变更', value ? h(React.Fragment, null,
+          h('span', { className: 'gd-add' }, '+' + value.additions),
+          h('span', { className: 'gd-del' }, '-' + value.deletions),
+        ) : null),
+        h('div', { className: 'gd-toolbar-actions', 'data-git-diff-actions': sessionId }))
+    }
+    function installTabTrigger(ctx) {
+      const mounts = new Map()
+      let scheduled = false, disposed = false
+      const selector = '[data-conversation-tabs]'
+      let sessionId = ctx.sidebarRight.mounted.getSnapshot(), summary = null
+      const renderSummary = button => {
+        button.replaceChildren('变更')
+        if (!summary) return
+        for (const [className, value] of [['gd-add', summary.additions], ['gd-del', summary.deletions]]) {
+          const count = document.createElement('span')
+          count.className = className
+          count.textContent = (className === 'gd-add' ? '+' : '-') + value
+          button.appendChild(count)
+        }
+      }
+      const updateSummary = value => {
+        summary = value
+        for (const button of mounts.values()) renderSummary(button)
+      }
+      const refreshSummary = () => {
+        sessionId = ctx.sidebarRight.mounted.getSnapshot()
+        for (const button of mounts.values()) button.nextElementSibling.dataset.gitDiffActions = sessionId || ''
+        updateSummary(null)
+        const target = sessionId
+        if (target) call('summary', { sessionId: target }).then(value => {
+          if (!disposed && sessionId === target) updateSummary(value)
+        }).catch(() => {})
+      }
+      const onUpdated = event => {
+        if (event.detail?.sessionId === sessionId) updateSummary(event.detail.value)
+      }
+      const scan = () => {
+        scheduled = false
+        if (disposed) return
+        const rows = new Set([...document.querySelectorAll(selector)]
+          .filter(tabs => !tabs.closest('[data-sidebar-right-session]'))
+          .map(tabs => tabs.parentElement).filter(Boolean))
+        for (const [row, button] of mounts) {
+          if (rows.has(row) && button.parentElement?.parentElement === row) continue
+          button.parentElement?.remove()
+          mounts.delete(row)
+        }
+        for (const row of rows) {
+          if (mounts.has(row)) continue
+          const button = document.createElement('button')
+          button.type = 'button'
+          button.className = 'gd-trigger'
+          button.dataset.gitDiffTrigger = ''
+          renderSummary(button)
+          button.title = '查看 Git 变更'
+          button.setAttribute('aria-label', '查看 Git 变更')
+          button.addEventListener('click', () => {
+            const sessionId = ctx.sidebarRight.mounted.getSnapshot()
+            if (sessionId) ctx.sidebarRight.openTabIn(sessionId, KIND)
+          })
+          const toolbar = document.createElement('div')
+          toolbar.className = 'gd-toolbar'
+          const actions = document.createElement('div')
+          actions.className = 'gd-toolbar-actions'
+          actions.dataset.gitDiffActions = sessionId || ''
+          toolbar.append(button, actions)
+          row.appendChild(toolbar)
+          mounts.set(row, button)
+        }
+      }
+      const schedule = () => {
+        if (disposed || scheduled) return
+        scheduled = true
+        queueMicrotask(scan)
+      }
+      const containsTabs = node => node.nodeType === 1 &&
+        (node.matches(selector) || node.querySelector(selector) !== null)
+      const observer = new MutationObserver(records => {
+        for (const record of records) {
+          if (record.target.nodeType === 1 && record.target.querySelector(':scope > ' + selector)) { schedule(); return }
+          if ([...record.addedNodes, ...record.removedNodes].some(containsTabs)) { schedule(); return }
+        }
+      })
+      observer.observe(document.body, { childList: true, subtree: true })
+      const unsubscribe = ctx.sidebarRight.mounted.subscribe(refreshSummary)
+      window.addEventListener('git-diff:updated', onUpdated)
+      refreshSummary()
+      scan()
+      return () => {
+        disposed = true
+        observer.disconnect()
+        unsubscribe()
+        window.removeEventListener('git-diff:updated', onUpdated)
+        for (const button of mounts.values()) button.parentElement?.remove()
+        mounts.clear()
+      }
+    }
+    return {
+      inject: ['slots', 'sidebarRight', 'sidebarRightTabs'],
+      apply(ctx) {
+        ctx.effect(() => { const style = document.createElement('style'); style.dataset.plugin = 'dsh-asuta-git-diff'; style.textContent = CSS; document.head.appendChild(style); return () => style.remove() }, 'git-diff: styles')
+        ctx.effect(() => ctx.sidebarRightTabs.register({
+          id: TAB_ID, kind: KIND, patterns: ['sidebar://git-diff', 'sidebar://git-diff/**'], title: () => '变更',
+          guide: [{ id: 'new', order: 42, title: () => '变更', description: () => '查看当前工作目录的 Git 差异' }],
+        }), 'git-diff: tab type')
+        ctx.effect(() => ctx.slots.inject('sidebar.right.pane.tab', () => ctx.slots.register({ name: 'sidebar.right.pane.tab', key: TAB_ID }, props => h(Panel, { ...props, ctx }))), 'git-diff: panel')
+        ctx.effect(() => ctx.slots.inject('conversation.session.header.actions', () => ctx.slots.register({ name: 'conversation.session.header.actions', id: 'git-diff.trigger', order: 24 }, props => h(Trigger, { ...props, ctx }))), 'git-diff: single-view trigger')
+        ctx.effect(() => installTabTrigger(ctx), 'git-diff: tab-row trigger')
+      },
+    }
+  },
+})

package/cordis.patch.yml

@@ -0,0 +1,4 @@
+- insert:
+    - id: local-git-diff
+      name: "dsh-asuta-git-diff"
+      config: {}

package/git.js

@@ -0,0 +1,107 @@
+import { execFile } from 'node:child_process'
+import { promisify } from 'node:util'
+import { readFile, lstat } from 'node:fs/promises'
+import { resolve } from 'node:path'
+
+const execute = promisify(execFile)
+const LIMIT = 8 * 1024 * 1024
+const EMPTY_TREE = '4b825dc642cb6eb9a060e54bf8d69288fbee4904'
+const splitPaths = value => value.split('\0').filter(Boolean)
+
+export async function git(cwd, args) {
+  const { stdout } = await execute('git', ['--no-pager', '-c', 'core.quotepath=false', '-c', 'core.fsmonitor=false', ...args], {
+    cwd, windowsHide: true, encoding: 'utf8', timeout: 20000, maxBuffer: LIMIT,
+    env: { ...process.env, GIT_OPTIONAL_LOCKS: '0', GIT_TERMINAL_PROMPT: '0' },
+  })
+  return stdout
+}
+
+export async function catalog(cwd) {
+  const root = (await git(cwd, ['rev-parse', '--show-toplevel'])).trim()
+  const head = (await git(root, ['rev-parse', '--verify', 'HEAD']).catch(() => '')).trim()
+  const branch = (await git(root, ['symbolic-ref', '--quiet', '--short', 'HEAD']).catch(() => '')).trim()
+  const branches = (await git(root, ['for-each-ref', '--format=%(refname:short)', 'refs/heads', 'refs/remotes'])).trim().split('\n').filter(Boolean).filter(value => !value.endsWith('/HEAD'))
+  const upstream = (await git(root, ['rev-parse', '--abbrev-ref', '--symbolic-full-name', '@{upstream}']).catch(() => '')).trim()
+  return { root, head, branch, branches, upstream }
+}
+
+function syntheticPatch(path, data) {
+  if (data.includes(0)) return { patch: '', skipped: '二进制文件' }
+  const text = data.toString('utf8')
+  const lines = text.split('\n')
+  if (lines.at(-1) === '') lines.pop()
+  const header = ['diff --git a/' + path + ' b/' + path, 'new file mode 100644', '--- /dev/null', '+++ b/' + path]
+  const patch = [...header, ...(lines.length ? ['@@ -0,0 +1,' + lines.length + ' @@', ...lines.map(line => '+' + line), ...(text.endsWith('\n') ? [] : ['\'])] : [])].join('\n') + '\n'
+  return { patch }
+}
+
+function counts(patch) {
+  let additions = 0, deletions = 0
+  for (const line of patch.split('\n')) {
+    if (line.startsWith('+') && !line.startsWith('+++')) additions++
+    if (line.startsWith('-') && !line.startsWith('---')) deletions++
+  }
+  return { additions, deletions }
+}
+
+export async function summary(cwd) {
+  const repo = await catalog(cwd)
+  const base = repo.head || EMPTY_TREE
+  const numbers = splitPaths(await git(repo.root, ['diff', '--no-ext-diff', '--no-textconv', '--no-renames', '--numstat', '-z', base, '--']))
+  const untracked = splitPaths(await git(repo.root, ['ls-files', '--others', '--exclude-standard', '-z']))
+  let additions = 0, deletions = 0
+  for (const entry of numbers) {
+    const match = /^(\d+|-)\t(\d+|-)\t/.exec(entry)
+    if (match) { additions += Number(match[1]) || 0; deletions += Number(match[2]) || 0 }
+  }
+  for (const path of untracked) {
+    const file = resolve(repo.root, path)
+    const info = await lstat(file).catch(error => { if (error.code === 'ENOENT') return null; throw error })
+    if (!info?.isFile() || info.isSymbolicLink() || info.size > LIMIT) continue
+    const data = await readFile(file)
+    if (!data.includes(0) && data.length) {
+      let lines = 1
+      for (const byte of data) if (byte === 10) lines++
+      additions += lines - (data.at(-1) === 10 ? 1 : 0)
+    }
+  }
+  return { files: numbers.length + untracked.length, additions, deletions }
+}
+
+export async function inspect(cwd, scope = 'uncommitted', ref = '') {
+  if (!['uncommitted', 'unstaged', 'staged', 'branch'].includes(scope)) throw new Error('未知的比较范围。')
+  const repo = await catalog(cwd)
+  const base = repo.head || EMPTY_TREE
+  let args
+  if (scope === 'branch') {
+    if (!repo.head) throw new Error('当前仓库尚无提交，不能比较分支。')
+    if (!repo.branches.includes(ref)) throw new Error('请选择列表中的分支。')
+    const commit = (await git(repo.root, ['rev-parse', '--verify', '--end-of-options', ref + '^{commit}'])).trim()
+    const ancestor = (await git(repo.root, ['merge-base', repo.head, commit])).trim()
+    args = [ancestor, repo.head]
+  } else if (scope === 'staged') args = ['--cached', base]
+  else if (scope === 'uncommitted') args = [base]
+  else args = []
+
+  const flags = ['--no-ext-diff', '--no-textconv', '--no-renames']
+  const tracked = splitPaths(await git(repo.root, ['diff', ...flags, '--name-only', '-z', ...args, '--']))
+  const untracked = scope === 'uncommitted' ? splitPaths(await git(repo.root, ['ls-files', '--others', '--exclude-standard', '-z'])) : []
+  const files = []
+  let totalBytes = 0, additions = 0, deletions = 0
+  for (const path of [...new Set([...tracked, ...untracked])]) {
+    let item
+    if (untracked.includes(path)) {
+      const info = await lstat(resolve(repo.root, path)).catch(error => { if (error.code === 'ENOENT') return null; throw error })
+      if (!info) continue
+      if (!info.isFile() || info.isSymbolicLink()) item = { patch: '', skipped: '非普通文件' }
+      else if (info.size > LIMIT) item = { patch: '', skipped: '文件超过 8 MiB' }
+      else item = syntheticPatch(path, await readFile(resolve(repo.root, path)))
+    } else item = { patch: await git(repo.root, ['diff', ...flags, '--unified=3', ...args, '--', path]) }
+    totalBytes += Buffer.byteLength(item.patch) + Buffer.byteLength(path)
+    if (totalBytes > LIMIT) throw new Error('差异超过 8 MiB，请缩小比较范围。')
+    const count = counts(item.patch)
+    additions += count.additions; deletions += count.deletions
+    files.push({ path, ...item, ...count, untracked: untracked.includes(path) })
+  }
+  return { root: repo.root, branch: repo.branch, head: repo.head, scope, ref: scope === 'branch' ? ref : '', files, additions, deletions }
+}

package/icon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64"><rect x="8" y="8" width="20" height="20" rx="5" fill="#6e9fff"/><rect x="36" y="8" width="20" height="20" rx="5" fill="#8bc9b2"/><rect x="8" y="36" width="20" height="20" rx="5" fill="#b4a0e8"/><rect x="36" y="36" width="20" height="20" rx="5" fill="#e9ba87"/></svg>

package/index.js

@@ -0,0 +1,35 @@
+import { catalog, inspect, summary } from './git.js'
+
+export const name = 'local-git-diff'
+export const inject = ['webServer', 'connection', 'agents', 'workingDirectory']
+
+export function apply(ctx) {
+  ctx.effect(() => ctx.webServer.register({ kind: 'prefix', path: '/git-diff/api', handler: async (req, res) => {
+    const send = (status, value) => {
+      res.statusCode = status
+      res.setHeader('content-type', 'application/json; charset=utf-8')
+      res.setHeader('cache-control', 'no-store')
+      res.end(JSON.stringify(value))
+    }
+    if (ctx.connection.requestRejection(req) !== undefined) return send(403, { ok: false, error: 'forbidden' })
+    if (req.method !== 'POST') return send(405, { ok: false, error: 'POST required' })
+    const action = new URL(req.url, 'http://dsh.local').pathname.slice('/git-diff/api/'.length)
+    if (!['catalog', 'inspect', 'summary'].includes(action)) return send(404, { ok: false, error: 'unknown action' })
+    try {
+      const chunks = []; let size = 0
+      for await (const chunk of req) {
+        size += chunk.length
+        if (size > 4096) throw new Error('请求过大。')
+        chunks.push(chunk)
+      }
+      const body = JSON.parse(Buffer.concat(chunks).toString('utf8') || '{}')
+      if (typeof body?.sessionId !== 'string' || !/^[\w-]{1,100}$/.test(body.sessionId)) throw new Error('无效的会话 ID。')
+      const agent = ctx.agents.get(body.sessionId)
+      if (!agent) throw new Error('请先打开主对话，等待会话连接。')
+      const cwd = ctx.workingDirectory.get(agent.session) ?? agent.session.header.cwd
+      if (!cwd) throw new Error('当前对话没有工作目录。')
+      const value = action === 'catalog' ? await catalog(cwd) : action === 'summary' ? await summary(cwd) : await inspect(cwd, body.scope, body.ref)
+      send(200, { ok: true, value })
+    } catch (error) { send(400, { ok: false, error: String(error.message ?? error) }) }
+  } }), 'git-diff: api')
+}

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Git changes",
+    "description": "Inspect staged, unstaged, uncommitted and branch diffs beside a DSH conversation."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Git 变更",
+    "description": "在 DSH 对话旁查看暂存、未暂存、未提交改动及分支差异。"
+  }
+}

package/package.json

@@ -1,6 +1,66 @@
 {
   "name": "dsh-asuta-git-diff",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.3",
+  "type": "module",
+  "description": "Inspect staged, unstaged, uncommitted and branch diffs beside a DSH conversation. · 在 DSH 对话旁查看暂存、未暂存、未提交改动及分支差异。",
+  "main": "index.js",
+  "exports": {
+    ".": "./index.js",
+    "./client": "./client.js",
+    "./package.json": "./package.json",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./locale/*.json": "./locale/*.json"
+  },
+  "files": [
+    "index.js",
+    "git.js",
+    "client.js",
+    "cordis.patch.yml",
+    "README.md",
+    "icon.svg",
+    "locale/*.json",
+    "LICENSE*",
+    "NOTICE*",
+    "THIRD_PARTY_NOTICES.md"
+  ],
+  "engines": {
+    "node": "^22.19.0 || >=24",
+    "dsh": "0.2.2-rc.2"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "immediately": true,
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-slots",
+        "@deepseek-ai/dsh-client-ui-sidebar-right"
+      ]
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Asuta/dsh-cdx-plus.git",
+    "directory": "packages/git-diff"
+  },
+  "homepage": "https://github.com/Asuta/dsh-cdx-plus/tree/main/packages/git-diff",
+  "bugs": {
+    "url": "https://github.com/Asuta/dsh-cdx-plus/issues"
+  },
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "cdx-plus",
+    "git",
+    "git-diff",
+    "diff-viewer"
+  ],
+  "license": "MIT",
+  "icon": "./icon.svg"
+}