Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
98 commits
Select commit Hold shift + click to select a range
c973b9a
feat(bettergi): 涓€鏉¢緳閰嶇疆鏀逛负鍙鍖栭槦鍒楃紪鎺?
TCddddd Sep 4, 2026
e2a7368
Merge branch 'dev' of https://github.com/AUTO-MAS-Project/AUTO-MAS in…
TCddddd Sep 4, 2026
9954506
chore(version): 琛ュ洖鍚堝苟鍐茬獊涓涪澶辩殑 BetterGI 闃熷垪 changelog 鏉$洰
TCddddd Sep 4, 2026
2649df8
feat(bettergi): 一条龙队列交互完善与任务设置面板
TCddddd Sep 4, 2026
6397c1b
chore(bettergi): OpenAPI 重新生成以接入一条龙设置读写接口
TCddddd Sep 4, 2026
8d8ec8a
feat(bettergi): 右栏任务设置补全遗漏字段
TCddddd Sep 5, 2026
bf21dc1
feat(bettergi): 首领讨伐目标弹窗与任务设置面板字段类型扩展
TCddddd Sep 5, 2026
d3cebb5
Merge branch 'dev' into feat/bettergi-onedragon-config
TCddddd Sep 6, 2026
3512202
feat(bettergi): 幽境危战右栏任务设置面板与队列交互细化
TCddddd Sep 6, 2026
0e24364
Merge branch 'dev' into feat/bettergi-onedragon-config
TCddddd Sep 6, 2026
073cdf7
Merge remote-tracking branch 'origin/feat/bettergi-onedragon-config' …
TCddddd Sep 6, 2026
bbe96cc
Merge remote-tracking branch 'upstream/dev' into feat/bettergi-onedra…
TCddddd Sep 6, 2026
f137cbd
feat(bettergi): 一条龙队列顺序落库并按序执行,收口评审整改
TCddddd Sep 6, 2026
ba30836
chore(frontend): 重新生成 API 客户端,一条龙队列字段落库前端
TCddddd Sep 6, 2026
39bd35d
fix(runtime): 修复深色模式下初始化界面连同标题栏整体变暗的问题;修复打包脚本
ClozyA Sep 7, 2026
8fa1192
fix(maa): 代理接管时强制开启开始唤醒的账号切换开关
1w1w11w1 Sep 7, 2026
c8d4173
fix(launch): 启动界面的查看日志入口 (#597)
qiyinxi Sep 7, 2026
03ea687
chore(version): mark PR entry contributors
github-actions[bot] Sep 7, 2026
12fb1e6
fix(maafw): 脚本侧强制停止不再被记成任务完成 (#598)
qiyinxi Sep 7, 2026
54f741a
chore(version): mark PR entry contributors
github-actions[bot] Sep 7, 2026
2207ea7
feat(home): 快速启动支持多选并记住选择 (#596)
Craun718 Sep 7, 2026
c5ca525
chore(version): mark PR entry contributors
github-actions[bot] Sep 7, 2026
678db7b
refactor(logs): 优化日志查看器,移除不必要的导出功能和主题依赖
ClozyA Sep 7, 2026
0e8d94e
refactor(runtime): 精简运行模式有效值的显示,移除来源信息
ClozyA Sep 7, 2026
1cebeff
feat(bettergi): 姣忓懆绉樺/鍦拌剦鑺遍厤缃氦鐢?MAS 鐩磋繛灞傛墭绠★紱鍙虫爮 weekly 骞抽摵閿噸缁勪负 P…
TCddddd Sep 7, 2026
0941228
feat(maa):maa配置项的diff透传
1w1w11w1 Sep 7, 2026
48ed4cc
fix(okww):强制启动器autostart
1w1w11w1 Sep 7, 2026
5b3262c
fix(runtime): uv 下载完成瞬间不再把「安装 Python」段显示成完成 (#602)
qiyinxi Sep 7, 2026
b8cb0be
chore(version): mark PR entry contributors
github-actions[bot] Sep 7, 2026
c6598c8
fix(maa): 停滞提示不再刷新日志活跃度 (#601)
qiyinxi Sep 7, 2026
6371d06
chore(version): mark PR entry contributors
github-actions[bot] Sep 7, 2026
05f1fc5
build(runtime): 更新 Runtime 版本至 v0.1.4
ClozyA Sep 7, 2026
0c53faf
fix(maa): 修复关闭理智作战后活动关优先任务从任务队列消失
1w1w11w1 Sep 7, 2026
5293df5
fix(maa): 修复关闭理智作战后活动关优先任务从任务队列消失 (#605)
1w1w11w1 Sep 7, 2026
0a5bf10
fix(bettergi): 修复右栏设置保存/回显与执行层 Plan 注入,落地新用户空白默认
TCddddd Sep 7, 2026
9c8eb2f
fix(version): 去掉 version.json 里导致解析失败的尾逗号 (#607)
qiyinxi Sep 7, 2026
bc2b1e9
style: 自动格式化代码
github-actions[bot] Sep 7, 2026
8aa60bd
feat(emulator): 新增 Emulator 2.0 模拟器配置形态 (#583)
qiyinxi Sep 7, 2026
bd182cd
chore(version): mark PR entry contributors
github-actions[bot] Sep 7, 2026
39f276e
perf(maafw): 运行环境按项目指纹缓存,并在自动更新后确认一次 (#610)
qiyinxi Sep 8, 2026
51a15ae
chore(version): mark PR entry contributors
github-actions[bot] Sep 8, 2026
bb109b8
style(layout): 为 HomeLayoutDrawer 添加文本颜色样式
ClozyA Sep 8, 2026
3767402
fix(BetterGI): do not treat BGI [ERR]/task-exception as fatal and kil…
TCddddd Sep 8, 2026
abb3817
feat(BetterGI): support multiple independent instances of same combat…
TCddddd Sep 8, 2026
f735b54
feat(zzz-od): 绝区零一条龙专项适配~(∠・ω< )⌒★ (#593)
AthenaHibou Sep 8, 2026
1fa00b7
feat(display): 无人值守时按需挂载虚拟显示器 (#608)
qiyinxi Sep 8, 2026
4106187
chore(version): mark PR entry contributors
github-actions[bot] Sep 8, 2026
61599f7
feat(BetterGI): 一条龙战斗四项逐实例配置落地并补充 changelog
TCddddd Sep 8, 2026
095c7e6
refactor(changelog): 更新日志与版本号收敛到 CHANGELOG.md,并重做应用内展示 (#622)
qiyinxi Sep 8, 2026
cf4d899
chore(version): mark PR entry contributors
github-actions[bot] Sep 8, 2026
bc90621
fix(community): 统一社区签到通知与任务报告 (#625)
Lance0174 Sep 8, 2026
6a163d1
chore(version): mark PR entry contributors
github-actions[bot] Sep 8, 2026
5d5e381
refactor(community): 整合社区签到与日常便笺重构 (#627)
Lance0174 Sep 8, 2026
99b961e
chore(version): mark PR entry contributors
github-actions[bot] Sep 8, 2026
1b80f4a
fix(ws): BetterGI 与 ZZZ-OD 迁移到 Publisher 出口 (#615)
qiyinxi Sep 8, 2026
97335f0
chore(version): mark PR entry contributors
github-actions[bot] Sep 8, 2026
02799a8
fix(BetterGI): 修复执行层多实例排序/超时/日常连坐,按官方源码修正幽境参数
TCddddd Sep 8, 2026
76051df
fix(main): 打开 MCP 后台初始化,$ref 解析加递归深度上限
TCddddd Sep 8, 2026
78bc197
refactor(miyoushe): 移除米游币获取任务
Lance0174 Sep 9, 2026
bf12e3a
feat(maa): 计划表模式下不再强制关闭库存保持 (#585)
jinghero Sep 9, 2026
25257de
chore(version): mark PR entry contributors
github-actions[bot] Sep 9, 2026
1c071a3
fix(log_box/LogMonitor): 修复log_box及LogMonitor在跨零点时采集节点与日志历史丢失的问题 (#626)
AthenaHibou Sep 9, 2026
7f29f3c
chore(version): mark PR entry contributors
github-actions[bot] Sep 9, 2026
70630eb
chore(changelog): 修正误签的条目署名并按提交作者补齐
qiyinxi Sep 9, 2026
4e578d6
fix(emulator2): 带包启动改为三路齐发,并挡住被别家模拟器顶包的序列号 (#635)
qiyinxi Sep 9, 2026
1704115
chore(version): mark PR entry contributors
github-actions[bot] Sep 9, 2026
e99f556
chore(changelog): 把 #635 的署名补回唯一手写来源
qiyinxi Sep 9, 2026
9dc1e60
chore(maafw): 按历史记录保留天数清理 MFW 原生日志备份 (#640)
qiyinxi Sep 9, 2026
3e519e1
fix(hsr): 三月七助手收尾崩溃不再把已完成的模块判为失败 (#639)
qiyinxi Sep 9, 2026
aefd2ec
refactor(home): 首页卫星图标改从全局脚本图标表取,新增专项不会再漏 (#642)
qiyinxi Sep 9, 2026
d6567ab
fix(display): 虚拟显示器说明里的驱动一句可直接点开下载页 (#644)
qiyinxi Sep 9, 2026
17e0817
feat(maafw): 启动模拟器时按项目包名一并拉起游戏 (#638)
qiyinxi Sep 9, 2026
3d34bdd
fix: dev 全量审计批量修复(MFW 旧引擎/等待时长/增量更新/控制方式、HSR 周口径、M9A、主页时区、CNB 同步) (#641)
qiyinxi Sep 9, 2026
7403f3c
fix(BetterGI): 修复队列关闭的战斗任务仍被执行与日常无任务时挂死
TCddddd Sep 9, 2026
c60fd8a
Merge remote-tracking branch 'upstream/dev' into feat/bettergi-onedra…
TCddddd Sep 9, 2026
e51267e
fix(BetterGI): 同步 dev 后补回本分支一条龙端点并重生成前端 API 代码
TCddddd Sep 9, 2026
615d602
fix(BetterGI): 恢复合并中被 dev 覆盖的两处端点改动并对齐前端调用
TCddddd Sep 10, 2026
e0e857b
fix(zzzod): 清理启动链路泄漏的 uv 环境变量 (#646)
AthenaHibou Sep 10, 2026
ab3f7c7
docs: 将 BetterGI 一条龙 changelog 补入 CHANGELOG.md 并同步生成物
TCddddd Sep 10, 2026
3ec954b
ci(build): 从构建分支读取 Runtime 版本
ClozyA Sep 10, 2026
0b3bb0a
fix(runtime): 补齐 Runtime 链路的代理透传与失败可诊断性 (#647)
qiyinxi Sep 10, 2026
5174847
chore(version): mark PR entry contributors
github-actions[bot] Sep 10, 2026
21be899
fix(i18n): 补齐 BetterGI 面板缺失的 bettergi 翻译键(三语)
TCddddd Sep 10, 2026
43eb9e0
chore(version): 更新版本至 v5.5.0-beta.4,包含新增、变更和修复
ClozyA Sep 10, 2026
e6ffe03
fix(runtime): 后端就绪前退出时给出「重建环境」入口 (#645)
qiyinxi Sep 10, 2026
74aa8b1
chore(version): mark PR entry contributors
github-actions[bot] Sep 10, 2026
c115792
fix(maa): 用户配置页在缺少分服关卡数据时不再整页崩溃 (#618)
qiyinxi Sep 10, 2026
f3aec75
chore(version): mark PR entry contributors
github-actions[bot] Sep 10, 2026
db0ab3e
fix(emulator): MuMu 命令输出混有日志时仍能取到设备信息 (#621)
qiyinxi Sep 10, 2026
ad92881
chore(version): mark PR entry contributors
github-actions[bot] Sep 10, 2026
f32bbc5
feat(display): 虚拟显示器改为常驻监测,不再随任务插拔 (#650)
qiyinxi Sep 10, 2026
0fd61ff
chore(version): mark PR entry contributors
github-actions[bot] Sep 10, 2026
7f62172
fix(BetterGI): 淇涓€鏉¢緳閰嶇疆绉樺閫夋嫨鍣ㄩ€€鍖栦笌鍙虫爮璁剧疆淇濆瓨鎶ラ敊
TCddddd Sep 10, 2026
275e21b
chore(changelog): 精简 beta.1–beta.4 更新日志
qiyinxi Sep 10, 2026
d18a433
Merge remote-tracking branch 'upstream/dev' into feat/bettergi-onedra…
TCddddd Sep 10, 2026
bd3ce52
feat(zzz-od): 脚本管理页用户卡片新增标签展示 (#651)
AthenaHibou Sep 10, 2026
489c4ed
chore(version): mark PR entry contributors
github-actions[bot] Sep 10, 2026
d15d639
Merge branch 'dev' into feat/bettergi-onedragon-config
TCddddd Sep 10, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
6 changes: 3 additions & 3 deletions .agents/skills/mas-code-standards/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ Use these samples as style lenses only. For frontend engineering or UI decisions
4. Match nearby naming, logging tone, comment style, and result contracts.
5. Prefer minimal edits that blend into surrounding code rather than style-driven rewrites.
6. If recent maintainer review comments are available for the same area, treat them as the strongest style signal.
7. Before completing a user-visible feature or fix, add its `res/version.json` entry under the next unreleased version; treat the entry as part of the implementation rather than a reminder. Add exactly one entry per PR, written as one concise sentence summarizing the PR's significance; condense all changes into that sentence.
7. Before completing a user-visible feature or fix, add its `CHANGELOG.md` entry under the top (unreleased) version section and run `python scripts/changelog.py sync` so the generated `res/version.json` stays in step; treat the entry as part of the implementation rather than a reminder. Add exactly one entry per PR, written as one concise sentence summarizing the PR's significance; condense all changes into that sentence.

## Commit Lenses
1. `e541fa5f`: small cleanup.
Expand Down Expand Up @@ -75,7 +75,7 @@ Protect these comments especially:
7. Do not split equivalent behavior into multiple methods or API routes when a dict selector or type field represents the difference directly.
8. Do not leave dead support paths for future detailed/raw config when there is no complete UI-to-runtime path yet.
9. Do not add maintainer-facing "safety" code that only repeats guarantees already enforced by base classes or validators.
10. Do not complete a user-visible feature or fix without adding a matching `res/version.json` entry under the next unreleased version.
10. Do not complete a user-visible feature or fix without adding a matching `CHANGELOG.md` entry under the top (unreleased) version section.
11. Do not delete useful comments just to make a diff look cleaner.

## Review Checklist
Expand All @@ -91,4 +91,4 @@ Protect these comments especially:
10. Commit messages and scopes follow the project convention when preparing commits.
11. Backend comments and config-class annotations use the project style rather than ad hoc prose.
12. Existing useful comments were preserved or updated accurately, not removed as noise.
13. User-visible features and fixes include their matching `res/version.json` entry under the next unreleased version.
13. User-visible features and fixes include their matching `CHANGELOG.md` entry under the top (unreleased) version section, with `res/version.json` regenerated.
7 changes: 5 additions & 2 deletions .agents/skills/mas-script-specialized-adapter/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -43,7 +43,8 @@ description: >-
[M9A/MFAA](references/examples-m9a.md) ·
[Okww](references/examples-okww.md) ·
[OkNte](references/examples-oknte.md) ·
[HSR](references/examples-hsr.md)
[HSR](references/examples-hsr.md) ·
[ZzzOd](references/examples-zzzod.md)
需要画面文本识别(登录/切号/按钮定位)时另读 [OCR 工具](references/ocr-tools.md)
4. 现场反查全部注册调用者与相邻实现,再定最小改动。**不要从旧 Skill 文案推断当前行为。**
5. 用用户场景验收:少了哪段手工配置?补位有无明确输入、失败提示、回退路径?
Expand All @@ -59,8 +60,9 @@ description: >-
- 配置与 schema:`app/models/config.py`、`app/models/schema.py`
- 注册与 API:`app/core/config.py`、`app/api/scripts.py`、`app/core/task_manager.py`、`app/utils/constants.py`
- 任务模块:`app/task/Xxx/` 的 `manager`、`AutoProxy`,按架构需要增加 `ScriptConfig`
- 日志采集推送:需要把脚本运行日志关键节点推送至任务报告时,用通用组件 `log_box`(用法见 [logbox-api.md](references/logbox-api.md)),专项只喂参数(日志路径/规则/处理器)并注入 sink。「是否展示节点详情」由专项(或其用户配置)的开关在**是否创建/启用 log_box 的入口**消费(关闭即不创建,省采集开销),不要给 log_box 加通用开关,也不要在聚合层采后过滤(参考 okww 用户级 `Notify.PushLogEnabled`)。**报告注入是硬约束**:只采集不注入,报告就只有总体状态、看不到节点——采集结果必须进入最终报告正文且保留各用户节点归属(多账号时用户结果行与节点详情按用户交错);聚合与追加统一复用通用工具 `app/tools/push_log.py`(`build_user_result_text` 按用户交错组装「用户结果行+节点」并入 result / `append_push_log`),专项不要自行拼接实现。具体注入端点(管理器汇总 / 通知正文追加)现场反查参考实现。
- 日志采集推送:需要把脚本运行日志关键节点推送至任务报告时,用通用组件 `log_box`(用法见 [logbox-api.md](references/logbox-api.md)),专项只喂参数(日志路径/规则/处理器)并注入 sink。**接入前确认脚本日志滚动行为**:有 inode(本地 NTFS)时一律按 inode 找回,与运行日志监控 LogMonitor 同逻辑,宁缺勿错不猜名字;**仅文件系统不提供 inode(FAT32/exFAT/网络盘)时需要传 `rotated_name` strftime 模板**(日期式滚动的唯一兜底,通用组件不猜测任何日期格式);`.bak` 式无需声明;删除重建/截断式滚动无法自动找回(见 logbox-api「日志轮转补偿」)。「是否展示节点详情」由专项(或其用户配置)的开关在**是否创建/启用 log_box 的入口**消费(关闭即不创建,省采集开销),不要给 log_box 加通用开关,也不要在聚合层采后过滤(参考 okww 用户级 `Notify.PushLogMode`)。**报告注入是硬约束**:只采集不注入,报告就只有总体状态、看不到节点——采集结果必须进入最终报告正文且保留各用户节点归属(多账号时用户结果行与节点详情按用户交错);聚合统一复用通用工具 `app/tools/push_log.py` 的 `build_user_result_text`(按用户交错组装「用户结果行+节点」并入 result),专项不要自行拼接实现。具体注入端点现场反查参考实现。
- 视觉识别:专项需要画面文本识别时,**新逻辑用共享工具 `app/tools/ocr.py`**(用法见 [ocr-tools.md](references/ocr-tools.md)),交互层(截图/激活/点击)专项自持;MaaEnd 登录仍为历史私有 OCR,未迁移前不强制改造
- 配置备份恢复:专项需要把运行/会话前会被 MAS 触碰的配置做跨会话持久快照与一键恢复时,**文件级原语用 `app/utils/config_archive.py`**(用法见 [config-archive.md](references/config-archive.md)),专项只提供备份对象(目录/文件集)与恢复后语义钩子;**恢复功能(列表/预览/详情/一键恢复)用通用服务 `app/utils/config_restore.py` + 前端组件 `ConfigRestoreSection.vue`**(用法见 [config-restore.md](references/config-restore.md)),专项只传目标池回调/API/专项统一名,会话遮罩用 `GuiSessionMask.vue`;不要给公共原语或通用组件加专项分支。**归档三时机**(`ConfigRestoreTarget.snapshot` + `service.ensure`):① 编辑界面进入时归档 MAS 会触碰的原生配置(捕捉「MAS 操作前原始态」——配置在 MAS 之外就可能已被修改);② 编辑界面退出时归档 MAS 侧配置终态(MAS 侧修改一定发生在 MAS 内,退出即备份);③ 运行前归档(原生配置可能在 MAS 之外被改)。所有归档走指纹去重(内容无变化自动跳过),覆盖性操作(导入/恢复)前另做强制归档。
- 前端入口:`Scripts.vue`、`ScriptTable.vue`、router、`types/script.ts`、相关 composable、脚本/用户编辑页
- Electron 能力:仅当需要注册表、文件系统或进程发现时增加 `electron/services`、IPC、preload 与类型声明
- 生成代码:后端 schema 变更后运行生成器,禁止手改 `frontend/src/api/**`
Expand All @@ -86,6 +88,7 @@ description: >-
| General | 用户 / 直控 两态 |
| MaaEnd | 脚本 / 用户 两态 |
| OkNte | 两态(`Info.Mode` 脚本 / 用户) |
| ZzzOd | 用户 / 直控 两态(用户=字段化注入绑定槽,直控=页面直编所选实例原生配置、运行原生裸跑;**每脚本限一个直控用户**,多账号在直控页实例管理里配,见 examples-zzzod) |
| M9A | 不使用这套模式 |

采用三态时:**脚本**=脚本级共享配置;**用户**=当前用户独立配置;**直控**=直接使用脚本原有配置、由原生 GUI 维护、不回写 MAS 独立配置。三态只决定 owner。
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,81 @@
# 配置归档:共享持久快照 / 恢复原语用法

> 适用:专项需要把「运行或配置会话前会被 MAS 触碰的配置文件」做**跨会话持久**
> 快照(可列出、可一键恢复)时。原语在 `app/utils/config_archive.py`,与脚本
> 解耦——专项只提供**备份对象**(目录或文件集)与**恢复后的语义钩子**,不关心
> 时间戳、去重、保留清理怎么做。

一句话链路:专项在「动手前」喂备份对象 + `store_root` → 原语时间戳归档 /
指纹去重 / 保留清理 → Web 或本地按时间倒序列出 → `restore_dir` 整目录回写 →
专项执行恢复后语义(字段回填、重建视图、清残留)。

> 上层「配置恢复」(列表 / 预览 / 一键恢复的服务与前端组件、会话遮罩)见
> [config-restore.md](config-restore.md);本文件只讲文件级快照/回写原语。

参考实现:`app/task/ZzzOd/tools/backup_archive.py`(两条视角:一条龙原生配置
= 文件集、MAS 用户槽 = 整目录)。

## 原语一览(签名现场读模块确认)

| 原语 | 用途 |
| --- | --- |
| `archive_dir(src, store_root, *, keep, force)` | 整个目录快照;内容与最近一份一致时跳过,返回 `None` |
| `archive_files(files, store_root, *, keep, force)` | 文件集快照(`{rel_key: Path}`),保留相对结构,供分散/部分备份 |
| `restore_dir(store_root, ts, target)` | 整目录替换 `target`(先删后拷) |
| `list_times(root)` | 时间倒序时间戳(目录名即时间戳) |
| `get_backup_dir(store_root, ts)` | 定位单份归档;`ts` 非法格式或目录不存在返回 `None`(报错由调用方/`restore_dir` 负责) |
| `dir_files(source)` | 目录 → 相对文件集 |
| `file_set_hash(files)` | 文件集指纹(rel 键 + 大小 + 字节) |

关键语义:

- **去重**:与最近一份指纹一致则跳过(`file_set_hash` 相同)。
- **`force=True`**:内容一致也强制归档——恢复前存底,让「恢复前的配置」必然有
自己的时间戳条目。
- **`keep`**:每个 `store_root` 独立保留池,超出清理最旧;默认 `KEEP_COUNT=10`。
- 目录名即时间戳(`%Y%m%d-%H%M%S`,同秒冲突加 `-N` 后缀)。

## 分层职责(关键,别混)

`app/utils/config_archive.py` 只做**文件/目录级快照与回写**,不感知任何脚本结构:

- 什么算「配置」(含排除规则,如 ZzzOd 排除 `MAS-` 槽)由**专项的收集函数**决定。
- 归档时机(`set_*` 注入前、配置会话基线注入前、直控页进入前)由专项编排。
- 恢复后动作(字段回填到 MAS 表单、重建合成视图、清 sidecar)由专项在
`restore_dir` 之后执行——原语不隐含任何业务。

**不要往公共原语里加专项分支或 any 类型参数**;专有逻辑进专项或邻近 helper。

## 接入步骤

1. 定 `store_root` 布局,专项独立(如 `data/{script_id}/{Adapter}Backups/...`);
一个根下分多类(如 `onedragon` / `mas/{slot}`)各自成独立保留池。
2. 定备份对象:整目录 → `archive_dir`;只挑部分文件 → 收集函数 + `archive_files`。
3. 在「动手前」挂归档点,用 `suppress(Exception)` 包裹——归档失败绝不中止运行
(ZzzOd `AutoProxy._prepare_injection` / `ScriptConfigTask` 为参考)。
4. 恢复:先 `force=True` 归档当前 → `restore_dir` 回写 → 专项执行恢复后语义;
误恢复必须可找回(「恢复前状态」在列表里有明确条目)。
5. UI 列备份:`list_times` 倒序。

## 参数化兼容(槽原理不同也成立)

| 专项差异 | 吸收方式 |
| --- | --- |
| 槽/目录布局不同 | `src` 任意目录;`store_root` 按专项定义(模块级 layout 函数归专项) |
| 只备份子集 / 需排除运行时内容 | `archive_files` + 专项收集函数 |
| 保留份数不同 | `keep` 参数 |
| 恢复语义(回填/视图/sidecar) | 专项恢复后钩子,原语只回写文件 |
| 运行中实时共享文件 | 原语不覆盖;用专项既有锁(SRC 式串行化)防恢复与运行抢文件 |

硬限制:原语只覆盖**文件型**配置;非文件状态(注册表快照如 HSR 分辨率、进程态)
由专项自理。ConfigItem 字段与原生 YAML 的往返留在专项,归档层从不解析脚本配置。

## 检查清单

- [ ] `store_root` 专项独立,保留池边界明确
- [ ] 归档点捕获的是未被本次 MAS 操作触碰的状态(动手前)
- [ ] 恢复前 `force` 归档当前,误恢复可找回
- [ ] 恢复后业务(回填 / 视图 / sidecar)在专项层
- [ ] 归档包 `suppress`,失败不中止运行
- [ ] 公共原语无专项分支
- [ ] `tests/task/` 有最小回归(去重跳过 + 恢复闭环,参照 `test_zzzod_config_yaml.py`)
Loading
Loading