update-local-mfw
Skill424 starsChanged 39 days agoMITView on GitHub
更新本机开发用 LocalBridge 实际加载的 MaaFramework 动态库与 MaaAgentBinary。用于“更新本地 mfw 依赖”“更新本地运行时”或已确认运行时过旧后的更新请求;不用于同步参考源码、修改 Go Binding 或开发产品内更新功能。
In this repository11 other files it gives its agents.
- AGENTS.mdAGENTS.md
- ant-designSkill
- maafwSkill
- mpe-background-artSkill
- react-flow-node-tsSkill
- shadcnSkill
- sync-reference-projectsSkill
- tauri-for-mpeSkill
- ui-ux-pro-maxSkill
- web-design-guidelinesSkill
- zustand-store-tsSkill
The file
Files
使用仓库根目录的统一入口 yarn lb:update,先阅读 dev/docs/本地MaaFramework依赖更新.md。目标版本默认来自当前源码 Editor/src/stores/app/configStore.ts 的 mfwVersion,不要擅自改成 latest 或修改该版本声明。
执行流程
- 先运行
yarn lb:update --dry-run,检查版本和目标 bin 目录。默认更新LocalBridge/build/runtime/maafw/bin;其他构建位置使用--binary-dir指定可执行文件目录。结合启动日志的“使用自带库路径”核对目标。 - 用户明确要求更新本地依赖即已授权执行,无需重复确认。仅添加/修改更新能力的请求不等于要求立即替换本机依赖。仅排查错误时先诊断,不因统一的“请更新”提示就自动更新。
- 更新前确认没有 LocalBridge / Agent 使用该目录。不要直接终止来源不明的进程;若无法确定实际加载路径或相关进程的归属,先询问必要信息。
- 执行
yarn lb:update,使用与预览相同的参数。其他构建位置使用--binary-dir指定可执行文件目录,依赖固定写入其runtime/maafw子目录。不能绕过目录检查。 - 下载器对临时网络问题每个请求最多追加 2 次重试(5 秒、15 秒),不要在外层再叠加自动重试。认证、证书校验、文件占用、校验或解压失败时停止并汇报。
- 汇报实际版本、目标目录和验证结果。文件大小/摘要、包结构校验通过不等于动态库已成功加载。按当前平台可用工具检查此前缺失的符号;最终由 LocalBridge 重启后的实际加载路径和初始化日志确认。未重启验证时如实说明,并列出用户需要检查的内容。
命令同时替换 bin、share/MaaAgentBinary 和 .version,不保留旧版本备份。替换期间临时保存旧组件用于异常回滚,成功或回滚完成后自动清理;仅回滚未完成时保留恢复文件并报告位置。不要清理用户资源、关闭证书校验或改写 Go Binding。参考源码更新仍使用 sync-reference-projects 技能。
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

