feat: Add support for custom message templates with new configuration options and updated documentation to version 2.1.0.

Author: lanxuexing

README.md

@@ -26,6 +26,7 @@ A Sentry extension to post notifications to DingTalk (钉钉) robot.
 > *   **🚦 Level**: error
 > *   **📍 Location**: `app/utils/math.js`
 >
+> 📢 **Trigger**: alert-rule  
 > [👉 View Issue on Sentry](#)
 
 ## ✨ 核心功能
@@ -71,7 +72,7 @@ A Sentry extension to post notifications to DingTalk (钉钉) robot.
 
 ## ⚙️ 配置手册
 
-进入 **Sentry > Project Settings > Legacy Integrations > DingTalk**。
+进入 **Sentry > Project Settings > Legacy Integrations > DingTalk Notify**。
 
 ### 1. Access Token (必填)
 钉钉机器人 Webhook URL 中的 `access_token` 参数。
@@ -102,6 +103,29 @@ A Sentry extension to post notifications to DingTalk (钉钉) robot.
 需要 @ 的群成员手机号。
 *   **格式**: 英文逗号分隔，例如 `13800000000,13900000000`。
 
+### 5. Custom Message / 自定义消息模版 (v2.1.0+)
+支持使用 Markdown 自定义消息格式。勾选 "Enable Custom Message" 后填入由变量组成的模版。
+
+**可用变量**:
+*   `{project}`: 项目名 (e.g. sentry-demo)
+*   `{title}`: 异常标题 (e.g. ValueError)
+*   `{message}`: 异常详情
+*   `{url}`: 报错详情页链接
+*   `{level}`: 报错级别 (error/info)
+*   `{environment}`: 环境 (prod/dev)
+*   `{culprit}`: 异常位置 (code path)
+*   `{display_title}`: 包含关键词前缀的标题 (推荐使用，用于通过关键词验证)
+
+**模版示例**:
+```markdown
+### {display_title}
+**环境**: {environment}
+**位置**: `{culprit}`
+> {message}
+[👉查看详情]({url})
+```
+*(注意：钉钉 Markdown 换行需在行尾加两个空格，或使用列表格式)*
+
 ---
 
 ## ⚠️ 常见问题：为什么收不到自动通知？

README_en.md

@@ -27,6 +27,7 @@ A Sentry extension to post notifications to DingTalk (钉钉) robot.
 > *   **🚦 Level**: error
 > *   **📍 Location**: `app/utils/math.js`
 >
+> 📢 **Trigger**: alert-rule  
 > [👉 View Issue on Sentry](#)
 
 ## ✨ Features
@@ -72,7 +73,7 @@ Quickly install without rebuilding images. **Note: The plugin will disappear if
 
 ## ⚙️ Configuration Guide
 
-Go to **Sentry > Project Settings > Legacy Integrations > DingTalk**.
+Go to **Sentry > Project Settings > Legacy Integrations > DingTalk Notify**.
 
 ### 1. Access Token (Required)
 The access token for your DingTalk robot. You can find this in the Webhook URL: `https://oapi.dingtalk.com/robot/send?access_token=YOUR_TOKEN`.
@@ -105,6 +106,29 @@ If your robot uses "Keyword" security verification.
 Comma-separated list of mobile numbers to @ in the group chat.
 *   **Example**: `13800000000,13900000000`
 
+### 5. Custom Message / Template (v2.1.0+)
+Supports custom Markdown message format. Check "Enable Custom Message" and define your template using variables.
+
+**Available Variables**:
+*   `{project}`: Project Name (e.g. sentry-demo)
+*   `{title}`: Exception Type (e.g. ValueError)
+*   `{message}`: Error Details
+*   `{url}`: Link to Sentry Issue
+*   `{level}`: Error Level (error/info)
+*   `{environment}`: Environment (prod/dev)
+*   `{culprit}`: Code Location (file path)
+*   `{display_title}`: Title with keyword prefix, use this for keyword validation robots.
+
+**Example Template**:
+```markdown
+### {display_title}
+**Env**: {environment}
+**Location**: `{culprit}`
+> {message}
+[👉View Issue]({url})
+```
+*(Note: DingTalk Markdown requires **two spaces** at the end of a line for a line break)*
+
 ---
 
 ## ⚠️ Important: Why am I not receiving notifications?

sentry_dingtalk_notify/__version__.py

@@ -1 +1 @@
-__version__ = '2.0.1'
+__version__ = '2.1.0'

sentry_dingtalk_notify/plugin.py

@@ -44,9 +44,22 @@ class DingTalkOptionsForm(forms.Form):
         help_text='Whether to @ all members in the group.',
         required=False
     )
+    custom_message_enabled = forms.BooleanField(
+        label='Enable Custom Message',
+        help_text='If checked, the "Custom Message Template" below will be used.',
+        required=False
+    )
+    custom_message_template = forms.CharField(
+        label='Custom Message Template',
+        widget=forms.Textarea(attrs={'class': 'span6', 'placeholder': '### {title}\n\n**Project**: {project}\n**Error**: {message}\n[View]({url})'}),
+        help_text='Markdown template. Available variables: {project}, {title}, {display_title}, {message}, {url}, {level}, {environment}, {culprit}, {project_slug}, {project_name}, {org_name}.',
+        required=False
+    )
+
 
 from .__version__ import __version__
-    
+
+
 class DingTalkPlugin(NotificationPlugin):
     author = 'lanxuexing'
     author_url = 'https://github.com/lanxuexing/sentry-dingtalk-notify'
@@ -86,6 +99,8 @@ def notify_users(self, group, event, fail_silently=False, triggering_rules=None,
         custom_keyword = self.get_option('custom_keyword', group.project) or ''
         at_mobiles_str = self.get_option('at_mobiles', group.project) or ''
         is_at_all = self.get_option('is_at_all', group.project) or False
+        custom_message_enabled = self.get_option('custom_message_enabled', group.project) or False
+        custom_message_template = self.get_option('custom_message_template', group.project) or ''
 
         logger.info(f"DingTalk notify_users called for event {event.event_id}")
 
@@ -143,29 +158,51 @@ def notify_users(self, group, event, fail_silently=False, triggering_rules=None,
 
         link = self.get_group_url(group)
 
-        # Markdown Content
-        # Using a list style for better readability
-        text = f"### {evt_title}\n\n"
-        
-        # Key Metadata
-        text += f"- **📦 Project**: {project_slug} ({org_name})\n"
-        text += f"- **🌍 Env**: {environment}\n"
-        text += f"- **🚦 Level**: {level}\n"
-        text += f"- **📍 Location**: `{culprit}`\n"
+        # Determine Markdown Content
+        text = ""
+        used_custom = False
+
+        if custom_message_enabled and custom_message_template:
+            # Prepare context for custom template
+            context = {
+                'project': project_name,        # Human readable name
+                'project_name': project_name,   # Alias
+                'project_slug': project_slug,   # Technical slug
+                'org_name': org_name,
+                'title': evt_title,
+                'display_title': display_title, # Title with keyword prefix 【Keyword】
+                'message': evt_message,
+                'url': link,
+                'level': level,
+                'environment': environment,
+                'culprit': culprit,
+            }
+            try:
+                text = custom_message_template.format(**context)
+                used_custom = True
+                logger.info("DingTalk: Used custom message template.")
+            except Exception as e:
+                logger.error(f"DingTalk: Error formatting custom template: {e}. Falling back to default.")
+                text = "" # Fallback logic below will handle empty text
 
-        # Error Message (Quote block)
-        if evt_message and evt_message != evt_title:
-            text += f"\n> {evt_message}\n\n"
-        else:
-            text += "\n"
-
-        # Trigger Context
-        if triggering_rules:
-            text += f"📢 **Trigger**: {', '.join(triggering_rules)}\n"
+        if not text:
+            # Standard Default Template
+            text = f"### {evt_title}\n\n"
+            text += f"- **📦 Project**: {project_slug} ({org_name})\n"
+            text += f"- **🌍 Env**: {environment}\n"
+            text += f"- **🚦 Level**: {level}\n"
+            text += f"- **📍 Location**: `{culprit}`\n"
+            
+            if evt_message and evt_message != evt_title:
+                text += f"\n> {evt_message}\n\n"
+            else:
+                text += "\n"
+
+            if triggering_rules:
+                text += f"📢 **Trigger**: {', '.join(triggering_rules)}\n"
+                
+            text += f"\n[👉 View Issue on Sentry]({link})\n"
 
-        # Action Link
-        text += f"\n[👉 View Issue on Sentry]({link})\n"
-        
         # Append @ mentions to text so they are visually highlighted
         if at_mobiles:
              at_text = ' '.join([f"@{m}" for m in at_mobiles])