@caozeal/dsh-next-git 0.1.5 → 0.1.6

package/README.md

@@ -10,6 +10,10 @@ https://github.com/user-attachments/assets/c57169b4-df00-450d-b4f0-7a2c64db03b6
 
 *全片界面为渲染示意，不含真实会话；[完整播放页](https://dsh-next-git.1017835747.workers.dev/) 另有下载版。*
 
+**不想先装再看？** [在线 Demo](https://dsh.caozeal.cn/next-git/demo/) 可以直接点——
+它加载的是发布包里同一份 `lib/client.js`，只补了一个最小假宿主和一份真实仓库的录制快照
+（详见 [`demo/README.md`](https://github.com/caozeal/dsh-plugins/blob/main/dsh-next-git/demo/README.md)）。写操作在 Demo 里是禁用的，会明确提示。
+
 在 DSH Web GUI **会话的右侧边栏**加一个 Git tab（2026-10-22 从左侧全局面板迁移而来）：
 会话头部点 **Git 图标**直接打开（会自动展开右栏），或在右栏的「+ → 开始」指南页里
 选「Git 管理」。面板内容：
@@ -17,12 +21,20 @@ https://github.com/user-attachments/assets/c57169b4-df00-450d-b4f0-7a2c64db03b6
 - **便捷分支切换**：顶栏下拉出全部本地/远程分支（含 ahead/behind 与最近提交），
   一键切换；点远程分支自动建同名跟踪分支；支持新建、删除分支。
 - **变更管理**：staged / unstaged / untracked / conflicted 四组文件列表，
-  单文件或全部暂存/取消暂存，点击文件看 diff。
+  单文件或全部暂存/取消暂存，点击文件看 diff。每行还带**丢弃**按钮：
+  未暂存回到 HEAD、未跟踪直接删除、已暂存连暂存区一起回退（都会二次确认）。
+  冲突文件不给丢弃——那等于放弃冲突解决状态，容易误伤。
+- **Stash**：分支页底部可直接 stash 当前改动（有未跟踪文件时自动带 `-u`），
+  列出全部 stash，一键恢复（pop）或删除（drop）。
 - **提交 / 推送 / 拉取**：Fetch、Pull、Push 按钮，提交信息输入框，
   支持「提交」「提交并推送」；无 upstream 时自动 `push -u origin <branch>`。
-- **AI 提交信息**：读取已暂存 diff + 最近提交风格，调用当前默认模型生成一行
-  Conventional Commits 提交信息，填入输入框供编辑；模型不可用时降级为
-  `chore: 更新 N 个文件`。
+- **AI 提交信息**：读取已暂存 diff + 最近提交风格，调用当前默认模型生成
+  Conventional Commits 提交信息（标题 + 可选正文，正文用来说清动机与影响面），
+  填入输入框供编辑；模型不可用时降级为 `chore: 更新 N 个文件`。
+- **可自定义的提交提示词**：提交区齿轮按钮可改写系统提示词，存在
+  `git config dsh.commitPrompt`（本地优先、可全局兜底，不产生工作区文件）。
+  自定义只改「怎么写」，diff 与变更文件列表始终由 Host 装配后传给模型——
+  提示词写坏也不会让模型凭空编造。
 - **彩色提交图（graph）**：`git log --graph --all` 的图形化渲染。每条分支线一种颜色，
   跨行保持同色；分支名徽章与它自己的线条严格同色，滚到哪都认得出。同一屏出现过的
   分支保证互不撞色（按首次出现顺序分配，不是对名字取哈希——8 色槽下取模约 1/8 会撞）。
@@ -175,7 +187,7 @@ op 一览：`snapshot` `graph` `diff` `stage` `unstage` `switchBranch` `deleteBr
   `fallback: true`（UI 显示「模型输出不可用，已生成降级文案」）。
 - **错误码分层**：`invalid-params`（含未知 op）HTTP 400；git 业务失败 HTTP 200 +
   `ok:false`，UI 统一按 body 判定。
-- **文案全部走 Client locale**（zh/en 共 104 个 key），tab 标题与头部按钮都是
+- **文案全部走 Client locale**（zh/en 共 134 个 key），tab 标题与头部按钮都是
   「Git 管理 / 打开 Git 管理」；面板只用 `--dsw-alias-*` 主题 token。
 
 ## 已知限制
@@ -185,5 +197,5 @@ op 一览：`snapshot` `graph` `diff` `stage` `unstage` `switchBranch` `deleteBr
 - 大仓库的 graph 默认取 80 条（上限 300）；diff 超过 400k 字符会截断。
 - 会话的工作目录被删除/不可访问时，面板显示「工作目录不存在或无法访问」空态
   （Host 返回 `cwd-unavailable`），不会展示原始 spawn 错误。
-- AI 提交信息只生成一行 subject，不生成 body。
-- 网络操作超时 180s；无凭据的私有仓库会失败并把 git stderr 显示出来。
+- 冲突只做展示（conflicted 分组 + 横幅提示），不提供 accept ours/theirs 之类的解决 UI。
+- 网络操作超时 180s；无凭据的私有仓库会失败并把 git stderr 显示出来。

package/assets/screenshots/README.md

@@ -0,0 +1,24 @@
+# 插件市场截图素材
+
+`screenshots.json`（本目录上一级）里声明的 6 张图，供 dsh-market 等插件市场详情页展示。
+它们由 `test/live/artifacts/` 里的真机验证截图加工而来，**都做过打码**。
+
+| 文件 | 来源 | 处理 |
+| --- | --- | --- |
+| `01-changes.png` | `V19-style-changes.png` | 左栏 + 对话区（x < 708）高斯模糊 σ=28 |
+| `02-commit-graph.png` | `V25-colored-graph-refs.png` | 同上 |
+| `03-word-level-diff.png` | `V24-word-level-diff.png` | 同上 |
+| `04-branches.png` | `V20-whale-branches.png` | 同上 |
+| `05-graph-multibranch.png` | `V26-colored-graph-multibranch.png` | 纯提交图渲染，裁掉下方空白（1280×320） |
+| `06-fullscreen.png` | `V18-right-tab-fullscreen.png` | 面板全屏，不含界面外内容，无需处理 |
+
+重新生成（`ffmpeg`，需 `gblur` 滤镜）：
+
+```sh
+IN=test/live/artifacts
+ffmpeg -i "$IN/V24-word-level-diff.png" -filter_complex \
+  "[0:v]split[a][b];[b]crop=708:577:0:0,gblur=sigma=28[c];[a][c]overlay=0:0" \
+  assets/screenshots/03-word-level-diff.png
+```
+
+换图时保持文件名不变，市场下次构建自动生效；增删条目改 `screenshots.json`，1–8 张。

package/lib/client.js

@@ -64,6 +64,11 @@ window.__ModuleLoader__.load({
       'changes.unstageAll': '全部取消暂存',
       'changes.stage': '暂存',
       'changes.unstage': '取消暂存',
+      'changes.discard': '丢弃改动',
+      'changes.discardUntracked': '删除文件',
+      'changes.discardConfirm': '丢弃 {path} 的改动？此操作不可恢复。',
+      'changes.discardUntrackedConfirm': '删除未跟踪文件 {path}？此操作不可恢复。',
+      'changes.discardStagedConfirm': '丢弃 {path} 的暂存与工作区改动？此操作不可恢复。',
       'commit.title': '提交信息',
       'commit.placeholder': '填写提交信息，或先点「AI 生成信息」',
       'commit.hintPlaceholder': '给 AI 的补充说明（可选）',
@@ -75,6 +80,13 @@ window.__ModuleLoader__.load({
       'commit.push': '提交并推送',
       'commit.messageRequired': '请先填写提交信息',
       'commit.empty': '没有可提交的暂存变更',
+      'commit.prompt': 'AI 提示词',
+      'commit.promptTitle': '自定义 AI 提交提示词',
+      'commit.promptHint': '留空使用默认提示词。这里只改「怎么写」，diff 与文件列表始终会传给模型。',
+      'commit.promptSave': '保存',
+      'commit.promptReset': '恢复默认',
+      'commit.promptCancel': '取消',
+      'commit.promptCustom': '自定义提示词',
       'tabs.changes': '变更',
       'tabs.graph': '提交图',
       'tabs.branches': '分支',
@@ -112,6 +124,12 @@ window.__ModuleLoader__.load({
       'status.branchCreated': '已创建分支 {branch}',
       'status.branchDeleted': '已删除分支 {branch}',
       'status.deleteConfirm': '确定删除分支 {branch}？',
+      'status.discardOk': '已丢弃 {path}',
+      'status.stashSaveOk': '已 stash 当前改动',
+      'status.stashPopOk': '已恢复 stash@{n}',
+      'status.stashDropOk': '已删除 stash@{n}',
+      'status.promptSaved': '提示词已保存',
+      'status.promptReset': '已恢复默认提示词',
       'status.aiModel': '由 {model} 生成',
       'status.aiFallback': '模型输出不可用，已生成降级文案',
       'toast.error': '失败',
@@ -131,6 +149,14 @@ window.__ModuleLoader__.load({
       'status.aiModelEdit': '由 {model} 生成，可继续编辑',
       'status.ready': '就绪',
       'changes.stagedCount': '已暂存 {n}',
+      'stash.title': 'Stash',
+      'stash.empty': '没有 stash 记录',
+      'stash.placeholder': 'stash 说明（可选）',
+      'stash.save': '暂存改动',
+      'stash.pop': '恢复',
+      'stash.drop': '删除',
+      'stash.popConfirm': '恢复 stash@{n} 并从列表移除？',
+      'stash.dropConfirm': '删除 stash@{n}？此操作不可恢复。',
       'changes.conflictBanner': '存在 {n} 个冲突文件，解决后再提交',
       'branch.selectTitle': '切换分支',
       'header.refreshing': '刷新中…',
@@ -175,6 +201,11 @@ window.__ModuleLoader__.load({
       'changes.unstageAll': 'Unstage all',
       'changes.stage': 'Stage',
       'changes.unstage': 'Unstage',
+      'changes.discard': 'Discard changes',
+      'changes.discardUntracked': 'Delete file',
+      'changes.discardConfirm': 'Discard changes to {path}? This cannot be undone.',
+      'changes.discardUntrackedConfirm': 'Delete untracked file {path}? This cannot be undone.',
+      'changes.discardStagedConfirm': 'Discard staged and working-tree changes to {path}? This cannot be undone.',
       'commit.title': 'Commit message',
       'commit.placeholder': 'Write a commit message, or generate one with AI',
       'commit.hintPlaceholder': 'Optional hint for the AI',
@@ -186,6 +217,13 @@ window.__ModuleLoader__.load({
       'commit.push': 'Commit & push',
       'commit.messageRequired': 'Commit message is required',
       'commit.empty': 'Nothing staged to commit',
+      'commit.prompt': 'AI prompt',
+      'commit.promptTitle': 'Custom AI commit prompt',
+      'commit.promptHint': 'Leave empty to use the default. This only changes how it writes; the diff and file list are always sent.',
+      'commit.promptSave': 'Save',
+      'commit.promptReset': 'Reset to default',
+      'commit.promptCancel': 'Cancel',
+      'commit.promptCustom': 'Custom prompt',
       'tabs.changes': 'Changes',
       'tabs.graph': 'Graph',
       'tabs.branches': 'Branches',
@@ -223,6 +261,12 @@ window.__ModuleLoader__.load({
       'status.branchCreated': 'Created branch {branch}',
       'status.branchDeleted': 'Deleted branch {branch}',
       'status.deleteConfirm': 'Delete branch {branch}?',
+      'status.discardOk': 'Discarded {path}',
+      'status.stashSaveOk': 'Stashed current changes',
+      'status.stashPopOk': 'Restored stash@{n}',
+      'status.stashDropOk': 'Dropped stash@{n}',
+      'status.promptSaved': 'Prompt saved',
+      'status.promptReset': 'Restored the default prompt',
       'status.aiModel': 'Generated by {model}',
       'status.aiFallback': 'Model output unusable; used a fallback message',
       'toast.error': 'Failed',
@@ -242,6 +286,14 @@ window.__ModuleLoader__.load({
       'status.aiModelEdit': 'Generated by {model}; edit as needed',
       'status.ready': 'Ready',
       'changes.stagedCount': '{n} staged',
+      'stash.title': 'Stash',
+      'stash.empty': 'No stash entries',
+      'stash.placeholder': 'Stash message (optional)',
+      'stash.save': 'Stash changes',
+      'stash.pop': 'Restore',
+      'stash.drop': 'Drop',
+      'stash.popConfirm': 'Restore stash@{n} and remove it from the list?',
+      'stash.dropConfirm': 'Drop stash@{n}? This cannot be undone.',
       'changes.conflictBanner': '{n} conflicted file(s); resolve them before committing',
       'branch.selectTitle': 'Switch branch',
       'header.refreshing': 'Refreshing…',
@@ -482,6 +534,11 @@ window.__ModuleLoader__.load({
       .gm-commit::before { content:''; position:absolute; top:0; left:0; right:0; height:3px;
         background:linear-gradient(90deg, var(--gm-cyan), var(--gm-blue) 45%, transparent 90%); }
       .gm-commit-head { display:flex; align-items:center; gap:6px; }
+      .gm-prompt { display:flex; flex-direction:column; gap:5px; padding:8px; border-radius:10px;
+        background:var(--gm-blue-06); border:1px solid var(--gm-blue-12); }
+      .gm-prompt .gm-section { padding:0; }
+      .gm-prompt-text { min-height:96px; max-height:180px; font-size:11px;
+        font-family:ui-monospace, SFMono-Regular, Menlo, Consolas, monospace; }
       .gm-commit-title { font-size:10.5px; font-weight:700; letter-spacing:.05em; text-transform:uppercase;
         color:var(--gm-blue); }
       .gm-textarea { width:100%; min-height:46px; max-height:140px; padding:7px 9px; border-radius:10px;
@@ -607,6 +664,9 @@ window.__ModuleLoader__.load({
       commit: ['M12 4a8 8 0 1 0 0 16 8 8 0 0 0 0-16z', 'M8.5 12l2.5 2.5L16 9.5'],
       file: ['M6 3h8l4 4v14H6z', 'M14 3v5h5'],
       branch: ['M6 4v9', 'M6 17m-2 0a2 2 0 1 0 4 0a2 2 0 1 0-4 0', 'M18 6m-2 0a2 2 0 1 0 4 0a2 2 0 1 0-4 0', 'M18 8v1a6 6 0 0 1-6 6H8'],
+      trash: ['M4 7h16', 'M9 7V4h6v3', 'M6 7l1 14h10l1-14', 'M10 11v6', 'M14 11v6'],
+      gear: ['M12 15a3 3 0 1 0 0-6 3 3 0 0 0 0 6z', 'M19.4 15a1.7 1.7 0 0 0 .3 1.9l.1.1a2 2 0 1 1-2.8 2.8l-.1-.1a1.7 1.7 0 0 0-1.9-.3 1.7 1.7 0 0 0-1 1.5V21a2 2 0 1 1-4 0v-.1A1.7 1.7 0 0 0 9 19.4a1.7 1.7 0 0 0-1.9.3l-.1.1a2 2 0 1 1-2.8-2.8l.1-.1a1.7 1.7 0 0 0 .3-1.9 1.7 1.7 0 0 0-1.5-1H3a2 2 0 1 1 0-4h.1A1.7 1.7 0 0 0 4.6 9a1.7 1.7 0 0 0-.3-1.9l-.1-.1a2 2 0 1 1 2.8-2.8l.1.1a1.7 1.7 0 0 0 1.9.3H9a1.7 1.7 0 0 0 1-1.5V3a2 2 0 1 1 4 0v.1a1.7 1.7 0 0 0 1 1.5 1.7 1.7 0 0 0 1.9-.3l.1-.1a2 2 0 1 1 2.8 2.8l-.1.1a1.7 1.7 0 0 0-.3 1.9V9a1.7 1.7 0 0 0 1.5 1H21a2 2 0 1 1 0 4h-.1a1.7 1.7 0 0 0-1.5 1z'],
+      stash: ['M4 5h16v4H4z', 'M6 9v10h12V9', 'M10 13h4'],
     }
 
     function Icon(props) {
@@ -790,6 +850,11 @@ window.__ModuleLoader__.load({
         newBranchOpen: false,
         newBranchName: '',
         newBranchFrom: '',
+        // 自定义 AI 提示词编辑态。promptDraft 是编辑中的草稿，
+        // 只有点保存才写回 git config，避免边打字边写盘。
+        promptOpen: false,
+        promptDraft: '',
+        stashMessage: '',
       })
       var toastTimer = null
       var loadToken = 0
@@ -909,6 +974,10 @@ window.__ModuleLoader__.load({
       }
 
       function setNewBranchName(value) { set({ newBranchName: value }) }
+      function setStashMessage(value) {
+        set({ stashMessage: String(value || '') })
+      }
+
       function setNewBranchFrom(value) { set({ newBranchFrom: value }) }
 
       async function runBusy(label, operation) {
@@ -981,6 +1050,117 @@ window.__ModuleLoader__.load({
         }
       }
 
+      /**
+       * 丢弃改动。分组的语义决定用哪个后端模式：
+       *   unstaged → worktree（只回退工作区）
+       *   untracked → untracked（删除文件）
+       *   staged → all（连暂存区一起回退）
+       * 三种都不可恢复，所以一律先 window.confirm。
+       */
+      async function discard(group, entry) {
+        var cwd = store.get().cwd
+        if (!cwd || !entry || !entry.path) return
+        var mode = group === 'untracked' ? 'untracked' : group === 'staged' ? 'all' : 'worktree'
+        var key = group === 'untracked'
+          ? 'changes.discardUntrackedConfirm'
+          : group === 'staged' ? 'changes.discardStagedConfirm' : 'changes.discardConfirm'
+        if (typeof window !== 'undefined' && typeof window.confirm === 'function') {
+          if (!window.confirm(tr(key, { path: entry.path }))) return
+        }
+        var result = await runBusy('discard', function () {
+          return rpc('discard', { cwd: cwd, paths: [entry.path], mode: mode })
+        })
+        if (result !== null) {
+          toast('ok', tr('status.discardOk', { path: entry.path }), result.output)
+          set({ selected: null, diff: null })
+          await refresh()
+        }
+      }
+
+      async function stashSave() {
+        var state = store.get()
+        var cwd = state.cwd
+        if (!cwd) return
+        var params = { cwd: cwd }
+        var message = String(state.stashMessage || '').trim()
+        if (message !== '') params.message = message
+        // 未跟踪文件默认不进 stash；有未跟踪改动时一并存起来，否则用户会以为「全存了」
+        var status = state.snapshot && state.snapshot.status ? state.snapshot.status : null
+        if (status && status.untracked && status.untracked.length > 0) params.includeUntracked = true
+        var result = await runBusy('stash', function () { return rpc('stashPush', params) })
+        if (result !== null) {
+          set({ stashMessage: '' })
+          toast('ok', tr('status.stashSaveOk'), result.output)
+          await refresh()
+        }
+      }
+
+      async function stashPop(index) {
+        var cwd = store.get().cwd
+        if (!cwd) return
+        if (typeof window !== 'undefined' && typeof window.confirm === 'function') {
+          if (!window.confirm(tr('stash.popConfirm', { n: index }))) return
+        }
+        var result = await runBusy('stash', function () { return rpc('stashPop', { cwd: cwd, index: index }) })
+        if (result !== null) {
+          toast('ok', tr('status.stashPopOk', { n: index }), result.output)
+          await refresh()
+        }
+      }
+
+      async function stashDrop(index) {
+        var cwd = store.get().cwd
+        if (!cwd) return
+        if (typeof window !== 'undefined' && typeof window.confirm === 'function') {
+          if (!window.confirm(tr('stash.dropConfirm', { n: index }))) return
+        }
+        var result = await runBusy('stash', function () { return rpc('stashDrop', { cwd: cwd, index: index }) })
+        if (result !== null) {
+          toast('ok', tr('status.stashDropOk', { n: index }), result.output)
+          await refresh()
+        }
+      }
+
+      function openPrompt() {
+        var snapshot = store.get().snapshot
+        set({ promptOpen: true, promptDraft: snapshot && snapshot.commitPrompt ? snapshot.commitPrompt : '' })
+      }
+
+      function closePrompt() {
+        set({ promptOpen: false, promptDraft: '' })
+      }
+
+      function setPromptDraft(value) {
+        set({ promptDraft: String(value || '') })
+      }
+
+      async function savePrompt() {
+        var state = store.get()
+        var cwd = state.cwd
+        if (!cwd) return
+        var result = await runBusy('prompt', function () {
+          return rpc('setCommitPrompt', { cwd: cwd, prompt: String(state.promptDraft || '') })
+        })
+        if (result !== null) {
+          set({ promptOpen: false, promptDraft: '' })
+          toast('ok', tr('status.promptSaved'))
+          await refresh()
+        }
+      }
+
+      async function resetPrompt() {
+        var cwd = store.get().cwd
+        if (!cwd) return
+        var result = await runBusy('prompt', function () {
+          return rpc('setCommitPrompt', { cwd: cwd, prompt: '' })
+        })
+        if (result !== null) {
+          set({ promptOpen: false, promptDraft: '' })
+          toast('ok', tr('status.promptReset'))
+          await refresh()
+        }
+      }
+
       async function switchBranch(name) {
         var cwd = store.get().cwd
         if (!cwd || !name) return
@@ -1105,6 +1285,16 @@ window.__ModuleLoader__.load({
         setNewBranch: setNewBranch,
         setNewBranchName: setNewBranchName,
         setNewBranchFrom: setNewBranchFrom,
+        discard: discard,
+        stashSave: stashSave,
+        stashPop: stashPop,
+        stashDrop: stashDrop,
+        setStashMessage: setStashMessage,
+        openPrompt: openPrompt,
+        closePrompt: closePrompt,
+        setPromptDraft: setPromptDraft,
+        savePrompt: savePrompt,
+        resetPrompt: resetPrompt,
         clearToast: clearToast,
       }
     }
@@ -1162,16 +1352,29 @@ window.__ModuleLoader__.load({
             h('span', { className: 'gm-fpath' },
               parts.dir ? h('span', { className: 'gm-dir' }, parts.dir) : null,
               parts.base),
-            h('button', {
-              type: 'button',
-              className: 'gm-btn icon sm ghost gm-act',
-              title: staged ? tr('changes.unstage') : tr('changes.stage'),
-              onClick: function (event) {
-                event.stopPropagation()
-                if (staged) props.onUnstage(entry)
-                else props.onStage(entry)
-              },
-            }, h(Icon, { name: staged ? 'minus' : 'plus', size: 12 })))
+            h('span', { className: 'gm-row', style: { gap: '2px' } },
+              h('button', {
+                type: 'button',
+                className: 'gm-btn icon sm ghost gm-act',
+                title: staged ? tr('changes.unstage') : tr('changes.stage'),
+                onClick: function (event) {
+                  event.stopPropagation()
+                  if (staged) props.onUnstage(entry)
+                  else props.onStage(entry)
+                },
+              }, h(Icon, { name: staged ? 'minus' : 'plus', size: 12 })),
+              // 冲突文件不给「丢弃」：那等于放弃冲突解决状态，语义上容易误伤
+              props.onDiscard && props.group !== 'conflicted'
+                ? h('button', {
+                  type: 'button',
+                  className: 'gm-btn icon sm ghost gm-act',
+                  title: props.group === 'untracked' ? tr('changes.discardUntracked') : tr('changes.discard'),
+                  onClick: function (event) {
+                    event.stopPropagation()
+                    props.onDiscard(entry)
+                  },
+                }, h(Icon, { name: 'trash', size: 12 }))
+                : null))
         }))
     }
 
@@ -1194,6 +1397,7 @@ window.__ModuleLoader__.load({
           onSelect: function (entry) { props.actions.selectFile(group, entry) },
           onStage: function (entry) { props.actions.stage(group, entry) },
           onUnstage: function (entry) { props.actions.unstage(group, entry) },
+          onDiscard: function (entry) { props.actions.discard(group, entry) },
         })
       }
       var empty = !conflicted.length && !staged.length && !unstaged.length && !untracked.length
@@ -1226,6 +1430,29 @@ window.__ModuleLoader__.load({
         }
       }
       return h('div', { className: 'gm-commit' },
+        state.promptOpen
+          ? h('div', { className: 'gm-prompt' },
+            h('div', { className: 'gm-section' },
+              h('span', null, tr('commit.promptTitle')),
+              h('span', { className: 'gm-spacer' }),
+              h('button', {
+                type: 'button',
+                className: 'gm-btn icon sm ghost',
+                title: tr('commit.promptCancel'),
+                onClick: props.onClosePrompt,
+              }, h(Icon, { name: 'close', size: 12 }))),
+            h('textarea', {
+              className: 'gm-textarea gm-prompt-text',
+              value: state.promptDraft,
+              placeholder: tr('commit.promptHint'),
+              onChange: function (event) { props.onPromptDraft(event.target.value) },
+            }),
+            h('div', { className: 'gm-hint' }, tr('commit.promptHint')),
+            h('div', { className: 'gm-actions' },
+              h(Btn, { label: tr('commit.promptReset'), small: true, ghost: true, disabled: !!busy, onClick: props.onResetPrompt }),
+              h('span', { className: 'gm-spacer' }),
+              h(Btn, { label: tr('commit.promptSave'), small: true, variant: 'primary', disabled: !!busy, onClick: props.onSavePrompt })))
+          : null,
         h('div', { className: 'gm-commit-head' },
           h(WhaleGlyph, { size: 22 }),
           h('span', { className: 'gm-commit-title' }, tr('commit.title')),
@@ -1254,8 +1481,17 @@ window.__ModuleLoader__.load({
             className: busy === 'ai' ? 'gm-ai-busy' : undefined,
             disabled: !!busy || !state.cwd,
             onClick: props.onGenerate,
+          }),
+          h(Btn, {
+            icon: 'gear',
+            title: tr('commit.prompt'),
+            disabled: !!busy || !state.cwd,
+            onClick: props.onOpenPrompt,
           })),
         h('div', { className: 'gm-actions' },
+          state.snapshot && state.snapshot.commitPrompt
+            ? h('span', { className: 'gm-badge brand', title: state.snapshot.commitPrompt }, tr('commit.promptCustom'))
+            : null,
           state.aiModel
             ? h('span', { className: 'gm-ai-line gm-hint', title: tr('status.aiModel', { model: state.aiModel }) },
               state.aiFallback ? tr('status.aiFallback') : tr('status.aiModelEdit', { model: state.aiModel }))
@@ -1539,6 +1775,7 @@ window.__ModuleLoader__.load({
       var branches = state.snapshot && state.snapshot.branches ? state.snapshot.branches : []
       var locals = branches.filter(function (branch) { return branch.kind === 'local' })
       var remotes = branches.filter(function (branch) { return branch.kind === 'remote' })
+      var stashes = state.snapshot && state.snapshot.stashes ? state.snapshot.stashes : []
       function group(title, items, allowDelete) {
         if (items.length === 0) return null
         return h('div', null,
@@ -1564,13 +1801,42 @@ window.__ModuleLoader__.load({
                   : null))
           }))
       }
+      // stash 放在分支页：它和分支一样是「当前工作放哪儿」的操作，
+      // 而不是某次提交的内容。后端 snapshot 早就解析了 stashes，这里才真正用上。
+      function stashSection() {
+        return h('div', null,
+          h('div', { className: 'gm-section' },
+            h('span', null, tr('stash.title')),
+            h('span', { className: 'gm-section-count' }, String(stashes.length))),
+          h('div', { className: 'gm-row', style: { padding: '0 10px 6px' } },
+            h('input', {
+              className: 'gm-input',
+              value: state.stashMessage,
+              placeholder: tr('stash.placeholder'),
+              onChange: function (event) { props.onStashMessage(event.target.value) },
+              onKeyDown: function (event) { if (event.key === 'Enter') props.onStashSave() },
+            }),
+            h(Btn, { label: tr('stash.save'), small: true, disabled: !!state.busy, onClick: props.onStashSave })),
+          stashes.length === 0
+            ? h('div', { className: 'gm-hint', style: { padding: '0 12px 8px' } }, tr('stash.empty'))
+            : stashes.map(function (item) {
+              return h('div', { key: 'stash:' + item.index, className: 'gm-branch' },
+                h(Icon, { name: 'stash', size: 12 }),
+                h('span', { className: 'gm-badge' }, 'stash@{' + item.index + '}'),
+                h('span', { className: 'gm-bmeta' }, item.message || ''),
+                h('span', { className: 'gm-row gm-act', style: { gap: '4px', flex: 'none' } },
+                  h(Btn, { label: tr('stash.pop'), small: true, disabled: !!state.busy, onClick: function () { props.onStashPop(item.index) } }),
+                  h(Btn, { label: tr('stash.drop'), small: true, ghost: true, disabled: !!state.busy, onClick: function () { props.onStashDrop(item.index) } })))
+            }))
+      }
       return h('div', { className: 'gm-scroll' },
         h('div', { className: 'gm-content-inner' },
           group(tr('branch.local'), locals, true),
           group(tr('branch.remote'), remotes, false),
           locals.length === 0 && remotes.length === 0
             ? h(EmptyState, { title: tr('branch.empty') })
-            : null))
+            : null,
+          stashSection()))
     }
 
     function StatusBar(props) {
@@ -1629,7 +1895,15 @@ window.__ModuleLoader__.load({
       var content
       if (state.activeTab === 'changes') content = h(ChangesPane, { state: state, actions: props.actions })
       else if (state.activeTab === 'graph') content = h(GraphView, { state: state, onSelectCommit: props.actions.selectCommit })
-      else if (state.activeTab === 'branches') content = h(BranchesView, { state: state, onSwitch: props.actions.switchBranch, onDelete: props.actions.deleteBranch })
+      else if (state.activeTab === 'branches') content = h(BranchesView, {
+        state: state,
+        onSwitch: props.actions.switchBranch,
+        onDelete: props.actions.deleteBranch,
+        onStashSave: props.actions.stashSave,
+        onStashPop: props.actions.stashPop,
+        onStashDrop: props.actions.stashDrop,
+        onStashMessage: props.actions.setStashMessage,
+      })
       else content = h(DiffView, { state: state })
       return h('div', { className: 'gm-root' },
         panelStyle(),
@@ -1665,6 +1939,11 @@ window.__ModuleLoader__.load({
             onHint: props.actions.setAiHint,
             onGenerate: props.actions.generateMessage,
             onCommit: function (andPush) { props.actions.commit(andPush) },
+            onOpenPrompt: props.actions.openPrompt,
+            onClosePrompt: props.actions.closePrompt,
+            onPromptDraft: props.actions.setPromptDraft,
+            onSavePrompt: props.actions.savePrompt,
+            onResetPrompt: props.actions.resetPrompt,
           })
           : null)
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@caozeal/dsh-next-git",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "DSH Git 管理插件：分支切换、变更暂存、提交/推送/拉取、AI 提交信息、提交图与 diff 查看",
   "type": "module",
   "main": "index.js",
@@ -16,6 +16,8 @@
     "src",
     "lib/client.js",
     "cordis.patch.yml",
+    "screenshots.json",
+    "assets/screenshots",
     "locale/*.json",
     "icon.svg",
     "icon.png"

package/screenshots.json

@@ -0,0 +1,8 @@
+[
+  "assets/screenshots/01-changes.png",
+  "assets/screenshots/02-commit-graph.png",
+  "assets/screenshots/03-word-level-diff.png",
+  "assets/screenshots/04-branches.png",
+  "assets/screenshots/05-graph-multibranch.png",
+  "assets/screenshots/06-fullscreen.png"
+]

package/src/ai-commit.js

@@ -2,8 +2,12 @@
  * git-manager — AI 提交信息生成。
  *
  * 流程：收集「已暂存 diff（为空则工作区 diff）→ 最近提交风格 → 调用默认模型的
- * llm.stream」→ 清理成一行提交信息。任何一步不可用都退回确定性文案（fallback），
- * 让面板始终能拿到一个可编辑的建议。
+ * llm.stream」→ 清理成「标题 + 可选正文」。任何一步不可用都退回确定性文案
+ * （fallback），让面板始终能拿到一条可编辑的建议。
+ *
+ * 系统提示词可由仓库自定义（git config dsh.commitPrompt），只替换「怎么写」的规则，
+ * 不改变「给模型看什么数据」——diff/文件/最近提交这条装配逻辑始终由本模块掌握，
+ * 避免用户把模板写坏后模型看不到 diff 而胡乱编造。
  */
 import { GitError } from './git.js'
 
@@ -11,11 +15,13 @@ const MAX_DIFF_CHARS = 12000
 /** 单次生成的 token 预算：reasoning 模型会先消耗思考 token，200 太小容易截断。 */
 const MAX_OUTPUT_TOKENS = 600
 
-const SYSTEM_PROMPT = [
+export const DEFAULT_SYSTEM_PROMPT = [
   '你是一个 Git 提交信息生成器。',
-  '只输出一行提交信息，不要解释、不要代码块、不要引号、不要句号结尾。',
-  '使用 Conventional Commits 风格（如 feat:/fix:/refactor:/docs:/chore:），',
-  '不超过 72 个字符。跟随仓库最近提交的语言：最近提交多为中文就用中文，否则用英文。',
+  '第一行是标题：Conventional Commits 风格（feat:/fix:/refactor:/docs:/chore: 等），不超过 72 个字符，不以句号结尾。',
+  '如果这次改动需要说明动机、影响面或取舍，空一行后写正文，正文每行不超过 72 个字符，可以分段。',
+  '改动很小、一句话能说清时不要硬凑正文。',
+  '不要解释、不要代码块、不要引号。',
+  '跟随仓库最近提交的语言：最近提交多为中文就用中文，否则用英文。',
 ].join('')
 
 /** 从 diff 与最近提交构造 user prompt。 */
@@ -48,6 +54,44 @@ export function sanitizeSubject(text) {
   return subject
 }
 
+/** 去掉整行的代码块围栏，保留内容。 */
+function stripFences(text) {
+  return String(text ?? '').replace(/^[ \t]*```[a-zA-Z0-9_-]*[ \t]*$/gm, '')
+}
+
+/**
+ * 清理模型输出的正文部分：去围栏、去首尾空行、去「正文：」这类前缀、限长。
+ * 不做逐行 trim——正文里的缩进（列表、代码片段）要保留。
+ * @param {string} text
+ * @returns {string}
+ */
+export function sanitizeBody(text) {
+  let value = stripFences(text).replace(/\r\n/g, '\n')
+  const lines = value.split('\n').map((line) => line.replace(/[ \t]+$/, ''))
+  while (lines.length > 0 && lines[0].trim() === '') lines.shift()
+  while (lines.length > 0 && lines[lines.length - 1].trim() === '') lines.pop()
+  let body = lines.join('\n').trim()
+  body = body.replace(/^(commit body|提交正文|正文)\s*[:：]\s*/i, '')
+  if (body.length > 2000) body = body.slice(0, 2000).trim()
+  return body
+}
+
+/**
+ * 把模型输出拆成「标题 + 正文」。
+ * 模型偶尔只给标题，也可能给「标题 / 空行 / 正文」，两种都要能吃下。
+ * @param {string} text
+ * @returns {{subject: string, body: string}}
+ */
+export function parseCommitMessage(text) {
+  const cleaned = stripFences(text).replace(/\r\n/g, '\n')
+  const lines = cleaned.split('\n')
+  let index = 0
+  while (index < lines.length && lines[index].trim() === '') index += 1
+  const subjectLine = index < lines.length ? lines[index] : ''
+  const rest = lines.slice(index + 1).join('\n')
+  return { subject: sanitizeSubject(subjectLine), body: sanitizeBody(rest) }
+}
+
 /** 最近提交是否以中文为主。 */
 function looksChinese(subjects) {
   const joined = subjects.join('')
@@ -104,8 +148,9 @@ export function fallbackSubject({ files, stagedCount, Chinese }) {
  *   signal?: AbortSignal,
  *   llm?: unknown,
  *   selection?: {provider?: string, model?: string, reasoningEffort?: string},
+ *   systemPrompt?: string,
  * }} options
- * @returns {Promise<{message: string, model: string|null, fallback: boolean}>}
+ * @returns {Promise<{message: string, subject: string, body: string, model: string|null, fallback: boolean}>}
  */
 export async function generateCommitMessage(options) {
   const {
@@ -117,6 +162,7 @@ export async function generateCommitMessage(options) {
     selection,
     files = [],
     stagedCount = 0,
+    systemPrompt = '',
   } = options
 
   const staged = await runGit(['diff', '--cached', '--no-color'], { cwd, signal, allowFailure: true })
@@ -144,13 +190,12 @@ export async function generateCommitMessage(options) {
 
   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 subject = fallbackSubject({ files: changedFiles, stagedCount, Chinese: chinese })
+    return { message: subject, subject, body: '', model, fallback: true }
   }
 
+  // 用户自定义提示词：只覆盖「怎么写」的规则，装配数据仍由 buildPrompt 负责。
+  const customPrompt = typeof systemPrompt === 'string' ? systemPrompt.trim().slice(0, 4000) : ''
   const prompt = buildPrompt({ diff, files: changedFiles, recent, hint })
   let text = ''
   try {
@@ -158,7 +203,7 @@ export async function generateCommitMessage(options) {
       provider: selection.provider,
       model: selection.model,
       reasoningEffort: selection.reasoningEffort,
-      system: SYSTEM_PROMPT,
+      system: customPrompt === '' ? DEFAULT_SYSTEM_PROMPT : customPrompt,
       messages: [{ role: 'user', content: [{ type: 'text', text: prompt }] }],
       maxTokens: MAX_OUTPUT_TOKENS,
       temperature: 0.2,
@@ -182,13 +227,11 @@ export async function generateCommitMessage(options) {
     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,
-    }
+  const parsed = parseCommitMessage(text)
+  if (!looksLikeSubject(parsed.subject)) {
+    const subject = fallbackSubject({ files: changedFiles, stagedCount, Chinese: chinese })
+    return { message: subject, subject, body: '', model, fallback: true }
   }
-  return { message: subject, model, fallback: false }
-}
+  const message = parsed.body === '' ? parsed.subject : parsed.subject + '\n\n' + parsed.body
+  return { message, subject: parsed.subject, body: parsed.body, model, fallback: false }
+}

package/src/operations.js

@@ -27,10 +27,17 @@ const DIFF_MAX_CHARS = 400000
 
 /** 支持的操作名。 */
 const OPS = [
-  'snapshot', 'graph', 'diff', 'stage', 'unstage', 'switchBranch', 'deleteBranch',
+  'snapshot', 'graph', 'diff', 'stage', 'unstage', 'discard', 'switchBranch', 'deleteBranch',
   'commit', 'fetch', 'pull', 'push', 'aiCommit',
+  'stashPush', 'stashPop', 'stashDrop', 'setCommitPrompt',
 ]
 
+/** 自定义提交提示词在 git config 里的键。用 git config 而不是新增工作区文件：
+ *  不污染 git status、不打扰 .gitignore，且天然区分本地/全局（写入用 --local，
+ *  读取走默认级联，所以用户可以先设一条全局默认再按仓库覆盖）。 */
+const COMMIT_PROMPT_KEY = 'dsh.commitPrompt'
+const COMMIT_PROMPT_MAX = 4000
+
 /** 只接受安全的 ref/远程名，避免被当作命令行选项。 */
 const SAFE_REF = /^[A-Za-z0-9._/-]+$/
 
@@ -160,10 +167,11 @@ export function createOperations(deps) {
         remotes: [],
         status: { clean: true, staged: [], unstaged: [], untracked: [], conflicted: [] },
         stashes: [],
+        commitPrompt: '',
       }
     }
     const root = resolved.root
-    const [statusRes, branchesRes, remotesRes, stashRes, headRes, urlRes] = await Promise.all([
+    const [statusRes, branchesRes, remotesRes, stashRes, headRes, urlRes, promptRes] = await Promise.all([
       runGit(['status', '--porcelain=v1', '-z', '--branch', '--untracked-files=all'], {
         cwd: root,
         signal,
@@ -178,6 +186,7 @@ export function createOperations(deps) {
       runGit(['stash', 'list', '--format=%gd%x00%s'], { cwd: root, signal, allowFailure: true }),
       runGit(['rev-parse', '--short', 'HEAD'], { cwd: root, signal, allowFailure: true }),
       runGit(['config', '--get', 'remote.origin.url'], { cwd: root, signal, allowFailure: true }),
+      runGit(['config', '--get', COMMIT_PROMPT_KEY], { cwd: root, signal, allowFailure: true }),
     ])
     const parsed = parsePorcelain(statusRes.stdout)
     const head = parseBranchHeader(parsed.branchLine)
@@ -209,6 +218,7 @@ export function createOperations(deps) {
       remotes,
       status: { clean, ...groups },
       stashes: parseStashes(stashRes.stdout),
+      commitPrompt: promptRes.code === 0 ? promptRes.stdout.trim() : '',
     }
   }
 
@@ -311,6 +321,31 @@ export function createOperations(deps) {
     return { output: joinOutput(result.stdout, result.stderr) }
   }
 
+  /**
+   * 丢弃改动。三种模式对应变更列表里的三个分组：
+   *   worktree  —— 未暂存（git restore --worktree）
+   *   untracked —— 未跟踪（git clean -f -d）
+   *   all       —— 已暂存，连暂存区一起回退（git restore --staged --worktree）
+   * 都不可恢复，前端必须二次确认后才调用。
+   */
+  async function discard(params, signal) {
+    const cwd = assertCwd(params.cwd)
+    const resolved = await repoRoot(cwd, signal)
+    const root = resolved.root
+    if (!root) throw new GitError(`当前目录不是 Git 仓库：${cwd}${resolved.error ? `（${resolved.error}）` : ''}`, { code: 'not-a-repo' })
+    const mode = params.mode
+    if (!['worktree', 'untracked', 'all'].includes(mode)) {
+      throw new GitError(`未知的丢弃模式：${String(mode)}`, { code: 'invalid-params' })
+    }
+    const paths = assertPaths(params.paths)
+    let args
+    if (mode === 'untracked') args = ['clean', '-f', '-d', '--', ...paths]
+    else if (mode === 'all') args = ['restore', '--staged', '--worktree', '--', ...paths]
+    else args = ['restore', '--worktree', '--', ...paths]
+    const result = await runGit(args, { cwd: root, signal, timeoutMs: timeouts.write })
+    return { output: joinOutput(result.stdout, result.stderr) }
+  }
+
   async function switchBranch(params, signal) {
     const cwd = assertCwd(params.cwd)
     const resolved = await repoRoot(cwd, signal)
@@ -429,6 +464,80 @@ export function createOperations(deps) {
     return { branch, output: joinOutput(result.stdout, result.stderr) }
   }
 
+  /** stash 索引只接受非负整数，避免拼进 stash@{...} 时被注入别的 ref。 */
+  function assertStashIndex(value, fallback) {
+    const raw = value === undefined || value === null ? fallback : value
+    const index = Number(raw)
+    if (!Number.isInteger(index) || index < 0 || index > 999) {
+      throw new GitError(`stash 索引非法：${String(raw)}`, { code: 'invalid-params' })
+    }
+    return index
+  }
+
+  async function stashPush(params, signal) {
+    const cwd = assertCwd(params.cwd)
+    const resolved = await repoRoot(cwd, signal)
+    const root = resolved.root
+    if (!root) throw new GitError(`当前目录不是 Git 仓库：${cwd}${resolved.error ? `（${resolved.error}）` : ''}`, { code: 'not-a-repo' })
+    const args = ['stash', 'push']
+    if (params.includeUntracked === true) args.push('-u')
+    const message = typeof params.message === 'string' ? params.message.trim().slice(0, 200) : ''
+    if (message !== '') args.push('-m', message)
+    const result = await runGit(args, { cwd: root, signal, timeoutMs: timeouts.write })
+    return { output: joinOutput(result.stdout, result.stderr) }
+  }
+
+  async function stashPop(params, signal) {
+    const cwd = assertCwd(params.cwd)
+    const resolved = await repoRoot(cwd, signal)
+    const root = resolved.root
+    if (!root) throw new GitError(`当前目录不是 Git 仓库：${cwd}${resolved.error ? `（${resolved.error}）` : ''}`, { code: 'not-a-repo' })
+    const index = assertStashIndex(params.index, 0)
+    const result = await runGit(['stash', 'pop', `stash@{${index}}`], {
+      cwd: root, signal, timeoutMs: timeouts.write,
+    })
+    return { output: joinOutput(result.stdout, result.stderr) }
+  }
+
+  async function stashDrop(params, signal) {
+    const cwd = assertCwd(params.cwd)
+    const resolved = await repoRoot(cwd, signal)
+    const root = resolved.root
+    if (!root) throw new GitError(`当前目录不是 Git 仓库：${cwd}${resolved.error ? `（${resolved.error}）` : ''}`, { code: 'not-a-repo' })
+    const index = assertStashIndex(params.index, 0)
+    const result = await runGit(['stash', 'drop', `stash@{${index}}`], {
+      cwd: root, signal, timeoutMs: timeouts.write,
+    })
+    return { output: joinOutput(result.stdout, result.stderr) }
+  }
+
+  /** 读写自定义提交提示词；传空串表示恢复默认。 */
+  async function setCommitPrompt(params, signal) {
+    const cwd = assertCwd(params.cwd)
+    const resolved = await repoRoot(cwd, signal)
+    const root = resolved.root
+    if (!root) throw new GitError(`当前目录不是 Git 仓库：${cwd}${resolved.error ? `（${resolved.error}）` : ''}`, { code: 'not-a-repo' })
+    const raw = typeof params.prompt === 'string' ? params.prompt : ''
+    if (raw.length > COMMIT_PROMPT_MAX) {
+      throw new GitError(`提示词过长（上限 ${COMMIT_PROMPT_MAX} 字）`, { code: 'invalid-params' })
+    }
+    const value = raw.trim()
+    if (value === '') {
+      // 没设过时 git config --unset 退出码非 0，不算失败。
+      await runGit(['config', '--local', '--unset', COMMIT_PROMPT_KEY], {
+        cwd: root, signal, timeoutMs: timeouts.write, allowFailure: true,
+      })
+    } else {
+      await runGit(['config', '--local', COMMIT_PROMPT_KEY, value], {
+        cwd: root, signal, timeoutMs: timeouts.write,
+      })
+    }
+    const read = await runGit(['config', '--get', COMMIT_PROMPT_KEY], {
+      cwd: root, signal, allowFailure: true,
+    })
+    return { prompt: read.code === 0 ? read.stdout.trim() : '' }
+  }
+
   async function aiCommit(params, signal) {
     const cwd = assertCwd(params.cwd)
     const resolved = await repoRoot(cwd, signal)
@@ -436,6 +545,10 @@ export function createOperations(deps) {
     if (!root) throw new GitError(`当前目录不是 Git 仓库：${cwd}${resolved.error ? `（${resolved.error}）` : ''}`, { code: 'not-a-repo' })
     const hint = typeof params.hint === 'string' ? params.hint.slice(0, 500) : ''
     const context = ai() ?? {}
+    const promptRes = await runGit(['config', '--get', COMMIT_PROMPT_KEY], {
+      cwd: root, signal, allowFailure: true,
+    })
+    const systemPrompt = promptRes.code === 0 ? promptRes.stdout : ''
     return generate({
       runGit: (args, options = {}) => runGit(args, {
         cwd: root,
@@ -448,6 +561,7 @@ export function createOperations(deps) {
       signal,
       llm: context.llm,
       selection: context.selection,
+      systemPrompt,
     })
   }
 
@@ -457,6 +571,7 @@ export function createOperations(deps) {
     diff,
     stage,
     unstage,
+    discard,
     switchBranch,
     deleteBranch,
     commit,
@@ -464,6 +579,10 @@ export function createOperations(deps) {
     pull,
     push,
     aiCommit,
+    stashPush,
+    stashPop,
+    stashDrop,
+    setCommitPrompt,
   }
 
   /**
@@ -507,4 +626,4 @@ export function createOperations(deps) {
   }
 
   return { handle, ops: [...OPS], runGit }
-}
+}