什么是 WU

此示例展示涉及的文件，假设项目已通过 bundler 解析 import ... from 'wu-framework'，并能提供应用文件；它不是安装教程。第一个应用会准备该环境。

shell HTML 包含 <div id="hello-slot"></div>，其客户端模块执行：

import { wu } from 'wu-framework';

await wu.init({
  apps: [{ name: 'hello', url: '/apps/hello' }],
  sandbox: 'module',
});

await wu.mount('hello', '#hello-slot');

该 URL 提供文件 /apps/hello/wu.json：

{
  "name": "hello",
  "entry": "assets/hello.js",
  "styleMode": "own-only",
  "wu": { "permissions": [] }
}

bundle assets/hello.js 在求值时注册应用：

import { wu } from 'wu-framework';

wu.define('hello', {
  mount(container) {
    const heading = document.createElement('h2');
    heading.textContent = 'Hola desde WU';
    container.append(heading);
  },
  unmount(container) {
    container.replaceChildren();
  },
});

wu.mount 完成后，容器显示 Hola desde WU。wu.define 注册如何渲染，wu.mount 让界面出现。目录注册、manifest 和 define 的名称必须一致。入口必须是浏览器可执行的 JavaScript；把原始 JSX/TSX 发布到静态服务器，不会自动使其成为可执行模块。

共享实例与应用权限

主导入创建或复用 window.wu，并暴露 Symbol.for('wu-framework')。同一页面的模块必须一致地解析运行时，复制软件包不会自动产生隔离实例。在 Node 中，导入的 wu 仍是进程共享的模块实例；SSR 应使用 wu-framework/server 和每请求数据。

shell 导入的 wu 具有宿主权限。应用 mount(container, context) 回调的第二个参数包含 context.wu，这是 facade，即受该应用权限限制的 WU 访问入口，卸载时会撤销。请使用此参数保留权限约定。与 shell 共享 JavaScript 上下文的微前端若取得 window.wu，则重新获得宿主权限。

软件包提供 ESM、CommonJS 和 UMD，工具要求 Node >=20.0.0。浏览器运行客户端 runtime；wu-framework/server 入口提供服务器渲染函数。每个适配器各有 renderer 和 hydration 要求。

WU 不要求 Astro 使用自身 islands 渲染 React/Vue 树，它可以在 shell 容器中挂载独立 bundle。

运行时范围

• core 没有解释 manifest 路由的通用路由器。
• Shadow DOM 封装 DOM/CSS，本身不阻止访问主窗口。
• strict 和 eval 使用同源 iframe，不构成抵御恶意代码的边界。
• Store、历史和 timeline 存在于内存中，不提供数据库或持久审计。
• 应用在浏览器上下文执行；core 不包含执行任意任务的通用 driver、Worker 或 WASM 引擎。

实现参考

Exports 约定位于 package.json；singleton 和全局访问位于 src/index.js；scoped context 位于 src/core/wu-core.js 和 src/core/wu-core.js。相关测试包括 tests/unit/package-exports.test.js、tests/unit/core-store-isolation.test.js 和 tests/unit/capability-security-v3.test.js。