YesMaiCore

YesMaiCore 是 YesMai 插件在 MaiBot 上的核心运行时。本仓库同时发布 Core 插件与匹配版本的 yesmai-sdk，供 YesMaiInstaller 原子安装。

仓库结构

plugins/yesmai-core/       MaiBot 插件 com.yesmai.core
packages/yesmai-sdk/       Python SDK 与 Astr 兼容层
examples/                  最小运行夹具
scripts/                   本地验证脚本
tests/                     Core 与 SDK 回归测试

用户安装

推荐在 MaiBot WebUI 中安装 Slapq/YesMaiInstaller。Installer 会从自己的 Git origin 推导本仓库，安装 packages/yesmai-sdk，校验并安装 plugins/yesmai-core。

本仓库不是一个仓库根即插件根的 WebUI 单插件仓库，不要直接把 Slapq/YesMaiCore URL 当作单个 MaiBot 插件安装。

开发安装

python -m pip install ./packages/yesmai-sdk

手工开发部署时，将 plugins/yesmai-core 复制到 MaiBot 的 plugins/。Core 要求 MaiBot Plugin SDK >=2.7.0,<3.0.0、tomlkit>=0.13.3,<1.0.0 和 tzdata>=2024.1。

Web 状态

YesMaiWeb 默认禁用。保持 web_url = "" 时，Core 不创建 Web instance identity、不启动轮询 worker，也不发起 Web 请求。Core、SDK、Astr 兼容和本地插件能力可独立运行。

权限

Bot 命令管理员使用 [permission].command_admins 中精确的 platform:user_id。普通 event/invoke 的 role="admin" 不参与授权。平台会话群主/群管理员是独立且当前不支持的权限域。

验证

python -m pytest -q
python -m compileall -q packages plugins tests

许可证

GPL-3.0-only，见 LICENSE。第三方内容如有独立许可证，以对应目录 notice 为准。