| 1 | import type { DocsComputersDict } from "../types"; |
| 2 | |
| 3 | /** 「把任务发送到云端」页的简体中文词典；与 `en/docs-computers.ts` 逐段对应。 */ |
| 4 | export const docsComputers: DocsComputersDict = { |
| 5 | metaTitle: "把任务发送到云端 · Codewhale 文档", |
| 6 | metaDescription: |
| 7 | "把编码任务交给 Codewhale 云端智能体，由它在一个分支上完成工作并提交拉取请求——先提议，只有你确认后才会开始。", |
| 8 | bodyClassName: "text-ink-soft leading-[1.9] tracking-wide", |
| 9 | title: "把任务发送到云端", |
| 10 | lede: |
| 11 | "云端智能体会把任务从你的机器上接走：它在一个全新的云端沙箱中工作，推送一个分支并提交拉取请求，你则可以继续在本地工作。在你确认之前，不会启动任何东西、不会产生费用，也不会推送代码。", |
| 12 | sections: [ |
| 13 | { |
| 14 | id: "status", |
| 15 | title: "了解目前的完成度", |
| 16 | blocks: [ |
| 17 | { |
| 18 | note: "云端智能体目前是预览版。完整流程已有离线测试覆盖，但真实链路——真实的沙箱，以及在各个代码托管平台上真实提交的拉取请求——尚未经过端到端验证。暂不支持私有仓库。", |
| 19 | }, |
| 20 | ], |
| 21 | }, |
| 22 | { |
| 23 | id: "before", |
| 24 | title: "开始之前", |
| 25 | blocks: [ |
| 26 | { |
| 27 | list: [ |
| 28 | "用 `codewhale login` 登录你的 Codewhale 账户。未登录时，任务只能提议，无法确认。", |
| 29 | "把账户 API 密钥设为 `CODEWHALE_API_KEY`，让沙箱中的智能体以你的账户身份运行。缺少它时，确认会在产生任何费用之前被拒绝。", |
| 30 | "如果使用 GitHub，请先登录 `gh` 命令行工具；Codewhale 会用这个登录来提交拉取请求。", |
| 31 | ], |
| 32 | }, |
| 33 | { code: "codewhale dispatch --status", lang: "终端" }, |
| 34 | { |
| 35 | p: "`--status` 会显示从你的 git 远程仓库中识别出的代码托管平台，以及所需的凭据是否齐全。它从不打印任何密钥。", |
| 36 | }, |
| 37 | ], |
| 38 | }, |
| 39 | { |
| 40 | id: "send", |
| 41 | title: "先提议，再确认", |
| 42 | blocks: [ |
| 43 | { |
| 44 | code: `codewhale dispatch "fix the flaky login test and open a PR" --remote github |
| 45 | codewhale dispatch --confirm cloud_<id>`, |
| 46 | lang: "终端", |
| 47 | }, |
| 48 | { |
| 49 | p: "第一条命令只写入一份提议并打印其 id；第二条命令才真正启动。Codewhale 可以自己提议云端任务，但从不自行确认。在会话中，使用 `/dispatch <task>` 和 `/dispatch confirm <id>`。", |
| 50 | }, |
| 51 | { |
| 52 | p: "确认之后，智能体会把仓库克隆到一个新沙箱中完成工作，推送一个新分支（绝不强制推送），并提交拉取请求。任务完成、失败或被取消时，沙箱都会被删除。", |
| 53 | }, |
| 54 | ], |
| 55 | }, |
| 56 | { |
| 57 | id: "track", |
| 58 | title: "跟踪或取消任务", |
| 59 | blocks: [ |
| 60 | { |
| 61 | code: `codewhale dispatch --list |
| 62 | codewhale dispatch --show cloud_<id> |
| 63 | codewhale dispatch --cancel cloud_<id>`, |
| 64 | lang: "终端", |
| 65 | }, |
| 66 | { |
| 67 | p: "云端任务也会出现在 `/jobs` 中。每个任务会显示进度、分支、拉取请求链接（有了之后），以及运行了多少分钟——这是运行时长，不是账单。取消会立即拆除沙箱。", |
| 68 | }, |
| 69 | ], |
| 70 | }, |
| 71 | { |
| 72 | id: "forge", |
| 73 | title: "选择拉取请求提交到哪里", |
| 74 | blocks: [ |
| 75 | { |
| 76 | p: "Codewhale 支持 GitHub、CNB 和 Gitee，且从不假定 `origin` 就是 GitHub。名为 `github`、`cnb` 或 `gitee` 的远程仓库即对应该平台；其他远程仓库按其主机名识别。如果仓库关联了多个平台，请传入 `--remote`。", |
| 77 | }, |
| 78 | { |
| 79 | p: "如果拉取请求无法提交——例如缺少代码托管平台的令牌——任务会在推送之后被标记为失败，并说明没有提交拉取请求。它绝不会报告一个并不存在的链接。", |
| 80 | }, |
| 81 | ], |
| 82 | }, |
| 83 | ], |
| 84 | next: [ |
| 85 | { |
| 86 | href: "/docs/auth", |
| 87 | label: "连接模型提供商", |
| 88 | note: "登录 Codewhale 账户并管理密钥。", |
| 89 | }, |
| 90 | { |
| 91 | href: "/docs/review", |
| 92 | label: "查看改动", |
| 93 | note: "合并之前，先审查智能体提交的拉取请求。", |
| 94 | }, |
| 95 | { |
| 96 | href: "/docs/fleet", |
| 97 | label: "运行工作流", |
| 98 | note: "改为在你自己的机器上运行更长的多步骤工作。", |
| 99 | }, |
| 100 | ], |
| 101 | sourceNote: "来源文档：docs/DAYTONA_CLOUD_DISPATCH.md、docs/CODEWHALE_AGENT.md · 修改时同步更新 docs-map.ts。", |
| 102 | }; |
| 103 |