ErisPulse 2.1.7__tar.gz → 2.1.7.post1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (75) hide show
  1. {erispulse-2.1.7 → erispulse-2.1.7.post1}/PKG-INFO +1 -1
  2. {erispulse-2.1.7 → erispulse-2.1.7.post1}/docs/AIDocs/ErisPulse-AdapterDev.md +18 -18
  3. {erispulse-2.1.7 → erispulse-2.1.7.post1}/docs/AIDocs/ErisPulse-Core.md +18 -49
  4. {erispulse-2.1.7 → erispulse-2.1.7.post1}/docs/AIDocs/ErisPulse-Full.md +22 -53
  5. {erispulse-2.1.7 → erispulse-2.1.7.post1}/docs/AIDocs/ErisPulse-ModuleDev.md +18 -48
  6. {erispulse-2.1.7 → erispulse-2.1.7.post1}/docs/CHANGELOG.md +1 -0
  7. {erispulse-2.1.7 → erispulse-2.1.7.post1}/docs/Development/CLI.md +1 -1
  8. {erispulse-2.1.7 → erispulse-2.1.7.post1}/docs/PlatformFeatures.md +0 -30
  9. {erispulse-2.1.7 → erispulse-2.1.7.post1}/docs/api/ErisPulse/Core/adapter.md +2 -2
  10. {erispulse-2.1.7 → erispulse-2.1.7.post1}/docs/api/ErisPulse/Core/env.md +2 -2
  11. {erispulse-2.1.7 → erispulse-2.1.7.post1}/docs/api/ErisPulse/Core/logger.md +2 -2
  12. {erispulse-2.1.7 → erispulse-2.1.7.post1}/docs/api/ErisPulse/Core/mods.md +2 -2
  13. {erispulse-2.1.7 → erispulse-2.1.7.post1}/docs/api/ErisPulse/Core/raiserr.md +2 -2
  14. {erispulse-2.1.7 → erispulse-2.1.7.post1}/docs/api/ErisPulse/Core/server.md +2 -2
  15. {erispulse-2.1.7 → erispulse-2.1.7.post1}/docs/api/ErisPulse/Core/util.md +2 -2
  16. {erispulse-2.1.7 → erispulse-2.1.7.post1}/docs/api/ErisPulse/__init__.md +2 -2
  17. {erispulse-2.1.7 → erispulse-2.1.7.post1}/docs/api/ErisPulse/__main__.md +2 -2
  18. {erispulse-2.1.7 → erispulse-2.1.7.post1}/docs/quick-start.md +5 -6
  19. {erispulse-2.1.7 → erispulse-2.1.7.post1}/examples/example-cli-module/pyproject.toml +1 -1
  20. {erispulse-2.1.7 → erispulse-2.1.7.post1}/pyproject.toml +1 -1
  21. {erispulse-2.1.7 → erispulse-2.1.7.post1}/src/ErisPulse/Core/raiserr.py +7 -2
  22. {erispulse-2.1.7 → erispulse-2.1.7.post1}/.github/assets/erispulse_logo.png +0 -0
  23. {erispulse-2.1.7 → erispulse-2.1.7.post1}/.github/tools/merge_md.py +0 -0
  24. {erispulse-2.1.7 → erispulse-2.1.7.post1}/.github/tools/update-api-docs.py +0 -0
  25. {erispulse-2.1.7 → erispulse-2.1.7.post1}/.github/workflows/auto-tag-release.yml +0 -0
  26. {erispulse-2.1.7 → erispulse-2.1.7.post1}/.github/workflows/pypi-publish.yml +0 -0
  27. {erispulse-2.1.7 → erispulse-2.1.7.post1}/.gitignore +0 -0
  28. {erispulse-2.1.7 → erispulse-2.1.7.post1}/.python-version +0 -0
  29. {erispulse-2.1.7 → erispulse-2.1.7.post1}/CODE_OF_CONDUCT.md +0 -0
  30. {erispulse-2.1.7 → erispulse-2.1.7.post1}/LICENSE +0 -0
  31. {erispulse-2.1.7 → erispulse-2.1.7.post1}/README.md +0 -0
  32. {erispulse-2.1.7 → erispulse-2.1.7.post1}/devs/test.py +0 -0
  33. {erispulse-2.1.7 → erispulse-2.1.7.post1}/devs/test_adapter.py +0 -0
  34. {erispulse-2.1.7 → erispulse-2.1.7.post1}/devs/test_files/test.docx +0 -0
  35. {erispulse-2.1.7 → erispulse-2.1.7.post1}/devs/test_files/test.jpg +0 -0
  36. {erispulse-2.1.7 → erispulse-2.1.7.post1}/devs/test_files/test.mp4 +0 -0
  37. {erispulse-2.1.7 → erispulse-2.1.7.post1}/docs/AIDocs/README.md +0 -0
  38. {erispulse-2.1.7 → erispulse-2.1.7.post1}/docs/AIModuleGeneration.md +0 -0
  39. {erispulse-2.1.7 → erispulse-2.1.7.post1}/docs/AdapterStandards/APIResponse.md +0 -0
  40. {erispulse-2.1.7 → erispulse-2.1.7.post1}/docs/AdapterStandards/EventConversion.md +0 -0
  41. {erispulse-2.1.7 → erispulse-2.1.7.post1}/docs/AdapterStandards/README.md +0 -0
  42. {erispulse-2.1.7 → erispulse-2.1.7.post1}/docs/CHANGELOG_1.x.md +0 -0
  43. {erispulse-2.1.7 → erispulse-2.1.7.post1}/docs/CLI.md +0 -0
  44. {erispulse-2.1.7 → erispulse-2.1.7.post1}/docs/Development/Adapter.md +0 -0
  45. {erispulse-2.1.7 → erispulse-2.1.7.post1}/docs/Development/Module.md +0 -0
  46. {erispulse-2.1.7 → erispulse-2.1.7.post1}/docs/Development/README.md +0 -0
  47. {erispulse-2.1.7 → erispulse-2.1.7.post1}/docs/UseCore.md +0 -0
  48. {erispulse-2.1.7 → erispulse-2.1.7.post1}/docs/api/README.md +0 -0
  49. {erispulse-2.1.7 → erispulse-2.1.7.post1}/examples/example-adapter/LICENSE +0 -0
  50. {erispulse-2.1.7 → erispulse-2.1.7.post1}/examples/example-adapter/MyAdapter/Core.py +0 -0
  51. {erispulse-2.1.7 → erispulse-2.1.7.post1}/examples/example-adapter/MyAdapter/__init__.py +0 -0
  52. {erispulse-2.1.7 → erispulse-2.1.7.post1}/examples/example-adapter/README.md +0 -0
  53. {erispulse-2.1.7 → erispulse-2.1.7.post1}/examples/example-adapter/pyproject.toml +0 -0
  54. {erispulse-2.1.7 → erispulse-2.1.7.post1}/examples/example-cli-module/LICENSE +0 -0
  55. {erispulse-2.1.7 → erispulse-2.1.7.post1}/examples/example-cli-module/README.md +0 -0
  56. {erispulse-2.1.7 → erispulse-2.1.7.post1}/examples/example-cli-module/my_cli_module/__init__.py +0 -0
  57. {erispulse-2.1.7 → erispulse-2.1.7.post1}/examples/example-cli-module/my_cli_module/cli.py +0 -0
  58. {erispulse-2.1.7 → erispulse-2.1.7.post1}/examples/example-module/LICENSE +0 -0
  59. {erispulse-2.1.7 → erispulse-2.1.7.post1}/examples/example-module/MyModule/Core.py +0 -0
  60. {erispulse-2.1.7 → erispulse-2.1.7.post1}/examples/example-module/MyModule/__init__.py +0 -0
  61. {erispulse-2.1.7 → erispulse-2.1.7.post1}/examples/example-module/README.md +0 -0
  62. {erispulse-2.1.7 → erispulse-2.1.7.post1}/examples/example-module/pyproject.toml +0 -0
  63. {erispulse-2.1.7 → erispulse-2.1.7.post1}/scripts/install/install.ps1 +0 -0
  64. {erispulse-2.1.7 → erispulse-2.1.7.post1}/scripts/install/install.sh +0 -0
  65. {erispulse-2.1.7 → erispulse-2.1.7.post1}/src/ErisPulse/Core/__init__.py +0 -0
  66. {erispulse-2.1.7 → erispulse-2.1.7.post1}/src/ErisPulse/Core/adapter.py +0 -0
  67. {erispulse-2.1.7 → erispulse-2.1.7.post1}/src/ErisPulse/Core/env.py +0 -0
  68. {erispulse-2.1.7 → erispulse-2.1.7.post1}/src/ErisPulse/Core/logger.py +0 -0
  69. {erispulse-2.1.7 → erispulse-2.1.7.post1}/src/ErisPulse/Core/mods.py +0 -0
  70. {erispulse-2.1.7 → erispulse-2.1.7.post1}/src/ErisPulse/Core/server.py +0 -0
  71. {erispulse-2.1.7 → erispulse-2.1.7.post1}/src/ErisPulse/Core/util.py +0 -0
  72. {erispulse-2.1.7 → erispulse-2.1.7.post1}/src/ErisPulse/__init__.py +0 -0
  73. {erispulse-2.1.7 → erispulse-2.1.7.post1}/src/ErisPulse/__main__.py +0 -0
  74. {erispulse-2.1.7 → erispulse-2.1.7.post1}/style_guide/DOCSTRING_SPEC.md +0 -0
  75. {erispulse-2.1.7 → erispulse-2.1.7.post1}/style_guide/README.md +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: ErisPulse
