# OpenRef

> 直白、可检索、能直接照着做的技术参考手册。

OpenRef is an open technical reference. Entries are grouped by topic; each entry documents one
specific thing with runnable code and explicit limits. Written in Chinese, plain and direct.

## Sections

## 云原生与基础设施 / Cloudflare

- [用 Workers 静态资源托管站点](https://openref.de5.net/docs/cloud/cloudflare/workers-static-assets/): 不需要 Pages，也不用对象存储：把构建产物目录交给 Workers 的 assets 配置，一条命令发布成静态站点，并拿到 <name>.<subdomain>.workers.dev 地址。
- [D1 索引与查询成本](https://openref.de5.net/docs/cloud/cloudflare/d1-index/): D1 按「扫描行数」计费而不是按请求数。缺索引的查询会把整表行数算进额度，本文说明如何建索引、如何写查询、以及免费额度的实际边界。
- [KV 免费额度与写入策略](https://openref.de5.net/docs/cloud/cloudflare/kv-free-limits/): KV 的写入额度只有每天 1000 次，却常被当成数据库用。本文给出它的正确用途、记数替代方案，以及最终一致带来的读取陷阱。

## 前端工程 / SEO

- [技术 SEO 检查清单](https://openref.de5.net/docs/frontend/seo/technical-seo-checklist/): 让页面能被 Google 与 Bing 正常收录的最低要求：预渲染 HTML、唯一元信息、站点地图、结构化数据，以及上线后主动提交索引。按清单逐项核验即可。

## 前端工程 / 性能优化

- [核心网页指标与优化顺序](https://openref.de5.net/docs/frontend/performance/core-web-vitals/): LCP、INP、CLS 三个指标分别衡量加载、交互与视觉稳定。本文给出各自的阈值、最常见成因，以及按投入产出排序的优化动作。

## 编程 / JavaScript / TypeScript

- [AbortController 取消请求](https://openref.de5.net/docs/programming/javascript/abort-controller/): fetch 一旦发出无法撤回，但可以通过 signal 提前中止。本文给出超时、组件卸载取消、以及一次取消多个请求的写法，并说明中止后错误的处理方式。

## Optional

- Full text of all entries: https://openref.de5.net/llms-full.txt