# ibirding

**Repository Path**: geds/ibirding

## Basic Information

- **Project Name**: ibirding
- **Description**: ibirding
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-04
- **Last Updated**: 2026-06-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 观鸟笔记 — 赛博观鸟小程序

桌面治愈系观鸟体验。在喧嚣的城市里，打造属于你自己的观鸟阳台。

## 项目架构

```
ibirding
├── bird-app/          # 前端（uni-app + Vue 3，编译为微信小程序）
│   ├── src/
│   │   ├── pages/     # 小程序页面
│   │   ├── static/    # 静态资源（图片、音频）
│   │   └── utils/     # 工具函数
│   └── scripts/       # 上传脚本
├── bird-server/       # 后端（Express + SQLite）
│   ├── src/
│   │   ├── routes/    # API 路由
│   │   ├── models/    # 数据模型
│   │   └── config.js  # 服务端配置
│   └── index.js       # 入口
├── scripts/           # 部署脚本
└── private.wxe3a6cf27965b4d3f-2.key  # 小程序上传密钥
```

## 快速开始

### 环境要求

- Node.js >= 18
- pnpm
- 微信开发者工具

### 安装依赖

```bash
./build.sh install:all
```

### 开发

**启动后端服务：**

```bash
./build.sh server
```

后端运行在 http://localhost:3001，API 文档在 http://localhost:3001/api-docs

**启动小程序开发：**

```bash
./build.sh dev
```

然后在微信开发者工具中打开 `bird-app` 目录。

### 构建小程序

```bash
./build.sh weixin
```

产物输出到 `bird-app/dist/build/mp-weixin`。

### 上传小程序

```bash
cd bird-app && pnpm upload
```

## 技术栈

| 层 | 技术 |
|---|---|
| 前端框架 | uni-app (Vue 3) |
| 后端 | Express + SQLite (sql.js) |
| 认证 | JWT + 微信登录 |
| 包管理 | pnpm workspace |

## API 概览

| 路径 | 说明 |
|---|---|
| `POST /auth/wx-login` | 微信登录 |
| `POST /auth/login` | 手机号登录 |
| `GET /auth/userinfo` | 用户信息 |
| `PUT /auth/profile` | 更新资料 |
| `GET /birds` | 鸟类列表 |
| `GET /scenes` | 场景列表 |
| `GET /photos` | 相片列表 |
| `GET /achievements` | 成就列表 |

完整 API 文档在 `http://localhost:3001/api-docs` 或生产环境 `https://<your-domain>/birdapi/api-docs`。

## 项目说明

本项目是一个"赛博观鸟"微信小程序，用户可以：

1. **观鸟** — 在虚拟场景中等待各种鸟类来访，每次来访可收集羽毛
2. **图鉴** — 收集不同种类的鸟类，解锁图鉴记录
3. **布置** — 购买和摆放装饰物，提升场景繁荣度，吸引更多鸟类
4. **摄影** — 给来访的鸟儿拍照，保存精彩瞬间
5. **成就** — 完成各种成就任务，解锁隐藏成就

游戏中包含 13 种鸟类，10 个渐次解锁的场景地图，15 种装饰物，以及 10 个成就目标。