Overview
dsh-gitbar-lite
README / EN
Package documentation
Registry summary
dsh.pub verifies the pinned bundle contract, runtime facts, and distribution semantics. The complete README remains in the source repository.
Read the full README on GitHubLIMITATIONS
Known limitations
- 一个工作区绑一个仓库,一个仓库一次推一个远端(有 `origin` 就优先它)。不做子模块、worktree、分支切换、历史列表、stash。 - Fetch 用的是 `git fetch --prune`,会删掉远端已经删除的分支对应的 remote-tracking ref(和 GitHub Desktop 一致)。 - 提交会跑你自己的 commit hook。卡住的 hook 是你自己的 hook;`timeoutMs` 是唯一的兜底。 - 回收站只存那一个 **diff**。恢复是把它 `git apply` 回去,所以能恢复出一模一样的字节(CRLF、无尾换行、 unicode、行尾空格都验过)。但它只能在「工作区还是舍弃后的样子」时重放:HEAD 变了,或那些文件又被改过, 按钮就变灰并说明原因——否则就是拿旧改动盖掉新改动。 **恢复出来的文件回到列表时是勾上的**:重放之后宿主会把这些路径 `git add` 进索引, 和「任何改动都默认勾选」是同一条规则,也和本插件「勾选就是真的索引」一致——终端里 `git status` 看到的就是这样。 **恢复成功后这条记录会被移除**:它是舍弃的逆操作,放回去之后档案就没有用处了, 而且再重放一次会把同一个改动应用两遍。 - 二进制文件不归档内容,只记一句 `Binary files … differ`。这很诚实,但那不是备份。 - 超过 `maxFileBytes` 的未跟踪文件被舍弃时,归档里只有一段说明。确认框目前不会特别提示这一点。 - 「舍弃未跟踪文件」是直接删除(不进系统回收站)——这是说好的设计:插件自己的回收站承接它,不勾「彻底删除」时能看到内容。
