智能体开发工具上手指南

1. 安装　双击下载的安装包，按向导完成安装（Windows 一路"下一步"）。
2. 启动　双击 Qoder 图标，首次启动会要求登录。
3. 激活　点击界面右上角用户图标（或按 Ctrl+Shift+,）→ 选择「登录」→ 用 Google / GitHub 账号或邮箱完成注册登录。

1. 打开平台　访问 platform.deepseek.com，用手机号或邮箱注册 / 登录。
2. 进入密钥页　登录后，在左侧导航栏选择 「API Keys」。
3. 创建密钥　点击 「创建新的 API key」并命名（如 qoder-exec-01），便于日后按人按工具吊销。
4. 立即保存　完整密钥仅在创建时显示一次，请立刻复制到密码管理器；页面关闭后无法再查看。
5. 确认余额　在「充值」中确认余额（按量计费），先充小额即可。

• 内置模型开箱即用：已内置 Deepseek-V4-Flash 等主流模型，不配 Key 也能用，按 Token 配额套餐计费。
• 接入自有 Key：API Key 仅保存在本地 models.json，不上传云端，适合数据敏感场景。
• 与 Qoder 的差异：Qoder 的提供商为下拉预设，并支持按量付费 / Coding plan / Token plan 三类；两者费用均由第三方模型账户直接结算。
• 配置不通过时依次检查：密钥有无多余空格 → 是否过期或禁用 → 余额是否充足 → 网络是否可达。

1. 打开设置　点击右上角用户图标 → 设置（Settings）。
2. 切换到「模型」　在左侧导航栏选择 「模型 / Models」。
3. 添加模型　点击右上角 「+ 添加」，弹出「添加模型」窗口。
4. 填写三项　► 提供商：选 DeepSeek；► 类型：选 按量付费；► API 密钥：粘贴上一步复制的 Key（可点「获取 API 密钥」直达平台）。
5. 验证并启用　点击「添加」，系统自动验证连接；通过后回到对话框，在模型下拉中选中它即可。

1. 建一个专用空文件夹　例如 D:\vibe-lab。记住：一个"工作区"就是电脑上的一个文件夹，AI 只会在这个文件夹内动手。
2. 选择工作模式　启动 Qoder，在左上角选择「编程」或「通用」：编程按工作区组织任务（适合改代码、跑命令、用 Git 分支）；通用按文件夹组织任务（适合处理资料、调研、内容整理）。
3. 关联项目并发出任务　选择已有工作区，或「添加本地项目」指定刚建的文件夹；编程模式下确认本地模式与当前分支，再在「新任务」输入框写明目标并发送。

Qoder 内置的「优化输入」（提示词增强）把"一句话想法"自动补全为结构化需求。这是非技术用户收益最大的一个按钮——它用极少的额外消耗，换掉大量返工。

1

三步法

1. 先写"人话"　在对话框写下粗需求，一句话即可，例如"把这份会议纪要整理成待办清单"。
2. 点「优化输入」　系统结合当前上下文与历史对话，自动生成详细且可操作的提示词。
3. 审阅再提交　生成结果包含目标、约束条件和实现指导，可手动修改；确认后直接提交。