ErisPulse 2.2.0.dev1__tar.gz → 2.2.1__tar.gz

{erispulse-2.2.0.dev1 → erispulse-2.2.1}/.github/tools/merge_md.py

@@ -92,7 +92,6 @@ def merge_api_docs(api_dir, output_file):
             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:])
@@ -110,12 +109,16 @@ def generate_full_document():
     # 要合并的文件
     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": "事件转换标准"},
+        {"path": "docs/platform-features.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": "最佳实践"},
+        {"path": "docs/development/module.md", "description": "模块开发指南"},
+        {"path": "docs/development/adapter.md", "description": "适配器开发指南"},
+        {"path": "docs/standards/api-response.md", "description": "API响应标准"},
+        {"path": "docs/standards/event-conversion.md", "description": "事件转换标准"},
     ]
     
     # 过滤不存在的文件
@@ -123,7 +126,7 @@ def generate_full_document():
     if len(existing_files) != len(files_to_merge):
         print(f"警告: {len(files_to_merge) - len(existing_files)} 个文件不存在，已跳过")
     
-    output_file = "docs/AIDocs/ErisPulse-Full.md"
+    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, "完整开发文档")
@@ -131,65 +134,51 @@ def generate_full_document():
     
     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": "模块开发指南"}
+        {"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/platform-features.md", "description": "平台功能说明"},
+        {"path": "docs/standards/event-conversion.md", "description": "标准事件的定义"},
+        {"path": "docs/standards/api-response.md", "description": "api响应的格式" },
     ]
     
     # 过滤不存在的文件
     existing_module_files = [f for f in module_files if os.path.exists(f['path'])]
     
-    module_output = "docs/AIDocs/ErisPulse-ModuleDev.md"
+    module_output = "docs/ai/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 = [
+    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": "事件转换标准"},
+        {"path": "docs/platform-features.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": "最佳实践"},
+        {"path": "docs/development/module.md", "description": "模块开发指南"},
+        {"path": "docs/development/adapter.md", "description": "适配器开发指南"},
+        {"path": "docs/standards/api-response.md", "description": "API响应标准"},
+        {"path": "docs/standards/event-conversion.md", "description": "事件转换标准"},
     ]
     
     # 过滤不存在的文件
     existing_adapter_files = [f for f in adapter_files if os.path.exists(f['path'])]
     
-    adapter_output = "docs/AIDocs/ErisPulse-AdapterDev.md"
+    adapter_output = "docs/ai/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}")
@@ -219,7 +208,6 @@ def generate_custom_document(title, files, api_dirs, output_path):
 if __name__ == "__main__":
     try:
         generate_full_document()
-        generate_core_document()
         generate_dev_documents()
         print("所有文档生成完成")
     except Exception as e:

{erispulse-2.2.0.dev1 → erispulse-2.2.1}/.github/tools/update-api-docs.py

