From 3fa25ee24dd971babb158c82156efa5f37018632 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=8D=97=E5=B0=8F=E6=A0=91?= Date: Mon, 26 Jan 2026 22:36:43 +0800 Subject: [PATCH 1/2] =?UTF-8?q?=E4=BF=AE=E5=A4=8D=E2=80=9C=E5=91=BD?= =?UTF-8?q?=E4=BB=A4=E5=B5=8C=E5=85=A5shell=E8=BE=93=E5=87=BA=E2=80=9C?= =?UTF-8?q?=E6=B8=B2=E6=9F=93=E9=97=AE=E9=A2=98?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/4-scenarios/office-automation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/4-scenarios/office-automation.md b/docs/4-scenarios/office-automation.md index f3eef1b..5e1b7eb 100644 --- a/docs/4-scenarios/office-automation.md +++ b/docs/4-scenarios/office-automation.md @@ -86,7 +86,7 @@ prerequisite: |-----------|------|------------------| | 自定义命令（Custom Commands） | 把“提示词模板”固化为 `/命令名` | 命令模板来自：Markdown 文件内容（官方：`opencode/packages/web/src/content/docs/commands.mdx:33`～`opencode/packages/web/src/content/docs/commands.mdx:34`；源码：`opencode/packages/opencode/src/config/config.ts:214`～`opencode/packages/opencode/src/config/config.ts:218`） | | 命令参数 | 给命令传参 | `$ARGUMENTS` / `$1` / `$2`…（官方：`opencode/packages/web/src/content/docs/commands.mdx:111`～`opencode/packages/web/src/content/docs/commands.mdx:161`） | -| 命令嵌入 shell 输出 | 把 `!\`cmd\`` 输出注入到 prompt | 语法 `!\`command\``（官方：`opencode/packages/web/src/content/docs/commands.mdx:164`～`opencode/packages/web/src/content/docs/commands.mdx:179`；源码：`opencode/packages/opencode/src/config/markdown.ts:7`～`opencode/packages/opencode/src/config/markdown.ts:15`） | +| 命令嵌入 shell 输出 | 把 ``!`cmd` `` 输出注入到 prompt | 语法 ``!`command` ``（官方：`opencode/packages/web/src/content/docs/commands.mdx:164`～`opencode/packages/web/src/content/docs/commands.mdx:179`；源码：`opencode/packages/opencode/src/config/markdown.ts:7`～`opencode/packages/opencode/src/config/markdown.ts:15`） | | 命令引用文件 | 用 `@path/to/file` 把文件内容注入 | 语法 `@...`（官方：`opencode/packages/web/src/content/docs/commands.mdx:198`～`opencode/packages/web/src/content/docs/commands.mdx:212`；源码：`opencode/packages/opencode/src/config/markdown.ts:6`～`opencode/packages/opencode/src/config/markdown.ts:12`） | | `opencode run` | 非交互运行（便于脚本化/流水线） | CLI 支持 `opencode run [message..]`（官方：`opencode/packages/web/src/content/docs/cli.mdx:311`～`opencode/packages/web/src/content/docs/cli.mdx:350`） | | MCP 服务器 | 引入外部工具（数据库/API/搜索） | MCP 工具会自动可用，但会占用上下文（官方：`opencode/packages/web/src/content/docs/mcp-servers.mdx:8`～`opencode/packages/web/src/content/docs/mcp-servers.mdx:21`） | From 7efa7685ccb1b0c967c772706904cb767d7dd963 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=8D=97=E5=B0=8F=E6=A0=91?= Date: Mon, 26 Jan 2026 23:09:20 +0800 Subject: [PATCH 2/2] =?UTF-8?q?=E4=BF=AE=E5=A4=8D=E2=80=9C=E5=91=BD?= =?UTF-8?q?=E4=BB=A4=E5=B5=8C=E5=85=A5shell=E8=BE=93=E5=87=BA=E2=80=9C?= =?UTF-8?q?=E6=B8=B2=E6=9F=93=E9=97=AE=E9=A2=98-2?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/4-scenarios/office-automation.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/4-scenarios/office-automation.md b/docs/4-scenarios/office-automation.md index 5e1b7eb..c3b6ac5 100644 --- a/docs/4-scenarios/office-automation.md +++ b/docs/4-scenarios/office-automation.md @@ -154,7 +154,7 @@ model: anthropic/claude-opus-4-5-thinking > 解释： > - 命令文件的“正文内容”就是模板（官方：`opencode/packages/web/src/content/docs/commands.mdx:33`～`opencode/packages/web/src/content/docs/commands.mdx:34`）。 -> - `!\`date ...\`` 会把命令输出注入 prompt（官方：`opencode/packages/web/src/content/docs/commands.mdx:164`～`opencode/packages/web/src/content/docs/commands.mdx:179`）。 +> - ``!`date ...` `` 会把命令输出注入 prompt（官方：`opencode/packages/web/src/content/docs/commands.mdx:164`～`opencode/packages/web/src/content/docs/commands.mdx:179`）。 #### 方法二：在 `opencode.json` 里用 JSONC 配置命令 @@ -290,7 +290,7 @@ OpenCode 支持 `{env:VAR}` 与 `{file:path}`（官方：`opencode/packages/web/ |-----|-----|-----| | 自定义命令执行后“像没生效” | 把模板写在 frontmatter 而不是正文 | 命令文件“正文内容”才是模板（官方：`opencode/packages/web/src/content/docs/commands.mdx:33`～`opencode/packages/web/src/content/docs/commands.mdx:34`） | | 自定义命令与内置命令同名 | 会覆盖内置命令 | 避免与 `/init`、`/share` 等重名（官方：`opencode/packages/web/src/content/docs/commands.mdx:319`～`opencode/packages/web/src/content/docs/commands.mdx:323`） | -| 命令里 `!\`cmd\`` 输出不符合预期 | 命令在项目根目录执行 | 把路径写成相对项目根，或在模板里明确目录（官方：`opencode/packages/web/src/content/docs/commands.mdx:194`～`opencode/packages/web/src/content/docs/commands.mdx:195`） | +| 命令里 ``!`cmd` `` 输出不符合预期 | 命令在项目根目录执行 | 把路径写成相对项目根，或在模板里明确目录（官方：`opencode/packages/web/src/content/docs/commands.mdx:194`～`opencode/packages/web/src/content/docs/commands.mdx:195`） | | provider 的 `apiKey` 不生效 | 写成了 `provider..apiKey` | 按 Schema 放到 `provider..options.apiKey`（源码：`opencode/packages/opencode/src/config/config.ts:740`～`opencode/packages/opencode/src/config/config.ts:763`） | --- @@ -301,7 +301,7 @@ OpenCode 支持 `{env:VAR}` 与 `{file:path}`（官方：`opencode/packages/web/ |---|---|---| | 命令模板来源 | Markdown 正文为 template | `opencode/packages/web/src/content/docs/commands.mdx:33`～`opencode/packages/web/src/content/docs/commands.mdx:34` | | 命令参数占位符 | 支持 `$ARGUMENTS` 与 `$1...` | `opencode/packages/web/src/content/docs/commands.mdx:111`～`opencode/packages/web/src/content/docs/commands.mdx:161` | -| 命令嵌入 shell | 支持 `!\`command\`` | `opencode/packages/web/src/content/docs/commands.mdx:164`～`opencode/packages/web/src/content/docs/commands.mdx:179` | +| 命令嵌入 shell | 支持 ``!`command` `` | `opencode/packages/web/src/content/docs/commands.mdx:164`～`opencode/packages/web/src/content/docs/commands.mdx:179` | | CLI 自动化 | 支持 `opencode run` | `opencode/packages/web/src/content/docs/cli.mdx:311`～`opencode/packages/web/src/content/docs/cli.mdx:350` | | MCP 能力 | MCP 工具会自动可用，但会增加上下文 | `opencode/packages/web/src/content/docs/mcp-servers.mdx:8`～`opencode/packages/web/src/content/docs/mcp-servers.mdx:21` |