启用QoderWake内置构建缓存、分离AI任务、定制插件白名单、调整TS检查粒度、禁用非必要监听器可显著提升Vue/React项目编译速度。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 QoderWake 进行 Vue 或 React 项目开发时，发现编译耗时明显增加、热更新延迟、IDE 响应迟滞，则很可能是前端构建配置与 QoderWake 的智能体工作流未对齐所致。以下是针对性提升编译速度的多种适配技巧：
一、启用 QoderWake 内置构建缓存策略
QoderWake 在底层集成了基于文件系统快照的增量构建缓存机制，可跳过未变更模块的重复解析与编译，显著缩短二次构建时间。该机制默认关闭，需显式激活以适配大型 Vue/React 项目。
1、打开项目根目录下的 qoder.config.js 文件（若不存在则新建）。
2、在导出对象中添加 buildCache: { enabled: true, strategy: 'filesystem' } 配置项。
立即学习“前端免费学习笔记（深入）”；
3、保存后重启 QoderWake IDE，首次构建将生成缓存目录 .qoder/cache/build。
4、后续修改任意单个组件或配置文件后，执行 Cmd/Ctrl + Shift + B 触发构建，仅变更路径及其依赖链被重新处理。
二、分离 AI 智能体任务与主构建流程
QoderWake 的 Quest 模式默认会监听 src 目录并自动触发代码分析与建议生成，该行为会与 Webpack/Vite 构建进程争夺文件句柄与内存资源，导致编译卡顿。需将智能体感知范围限定在非构建关键路径。
1、在项目根目录创建 .qoder/agentignore 文件。
2、向该文件逐行写入以下路径模式：node_modules/**、dist/**、.qoder/cache/**、public/**。
3、在 qoder.config.js 中配置 agent: { include: ['src/**/*.{js,ts,jsx,tsx,vue}'] }，显式排除构建产物与依赖目录。
4、重启 QoderWake 后，AI 智能体将不再扫描 dist 和 node_modules，主构建线程获得独占 I/O 资源。
三、定制 Vue/React 构建插件白名单
QoderWake 自动注入的开发辅助插件（如实时类型检查、组件依赖图谱生成器）可能与 Vue CLI/Vite 或 React Scripts 的原生插件链冲突，引发重复解析或循环依赖警告，拖慢编译。需按框架类型禁用非必要插件。
1、确认项目类型：执行 npm ls vue 或 npm ls react 判断主框架。
Vue 3 组合式 API 与 最佳实践，涵盖代码组织、useXxx 模式、组合式函数设计、Store 集成、响应式优化及功能抽取。
2、若为 Vue 项目，在 qoder.config.js 中设置：plugins: { vue: { enableDevTools: false, enableDependencyGraph: false } }。
3、若为 React 项目，配置：plugins: { react: { enableJSXPreview: false, enableHookAnalyzer: false } }。
4、保存配置并重启 IDE，QoderWake 将跳过对应插件的加载与初始化阶段。
四、调整 TypeScript 类型检查粒度
QoderWake 默认启用全量 TS 类型检查（包括 node_modules 中的声明文件），在大型 Vue/React 项目中极易引发内存溢出与构建阻塞。需将其限制为仅检查项目源码，并复用 Volar 或 TypeScript ESLint 的已有能力。
1、在项目根目录的 tsconfig.json 中，确保 "include" 字段仅包含 ["src/**/*"]，移除 "node_modules/**" 等宽泛路径。
2、在 qoder.config.js 中添加：typescript: { skipLibCheck: true, noEmit: true, checkOnSave: 'workspace' }。
3、关闭 QoderWake 内置 TS Server：在 IDE 设置中搜索 TypeScript > Suggest: Enable TS Server，设为 false。
4、重启后，类型检查交由 VS Code 原生语言服务或 Volar 承担，QoderWake 仅做轻量级语法提示。
五、禁用非必要文件监听器
QoderWake 为支持多模态编辑（如 Markdown 文档生成、API Schema 解析），默认监听项目内所有 JSON/YAML/MD 文件变更。这些监听器在纯前端 Vue/React 项目中无实际用途，却持续占用 fs.watch 句柄，间接降低构建进程可用文件描述符数量。
1、打开 QoderWake 设置界面，进入 Settings > Files > Watcher。
2、取消勾选 "Watch JSON files for schema inference" 与 "Watch Markdown files for doc generation"。
3、在 qoder.config.js 中追加：watcher: { exclude: ['**/*.json', '**/*.md', '**/*.yaml'] }。
4、执行 qoder reload-watcher 命令（在终端中输入）强制刷新监听规则。
