| 1 | import type { DocsWebDict } from "../types"; |
| 2 | |
| 3 | /** 「打开浏览器客户端」页的简体中文词典；与 `en/docs-web.ts` 逐段对应。 */ |
| 4 | export const docsWeb: DocsWebDict = { |
| 5 | metaTitle: "打开浏览器客户端 · Codewhale 文档", |
| 6 | metaDescription: |
| 7 | "在你自己机器上的浏览器标签页里使用 Codewhale，或者用 /rc 在 Codewhale 网页应用中接着使用正在终端里运行的会话。", |
| 8 | bodyClassName: "text-ink-soft leading-[1.9] tracking-wide", |
| 9 | title: "打开浏览器客户端", |
| 10 | lede: |
| 11 | "比起终端，更喜欢浏览器窗口？Codewhale 可以在你的机器上提供自己的客户端。它只是同一个本地会话的另一种视图——审批相同、沙箱相同，也不需要账户。", |
| 12 | sections: [ |
| 13 | { |
| 14 | id: "start", |
| 15 | title: "启动", |
| 16 | blocks: [ |
| 17 | { p: "在你希望 Codewhale 工作的文件夹中运行：" }, |
| 18 | { code: "codewhale web\ncodewhale web --port 8788 # if 7878 is taken", lang: "终端" }, |
| 19 | { |
| 20 | p: "Codewhale 会在 `http://127.0.0.1:7878` 启动本地服务，打印一个一次性链接，并在默认浏览器中打开它。如果浏览器没有打开，请在十分钟内使用打印出来的链接。在终端按 Ctrl+C 即可停止，浏览器会话也随之结束。", |
| 21 | }, |
| 22 | ], |
| 23 | }, |
| 24 | { |
| 25 | id: "use", |
| 26 | title: "在浏览器中工作", |
| 27 | blocks: [ |
| 28 | { |
| 29 | p: "浏览器客户端可以列出和搜索你的会话线程，显示对话记录及每个工具的结果，并提供输入框。你可以开始、引导或中断一个回合，回应审批，给线程改名或归档。你的提供商密钥始终留在 Codewhale 中，不会被复制到浏览器存储里。", |
| 30 | }, |
| 31 | ], |
| 32 | }, |
| 33 | { |
| 34 | id: "local", |
| 35 | title: "只在本机使用", |
| 36 | blocks: [ |
| 37 | { |
| 38 | list: [ |
| 39 | "服务只监听 `127.0.0.1`。没有任何选项能把它开放到你的网络，也无法在不认证的情况下运行。", |
| 40 | "链接中携带的是一次性代码，而不是你的访问令牌。打开链接时，这个代码会换成一个绑定到当前进程的 cookie，随即失效。", |
| 41 | "不要通过路由器、公共代理或隧道转发这个端口。如果要在手机或另一台机器上使用，请参阅 [Runtime API](/docs/runtime-api)，并先读一读它的认证规则。", |
| 42 | ], |
| 43 | }, |
| 44 | ], |
| 45 | }, |
| 46 | { |
| 47 | id: "remote", |
| 48 | title: "在网页应用中接着使用会话", |
| 49 | blocks: [ |
| 50 | { |
| 51 | p: "这是另一回事：它把已经在终端里运行的会话交给已登录的 Codewhale 网页应用，让你可以换一台设备继续。这需要一个 [Codewhale 账户](/docs/auth#account)。", |
| 52 | }, |
| 53 | { |
| 54 | code: `/rc # in the running session; approve the one-time code in your browser |
| 55 | /rc status # who controls the session now |
| 56 | /rc link # print the session link |
| 57 | /rc stop # hand control back to the terminal`, |
| 58 | lang: "Codewhale", |
| 59 | }, |
| 60 | { |
| 61 | p: "网页应用接管会话期间，新的提示和审批都来自浏览器，终端仍可查看内容。任何一方都可以中断。你也可以用 `codewhale rc` 直接以这种方式启动会话。", |
| 62 | }, |
| 63 | ], |
| 64 | }, |
| 65 | { |
| 66 | id: "fix", |
| 67 | title: "遇到问题时", |
| 68 | blocks: [ |
| 69 | { |
| 70 | rows: [ |
| 71 | ["端口被占用", "用 `--port` 指定一个空闲端口。"], |
| 72 | ["浏览器没有打开", "在十分钟内，把打印出来的链接复制到同一台机器上的浏览器中打开。"], |
| 73 | ["链接已过期或已被使用", "这是预期行为。重新运行 `codewhale web` 获取新链接。"], |
| 74 | ["模型没有回复", "web 命令不负责配置提供商。请检查 `codewhale doctor` 和 `/provider`。"], |
| 75 | ], |
| 76 | }, |
| 77 | ], |
| 78 | }, |
| 79 | ], |
| 80 | next: [ |
| 81 | { |
| 82 | href: "/docs/runtime-api", |
| 83 | label: "用 Runtime API 自动化", |
| 84 | note: "浏览器客户端所基于的本地 API。", |
| 85 | }, |
| 86 | { |
| 87 | href: "/docs/auth", |
| 88 | label: "连接模型提供商", |
| 89 | note: "为浏览器客户端接上一个模型。", |
| 90 | }, |
| 91 | { |
| 92 | href: "/docs/modes", |
| 93 | label: "设置模式与审批", |
| 94 | note: "浏览器中同样适用这些审批设置。", |
| 95 | }, |
| 96 | ], |
| 97 | sourceNote: "来源文档：docs/WEB.md · 修改时同步更新 docs-map.ts。", |
| 98 | }; |
| 99 |