dsh-easygit-plugin 0.2.3 → 0.3.0

package/README.md

@@ -2,7 +2,9 @@
 
 # DSH Git Plugin
 
-**A visual Git workbench for inspecting repositories, running common actions, and safely executing AI-generated Git workflows in DeepSeek Harness Web.**
+**See your Git history and changes. Run everyday Git operations with a few clicks.**
+
+A visual Git workbench inside DeepSeek Harness Web.
 
 ![DeepSeek Harness](https://img.shields.io/badge/DeepSeek%20Harness-Developer%20Preview-4f46e5)
 ![Web profile](https://img.shields.io/badge/profile-Web-0ea5e9)
@@ -15,124 +17,121 @@ English · [简体中文](README.zh-CN.md)
 
 </div>
 
-## How to use
+## Preview
 
-<p align="center">
-  <strong>👀 Inspect Git state &nbsp;→&nbsp; 🖱️ Run a quick action or ask the Agent &nbsp;→&nbsp; ✅ Review &nbsp;→&nbsp; 🚀 Execute</strong>
-</p>
+![DSH Git Plugin changes view and quick Git actions](./assets/preview.png)
 
-## Preview
+## Git you can see and use
 
-![DSH Git Plugin visual workbench](./assets/preview.png)
+**Understand your repository at a glance.** Browse the commit graph, inspect commit details and file diffs, compare staged and unstaged changes, and see branches, tags, stashes, and remote sync status in one workbench.
 
-## Features
+**Click through everyday Git work.** Stage files, commit, switch branches, merge, stash, fetch, pull, and push from the interface. Preview changes before merging and resolve conflicts in the built-in three-pane editor.
+
+| Area | What you can do |
+| --- | --- |
+| Changes | Review formatted or raw diffs; stage or unstage individual files or all files; create commits. |
+| Commit history | Browse the graph, inspect messages, parents, changed files and diffs; amend, undo, or revert commits. |
+| Branches | Search, create, switch, and delete local branches; inspect remote branches and tags. |
+| Merge branches | Preview incoming commits and changes; choose normal, fast-forward-only, or squash merge. |
+| Conflict resolution | Compare current, incoming, and result panes; accept either side, keep both, or edit manually; save, resolve, and continue. |
+| Stashes | Stash all or selected files, optionally including untracked files; review, apply, pop, drop, or create a branch from a stash. |
+| Sync | Inspect upstream and ahead/behind counts; fetch, fast-forward pull, push, set upstream, and manage Rebase. |
 
-1. **Visual repository state**: See the current branch, staged and unstaged files, and each file's formatted review view or raw diff.
-2. **Commit history and details**: Browse the current branch as a commit graph, then click a commit to inspect its message, author, timestamps, parents, changed files, statistics, and full diff.
-3. **One-click Git actions**: Stage or unstage one file or all files, create commits, and create, search, switch, or safely delete local branches directly from the workbench.
-4. **Remote sync and Rebase**: Inspect upstream, ahead/behind counts, and working-tree state; fetch, fast-forward pull, push, set an upstream for a new branch, or safely start, continue, and abort a Rebase.
-5. **References at a glance**: Inspect local branches, remote branches, and tags without leaving DeepSeek Harness Web.
-6. **Natural-language workflows**: Turn a request into a clear, step-by-step Git command proposal, then execute it directly or copy it for manual execution.
-7. **Actionable failure handling**: Keep the failed command, output, and post-failure repository diagnostics together; offer a safe recovery proposal for recognized failures or let the Agent analyze a complex failure.
-8. **Safety by default**: Validate commands against a conservative allowlist, require confirmation for high-risk operations and history rewrites, prevent proposal replay, and redact common credentials from diagnostics.
+For more involved workflows, you can also ask the Agent in natural language. Review its proposed Git commands in **建议 (Proposals)**, then execute or copy them. Failed actions retain command output and repository diagnostics for recovery or Agent analysis.
 
 ## Quick start
 
-### 0. Allow immediate installation of the new package
+Requires Git, Node.js `^22.19.0 || >=24.0.0`, and DeepSeek Harness Web. Plugin `0.3.0` targets DSH `0.1.7-rc.1`; see [compatibility](#compatibility).
+
+```sh
+npm install -g @deepseek-ai/dsh@0.1.7-rc.1
+dsh plugin --profile web add dsh-easygit-plugin@0.3.0
+dsh web
+```
+
+Open a session for your Git repository, then click the **Git** button beside the composer. The workbench opens in a native right-sidebar tab.
 
-Newer versions of `pnpm` may delay recently published packages. To install the latest release immediately, add `dsh-easygit-plugin` to `~/.dsh/profiles/web/pnpm-workspace.yaml`:
+A typical workflow: **Changes → review the diff → stage files → enter a message → commit → Sync → push**. New branches can set their upstream when pushing.
+
+If pnpm blocks installation because the package was recently published, add the package to the existing configuration in `~/.dsh/profiles/web/pnpm-workspace.yaml`:
 
 ```yaml
 minimumReleaseAgeExclude:
   - dsh-easygit-plugin
 ```
 
-### 1. Install the plugin
+## Common workflows
 
-```sh
-dsh plugin --profile web add dsh-easygit-plugin
-```
+### Amend, undo, or revert a commit
 
-### 2. Start DSH Web
+Open **变更 → 提交撤销与修正 (Changes → Commit edits)** for the latest commit, or click a commit in **提交记录 (Commit history)**.
 
-```sh
-dsh web
-```
+- **Edit the latest message** changes only the message, preserving staged and working-tree changes.
+- **Amend the latest commit** adds all staged changes while keeping its message.
+- **Undo the latest commit, keep changes** uses `reset --soft` to return to its first parent; the initial commit cannot be undone this way.
+- **Revert a commit** creates a reverse commit and requires a clean worktree and index. For merge commits, select the mainline parent. Conflicts can be continued, aborted, or skipped from Conflict resolution.
 
-### 3. Open the Git workbench
+These actions require confirmation. Amend and undo rewrite local history and can affect published commits; the plugin never force-pushes automatically. If the branch, HEAD, or index changes after loading, refresh before confirming again.
 
-Use the Git button beside the composer to inspect changes, review commit history, stage files, commit changes, manage branches, or synchronize with a remote. Rebase and forceful branch deletion require an explicit risk confirmation.
+### Preview and merge branches
 
-For a more involved workflow, ask the Agent for a Git operation. For example:
+Open **合并分支 (Merge branches)**, select a local or fetched remote branch, and preview its incoming commits and file changes. Choose normal merge, fast-forward only, or squash. Squash stages the combined changes for you to finish as one commit.
 
-```text
-Commit the documentation update to the current branch with the message "docs: update guide"
-```
+Merging requires a clean worktree. Remote sources use locally fetched references, so fetch first for current data. The preview compares the source with the common ancestor; it does not predict conflicts or show the final merge result. A changed branch tip requires a new preview. You can abort an unfinished merge, including squash, but cannot abort a completed merge.
 
-Review the generated steps in the Git workbench, then choose direct execution or manual execution.
+### Resolve conflicts visually
 
-## Install from source
+In **冲突解决 (Conflict resolution)**, compare the current side, incoming side, and editable result with line numbers and commit references. Choose either side or both per block, or edit the result; then **save → mark resolved → continue**. Merge, Rebase, Cherry-pick, and Revert use this workflow. Abort and supported skip actions require confirmation.
 
-```sh
-git clone https://github.com/IT-coder-Yy/dsh-git-plugin.git
-cd dsh-git-plugin
-npm install
-npm run build
-dsh plugin --profile web add ${PWD}
-```
+During Rebase, the current side is the target branch plus replayed commits; the incoming side is the commit being replayed. Unresolved markers block resolution, and changed files invalidate an old snapshot. Binary conflicts support whole-side selection; text editing supports up to 48 KiB per version. Use external tools for larger files, symlinks, or submodules. Unsaved drafts last only for the current page and do not survive a reload.
 
-## Install from GitHub repository
+### Save work with Stash
 
-```sh
-dsh plugin --profile web add github:IT-coder-Yy/dsh-git-plugin
-```
+In **贮藏 (Stashes)**, select all or individual files and optionally include untracked files. Selected-file stashes preserve unrelated changes. Review a stash before applying it; **apply** retains it, while **pop** removes it only after successful restoration. Conflicts retain the stash and link to Conflict resolution. Creating a branch from a stash requires a clean worktree and starts at the stash's original base.
 
-## Update the plugin
+## Update, remove, or install from source
 
 ```sh
+# Update / remove
 dsh plugin --profile web update dsh-easygit-plugin
+dsh plugin --profile web remove dsh-easygit-plugin
 ```
 
-## Uninstall the plugin
+After updating, restart the Harness backend and refresh the browser to load both Host and Client changes.
 
 ```sh
-dsh plugin --profile web remove dsh-easygit-plugin
+# Install from source
+git clone https://github.com/IT-coder-Yy/dsh-git-plugin.git
+cd dsh-git-plugin
+npm install
+npm run build
+dsh plugin --profile web add "${PWD}"
 ```
 
-## How it works
-
-The plugin registers two model tools:
-
-| Tool | Description |
-| --- | --- |
-| `git_repo_state` | Reads the current repository state without modifying it. |
-| `git_propose` | Validates and registers one or more Git steps. |
+You can also install directly from the repository with `dsh plugin --profile web add github:IT-coder-Yy/dsh-git-plugin`.
 
-The Web profile adds a Git action beside the composer and opens the workbench in the native details area. Its tabs provide visual access to working-tree changes and diffs, branches and references, commit history and details, stashes, remote synchronization, and Agent-generated proposals. Commands are validated both when a proposal is created and immediately before execution. When an action fails, the workbench preserves structured error context and repository diagnostics; recognized failures can create a new recovery proposal, while complex failures can be handed back to the Agent for analysis.
+## Compatibility
 
-## Security
+Version `0.3.0` integrates with DSH `0.1.7-rc.1` using native sidebar tabs and session APIs. Shell execution uses `execute(spec).result()` and retains the `run(spec)` fallback for DSH `0.1.6-alpha.2`. DSH `0.1.0-rc.8` is no longer supported.
 
-- Each step must contain exactly one allowed `git <subcommand> ...` command.
-- Shell control operators, command substitution, redirection, executable hooks, and unsafe Git options are rejected.
-- High-risk operations, including history rewrites, require explicit confirmation and proposals can only be executed once.
-- The plugin follows the Shell and sandbox policies provided by DeepSeek Harness; use it only with trusted repositories and trusted Git configuration.
+Check other installed plugins when upgrading DSH. If you use `dsh-client-auto-continue`, upgrade it to `0.11.8` or later: `0.11.6` depends on the removed `settingsScope` service and can block Web startup on DSH `0.1.7-rc.1`.
 
-Please report vulnerabilities privately by following [SECURITY.md](SECURITY.md).
+## Safety and Agent tools
 
-## Compatibility
+High-risk actions require explicit confirmation. Agent proposals are validated against a Git command allowlist when created and before execution; shell control operators, substitutions, redirection, and unsafe options are rejected. Proposals cannot be replayed. Commands follow Harness Shell and session sandbox policies; use trusted repositories and Git configuration.
 
-Last verified on **2026-08-20** with DeepSeek Harness `0.1.0-rc.8` and dsh-easygit-plugin `0.2.3`. Verification covered `npm run check` (68 tests), 24 reproducible build artifacts, a dry-run npm package, a temporary DSH Web-profile composition, and end-to-end Git operations against a temporary local copy of the FastAPI repository. The end-to-end coverage includes repository inspection, diffs, commits, branches, stashes, fetch/pull/push, successful and conflicted Rebases, recovery behavior, and proposal safety checks.
+The Agent uses `git_repo_state` for read-only repository inspection and `git_propose` to register command proposals. Report vulnerabilities privately through [SECURITY.md](SECURITY.md).
 
 ## Development
 
-Requires Node.js `^22.19.0 || >=24.0.0`, Git, and a DeepSeek Harness developer preview release that supports static Cordis plugins.
-
 ```sh
 npm install
 npm run check
 npm pack --dry-run --ignore-scripts
 ```
 
+`npm run check` runs type checks, tests, and build reproducibility checks. Git integration tests create temporary repositories for repository operations and recovery scenarios.
+
 ## License
 
 [MIT](LICENSE)

package/README.zh-CN.md

@@ -2,7 +2,9 @@
 
 # DSH Git Plugin
 
-**面向 DeepSeek Harness Web 的可视化 Git 工作台：查看仓库、执行常用操作，并安全运行 AI 生成的 Git 工作流。**
+**看得清 Git 历史与变更，点几下就能完成日常 Git 操作。**
+
+集成在 DeepSeek Harness Web 中的可视化 Git 工作台。
 
 ![DeepSeek Harness](https://img.shields.io/badge/DeepSeek%20Harness-Developer%20Preview-4f46e5)
 ![Web profile](https://img.shields.io/badge/profile-Web-0ea5e9)
@@ -15,124 +17,121 @@
 
 </div>
 
-## 怎么用
+## 效果预览
 
-<p align="center">
-  <strong>👀 查看 Git 状态 &nbsp;→&nbsp; 🖱️ 点击快捷操作或询问 Agent &nbsp;→&nbsp; ✅ 检查确认 &nbsp;→&nbsp; 🚀 执行</strong>
-</p>
+![DSH Git Plugin 变更视图与 Git 快捷操作](./assets/preview.png)
 
-## 效果预览
+## Git 可视化，操作更简单
 
-![DSH Git Plugin 可视化工作台](./assets/preview.png)
+**仓库情况，一眼看清。** 用提交图浏览历史，点击查看提交详情与文件 Diff，对比已暂存和未暂存改动，在同一工作台掌握分支、标签、贮藏与远程同步状态。
 
-## 功能
+**日常操作，点击完成。** 暂存、提交、切换分支、合并、贮藏、拉取和推送都可直接在界面操作。合并前先预览改动，遇到冲突用内置三方编辑器处理。
+
+| 功能区 | 可以做什么 |
+| --- | --- |
+| 变更 | 查看格式化审阅或原始 Diff；暂存、取消暂存单个或全部文件；创建提交。 |
+| 提交记录 | 浏览提交图、说明、父提交、变更文件及 Diff；修改、撤销或 Revert 提交。 |
+| 分支 | 搜索、新建、切换和删除本地分支；查看远程分支与标签。 |
+| 合并分支 | 预览待引入提交与文件改动；选择普通合并、仅快进或压缩合并。 |
+| 冲突解决 | 对照当前方、传入方与结果；逐块选择一方、保留双方或手动编辑；保存、标记解决并继续。 |
+| 贮藏 | 贮藏全部或指定文件，按需包含未跟踪文件；审阅、应用、弹出、删除或从贮藏创建分支。 |
+| 同步 | 查看上游和领先/落后数量；获取更新、仅快进拉取、推送、设置上游，以及管理 Rebase。 |
 
-1. **可视化仓库状态**：查看当前分支、已暂存和未暂存文件，并查看每个文件的格式化审阅视图或原始 Diff。
-2. **提交记录与详情**：通过提交图浏览当前分支历史；点击提交即可查看提交说明、作者、时间、父提交、变更文件、增删统计和完整 Diff。
-3. **点击执行 Git 操作**：直接暂存或取消暂存单个/全部文件、创建提交，以及新建、搜索、切换或安全删除本地分支。
-4. **远程同步与 Rebase**：查看上游、领先/落后提交数和工作区状态；执行 fetch、仅快进 pull、push、为新分支设置上游，以及安全地开始、继续或中止 Rebase。
-5. **集中查看引用**：无需离开 DeepSeek Harness Web，即可查看本地分支、远程分支和标签。
-6. **自然语言工作流**：将自然语言请求转换成清晰、分步骤的 Git 命令提议，然后直接执行或复制到终端手动执行。
-7. **可追溯的失败处理**：保留失败命令、输出和失败后的仓库诊断；已识别的失败可给出安全修正提议，复杂失败可交由 Agent 分析。
-8. **默认安全**：使用保守的命令白名单；高风险操作和历史重写必须确认；并提供防重复执行和诊断信息脱敏机制。
+复杂流程也可以用自然语言交给 Agent，在 **建议** 页检查生成的 Git 命令后执行或复制。操作失败时保留命令输出和仓库诊断，方便修正或交由 Agent 分析。
 
 ## 快速开始
 
-### 0. 允许立即安装新发布的包
+需要 Git、Node.js `^22.19.0 || >=24.0.0` 和 DeepSeek Harness Web。插件 `0.3.0` 面向 DSH `0.1.7-rc.1`，详见[兼容性](#兼容性)。
+
+```sh
+npm install -g @deepseek-ai/dsh@0.1.7-rc.1
+dsh plugin --profile web add dsh-easygit-plugin@0.3.0
+dsh web
+```
+
+打开 Git 仓库对应的会话，点击输入框旁的 **Git** 按钮，即可在原生右侧标签页中打开工作台。
 
-较新版本的 `pnpm` 可能延迟安装刚发布的包。若要立即安装最新版本，请在 `~/.dsh/profiles/web/pnpm-workspace.yaml` 中加入：
+日常提交只需：**变更 → 审阅 Diff → 暂存文件 → 填写说明 → 提交 → 同步 → 推送**。新分支可以在推送时设置上游。
+
+如果 pnpm 因包刚发布而暂缓安装，可在 `~/.dsh/profiles/web/pnpm-workspace.yaml` 的现有配置中加入：
 
 ```yaml
 minimumReleaseAgeExclude:
   - dsh-easygit-plugin
 ```
 
-### 1. 安装插件
+## 常用工作流
 
-```sh
-dsh plugin --profile web add dsh-easygit-plugin
-```
+### 修改、撤销与 Revert 提交
 
-### 2. 启动 DSH Web
+在 **变更 → 提交撤销与修正** 中操作最近提交，或在 **提交记录** 中点击具体提交。
 
-```sh
-dsh web
-```
+- **修改最近提交说明**：只修改说明，保留暂存区与工作区改动。
+- **补充最近提交**：将全部已暂存改动加入最近提交，保留原说明。
+- **撤销最近提交但保留修改**：通过 `reset --soft` 退回第一父提交；根提交不支持此操作。
+- **Revert 此提交**：创建反向提交，要求工作区与暂存区干净。合并提交需选择主线父提交；发生冲突后可在“冲突解决”中继续、中止或跳过。
 
-### 3. 打开 Git 工作台
+这些操作均需确认。修改与撤销最近提交会改写本地历史，可能影响已推送提交；插件不会自动强制推送。分支、HEAD 或暂存区在读取后变化时，需刷新后重新确认。
 
-点击输入框旁的 Git 按钮，即可查看变更和提交记录，也可以点击暂存文件、创建提交、管理分支或同步远程仓库。Rebase 和强制删除分支必须显式确认风险。
+### 预览并合并分支
 
-遇到更复杂的工作流时，可以用自然语言告诉 Agent。例如：
+打开 **合并分支**，选择本地或已获取的远程分支，先预览待引入提交与文件改动，再选择普通合并、仅快进或压缩合并。压缩合并先生成暂存结果，再由你完成为一个提交。
 
-```text
-将文档更新提交到当前分支，提交信息为 "docs: update guide"
-```
+合并要求工作区干净。远程源使用本地已获取的引用，需要最新数据时先获取更新。预览展示源分支相对共同祖先的改动，不预判冲突，也不等于最终合并结果；分支变化后需重新预览。尚未完成的普通或压缩合并可以中止，已完成的合并不能通过中止撤销。
 
-在 Git 工作台中检查生成的步骤，然后选择直接执行或手动执行。
+### 可视化解决冲突
 
-## 从源码安装
+在 **冲突解决** 中对照当前方、传入方与可编辑结果，结合行号和提交引用逐块选择一方、保留双方或手动修改，然后 **保存 → 标记解决 → 继续**。Merge、Rebase、Cherry-pick 与 Revert 共用这一流程；中止与支持的跳过操作需确认。
 
-```sh
-git clone https://github.com/IT-coder-Yy/dsh-git-plugin.git
-cd dsh-git-plugin
-npm install
-npm run build
-dsh plugin --profile web add ${PWD}
-```
+Rebase 中，当前方是目标分支及已重放提交，传入方是正在重放的提交。未清除的冲突标记会阻止解决，文件变化会使旧快照失效。二进制冲突支持整方选择；文本编辑每个版本最多支持 48 KiB。更大文件、符号链接与子模块请使用外部工具处理。未保存草稿仅在当前页面保留，刷新后不会恢复。
 
-## 从 GitHub 仓库安装
+### 用 Stash 暂存手头工作
 
-```sh
-dsh plugin --profile web add github:IT-coder-Yy/dsh-git-plugin
-```
+在 **贮藏** 页选择全部或指定文件，按需包含未跟踪文件；按文件贮藏会保留其他文件的改动。恢复前可以先审阅内容：**应用** 保留贮藏，**弹出** 仅在恢复成功后删除贮藏。发生冲突时保留贮藏并提供冲突解决入口。从贮藏创建分支要求工作区干净，新分支从贮藏原始提交开始。
 
-## 更新插件
+## 更新、卸载与源码安装
 
 ```sh
+# 更新 / 卸载
 dsh plugin --profile web update dsh-easygit-plugin
+dsh plugin --profile web remove dsh-easygit-plugin
 ```
 
-## 卸载插件
+更新后重启 Harness 后端并刷新浏览器，确保 Host 和 Client 均加载新版本。
 
 ```sh
-dsh plugin --profile web remove dsh-easygit-plugin
+# 从源码安装
+git clone https://github.com/IT-coder-Yy/dsh-git-plugin.git
+cd dsh-git-plugin
+npm install
+npm run build
+dsh plugin --profile web add "${PWD}"
 ```
 
-## 工作原理
-
-插件注册两个模型工具：
-
-| 工具 | 说明 |
-| --- | --- |
-| `git_repo_state` | 只读获取当前仓库状态。 |
-| `git_propose` | 校验并登记一个或多个 Git 操作步骤。 |
+也可直接从仓库安装：`dsh plugin --profile web add github:IT-coder-Yy/dsh-git-plugin`。
 
-Web profile 会在输入框旁添加 Git 操作入口，并在原生详情区域打开工作台。工作台通过多个标签页集中展示工作区变更与 Diff、分支与引用、提交记录与详情、贮藏、远程同步，以及 Agent 生成的操作提议。命令会在创建提议时和实际执行前分别进行校验。操作失败时，工作台会保留结构化错误上下文和仓库诊断；可识别的失败会生成新的修正提议，复杂失败则可交由 Agent 分析。
+## 兼容性
 
-## 安全说明
+`0.3.0` 使用 DSH `0.1.7-rc.1` 的原生右侧标签页与会话接口。Shell 执行已适配 `execute(spec).result()`，并保留 `run(spec)` 作为 DSH `0.1.6-alpha.2` 的兼容路径。不再支持 DSH `0.1.0-rc.8`。
 
-- 每个步骤只能包含一条允许的 `git <子命令> ...` 命令。
-- 禁止 shell 控制符、命令替换、重定向、可执行 hook 和不安全的 Git 选项。
-- 高风险操作（包括历史重写）必须显式确认，每个提议只能执行一次。
-- 插件遵循 DeepSeek Harness 提供的 Shell 和沙箱策略；请仅在可信仓库和可信 Git 配置中使用。
+升级 DSH 时请检查其他已安装插件的兼容性。若使用 `dsh-client-auto-continue`，请升级至 `0.11.8` 或更新版本：`0.11.6` 依赖已移除的 `settingsScope` 服务，可能阻止 DSH `0.1.7-rc.1` 的 Web 页面启动。
 
-如需报告安全漏洞，请按照 [SECURITY.md](SECURITY.md) 中的方式私下联系。
+## 安全与 Agent 工具
 
-## 兼容性
+高风险操作必须显式确认。Agent 提议在创建和执行前均经过 Git 命令白名单校验，禁止 shell 控制符、命令替换、重定向与不安全选项，且不可重复执行。命令遵循 Harness Shell 与会话沙箱策略；请在可信仓库与 Git 配置中使用。
 
-最后于 **2026-08-20** 使用 DeepSeek Harness `0.1.0-rc.8` 和 dsh-easygit-plugin `0.2.3` 完成验证。验证范围包括 `npm run check`（68 项测试）、24 个可重复构建产物、npm 发布包 dry-run、临时 DSH Web profile 组合，以及基于 FastAPI 仓库临时本地副本的端到端 Git 操作。端到端范围包括仓库读取、Diff、提交、分支、贮藏、fetch/pull/push、成功与冲突 Rebase、修正建议和提议安全校验。
+Agent 通过 `git_repo_state` 只读查看仓库，通过 `git_propose` 登记命令提议。如需报告安全漏洞，请按照 [SECURITY.md](SECURITY.md) 私下联系。
 
 ## 开发
 
-需要 Node.js `^22.19.0 || >=24.0.0`、Git，以及支持静态 Cordis 插件的 DeepSeek Harness 开发者预览版本。
-
 ```sh
 npm install
 npm run check
 npm pack --dry-run --ignore-scripts
 ```
 
+`npm run check` 执行类型检查、测试与构建一致性检查。Git 集成测试会创建临时仓库，验证仓库操作与失败恢复场景。
+
 ## 许可证
 
 [MIT](LICENSE)