ErisPulse 2.1.14.dev1__tar.gz → 2.1.15__tar.gz

erispulse-2.1.15/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: ErisPulse 官方文档
+    url: https://erisdev.com/
+    about: 查看官方文档获取更多信息

erispulse-2.1.15/.github/ISSUE_TEMPLATE/module_submission.md

@@ -0,0 +1,38 @@
+---
+name: 模块/适配器/CLI扩展提交
+about: 提交一个新的模块、适配器或CLI扩展到 ErisPulse 生态系统
+title: '[提交] '
+labels: 'submission'
+assignees: ''
+
+---
+
+## 提交类型
+<!-- 请在适用的选项前打勾 -->
+- [ ] 模块 (Module)
+- [ ] 适配器 (Adapter)
+- [ ] CLI 扩展 (CLI Extension)
+
+## 基本信息
+- **名称**: 
+- **描述**: 
+- **作者**: 
+- **仓库地址**: 
+
+## 技术信息
+- **最低 SDK 版本要求** (如适用): 
+- **依赖项** (如适用): 
+
+## 其他信息
+- [ ] 官方维护
+- **标签** (用逗号分隔): 
+
+## 检查清单
+<!-- 请确认以下事项 -->
+- [ ] 代码遵循 ErisPulse 开发规范
+- [ ] 包含适当的文档
+- [ ] 包含测试用例（如适用）
+- [ ] 已在 PyPI 发布（如适用）
+
+## 备注
+<!-- 其他需要说明的信息 -->

erispulse-2.1.15/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,22 @@
+## 提交类型
+<!-- 请在适用的选项前打勾 -->
+- [ ] 功能新增
+- [ ] Bug 修复
+- [ ] 文档更新
+- [ ] 代码优化
+- [ ] 其他
+
+## 变更描述
+<!-- 请详细描述本次提交的内容 -->
+
+## 相关 Issue
+<!-- 如果有相关的 Issue，请填写链接 -->
+
+## 检查清单
+- [ ] 代码符合项目规范
+- [ ] 已进行充分测试
+- [ ] 文档已更新（如适用）
+- [ ] CHANGELOG 已更新（如适用）
+
+## 其他说明
+<!-- 其他需要说明的信息 -->

erispulse-2.1.15/.github/scripts/update_packages.py

