@klarkxy/dsh-git-commit 0.2.2 → 0.2.3

package/README.md

@@ -1,86 +1,35 @@
-# @klarkxy/dsh-git-commit
+# Git Commit
 
 <!-- release-state-note -->
 
-Commit workspace changes to git without leaving the chat. Every conversation
-thread gets a **Commit** action in its header: click it, check the branch, the
-file count and the model that will be used, then confirm to commit every
-uncommitted path in the repository that contains the session's working
-directory.
-
 [简体中文](docs/README.zh-CN.md)
 
-## Install
+Commit workspace changes without leaving the chat. A model groups your changes into a few sensible commits and writes their messages.
 
-Requires Node.js ≥22 (26 verified). Install the published package into the target profile
-with the DSH plugin manager; the install also enables the `git-commit` entry:
+## Install
 
 ```sh
 dsh plugin --profile web add @klarkxy/dsh-git-commit
 ```
 
-Replace `web` with your profile name. Installation or removal may require a
-restart when the host asks for one.
-
-To uninstall:
-
-```sh
-dsh plugin --profile web remove @klarkxy/dsh-git-commit
-```
-
-## How it works
-
-A model splits the change set into a small number of coherent commits with
-proper messages, then the groups are applied in order as path-scoped commits.
-The model route comes from this plugin's own settings row: configure the
-**Commit planning model** there in advance to pin a dedicated model; when
-nothing is configured, the request follows the live session model and then the
-host default chat model. If the model call fails or returns an invalid plan,
-the run is **rejected** and nothing is staged or committed — a commit the model
-never planned is not one you asked for. The plugin page can opt back into the
-old behavior with **Commit even without a model plan**, which merges every
-change into a single commit with a plugin-written message.
-
-## Plugin page settings
-
-`Settings → Plugins → Git Commit` holds the rows this plugin needs.
-**Commit planning model** is optional: a saved route is used for the planning
-call as an explicit model, an empty selection follows the live session model
-and then the host default chat model, and the conversation header panel reports
-which of the two is in effect. Only that call is affected; a saved route selects
-a model, but it is not evidence of connectivity. **Commit even without a model
-plan** is off by default and only changes what happens when planning produces
-nothing.
-
-## Usage
+Replace `web` with your profile name and restart it if DSH asks.
 
-1. Open a conversation whose workspace sits inside a git repository.
-2. Click **Commit** in the thread header (top right).
-3. Confirm in the popover, then wait for the run to finish.
-4. The panel lists every commit it created (hash + message).
+## Use
 
-The button is disabled while the session is running. The host checks again
-before committing, and stops the run if the workspace changes during planning.
+1. Open a conversation whose workspace is inside a Git repository.
+2. Click **Commit** in the top-right of the conversation.
+3. Check the branch, file count, and model, then confirm.
+4. The panel lists the commits it created.
 
-If a later group fails or the run is cancelled, completed commits stay in place.
-The panel shows those commits, the remaining groups and the stopping reason,
-then refreshes repository status. A commit whose hash could not be read is
-marked explicitly. It never rolls back completed commits or retries them
-automatically. Unloading the plugin cancels in-flight planning and rejects new
-runs while existing cleanup finishes.
-If a rejected Git command leaves HEAD changed or unreadable, its group's outcome
-is marked uncertain without attributing a commit to the plugin. Check Git log
-and status before acting on that group; it is separate from groups not executed.
+Under **Plugins → Git Commit** you can choose the **Commit planning model** (empty follows the current session model) and turn on **Commit even without a model plan**, which makes one commit when the model is unavailable.
 
-## Notes
+## Good to know
 
-- Each selected file is committed from its current worktree content. Pre-staged
-  changes that belong to another group stay staged until that group is
-  committed.
-- Untracked files are included: small text files get a content preview for the
-  model, while binaries are listed by path only.
-- Commits never push. Pushing stays a manual decision.
+- All uncommitted changes in the repository are included, including new files.
+- It only commits; it never pushes.
+- If the run stops partway, finished commits stay and the panel shows what was left. Nothing is rolled back or retried automatically.
+- The button is unavailable while the session is running.
 
 ## License
 
-SEE LICENSE IN LICENSE
+[SATA License 2.1](LICENSE)

package/docs/README.zh-CN.md

@@ -1,64 +1,35 @@
-# @klarkxy/dsh-git-commit
+# Git 提交
 
 <!-- release-state-note -->
 
-在对话里直接把工作区修改提交到 git。每个对话线程的右上角都有一个 **提交** 按钮：
-点一下打开弹层，确认分支、文件数量和将使用的模型，再点一下即可把会话工作目录
-所在仓库的全部未提交改动分次提交。
-
 [English](../README.md)
 
-## 安装
+不离开对话就能提交工作区改动。模型会把改动分成几个合理的提交，并写好提交信息。
 
-需要 Node.js ≥22（已验证 26）。用 DSH 插件管理器把已发布包装进目标 profile，安装即启用
-`git-commit` 入口：
+## 安装
 
 ```sh
 dsh plugin --profile web add @klarkxy/dsh-git-commit
 ```
 
