@neurocode-ai/web 1.18.8

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

@@ -0,0 +1,194 @@
+---
+title: 快捷键
+description: 自定义您的快捷键。
+---
+
+OpenCode 提供了一系列快捷键，您可以通过 `tui.json` 进行自定义。
+
+```json title="tui.json"
+{
+  "$schema": "https://opencode.ai/tui.json",
+  "keybinds": {
+    "leader": "ctrl+x",
+    "app_exit": "ctrl+c,ctrl+d,<leader>q",
+    "editor_open": "<leader>e",
+    "theme_list": "<leader>t",
+    "sidebar_toggle": "<leader>b",
+    "scrollbar_toggle": "none",
+    "username_toggle": "none",
+    "status_view": "<leader>s",
+    "tool_details": "none",
+    "session_export": "<leader>x",
+    "session_new": "<leader>n",
+    "session_list": "<leader>l",
+    "session_timeline": "<leader>g",
+    "session_fork": "none",
+    "session_rename": "none",
+    "session_share": "none",
+    "session_unshare": "none",
+    "session_interrupt": "escape",
+    "session_compact": "<leader>c",
+    "session_child_first": "<leader>down",
+    "session_child_cycle": "<leader>right",
+    "session_child_cycle_reverse": "<leader>left",
+    "session_parent": "<leader>up",
+    "messages_page_up": "pageup,ctrl+alt+b",
+    "messages_page_down": "pagedown,ctrl+alt+f",
+    "messages_line_up": "ctrl+alt+y",
+    "messages_line_down": "ctrl+alt+e",
+    "messages_half_page_up": "ctrl+alt+u",
+    "messages_half_page_down": "ctrl+alt+d",
+    "messages_first": "ctrl+g,home",
+    "messages_last": "ctrl+alt+g,end",
+    "messages_next": "none",
+    "messages_previous": "none",
+    "messages_copy": "<leader>y",
+    "messages_undo": "<leader>u",
+    "messages_redo": "<leader>r",
+    "messages_last_user": "none",
+    "messages_toggle_conceal": "<leader>h",
+    "model_list": "<leader>m",
+    "model_cycle_recent": "f2",
+    "model_cycle_recent_reverse": "shift+f2",
+    "model_cycle_favorite": "none",
+    "model_cycle_favorite_reverse": "none",
+    "variant_cycle": "ctrl+t",
+    "variant_list": "none",
+    "command_list": "ctrl+p",
+    "agent_list": "<leader>a",
+    "agent_cycle": "tab",
+    "agent_cycle_reverse": "shift+tab",
+    "input_clear": "ctrl+c",
+    "input_paste": "ctrl+v",
+    "input_submit": "return",
+    "input_newline": "shift+return,ctrl+return,alt+return,ctrl+j",
+    "input_move_left": "left,ctrl+b",
+    "input_move_right": "right,ctrl+f",
+    "input_move_up": "up",
+    "input_move_down": "down",
+    "input_select_left": "shift+left",
+    "input_select_right": "shift+right",
+    "input_select_up": "shift+up",
+    "input_select_down": "shift+down",
+    "input_line_home": "ctrl+a",
+    "input_line_end": "ctrl+e",
+    "input_select_line_home": "ctrl+shift+a",
+    "input_select_line_end": "ctrl+shift+e",
+    "input_visual_line_home": "alt+a",
+    "input_visual_line_end": "alt+e",
+    "input_select_visual_line_home": "alt+shift+a",
+    "input_select_visual_line_end": "alt+shift+e",
+    "input_buffer_home": "home",
+    "input_buffer_end": "end",
+    "input_select_buffer_home": "shift+home",
+    "input_select_buffer_end": "shift+end",
+    "input_delete_line": "ctrl+shift+d",
+    "input_delete_to_line_end": "ctrl+k",
+    "input_delete_to_line_start": "ctrl+u",
+    "input_backspace": "backspace,shift+backspace",
+    "input_delete": "ctrl+d,delete,shift+delete",
+    "input_undo": "ctrl+-,super+z",
+    "input_redo": "ctrl+.,super+shift+z",
+    "input_word_forward": "alt+f,alt+right,ctrl+right",
+    "input_word_backward": "alt+b,alt+left,ctrl+left",
+    "input_select_word_forward": "alt+shift+f,alt+shift+right",
+    "input_select_word_backward": "alt+shift+b,alt+shift+left",
+    "input_delete_word_forward": "alt+d,alt+delete,ctrl+delete",
+    "input_delete_word_backward": "ctrl+w,ctrl+backspace,alt+backspace",
+    "history_previous": "up",
+    "history_next": "down",
+    "terminal_suspend": "ctrl+z",
+    "terminal_title_toggle": "none",
+    "tips_toggle": "<leader>h",
+    "display_thinking": "none"
+  }
+}
+```
+
+---
+
+## 前导键
+
+OpenCode 的大多数快捷键使用 `leader`（前导键）。这可以避免与终端中的其他快捷键冲突。
+
+默认情况下，`ctrl+x` 是前导键，大多数操作需要您先按下前导键，然后再按对应的快捷键。例如，要新建一个会话，请先按 `ctrl+x`，然后按 `n`。
+
+您不一定需要使用前导键来设置快捷键，但我们建议您这样做。
+
+---
+
+## 禁用快捷键
+
+您可以通过将键值添加到 `tui.json` 并设置为 "none" 来禁用某个快捷键。
+
+```json title="tui.json"
+{
+  "$schema": "https://opencode.ai/tui.json",
+  "keybinds": {
+    "session_compact": "none"
+  }
+}
+```
+
+---
+
+## 桌面版提示词输入快捷键
+
+OpenCode 桌面应用的提示词输入框支持常见的 Readline/Emacs 风格文本编辑快捷键。这些快捷键为内置功能，目前无法通过 `opencode.json` 进行配置。
+
+| 快捷键   | 操作                              |
+| -------- | --------------------------------- |
+| `ctrl+a` | 移动到当前行的开头                |
+| `ctrl+e` | 移动到当前行的末尾                |
+| `ctrl+b` | 光标向后移动一个字符              |
+| `ctrl+f` | 光标向前移动一个字符              |
+| `alt+b`  | 光标向后移动一个单词              |
+| `alt+f`  | 光标向前移动一个单词              |
+| `ctrl+d` | 删除光标所在位置的字符            |
+| `ctrl+k` | 删除从光标到行尾的内容            |
+| `ctrl+u` | 删除从光标到行首的内容            |
+| `ctrl+w` | 删除前一个单词                    |
+| `alt+d`  | 删除后一个单词                    |
+| `ctrl+t` | 交换光标前后的字符                |
+| `ctrl+g` | 取消弹出窗口 / 中止正在运行的响应 |
+
+---
+
+## Shift+Enter
+
+某些终端默认不会发送带修饰键的 Enter 键。您可能需要配置终端将 `Shift+Enter` 作为转义序列发送。
+
+### Windows Terminal
+
+打开您的 `settings.json` 文件，路径为：
+
+```
+%LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json
+```
+
+将以下内容添加到根级 `actions` 数组中：
+
+```json
+"actions": [
+  {
+    "command": {
+      "action": "sendInput",
+      "input": "\u001b[13;2u"
+    },
+    "id": "User.sendInput.ShiftEnterCustom"
+  }
+]
+```
+
+将以下内容添加到根级 `keybindings` 数组中：
+
+```json
+"keybindings": [
+  {
+    "keys": "shift+enter",
+    "id": "User.sendInput.ShiftEnterCustom"
+  }
+]
+```
+
+保存文件并重启 Windows Terminal，或打开一个新标签页。

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

