Skip to main content

AUTO-MAS Whimbox Adapter

AUTO-MAS 的奇想盒(无限暖暖)专项插件。

插件调用奇想盒官方 startOneDragon 入口,消费其日志结果;保留原生配置、MAS 账号覆盖、配置备份恢复、后端更新和通知能力。

本地开发

将仓库克隆到 AUTO-MAS 主仓的 plugins/whimbox_adapter。在主仓执行 yarn dev,然后在插件中心启用源码插件。前端目前随主程序构建,入口为主仓 frontend/src/views/whimbox/entry.ts;主程序尚不支持独立加载插件前端。

旧托管仍使用 WhimboxConfig / WhimboxUserConfig 类型及原有 UID。插件在激活时将 UserData 转为 users,不重建账号。禁用沿用宿主语义,会删除本插件的托管和账号;操作前应先备份。

账号覆盖写入前会保存原生配置。若配置恢复失败,解除文件占用后可重试,MAS 会先恢复原生配置再启动任务。若原生配置已有新修改,请在配置恢复中选择所需备份,恢复时会先存底。若 MAS 无法确认奇想盒进程已退出,请先关闭奇想盒再重启 MAS。

验证与构建

使用与本插件匹配的 AUTO-MAS 源码及开发依赖。设置 AUTO_MAS_HOST_SOURCE 为主仓绝对路径,然后执行:

python -m pytest tests -q
python -m ruff check src tests
python -m ruff format --check src tests
uv build

本次迁移未改变上游游戏执行与结果判定语义。真实游戏、管理员授权和线上更新需在装有奇想盒的 Windows 环境验收。

发布

与 MAA Adapter 使用相同的 SDK 依赖范围 >=5,<6。运行需要包含奇想盒插件迁移的宿主。插件市场安装使用随宿主提供的 SDK 和版本元数据。独立使用 pip 安装时需要另行提供兼容的 SDK wheel。

分支推送和 PR 会构建并校验 wheel 与源码包。首次上传使用 PyPI pending Trusted Publisher,配置如下。

字段 值
PyPI project name auto-mas-whimbox-adapter
Owner AUTO-MAS-Project
Repository name AUTO-MAS-Whimbox-Adapter
Workflow name publish.yml
Environment name pypi

将经验证的发布提交合入 master 后,推送与 pyproject.toml 版本一致的 v<版本> 标签。发布任务将构建校验通过的文件上传到 PyPI。交付宿主前,用包含迁移代码的候选宿主和脱敏的旧托管配置验收。临时环境仅使用 PyPI 安装的 Adapter,验证首次启动自动安装插件,以及重启后托管、账号 UID、顺序和设置仍然保留。

Metadata

Release files for auto-mas-whimbox-adapter 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for auto-mas-whimbox-adapter 0.1.0
File Size Uploaded Provenance Actions
auto_mas_whimbox_adapter-0.1.0.tar.gz 75.9 kB With provenance Details for auto_mas_whimbox_adapter-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for auto-mas-whimbox-adapter 0.1.0
File Interpreter ABI Platform Actions
auto_mas_whimbox_adapter-0.1.0-py3-none-any.whl Python 3 none any Details for auto_mas_whimbox_adapter-0.1.0-py3-none-any.whl

Total release size: 159.4 kB

Release files / auto_mas_whimbox_adapter-0.1.0.tar.gz

Download URL auto_mas_whimbox_adapter-0.1.0.tar.gz
Size 75.9 kB
Tags Source
SHA-256 checksum
How to use checksums
5efa3ad07aa07d5f969c54196225c2b5c6523263ab444e6c369f6d92cf36aa9c
BLAKE2b-256 checksum
How to use checksums
0e17f8140dcb92275af83ec28f578b64c140c703d06a0ff9648acd9fdaa9b575
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Release files / auto_mas_whimbox_adapter-0.1.0-py3-none-any.whl

Download URL auto_mas_whimbox_adapter-0.1.0-py3-none-any.whl
Size 83.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e4a20f64fda5d0630f90db9be5c110d4870e1953a092d0b719e3a7445e0fc865
BLAKE2b-256 checksum
How to use checksums
964050ce2599b1f36bad3d7157440bc8daf638bf0d7e902c33ea6bb95945a6df
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

Security for auto-mas-whimbox-adapter 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for auto_mas_whimbox_adapter-0.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 18, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page