dsh-git-ui 0.0.1 → 0.0.2

package/README.md

@@ -1,13 +1,23 @@
 # dsh-git-ui
 
+[![npm version](https://img.shields.io/npm/v/dsh-git-ui.svg)](https://www.npmjs.com/package/dsh-git-ui)
+[![npm license](https://img.shields.io/npm/l/dsh-git-ui.svg)](https://www.npmjs.com/package/dsh-git-ui)
+[![npm downloads](https://img.shields.io/npm/dm/dsh-git-ui.svg)](https://www.npmjs.com/package/dsh-git-ui)
+
 A [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (dsh) plugin that visualizes Git status in the Web UI: current branch, HEAD, dirty-state counts (staged / modified / untracked), ahead/behind, recent commits, and changed files — right in the session header, no terminal needed.
 
 > Read this in [简体中文](README.zh.md).
 
+- 📦 **npm**: <https://www.npmjs.com/package/dsh-git-ui>
+- 🐙 **GitHub**: <https://github.com/Julyves/dsh-git-ui>
+- 🐛 **Issues**: <https://github.com/Julyves/dsh-git-ui/issues>
+
 ## Features
 
 - **Branch pill** in the session header (right-aligned, per-session): shows the current branch at a glance, with dirty-state and ahead/behind indicators:
 
+  <img src="docs/screenshots/pill.png" alt="Branch pill in the session header" width="720">
+
   | State | Pill |
   |---|---|
   | Clean | `⎇ main` |
@@ -18,9 +28,19 @@ A [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (dsh) plug
   | Not a git repo | Dimmed `无 Git 仓库` |
   | Git unavailable / error | Dimmed `Git 不可用` (reason in tooltip) |
 
-- **Detail popover** (click the pill): repository root, count grid (staged / modified / untracked / ahead / behind), recent commits (hash · subject · author · relative time), changed-file list with status chips, manual refresh button, and last-checked time.
+- **Detail popover** (click the pill): repository root, count grid (staged / modified / untracked / ahead / behind), recent commits (hash · subject · author · relative time), changed-file list with status chips, manual refresh button, and last-checked time:
+
+  <img src="docs/screenshots/popup.png" alt="Git status detail popup" width="720">
+
+- **Git center** (management panel from the popup): IDE-style changes view — stage / unstage / discard per file or all, and commit with a message (selected files or everything staged). Every operation refreshes the status instantly:
+
+  <img src="docs/screenshots/center.png" alt="Git center changes view" width="720">
+
 - **Always-fresh data, zero interaction**: automatic fetch on session open, silent polling (host-configured interval, default 30s, no overlapping requests), **immediate refresh when an agent turn completes** (best-effort — the working tree most likely changed right then), resync after reconnect, and a manual refresh button.
-- **Deterministic degradation**: non-git directories, missing cwd, missing git, timeouts, and oversized repositories show stable fallback states — never crashes, never spams.
+- **Deterministic degradation**: non-git directories, missing cwd, missing git, timeouts, and oversized repositories show stable fallback states — never crashes, never spams:
+
+  <img src="docs/screenshots/dirty.png" alt="Clean vs dirty vs non-repository states" width="720">
+
 - **Pure read-only UI**: no new model tools, no session events, no impact on agent behavior.
 
 ## Installation
@@ -106,8 +126,6 @@ pnpm run build        # host (esbuild ESM, never minified) + client (ModuleLoade
 dsh plugin --profile web add ./   # local install; restart dsh web to verify
 ```
 
-See [PLAN.md](PLAN.md) for the architecture research and engineering decisions.
-
 ## License
 
 [MIT](LICENSE)

package/README.zh.md

@@ -1,13 +1,23 @@
 # dsh-git-ui
 
+[![npm version](https://img.shields.io/npm/v/dsh-git-ui.svg)](https://www.npmjs.com/package/dsh-git-ui)
+[![npm license](https://img.shields.io/npm/l/dsh-git-ui.svg)](https://www.npmjs.com/package/dsh-git-ui)
+[![npm downloads](https://img.shields.io/npm/dm/dsh-git-ui.svg)](https://www.npmjs.com/package/dsh-git-ui)
+
 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)（dsh）Web UI 插件：在会话界面中可视化展示当前工程的 Git 状态——分支、HEAD、脏状态计数（已暂存/已修改/未跟踪）、领先/落后、最近提交与变更文件。无需切换终端，扫一眼即得。
 
 > English version: [README.md](README.md)
 
+- 📦 **npm**：<https://www.npmjs.com/package/dsh-git-ui>
+- 🐙 **GitHub**：<https://github.com/Julyves/dsh-git-ui>
+- 🐛 **Issues**：<https://github.com/Julyves/dsh-git-ui/issues>
+
 ## 功能特性
 
 - **会话头部分支 Pill**（右侧、每会话独立）：常态只显示分支，脏状态与领先/落后以徽标呈现：
 
+  <img src="docs/screenshots/pill.png" alt="会话头部分支 Pill" width="720">
+
   | 状态 | Pill 显示 |
   |---|---|
   | 干净 | `⎇ main` |
@@ -18,9 +28,19 @@
   | 非 git 仓库 | 弱化显示 `无 Git 仓库` |
   | git 不可用/出错 | 弱化显示 `Git 不可用`（tooltip 显示原因） |
 
-- **详情面板**（点击 pill 展开）：仓库根目录、计数格（已暂存/已修改/未跟踪/领先/落后）、最近提交（哈希·主题·作者·相对时间）、变更文件列表（状态 chip）、手动刷新按钮、上次检查时间。
+- **详情面板**（点击 pill 展开）：仓库根目录、计数格（已暂存/已修改/未跟踪/领先/落后）、最近提交（哈希·主题·作者·相对时间）、变更文件列表（状态 chip）、手动刷新按钮、上次检查时间：
+
+  <img src="docs/screenshots/popup.png" alt="Git 状态详情面板" width="720">
+
+- **Git 中心**（从面板进入的管理面板）：IDE 式变更视图——单文件/全部暂存、取消暂存、丢弃，以及带提交信息的提交（勾选文件或全部已暂存）。每次操作即时刷新状态：
+
+  <img src="docs/screenshots/center.png" alt="Git 中心变更视图" width="720">
+
 - **数据自动保鲜，零操作**：进入会话自动拉取、静默轮询（间隔由主机下发，默认 30s，不重叠请求）、**agent 完成一个回合后立即刷新**（尽力而为——此时工作区最可能已变化）、断线重连 resync、面板内手动刷新。
-- **确定性降级**：非 git 目录、无 cwd、git 缺失、超时、巨型仓库等边界显示稳定降级态——不崩溃、不刷屏。
+- **确定性降级**：非 git 目录、无 cwd、git 缺失、超时、巨型仓库等边界显示稳定降级态——不崩溃、不刷屏：
+
+  <img src="docs/screenshots/dirty.png" alt="干净 / 脏状态 / 非 git 仓库对照" width="720">
+
 - **纯只读 UI**：不给模型新增工具、不写会话事件，不改变 agent 的任何行为。
 
 ## 安装
@@ -103,8 +123,6 @@ pnpm run build        # host（esbuild ESM，禁止压缩）+ client（ModuleLoa
 dsh plugin --profile web add ./   # 本地安装；重启 dsh web 验证
 ```
 
-架构研究与工程决策见 [PLAN.md](PLAN.md)。
-
 ## 许可证
 
 [MIT](LICENSE)