Merge pull request #81 from flashcatcloud/lm_main

1. slack app default template 2. add template function

Author: alick-liming

flashduty/en/1. On-call/4. Configure On-call/4.7 Templates.md

@@ -247,7 +247,36 @@ CloseTime | int64 | No | Close time, EndTime is alert recovery time, CloseTime i
     {{jsonGet .Labels.rule_note "#(userId==7777)#.instanceId" }}
 
     ```
-10. **如何使用逻辑与、或等条件进行内容显示判断？**
+
+10. **How to Retrieve the Image URL via the Src Attribute of [Image](#Image)**
+    - The imageSrcToURL function can be implemented, accepting parameters: $root and Src
+    - If Src is an image_key from the Image Upload API, it should be converted into a short-term accessible URL
+    - If Src is an accessible http/https address, the address should be returned directly
+    - Dingtalk/Slack Apps employ this method to render images
+    ```go
+    {{ $root := . }}
+    {{ range $i, $v := .Images }}
+    {{ $imageURL := imageSrcToURL $root $v.Src }}
+    {{ if $imageURL }}![]({{$imageURL}}){{ end }}{{end}}
+    ```
+
+11. **How to Convert and Upload Images to a Third-Party Notification Platform**
+    - The transferImage function can be implemented, accepting parameters: $root and Src
+    - Src can be an image_key from the Image Upload API or an accessible http/https image URL
+    - Image size must not exceed 10 MB
+    - Supported image formats include JPG, JPEG, PNG, WEBP, GIF, BMP, ICO, TIFF, HEIC
+    - Requires enabling the application permission to access and upload image or file resources
+    - Lark/Feishu Apps employ this method to render images
+
+    ```go
+    {{ $root := . }}
+    {{ range $i, $v := .Images }}
+      {{ $transferURL := transferImage $root $v.Src }}
+      {{ if $transferURL }}![]({{$transferURL}}){{ end }}
+    {{ end }}
+    ```
+
+12. **How to use logical AND, OR, and other conditions for conditional rendering/content display judgment?**
 
     ```
     # Supported functions
@@ -280,7 +309,7 @@ CloseTime | int64 | No | Close time, EndTime is alert recovery time, CloseTime i
 
     ```
 
-11. **How do I find more functions and their usage examples?**
+13. **How do I find more functions and their usage examples?**
    - Function list: https://github.com/flashcatcloud/sprig/blob/master/functions.go#L97
    - Usage examples: Check corresponding _test.go files, e.g., date function test cases at https://github.com/flashcatcloud/sprig/blob/master/date_test.go
 
@@ -430,13 +459,22 @@ As shown below:
 
 ## Slack App
 ---
+
 You need to configure `Integration Center-Instant Message-Slack` integration first to send message cards. If custom content is not set, the system default template will be used, rendering only common label information:
 
 ```go
-{{if .Description}}*description* :{{toHtml .Labels.body_text .Description}}{{end}}
-{{if .Labels.resource}}*resource* : {{toHtml (joinAlertLabels . "resource" ", ")}}{{end}}
+{{if .Labels.body_text}}{{.Labels.body_text}}{{else if .Description}}{{.Description}}{{end}}
+{{if .Labels.resource}}*resource* : {{(joinAlertLabels . "resource" ", ")}}{{end}}
 {{range $k, $v := .Labels}}
