Skip to content

智能体管理器

智能体管理器是一款专用控制面板,可将 VJSP 智能体作为交互式命令行进程运行并监控,支持以下功能:

  • 本地会话运行
  • 恢复已存在的会话
  • 并行模式(兼容 Git 工作树),实现安全、隔离的代码修改
  • 查看并继续与当前代码仓库匹配的云端同步会话

本页面内容与插件实际实现逻辑完全一致。

前置条件

  1. 安装/更新最新版 VJSP 命令行工具(CLI)—— 详见命令行工具配置
  2. 在 VS Code 中打开项目(需已创建工作区)
  3. 身份验证:需通过插件设置完成登录,或使用以 vjsp 为服务商的命令行工具(详见身份验证要求章节)

打开智能体管理器

  • 命令面板:输入「VJSP:打开智能体管理器」
  • 若 VJSP 界面提供对应标题/菜单入口,可直接点击打开

该面板以网页视图形式打开,切换窗口焦点时仍保持激活状态。

消息发送、操作审批与进程控制

  • 继续对话:向运行中的智能体发送跟进消息
  • 操作审批:当智能体请求调用工具、执行命令、启动浏览器或连接 MCP 服务器时,界面将弹出审批提示
    • 可选择批准或拒绝,也可按需添加简短备注
  • 取消与停止的区别
    • 取消:向运行中的进程发送结构化取消指令(协作式优雅停止)
    • 停止:强制终止底层命令行进程,进程状态同步更新为「已停止」

恢复已存在的会话

本地或远程会话均可在后续继续使用:

  • 若目标会话当前未运行,智能体管理器将启动新的命令行进程,并关联该会话的唯一标识(ID)
  • 原会话的标签信息将尽可能保留
  • 发送的第一条跟进消息将作为会话恢复的输入内容

并行模式

并行模式会在独立的 Git 工作树分支中运行智能体,确保主分支代码清洁无冗余修改。

  1. 启动智能体前,开启「并行模式」开关
  2. 插件会禁止在已存在的工作树内使用并行模式
    • 需打开主代码仓库(.git 为文件夹的目录)方可使用该功能

工作树存储路径

工作树将创建在项目目录下的 .vjsp/worktrees/ 文件夹中。该文件夹会被自动添加至 Git 本地忽略规则(.git/info/exclude),无需提交至代码仓库。

your-project/
├── .git/
│   └── info/
│       └── exclude   # Git 本地忽略规则(已包含 .vjsp/worktrees/)
├── .vjsp/
│   └── worktrees/
│       └── feature-branch-1234567890/   # 独立的代码工作目录
└── ...

运行中状态展示

智能体管理器将实时展示以下信息:

  • 已创建/正在使用的分支名称
  • 工作树的具体路径
  • 智能体运行完成后,将显示分支合并/完成的操作指引

运行完成后处理

  • 工作树将自动清理,但其对应的分支会被保留
  • 可在版本控制(VCS)界面中查看该分支的代码修改
  • 按需执行分支合并或 cherry-pick 操作,整合代码修改

并行模式会话恢复

若后续恢复并行模式的会话,插件将按以下逻辑执行:

  1. 若原工作树仍存在,直接复用该工作树
  2. 若原工作树已被清理,从该会话关联的分支重新创建工作树

身份验证要求

智能体管理器需完成合法身份验证,方可解锁全功能使用,包括会话同步。

支持的身份验证方式

方式一:VJSP 插件(推荐)

  • 通过插件设置页面完成登录
  • 为智能体管理器提供无缝的身份验证体验

方式二:以 VJSP 为服务商的命令行工具

  • 使用已配置 vjsp 为默认服务商的命令行工具
  • 执行 vjsp config 命令完成身份验证配置
  • 详细步骤详见命令行工具配置

问题排查

提示「Please open a folder…」(请打开一个文件夹)

  • 智能体管理器的使用依赖 VS Code 工作区文件夹,需先打开项目目录

提示「Cannot use parallel mode from within a git worktree」(无法在 Git 工作树内使用并行模式)

  • 需打开主代码仓库(.git 为文件夹的目录),而非工作树的检出目录

身份验证失败

  • 验证是否已通过插件设置完成登录,或使用了以 vjsp 为服务商的命令行工具

相关功能