3
- Version: 2.1.7
3
+ Version: 2.1.7.post1
4
4
  Summary: ErisPulse 是一个模块化、可扩展的异步 Python SDK 框架,主要用于构建高效、可维护的机器人应用程序。
5
5
  Author-email: "艾莉丝·格雷拉特(WSu2059)" <wsu2059@qq.com>, runoneall <runoobsteve@gmail.com>
6
6
  License: MIT License
@@ -919,7 +919,7 @@ def generate_message_id(platform: str, raw_id: str) -> str:
919
919
 
920
920
  # 📦 `ErisPulse.__init__` 模块
921
921
 
922
- *自动生成于 2025-07-19 13:32:12*
922
+ *自动生成于 2025-07-19 19:31:39*
923
923
 
924
924
  ---
925
925
 
@@ -1250,13 +1250,13 @@ SDK初始化入口
1250
1250
  ---
1251
1251
 
1252
1252
 
1253
- *文档最后更新于 2025-07-19 13:32:12*
1253
+ *文档最后更新于 2025-07-19 19:31:39*
1254
1254
 
1255
1255
  ## ErisPulse\__main__.md
1256
1256
 
1257
1257
  # 📦 `ErisPulse.__main__` 模块
1258
1258
 
1259
- *自动生成于 2025-07-19 13:32:12*
1259
+ *自动生成于 2025-07-19 19:31:39*
1260
1260
 
1261
1261
  ---
1262
1262
 
@@ -1386,13 +1386,13 @@ PyPI包管理器
1386
1386
  ---
1387
1387
 
1388
1388
 
1389
- *文档最后更新于 2025-07-19 13:32:12*
1389
+ *文档最后更新于 2025-07-19 19:31:39*
1390
1390
 
1391
1391
  ## ErisPulse\Core\adapter.md
1392
1392
 
1393
1393
  # 📦 `ErisPulse.Core.adapter` 模块
1394
1394
 
1395
- *自动生成于 2025-07-19 13:32:12*
1395
+ *自动生成于 2025-07-19 19:31:39*
1396
1396
 
1397
1397
  ---
1398
1398
 
@@ -1737,13 +1737,13 @@ OneBot12协议事件监听装饰器
1737
1737
  ---
1738
1738
 
1739
1739
 
1740
- *文档最后更新于 2025-07-19 13:32:12*
1740
+ *文档最后更新于 2025-07-19 19:31:39*
1741
1741
 
1742
1742
  ## ErisPulse\Core\env.md
1743
1743
 
1744
1744
  # 📦 `ErisPulse.Core.env` 模块
1745
1745
 
1746
- *自动生成于 2025-07-19 13:32:12*
1746
+ *自动生成于 2025-07-19 19:31:39*
1747
1747
 
1748
1748
  ---
1749
1749
 
@@ -2029,13 +2029,13 @@ ErisPulse 环境配置模块
2029
2029
  ---
2030
2030
 
2031
2031
 
