dsh-git-changes 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-review-panel 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.en.md

@@ -0,0 +1,105 @@
+# dsh-git-changes
+
+[![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE) [![DeepSeek Harness](https://img.shields.io/badge/DeepSeek%20Harness-0.2.1%2B-4B6BFB)](https://www.deepseek.com/download/) <br>
+[中文](README.md)
+
+![Side-by-side diff: deleted lines are tinted, switch inline/side-by-side from the toolbar](docs/images/git-changes-diff.png)
+
+> `.gitignore` in side-by-side mode (deleted lines tinted); the right sidebar holds the Git changes panel.
+
+## What is this
+
+`dsh-git-changes` brings a **Cursor-style code review experience** to DeepSeek Harness. It adds a **Code Review** tab to the official right sidebar, showing what changed in this agent turn, in the uncommitted worktree or in any historical git version as full source files with line-level diffs — and it brings the **VS Code shortcuts** you already know. Its left-hand changes panel mirrors the Cursor / VS Code CHANGES view: staged and unstaged groups, stage/unstage one file or all of them, and commit or commit & push right from the panel.
+
+DSH's builtin review shows one hunk at a time; this panel gives you the **whole file** — added lines tinted across the full row, deleted lines kept inline with their original line numbers — plus a file tree, editor tabs and keyboard-driven navigation, so reviewing feels like working in an editor.
+
+- **Full source + inline line-level diffs** — added lines tinted, deleted lines inline with original line numbers
+- **Defaults to the Git uncommitted baseline** — open the panel and review the working tree; use the command palette to compare against an agent turn or any git version
+- **Diff against any git version** — pick any historical commit (or type a branch, tag, `HEAD~2`, …) and review exactly what that commit changed; switch to "changes since this version" to see the cumulative diff up to the current worktree. Especially handy for reviewing the last round right after pushing
+- **VS Code-style workspace** — file tree, editor tabs, Quick Open (`Ctrl+P`), command palette, workspace search
+- **Language-server navigation** — `F12` definition, `Shift+F12` references, hover, document outline, read-only diagnostics
+- **Git changes panel** — `Staged Changes` / `Changes` groups, stage or unstage a file or a whole group, commit message box, commit and commit & push, current branch with ahead/behind
+- **AI commit messages**: the ✨ button in the commit box asks the Host default model to draft a message from the staged (or unstaged) diff; edit it before committing
+- **Line blame**: pause the cursor on a line for about a second to see `author · time · subject` at the line end; hover the annotation for a commit card (author, time, full message, sha)
+- **Commit graph**: a collapsible lane graph at the bottom of the changes panel lists the latest 80 commits; clicking one opens its diff as the baseline
+- **Inline / side-by-side diffs** — one click to switch; `auto` mode picks a layout from the panel width (900px breakpoint)
+- **Controlled git writes** — only touches the git index and commits: never rewrites files, never runs arbitrary commands, never force pushes; every write goes through a session-authenticated local route
+- **Follows the DSH light/dark theme automatically**
+
+## 🆕 What's New
+
+### v0.1.0 · Git changes panel (first release of this fork)
+
+- **Git changes panel** — the Code Review tab now has a `Changes | Project` switch. Changes mode mirrors the Cursor / VS Code CHANGES layout with `Staged Changes (N)` and `Changes (N)` groups, a collapsible tree, and M/A/D/untracked status markers.
+- **Stage & commit** — hover `+` / `−` on a file row to stage or unstage it; group headers offer stage-all / unstage-all; the message box supports `⌘/Ctrl+Enter` to commit and `⌘/Ctrl+Shift+Enter` to commit & push (the `▾` menu next to the primary button does the same); the branch bar shows the current branch with ahead/behind.
+- **Inline / side-by-side diffs** — a new toolbar toggle cycles auto → side-by-side → inline → auto. Clicking a staged file diffs `HEAD → index`; clicking an unstaged file diffs `index → worktree`.
+- **Inherited from upstream** — Agent turn / Git uncommitted / any historical version baselines, VS Code shortcuts, language-server navigation, light/dark theme.
+
+> Upstream history: [dsh-review-panel commits](https://github.com/sadgsk/dsh-review-panel/commits/main).
+
+## Install
+
+Requires **DSH 0.2.1-rc.2** or newer (Desktop and Web both work). Git and language servers are optional; the panel degrades gracefully without them.
+
+### 1. Open the Plugins page
+
+Open **Plugins** in DSH's left sidebar and click **Add plugin** at the top right:
+
+### 2. Paste the repository URL and install
+
+Paste the package name (`dsh-git-changes`) or a local directory path into the input and click **Install**:
+
+### 3. Open Git Review
+
+Restart DSH when prompted. Then click **+** in the right sidebar and choose **Git Review / Git 审查**:
+
+You can also open it from the "本轮修改" pill above the chat input.
+
+## Review changes from a historical git version
+
+The panel defaults to **Git uncommitted** (staged compares against HEAD, unstaged against the index) and opens the first changed file automatically. To use another baseline, open the command palette (`Ctrl+Shift+P` / `Cmd+Shift+P`) and run `Show latest commit`, `Select a git version…`, `Switch to agent turn` or `View code only`.
+
+- **Latest commit**: one click to review what the most recent commit (`HEAD`) changed. Right after a push, this is exactly the last round's diff.
+- **Git version…**: opens the commit history (sha, subject, branch/tag refs and date). After you pick a commit:
+  - **This version's diff** (default) — what that commit introduced relative to its previous version (first parent). Works even when the worktree is clean or has moved on.
+  - **Changes since this version** — the cumulative diff from that version up to the current worktree (committed, staged, unstaged and untracked changes included).
+  - The input below the list also accepts any revision expression (full/short sha, branch, tag, `HEAD~2`, …).
+
+Historical content comes from git. `F12`, find references, hover and the document outline keep working on that snapshot text (a cross-file jump opens the target file at the selected version; its line number comes from the current worktree and may be off); diagnostics stay hidden in this mode so an old snapshot is never mixed with the current project. Worktree baselines restore diagnostics automatically.
+
+## Session switching
+
+The review page remembers each conversation's workspace state: after switching sessions and back, the open files, tabs and diff baseline (including the selected git version) are still there instead of being reset.
+
+## Shortcuts
+
+Every command is registered through DSH's official shortcuts service, so all of them can be rebound in **Settings → General → Keyboard shortcuts**. On macOS, use `Cmd` instead of `Ctrl`; a chord the OS already owns may show as unbound, in which case rebind it in Settings.
+
+| Action | Windows / Linux | macOS |
+| --- | --- | --- |
+| Open Code Review | `Ctrl+Alt+D` | `Cmd+Option+D` |
+| Previous / next change | `Shift+F7` / `F7` | `Shift+F7` / `F7` |
+| Quick Open | `Ctrl+P` (fallback `Ctrl+Alt+P`) | `Cmd+P` (fallback `Cmd+Option+P`) |
+| Command palette | `Ctrl+Shift+P` | `Cmd+Shift+P` |
+| Workspace search | `Ctrl+Shift+F` | `Cmd+Shift+F` |
+| Go to line | `Ctrl+G` | `Cmd+G` |
+| Next / previous tab | `Ctrl+Tab` / `Ctrl+Shift+Tab` | `Cmd+Tab` / `Cmd+Shift+Tab` |
+| Close tab | `Ctrl+F4` | `Cmd+F4` |
+| Show / hide file tree | `Ctrl+Shift+E` | `Cmd+Shift+E` |
+| Document outline | `Ctrl+Shift+O` | `Cmd+Shift+O` |
+| Find in editor | `Ctrl+F` | `Cmd+F` |
+| Go to definition | `F12` / `Ctrl+click` | `F12` / `Cmd+click` |
+| Find references | `Shift+F12` | `Shift+F12` |
+| Fold / unfold block | `Ctrl+Shift+[` / `Ctrl+Shift+]` | `Cmd+Option+[` / `Cmd+Option+]` |
+| Fold / unfold all | `Ctrl+K Ctrl+0` / `Ctrl+K Ctrl+J` | `Cmd+K Cmd+0` / `Cmd+K Cmd+J` |
+| Font zoom | `Ctrl+wheel` / `Ctrl+=` / `Ctrl+-` / `Ctrl+0` | `Cmd+wheel` / `Cmd+=` / `Cmd+-` / `Cmd+0` |
+
+Navigate back / forward has no default chord; bind it in Settings if you want it.
+
+## Feedback
+
+Found a bug, have an idea, or just want to share how you use it? Please report it in the release repository or on the plugin's marketplace page.
+
+## License
+
+[MIT](LICENSE). See [THIRD_PARTY_NOTICES](THIRD_PARTY_NOTICES.md) for third-party components and their licenses.

package/README.md

@@ -1,3 +1,123 @@
-# Temporary Holding Version
+# dsh-git-changes
 
-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.
+[![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE) [![DeepSeek Harness](https://img.shields.io/badge/DeepSeek%20Harness-0.2.1%2B-4B6BFB)](https://www.deepseek.com/download/) <br>
+[English](README.en.md)
+
+![左右并排 diff：删除行整行标红，工具栏可切换内联/左右并排](docs/images/git-changes-diff.png)
+
+> 截图：`.gitignore` 的左右并排 diff（删除行整行标红），右侧栏为 Git 更改面板。
+
+## 这是什么
+
+`dsh-git-changes` 把 **Cursor 式的代码审查体验**带进 DeepSeek Harness：在官方右侧栏里加一个「Git 审查」页，用完整源码 + 行级 diff 展示 Agent 本轮、Git 未提交或任意历史版本改了什么，并把常用的 **VS Code 快捷键操作**搬了过来。左栏的 Git 更改面板复刻了 Cursor/VS Code 的 CHANGES 体验——分组查看暂存的更改与未暂存的更改、逐个或全部暂存/取消暂存、填写提交信息后提交或提交并推送。
+
+DSH 自带的审查是一个个 hunk 片段；这个插件给的是**整个文件**——新增行整行着色，删除行按原行号内联显示，配合文件树、编辑器标签页和键盘操作，像在编辑器里 review 一样。
+
+- **完整源码 + 行级内联 diff**：新增行整行着色，删除行内联保留原行号
+- **默认 Git 未提交基线**：打开即看工作区改动；需要对比本轮对话或任意历史版本时，用命令面板切换
+- **任意 Git 版本 diff**：选中任意历史提交（也可输入分支、标签、`HEAD~2` 等版本引用），直接查看那次提交引入的改动；也能切换到「自该版本以来」查看该版本到当前工作区的累计改动。推送之后再回头 review 上一轮改动尤其方便
+- **VS Code 式工作区**：文件树、编辑器标签页、Quick Open（Ctrl+P）、命令面板、工作区搜索
+- **语言服务导航**：F12 跳转定义、Shift+F12 查找引用、悬停提示、文档大纲、只读诊断
+- **Git 更改面板**：`暂存的更改` / `更改` 两组、文件与分组一键暂存/取消暂存、提交信息框、提交与提交并推送、当前分支与 ahead/behind 显示
+- **AI 生成提交信息**：提交框右侧 ✨ 按钮调用 Host 的默认模型，根据已暂存（无暂存时用未暂存）改动生成提交信息，填入后仍可修改
+- **行级 Blame**：光标在某行停留约 1 秒后，行尾显示「作者 · 时间 · 提交说明」；鼠标移到标注上弹出提交详情卡片（作者、时间、完整 commit message、提交号）
+- **提交图谱**：更改面板底部「提交图谱」折叠区，用 lane 图展示最近 80 条提交，点击任意提交即以该版本为对比基线打开 diff
+- **内联 / 左右并排 diff**：一键切换，`auto` 模式按面板宽度自动选择（900px 阈值）
+- **可控的 Git 写操作**：只碰 Git 索引与提交，不写文件、不执行任意命令、不 force push；所有写操作都走 DSH 会话鉴权的本地接口
+- **自动跟随 DSH 明暗主题**
+
+## 🆕 版本更新
+
+### v0.1.0 · Git 更改面板（本 fork 首个版本）
+
+- **Git 更改面板**：右侧栏「Git 审查」页新增「更改 | 文件树」分段。更改模式按 Cursor/VS Code 的 CHANGES 布局展示 `暂存的更改 (N)` 与 `更改 (N)` 两个分组，目录树折叠、未跟踪/修改/新增/删除状态标记。
+- **暂存与提交**：文件行 hover `+` / `−` 暂存或取消暂存；分组头可一键全部暂存/取消暂存；提交信息框支持 `⌘/Ctrl+Enter` 提交、`⌘/Ctrl+Shift+Enter` 提交并推送，主按钮旁 `▾` 也可选择「提交并推送」；分支栏显示当前分支与 ahead/behind。
+- **内联 / 左右并排 diff**：工具栏新增布局切换（auto → 左右并排 → 内联 → auto）。点击暂存区文件看 `HEAD → 索引` 的改动，点击未暂存文件看 `索引 → 工作区` 的改动。
+- **沿用上游能力**：Agent 本轮 / Git 未提交 / 任意历史版本三种对比基线、VS Code 快捷键、语言服务导航、明暗主题跟随。
+
+> 上游版本的完整改动记录见 [dsh-review-panel 提交历史](https://github.com/sadgsk/dsh-review-panel/commits/main)。
+
+## 安装
+
+需要 **DSH 0.2.1-rc.2** 或更高版本（Desktop 与 Web 均可）。Git 与语言服务器都是可选项，缺失时自动降级。
+
+### 1. 打开插件页
+
+在 DSH 左侧栏打开 **插件**，点右上角的 **添加插件**：
+
+### 2. 粘贴仓库地址并安装
+
+在输入框中粘贴本插件包名（`dsh-git-changes`）或本地目录路径，点 **安装**：
+
+### 3. 打开 Git 审查
+
+安装完成后按提示重启 DSH。之后在右侧栏点 **+**，选择 **Git 审查** 即可：
+
+如果预览入口还没出现，也可以点击聊天输入框上方的「本轮修改」直接打开。
+
+## 查看历史 Git 版本的改动
+
+插件默认固定在 **Git 未提交** 基线（暂存看 HEAD、未暂存看索引），打开面板就会自动选中第一个改动文件。需要看其他基线时，打开命令面板（`Ctrl+Shift+P` / `Cmd+Shift+P`）搜索对应命令：`查看最新提交`、`选择 Git 版本…`、`切换到本轮改动`、`仅代码查看`。
+
+- **最新提交**：查看最近一次提交（`HEAD`）引入的改动。刚 push 完想 review 上一轮时用它。
+- **选择 Git 版本…**：打开提交历史列表（显示 sha、提交说明、分支/标签与时间）。选中一个提交后：
+  - **该版本改动**（默认）：展示该提交相对上一版本（第一父提交）引入的改动，即使工作区已经干净或又有了新提交，也能准确回看那一轮。
+  - **自该版本以来**：展示该版本到当前工作区的累计改动，包含已提交、已暂存、未暂存和新增文件。
+  - 列表下方的输入框也可以直接输入任意版本引用（完整/短 sha、分支、标签、`HEAD~2` 等）。
+
+历史版本的内容来自 Git：`F12`、查找引用、悬停与文档大纲由语言服务器基于该快照文本工作，跨文件跳转会打开目标文件在当前选中版本中的内容（行号取自工作区当前版本，可能略有偏移）；为避免旧快照与新工作区混用产生误报，该模式下不显示诊断标记。切回工作区相关基线后诊断自动恢复。
+
+## 会话切换
+
+审查页会记住每个会话的工作区状态：切换会话再切回来时，仍停留在之前的文件、标签页与对比基线（包括选中的 Git 版本），不会被重置。
+
+## 快捷键
+
+所有命令都注册在 DSH 官方快捷键服务里，可在 **设置 → 通用 → 键盘快捷键** 中重新绑定。macOS 上把 `Ctrl` 换成 `Cmd`；个别组合被系统占用时会显示为未绑定，此时可在设置里改绑。
+
+| 操作 | Windows / Linux | macOS |
+| --- | --- | --- |
+| 打开代码审查 | `Ctrl+Alt+D` | `Cmd+Option+D` |
+| 上一处 / 下一处改动 | `Shift+F7` / `F7` | `Shift+F7` / `F7` |
+| 快速打开文件 | `Ctrl+P`（被占用时 `Ctrl+Alt+P`） | `Cmd+P`（被占用时 `Cmd+Option+P`） |
+| 命令面板 | `Ctrl+Shift+P` | `Cmd+Shift+P` |
+| 工作区搜索 | `Ctrl+Shift+F` | `Cmd+Shift+F` |
+| 跳转到行 | `Ctrl+G` | `Cmd+G` |
+| 下一个 / 上一个标签页 | `Ctrl+Tab` / `Ctrl+Shift+Tab` | `Cmd+Tab` / `Cmd+Shift+Tab` |
+| 关闭标签页 | `Ctrl+F4` | `Cmd+F4` |
+| 显示 / 隐藏文件树 | `Ctrl+Shift+E` | `Cmd+Shift+E` |
+| 文档大纲 | `Ctrl+Shift+O` | `Cmd+Shift+O` |
+| 编辑器内查找 | `Ctrl+F` | `Cmd+F` |
+| 跳转定义 | `F12` / `Ctrl+单击` | `F12` / `Cmd+单击` |
+| 查找引用 | `Shift+F12` | `Shift+F12` |
+| 折叠 / 展开代码块 | `Ctrl+Shift+[` / `Ctrl+Shift+]` | `Cmd+Option+[` / `Cmd+Option+]` |
+| 全部折叠 / 全部展开 | `Ctrl+K Ctrl+0` / `Ctrl+K Ctrl+J` | `Cmd+K Cmd+0` / `Cmd+K Cmd+J` |
+| 字号缩放 | `Ctrl+滚轮` / `Ctrl+=` / `Ctrl+-` / `Ctrl+0` | `Cmd+滚轮` / `Cmd+=` / `Cmd+-` / `Cmd+0` |
+
+导航后退 / 前进默认不占用按键，可在设置里自行绑定。
+
+## 开发与验证
+
+改动任何客户端代码后，先跑完整回归（逐步输出，失败即停）：
+
+```bash
+node scripts/verify.mjs
+```
+
+覆盖：构建 → 语法检查 → Hooks 位置检查 → smoke（client/host 路由）→ 页面状态机 → 快捷键 → git 只读层 → LSP → git 扩展（blame/history/AI 提交信息/discard）。
+
+手工验收清单见 [docs/regression-checklist.md](docs/regression-checklist.md)：重启 DSH NEXT 后逐项确认页签、暂存/放弃、diff 双模式、改动导航、基线记忆等既有功能。
+
+**注意**：DSH Desktop 不支持 Cmd+R，客户端改动需 Cmd+Q 重启应用才会加载新 bundle。
+
+## 来源与致谢
+
+本插件是 [sadgsk/dsh-review-panel](https://github.com/sadgsk/dsh-review-panel) 0.3.1（MIT）的 fork，在其只读代码审查面板基础上新增 Git 更改面板与暂存/提交/推送写操作。上游版权与许可声明见 [THIRD_PARTY_NOTICES](THIRD_PARTY_NOTICES.md)。
+
+## 反馈
+
+使用中遇到问题或有功能建议，欢迎在插件的发布仓库或 DSH 插件市场页面反馈。
+
+## License
+
+采用 [MIT](LICENSE) 许可。第三方组件与对应许可见 [THIRD_PARTY_NOTICES](THIRD_PARTY_NOTICES.md)。

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,12 @@
+# Third-party notices
+
+The following components are distributed with, embedded in, or adapted by dsh-git-changes. Their original notices and license terms are retained in this package.
+
+| Component | Source and attribution | Included license / notices |
+| --- | --- | --- |
+| Monaco Editor AMD distribution and codicon font | Microsoft Corporation; copied from the Monaco assets distributed with `dsh-vscode-mode@0.15.9` | [LICENSE](assets/vendor/monaco/LICENSE), [ThirdPartyNotices.txt](assets/vendor/monaco/ThirdPartyNotices.txt) |
+| Inline diff / Monaco loader reference implementation | [dsh-vscode-mode](https://github.com/Lenonss/DSH_VsCodeMode), copyright (c) 2026 LiuZiLong | [MIT license](licenses/dsh-vscode-mode-LICENSE) |
+| VS Code Seti icon theme data | [vscode-theme-seti](https://github.com/microsoft/vscode/tree/main/extensions/theme-seti), copyright (c) Microsoft Corporation | [MIT license](licenses/vscode-theme-seti-LICENSE) |
+| Embedded Seti icon font and artwork | [seti-ui](https://github.com/jesseweed/seti-ui), copyright (c) 2014 Jesse Weed | [Original Seti notice and MIT license](licenses/vscode-theme-seti-ThirdPartyNotices.txt) |
+
+The generated Seti theme data and embedded WOFF are part of `lib/client.js` (source: `src/client/12-vscode-icons.js`). The original VS Code theme associates these assets with Seti UI revision `2d6c5e68b4ded73c92dac291845ee44e1182d511`.

package/assets/vendor/monaco/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 - present Microsoft Corporation
+
+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.