dsh-git-sidebar 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 adamaik
+
+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

@@ -0,0 +1,44 @@
+# dsh-git-sidebar
+
+A draggable right-side Git sidebar for DeepSeek Harness Web. It follows the active workspace, lists changed files, generates commit messages with the model you are already using, and runs commit / push / pull.
+
+## Features
+
+- **Follows the active workspace** — the panel switches to the workspace of the conversation you select, resolving the git root automatically (walking up from the workspace path, or one level down for nested checkouts).
+- **Draggable right-edge entry** — a vertical tab on the right edge of the window; drag it anywhere along the edge, click to toggle the panel.
+- **Change list** — staged / unstaged groups with status badges (M/A/D/R/?), click a file to stage or unstage, stage-all toggle.
+- **Branch switching** — a branch dropdown listing local and remote branches; checkout with a dirty-workspace warning before switching.
+- **AI commit message** — ✨ generates a Conventional Commits style message (Chinese subject) from `git status` + `git diff HEAD` using the current session's default model via the harness `llm` service, then fills the message box for editing.
+- **Actions** — commit (optionally with all changes), push, pull, refresh.
+
+## Install
+
+```sh
+dsh plugin --profile web add dsh-git-sidebar
+```
+
+Or install from this repository:
+
+```sh
+dsh plugin --profile web add "github:adamaik/dsh-git-sidebar#main"
+```
+
+## Usage
+
+The Git tab appears on the right edge of the window. Click it to open the panel; drag it to reposition. Select a conversation in the left sidebar to point the panel at that workspace.
+
+## How it works
+
+- Host half (`lib/index.js`) registers JSON routes on the `webServer` service and runs git commands through the `shell` service; the AI commit message endpoint calls `llm.stream` with the current default model selection.
+- Browser half (`lib/client.js`) is a `dsh.client` module registered into `shell.overlay`; it fetches the host routes and renders the React UI.
+
+## Development
+
+```sh
+node --check lib/index.js
+node --check lib/client.js
+```
+
+## License
+
+MIT

package/README.zh.md

@@ -0,0 +1,44 @@
+# dsh-git-sidebar
+
+用于 DeepSeek Harness Web 的可拖拽右侧 Git 侧栏。跟随当前工作区、列出变更文件、用你正在使用的模型生成提交信息，并支持提交 / 推送 / 拉取。
+
+## 功能
+
+- **跟随当前工作区**——面板自动切换到你选中的会话所属项目，自动解析 Git 仓库根目录（从工作区向上查找，找不到再向下扫一级子目录）。
+- **可拖拽的右侧入口**——窗口右边缘的竖条按钮，可沿边缘上下拖动位置，点击开合面板。
+- **变更列表**——按已暂存 / 未暂存分组，带状态徽标（M/A/D/R/?），点击文件即可暂存或取消暂存，支持一键全部暂存。
+- **分支切换**——分支下拉框列出本地与远程分支；切换前若工作区有未提交变更会弹出警告。
+- **AI 生成提交信息**——✨ 按钮基于 `git status` + `git diff HEAD`，调用当前会话默认模型（走 harness `llm` 服务）生成 Conventional Commits 风格的中文提交信息，并填入注释框供你编辑。
+- **操作按钮**——提交（可选包含全部更改）、推送、拉取、刷新。
+
+## 安装
+
+```sh
+dsh plugin --profile web add dsh-git-sidebar
+```
+
+或从本仓库安装：
+
+```sh
+dsh plugin --profile web add "github:adamaik/dsh-git-sidebar#main"
+```
+
+## 使用
+
+窗口右边缘出现 Git 竖条按钮：点击打开面板，按住可上下拖动。在左侧栏选择某工作区的会话，面板即切换到该项目的 git 状态。
+
+## 原理
+
+- **宿主半**（`lib/index.js`）：通过 `webServer` 服务注册 JSON 路由，用 `shell` 服务执行 git 命令；AI 生成提交信息的接口通过 `llm.stream` 调用当前默认模型。
+- **浏览器半**（`lib/client.js`）：一个注册到 `shell.overlay` 的 `dsh.client` 模块，通过 fetch 调用宿主路由并渲染 React UI。
+
+## 开发
+
+```sh
+node --check lib/index.js
+node --check lib/client.js
+```
+
+## License
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,9 @@
+# dsh-git-sidebar bundle patch: mount the draggable Git sidebar plugin.
+#
+# The host half (package root) runs git commands and registers the
+# package-private RPC handlers; the browser half (dsh.client) is discovered
+# automatically through the package's dsh.client declaration + exports["./client"].
+
+- insert:
+    - id: git-sidebar
+      name: 'dsh-git-sidebar'

package/lib/client.js

