lava-autocode 是面向项目开发者的 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 官方下载页。

登录成功后插件会自动运行一次环境预检，结果随登录状态保存；之后打开插件会复用最近一次预检结果，点击「运行环境预检」可随时复查并更新保存结果。退出登录或进入登录页时，保存的预检数据会被清除。

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 自身默认值。插件不会在本地配置与项目配置之间混合字段；已运行终端保持原参数，关闭后重新启动才应用最新默认项。

「智能体设置」详情页展示服务端返回的完整智能体目录。点击「固定」会将该智能体置于列表前部，点击独立的「取消固定」会使它从当前账号的 AI 团队侧边栏隐藏；设置页仍保留该智能体并显示「固定」按钮。固定组和未固定组都可通过行首手柄拖动排序，排序成功后当前账号的 AI 团队侧边栏会立即同步；也可聚焦手柄后使用上下方向键调整。侧边栏标题旁的问号图标另行打开「智能体说明」操作详情。偏好仅保存在当前 VS Code Profile 的本机 globalState 中，按登录账号隔离，退出登录后仍保留且不会通过 Settings Sync 同步。

账号没有本地偏好时使用服务端 default-pinned 默认值；旧服务端未提供该字段时兼容为全部固定。使用「恢复默认固定」并确认后，只删除当前账号的本地覆盖并重新继承服务端默认。