docs(console): document Host-page and embedded build workflows

- explain the persistent Host and disposable iframe ownership model
- define SDK compatibility and PWA cache boundaries
- document independent debug servers and release embedding
- record Node, npm, NPM, and WASMELD_BUILD_WEB requirements
- update repository structure and startup commands
This commit is contained in:
Maofeng
2026-07-30 09:22:10 +08:00
parent f6ad94e948
commit ccad05fa5a
3 changed files with 130 additions and 3 deletions
+16 -3
View File
@@ -34,9 +34,9 @@ Host driver <- validated operation <- raw effect <-
```text
crates/wasmeld-runtime Component Runtime 与 Sandbox
crates/wasmeld-console 管理 API 与持久化
└── web/ Solid + Tailwind v4 管理面
crates/wasmeld-package wasmeld CLI、组件包与 WIT 依赖管理
components/ 示例 Component
console/ TanStack Start 管理面
wit/ Wasmeld WIT package 源码
```
@@ -65,13 +65,26 @@ curl http://127.0.0.1:8081/v1/services/echo/invoke \
--data-binary 'hello'
```
管理面:
管理面开发服务器
```bash
cd console
cd crates/wasmeld-console/web
npm ci
npm run dev
```
打开 `http://127.0.0.1:3000`。开发期间 Rust 和 Web 独立增量构建;Release 构建会自动
构建 Web 并嵌入 `wasmeld-console`
```bash
cargo +stable build --release -p wasmeld-console
./target/release/wasmeld-console
```
此时管理面直接由 `http://127.0.0.1:8080` 提供,不需要部署单独的静态站点。Host +
iframe 页面生命周期、PWA 缓存和前端目录约定见
[`Console Web 文档`](crates/wasmeld-console/web/README.md)。
## 组件开发
Console 启动后,使用开发模式监听组件源码和本地 WIT `replace`