@@ -0,0 +1,125 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+"""
+🌟 艾莉丝的版本探知魔法阵 ~
+这是一个用于自动检测和更新 packages.json 中模块版本的魔法脚本
+"""
+
+import json
+import requests
+import os
+from datetime import datetime, timezone
+import re
+
+# 魔法咒语准备
+headers = {
+    'Authorization': f'token {os.environ["GITHUB_TOKEN"]}',
+    'Accept': 'application/vnd.github.v3+json'
+}
+
+def get_latest_pypi_version(package_name):
+    try:
+        print(f"正在探查 {package_name} 的 PyPI 版本...")
+        response = requests.get(f'https://pypi.org/pypi/{package_name}/json', timeout=10)
+        if response.status_code == 200:
+            data = response.json()
+            version = data['info']['version']
+            print(f"找到了 {package_name} 的最新版本: {version}")
+            return version
+    except Exception as e:
+        print(f"💢 探查 {package_name} 的 PyPI 版本时遇到了障碍: {e}")
+    return None
+
+def get_latest_github_release(repo_url):
+    try:
+        print(f"正在探查 {repo_url} 的 GitHub 发布版本...")
+        if 'github.com' in repo_url:
+            # 从仓库 URL 提取 owner/repo
+            parts = repo_url.rstrip('/').split('/')
+            owner_repo = f"{parts[-2]}/{parts[-1]}"
+            
+            response = requests.get(f'https://api.github.com/repos/{owner_repo}/releases/latest', headers=headers, timeout=10)
+            if response.status_code == 200:
+                data = response.json()
+                version = data['tag_name'].lstrip('v')  # 移除可能的 'v' 前缀
+                print(f"✨ 找到了 {owner_repo} 的最新发布版本: {version}")
+                return version
+    except Exception as e:
+        print(f"💢 探查 {repo_url} 的 GitHub 版本时遇到了障碍: {e}")
+    return None
+
+def is_version_newer(new_version, old_version):
+    try:
+        def version_to_tuple(v):
+            # 移除版本字符串中的非数字和点字符（如 dev, alpha, beta 等）
+            v = re.sub(r'[^\d.]', '', v)
+            return tuple(map(int, (v.split('.'))))
+        
+        return version_to_tuple(new_version) > version_to_tuple(old_version)
+    except:
+        # 如果无法解析，保守地认为需要更新
+        return new_version != old_version
+
+def update_packages():
+    print("🌟 艾莉丝的版本探知魔法阵启动!")
+    
+    # 读取当前的魔法书
+    try:
+        with open('packages.json', 'r', encoding='utf-8') as f:
+            packages = json.load(f)
+        print("成功打开了 packages.json 魔法书!")
+    except Exception as e:
+        print(f"无法打开 packages.json 魔法书: {e}")
+        return
+    
+    current_time = datetime.now(timezone.utc).strftime('%Y-%m-%dT%H:%M:%SZ')
+    packages['last_updated'] = current_time
+    print(f"更新时间戳: {current_time}")
+    
+    updated_count = 0
+    
+    for category in ['modules', 'adapters', 'cli_extensions']:
+        if category in packages:
+            print(f"开始探查 {category} 分类...")
+            for name, info in packages[category].items():
+                try:
+                    old_version = info.get('version', '0.0.0')
+                    print(f"检查 {name} (当前版本: {old_version})")
+                    
+                    # 尝试从 PyPI 获取最新版本
+                    new_version = None
+                    if 'package' in info:
+                        new_version = get_latest_pypi_version(info.get('package', ''))
+                    
+                    # 如果 PyPI 获取失败，尝试从 GitHub 获取
+                    if not new_version and 'repository' in info:
+                        new_version = get_latest_github_release(info['repository'])
+                    
+                    # 如果找到了新版本且版本更高，则更新
+                    if new_version and is_version_newer(new_version, old_version):
+                        packages[category][name]['version'] = new_version
+                        print(f"更新 {name}: {old_version} -> {new_version}")
+                        updated_count += 1
+                    else:
+                        print(f"✨ {name} 已经是最新版本啦~")
+                        
+                except Exception as e:
+                    print(f"处理 {name} 时遇到了意外: {e}")
+    
+    # 写回魔法书
+    try:
+        with open('packages.json', 'w', encoding='utf-8') as f:
+            json.dump(packages, f, ensure_ascii=False, indent=4)
+        print(f"魔法书更新完成! 共更新了 {updated_count} 个模块~")
+    except Exception as e:
+        print(f"无法保存魔法书: {e}")
+        return
+    
+    if updated_count > 0:
+        print("艾莉丝的版本探知魔法大成功!")
+    else:
+        print("今天没有发现需要更新的模块呢~")
+
+if __name__ == '__main__':
+    update_packages()

erispulse-2.1.15/.github/tools/merge_md.py