-把 `web` 换成你的 profile 名。安装或卸载后宿主可能要求重启。
-
-卸载：
-
-```sh
-dsh plugin --profile web remove @klarkxy/dsh-git-commit
-```
-
-## 工作方式
-
-模型会把改动整理成若干个内聚的提交并生成提交信息，然后按顺序逐组创建限定路径的提交。模型路由由本插件自己的设置行提供：在「设置 → 插件 → Git 提交」提前配置**提交规划模型**即可固定专用模型；没有配置时依次使用当前会话模型和宿主默认对话模型。模型调用失败或返回非法分组时，本次提交会被**拒绝**，不会暂存也不会提交任何内容——模型没有规划过的提交不是你要求的提交。想要回到旧行为，可以在插件页打开**模型不可用时仍然提交**，此时全部改动会合并成一个提交，由插件代写提交信息。
-
-## 插件页设置
-
-「设置 → 插件 → Git 提交」下是本插件需要的设置项。**提交规划模型**用于提交规划调用，
-可留空：保存某个路由后，对应该调用会使用这个显式模型；留空则使用当前会话模型，
-再回落到宿主默认对话模型。对话头部面板会显示实际生效的是哪一种。只有这个调用受影响；
-保存路由只表示选定模型，不代表已连通。**模型不可用时仍然提交**默认关闭，只在
-规划完全没有产出时改变行为。
+把 `web` 换成你的 profile 名，DSH 提示时重启。
 
 ## 使用
 
-1. 打开一个工作目录位于 git 仓库内的对话。
-2. 点击线程右上角的 **提交** 按钮。
-3. 在弹层里确认，然后等待执行完成。
-4. 面板会列出创建的每个提交（哈希 + 信息）。
-
-会话运行期间按钮不可用。宿主在提交前还会再检查一次，规划期间工作区发生变化时会中止本次提交。
+1. 打开一个工作目录位于 Git 仓库内的对话。
+2. 点击对话右上角的「提交」。
+3. 确认分支、文件数和模型后提交。
+4. 面板会列出创建的提交。
 
-后续分组失败或执行被取消时，已经完成的提交仍然保留。面板显示这些提交、剩余
-分组和停止原因，再刷新仓库状态；已创建但未能读回哈希的提交会明确标注。
-插件不会回滚已完成的提交，也不会自动重试。卸载插件会取消正在进行的规划，
-拒绝新的执行，并等待已有操作完成清理。
-如果 Git 命令报错后 HEAD 已变化或无法读回，对应分组会标为“结果不确定”，不擅自
-归属某个提交。请先检查 Git 日志和状态；这一组与尚未执行的分组分开显示。
+在「插件 → Git 提交」里可以选择**提交规划模型**（留空跟随当前会话模型），也可以打开**模型不可用时仍然提交**，这时所有改动合并为一个提交。
 
-## 说明
+## 注意
 
-- 每个选中文件按当前工作区内容提交。属于其他分组的已暂存修改会保留到对应分组提交。
-- 未跟踪文件也会提交：较小的文本文件会把内容预览发给模型，二进制文件只列路径。
-- 插件只做 commit，不会 push；push 仍由你手动决定。
+- 会提交仓库里的全部未提交改动，包括新文件。
+- 只提交，不推送。
+- 中途停止时，已完成的提交会保留，面板显示剩余内容；不会自动回滚或重试。
+- 会话运行期间按钮不可用。
 
 ## 许可证
 
-SEE LICENSE IN LICENSE
+[SATA License 2.1](../LICENSE)

package/locale/en.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "Git Commit",
-    "description": "Commit workspace changes from the conversation header, with AI-split commits via AI Services."
+    "description": "Commit workspace changes from the conversation header, with the model grouping the commits."
   }
 }

package/locale/zh.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "Git 提交",
-    "description": "从会话顶栏提交工作区修改，并由 AI 服务拆成多次提交。"
+    "description": "从会话顶栏提交工作区改动，由模型分组。"
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@klarkxy/dsh-git-commit",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Git Commit: commit workspace changes from the conversation header, with model-planned commit groups.",
   "icon": "./icon.svg",
   "license": "SEE LICENSE IN LICENSE",
@@ -74,8 +74,8 @@
     "test": "vitest run --root ../.. --config vitest.editor-plugins.config.ts --maxWorkers=2 plugins/dsh-git-commit/src"
   },
   "dependencies": {
-    "@klarkxy/dsh-model-route": "0.2.1",
-    "@klarkxy/dsh-plugin-kit": "0.3.1",
+    "@klarkxy/dsh-model-route": "0.2.2",
+    "@klarkxy/dsh-plugin-kit": "0.3.2",
     "zod": "^4.1.5"
   },
   "peerDependencies": {
@@ -124,6 +124,6 @@
     "registry": "https://registry.npmjs.org/"
   },
   "dshRelease": {
-    "contentHash": "4acf2bc66703208b27ee0eafa2b3eb91cc51907e5ffde9ffcd7d8d98d9a56fdd"
+    "contentHash": "077d58a4b92b919573e9181cd1e3bf98f34deaabfd12f2366f87894352b2ab4f"
   }
 }