2032
- *文档最后更新于 2025-07-19 13:32:12*
2032
+ *文档最后更新于 2025-07-19 19:31:39*
2033
2033
 
2034
2034
  ## ErisPulse\Core\logger.md
2035
2035
 
2036
2036
  # 📦 `ErisPulse.Core.logger` 模块
2037
2037
 
2038
- *自动生成于 2025-07-19 13:32:12*
2038
+ *自动生成于 2025-07-19 19:31:39*
2039
2039
 
2040
2040
  ---
2041
2041
 
@@ -2117,13 +2117,13 @@ ErisPulse 日志系统
2117
2117
  ---
2118
2118
 
2119
2119
 
2120
- *文档最后更新于 2025-07-19 13:32:12*
2120
+ *文档最后更新于 2025-07-19 19:31:39*
2121
2121
 
2122
2122
  ## ErisPulse\Core\mods.md
2123
2123
 
2124
2124
  # 📦 `ErisPulse.Core.mods` 模块
2125
2125
 
2126
- *自动生成于 2025-07-19 13:32:12*
2126
+ *自动生成于 2025-07-19 19:31:39*
2127
2127
 
2128
2128
  ---
2129
2129
 
@@ -2305,13 +2305,13 @@ ErisPulse 模块管理器
2305
2305
  ---
2306
2306
 
2307
2307
 
2308
- *文档最后更新于 2025-07-19 13:32:12*
2308
+ *文档最后更新于 2025-07-19 19:31:39*
2309
2309
 
2310
2310
  ## ErisPulse\Core\raiserr.md
2311
2311
 
2312
2312
  # 📦 `ErisPulse.Core.raiserr` 模块
2313
2313
 
2314
- *自动生成于 2025-07-19 13:32:12*
2314
+ *自动生成于 2025-07-19 19:31:39*
2315
2315
 
2316
2316
  ---
2317
2317
 
@@ -2404,13 +2404,13 @@ ErisPulse 错误管理系统
2404
2404
  ---
2405
2405
 
2406
2406
 
2407
- *文档最后更新于 2025-07-19 13:32:12*
2407
+ *文档最后更新于 2025-07-19 19:31:39*
2408
2408
 
2409
2409
  ## ErisPulse\Core\server.md
2410
2410
 
2411
2411
  # 📦 `ErisPulse.Core.server` 模块
2412
2412
 
2413
- *自动生成于 2025-07-19 13:32:12*
2413
+ *自动生成于 2025-07-19 19:31:39*
2414
2414
 
2415
2415
  ---
2416
2416
 
@@ -2531,13 +2531,13 @@ ErisPulse Adapter Server
2531
2531
  ---
2532
2532
 
2533
2533
 
2534
- *文档最后更新于 2025-07-19 13:32:12*
2534
+ *文档最后更新于 2025-07-19 19:31:39*
2535
2535
 
2536
2536
  ## ErisPulse\Core\util.md
2537
2537
 
2538
2538
  # 📦 `ErisPulse.Core.util` 模块
2539
2539
 
2540
- *自动生成于 2025-07-19 13:32:12*
2540
+ *自动生成于 2025-07-19 19:31:39*
2541
2541
 
2542
2542
  ---
2543
2543
 
@@ -2631,6 +2631,6 @@ ErisPulse 工具函数集合
2631
2631
  ---
2632
2632
 
2633
2633
 
2634
- *文档最后更新于 2025-07-19 13:32:12*
2634
+ *文档最后更新于 2025-07-19 19:31:39*
2635
2635
 
2636
2636
  <!--- End of API文档 -->
@@ -19,12 +19,13 @@
19
19
  ## 安装ErisPulse
20
20
 
21
21
  ### 使用 pip 安装
22
+ 确保你的 Python 版本 >= 3.8,然后使用 pip 安装 ErisPulse:
22
23
  ```bash
23
24
  pip install ErisPulse
24
25
  ```
25
26
 
26
27
  ### 更先进的安装方法
