智能体管理器
智能体管理器是一款专用控制面板,可将 VJSP 智能体作为交互式命令行进程运行并监控,支持以下功能:
- 本地会话运行
- 恢复已存在的会话
- 并行模式(兼容 Git 工作树),实现安全、隔离的代码修改
- 查看并继续与当前代码仓库匹配的云端同步会话
本页面内容与插件实际实现逻辑完全一致。
前置条件
- 安装/更新最新版 VJSP 命令行工具(CLI)—— 详见命令行工具配置
- 在 VS Code 中打开项目(需已创建工作区)
- 身份验证:需通过插件设置完成登录,或使用以 vjsp 为服务商的命令行工具(详见身份验证要求章节)
打开智能体管理器
- 命令面板:输入「VJSP:打开智能体管理器」
- 若 VJSP 界面提供对应标题/菜单入口,可直接点击打开
该面板以网页视图形式打开,切换窗口焦点时仍保持激活状态。
消息发送、操作审批与进程控制
- 继续对话:向运行中的智能体发送跟进消息
- 操作审批:当智能体请求调用工具、执行命令、启动浏览器或连接 MCP 服务器时,界面将弹出审批提示
- 可选择批准或拒绝,也可按需添加简短备注
- 取消与停止的区别
- 取消:向运行中的进程发送结构化取消指令(协作式优雅停止)
- 停止:强制终止底层命令行进程,进程状态同步更新为「已停止」
恢复已存在的会话
本地或远程会话均可在后续继续使用:
- 若目标会话当前未运行,智能体管理器将启动新的命令行进程,并关联该会话的唯一标识(ID)
- 原会话的标签信息将尽可能保留
- 发送的第一条跟进消息将作为会话恢复的输入内容
并行模式
并行模式会在独立的 Git 工作树分支中运行智能体,确保主分支代码清洁无冗余修改。
- 启动智能体前,开启「并行模式」开关
- 插件会禁止在已存在的工作树内使用并行模式
- 需打开主代码仓库(.git 为文件夹的目录)方可使用该功能
工作树存储路径
工作树将创建在项目目录下的 .vjsp/worktrees/ 文件夹中。该文件夹会被自动添加至 Git 本地忽略规则(.git/info/exclude),无需提交至代码仓库。
your-project/
├── .git/
│ └── info/
│ └── exclude # Git 本地忽略规则(已包含 .vjsp/worktrees/)
├── .vjsp/
│ └── worktrees/
│ └── feature-branch-1234567890/ # 独立的代码工作目录
└── ...运行中状态展示
智能体管理器将实时展示以下信息:
- 已创建/正在使用的分支名称
- 工作树的具体路径
- 智能体运行完成后,将显示分支合并/完成的操作指引
运行完成后处理
- 工作树将自动清理,但其对应的分支会被保留
- 可在版本控制(VCS)界面中查看该分支的代码修改
- 按需执行分支合并或 cherry-pick 操作,整合代码修改
并行模式会话恢复
若后续恢复并行模式的会话,插件将按以下逻辑执行:
- 若原工作树仍存在,直接复用该工作树
- 若原工作树已被清理,从该会话关联的分支重新创建工作树
身份验证要求
智能体管理器需完成合法身份验证,方可解锁全功能使用,包括会话同步。
支持的身份验证方式
方式一:VJSP 插件(推荐)
- 通过插件设置页面完成登录
- 为智能体管理器提供无缝的身份验证体验
方式二:以 VJSP 为服务商的命令行工具
- 使用已配置
vjsp为默认服务商的命令行工具 - 执行
vjsp config命令完成身份验证配置 - 详细步骤详见命令行工具配置
问题排查
提示「Please open a folder…」(请打开一个文件夹)
- 智能体管理器的使用依赖 VS Code 工作区文件夹,需先打开项目目录
提示「Cannot use parallel mode from within a git worktree」(无法在 Git 工作树内使用并行模式)
- 需打开主代码仓库(.git 为文件夹的目录),而非工作树的检出目录
身份验证失败
- 验证是否已通过插件设置完成登录,或使用了以 vjsp 为服务商的命令行工具
