桌面端安装与使用

本指南介绍 Remy 桌面端的安装、登录、项目配置、任务执行、结果查看及更新。首次使用时，可以结合 Quick Start 完成一个完整的编程任务。

flowchart LR
    A["下载与安装"] --> B["登录账号"]
    B --> C["添加项目"]
    C --> D["发起任务"]
    D --> E["检查结果"]
    E --> F["继续修改或交付"]

1. 使用前准备

1.1 选择适合电脑的安装包

在 Mac 上，可以通过  → 关于本机 查看芯片或处理器；在 Windows 上，可以通过 设置 → 系统 → 系统信息／关于 → 系统类型 查看架构。

1.2 准备账号与工作环境

Remy 与项目的运行环境分别准备。桌面端自带运行环境，无需为安装 Remy 另装 Python 或 Node.js；如果你的项目需要这些工具，仍需按项目说明准备。

2. 下载与安装

通过 Remy 官网下载入口 获取安装包，按上一章的系统与芯片选择对应版本。

2.1 macOS

1. 下载对应芯片的 DMG 安装包。
2. 双击打开 DMG，按安装窗口提示将 Remy 放入 Applications（应用程序）。
3. 从“应用程序”文件夹打开 Remy。

安装成功的标志： Remy 可以正常打开，并显示登录界面；如果已经登录，则进入工作界面。

2.2 Windows

1. 下载 Windows x64 EXE 安装包。
2. 双击安装包，按照安装向导继续。
3. 选择安装目录，完成安装。
4. 从开始菜单打开 Remy。

安装成功的标志： Remy 可以正常打开，并显示登录界面或工作界面。

2.3 安装后先检查什么

• 安装包与电脑的系统和芯片一致。
• 应用可以正常启动。
• 点击 Get started 后，系统浏览器能够打开登录页面。

安装包无法打开或应用无法启动时，参见第 7 章的对应问题。

3. 登录与认识界面

3.1 登录账号

1. 打开 Remy，点击 Get started。
2. 在系统浏览器中完成登录。
3. 返回 Remy，进入工作界面。

等待浏览器登录期间，应用会显示 Continue signing in with your browser。

如果需要重新开始，可以点击 Cancel sign-in，再点击 Get started。登录失败时，先根据界面提示检查网络或重新发起登录。

3.2 认识常用入口

查看设置： 点击侧栏底部的账号入口，选择 Settings。需要退出当前账号时，在账号菜单中选择 Log out。

4. 项目与对话

4.1 添加已有项目

1. 打开项目选择菜单，点击 New project。
2. 在 Create project 窗口中填写 Project name。
3. 在 Source folders 中点击 Add folders the agent can read and edit，选择代码所在的本地目录。
4. 核对项目名称和目录，点击 Create project。
5. 在该项目中点击 New chat，开始任务。

通常应选择包含项目说明、源代码及构建配置的项目根目录。例如：

example-project/       ← 添加这个目录
├── README.md
├── package.json       ← 项目的环境与依赖配置（示例）
├── src/
└── tests/

这是目录结构示例；实际文件名取决于你的项目。

Source folders 是 Remy 可以读取和编辑的项目目录。创建项目前确认选中了目标项目，任务中再说明本次操作范围。

4.2 一个项目需要多个目录时

例如前端和后端分别位于两个目录，可以在 Source folders 中继续点击 Add folder。

补充要求时，说明涉及哪个目录，避免让 Remy 只根据名称猜测。

这个项目包含前端和后端两个目录。
请先检查前端提交参数与后端校验规则是否一致，列出相关文件和差异。
只分析，不修改文件。

4.3 新建还是继续对话

开始任务前，检查当前项目名称和目录。新建对话后，仍应把本次目标与约束说清楚。

5. 执行任务与查看结果

5.1 选择模型并说明任务

在输入框旁选择可用模型；如提供推理设置，可按任务需要调整。也可以选择 Dynamic，由 Remy 按任务选择模型，遇到困难时可自动升级；具体型号不向用户展示。