27
- > 我们全面采用 [`uv`](https://github.com/astral-sh/uv) 作为 Python 工具链, 所以需要先安装 uv。
28
+ > 采用 [`uv`](https://github.com/astral-sh/uv) 作为 Python 工具链
28
29
 
29
30
  ### 1. 安装 uv
30
31
 
@@ -70,11 +71,9 @@ mkdir my_bot && cd my_bot
70
71
  2. 初始化 SDK 并生成配置文件:
71
72
 
72
73
  ```bsah
73
- epsdk init
74
- # 或 ep-init
74
+ ep-init
75
75
  ```
76
-
77
- 这将在当前目录下自动生成 `env.py` 配置模板文件, 以及最简程序入口 `main.py`。
76
+ 这将在当前目录下生成 `config.yml` 和 `main.py` 入口。
78
77
 
79
78
  ---
80
79
 
@@ -518,36 +517,6 @@ await telegram.Send.To("user", user_id).Text("Hello World!")
518
517
  - `.DeleteMessage(message_id: int)`:删除指定消息。
519
518
  - `.GetChat()`:获取聊天信息。
520
519
 
521
- #### env.py 配置示例
522
- ```python
523
- sdk.env.set("TelegramAdapter", {
524
- # 必填:Telegram Bot Token
525
- "token": "YOUR_BOT_TOKEN",
526
-
527
- # Webhook 模式下的服务配置(如使用 webhook)
528
- "server": {
529
- "host": "127.0.0.1", # 推荐监听本地,防止外网直连
530
- "port": 8443, # 监听端口
531
- "path": "/telegram/webhook" # Webhook 路径
532
- },
533
- "webhook": {
534
- "host": "example.com", # Telegram API 监听地址(外部地址)
535
- "port": 8443, # 监听端口
536
- "path": "/telegram/webhook" # Webhook 路径
537
- }
538
-
539
- # 启动模式: webhook 或 polling
540
- "mode": "webhook",
541
-
542
- # 可选:代理配置(用于连接 Telegram API)
543
- "proxy": {
544
- "host": "127.0.0.1",
545
- "port": 1080,
546
- "type": "socks5" # 支持 socks4 / socks5
547
- }
548
- })
549
- ```
550
-
551
520
  #### 数据格式示例
552
521
  > 略: 使用你了解的 TG 事件数据格式即可,这里不进行演示
553
522
 
@@ -721,7 +690,7 @@ ErisPulse 项目:
721
690
 
722
691
  # 📦 `ErisPulse.Core.adapter` 模块
723
692
 
724
- *自动生成于 2025-07-19 13:32:12*
693
+ *自动生成于 2025-07-19 19:31:39*
725
694
 
726
695
  ---
727
696
 
@@ -1066,13 +1035,13 @@ OneBot12协议事件监听装饰器
1066
1035
  ---
1067
1036
 
1068
1037
 
1069
- *文档最后更新于 2025-07-19 13:32:12*
1038
+ *文档最后更新于 2025-07-19 19:31:39*
1070
1039
 
1071
1040
  ## env.md
1072
1041
 
1073
1042
  # 📦 `ErisPulse.Core.env` 模块
1074
1043
 
1075
- *自动生成于 2025-07-19 13:32:12*
1044
+ *自动生成于 2025-07-19 19:31:39*
1076
1045
 
1077
1046
  ---
1078
1047
 
@@ -1358,13 +1327,13 @@ ErisPulse 环境配置模块
1358
1327
  ---
1359
1328
 
1360
1329
 
1361
- *文档最后更新于 2025-07-19 13:32:12*
1330
+ *文档最后更新于 2025-07-19 19:31:39*
1362
1331
 
1363
1332
  ## logger.md
1364
1333
 
1365
1334
  # 📦 `ErisPulse.Core.logger` 模块
1366
1335
 
1367
- *自动生成于 2025-07-19 13:32:12*
1336
+ *自动生成于 2025-07-19 19:31:39*
1368
1337
 
1369
1338
  ---
1370
1339
 
@@ -1446,13 +1415,13 @@ ErisPulse 日志系统
1446
1415
  ---
1447
1416
 
1448
1417
 
1449
- *文档最后更新于 2025-07-19 13:32:12*
1418
+ *文档最后更新于 2025-07-19 19:31:39*
1450
1419
 
1451
1420
  ## mods.md
1452
1421
 
1453
1422
  # 📦 `ErisPulse.Core.mods` 模块
1454
1423
 
1455
- *自动生成于 2025-07-19 13:32:12*
1424
+ *自动生成于 2025-07-19 19:31:39*
1456
1425
 
1457
1426
  ---
1458
1427
 
@@ -1634,13 +1603,13 @@ ErisPulse 模块管理器
1634
1603
  ---
1635
1604
 
1636
1605
 
1637
- *文档最后更新于 2025-07-19 13:32:12*
1606
+ *文档最后更新于 2025-07-19 19:31:39*
1638
1607
 
1639
1608
  ## raiserr.md
1640
1609
 
1641
1610
  # 📦 `ErisPulse.Core.raiserr` 模块
1642
1611
 
1643
- *自动生成于 2025-07-19 13:32:12*
1612
+ *自动生成于 2025-07-19 19:31:39*
1644
1613
 
1645
1614
  ---
1646
1615
 
@@ -1733,13 +1702,13 @@ ErisPulse 错误管理系统
1733
1702
  ---
1734
1703
 
1735
1704
 
1736
- *文档最后更新于 2025-07-19 13:32:12*
1705
+ *文档最后更新于 2025-07-19 19:31:39*
1737
1706
 
1738
1707
  ## server.md
1739
1708
 
1740
1709
  # 📦 `ErisPulse.Core.server` 模块
1741
1710
 
1742
- *自动生成于 2025-07-19 13:32:12*
1711
+ *自动生成于 2025-07-19 19:31:39*
1743
1712
 
1744
1713
  ---
1745
1714
 
@@ -1860,13 +1829,13 @@ ErisPulse Adapter Server
1860
1829
  ---
1861
1830
 
1862
1831
 
1863
- *文档最后更新于 2025-07-19 13:32:12*
1832
+ *文档最后更新于 2025-07-19 19:31:39*
1864
1833
 
1865
1834
  ## util.md
1866
1835
 
1867
1836
  # 📦 `ErisPulse.Core.util` 模块
1868
1837
 
1869
- *自动生成于 2025-07-19 13:32:12*
1838
+ *自动生成于 2025-07-19 19:31:39*
1870
1839
 
1871
1840
  ---
1872
1841
 
@@ -1960,6 +1929,6 @@ ErisPulse 工具函数集合
1960
1929
  ---
1961
1930
 
1962
1931
 
1963
- *文档最后更新于 2025-07-19 13:32:12*
1932
+ *文档最后更新于 2025-07-19 19:31:39*
1964
1933
 
1965
1934
  <!--- End of API文档 -->
@@ -23,12 +23,13 @@
23
23
  ## 安装ErisPulse
24
24
 
25
25
  ### 使用 pip 安装
26
+ 确保你的 Python 版本 >= 3.8,然后使用 pip 安装 ErisPulse:
26
27
  ```bash
27
28
  pip install ErisPulse
28
29
  ```
29
30
 
30
31
  ### 更先进的安装方法
31
- > 我们全面采用 [`uv`](https://github.com/astral-sh/uv) 作为 Python 工具链, 所以需要先安装 uv。
32
+ > 采用 [`uv`](https://github.com/astral-sh/uv) 作为 Python 工具链
32
33
 
33
34
  ### 1. 安装 uv
34
35
 
@@ -74,11 +75,9 @@ mkdir my_bot && cd my_bot
74
75
  2. 初始化 SDK 并生成配置文件:
75
76
 
76
77
  ```bsah
77
- epsdk init
78
- # 或 ep-init
78
+ ep-init
79
79
  ```
80
-
81
- 这将在当前目录下自动生成 `env.py` 配置模板文件, 以及最简程序入口 `main.py`。
80
+ 这将在当前目录下生成 `config.yml` 和 `main.py` 入口。
82
81
 
83
82
  ---
84
83
 
@@ -522,36 +521,6 @@ await telegram.Send.To("user", user_id).Text("Hello World!")
522
521
  - `.DeleteMessage(message_id: int)`:删除指定消息。
523
522
  - `.GetChat()`:获取聊天信息。
524
523
 
525
- #### env.py 配置示例
526
- ```python
527
- sdk.env.set("TelegramAdapter", {
528
- # 必填:Telegram Bot Token
529
- "token": "YOUR_BOT_TOKEN",
530
-
531
- # Webhook 模式下的服务配置(如使用 webhook)
532
- "server": {
533
- "host": "127.0.0.1", # 推荐监听本地,防止外网直连
534
- "port": 8443, # 监听端口
535
- "path": "/telegram/webhook" # Webhook 路径
536
- },
537
- "webhook": {
538
- "host": "example.com", # Telegram API 监听地址(外部地址)
539
- "port": 8443, # 监听端口
540
- "path": "/telegram/webhook" # Webhook 路径
541
- }
542
-
543
- # 启动模式: webhook 或 polling
544
- "mode": "webhook",
545
-
546
- # 可选:代理配置(用于连接 Telegram API)
547
- "proxy": {
548
- "host": "127.0.0.1",
549
- "port": 1080,
550
- "type": "socks5" # 支持 socks4 / socks5
551
- }
552
- })
553
- ```
554
-
555
524
  #### 数据格式示例
556
525
  > 略: 使用你了解的 TG 事件数据格式即可,这里不进行演示
557
526
 
@@ -1630,7 +1599,7 @@ def generate_message_id(platform: str, raw_id: str) -> str:
1630
1599
 
1631
1600
  # 📦 `ErisPulse.__init__` 模块
1632
1601
 
1633
- *自动生成于 2025-07-19 13:32:12*
1602
+ *自动生成于 2025-07-19 19:31:39*
1634
1603
 
1635
1604
  ---
1636
1605
 
@@ -1961,13 +1930,13 @@ SDK初始化入口
1961
1930
  ---
1962
1931
 
1963
1932
 
1964
- *文档最后更新于 2025-07-19 13:32:12*
1933
+ *文档最后更新于 2025-07-19 19:31:39*
1965
1934
 
1966
1935
  ## ErisPulse\__main__.md
1967
1936
 
1968
1937
  # 📦 `ErisPulse.__main__` 模块
1969
1938
 
1970
- *自动生成于 2025-07-19 13:32:12*
1939
+ *自动生成于 2025-07-19 19:31:39*
1971
1940
 
1972
1941
  ---
1973
1942
 
@@ -2097,13 +2066,13 @@ PyPI包管理器
2097
2066
  ---
2098
2067
 
2099
2068
 
2100
- *文档最后更新于 2025-07-19 13:32:12*
2069
+ *文档最后更新于 2025-07-19 19:31:39*
2101
2070
 
2102
2071
  ## ErisPulse\Core\adapter.md
2103
2072
 
2104
2073
  # 📦 `ErisPulse.Core.adapter` 模块
2105
2074
 
2106
- *自动生成于 2025-07-19 13:32:12*
2075
+ *自动生成于 2025-07-19 19:31:39*
2107
2076
 
2108
2077
  ---
2109
2078
 
@@ -2448,13 +2417,13 @@ OneBot12协议事件监听装饰器
2448
2417
  ---
2449
2418
 
2450
2419
 
2451
- *文档最后更新于 2025-07-19 13:32:12*
2420
+ *文档最后更新于 2025-07-19 19:31:39*
2452
2421
 
2453
2422
  ## ErisPulse\Core\env.md
2454
2423
 
2455
2424
  # 📦 `ErisPulse.Core.env` 模块
2456
2425
 
2457
- *自动生成于 2025-07-19 13:32:12*
2426
+ *自动生成于 2025-07-19 19:31:39*
2458
2427
 
2459
2428
  ---
2460
2429
 
@@ -2740,13 +2709,13 @@ ErisPulse 环境配置模块
2740
2709
  ---
2741
2710
 
2742
2711
 
2743
- *文档最后更新于 2025-07-19 13:32:12*
2712
+ *文档最后更新于 2025-07-19 19:31:39*
2744
2713
 
2745
2714
  ## ErisPulse\Core\logger.md
2746
2715
 
2747
2716
  # 📦 `ErisPulse.Core.logger` 模块
2748
2717
 
2749
- *自动生成于 2025-07-19 13:32:12*
2718
+ *自动生成于 2025-07-19 19:31:39*
2750
2719
 
2751
2720
  ---
2752
2721
 
@@ -2828,13 +2797,13 @@ ErisPulse 日志系统
2828
2797
  ---
2829
2798
 
2830
2799
 
2831
- *文档最后更新于 2025-07-19 13:32:12*
2800
+ *文档最后更新于 2025-07-19 19:31:39*
2832
2801
 
2833
2802
  ## ErisPulse\Core\mods.md
2834
2803
 
2835
2804
  # 📦 `ErisPulse.Core.mods` 模块
2836
2805
 
2837
- *自动生成于 2025-07-19 13:32:12*
2806
+ *自动生成于 2025-07-19 19:31:39*
2838
2807
 
2839
2808
  ---
2840
2809
 
@@ -3016,13 +2985,13 @@ ErisPulse 模块管理器
3016
2985
  ---
3017
2986
 
3018
2987
 
3019
- *文档最后更新于 2025-07-19 13:32:12*
2988
+ *文档最后更新于 2025-07-19 19:31:39*
3020
2989
 
3021
2990
  ## ErisPulse\Core\raiserr.md
3022
2991
 
3023
2992
  # 📦 `ErisPulse.Core.raiserr` 模块
3024
2993
 
3025
- *自动生成于 2025-07-19 13:32:12*
2994
+ *自动生成于 2025-07-19 19:31:39*
3026
2995
 
3027
2996
  ---
3028
2997
 
@@ -3115,13 +3084,13 @@ ErisPulse 错误管理系统
3115
3084
  ---
3116
3085
 
3117
3086
 
3118
- *文档最后更新于 2025-07-19 13:32:12*
3087
+ *文档最后更新于 2025-07-19 19:31:39*
3119
3088
 
3120
3089
  ## ErisPulse\Core\server.md
3121
3090
 
3122
3091
  # 📦 `ErisPulse.Core.server` 模块
3123
3092
 
3124
- *自动生成于 2025-07-19 13:32:12*
3093
+ *自动生成于 2025-07-19 19:31:39*
3125
3094
 
3126
3095
  ---
3127
3096
 
@@ -3242,13 +3211,13 @@ ErisPulse Adapter Server
3242
3211
  ---
3243
3212
 
3244
3213
 
3245
- *文档最后更新于 2025-07-19 13:32:12*
3214
+ *文档最后更新于 2025-07-19 19:31:39*
3246
3215
 
3247
3216
  ## ErisPulse\Core\util.md
3248
3217
 
3249
3218
  # 📦 `ErisPulse.Core.util` 模块
3250
3219
 
3251
- *自动生成于 2025-07-19 13:32:12*
3220
+ *自动生成于 2025-07-19 19:31:39*
3252
3221
 
3253
3222
  ---
3254
3223
 
@@ -3342,6 +3311,6 @@ ErisPulse 工具函数集合
3342
3311
  ---
3343
3312
 
3344
3313
 
3345
- *文档最后更新于 2025-07-19 13:32:12*
3314
+ *文档最后更新于 2025-07-19 19:31:39*
3346
3315
 
3347
3316
  <!--- End of API文档 -->
@@ -425,36 +425,6 @@ await telegram.Send.To("user", user_id).Text("Hello World!")
425
425
  - `.DeleteMessage(message_id: int)`:删除指定消息。
426
426
  - `.GetChat()`:获取聊天信息。
427
427
 
428
- #### env.py 配置示例
429
- ```python
430
- sdk.env.set("TelegramAdapter", {
431
- # 必填:Telegram Bot Token
432
- "token": "YOUR_BOT_TOKEN",
433
-
434
- # Webhook 模式下的服务配置(如使用 webhook)
435
- "server": {
436
- "host": "127.0.0.1", # 推荐监听本地,防止外网直连
437
- "port": 8443, # 监听端口
438
- "path": "/telegram/webhook" # Webhook 路径
439
- },
440
- "webhook": {
441
- "host": "example.com", # Telegram API 监听地址(外部地址)
442
- "port": 8443, # 监听端口
443
- "path": "/telegram/webhook" # Webhook 路径
444
- }
445
-
446
- # 启动模式: webhook 或 polling
447
- "mode": "webhook",
448
-
449
- # 可选:代理配置(用于连接 Telegram API)
450
- "proxy": {
451
- "host": "127.0.0.1",
452
- "port": 1080,
453
- "type": "socks5" # 支持 socks4 / socks5
454
- }
455
- })
456
- ```
457
-
458
428
  #### 数据格式示例
459
429
  > 略: 使用你了解的 TG 事件数据格式即可,这里不进行演示
460
430
 
@@ -772,7 +742,7 @@ sdk.MyModule.print_hello()
772
742
 
773
743
  # 📦 `ErisPulse.__init__` 模块
774
744
 
775
- *自动生成于 2025-07-19 13:32:12*
745
+ *自动生成于 2025-07-19 19:31:39*
776
746
 
777
747
  ---
778
748
 
@@ -1103,13 +1073,13 @@ SDK初始化入口
1103
1073
  ---
1104
1074
 
1105
1075
 
1106
- *文档最后更新于 2025-07-19 13:32:12*
1076
+ *文档最后更新于 2025-07-19 19:31:39*
1107
1077
 
1108
1078
  ## ErisPulse\__main__.md
1109
1079
 
1110
1080
  # 📦 `ErisPulse.__main__` 模块
1111
1081
 
1112
- *自动生成于 2025-07-19 13:32:12*
1082
+ *自动生成于 2025-07-19 19:31:39*
1113
1083
 
1114
1084
  ---
1115
1085
 
@@ -1239,13 +1209,13 @@ PyPI包管理器
1239
1209
  ---
1240
1210
 
1241
1211
 
1242
- *文档最后更新于 2025-07-19 13:32:12*
1212
+ *文档最后更新于 2025-07-19 19:31:39*
1243
1213
 
1244
1214
  ## ErisPulse\Core\adapter.md
1245
1215
 
1246
1216
  # 📦 `ErisPulse.Core.adapter` 模块
1247
1217
 
1248
- *自动生成于 2025-07-19 13:32:12*
1218
+ *自动生成于 2025-07-19 19:31:39*
1249
1219
 
1250
1220
  ---
1251
1221
 
@@ -1590,13 +1560,13 @@ OneBot12协议事件监听装饰器
1590
1560
  ---
1591
1561
 
1592
1562
 
1593
- *文档最后更新于 2025-07-19 13:32:12*
1563
+ *文档最后更新于 2025-07-19 19:31:39*
1594
1564
 
1595
1565
  ## ErisPulse\Core\env.md
1596
1566
 
1597
1567
  # 📦 `ErisPulse.Core.env` 模块
1598
1568
 
1599
- *自动生成于 2025-07-19 13:32:12*
1569
+ *自动生成于 2025-07-19 19:31:39*
1600
1570
 
1601
1571
  ---
1602
1572
 
@@ -1882,13 +1852,13 @@ ErisPulse 环境配置模块
1882
1852
  ---
1883
1853
 
1884
1854
 
1885
- *文档最后更新于 2025-07-19 13:32:12*
1855
+ *文档最后更新于 2025-07-19 19:31:39*
1886
1856
 
1887
1857
  ## ErisPulse\Core\logger.md
1888
1858
 
1889
1859
  # 📦 `ErisPulse.Core.logger` 模块
1890
1860
 
1891
- *自动生成于 2025-07-19 13:32:12*
1861
+ *自动生成于 2025-07-19 19:31:39*
1892
1862
 
1893
1863
  ---
1894
1864
 
@@ -1970,13 +1940,13 @@ ErisPulse 日志系统
1970
1940
  ---
1971
1941
 
1972
1942
 
1973
- *文档最后更新于 2025-07-19 13:32:12*
1943
+ *文档最后更新于 2025-07-19 19:31:39*
1974
1944
 
1975
1945
  ## ErisPulse\Core\mods.md
1976
1946
 
1977
1947
  # 📦 `ErisPulse.Core.mods` 模块
1978
1948
 
1979
- *自动生成于 2025-07-19 13:32:12*
1949
+ *自动生成于 2025-07-19 19:31:39*
1980
1950
 
1981
1951
  ---
1982
1952
 
@@ -2158,13 +2128,13 @@ ErisPulse 模块管理器
2158
2128
  ---
2159
2129
 
2160
2130
 
2161
- *文档最后更新于 2025-07-19 13:32:12*
2131
+ *文档最后更新于 2025-07-19 19:31:39*
2162
2132
 
2163
2133
  ## ErisPulse\Core\raiserr.md
2164
2134
 
2165
2135
  # 📦 `ErisPulse.Core.raiserr` 模块
2166
2136
 
2167
- *自动生成于 2025-07-19 13:32:12*
2137
+ *自动生成于 2025-07-19 19:31:39*
2168
2138
 
2169
2139
  ---
2170
2140
 
@@ -2257,13 +2227,13 @@ ErisPulse 错误管理系统
2257
2227
  ---
2258
2228
 
2259
2229
 
2260
- *文档最后更新于 2025-07-19 13:32:12*
2230
+ *文档最后更新于 2025-07-19 19:31:39*
2261
2231
 
2262
2232
  ## ErisPulse\Core\server.md
2263
2233
 
2264
2234
  # 📦 `ErisPulse.Core.server` 模块
2265
2235
 
2266
- *自动生成于 2025-07-19 13:32:12*
2236
+ *自动生成于 2025-07-19 19:31:39*
2267
2237
 
2268
2238
  ---
2269
2239
 
@@ -2384,13 +2354,13 @@ ErisPulse Adapter Server
2384
2354
  ---
2385
2355
 
2386
2356
 
2387
- *文档最后更新于 2025-07-19 13:32:12*
2357
+ *文档最后更新于 2025-07-19 19:31:39*
2388
2358
 
2389
2359
  ## ErisPulse\Core\util.md
2390
2360
 
2391
2361
  # 📦 `ErisPulse.Core.util` 模块
2392
2362
 
2393
- *自动生成于 2025-07-19 13:32:12*
2363
+ *自动生成于 2025-07-19 19:31:39*
2394
2364
 
2395
2365
  ---
2396
2366
 
@@ -2484,6 +2454,6 @@ ErisPulse 工具函数集合
2484
2454
  ---
2485
2455
 
2486
2456
 
2487
- *文档最后更新于 2025-07-19 13:32:12*
2457
+ *文档最后更新于 2025-07-19 19:31:39*
2488
2458
 
2489
2459
  <!--- End of API文档 -->
@@ -24,6 +24,7 @@
24
24
 
25
25
  ### 修复
26
26
  - 修复windows依赖引入错误
27
+ - f-string 语法兼容性修复
27
28
 
28
29
  ---
29
30
 
@@ -71,7 +71,7 @@ def my_command_register(subparsers: Any, console: Any) -> None:
71
71
  [project]
72
72
  name = "your-module-name"
73
73
  version = "1.0.0"
74
- dependencies = ["ErisPulse>=1.0.0"]
74
+ dependencies = ["ErisPulse>=2.1.6"]
75
75
 
76
76
  [project.entry-points."erispulse.cli"]
77
77
  "yourcommand" = "my_cli_module:your_command_register"
@@ -279,36 +279,6 @@ await telegram.Send.To("user", user_id).Text("Hello World!")
279
279
  - `.DeleteMessage(message_id: int)`:删除指定消息。
280
280
  - `.GetChat()`:获取聊天信息。
281
281
 
282
- #### env.py 配置示例
283
- ```python
284
- sdk.env.set("TelegramAdapter", {
285
- # 必填:Telegram Bot Token
286
- "token": "YOUR_BOT_TOKEN",
287
-
288
- # Webhook 模式下的服务配置(如使用 webhook)
289
- "server": {
290
- "host": "127.0.0.1", # 推荐监听本地,防止外网直连
291
- "port": 8443, # 监听端口
292
- "path": "/telegram/webhook" # Webhook 路径
293
- },
294
- "webhook": {
295
- "host": "example.com", # Telegram API 监听地址(外部地址)
296
- "port": 8443, # 监听端口
297
- "path": "/telegram/webhook" # Webhook 路径
298
- }
299
-
300
- # 启动模式: webhook 或 polling
301
- "mode": "webhook",
302
-
303
- # 可选:代理配置(用于连接 Telegram API)
304
- "proxy": {
305
- "host": "127.0.0.1",
306
- "port": 1080,
307
- "type": "socks5" # 支持 socks4 / socks5
308
- }
309
- })
310
- ```
311
-
312
282
  #### 数据格式示例
313
283
  > 略: 使用你了解的 TG 事件数据格式即可,这里不进行演示
314
284
 
@@ -1,6 +1,6 @@
1
1
  # 📦 `ErisPulse.Core.adapter` 模块
2
2
 
3
- *自动生成于 2025-07-19 13:32:12*
3
+ *自动生成于 2025-07-19 19:31:39*
4
4
 
5
5
  ---
6
6
 
@@ -345,4 +345,4 @@ OneBot12协议事件监听装饰器
345
345
  ---
346
346
 
347
347
 
348
- *文档最后更新于 2025-07-19 13:32:12*
348
+ *文档最后更新于 2025-07-19 19:31:39*
@@ -1,6 +1,6 @@
1
1
  # 📦 `ErisPulse.Core.env` 模块
2
2
 
3
- *自动生成于 2025-07-19 13:32:12*
3
+ *自动生成于 2025-07-19 19:31:39*
4
4
 
5
5
  ---
6
6
 
@@ -286,4 +286,4 @@ ErisPulse 环境配置模块
286
286
  ---
287
287
 
288
288
 
289
- *文档最后更新于 2025-07-19 13:32:12*
289
+ *文档最后更新于 2025-07-19 19:31:39*
@@ -1,6 +1,6 @@
1
1
  # 📦 `ErisPulse.Core.logger` 模块
2
2
 
3
- *自动生成于 2025-07-19 13:32:12*
3
+ *自动生成于 2025-07-19 19:31:39*
4
4
 
5
5
  ---
6
6
 
@@ -82,4 +82,4 @@ ErisPulse 日志系统
82
82
  ---
83
83
 
84
84
 
85
- *文档最后更新于 2025-07-19 13:32:12*
85
+ *文档最后更新于 2025-07-19 19:31:39*
@@ -1,6 +1,6 @@
1
1
  # 📦 `ErisPulse.Core.mods` 模块
2
2
 
3
- *自动生成于 2025-07-19 13:32:12*
3
+ *自动生成于 2025-07-19 19:31:39*
4
4
 
5
5
  ---
6
6
 
@@ -182,4 +182,4 @@ ErisPulse 模块管理器
182
182
  ---
183
183
 
184
184
 
185
- *文档最后更新于 2025-07-19 13:32:12*
185
+ *文档最后更新于 2025-07-19 19:31:39*
@@ -1,6 +1,6 @@
1
1
  # 📦 `ErisPulse.Core.raiserr` 模块
2
2
 
3
- *自动生成于 2025-07-19 13:32:12*
3
+ *自动生成于 2025-07-19 19:31:39*
4
4
 
5
5
  ---
6
6
 
@@ -93,4 +93,4 @@ ErisPulse 错误管理系统
93
93
  ---
94
94
 
95
95
 
96
- *文档最后更新于 2025-07-19 13:32:12*
96
+ *文档最后更新于 2025-07-19 19:31:39*
@@ -1,6 +1,6 @@
1
1
  # 📦 `ErisPulse.Core.server` 模块
2
2
 
3
- *自动生成于 2025-07-19 13:32:12*
3
+ *自动生成于 2025-07-19 19:31:39*
4
4
 
5
5
  ---
6
6
 
@@ -121,4 +121,4 @@ ErisPulse Adapter Server
121
121
  ---
122
122
 
123
123
 
124
- *文档最后更新于 2025-07-19 13:32:12*
124
+ *文档最后更新于 2025-07-19 19:31:39*
@@ -1,6 +1,6 @@
1
1
  # 📦 `ErisPulse.Core.util` 模块
2
2
 
3
- *自动生成于 2025-07-19 13:32:12*
3
+ *自动生成于 2025-07-19 19:31:39*
4
4
 
5
5
  ---
6
6
 
@@ -94,4 +94,4 @@ ErisPulse 工具函数集合
94
94
  ---
95
95
 
96
96
 
97
- *文档最后更新于 2025-07-19 13:32:12*
97
+ *文档最后更新于 2025-07-19 19:31:39*
@@ -1,6 +1,6 @@
1
1
  # 📦 `ErisPulse.__init__` 模块
2
2
 
3
- *自动生成于 2025-07-19 13:32:12*
3
+ *自动生成于 2025-07-19 19:31:39*
4
4
 
5
5
  ---
6
6
 
@@ -331,4 +331,4 @@ SDK初始化入口
331
331
  ---
332
332
 
333
333
 
334
- *文档最后更新于 2025-07-19 13:32:12*
334
+ *文档最后更新于 2025-07-19 19:31:39*
@@ -1,6 +1,6 @@
1
1
  # 📦 `ErisPulse.__main__` 模块
2
2
 
3
- *自动生成于 2025-07-19 13:32:12*
3
+ *自动生成于 2025-07-19 19:31:39*
4
4
 
5
5
  ---
6
6
 
@@ -130,4 +130,4 @@ PyPI包管理器
130
130
  ---
131
131
 
132
132
 
133
- *文档最后更新于 2025-07-19 13:32:12*
133
+ *文档最后更新于 2025-07-19 19:31:39*
@@ -3,12 +3,13 @@
3
3
  ## 安装ErisPulse
4
4
 
5
5
  ### 使用 pip 安装
6
+ 确保你的 Python 版本 >= 3.8,然后使用 pip 安装 ErisPulse:
6
7
  ```bash
7
8
  pip install ErisPulse
8
9
  ```
9
10
 
10
11
  ### 更先进的安装方法
11
- > 我们全面采用 [`uv`](https://github.com/astral-sh/uv) 作为 Python 工具链, 所以需要先安装 uv。
12
+ > 采用 [`uv`](https://github.com/astral-sh/uv) 作为 Python 工具链
12
13
 
13
14
  ### 1. 安装 uv
14
15
 
@@ -54,11 +55,9 @@ mkdir my_bot && cd my_bot
54
55
  2. 初始化 SDK 并生成配置文件:
55
56
 
56
57
  ```bsah
57
- epsdk init
58
- # 或 ep-init
58
+ ep-init
59
59
  ```
60
-
61
- 这将在当前目录下自动生成 `env.py` 配置模板文件, 以及最简程序入口 `main.py`。
60
+ 这将在当前目录下生成 `config.yml` 和 `main.py` 入口。
62
61
 
63
62
  ---
64
63
 
@@ -67,7 +66,7 @@ epsdk init
67
66
  你可以通过 CLI 安装所需模块:
68
67
 
69
68
  ```bash
70
- epsdk install Yunhu OneBot AIChat
69
+ epsdk install Yunhu AIChat
71
70
  ```
72
71
 
73
72
  你也可以手动编写模块逻辑,参考开发者文档进行模块开发。
@@ -8,7 +8,7 @@ license = { file = "LICENSE" }
8
8
  authors = [ { name = "yourname", email = "your@mail.com" } ]
9
9
 
10
10
  dependencies = [
11
- "ErisPulse>=1.0.0"
11
+ "ErisPulse>=2.1.6"
12
12
  ]
13
13
 
14
14
  [project.urls]
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
4
4
 
5
5
  [project]
6
6
  name = "ErisPulse"
7
- version = "2.1.7"
7
+ version = "2.1.7-1"
8
8
  description = "ErisPulse 是一个模块化、可扩展的异步 Python SDK 框架,主要用于构建高效、可维护的机器人应用程序。"
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.8"
@@ -137,7 +137,10 @@ def global_exception_handler(exc_type: Type[Exception], exc_value: Exception, ex
137
137
  else:
138
138
  colored_traceback.append(f"{RED}{line}{RESET}")
139
139
 
140
- full_error = f"{error_title}\n{RED}Traceback:{RESET}\n{''.join(colored_traceback)}"
140
+ full_error = f"""
141
+ {error_title}
142
+ {RED}Traceback:{RESET}
143
+ {colored_traceback}"""
141
144
 
142
145
  sys.stderr.write(full_error)
143
146
 
@@ -166,7 +169,9 @@ def async_exception_handler(loop: asyncio.AbstractEventLoop, context: Dict[str,
166
169
  else:
167
170
  colored_tb.append(f"{RED}{line}{RESET}")
168
171
 
169
- error_msg = f"{RED}{type(exception).__name__}{RESET}: {YELLOW}{exception}{RESET}\n{RED}Traceback:{RESET}\n{'\n'.join(colored_tb)}"
172
+ error_msg = f"""{RED}{type(exception).__name__}{RESET}: {YELLOW}{exception}{RESET}
173
+ {RED}Traceback:{RESET}
174
+ {colored_tb}"""
170
175
  sys.stderr.write(error_msg)
171
176
  else:
172
177
  msg = context.get('message', 'Unknown async error')
File without changes
File without changes
File without changes
File without changes
File without changes