render

name	render
description	输出技能工具。Agent 调用对应子命令生成 aka_yhy 富媒体卡片，覆盖 HTML 渲染、图片、附件、diff、预览五种类型。

概述

render 是输出技能工具，提供 5 个子命令，每个对应一种富媒体卡片类型。Agent 调用后，工具执行实际操作并输出格式化的 aka_yhy 代码块，Agent 直接将输出包含在回复中即可。

输出规则

所有 render 子命令输出的 aka_yhy 代码块都必须遵守以下规则：

• 代码块的结束 fence ``` 必须单独占一行，后面不能紧跟任何正文。
• 如果还要继续输出普通文本，例如“已合并到 task 分支，无冲突。”，必须在结束 fence 之后另起一行再写。
• 否则前端 block parser 不会把它识别成富媒体卡片，而会退化成普通文本显示。

正确示例：

这里是正文说明。

```aka_yhy
type: html-render
<div style="padding:20px">Hello</div>
```

这里是代码块之后的普通文本。

错误示例：

```aka_yhy
type: html-render
<div style="padding:20px">Hello</div>
```这里继续写普通文本

命令

html-render

输出 HTML 渲染卡片。通过 stdin 管道传入内容。

# 短内容
echo '<div style="padding:20px">Hello</div>' | ./render html-render

# 长内容用 heredoc
cat <<'EOF' | ./render html-render
<h1>Title</h1>
<p>Body text here</p>
EOF

输出示例：

```aka_yhy
type: html-render
<div style="padding:20px">Hello</div>

### `image <path>`

验证图片存在后输出图片卡片。路径相对于 workspace 根目录。

```bash
./render image chart.png

attachment <path>

验证文件存在后输出附件下载卡片。路径相对于 workspace 根目录。

./render attachment report.pdf

diff

执行 git diff HEAD，输出工作区变更卡片。前端收到此卡片后会调 API 获取 diff 内容。

./render diff

无变更时不输出卡片。

preview [-port N]

启动本地 HTTP 预览服务（serve 工作区目录），输出预览卡片。不指定端口则自动分配。重复调用时复用已有服务。

./render preview           # 自动分配端口
./render preview -port 8080

输出示例：

```aka_yhy
type: preview
url: http://localhost:3928/index.html