前言¶

在多智能体协作场景中，版本控制往往成为瓶颈。传统 Git 工作流中，多个智能体同时操作同一个仓库时，容易出现冲突、分支混乱或权限边界不清的问题。DeepSeek Harness (DSH) 通过插件化架构支持扩展，dsh-jj-vcs 插件正是为此设计。它将 Jujutsu 的版本控制能力引入 DSH 智能体团队，通过独立的变更（change）和清晰的归属管理，为多智能体协作提供更健壮的版本控制方案。

插件简介¶

dsh-jj-vcs 是一个为 DeepSeek Harness 智能体团队提供的 Jujutsu 版本控制插件。该插件由社区开发者 bingfengaaaaa 维护，采用 MIT 许可证。它旨在解决多智能体并行开发时的版本管理难题，通过将智能体任务映射为独立的 Jujutsu 变更，实现清晰的归属审计和操作追踪。

核心能力¶

该插件主要提供以下功能：

• 独立的智能体工作区：为每个智能体创建一个外部 JJ 工作区和独立的变更。
• 明确的归属权：在变更描述中记录任务和智能体信息，并在交接时验证两者。
• 可审计的变更：记录任务设置前后的操作 ID，确保变更可追溯。
• 受控的发布：将本地编辑、共享历史变更和远程可见操作分开管理。
• 并发安全：拒绝冲突、分歧的变更、共享变更所有权以及意外的工区。
• Windows 兼容性：检测可能导致误报文件变更的 Git 符号链接和工作区别名。

安装与启用¶

使用以下命令将插件添加到指定的 Profile 中（推荐使用具体的版本标签以保持稳定）：

dsh plugin --profile <profile> add github:bingfengaaaaa/dsh-jj-vcs#v0.1.1
dsh --profile <profile> --dump-config

典型用法¶

在使用插件前，需要确认 JJ 版本。插件维护的命令规则基于 jj 0.44.0。首先检查版本：

jj --version
jj help
node <skill-dir>/scripts/verify-jj-compat.mjs --repo <repository>

在实际任务流程中，协调者（coordinator）需要启动任务并创建智能体的工作区：

node <skill-dir>/scripts/jj-task.mjs start \
  --repo <coordinator-workspace> \
  --destination <external-worker-directory> \
  --workspace <task-agent-name> \
  --agent <agent-id> \
  --task <task-id> \
  --base <explicit-revset>

智能体完成编辑后，在交接前需要执行完成验证：

node <skill-dir>/scripts/jj-task.mjs finish \
  --workspace-root <external-worker-directory> \
  --workspace <task-agent-name> \
  --agent <agent-id> \
  --task <task-id> \
  --expected-change <change-id>

开发者可以通过以下命令进行本地验证：

npm run verify
npm test
npm pack --dry-run --json

适用场景与注意事项¶

该插件适用于需要精细化管理多智能体协作版本控制、关注操作审计和并发安全的团队。它依赖于 Jujutsu (jj) 作为底层版本控制工具，具体版本需锁定为 0.44.0。

需要注意以下几点：

• 独立社区项目：这是一个独立的社区项目，并非 DeepSeek 官方发布。
• 安装不包含依赖：安装插件不会自动安装 JJ、初始化仓库、更改 Git 远程地址或处理凭据。仓库初始化和远程可见操作仍需单独授权。
• 权限分级：插件支持将权限分为四级：只读检查、任务本地变更、共享本地历史和远程可见操作。
• Windows 正确性：插件针对 Windows 环境进行了正确性修正，以避免 Git 符号链接和别名导致的误报。

总结¶

dsh-jj-vcs 通过引入 Jujutsu 的变更模型，为 DSH 多智能体协作提供了更清晰的版本控制边界和操作审计能力。对于需要严格版本管理的企业级或多智能体项目，这是一个值得尝试的社区方案。

插件详情与源码可参考：
- GitHub 仓库
- SkillHub 目录