commit 1b5d3300f6d364e9ff9406d713394b5f0f1218f3
Author: AI Engineer <ai@apigo.cc>
Date:   Sat May 16 19:54:31 2026 +0800

    1

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e67c5e8
--- /dev/null
+++ b/README.md
@@ -0,0 +1,22 @@
+# @web 开发指引 (INDEX)
+
+## 设计哲学与原则
+
+本项目致力于构建一套**极致精简、消除摩擦、高性能**的 Web 开发基础设施。
+
+*   **无打包**: 无需打包，直接在浏览器中运行，遵循原生 ES Modules (ESM) 规范。
+*   **易用性**: 极简 API 设计，降低门槛，加速开发。
+*   **状态驱动**: 基于状态管理库，实现组件之间的状态共享与更新。
+*   **组件化**: 采用组件化开发模式，提高代码复用性和可维护性。
+
+---
+
+## 模块清单与 API 参考
+
+详细文档: https://apigo.cc/web/
+
+### web/state v1.0.1
+极致精简的状态管理与 DOM 绑定库，支持零打包 ESM 运行，内置高性能 `$each` 索引复用机制与单层响应式系统。
+
+### web/base v1.0.0
+基于 State.js 的基础组件库，集成 HTTP 请求、Bootstrap 5 UI 组件、AutoForm 数据驱动表单及 FastList 虚拟滚动列表。