Skip to main content

ErisPulse的沙箱适配器,提供网页界面用于调试和模拟消息

Project description

ErisPulse 沙箱适配器

ErisPulse 的沙箱适配器,提供网页界面用于调试和模拟消息, 可以帮助您在不接入实际机器人平台的情况下进行开发和测试。

安装

pip install ErisPulse-SandboxAdapter
# 或者 epsdk install sandbox

配置

config.toml 中添加以下配置:

[SandboxAdapter]
self_id = "sandbox_bot"
enable = true

消息发送

沙箱适配器支持链式消息发送 DSL,支持以下功能:

基本发送方法

# 发送文本
adapter.Send.To("user", "123").Text("Hello")

# 发送图片
adapter.Send.To("user", "123").Image("image_url")

# 发送表情
adapter.Send.To("group", "456").Face(1)

链式修饰方法

# @用户
adapter.Send.To("group", "456").At("user123").Text("Hello")

# @全体成员
adapter.Send.To("group", "456").AtAll().Text("Everyone")

# 回复消息
adapter.Send.To("group", "456").Reply("msg_id").Text("Reply")

# 链式组合
adapter.Send.To("group", "456").At("user1").At("user2").Reply("msg_id").Text("Hello")

原始消息发送

# 发送 OneBot12 格式消息段
adapter.Send.To("group", "456").Raw_ob12([
    {"type": "text", "data": {"text": "Hello"}},
    {"type": "image", "data": {"file": "url"}}
])

大小写不敏感

方法名支持大小写不敏感调用:

# 以下调用方式等效
adapter.Send.To("user", "123").Text("hi")
adapter.Send.To("user", "123").text("hi")
adapter.Send.To("user", "123").TEXT("hi")

不支持的方法

调用不支持的方法时,会自动发送文本提示:

adapter.Send.To("user", "123").UnsupportedMethod("data")
# 实际发送: "[不支持的发送类型] 方法名: UnsupportedMethod, 参数: [data]"

开发

沙箱适配器可以模拟一个完整的标准适配器,可以辅助开发和调试,使用时请确保你进行了多适配器的适配 在获取到事件event后可以获取platform属性进行平台判断,具体实现请查看ErisPulse的官方文档

使用

  1. 启动适配器后,访问 http://localhost:8000/sandbox/(端口号根据你的配置)
  2. 在网页中添加虚拟好友或群聊
  3. 选择一个聊天,发送消息
  4. 适配器会自动将消息转换为 OneBot12 标准事件并发送给模块

网页界面功能

ErisPulse-SandboxAdapter

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

erispulse_sandboxadapter-1.1.1.tar.gz (32.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

erispulse_sandboxadapter-1.1.1-py3-none-any.whl (29.8 kB view details)

Uploaded Python 3

File details

Details for the file erispulse_sandboxadapter-1.1.1.tar.gz.

File metadata

  • Download URL: erispulse_sandboxadapter-1.1.1.tar.gz
  • Upload date:
  • Size: 32.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for erispulse_sandboxadapter-1.1.1.tar.gz
Algorithm Hash digest
SHA256 9aefd32b00d60c2ba6a3f781e9de77869cafc49992486393941c3dd71f1e5f45
MD5 97544f92ec8c7f7e1b51c7b7968703ac
BLAKE2b-256 0caea30f29a835552788474b34bbd5b29584555b6917b7729e27afdee7dd3bad

See more details on using hashes here.

Provenance

The following attestation bundles were made for erispulse_sandboxadapter-1.1.1.tar.gz:

Publisher: python-publish.yml on ErisPulse/ErisPulse-SandboxAdapter

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file erispulse_sandboxadapter-1.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for erispulse_sandboxadapter-1.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 2e2b0d45ea65b794b8f451f4df24e3ecb9a7e29d26a07a0f1edfef7ed8064dd7
MD5 1112664a622838666bfd9dff124465e3
BLAKE2b-256 185b63feaf1c87c5b915d220233f6a9fe05edc9c79d5391a546fc533f7bf7d9d

See more details on using hashes here.

Provenance

The following attestation bundles were made for erispulse_sandboxadapter-1.1.1-py3-none-any.whl:

Publisher: python-publish.yml on ErisPulse/ErisPulse-SandboxAdapter

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page