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
+20
View File
@@ -10,6 +10,7 @@
- 通过独立 Gateway 转发原始二进制调用
- 为导入 `wasmeld:kv/store@0.1.0` 的 Component 提供持久化 KV
- 暴露调用计数、状态和最近事件
- 在 Release 可执行文件中嵌入 Solid + Tailwind v4 管理面
Wasm 制品保存在本地文件系统。服务 manifest、调用计数和最近 256 条事件通过
[Toasty](https://github.com/tokio-rs/toasty) 写入本地 libSQL 数据库,默认路径是
@@ -38,6 +39,25 @@ Console 或 Runtime 重启后可由 Wasmtime 直接复用;缓存不包含 Acto
cargo +stable run -p wasmeld-console
```
Debug 构建只启动 API,不构建或提供 Web 静态文件。前端开发服务器需要单独启动:
```bash
cd crates/wasmeld-console/web
npm ci
npm run dev
```
Release 构建会自动使用 `package-lock.json` 构建并嵌入管理面:
```bash
cargo +stable build --release -p wasmeld-console
./target/release/wasmeld-console
```
发布构建要求 Node.js 22.13+ 和 npm。可用 `NPM` 指定 npm 可执行文件;设置
`WASMELD_BUILD_WEB=1` 可以在非 Release Cargo 构建中验证嵌入流程。前端结构和 PWA
边界见 [`web/README.md`](web/README.md)。
进程默认启动两个独立 Listener:
- 管理 API`127.0.0.1:8080`