Skip to content

修复“命令嵌入shell输出“渲染问题 #3

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
nanxiaoshu wants to merge 2 commits into
base: main
Choose a base branch
from
Open

修复“命令嵌入shell输出“渲染问题 #3

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
3fa25ee
修复“命令嵌入shell输出“渲染问题
Jan 26, 2026
7efa768
修复“命令嵌入shell输出“渲染问题-2
Jan 26, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions docs/4-scenarios/office-automation.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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`） |
Expand Down Expand Up @@ -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 配置命令

Expand Down Expand Up @@ -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.<id>.apiKey` | 按 Schema 放到 `provider.<id>.options.apiKey`（源码：`opencode/packages/opencode/src/config/config.ts:740`～`opencode/packages/opencode/src/config/config.ts:763`） |

---
Expand All @@ -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` |

Expand Down