Skip to content

Commit 3da198a

Browse files
committed
update template doc
1 parent 8b82d58 commit 3da198a

File tree

1 file changed

+33
-7
lines changed

1 file changed

+33
-7
lines changed

zh/on-call/configuration/templates.mdx

Lines changed: 33 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -264,8 +264,22 @@ keywords: ["通知模板", "模板配置", "消息格式", "模板变量", "通
264264
```
265265
</Accordion>
266266

267-
<Accordion title="如何获取图片 URL?">
268-
**imageSrcToURL**:将 image_key 或 URL 转换为可访问地址(钉钉/Slack App 使用)
267+
<Accordion title="如何在发送应用消息时携带图片?">
268+
### 通过 imageSrcToURL 获取图片 URL
269+
270+
**imageSrcToURL** 函数用于将图片的 `Src` 属性转换为可访问的 URL。
271+
272+
**参数说明:**
273+
- `$root`:根上下文对象
274+
- `Src`:图片源,可以是 `image_key` 或 http/https URL
275+
276+
**处理逻辑:**
277+
- 如果 `Src` 是从图片上传界面获取的 `image_key`,会转换为可访问的 URL(短期有效)
278+
- 如果 `Src` 是 http/https 地址,直接返回该地址
279+
280+
**适用平台:** 钉钉应用、Slack 应用
281+
282+
**使用示例:**
269283

270284
```go
271285
{{ $root := . }}
@@ -275,7 +289,23 @@ keywords: ["通知模板", "模板配置", "消息格式", "模板变量", "通
275289
{{ end }}
276290
```
277291

278-
**transferImage**:上传图片到第三方平台(飞书/Lark App 使用)
292+
### 通过 transferImage 上传图片到第三方平台
293+
294+
**transferImage** 函数用于将图片转换并上传到第三方通知平台。
295+
296+
**参数说明:**
297+
- `$root`:根上下文对象
298+
- `Src`:图片源,可以是 `image_key` 或 http/https URL
299+
300+
**限制条件:**
301+
- 最大图片大小:10 MB
302+
- 支持格式:JPG、JPEG、PNG、WEBP、GIF、BMP、ICO、TIFF、HEIC
303+
304+
**权限要求:** 需要应用具备"获取与上传图片或文件资源"的权限
305+
306+
**适用平台:** 飞书应用(Lark App)
307+
308+
**使用示例:**
279309

280310
```go
281311
{{ $root := . }}
@@ -284,10 +314,6 @@ keywords: ["通知模板", "模板配置", "消息格式", "模板变量", "通
284314
{{ if $transferURL }}![]({{$transferURL}}){{ end }}
285315
{{ end }}
286316
```
287-
288-
<Note>
289-
图片大小不能超过 10 MB,支持 JPG、PNG、WEBP、GIF、BMP 等格式。
290-
</Note>
291317
</Accordion>
292318

293319
<Accordion title="如何使用逻辑运算?">

0 commit comments

Comments
 (0)