@@ -117,11 +117,9 @@ def parse_python_file(file_path: str) -> Tuple[Optional[str], List[Dict], List[D
         # 处理类定义
         if isinstance(node, ast.ClassDef):
             class_doc = ast.get_docstring(node)
-            processed_class_doc = process_docstring(class_doc) if class_doc else None
+            processed_class_doc = process_docstring(class_doc) if class_doc else ""
             
-            if processed_class_doc is None:
-                continue
-                
+            # 不管类有没有文档，都要处理其中的方法
             methods = []
             # 提取类方法
             for item in node.body:
@@ -129,7 +127,7 @@ def parse_python_file(file_path: str) -> Tuple[Optional[str], List[Dict], List[D
                     method_doc = ast.get_docstring(item)
                     processed_method_doc = process_docstring(method_doc) if method_doc else None
                     
-                    if processed_method_doc:
+                    if processed_method_doc:  # 只有方法有文档才添加
                         # 获取函数签名
                         args = []
                         defaults = dict(zip([arg.arg for arg in item.args.args][-len(item.args.defaults):], item.args.defaults)) if item.args.defaults else {}
@@ -159,12 +157,14 @@ def parse_python_file(file_path: str) -> Tuple[Optional[str], List[Dict], List[D
             bases = [ast.unparse(base) for base in node.bases] if node.bases else []
             class_signature = f"class {node.name}({', '.join(bases)})" if bases else f"class {node.name}"
             
-            classes.append({
-                "name": node.name,
-                "signature": class_signature,
-                "doc": processed_class_doc,
-                "methods": methods
-            })
+            # 只有类有文档或者有方法时才添加类
+            if processed_class_doc or methods:
+                classes.append({
+                    "name": node.name,
+                    "signature": class_signature,
+                    "doc": processed_class_doc,
+                    "methods": methods
+                })
         
         # 处理函数定义
         elif isinstance(node, (ast.FunctionDef, ast.AsyncFunctionDef)):
@@ -243,11 +243,13 @@ def generate_markdown(module_path: str, module_doc: Optional[str],
     if classes:
         content.append("## 类列表\n")
         for cls in classes:
+            # 如果类没有文档，显示默认信息
+            class_doc = cls['doc'] if cls['doc'] else f"{cls['name']} 类提供相关功能。"
             content.append(f"""### `{cls['signature']}`
 
-{cls['doc']}
+    {class_doc}
 
-""")
+    """)
             
             # 类方法
             if cls["methods"]:
@@ -256,10 +258,10 @@ def generate_markdown(module_path: str, module_doc: Optional[str],
                     async_marker = "async " if method["is_async"] else ""
                     content.append(f"""##### {async_marker}`{method['signature']}`
 
-{method['doc']}
+    {method['doc']}
 
----
-""")
+    ---
+    """)
     
     # 文档尾部
     content.append(f"<sub>文档最后更新于 {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}</sub>")

{erispulse-2.2.0.dev1 → erispulse-2.2.1}/.github/workflows/auto-tag-release.yml

@@ -5,7 +5,7 @@ permissions:
 
 on:
   push:
-    branches: [main]
+    branches: [main, Pre-Release/v2]
 
 jobs:
   auto-tag-and-release:
@@ -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"
@@ -126,4 +114,4 @@ jobs:
               --prerelease=$is_dev
             echo "✨ 已发布新的魔法版本 $tag_name"
           fi
-          
+          

{erispulse-2.2.0.dev1/docs → erispulse-2.2.1}/CHANGELOG.md

@@ -3,13 +3,103 @@
 所有版本更新遵循 [语义化版本控制](https://semver.org/lang/zh-CN/) 规范。
 
 > **如何阅读本日志**
-> 每个版本分为“新增”、“变更”、“修复” 等部分。建议开发者在升级前先阅读对应版本的 Breaking Change 和修复内容。
+> 每个版本分为 "新增"/"变更"/"修复"/"移除"/"废弃" 等部分。建议开发者在升级前先阅读对应版本的 Breaking Change 和修复内容。
 
 > **贡献日志**
 > 如需为新版本添加日志，请在对应版本号下补充内容，并注明日期和主要贡献者。
 
 ---
 
+## 规则
+
+### 必须包含的信息
+1. **贡献者信息**：每项变更必须标明贡献者，格式为 `@Github用户名`
+2. **变更类型**：明确标识变更类型（新增/变更/修复/移除/废弃等）
+3. **日期信息**：版本发布日期采用 `YYYY/MM/DD` 格式
+
+### 示例格式
+
+```markdown
+## [version] - 2025/08/20
+> 开发版本
+
+### 新增
+
+- By [贡献者](https://github.com/贡献者)
+  - `模块名` 模块新增功能描述：
+    - 具体功能点1
+    - 具体功能点2
+```
+
+---
+
+## [2.2.1] - 2025/08/19
+
+> 正式发布
+
+---
+
+## [2.2.1-dev.0] - 2025/08/18
+
+### 新增
+
+- @wsu2059q
+  - `Event.command` 模块新增交互式命令支持：
+    - 添加 `wait_reply` 方法，支持命令处理器等待用户回复并进行交互
+    - 支持设置提示消息、超时时间、验证函数和回调函数
+    - 提供优雅的多轮对话命令实现机制
+  - `Event` 模块增强事件处理器管理功能：
+    - 为所有事件子模块（command、message、notice、request、meta）每种装饰器添加对应的处理器注销方法
+    - 支持通过装饰器注册的事件处理器可以被取消注册
+
+### 变更
+- @wsu2059q
+  - 重构 `Event` 模块内部实现：
+    - 优化事件处理器的存储和查找机制，提高效率
+  - 遵循 ErisPulse 注释风格规范，完善所有事件处理模块的注释
+
+### 修复
+- @wsu2059q
+  - 修复命令处理器注销时未能清理相关配置的缺陷
+  - 修复 `wait_reply` 功能在并发情况下的潜在竞争条件问题
+  - 修复事件处理器重复注册导致事件被多次处理的问题：
+    - 优化 `BaseEventHandler` 类，确保每个事件类型只向适配器注册一次处理器
+    - 防止使用多个 `@message` 等装饰器时事件被重复触发多次的问题
+    - 提高事件处理效率，避免不必要的重复处理
+
+---
+
+## [2.2.0] - 2025/08/18
+
+> 正式发布
+
+---
+
+## [2.2.0-dev.2] - 2025/08/18
+
+### 新增
+- 添加 `Event` 模块更多功能：
+  - 命令支持权限检查功能，可通过 `permission` 参数设置权限检查函数
+  - 命令支持隐藏功能，可通过 `hidden` 参数控制命令在帮助中是否显示
+  - 命令支持更灵活的别名配置，可通过 `aliases` 参数设置额外别名
+  - 命令帮助系统增强，支持显示隐藏命令选项
+  - 添加命令执行错误和权限拒绝的自动消息反馈机制
+- `Event` 模块配置增强：
+  - 添加 `allow_space_prefix` 配置项，支持 "/ command" 格式的命令
+
+### 变更
+- 重构 `Event` 模块设计：
+  - 移除 `event_manager` 模块，避免与 `adapter` 模块功能重复
+  - 简化中间件系统，移除全局和局部中间件以避免复杂性
+  - 用户应通过 `adapter` 模块进行事件的发送和接收
+- 优化 `Event` 模块注释和文档，遵循 ErisPulse 注释风格规范
+
+### 修复
+- 修复命令处理中的一些潜在错误处理问题
+- 修复命令别名处理逻辑中的边界情况
+
+---
+
 ## [2.2.0-dev.1] - 2025/08/17
 
 ### 新增

erispulse-2.2.1/CONTRIBUTING.md

@@ -0,0 +1,107 @@
+# 项目贡献指南
+
+## 分支管理规范
+
+### 分支结构
+- **main**: 主分支，存放稳定可发布的代码
+- **Develop/v2**: 开发主分支，所有功能分支最终合并至此
+- **Pre-Release/v2**: 预发布分支，用于版本发布前的测试
+- **feature/***: 功能开发分支，按功能命名
+- **Archive/v1**: 归档分支，存放旧版本代码
+
+## 代码注释规范
+
+### 模块级文档注释
+```python
+"""
+[模块名称]
+[模块功能描述]
+
+{!--< tips >!--}
+重要使用说明或注意事项
+{!--< /tips >!--}
+"""
+```
+
+### 方法注释
+#### 基本格式
+```python
+def func(param1: type1, param2: type2) -> return_type:
+    """
+    [功能描述]
+    
+    :param param1: [类型1] [参数描述1]
+    :param param2: [类型2] [参数描述2]
+    :return: [返回类型] [返回描述]
+    """
+    pass
+```
+
+#### 完整格式（适用于复杂方法）
+```python
+def complex_func(param1: type1, param2: type2 = None) -> Tuple[type1, type2]:
+    """
+    [功能详细描述]
+    [可包含多行描述]
+    
+    :param param1: [类型1] [参数描述1]
+    :param param2: [类型2] [可选参数描述2] (默认: None)
+    
+    :return: 
+        type1: [返回参数1描述]
+        type2: [返回参数2描述]
+    
+    :raises ErrorType: [错误描述]
+    """
+    pass
+```
+
+### 特殊标签
+| 标签格式 | 作用 | 示例 |
+|---------|------|------|
+| `{!--< internal-use >!--}` | 标记为内部使用 | `{!--< internal-use >!--}` |
+| `{!--< ignore >!--}` | 忽略此方法 | `{!--< ignore >!--}` |
+| `{!--< deprecated >!--}` | 标记为过时方法 | `{!--< deprecated >!--} 请使用new_func()代替` |
+| `{!--< experimental >!--}` | 标记为实验性功能 | `{!--< experimental >!--} 可能不稳定` |
+| `{!--< tips >!--}...{!--< /tips >!--}` | 多行提示内容 | `{!--< tips >!--}\n重要提示内容\n{!--< /tips >!--}` |
+
+## 贡献流程
+
+1. **Fork仓库**
+   - 首先fork主仓库到您的个人账户
+
+2. **创建个人分支**
+   - 从`Develop/v2`创建功能分支，命名规范：
+     - `feature/描述性名称` (如`feature/wsu2059q`)
+
+3. **开发工作**
+   - 在功能分支上进行开发
+   - 保持提交信息清晰明确
+   - 按照注释规范添加文档注释
+   - 提交前确保已经在ChangeLog中添加描述
+   - 定期从`Develop/v2`拉取更新
+
+4. **提交Pull Request**
+   - 开发完成后，向`Develop/v2`提交PR
+   - 在PR模板中勾选对应选项或添加详情信息
+
+5. **代码审查**
+   - 确保代码符合注释规范
+   - 检查特殊标签使用是否正确
+
+6. **合并到Develop/v2**
+   - 审查通过后，代码将被合并
+
+7. **发布流程**
+   - `Develop/v2` → `Pre-Release/v2` 进行测试
+   - 测试通过后发布到`main`分支
+
+## 注意事项
+
+- 请勿直接向`main`或`Pre-Release/v2`分支提交代码
+- 所有公开API方法必须包含完整注释
+- 内部方法应添加`{!--< internal-use >!--}`标签
+- 过时方法需标记并提供替代方案
+- 如有疑问，请联系 `support@erisdev.com` 或 云湖群ID 635409929
+
+感谢您的贡献！

{erispulse-2.2.0.dev1 → erispulse-2.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ErisPulse
-Version: 2.2.0.dev1
+Version: 2.2.1
 Summary: ErisPulse 是一个模块化、可扩展的异步 Python SDK 框架，主要用于构建高效、可维护的机器人应用程序。
 Author-email: "艾莉丝·格雷拉特(WSu2059)" <wsu2059@qq.com>
 License: MIT License
@@ -52,7 +52,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.8
+Requires-Python: >=3.10
 Requires-Dist: aiohttp
 Requires-Dist: colorama
 Requires-Dist: fastapi>=0.116.1
@@ -71,43 +71,31 @@ Description-Content-Type: text/markdown
 
 ![ErisPulse Logo](.github/assets/erispulse_logo.png)
 
-[![FramerOrg](https://img.shields.io/badge/合作伙伴-FramerOrg-blue?style=flat-square)](https://github.com/FramerOrg)
+[![PyPI](https://img.shields.io/pypi/v/ErisPulse?style=flat-square)](https://pypi.org/project/ErisPulse/)
 [![Python Versions](https://img.shields.io/pypi/pyversions/ErisPulse?style=flat-square)](https://pypi.org/project/ErisPulse/)
+[![Socket Badge](https://socket.dev/api/badge/pypi/package/ErisPulse/latest)](https://socket.dev/pypi/package/ErisPulse)
 
-## 文档站
+## 文档资源
 
-[![Docs-Main](https://img.shields.io/badge/docs-main_site-blue?style=flat-square)](https://www.erisdev.com/#docs)
-[![Docs-CF Pages](https://img.shields.io/badge/docs-cloudflare-blue?style=flat-square)](https://erispulse.pages.dev/#docs)
-[![Docs-GitHub](https://img.shields.io/badge/docs-github-blue?style=flat-square)](https://erispulse.github.io/#docs)
-[![Docs-Netlify](https://img.shields.io/badge/docs-netlify-blue?style=flat-square)](https://erispulse.netlify.app/#docs)
-
-## 模块市场
-
-[![Market-Main](https://img.shields.io/badge/market-erisdev-blue?style=flat-square)](https://www.erisdev.com/#market)
-[![Market-CF Pages](https://img.shields.io/badge/market-cloudflare-blue?style=flat-square)](https://erispulse.pages.dev/#market)
-[![Market-GitHub](https://img.shields.io/badge/market-github-blue?style=flat-square)](https://erispulse.github.io/#market)
-[![Market-Netlify](https://img.shields.io/badge/market-netlify-blue?style=flat-square)](https://erispulse.netlify.app/#market)
-
----
+| 平台 | 主站点 | 备用站点 |
+|------|--------|---------|
+| 文档 | [erisdev.com](https://www.erisdev.com/#docs) | [Cloudflare](https://erispulse.pages.dev/#docs) • [GitHub](https://erispulse.github.io/#docs) • [Netlify](https://erispulse.netlify.app/#docs) |
+| 模块市场 | [erisdev.com](https://www.erisdev.com/#market) | [Cloudflare](https://erispulse.pages.dev/#market) • [GitHub](https://erispulse.github.io/#market) • [Netlify](https://erispulse.netlify.app/#market) |
 
 ## 核心特性
 
 | 特性 | 描述 |
 |:-----|:-----|
-| **异步架构** | 完全基于 async/await 的异步设计 |
-| **模块化系统** | 灵活的插件和模块管理 |
-| **热重载** | 开发时自动重载，无需重启 |
-| **错误管理** | 统一的错误处理和报告系统 |
-| **配置管理** | 灵活的配置存储和访问 |
-
----
+| 异步架构 | 完全基于 async/await 的异步设计 |
+| 模块化系统 | 灵活的插件和模块管理 |
+| 热重载 | 开发时自动重载，无需重启 |
+| 错误管理 | 统一的错误处理和报告系统 |
+| 配置管理 | 灵活的配置存储和访问 |
 
 ## 快速开始
 
 ### 一键安装脚本
 
-我们提供了一键安装脚本，支持所有主流平台：
-
 #### Windows (PowerShell):
 
 ```powershell
@@ -120,30 +108,30 @@ irm https://get.erisdev.com/install.ps1 -OutFile install.ps1; powershell -Execut
 curl -sSL https://get.erisdev.com/install.sh | tee install.sh >/dev/null && chmod +x install.sh && ./install.sh
 ```
 
----
+## 开发与测试
 
-## 测试与开发
-
-### 1. 克隆项目并进入目录
+### 1. 克隆项目
 
 ```bash
 git clone -b Develop/v2 https://github.com/ErisPulse/ErisPulse.git
 cd ErisPulse
 ```
 
-### 2. 使用 `uv` 同步项目环境
+### 2. 环境搭建
+
+使用 uv 同步项目环境:
 
 ```bash
 uv sync
 
-# 启动虚拟环境
-source .venv/bin/activate   
+# 激活虚拟环境
+source .venv/bin/activate   # macOS/Linux
 # Windows: .venv\Scripts\activate
 ```
 
-> `ErisPulse` 目前正在使用 `python3.13` 进行开发(所以您同步环境时会自动安装 `3.13`)，但也可以使用其他版本(版本不应低于 `3.10`)。
+说明: ErisPulse 使用 Python 3.13 开发，但兼容 Python 3.10+
 
-### 3. 安装依赖并开始
+### 3. 安装依赖
 
 ```bash
 uv pip install -e .
@@ -161,7 +149,7 @@ python -c "from ErisPulse import sdk; sdk.init()"
 
 ### 5. 运行测试
 
-我们提供了一个交互式测试脚本，可以帮助您快速验证SDK功能：
+我们提供了一个交互式测试脚本，可以帮助您快速验证SDK功能(于开发中)：
 
 ```bash
 uv run devs/test.py
@@ -174,34 +162,25 @@ uv run devs/test.py
 - 工具函数测试
 - 适配器功能测试
 
-### 6. 开发模式 (热重载)
-
-```bash
-epsdk run your_script.py --reload
-```
-
----
-
 ## 贡献指南
 
 我们欢迎各种形式的贡献，包括但不限于:
 
-1. **报告问题**  
+1. 报告问题  
    在 [GitHub Issues](https://github.com/ErisPulse/ErisPulse/issues) 提交bug报告
 
-2. **功能请求**  
+2. 功能请求  
    通过 [社区讨论](https://github.com/ErisPulse/ErisPulse/discussions) 提出新想法
 
-3. **代码贡献**  
-   提交 Pull Request 前请阅读我们的 [代码风格](docs/StyleGuide/DocstringSpec.md)
+3. 代码贡献  
+   提交 Pull Request 前请阅读我们的 [代码风格](docs/StyleGuide/DocstringSpec.md) 以及 [贡献指南](CONTRIBUTING.md)
 
-4. **文档改进**  
+4. 文档改进  
    帮助完善文档和示例代码
 
----
-
-[加入社区讨论 →](https://github.com/ErisPulse/ErisPulse/discussions)
+[加入社区讨论](https://github.com/ErisPulse/ErisPulse/discussions)
 
 ---
 
 [![](https://starchart.cc/ErisPulse/ErisPulse.svg?variant=adaptive)](https://starchart.cc/ErisPulse/ErisPulse)
+