-{{if not (in $k "resource" "body_text")}}*{{$k}}* : {{toHtml $v}}{{end}}{{end}}
+{{if not (in $k "resource" "body_text" "body_text_with_table")}}*{{$k}}* : {{$v}}{{end}}{{end}}
+{{ $root := . }}
+{{ range $i, $v := .Images }}
+ {{ $imageURL := imageSrcToURL $root $v.Src }}
+ {{ if $imageURL }}
+  ---
+  ![{{$v.Alt}}]({{$imageURL}})
+ {{ end }}
+{{ end }}
 ```
 
 As shown below:
@@ -448,6 +486,7 @@ If you want to display only key label information, you can refer to the code seg
 - We've listed some common labels, you can add or remove as needed
 - Messages can be around 15000 characters long, content beyond this will be truncated
 - In Slack app, the system will automatically remove empty rendered lines (due to non-existent labels), so you can configure freely
+- To display images, use three consecutive hyphens `---` to separate it from other content. The image syntax must begin with `![` format, as demonstrated in the ​​FAQ​​ section
 
 ```go
 {{if (index .Labels "resource")}}*resource*：{{toHtml (joinAlertLabels . "resource" ", ")}}{{end}}

flashduty/zh/1. On-call/3. 配置管理/4.7 配置通知模板.md

@@ -247,7 +247,35 @@ CloseTime | int64 | 否 | 关闭时间，EndTime 为告警恢复时间，CloseTi
     {{jsonGet .Labels.rule_note "#(userId==7777)#.instanceId" }}
 
     ```
-10. **如何使用逻辑与、或等条件进行内容显示判断？**
+
+10. **如何通过图片[Image](#Image)的 Src 属性获取对应的图片 URL**
+    - imageSrcToURL 可以实现，入参： $root 和 Src
+    - 若 Src 是 [图片上传](https://developer.flashcat.cloud/api-344943718)接口的 image_key, 则 转换成短时间内可访问的地址
+    - 若 Src 是 http/https 可访问地址，则直接返回该地址
+    - 钉钉/Slack App 使用本函数来展示图片
+    ```
+    {{ $root := . }}
+    {{ range $i, $v := .Images }}
+    {{ $imageURL := imageSrcToURL $root $v.Src }}
+    {{ if $imageURL }}![]({{$imageURL}}){{ end }}{{ end }}
+    ```
+
+11. **如何将图片转换并上传到第三方通知平台**
+    - transferImage 可以实现，入参： $root 和 Src
+    - Src 可以是 [图片上传](https://developer.flashcat.cloud/api-344943718) 接口的 image_key 或者 http/https 可访问图片地址
+    - 图片大小不能超过 10 MB
+    - 支持上传 JPG、JPEG、PNG、WEBP、GIF、BMP、ICO、TIFF、HEIC 格式的图片
+    - 需要开启 应用 获取与上传图片或文件资源  权限
+    - 飞书/Lark App 使用本函数来展示图片
+    ```
+    {{ $root := . }}
+    {{ range $i, $v := .Images }}
+      {{ $transferURL := transferImage $root $v.Src }}
+      {{ if $transferURL }}![]({{$transferURL}}){{ end }}
+    {{ end }}
+    ```
+
+12. **如何使用逻辑与、或等条件进行内容显示判断？**
 
     ```
     # 支持的函数
@@ -280,8 +308,7 @@ CloseTime | int64 | 否 | 关闭时间，EndTime 为告警恢复时间，CloseTi
 
     ```
 
-
-11. **如何查阅更多的函数及其使用示例？**
+13. **如何查阅更多的函数及其使用示例？**
    - 函数列表：https://github.com/flashcatcloud/sprig/blob/master/functions.go#L97
    - 使用示例：查看对应的\_test.go 文件，比如 date 函数测试用例见 https://github.com/flashcatcloud/sprig/blob/master/date_test.go
 
@@ -432,16 +459,24 @@ CloseTime | int64 | 否 | 关闭时间，EndTime 为告警恢复时间，CloseTi
 
 ## Slack 应用
 ---
+
 您需要预先配置 `集成中心-即时消息- Slack` 集成，才能发送消息卡片。如果不设置自定义内容，将采用系统默认模板，仅渲染常见标签信息：
 
 ```go
-{{if .Description}}*description* :{{toHtml .Labels.body_text .Description}}{{end}}
-{{if .Labels.resource}}*resource* : {{toHtml (joinAlertLabels . "resource" ", ")}}{{end}}
+{{if .Labels.body_text}}{{.Labels.body_text}}{{else if .Description}}{{.Description}}{{end}}
+{{if .Labels.resource}}*resource* : {{(joinAlertLabels . "resource" ", ")}}{{end}}
 {{range $k, $v := .Labels}}
-{{if not (in $k "resource" "body_text")}}*{{$k}}* : {{toHtml $v}}{{end}}{{end}}
+{{if not (in $k "resource" "body_text" "body_text_with_table")}}*{{$k}}* : {{$v}}{{end}}{{end}}
+{{ $root := . }}
+{{ range $i, $v := .Images }}
+ {{ $imageURL := imageSrcToURL $root $v.Src }}
+ {{ if $imageURL }}
+  ---
+  ![{{$v.Alt}}]({{$imageURL}})
+ {{ end }}
+{{ end }}
 ```
 
-
 如下图所示：
 
 <img src="https://download.flashcat.cloud/flashduty/integration/slack/slack_app_message.png" alt="drawing" style="display: block; margin: 0 auto;" width="600"/>
@@ -451,6 +486,7 @@ CloseTime | int64 | 否 | 关闭时间，EndTime 为告警恢复时间，CloseTi
 - 我们列出了一些常见标签，您可自行删减；
 - 消息可以发送长度为15000左右字符，超出后截断发送；
 - 在 Slack 应用中，系统会自动帮您删除（因标签不存在导致的）渲染空行，您可放心配置
+- 要展示图片，请用 `---` 把图片和其他内容分割开来， 开头是 `![` 格式， 参考 常见问题 部分
 
 ```go
 {{if (index .Labels "resource")}}*resource*：{{toHtml (joinAlertLabels . "resource" ", ")}}{{end}}