@@ -0,0 +1,226 @@
+import os
+from datetime import datetime
+
+def merge_md_files(output_file, files_to_merge, title="文档合集"):
+    """
+    合并多个Markdown文件
+    
+    :param output_file: 输出文件路径
+    :param files_to_merge: 要合并的文件列表，包含文件路径和描述
+    :param title: 文档标题
+    """
+    with open(output_file, 'w', encoding='utf-8') as outfile:
+        # 写入头部说明
+        outfile.write(f"# ErisPulse {title}\n\n")
+        outfile.write(f"**生成时间**: {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}\n\n")
+        outfile.write("本文件由多个开发文档合并而成，用于辅助开发者理解 ErisPulse 的相关功能。\n\n")
+
+        # 写入目录
+        outfile.write("## 目录\n\n")
+        for i, file_info in enumerate(files_to_merge, 1):
+            filename = os.path.basename(file_info['path'])
+            outfile.write(f"{i}. [{file_info.get('description', filename)}](#{filename.replace('.', '').replace(' ', '-')})\n")
+        outfile.write("\n")
+
+        outfile.write("## 各文件对应内容说明\n\n")
+        outfile.write("| 文件名 | 作用 |\n")
+        outfile.write("|--------|------|\n")
+        
+        # 写入文件说明
+        for file_info in files_to_merge:
+            filename = os.path.basename(file_info['path'])
+            outfile.write(f"| [{filename}](#{filename.replace('.', '').replace(' ', '-')}) | {file_info.get('description', '')} |\n")
+        
+        outfile.write("\n---\n\n")
+
+        # 合并文件内容
+        for file_info in files_to_merge:
+            file_path = file_info['path']
+            if os.path.exists(file_path):
+                filename = os.path.basename(file_path)
+                outfile.write(f"<a id=\"{filename.replace('.', '').replace(' ', '-')}\"></a>\n")
+                outfile.write(f"## {file_info.get('description', filename)}\n\n")
+                
+                with open(file_path, 'r', encoding='utf-8') as infile:
+                    content = infile.read()
+                    outfile.write(content)
+                    outfile.write(f"\n\n---\n\n")
+            else:
+                print(f"文件不存在，跳过: {file_path}")
+
+def merge_api_docs(api_dir, output_file):
+    """
+    合并API文档
+    
+    :param api_dir: API文档目录
+    :param output_file: 输出文件路径
+    """
+    if not os.path.exists(api_dir):
+        print(f"API文档目录不存在: {api_dir}")
+        return
+        
+    with open(output_file, 'a', encoding='utf-8') as outfile:
+        outfile.write("# API参考\n\n")
+        
+        # 收集所有API文档文件
+        api_files = []
+        for root, _, files in os.walk(api_dir):
+            for file in files:
+                if file.endswith('.md'):
+                    file_path = os.path.join(root, file)
+                    api_files.append(file_path)
+        
+        # 按路径排序以保持一致性
+        api_files.sort()
+        
+        # 生成API文档目录
+        outfile.write("## API文档目录\n\n")
+        for file_path in api_files:
+            rel_path = os.path.relpath(file_path, api_dir)
+            anchor = rel_path.replace(os.sep, "_").replace(".md", "")
+            outfile.write(f"- [{rel_path}](#{anchor})\n")
+        outfile.write("\n---\n\n")
+
+        # 合并API文档内容
+        for file_path in api_files:
+            rel_path = os.path.relpath(file_path, api_dir)
+            anchor = rel_path.replace(os.sep, "_").replace(".md", "")
+            
+            outfile.write(f"<a id=\"{anchor}\"></a>\n")
+            outfile.write(f"## {rel_path}\n\n")
+            
+            try:
+                with open(file_path, 'r', encoding='utf-8') as infile:
+                    content = infile.read()
+                    # 移除原有标题，因为我们已经添加了
+                    lines = content.split('\n')
+                    if lines and lines[0].startswith('# '):
+                        content = '\n'.join(lines[1:])
+                    
+                    outfile.write(content)
+                    outfile.write("\n\n")
+            except Exception as e:
+                outfile.write(f"无法读取文件 {file_path}: {str(e)}\n\n")
+        
+        outfile.write("---\n")
+
+def generate_full_document():
+    print("正在生成完整文档...")
+    
+    # 要合并的文件
+    files_to_merge = [
+        {"path": "docs/quick-start.md", "description": "快速开始指南"},
+        {"path": "docs/UseCore.md", "description": "核心功能使用说明"},
+        {"path": "docs/PlatformFeatures.md", "description": "平台功能说明"},
+        {"path": "docs/Development/Module.md", "description": "模块开发指南"},
+        {"path": "docs/Development/Adapter.md", "description": "适配器开发指南"},
+        {"path": "docs/AdapterStandards/APIResponse.md", "description": "API响应标准"},
+        {"path": "docs/AdapterStandards/EventConversion.md", "description": "事件转换标准"},
+    ]
+    
+    # 过滤不存在的文件
+    existing_files = [f for f in files_to_merge if os.path.exists(f['path'])]
+    if len(existing_files) != len(files_to_merge):
+        print(f"警告: {len(files_to_merge) - len(existing_files)} 个文件不存在，已跳过")
+    
+    output_file = "docs/AIDocs/ErisPulse-Full.md"
+    os.makedirs(os.path.dirname(output_file), exist_ok=True)
+    
+    merge_md_files(output_file, existing_files, "完整开发文档")
+    merge_api_docs("docs/api", output_file)
+    
+    print(f"完整文档生成完成，已保存到: {output_file}")
+
+def generate_core_document():
+    print("正在生成核心功能文档...")
+    
+    files_to_merge = [
+        {"path": "docs/quick-start.md", "description": "快速开始指南"},
+        {"path": "docs/UseCore.md", "description": "核心功能使用说明"},
+        {"path": "docs/PlatformFeatures.md", "description": "平台功能说明"},
+    ]
+    
+    # 过滤不存在的文件
+    existing_files = [f for f in files_to_merge if os.path.exists(f['path'])]
+    
+    output_file = "docs/AIDocs/ErisPulse-Core.md"
+    os.makedirs(os.path.dirname(output_file), exist_ok=True)
+    
+    merge_md_files(output_file, existing_files, "核心功能文档")
+    # 合并API文档
+    merge_api_docs("docs/api", output_file)
+    
+    print(f"核心功能文档生成完成，已保存到: {output_file}")
+
+def generate_dev_documents():
+    print("正在生成开发文档...")
+    
+    # 模块开发文档
+    module_files = [
+        {"path": "docs/quick-start.md", "description": "快速开始指南"},
+        {"path": "docs/UseCore.md", "description": "核心功能使用说明"},
+        {"path": "docs/PlatformFeatures.md", "description": "平台支持的发送类型及差异性说明"},
+        {"path": "docs/Development/Module.md", "description": "模块开发指南"}
+    ]
+    
+    # 过滤不存在的文件
+    existing_module_files = [f for f in module_files if os.path.exists(f['path'])]
+    
+    module_output = "docs/AIDocs/ErisPulse-ModuleDev.md"
+    os.makedirs(os.path.dirname(module_output), exist_ok=True)
+    merge_md_files(module_output, existing_module_files, "模块开发文档")
+    # 合并API文档
+    merge_api_docs("docs/api", module_output)
+    
+    print(f"模块开发文档生成完成，已保存到: {module_output}")
+    
+    # 适配器开发文档
+    adapter_files = [
+        {"path": "docs/quick-start.md", "description": "快速开始指南"},
+        {"path": "docs/UseCore.md", "description": "核心功能使用说明"},
+        {"path": "docs/Development/Adapter.md", "description": "适配器开发指南"},
+        {"path": "docs/AdapterStandards/APIResponse.md", "description": "API响应标准"},
+        {"path": "docs/AdapterStandards/EventConversion.md", "description": "事件转换标准"},
+    ]
+    
+    # 过滤不存在的文件
+    existing_adapter_files = [f for f in adapter_files if os.path.exists(f['path'])]
+    
+    adapter_output = "docs/AIDocs/ErisPulse-AdapterDev.md"
+    os.makedirs(os.path.dirname(adapter_output), exist_ok=True)
+    merge_md_files(adapter_output, existing_adapter_files, "适配器开发文档")
+    # 合并API文档
+    merge_api_docs("docs/api", adapter_output)
+    
+    print(f"适配器开发文档生成完成，已保存到: {adapter_output}")
+
+def generate_custom_document(title, files, api_dirs, output_path):
+    """
+    生成自定义文档
+    
+    :param title: 文档标题
+    :param files: 要合并的文件列表
+    :param api_dirs: 要合并的API目录列表
+    :param output_path: 输出路径
+    """
+    print(f"正在生成{title}...")
+    
+    # 过滤不存在的文件
+    existing_files = [f for f in files if os.path.exists(f['path'])]
+    
+    os.makedirs(os.path.dirname(output_path), exist_ok=True)
+    merge_md_files(output_path, existing_files, title)
+    
+    # API文档
+    merge_api_docs("docs/api", output_path)
+    
+    print(f"{title}生成完成，已保存到: {output_path}")
+
+if __name__ == "__main__":
+    try:
+        generate_full_document()
+        generate_core_document()
+        generate_dev_documents()
+        print("所有文档生成完成")
+    except Exception as e:
+        print(f"文档生成过程中出现错误: {str(e)}")