@@ -0,0 +1,208 @@
+---
+title: LSP 服务器
+description: OpenCode 与你的 LSP 服务器集成。
+---
+
+OpenCode 可以与语言服务器协议（LSP）服务器集成，将诊断信息作为 agent 的反馈。
+
+---
+
+## 内置支持
+
+OpenCode 内置了多种适用于主流语言的 LSP 服务器：
+
+| LSP 服务器         | 扩展名                                                              | 要求                                                  |
+| ------------------ | ------------------------------------------------------------------- | ----------------------------------------------------- |
+| astro              | .astro                                                              | 为 Astro 项目自动安装                                 |
+| bash               | .sh, .bash, .zsh, .ksh                                              | 自动安装 bash-language-server                         |
+| clangd             | .c, .cpp, .cc, .cxx, .c++, .h, .hpp, .hh, .hxx, .h++                | 为 C/C++ 项目自动安装                                 |
+| csharp             | .cs                                                                 | 需要已安装 `.NET SDK`                                 |
+| clojure-lsp        | .clj, .cljs, .cljc, .edn                                            | 需要 `clojure-lsp` 命令可用                           |
+| dart               | .dart                                                               | 需要 `dart` 命令可用                                  |
+| deno               | .ts, .tsx, .js, .jsx, .mjs                                          | 需要 `deno` 命令可用（自动检测 deno.json/deno.jsonc） |
+| elixir-ls          | .ex, .exs                                                           | 需要 `elixir` 命令可用                                |
+| eslint             | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue                  | 项目中需要 `eslint` 依赖                              |
+| fsharp             | .fs, .fsi, .fsx, .fsscript                                          | 需要已安装 `.NET SDK`                                 |
+| gleam              | .gleam                                                              | 需要 `gleam` 命令可用                                 |
+| gopls              | .go                                                                 | 需要 `go` 命令可用                                    |
+| hls                | .hs, .lhs                                                           | 需要 `haskell-language-server-wrapper` 命令可用       |
+| jdtls              | .java                                                               | 需要已安装 `Java SDK (version 21+)`                   |
+| julials            | .jl                                                                 | 需要安装 `julia` and `LanguageServer.jl`              |
+| kotlin-ls          | .kt, .kts                                                           | 为 Kotlin 项目自动安装                                |
+| lua-ls             | .lua                                                                | 为 Lua 项目自动安装                                   |
+| nixd               | .nix                                                                | 需要 `nixd` 命令可用                                  |
+| ocaml-lsp          | .ml, .mli                                                           | 需要 `ocamllsp` 命令可用                              |
+| oxlint             | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue, .astro, .svelte | 项目中需要 `oxlint` 依赖                              |
+| php intelephense   | .php                                                                | 为 PHP 项目自动安装                                   |
+| prisma             | .prisma                                                             | 需要 `prisma` 命令可用                                |
+| pyright            | .py, .pyi                                                           | 需要已安装 `pyright` 依赖                             |
+| ruby-lsp (rubocop) | .rb, .rake, .gemspec, .ru                                           | 需要 `ruby` 和 `gem` 命令可用                         |
+| rust               | .rs                                                                 | 需要 `rust-analyzer` 命令可用                         |
+| sourcekit-lsp      | .swift, .objc, .objcpp                                              | 需要已安装 `swift`（macOS 上为 `xcode`）              |
+| svelte             | .svelte                                                             | 为 Svelte 项目自动安装                                |
+| terraform          | .tf, .tfvars                                                        | 从 GitHub releases 自动安装                           |
+| tinymist           | .typ, .typc                                                         | 从 GitHub releases 自动安装                           |
+| typescript         | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts                        | 项目中需要 `typescript` 依赖                          |
+| vue                | .vue                                                                | 为 Vue 项目自动安装                                   |
+| yaml-ls            | .yaml, .yml                                                         | 自动安装 Red Hat yaml-language-server                 |
+| zls                | .zig, .zon                                                          | 需要 `zig` 命令可用                                   |
+
+LSP 默认关闭。启用后，当检测到上述文件扩展名且满足相应要求时，服务器会启动。
+
+:::note
+你可以将 `OPENCODE_DISABLE_LSP_DOWNLOAD` 环境变量设置为 `true` 来禁用 LSP 服务器的自动下载。
+:::
+
+---
+
+## 工作原理
+
+启用 LSP 且 opencode 打开文件时，它会：
+
+1. 将文件扩展名与所有已启用的 LSP 服务器进行匹配。
+2. 如果对应的 LSP 服务器尚未运行，则自动启动它。
+
+---
+
+## 最佳实践
+
+LSP 可以通过语言服务器诊断帮助 agent 发现并修复问题。这对某些项目很有用，但并不总是带来净收益。
+
+语言服务器可能与项目不同步、占用较多内存、随版本或项目表现不同，并拖慢 agent 工作流。在许多项目中，更好的做法是让 agent 直接运行 lint、typecheck 或其他诊断类 CLI 工具，这样错误会进入 agent 循环，同时避免这些权衡。将这些命令记录在 `AGENTS.md` 或 skills 等指令文件中，让 agent 知道该运行什么。当你的项目能从额外的语言服务器反馈中受益时再启用 LSP。
+
+---
+
+## 配置
+
+你可以通过 opencode 配置文件中的 `lsp` 部分来启用并自定义 LSP 服务器。
+
+要启用所有内置 LSP 服务器，请将 `lsp` 设置为 `true`。
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "lsp": true
+}
+```
+
+使用对象可以在保持内置服务器启用的同时配置覆盖项或自定义服务器。
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "lsp": {}
+}
+```
+
+每个 LSP 服务器支持以下配置项：
+
+| 属性             | 类型     | 描述                              |
+| ---------------- | -------- | --------------------------------- |
+| `disabled`       | boolean  | 设置为 `true` 可禁用该 LSP 服务器 |
+| `command`        | string[] | 启动 LSP 服务器的命令             |
+| `extensions`     | string[] | 该 LSP 服务器需要处理的文件扩展名 |
+| `env`            | object   | 启动服务器时设置的环境变量        |
+| `initialization` | object   | 发送给 LSP 服务器的初始化选项     |
+
+下面来看一些示例。
+
+---
+
+### 环境变量
+
+使用 `env` 属性在启动 LSP 服务器时设置环境变量：
+
+```json title="opencode.json" {5-7}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "lsp": {
+    "rust": {
+      "env": {
+        "RUST_LOG": "debug"
+      }
+    }
+  }
+}
+```
+
+---
+
+### 初始化选项
+
+使用 `initialization` 属性向 LSP 服务器传递初始化选项。这些是在 LSP `initialize` 请求期间发送的服务器特定设置：
+
+```json title="opencode.json" {5-9}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "lsp": {
+    "typescript": {
+      "initialization": {
+        "preferences": {
+          "importModuleSpecifierPreference": "relative"
+        }
+      }
+    }
+  }
+}
+```
+
+:::note
+初始化选项因 LSP 服务器而异。请查阅你所使用的 LSP 服务器的文档以了解可用选项。
+:::
+
+---
+
+### 禁用 LSP 服务器
+
+如果省略 `lsp`，所有 LSP 服务器都会被禁用。如果另一个配置启用了 LSP，可将 `lsp` 设置为 `false` 来禁用所有 LSP 服务器：
+
+```json title="opencode.json" {3}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "lsp": false
+}
+```
+
+要禁用**特定的** LSP 服务器，将 `disabled` 设置为 `true`：
+
+```json title="opencode.json" {5}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "lsp": {
+    "typescript": {
+      "disabled": true
+    }
+  }
+}
+```
+
+---
+
+### 自定义 LSP 服务器
+
+你可以通过指定命令和文件扩展名来添加自定义 LSP 服务器：
+
+```json title="opencode.json" {4-7}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "lsp": {
+    "custom-lsp": {
+      "command": ["custom-lsp-server", "--stdio"],
+      "extensions": [".custom"]
+    }
+  }
+}
+```
+
+---
+
+## 补充信息
+
+### PHP Intelephense
+
+PHP Intelephense 通过许可证密钥提供高级功能。你可以将许可证密钥单独放在以下路径的文本文件中：
+
+- macOS/Linux：`$HOME/intelephense/license.txt`
+- Windows：`%USERPROFILE%/intelephense/license.txt`
+
+该文件应仅包含许可证密钥，不要添加其他任何内容。