v0.0.4

README.md

@@ -0,0 +1,52 @@
+# 汪圈 Taro 微信小程序
+
+本项目已从 `refrence_html/` 的静态 HTML 参考稿迁移为 Taro + React + TypeScript 微信小程序，并按微信云开发模式保留云函数目录。
+
+## 运行
+
+```bash
+npm install
+npm run dev:weapp
+```
+
+构建：
+
+```bash
+npm run build:weapp
+```
+
+类型检查：
+
+```bash
+npm run typecheck
+```
+
+## 微信开发者工具
+
+1. 打开微信开发者工具。
+2. 导入当前项目根目录。
+3. `miniprogramRoot` 已配置为 `dist/`。
+4. `cloudfunctionRoot` 已配置为 `cloudfunctions/`。
+5. `project.config.json` 当前使用 `touristappid`，正式开发时替换为你的小程序 AppID。
+
+## 云开发环境
+
+客户端通过 `TARO_APP_CLOUD_ENV` 初始化云环境：
+
+```bash
+$env:TARO_APP_CLOUD_ENV="你的云环境ID"
+npm run dev:weapp
+```
+
+未配置云环境时，页面会自动使用本地 mock 数据，方便先验收视觉和交互。
+
+## 页面
+
+- `src/pages/plaza`：广场信息流
+- `src/pages/nearby`：附近地图与可拖拽底部列表
+- `src/pages/publish`：发布动态
+- `src/pages/messages`：消息列表
+- `src/pages/profile`：我的主页
+
+设计与架构说明见 [docs/taro-miniapp-design.md](docs/taro-miniapp-design.md)。
+