@klarkxy/dsh-git-commit 0.2.0 → 0.2.2

package/README.md

@@ -1,4 +1,6 @@
-# @klarkxy/dsh-git-commit
+# @klarkxy/dsh-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
@@ -10,7 +12,7 @@ directory.
 
 ## Install
 
-Requires Node.js ≥22. Install the published package into the target profile
+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:
 
 ```sh
@@ -20,15 +22,6 @@ 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 install a source checkout of this repository instead, pack it first and add
-the archive:
-
-```sh
-cd plugins/dsh-git-commit
-npm pack --ignore-scripts
-dsh plugin --profile web add "<absolute path to the .tgz>"
-```
-
 To uninstall:
 
 ```sh
@@ -69,6 +62,16 @@ nothing.
 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.
 
+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.
+
 ## Notes
 
 - Each selected file is committed from its current worktree content. Pre-staged

package/docs/README.zh-CN.md

@@ -1,4 +1,6 @@
-# @klarkxy/dsh-git-commit
+# @klarkxy/dsh-git-commit
+
+<!-- release-state-note -->
 
 在对话里直接把工作区修改提交到 git。每个对话线程的右上角都有一个 **提交** 按钮：
 点一下打开弹层，确认分支、文件数量和将使用的模型，再点一下即可把会话工作目录
@@ -8,7 +10,7 @@
 
 ## 安装
 
-需要 Node.js ≥22。用 DSH 插件管理器把已发布包装进目标 profile，安装即启用
+需要 Node.js ≥22（已验证 26）。用 DSH 插件管理器把已发布包装进目标 profile，安装即启用
 `git-commit` 入口：
 
 ```sh
@@ -17,14 +19,6 @@ dsh plugin --profile web add @klarkxy/dsh-git-commit
 
 把 `web` 换成你的 profile 名。安装或卸载后宿主可能要求重启。
 
-要装本仓库的源码，先打包再添加归档：
-
-```sh
-cd plugins/dsh-git-commit
-npm pack --ignore-scripts
-dsh plugin --profile web add "<归档绝对路径>"
-```
-
 卸载：
 
 ```sh
@@ -52,6 +46,13 @@ dsh plugin --profile web remove @klarkxy/dsh-git-commit
 
 会话运行期间按钮不可用。宿主在提交前还会再检查一次，规划期间工作区发生变化时会中止本次提交。
 
+后续分组失败或执行被取消时，已经完成的提交仍然保留。面板显示这些提交、剩余
+分组和停止原因，再刷新仓库状态；已创建但未能读回哈希的提交会明确标注。
+插件不会回滚已完成的提交，也不会自动重试。卸载插件会取消正在进行的规划，
+拒绝新的执行，并等待已有操作完成清理。
+如果 Git 命令报错后 HEAD 已变化或无法读回，对应分组会标为“结果不确定”，不擅自
+归属某个提交。请先检查 Git 日志和状态；这一组与尚未执行的分组分开显示。
+
 ## 说明
 
 - 每个选中文件按当前工作区内容提交。属于其他分组的已暂存修改会保留到对应分组提交。