# Web 技术库研究

> 一个只收录"**单一职责、可独立引入、维护稳定**"的 Web 技术库研究库。
> 每个库一份固定档案，按能力分板块，并用雷达四档给出可比较的结论。

## 浏览

- [index.html](index.html) — 全部库的分类索引（纯静态，双击即可打开）
- [radar.md](radar.md) — 四档总表
- [libs/](libs/) — 每个库的档案

部署：任何静态托管直接指向仓库根目录即可，不需要构建。根目录已有 `index.html`。

## 为什么不是"大而全"

大型一体化框架把路由、状态、渲染、构建全部绑定在一起，接入成本高、替换成本更高。
本项目的方法相反：**按能力拆开，一个一个库评估，按需引入**。因此这里关心的是：

- 它只解决一件事吗？这件事是否已经有人用更小的库解决？
- 引入它的真实代价是多少（gzip 体积、生命周期、与其他库的范式冲突）？
- 在"无构建 / 服务端渲染页面 / 动态插入的区块"这类受限环境里还能不能用？

## 雷达四档

| 档位 | 含义 | 使用建议 |
|---|---|---|
| **采纳 Adopt** | 已在真实项目验证，稳定、体积可控 | 可直接用于生产 |
| **试用 Trial** | 能力契合、风险可控，但尚未大规模验证 | 新项目可试，老项目谨慎 |
| **评估 Assess** | 值得关注，有明确取舍或硬缺口 | 先做 PoC 再决定 |
| **暂缓 Hold** | 当前不建议引入（体积、维护、范式冲突） | 除非有不可替代的理由 |

完整定级见 [radar.md](radar.md)。

## 收录标准（6 项）

1. 近 6 个月有 release，issue 有人响应
2. 有语义化版本与明确的破坏性变更记录
3. 有可验证的生产采用度（npm 下载 / 真实站点），不只看 star
4. 体积透明，支持 ESM 与按需引入
5. 兼容现代浏览器；在无构建或 SSR 环境下的行为有明确说明
6. License 清晰（MIT / Apache-2.0 / ISC 优先）

## 目录结构

```
web-techs/
├─ index.html                库索引（纯静态，无依赖）
├─ README.md                 本文件：定位、标准、导航
├─ radar.md                  四档总表
└─ libs/                     每个库一份档案（按能力分类）
   ├─ _template.md           档案模板
   ├─ animation/             动画、滚动、滑动
   ├─ state-dom/             声明式状态、DOM 行为
   ├─ data-fetch/            请求、缓存、数据层
   ├─ validation/            数据校验、类型
   ├─ realtime/              实时通信
   ├─ storage/               本地存储
   ├─ backend/               服务端框架、ORM
   ├─ build/                 构建、工具链
   └─ testing/               测试、质量
```

## 如何新增一个条目

1. 复制 [libs/_template.md](libs/_template.md)，按分类放到 `libs/<分类>/<库名>.md`，填满 9 个字段（体积注明实测或官方口径）
2. 在 [radar.md](radar.md) 增加一行，写明档位与一句话结论
3. 在 [index.html](index.html) 对应板块加一张卡片；未立档的先放进候选标签

## 当前收录

- **动画与滚动**：Lenis、Swiper、Anime.js v4；GSAP + ScrollTrigger 暂缓
- **状态与 DOM**：Alpine.js
- 其余板块（数据请求、校验、实时、存储、后端、构建、测试）见 `index.html` 的候选清单
