SuperAPI AI 工具集

jj

通用与其它

查看项目

更新于 10-16 06:13

技能介绍

用途:在 jj 仓库(存在 .jj/ 目录,可能同时有 .git/)中按 DAG 原生方式操作版本控制。资料基于 jj 0.45.1 校验,具体语法以 jj help <cmd> 为准。

主要能力与理念:把提交 DAG 当作直接操作对象,@(工作副本)只是文件编辑落点的游标,而非操作中心。每个节点都可用 change ID(jj log 中的 k–z 字母 ID)永久寻址,跨重写仍有效;重写任意节点(describe、squash、split、rebase)后其后代会自动 rebase;游标可自由移动(jj new <id> / jj edit <id>),进行中的工作本身就是提交,无需 stash;每条 jj 命令都会自动把当前文件状态快照进 @,新文件也包含在内。

使用方式:操作前先读图,jj log 读取后再写,任何重写后需重新读取,因为前缀会变化。两种状态:创作时用 jj new <parent-id> -m "..." 打开节点并声明意图;修正时游标不动,直接寻址节点,如 jj describe <id> -m "..."、jj squash --from <A> --into <B> -m "msg"。内容归属错误时按优先级路由:jj absorb --from <id>、jj squash --from <A> --into <B> <paths> -m "msg"、jj split -r <id> <paths> -m "..."、jj split -r <id> <paths> -m "..." -A <dest-parent>。同步推送流程:jj git fetch、jj rebase -d 'trunk()'、jj log、jj bookmark set <name> -r <id>、jj git push -b <name>,随后运行推送探针。

限制与风险:jj 会 fork $EDITOR 且不检查 TTY,在 agent shell 中可能永久挂起,因此 describe/commit、squash、split 等务必传 -m(或 -u),converge 需 --no-interactive,-i/--interactive/--tool、jj resolve、jj diffedit 同样有风险。jj git push 可能打印 Warning: Refusing to create new remote bookmark 却什么都不推,故推送探针必做。revset description("x") 是全字符串 glob,通常匹配不到,应使用 subject("x") 或 description(substring:"x")。jj log 默认隐藏被 abandon 的提交和深层祖先。jj restore 不带路径会重置整个 @ 到父节点并删除新文件;jj abandon 不带参数会作用于 @。恢复依靠 jj op log 与 jj undo(最多一次),再用 jj op restore <op-id>。完成判定以探针输出为准,而非退出码:任务探针空输出为绿,推送探针非空为绿。冲突节点是含冲突标记的普通节点,编辑文件至最终状态即可。共置仓库中 git 仅用于只读需求,所有变更走 jj。