fix(release): moxwebgpu 1.0.1 修复 Node 下 import 即崩溃

- src/core/buffer.ts 顶层 GPUBufferUsage 常量改用标准 WebGPU 位值兜底，
  包在 Node 下可正常 import（真实 GPU 执行仍需浏览器 / WebGPU 运行时）
- 版本 1.0.0 -> 1.0.1，MOXWEBGPU_VERSION 同步
- CHANGELOG 补 [1.0.0] 与 [1.0.1] 段落

Author: codecloud-dev

CHANGELOG.md

@@ -9,6 +9,18 @@
 
 计划中(见 README 路线图):f16/bf16、tensor-core matmul、多 GPU pass 融合、生态集成。
 
+## [1.0.1] - 2026-10-08
+
+### 修复
+
+- **发布阻断级 bug：Node 下 `require`/`import` 即崩溃**。根因：`src/core/buffer.ts` 顶层常量直接引用浏览器 WebGPU 全局 `GPUBufferUsage`，在 Node 环境（无该全局）`import` 时即抛 `ReferenceError`，整包不可用。改为用标准 WebGPU 位值兜底（全局存在时仍走全局），包现在可在 Node 下正常 import；实际 GPU 执行仍需浏览器 / WebGPU 运行时。
+
+## [1.0.0] - 2026-10-07
+
+### 里程碑
+
+- MoX 全家桶首个大版本：moxwebgpu 随 agent-core / moxsh 系列一同升 1.0.0 发布。
+
 ## [0.2.0] - 2026-10-02
 
 ### 新增

package.json

@@ -1,6 +1,6 @@
 {
   "name": "moxwebgpu",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "⚡ A WebGPU compute (GPGPU) framework — typed tensors, raw kernels and a lazy compute graph, with reverse-mode autodiff, in one tiny package.",
   "type": "module",
   "main": "./dist/index.cjs",

src/core/buffer.ts

@@ -6,13 +6,35 @@
 import type { DType } from './dtype.js';
 import { dtypeInfo } from './dtype.js';
 
+/**
+ * `GPUBufferUsage` 是浏览器 / WebGPU 全局，Node 环境下不存在。
+ * 下面的常量是顶层定义，会在 `import` 时立即求值；若直接写 `GPUBufferUsage.STORAGE`
+ * 会让整个包在 Node 下一 `require` 就 `ReferenceError` 崩溃（npm 包不可用）。
+ * 这里用标准规范位值兜底：真机 WebGPU 运行时全局存在时走全局，否则用等价常量，
+ * 保证包在 Node 下也能被 import（实际执行 GPU 命令仍需浏览器 / WebGPU 环境）。
+ */
+const GPUBufferUsageFlags = (typeof GPUBufferUsage !== 'undefined')
+  ? GPUBufferUsage
+  : {
+      MAP_READ: 0x0001,
+      MAP_WRITE: 0x0002,
+      COPY_SRC: 0x0004,
+      COPY_DST: 0x0008,
+      INDEX: 0x0010,
+      VERTEX: 0x0020,
+      UNIFORM: 0x0040,
+      STORAGE: 0x0080,
+      INDIRECT: 0x0100,
+      QUERY_RESOLVE: 0x0200,
+    };
+
 /** Usage flags shared by every storage buffer the framework creates. */
 export const STORAGE_USAGE =
-  GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_SRC | GPUBufferUsage.COPY_DST;
+  GPUBufferUsageFlags.STORAGE | GPUBufferUsageFlags.COPY_SRC | GPUBufferUsageFlags.COPY_DST;
 
-export const UNIFORM_USAGE = GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST;
+export const UNIFORM_USAGE = GPUBufferUsageFlags.UNIFORM | GPUBufferUsageFlags.COPY_DST;
 
-export const STAGING_USAGE = GPUBufferUsage.MAP_READ | GPUBufferUsage.COPY_DST;
+export const STAGING_USAGE = GPUBufferUsageFlags.MAP_READ | GPUBufferUsageFlags.COPY_DST;
 
 /** Round a byte size up to the WebGPU-required 4-byte alignment. */
 export function align4(n: number): number {

src/index.ts

@@ -34,7 +34,7 @@ export { backward, sumTo } from './graph/autograd.js';
 export * from './tensor/codegen.js';
 
 // ---- version ----
-export const MOXWEBGPU_VERSION = '1.0.0';
+export const MOXWEBGPU_VERSION = '1.0.1';
 
 import { Tensor } from './tensor/tensor.js';
 import { installTensorOps } from './tensor/ops/index.js';