Jujutsu 版本控制 AQian0/dsh-jj

dsh-jj

为 DeepSeek Harness 提供 Jujutsu (jj) 一等支持。

功能

- 仓库识别：区分 git / jj-colocated / jj-native / 非仓库；jj 与 git 嵌套时给出明确归属，不会把 jj 工作区当成普通 git 仓库。
- 防混淆 guard：在 jj 仓库里执行 git commit、git reset 等会破坏 change graph 的命令时，默认放行并在结果里提示等价 jj 命令，也可配置为直接拒绝。
- jj 原生工具：13 个 jj_ 工具（status / log / diff / new / describe / squash / undo / op log / workspace / bookmark / rebase）。
- 模型上下文：在 jj 仓库里自动向模型注入「优先用 jj」的上下文；非 jj 仓库不注入。
- 项目根发现：让 agent-instructions 也能把 .jj 当作项目根标记（headless/CLI profile 生效）。
- 不回退 git：jj 不可用或目录不是 jj 仓库时明确报错，绝不静默改用 git。

安装

需要 DSH 与 jj CLI（jj 在 PATH 中，或用 jjCommand 指定）；无其他运行时依赖。

从 npm 安装：在 Plugin Manager 里把 spec 填成精确版本（如 @aqian0/dsh-jj@0.2.1，避免发版后已装内容变化），或执行：

dsh plugin --profile <name> add @aqian0/dsh-jj@0.2.1

本地目录安装：lib/ 是构建产物、不入库，先在仓库根执行 npm run build，再在 Plugin Manager 里安装本地 bundle，spec 填本仓库绝对路径（如 /path/to/dsh-jj）；Web GUI 在设置 → 插件管理，Agent 侧用 plugin_manager 的 install_bundle。

安装后自动启用 jj-runtime / jj-tools / jj-guard 三行，并给 agent-instructions 加上 .jj 根标记；用 Plugin 页面或 list_plugins 确认。

使用

安装后自动生效，无需手工写 profile。典型的 agent 用法：

| 你说 | 模型调用 |
| "看下当前 jj 状态" | jj_status |
| "列出最近 10 个提交" | jj_log |
| "把当前改动并进上一个提交" | jj_squash |
| "改一下当前 change 的描述" | jj_describe |
| "撤销刚才那次 jj 操作" | jj_undo |
| "新建一个 workspace 放到 /tmp/wt" | jj_workspace_add |

在 jj 仓库里直接让 agent 跑 git commit 之类的命令时，默认会在工具结果里追加「优先用 jj」的提示；把 guardMutatingGit 设为 deny 后会直接拒绝并给出等价命令：

Blocked: git commit in a Jujutsu (jj) workspace (jj-colocated: /path/to/repo).
Use the jj equivalent instead:
jj commit -m "…" (or: jj describe -m "…" then jj new)

工具一览

| 工具 | 作用 |
| jj_status | 工作副本 @ 的状态 |
| jj_log | 按 revset 查看提交（@、@-、bookmarks() 等） |
| jj_diff | 指定 revset 的 diff |
| jj_new | 新建 change 并设为 @ |
| jj_describe | 就地修改提交描述（代替 git commit --amend） |
| jj_squash | 把改动并进另一个提交 |
| jj_undo | 撤销/恢复到某个 operation |
| jj_op_log | operation 历史，用于找 jj_undo 的目标 |
| jj_workspace_add / jj_workspace_list | 新建/列出 jj workspace |
| jj_bookmark_list / jj_bookmark_set | 列出/设置 bookmark |
| jj_rebase | rebase 提交及其后代 |

非 jj 仓库会直接拒绝工具调用并说明如何初始化 jj；不会回退到 git。

配置

所有配置键可选，写在 profile 中对应 bundle 行的 config 里：

| 键 | 默认 | 说明 |
| jjCommand / gitCommand | jj / git | 可执行文件名；gitCommand 只用于探测和提示 |
| timeoutMs / graceMs | 30000 / 3000 | 子进程超时，以及超时后强制结束前的宽限时间 |
| maxOutputBytes | 262144 | 单个输出流（stdout / stderr）的上限 |
| detectCacheTtlMs | 10000 | 仓库检测结果的缓存时长 |
| guardMutatingGit | warn | jj 仓库内 mutating git 的处置：warn（放行+提示）/ deny（拒绝）/ off |
| guardGitInJjNative | warn | 仅 jj-native 仓库内 git 的处置 |
| guardJjRepositoryWide | warn | jj undo / jj op restore 等仓库级 jj 操作的处置 |
| guardTools | bash / pwsh / terminal_send | 参与上述守卫判定的 shell 工具名 |
| guardCreateWorktree | true | 在 jj 仓库里拒绝 create_worktree，引导用 jj workspace add |
| readOnlyGitNotice | true | colocated 仓库内只读 git 命令是否附「优先用 jj」提示 |
| preferJjContext | true | 会话开始时注入「优先用 jj」的模型可见上下文 |
| defaultLogLimit / maxLogLimit | 30 / 200 | jj_log 的默认与最大返回条数 |
| defaultCwd | '' | 工具没有 workdir 时的回退目录（空 = 进程 cwd） |

已知限制

- jj 未安装或目录不是 jj 仓库时，jj_ 工具会报错并给出处理建议，不会退回 git。
- agent-instructions 的 .jj 根标记覆盖在 Web 配置档不生效（Web 在 bundle 层禁用了顶层该行），headless/CLI 配置档生效。
- jj-native 工作区里项目级技能根仍按 .git 查找（上游硬编码），暂不可用。

License

MIT