@@ -0,0 +1,565 @@
+window.__ModuleLoader__.load({
+  id: "dsh-git-sidebar",
+  factory: (require) => {
+    var module = { exports: {} };
+    var exports = module.exports;
+    Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+    let react = require("react");
+
+    const API_BASE = "/git-sidebar";
+
+    async function api(path, body) {
+      const res = await fetch(`${API_BASE}/${path}`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: body === undefined ? "{}" : JSON.stringify(body),
+      });
+      return res.json();
+    }
+
+    // 跨组件共享开合状态：按钮（写）与面板（读）同步。
+    const store = { open: false, listeners: new Set() };
+    function setOpen(v) {
+      store.open = v;
+      for (const fn of store.listeners) fn();
+    }
+    function useOpen() {
+      const [open, set] = react.useState(store.open);
+      react.useEffect(() => {
+        const fn = () => set(store.open);
+        store.listeners.add(fn);
+        return () => store.listeners.delete(fn);
+      }, []);
+      return open;
+    }
+
+    function GitIcon() {
+      return react.createElement(
+        "svg",
+        { width: 15, height: 15, viewBox: "0 0 16 16", fill: "currentColor", "aria-hidden": true },
+        react.createElement("path", { d: "M9.5 3.25a2.25 2.25 0 1 1 3 2.122V6A2.5 2.5 0 0 1 10 8.5H6a1 1 0 0 0-1 1v1.128a2.251 2.251 0 1 1-1.5 0V5.372a2.25 2.25 0 1 1 1.5 0v1.836A2.493 2.493 0 0 1 6 7h4a1 1 0 0 0 1-1v-.628A2.25 2.25 0 0 1 9.5 3.25Zm-6 0a.75.75 0 1 0 1.5 0 .75.75 0 0 0-1.5 0Zm8.25-.75a.75.75 0 1 0 0 1.5.75.75 0 0 0 0-1.5ZM4.25 12a.75.75 0 1 0 0 1.5.75.75 0 0 0 0-1.5Z" })
+      );
+    }
+
+    function FabButton() {
+      const open = useOpen();
+      const [top, setTop] = react.useState(null);
+      const [dragging, setDragging] = react.useState(false);
+      const dragRef = react.useRef(null);
+
+      const onMouseDown = react.useCallback((e) => {
+        if (e.button !== 0) return;
+        e.preventDefault();
+        const startTop = top === null ? (window.innerHeight - 92) / 2 : top;
+        dragRef.current = { startY: e.clientY, startTop, moved: false };
+        const onMove = (ev) => {
+          const d = dragRef.current;
+          if (!d) return;
+          const dy = ev.clientY - d.startY;
+          if (Math.abs(dy) > 2) d.moved = true;
+          const maxTop = window.innerHeight - 92 - 8;
+          setTop(Math.max(4, Math.min(d.startTop + dy, maxTop)));
+        };
+        const onUp = () => {
+          dragRef.current = null;
+          setDragging(false);
+          window.removeEventListener("mousemove", onMove);
+          window.removeEventListener("mouseup", onUp);
+        };
+        setDragging(true);
+        window.addEventListener("mousemove", onMove);
+        window.addEventListener("mouseup", onUp);
+      }, [top]);
+
+      const onClick = () => {
+        const d = dragRef.current;
+        if (d && d.moved) return;
+        setOpen(!open);
+      };
+
+      return react.createElement(
+        "button",
+        {
+          className: "dshgit-fab" + (open ? " active" : "") + (dragging ? " dragging" : ""),
+          style: top === null ? undefined : { top: `${top}px` },
+          title: open ? "关闭 Git 面板" : "打开 Git 面板",
+          onMouseDown,
+          onClick,
+          "aria-label": "Git 面板",
+        },
+        react.createElement(GitIcon, null),
+        react.createElement("span", { className: "dshgit-fab-label" }, "Git")
+      );
+    }
+
+    function GitPanel(props) {
+      const [status, setStatus] = react.useState(null);
+      const [loading, setLoading] = react.useState(false);
+      const [msg, setMsg] = react.useState("");
+      const [gen, setGen] = react.useState(false);
+      const [busy, setBusy] = react.useState("");
+      const [err, setErr] = react.useState("");
+      const [ok, setOk] = react.useState("");
+      const [all, setAll] = react.useState(true);
+      const [branchOpen, setBranchOpen] = react.useState(false);
+      const [branches, setBranches] = react.useState(null);
+      const [pendingCheckout, setPendingCheckout] = react.useState(null);
+
+      // 标准 props：useSessions selector hook（框架提供，非注入服务）。
+      // 会话变化会触发本组件重渲染，useSessions 返回最新 current/row。
+      const useSessions = props && typeof props.useSessions === "function" ? props.useSessions : undefined;
+      const sessionRow = useSessions
+        ? useSessions((s) => (s && s.current && s.byId ? s.byId[s.current] : undefined))
+        : undefined;
+      const cwd = useSessions ? (sessionRow && sessionRow.cwd) || "" : "";
+
+      const refresh = react.useCallback(async () => {
+        setLoading(true);
+        setErr("");
+        setOk("");
+        try {
+          const r = await api("status", { cwd });
+          if (r && r.ok) setStatus(r);
+          else setErr((r && r.error) || "获取状态失败");
+        } catch (e) {
+          setErr(String((e && e.message) || e));
+        }
+        setLoading(false);
+      }, [cwd]);
+
+      // 会话/工作区切换后自动刷新到新目录
+      react.useEffect(() => {
+        refresh();
+      }, [refresh]);
+
+      function loadBranches() {
+        setBranches(null);
+        api("branches", { cwd: cwd })
+          .then((r) => {
+            if (r && r.ok) setBranches(r);
+            else if (r && !r.ok) setErr((r && r.error) || "获取分支失败");
+          })
+          .catch((e) => {
+            setBranches(null);
+            setErr(String((e && e.message) || e));
+          });
+      }
+
+      function toggleBranch() {
+        if (branchOpen) {
+          setBranchOpen(false);
+          return;
+        }
+        setBranchOpen(true);
+        loadBranches();
+      }
+
+      function pickBranch(b) {
+        setBranchOpen(false);
+        if (status && b.name === status.branch) return;
+        const dirty = status && status.files && status.files.length > 0;
+        if (dirty) {
+          setPendingCheckout(b);
+          return;
+        }
+        doCheckout(b);
+      }
+
+      function doCheckout(b) {
+        setBusy("切换");
+        setErr("");
+        setOk("");
+        api("checkout", { name: b.name, isRemote: !!b.isRemote, cwd: cwd })
+          .then(async (r) => {
+            if (r && r.ok) {
+              if (r.notice) setOk(r.notice);
+              const [s, br] = await Promise.all([
+                api("status", { cwd: cwd }),
+                api("branches", { cwd: cwd }),
+              ]);
+              if (s && s.ok) setStatus(s);
+              if (br && br.ok) setBranches(br);
+              setPendingCheckout(null);
+            } else {
+              setErr((r && r.error) || "切换分支失败");
+              setPendingCheckout(null);
+            }
+          })
+          .catch((e) => {
+            setErr(String((e && e.message) || e));
+            setPendingCheckout(null);
+          })
+          .finally(() => setBusy(""));
+      }
+
+      function doOp(label, fn) {
+        setBusy(label);
+        setErr("");
+        setOk("");
+        Promise.resolve(fn())
+          .then(async (r) => {
+            if (r && r.ok) {
+              if (r.notice) setOk(r.notice);
+              try {
+                const s = await api("status", { cwd: cwd });
+                if (s && s.ok) setStatus(s);
+              } catch (e) {}
+            } else {
+              setErr((r && r.error) || label + "失败");
+            }
+          })
+          .catch((e) => setErr(String((e && e.message) || e)))
+          .finally(() => setBusy(""));
+      }
+
+      function doGenerate() {
+        setGen(true);
+        setErr("");
+        setOk("");
+        api("generate", { cwd: cwd })
+          .then((r) => {
+            if (r && r.ok) {
+              setMsg(r.message);
+              setOk("已生成，可直接编辑后提交");
+            } else {
+              setErr((r && r.error) || "生成失败");
+            }
+          })
+          .catch((e) => setErr(String((e && e.message) || e)))
+          .finally(() => setGen(false));
+      }
+
+      function toggleFile(f) {
+        doOp(f.staged ? "取消暂存" : "暂存", () =>
+          api("stage", { paths: [f.path], staged: !f.staged, cwd: cwd }));
+      }
+
+      function commit() {
+        doOp("提交", () => api("commit", { message: msg, all, cwd: cwd }));
+      }
+
+      function badgeLetter(f) {
+        if (f.untracked) return "?";
+        if (f.staged && f.code[0] !== " ") return f.code[0];
+        if (f.code[1] !== " " && f.code[1] !== "?") return f.code[1];
+        return f.code[0];
+      }
+
+      function badgeCls(f) {
+        const L = badgeLetter(f);
+        const cls = { M: "M", A: "A", D: "D", R: "R", C: "C", U: "U" }[L];
+        return cls ? " dshgit-badge-" + cls : "";
+      }
+
+      function FileRow(f) {
+        return react.createElement(
+          "button",
+          {
+            key: f.path,
+            className: "dshgit-file" + (f.staged ? " staged" : ""),
+            onClick: () => toggleFile(f),
+            title: (f.staged ? "取消暂存：" : "暂存：") + f.path,
+          },
+          react.createElement("span", { className: "dshgit-badge" + badgeCls(f) }, badgeLetter(f)),
+          react.createElement("span", { className: "dshgit-filepath" }, f.path)
+        );
+      }
+
+      const files = (status && status.files) || [];
+      const staged = files.filter((f) => f.staged);
+      const rest = files.filter((f) => !f.staged);
+      const dirtyCount = files.length;
+
+      const branchDesc =
+        !status
+          ? "加载中…"
+          : status.upstream
+            ? "→ " + status.upstream.split("/").slice(1).join("/") +
+              (status.ahead || status.behind
+                ? " (" + (status.ahead ? "领先 " + status.ahead : "") +
+                  (status.ahead && status.behind ? " / " : "") +
+                  (status.behind ? "落后 " + status.behind : "") + ")"
+                : "")
+            : "（无上游分支）";
+
+      const branchItems = (branches && branches.branches) || null;
+
+      return react.createElement(
+        "div",
+        null,
+        react.createElement("div", { className: "dshgit-scrim", onClick: () => setOpen(false) }),
+        react.createElement(
+          "div",
+          { className: "dshgit-panel" },
+          react.createElement(
+            "div",
+            { className: "dshgit-head" },
+            react.createElement(
+              "div",
+              { className: "dshgit-title" },
+              react.createElement(GitIcon, null),
+              react.createElement("span", null, "Git 面板")
+            ),
+            react.createElement("button", { className: "dshgit-close", title: "关闭", onClick: () => setOpen(false) }, "✕")
+          ),
+          react.createElement(
+            "div",
+            { className: "dshgit-meta" },
+            react.createElement(
+              "div",
+              { className: "dshgit-branch" },
+              react.createElement(
+                "button",
+                { className: "dshgit-branch-chip", title: "切换分支", onClick: toggleBranch },
+                react.createElement("span", null, status ? status.branch : "…"),
+                react.createElement("span", { className: "dshgit-caret" }, "▼")
+              ),
+              react.createElement("span", { className: "dshgit-branch-desc" }, branchDesc),
+              branchOpen && branchItems
+                ? react.createElement(
+                    "div",
+                    { className: "dshgit-dropdown" },
+                    branchItems.map((b) =>
+                      react.createElement(
+                        "button",
+                        {
+                          key: (b.isRemote ? "r:" : "l:") + b.name,
+                          className:
+                            "dshgit-drop-item" +
+                            (status && b.name === status.branch ? " active" : "") +
+                            (b.isRemote ? " remote" : ""),
+                          onClick: () => pickBranch(b),
+                        },
+                        react.createElement("span", null, b.name),
+                        status && b.name === status.branch
+                          ? react.createElement("span", { className: "dshgit-drop-tag" }, "当前")
+                          : null,
+                        b.isRemote ? react.createElement("span", { className: "dshgit-drop-tag" }, "remote") : null
+                      )
+                    )
+                  )
+                : null
+            ),
+            pendingCheckout
+              ? react.createElement(
+                  "div",
+                  { className: "dshgit-warn" },
+                  react.createElement("span", null, `工作区有 ${dirtyCount} 个未提交变更，切换分支可能丢失，确定继续？`),
+                  react.createElement(
+                    "span",
+                    { className: "dshgit-warnbtns" },
+                    react.createElement("button", { className: "dshgit-btn dshgit-btn-danger", disabled: !!busy, onClick: () => doCheckout(pendingCheckout) }, "确认切换"),
+                    react.createElement("button", { className: "dshgit-btn", disabled: !!busy, onClick: () => setPendingCheckout(null) }, "取消")
+                  )
+                )
+              : null,
+            react.createElement("div", { className: "dshgit-rootpath", title: status ? status.root : "" }, status ? status.root : "")
+          ),
+          react.createElement(
+            "div",
+            { className: "dshgit-toolbar" },
+            react.createElement("button", { className: "dshgit-btn", disabled: !!busy, onClick: refresh }, "刷新"),
+            react.createElement(
+              "button",
+              {
+                className: "dshgit-btn",
+                disabled: !!busy || !files.length,
+                onClick: () =>
+                  doOp("全部操作", () =>
+                    api("stage", { paths: files.map((f) => f.path), staged: rest.length > 0, cwd: cwd })),
+              },
+              rest.length > 0 ? "全部暂存" : "全部取消"
+            )
+          ),
+          react.createElement(
+            "div",
+            { className: "dshgit-files" },
+            !status && loading
+              ? react.createElement("div", { className: "dshgit-nofiles" }, "加载中…")
+              : status && files.length === 0
+                ? react.createElement("div", { className: "dshgit-nofiles" }, "工作区干净，没有变更 ✓")
+                : react.createElement(
+                    react.Fragment,
+                    null,
+                    staged.length
+                      ? react.createElement(
+                          react.Fragment,
+                          null,
+                          react.createElement("div", { className: "dshgit-section-title" }, "已暂存 ( " + staged.length + " )"),
+                          staged.map(FileRow)
+                        )
+                      : null,
+                    rest.length
+                      ? react.createElement(
+                          react.Fragment,
+                          null,
+                          react.createElement("div", { className: "dshgit-section-title" }, "未暂存 ( " + rest.length + " )"),
+                          rest.map(FileRow)
+                        )
+                      : null
+                  )
+          ),
+          react.createElement(
+            "div",
+            { className: "dshgit-commitbox" },
+            react.createElement("textarea", {
+              className: "dshgit-msg",
+              placeholder: "输入提交信息…（或点击 ✨ 自动生成）",
+              value: msg,
+              onChange: (e) => setMsg(e.target.value),
+            }),
+            react.createElement(
+              "div",
+              { className: "dshgit-genrow" },
+              react.createElement(
+                "button",
+                { className: "dshgit-btn dshgit-btn-gen", disabled: gen || !!busy || !status || status.clean, onClick: doGenerate },
+                gen ? "生成中…" : "✨ 自动生成"
+              ),
+              react.createElement(
+                "label",
+                null,
+                react.createElement("input", { type: "checkbox", checked: all, onChange: (e) => setAll(e.target.checked) }),
+                "提交时包含全部更改"
+              )
+            ),
+            react.createElement(
+              "div",
+              { className: "dshgit-actions" },
+              react.createElement(
+                "button",
+                { className: "dshgit-btn dshgit-btn-primary", disabled: busy === "提交" || !msg.trim(), onClick: commit },
+                busy === "提交" ? "提交中…" : "提交"
+              ),
+              react.createElement(
+                "button",
+                { className: "dshgit-btn", disabled: !!busy, onClick: () => doOp("推送", () => api("push", { cwd: cwd })) },
+                busy === "推送" ? "推送中…" : "推送"
+              ),
+              react.createElement(
+                "button",
+                { className: "dshgit-btn", disabled: !!busy, onClick: () => doOp("拉取", () => api("pull", { cwd: cwd })) },
+                busy === "拉取" ? "拉取中…" : "拉取"
+              )
+            ),
+            ok ? react.createElement("div", { className: "dshgit-status ok" }, ok) : null,
+            err ? react.createElement("div", { className: "dshgit-status err" }, err) : null,
+            loading && status ? react.createElement("div", { className: "dshgit-status load" }, "刷新中…") : null
+          )
+        )
+      );
+    }
+
+    function SidebarToggle() {
+      const open = useOpen();
+      return react.createElement(
+        "button",
+        { className: "dshgit-toggle" + (open ? " active" : ""), title: "Git 面板", onClick: () => setOpen(true) },
+        react.createElement(GitIcon, null)
+      );
+    }
+
+    const inject = ["slots"];
+
+    function apply(ctx) {
+      // 注入样式表（插件级样式，卸载自动移除）
+      const tag = document.createElement("style");
+      tag.dataset.plugin = "dsh-git-sidebar";
+      tag.textContent = `
+.dshgit-layer{pointer-events:none}
+.dshgit-fab{position:fixed;right:0;top:50%;pointer-events:auto;z-index:2147483000;width:32px;height:92px;display:flex;flex-direction:column;align-items:center;justify-content:center;gap:6px;border:none;border-radius:9px 0 0 9px;border-right:1px solid var(--dsw-alias-border-l1,rgba(255,255,255,.1));background:var(--dsw-alias-bg-layer-1,#1e1f22);color:var(--dsw-alias-label-secondary,#9aa0a6);cursor:grab;box-shadow:-4px 0 14px rgba(0,0,0,.25);font-family:inherit;user-select:none;touch-action:none}
+.dshgit-fab:active{cursor:grabbing}
+.dshgit-fab:hover{color:var(--dsw-alias-label-primary,#e6e8eb);background:var(--dsw-alias-bg-overlay,#26272b)}
+.dshgit-fab.active{color:var(--dsw-alias-brand-primary,#7aa5ff);background:rgba(76,141,255,.14);border-color:var(--dsw-alias-brand-primary,#4c8dff)}
+.dshgit-fab-label{writing-mode:vertical-rl;font-size:10.5px;letter-spacing:2px;font-weight:600;pointer-events:none}
+.dshgit-scrim{position:fixed;inset:0;pointer-events:auto;background:rgba(0,0,0,.35)}
+.dshgit-panel{position:fixed;top:0;right:0;bottom:0;width:400px;max-width:88vw;pointer-events:auto;background:var(--dsw-alias-bg-layer-1,#1e1f22);border-left:1px solid var(--dsw-alias-border-l1,rgba(255,255,255,.1));display:flex;flex-direction:column;box-shadow:-8px 0 24px rgba(0,0,0,.25);animation:dshgitIn .18s ease-out;font-family:-apple-system,BlinkMacSystemFont,'Segoe UI','PingFang SC','Microsoft YaHei',sans-serif}
+@keyframes dshgitIn{from{transform:translateX(24px);opacity:0}to{transform:none;opacity:1}}
+.dshgit-head{display:flex;align-items:center;gap:8px;padding:10px 14px;border-bottom:1px solid var(--dsw-alias-border-l1,rgba(255,255,255,.08))}
+.dshgit-title{font-weight:600;font-size:13px;color:var(--dsw-alias-label-primary,#e6e8eb);flex:1;display:flex;align-items:center;gap:7px}
+.dshgit-close{background:none;border:none;color:var(--dsw-alias-label-secondary,#9aa0a6);cursor:pointer;font-size:15px;line-height:1;padding:3px 8px;border-radius:4px}
+.dshgit-close:hover{background:rgba(127,127,127,.15);color:var(--dsw-alias-label-primary,#e6e8eb)}
+.dshgit-meta{padding:8px 14px 10px;border-bottom:1px solid var(--dsw-alias-border-l1,rgba(255,255,255,.08));display:flex;flex-direction:column;gap:6px}
+.dshgit-branch{display:flex;align-items:center;gap:8px;font-weight:600;font-size:12.5px;color:var(--dsw-alias-label-primary,#e6e8eb);position:relative;align-items:flex-start}
+.dshgit-branch-chip{border:1px solid var(--dsw-alias-border-l2,rgba(255,255,255,.16));border-radius:999px;padding:1px 9px;font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-weight:500;display:inline-flex;align-items:center;gap:4px;cursor:pointer;background:none;color:var(--dsw-alias-label-primary,#e6e8eb);flex-shrink:0;white-space:nowrap;max-width:200px;overflow:hidden;text-overflow:ellipsis}
+.dshgit-branch-chip:hover{border-color:var(--dsw-alias-brand-primary,#4c8dff);color:var(--dsw-alias-brand-primary,#7aa5ff)}
+.dshgit-caret{font-size:9px;opacity:.75}
+.dshgit-branch-desc{font-size:11px;color:var(--dsw-alias-label-secondary,#9aa0a6);word-break:break-all;line-height:1.5;min-width:0;flex:1}
+.dshgit-dropdown{position:absolute;top:26px;left:0;z-index:10;min-width:220px;max-width:320px;max-height:260px;overflow-y:auto;background:var(--dsw-alias-bg-overlay,#26272b);border:1px solid var(--dsw-alias-border-l2,rgba(255,255,255,.16));border-radius:8px;box-shadow:0 10px 30px rgba(0,0,0,.4);padding:4px}
+.dshgit-drop-item{display:flex;align-items:center;gap:6px;width:100%;padding:5px 8px;border:none;border-radius:5px;background:none;cursor:pointer;color:var(--dsw-alias-label-primary,#e6e8eb);font-size:12px;text-align:left;font-family:ui-monospace,SFMono-Regular,Menlo,monospace;word-break:break-all}
+.dshgit-drop-item:hover{background:rgba(127,127,127,.15)}
+.dshgit-drop-item.active{color:var(--dsw-alias-brand-primary,#7aa5ff);font-weight:600}
+.dshgit-drop-item.remote{opacity:.8}
+.dshgit-drop-tag{font-size:9px;border:1px solid var(--dsw-alias-border-l2,rgba(255,255,255,.2));border-radius:4px;padding:0 4px;color:var(--dsw-alias-label-secondary,#9aa0a6);margin-left:auto;flex-shrink:0}
+.dshgit-rootpath{font-size:11px;color:var(--dsw-alias-label-secondary,#9aa0a6);overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+.dshgit-warn{display:flex;align-items:center;gap:8px;flex-wrap:wrap;margin-top:6px;padding:7px 9px;border:1px solid var(--dsw-alias-state-warn-primary,#e5a50a);border-radius:7px;background:rgba(229,165,10,.08);font-size:11.5px;color:var(--dsw-alias-state-warn-primary,#e5a50a)}
+.dshgit-warnbtns{display:flex;gap:6px;margin-left:auto}
+.dshgit-toolbar{display:flex;gap:6px;padding:8px 14px;border-bottom:1px solid var(--dsw-alias-border-l1,rgba(255,255,255,.08));flex-wrap:wrap}
+.dshgit-btn{background:var(--dsw-alias-bg-overlay,#26272b);border:1px solid var(--dsw-alias-border-l1,rgba(255,255,255,.12));color:var(--dsw-alias-label-primary,#e6e8eb);border-radius:6px;padding:4px 11px;font-size:12px;cursor:pointer}
+.dshgit-btn:hover:not(:disabled){background:rgba(127,127,127,.18)}
+.dshgit-btn:disabled{opacity:.45;cursor:default}
+.dshgit-btn-primary{background:var(--dsw-alias-brand-primary,#4c8dff);border-color:transparent;color:#fff;font-weight:600}
+.dshgit-btn-danger{border-color:var(--dsw-alias-state-warn-primary,#e5a50a);color:var(--dsw-alias-state-warn-primary,#e5a50a)}
+.dshgit-btn-gen{border-color:var(--dsw-alias-brand-primary,#4c8dff);color:var(--dsw-alias-brand-primary,#7aa5ff)}
+.dshgit-files{flex:1;overflow-y:auto;min-height:0}
+.dshgit-section-title{padding:6px 14px 2px;font-size:11px;font-weight:600;color:var(--dsw-alias-label-secondary,#9aa0a6)}
+.dshgit-file{display:flex;align-items:center;gap:8px;width:100%;padding:4px 14px;background:none;border:none;cursor:pointer;color:var(--dsw-alias-label-primary,#e6e8eb);text-align:left}
+.dshgit-file:hover{background:rgba(127,127,127,.12)}
+.dshgit-file.staged{opacity:.82}
+.dshgit-badge{display:inline-flex;align-items:center;justify-content:center;min-width:22px;height:18px;border-radius:4px;font-size:10.5px;font-weight:700;font-family:ui-monospace,SFMono-Regular,Menlo,monospace;background:rgba(127,127,127,.22);color:var(--dsw-alias-label-secondary,#c8ccd2)}
+.dshgit-badge.M{color:var(--dsw-alias-state-warn-primary,#e5a50a)}
+.dshgit-badge.A{color:var(--dsw-alias-state-success-primary,#3fb950)}
+.dshgit-badge.D{color:var(--dsw-alias-state-error-primary,#f85149)}
+.dshgit-badge.R,.dshgit-badge.C{color:var(--dsw-alias-brand-primary,#7aa5ff)}
+.dshgit-badge.U{color:var(--dsw-alias-state-error-primary,#f85149)}
+.dshgit-filepath{font-size:12.5px;font-family:ui-monospace,SFMono-Regular,Menlo,monospace;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;flex:1}
+.dshgit-nofiles{padding:18px 14px;font-size:12px;color:var(--dsw-alias-label-secondary,#9aa0a6)}
+.dshgit-commitbox{border-top:1px solid var(--dsw-alias-border-l1,rgba(255,255,255,.08));padding:10px 14px;display:flex;flex-direction:column;gap:8px}
+.dshgit-msg{width:100%;box-sizing:border-box;min-height:74px;resize:vertical;background:var(--dsw-alias-bg-base,#141518);border:1px solid var(--dsw-alias-border-l2,rgba(255,255,255,.14));border-radius:8px;color:var(--dsw-alias-label-primary,#e6e8eb);font-size:13px;font-family:inherit;padding:8px 10px;outline:none}
+.dshgit-msg:focus{border-color:var(--dsw-alias-brand-primary,#4c8dff)}
+.dshgit-genrow{display:flex;align-items:center;gap:10px;flex-wrap:wrap}
+.dshgit-genrow label{display:flex;align-items:center;gap:5px;font-size:11.5px;color:var(--dsw-alias-label-secondary,#9aa0a6);cursor:pointer}
+.dshgit-actions{display:flex;gap:6px;align-items:center}
+.dshgit-actions .dshgit-btn{flex:1;padding:6px 8px;font-size:12.5px}
+.dshgit-status{font-size:11.5px;line-height:1.45;word-break:break-word;max-height:72px;overflow-y:auto}
+.dshgit-status.err{color:var(--dsw-alias-state-error-primary,#f85149)}
+.dshgit-status.ok{color:var(--dsw-alias-state-success-primary,#3fb950)}
+.dshgit-status.load{color:var(--dsw-alias-label-secondary,#9aa0a6)}
+.dshgit-toggle{display:inline-flex;align-items:center;justify-content:center;width:28px;height:28px;border-radius:6px;border:none;background:none;color:var(--dsw-alias-label-secondary,#9aa0a6);cursor:pointer}
+.dshgit-toggle:hover{background:rgba(127,127,127,.15);color:var(--dsw-alias-label-primary,#e6e8eb)}
+.dshgit-toggle.active{color:var(--dsw-alias-brand-primary,#7aa5ff);background:rgba(76,141,255,.15)}
+`;
+      ctx.effect(() => {
+        document.head.append(tag);
+        return () => tag.remove();
+      }, "dsh-git-sidebar: styles");
+
+      const slots = ctx.get("slots");
+      if (slots === undefined) return;
+
+      // 根层组件：按钮常驻，面板仅在 open 时挂载（避免 scrim/面板常驻全屏挡住交互）
+      function GitLayer(props) {
+        const open = useOpen();
+        return react.createElement(
+          "div",
+          { className: "dshgit-layer" },
+          react.createElement(FabButton, null),
+          open ? react.createElement(GitPanel, props) : null
+        );
+      }
+
+      slots.inject(
+        "shell.overlay",
+        () =>
+          slots.register(
+            { name: "shell.overlay", id: "dsh-git-sidebar", order: 300, label: "Git 面板" },
+            (props) => react.createElement(GitLayer, props)
+          )
+      );
+    }
+
+    exports.inject = inject;
+    exports.apply = apply;
+    return module.exports;
+  },
+});

