产品文档
安装与启动
Avelia 的常见使用形态分为桌面端与 VS Code 编码插件两部分。桌面端负责通用任务、群组协作和跨通道工作，编码能力则主要通过 VS Code 插件承载。
安装桌面端
- 1从官网下载安装包并完成安装。
- 2首次启动后，优先确认模型、权限和存储目录配置。
- 3建议先完成一次基础问答和一次简单任务，确认环境正常。
安装编码插件
如果你要使用代码理解、仓库修改、终端执行、补丁生成等编码能力，请在 VS Code 中安装 Avelias 插件。
首次进入编码模式的关键动作
安装完成后请切换到 VS Code 左侧的 Avelias 插件面板，让插件视图完成初始化。若始终停留在普通编辑器页面，部分交互可能不会按预期工作。
- 1打开 VS Code，进入扩展面板，快捷键为 Ctrl+Shift+X。
- 2搜索 Avelias 并安装，或在菜单中选择“Install from VSIX...”。
- 3安装后重新打开目标项目文件夹，让插件在真实工作区中初始化。
首次进入编码模式前建议确认
已打开工作区
建议使用“打开文件夹”，而不是只打开单个文件。
工作目录明确
你需要知道 AI 应该在哪个目录下读写、执行命令和组织结果。
目标清晰
提前说明是分析、修复、开发、补测试，还是只出方案。
编码插件操作流程
推荐操作顺序
- 先打开项目文件夹
- 不要只打开单个文件。
- 最好直接打开你的仓库根目录。
- 切换到 Avelias 插件面板
- 让插件视图完成初始化。
- 确认当前会话已经识别到工作区。
- 先做一次轻量验证
- 例如：
帮我梳理当前项目目录结构 - 或：
帮我定位登录相关文件
- 例如：
- 再进入真实修改
- 例如：
修复首页按钮不显示的问题，并说明改动点 - 或：
补一条接口报错的边界处理
- 例如：
VSIX 安装流程
- 下载上面的
.vsix文件。 - 打开 VS Code 扩展面板。
- 点击右上角菜单。
- 选择 Install from VSIX...。
- 选择下载好的插件包。
- 安装完成后重载窗口。
如果安装后看不到可用界面，优先检查是否已经切换到左侧的 Avelias 面板。
使用建议
当你准备让 Avelia 执行真实任务时，优先说明目标、工作目录、限制条件和交付形式。对复杂任务，优先使用群组协作或多代理分工，而不是把所有要求一次性堆给单个会话。