Dvina 在你电脑上的项目中编写代码，同时参考笔记、讨论和背后的原因。你只需说明需求、检查更改并交付成果，所有操作都在你处理其他事务的同一个应用中完成。
开始之前
编程功能内置于 Mac、Windows 和 Linux 上的 Dvina 桌面应用，无需单独安装。至少有一台电脑需要安装 Dvina；其他所有设备都可以发起任务并跟进进展。
要获取桌面应用，请参阅下载并安装 Dvina。
打开项目
项目是你电脑上的一个文件夹，可以是代码仓库，也可以是普通文件夹。
- 在桌面应用中，打开 Dock 并选择项目行（项目）。
- 选择**打开…来选取文件夹或代码仓库，或选择新建项目…**在这台电脑上创建新文件夹。
创建新项目时，开启创建 Git 仓库以保留每次更改的历史记录，这样就能撤销 Dvina 的编辑。
聊天会在你选择的项目中执行操作。如果是代码项目，Dock 还会显示其分支。
提出任务
描述你的需求，例如“让 CSV 导出使用正确的日期”。Dvina 会在你的电脑上将其作为任务执行，你可以继续聊天或启动更多任务。多个任务可以在同一个仓库中开展工作，并自行决定谁先提交。
编写代码前，Dvina 会阅读项目及其相关上下文：它会搜索你过去的聊天和文件，了解背后的原因。它也会遵循项目中的 AGENTS.md 或 CLAUDE.md。
检查更改
每个任务的回复都会附上更改，显示在以该任务命名、标有可供检查的卡片中。
- 查看更改内容：选择更改，在侧边面板中查看每个文件的更改。选择文件可以浏览项目。
- 撤销一轮更改：在修改了文件的回复下方，选择显示更改文件数量的那一行，再选择撤销，并确认撤销这一轮？。文件会恢复到这一轮更改前的状态，之后所做的更改会保留。
提交并创建拉取请求
- 在任务卡片中，选择提交。
- 提交更改会列出将提交到你的分支的文件，并提供建议的标题和消息。选择提交。此操作不会推送任何内容。
- 要创建拉取请求，选择推送并创建 PR。Dvina 会先推送当前分支，再创建拉取请求。未提交的文件不会包含在内。
拉取请求使用你自己的 Git 登录身份创建。Dvina 会在 GitHub 或 GitLab 上创建拉取请求；对于其他托管平台，则会在浏览器中打开该平台的新建拉取请求页面。完成后，选择查看 PR。
操作审批
构建和测试会直接运行。删除文件、推送、修改数据库、部署以及任何涉及密钥的操作，都需要先获得你的同意。卡片会说明原因，例如 运行此命令？，并标注 会删除文件 或 会修改数据库。你可以选择 允许 或 拒绝。管理员可以设置哪些操作始终需要询问。
重要
未经你的同意，不会推送任何内容。你的项目就是电脑上的一个文件夹，借助 Git，Dvina 所做的每一处修改都可以撤销。
在模拟器上测试
在桌面应用中，Dvina 可以在这台电脑上以用户实际使用的方式试用你的应用：在浏览器中、在 Mac 上的 iOS 模拟器中，或在 Mac、Windows 或 Linux 上的 Android 模拟器中。
- 打开 Dock，选择标有 设备 的一行。
- 在 此设备 下，选择 浏览器、iOS 模拟器 或 Android 模拟器。
对应窗格会在侧边面板中打开。如果模拟器尚未启动，打开时会自动启动。要使用其他设备，请选择窗格顶部的 选择设备；每台设备都会显示其系统，以及 运行中 或 已关闭 状态。
要显示或隐藏浏览器，在 Mac 上按 ⌘ ⇧ B，在 Windows 和 Linux 上按 Ctrl Shift B。如果 Dvina 正在你未查看的窗格中操作，设备 一行会显示一个圆点。
允许 Dvina 使用设备
Dvina 首次使用模拟器时会请求许可，例如 允许 Dvina 使用 iPhone 17 Pro？。因为 Dvina 能看到设备屏幕，所以请勿在其中登录你的真实账号。选择 允许 或 拒绝。设备会记住你的选择，换一个聊天也不会再次询问。在你允许之前，窗格会显示 允许 Dvina 使用此设备。
Dvina 操作时，窗格会显示 Dvina 正在使用此设备，聊天中也会实时显示设备画面。选择 放大查看 可查看更大的画面。在设备上发送、付款和删除，每次都需要先获得你的同意。
要亲自操作设备，请选择 接管。你的点击和按键会传递到设备，你还可以按 主屏幕，在 Android 上也可以按 返回 和 最近使用的应用。完成后，选择 交还控制权，Dvina 就会继续操作。
设置 iOS 模拟器
如果尚未设置 iOS 模拟器，选择对应的一行会打开 设置 iOS 模拟器 检查清单。每完成一步，该步骤就会自动勾选，即使你是在其他地方完成的。
- 安装 Xcode： 选择 打开 App Store。Xcode 免费，大小约为 7 GB；安装完成后，打开一次。
- 选择 Xcode： 选择 复制命令，然后在终端中运行。该命令会要求输入你的密码，因此 Dvina 不会代你运行。
- 添加 iOS 模拟器： 在 Xcode 中，前往 Settings › Components 并获取 iOS，或在终端中运行命令。
- 创建设备： 选择 创建 iPhone。此步骤不会下载任何内容。
设置 Android 模拟器
如果尚未设置 Android 模拟器，选择对应的一行会打开 设置 Android 模拟器 检查清单。
- 安装 Android Studio： 选择 获取 Android Studio。它会安装模拟器运行所需的组件；安装完成后，打开一次。
- 添加模拟器和平台工具： 在终端中运行命令，或在 Android Studio › SDK Manager 中添加。
- 启用硬件加速： 在 Windows 和 Linux 上，请自行运行命令，因为这需要你的密码或管理员权限。然后，在 Linux 上注销并重新登录，或在 Windows 上重启。Mac 无需执行此步骤。
- 添加系统映像： 在终端中运行命令，或在 Android Studio › SDK Manager 中添加。下载文件较大。
- 创建模拟器： 选择 创建模拟器。此步骤不会下载任何内容。
如果管理员关闭了模拟器，对应的行会显示 已被管理员关闭。
随时随地工作
你可以在手机或网页上，通过聊天提出工作需求。Dvina 会在你电脑上的项目中完成工作，所做的更改会等待你审核。你的电脑需要保持开机，并打开 Dvina。
适用场景
- 你正在开发实际的软件，希望工作时能参考完整的背景信息：笔记、决策和上个月的讨论。
- 你希望在离开办公桌时，也能完成修复。
- 你希望同时推进多项更改，并能逐一审核。
提示
- 写下你的工作规范。 在 AGENTS.md 或 CLAUDE.md 中说明你的工作方式，Dvina 会遵循这些规范。
- 在手机上测试。 正在开发应用？Dvina 可以在 iPhone 模拟器或 Android 模拟器中测试，像你的用户一样逐步点击操作。参阅在模拟器或仿真器上测试。
- 你不是开发者？ 如果想制作可用的应用和页面，请改用创建。