71 lines
1.5 KiB
Markdown
71 lines
1.5 KiB
Markdown
# WASM SIMD 构建指南
|
||
|
||
## 🚀 快速构建
|
||
|
||
### 前置要求
|
||
|
||
```bash
|
||
# 安装 Rust
|
||
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
|
||
|
||
# 安装 wasm-pack
|
||
curl https://rustwasm.github.io/wasm-pack/installer/init.sh -sSf | sh
|
||
```
|
||
|
||
### 构建选项
|
||
|
||
1. **从项目根目录构建**（推荐）：
|
||
|
||
```bash
|
||
# 构建 WASM 并自动复制到 Chrome 扩展
|
||
npm run build:wasm
|
||
```
|
||
|
||
2. **只构建 WASM 包**：
|
||
|
||
```bash
|
||
# 从 packages/wasm-simd 目录
|
||
npm run build
|
||
|
||
# 或者从任何地方使用 pnpm filter
|
||
pnpm --filter @chrome-mcp/wasm-simd build
|
||
```
|
||
|
||
3. **开发模式构建**：
|
||
```bash
|
||
npm run build:dev # 未优化版本，构建更快
|
||
```
|
||
|
||
### 构建产物
|
||
|
||
构建完成后，在 `pkg/` 目录下会生成：
|
||
|
||
- `simd_math.js` - JavaScript 绑定
|
||
- `simd_math_bg.wasm` - WebAssembly 二进制文件
|
||
- `simd_math.d.ts` - TypeScript 类型定义
|
||
- `package.json` - NPM 包信息
|
||
|
||
### 集成到 Chrome 扩展
|
||
|
||
WASM 文件会自动复制到 `app/chrome-extension/workers/` 目录，Chrome 扩展可以直接使用：
|
||
|
||
```typescript
|
||
// 在 Chrome 扩展中使用
|
||
const wasmUrl = chrome.runtime.getURL('workers/simd_math.js');
|
||
const wasmModule = await import(wasmUrl);
|
||
```
|
||
|
||
## 🔧 开发工作流
|
||
|
||
1. 修改 `src/lib.rs` 中的 Rust 代码
|
||
2. 运行 `npm run build` 重新构建
|
||
3. Chrome 扩展会自动使用新的 WASM 文件
|
||
|
||
## 📊 性能测试
|
||
|
||
```bash
|
||
# 在 Chrome 扩展中运行基准测试
|
||
import { runSIMDBenchmark } from './utils/simd-benchmark';
|
||
await runSIMDBenchmark();
|
||
```
|