AUTO-MAS MSS Adapter
MSS(MaaStellaSora / 星塔旅人)专项插件:MSS 托管、账号与 MSS 计划表。账号运行沿用宿主迁移分支上 MSS 自己的两层流程
(manager.MSSManager → account_run.MSSAccountRun),项目更新、运行池、agent 环境、worker 运行等交给 MFW 的三块积木插件
(maafw_project_update、maafw_agent_env、maafw_runner)和两块解析库(maafw_interface、maafw_native)。
0.1.0 是联调版,允许带已知问题发布,清单见下文。
依赖与安装
- 宿主:已让出内置 MFW / M9A / MSS 的 AUTO-MAS(联调分支,见开工文档 §5)。宿主仍内置 MSS 时,加载本插件会报 「当前 AUTO-MAS 仍内置 MFW / M9A / MSS,请换到让位分支」。
- 插件服务:
requires = ("maafw.agent_env.v1", "maafw.runner.v1", "maafw.project.v1"),即三块积木插件都要先启用。 - 提供服务:
maafw.owner.mss_adapter.v1(属主入口,项目更新插件按服务名现取)。 - 脚本类型键
MSS;只支持自动代理(AUTO_PROXY);计划表类型MSSPlanConfig;活动标识stellasora。
本地联调:把本仓库目录联接到联调宿主树的 plugins\mss_adapter,宿主启动时发现并加载(做法见开工文档 §6)。
模块
| 模块 | 内容 | 来源(宿主迁移分支 46785ce81) |
|---|---|---|
plugin.py |
插件声明、属主登记 | 取代 app/task/MSS/registration.py |
expander.py |
L3 外壳:整轮交给管理器 | 新写(开工文档 §2.5) |
owner.py |
属主入口、项目拒收原因 | registration.py 的属主部分 |
config.py |
MSSConfig、MSSUserConfig、MSSPlanConfig |
app/models/config/script.py、plan.py 切片,换 SDK 基类 |
manager.py |
脚本级管理器 | app/task/MSS/manager.py |
account_run.py |
账号级流程 | app/task/MSS/account_run.py |
config_view.py |
流程读写配置的唯一入口 | app/task/MSS/config_view.py |
arrange.py、rules.py |
排队列、规则常量与项目判据 | 同名 |
已知问题(0.1.0)
越界导入(规则 L:只在函数体内首次导入,或落在只在函数体内才被导入的模块里):
- 直接 import 积木插件的模块(开工文档 §3.2 S1、S2):
manager.py、account_run.py、config_view.py顶层导入maafw_runner.host.*、maafw_runner.core.runner.run_events、maafw_project_update.host.*、maafw_project_update.glue.*、maafw_agent_env.host.*。这三个流程模块只由expander.py、owner.py在函数体内 首次导入。owner.build_owner在函数体内导入maafw_project_update.glue.owner_entry;config.MSSUserConfig.update在函数体内导入maafw_project_update.glue.user_update。 - 直接 import 宿主内部模块(SDK 没有公开):
manager.py顶层from app.core.notify.lifecycle import NotificationTaskBase(管理器的基类,挪不进函数体)。- 函数体内:
app.core.notify.formats.maafw、app.utils.common.process.session.desktop_process_target、app.tools.common.game_calendar.stella(account_run.py);app.task.game.current_game_session(manager.py);app.task.client、app.task.game.game_is_emulator、app.utils.common.game_resolution(config_view.py)。
- 其余宿主能力经 SDK 门面
auto_mas_core.host.*、auto_mas_core.devices.task、auto_mas_core.adapters.script取。
行为上的简化(开工文档 §5.2、§8):
- 执行入口是「L3 外壳 + 沿用的管理器」,L3 的账号循环与
can_run_user不用;L3 收尾可能把脚本状态覆盖成「完成」。 - 宿主不给插件类型绑配置回调:新账号不自动补默认队列(开跑前补)、复制托管不复制视图、删托管不立刻清视图、
配置备份恢复不可用;保存前加密改由账号类覆盖
update()实现。 - L2 给插件准备的预下载路径没有传给管理器(
after_config_lock在插件路径上不挂),预下载过的发行包可能再下一次。 - 「仅更新」模式对插件类型不走插件路径。没有桌面分身。
- 托管与账号载荷从
UserData变成users,多了小写的info;前端是否都读得到没有核实。
测试
单元测试只留本地(tests/ 已写进 .gitignore)。
发布
由 AUTO-MAS-Project 的 publish.yml 使用 pypi 环境与同组织的 PyPI Trusted Publisher 完成;只有匹配包版本的发布标签会上传分发包。
Metadata
Release files for auto-mas-mss-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)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| auto_mas_mss_adapter-0.1.0.tar.gz | 76.3 kB | With provenance | Details for auto_mas_mss_adapter-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| auto_mas_mss_adapter-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for auto_mas_mss_adapter-0.1.0-py3-none-any.whl |
Total release size: 158.8 kB
Release files / auto_mas_mss_adapter-0.1.0.tar.gz
| Download URL | auto_mas_mss_adapter-0.1.0.tar.gz |
|---|---|
| Size | 76.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9c92e5fe7de3f0ec3a7cdd3ca9f015d1d329eb8fbc081993a30e70ed1e16b0cf
|
|
BLAKE2b-256 checksum How to use checksums |
1690e17437c08ce05c1281b0ee4a29eb2f3cd4ea6a13ffd771514c740f23d516
|
| 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 22, 2026.
Transparency logRelease files / auto_mas_mss_adapter-0.1.0-py3-none-any.whl
| Download URL | auto_mas_mss_adapter-0.1.0-py3-none-any.whl |
|---|---|
| Size | 82.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7d1ef3ed30ad20edb81b6986c080b34e700df7857424e3082107b7b940dbbf25
|
|
BLAKE2b-256 checksum How to use checksums |
daeae48d7b6a14de77d66809c934673e1835b3089c76fef1ecb95aa4d8aee2ae
|
| 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 22, 2026.
Transparency logSecurity for auto-mas-mss-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.
Attestation for auto_mas_mss_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 22, 2026.
Transparency logA 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.