package/lib/index.js

@@ -0,0 +1,358 @@
+/**
+ * dsh-git-sidebar — draggable right-side Git sidebar (host half)
+ *
+ * Registers JSON endpoints served to the browser:
+ *   /git-sidebar/status     — branch, upstream, ahead/behind, changed files
+ *   /git-sidebar/branches   — local + remote branch list
+ *   /git-sidebar/checkout   — switch branch (refuses a dirty workspace)
+ *   /git-sidebar/stage      — stage / unstage files
+ *   /git-sidebar/commit     — stage-all + commit
+ *   /git-sidebar/push       — git push
+ *   /git-sidebar/pull       — git pull
+ *   /git-sidebar/generate   — AI commit message from git status + diff
+ *
+ * Transport: the webServer service registers the routes; the browser half
+ * fetches JSON. Only scalars/arrays are serialized — no live objects.
+ *
+ * The git root is resolved per request from the workspace cwd passed by the
+ * client, walking up to find .git and caching per workspace.
+ */
+
+export const name = 'dsh-git-sidebar'
+// Dependencies must be declared via `inject` (ctx.get may return undefined for them)
+export const inject = ['webServer', 'shell', 'sandboxPolicy']
+
+const API_BASE = '/git-sidebar'
+const MAX_BODY_BYTES = 4 * 1024 * 1024
+const STATUS_CHARS = [' ', '?', 'A', 'M', 'D', 'R', 'C', 'T', 'U']
+
+function dirname(p) {
+  const s = String(p).replace(/[\\/]+$/, '')
+  const i = s.lastIndexOf('/')
+  if (i <= 0) return i === 0 ? '/' : ''
+  return s.slice(0, i)
+}
+
+function shq(s) {
+  return `'${String(s).replace(/'/g, `'\\''`)}'`
+}
+
+function isConflict(code) {
+  const x = code[0]
+  const y = code[1]
+  return x === 'U' || y === 'U' || (x === 'A' && y === 'A') || (x === 'D' && y === 'D')
+}
+
+function looksLikeStatus(rec) {
+  return (
+    rec.length >= 3 &&
+    STATUS_CHARS.indexOf(rec[0]) >= 0 &&
+    STATUS_CHARS.indexOf(rec[1]) >= 0 &&
+    rec[2] === ' '
+  )
+}
+
+async function readJson(req) {
+  const chunks = []
+  let size = 0
+  for await (const chunk of req) {
+    const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk)
+    size += buffer.length
+    if (size > MAX_BODY_BYTES) throw new Error('request body too large')
+    chunks.push(buffer)
+  }
+  if (chunks.length === 0) return null
+  return JSON.parse(Buffer.concat(chunks).toString('utf8'))
+}
+
+function sendJson(res, status, body) {
+  res.writeHead(status, {
+    'content-type': 'application/json; charset=utf-8',
+    'cache-control': 'no-store',
+    'x-content-type-options': 'nosniff',
+  })
+  res.end(JSON.stringify(body))
+}
+
+export function apply(ctx) {
+  const webServer = ctx.webServer
+  const shell = ctx.shell
+  const sp = ctx.get('sandboxPolicy')
+  const llm = ctx.get('llm')
+  const adm = ctx.get('agentDefaultModel')
+  if (webServer === undefined || shell === undefined) return
+  const defaultBase = sp && sp.workspaceRoot ? sp.workspaceRoot : undefined
+  const rootCache = new Map()
+
+  async function gitRun(cmd, opts) {
+    try {
+      const request = {
+        command: cmd,
+        workdir: (opts && opts.cwd) || defaultBase || undefined,
+        timeoutMs: (opts && opts.timeoutMs) || 60000,
+        stdoutMaxBytes: (opts && opts.cap) || 4 * 1024 * 1024,
+      }
+      const spec = shell.resolve(request)
+      const r = await shell.run(spec)
+      const stdout = (r.stdout && r.stdout.text) || ''
+      const stderr = (r.stderr && r.stderr.text) || ''
+      return { ok: r.exitCode === 0, exitCode: r.exitCode, stdout, stderr }
+    } catch (err) {
+      return { ok: false, exitCode: null, stdout: '', stderr: '', error: String((err && err.message) || err) }
+    }
+  }
+
+  async function findGitRoot(base) {
+    const start = base || defaultBase
+    if (start === undefined) return undefined
+    if (rootCache.has(start)) return rootCache.get(start)
+    let found
+    let dir = start
+    for (let i = 0; i < 8; i++) {
+      const r = await gitRun('git rev-parse --show-toplevel', { cwd: dir })
+      if (r.ok && r.stdout.trim()) {
+        found = r.stdout.trim().split('\n')[0]
+        break
+      }
+      const parent = dirname(dir)
+      if (!parent || parent === dir) break
+      dir = parent
+    }
+    if (!found) {
+      const f = await gitRun(`find ${shq(start)} -maxdepth 2 -name .git -type d 2>/dev/null | head -1`, { cwd: start, cap: 4096 })
+      if (f.ok && f.stdout.trim()) {
+        const parent = dirname(f.stdout.trim().split('\n')[0])
+        if (parent) {
+          const v = await gitRun('git rev-parse --show-toplevel', { cwd: parent })
+          if (v.ok && v.stdout.trim()) found = v.stdout.trim().split('\n')[0]
+        }
+      }
+    }
+    rootCache.set(start, found)
+    return found
+  }
+
+  async function readStatus(base) {
+    const start = base || defaultBase
+    const root = await findGitRoot(start)
+    if (!root) {
+      return { ok: false, error: `未找到 Git 仓库：${start || '当前工作区'} 及上级目录均无 .git` }
+    }
+    const r = await gitRun('git status --porcelain=v1 -z -b', { cwd: root, cap: 2 * 1024 * 1024 })
+    if (!r.ok) return { ok: false, error: (r.stderr || r.stdout || 'git status 失败').trim() }
+    const parts = r.stdout.split('\0')
+    const header = (parts[0] || '').replace(/\n$/, '')
+    let branch = '?', upstream = ''
+    let ahead = 0, behind = 0
+    const m = /^## (.+?)(?:\.\.\.(.+?))?(?: \[(.*)\])?$/.exec(header)
+    if (m) {
+      branch = m[1]
+      upstream = m[2] || ''
+      const info = m[3] || ''
+      const am = /ahead (\d+)/.exec(info)
+      const bm = /behind (\d+)/.exec(info)
+      ahead = am ? parseInt(am[1], 10) : 0
+      behind = bm ? parseInt(bm[1], 10) : 0
+    }
+    const files = []
+    for (let i = 1; i < parts.length; i++) {
+      const rec = parts[i] || ''
+      if (!rec) continue
+      if (!looksLikeStatus(rec)) continue
+      const x = rec[0]
+      const y = rec[1]
+      const path = rec.slice(3)
+      if (!path) continue
+      const untracked = x === '?' && y === '?'
+      files.push({
+        path,
+        code: untracked ? '??' : x + y,
+        staged: !untracked && x !== ' ',
+        unstaged: !untracked && y !== ' ' && y !== '?',
+        untracked,
+        conflict: untracked ? false : isConflict(x + y),
+      })
+      if (x === 'R' || x === 'C') i++
+    }
+    return {
+      ok: true,
+      root,
+      branch,
+      upstream,
+      ahead,
+      behind,
+      files,
+      stagedCount: files.filter((f) => f.staged).length,
+      unstagedCount: files.filter((f) => !f.staged).length,
+      clean: files.length === 0,
+    }
+  }
+
+  function cwdOf(body) {
+    return body && body.cwd ? String(body.cwd) : defaultBase
+  }
+
+  function route(path, handler) {
+    ctx.effect(() => webServer.register({
+      kind: 'exact',
+      path,
+      handler: async (req, res) => {
+        try {
+          const body = await readJson(req)
+          const result = await handler(body)
+          sendJson(res, 200, result)
+        } catch (err) {
+          sendJson(res, 400, { ok: false, error: String((err && err.message) || err) })
+        }
+      },
+    }), `dsh-git-sidebar: ${path}`)
+  }
+
+  route(`${API_BASE}/status`, async (body) => readStatus(cwdOf(body)))
+
+  route(`${API_BASE}/branches`, async (body) => {
+    const root = await findGitRoot(cwdOf(body))
+    if (!root) return { ok: false, error: '未找到 Git 仓库' }
+    const [local, remote, cur] = await Promise.all([
+      gitRun(`git for-each-ref '--format=%(refname:short)' refs/heads`, { cwd: root }),
+      gitRun(`git for-each-ref '--format=%(refname:short)' refs/remotes`, { cwd: root }),
+      gitRun('git rev-parse --abbrev-ref HEAD', { cwd: root }),
+    ])
+    if (!local.ok || !cur.ok) return { ok: false, error: (local.stderr || cur.stderr || '获取分支失败').trim() }
+    const branches = (local.stdout || '').split('\n').filter(Boolean).map((name) => ({ name, isRemote: false }))
+    if (remote.ok) {
+      ;(remote.stdout || '').split('\n').filter(Boolean).forEach((name) => {
+        if (name === 'origin/HEAD' || /\/HEAD$/.test(name)) return
+        if (!branches.some((b) => b.name === name)) branches.push({ name, isRemote: true })
+      })
+    }
+    return { ok: true, current: (cur.stdout || '').trim(), branches }
+  })
+
+  route(`${API_BASE}/checkout`, async (body) => {
+    const root = await findGitRoot(cwdOf(body))
+    if (!root) return { ok: false, error: '未找到 Git 仓库' }
+    const name = body && body.name ? String(body.name) : ''
+    if (!name) return { ok: false, error: '未指定分支' }
+    const isRemote = !!(body && body.isRemote)
+    const st = await readStatus(cwdOf(body))
+    if (st.ok && !st.clean) {
+      return {
+        ok: false,
+        code: 'dirty-workspace',
+        error: `工作区有 ${st.files.length} 个未提交变更，切换分支可能丢失这些更改`,
+      }
+    }
+    let cmd
+    if (isRemote) {
+      const short = name.split('/').slice(1).join('/')
+      const exists = await gitRun(`git rev-parse --verify --quiet ${shq(short)}`, { cwd: root })
+      cmd = exists.ok ? `git checkout ${shq(short)}` : `git checkout -b ${shq(short)} --track ${shq(name)}`
+    } else {
+      cmd = `git checkout ${shq(name)}`
+    }
+    const r = await gitRun(cmd, { cwd: root, timeoutMs: 120000 })
+    if (!r.ok) return { ok: false, error: (r.stderr || r.stdout || '切换分支失败').trim() }
+    return { ok: true, notice: `已切换到 ${name}${isRemote ? '（新建跟踪分支）' : ''}` }
+  })
+
+  route(`${API_BASE}/stage`, async (body) => {
+    const root = await findGitRoot(cwdOf(body))
+    if (!root) return { ok: false, error: '未找到 Git 仓库' }
+    const paths = (body && Array.isArray(body.paths) && body.paths.map(String)) || []
+    if (!paths.length) return { ok: false, error: '未指定文件' }
+    const quoted = paths.map(shq).join(' ')
+    const r = body && body.staged
+      ? await gitRun(`git add -- ${quoted}`, { cwd: root })
+      : await gitRun(`git reset -- ${quoted}`, { cwd: root })
+    if (!r.ok) return { ok: false, error: (r.stderr || r.stdout || '操作失败').trim() }
+    return { ok: true }
+  })
+
+  route(`${API_BASE}/commit`, async (body) => {
+    const root = await findGitRoot(cwdOf(body))
+    if (!root) return { ok: false, error: '未找到 Git 仓库' }
+    const msg = body && body.message ? String(body.message).trim() : ''
+    if (!msg) return { ok: false, error: '提交信息不能为空' }
+    if (body === null || body === undefined || body.all !== false) {
+      const add = await gitRun('git add -A', { cwd: root })
+      if (!add.ok) return { ok: false, error: (add.stderr || add.stdout || 'git add 失败').trim() }
+    }
+    const c = await gitRun(`git commit -m ${shq(msg)}`, { cwd: root })
+    if (!c.ok) return { ok: false, error: (c.stderr || c.stdout || 'git commit 失败').trim() }
+    return { ok: true, notice: (c.stdout || '').split('\n')[0] || '提交成功' }
+  })
+
+  route(`${API_BASE}/push`, async (body) => {
+    const root = await findGitRoot(cwdOf(body))
+    if (!root) return { ok: false, error: '未找到 Git 仓库' }
+    const r = await gitRun('git push', { cwd: root, timeoutMs: 300000 })
+    if (!r.ok) return { ok: false, error: (r.stderr || r.stdout || 'git push 失败').trim() }
+    return { ok: true, notice: (r.stdout || '推送成功').trim() || '推送成功' }
+  })
+
+  route(`${API_BASE}/pull`, async (body) => {
+    const root = await findGitRoot(cwdOf(body))
+    if (!root) return { ok: false, error: '未找到 Git 仓库' }
+    const r = await gitRun('git pull', { cwd: root, timeoutMs: 300000 })
+    if (!r.ok) return { ok: false, error: (r.stderr || r.stdout || 'git pull 失败').trim() }
+    return { ok: true, notice: (r.stdout || '拉取完成').trim() || '拉取完成' }
+  })
+
+  route(`${API_BASE}/generate`, async (body) => {
+    const st = await readStatus(cwdOf(body))
+    if (!st.ok) return st
+    if (st.clean) return { ok: false, error: '工作区没有变更' }
+    const root = st.root
+    const diffR = await gitRun('git diff HEAD', { cwd: root, cap: 20000 })
+    if (!diffR.ok && diffR.stderr) return { ok: false, error: diffR.stderr.trim() }
+    const diff = (diffR.stdout || '').slice(0, 19000)
+    if (!llm) return { ok: false, error: 'LLM 服务不可用' }
+    if (!adm) return { ok: false, error: '默认模型服务不可用' }
+    const sel = adm.currentSelection()
+    if (!sel || !sel.provider || !sel.model) return { ok: false, error: '未配置默认模型，无法生成提交信息' }
+    const fileLines = st.files.map((f) => `  ${f.code} ${f.path}`).join('\n')
+    const prompt = [
+      '你是一名资深开发者。请根据下面的 Git 变更生成一条提交信息。',
+      '要求：',
+      '1. 使用 Conventional Commits 风格：<type>(<scope>): <subject>，type 取 feat/fix/refactor/docs/style/chore/test/perf 之一；',
+      '2. subject 用简洁的中文描述，不超过 50 个字符；',
+      '3. 只输出提交信息本身，不要任何解释、前缀或引号。',
+      '',
+      `当前分支：${st.branch}`,
+      '变更文件：',
+      fileLines,
+      '',
+      'Diff：',
+      diff || '（无可展示的 diff，仅有未跟踪文件）',
+    ].join('\n')
+    let text = ''
+    let failed = false
+    const stream = llm.stream({
+      provider: sel.provider,
+      model: sel.model,
+      temperature: 0.4,
+      maxTokens: 150,
+      messages: [
+        {
+          id: `dsh-git-gen-${Date.now()}`,
+          role: 'user',
+          content: [{ type: 'text', text: prompt }],
+          source: { kind: 'user' },
+        },
+      ],
+    })
+    for await (const chunk of stream) {
+      if (!chunk) continue
+      if (chunk.type === 'text-delta') text += chunk.text || ''
+      else if (chunk.type === 'finish') {
+        if (chunk.reason === 'error' || chunk.reason === 'aborted') failed = true
+        break
+      }
+    }
+    if (failed) return { ok: false, error: '模型调用失败' }
+    const msg = text.trim()
+    if (!msg) return { ok: false, error: '模型未返回内容' }
+    return { ok: true, message: msg }
+  })
+}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "dsh-git-sidebar",
+  "version": "0.1.2",
+  "description": "A draggable right-side Git sidebar for DeepSeek Harness Web: follow the active workspace, list changed files, generate commit messages with the current model, and commit/push/pull",
+  "type": "module",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./client": "./lib/client.js",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "README.md",
+    "README.zh.md",
+    "README.i18n.yaml",
+    "LICENSE"
+  ],
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "plugin",
+    "git",
+    "version-control",
+    "git-status",
+    "commit-message",
+    "web-ui"
+  ],
+  "license": "MIT",
+  "engines": {
+    "dsh": ">=0.0.1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/adamaik/dsh-git-sidebar.git"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web"
+    }
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1-rc.1"
+  }
+}