Agent Skills
› kqcoxn/MaaPipelineEditor
› update-local-mfw
update-local-mfw
GitHub用于更新本机开发环境的 MaaFramework 动态库与 Agent 二进制文件。通过 yarn update:mfw 脚本执行，涵盖版本检查、依赖替换及加载验证，确保本地运行时环境正确更新。
Trigger Scenarios
用户明确要求更新本地 mfw 依赖
确认运行时过旧需更新
Install
npx skills add kqcoxn/MaaPipelineEditor --skill update-local-mfw -g -y
SKILL.md
Frontmatter
{
"name": "update-local-mfw",
"description": "更新本机开发用 LocalBridge 实际加载的 MaaFramework 动态库与 MaaAgentBinary。用于“更新本地 mfw 依赖”“更新本地运行时”或已确认运行时过旧后的更新请求；不用于同步参考源码、修改 Go Binding 或开发产品内更新功能。"
}
使用仓库根目录的统一入口 yarn update:mfw，先阅读 dev/docs/本地MaaFramework依赖更新.md。目标版本默认来自当前源码 Editor/src/stores/app/configStore.ts 的 mfwVersion，不要擅自改成 latest 或修改该版本声明。
执行流程
- 先运行
yarn update:mfw --dry-run，检查版本和目标 bin 目录。默认更新LocalBridge/build/runtime/maafw/bin；其他构建位置使用--binary-dir指定可执行文件目录。结合启动日志的“使用自带库路径”核对目标。 - 用户明确要求更新本地依赖即已授权执行，无需重复确认。仅添加/修改更新能力的请求不等于要求立即替换本机依赖。仅排查错误时先诊断，不因统一的“请更新”提示就自动更新。
- 更新前确认没有 LocalBridge / Agent 使用该目录。不要直接终止来源不明的进程；若无法确定实际加载路径或相关进程的归属，先询问必要信息。
- 执行
yarn update:mfw，使用与预览相同的参数。其他构建位置使用--binary-dir指定可执行文件目录，依赖固定写入其runtime/maafw子目录。不能绕过目录检查。 - 下载器对临时网络问题每个请求最多追加 2 次重试（5 秒、15 秒），不要在外层再叠加自动重试。认证、证书校验、文件占用、校验或解压失败时停止并汇报。
- 汇报实际版本、目标目录和验证结果。文件大小/摘要、包结构校验通过不等于动态库已成功加载。按当前平台可用工具检查此前缺失的符号；最终由 LocalBridge 重启后的实际加载路径和初始化日志确认。未重启验证时如实说明，并列出用户需要检查的内容。
命令同时替换 bin、share/MaaAgentBinary 和 .version，不保留旧版本备份。替换期间临时保存旧组件用于异常回滚，成功或回滚完成后自动清理；仅回滚未完成时保留恢复文件并报告位置。不要清理用户资源、关闭证书校验或改写 Go Binding。参考源码更新仍使用 sync-reference-projects 技能。
Version History
- a224594 Current 2026-09-22 11:31