用户当前不能在任务执行过程中手动切换模型。可选模型和推理设置以应用内列表为准。

一个容易执行和检查的任务，可以按下面的方式描述：

5.2 使用可复制的任务模板

以下示例中的业务模块和行为，应替换为你项目中的实际情况。

定位并修复问题

订单列表在第 3 页时切换状态筛选，结果显示为空；
回到第 1 页后才有数据。

请定位原因，让切换筛选时重置页码，补充并运行相关测试。
只修改相关逻辑，最后说明改动文件、检查结果及无法完成的检查。
先不要提交或推送代码。

只审查现有改动

请审查当前未提交的改动，重点检查筛选、分页和排序是否相互影响，
以及是否遗漏边界情况。

按严重程度列出问题，附文件位置、触发条件和修改建议。
先不要修改文件、提交或推送代码。

完整的首次编程任务示例见 Quick Start。

5.3 任务过程中补充信息

如果 Remy 需要你补充信息或确认操作，先阅读问题，再给出答复。需求发生变化时，在同一对话中明确说明调整范围。

补充一个限制：本次不修改接口，只调整前端筛选行为。
如果当前方案需要改接口，请先说明原因和影响，等待我确认。

5.4 查看文件与改动

• 在 Explorer 中查看项目文件，打开需要检查的内容。
• 在 Changes 中查看 Git 工作区的文件改动。选择文件，阅读增加、删除或修改的内容。
• 如果尚未打开这些面板，可从面板添加入口选择 Explorer 或 Changes。

Changes 展示的是当前 Git 工作区的改动。它可能同时包含任务开始前已有的未提交改动；检查时要区分本次任务与原有工作。非 Git 目录没有相对 HEAD 的差异，可以直接检查实际文件和任务说明。

5.5 判断任务是否完成

结果不符合预期时，在原对话中描述具体问题。例如：

切换筛选条件后，页码已经回到第 1 页，但列表没有刷新。
预期是更新筛选条件后立即请求新数据。

请只修复这一问题，补充并运行相关测试，
最后说明修改与检查结果。先不要提交或推送代码。

6. 更新 Remy

6.1 查看当前版本

在 macOS 上，可以通过 Remy → About Remy 查看应用版本。

提交问题反馈时，也可以在反馈窗口中将鼠标移到 Information included automatically，查看 Remy version 等随报告提供的信息。

6.2 手动检查更新

检查结果可能包括：

6.3 安装更新

1. 保存正在编辑的内容，检查是否还有正在执行的任务。
2. 更新下载完成后，在更新提示中选择 Install Update；也可以点击侧栏的 Relaunch to update。
3. 按提示完成安装并重新打开应用。

如果应用提示任务仍在执行，建议先完成当前工作，再重新启动更新。

7. 常见问题与已知限制

7.1 安装、登录或使用遇到问题

7.2 需要了解的限制

• 用户不能在任务执行过程中手动切换模型；Dynamic 可以自动升级模型。
• Branch 创建的是对话分支，不会撤销文件改动。
• Browser Use 与 Computer Use 当前仅支持 macOS。
• 处理本地项目时，保持电脑、Remy 应用和任务所需环境可用；云端任务的使用方式见 Cloud 指南。

8. 获取帮助与进一步使用

8.1 提交问题反馈

1. 打开对应对话的菜单，选择 Send feedback。
2. 在 Submit feedback to Remy 窗口中填写反馈类型、影响程度和问题描述。
3. 按需要补充截图或附件，点击 Submit feedback。

也可以在侧栏对话条目上打开右键菜单，选择 Send feedback。

描述问题时，说明复现步骤、预期结果与实际结果，并附上错误提示或相关截图。

8.2 评价任务回复

使用回复下方的赞／踩，补充哪些内容有帮助、哪些地方不符合预期。具体的任务目标、错误现象和预期结果更有助于后续处理。

找不到反馈入口，或无法进入应用时，可以联系运营支持：support@corepass.com。

8.3 继续阅读