@neurocode-ai/web 1.18.8

package/src/content/docs/zh-cn/models.mdx

@@ -0,0 +1,222 @@
+---
+title: 模型
+description: 配置 LLM 提供商和模型。
+---
+
+OpenCode 使用 [AI SDK](https://ai-sdk.dev/) 和 [Models.dev](https://models.dev) 支持 **75+ LLM 提供商**，并支持运行本地模型。
+
+---
+
+## 提供商
+
+大多数热门提供商已默认预加载。如果你通过 `/connect` 命令添加了提供商的凭据，它们将在你启动 OpenCode 时自动可用。
+
+了解更多关于[提供商](/docs/providers)的信息。
+
+---
+
+## 选择模型
+
+配置好提供商后，你可以通过输入以下命令来选择想要使用的模型：
+
+```bash frame="none"
+/models
+```
+
+---
+
+## 推荐模型
+
+市面上有非常多的模型，每周都有新模型发布。
+
+:::tip
+建议使用我们推荐的模型。
+:::
+
+然而，真正擅长代码生成和工具调用的模型只有少数几个。
+
+以下是与 OpenCode 配合良好的几个模型，排名不分先后（此列表并非详尽无遗，也不一定是最新的）：
+
+- GPT 5.2
+- GPT 5.1 Codex
+- Claude Opus 4.5
+- Claude Sonnet 4.5
+- Minimax M2.1
+- Gemini 3 Pro
+
+---
+
+## 设置默认模型
+
+要将某个模型设为默认模型，可以在 OpenCode 配置中设置 `model` 字段。
+
+```json title="opencode.json" {3}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "model": "lmstudio/google/gemma-3n-e4b"
+}
+```
+
+这里完整的 ID 格式为 `provider_id/model_id`。例如，如果你使用 [OpenCode Zen](/docs/zen)，则 GPT 5.1 Codex 对应的值为 `opencode/gpt-5.1-codex`。
+
+如果你配置了[自定义提供商](/docs/providers#custom)，`provider_id` 是配置中 `provider` 部分的键名，`model_id` 是 `provider.models` 中的键名。
+
+---
+
+## 配置模型
+
+你可以通过配置文件全局配置模型的选项。
+
+```jsonc title="opencode.jsonc" {7-12,19-24}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "provider": {
+    "openai": {
+      "models": {
+        "gpt-5": {
+          "options": {
+            "reasoningEffort": "high",
+            "textVerbosity": "low",
+            "reasoningSummary": "auto",
+            "include": ["reasoning.encrypted_content"],
+          },
+        },
+      },
+    },
+    "anthropic": {
+      "models": {
+        "claude-sonnet-4-5-20250929": {
+          "options": {
+            "thinking": {
+              "type": "enabled",
+              "budgetTokens": 16000,
+            },
+          },
+        },
+      },
+    },
+  },
+}
+```
+
+这里我们为两个内置模型配置了全局设置：通过 `openai` 提供商访问的 `gpt-5`，以及通过 `anthropic` 提供商访问的 `claude-sonnet-4-20250514`。
+内置的提供商和模型名称可以在 [Models.dev](https://models.dev) 上查阅。
+
+你还可以为使用中的任何代理配置这些选项。代理配置会覆盖此处的全局选项。[了解更多](/docs/agents/#additional)。
+
+你也可以定义扩展内置变体的自定义变体。变体允许你为同一个模型配置不同的设置，而无需创建重复的条目：
+
+```jsonc title="opencode.jsonc" {6-21}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "provider": {
+    "opencode": {
+      "models": {
+        "gpt-5": {
+          "variants": {
+            "high": {
+              "reasoningEffort": "high",
+              "textVerbosity": "low",
+              "reasoningSummary": "auto",
+            },
+            "low": {
+              "reasoningEffort": "low",
+              "textVerbosity": "low",
+              "reasoningSummary": "auto",
+            },
+          },
+        },
+      },
+    },
+  },
+}
+```
+
+---
+
+## 变体
+
+许多模型支持具有不同配置的多种变体。OpenCode 为热门提供商内置了默认变体。
+
+### 内置变体
+
+OpenCode 为许多提供商提供了默认变体：
+
+**Anthropic**：
+
+- `high` - 高思考预算（默认）
+- `max` - 最大思考预算
+
+**OpenAI**：
+
+因模型而异，但大致如下：
+
+- `none` - 无推理
+- `minimal` - 极少推理
+- `low` - 低推理
+- `medium` - 中等推理
+- `high` - 高推理
+- `xhigh` - 超高推理
+
+**Google**：
+
+- `low` - 较低推理/Token 预算
+- `high` - 较高推理/Token 预算
+
+:::tip
+此列表并不全面，许多其他提供商也有内置的默认变体。
+:::
+
+### 自定义变体
+
+你可以覆盖现有变体或添加自己的变体：
+
+```jsonc title="opencode.jsonc" {7-18}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "provider": {
+    "openai": {
+      "models": {
+        "gpt-5": {
+          "variants": {
+            "thinking": {
+              "reasoningEffort": "high",
+              "textVerbosity": "low",
+            },
+            "fast": {
+              "disabled": true,
+            },
+          },
+        },
+      },
+    },
+  },
+}
+```
+
+### 切换变体
+
+使用快捷键 `variant_cycle` 可以快速在变体之间切换。[了解更多](/docs/keybinds)。
+
+---
+
+## 加载模型
+
+OpenCode 启动时，会按以下优先顺序加载模型：
+
+1. `--model` 或 `-m` 命令行标志。格式与配置文件中相同：`provider_id/model_id`。
+
+2. OpenCode 配置中的 model 字段。
+
+   ```json title="opencode.json"
+   {
+     "$schema": "https://opencode.ai/config.json",
+     "model": "anthropic/claude-sonnet-4-20250514"
+   }
+   ```
+
+   格式为 `provider/model`。
+
+3. 上次使用的模型。
+
+4. 按内部优先级排列的第一个可用模型。

package/src/content/docs/zh-cn/network.mdx

@@ -0,0 +1,57 @@
+---
+title: 网络
+description: 配置代理和自定义证书。
+---
+
+OpenCode 支持标准代理环境变量和自定义证书，适用于企业网络环境。
+
+---
+
+## 代理
+
+OpenCode 遵循标准代理环境变量。
+
+```bash
+# HTTPS proxy (recommended)
+export HTTPS_PROXY=https://proxy.example.com:8080
+
+# HTTP proxy (if HTTPS not available)
+export HTTP_PROXY=http://proxy.example.com:8080
+
+# Bypass proxy for local server (required)
+export NO_PROXY=localhost,127.0.0.1
+```
+
+:::caution
+TUI 与本地 HTTP 服务器进行通信。你必须为此连接绕过代理，以防止路由循环。
+:::
+
+你可以使用 [CLI 标志](/docs/cli#run)来配置服务器的端口和主机名。
+
+---
+
+### 身份验证
+
+如果你的代理需要基本身份验证，请在 URL 中包含凭据。
+
+```bash
+export HTTPS_PROXY=http://username:password@proxy.example.com:8080
+```
+
+:::caution
+避免将密码硬编码在代码中。请使用环境变量或安全的凭据存储方式。
+:::
+
+对于需要高级身份验证（如 NTLM 或 Kerberos）的代理，建议使用支持相应身份验证方式的 LLM 网关。
+
+---
+
+## 自定义证书
+
+如果你的企业使用自定义 CA 进行 HTTPS 连接，请配置 OpenCode 以信任这些证书。
+
+```bash
+export NODE_EXTRA_CA_CERTS=/path/to/ca-cert.pem
+```
+
+此配置同时适用于代理连接和直接 API 访问。

package/src/content/docs/zh-cn/permissions.mdx

@@ -0,0 +1,235 @@
+---
+title: 权限
+description: 控制哪些操作需要审批才能运行。
+---
+
+OpenCode 使用 `permission` 配置来决定某个操作是否应自动运行、提示你审批，还是被阻止。
+
+从 `v1.1.1` 开始，旧版 `tools` 布尔配置已被弃用，并已合并到 `permission` 中。旧版 `tools` 配置仍然支持，以保持向后兼容。
+
+---
+
+## 操作
+
+每条权限规则解析为以下之一：
+
+- `"allow"` — 无需审批直接运行
+- `"ask"` — 提示审批
+- `"deny"` — 阻止该操作
+
+---
+
+## 配置
+
+你可以全局设置权限（使用 `*`），并覆盖特定工具的权限。
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "*": "ask",
+    "bash": "allow",
+    "edit": "deny"
+  }
+}
+```
+
+你还可以一次性设置所有权限：
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": "allow"
+}
+```
+
+---
+
+## 细粒度规则（对象语法）
+
+对于大多数权限，你可以使用对象来根据工具输入应用不同的操作。
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "bash": {
+      "*": "ask",
+      "git *": "allow",
+      "npm *": "allow",
+      "rm *": "deny",
+      "grep *": "allow"
+    },
+    "edit": {
+      "*": "deny",
+      "packages/web/src/content/docs/*.mdx": "allow"
+    }
+  }
+}
+```
+
+规则通过模式匹配进行评估，**最后匹配的规则优先**。常见做法是将通配的 `"*"` 规则放在最前面，更具体的规则放在后面。
+
+### 通配符
+
+权限模式使用简单的通配符匹配：
+
+- `*` 匹配零个或多个任意字符
+- `?` 精确匹配一个字符
+- 所有其他字符按字面值匹配
+
+### 主目录展开
+
+你可以在模式开头使用 `~` 或 `$HOME` 来引用你的主目录。这对于 [`external_directory`](#外部目录) 规则特别有用。
+
+- `~/projects/*` -> `/Users/username/projects/*`
+- `$HOME/projects/*` -> `/Users/username/projects/*`
+- `~` -> `/Users/username`
+
+### 外部目录
+
+使用 `external_directory` 允许工具调用访问 OpenCode 启动时工作目录之外的路径。这适用于任何接受路径作为输入的工具（例如 `read`、`edit`、`glob`、`grep` 以及许多 `bash` 命令）。
+
+主目录展开（如 `~/...`）仅影响模式的书写方式。它不会将外部路径纳入当前工作空间，因此工作目录之外的路径仍然必须通过 `external_directory` 来允许。
+
+例如，以下配置允许访问 `~/projects/personal/` 下的所有内容：
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "external_directory": {
+      "~/projects/personal/**": "allow"
+    }
+  }
+}
+```
+
+此处允许的任何目录都会继承与当前工作空间相同的默认值。由于 [`read` 默认为 `allow`](#默认值)，`external_directory` 下的条目也允许读取，除非另行覆盖。当需要在这些路径中限制某个工具时，请添加显式规则，例如在保留读取的同时阻止编辑：
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "external_directory": {
+      "~/projects/personal/**": "allow"
+    },
+    "edit": {
+      "~/projects/personal/**": "deny"
+    }
+  }
+}
+```
+
+请将列表限定在受信任的路径上，并根据需要为其他工具（例如 `bash`）叠加额外的允许或拒绝规则。
+
+---
+
+## 可用权限
+
+OpenCode 的权限以工具名称为键，外加几个安全防护项：
+
+- `read` — 读取文件（匹配文件路径）
+- `edit` — 所有文件修改（涵盖 `edit`、`write`、`patch`）
+- `glob` — 文件通配（匹配通配模式）
+- `grep` — 内容搜索（匹配正则表达式模式）
+- `bash` — 运行 shell 命令（匹配解析后的命令，如 `git status --porcelain`）
+- `task` — 启动子代理（匹配子代理类型）
+- `skill` — 加载技能（匹配技能名称）
+- `lsp` — 运行 LSP 查询（当前不支持细粒度配置）
+- `webfetch` — 获取 URL（匹配 URL）
+- `websearch` — 网页搜索（匹配查询内容）
+- `external_directory` — 当工具访问项目工作目录之外的路径时触发
+- `doom_loop` — 当同一工具调用以相同输入重复 3 次时触发
+
+---
+
+## 默认值
+
+如果你未指定任何配置，OpenCode 将使用宽松的默认值：
+
+- 大多数权限默认为 `"allow"`。
+- `doom_loop` 和 `external_directory` 默认为 `"ask"`。
+- `read` 为 `"allow"`，但 `.env` 文件默认被拒绝：
+
+```json title="opencode.json"
+{
+  "permission": {
+    "read": {
+      "*": "allow",
+      "*.env": "deny",
+      "*.env.*": "deny",
+      "*.env.example": "allow"
+    }
+  }
+}
+```
+
+---
+
+## "Ask"的作用
+
+当 OpenCode 提示审批时，界面提供三种选择：
+
+- `once` — 仅批准本次请求
+- `always` — 批准与建议模式匹配的后续请求（在当前 OpenCode 会话的剩余时间内有效）
+- `reject` — 拒绝请求
+
+`always` 所批准的模式集合由工具提供（例如，bash 审批通常会将安全的命令前缀如 `git status*` 加入白名单）。
+
+---
+
+## 代理
+
+你可以为每个代理单独覆盖权限。代理权限会与全局配置合并，且代理规则优先。[了解更多](/docs/agents#permissions)关于代理权限的内容。
+
+:::note
+有关更详细的模式匹配示例，请参阅上方的[细粒度规则（对象语法）](#细粒度规则对象语法)部分。
+:::
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "bash": {
+      "*": "ask",
+      "git *": "allow",
+      "git commit *": "deny",
+      "git push *": "deny",
+      "grep *": "allow"
+    }
+  },
+  "agent": {
+    "build": {
+      "permission": {
+        "bash": {
+          "*": "ask",
+          "git *": "allow",
+          "git commit *": "ask",
+          "git push *": "deny",
+          "grep *": "allow"
+        }
+      }
+    }
+  }
+}
+```
+
+你还可以在 Markdown 中配置代理权限：
+
+```markdown title="~/.config/opencode/agents/review.md"
+---
+description: Code review without edits
+mode: subagent
+permission:
+  edit: deny
+  bash: ask
+  webfetch: deny
+---
+
+Only analyze code and suggest changes.
+```
+
+:::tip
+对带参数的命令使用模式匹配。`"grep *"` 允许执行 `grep pattern file.txt`，而单独的 `"grep"` 则会阻止它。像 `git status` 这样的命令适用于默认行为，但在传递参数时需要显式权限（如 `"git status *"`）。
+:::