AionClaw是轻量级状态协同层，不提供UI组件，需嵌入现有Vue/React/Angular项目并替换原状态管理；须检查package.json含"type":"module"、安装0.8.0+版本；Vue中支持Pinia共存或完全替换Vuex（传plain object）；React中用ClawProvider包裹根组件并用useClaw消费；Vite需配置optimizeDeps.include并启用内置DevTools。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
用AionClaw按现有技术栈编写前端代码，需明确它不提供开箱即用的UI框架或组件库，而是作为轻量级状态协同层嵌入已有工程——你得保留Vue/React/Angular项目结构，只替换掉原生状态管理部分。
确认当前技术栈与AionClaw兼容性
打开项目根目录下的 package.json，检查 【"type": "module"】 字段是否存在；若无，需手动添加，否则AionClaw的ESM导入方式会触发Node报错。
运行 npm list aionclaw 确认已安装 0.8.0+ 版本；低于此版本不支持React 18并发渲染模式下的状态快照同步。
在Vue项目中接入AionClaw
方法一：组合式API + Pinia共存过渡
立即学习“前端免费学习笔记（深入）”；
在 src/stores/useCounter.ts 中，用 defineStore 创建传统Pinia store，同时用 createClaw 初始化同名状态爪实例——二者共享同一份初始数据，但AionClaw接管后续所有异步变更广播。
方法二：完全替换Vuex（仅限Vue 3.3+）
删除 store/index.ts，新建 src/claws/userClaw.ts，调用 createClaw({ user: { id: 0, name: '' } })；注意此处不能传入ref或reactive对象，【必须传plain object】，否则会导致响应式代理嵌套失效。
在React项目中注入AionClaw状态流
第一步：在 src/main.tsx 顶部添加
import { ClawProvider } from 'aionclaw/react';
第二步：将根组件包裹进
第三步：在任意组件中使用 useClaw('cart') 获取状态爪实例，调用 claw.update({ items: newItemList }) 触发批量更新——这一步会自动跳过未订阅该字段的组件重渲染，比useState更细粒度。
调试与热更新适配
在Vite项目中，需在 vite.config.ts 的 optimizeDeps.include 数组里显式加入 'aionclaw'，否则HMR会丢失状态爪实例引用，导致页面刷新后状态归零。
打开浏览器开发者工具，在Console中输入 window.__AION_CLAW_DEVTOOLS__，可访问内置状态时间轴面板——这个面板只在开发环境注入，生产构建时自动剥离。
