Lava-Autocode 开发者使用说明
lava-autocode 是面向 Lava 项目开发者的 VS Code 插件。你可以在插件中查看项目共享信息、使用工程工具,并安装和启动 AI 智能体辅助研发工作。
1. 你可以使用哪些能力
| 能力模块 |
你可以做什么 |
| 项目信息 |
查看项目文档和团队规范,选择项目及目标环境 |
| 工程工具 |
执行环境预检、创建微服务、代码审查和 Jenkins 部署 |
| AI 智能团队 |
安装和启动 AI 智能体,维护当前插件的本地默认模型配置 |
三个模块相互独立,不需要按固定顺序使用。你可以根据当前任务直接进入对应模块。
2. 使用前准备
首次使用前,请确认:
- 账号可以正常登录插件并访问目标项目;
- 已在 VS Code 中打开需要开发的项目目录;
- 首页可以选择目标项目和环境;
- 使用 AI 智能团队时,可以连接公司 VPN 并访问公司 npm 私服。
如果项目或环境列表没有及时更新,请退出并重新登录插件。
3. 环境预检
环境预检会区分阻塞使用的必装项和不阻塞使用的建议项:
| 分类 |
检查项 |
规则 |
| 必装本地工具 |
Node.js、Python 3 |
Node.js 版本必须 ≥ 22.22.0,Python 版本必须 ≥ 3.0.0;缺失或版本过低时环境预检不通过 |
| 建议安装的 VS Code 插件 |
Extension Pack for Java、Spring Boot Extension Pack、Vue (Official) |
缺失时提供扩展市场安装入口,但不阻塞环境预检 |
| 建议安装的本地工具 |
Git、OpenSpec |
缺失时提示安装,但不阻塞环境预检 |
Python 3 缺失或仅检测到 Python 2 时,环境预检不会通过;详情页会显示「去安装」按钮并打开 Python 官方下载页。CC Switch 不再属于环境预检检查项。
4. 安装与登录
- 在 VS Code 扩展市场搜索 lava-autocode 并安装。
- 点击 VS Code 左侧 Activity Bar 中的 lava-autocode 图标打开工作台。
- 使用插件提供的授权方式登录。
- 在首页选择当前项目和目标环境。
如需退出登录,请打开命令面板并执行 lava-autocode: Logout。
5. 本地模型配置
在侧边栏「你的 AI 团队」标题右侧点击带设置图标的「我的模型」按钮,可以新增、编辑、复制、删除模型配置并设置唯一默认项。模型 Key 与 Tavily Key 保存在 VS Code 插件的 SecretStorage 中;列表中的复制图标由扩展端将完整模型 Key 直接写入系统剪贴板,明文不会进入 Webview。点击编辑时,当前详情页会在密码框中回显模型 Key,并可通过眼睛按钮切换显示,Tavily Key 不回显。
新启动智能体时,插件按以下顺序选择参数:本地默认模型的完整对象、当前项目环境的 agent-startup-parameters、Pi 自身默认值。插件不会在本地配置与项目配置之间混合字段;已运行终端保持原参数,关闭后重新启动才应用最新默认项。
6. 插件出现异常?
可重新加载 VS Code 窗口:
| 平台 |
操作 |
| Windows / Linux |
Ctrl+Shift+P → 输入并执行 Reload Window |
| macOS |
Cmd+Shift+P → 输入并执行 Reload Window |
| |