Lava-Autocode 开发者使用说明

lava-autocode 是面向项目开发者的 VS Code 插件。你可以在插件中查看项目共享信息、使用工程工具，并安装和启动 AI 智能体辅助研发工作。

1. 你可以使用哪些能力

三个模块相互独立，不需要按固定顺序使用。你可以根据当前任务直接进入对应模块。

2. 使用前准备

首次使用前，请确认：

• 账号可以正常登录插件并访问目标项目；
• 已在 VS Code 中打开需要开发的项目目录；
• 首页可以选择目标项目和环境；
• 使用 AI 智能团队时，可以连接公司 VPN 并访问公司 npm 私服。

如果项目或环境列表没有及时更新，请退出并重新登录插件。

3. 环境预检

环境预检会区分阻塞使用的必装项和不阻塞使用的建议项：

Python 3 缺失或仅检测到 Python 2 时，环境预检不会通过；详情页会显示「去安装」按钮并打开 Python 官方下载页。

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

4. 安装与登录

1. 在 VS Code 扩展市场搜索 lava-autocode 并安装。
2. 点击 VS Code 左侧 Activity Bar 中的 lava-autocode 图标打开工作台。
3. 使用插件提供的授权方式登录。
4. 在首页选择当前项目和目标环境。

如需退出登录，请打开命令面板并执行 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 同步。

「智能体设置」详情页列表头部的「设置」按钮可配置团队级子代理模型策略，作用于所有内置子代理的智能体（当前为开发工程师、CLI 工程师），三选一：

• 跟随会话：子代理与主会话使用同一模型，不允许子代理自行更换；
• 范围内自主：子代理可在你配置的本地模型范围内自主选择；
• 完全自主：不施加限制（默认行为）。

策略按登录账号保存在本机 globalState，仅在下一次启动智能体时生效；已运行终端保持原行为。「跟随会话」与「范围内自主」会把模型白名单写入智能体的 Pi 设置（enabledModels），主会话的模型切换范围也会随之受限。策略写入依赖新版 @ya/aim-pi，旧版本仅显示升级提示。

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

6. 插件出现异常？

可重新加载 VS Code 窗口：