| name | mas-script-specialized-adapter |
| description | Guide specialized AUTO-MAS integration by script frontend architecture (MAA / SRC / MXU-line like MaaEnd / MFAA-line like M9A / ok-script like Okww). Before coding: run script-architecture intake (prefer repo URL). Surfaces first, then backend. Code norms: references/adapter-code-norms.md. |
专项适配（前端表面优先）
使用前：脚本架构问诊 → 再开工（必做）
专项适配按脚本前端架构区分。加载本 Skill 后、写任何实现前：
- 请用户提供脚本/Git 仓库链接（多仓可都要）。
- Agent 研判 README、目录信号，对照下表归纳架构线。
- 请用户确认后再写代码；无仓库则口述 + script-frontend-architectures.md 问诊项。
UI 开工前必问
- 图标来源与落地路径（
frontend/src/assets/<slug>.ico）、替换入口（列表/弹窗/编辑页）。
- 用户可见文案统一写法（如
ok-ww）vs 技术标识（Okww、ScriptType、OpenAPI 名）。
落地流程（ok-script 等）
- 先验证：
General 跑通启动、日志（可临时预设）。
- 再专项：新增
ScriptType，迁移默认值到专项页。
- 最后清理：删除 General 临时入口。
流程与验证
代码规范（必遵守，替代排查叙事）
全仓新增 ScriptType：adapter-code-norms.md（注册、前端表面、任务模块、代码质量、Manager 规范、check() 消息、General 对齐原则）。
Okww 增量：examples-okww.md · 实现规范。
通用代码质量规范（所有适配通用，见 adapter-code-norms §6-9）：
- hasattr() 消除 → 显式
__init__ 初始化
- 原子化文件操作（tmp + rename）
- DRY 提取共用恢复逻辑
- 独立 try/except 每操作
- unlock-then-write 顺序
- check() 消息用户可操作
| 架构线 | 含义 | 本仓 ScriptType |
|---|
| MAA 线 | MAA 系配置会话、计划表 | MAA |
| SRC 线 | 大表单 + Section | SRC |
| MXU 线 | MaaEnd + MXU、mxu-*.json | MaaEnd |
| MFAA 线 | M9A 队列 JSON，无 ScriptConfig 壳 | M9A |
| General | 通用路径/进程/日志 | General |
| ok-script | -t/-e CLI + 表单化配置编辑器 | Okww |
确认架构后读上游 自启动（argv vs 写盘）与 配置落盘（表单编辑器 vs ScriptConfig GUI vs 仅写 JSON）。MFAA 见 examples-m9a.md；MXU 见 examples-maaend.md；ok-script 见 examples-okww.md。
架构取向
主要对象是前端表面（EditView/、Scripts.vue、Section）；后端 app/task/Xxx/ 同 PR 补齐。先加载 mas-skills，配合 mas-module-boundary、mas-data-model、mas-api-contract、mas-code-standards。
前端表面清单
| 表面 | 要点 |
|---|
| Hub | Scripts.vue / ScriptTable.vue：ScriptType → URL 片段 |
| 脚本/用户编辑 | EditView/Script/、EditView/User/；Section 单职责 + @save |
| 映射 | types/script.ts、useScriptApi.ts（含 UserConfig→users[]） |
| 路由 | router/index.ts 与 Hub 片段一致 |
| 配置入口 | ok-script 线：表单化编辑器（非 ScriptConfig GUI）；MXU/MAA：ScriptConfig teleport 遮罩 + WebSocket |
| 配置 Schema | 表单化编辑器需 config_schema.py（字段类型/选项/翻译）+ API 端点 + 前端 Service |
后端切面
XxxConfig / XxxUserConfig、SCRIPT_BOOK、task_manager、app/task/Xxx/（Manager、AutoProxy；按需 config_schema.py 或 ScriptConfig；须实现 final_task / on_crash）。
UI 分段（默认）
脚本编辑三段：基本信息 / 游戏配置 / 运行配置。用户编辑三段：基本 / 任务 / 通知。Okww 游戏段：Enabled、LaunchBeforeTask、CloseOnFinish 独立；见 examples-okww · 实现规范。
完整开发工作流（Agent 执行清单）
以下为 Agent 接到「新增 ScriptType」任务时的标准流程：
阶段 1：架构确认
- 获取上游仓库 URL → 读 README、CLI 参数、配置方式
- 对照 script-frontend-architectures.md 确认架构线
- 与用户确认架构线 + UI 文案（如
ok-ww vs Okww）
阶段 2：前端表面
Scripts.vue：新增 ScriptType Hub 分支（handleEditScript / handleAddUser / handleEditUser / handleConfirmAddScript）ScriptTable.vue：卡片图标 + 操作按钮router/index.ts：新增 URL 片段路由types/script.ts：ScriptType 枚举、默认 config 结构useScriptApi.ts：类型判断 + UserConfig→users[] 两处分支OkwwScriptEdit.vue：脚本编辑三段OkwwUserEdit.vue：用户编辑 + 配置编辑器（按架构线选型）- 图标：
frontend/src/assets/<slug>.ico
阶段 3：后端注册
app/models/config.py：XxxConfig / XxxUserConfigapp/models/schema.py：schema 注册app/core/config.py：isinstance 分支app/api/scripts.py：SCRIPT_BOOK / USER_BOOKapp/utils/constants.py：TYPE_BOOK 展示文案yarn openapi → 确认 openapi.json 含新类型
阶段 4：任务模块
app/task/Okww/__init__.pyapp/task/Okww/manager.py：METHOD_BOOK、check/prepare/main_task/final_task/on_crashapp/task/Okww/AutoProxy.py：init、check、prepare、main_task、final_task、on_crash、进程/日志/游戏管理- 按需：
config_schema.py 或 ScriptConfig.py
app/core/task_manager.py：注册
阶段 5：自检与清理
- 对照 adapter-code-norms.md §10 逐项检查
- 对照对应
examples-*.md 实现规范
- 删除 General 临时预设入口（如有）
原则
- Agent 必须修改所有相关文件，不遗漏任何分支（Hub 四处分支、useScriptApi 两处分支、TYPE_BOOK 等）
- 对齐最接近的表面模板；一次打通 Hub + 编辑 + 后端；勿手改
frontend/src/api/models/*
- 通用代码质量规范（hasattr 消除、原子 I/O、DRY、独立 try/except）对所有专项适配生效
进一步阅读
提交前自检
对照 adapter-code-norms.md；Okww 另对照 examples-okww · 实现规范。
