ErisPulse 2.2.1__tar.gz → 2.3.0__tar.gz

{erispulse-2.2.1 → erispulse-2.3.0}/.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/.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 → erispulse-2.3.0}/.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.3.0/.github/workflows/auto-tag-release.yml

@@ -0,0 +1,95 @@
+name: 🎀 艾莉丝的版本标签魔法 ~
+
+permissions:
+  contents: write
+
+on:
+  push:
+    branches: [main, Pre-Release/v2]
+
+jobs:
+  update-latest-release:
+    runs-on: ubuntu-latest
+    steps:
+      - name: 检出代码
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: 施展版本魔法
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        shell: bash
+        run: |
+          # 读取当前版本
+          version=$(grep '^version' pyproject.toml | head -1 | sed 's/version = "//;s/"//')
+          tag_name="v$version"
+          
+          echo "当前版本: $version"
+          echo "标签名称: $tag_name"
+          
+          # 从 CHANGELOG.md 提取更新日志
+          if [ -f "CHANGELOG.md" ]; then
+            # 修复版本号格式：将 -de. 替换为 -dev.
+            fixed_version=$(echo "$version" | sed 's/-de\./-dev./g')
+            
+            echo "尝试匹配版本: $version 或 $fixed_version"
+            
+            # 使用 sed 提取版本更新日志
+            # 先尝试匹配原始版本号
+            changelog_section=$(sed -n "/^## \[$version\] -/,/^## \[.*\] -/p" CHANGELOG.md | sed '$d')
+            
+            # 如果没找到，尝试匹配修复后的版本号
+            if [ -z "$changelog_section" ]; then
+              changelog_section=$(sed -n "/^## \[$fixed_version\] -/,/^## \[.*\] -/p" CHANGELOG.md | sed '$d')
+            fi
+            
+            # 移除第一行（标题行）
+            if [ -n "$changelog_section" ]; then
+              changelog=$(echo "$changelog_section" | tail -n +2)
+              
+              # 判断是否为开发版本
+              if [[ $version =~ dev|alpha|beta|pre|a|b ]]; then
+                is_dev="true"
+                latest_flag=""
+              else
+                is_dev="false"
+                latest_flag="--latest"
+              fi
+              
+              # 检查标签是否已存在
+              if ! git rev-parse "$tag_name" >/dev/null 2>&1; then
+                echo "🎀🎀 创建新标签 $tag_name..."
+                git tag "$tag_name"
+                git push origin "$tag_name"
+              else
+                echo "标签 $tag_name 已存在"
+              fi
+              
+              # 检查发行是否存在
+              if gh release view "$tag_name" &>/dev/null; then
+                # 更新发行
+                echo "🔄 更新发行 $tag_name..."
+                gh release edit "$tag_name" \
+                  --notes "$changelog" \
+                  --prerelease=$is_dev
+                echo "✅ 已更新发行 $tag_name"
+              else
+                # 创建发行
+                echo "✨ 创建发行 $tag_name..."
+                gh release create "$tag_name" \
+                  --notes "$changelog" \
+                  --title "✨ 艾莉丝的魔法更新 $tag_name" \
+                  --prerelease=$is_dev \
+                  $latest_flag
+                echo "✅ 已创建发行 $tag_name"
+              fi
+              
+              echo "📦 发行页面: https://github.com/${{ github.repository }}/releases/tag/$tag_name"
+            else
+              echo "⚠️ 未找到版本 $version 的更新日志"
+            fi
+          else
+            echo "⚠️ CHANGELOG.md 文件不存在"
+          fi

erispulse-2.3.0/.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 → erispulse-2.3.0}/.gitignore

@@ -212,3 +212,5 @@ pyvenv.cfg
 my_bot
 modules
 config.toml
+devs/test_st.py
+docs/ux-improvements.md