SuperAPI AI 工具集

plugin-core-builtin-migration

通用与其它

查看项目

更新于 10-16 05:48

技能介绍

用途:把单个 MindOS 渲染器插件改造成稳定、默认、不可缺席的产品能力,并沉淀可复用迁移步骤。触发场景包括要求把某插件改成内置/核心、插件不应可关闭、插件主程序化,或需将旧入口迁移到新主流程并保留兼容迁移能力。

主要能力与目标:注册稳定(渲染器注册有且仅有一个客户端根入口,推荐 SidebarLayout/ShellLayout);默认可用(manifest.builtin = true);不可禁用(manifest.core = true,registry 强制启用);可观测可维护(插件页、设置页、文档、测试一致);历史兼容(旧入口数据有迁移方案);表层语义清晰(区分可管理插件与应用内建能力)。

执行流程:Step 1 盘点现状与边界,确认代码入口 packages/web/components/renderers/<plugin>/manifest.ts、注册入口 packages/web/lib/renderers/index.ts、使用入口 resolveRenderer() 调用链、展示入口 getPluginRenderers(),并判断是否 core、是否存在旧文件协议。Step 2 升级插件声明,设置 builtin、core、appBuiltinFeature,match 保持明确;若替换下线则删除旧 renderer 并重新生成注册文件。Step 3 统一注册机制,在客户端根组件引入 @/lib/renderers/index,移除分散 import,验收任意路由进入插件页不出现 0/0 假空状态。Step 4 历史兼容迁移,在核心数据层实现懒迁移,首次读取自动导入旧格式、写入新格式 JSON、迁移后清理旧入口文件,并提供一次性脚本 scripts/migrate-*.js。Step 5 UI/UX 对齐,插件页、设置页状态与 core 语义一致,appBuiltinFeature 在插件页/设置页/首页 Extensions 一致隐藏。Step 6 同步 wiki/plugins/README.md、wiki/60-stage-plugins.md 及相关 spec。Step 7 测试与回归,覆盖 core 迁移、API 筛选查询、UI smoke、分类隐藏,推荐命令 npm --prefix app run test -- tests/core/content-changes.test.ts tests/api/changes.test.ts。

质量闸门:依次应用产品设计、UI/UX、实现质量、验证视角;迁移逻辑幂等、注册单点化、兼容失败不阻断主流程、最少通过 core/API 回归测试与 lint,UI 变更需人工检查亮色/暗色。

限制与常见坑:只删插件不迁移旧数据会丢失历史;注册入口分散或仅服务端注册会导致客户端 0/0;文档未同步会展示过时入口;core/builtin/appBuiltinFeature 语义混淆;迁移不幂等会重复导入。具体价格、平台支持等信息暂未提供。