ErisPulse 1.1.14.dev1__tar.gz → 1.1.15__tar.gz

{erispulse-1.1.14.dev1 → erispulse-1.1.15}/.github/config/notify.json

@@ -1,7 +1,6 @@
 {
     "emails": [
         "wsu2059@qq.com",
-        "suyu@anran.xyz",
         "dev@oneall.eu.org",
         "yuzi6666@outlook.com",
         "ybrinpds@icloud.com",

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

@@ -0,0 +1,39 @@
+def merge_markdown_files(file_paths, output_file):
+    with open(output_file, 'w', encoding='utf-8') as outfile:
+        # 写入头部说明：介绍每个文件的作用（不包含路径）
+        outfile.write("# ErisPulse 开发文档合集\n\n")
+        outfile.write("本文件由多个开发文档合并而成，用于辅助 AI 理解 ErisPulse 的模块开发规范与 SDK 使用方式。\n\n")
+
+        outfile.write("## 各文件对应内容说明\n\n")
+        outfile.write("| 文件名 | 作用 |\n")
+        outfile.write("|--------|------|\n")
+        outfile.write("| README.md | 项目概览、安装说明和快速入门指南 |\n")
+        outfile.write("| DEVELOPMENT.md | 模块结构定义、入口文件格式、Main 类规范 |\n")
+        outfile.write("| ADAPTERS.md | 平台适配器说明，包括事件监听和消息发送方式 |\n")
+        outfile.write("| REFERENCE.md | SDK 接口调用方式（如 `sdk.env`, `sdk.logger`, `sdk.adapter` 等） |\n\n")
+
+        outfile.write("## 合并内容开始\n\n")
+
+        for file_path in file_paths:
+            filename = file_path.split("/")[-1]
+            with open(file_path, 'r', encoding='utf-8') as infile:
+                content = infile.read()
+                outfile.write(f"<!-- {filename} -->\n\n")
+                outfile.write(content)
+                outfile.write(f"\n\n<!--- End of {filename} -->\n\n")
+
+if __name__ == "__main__":
+    files_to_merge = [
+        "README.md",
+        
+        "docs/DEVELOPMENT.md",
+        
+        "docs/REFERENCE.md",
+
+        "docs/ADAPTERS.md",
+
+        "docs/CLI.md"
+    ]
+    output_file = "docs/ForAIDocs/ErisPulseDevelop.md"
+
+    merge_markdown_files(files_to_merge, output_file)

{erispulse-1.1.14.dev1 → erispulse-1.1.15}/.github/tools/update-api-docs.py

@@ -57,7 +57,7 @@ def update_reference_docs(module_name, docs, reference_path, module_path):
     print(f"Updated docs for {module_name} in REFERENCE.md")
 
 def main():
-    module_dir = Path('ErisPulse')
+    module_dir = Path('src/ErisPulse')
     reference_path = Path('docs/REFERENCE.md')
     
     modules = ['__init__', '__main__', 'adapter', 'db', 'logger', 'mods', 'raiserr', 'util']

{erispulse-1.1.14.dev1 → erispulse-1.1.15}/.gitignore

@@ -1,5 +1,6 @@
 # dev gnore ignore file for Python projects
 env.py
+adapters
 uv.lock
 snapshots/
 config.db*
@@ -196,4 +197,14 @@ cython_debug/
 .cursorindexingignore
 
 # osx
-.DS_Store
+.DS_Store
+
+# pyvenv
+bin
+include
+lib
+pyvenv.cfg
+
+# erispulse
+my_bot
+modules

{erispulse-1.1.14.dev1 → erispulse-1.1.15}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ErisPulse
-Version: 1.1.14.dev1
+Version: 1.1.15
 Summary: ErisPulse 是一个模块化、可扩展的异步 Python SDK 框架，主要用于构建高效、可维护的机器人应用程序。
 Author-email: "艾莉丝·格雷拉特(WSu2059)" <wsu2059@qq.com>, runoneall <runoobsteve@gmail.com>
 License: MIT License

erispulse-1.1.15/docs/ADAPTERS.md

@@ -0,0 +1,125 @@
+# AI 模块生成指南
+
+使用本指南，你可以通过AI快速生成符合ErisPulse规范的模块代码，无需从零开始编写。
+
+## 快速开始
+
+1. **获取开发文档**  
+   下载 `docs/ForAIDocs/ErisPulseDevelop.md` - 它包含了所有AI需要的开发规范、适配器接口和SDK参考。
+
+2. **明确你的需求**  
+   确定模块功能、使用的适配器、依赖关系等核心要素。
+
+3. **向AI描述需求**  
+   使用下面的标准格式清晰地描述你的模块需求。
+
+## 需求描述规范
+
+请按照以下格式描述你的模块需求：
+
+```
+我需要一个用于处理用户指令的模块，名为 CommandProcessor。
+该模块应该能够：
+- 监听 Yunhu 平台的指令事件
+- 当用户发送 "/help" 时，回复帮助信息
+
+请根据 ErisPulse 的模块规范和文档，为我生成完整的模块文件结构和代码
+```
+
+### AI生成代码示例
+
+## 示例：生成一个天气查询模块
+
+### 用户输入需求：
+
+> 我需要一个天气查询模块 WeatherBot，当用户在群聊中发送“/weather 上海”时，机器人会调用 OpenWeatherMap API 查询天气，并返回中文格式的天气信息。  
+> 要求：
+> - 使用 YunhuAdapter 监听指令消息；
+> - 使用 sdk.util.cache 缓存结果；
+> - 模块结构符合 ErisPulse 规范。
+
+并且将刚刚下载的 `ErisPulseDevelop.md` 作为附件发送给 AI。
+
+### AI 输出示例：
+
+```python
+# __init__.py
+moduleInfo = {
+    "meta": {
+        "name": "WeatherBot",
+        "version": "1.0.0",
+        "description": "天气查询模块",
+        "author": "YourName",
+        "license": "MIT"
+    },
+    "dependencies": {
+        "requires": [
+            "YunhuAdapter"
+        ],
+        "optional": [],
+        "pip": ["aiohttp"]
+    }
+}
+
+from .Core import Main
+```
+
+```python
+# Core.py
+import aiohttp
+import time
+
+class Main:
+    def __init__(self, sdk):
+        self.sdk = sdk
+        self.logger = sdk.logger
+        self.env = sdk.env
+        self.util = sdk.util
+
+        @sdk.adapter.Yunhu.on("command")
+        async def handle_weather(data):
+            if data.event.message.commandName.lower() == "weather":
+                city = data.event.message.content.text.strip()
+                chat_type = data.event.chatType
+                sender_type = "group" if chat_type == "group" else "user"
+                sender_id = data.chat.chatId if chat_type == "group" else data.event.sender.senderId
+
+                if not city:
+                    await self.sdk.adapter.Yunhu.Send.To(sender_type, sender_id).Text("请指定城市名称，例如：/weather 上海")
+                    return
+                await self.reply_weather(sender_type, sender_id, city)
+
+    @sdk.util.cache
+    async def get_weather_data(self, city: str):
+        api_key = self.env.get("WEATHER_API_KEY")
+        url = f"http://api.openweathermap.org/data/2.5/weather?q={city}&appid={api_key}"
+        async with aiohttp.ClientSession() as session:
+            async with session.get(url) as resp:
+                if resp.status == 200:
+                    return await resp.json()
+                else:
+                    raise Exception("无法获取天气信息")
+
+    async def reply_weather(self, sender_type, sender_id, city):
+        try:
+            data = await self.get_weather_data(city)
+            temperature = data["main"]["temp"] - 273.15
+            await self.sdk.adapter.Yunhu.Send.To(sender_type, sender_id).Text(f"{city} 的温度是 {temperature:.1f}℃")
+        except Exception as e:
+            self.logger.error(f"获取天气失败: {e}")
+            await self.sdk.adapter.Yunhu.Send.To(sender_type, sender_id).Text(f"获取天气失败，请稍后再试。")
+```
+
+## 常见问题
+
+Q: 如何测试生成的模块？  
+A: 将生成的代码放入ErisPulse项目(初始化过的你自己的项目内会有这个文件夹)的modules目录，重启服务即可加载测试。
+
+Q: 生成的代码不符合我的需求怎么办？  
+A: 可以调整需求描述后重新生成，或直接在生成代码基础上进行修改。
+
+Q: 需要更复杂的功能怎么办？  
+A: 可以将复杂功能拆分为多个简单模块，或分阶段实现。
+
+Q: 我可以把这个模块发布到ErisPulse吗？
+A: 当然可以！但是我们会审查你的代码，确保它符合我们的规范。

erispulse-1.1.15/docs/AI-Module-Generation.md

@@ -0,0 +1,125 @@
+# AI 模块生成指南
+
+使用本指南，你可以通过AI快速生成符合ErisPulse规范的模块代码，无需从零开始编写。
+
+## 快速开始
+
+1. **获取开发文档**  
+   下载 `docs/ForAIDocs/ErisPulseDevelop.md` - 它包含了所有AI需要的开发规范、适配器接口和SDK参考。
+
+2. **明确你的需求**  
+   确定模块功能、使用的适配器、依赖关系等核心要素。
+
+3. **向AI描述需求**  
+   使用下面的标准格式清晰地描述你的模块需求。
+
+## 需求描述规范
+
+请按照以下格式描述你的模块需求：
+
+```
+我需要一个用于处理用户指令的模块，名为 CommandProcessor。
+该模块应该能够：
+- 监听 Yunhu 平台的指令事件
+- 当用户发送 "/help" 时，回复帮助信息
+
+请根据 ErisPulse 的模块规范和文档，为我生成完整的模块文件结构和代码
+```
+
+### AI生成代码示例
+
+## 示例：生成一个天气查询模块
+
+### 用户输入需求：
+
+> 我需要一个天气查询模块 WeatherBot，当用户在群聊中发送“/weather 上海”时，机器人会调用 OpenWeatherMap API 查询天气，并返回中文格式的天气信息。  
+> 要求：
+> - 使用 YunhuAdapter 监听指令消息；
+> - 使用 sdk.util.cache 缓存结果；
+> - 模块结构符合 ErisPulse 规范。
+
+并且将刚刚下载的 `ErisPulseDevelop.md` 作为附件发送给 AI。
+
+### AI 输出示例：
+
+```python
+# __init__.py
+moduleInfo = {
+    "meta": {
+        "name": "WeatherBot",
+        "version": "1.0.0",
+        "description": "天气查询模块",
+        "author": "YourName",
+        "license": "MIT"
+    },
+    "dependencies": {
+        "requires": [
+            "YunhuAdapter"
+        ],
+        "optional": [],
+        "pip": ["aiohttp"]
+    }
+}
+
+from .Core import Main
+```
+
+```python
+# Core.py
+import aiohttp
+import time
+
+class Main:
+    def __init__(self, sdk):
+        self.sdk = sdk
+        self.logger = sdk.logger
+        self.env = sdk.env
+        self.util = sdk.util
+
+        @sdk.adapter.Yunhu.on("command")
+        async def handle_weather(data):
+            if data.event.message.commandName.lower() == "weather":
+                city = data.event.message.content.text.strip()
+                chat_type = data.event.chatType
+                sender_type = "group" if chat_type == "group" else "user"
+                sender_id = data.chat.chatId if chat_type == "group" else data.event.sender.senderId
+
+                if not city:
+                    await self.sdk.adapter.Yunhu.Send.To(sender_type, sender_id).Text("请指定城市名称，例如：/weather 上海")
+                    return
+                await self.reply_weather(sender_type, sender_id, city)
+
+    @sdk.util.cache
+    async def get_weather_data(self, city: str):
+        api_key = self.env.get("WEATHER_API_KEY")
+        url = f"http://api.openweathermap.org/data/2.5/weather?q={city}&appid={api_key}"
+        async with aiohttp.ClientSession() as session:
+            async with session.get(url) as resp:
+                if resp.status == 200:
+                    return await resp.json()
+                else:
+                    raise Exception("无法获取天气信息")
+
+    async def reply_weather(self, sender_type, sender_id, city):
+        try:
+            data = await self.get_weather_data(city)
+            temperature = data["main"]["temp"] - 273.15
+            await self.sdk.adapter.Yunhu.Send.To(sender_type, sender_id).Text(f"{city} 的温度是 {temperature:.1f}℃")
+        except Exception as e:
+            self.logger.error(f"获取天气失败: {e}")
+            await self.sdk.adapter.Yunhu.Send.To(sender_type, sender_id).Text(f"获取天气失败，请稍后再试。")
+```
+
+## 常见问题
+
+Q: 如何测试生成的模块？  
+A: 将生成的代码放入ErisPulse项目(初始化过的你自己的项目内会有这个文件夹)的modules目录，重启服务即可加载测试。
+
+Q: 生成的代码不符合我的需求怎么办？  
+A: 可以调整需求描述后重新生成，或直接在生成代码基础上进行修改。
+
+Q: 需要更复杂的功能怎么办？  
+A: 可以将复杂功能拆分为多个简单模块，或分阶段实现。
+
+Q: 我可以把这个模块发布到ErisPulse吗？
+A: 当然可以！但是我们会审查你的代码，确保它符合我们的规范。

{erispulse-1.1.14.dev1 → erispulse-1.1.15}/docs/CHANGELOG.md

@@ -8,11 +8,21 @@
 > **贡献日志**
 > 如需为新版本添加日志，请在对应版本号下补充内容，并注明日期和主要贡献者。
 
+## [1.1.15]
+> 此版本为回滚版本,版本基于1.1.14.dev1:re | 为了修复多项目带来的严重问题，建议升级前先备份数据
+### 新增
+- 拓展CLI:install命令，现在可以指定本地目录直接安装模块
+
+### 修复
+- 修复多项目下模块初始化时可能出现的错误(回滚为单模块项目)
+
 ---
-## [1.1.14.dev1]
+## [1.1.14.dev1:re]
 > 此版本为开发版本，不保证兼容性，仅用于测试和开发
 
 > dev1 的改动为sdk初始化功能优化 | 修复上个版本留下的bug
+### 新增
+- 添加新的 ForAIDocs 项目文档
 
 ### 修复
 - 修复自动快照初始化时`_last_snapshot_time`和`_snapshot_interval`可能为None的问题

{erispulse-1.1.14.dev1 → erispulse-1.1.15}/docs/CLI.md

@@ -12,7 +12,7 @@
 | `list`     | `[--module=<name>] [--init]` | 列出模块（可筛选）                   | `epsdk list --module=payment`       |
 | `update`   | -                         | 更新模块索引                           | `epsdk update`                      |
 | `upgrade`  | `[--force] [--init]`      | 升级模块（`--force` 强制覆盖）        | `epsdk upgrade --force --init`      |
-| `install`  | `<module...> [--init]`    | 安装一个或多个模块（空格分隔）        | `epsdk install YunhuAdapter OpenAI` |
+| `install`  | `<module...> [--init]`    | 安装一个或多个模块（空格分隔），支持本地目录路径 | `epsdk install YunhuAdapter OpenAI`<br>`epsdk install .`<br>`epsdk install /path/to/module` |
 | `uninstall`| `<module> [--init]`       | 移除指定模块                          | `epsdk uninstall old-module --init` |
 
 ## 源管理
@@ -46,4 +46,4 @@ epsdk run main.py --reload
 ---
 
 ## 反馈与支持
-如遇到 CLI 使用问题，请在 GitHub Issues 提交反馈。
+如遇到 CLI 使用问题，请在 GitHub Issues 提交反馈。

{erispulse-1.1.14.dev1 → erispulse-1.1.15}/docs/DEVELOPMENT.md

@@ -279,7 +279,7 @@ class Main:
         #   在 MyPlatformAdapter 中的方法可以使用 sdk.adapter.<适配器注册名>.<方法名> 访问
 
 class MyPlatformAdapter(sdk.BaseAdapter):
-    class Send(sdk.BaseAdapter.Send):  # 继承BaseAdapter内置的Send类
+    class Send(super().Send):  # 继承BaseAdapter内置的Send类
         # 底层SendDSL中提供了To方法，用户调用的时候类会被定义 `self._target_type` 和 `self._target_id`/`self._target_to` 三个属性
         # 当你只需要一个接受的To时，例如 mail 的To只是一个邮箱，那么你可以使用 `self.To(email)`，这时只会有 `self._target_id`/`self._target_to` 两个属性被定义
         # 或者说你不需要用户的To，那么用户也可以直接使用 Send.Func(text) 的方式直接调用这里的方法
@@ -343,7 +343,7 @@ class MyPlatformAdapter(sdk.BaseAdapter):
 
 > ⚠️ 注意：
 > - 适配器类必须继承 `sdk.BaseAdapter`；
-> - 必须实现 `call_api`, `start`, `shutdown` 方法 和 `Send`类并继承自 `sdk.BaseAdapter.Send`；
+> - 必须实现 `call_api`, `start`, `shutdown` 方法 和 `Send`类并继承自 `super().Send`；
 > - 推荐实现 `.Text(...)` 方法作为基础消息发送接口。
 
 ## 4. DSL 风格消息接口（SendDSL）
@@ -351,7 +351,7 @@ class MyPlatformAdapter(sdk.BaseAdapter):
 每个适配器可定义一组链式调用风格的方法，例如：
 
 ```python
-class Send(sdk.BaseAdapter.Send):
+class Send(super().Send):
     def Text(self, text: str):
         return asyncio.create_task(
             self._adapter.call_api(...)