# Qingkuai > 轻快（Qingkuai，得名于中文「轻快」）是一个用于构建 Web 用户界面的前端框架。它将 `.qk` 组件文件编译为精简、严格优化的 JavaScript，提供编译器推导的响应性、无虚拟 DOM 的直接 DOM 更新，以及开箱即用的 TypeScript 支持。 ## Agent 参考 - [Agent 参考索引](https://cn.qingkuai.dev/agent/index.md): 语法速查表、代码生成规则、任务到文档的路由以及跨语法依赖查找。 ## 开始 - [安装](https://cn.qingkuai.dev/agent/getting-started/install.md): Qingkuai 安装：使用 create-qingkuai 脚手架创建项目（npm/pnpm/yarn）、--ts TypeScript 选项以及本地开发服务器启动命令；已全局安装 qingkuai 命令时可直接 init 并执行类型检查。 - [简介](https://cn.qingkuai.dev/agent/getting-started/introduction.md): Qingkuai 框架概览：基于响应式变量与组件化的编程模型、嵌入语言标签、设计哲学，以及相对其他框架的核心优势。 ## 基础 - [编译指令](https://cn.qingkuai.dev/agent/basic/compilation-directives.md): Qingkuai 编译指令：#if/#elif/#else、#for、#key、#await/#then/#catch、#html、#target、#scope、#slot，精确用法形式、语义、优先级顺序与约束。 - [事件处理](https://cn.qingkuai.dev/agent/basic/event-handling.md): 通过 @ 属性绑定 DOM 与组件事件：方法引用、带 $arg 的内联处理器、事件处理标志，以及编译器托管的事件委托。 - [表单处理](https://cn.qingkuai.dev/agent/basic/forms.md): Qingkuai 通过引用属性实现表单元素双向绑定：input/textarea/select 上的 &value、input 上的 &number、单选/复选输入上的 &checked 与 &group。 - [插值块](https://cn.qingkuai.dev/agent/basic/interpolation.md): Qingkuai 插值块：文本插值、动态属性、动态 class 的对象/数组形式，以及花括号内仅允许表达式的规则。 - [响应性](https://cn.qingkuai.dev/agent/basic/reactivity.md): Qingkuai 响应性 API 与声明形式：编译器推导的响应性、显式 raw/reactive/shallow 标记、衍生状态（derived / derivedExp）、别名绑定、响应性模式、非响应式读取（noTracking / raw），以及 toRaw/toReactive/createStore 工具。 - [引用属性](https://cn.qingkuai.dev/agent/basic/reference-attributes.md): Qingkuai 引用属性通过 & 前缀属性传递变量引用（DOM 元素用 &handle，表单状态用 &value/&number/&checked/&group），本质是 setter 调用。 - [监视器与副作用](https://cn.qingkuai.dev/agent/basic/watchers-and-side-effects.md): Qingkuai 监视器与副作用：四种触发时机的 watch/effect 家族、*Exp 简写注册、绑定实例的外部注册方式，以及清理语义。 ## 组件 - [异步组件](https://cn.qingkuai.dev/agent/components/async-components.md): Qingkuai 异步组件：Promise 与动态导入的组件标签、#await/#then/#catch 指令渲染、动态切换，以及经 &handle 的实例访问。 - [组件属性](https://cn.qingkuai.dev/agent/components/attributes.md): 通过组件标签上的属性向 Qingkuai 组件传入数据、事件与可写引用。 - [组件基础](https://cn.qingkuai.dev/agent/components/basic.md): Qingkuai 组件文件：基于文件的定义模型、导入与标签使用、kebab-case/camelCase 命名等价性，以及成员访问标签。 - [组件上下文](https://cn.qingkuai.dev/agent/components/contexts.md): Qingkuai 组件上下文：setContext/setContextGetter/setContextExp 写入、经 contexts 的原型链读取、默认值，以及绑定实例的外部上下文 API。 - [动态组件](https://cn.qingkuai.dev/agent/components/dynamic-components.md): Qingkuai 动态组件：变量组件标签、值变化时的自动切换、实例句柄更新，以及基于 derived 的联合类型推导。 - [成员导出](https://cn.qingkuai.dev/agent/components/exports.md): Qingkuai 成员导出：支持的 export 语句形式、通过 &handle 获取组件实例消费导出成员，以及禁止的导出形式。 - [生命周期](https://cn.qingkuai.dev/agent/components/lifecycle.md): Qingkuai 组件生命周期：onAfterMount、onBeforeDestroy、onAfterDestroy、onBeforeUpdate、onAfterUpdate，内建注册规则与绑定实例的外部注册。 - [插槽](https://cn.qingkuai.dev/agent/components/slots.md): Qingkuai 插槽：声明插槽出口、具名插槽、回退内容、作用域插槽上下文，以及按插槽存在性渲染。 - [组件样式表](https://cn.qingkuai.dev/agent/components/stylesheets.md): Qingkuai 样式表：作用域化的嵌入样式块、#scope 样式穿透、src/@import 外部样式、global 样式块，以及 qk-scope 选择器定位。 ## 参考 - [API 参考](https://cn.qingkuai.dev/agent/references/api.md): Qingkuai 运行时与编译器包 API 参考：实例绑定的运行时 API、上下文操作、响应性控制、状态/调度函数，以及编译器入口导出。 - [错误码参考](https://cn.qingkuai.dev/agent/references/error-code.md): Qingkuai 错误码参考：1xxx 编译错误、9xxx 编译警告、2xxx 运行时错误、8xxx 运行时警告、3xxx/7xxx 语言服务消息。 - [内建标识符](https://cn.qingkuai.dev/agent/references/intrinsics.md): Qingkuai 内建标识符完整参考：props、refs、slots、contexts、instance、响应性标记、监视器/副作用家族、defaults 与上下文方法。 - [响应性推导规则](https://cn.qingkuai.dev/agent/references/reactivity-infer-rules.md): Qingkuai 编译器为脚本块顶层每个标识符推导响应性类型的有序规则：显式标记、退化条件，以及基于模板用法的隐式推导。 - [术语参考](https://cn.qingkuai.dev/agent/references/terminology.md): Qingkuai 术语参考：组件文件/实例、各类属性、插值术语、嵌入语言标签、插槽术语、运行时包、内建标识符与方法。 ## 其他 - [内置元素](https://cn.qingkuai.dev/agent/misc/builtin-elements.md): Qingkuai 内置元素：qk:spread 作为兄弟节点组与文本节点的指令虚拟挂载点，本身不渲染。 - [命令行工具](https://cn.qingkuai.dev/agent/misc/cli.md): Qingkuai 命令行工具：init 初始化、dev/build/preview 开发与构建、check 类型检查、format 格式化、build-types 声明生成，以及 vite/prettier/typescript 的类型重导出。 - [配置文件](https://cn.qingkuai.dev/agent/misc/config-files.md): Qingkuai 配置：.qingkuairc 运行配置选项（reactivityMode、whitespace、resolveImportExtension 等）与 Prettier 的 qingkuai 格式化选项。 - [调试](https://cn.qingkuai.dev/agent/misc/debugging.md): Qingkuai 调试：脚本与样式块的 source map、DevTools 中的响应式标识符包装、指令上下文调试信息，以及插值块更新的映射点。 - [语言功能](https://cn.qingkuai.dev/agent/misc/language-features.md): Qingkuai 语言功能：基于 LSP 的语言服务、VS Code 扩展、Emmet 语法差异、格式化、语言服务重启、代码导航，以及面向 AI agent 的 MCP 服务器。 - [性能优化](https://cn.qingkuai.dev/agent/misc/optimization.md): Qingkuai 性能优化：信号模式（reactivityMode: shallow + allowConstReactive: false）、指令级摇树优化、避免作用域样式重复的共享样式复用规则，以及基于异步组件的代码分割。 - [TypeScript 支持](https://cn.qingkuai.dev/agent/misc/typescript.md): Qingkuai TypeScript 支持：Meta 组件契约、Meta 上的泛型、defaults 类型收窄、插槽/事件推导，以及运行时工具类型（ComponentInstance、ComponentProps 等）。