docs: improve zh-cn and zh-tw documentation translations (#13942)
This commit is contained in:
@@ -1,43 +1,43 @@
|
||||
---
|
||||
title: 介绍
|
||||
description: 开始使用 opencode。
|
||||
title: 简介
|
||||
description: 开始使用 OpenCode。
|
||||
---
|
||||
|
||||
import { Tabs, TabItem } from "@astrojs/starlight/components"
|
||||
import config from "../../../../config.mjs"
|
||||
export const console = config.console
|
||||
|
||||
[**opencode**](/) 是一个开源人工智能编码代理。它可用于基于终端的界面、桌面应用程序或 IDE 扩展。
|
||||
[**OpenCode**](/) 是一个开源的 AI 编码代理。它提供终端界面、桌面应用和 IDE 扩展等多种使用方式。
|
||||
|
||||

|
||||

|
||||
|
||||
让我们开始吧。
|
||||
|
||||
---
|
||||
|
||||
#### 先决条件
|
||||
#### 前提条件
|
||||
|
||||
要在终端中使用 opencode,您需要:
|
||||
要在终端中使用 OpenCode,你需要:
|
||||
|
||||
1. 现代终端模拟器,例如:
|
||||
1. 一款现代终端模拟器,例如:
|
||||
- [WezTerm](https://wezterm.org),跨平台
|
||||
- [Alacritty](https://alacritty.org),跨平台
|
||||
- [Ghostty](https://ghostty.org),Linux 和 macOS
|
||||
- [Kitty](https://sw.kovidgoyal.net/kitty/),Linux 和 macOS
|
||||
|
||||
2. 你要使用的 LLM 提供商 API 密钥。
|
||||
2. 你想使用的 LLM 提供商的 API 密钥。
|
||||
|
||||
---
|
||||
|
||||
## 安装
|
||||
|
||||
安装 opencode 最简单的方法是通过安装脚本。
|
||||
安装 OpenCode 最简单的方法是通过安装脚本。
|
||||
|
||||
```bash
|
||||
curl -fsSL https://opencode.ai/install | bash
|
||||
```
|
||||
|
||||
您还可以使用以下命令安装它:
|
||||
你也可以使用以下方式安装:
|
||||
|
||||
- **使用 Node.js**
|
||||
|
||||
@@ -79,9 +79,9 @@ curl -fsSL https://opencode.ai/install | bash
|
||||
brew install anomalyco/tap/opencode
|
||||
```
|
||||
|
||||
> 我们使用 opencode Tap 来获取最新版本。官方 `brew install opencode` 公式由 Homebrew 团队建议,维护频率较低。
|
||||
> 我们推荐使用 OpenCode tap 以获取最新版本。官方的 `brew install opencode` formula 由 Homebrew 团队维护,更新频率较低。
|
||||
|
||||
- **在 Arch Linux 上使用 Paru**
|
||||
- **在 Arch Linux 上安装**
|
||||
|
||||
```bash
|
||||
sudo pacman -S opencode # Arch Linux (Stable)
|
||||
@@ -91,7 +91,7 @@ curl -fsSL https://opencode.ai/install | bash
|
||||
#### Windows
|
||||
|
||||
:::tip[推荐:使用 WSL]
|
||||
为了在 Windows 上获得最佳体验,我们建议使用 [Windows Subsystem for Linux (WSL)](/docs/windows-wsl)。它提供了更好的性能并与 opencode 的功能完全兼容。
|
||||
为了在 Windows 上获得最佳体验,我们推荐使用 [Windows Subsystem for Linux (WSL)](/docs/windows-wsl)。它提供更好的性能,并完全兼容 OpenCode 的所有功能。
|
||||
:::
|
||||
|
||||
- **使用 Chocolatey**
|
||||
@@ -106,7 +106,7 @@ curl -fsSL https://opencode.ai/install | bash
|
||||
scoop install opencode
|
||||
```
|
||||
|
||||
- **使用 npm**
|
||||
- **使用 NPM**
|
||||
|
||||
```bash
|
||||
npm install -g opencode-ai
|
||||
@@ -124,18 +124,17 @@ curl -fsSL https://opencode.ai/install | bash
|
||||
docker run -it --rm ghcr.io/anomalyco/opencode
|
||||
```
|
||||
|
||||
目前正在支持在 Windows 上安装 opencode 时使用 Bun。
|
||||
在 Windows 上通过 Bun 安装 OpenCode 的支持目前正在开发中。
|
||||
|
||||
您还可以从 [Releases](https://github.com/anomalyco/opencode/releases) 获取二进制文件。
|
||||
你也可以从 [Releases](https://github.com/anomalyco/opencode/releases) 页面直接下载二进制文件。
|
||||
|
||||
---
|
||||
|
||||
## 配置
|
||||
|
||||
借助 opencode,你可以通过配置 API 使用任意 LLM 提供商。
|
||||
通过 OpenCode,你可以配置 API 密钥来使用任意 LLM 提供商。
|
||||
|
||||
如果你刚开始使用 LLM 提供商,我们建议使用 [OpenCode Zen](/docs/zen)。
|
||||
这是经过 opencode 团队测试和验证的精选模型列表。
|
||||
如果你刚开始接触 LLM 提供商,我们推荐使用 [OpenCode Zen](/docs/zen)。这是一组经过 OpenCode 团队测试和验证的精选模型。
|
||||
|
||||
1. 在 TUI 中运行 `/connect` 命令,选择 opencode,然后前往 [opencode.ai/auth](https://opencode.ai/auth)。
|
||||
|
||||
@@ -143,9 +142,9 @@ curl -fsSL https://opencode.ai/install | bash
|
||||
/connect
|
||||
```
|
||||
|
||||
2. 登录,添加您的账单信息,然后复制您的详细 API 密钥。
|
||||
2. 登录并添加账单信息,然后复制你的 API 密钥。
|
||||
|
||||
3. 粘贴您的 API 密钥。
|
||||
3. 粘贴你的 API 密钥。
|
||||
|
||||
```txt
|
||||
┌ API key
|
||||
@@ -154,82 +153,79 @@ curl -fsSL https://opencode.ai/install | bash
|
||||
└ enter
|
||||
```
|
||||
|
||||
或者,你也可以选择其他提供商之一。[了解更多](/docs/providers#directory)。
|
||||
你也可以选择其他提供商。[了解更多](/docs/providers#directory)。
|
||||
|
||||
---
|
||||
|
||||
## 初始化
|
||||
|
||||
现在您已经配置了提供商,您可以导航到一个项目
|
||||
你想继续工作。
|
||||
配置好提供商后,导航到你想要处理的项目目录。
|
||||
|
||||
```bash
|
||||
cd /path/to/project
|
||||
```
|
||||
|
||||
并运行 opencode。
|
||||
然后运行 OpenCode。
|
||||
|
||||
```bash
|
||||
opencode
|
||||
```
|
||||
|
||||
接下来,通过运行以下命令来初始化项目的 opencode。
|
||||
接下来,运行以下命令为项目初始化 OpenCode。
|
||||
|
||||
```bash frame="none"
|
||||
/init
|
||||
```
|
||||
|
||||
这涉及 opencode 分析您的项目并在以下位置创建 `AGENTS.md` 文件
|
||||
项目根。
|
||||
OpenCode 会分析你的项目并在项目根目录创建一个 `AGENTS.md` 文件。
|
||||
|
||||
:::tip
|
||||
您应该将项目的 `AGENTS.md` 文件提交到 Git。
|
||||
你应该将项目的 `AGENTS.md` 文件提交到 Git。
|
||||
:::
|
||||
|
||||
这有助于 opencode 理解项目结构和使用的编码模式。
|
||||
这有助于 OpenCode 理解项目结构和编码规范。
|
||||
|
||||
---
|
||||
|
||||
## 用法
|
||||
## 使用
|
||||
|
||||
您现在已准备好使用 opencode 来处理您的项目。请轻松询问任何事物!
|
||||
现在你已经准备好使用 OpenCode 来处理项目了,尽管提问吧!
|
||||
|
||||
如果您不熟悉使用 AI 编码代理,以下是一些可能会有所帮助的示例。
|
||||
如果你是第一次使用 AI 编码代理,以下示例可能会对你有所帮助。
|
||||
|
||||
---
|
||||
|
||||
### 提问
|
||||
|
||||
您可以要求 opencode 向您解释代码库。
|
||||
你可以让 OpenCode 为你讲解代码库。
|
||||
|
||||
:::tip
|
||||
使用 `@` 键模糊搜索工程中的文件。
|
||||
使用 `@` 键可以模糊搜索项目中的文件。
|
||||
:::
|
||||
|
||||
```txt frame="none" "@packages/functions/src/api/index.ts"
|
||||
How is authentication handled in @packages/functions/src/api/index.ts
|
||||
```
|
||||
|
||||
如果您没有处理代码库的一部分,这会很有帮助。
|
||||
当你遇到不熟悉的代码时,这个功能非常有用。
|
||||
|
||||
---
|
||||
|
||||
### 添加功能
|
||||
|
||||
您可以要求 opencode 向您的项目添加新功能。但是我们首先建议要求它制定一个计划。
|
||||
你可以让 OpenCode 为项目添加新功能。不过我们建议先让它制定一个计划。
|
||||
|
||||
1. **创建计划**
|
||||
1. **制定计划**
|
||||
|
||||
opencode 有一个 _计划模式_,该模式禁止其进行更改和
|
||||
相反,建议 _如何_ 实现该功能。
|
||||
OpenCode 有一个*计划模式*,该模式下它不会进行任何修改,而是建议*如何*实现该功能。
|
||||
|
||||
使用 **Tab** 键切换到它。您会在右下角有一个指示符。
|
||||
使用 **Tab** 键切换到计划模式。你会在右下角看到模式指示器。
|
||||
|
||||
```bash frame="none" title="Switch to Plan mode"
|
||||
<TAB>
|
||||
```
|
||||
|
||||
现在让我们描述一下我们想要它做什么。
|
||||
接下来描述你希望它做什么。
|
||||
|
||||
```txt frame="none"
|
||||
When a user deletes a note, we'd like to flag it as deleted in the database.
|
||||
@@ -237,17 +233,15 @@ How is authentication handled in @packages/functions/src/api/index.ts
|
||||
From this screen, the user can undelete a note or permanently delete it.
|
||||
```
|
||||
|
||||
您需要为 opencode 提供足够的详细信息才能了解您想要的内容。它有帮助
|
||||
就像与团队中的初级开发人员交谈一样与它交谈。
|
||||
你需要提供足够的细节,让 OpenCode 理解你的需求。可以把它当作团队中的一名初级开发者来沟通。
|
||||
|
||||
:::tip
|
||||
为 opencode 提供大量上下文和示例,以帮助其理解您的内容
|
||||
想。
|
||||
为 OpenCode 提供充足的上下文和示例,帮助它理解你的需求。
|
||||
:::
|
||||
|
||||
2. **迭代计划**
|
||||
|
||||
一旦它为您提供了计划,您就可以提供反馈或添加更多详细信息。
|
||||
当它给出计划后,你可以提供反馈或补充更多细节。
|
||||
|
||||
```txt frame="none"
|
||||
We'd like to design this new screen using a design I've used before.
|
||||
@@ -255,22 +249,20 @@ How is authentication handled in @packages/functions/src/api/index.ts
|
||||
```
|
||||
|
||||
:::tip
|
||||
将图像拖放到终端中以将其添加到提示中。
|
||||
将图片拖放到终端中即可将其添加到提示词中。
|
||||
:::
|
||||
|
||||
opencode 可以扫描您提供的任何图像并将其添加到提示中。您可以
|
||||
通过将图像拖放到终端中来完成此操作。
|
||||
OpenCode 可以扫描你提供的图片并将其添加到提示词中。只需将图片拖放到终端窗口即可。
|
||||
|
||||
3. **构建功能**
|
||||
|
||||
一旦您对计划感到满意,请切换回 _构建模式_
|
||||
再次按 **Tab** 键。
|
||||
当你对计划满意后,再次按 **Tab** 键切换回*构建模式*。
|
||||
|
||||
```bash frame="none"
|
||||
<TAB>
|
||||
```
|
||||
|
||||
并要求它做出改变。
|
||||
然后让它开始实施。
|
||||
|
||||
```bash frame="none"
|
||||
Sounds good! Go ahead and make the changes.
|
||||
@@ -278,10 +270,9 @@ How is authentication handled in @packages/functions/src/api/index.ts
|
||||
|
||||
---
|
||||
|
||||
### 进行更改
|
||||
### 直接修改
|
||||
|
||||
对于更直接的更改,您可以要求 opencode 直接构建它
|
||||
无需先审查计划。
|
||||
对于比较简单的修改,你可以直接让 OpenCode 实施,无需先审查计划。
|
||||
|
||||
```txt frame="none" "@packages/functions/src/settings.ts" "@packages/functions/src/notes.ts"
|
||||
We need to add authentication to the /settings route. Take a look at how this is
|
||||
@@ -289,38 +280,37 @@ handled in the /notes route in @packages/functions/src/notes.ts and implement
|
||||
the same logic in @packages/functions/src/settings.ts
|
||||
```
|
||||
|
||||
您需要确保提供大量详细信息,以便 opencode 做出正确的决定变化。
|
||||
请确保提供足够的细节,以便 OpenCode 做出正确的修改。
|
||||
|
||||
---
|
||||
|
||||
### 撤消更改
|
||||
### 撤销修改
|
||||
|
||||
假设您要求 opencode 进行一些更改。
|
||||
假设你让 OpenCode 做了一些修改。
|
||||
|
||||
```txt frame="none" "@packages/functions/src/api/index.ts"
|
||||
Can you refactor the function in @packages/functions/src/api/index.ts?
|
||||
```
|
||||
|
||||
但你意识到这不是你想要的。您 **可以撤消** 更改
|
||||
使用 `/undo` 命令。
|
||||
但你发现结果不是你想要的。你**可以使用** `/undo` 命令来撤销修改。
|
||||
|
||||
```bash frame="none"
|
||||
/undo
|
||||
```
|
||||
|
||||
opencode 现在将恢复您所做的更改并再次显示您的原始消息。
|
||||
OpenCode 会还原所做的修改,并重新显示你之前的消息。
|
||||
|
||||
```txt frame="none" "@packages/functions/src/api/index.ts"
|
||||
Can you refactor the function in @packages/functions/src/api/index.ts?
|
||||
```
|
||||
|
||||
您可以从这里调整提示并要求 opencode 重试。
|
||||
你可以调整提示词,让 OpenCode 重新尝试。
|
||||
|
||||
:::tip
|
||||
您可以多次运行 `/undo` 以撤销多次更改。
|
||||
你可以多次运行 `/undo` 来撤销多次修改。
|
||||
:::
|
||||
|
||||
或者您 **可以使用 `/redo` 命令重做** 更改。
|
||||
你也**可以使用** `/redo` 命令来重做修改。
|
||||
|
||||
```bash frame="none"
|
||||
/redo
|
||||
@@ -330,24 +320,24 @@ Can you refactor the function in @packages/functions/src/api/index.ts?
|
||||
|
||||
## 分享
|
||||
|
||||
您与 opencode 的对话可以 [与您的团队分享](/docs/share)。
|
||||
你与 OpenCode 的对话可以[与团队分享](/docs/share)。
|
||||
|
||||
```bash frame="none"
|
||||
/share
|
||||
```
|
||||
|
||||
这会创建当前对话的链接并复制到剪贴板。
|
||||
这会生成当前对话的链接并复制到剪贴板。
|
||||
|
||||
:::note
|
||||
默认情况下不共享对话。
|
||||
对话默认不会被分享。
|
||||
:::
|
||||
|
||||
这是带有 opencode 的 [示例对话](https://opencode.ai/s/4XP1fce5)。
|
||||
这是一个与 OpenCode 的[示例对话](https://opencode.ai/s/4XP1fce5)。
|
||||
|
||||
---
|
||||
|
||||
## 定制
|
||||
## 个性化
|
||||
|
||||
就是这样!你现在已经是 opencode 高手了。
|
||||
以上就是全部内容!你现在已经是 OpenCode 的使用高手了。
|
||||
|
||||
要让您成为自己的,我们建议 [选择一个主题](/docs/themes)、[自定义交互绑定](/docs/keybinds)、[配置代码整理程序](/docs/formatters)、[创建自定义命令](/docs/commands) 或使用 [opencode 配置](/docs/config)。
|
||||
要让它更符合你的习惯,我们推荐[选择一个主题](/docs/themes)、[自定义快捷键](/docs/keybinds)、[配置代码格式化工具](/docs/formatters)、[创建自定义命令](/docs/commands),或者探索 [OpenCode 配置](/docs/config)。
|
||||
|
||||
Reference in New Issue
Block a user