ErisPulse 2.1.15.dev3__tar.gz → 2.2.0.dev0__tar.gz

erispulse-2.2.0.dev0/.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.15.dev3 → erispulse-2.2.0.dev0}/.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.15.dev3 → erispulse-2.2.0.dev0}/.github/workflows/auto-tag-release.yml

@@ -96,15 +96,16 @@ jobs:
             changelog="$changelog\n\n"
           fi
           
-          # 添加贡献者信息
+          # 贡献信息
           changelog="${changelog}### 🧙‍♀️ 魔法贡献者\n\n"
           while IFS= read -r contributor; do
-            changelog="${changelog}- ${contributor}\n"
+            escaped_contributor=$(echo "$contributor" | sed 's/>/\&gt;/g' | sed 's/</\&lt;/g')
+            changelog="${changelog}- ${escaped_contributor}\n"
           done <<< "$contributors"
-          
-          # 添加提交信息
+
           changelog="${changelog}\n### 📜 魔法卷轴更新\n\n"
-          changelog="${changelog}- 最新提交: $commit_msg (by $commit_author, $commit_short)\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

{erispulse-2.1.15.dev3 → erispulse-2.2.0.dev0}/.gitignore

@@ -1,4 +1,5 @@
 # dev gnore ignore file for Python projects
+devs/videos
 main.py
 venvs
 config.toml

{erispulse-2.1.15.dev3 → erispulse-2.2.0.dev0}/LICENSE

@@ -28,4 +28,10 @@ This SDK's core adapter standardization layer strictly follows OneBot12 specific
 - Message segment definitions
 - Metadata definitions
 
-This ensures consistent behavior and interoperability across all adapter implementations.
+This ensures consistent behavior and interoperability across all adapter implementations.
+
+感谢所有为开源社区做出贡献的开发者和作者
+
+请尊重每一位开源作者的劳动成果，承诺在使用、修改和分发本软件时，将严格遵守相关许可证条款，并保留所有原始版权声明
+
+开源精神的核心在于分享、协作与尊重。我们希望通过本项目，能够传承这一精神，为开源社区的发展贡献一份力量

