端侧AI实战：WebGPU本地大模型组件封装与数据流
端侧AI项目聚焦组件封装与聊天交互底座，涵盖React单向数据流中State与Props的规范管理。高质量进度条组件通过空值合并运算符实现容错，结合字节格式化工具适配模型加载。受控输入框支持回车发送与Shift换行，模型状态锁控制交互可用性，构建完整AI对话底座。
这一章要聊的，是端侧AI项目里两个最棘手的工程问题。有多少人写组件还停留在“能跑就行”的阶段？但到了企业级、商用级，标准完全不一样了。
第一个，如何写出真正健壮、能容错、可以直接上线的通用业务组件？第二个，怎么搭建一个完整的聊天交互底座——从受控输入框、键盘回车发送，到模型状态锁、父子组件数据流规范，一步到位。
这两块内容，都是React高阶工程思维加上AI端侧业务的落地实战，简历上直接写，面试官一眼就能看出功底。
一、复盘：前端AI项目的核心数据流思想
做过Vue项目的同学，对双向绑定、模板语法肯定很熟悉。但到了React AI大型项目，核心逻辑就变了：单向数据流、状态驱动视图，这是基本盘。
整个WebGPU端侧项目，其实就两种数据在流转。
1. State 组件内部状态
通过useState声明，组件自己管自己，自己修改自己，自己驱动视图刷新。本项目的核心State包括：模型状态status、错误状态error、输入文本input、进度列表progressItems。
2. Props 父传子只读属性
子组件绝对不能碰props，只负责接收、展示。进度条组件的text、percentage、total全部由父组件App下发，子组件只管UI渲染，视图与逻辑彻底解耦。这才是工程化的思路。
二、高质量可复用进度条组件封装（面试亮点）
很多人写组件，只能说“能用”，但企业级开发要的是“健壮、容错、体验极致”。这一章，我们就对进度条组件做一次生产级封装。
1. 空值合并运算符容错处理??=
模型初始化阶段，进度为空、undefined是常有的事。如果直接渲染，NaN、白屏、报错都可能出现。这时候，ES12的新特性空值合并赋值运算符就派上用场了：
percentage ??= 0;
逻辑很简单：当percentage为null或undefined时，自动赋值为0；有值就用传入值。封装者把兜底逻辑做了，使用者省心省力，这就是高阶组件封装思维。
2. 字节单位自动格式化工具函数
模型文件单位是字节，直接展示数字，用户根本看不懂。所以封装一个通用的formatBytes函数，自动适配B/KB/MB/GB/TB，不管多大的ONNX模型文件都能应对。
function formatBytes(size) { const i = size == 0 ? 0 : Math.floor(Math.log(size) / Math.log(1024)); return (+(size / Math.pow(1024, i)).toFixed(2) * 1 + ["B", "kB", "MB", "GB", "TB"][i]); }
3. 动态行内样式 + 进度可视化
进度条宽度是动态变化的，Tailwind预设类没法搞定。所以用React的行内样式特性：style={{width: `${percentage}%`}}。JSX里所有样式对象都是驼峰、对象格式，这是React标准写法，没什么好说的。
完整 Progress 组件源码（可直接上线）
{/* 动态宽度进度条 */} {text} {percentage.toFixed(2)}% {isNaN(total) ? "" : ` / ${formatBytes(total)}`} // Progress.mjs 通用模型加载进度条组件 const Progress = ({ text, percentage, total }) => { // 字节自动格式化工具 function formatBytes(size) { const i = size == 0 ? 0 : Math.floor(Math.log(size) / Math.log(1024)); return (+(size / Math.pow(1024, i)).toFixed(2) * 1 + ["B", "kB", "MB", "GB", "TB"][i]); } // 容错兜底：空进度默认赋值0 percentage ??= 0; return (
三、React核心难点：受控组件与输入框交互
AI对话项目的核心交互，就是输入框这一块。Vue有双向绑定，但React严格遵循单向数据流，没有双向绑定这回事。所以手动实现受控输入框，是面试必问的考点。
1. 核心原理
- value绑定state：输入框的值完全由
input状态控制。 - onInput监听更新：通过事件对象拿到输入值，更新state。
- TS类型断言：解决TS事件对象类型不确定的问题，用
as HTMLTextAreaElement。
const [input, setInput] = useState(""); // 输入框受控绑定