ErisPulse 2.2.1.dev0__tar.gz → 2.3.0.dev5__tar.gz

{erispulse-2.2.1.dev0 → erispulse-2.3.0.dev5}/.github/scripts/update_packages.py

@@ -57,7 +57,7 @@ def is_version_newer(new_version, old_version):
             return tuple(map(int, (v.split('.'))))
         
         return version_to_tuple(new_version) > version_to_tuple(old_version)
-    except:
+    except Exception:
         # 如果无法解析，保守地认为需要更新
         return new_version != old_version
 

erispulse-2.3.0.dev5/.github/tools/merge_md.py

@@ -0,0 +1,424 @@
+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(' ', '-').replace('/', '').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(' ', '-').replace('/', '').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)
+                anchor_name = filename.replace('.', '').replace(' ', '-').replace('/', '').replace('(', '').replace(')', '')
+                outfile.write(f"<a id=\"{anchor_name}\"></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("\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", "").replace("/", "_").replace("\\", "_")
+            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", "").replace("/", "_").replace("\\", "_")
+            
+            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 get_core_files():
+    """
+    获取core目录下的所有文档文件
+    """
+    core_files = []
+    core_dir = "docs/core"
+    
+    if os.path.exists(core_dir):
+        # 按重要性排序的文件列表
+        important_files = [
+            "README.md",
+            "concepts.md", 
+            "modules.md",
+            "adapters.md",
+            "event-system.md",
+            "cli.md",
+            "best-practices.md"
+        ]
+        
+        # 按顺序添加文件
+        for filename in important_files:
+            file_path = os.path.join(core_dir, filename)
+            if os.path.exists(file_path):
+                description = ""
+                if filename == "README.md":
+                    description = "核心功能文档列表"
+                elif filename == "concepts.md":
+                    description = "核心概念"
+                elif filename == "modules.md":
+                    description = "核心模块详解"
+                elif filename == "adapters.md":
+                    description = "适配器系统"
+                elif filename == "event-system.md":
+                    description = "事件系统"
+                elif filename == "cli.md":
+                    description = "命令行接口"
+                elif filename == "best-practices.md":
+                    description = "最佳实践"
+                
+                core_files.append({
+                    "path": file_path,
+                    "description": description
+                })
+    
+    return core_files
+
+def get_development_files():
+    """
+    获取development目录下的所有文档文件
+    """
+    dev_files = []
+    dev_dir = "docs/development"
+    
+    if os.path.exists(dev_dir):
+        # 按重要性排序的文件列表
+        important_files = [
+            "README.md",
+            "module.md",
+            "adapter.md", 
+            "cli.md"
+        ]
+        
+        # 按顺序添加文件
+        for filename in important_files:
+            file_path = os.path.join(dev_dir, filename)
+            if os.path.exists(file_path):
+                description = ""
+                if filename == "README.md":
+                    description = "开发者指南列表"
+                elif filename == "module.md":
+                    description = "模块开发指南"
+                elif filename == "adapter.md":
+                    description = "适配器开发指南"
+                elif filename == "cli.md":
+                    description = "CLI开发指南"
+                
+                dev_files.append({
+                    "path": file_path,
+                    "description": description
+                })
+    
+    return dev_files
+
+def get_standards_files():
+    """
+    获取standards目录下的所有文档文件
+    """
+    standards_files = []
+    standards_dir = "docs/standards"
+    
+    if os.path.exists(standards_dir):
+        # 按重要性排序的文件列表
+        important_files = [
+            "README.md",
+            "event-conversion.md",
+            "api-response.md"
+        ]
+        
+        # 按顺序添加文件
+        for filename in important_files:
+            file_path = os.path.join(standards_dir, filename)
+            if os.path.exists(file_path):
+                description = ""
+                if filename == "README.md":
+                    description = "标准规范总览"
+                elif filename == "event-conversion.md":
+                    description = "事件转换标准"
+                elif filename == "api-response.md":
+                    description = "API响应标准"
+                
+                standards_files.append({
+                    "path": file_path,
+                    "description": description
+                })
+    
+    return standards_files
+
+def get_platform_features_files():
+    """
+    获取platform-features目录下的所有文档文件
+    """
+    platform_files = []
+    platform_dir = "docs/platform-features"
+    
+    if os.path.exists(platform_dir):
+        # 按重要性排序的文件列表
+        important_files = [
+            "README.md",
+            "yunhu.md",
+            "telegram.md",
+            "onebot11.md",
+            "email.md"
+        ]
+        
+        # 按顺序添加文件
+        for filename in important_files:
+            file_path = os.path.join(platform_dir, filename)
+            if os.path.exists(file_path):
+                # 跳过维护说明文件
+                if filename == "maintain-notes.md":
+                    continue
+                    
+                description = ""
+                if filename == "README.md":
+                    description = "平台特性总览"
+                elif filename == "yunhu.md":
+                    description = "云湖平台特性"
+                elif filename == "telegram.md":
+                    description = "Telegram平台特性"
+                elif filename == "onebot11.md":
+                    description = "OneBot11平台特性"
+                elif filename == "email.md":
+                    description = "邮件平台特性"
+                
+                platform_files.append({
+                    "path": file_path,
+                    "description": description
+                })
+    
+    return platform_files
+
+def generate_full_document():
+    print("正在生成完整文档...")
+    
+    # 基础文件
+    base_files = [
+        {"path": "docs/README.md", "description": "文档总览"},
+        {"path": "docs/quick-start.md", "description": "快速开始指南"},
+    ]
+    
+    # 添加核心文档
+    core_files = get_core_files()
+    
+    # 添加开发文档
+    dev_files = get_development_files()
+    
+    # 添加标准文档
+    standards_files = get_standards_files()
+    
+    # 添加平台特性文件
+    platform_files = get_platform_features_files()
+    
+    # 合并所有文件
+    files_to_merge = base_files + core_files + dev_files + standards_files + platform_files
+    
+    # 过滤不存在的文件
+    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/ai/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_dev_documents():
+    print("正在生成开发文档...")
+    
+    # 模块开发文档
+    module_files = [
+        {"path": "docs/README.md", "description": "文档总览"},
+        {"path": "docs/quick-start.md", "description": "快速开始指南"},
+        {"path": "docs/core/concepts.md", "description": "基础架构和设计理念"},
+        {"path": "docs/core/modules.md", "description": "核心模块"},
+        {"path": "docs/core/adapters.md", "description": "适配器"},
+        {"path": "docs/core/event-system.md", "description": "事件系统"},
+    ]
+    
+    # 添加开发文档 (包括模块开发指南)
+    dev_files = get_development_files()
+    module_dev_files = [f for f in dev_files if "模块" in f["description"] or "指南列表" in f["description"]]
+    
+    # 添加标准文档
+    standards_files = get_standards_files()
+    
+    # 添加平台特性文件
+    platform_files = get_platform_features_files()
+    
+    # 合并所有文件
+    files_to_merge = module_files + module_dev_files + standards_files + platform_files
+    
+    # 过滤不存在的文件
+    existing_files = [f for f in files_to_merge if os.path.exists(f['path'])]
+    
+    module_output = "docs/ai/AIDocs/ErisPulse-ModuleDev.md"
+    os.makedirs(os.path.dirname(module_output), exist_ok=True)
+    merge_md_files(module_output, existing_files, "模块开发文档")
+
+    print(f"模块开发文档生成完成，已保存到: {module_output}")
+    
+    # 适配器开发文档
+    adapter_files = [
+        {"path": "docs/README.md", "description": "文档总览"},
+        {"path": "docs/quick-start.md", "description": "快速开始指南"},
+        {"path": "docs/core/concepts.md", "description": "核心概念"},
+        {"path": "docs/core/modules.md", "description": "核心模块"},
+        {"path": "docs/core/adapters.md", "description": "适配器系统"},
+        {"path": "docs/core/event-system.md", "description": "事件系统"},
+        {"path": "docs/core/best-practices.md", "description": "最佳实践"},
+    ]
+    
+    # 添加开发文档 (包括适配器开发指南)
+    adapter_dev_files = [f for f in dev_files if "适配器" in f["description"] or "指南列表" in f["description"]]
+    
+    # 合并所有文件
+    files_to_merge = adapter_files + adapter_dev_files + standards_files + platform_files
+    
+    # 过滤不存在的文件
+    existing_files = [f for f in files_to_merge if os.path.exists(f['path'])]
+    
+    adapter_output = "docs/ai/AIDocs/ErisPulse-AdapterDev.md"
+    os.makedirs(os.path.dirname(adapter_output), exist_ok=True)
+    merge_md_files(adapter_output, existing_files, "适配器开发文档")
+    merge_api_docs("docs/api", adapter_output)
+    
+    print(f"适配器开发文档生成完成，已保存到: {adapter_output}")
+
+def generate_core_document():
+    print("正在生成核心文档...")
+    
+    # 基础文件
+    base_files = [
+        {"path": "docs/README.md", "description": "文档总览"},
+        {"path": "docs/quick-start.md", "description": "快速开始指南"},
+    ]
+    
+    # 核心文档
+    core_files = get_core_files()
+    
+    # 添加平台特性文件
+    platform_files = get_platform_features_files()
+    
+    # 合并所有文件
+    files_to_merge = base_files + core_files + platform_files
+    
+    # 过滤不存在的文件
+    existing_files = [f for f in files_to_merge if os.path.exists(f['path'])]
+    
+    core_output = "docs/ai/AIDocs/ErisPulse-Core.md"
+    os.makedirs(os.path.dirname(core_output), exist_ok=True)
+    merge_md_files(core_output, existing_files, "核心功能文档")
+    
+    print(f"核心文档生成完成，已保存到: {core_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文档
+    for api_dir in api_dirs:
+        merge_api_docs(api_dir, output_path)
+    
+    print(f"{title}生成完成，已保存到: {output_path}")
+
+if __name__ == "__main__":
+    try:
+        generate_full_document()
+        generate_dev_documents()
+        # generate_core_document()
+        print("所有文档生成完成")
+    except Exception as e:
+        print(f"文档生成过程中出现错误: {str(e)}")

{erispulse-2.2.1.dev0 → erispulse-2.3.0.dev5}/.github/tools/update-api-docs.py

@@ -2,7 +2,7 @@ import os
 import ast
 import re
 import argparse
-from typing import List, Dict, Tuple, Optional, Set
+from typing import List, Dict, Tuple, Optional
 from datetime import datetime
 
 def process_docstring(docstring: str) -> Optional[str]:
@@ -606,4 +606,4 @@ if __name__ == "__main__":
     
     generate_api_docs(args.src, args.output, args.format)
     
-    print(f"API文档生成完成！")
+    print("API文档生成完成！")

{erispulse-2.2.1.dev0 → erispulse-2.3.0.dev5}/.github/workflows/auto-tag-release.yml

@@ -96,18 +96,6 @@ jobs:
             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 "🎀🎀 施加新的魔法印记..."
             git tag "$tag_name"

erispulse-2.3.0.dev5/.github/workflows/code-quality-check.yml

@@ -0,0 +1,86 @@
+name: 🔍 艾莉丝的代码审查魔法 ~
+
+permissions:
+  contents: read
+  pull-requests: write
+
+on:
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  code-quality-check:
+    runs-on: ubuntu-latest
+    steps:
+      - name: 检出魔法书
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: 准备魔法环境
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.x'
+
+      - name: 召唤审查精灵 Ruff
+        run: |
+          python -m pip install --upgrade pip
+          pip install ruff
+
+      - name: 施展代码审查魔法
+        id: ruff-check
+        continue-on-error: true
+        run: |
+          echo "🔍 艾莉丝正在使用 Ruff 审查代码规范..."
+          ruff_output=$(ruff check . 2>&1; echo "RUFF_EXIT_CODE=$?")
+          exit_code=${ruff_output##*RUFF_EXIT_CODE=}
+          ruff_output=${ruff_output%RUFF_EXIT_CODE=*}
+          
+          echo "RUFF_OUTPUT<<EOF" >> $GITHUB_ENV
+          echo "$ruff_output" >> $GITHUB_ENV
+          echo "EOF" >> $GITHUB_ENV
+          
+          if [ -n "$ruff_output" ] || [ "$exit_code" -ne 0 ]; then
+            echo "has_errors=true" >> $GITHUB_OUTPUT
+          else
+            echo "has_errors=false" >> $GITHUB_OUTPUT
+          fi
+
+      - name: 提交审查结果到PR
+        if: steps.ruff-check.outputs.has_errors == 'true' && github.event_name == 'pull_request'
+        uses: actions/github-script@v6
+        with:
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          script: |
+            const { data: comments } = await github.rest.issues.listComments({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.payload.pull_request.number
+            });
+            
+            const botComment = comments.find(comment => 
+              comment.user.login === '艾莉丝[bot]' && 
+              comment.body.includes('🔍 代码审查结果')
+            );
+            
+            const message = `
+            🔍 代码审查结果
+            
+            ${process.env.RUFF_OUTPUT}
+            `;
+            
+            if (botComment) {
+              await github.rest.issues.updateComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                comment_id: botComment.id,
+                body: message
+              });
+            } else {
+              await github.rest.issues.createComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: context.payload.pull_request.number,
+                body: message
+              });
+            }

{erispulse-2.2.1.dev0 → erispulse-2.3.0.dev5}/.gitignore

@@ -212,3 +212,4 @@ pyvenv.cfg
 my_bot
 modules
 config.toml
+devs/test_st.py