{erispulse-2.1.14.dev1 → erispulse-2.1.15}/.github/tools/update-api-docs.py

@@ -102,7 +102,7 @@ def parse_python_file(file_path: str) -> Tuple[Optional[str], List[Dict], List[D
     try:
         module = ast.parse(source)
     except SyntaxError:
-        print(f"⚠️ 语法错误，跳过文件: {file_path}")
+        print(f"语法错误，跳过文件: {file_path}")
         return None, [], []
     
     # 提取模块文档
@@ -211,9 +211,9 @@ def generate_markdown(module_path: str, module_doc: Optional[str],
     content = []
     
     # 文档头部
-    content.append(f"""# 📦 `{module_path}` 模块
+    content.append(f"""# `{module_path}` 模块
 
-<sup>自动生成于 {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}</sup>
+<sup>更新时间: {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}</sup>
 
 ---
 
@@ -229,9 +229,9 @@ def generate_markdown(module_path: str, module_doc: Optional[str],
     
     # 函数部分
     if functions:
-        content.append("## 🛠️ 函数\n")
+        content.append("## 函数列表\n")
         for func in functions:
-            async_marker = "🔷 " if func["is_async"] else ""
+            async_marker = "async " if func["is_async"] else ""
             content.append(f"""### {async_marker}`{func['signature']}`
 
 {func['doc']}
@@ -241,7 +241,7 @@ def generate_markdown(module_path: str, module_doc: Optional[str],
     
     # 类部分
     if classes:
-        content.append("## 🏛️ 类\n")
+        content.append("## 类列表\n")
         for cls in classes:
             content.append(f"""### `{cls['signature']}`
 
@@ -251,9 +251,9 @@ def generate_markdown(module_path: str, module_doc: Optional[str],
             
             # 类方法
             if cls["methods"]:
-                content.append("#### 🧰 方法\n")
+                content.append("#### 方法列表\n")
                 for method in cls["methods"]:
-                    async_marker = "🔷 " if method["is_async"] else ""
+                    async_marker = "async " if method["is_async"] else ""
                     content.append(f"""##### {async_marker}`{method['signature']}`
 
 {method['doc']}
@@ -480,8 +480,8 @@ def generate_html(module_path: str, module_doc: Optional[str],
 <body>
     <header>
         <div class="container">
-            <h1>📦 <code>{module_path}</code> 模块</h1>
-            <p><small>自动生成于 {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}</small></p>
+            <h1>`{module_path}` 模块</h1>
+            <p><small>更新时间: {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}</small></p>
         </div>
     </header>
     
@@ -498,18 +498,18 @@ def generate_html(module_path: str, module_doc: Optional[str],
     
     # 函数部分
     if functions:
-        html_content.append("</section>\n\n<section>\n<h2>🛠️ 函数</h2>\n")
+        html_content.append("</section>\n\n<section>\n<h2>函数列表</h2>\n")
         for func in functions:
-            async_marker = "🔷 " if func["is_async"] else ""
+            async_marker = "async " if func["is_async"] else ""
             html_content.append(f"""<article>
-    <h3>{async_marker}<code class="signature function-signature">{func['signature']}</code></h3>
+    <h3><code class="signature function-signature">{async_marker}{func['signature']}</code></h3>
     <div>{func['doc']}</div>
 </article>
 """)
     
     # 类部分
     if classes:
-        html_content.append("</section>\n\n<section>\n<h2>🏛️ 类</h2>\n")
+        html_content.append("</section>\n\n<section>\n<h2>类列表</h2>\n")
         for cls in classes:
             html_content.append(f"""<article>
     <h3><code class="signature class-signature">{cls['signature']}</code></h3>
@@ -518,11 +518,11 @@ def generate_html(module_path: str, module_doc: Optional[str],
             
             # 类方法
             if cls["methods"]:
-                html_content.append("<h4>🧰 方法</h4>\n")
+                html_content.append("<h4>方法列表</h4>\n")
                 for method in cls["methods"]:
-                    async_marker = "🔷 " if method["is_async"] else ""
+                    async_marker = "async " if method["is_async"] else ""
                     html_content.append(f"""<article>
-        <h5>{async_marker}<code class="signature method-signature">{method['signature']}</code></h5>
+        <h5><code class="signature method-signature">{async_marker}{method['signature']}</code></h5>
         <div>{method['doc']}</div>
     </article>
 """)
@@ -539,7 +539,7 @@ def generate_html(module_path: str, module_doc: Optional[str],
     </footer>
 </body>
 </html>""")
-    
+
     return "\n".join(html_content)
 
 def generate_api_docs(src_dir: str, output_dir: str, format: str = "markdown"):
@@ -568,7 +568,7 @@ def generate_api_docs(src_dir: str, output_dir: str, format: str = "markdown"):
                 
                 # 跳过没有文档的文件
                 if not module_doc and not classes and not functions:
-                    print(f"⏭️ 跳过无文档文件: {file_path}")
+                    print(f"跳过无文档文件: {file_path}")
                     continue
                 
                 # 生成内容
@@ -586,7 +586,7 @@ def generate_api_docs(src_dir: str, output_dir: str, format: str = "markdown"):
                 with open(output_path, "w", encoding="utf-8") as f:
                     f.write(content)
                 
-                print(f"✅ 已生成: {output_path}")
+                print(f"已生成: {output_path}")
 
 if __name__ == "__main__":
     parser = argparse.ArgumentParser(description="API文档生成器")
@@ -597,20 +597,11 @@ if __name__ == "__main__":
     
     args = parser.parse_args()
     
-    print(f"""📁 源代码目录: {args.src}
-📂 输出目录: {args.output}
-📄 输出格式: {args.format}
-⏳ 正在生成API文档...""")
+    print(f"""源代码目录: {args.src}
+输出目录: {args.output}
+输出格式: {args.format}
+正在生成API文档...""")
     
     generate_api_docs(args.src, args.output, args.format)
     
-    print(f"""🎉 API文档生成完成！
-
-生成文档包含以下改进:
-✨ 更现代化的样式和布局
-📅 自动添加生成时间戳
-🔖 使用emoji图标提高可读性
-📝 优化了参数和返回值的显示方式
-📱 响应式设计，适配移动设备
-💡 改进了示例代码的展示方式
-""")
+    print(f"API文档生成完成！")

{erispulse-2.1.14.dev1 → erispulse-2.1.15}/.github/workflows/auto-tag-release.yml

@@ -33,12 +33,16 @@ jobs:
 
           commit_msg=$(git log -1 --pretty=%B)
           commit_short=$(git rev-parse --short HEAD)
+          commit_author=$(git log -1 --pretty=%an)
+          commit_email=$(git log -1 --pretty=%ae)
           echo "commit_short=$commit_short" >> $GITHUB_OUTPUT
+          echo "commit_author=$commit_author" >> $GITHUB_OUTPUT
+          echo "commit_email=$commit_email" >> $GITHUB_OUTPUT
           echo "commit_msg<<EOF" >> $GITHUB_OUTPUT
           echo "$commit_msg" >> $GITHUB_OUTPUT
           echo "EOF" >> $GITHUB_OUTPUT
 
-      - name: 获取变更文件列表
+      - name: 获取变更文件列表和贡献者
         id: changed_files
         shell: bash
         run: |
@@ -52,15 +56,21 @@ jobs:
           echo "before=$before" >> $GITHUB_OUTPUT
           echo "after=$after" >> $GITHUB_OUTPUT
 
+          # 获取变更文件列表
           files=$(git diff --name-only $before..$after | head -n 50 | xargs)
           file_count=$(git diff --name-only $before..$after | wc -l)
 
           if [ "$file_count" -gt 50 ]; then
             files="$files ..."
           fi
-
           echo "files=$files" >> $GITHUB_OUTPUT
 
+          # 获取贡献者列表
+          contributors=$(git log $before..$after --format="%an <%ae>" | sort -u)
+          echo "contributors<<EOF" >> $GITHUB_OUTPUT
+          echo "$contributors" >> $GITHUB_OUTPUT
+          echo "EOF" >> $GITHUB_OUTPUT
+
       - name: 施展版本魔法
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -68,19 +78,38 @@ jobs:
         run: |
           version="${{ steps.info.outputs.version }}"
           commit_short="${{ steps.info.outputs.commit_short }}"
+          commit_author="${{ steps.info.outputs.commit_author }}"
+          commit_email="${{ steps.info.outputs.commit_email }}"
           commit_msg="${{ steps.info.outputs.commit_msg }}"
           is_dev="${{ steps.info.outputs.is_dev }}"
+          contributors="${{ steps.changed_files.outputs.contributors }}"
           tag_name="v$version"
           
+          # 构建发布说明
           if [ -f "docs/CHANGELOG.md" ]; then
             changelog=$(sed -n "/^## \[$version\]/,/^## /p" docs/CHANGELOG.md | sed '1d;$d')
           fi
+          
           if [ -z "$changelog" ]; then
-            changelog="### ✨ 魔法更新\n\n- $commit_msg ($commit_short)"
+            changelog="### ✨✨ 魔法更新\n\n- $commit_msg ($commit_short)\n\n"
+          else
+            changelog="$changelog\n\n"
           fi
+          
+          # 贡献信息
+          changelog="${changelog}### 🧙‍♀️ 魔法贡献者\n\n"
+          while IFS= read -r contributor; do
+            escaped_contributor=$(echo "$contributor" | sed 's/>/\&gt;/g' | sed 's/</\&lt;/g')
+            changelog="${changelog}- ${escaped_contributor}\n"
+          done <<< "$contributors"
+
+          changelog="${changelog}\n### 📜 魔法卷轴更新\n\n"
+          escaped_commit_msg=$(echo "$commit_msg" | sed 's/#/\\#/g')
+          changelog="${changelog}- 最新提交: $escaped_commit_msg (by $commit_author, $commit_short)\n"
+          changelog="${changelog}- 变更文件: ${{ steps.changed_files.outputs.files }}\n"
 
           if ! git rev-parse "$tag_name" >/dev/null 2>&1; then
-            echo "🎀 施加新的魔法印记..."
+            echo "🎀🎀 施加新的魔法印记..."
             git tag "$tag_name"
             git push origin "$tag_name"
           fi
@@ -97,3 +126,4 @@ jobs:
               --prerelease=$is_dev
             echo "✨ 已发布新的魔法版本 $tag_name"
           fi
+