{erispulse-2.1.15.dev3 → erispulse-2.2.0.dev0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ErisPulse
-Version: 2.1.15.dev3
+Version: 2.2.0.dev0
 Summary: ErisPulse 是一个模块化、可扩展的异步 Python SDK 框架，主要用于构建高效、可维护的机器人应用程序。
 Author-email: "艾莉丝·格雷拉特(WSu2059)" <wsu2059@qq.com>
 License: MIT License
@@ -34,6 +34,12 @@ License: MIT License
         - Metadata definitions
         
         This ensures consistent behavior and interoperability across all adapter implementations.
+        
+        感谢所有为开源社区做出贡献的开发者和作者
+        
+        请尊重每一位开源作者的劳动成果，承诺在使用、修改和分发本软件时，将严格遵守相关许可证条款，并保留所有原始版权声明
+        
+        开源精神的核心在于分享、协作与尊重。我们希望通过本项目，能够传承这一精神，为开源社区的发展贡献一份力量
 License-File: LICENSE
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers

{erispulse-2.1.15.dev3 → erispulse-2.2.0.dev0}/devs/test.py

@@ -74,7 +74,7 @@ async def test_logger():
     
     print(f"\n{Colors.GREEN}日志测试完成，请查看控制台和文件 {log_file} 的输出{Colors.END}")
 
-async def test_env():
+async def test_storage():
     while True:
         print(f"\n{Colors.CYAN}--- 环境配置测试 ---{Colors.END}")
         print(f"{Colors.BLUE}1. 设置/获取单个配置项{Colors.END}")
@@ -91,36 +91,36 @@ async def test_env():
                 print(f"\n{Colors.YELLOW}--- 单个配置项测试 ---{Colors.END}")
                 key = input(f"{Colors.GREEN}请输入配置项名称: {Colors.END}").strip()
                 value = input(f"{Colors.GREEN}请输入{key}的值: {Colors.END}").strip()
-                sdk.env.set(key, value)
+                sdk.storage.set(key, value)
                 print(f"{Colors.GREEN}已设置 {key}={value}{Colors.END}")
-                print(f"{Colors.GREEN}读取测试: {key} = {sdk.env.get(key)}{Colors.END}")
+                print(f"{Colors.GREEN}读取测试: {key} = {sdk.storage.get(key)}{Colors.END}")
                 
             elif choice == "2":
                 print(f"\n{Colors.YELLOW}--- 批量配置项测试 ---{Colors.END}")
                 count = input(f"{Colors.GREEN}请输入要批量设置的配置项数量(默认3): {Colors.END}") or "3"
                 items = {f"test_key_{i}": f"value_{i}" for i in range(1, int(count)+1)}
-                sdk.env.set_multi(items)
+                sdk.storage.set_multi(items)
                 print(f"{Colors.GREEN}已批量设置 {len(items)} 个配置项{Colors.END}")
-                print(f"{Colors.GREEN}批量读取结果: {sdk.env.get_multi(list(items.keys()))}{Colors.END}")
+                print(f"{Colors.GREEN}批量读取结果: {sdk.storage.get_multi(list(items.keys()))}{Colors.END}")
                 
             elif choice == "3":
                 print(f"\n{Colors.YELLOW}--- 测试配置管理 ---{Colors.END}")
                 config_key = input(f"{Colors.GREEN}请输入配置项key: {Colors.END}") or None
                 config_value = input(f"{Colors.GREEN}请输入配置项value: {Colors.END}") or None
                 if config_key and config_value:
-                    sdk.env.setConfig(config_key, config_value)
+                    sdk.storage.setConfig(config_key, config_value)
                     print(f"{Colors.GREEN}已设置 {config_key}={config_value}{Colors.END}")
-                    print(f"{Colors.GREEN}读取测试: {config_key} = {sdk.env.getConfig(config_key)}{Colors.END}")
+                    print(f"{Colors.GREEN}读取测试: {config_key} = {sdk.storage.getConfig(config_key)}{Colors.END}")
                 else:
                     print(f"{Colors.RED}请设置配置项key和value{Colors.END}")
                     
             elif choice == "4":
                 print(f"\n{Colors.YELLOW}--- 事务操作测试 ---{Colors.END}")
                 print(f"{Colors.YELLOW}开始事务...{Colors.END}")
-                with sdk.env.transaction():
-                    sdk.env.set("tx_key1", "value1")
-                    sdk.env.set("tx_key2", "value2")
-                    print(f"{Colors.GREEN}事务中设置的值: tx_key1={sdk.env.get('tx_key1')}{Colors.END}")
+                with sdk.storage.transaction():
+                    sdk.storage.set("tx_key1", "value1")
+                    sdk.storage.set("tx_key2", "value2")
+                    print(f"{Colors.GREEN}事务中设置的值: tx_key1={sdk.storage.get('tx_key1')}{Colors.END}")
                 print(f"{Colors.GREEN}事务提交成功{Colors.END}")
                 
             elif choice == "5":
@@ -128,11 +128,11 @@ async def test_env():
                 try:
                     # 测试创建快照
                     snapshot_name = input(f"{Colors.GREEN}请输入快照名称(默认: test_snapshot): {Colors.END}") or "test_snapshot"
-                    snapshot_path = sdk.env.snapshot(snapshot_name)
+                    snapshot_path = sdk.storage.snapshot(snapshot_name)
                     print(f"{Colors.GREEN}✓ 快照创建成功: {snapshot_path}{Colors.END}")
                     
                     # 测试列出快照
-                    snapshots = sdk.env.list_snapshots()
+                    snapshots = sdk.storage.list_snapshots()
                     print(f"\n{Colors.CYAN}当前可用快照:{Colors.END}")
                     for i, (name, date, size) in enumerate(snapshots, 1):
                         print(f"{i}. {name} - {date.strftime('%Y-%m-%d %H:%M:%S')} ({size/1024:.1f} KB)")
@@ -142,7 +142,7 @@ async def test_env():
                         restore_choice = input(f"\n{Colors.GREEN}是否要测试恢复快照?(y/n): {Colors.END}").lower()
                         if restore_choice == 'y':
                             snap_name = snapshots[0][0]  # 取第一个快照
-                            if sdk.env.restore(snap_name):
+                            if sdk.storage.restore(snap_name):
                                 print(f"{Colors.GREEN}✓ 快照恢复成功: {snap_name}{Colors.END}")
                             else:
                                 print(f"{Colors.RED}✗ 快照恢复失败{Colors.END}")
@@ -357,14 +357,14 @@ async def main():
             if choice == "1":
                 print("\n核心模块列表:")
                 print("- logger: 日志记录系统")
-                print("- env: 环境配置管理")
+                print("- storage: 数据存储系统")
                 print("- exceptions: 异常处理系统")
                 print("- router: 路由管理")
                 print("- adapter: 适配器系统")
             elif choice == "2":
                 await test_logger()
             elif choice == "3":
-                await test_env()
+                await test_storage()
             elif choice == "4":
                 await test_exceptions()
             elif choice == "5":

erispulse-2.2.0.dev0/devs/test_cmd.py

@@ -0,0 +1,124 @@
+import asyncio
+import json
+from ErisPulse import sdk
+from ErisPulse.Core.Event import command
+
+echo_status = False
+
+@command("test", help="测试命令", usage="/test [参数]")
+async def test_command(event):
+    platform = event["platform"]
+    
+    if event.get("detail_type") == "group":
+        type = "group"
+        id = event["group_id"]
+    else:
+        type = "user"
+        id = event["user_id"]
+    
+    adapter = getattr(sdk.adapter, platform)
+    await adapter.Send.To(type, id).Text("收到测试命令")
+    sdk.logger.info(f"处理测试命令: {event}")
+
+@command("help", help="帮助命令", usage="/help")
+async def help_command(event):
+    platform = event["platform"]
+    
+    if event.get("detail_type") == "group":
+        type = "group"
+        id = event["group_id"]
+    else:
+        type = "user"
+        id = event["user_id"]
+
+    adapter = getattr(sdk.adapter, platform)
+    await adapter.Send.To(type, id).Text(command.help())
+
+@command("echo", help="控制事件回显", usage="/echo <on|off>")
+async def echo_control_command(event):
+    platform = event["platform"]
+    
+    if event.get("detail_type") == "group":
+        type = "group"
+        id = event["group_id"]
+    else:
+        type = "user"
+        id = event["user_id"]
+    
+    adapter = getattr(sdk.adapter, platform)
+    
+    # 解析参数
+    alt_message = event["alt_message"].strip()
+    args = alt_message.split()[1:]
+    
+    global echo_status
+    
+    if not args:
+        # 没有参数，显示当前状态
+        status_text = "开启" if echo_status else "关闭"
+        await adapter.Send.To(type, id).Text(f"Echo当前状态: {status_text}")
+        return
+    
+    subcommand = args[0].lower()
+    
+    if subcommand == "on":
+        echo_status = True
+        await adapter.Send.To(type, id).Text("Echo已开启")
+    elif subcommand == "off":
+        echo_status = False
+        await adapter.Send.To(type, id).Text("Echo已关闭")
+    else:
+        await adapter.Send.To(type, id).Text("无效参数，请使用 'on' 或 'off'")
+
+@sdk.adapter.on("message")
+async def echo_message(event):
+    global echo_status
+    platform = event["platform"]
+
+    if echo_status:
+        try:
+            adapter = getattr(sdk.adapter, platform)
+            
+            if event.get("detail_type") == "group":
+                target_type = "group"
+                target_id = event["group_id"]
+            else:
+                target_type = "user"
+                target_id = event["user_id"]
+            
+            event_copy = event.copy()
+            platform_raw_key = f"{platform}_raw"
+            if platform_raw_key in event_copy:
+                del event_copy[platform_raw_key]
+            
+            event_str = json.dumps(event_copy, ensure_ascii=False, indent=2)
+            if len(event_str) > 1000:
+                event_str = event_str[:1000] + "... (内容过长已截断)"
+            
+            await adapter.Send.To(target_type, target_id).Text(f"Event内容:\n{event_str}")
+        except Exception as e:
+            sdk.logger.error(f"Echo回显失败: {e}")
+
+    return event
+
+async def main():
+    try:
+        isInit = await sdk.init_task()
+        
+        if not isInit:
+            sdk.logger.error("ErisPulse 初始化失败，请检查日志")
+            return
+        
+        await sdk.adapter.startup()
+        
+        # 保持程序运行(不建议修改)
+        await asyncio.Event().wait()
+    except Exception as e:
+        sdk.logger.error(e)
+    except KeyboardInterrupt:
+        sdk.logger.info("正在停止程序")
+    finally:
+        await sdk.adapter.shutdown()
+
+if __name__ == "__main__":
+    asyncio.run(main())