diff --git a/MiniApp/Demo/git-graph/README.md b/MiniApp/Demo/git-graph/README.md index 86c8a8f9..c2115c82 100644 --- a/MiniApp/Demo/git-graph/README.md +++ b/MiniApp/Demo/git-graph/README.md @@ -70,11 +70,11 @@ miniapps/git-graph/ 3. **Install dependencies**: inside the MiniApp's app directory, run: - `bun install` or `npm install` (matching the runtime BitFun detected) - - Or use the "Install Dependencies" action in Toolbox (calls `miniapp_install_deps`) + - Or use the "Install Dependencies" action in the Mini Apps gallery (calls `miniapp_install_deps`) 4. **Compile**: to regenerate `compiled.html`, call `miniapp_recompile` or let BitFun compile automatically when the MiniApp is opened. -5. Open the MiniApp in the Toolbox scene, pick a repository, and the Git Graph will appear. +5. Open the MiniApp in the Mini Apps gallery, pick a repository, and the Git Graph will appear. ### Permissions @@ -159,11 +159,11 @@ miniapps/git-graph/ 3. **安装依赖**:在 MiniApp 的 app 目录下执行: - `bun install` 或 `npm install`(与 BitFun 检测到的运行时一致) - - 或在 Toolbox 中对该 MiniApp 执行「安装依赖」操作(调用 `miniapp_install_deps`) + - 或在 Mini Apps 画廊中对该 MiniApp 执行「安装依赖」操作(调用 `miniapp_install_deps`) 4. **编译**:若需重新生成 `compiled.html`,可调用 `miniapp_recompile` 或由 BitFun 在打开该 MiniApp 时自动编译。 -5. 在 Toolbox 场景中打开该 MiniApp,选择仓库后即可查看 Git Graph。 +5. 在 Mini Apps 画廊中打开该 MiniApp,选择仓库后即可查看 Git Graph。 ### 权限说明 diff --git a/MiniApp/Skills/miniapp-dev/SKILL.md b/MiniApp/Skills/miniapp-dev/SKILL.md index 14b7206d..904527df 100644 --- a/MiniApp/Skills/miniapp-dev/SKILL.md +++ b/MiniApp/Skills/miniapp-dev/SKILL.md @@ -1,6 +1,6 @@ --- name: miniapp-dev -description: Develops and maintains the BitFun MiniApp system (Zero-Dialect Runtime). Use when working on miniapp modules, toolbox scene, bridge scripts, agent tool (InitMiniApp), permission policy, or any code under src/crates/core/src/miniapp/ or src/web-ui/src/app/scenes/toolbox/. Also use when the user mentions MiniApp, toolbox, bridge, or zero-dialect. +description: Develops and maintains the BitFun MiniApp system (Zero-Dialect Runtime). Use when working on miniapp modules, Mini Apps gallery, bridge scripts, agent tool (InitMiniApp), permission policy, or any code under src/crates/core/src/miniapp/ or src/web-ui/src/app/scenes/miniapps/. Also use when the user mentions MiniApp, miniapps, bridge, or zero-dialect. --- # BitFun MiniApp V2 开发指南 @@ -52,14 +52,16 @@ src/crates/core/src/agentic/tools/implementations/ ### 前端 ``` -src/web-ui/src/app/scenes/toolbox/ -├── ToolboxScene.tsx / .scss -├── toolboxStore.ts -├── views/ GalleryView, AppRunnerView +src/web-ui/src/app/scenes/miniapps/ +├── MiniAppGalleryScene.tsx / .scss +├── MiniAppScene.tsx / .scss +├── miniAppStore.ts +├── views/ MiniAppGalleryView ├── components/ MiniAppCard, MiniAppRunner (iframe 带 data-app-id) -└── hooks/ - ├── useMiniAppBridge.ts # 仅处理 worker.call → workerCall() + dialog.open/save/message - └── useMiniAppList.ts +├── hooks/ +│ ├── useMiniAppBridge.ts # worker.call → workerCall() + dialog.open/save/message +│ └── useMiniAppCatalogSync.ts # 列表与运行态同步 +└── utils/ miniAppIcons.tsx, buildMiniAppThemeVars.ts src/web-ui/src/infrastructure/api/service-api/MiniAppAPI.ts # runtimeStatus, workerCall, workerStop, installDeps, recompile src/web-ui/src/flow_chat/tool-cards/MiniAppToolDisplay.tsx # InitMiniAppDisplay @@ -213,7 +215,7 @@ body { ### 前端事件 -后端 `miniapp-created` / `miniapp-updated` / `miniapp-deleted`,前端 `useMiniAppList` 监听刷新。 +后端 `miniapp-created` / `miniapp-updated` / `miniapp-deleted` / `miniapp-worker-*`,前端 `useMiniAppCatalogSync` 统一监听并刷新 store。 ## 场景注册检查清单 diff --git a/MiniApp/Skills/miniapp-dev/architecture.md b/MiniApp/Skills/miniapp-dev/architecture.md index 458cb52c..21af1078 100644 --- a/MiniApp/Skills/miniapp-dev/architecture.md +++ b/MiniApp/Skills/miniapp-dev/architecture.md @@ -7,8 +7,8 @@ AI 对话 → GenerateMiniApp Tool → MiniAppManager::create() → storage.rs 持久化 source + meta.json → compiler.rs 生成 compiled_html(注入 Bridge) → emit miniapp-created 事件 - → 前端 useMiniAppList 监听 → 刷新 GalleryView - → 用户点击「打开」→ AppRunnerView → MiniAppRunner + → 前端 useMiniAppCatalogSync 监听 → 刷新 MiniAppGalleryView + → 用户点击「打开」→ MiniAppScene → MiniAppRunner →