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 指定);无其他运行时依赖。 兼容 DSH 0.2.1-rc.2 及之后的 0.2.x:peer 依赖写作 ^0.2.1-rc.2,同一 0.2 系列内的补丁/预发布升级(如 0.2.1-rc.3)无需更新插件;0.3 起需要插件适配。

从 npm 安装:在 Plugin Manager 里把 spec 填成精确版本(如 @aqian0/dsh-jj@0.2.2,避免发版后已装内容变化),或执行:

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

本地目录安装: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 profile 不生效(Web 在 bundle 层禁用了顶层该行),headless/CLI profile 生效。
• jj-native 工作区里项目级 skill 根仍按 .git 查找(上游硬编码),暂不可用。

License

MIT