From 860136bceba5af2330e7caf1a81f3232adb0f498 Mon Sep 17 00:00:00 2001
From: cheng <545895878@qq.com>
Date: Thu, 16 Jul 2026 22:47:38 +0800
Subject: [PATCH] =?UTF-8?q?feat(theme):=20=E5=AE=9E=E7=8E=B0=E6=97=A5?=
 =?UTF-8?q?=E5=A4=9C=E4=B8=BB=E9=A2=98=E8=87=AA=E5=8A=A8=E5=88=87=E6=8D=A2?=
 =?UTF-8?q?=E5=8A=9F=E8=83=BD?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 添加日夜主题CSS变量定义，支持琥珀夜光和暖白琥珀两种风格
- 实现主题切换逻辑，根据时间自动切换白天(light)和夜间(dark)主题
- 在App.vue中集成主题初始化和token恢复功能
- 更新全局样式类应用主题颜色变量，包括卡片、文本、边框等
- 创建主题混入(mixin)供各页面使用，确保主题同步更新
- 实现导航栏和TabBar主题动态切换，提升用户体验
- 添加API服务层封装HaveADrink SDK，统一处理认证和请求
- 优化DrinkCard组件显示饮酒感受信息，丰富打卡记录展示
- 更新项目依赖配置，集成新的API客户端库
---
 App.vue                              |   57 +-
 common/api.js                        |  143 ++
 common/theme-mixin.js                |   28 +
 common/utils.js                      |   83 +
 components/AchievementBadge.vue      |    2 +-
 components/DrinkCalendar.vue         |    3 +-
 components/DrinkCard.vue             |   36 +-
 node_modules/.package-lock.json      |   13 +
 node_modules/HaveADrink/README.md    | 1115 +++++++++++
 node_modules/HaveADrink/index.d.ts   | 2701 ++++++++++++++++++++++++++
 node_modules/HaveADrink/index.js     | 2378 +++++++++++++++++++++++
 node_modules/HaveADrink/package.json |   16 +
 package-lock.json                    |   18 +
 package.json                         |    5 +
 pages.json                           |    2 +-
 pages/card/card.vue                  |  106 +-
 pages/index/index.vue                |  147 +-
 pages/login/login.vue                |   52 +-
 pages/onboarding/onboarding.vue      |    5 +-
 pages/profile/profile.vue            |   85 +-
 pages/record/record.vue              |   72 +-
 uni.scss                             |  139 +-
 22 files changed, 7051 insertions(+), 155 deletions(-)
 create mode 100644 common/api.js
 create mode 100644 common/theme-mixin.js
 create mode 100644 node_modules/.package-lock.json
 create mode 100644 node_modules/HaveADrink/README.md
 create mode 100644 node_modules/HaveADrink/index.d.ts
 create mode 100644 node_modules/HaveADrink/index.js
 create mode 100644 node_modules/HaveADrink/package.json
 create mode 100644 package-lock.json
 create mode 100644 package.json

diff --git a/App.vue b/App.vue
index ca6d32f..37d64e9 100644
--- a/App.vue
+++ b/App.vue
@@ -1,15 +1,14 @@
 <script>
+import { getCurrentTheme, applyTheme } from './common/utils'
+import client, { refreshAuthToken } from './common/api'
+
 export default {
   onLaunch() {
     console.log('喝了么 App Launch')
-    // 初始化Mock数据(仅首次)
-    const hasData = uni.getStorageSync('drink_records')
-    if (!hasData) {
-      import('./common/mock-data').then(({ initMockData }) => {
-        initMockData()
-        console.log('Mock数据已初始化')
-      })
-    }
+    // 初始化主题
+    this.initTheme()
+    // 尝试刷新 token
+    this.restoreAuth()
     // 数据迁移：清除旧版 logo.png 头像引用
     this.migrateUserData()
     // 启动路由守卫
@@ -17,11 +16,36 @@ export default {
   },
   onShow() {
     console.log('App Show')
+    // 每次回到前台刷新主题（时间可能已变化）
+    this.initTheme()
   },
   onHide() {
     console.log('App Hide')
   },
   methods: {
+    // 初始化并应用日夜主题
+    initTheme() {
+      const theme = getCurrentTheme()
+      applyTheme(theme)
+      // 同步设置page元素背景色
+      const bgColor = theme === 'light' ? '#FAF7F2' : '#0B0B14'
+      try {
+        uni.setBackgroundColor({
+          backgroundColor: bgColor,
+          backgroundColorTop: bgColor,
+          backgroundColorBottom: bgColor
+        })
+      } catch (e) {}
+    },
+    // 恢复登录态：从缓存恢复 token 并尝试刷新
+    async restoreAuth() {
+      const token = uni.getStorageSync('auth_token')
+      if (token) {
+        client.setToken(token)
+        // 后台尝试刷新 token（静默，不阻塞启动）
+        refreshAuthToken().catch(() => {})
+      }
+    },
     // 数据迁移：清除旧版 logo.png 头像引用
     migrateUserData() {
       try {
@@ -72,11 +96,13 @@ page {
 .page-container {
   min-height: 100vh;
   background-color: $bg-base;
+  color: $text-primary;
   padding-bottom: env(safe-area-inset-bottom);
 }
 
 .card {
   background-color: $bg-card;
+  color: $text-primary;
   border-radius: $radius-lg;
   padding: $sp-lg;
   box-shadow: $shadow-sm;
@@ -84,6 +110,7 @@ page {
 
 .card-elevated {
   background-color: $bg-elevated;
+  color: $text-primary;
   border-radius: $radius-lg;
   padding: $sp-lg;
   box-shadow: $shadow-md;
@@ -95,36 +122,42 @@ page {
   font-weight: $fw-black;
   line-height: $lh-tight;
   letter-spacing: -2rpx;
+  color: $text-primary;
 }
 
 .text-display {
   font-size: $fs-3xl;
   font-weight: $fw-black;
   line-height: $lh-tight;
+  color: $text-primary;
 }
 
 .text-h1 {
   font-size: $fs-2xl;
   font-weight: $fw-bold;
   line-height: $lh-tight;
+  color: $text-primary;
 }
 
 .text-h2 {
   font-size: $fs-xl;
   font-weight: $fw-bold;
   line-height: $lh-tight;
+  color: $text-primary;
 }
 
 .text-h3 {
   font-size: $fs-lg;
   font-weight: $fw-medium;
   line-height: $lh-normal;
+  color: $text-primary;
 }
 
 .text-body {
   font-size: $fs-base;
   font-weight: $fw-normal;
   line-height: $lh-normal;
+  color: $text-primary;
 }
 
 .text-caption {
@@ -195,7 +228,7 @@ page {
   font-weight: $fw-medium;
   padding: $sp-md $sp-xl;
   border-radius: $radius-full;
-  border: 2rpx solid rgba(255, 255, 255, 0.08);
+  border: 2rpx solid var(--border-subtle, rgba(255, 255, 255, 0.10));
   transition: all $duration-fast $ease-out;
   display: flex;
   align-items: center;
@@ -252,7 +285,7 @@ page {
     left: -100%;
     width: 100%;
     height: 100%;
-    background: linear-gradient(90deg, transparent, rgba(255,255,255,0.15), transparent);
+    background: linear-gradient(90deg, transparent, var(--btn-shimmer, rgba(255, 255, 255, 0.15)), transparent);
     animation: shimmer 3s infinite;
   }
 
@@ -287,7 +320,7 @@ page {
 /* --- 分隔线 --- */
 .divider {
   height: 2rpx;
-  background: linear-gradient(90deg, transparent, rgba(255,255,255,0.06), transparent);
+  background: linear-gradient(90deg, transparent, var(--divider-color, rgba(255, 255, 255, 0.08)), transparent);
   margin: $sp-lg 0;
 }
 
@@ -330,7 +363,7 @@ page {
   padding: $sp-sm;
   font-size: $fs-xs;
   color: $text-tertiary;
-  background-color: rgba(255, 255, 255, 0.02);
+  background-color: var(--bg-subtle, rgba(255, 255, 255, 0.03));
 
   text {
     opacity: 0.5;
diff --git a/common/api.js b/common/api.js
new file mode 100644
index 0000000..9ce7701
--- /dev/null
+++ b/common/api.js
@@ -0,0 +1,143 @@
+/* 喝了么 - API 服务层
+ * 基于 HaveADrink SDK 封装后端接口
+ */
+import HaveADrink from 'HaveADrink'
+
+// ==========================================
+// 后端服务地址（切换环境只需改这里）
+// ==========================================
+const API_HOST = 'https://dev.wash-painting.cn'
+
+// ==========================================
+// HTTP 请求函数（供 SDK 内部调用）
+// 参考 goodBooth 项目的 fetchsomething
+// ==========================================
+function httpRequest(url, params) {
+  console.log('[API] Request:', params.method, url, 'data:', JSON.stringify(params.data))
+  return new Promise((resolve, reject) => {
+    // 自动注入 Authorization token
+    const headers = Object.assign({}, params.headers || {})
+    const token = uni.getStorageSync('auth_token')
+    if (token) {
+      headers['Authorization'] = `Bearer ${token}`
+    }
+
+    uni.request({
+      url: url,
+      method: params.method,
+      params: params.query || undefined,
+      data: params.data,
+      header: headers,
+      success: (res) => {
+        const code = res.statusCode
+        if (code === 200 || code === 201 || code === 204) {
+          resolve(res.data)
+        } else if (code === 401) {
+          // token 过期，清除登录态并跳转登录页
+          uni.removeStorageSync('auth_token')
+          uni.removeStorageSync('refresh_token')
+          uni.removeStorageSync('is_logged_in')
+          uni.reLaunch({ url: '/pages/login/login' })
+          reject({ msg: '登录已过期，请重新登录' })
+        } else {
+          const errMsg = (res.data && res.data.msg) || (res.data && res.data.errmsg) || `请求失败(${code})`
+          reject({ msg: errMsg, code })
+        }
+      },
+      fail: (err) => {
+        reject({ msg: err.errMsg || '网络请求失败' })
+      }
+    })
+  })
+}
+
+// ==========================================
+// 文件上传函数（供 SDK 内部调用）
+// ==========================================
+function uploadRequest(url, params) {
+  return new Promise((resolve, reject) => {
+    const headers = Object.assign({}, params.headers || {})
+    const token = uni.getStorageSync('auth_token')
+    if (token) {
+      headers['Authorization'] = `Bearer ${token}`
+    }
+
+    uni.uploadFile({
+      url: url,
+      filePath: params.data.fileName || params.data.filePath,
+      name: params.data.name || 'file',
+      header: headers,
+      formData: params.data.formData || {},
+      success: (uploadRes) => {
+        try {
+          const data = typeof uploadRes.data === 'string'
+            ? JSON.parse(uploadRes.data)
+            : uploadRes.data
+          resolve(data)
+        } catch (e) {
+          resolve(uploadRes.data)
+        }
+      },
+      fail: (err) => {
+        reject({ msg: err.errMsg || '上传失败' })
+      }
+    })
+  })
+}
+
+// ==========================================
+// 初始化 SDK 实例
+// ==========================================
+const client = new HaveADrink({
+  host: API_HOST,
+  http_request: httpRequest,
+  upload: uploadRequest,
+  token: uni.getStorageSync('auth_token') || ''
+})
+
+// ==========================================
+// 导出 SDK 实例（各页面直接 import 使用）
+// ==========================================
+export default client
+
+// ==========================================
+// Token 管理辅助函数
+// ==========================================
+
+/** 登录成功后保存 token 并同步到 SDK */
+export function saveAuthTokens(data) {
+  if (data.token) {
+    uni.setStorageSync('auth_token', data.token)
+    client.setToken(data.token)
+  }
+  if (data.refresh_token) {
+    uni.setStorageSync('refresh_token', data.refresh_token)
+  }
+}
+
+/** 清除所有认证信息 */
+export function clearAuth() {
+  uni.removeStorageSync('auth_token')
+  uni.removeStorageSync('refresh_token')
+  uni.removeStorageSync('is_logged_in')
+  uni.removeStorageSync('is_guest')
+  uni.removeStorageSync('user_info')
+  client.setToken('')
+}
+
+/** 尝试用 refresh_token 刷新 token */
+export async function refreshAuthToken() {
+  const refreshToken = uni.getStorageSync('refresh_token')
+  if (!refreshToken) return false
+  try {
+    const res = await client.RefreshToken({ refresh_token: refreshToken })
+    if (res && res.token) {
+      saveAuthTokens(res)
+      return true
+    }
+    return false
+  } catch (e) {
+    console.warn('刷新 token 失败:', e)
+    return false
+  }
+}
diff --git a/common/theme-mixin.js b/common/theme-mixin.js
new file mode 100644
index 0000000..8cd6a98
--- /dev/null
+++ b/common/theme-mixin.js
@@ -0,0 +1,28 @@
+/* 喝了么 - 主题混入 (Theme Mixin)
+ * 每个页面混入此mixin，自动在onShow时刷新日夜主题
+ * 页面根视图需绑定 :class="themeClass"
+ */
+import { getCurrentTheme, applyTheme } from './utils'
+
+export default {
+  data() {
+    return {
+      themeClass: 'theme-dark',
+      currentTheme: 'dark'
+    }
+  },
+  created() {
+    this._refreshTheme()
+  },
+  onShow() {
+    this._refreshTheme()
+  },
+  methods: {
+    _refreshTheme() {
+      const theme = getCurrentTheme()
+      this.currentTheme = theme
+      this.themeClass = theme === 'light' ? 'theme-light' : 'theme-dark'
+      applyTheme(theme)
+    }
+  }
+}
diff --git a/common/utils.js b/common/utils.js
index 73a1c67..1d8e443 100644
--- a/common/utils.js
+++ b/common/utils.js
@@ -190,6 +190,89 @@ export function calcStats(records) {
   }
 }
 
+/**
+ * 主题系统：日夜自动切换
+ * 白天：6:00-16:00 → light
+ * 夜间：16:00-6:00 → dark
+ */
+export function getCurrentTheme() {
+  const hour = new Date().getHours()
+  return (hour >= 6 && hour < 16) ? 'light' : 'dark'
+}
+
+export function applyTheme(theme) {
+  // 同步存储当前主题
+  uni.setStorageSync('current_theme', theme)
+  // 应用导航栏和TabBar主题
+  applyNavBarTheme(theme)
+  applyTabBarTheme(theme)
+}
+
+export function applyNavBarTheme(theme) {
+  const colors = {
+    dark: { backgroundColor: '#0B0B14', frontColor: '#ffffff' },
+    light: { backgroundColor: '#FAF7F2', frontColor: '#000000' }
+  }
+  const c = colors[theme] || colors.dark
+  try {
+    uni.setNavigationBarColor({
+      frontColor: c.frontColor,
+      backgroundColor: c.backgroundColor,
+      animation: { duration: 300, timingFunc: 'easeInOut' }
+    })
+  } catch (e) {}
+}
+
+export function applyTabBarTheme(theme) {
+  // 仅在 tabBar 页面上调用 setTabBarStyle，避免报错
+  const tabBarPages = ['pages/index/index', 'pages/profile/profile']
+  const pages = getCurrentPages()
+  if (!pages.length) return
+  const currentPath = pages[pages.length - 1].route
+  if (!tabBarPages.includes(currentPath)) return
+
+  const styles = {
+    dark: {
+      color: '#9494AC',
+      selectedColor: '#E8A838',
+      backgroundColor: '#151520',
+      borderStyle: 'black'
+    },
+    light: {
+      color: '#B5AEA0',
+      selectedColor: '#D49530',
+      backgroundColor: '#FFFFFF',
+      borderStyle: 'white'
+    }
+  }
+  const s = styles[theme] || styles.dark
+  try {
+    uni.setTabBarStyle({
+      color: s.color,
+      selectedColor: s.selectedColor,
+      backgroundColor: s.backgroundColor,
+      borderStyle: s.borderStyle
+    })
+  } catch (e) {}
+}
+
+export function getThemeColors(theme) {
+  const isDark = theme !== 'light'
+  return {
+    textPrimary: isDark ? '#FFFFFF' : '#2C2416',
+    textSecondary: isDark ? '#C0C0D2' : '#8C8474',
+    textTertiary: isDark ? '#9494AC' : '#B5AEA0',
+    amber: isDark ? '#E8A838' : '#D49530',
+    bgBase: isDark ? '#0B0B14' : '#FAF7F2',
+    bgCard: isDark ? '#1A1A28' : '#FFFFFF',
+    cardGradStart: isDark ? '#1A1510' : '#F5F0E8',
+    cardGradEnd: isDark ? '#0D0B08' : '#EDE8DF',
+    borderSubtle: isDark ? 'rgba(232,168,56,0.15)' : 'rgba(212,149,48,0.2)',
+    bgPlaceholder: isDark ? 'rgba(255,255,255,0.03)' : 'rgba(0,0,0,0.04)',
+    emojiBg: isDark ? 'rgba(232,168,56,0.08)' : 'rgba(212,149,48,0.1)'
+  }
+}
+
 /**
  * 检查成就解锁
  */
diff --git a/components/AchievementBadge.vue b/components/AchievementBadge.vue
index 81fa6e1..89b0e62 100644
--- a/components/AchievementBadge.vue
+++ b/components/AchievementBadge.vue
@@ -66,7 +66,7 @@ export default {
   display: flex;
   align-items: center;
   justify-content: center;
-  border: 3rpx solid rgba(255,255,255,0.06);
+  border: 3rpx solid var(--border-faint, rgba(255, 255, 255, 0.08));
   position: relative;
 }
 
diff --git a/components/DrinkCalendar.vue b/components/DrinkCalendar.vue
index 451ab0c..6d251a6 100644
--- a/components/DrinkCalendar.vue
+++ b/components/DrinkCalendar.vue
@@ -126,6 +126,7 @@ export default {
   font-size: $fs-lg;
   font-weight: $fw-bold;
   font-family: $font-num;
+  color: $text-primary;
 }
 
 .cal-weekdays {
@@ -205,7 +206,7 @@ export default {
 
 /* 饮酒日高亮背景 */
 .cal-cell-drank {
-  background: rgba(232, 168, 56, 0.08);
+  background: var(--amber-glow, rgba(232, 168, 56, 0.15));
 }
 
 .cal-cell-abstain {
diff --git a/components/DrinkCard.vue b/components/DrinkCard.vue
index 4a4258a..f01aba3 100644
--- a/components/DrinkCard.vue
+++ b/components/DrinkCard.vue
@@ -34,7 +34,7 @@
     <view class="drink-list">
       <view v-for="(drink, i) in record.drinks" :key="i" class="drink-row">
         <text class="drink-name">{{ getCatEmoji(drink.category) }} {{ drink.brand }}</text>
-        <text class="drink-detail">{{ formatAmount(drink) }}·{{ drink.standardCups }}杯</text>
+        <text class="drink-detail">{{ formatAmount(drink) }}</text>
       </view>
       <view v-if="record.food" class="drink-row">
         <text class="drink-name">🍲 {{ getFoodName() }}</text>
@@ -42,6 +42,11 @@
       </view>
     </view>
 
+    <!-- 饮酒感受 -->
+    <view v-if="feelingLabel" class="feeling-row">
+      <text class="feeling-text">{{ feelingLabel }}</text>
+    </view>
+
     <!-- 分割线 -->
     <view class="divider"></view>
 
@@ -63,7 +68,7 @@
 </template>
 
 <script>
-import { DRINK_CATEGORIES, FOOD_CATEGORIES, DRINK_QUOTES } from '../common/constants'
+import { DRINK_CATEGORIES, FOOD_CATEGORIES, DRINK_QUOTES, FEELINGS } from '../common/constants'
 
 const UNIT_NAMES = { ml: 'ml', liang: '两', bottle: '瓶', cup: '杯', can: '听', shot: 'shot' }
 
@@ -83,6 +88,10 @@ export default {
     mainEmoji() {
       const first = (this.record.drinks || [])[0]
       return first ? this.getCatEmoji(first.category) : '🥃'
+    },
+    feelingLabel() {
+      const f = FEELINGS.find(fe => fe.id === this.record.feeling)
+      return f ? `${f.emoji} ${f.name}` : ''
     }
   },
   methods: {
@@ -109,9 +118,9 @@ export default {
   width: 620rpx;
   border-radius: 32rpx;
   overflow: hidden;
-  background: linear-gradient(170deg, #1A1510 0%, #0D0B08 100%);
-  border: 2rpx solid rgba(232, 168, 56, 0.15);
-  box-shadow: 0 24rpx 80rpx rgba(0, 0, 0, 0.5), 0 0 60rpx rgba(232, 168, 56, 0.06);
+  background: linear-gradient(170deg, var(--card-gradient-start, #1A1510) 0%, var(--card-gradient-end, #0D0B08) 100%);
+  border: 2rpx solid var(--border-subtle, rgba(255, 255, 255, 0.10));
+  box-shadow: var(--shadow-lg, 0 16rpx 48rpx rgba(0, 0, 0, 0.45)), 0 0 60rpx var(--amber-glow, rgba(232, 168, 56, 0.15));
   display: flex;
   flex-direction: column;
 }
@@ -213,6 +222,19 @@ export default {
   margin-left: $sp-md;
 }
 
+/* 饮酒感受 */
+.feeling-row {
+  padding: $sp-sm $sp-xl 0;
+  display: flex;
+  align-items: center;
+}
+.feeling-text {
+  font-size: $fs-base;
+  color: $amber;
+  font-weight: $fw-medium;
+  letter-spacing: 2rpx;
+}
+
 /* 分割线 */
 .divider {
   margin: $sp-lg $sp-xl;
@@ -265,7 +287,7 @@ export default {
   width: 80rpx;
   height: 80rpx;
   border-radius: $radius-sm;
-  border: 2rpx solid rgba(232, 168, 56, 0.15);
-  background: rgba(255, 255, 255, 0.03);
+  border: 2rpx solid var(--border-subtle, rgba(255, 255, 255, 0.10));
+  background: var(--bg-subtle, rgba(255, 255, 255, 0.03));
 }
 </style>
diff --git a/node_modules/.package-lock.json b/node_modules/.package-lock.json
new file mode 100644
index 0000000..5f675e1
--- /dev/null
+++ b/node_modules/.package-lock.json
@@ -0,0 +1,13 @@
+{
+  "name": "hejiu",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "node_modules/HaveADrink": {
+      "version": "1.0.2",
+      "resolved": "https://npm.wash-painting.cn/HaveADrink/-/HaveADrink-1.0.2.tgz",
+      "integrity": "sha512-rhcILwsr6F1SBK7z+C4HMemUHHd63pl5ggxHisky0ZDgCOL7bITf3TGgvoiqXRoAGe4qmV+4FT8E6oCbvD1PIg==",
+      "license": "ISC"
+    }
+  }
+}
diff --git a/node_modules/HaveADrink/README.md b/node_modules/HaveADrink/README.md
new file mode 100644
index 0000000..9196d80
--- /dev/null
+++ b/node_modules/HaveADrink/README.md
@@ -0,0 +1,1115 @@
+# 使用说明
+
+
+ * 喝酒了么 - 后端接口 API
+ * 小程序：喝酒了么（uni-app 微信小程序）
+ * 基础URL: /api/v1
+ * 
+ * 主要功能模块：
+ * 1. 用户模块 - 微信登录、用户信息管理
+ * 2. 打卡记录模块 - 饮酒记录创建、查询、日历数据
+ * 3. 照片上传模块 - 单张/批量照片上传
+ * 4. 统计模块 - 用户统计、月度统计、酒类分布
+ * 5. 成就模块 - 成就列表和进度
+ * 6. 社交模块 - 朋友圈动态、点赞
+ 
+
+**版本:** v1.0.2
+
+## 安装
+
+```
+npm install --registry="https://npm.wash-painting.cn" HaveADrink
+```
+
+## 用法
+
+用户需实现普通 http 请求函数和文件上传函数，返回值均为 json 对象
+
+**示例**
+```javascript
+// reslove 和 reject 必须返回 json 对象
+const http_request_function = (url, method, headers, body) => {
+    return new Promise((reslove, reject)=>{});
+}
+
+const upload_function = (url, method, headers, data) => {
+    return new Promise((reslove, reject)=>{});
+}
+
+const client = new HaveADrink(host, http_request_function, upload_function);
+```
+
+## 接口文档
+
+
+###  微信登录, 获取openid、unionid、token
+
+
+
+<font color="green">POST</font> `/api/have_a_drink/v1/auth/wechat/login`
+
+#### 请求参数
+|名称|类型|校验规则|说明|
+|:-|:-|:-|:-|
+|code|`string`|required| 登录时获取的 code, 可通过 wx.login 获取|
+|nickName|`string`|| 用户昵称|
+|avatarUrl|`string`|| 头像URL|
+
+
+
+
+#### 返回值
+|名称|类型|说明|
+|:-|:-:|:-|
+|token|`string`| JWT Token<br>|
+|user|`User`| 用户信息<br>|
+|isNew|`boolean`| 是否新用户<br>|
+|session_key|`string`| 会话密钥<br>|
+|open_id|`string`| 用户唯一标识<br>|
+|union_id|`string`| 用户在开放平台的唯一标识符，若当前小程序已绑定到微信开放平台账号下会返回，详见 UnionID 机制说明。<br>|
+|errcode|`number`| 错误码<br>|
+|errmsg|`string`| 错误信息<br>|
+|refresh_token|`string`| 刷新token<br>|
+
+
+
+**User**
+|名称|类型|说明|
+|:-|:-|:-|
+|id|`string\|number`| 用户ID|
+|nickname|`string`| 用户昵称|
+|avatar|`string`| 头像URL|
+|joinedAt|`string`| 加入时间|
+|preferences|`UserPreferences`| 用户偏好|
+
+
+**UserPreferences**
+|名称|类型|说明|
+|:-|:-|:-|
+|favoriteCategories|`Array<Category>`| 偏好酒类ID列表|
+|frequency|`Frequency`| 饮酒频率|
+
+
+
+```javascript
+const req = new WechatLoginReq()
+client.WechatLogin(req).then(...).catch(...)
+```
+
+###  获取微信手机号
+
+
+
+<font color="green">POST</font> `/api/have_a_drink/v1/auth/wechat/get_phone_number`
+
+#### 请求参数
+|名称|类型|校验规则|说明|
+|:-|:-|:-|:-|
+|code|`string`|required| 手机号获取凭证|
+
+
+
+
+#### 返回值
+|名称|类型|说明|
+|:-|:-:|:-|
+|errcode|`number`| 错误码<br>|
+|errmsg|`string`| 错误信息<br>|
+|token|`string`| token:api使用<br>|
+|expires_in|`number`| token 超时时间，单位（秒）<br>|
+|refresh_token|`string`| refresh_token:刷新token<br>|
+
+
+
+
+```javascript
+const req = new WechatGetPhoneNumberReq()
+client.WechatGetPhoneNumber(req).then(...).catch(...)
+```
+
+###  刷新 token 接口
+
+
+
+<font color="green">POST</font> `/api/have_a_drink/v1/auth/refresh_token`
+
+#### 请求参数
+|名称|类型|校验规则|说明|
+|:-|:-|:-|:-|
+|refresh_token|`string`|required| 签发 token 时生成的 refresh_token|
+
+
+
+
+#### 返回值
+|名称|类型|说明|
+|:-|:-:|:-|
+|token|`string`| 生成的新token<br>|
+|expire_in|`number`| token 超时时间，单位（秒）<br>|
+|refresh_token|`string`| refresh_token:刷新token<br>|
+
+
+
+
+```javascript
+const req = new RefreshTokenReq()
+client.RefreshToken(req).then(...).catch(...)
+```
+
+###  获取成就列表
+
+
+
+<font color="green">GET</font> `/api/have_a_drink/v1/achievements/list`
+
+#### 请求参数
+|名称|类型|校验规则|说明|
+|:-|:-|:-|:-|
+
+
+
+
+#### 返回值
+|名称|类型|说明|
+|:-|:-:|:-|
+|data|`AchievementsData`| 成就列表数据<br>|
+
+
+
+**AchievementsData**
+|名称|类型|说明|
+|:-|:-|:-|
+|achievements|`Array<Achievement>`| 成就列表|
+
+
+**Achievement**
+|名称|类型|说明|
+|:-|:-|:-|
+|id|`string`| 成就ID|
+|name|`string`| 成就名称|
+|desc|`string`| 成就描述|
+|icon|`string`| 成就图标|
+|unlocked|`boolean`| 是否已解锁|
+|unlockedAt|`string`| 解锁时间|
+|condition|`AchievementCondition`| 成就条件|
+|progress|`number`| 进度（0-1）|
+
+
+**AchievementCondition**
+|名称|类型|说明|
+|:-|:-|:-|
+|type|`AchievementConditionType`| 条件类型|
+|value|`number`| 目标值|
+
+
+**AchievementConditionType**
+|名称|值|类型|说明|
+|:-|:-:|:-|:-|
+|TotalRecords|"total_records"|`AchievementConditionType`|总记录数|
+|TotalStandardCups|"total_standard_cups"|`AchievementConditionType`|累计标准杯|
+|StreakDays|"streak_days"|`AchievementConditionType`|连续打卡天数|
+|CategoryRecords|"category_records"|`AchievementConditionType`|某酒类打卡次数|
+|CategoryVariety|"category_variety"|`AchievementConditionType`|尝试酒类品种数|
+
+
+
+```javascript
+const req = new GetAchievementsReq()
+client.GetAchievements(req).then(...).catch(...)
+```
+
+###  获取朋友圈动态
+
+
+
+<font color="green">GET</font> `/api/have_a_drink/v1/communication/feed`
+
+#### 请求参数
+|名称|类型|校验规则|说明|
+|:-|:-|:-|:-|
+|lastId|`string\|number`|| 游标分页，上一页最后一条ID|
+
+
+
+
+#### 返回值
+|名称|类型|说明|
+|:-|:-:|:-|
+|data|`FeedPageData`| 朋友圈动态分页数据<br>|
+
+
+
+**FeedPageData**
+|名称|类型|说明|
+|:-|:-|:-|
+|list|`Array<FeedItem>`| 动态列表|
+
+
+**FeedItem**
+|名称|类型|说明|
+|:-|:-|:-|
+|id|`string\|number`| 记录ID|
+|user|`FeedUser`| 用户信息|
+|date|`string`| 日期|
+|mode|`Mode`| 打卡模式|
+|drinks|`Array<DrinkItem>`| 酒水列表|
+|food|`FoodInfo`| 配餐信息|
+|feeling|`Feeling`| 感受|
+|photos|`Array<string>`| 照片URL数组|
+|standardCupsTotal|`number`| 标准杯总数|
+|quote|`string`| 酒言酒语|
+|likeCount|`number`| 点赞数|
+|commentCount|`number`| 评论数|
+|liked|`boolean`| 当前用户是否已点赞|
+|createdAt|`string`| 创建时间|
+
+
+**FeedUser**
+|名称|类型|说明|
+|:-|:-|:-|
+|id|`string\|number`| 用户ID|
+|nickname|`string`| 用户昵称|
+|avatar|`string`| 头像URL|
+
+
+**DrinkItem**
+|名称|类型|说明|
+|:-|:-|:-|
+|category|`Category`| 酒类分类ID|
+|brand|`string`| 品牌名称|
+|product|`string`| 产品名|
+|amount|`number`| 饮用量数值|
+|unit|`Unit`| 单位|
+|degree|`number`| 酒精度数(%)|
+|standardCups|`number`| 标准杯数（前端计算，后端应校验）|
+
+
+**Category**
+|名称|值|类型|说明|
+|:-|:-:|:-|:-|
+|Baijiu|"baijiu"|`Category`|白酒|
+|Beer|"beer"|`Category`|啤酒|
+|Wine|"wine"|`Category`|红酒|
+|Whisky|"whisky"|`Category`|洋酒|
+|Huangjiu|"huangjiu"|`Category`|黄酒|
+|Sake|"sake"|`Category`|清酒|
+|Fruit|"fruit"|`Category`|果酒|
+|Cocktail|"cocktail"|`Category`|调酒|
+|Other|"other"|`Category`|其他|
+
+
+**Unit**
+|名称|值|类型|说明|
+|:-|:-:|:-|:-|
+|Ml|"ml"|`Unit`|毫升|
+|Liang|"liang"|`Unit`|两|
+|Bottle|"bottle"|`Unit`|瓶|
+|Cup|"cup"|`Unit`|杯|
+|Can|"can"|`Unit`|听|
+|Shot|"shot"|`Unit`|shot|
+
+
+**FoodInfo**
+|名称|类型|说明|
+|:-|:-|:-|
+|category|`FoodCategory`| 配餐分类ID|
+|name|`string`| 具体菜名|
+
+
+**FoodCategory**
+|名称|值|类型|说明|
+|:-|:-:|:-|:-|
+|Hotpot|"hotpot"|`FoodCategory`|火锅|
+|Bbq|"bbq"|`FoodCategory`|烧烤|
+|Stirfry|"stirfry"|`FoodCategory`|炒菜|
+|Seafood|"seafood"|`FoodCategory`|海鲜|
+|Japanese|"japanese"|`FoodCategory`|日料|
+|Western|"western"|`FoodCategory`|西餐|
+|Snack|"snack"|`FoodCategory`|小吃卤味|
+|Junk|"junk"|`FoodCategory`|零食|
+|None|"none"|`FoodCategory`|无配餐|
+
+
+
+```javascript
+const req = new GetFeedReq()
+client.GetFeed(req).then(...).catch(...)
+```
+
+###  点赞
+
+
+
+<font color="green">POST</font> `/api/have_a_drink/v1/communication/records/like`
+
+#### 请求参数
+|名称|类型|校验规则|说明|
+|:-|:-|:-|:-|
+|id|`string\|number`|required| 记录ID|
+
+
+
+
+#### 返回值
+|名称|类型|说明|
+|:-|:-:|:-|
+
+
+
+
+```javascript
+const req = new LikeRecordReq()
+client.LikeRecord(req).then(...).catch(...)
+```
+
+###  取消点赞
+
+
+
+<font color="green">POST</font> `/api/have_a_drink/v1/communication/records/unlike`
+
+#### 请求参数
+|名称|类型|校验规则|说明|
+|:-|:-|:-|:-|
+|id|`string\|number`|required| 记录ID|
+
+
+
+
+#### 返回值
+|名称|类型|说明|
+|:-|:-:|:-|
+
+
+
+
+```javascript
+const req = new LikeRecordReq()
+client.UnlikeRecord(req).then(...).catch(...)
+```
+
+###  上传照片
+
+
+
+<font color="green">POST</font> `/api/have_a_drink/v1/photo/upload/photo`
+
+#### 请求参数
+|名称|类型|校验规则|说明|
+|:-|:-|:-|:-|
+|url|`string`|required| 图片Url|
+|recordId|`string\|number`|required| 关联记录ID|
+
+
+
+
+#### 返回值
+|名称|类型|说明|
+|:-|:-:|:-|
+
+
+
+
+```javascript
+const req = new UploadPhotoReq()
+client.UploadPhoto(req).then(...).catch(...)
+```
+
+###  批量上传照片
+
+
+
+<font color="green">POST</font> `/api/have_a_drink/v1/photo/upload/photos`
+
+#### 请求参数
+|名称|类型|校验规则|说明|
+|:-|:-|:-|:-|
+|urls|`Array<string>`|required,max=9| 图片URL数组（最多9张）|
+|recordId|`string\|number`|required| 关联记录ID|
+
+
+
+
+#### 返回值
+|名称|类型|说明|
+|:-|:-:|:-|
+
+
+
+
+```javascript
+const req = new UploadPhotosReq()
+client.UploadPhotos(req).then(...).catch(...)
+```
+
+###  创建打卡记录
+
+
+
+<font color="green">POST</font> `/api/have_a_drink/v1/record/records`
+
+#### 请求参数
+|名称|类型|校验规则|说明|
+|:-|:-|:-|:-|
+|date|`string`|required| 日期 YYYY-MM-DD|
+|mode|`Mode`|今日喝了: Mode.Drank = "drank"<br>今日未喝: Mode.Abstain = "abstain"| 打卡模式|
+|drinks|`Array<DrinkItem>`|| 酒水列表（mode=abstain时为空数组）|
+|food|`FoodInfo`|| 配餐信息|
+|feeling|`Feeling`|微醺: Feeling.Tipsy = "tipsy"<br>到位: Feeling.Buzzed = "buzzed"<br>醉了: Feeling.Drunk = "drunk"<br>断片: Feeling.Blackout = "blackout"| 感受ID|
+|photos|`Array<string>`|max=9| 照片URL数组（最多9张）|
+|visibility|`Visibility`|公开: Visibility.Public = "public"<br>仅好友: Visibility.Friends = "friends"<br>仅自己: Visibility.Private = "private"| 可见范围|
+|quote|`string`|| 酒言酒语|
+
+
+
+**DrinkItem**
+|名称|类型|校验规则|说明|
+|:-|:-|:-|:-|
+|category|`Category`|required| 酒类分类ID|
+|brand|`string`|required| 品牌名称|
+|product|`string`|| 产品名|
+|amount|`number`|required,gt=0| 饮用量数值|
+|unit|`Unit`|required| 单位|
+|degree|`number`|required,gte=0,lte=100| 酒精度数(%)|
+|standardCups|`number`|| 标准杯数（前端计算，后端应校验）|
+
+
+**Category**
+|名称|值|类型|说明|
+|:-|:-|:-|:-|
+|Baijiu|"baijiu"|`Category`|白酒|
+|Beer|"beer"|`Category`|啤酒|
+|Wine|"wine"|`Category`|红酒|
+|Whisky|"whisky"|`Category`|洋酒|
+|Huangjiu|"huangjiu"|`Category`|黄酒|
+|Sake|"sake"|`Category`|清酒|
+|Fruit|"fruit"|`Category`|果酒|
+|Cocktail|"cocktail"|`Category`|调酒|
+|Other|"other"|`Category`|其他|
+
+
+
+**Unit**
+|名称|值|类型|说明|
+|:-|:-|:-|:-|
+|Ml|"ml"|`Unit`|毫升|
+|Liang|"liang"|`Unit`|两|
+|Bottle|"bottle"|`Unit`|瓶|
+|Cup|"cup"|`Unit`|杯|
+|Can|"can"|`Unit`|听|
+|Shot|"shot"|`Unit`|shot|
+
+
+
+**FoodInfo**
+|名称|类型|校验规则|说明|
+|:-|:-|:-|:-|
+|category|`FoodCategory`|required| 配餐分类ID|
+|name|`string`|| 具体菜名|
+
+
+**FoodCategory**
+|名称|值|类型|说明|
+|:-|:-|:-|:-|
+|Hotpot|"hotpot"|`FoodCategory`|火锅|
+|Bbq|"bbq"|`FoodCategory`|烧烤|
+|Stirfry|"stirfry"|`FoodCategory`|炒菜|
+|Seafood|"seafood"|`FoodCategory`|海鲜|
+|Japanese|"japanese"|`FoodCategory`|日料|
+|Western|"western"|`FoodCategory`|西餐|
+|Snack|"snack"|`FoodCategory`|小吃卤味|
+|Junk|"junk"|`FoodCategory`|零食|
+|None|"none"|`FoodCategory`|无配餐|
+
+
+
+
+#### 返回值
+|名称|类型|说明|
+|:-|:-:|:-|
+|data|`Record`| 创建的记录详情<br>|
+
+
+
+**Record**
+|名称|类型|说明|
+|:-|:-|:-|
+|id|`string\|number`| 记录ID|
+|date|`string`| 日期|
+|mode|`Mode`| 打卡模式|
+|drinks|`Array<DrinkItem>`| 酒水列表|
+|food|`FoodInfo`| 配餐信息|
+|feeling|`Feeling`| 感受|
+|photos|`Array<string>`| 照片URL数组|
+|visibility|`Visibility`| 可见范围|
+|quote|`string`| 酒言酒语|
+|standardCupsTotal|`number`| 标准杯总数|
+|createdAt|`string`| 创建时间|
+
+
+**Mode**
+|名称|值|类型|说明|
+|:-|:-:|:-|:-|
+|Drank|"drank"|`Mode`|今日喝了|
+|Abstain|"abstain"|`Mode`|今日未喝|
+
+
+**DrinkItem**
+|名称|类型|说明|
+|:-|:-|:-|
+|category|`Category`| 酒类分类ID|
+|brand|`string`| 品牌名称|
+|product|`string`| 产品名|
+|amount|`number`| 饮用量数值|
+|unit|`Unit`| 单位|
+|degree|`number`| 酒精度数(%)|
+|standardCups|`number`| 标准杯数（前端计算，后端应校验）|
+
+
+**FoodInfo**
+|名称|类型|说明|
+|:-|:-|:-|
+|category|`FoodCategory`| 配餐分类ID|
+|name|`string`| 具体菜名|
+
+
+**Feeling**
+|名称|值|类型|说明|
+|:-|:-:|:-|:-|
+|Tipsy|"tipsy"|`Feeling`|微醺|
+|Buzzed|"buzzed"|`Feeling`|到位|
+|Drunk|"drunk"|`Feeling`|醉了|
+|Blackout|"blackout"|`Feeling`|断片|
+
+
+**Visibility**
+|名称|值|类型|说明|
+|:-|:-:|:-|:-|
+|Public|"public"|`Visibility`|公开|
+|Friends|"friends"|`Visibility`|仅好友|
+|Private|"private"|`Visibility`|仅自己|
+
+
+
+```javascript
+const req = new CreateRecordReq()
+client.CreateRecord(req).then(...).catch(...)
+```
+
+###  获取记录列表
+
+
+
+<font color="green">GET</font> `/api/have_a_drink/v1/record/records`
+
+#### 请求参数
+|名称|类型|校验规则|说明|
+|:-|:-|:-|:-|
+|page|`number`|required,min=1| 页码|
+|pageSize|`number`|required,min=1,max=100| 每页数量，默认1-100|
+|month|`string`|| 月份筛选 YYYY-MM|
+|mode|`Mode`|今日喝了: Mode.Drank = "drank"<br>今日未喝: Mode.Abstain = "abstain"| 打卡模式筛选|
+
+
+
+
+#### 返回值
+|名称|类型|说明|
+|:-|:-:|:-|
+|list|`Array<Record>`| 分页数据<br>|
+
+
+
+**Record**
+|名称|类型|说明|
+|:-|:-|:-|
+|id|`string\|number`| 记录ID|
+|date|`string`| 日期|
+|mode|`Mode`| 打卡模式|
+|drinks|`Array<DrinkItem>`| 酒水列表|
+|food|`FoodInfo`| 配餐信息|
+|feeling|`Feeling`| 感受|
+|photos|`Array<string>`| 照片URL数组|
+|visibility|`Visibility`| 可见范围|
+|quote|`string`| 酒言酒语|
+|standardCupsTotal|`number`| 标准杯总数|
+|createdAt|`string`| 创建时间|
+
+
+**Mode**
+|名称|值|类型|说明|
+|:-|:-:|:-|:-|
+|Drank|"drank"|`Mode`|今日喝了|
+|Abstain|"abstain"|`Mode`|今日未喝|
+
+
+**DrinkItem**
+|名称|类型|说明|
+|:-|:-|:-|
+|category|`Category`| 酒类分类ID|
+|brand|`string`| 品牌名称|
+|product|`string`| 产品名|
+|amount|`number`| 饮用量数值|
+|unit|`Unit`| 单位|
+|degree|`number`| 酒精度数(%)|
+|standardCups|`number`| 标准杯数（前端计算，后端应校验）|
+
+
+**FoodInfo**
+|名称|类型|说明|
+|:-|:-|:-|
+|category|`FoodCategory`| 配餐分类ID|
+|name|`string`| 具体菜名|
+
+
+**Feeling**
+|名称|值|类型|说明|
+|:-|:-:|:-|:-|
+|Tipsy|"tipsy"|`Feeling`|微醺|
+|Buzzed|"buzzed"|`Feeling`|到位|
+|Drunk|"drunk"|`Feeling`|醉了|
+|Blackout|"blackout"|`Feeling`|断片|
+
+
+**Visibility**
+|名称|值|类型|说明|
+|:-|:-:|:-|:-|
+|Public|"public"|`Visibility`|公开|
+|Friends|"friends"|`Visibility`|仅好友|
+|Private|"private"|`Visibility`|仅自己|
+
+
+
+```javascript
+const req = new GetRecordsReq()
+client.GetRecords(req).then(...).catch(...)
+```
+
+###  获取单条记录详情
+
+
+
+<font color="green">GET</font> `/api/have_a_drink/v1/record/records/detail`
+
+#### 请求参数
+|名称|类型|校验规则|说明|
+|:-|:-|:-|:-|
+|id|`string\|number`|required| 记录ID|
+
+
+
+
+#### 返回值
+|名称|类型|说明|
+|:-|:-:|:-|
+|data|`Record`| 记录详情<br>|
+
+
+
+**Record**
+|名称|类型|说明|
+|:-|:-|:-|
+|id|`string\|number`| 记录ID|
+|date|`string`| 日期|
+|mode|`Mode`| 打卡模式|
+|drinks|`Array<DrinkItem>`| 酒水列表|
+|food|`FoodInfo`| 配餐信息|
+|feeling|`Feeling`| 感受|
+|photos|`Array<string>`| 照片URL数组|
+|visibility|`Visibility`| 可见范围|
+|quote|`string`| 酒言酒语|
+|standardCupsTotal|`number`| 标准杯总数|
+|createdAt|`string`| 创建时间|
+
+
+**Mode**
+|名称|值|类型|说明|
+|:-|:-:|:-|:-|
+|Drank|"drank"|`Mode`|今日喝了|
+|Abstain|"abstain"|`Mode`|今日未喝|
+
+
+**DrinkItem**
+|名称|类型|说明|
+|:-|:-|:-|
+|category|`Category`| 酒类分类ID|
+|brand|`string`| 品牌名称|
+|product|`string`| 产品名|
+|amount|`number`| 饮用量数值|
+|unit|`Unit`| 单位|
+|degree|`number`| 酒精度数(%)|
+|standardCups|`number`| 标准杯数（前端计算，后端应校验）|
+
+
+**FoodInfo**
+|名称|类型|说明|
+|:-|:-|:-|
+|category|`FoodCategory`| 配餐分类ID|
+|name|`string`| 具体菜名|
+
+
+**Feeling**
+|名称|值|类型|说明|
+|:-|:-:|:-|:-|
+|Tipsy|"tipsy"|`Feeling`|微醺|
+|Buzzed|"buzzed"|`Feeling`|到位|
+|Drunk|"drunk"|`Feeling`|醉了|
+|Blackout|"blackout"|`Feeling`|断片|
+
+
+**Visibility**
+|名称|值|类型|说明|
+|:-|:-:|:-|:-|
+|Public|"public"|`Visibility`|公开|
+|Friends|"friends"|`Visibility`|仅好友|
+|Private|"private"|`Visibility`|仅自己|
+
+
+
+```javascript
+const req = new GetRecordDetailReq()
+client.GetRecordDetail(req).then(...).catch(...)
+```
+
+###  删除记录
+
+
+
+<font color="green">DELETE</font> `/api/have_a_drink/v1/record/records`
+
+#### 请求参数
+|名称|类型|校验规则|说明|
+|:-|:-|:-|:-|
+|id|`string\|number`|required| 记录ID|
+
+
+
+
+#### 返回值
+|名称|类型|说明|
+|:-|:-:|:-|
+
+
+
+
+```javascript
+const req = new DeleteRecordReq()
+client.DeleteRecord(req).then(...).catch(...)
+```
+
+###  获取日历打卡数据
+
+
+
+<font color="green">GET</font> `/api/have_a_drink/v1/record/records/calendar`
+
+#### 请求参数
+|名称|类型|校验规则|说明|
+|:-|:-|:-|:-|
+|year|`number`|required| 年份|
+|month|`number`|required,gte=1,lte=12| 月份(1-12)|
+
+
+
+
+#### 返回值
+|名称|类型|说明|
+|:-|:-:|:-|
+|data|`CalendarData`| 日历数据<br>|
+
+
+
+**CalendarData**
+|名称|类型|说明|
+|:-|:-|:-|
+|year|`number`| 年份|
+|month|`number`| 月份|
+|days|`Array<CalendarDayData>`| 每天的打卡数据，null表示当天无记录|
+
+
+**CalendarDayData**
+|名称|类型|说明|
+|:-|:-|:-|
+|date|`string`| 日期YYYY-MM-DD|
+|hasRecord|`boolean`| 是否有记录|
+|mode|`Mode`| 打卡模式|
+|standardCupsTotal|`number`| 标准杯总数|
+
+
+
+```javascript
+const req = new GetCalendarReq()
+client.GetCalendar(req).then(...).catch(...)
+```
+
+###  获取用户统计概览
+
+
+
+<font color="green">GET</font> `/api/have_a_drink/v1/statistics/overview`
+
+#### 请求参数
+|名称|类型|校验规则|说明|
+|:-|:-|:-|:-|
+
+
+
+
+#### 返回值
+|名称|类型|说明|
+|:-|:-:|:-|
+|data|`StatsOverview`| 统计概览数据<br>|
+
+
+
+**StatsOverview**
+|名称|类型|说明|
+|:-|:-|:-|
+|weekDrinkCount|`number`| 本周饮酒天数|
+|weekCups|`number`| 本周标准杯总数|
+|monthDrinkCount|`number`| 本月饮酒天数|
+|monthCups|`number`| 本月标准杯总数|
+|streak|`number`| 当前连续打卡天数|
+|streakType|`Mode`| 连续类型|
+|totalDays|`number`| 总饮酒天数（去重）|
+|totalRecords|`number`| 总记录数|
+|totalCups|`number`| 历史累计标准杯|
+|favCategory|`Category`| 最爱酒类ID|
+|categoryVariety|`number`| 尝试过的酒类品种数|
+
+
+**Mode**
+|名称|值|类型|说明|
+|:-|:-:|:-|:-|
+|Drank|"drank"|`Mode`|今日喝了|
+|Abstain|"abstain"|`Mode`|今日未喝|
+
+
+**Category**
+|名称|值|类型|说明|
+|:-|:-:|:-|:-|
+|Baijiu|"baijiu"|`Category`|白酒|
+|Beer|"beer"|`Category`|啤酒|
+|Wine|"wine"|`Category`|红酒|
+|Whisky|"whisky"|`Category`|洋酒|
+|Huangjiu|"huangjiu"|`Category`|黄酒|
+|Sake|"sake"|`Category`|清酒|
+|Fruit|"fruit"|`Category`|果酒|
+|Cocktail|"cocktail"|`Category`|调酒|
+|Other|"other"|`Category`|其他|
+
+
+
+```javascript
+const req = new GetStatsOverviewReq()
+client.GetStatsOverview(req).then(...).catch(...)
+```
+
+###  获取月度统计
+
+
+
+<font color="green">GET</font> `/api/have_a_drink/v1/statistics/monthly`
+
+#### 请求参数
+|名称|类型|校验规则|说明|
+|:-|:-|:-|:-|
+|year|`number`|| 年份，默认当前年|
+|month|`number`|| 月份，默认当前月|
+
+
+
+
+#### 返回值
+|名称|类型|说明|
+|:-|:-:|:-|
+|data|`MonthlyStats`| 月度统计数据<br>|
+
+
+
+**MonthlyStats**
+|名称|类型|说明|
+|:-|:-|:-|
+|year|`number`| 年份|
+|month|`number`| 月份|
+|drinkDays|`number`| 饮酒天数|
+|abstainDays|`number`| 戒酒天数|
+|totalCups|`number`| 总标准杯数|
+|avgCupsPerDay|`number`| 日均标准杯数|
+|categoryBreakdown|`Array<CategoryBreakdown>`| 酒类分布|
+|feelingBreakdown|`Array<FeelingBreakdown>`| 感受分布|
+|foodBreakdown|`Array<FoodBreakdown>`| 配餐分布|
+
+
+**CategoryBreakdown**
+|名称|类型|说明|
+|:-|:-|:-|
+|category|`Category`| 酒类分类|
+|count|`number`| 次数|
+|cups|`number`| 标准杯数|
+
+
+**FeelingBreakdown**
+|名称|类型|说明|
+|:-|:-|:-|
+|feeling|`Feeling`| 感受类型|
+|count|`number`| 次数|
+
+
+**FoodBreakdown**
+|名称|类型|说明|
+|:-|:-|:-|
+|category|`FoodCategory`| 配餐分类|
+|count|`number`| 次数|
+
+
+
+```javascript
+const req = new GetMonthlyStatsReq()
+client.GetMonthlyStats(req).then(...).catch(...)
+```
+
+###  获取酒类分布统计
+
+
+
+<font color="green">GET</font> `/api/have_a_drink/v1/statistics/categories`
+
+#### 请求参数
+|名称|类型|校验规则|说明|
+|:-|:-|:-|:-|
+
+
+
+
+#### 返回值
+|名称|类型|说明|
+|:-|:-:|:-|
+|data|`CategoryStatsData`| 酒类分布统计数据<br>|
+
+
+
+**CategoryStatsData**
+|名称|类型|说明|
+|:-|:-|:-|
+|categories|`Array<CategoryStats>`| 酒类分布列表|
+
+
+**CategoryStats**
+|名称|类型|说明|
+|:-|:-|:-|
+|id|`Category`| 酒类分类ID|
+|name|`string`| 酒类名称|
+|recordCount|`number`| 记录次数|
+|totalCups|`number`| 总标准杯数|
+|percentage|`number`| 占比（百分比）|
+
+
+
+```javascript
+const req = new GetCategoryStatsReq()
+client.GetCategoryStats(req).then(...).catch(...)
+```
+
+###  获取用户信息
+
+
+
+<font color="green">GET</font> `/api/have_a_drink/v1/user/user/profile`
+
+#### 请求参数
+|名称|类型|校验规则|说明|
+|:-|:-|:-|:-|
+
+
+
+
+#### 返回值
+|名称|类型|说明|
+|:-|:-:|:-|
+|id|`string\|number`| 用户ID<br>|
+|nickname|`string`| 用户昵称<br>|
+|avatar|`string`| 头像URL<br>|
+|joinedAt|`string`| 加入时间<br>|
+|preferences|`UserPreferences`| 用户偏好<br>|
+
+
+
+**UserPreferences**
+|名称|类型|说明|
+|:-|:-|:-|
+|favoriteCategories|`Array<Category>`| 偏好酒类ID列表|
+|frequency|`Frequency`| 饮酒频率|
+
+
+**Frequency**
+|名称|值|类型|说明|
+|:-|:-:|:-|:-|
+|Rarely|"rarely"|`Frequency`|很少|
+|Sometimes|"sometimes"|`Frequency`|有时|
+|Often|"often"|`Frequency`|经常|
+
+
+
+```javascript
+const req = new GetUserProfileReq()
+client.GetUserProfile(req).then(...).catch(...)
+```
+
+###  更新用户偏好
+
+
+
+<font color="green">PUT</font> `/api/have_a_drink/v1/user/user/preferences`
+
+#### 请求参数
+|名称|类型|校验规则|说明|
+|:-|:-|:-|:-|
+|favoriteCategories|`Array<Category>`|| 偏好酒类ID列表|
+|frequency|`Frequency`|很少: Frequency.Rarely = "rarely"<br>有时: Frequency.Sometimes = "sometimes"<br>经常: Frequency.Often = "often"| 饮酒频率|
+
+
+
+
+#### 返回值
+|名称|类型|说明|
+|:-|:-:|:-|
+|favoriteCategories|`Array<Category>`| 偏好酒类ID列表<br>|
+|frequency|`Frequency`| 饮酒频率<br>很少: Frequency.Rarely = "rarely"<br>有时: Frequency.Sometimes = "sometimes"<br>经常: Frequency.Often = "often"|
+
+
+
+
+```javascript
+const req = new UpdatePreferencesReq()
+client.UpdatePreferences(req).then(...).catch(...)
+```
+
+###  上传文件
+
+
+
+<font color="green">POST</font> `/api/have_a_drink/v1/upload/image`
+
+#### 请求参数
+|名称|类型|校验规则|说明|
+|:-|:-|:-|:-|
+|image|`any`|required| 图片|
+
+
+
+
+#### 返回值
+|名称|类型|说明|
+|:-|:-:|:-|
+|id|`string\|number`| 图片 id<br>|
+|url|`string`| 图片 url<br>|
+
+
+
+
+```javascript
+const req = new UploadImageReq()
+client.UploadImage(req).then(...).catch(...)
+```
diff --git a/node_modules/HaveADrink/index.d.ts b/node_modules/HaveADrink/index.d.ts
new file mode 100644
index 0000000..9aa88e2
--- /dev/null
+++ b/node_modules/HaveADrink/index.d.ts
@@ -0,0 +1,2701 @@
+/*
+ * 喝酒了么 - 后端接口 API
+ * 小程序：喝酒了么（uni-app 微信小程序）
+ * 基础URL: /api/v1
+ * 
+ * 主要功能模块：
+ * 1. 用户模块 - 微信登录、用户信息管理
+ * 2. 打卡记录模块 - 饮酒记录创建、查询、日历数据
+ * 3. 照片上传模块 - 单张/批量照片上传
+ * 4. 统计模块 - 用户统计、月度统计、酒类分布
+ * 5. 成就模块 - 成就列表和进度
+ * 6. 社交模块 - 朋友圈动态、点赞
+ */
+
+export declare interface option {
+    value: number | string;
+    text: string;
+}
+
+/**
+ * 枚举类型基类
+ */
+export declare class Enum {
+    constructor(value: number|string);
+    toString(): number|string;
+    toJSON(): number|string;
+    valueOf(): number|string;
+}
+
+/**
+ * 成就条件类型
+ */
+export declare class AchievementConditionType extends Enum {
+    /**
+     * 总记录数
+     */
+    static TotalRecords: AchievementConditionType;
+    /**
+     * 累计标准杯
+     */
+    static TotalStandardCups: AchievementConditionType;
+    /**
+     * 连续打卡天数
+     */
+    static StreakDays: AchievementConditionType;
+    /**
+     * 某酒类打卡次数
+     */
+    static CategoryRecords: AchievementConditionType;
+    /**
+     * 尝试酒类品种数
+     */
+    static CategoryVariety: AchievementConditionType;
+
+    static entries(): Array<option>;
+    static getLabel(v: number|string): string;
+}
+
+/**
+ * 酒类分类
+ */
+export declare class Category extends Enum {
+    /**
+     * 白酒
+     */
+    static Baijiu: Category;
+    /**
+     * 啤酒
+     */
+    static Beer: Category;
+    /**
+     * 红酒
+     */
+    static Wine: Category;
+    /**
+     * 洋酒
+     */
+    static Whisky: Category;
+    /**
+     * 黄酒
+     */
+    static Huangjiu: Category;
+    /**
+     * 清酒
+     */
+    static Sake: Category;
+    /**
+     * 果酒
+     */
+    static Fruit: Category;
+    /**
+     * 调酒
+     */
+    static Cocktail: Category;
+    /**
+     * 其他
+     */
+    static Other: Category;
+
+    static entries(): Array<option>;
+    static getLabel(v: number|string): string;
+}
+
+/**
+ * 饮用量单位
+ */
+export declare class Unit extends Enum {
+    /**
+     * 毫升
+     */
+    static Ml: Unit;
+    /**
+     * 两
+     */
+    static Liang: Unit;
+    /**
+     * 瓶
+     */
+    static Bottle: Unit;
+    /**
+     * 杯
+     */
+    static Cup: Unit;
+    /**
+     * 听
+     */
+    static Can: Unit;
+    /**
+     * shot
+     */
+    static Shot: Unit;
+
+    static entries(): Array<option>;
+    static getLabel(v: number|string): string;
+}
+
+/**
+ * 配餐分类
+ */
+export declare class FoodCategory extends Enum {
+    /**
+     * 火锅
+     */
+    static Hotpot: FoodCategory;
+    /**
+     * 烧烤
+     */
+    static Bbq: FoodCategory;
+    /**
+     * 炒菜
+     */
+    static Stirfry: FoodCategory;
+    /**
+     * 海鲜
+     */
+    static Seafood: FoodCategory;
+    /**
+     * 日料
+     */
+    static Japanese: FoodCategory;
+    /**
+     * 西餐
+     */
+    static Western: FoodCategory;
+    /**
+     * 小吃卤味
+     */
+    static Snack: FoodCategory;
+    /**
+     * 零食
+     */
+    static Junk: FoodCategory;
+    /**
+     * 无配餐
+     */
+    static None: FoodCategory;
+
+    static entries(): Array<option>;
+    static getLabel(v: number|string): string;
+}
+
+/**
+ * 饮用感受
+ */
+export declare class Feeling extends Enum {
+    /**
+     * 微醺
+     */
+    static Tipsy: Feeling;
+    /**
+     * 到位
+     */
+    static Buzzed: Feeling;
+    /**
+     * 醉了
+     */
+    static Drunk: Feeling;
+    /**
+     * 断片
+     */
+    static Blackout: Feeling;
+
+    static entries(): Array<option>;
+    static getLabel(v: number|string): string;
+}
+
+/**
+ * 可见范围
+ */
+export declare class Visibility extends Enum {
+    /**
+     * 公开
+     */
+    static Public: Visibility;
+    /**
+     * 仅好友
+     */
+    static Friends: Visibility;
+    /**
+     * 仅自己
+     */
+    static Private: Visibility;
+
+    static entries(): Array<option>;
+    static getLabel(v: number|string): string;
+}
+
+/**
+ * 打卡模式
+ */
+export declare class Mode extends Enum {
+    /**
+     * 今日喝了
+     */
+    static Drank: Mode;
+    /**
+     * 今日未喝
+     */
+    static Abstain: Mode;
+
+    static entries(): Array<option>;
+    static getLabel(v: number|string): string;
+}
+
+/**
+ * 饮酒频率
+ */
+export declare class Frequency extends Enum {
+    /**
+     * 很少
+     */
+    static Rarely: Frequency;
+    /**
+     * 有时
+     */
+    static Sometimes: Frequency;
+    /**
+     * 经常
+     */
+    static Often: Frequency;
+
+    static entries(): Array<option>;
+    static getLabel(v: number|string): string;
+}
+
+
+/**
+ * 手机号
+ */
+export declare class Phone {
+    [key: string]: any;
+    /**
+     * 区号 (cn +86)
+     */
+    regin: string
+    /**
+     * 手机号
+     */
+    number: string
+
+    /**
+     * @param regin string
+     * @param number string
+     */
+    constructor(regin: string, number: string);
+}
+
+/**
+ * 分页请求参数
+ */
+export declare class PageReq {
+    [key: string]: any;
+    /**
+    * 页码
+    */
+    page: number;
+    /**
+    * 每页数量，默认1-100
+    */
+    pageSize: number;
+    
+    /**
+     * @param page number  页码
+     * @param pageSize number  每页数量，默认1-100
+     */
+    constructor(page: number,pageSize: number,);
+    /**
+     * 从对象创建 PageReq
+     *
+     * @param o Object 
+     * - page: number, //  页码
+     * - pageSize: number, //  每页数量，默认1-100
+     */
+    static fromObject(o: Object): PageReq;
+}
+
+/**
+ * 分页响应结构
+ */
+export declare class PageResp {
+    [key: string]: any;
+    /**
+    * 总数
+    */
+    total: number;
+    /**
+    * 当前页码
+    */
+    page: number;
+    /**
+    * 每页数量
+    */
+    pageSize: number;
+    
+    /**
+     * @param total number  总数
+     * @param page number  当前页码
+     * @param pageSize number  每页数量
+     */
+    constructor(total: number,page: number,pageSize: number,);
+    /**
+     * 从对象创建 PageResp
+     *
+     * @param o Object 
+     * - total: number, //  总数
+     * - page: number, //  当前页码
+     * - pageSize: number, //  每页数量
+     */
+    static fromObject(o: Object): PageResp;
+}
+
+/**
+ * 
+ */
+export declare class Ok {
+    [key: string]: any;
+    /**
+    * 是否成功
+    */
+    ok: boolean;
+    
+    /**
+     * @param ok boolean  是否成功
+     */
+    constructor(ok: boolean,);
+    /**
+     * 从对象创建 Ok
+     *
+     * @param o Object 
+     * - ok: boolean, //  是否成功
+     */
+    static fromObject(o: Object): Ok;
+}
+
+/**
+ * 微信登录请求参数
+ */
+export declare class WechatLoginReq {
+    [key: string]: any;
+    /**
+    * 登录时获取的 code, 可通过 wx.login 获取
+    */
+    code: string;
+    /**
+    * 用户昵称
+    */
+    nickName: string;
+    /**
+    * 头像URL
+    */
+    avatarUrl: string;
+    
+    /**
+     * @param code string  登录时获取的 code, 可通过 wx.login 获取
+     * @param nickName string  用户昵称
+     * @param avatarUrl string  头像URL
+     */
+    constructor(code: string,nickName: string,avatarUrl: string,);
+    /**
+     * 从对象创建 WechatLoginReq
+     *
+     * @param o Object 
+     * - code: string, //  登录时获取的 code, 可通过 wx.login 获取
+     * - nickName: string, //  用户昵称
+     * - avatarUrl: string, //  头像URL
+     */
+    static fromObject(o: Object): WechatLoginReq;
+}
+
+/**
+ * 微信登录返回值
+ */
+export declare class WechatLoginResp {
+    [key: string]: any;
+    /**
+    * JWT Token
+    */
+    token: string;
+    /**
+    * 用户信息
+    */
+    user: User;
+    /**
+    * 是否新用户
+    */
+    isNew: boolean;
+    /**
+    * 会话密钥
+    */
+    session_key: string;
+    /**
+    * 用户唯一标识
+    */
+    open_id: string;
+    /**
+    * 用户在开放平台的唯一标识符，若当前小程序已绑定到微信开放平台账号下会返回，详见 UnionID 机制说明。
+    */
+    union_id: string;
+    /**
+    * 错误码
+    */
+    errcode: number;
+    /**
+    * 错误信息
+    */
+    errmsg: string;
+    /**
+    * 刷新token
+    */
+    refresh_token: string;
+    
+    /**
+     * @param token string  JWT Token
+     * @param user User  用户信息
+     * @param isNew boolean  是否新用户
+     * @param session_key string  会话密钥
+     * @param open_id string  用户唯一标识
+     * @param union_id string  用户在开放平台的唯一标识符，若当前小程序已绑定到微信开放平台账号下会返回，详见 UnionID 机制说明。
+     * @param errcode number  错误码
+     * @param errmsg string  错误信息
+     * @param refresh_token string  刷新token
+     */
+    constructor(token: string,user: User,isNew: boolean,session_key: string,open_id: string,union_id: string,errcode: number,errmsg: string,refresh_token: string,);
+    /**
+     * 从对象创建 WechatLoginResp
+     *
+     * @param o Object 
+     * - token: string, //  JWT Token
+     * - user: User, //  用户信息
+     * - isNew: boolean, //  是否新用户
+     * - session_key: string, //  会话密钥
+     * - open_id: string, //  用户唯一标识
+     * - union_id: string, //  用户在开放平台的唯一标识符，若当前小程序已绑定到微信开放平台账号下会返回，详见 UnionID 机制说明。
+     * - errcode: number, //  错误码
+     * - errmsg: string, //  错误信息
+     * - refresh_token: string, //  刷新token
+     */
+    static fromObject(o: Object): WechatLoginResp;
+}
+
+/**
+ * 获取微信手机号
+ */
+export declare class WechatGetPhoneNumberReq {
+    [key: string]: any;
+    /**
+    * 手机号获取凭证
+    */
+    code: string;
+    
+    /**
+     * @param code string  手机号获取凭证
+     */
+    constructor(code: string,);
+    /**
+     * 从对象创建 WechatGetPhoneNumberReq
+     *
+     * @param o Object 
+     * - code: string, //  手机号获取凭证
+     */
+    static fromObject(o: Object): WechatGetPhoneNumberReq;
+}
+
+/**
+ * 获取微信手机号返回值
+ */
+export declare class WechatGetPhoneNumberResp {
+    [key: string]: any;
+    /**
+    * 错误码
+    */
+    errcode: number;
+    /**
+    * 错误信息
+    */
+    errmsg: string;
+    /**
+    * token:api使用
+    */
+    token: string;
+    /**
+    * token 超时时间，单位（秒）
+    */
+    expires_in: number;
+    /**
+    * refresh_token:刷新token
+    */
+    refresh_token: string;
+    
+    /**
+     * @param errcode number  错误码
+     * @param errmsg string  错误信息
+     * @param token string  token:api使用
+     * @param expires_in number  token 超时时间，单位（秒）
+     * @param refresh_token string  refresh_token:刷新token
+     */
+    constructor(errcode: number,errmsg: string,token: string,expires_in: number,refresh_token: string,);
+    /**
+     * 从对象创建 WechatGetPhoneNumberResp
+     *
+     * @param o Object 
+     * - errcode: number, //  错误码
+     * - errmsg: string, //  错误信息
+     * - token: string, //  token:api使用
+     * - expires_in: number, //  token 超时时间，单位（秒）
+     * - refresh_token: string, //  refresh_token:刷新token
+     */
+    static fromObject(o: Object): WechatGetPhoneNumberResp;
+}
+
+/**
+ * 刷新token请求参数
+ */
+export declare class RefreshTokenReq {
+    [key: string]: any;
+    /**
+    * 签发 token 时生成的 refresh_token
+    */
+    refresh_token: string;
+    
+    /**
+     * @param refresh_token string  签发 token 时生成的 refresh_token
+     */
+    constructor(refresh_token: string,);
+    /**
+     * 从对象创建 RefreshTokenReq
+     *
+     * @param o Object 
+     * - refresh_token: string, //  签发 token 时生成的 refresh_token
+     */
+    static fromObject(o: Object): RefreshTokenReq;
+}
+
+/**
+ * 刷新 token 返回值
+ */
+export declare class RefreshTokenResp {
+    [key: string]: any;
+    /**
+    * 生成的新token
+    */
+    token: string;
+    /**
+    * token 超时时间，单位（秒）
+    */
+    expire_in: number;
+    /**
+    * refresh_token:刷新token
+    */
+    refresh_token: string;
+    
+    /**
+     * @param token string  生成的新token
+     * @param expire_in number  token 超时时间，单位（秒）
+     * @param refresh_token string  refresh_token:刷新token
+     */
+    constructor(token: string,expire_in: number,refresh_token: string,);
+    /**
+     * 从对象创建 RefreshTokenResp
+     *
+     * @param o Object 
+     * - token: string, //  生成的新token
+     * - expire_in: number, //  token 超时时间，单位（秒）
+     * - refresh_token: string, //  refresh_token:刷新token
+     */
+    static fromObject(o: Object): RefreshTokenResp;
+}
+
+/**
+ * 成就条件
+ */
+export declare class AchievementCondition {
+    [key: string]: any;
+    /**
+    * 条件类型
+    */
+    type: AchievementConditionType;
+    /**
+    * 目标值
+    */
+    value: number;
+    
+    /**
+     * @param type AchievementConditionType  条件类型
+     * @param value number  目标值
+     */
+    constructor(type: AchievementConditionType,value: number,);
+    /**
+     * 从对象创建 AchievementCondition
+     *
+     * @param o Object 
+     * - type: AchievementConditionType, //  条件类型
+     * - value: number, //  目标值
+     */
+    static fromObject(o: Object): AchievementCondition;
+}
+
+/**
+ * 成就信息
+ */
+export declare class Achievement {
+    [key: string]: any;
+    /**
+    * 成就ID
+    */
+    id: string;
+    /**
+    * 成就名称
+    */
+    name: string;
+    /**
+    * 成就描述
+    */
+    desc: string;
+    /**
+    * 成就图标
+    */
+    icon: string;
+    /**
+    * 是否已解锁
+    */
+    unlocked: boolean;
+    /**
+    * 解锁时间
+    */
+    unlockedAt: string;
+    /**
+    * 成就条件
+    */
+    condition: AchievementCondition;
+    /**
+    * 进度（0-1）
+    */
+    progress: number;
+    
+    /**
+     * @param id string  成就ID
+     * @param name string  成就名称
+     * @param desc string  成就描述
+     * @param icon string  成就图标
+     * @param unlocked boolean  是否已解锁
+     * @param unlockedAt string  解锁时间
+     * @param condition AchievementCondition  成就条件
+     * @param progress number  进度（0-1）
+     */
+    constructor(id: string,name: string,desc: string,icon: string,unlocked: boolean,unlockedAt: string,condition: AchievementCondition,progress: number,);
+    /**
+     * 从对象创建 Achievement
+     *
+     * @param o Object 
+     * - id: string, //  成就ID
+     * - name: string, //  成就名称
+     * - desc: string, //  成就描述
+     * - icon: string, //  成就图标
+     * - unlocked: boolean, //  是否已解锁
+     * - unlockedAt: string, //  解锁时间
+     * - condition: AchievementCondition, //  成就条件
+     * - progress: number, //  进度（0-1）
+     */
+    static fromObject(o: Object): Achievement;
+}
+
+/**
+ * 
+ */
+export declare class GetAchievementsReq {
+    [key: string]: any;
+    
+    /**
+     */
+    constructor();
+    /**
+     * 从对象创建 GetAchievementsReq
+     *
+     * @param o Object 
+     */
+    static fromObject(o: Object): GetAchievementsReq;
+}
+
+/**
+ * 获取成就列表响应
+ */
+export declare class GetAchievementsResp {
+    [key: string]: any;
+    /**
+    * 成就列表数据
+    */
+    data: AchievementsData;
+    
+    /**
+     * @param data AchievementsData  成就列表数据
+     */
+    constructor(data: AchievementsData,);
+    /**
+     * 从对象创建 GetAchievementsResp
+     *
+     * @param o Object 
+     * - data: AchievementsData, //  成就列表数据
+     */
+    static fromObject(o: Object): GetAchievementsResp;
+}
+
+/**
+ * 成就列表数据
+ */
+export declare class AchievementsData {
+    [key: string]: any;
+    /**
+    * 成就列表
+    */
+    achievements: Array<Achievement>;
+    
+    /**
+     * @param achievements Array<Achievement>  成就列表
+     */
+    constructor(achievements: Array<Achievement>,);
+    /**
+     * 从对象创建 AchievementsData
+     *
+     * @param o Object 
+     * - achievements: Array<Achievement>, //  成就列表
+     */
+    static fromObject(o: Object): AchievementsData;
+}
+
+/**
+ * 朋友圈动态项
+ */
+export declare class FeedItem {
+    [key: string]: any;
+    /**
+    * 记录ID
+    */
+    id: string|number;
+    /**
+    * 用户信息
+    */
+    user: FeedUser;
+    /**
+    * 日期
+    */
+    date: string;
+    /**
+    * 打卡模式
+    */
+    mode: Mode;
+    /**
+    * 酒水列表
+    */
+    drinks: Array<DrinkItem>;
+    /**
+    * 配餐信息
+    */
+    food: FoodInfo;
+    /**
+    * 感受
+    */
+    feeling: Feeling;
+    /**
+    * 照片URL数组
+    */
+    photos: Array<string>;
+    /**
+    * 标准杯总数
+    */
+    standardCupsTotal: number;
+    /**
+    * 酒言酒语
+    */
+    quote: string;
+    /**
+    * 点赞数
+    */
+    likeCount: number;
+    /**
+    * 评论数
+    */
+    commentCount: number;
+    /**
+    * 当前用户是否已点赞
+    */
+    liked: boolean;
+    /**
+    * 创建时间
+    */
+    createdAt: string;
+    
+    /**
+     * @param id string|number  记录ID
+     * @param user FeedUser  用户信息
+     * @param date string  日期
+     * @param mode Mode  打卡模式
+     * @param drinks Array<DrinkItem>  酒水列表
+     * @param food FoodInfo  配餐信息
+     * @param feeling Feeling  感受
+     * @param photos Array<string>  照片URL数组
+     * @param standardCupsTotal number  标准杯总数
+     * @param quote string  酒言酒语
+     * @param likeCount number  点赞数
+     * @param commentCount number  评论数
+     * @param liked boolean  当前用户是否已点赞
+     * @param createdAt string  创建时间
+     */
+    constructor(id: string|number,user: FeedUser,date: string,mode: Mode,drinks: Array<DrinkItem>,food: FoodInfo,feeling: Feeling,photos: Array<string>,standardCupsTotal: number,quote: string,likeCount: number,commentCount: number,liked: boolean,createdAt: string,);
+    /**
+     * 从对象创建 FeedItem
+     *
+     * @param o Object 
+     * - id: string|number, //  记录ID
+     * - user: FeedUser, //  用户信息
+     * - date: string, //  日期
+     * - mode: Mode, //  打卡模式
+     * - drinks: Array<DrinkItem>, //  酒水列表
+     * - food: FoodInfo, //  配餐信息
+     * - feeling: Feeling, //  感受
+     * - photos: Array<string>, //  照片URL数组
+     * - standardCupsTotal: number, //  标准杯总数
+     * - quote: string, //  酒言酒语
+     * - likeCount: number, //  点赞数
+     * - commentCount: number, //  评论数
+     * - liked: boolean, //  当前用户是否已点赞
+     * - createdAt: string, //  创建时间
+     */
+    static fromObject(o: Object): FeedItem;
+}
+
+/**
+ * 朋友圈用户信息
+ */
+export declare class FeedUser {
+    [key: string]: any;
+    /**
+    * 用户ID
+    */
+    id: string|number;
+    /**
+    * 用户昵称
+    */
+    nickname: string;
+    /**
+    * 头像URL
+    */
+    avatar: string;
+    
+    /**
+     * @param id string|number  用户ID
+     * @param nickname string  用户昵称
+     * @param avatar string  头像URL
+     */
+    constructor(id: string|number,nickname: string,avatar: string,);
+    /**
+     * 从对象创建 FeedUser
+     *
+     * @param o Object 
+     * - id: string|number, //  用户ID
+     * - nickname: string, //  用户昵称
+     * - avatar: string, //  头像URL
+     */
+    static fromObject(o: Object): FeedUser;
+}
+
+/**
+ * 获取朋友圈动态请求
+ */
+export declare class GetFeedReq {
+    [key: string]: any;
+    /**
+    * 游标分页，上一页最后一条ID
+    */
+    lastId: string|number;
+    
+    /**
+     * @param lastId string|number  游标分页，上一页最后一条ID
+     */
+    constructor(lastId: string|number,);
+    /**
+     * 从对象创建 GetFeedReq
+     *
+     * @param o Object 
+     * - lastId: string|number, //  游标分页，上一页最后一条ID
+     */
+    static fromObject(o: Object): GetFeedReq;
+}
+
+/**
+ * 获取朋友圈动态响应
+ */
+export declare class GetFeedResp {
+    [key: string]: any;
+    /**
+    * 朋友圈动态分页数据
+    */
+    data: FeedPageData;
+    
+    /**
+     * @param data FeedPageData  朋友圈动态分页数据
+     */
+    constructor(data: FeedPageData,);
+    /**
+     * 从对象创建 GetFeedResp
+     *
+     * @param o Object 
+     * - data: FeedPageData, //  朋友圈动态分页数据
+     */
+    static fromObject(o: Object): GetFeedResp;
+}
+
+/**
+ * 朋友圈动态分页数据
+ */
+export declare class FeedPageData {
+    [key: string]: any;
+    /**
+    * 动态列表
+    */
+    list: Array<FeedItem>;
+    
+    /**
+     * @param list Array<FeedItem>  动态列表
+     */
+    constructor(list: Array<FeedItem>,);
+    /**
+     * 从对象创建 FeedPageData
+     *
+     * @param o Object 
+     * - list: Array<FeedItem>, //  动态列表
+     */
+    static fromObject(o: Object): FeedPageData;
+}
+
+/**
+ * 点赞/取消点赞请求
+ */
+export declare class LikeRecordReq {
+    [key: string]: any;
+    /**
+    * 记录ID
+    */
+    id: string|number;
+    
+    /**
+     * @param id string|number  记录ID
+     */
+    constructor(id: string|number,);
+    /**
+     * 从对象创建 LikeRecordReq
+     *
+     * @param o Object 
+     * - id: string|number, //  记录ID
+     */
+    static fromObject(o: Object): LikeRecordReq;
+}
+
+/**
+ * 点赞/取消点赞响应
+ */
+export declare class LikeRecordResp {
+    [key: string]: any;
+    
+    /**
+     */
+    constructor();
+    /**
+     * 从对象创建 LikeRecordResp
+     *
+     * @param o Object 
+     */
+    static fromObject(o: Object): LikeRecordResp;
+}
+
+/**
+ * 上传照片请求
+ */
+export declare class UploadPhotoReq {
+    [key: string]: any;
+    /**
+    * 图片Url
+    */
+    url: string;
+    /**
+    * 关联记录ID
+    */
+    recordId: string|number;
+    
+    /**
+     * @param url string  图片Url
+     * @param recordId string|number  关联记录ID
+     */
+    constructor(url: string,recordId: string|number,);
+    /**
+     * 从对象创建 UploadPhotoReq
+     *
+     * @param o Object 
+     * - url: string, //  图片Url
+     * - recordId: string|number, //  关联记录ID
+     */
+    static fromObject(o: Object): UploadPhotoReq;
+}
+
+/**
+ * 上传照片响应
+ */
+export declare class UploadPhotoResp {
+    [key: string]: any;
+    
+    /**
+     */
+    constructor();
+    /**
+     * 从对象创建 UploadPhotoResp
+     *
+     * @param o Object 
+     */
+    static fromObject(o: Object): UploadPhotoResp;
+}
+
+/**
+ * 批量上传照片请求
+ */
+export declare class UploadPhotosReq {
+    [key: string]: any;
+    /**
+    * 图片URL数组（最多9张）
+    */
+    urls: Array<string>;
+    /**
+    * 关联记录ID
+    */
+    recordId: string|number;
+    
+    /**
+     * @param urls Array<string>  图片URL数组（最多9张）
+     * @param recordId string|number  关联记录ID
+     */
+    constructor(urls: Array<string>,recordId: string|number,);
+    /**
+     * 从对象创建 UploadPhotosReq
+     *
+     * @param o Object 
+     * - urls: Array<string>, //  图片URL数组（最多9张）
+     * - recordId: string|number, //  关联记录ID
+     */
+    static fromObject(o: Object): UploadPhotosReq;
+}
+
+/**
+ * 批量上传照片响应
+ */
+export declare class UploadPhotosResp {
+    [key: string]: any;
+    
+    /**
+     */
+    constructor();
+    /**
+     * 从对象创建 UploadPhotosResp
+     *
+     * @param o Object 
+     */
+    static fromObject(o: Object): UploadPhotosResp;
+}
+
+/**
+ * 酒水项
+ */
+export declare class DrinkItem {
+    [key: string]: any;
+    /**
+    * 酒类分类ID
+    */
+    category: Category;
+    /**
+    * 品牌名称
+    */
+    brand: string;
+    /**
+    * 产品名
+    */
+    product: string;
+    /**
+    * 饮用量数值
+    */
+    amount: number;
+    /**
+    * 单位
+    */
+    unit: Unit;
+    /**
+    * 酒精度数(%)
+    */
+    degree: number;
+    /**
+    * 标准杯数（前端计算，后端应校验）
+    */
+    standardCups: number;
+    
+    /**
+     * @param category Category  酒类分类ID
+     * @param brand string  品牌名称
+     * @param product string  产品名
+     * @param amount number  饮用量数值
+     * @param unit Unit  单位
+     * @param degree number  酒精度数(%)
+     * @param standardCups number  标准杯数（前端计算，后端应校验）
+     */
+    constructor(category: Category,brand: string,product: string,amount: number,unit: Unit,degree: number,standardCups: number,);
+    /**
+     * 从对象创建 DrinkItem
+     *
+     * @param o Object 
+     * - category: Category, //  酒类分类ID
+     * - brand: string, //  品牌名称
+     * - product: string, //  产品名
+     * - amount: number, //  饮用量数值
+     * - unit: Unit, //  单位
+     * - degree: number, //  酒精度数(%)
+     * - standardCups: number, //  标准杯数（前端计算，后端应校验）
+     */
+    static fromObject(o: Object): DrinkItem;
+}
+
+/**
+ * 配餐信息
+ */
+export declare class FoodInfo {
+    [key: string]: any;
+    /**
+    * 配餐分类ID
+    */
+    category: FoodCategory;
+    /**
+    * 具体菜名
+    */
+    name: string;
+    
+    /**
+     * @param category FoodCategory  配餐分类ID
+     * @param name string  具体菜名
+     */
+    constructor(category: FoodCategory,name: string,);
+    /**
+     * 从对象创建 FoodInfo
+     *
+     * @param o Object 
+     * - category: FoodCategory, //  配餐分类ID
+     * - name: string, //  具体菜名
+     */
+    static fromObject(o: Object): FoodInfo;
+}
+
+/**
+ * 创建打卡记录请求
+ */
+export declare class CreateRecordReq {
+    [key: string]: any;
+    /**
+    * 日期 YYYY-MM-DD
+    */
+    date: string;
+    /**
+    * 打卡模式
+    */
+    mode: Mode;
+    /**
+    * 酒水列表（mode=abstain时为空数组）
+    */
+    drinks: Array<DrinkItem>;
+    /**
+    * 配餐信息
+    */
+    food: FoodInfo;
+    /**
+    * 感受ID
+    */
+    feeling: Feeling;
+    /**
+    * 照片URL数组（最多9张）
+    */
+    photos: Array<string>;
+    /**
+    * 可见范围
+    */
+    visibility: Visibility;
+    /**
+    * 酒言酒语
+    */
+    quote: string;
+    
+    /**
+     * @param date string  日期 YYYY-MM-DD
+     * @param mode Mode  打卡模式
+     * @param drinks Array<DrinkItem>  酒水列表（mode=abstain时为空数组）
+     * @param food FoodInfo  配餐信息
+     * @param feeling Feeling  感受ID
+     * @param photos Array<string>  照片URL数组（最多9张）
+     * @param visibility Visibility  可见范围
+     * @param quote string  酒言酒语
+     */
+    constructor(date: string,mode: Mode,drinks: Array<DrinkItem>,food: FoodInfo,feeling: Feeling,photos: Array<string>,visibility: Visibility,quote: string,);
+    /**
+     * 从对象创建 CreateRecordReq
+     *
+     * @param o Object 
+     * - date: string, //  日期 YYYY-MM-DD
+     * - mode: Mode, //  打卡模式
+     * - drinks: Array<DrinkItem>, //  酒水列表（mode=abstain时为空数组）
+     * - food: FoodInfo, //  配餐信息
+     * - feeling: Feeling, //  感受ID
+     * - photos: Array<string>, //  照片URL数组（最多9张）
+     * - visibility: Visibility, //  可见范围
+     * - quote: string, //  酒言酒语
+     */
+    static fromObject(o: Object): CreateRecordReq;
+}
+
+/**
+ * 打卡记录详情
+ */
+export declare class Record {
+    [key: string]: any;
+    /**
+    * 记录ID
+    */
+    id: string|number;
+    /**
+    * 日期
+    */
+    date: string;
+    /**
+    * 打卡模式
+    */
+    mode: Mode;
+    /**
+    * 酒水列表
+    */
+    drinks: Array<DrinkItem>;
+    /**
+    * 配餐信息
+    */
+    food: FoodInfo;
+    /**
+    * 感受
+    */
+    feeling: Feeling;
+    /**
+    * 照片URL数组
+    */
+    photos: Array<string>;
+    /**
+    * 可见范围
+    */
+    visibility: Visibility;
+    /**
+    * 酒言酒语
+    */
+    quote: string;
+    /**
+    * 标准杯总数
+    */
+    standardCupsTotal: number;
+    /**
+    * 创建时间
+    */
+    createdAt: string;
+    
+    /**
+     * @param id string|number  记录ID
+     * @param date string  日期
+     * @param mode Mode  打卡模式
+     * @param drinks Array<DrinkItem>  酒水列表
+     * @param food FoodInfo  配餐信息
+     * @param feeling Feeling  感受
+     * @param photos Array<string>  照片URL数组
+     * @param visibility Visibility  可见范围
+     * @param quote string  酒言酒语
+     * @param standardCupsTotal number  标准杯总数
+     * @param createdAt string  创建时间
+     */
+    constructor(id: string|number,date: string,mode: Mode,drinks: Array<DrinkItem>,food: FoodInfo,feeling: Feeling,photos: Array<string>,visibility: Visibility,quote: string,standardCupsTotal: number,createdAt: string,);
+    /**
+     * 从对象创建 Record
+     *
+     * @param o Object 
+     * - id: string|number, //  记录ID
+     * - date: string, //  日期
+     * - mode: Mode, //  打卡模式
+     * - drinks: Array<DrinkItem>, //  酒水列表
+     * - food: FoodInfo, //  配餐信息
+     * - feeling: Feeling, //  感受
+     * - photos: Array<string>, //  照片URL数组
+     * - visibility: Visibility, //  可见范围
+     * - quote: string, //  酒言酒语
+     * - standardCupsTotal: number, //  标准杯总数
+     * - createdAt: string, //  创建时间
+     */
+    static fromObject(o: Object): Record;
+}
+
+/**
+ * 创建打卡记录响应
+ */
+export declare class CreateRecordResp {
+    [key: string]: any;
+    /**
+    * 创建的记录详情
+    */
+    data: Record;
+    
+    /**
+     * @param data Record  创建的记录详情
+     */
+    constructor(data: Record,);
+    /**
+     * 从对象创建 CreateRecordResp
+     *
+     * @param o Object 
+     * - data: Record, //  创建的记录详情
+     */
+    static fromObject(o: Object): CreateRecordResp;
+}
+
+/**
+ * 获取记录列表请求
+ */
+export declare class GetRecordsReq {
+    [key: string]: any;
+    /**
+    * 页码
+    */
+    page: number;
+    /**
+    * 每页数量，默认1-100
+    */
+    pageSize: number;
+    /**
+    * 月份筛选 YYYY-MM
+    */
+    month: string;
+    /**
+    * 打卡模式筛选
+    */
+    mode: Mode;
+    
+    /**
+     * @param page number  页码
+     * @param pageSize number  每页数量，默认1-100
+     * @param month string  月份筛选 YYYY-MM
+     * @param mode Mode  打卡模式筛选
+     */
+    constructor(page: number,pageSize: number,month: string,mode: Mode,);
+    /**
+     * 从对象创建 GetRecordsReq
+     *
+     * @param o Object 
+     * - page: number, //  页码
+     * - pageSize: number, //  每页数量，默认1-100
+     * - month: string, //  月份筛选 YYYY-MM
+     * - mode: Mode, //  打卡模式筛选
+     */
+    static fromObject(o: Object): GetRecordsReq;
+}
+
+/**
+ * 获取记录列表响应
+ */
+export declare class GetRecordsResp {
+    [key: string]: any;
+    /**
+    * 分页数据
+    */
+    list: Array<Record>;
+    
+    /**
+     * @param list Array<Record>  分页数据
+     */
+    constructor(list: Array<Record>,);
+    /**
+     * 从对象创建 GetRecordsResp
+     *
+     * @param o Object 
+     * - list: Array<Record>, //  分页数据
+     */
+    static fromObject(o: Object): GetRecordsResp;
+}
+
+/**
+ * 获取单条记录详情请求
+ */
+export declare class GetRecordDetailReq {
+    [key: string]: any;
+    /**
+    * 记录ID
+    */
+    id: string|number;
+    
+    /**
+     * @param id string|number  记录ID
+     */
+    constructor(id: string|number,);
+    /**
+     * 从对象创建 GetRecordDetailReq
+     *
+     * @param o Object 
+     * - id: string|number, //  记录ID
+     */
+    static fromObject(o: Object): GetRecordDetailReq;
+}
+
+/**
+ * 获取单条记录详情响应
+ */
+export declare class GetRecordDetailResp {
+    [key: string]: any;
+    /**
+    * 记录详情
+    */
+    data: Record;
+    
+    /**
+     * @param data Record  记录详情
+     */
+    constructor(data: Record,);
+    /**
+     * 从对象创建 GetRecordDetailResp
+     *
+     * @param o Object 
+     * - data: Record, //  记录详情
+     */
+    static fromObject(o: Object): GetRecordDetailResp;
+}
+
+/**
+ * 删除记录请求
+ */
+export declare class DeleteRecordReq {
+    [key: string]: any;
+    /**
+    * 记录ID
+    */
+    id: string|number;
+    
+    /**
+     * @param id string|number  记录ID
+     */
+    constructor(id: string|number,);
+    /**
+     * 从对象创建 DeleteRecordReq
+     *
+     * @param o Object 
+     * - id: string|number, //  记录ID
+     */
+    static fromObject(o: Object): DeleteRecordReq;
+}
+
+/**
+ * 删除记录响应
+ */
+export declare class DeleteRecordResp {
+    [key: string]: any;
+    
+    /**
+     */
+    constructor();
+    /**
+     * 从对象创建 DeleteRecordResp
+     *
+     * @param o Object 
+     */
+    static fromObject(o: Object): DeleteRecordResp;
+}
+
+/**
+ * 获取日历打卡数据请求
+ */
+export declare class GetCalendarReq {
+    [key: string]: any;
+    /**
+    * 年份
+    */
+    year: number;
+    /**
+    * 月份(1-12)
+    */
+    month: number;
+    
+    /**
+     * @param year number  年份
+     * @param month number  月份(1-12)
+     */
+    constructor(year: number,month: number,);
+    /**
+     * 从对象创建 GetCalendarReq
+     *
+     * @param o Object 
+     * - year: number, //  年份
+     * - month: number, //  月份(1-12)
+     */
+    static fromObject(o: Object): GetCalendarReq;
+}
+
+/**
+ * 日历打卡数据
+ */
+export declare class CalendarData {
+    [key: string]: any;
+    /**
+    * 年份
+    */
+    year: number;
+    /**
+    * 月份
+    */
+    month: number;
+    /**
+    * 每天的打卡数据，null表示当天无记录
+    */
+    days: Array<CalendarDayData>;
+    
+    /**
+     * @param year number  年份
+     * @param month number  月份
+     * @param days Array<CalendarDayData>  每天的打卡数据，null表示当天无记录
+     */
+    constructor(year: number,month: number,days: Array<CalendarDayData>,);
+    /**
+     * 从对象创建 CalendarData
+     *
+     * @param o Object 
+     * - year: number, //  年份
+     * - month: number, //  月份
+     * - days: Array<CalendarDayData>, //  每天的打卡数据，null表示当天无记录
+     */
+    static fromObject(o: Object): CalendarData;
+}
+
+/**
+ * 日历单日打卡数据
+ */
+export declare class CalendarDayData {
+    [key: string]: any;
+    /**
+    * 日期YYYY-MM-DD
+    */
+    date: string;
+    /**
+    * 是否有记录
+    */
+    hasRecord: boolean;
+    /**
+    * 打卡模式
+    */
+    mode: Mode;
+    /**
+    * 标准杯总数
+    */
+    standardCupsTotal: number;
+    
+    /**
+     * @param date string  日期YYYY-MM-DD
+     * @param hasRecord boolean  是否有记录
+     * @param mode Mode  打卡模式
+     * @param standardCupsTotal number  标准杯总数
+     */
+    constructor(date: string,hasRecord: boolean,mode: Mode,standardCupsTotal: number,);
+    /**
+     * 从对象创建 CalendarDayData
+     *
+     * @param o Object 
+     * - date: string, //  日期YYYY-MM-DD
+     * - hasRecord: boolean, //  是否有记录
+     * - mode: Mode, //  打卡模式
+     * - standardCupsTotal: number, //  标准杯总数
+     */
+    static fromObject(o: Object): CalendarDayData;
+}
+
+/**
+ * 获取日历打卡数据响应
+ */
+export declare class GetCalendarResp {
+    [key: string]: any;
+    /**
+    * 日历数据
+    */
+    data: CalendarData;
+    
+    /**
+     * @param data CalendarData  日历数据
+     */
+    constructor(data: CalendarData,);
+    /**
+     * 从对象创建 GetCalendarResp
+     *
+     * @param o Object 
+     * - data: CalendarData, //  日历数据
+     */
+    static fromObject(o: Object): GetCalendarResp;
+}
+
+/**
+ * 用户统计概览数据
+ */
+export declare class StatsOverview {
+    [key: string]: any;
+    /**
+    * 本周饮酒天数
+    */
+    weekDrinkCount: number;
+    /**
+    * 本周标准杯总数
+    */
+    weekCups: number;
+    /**
+    * 本月饮酒天数
+    */
+    monthDrinkCount: number;
+    /**
+    * 本月标准杯总数
+    */
+    monthCups: number;
+    /**
+    * 当前连续打卡天数
+    */
+    streak: number;
+    /**
+    * 连续类型
+    */
+    streakType: Mode;
+    /**
+    * 总饮酒天数（去重）
+    */
+    totalDays: number;
+    /**
+    * 总记录数
+    */
+    totalRecords: number;
+    /**
+    * 历史累计标准杯
+    */
+    totalCups: number;
+    /**
+    * 最爱酒类ID
+    */
+    favCategory: Category;
+    /**
+    * 尝试过的酒类品种数
+    */
+    categoryVariety: number;
+    
+    /**
+     * @param weekDrinkCount number  本周饮酒天数
+     * @param weekCups number  本周标准杯总数
+     * @param monthDrinkCount number  本月饮酒天数
+     * @param monthCups number  本月标准杯总数
+     * @param streak number  当前连续打卡天数
+     * @param streakType Mode  连续类型
+     * @param totalDays number  总饮酒天数（去重）
+     * @param totalRecords number  总记录数
+     * @param totalCups number  历史累计标准杯
+     * @param favCategory Category  最爱酒类ID
+     * @param categoryVariety number  尝试过的酒类品种数
+     */
+    constructor(weekDrinkCount: number,weekCups: number,monthDrinkCount: number,monthCups: number,streak: number,streakType: Mode,totalDays: number,totalRecords: number,totalCups: number,favCategory: Category,categoryVariety: number,);
+    /**
+     * 从对象创建 StatsOverview
+     *
+     * @param o Object 
+     * - weekDrinkCount: number, //  本周饮酒天数
+     * - weekCups: number, //  本周标准杯总数
+     * - monthDrinkCount: number, //  本月饮酒天数
+     * - monthCups: number, //  本月标准杯总数
+     * - streak: number, //  当前连续打卡天数
+     * - streakType: Mode, //  连续类型
+     * - totalDays: number, //  总饮酒天数（去重）
+     * - totalRecords: number, //  总记录数
+     * - totalCups: number, //  历史累计标准杯
+     * - favCategory: Category, //  最爱酒类ID
+     * - categoryVariety: number, //  尝试过的酒类品种数
+     */
+    static fromObject(o: Object): StatsOverview;
+}
+
+/**
+ * 获取用户统计概览响应
+ */
+export declare class GetStatsOverviewResp {
+    [key: string]: any;
+    /**
+    * 统计概览数据
+    */
+    data: StatsOverview;
+    
+    /**
+     * @param data StatsOverview  统计概览数据
+     */
+    constructor(data: StatsOverview,);
+    /**
+     * 从对象创建 GetStatsOverviewResp
+     *
+     * @param o Object 
+     * - data: StatsOverview, //  统计概览数据
+     */
+    static fromObject(o: Object): GetStatsOverviewResp;
+}
+
+/**
+ * 获取月度统计请求
+ */
+export declare class GetMonthlyStatsReq {
+    [key: string]: any;
+    /**
+    * 年份，默认当前年
+    */
+    year: number;
+    /**
+    * 月份，默认当前月
+    */
+    month: number;
+    
+    /**
+     * @param year number  年份，默认当前年
+     * @param month number  月份，默认当前月
+     */
+    constructor(year: number,month: number,);
+    /**
+     * 从对象创建 GetMonthlyStatsReq
+     *
+     * @param o Object 
+     * - year: number, //  年份，默认当前年
+     * - month: number, //  月份，默认当前月
+     */
+    static fromObject(o: Object): GetMonthlyStatsReq;
+}
+
+/**
+ * 月度统计数据
+ */
+export declare class MonthlyStats {
+    [key: string]: any;
+    /**
+    * 年份
+    */
+    year: number;
+    /**
+    * 月份
+    */
+    month: number;
+    /**
+    * 饮酒天数
+    */
+    drinkDays: number;
+    /**
+    * 戒酒天数
+    */
+    abstainDays: number;
+    /**
+    * 总标准杯数
+    */
+    totalCups: number;
+    /**
+    * 日均标准杯数
+    */
+    avgCupsPerDay: number;
+    /**
+    * 酒类分布
+    */
+    categoryBreakdown: Array<CategoryBreakdown>;
+    /**
+    * 感受分布
+    */
+    feelingBreakdown: Array<FeelingBreakdown>;
+    /**
+    * 配餐分布
+    */
+    foodBreakdown: Array<FoodBreakdown>;
+    
+    /**
+     * @param year number  年份
+     * @param month number  月份
+     * @param drinkDays number  饮酒天数
+     * @param abstainDays number  戒酒天数
+     * @param totalCups number  总标准杯数
+     * @param avgCupsPerDay number  日均标准杯数
+     * @param categoryBreakdown Array<CategoryBreakdown>  酒类分布
+     * @param feelingBreakdown Array<FeelingBreakdown>  感受分布
+     * @param foodBreakdown Array<FoodBreakdown>  配餐分布
+     */
+    constructor(year: number,month: number,drinkDays: number,abstainDays: number,totalCups: number,avgCupsPerDay: number,categoryBreakdown: Array<CategoryBreakdown>,feelingBreakdown: Array<FeelingBreakdown>,foodBreakdown: Array<FoodBreakdown>,);
+    /**
+     * 从对象创建 MonthlyStats
+     *
+     * @param o Object 
+     * - year: number, //  年份
+     * - month: number, //  月份
+     * - drinkDays: number, //  饮酒天数
+     * - abstainDays: number, //  戒酒天数
+     * - totalCups: number, //  总标准杯数
+     * - avgCupsPerDay: number, //  日均标准杯数
+     * - categoryBreakdown: Array<CategoryBreakdown>, //  酒类分布
+     * - feelingBreakdown: Array<FeelingBreakdown>, //  感受分布
+     * - foodBreakdown: Array<FoodBreakdown>, //  配餐分布
+     */
+    static fromObject(o: Object): MonthlyStats;
+}
+
+/**
+ * 酒类分布统计项
+ */
+export declare class CategoryBreakdown {
+    [key: string]: any;
+    /**
+    * 酒类分类
+    */
+    category: Category;
+    /**
+    * 次数
+    */
+    count: number;
+    /**
+    * 标准杯数
+    */
+    cups: number;
+    
+    /**
+     * @param category Category  酒类分类
+     * @param count number  次数
+     * @param cups number  标准杯数
+     */
+    constructor(category: Category,count: number,cups: number,);
+    /**
+     * 从对象创建 CategoryBreakdown
+     *
+     * @param o Object 
+     * - category: Category, //  酒类分类
+     * - count: number, //  次数
+     * - cups: number, //  标准杯数
+     */
+    static fromObject(o: Object): CategoryBreakdown;
+}
+
+/**
+ * 感受分布统计项
+ */
+export declare class FeelingBreakdown {
+    [key: string]: any;
+    /**
+    * 感受类型
+    */
+    feeling: Feeling;
+    /**
+    * 次数
+    */
+    count: number;
+    
+    /**
+     * @param feeling Feeling  感受类型
+     * @param count number  次数
+     */
+    constructor(feeling: Feeling,count: number,);
+    /**
+     * 从对象创建 FeelingBreakdown
+     *
+     * @param o Object 
+     * - feeling: Feeling, //  感受类型
+     * - count: number, //  次数
+     */
+    static fromObject(o: Object): FeelingBreakdown;
+}
+
+/**
+ * 配餐分布统计项
+ */
+export declare class FoodBreakdown {
+    [key: string]: any;
+    /**
+    * 配餐分类
+    */
+    category: FoodCategory;
+    /**
+    * 次数
+    */
+    count: number;
+    
+    /**
+     * @param category FoodCategory  配餐分类
+     * @param count number  次数
+     */
+    constructor(category: FoodCategory,count: number,);
+    /**
+     * 从对象创建 FoodBreakdown
+     *
+     * @param o Object 
+     * - category: FoodCategory, //  配餐分类
+     * - count: number, //  次数
+     */
+    static fromObject(o: Object): FoodBreakdown;
+}
+
+/**
+ * 获取月度统计响应
+ */
+export declare class GetMonthlyStatsResp {
+    [key: string]: any;
+    /**
+    * 月度统计数据
+    */
+    data: MonthlyStats;
+    
+    /**
+     * @param data MonthlyStats  月度统计数据
+     */
+    constructor(data: MonthlyStats,);
+    /**
+     * 从对象创建 GetMonthlyStatsResp
+     *
+     * @param o Object 
+     * - data: MonthlyStats, //  月度统计数据
+     */
+    static fromObject(o: Object): GetMonthlyStatsResp;
+}
+
+/**
+ * 酒类分布统计项
+ */
+export declare class CategoryStats {
+    [key: string]: any;
+    /**
+    * 酒类分类ID
+    */
+    id: Category;
+    /**
+    * 酒类名称
+    */
+    name: string;
+    /**
+    * 记录次数
+    */
+    recordCount: number;
+    /**
+    * 总标准杯数
+    */
+    totalCups: number;
+    /**
+    * 占比（百分比）
+    */
+    percentage: number;
+    
+    /**
+     * @param id Category  酒类分类ID
+     * @param name string  酒类名称
+     * @param recordCount number  记录次数
+     * @param totalCups number  总标准杯数
+     * @param percentage number  占比（百分比）
+     */
+    constructor(id: Category,name: string,recordCount: number,totalCups: number,percentage: number,);
+    /**
+     * 从对象创建 CategoryStats
+     *
+     * @param o Object 
+     * - id: Category, //  酒类分类ID
+     * - name: string, //  酒类名称
+     * - recordCount: number, //  记录次数
+     * - totalCups: number, //  总标准杯数
+     * - percentage: number, //  占比（百分比）
+     */
+    static fromObject(o: Object): CategoryStats;
+}
+
+/**
+ * 
+ */
+export declare class GetStatsOverviewReq {
+    [key: string]: any;
+    
+    /**
+     */
+    constructor();
+    /**
+     * 从对象创建 GetStatsOverviewReq
+     *
+     * @param o Object 
+     */
+    static fromObject(o: Object): GetStatsOverviewReq;
+}
+
+/**
+ * 
+ */
+export declare class GetCategoryStatsReq {
+    [key: string]: any;
+    
+    /**
+     */
+    constructor();
+    /**
+     * 从对象创建 GetCategoryStatsReq
+     *
+     * @param o Object 
+     */
+    static fromObject(o: Object): GetCategoryStatsReq;
+}
+
+/**
+ * 获取酒类分布统计响应
+ */
+export declare class GetCategoryStatsResp {
+    [key: string]: any;
+    /**
+    * 酒类分布统计数据
+    */
+    data: CategoryStatsData;
+    
+    /**
+     * @param data CategoryStatsData  酒类分布统计数据
+     */
+    constructor(data: CategoryStatsData,);
+    /**
+     * 从对象创建 GetCategoryStatsResp
+     *
+     * @param o Object 
+     * - data: CategoryStatsData, //  酒类分布统计数据
+     */
+    static fromObject(o: Object): GetCategoryStatsResp;
+}
+
+/**
+ * 酒类分布统计数据
+ */
+export declare class CategoryStatsData {
+    [key: string]: any;
+    /**
+    * 酒类分布列表
+    */
+    categories: Array<CategoryStats>;
+    
+    /**
+     * @param categories Array<CategoryStats>  酒类分布列表
+     */
+    constructor(categories: Array<CategoryStats>,);
+    /**
+     * 从对象创建 CategoryStatsData
+     *
+     * @param o Object 
+     * - categories: Array<CategoryStats>, //  酒类分布列表
+     */
+    static fromObject(o: Object): CategoryStatsData;
+}
+
+/**
+ * 用户信息
+ */
+export declare class User {
+    [key: string]: any;
+    /**
+    * 用户ID
+    */
+    id: string|number;
+    /**
+    * 用户昵称
+    */
+    nickname: string;
+    /**
+    * 头像URL
+    */
+    avatar: string;
+    /**
+    * 加入时间
+    */
+    joinedAt: string;
+    /**
+    * 用户偏好
+    */
+    preferences: UserPreferences;
+    
+    /**
+     * @param id string|number  用户ID
+     * @param nickname string  用户昵称
+     * @param avatar string  头像URL
+     * @param joinedAt string  加入时间
+     * @param preferences UserPreferences  用户偏好
+     */
+    constructor(id: string|number,nickname: string,avatar: string,joinedAt: string,preferences: UserPreferences,);
+    /**
+     * 从对象创建 User
+     *
+     * @param o Object 
+     * - id: string|number, //  用户ID
+     * - nickname: string, //  用户昵称
+     * - avatar: string, //  头像URL
+     * - joinedAt: string, //  加入时间
+     * - preferences: UserPreferences, //  用户偏好
+     */
+    static fromObject(o: Object): User;
+}
+
+/**
+ * 用户偏好设置
+ */
+export declare class UserPreferences {
+    [key: string]: any;
+    /**
+    * 偏好酒类ID列表
+    */
+    favoriteCategories: Array<Category>;
+    /**
+    * 饮酒频率
+    */
+    frequency: Frequency;
+    
+    /**
+     * @param favoriteCategories Array<Category>  偏好酒类ID列表
+     * @param frequency Frequency  饮酒频率
+     */
+    constructor(favoriteCategories: Array<Category>,frequency: Frequency,);
+    /**
+     * 从对象创建 UserPreferences
+     *
+     * @param o Object 
+     * - favoriteCategories: Array<Category>, //  偏好酒类ID列表
+     * - frequency: Frequency, //  饮酒频率
+     */
+    static fromObject(o: Object): UserPreferences;
+}
+
+/**
+ * 获取用户信息请求
+ */
+export declare class GetUserProfileReq {
+    [key: string]: any;
+    
+    /**
+     */
+    constructor();
+    /**
+     * 从对象创建 GetUserProfileReq
+     *
+     * @param o Object 
+     */
+    static fromObject(o: Object): GetUserProfileReq;
+}
+
+/**
+ * 获取用户信息响应
+ */
+export declare class GetUserProfileResp {
+    [key: string]: any;
+    /**
+    * 用户ID
+    */
+    id: string|number;
+    /**
+    * 用户昵称
+    */
+    nickname: string;
+    /**
+    * 头像URL
+    */
+    avatar: string;
+    /**
+    * 加入时间
+    */
+    joinedAt: string;
+    /**
+    * 用户偏好
+    */
+    preferences: UserPreferences;
+    
+    /**
+     * @param id string|number  用户ID
+     * @param nickname string  用户昵称
+     * @param avatar string  头像URL
+     * @param joinedAt string  加入时间
+     * @param preferences UserPreferences  用户偏好
+     */
+    constructor(id: string|number,nickname: string,avatar: string,joinedAt: string,preferences: UserPreferences,);
+    /**
+     * 从对象创建 GetUserProfileResp
+     *
+     * @param o Object 
+     * - id: string|number, //  用户ID
+     * - nickname: string, //  用户昵称
+     * - avatar: string, //  头像URL
+     * - joinedAt: string, //  加入时间
+     * - preferences: UserPreferences, //  用户偏好
+     */
+    static fromObject(o: Object): GetUserProfileResp;
+}
+
+/**
+ * 更新用户偏好请求
+ */
+export declare class UpdatePreferencesReq {
+    [key: string]: any;
+    /**
+    * 偏好酒类ID列表
+    */
+    favoriteCategories: Array<Category>;
+    /**
+    * 饮酒频率
+    */
+    frequency: Frequency;
+    
+    /**
+     * @param favoriteCategories Array<Category>  偏好酒类ID列表
+     * @param frequency Frequency  饮酒频率
+     */
+    constructor(favoriteCategories: Array<Category>,frequency: Frequency,);
+    /**
+     * 从对象创建 UpdatePreferencesReq
+     *
+     * @param o Object 
+     * - favoriteCategories: Array<Category>, //  偏好酒类ID列表
+     * - frequency: Frequency, //  饮酒频率
+     */
+    static fromObject(o: Object): UpdatePreferencesReq;
+}
+
+/**
+ * 更新用户偏好响应
+ */
+export declare class UpdatePreferencesResp {
+    [key: string]: any;
+    /**
+    * 偏好酒类ID列表
+    */
+    favoriteCategories: Array<Category>;
+    /**
+    * 饮酒频率
+    */
+    frequency: Frequency;
+    
+    /**
+     * @param favoriteCategories Array<Category>  偏好酒类ID列表
+     * @param frequency Frequency  饮酒频率
+     */
+    constructor(favoriteCategories: Array<Category>,frequency: Frequency,);
+    /**
+     * 从对象创建 UpdatePreferencesResp
+     *
+     * @param o Object 
+     * - favoriteCategories: Array<Category>, //  偏好酒类ID列表
+     * - frequency: Frequency, //  饮酒频率
+     */
+    static fromObject(o: Object): UpdatePreferencesResp;
+}
+
+/**
+ * 上传图片参数
+ */
+export declare class UploadImageReq {
+    [key: string]: any;
+    /**
+    * 图片
+    */
+    image: any;
+    
+    /**
+     * @param image any  图片
+     */
+    constructor(image: any,);
+    /**
+     * 从对象创建 UploadImageReq
+     *
+     * @param o Object 
+     * - image: any, //  图片
+     */
+    static fromObject(o: Object): UploadImageReq;
+}
+
+/**
+ * 上传图片返回
+ */
+export declare class UploadImageResp {
+    [key: string]: any;
+    /**
+    * 图片 id
+    */
+    id: string|number;
+    /**
+    * 图片 url
+    */
+    url: string;
+    
+    /**
+     * @param id string|number  图片 id
+     * @param url string  图片 url
+     */
+    constructor(id: string|number,url: string,);
+    /**
+     * 从对象创建 UploadImageResp
+     *
+     * @param o Object 
+     * - id: string|number, //  图片 id
+     * - url: string, //  图片 url
+     */
+    static fromObject(o: Object): UploadImageResp;
+}
+
+/**
+ * 引用文件参数
+ */
+export declare class ReferenceFileReq {
+    [key: string]: any;
+    /**
+    * 项目名称
+    */
+    project: string;
+    /**
+    * 模块名称
+    */
+    module: string;
+    /**
+    * 数据 id
+    */
+    data: number;
+    /**
+    * 文件 urls
+    */
+    urls: Array<string>;
+    
+    /**
+     * @param project string  项目名称
+     * @param module string  模块名称
+     * @param data number  数据 id
+     * @param urls Array<string>  文件 urls
+     */
+    constructor(project: string,module: string,data: number,urls: Array<string>,);
+    /**
+     * 从对象创建 ReferenceFileReq
+     *
+     * @param o Object 
+     * - project: string, //  项目名称
+     * - module: string, //  模块名称
+     * - data: number, //  数据 id
+     * - urls: Array<string>, //  文件 urls
+     */
+    static fromObject(o: Object): ReferenceFileReq;
+}
+
+/**
+ * 引用文件返回
+ */
+export declare class ReferenceFileResp {
+    [key: string]: any;
+    /**
+    * 是否成功
+    */
+    ok: boolean;
+    
+    /**
+     * @param ok boolean  是否成功
+     */
+    constructor(ok: boolean,);
+    /**
+     * 从对象创建 ReferenceFileResp
+     *
+     * @param o Object 
+     * - ok: boolean, //  是否成功
+     */
+    static fromObject(o: Object): ReferenceFileResp;
+}
+
+/**
+ * 取消引用文件参数
+ */
+export declare class DereferenceFileReq {
+    [key: string]: any;
+    /**
+    * 模块
+    */
+    module: string;
+    /**
+    * 数据 id
+    */
+    data: number;
+    /**
+    * 文件 urls
+    */
+    urls: Array<string>;
+    
+    /**
+     * @param module string  模块
+     * @param data number  数据 id
+     * @param urls Array<string>  文件 urls
+     */
+    constructor(module: string,data: number,urls: Array<string>,);
+    /**
+     * 从对象创建 DereferenceFileReq
+     *
+     * @param o Object 
+     * - module: string, //  模块
+     * - data: number, //  数据 id
+     * - urls: Array<string>, //  文件 urls
+     */
+    static fromObject(o: Object): DereferenceFileReq;
+}
+
+/**
+ * 取消引用文件返回
+ */
+export declare class DereferenceFileResp {
+    [key: string]: any;
+    /**
+    * 是否成功
+    */
+    ok: boolean;
+    
+    /**
+     * @param ok boolean  是否成功
+     */
+    constructor(ok: boolean,);
+    /**
+     * 从对象创建 DereferenceFileResp
+     *
+     * @param o Object 
+     * - ok: boolean, //  是否成功
+     */
+    static fromObject(o: Object): DereferenceFileResp;
+}
+
+/**
+ * 删除数据参数
+ */
+export declare class DeleteDataReq {
+    [key: string]: any;
+    /**
+    * 模块
+    */
+    module: string;
+    /**
+    * 数据 id
+    */
+    data: number;
+    
+    /**
+     * @param module string  模块
+     * @param data number  数据 id
+     */
+    constructor(module: string,data: number,);
+    /**
+     * 从对象创建 DeleteDataReq
+     *
+     * @param o Object 
+     * - module: string, //  模块
+     * - data: number, //  数据 id
+     */
+    static fromObject(o: Object): DeleteDataReq;
+}
+
+/**
+ * 删除数据返回
+ */
+export declare class DeleteDataResp {
+    [key: string]: any;
+    /**
+    * 是否成功
+    */
+    ok: boolean;
+    
+    /**
+     * @param ok boolean  是否成功
+     */
+    constructor(ok: boolean,);
+    /**
+     * 从对象创建 DeleteDataResp
+     *
+     * @param o Object 
+     * - ok: boolean, //  是否成功
+     */
+    static fromObject(o: Object): DeleteDataResp;
+}
+
+
+
+/**
+ * * 喝酒了么 - 后端接口 API
+ * 小程序：喝酒了么（uni-app 微信小程序）
+ * 基础URL: /api/v1
+ * 
+ * 主要功能模块：
+ * 1. 用户模块 - 微信登录、用户信息管理
+ * 2. 打卡记录模块 - 饮酒记录创建、查询、日历数据
+ * 3. 照片上传模块 - 单张/批量照片上传
+ * 4. 统计模块 - 用户统计、月度统计、酒类分布
+ * 5. 成就模块 - 成就列表和进度
+ * 6. 社交模块 - 朋友圈动态、点赞
+ */
+export default class HaveADrink {
+    host: string;
+    http_request: any;
+    upload: any;
+    constructor(conf: any);
+
+    /**
+     * 设置 token
+     * 
+     * @param token 登录接口获取的 token
+     */
+    public setToken(token: string): void;
+
+    /**
+     * 微信登录, 获取openid、unionid、token
+     *
+     * @param req WechatLoginReq 微信登录请求参数
+     * @return WechatLoginResp 微信登录返回值
+     */
+    public WechatLogin(req: WechatLoginReq) : Promise<WechatLoginResp>;
+    
+    /**
+     * 获取微信手机号
+     *
+     * @param req WechatGetPhoneNumberReq 获取微信手机号
+     * @return WechatGetPhoneNumberResp 获取微信手机号返回值
+     */
+    public WechatGetPhoneNumber(req: WechatGetPhoneNumberReq) : Promise<WechatGetPhoneNumberResp>;
+    
+    /**
+     * 刷新 token 接口
+     *
+     * @param req RefreshTokenReq 刷新token请求参数
+     * @return RefreshTokenResp 刷新 token 返回值
+     */
+    public RefreshToken(req: RefreshTokenReq) : Promise<RefreshTokenResp>;
+    
+    /**
+     * 获取成就列表
+     *
+     * @param req GetAchievementsReq 
+     * @return GetAchievementsResp 获取成就列表响应
+     */
+    public GetAchievements(req: GetAchievementsReq) : Promise<GetAchievementsResp>;
+    
+    /**
+     * 获取朋友圈动态
+     *
+     * @param req GetFeedReq 获取朋友圈动态请求
+     * @return GetFeedResp 获取朋友圈动态响应
+     */
+    public GetFeed(req: GetFeedReq) : Promise<GetFeedResp>;
+    
+    /**
+     * 点赞
+     *
+     * @param req LikeRecordReq 点赞/取消点赞请求
+     * @return LikeRecordResp 点赞/取消点赞响应
+     */
+    public LikeRecord(req: LikeRecordReq) : Promise<LikeRecordResp>;
+    
+    /**
+     * 取消点赞
+     *
+     * @param req LikeRecordReq 点赞/取消点赞请求
+     * @return LikeRecordResp 点赞/取消点赞响应
+     */
+    public UnlikeRecord(req: LikeRecordReq) : Promise<LikeRecordResp>;
+    
+    /**
+     * 上传照片
+     *
+     * @param req UploadPhotoReq 上传照片请求
+     * @return UploadPhotoResp 上传照片响应
+     */
+    public UploadPhoto(req: UploadPhotoReq) : Promise<UploadPhotoResp>;
+    
+    /**
+     * 批量上传照片
+     *
+     * @param req UploadPhotosReq 批量上传照片请求
+     * @return UploadPhotosResp 批量上传照片响应
+     */
+    public UploadPhotos(req: UploadPhotosReq) : Promise<UploadPhotosResp>;
+    
+    /**
+     * 创建打卡记录
+     *
+     * @param req CreateRecordReq 创建打卡记录请求
+     * @return CreateRecordResp 创建打卡记录响应
+     */
+    public CreateRecord(req: CreateRecordReq) : Promise<CreateRecordResp>;
+    
+    /**
+     * 获取记录列表
+     *
+     * @param req GetRecordsReq 获取记录列表请求
+     * @return GetRecordsResp 获取记录列表响应
+     */
+    public GetRecords(req: GetRecordsReq) : Promise<GetRecordsResp>;
+    
+    /**
+     * 获取单条记录详情
+     *
+     * @param req GetRecordDetailReq 获取单条记录详情请求
+     * @return GetRecordDetailResp 获取单条记录详情响应
+     */
+    public GetRecordDetail(req: GetRecordDetailReq) : Promise<GetRecordDetailResp>;
+    
+    /**
+     * 删除记录
+     *
+     * @param req DeleteRecordReq 删除记录请求
+     * @return DeleteRecordResp 删除记录响应
+     */
+    public DeleteRecord(req: DeleteRecordReq) : Promise<DeleteRecordResp>;
+    
+    /**
+     * 获取日历打卡数据
+     *
+     * @param req GetCalendarReq 获取日历打卡数据请求
+     * @return GetCalendarResp 获取日历打卡数据响应
+     */
+    public GetCalendar(req: GetCalendarReq) : Promise<GetCalendarResp>;
+    
+    /**
+     * 获取用户统计概览
+     *
+     * @param req GetStatsOverviewReq 
+     * @return GetStatsOverviewResp 获取用户统计概览响应
+     */
+    public GetStatsOverview(req: GetStatsOverviewReq) : Promise<GetStatsOverviewResp>;
+    
+    /**
+     * 获取月度统计
+     *
+     * @param req GetMonthlyStatsReq 获取月度统计请求
+     * @return GetMonthlyStatsResp 获取月度统计响应
+     */
+    public GetMonthlyStats(req: GetMonthlyStatsReq) : Promise<GetMonthlyStatsResp>;
+    
+    /**
+     * 获取酒类分布统计
+     *
+     * @param req GetCategoryStatsReq 
+     * @return GetCategoryStatsResp 获取酒类分布统计响应
+     */
+    public GetCategoryStats(req: GetCategoryStatsReq) : Promise<GetCategoryStatsResp>;
+    
+    /**
+     * 获取用户信息
+     *
+     * @param req GetUserProfileReq 获取用户信息请求
+     * @return GetUserProfileResp 获取用户信息响应
+     */
+    public GetUserProfile(req: GetUserProfileReq) : Promise<GetUserProfileResp>;
+    
+    /**
+     * 更新用户偏好
+     *
+     * @param req UpdatePreferencesReq 更新用户偏好请求
+     * @return UpdatePreferencesResp 更新用户偏好响应
+     */
+    public UpdatePreferences(req: UpdatePreferencesReq) : Promise<UpdatePreferencesResp>;
+    
+    /**
+     * 上传文件
+     *
+     * @param req UploadImageReq 上传图片参数
+     * @return UploadImageResp 上传图片返回
+     */
+    public UploadImage(req: UploadImageReq) : Promise<UploadImageResp>;
+    
+}
diff --git a/node_modules/HaveADrink/index.js b/node_modules/HaveADrink/index.js
new file mode 100644
index 0000000..6202c4b
--- /dev/null
+++ b/node_modules/HaveADrink/index.js
@@ -0,0 +1,2378 @@
+"use strict";
+/*
+ * 喝酒了么 - 后端接口 API
+ * 小程序：喝酒了么（uni-app 微信小程序）
+ * 基础URL: /api/v1
+ * 
+ * 主要功能模块：
+ * 1. 用户模块 - 微信登录、用户信息管理
+ * 2. 打卡记录模块 - 饮酒记录创建、查询、日历数据
+ * 3. 照片上传模块 - 单张/批量照片上传
+ * 4. 统计模块 - 用户统计、月度统计、酒类分布
+ * 5. 成就模块 - 成就列表和进度
+ * 6. 社交模块 - 朋友圈动态、点赞
+ */
+
+export class Enum {
+    constructor(value) {
+        this.v = value;
+    }
+    toString() {
+        return this.v;
+    }
+    toJSON() {
+        return this.v;
+    }
+    valueOf() {
+        return this.v;
+    };
+}
+
+
+/**
+ * 成就条件类型
+ */
+export class AchievementConditionType {
+    /**
+     * 总记录数
+     */
+    static TotalRecords = "total_records";
+    /**
+     * 累计标准杯
+     */
+    static TotalStandardCups = "total_standard_cups";
+    /**
+     * 连续打卡天数
+     */
+    static StreakDays = "streak_days";
+    /**
+     * 某酒类打卡次数
+     */
+    static CategoryRecords = "category_records";
+    /**
+     * 尝试酒类品种数
+     */
+    static CategoryVariety = "category_variety";
+
+    static entries() {
+        return [
+            { value: AchievementConditionType.TotalRecords, label: '总记录数' },
+            { value: AchievementConditionType.TotalStandardCups, label: '累计标准杯' },
+            { value: AchievementConditionType.StreakDays, label: '连续打卡天数' },
+            { value: AchievementConditionType.CategoryRecords, label: '某酒类打卡次数' },
+            { value: AchievementConditionType.CategoryVariety, label: '尝试酒类品种数' },
+        ];
+    }
+    static getLabel(v) {
+        switch(v) { 
+        case AchievementConditionType.TotalRecords: return '总记录数';
+        case AchievementConditionType.TotalStandardCups: return '累计标准杯';
+        case AchievementConditionType.StreakDays: return '连续打卡天数';
+        case AchievementConditionType.CategoryRecords: return '某酒类打卡次数';
+        case AchievementConditionType.CategoryVariety: return '尝试酒类品种数';
+        }
+    }
+}
+
+/**
+ * 酒类分类
+ */
+export class Category {
+    /**
+     * 白酒
+     */
+    static Baijiu = "baijiu";
+    /**
+     * 啤酒
+     */
+    static Beer = "beer";
+    /**
+     * 红酒
+     */
+    static Wine = "wine";
+    /**
+     * 洋酒
+     */
+    static Whisky = "whisky";
+    /**
+     * 黄酒
+     */
+    static Huangjiu = "huangjiu";
+    /**
+     * 清酒
+     */
+    static Sake = "sake";
+    /**
+     * 果酒
+     */
+    static Fruit = "fruit";
+    /**
+     * 调酒
+     */
+    static Cocktail = "cocktail";
+    /**
+     * 其他
+     */
+    static Other = "other";
+
+    static entries() {
+        return [
+            { value: Category.Baijiu, label: '白酒' },
+            { value: Category.Beer, label: '啤酒' },
+            { value: Category.Wine, label: '红酒' },
+            { value: Category.Whisky, label: '洋酒' },
+            { value: Category.Huangjiu, label: '黄酒' },
+            { value: Category.Sake, label: '清酒' },
+            { value: Category.Fruit, label: '果酒' },
+            { value: Category.Cocktail, label: '调酒' },
+            { value: Category.Other, label: '其他' },
+        ];
+    }
+    static getLabel(v) {
+        switch(v) { 
+        case Category.Baijiu: return '白酒';
+        case Category.Beer: return '啤酒';
+        case Category.Wine: return '红酒';
+        case Category.Whisky: return '洋酒';
+        case Category.Huangjiu: return '黄酒';
+        case Category.Sake: return '清酒';
+        case Category.Fruit: return '果酒';
+        case Category.Cocktail: return '调酒';
+        case Category.Other: return '其他';
+        }
+    }
+}
+
+/**
+ * 饮用量单位
+ */
+export class Unit {
+    /**
+     * 毫升
+     */
+    static Ml = "ml";
+    /**
+     * 两
+     */
+    static Liang = "liang";
+    /**
+     * 瓶
+     */
+    static Bottle = "bottle";
+    /**
+     * 杯
+     */
+    static Cup = "cup";
+    /**
+     * 听
+     */
+    static Can = "can";
+    /**
+     * shot
+     */
+    static Shot = "shot";
+
+    static entries() {
+        return [
+            { value: Unit.Ml, label: '毫升' },
+            { value: Unit.Liang, label: '两' },
+            { value: Unit.Bottle, label: '瓶' },
+            { value: Unit.Cup, label: '杯' },
+            { value: Unit.Can, label: '听' },
+            { value: Unit.Shot, label: 'shot' },
+        ];
+    }
+    static getLabel(v) {
+        switch(v) { 
+        case Unit.Ml: return '毫升';
+        case Unit.Liang: return '两';
+        case Unit.Bottle: return '瓶';
+        case Unit.Cup: return '杯';
+        case Unit.Can: return '听';
+        case Unit.Shot: return 'shot';
+        }
+    }
+}
+
+/**
+ * 配餐分类
+ */
+export class FoodCategory {
+    /**
+     * 火锅
+     */
+    static Hotpot = "hotpot";
+    /**
+     * 烧烤
+     */
+    static Bbq = "bbq";
+    /**
+     * 炒菜
+     */
+    static Stirfry = "stirfry";
+    /**
+     * 海鲜
+     */
+    static Seafood = "seafood";
+    /**
+     * 日料
+     */
+    static Japanese = "japanese";
+    /**
+     * 西餐
+     */
+    static Western = "western";
+    /**
+     * 小吃卤味
+     */
+    static Snack = "snack";
+    /**
+     * 零食
+     */
+    static Junk = "junk";
+    /**
+     * 无配餐
+     */
+    static None = "none";
+
+    static entries() {
+        return [
+            { value: FoodCategory.Hotpot, label: '火锅' },
+            { value: FoodCategory.Bbq, label: '烧烤' },
+            { value: FoodCategory.Stirfry, label: '炒菜' },
+            { value: FoodCategory.Seafood, label: '海鲜' },
+            { value: FoodCategory.Japanese, label: '日料' },
+            { value: FoodCategory.Western, label: '西餐' },
+            { value: FoodCategory.Snack, label: '小吃卤味' },
+            { value: FoodCategory.Junk, label: '零食' },
+            { value: FoodCategory.None, label: '无配餐' },
+        ];
+    }
+    static getLabel(v) {
+        switch(v) { 
+        case FoodCategory.Hotpot: return '火锅';
+        case FoodCategory.Bbq: return '烧烤';
+        case FoodCategory.Stirfry: return '炒菜';
+        case FoodCategory.Seafood: return '海鲜';
+        case FoodCategory.Japanese: return '日料';
+        case FoodCategory.Western: return '西餐';
+        case FoodCategory.Snack: return '小吃卤味';
+        case FoodCategory.Junk: return '零食';
+        case FoodCategory.None: return '无配餐';
+        }
+    }
+}
+
+/**
+ * 饮用感受
+ */
+export class Feeling {
+    /**
+     * 微醺
+     */
+    static Tipsy = "tipsy";
+    /**
+     * 到位
+     */
+    static Buzzed = "buzzed";
+    /**
+     * 醉了
+     */
+    static Drunk = "drunk";
+    /**
+     * 断片
+     */
+    static Blackout = "blackout";
+
+    static entries() {
+        return [
+            { value: Feeling.Tipsy, label: '微醺' },
+            { value: Feeling.Buzzed, label: '到位' },
+            { value: Feeling.Drunk, label: '醉了' },
+            { value: Feeling.Blackout, label: '断片' },
+        ];
+    }
+    static getLabel(v) {
+        switch(v) { 
+        case Feeling.Tipsy: return '微醺';
+        case Feeling.Buzzed: return '到位';
+        case Feeling.Drunk: return '醉了';
+        case Feeling.Blackout: return '断片';
+        }
+    }
+}
+
+/**
+ * 可见范围
+ */
+export class Visibility {
+    /**
+     * 公开
+     */
+    static Public = "public";
+    /**
+     * 仅好友
+     */
+    static Friends = "friends";
+    /**
+     * 仅自己
+     */
+    static Private = "private";
+
+    static entries() {
+        return [
+            { value: Visibility.Public, label: '公开' },
+            { value: Visibility.Friends, label: '仅好友' },
+            { value: Visibility.Private, label: '仅自己' },
+        ];
+    }
+    static getLabel(v) {
+        switch(v) { 
+        case Visibility.Public: return '公开';
+        case Visibility.Friends: return '仅好友';
+        case Visibility.Private: return '仅自己';
+        }
+    }
+}
+
+/**
+ * 打卡模式
+ */
+export class Mode {
+    /**
+     * 今日喝了
+     */
+    static Drank = "drank";
+    /**
+     * 今日未喝
+     */
+    static Abstain = "abstain";
+
+    static entries() {
+        return [
+            { value: Mode.Drank, label: '今日喝了' },
+            { value: Mode.Abstain, label: '今日未喝' },
+        ];
+    }
+    static getLabel(v) {
+        switch(v) { 
+        case Mode.Drank: return '今日喝了';
+        case Mode.Abstain: return '今日未喝';
+        }
+    }
+}
+
+/**
+ * 饮酒频率
+ */
+export class Frequency {
+    /**
+     * 很少
+     */
+    static Rarely = "rarely";
+    /**
+     * 有时
+     */
+    static Sometimes = "sometimes";
+    /**
+     * 经常
+     */
+    static Often = "often";
+
+    static entries() {
+        return [
+            { value: Frequency.Rarely, label: '很少' },
+            { value: Frequency.Sometimes, label: '有时' },
+            { value: Frequency.Often, label: '经常' },
+        ];
+    }
+    static getLabel(v) {
+        switch(v) { 
+        case Frequency.Rarely: return '很少';
+        case Frequency.Sometimes: return '有时';
+        case Frequency.Often: return '经常';
+        }
+    }
+}
+
+/**
+ * 手机号
+ */
+export class Phone {
+    /**
+     * @param regin string
+     * @param number string
+     */
+    constructor(regin, number) {
+        this.regin = regin;
+        this.number = number;
+    }
+}
+
+
+/**
+ * 分页请求参数
+ */
+export class PageReq {
+    /**
+     * @param page: number  页码
+     * @param pageSize: number  每页数量，默认1-100
+     */
+    constructor(page,pageSize,) {
+        this.page = page;
+        this.pageSize = pageSize;
+        
+    }
+    static fromObject(o) {
+        return new PageReq(o.page,o.pageSize,);
+    }
+}
+
+/**
+ * 分页响应结构
+ */
+export class PageResp {
+    /**
+     * @param total: number  总数
+     * @param page: number  当前页码
+     * @param pageSize: number  每页数量
+     */
+    constructor(total,page,pageSize,) {
+        this.total = total;
+        this.page = page;
+        this.pageSize = pageSize;
+        
+    }
+    static fromObject(o) {
+        return new PageResp(o.total,o.page,o.pageSize,);
+    }
+}
+
+/**
+ * 
+ */
+export class Ok {
+    /**
+     * @param ok: boolean  是否成功
+     */
+    constructor(ok,) {
+        this.ok = ok;
+        
+    }
+    static fromObject(o) {
+        return new Ok(o.ok,);
+    }
+}
+
+/**
+ * 微信登录请求参数
+ */
+export class WechatLoginReq {
+    /**
+     * @param code: string  登录时获取的 code, 可通过 wx.login 获取
+     * @param nickName: string  用户昵称
+     * @param avatarUrl: string  头像URL
+     */
+    constructor(code,nickName,avatarUrl,) {
+        this.code = code;
+        this.nickName = nickName;
+        this.avatarUrl = avatarUrl;
+        
+    }
+    static fromObject(o) {
+        return new WechatLoginReq(o.code,o.nickName,o.avatarUrl,);
+    }
+}
+
+/**
+ * 微信登录返回值
+ */
+export class WechatLoginResp {
+    /**
+     * @param token: string  JWT Token
+     * @param user: User  用户信息
+     * @param isNew: boolean  是否新用户
+     * @param session_key: string  会话密钥
+     * @param open_id: string  用户唯一标识
+     * @param union_id: string  用户在开放平台的唯一标识符，若当前小程序已绑定到微信开放平台账号下会返回，详见 UnionID 机制说明。
+     * @param errcode: number  错误码
+     * @param errmsg: string  错误信息
+     * @param refresh_token: string  刷新token
+     */
+    constructor(token,user,isNew,session_key,open_id,union_id,errcode,errmsg,refresh_token,) {
+        this.token = token;
+        this.user = user;
+        this.isNew = isNew;
+        this.session_key = session_key;
+        this.open_id = open_id;
+        this.union_id = union_id;
+        this.errcode = errcode;
+        this.errmsg = errmsg;
+        this.refresh_token = refresh_token;
+        
+    }
+    static fromObject(o) {
+        return new WechatLoginResp(o.token,o.user,o.isNew,o.session_key,o.open_id,o.union_id,o.errcode,o.errmsg,o.refresh_token,);
+    }
+}
+
+/**
+ * 获取微信手机号
+ */
+export class WechatGetPhoneNumberReq {
+    /**
+     * @param code: string  手机号获取凭证
+     */
+    constructor(code,) {
+        this.code = code;
+        
+    }
+    static fromObject(o) {
+        return new WechatGetPhoneNumberReq(o.code,);
+    }
+}
+
+/**
+ * 获取微信手机号返回值
+ */
+export class WechatGetPhoneNumberResp {
+    /**
+     * @param errcode: number  错误码
+     * @param errmsg: string  错误信息
+     * @param token: string  token:api使用
+     * @param expires_in: number  token 超时时间，单位（秒）
+     * @param refresh_token: string  refresh_token:刷新token
+     */
+    constructor(errcode,errmsg,token,expires_in,refresh_token,) {
+        this.errcode = errcode;
+        this.errmsg = errmsg;
+        this.token = token;
+        this.expires_in = expires_in;
+        this.refresh_token = refresh_token;
+        
+    }
+    static fromObject(o) {
+        return new WechatGetPhoneNumberResp(o.errcode,o.errmsg,o.token,o.expires_in,o.refresh_token,);
+    }
+}
+
+/**
+ * 刷新token请求参数
+ */
+export class RefreshTokenReq {
+    /**
+     * @param refresh_token: string  签发 token 时生成的 refresh_token
+     */
+    constructor(refresh_token,) {
+        this.refresh_token = refresh_token;
+        
+    }
+    static fromObject(o) {
+        return new RefreshTokenReq(o.refresh_token,);
+    }
+}
+
+/**
+ * 刷新 token 返回值
+ */
+export class RefreshTokenResp {
+    /**
+     * @param token: string  生成的新token
+     * @param expire_in: number  token 超时时间，单位（秒）
+     * @param refresh_token: string  refresh_token:刷新token
+     */
+    constructor(token,expire_in,refresh_token,) {
+        this.token = token;
+        this.expire_in = expire_in;
+        this.refresh_token = refresh_token;
+        
+    }
+    static fromObject(o) {
+        return new RefreshTokenResp(o.token,o.expire_in,o.refresh_token,);
+    }
+}
+
+/**
+ * 成就条件
+ */
+export class AchievementCondition {
+    /**
+     * @param type: AchievementConditionType  条件类型
+     * @param value: number  目标值
+     */
+    constructor(type,value,) {
+        this.type = type;
+        this.value = value;
+        
+    }
+    static fromObject(o) {
+        return new AchievementCondition(o.type,o.value,);
+    }
+}
+
+/**
+ * 成就信息
+ */
+export class Achievement {
+    /**
+     * @param id: string  成就ID
+     * @param name: string  成就名称
+     * @param desc: string  成就描述
+     * @param icon: string  成就图标
+     * @param unlocked: boolean  是否已解锁
+     * @param unlockedAt: string  解锁时间
+     * @param condition: AchievementCondition  成就条件
+     * @param progress: number  进度（0-1）
+     */
+    constructor(id,name,desc,icon,unlocked,unlockedAt,condition,progress,) {
+        this.id = id;
+        this.name = name;
+        this.desc = desc;
+        this.icon = icon;
+        this.unlocked = unlocked;
+        this.unlockedAt = unlockedAt;
+        this.condition = condition;
+        this.progress = progress;
+        
+    }
+    static fromObject(o) {
+        return new Achievement(o.id,o.name,o.desc,o.icon,o.unlocked,o.unlockedAt,o.condition,o.progress,);
+    }
+}
+
+/**
+ * 
+ */
+export class GetAchievementsReq {
+    /**
+     */
+    constructor() {
+        
+    }
+    static fromObject(o) {
+        return new GetAchievementsReq();
+    }
+}
+
+/**
+ * 获取成就列表响应
+ */
+export class GetAchievementsResp {
+    /**
+     * @param data: AchievementsData  成就列表数据
+     */
+    constructor(data,) {
+        this.data = data;
+        
+    }
+    static fromObject(o) {
+        return new GetAchievementsResp(o.data,);
+    }
+}
+
+/**
+ * 成就列表数据
+ */
+export class AchievementsData {
+    /**
+     * @param achievements: Array<Achievement>  成就列表
+     */
+    constructor(achievements,) {
+        this.achievements = achievements;
+        
+    }
+    static fromObject(o) {
+        return new AchievementsData(o.achievements,);
+    }
+}
+
+/**
+ * 朋友圈动态项
+ */
+export class FeedItem {
+    /**
+     * @param id: string|number  记录ID
+     * @param user: FeedUser  用户信息
+     * @param date: string  日期
+     * @param mode: Mode  打卡模式
+     * @param drinks: Array<DrinkItem>  酒水列表
+     * @param food: FoodInfo  配餐信息
+     * @param feeling: Feeling  感受
+     * @param photos: Array<string>  照片URL数组
+     * @param standardCupsTotal: number  标准杯总数
+     * @param quote: string  酒言酒语
+     * @param likeCount: number  点赞数
+     * @param commentCount: number  评论数
+     * @param liked: boolean  当前用户是否已点赞
+     * @param createdAt: string  创建时间
+     */
+    constructor(id,user,date,mode,drinks,food,feeling,photos,standardCupsTotal,quote,likeCount,commentCount,liked,createdAt,) {
+        this.id = id;
+        this.user = user;
+        this.date = date;
+        this.mode = mode;
+        this.drinks = drinks;
+        this.food = food;
+        this.feeling = feeling;
+        this.photos = photos;
+        this.standardCupsTotal = standardCupsTotal;
+        this.quote = quote;
+        this.likeCount = likeCount;
+        this.commentCount = commentCount;
+        this.liked = liked;
+        this.createdAt = createdAt;
+        
+    }
+    static fromObject(o) {
+        return new FeedItem(o.id,o.user,o.date,o.mode,o.drinks,o.food,o.feeling,o.photos,o.standardCupsTotal,o.quote,o.likeCount,o.commentCount,o.liked,o.createdAt,);
+    }
+}
+
+/**
+ * 朋友圈用户信息
+ */
+export class FeedUser {
+    /**
+     * @param id: string|number  用户ID
+     * @param nickname: string  用户昵称
+     * @param avatar: string  头像URL
+     */
+    constructor(id,nickname,avatar,) {
+        this.id = id;
+        this.nickname = nickname;
+        this.avatar = avatar;
+        
+    }
+    static fromObject(o) {
+        return new FeedUser(o.id,o.nickname,o.avatar,);
+    }
+}
+
+/**
+ * 获取朋友圈动态请求
+ */
+export class GetFeedReq {
+    /**
+     * @param lastId: string|number  游标分页，上一页最后一条ID
+     */
+    constructor(lastId,) {
+        this.lastId = lastId;
+        
+    }
+    static fromObject(o) {
+        return new GetFeedReq(o.lastId,);
+    }
+}
+
+/**
+ * 获取朋友圈动态响应
+ */
+export class GetFeedResp {
+    /**
+     * @param data: FeedPageData  朋友圈动态分页数据
+     */
+    constructor(data,) {
+        this.data = data;
+        
+    }
+    static fromObject(o) {
+        return new GetFeedResp(o.data,);
+    }
+}
+
+/**
+ * 朋友圈动态分页数据
+ */
+export class FeedPageData {
+    /**
+     * @param list: Array<FeedItem>  动态列表
+     */
+    constructor(list,) {
+        this.list = list;
+        
+    }
+    static fromObject(o) {
+        return new FeedPageData(o.list,);
+    }
+}
+
+/**
+ * 点赞/取消点赞请求
+ */
+export class LikeRecordReq {
+    /**
+     * @param id: string|number  记录ID
+     */
+    constructor(id,) {
+        this.id = id;
+        
+    }
+    static fromObject(o) {
+        return new LikeRecordReq(o.id,);
+    }
+}
+
+/**
+ * 点赞/取消点赞响应
+ */
+export class LikeRecordResp {
+    /**
+     */
+    constructor() {
+        
+    }
+    static fromObject(o) {
+        return new LikeRecordResp();
+    }
+}
+
+/**
+ * 上传照片请求
+ */
+export class UploadPhotoReq {
+    /**
+     * @param url: string  图片Url
+     * @param recordId: string|number  关联记录ID
+     */
+    constructor(url,recordId,) {
+        this.url = url;
+        this.recordId = recordId;
+        
+    }
+    static fromObject(o) {
+        return new UploadPhotoReq(o.url,o.recordId,);
+    }
+}
+
+/**
+ * 上传照片响应
+ */
+export class UploadPhotoResp {
+    /**
+     */
+    constructor() {
+        
+    }
+    static fromObject(o) {
+        return new UploadPhotoResp();
+    }
+}
+
+/**
+ * 批量上传照片请求
+ */
+export class UploadPhotosReq {
+    /**
+     * @param urls: Array<string>  图片URL数组（最多9张）
+     * @param recordId: string|number  关联记录ID
+     */
+    constructor(urls,recordId,) {
+        this.urls = urls;
+        this.recordId = recordId;
+        
+    }
+    static fromObject(o) {
+        return new UploadPhotosReq(o.urls,o.recordId,);
+    }
+}
+
+/**
+ * 批量上传照片响应
+ */
+export class UploadPhotosResp {
+    /**
+     */
+    constructor() {
+        
+    }
+    static fromObject(o) {
+        return new UploadPhotosResp();
+    }
+}
+
+/**
+ * 酒水项
+ */
+export class DrinkItem {
+    /**
+     * @param category: Category  酒类分类ID
+     * @param brand: string  品牌名称
+     * @param product: string  产品名
+     * @param amount: number  饮用量数值
+     * @param unit: Unit  单位
+     * @param degree: number  酒精度数(%)
+     * @param standardCups: number  标准杯数（前端计算，后端应校验）
+     */
+    constructor(category,brand,product,amount,unit,degree,standardCups,) {
+        this.category = category;
+        this.brand = brand;
+        this.product = product;
+        this.amount = amount;
+        this.unit = unit;
+        this.degree = degree;
+        this.standardCups = standardCups;
+        
+    }
+    static fromObject(o) {
+        return new DrinkItem(o.category,o.brand,o.product,o.amount,o.unit,o.degree,o.standardCups,);
+    }
+}
+
+/**
+ * 配餐信息
+ */
+export class FoodInfo {
+    /**
+     * @param category: FoodCategory  配餐分类ID
+     * @param name: string  具体菜名
+     */
+    constructor(category,name,) {
+        this.category = category;
+        this.name = name;
+        
+    }
+    static fromObject(o) {
+        return new FoodInfo(o.category,o.name,);
+    }
+}
+
+/**
+ * 创建打卡记录请求
+ */
+export class CreateRecordReq {
+    /**
+     * @param date: string  日期 YYYY-MM-DD
+     * @param mode: Mode  打卡模式
+     * @param drinks: Array<DrinkItem>  酒水列表（mode=abstain时为空数组）
+     * @param food: FoodInfo  配餐信息
+     * @param feeling: Feeling  感受ID
+     * @param photos: Array<string>  照片URL数组（最多9张）
+     * @param visibility: Visibility  可见范围
+     * @param quote: string  酒言酒语
+     */
+    constructor(date,mode,drinks,food,feeling,photos,visibility,quote,) {
+        this.date = date;
+        this.mode = mode;
+        this.drinks = drinks;
+        this.food = food;
+        this.feeling = feeling;
+        this.photos = photos;
+        this.visibility = visibility;
+        this.quote = quote;
+        
+    }
+    static fromObject(o) {
+        return new CreateRecordReq(o.date,o.mode,o.drinks,o.food,o.feeling,o.photos,o.visibility,o.quote,);
+    }
+}
+
+/**
+ * 打卡记录详情
+ */
+export class Record {
+    /**
+     * @param id: string|number  记录ID
+     * @param date: string  日期
+     * @param mode: Mode  打卡模式
+     * @param drinks: Array<DrinkItem>  酒水列表
+     * @param food: FoodInfo  配餐信息
+     * @param feeling: Feeling  感受
+     * @param photos: Array<string>  照片URL数组
+     * @param visibility: Visibility  可见范围
+     * @param quote: string  酒言酒语
+     * @param standardCupsTotal: number  标准杯总数
+     * @param createdAt: string  创建时间
+     */
+    constructor(id,date,mode,drinks,food,feeling,photos,visibility,quote,standardCupsTotal,createdAt,) {
+        this.id = id;
+        this.date = date;
+        this.mode = mode;
+        this.drinks = drinks;
+        this.food = food;
+        this.feeling = feeling;
+        this.photos = photos;
+        this.visibility = visibility;
+        this.quote = quote;
+        this.standardCupsTotal = standardCupsTotal;
+        this.createdAt = createdAt;
+        
+    }
+    static fromObject(o) {
+        return new Record(o.id,o.date,o.mode,o.drinks,o.food,o.feeling,o.photos,o.visibility,o.quote,o.standardCupsTotal,o.createdAt,);
+    }
+}
+
+/**
+ * 创建打卡记录响应
+ */
+export class CreateRecordResp {
+    /**
+     * @param data: Record  创建的记录详情
+     */
+    constructor(data,) {
+        this.data = data;
+        
+    }
+    static fromObject(o) {
+        return new CreateRecordResp(o.data,);
+    }
+}
+
+/**
+ * 获取记录列表请求
+ */
+export class GetRecordsReq {
+    /**
+     * @param page: number  页码
+     * @param pageSize: number  每页数量，默认1-100
+     * @param month: string  月份筛选 YYYY-MM
+     * @param mode: Mode  打卡模式筛选
+     */
+    constructor(page,pageSize,month,mode,) {
+        this.page = page;
+        this.pageSize = pageSize;
+        this.month = month;
+        this.mode = mode;
+        
+    }
+    static fromObject(o) {
+        return new GetRecordsReq(o.page,o.pageSize,o.month,o.mode,);
+    }
+}
+
+/**
+ * 获取记录列表响应
+ */
+export class GetRecordsResp {
+    /**
+     * @param list: Array<Record>  分页数据
+     */
+    constructor(list,) {
+        this.list = list;
+        
+    }
+    static fromObject(o) {
+        return new GetRecordsResp(o.list,);
+    }
+}
+
+/**
+ * 获取单条记录详情请求
+ */
+export class GetRecordDetailReq {
+    /**
+     * @param id: string|number  记录ID
+     */
+    constructor(id,) {
+        this.id = id;
+        
+    }
+    static fromObject(o) {
+        return new GetRecordDetailReq(o.id,);
+    }
+}
+
+/**
+ * 获取单条记录详情响应
+ */
+export class GetRecordDetailResp {
+    /**
+     * @param data: Record  记录详情
+     */
+    constructor(data,) {
+        this.data = data;
+        
+    }
+    static fromObject(o) {
+        return new GetRecordDetailResp(o.data,);
+    }
+}
+
+/**
+ * 删除记录请求
+ */
+export class DeleteRecordReq {
+    /**
+     * @param id: string|number  记录ID
+     */
+    constructor(id,) {
+        this.id = id;
+        
+    }
+    static fromObject(o) {
+        return new DeleteRecordReq(o.id,);
+    }
+}
+
+/**
+ * 删除记录响应
+ */
+export class DeleteRecordResp {
+    /**
+     */
+    constructor() {
+        
+    }
+    static fromObject(o) {
+        return new DeleteRecordResp();
+    }
+}
+
+/**
+ * 获取日历打卡数据请求
+ */
+export class GetCalendarReq {
+    /**
+     * @param year: number  年份
+     * @param month: number  月份(1-12)
+     */
+    constructor(year,month,) {
+        this.year = year;
+        this.month = month;
+        
+    }
+    static fromObject(o) {
+        return new GetCalendarReq(o.year,o.month,);
+    }
+}
+
+/**
+ * 日历打卡数据
+ */
+export class CalendarData {
+    /**
+     * @param year: number  年份
+     * @param month: number  月份
+     * @param days: Array<CalendarDayData>  每天的打卡数据，null表示当天无记录
+     */
+    constructor(year,month,days,) {
+        this.year = year;
+        this.month = month;
+        this.days = days;
+        
+    }
+    static fromObject(o) {
+        return new CalendarData(o.year,o.month,o.days,);
+    }
+}
+
+/**
+ * 日历单日打卡数据
+ */
+export class CalendarDayData {
+    /**
+     * @param date: string  日期YYYY-MM-DD
+     * @param hasRecord: boolean  是否有记录
+     * @param mode: Mode  打卡模式
+     * @param standardCupsTotal: number  标准杯总数
+     */
+    constructor(date,hasRecord,mode,standardCupsTotal,) {
+        this.date = date;
+        this.hasRecord = hasRecord;
+        this.mode = mode;
+        this.standardCupsTotal = standardCupsTotal;
+        
+    }
+    static fromObject(o) {
+        return new CalendarDayData(o.date,o.hasRecord,o.mode,o.standardCupsTotal,);
+    }
+}
+
+/**
+ * 获取日历打卡数据响应
+ */
+export class GetCalendarResp {
+    /**
+     * @param data: CalendarData  日历数据
+     */
+    constructor(data,) {
+        this.data = data;
+        
+    }
+    static fromObject(o) {
+        return new GetCalendarResp(o.data,);
+    }
+}
+
+/**
+ * 用户统计概览数据
+ */
+export class StatsOverview {
+    /**
+     * @param weekDrinkCount: number  本周饮酒天数
+     * @param weekCups: number  本周标准杯总数
+     * @param monthDrinkCount: number  本月饮酒天数
+     * @param monthCups: number  本月标准杯总数
+     * @param streak: number  当前连续打卡天数
+     * @param streakType: Mode  连续类型
+     * @param totalDays: number  总饮酒天数（去重）
+     * @param totalRecords: number  总记录数
+     * @param totalCups: number  历史累计标准杯
+     * @param favCategory: Category  最爱酒类ID
+     * @param categoryVariety: number  尝试过的酒类品种数
+     */
+    constructor(weekDrinkCount,weekCups,monthDrinkCount,monthCups,streak,streakType,totalDays,totalRecords,totalCups,favCategory,categoryVariety,) {
+        this.weekDrinkCount = weekDrinkCount;
+        this.weekCups = weekCups;
+        this.monthDrinkCount = monthDrinkCount;
+        this.monthCups = monthCups;
+        this.streak = streak;
+        this.streakType = streakType;
+        this.totalDays = totalDays;
+        this.totalRecords = totalRecords;
+        this.totalCups = totalCups;
+        this.favCategory = favCategory;
+        this.categoryVariety = categoryVariety;
+        
+    }
+    static fromObject(o) {
+        return new StatsOverview(o.weekDrinkCount,o.weekCups,o.monthDrinkCount,o.monthCups,o.streak,o.streakType,o.totalDays,o.totalRecords,o.totalCups,o.favCategory,o.categoryVariety,);
+    }
+}
+
+/**
+ * 获取用户统计概览响应
+ */
+export class GetStatsOverviewResp {
+    /**
+     * @param data: StatsOverview  统计概览数据
+     */
+    constructor(data,) {
+        this.data = data;
+        
+    }
+    static fromObject(o) {
+        return new GetStatsOverviewResp(o.data,);
+    }
+}
+
+/**
+ * 获取月度统计请求
+ */
+export class GetMonthlyStatsReq {
+    /**
+     * @param year: number  年份，默认当前年
+     * @param month: number  月份，默认当前月
+     */
+    constructor(year,month,) {
+        this.year = year;
+        this.month = month;
+        
+    }
+    static fromObject(o) {
+        return new GetMonthlyStatsReq(o.year,o.month,);
+    }
+}
+
+/**
+ * 月度统计数据
+ */
+export class MonthlyStats {
+    /**
+     * @param year: number  年份
+     * @param month: number  月份
+     * @param drinkDays: number  饮酒天数
+     * @param abstainDays: number  戒酒天数
+     * @param totalCups: number  总标准杯数
+     * @param avgCupsPerDay: number  日均标准杯数
+     * @param categoryBreakdown: Array<CategoryBreakdown>  酒类分布
+     * @param feelingBreakdown: Array<FeelingBreakdown>  感受分布
+     * @param foodBreakdown: Array<FoodBreakdown>  配餐分布
+     */
+    constructor(year,month,drinkDays,abstainDays,totalCups,avgCupsPerDay,categoryBreakdown,feelingBreakdown,foodBreakdown,) {
+        this.year = year;
+        this.month = month;
+        this.drinkDays = drinkDays;
+        this.abstainDays = abstainDays;
+        this.totalCups = totalCups;
+        this.avgCupsPerDay = avgCupsPerDay;
+        this.categoryBreakdown = categoryBreakdown;
+        this.feelingBreakdown = feelingBreakdown;
+        this.foodBreakdown = foodBreakdown;
+        
+    }
+    static fromObject(o) {
+        return new MonthlyStats(o.year,o.month,o.drinkDays,o.abstainDays,o.totalCups,o.avgCupsPerDay,o.categoryBreakdown,o.feelingBreakdown,o.foodBreakdown,);
+    }
+}
+
+/**
+ * 酒类分布统计项
+ */
+export class CategoryBreakdown {
+    /**
+     * @param category: Category  酒类分类
+     * @param count: number  次数
+     * @param cups: number  标准杯数
+     */
+    constructor(category,count,cups,) {
+        this.category = category;
+        this.count = count;
+        this.cups = cups;
+        
+    }
+    static fromObject(o) {
+        return new CategoryBreakdown(o.category,o.count,o.cups,);
+    }
+}
+
+/**
+ * 感受分布统计项
+ */
+export class FeelingBreakdown {
+    /**
+     * @param feeling: Feeling  感受类型
+     * @param count: number  次数
+     */
+    constructor(feeling,count,) {
+        this.feeling = feeling;
+        this.count = count;
+        
+    }
+    static fromObject(o) {
+        return new FeelingBreakdown(o.feeling,o.count,);
+    }
+}
+
+/**
+ * 配餐分布统计项
+ */
+export class FoodBreakdown {
+    /**
+     * @param category: FoodCategory  配餐分类
+     * @param count: number  次数
+     */
+    constructor(category,count,) {
+        this.category = category;
+        this.count = count;
+        
+    }
+    static fromObject(o) {
+        return new FoodBreakdown(o.category,o.count,);
+    }
+}
+
+/**
+ * 获取月度统计响应
+ */
+export class GetMonthlyStatsResp {
+    /**
+     * @param data: MonthlyStats  月度统计数据
+     */
+    constructor(data,) {
+        this.data = data;
+        
+    }
+    static fromObject(o) {
+        return new GetMonthlyStatsResp(o.data,);
+    }
+}
+
+/**
+ * 酒类分布统计项
+ */
+export class CategoryStats {
+    /**
+     * @param id: Category  酒类分类ID
+     * @param name: string  酒类名称
+     * @param recordCount: number  记录次数
+     * @param totalCups: number  总标准杯数
+     * @param percentage: number  占比（百分比）
+     */
+    constructor(id,name,recordCount,totalCups,percentage,) {
+        this.id = id;
+        this.name = name;
+        this.recordCount = recordCount;
+        this.totalCups = totalCups;
+        this.percentage = percentage;
+        
+    }
+    static fromObject(o) {
+        return new CategoryStats(o.id,o.name,o.recordCount,o.totalCups,o.percentage,);
+    }
+}
+
+/**
+ * 
+ */
+export class GetStatsOverviewReq {
+    /**
+     */
+    constructor() {
+        
+    }
+    static fromObject(o) {
+        return new GetStatsOverviewReq();
+    }
+}
+
+/**
+ * 
+ */
+export class GetCategoryStatsReq {
+    /**
+     */
+    constructor() {
+        
+    }
+    static fromObject(o) {
+        return new GetCategoryStatsReq();
+    }
+}
+
+/**
+ * 获取酒类分布统计响应
+ */
+export class GetCategoryStatsResp {
+    /**
+     * @param data: CategoryStatsData  酒类分布统计数据
+     */
+    constructor(data,) {
+        this.data = data;
+        
+    }
+    static fromObject(o) {
+        return new GetCategoryStatsResp(o.data,);
+    }
+}
+
+/**
+ * 酒类分布统计数据
+ */
+export class CategoryStatsData {
+    /**
+     * @param categories: Array<CategoryStats>  酒类分布列表
+     */
+    constructor(categories,) {
+        this.categories = categories;
+        
+    }
+    static fromObject(o) {
+        return new CategoryStatsData(o.categories,);
+    }
+}
+
+/**
+ * 用户信息
+ */
+export class User {
+    /**
+     * @param id: string|number  用户ID
+     * @param nickname: string  用户昵称
+     * @param avatar: string  头像URL
+     * @param joinedAt: string  加入时间
+     * @param preferences: UserPreferences  用户偏好
+     */
+    constructor(id,nickname,avatar,joinedAt,preferences,) {
+        this.id = id;
+        this.nickname = nickname;
+        this.avatar = avatar;
+        this.joinedAt = joinedAt;
+        this.preferences = preferences;
+        
+    }
+    static fromObject(o) {
+        return new User(o.id,o.nickname,o.avatar,o.joinedAt,o.preferences,);
+    }
+}
+
+/**
+ * 用户偏好设置
+ */
+export class UserPreferences {
+    /**
+     * @param favoriteCategories: Array<Category>  偏好酒类ID列表
+     * @param frequency: Frequency  饮酒频率
+     */
+    constructor(favoriteCategories,frequency,) {
+        this.favoriteCategories = favoriteCategories;
+        this.frequency = frequency;
+        
+    }
+    static fromObject(o) {
+        return new UserPreferences(o.favoriteCategories,o.frequency,);
+    }
+}
+
+/**
+ * 获取用户信息请求
+ */
+export class GetUserProfileReq {
+    /**
+     */
+    constructor() {
+        
+    }
+    static fromObject(o) {
+        return new GetUserProfileReq();
+    }
+}
+
+/**
+ * 获取用户信息响应
+ */
+export class GetUserProfileResp {
+    /**
+     * @param id: string|number  用户ID
+     * @param nickname: string  用户昵称
+     * @param avatar: string  头像URL
+     * @param joinedAt: string  加入时间
+     * @param preferences: UserPreferences  用户偏好
+     */
+    constructor(id,nickname,avatar,joinedAt,preferences,) {
+        this.id = id;
+        this.nickname = nickname;
+        this.avatar = avatar;
+        this.joinedAt = joinedAt;
+        this.preferences = preferences;
+        
+    }
+    static fromObject(o) {
+        return new GetUserProfileResp(o.id,o.nickname,o.avatar,o.joinedAt,o.preferences,);
+    }
+}
+
+/**
+ * 更新用户偏好请求
+ */
+export class UpdatePreferencesReq {
+    /**
+     * @param favoriteCategories: Array<Category>  偏好酒类ID列表
+     * @param frequency: Frequency  饮酒频率
+     */
+    constructor(favoriteCategories,frequency,) {
+        this.favoriteCategories = favoriteCategories;
+        this.frequency = frequency;
+        
+    }
+    static fromObject(o) {
+        return new UpdatePreferencesReq(o.favoriteCategories,o.frequency,);
+    }
+}
+
+/**
+ * 更新用户偏好响应
+ */
+export class UpdatePreferencesResp {
+    /**
+     * @param favoriteCategories: Array<Category>  偏好酒类ID列表
+     * @param frequency: Frequency  饮酒频率
+     */
+    constructor(favoriteCategories,frequency,) {
+        this.favoriteCategories = favoriteCategories;
+        this.frequency = frequency;
+        
+    }
+    static fromObject(o) {
+        return new UpdatePreferencesResp(o.favoriteCategories,o.frequency,);
+    }
+}
+
+/**
+ * 上传图片参数
+ */
+export class UploadImageReq {
+    /**
+     * @param image: any  图片
+     */
+    constructor(image,) {
+        this.image = image;
+        
+    }
+    static fromObject(o) {
+        return new UploadImageReq(o.image,);
+    }
+}
+
+/**
+ * 上传图片返回
+ */
+export class UploadImageResp {
+    /**
+     * @param id: string|number  图片 id
+     * @param url: string  图片 url
+     */
+    constructor(id,url,) {
+        this.id = id;
+        this.url = url;
+        
+    }
+    static fromObject(o) {
+        return new UploadImageResp(o.id,o.url,);
+    }
+}
+
+/**
+ * 引用文件参数
+ */
+export class ReferenceFileReq {
+    /**
+     * @param project: string  项目名称
+     * @param module: string  模块名称
+     * @param data: number  数据 id
+     * @param urls: Array<string>  文件 urls
+     */
+    constructor(project,module,data,urls,) {
+        this.project = project;
+        this.module = module;
+        this.data = data;
+        this.urls = urls;
+        
+    }
+    static fromObject(o) {
+        return new ReferenceFileReq(o.project,o.module,o.data,o.urls,);
+    }
+}
+
+/**
+ * 引用文件返回
+ */
+export class ReferenceFileResp {
+    /**
+     * @param ok: boolean  是否成功
+     */
+    constructor(ok,) {
+        this.ok = ok;
+        
+    }
+    static fromObject(o) {
+        return new ReferenceFileResp(o.ok,);
+    }
+}
+
+/**
+ * 取消引用文件参数
+ */
+export class DereferenceFileReq {
+    /**
+     * @param module: string  模块
+     * @param data: number  数据 id
+     * @param urls: Array<string>  文件 urls
+     */
+    constructor(module,data,urls,) {
+        this.module = module;
+        this.data = data;
+        this.urls = urls;
+        
+    }
+    static fromObject(o) {
+        return new DereferenceFileReq(o.module,o.data,o.urls,);
+    }
+}
+
+/**
+ * 取消引用文件返回
+ */
+export class DereferenceFileResp {
+    /**
+     * @param ok: boolean  是否成功
+     */
+    constructor(ok,) {
+        this.ok = ok;
+        
+    }
+    static fromObject(o) {
+        return new DereferenceFileResp(o.ok,);
+    }
+}
+
+/**
+ * 删除数据参数
+ */
+export class DeleteDataReq {
+    /**
+     * @param module: string  模块
+     * @param data: number  数据 id
+     */
+    constructor(module,data,) {
+        this.module = module;
+        this.data = data;
+        
+    }
+    static fromObject(o) {
+        return new DeleteDataReq(o.module,o.data,);
+    }
+}
+
+/**
+ * 删除数据返回
+ */
+export class DeleteDataResp {
+    /**
+     * @param ok: boolean  是否成功
+     */
+    constructor(ok,) {
+        this.ok = ok;
+        
+    }
+    static fromObject(o) {
+        return new DeleteDataResp(o.ok,);
+    }
+}
+
+
+/**
+ * * 喝酒了么 - 后端接口 API
+ * 小程序：喝酒了么（uni-app 微信小程序）
+ * 基础URL: /api/v1
+ * 
+ * 主要功能模块：
+ * 1. 用户模块 - 微信登录、用户信息管理
+ * 2. 打卡记录模块 - 饮酒记录创建、查询、日历数据
+ * 3. 照片上传模块 - 单张/批量照片上传
+ * 4. 统计模块 - 用户统计、月度统计、酒类分布
+ * 5. 成就模块 - 成就列表和进度
+ * 6. 社交模块 - 朋友圈动态、点赞
+ */
+export default class HaveADrink {
+    constructor(conf) {
+        this.host = conf.host;
+        this.http_request = conf.http_request;
+        this.upload = conf.upload;
+        this.token = conf.token;
+    }
+
+    /**
+     * 设置 token
+     */
+    setToken(token) {
+        this.token = token;
+    }
+
+    /**
+    * 微信登录, 获取openid、unionid、token
+    */
+    WechatLogin(req) {
+        return new Promise((reslove, reject)=>{
+            let data = req;
+            let url = `${this.host}/api/have_a_drink/v1/auth/wechat/login`;
+            
+            
+            this.http_request(url, {
+                uri: '/api/have_a_drink/v1/auth/wechat/login',
+                method: 'POST',
+                data: data,
+                responseType: 'json',
+                headers: { 
+                    'Content-Type': 'application/json',
+                },
+            }).then((data)=>{
+                if (data.hasOwnProperty("fail")) {
+                    if (data.fail) {
+                        reject(data.msg);
+                    } else {
+                        reslove(data.data);
+                    }
+                } else {
+                    reslove(data);
+                }
+            }).catch((err)=>reject(err));
+            
+        });
+    }
+    
+    /**
+    * 获取微信手机号
+    */
+    WechatGetPhoneNumber(req) {
+        return new Promise((reslove, reject)=>{
+            let data = req;
+            let url = `${this.host}/api/have_a_drink/v1/auth/wechat/get_phone_number`;
+            
+            
+            this.http_request(url, {
+                uri: '/api/have_a_drink/v1/auth/wechat/get_phone_number',
+                method: 'POST',
+                data: data,
+                responseType: 'json',
+                headers: { 
+                    'Content-Type': 'application/json',
+                },
+            }).then((data)=>{
+                if (data.hasOwnProperty("fail")) {
+                    if (data.fail) {
+                        reject(data.msg);
+                    } else {
+                        reslove(data.data);
+                    }
+                } else {
+                    reslove(data);
+                }
+            }).catch((err)=>reject(err));
+            
+        });
+    }
+    
+    /**
+    * 刷新 token 接口
+    */
+    RefreshToken(req) {
+        return new Promise((reslove, reject)=>{
+            let data = req;
+            let url = `${this.host}/api/have_a_drink/v1/auth/refresh_token`;
+            
+            
+            this.http_request(url, {
+                uri: '/api/have_a_drink/v1/auth/refresh_token',
+                method: 'POST',
+                data: data,
+                responseType: 'json',
+                headers: { 
+                    'Content-Type': 'application/json',
+                },
+            }).then((data)=>{
+                if (data.hasOwnProperty("fail")) {
+                    if (data.fail) {
+                        reject(data.msg);
+                    } else {
+                        reslove(data.data);
+                    }
+                } else {
+                    reslove(data);
+                }
+            }).catch((err)=>reject(err));
+            
+        });
+    }
+    
+    /**
+    * 获取成就列表
+    */
+    GetAchievements(req) {
+        return new Promise((reslove, reject)=>{
+            let data = req;
+            let url = `${this.host}/api/have_a_drink/v1/achievements/list`;
+            const query = Object.keys(data).map((x)=>(`${x}=${data[x]}`)).join('&');
+            
+            this.http_request(url, {
+                uri: '/api/have_a_drink/v1/achievements/list',
+                method: 'GET',
+                query: query,
+                data: data,
+                responseType: 'json',
+                headers: { 
+                },
+            }).then((data)=>{
+                if (data.hasOwnProperty("fail")) {
+                    if (data.fail) {
+                        reject(data.msg);
+                    } else {
+                        reslove(data.data);
+                    }
+                } else {
+                    reslove(data);
+                }
+            }).catch((err)=>reject(err));
+            
+        });
+    }
+    
+    /**
+    * 获取朋友圈动态
+    */
+    GetFeed(req) {
+        return new Promise((reslove, reject)=>{
+            let data = req;
+            let url = `${this.host}/api/have_a_drink/v1/communication/feed`;
+            const query = Object.keys(data).map((x)=>(`${x}=${data[x]}`)).join('&');
+            
+            this.http_request(url, {
+                uri: '/api/have_a_drink/v1/communication/feed',
+                method: 'GET',
+                query: query,
+                data: data,
+                responseType: 'json',
+                headers: { 
+                },
+            }).then((data)=>{
+                if (data.hasOwnProperty("fail")) {
+                    if (data.fail) {
+                        reject(data.msg);
+                    } else {
+                        reslove(data.data);
+                    }
+                } else {
+                    reslove(data);
+                }
+            }).catch((err)=>reject(err));
+            
+        });
+    }
+    
+    /**
+    * 点赞
+    */
+    LikeRecord(req) {
+        return new Promise((reslove, reject)=>{
+            let data = req;
+            let url = `${this.host}/api/have_a_drink/v1/communication/records/like`;
+            
+            
+            this.http_request(url, {
+                uri: '/api/have_a_drink/v1/communication/records/like',
+                method: 'POST',
+                data: data,
+                responseType: 'json',
+                headers: { 
+                    'Content-Type': 'application/json',
+                },
+            }).then((data)=>{
+                if (data.hasOwnProperty("fail")) {
+                    if (data.fail) {
+                        reject(data.msg);
+                    } else {
+                        reslove(data.data);
+                    }
+                } else {
+                    reslove(data);
+                }
+            }).catch((err)=>reject(err));
+            
+        });
+    }
+    
+    /**
+    * 取消点赞
+    */
+    UnlikeRecord(req) {
+        return new Promise((reslove, reject)=>{
+            let data = req;
+            let url = `${this.host}/api/have_a_drink/v1/communication/records/unlike`;
+            
+            
+            this.http_request(url, {
+                uri: '/api/have_a_drink/v1/communication/records/unlike',
+                method: 'POST',
+                data: data,
+                responseType: 'json',
+                headers: { 
+                    'Content-Type': 'application/json',
+                },
+            }).then((data)=>{
+                if (data.hasOwnProperty("fail")) {
+                    if (data.fail) {
+                        reject(data.msg);
+                    } else {
+                        reslove(data.data);
+                    }
+                } else {
+                    reslove(data);
+                }
+            }).catch((err)=>reject(err));
+            
+        });
+    }
+    
+    /**
+    * 上传照片
+    */
+    UploadPhoto(req) {
+        return new Promise((reslove, reject)=>{
+            let data = req;
+            let url = `${this.host}/api/have_a_drink/v1/photo/upload/photo`;
+            
+            
+            this.http_request(url, {
+                uri: '/api/have_a_drink/v1/photo/upload/photo',
+                method: 'POST',
+                data: data,
+                responseType: 'json',
+                headers: { 
+                    'Content-Type': 'application/json',
+                },
+            }).then((data)=>{
+                if (data.hasOwnProperty("fail")) {
+                    if (data.fail) {
+                        reject(data.msg);
+                    } else {
+                        reslove(data.data);
+                    }
+                } else {
+                    reslove(data);
+                }
+            }).catch((err)=>reject(err));
+            
+        });
+    }
+    
+    /**
+    * 批量上传照片
+    */
+    UploadPhotos(req) {
+        return new Promise((reslove, reject)=>{
+            let data = req;
+            let url = `${this.host}/api/have_a_drink/v1/photo/upload/photos`;
+            
+            
+            this.http_request(url, {
+                uri: '/api/have_a_drink/v1/photo/upload/photos',
+                method: 'POST',
+                data: data,
+                responseType: 'json',
+                headers: { 
+                    'Content-Type': 'application/json',
+                },
+            }).then((data)=>{
+                if (data.hasOwnProperty("fail")) {
+                    if (data.fail) {
+                        reject(data.msg);
+                    } else {
+                        reslove(data.data);
+                    }
+                } else {
+                    reslove(data);
+                }
+            }).catch((err)=>reject(err));
+            
+        });
+    }
+    
+    /**
+    * 创建打卡记录
+    */
+    CreateRecord(req) {
+        return new Promise((reslove, reject)=>{
+            let data = req;
+            let url = `${this.host}/api/have_a_drink/v1/record/records`;
+            
+            
+            this.http_request(url, {
+                uri: '/api/have_a_drink/v1/record/records',
+                method: 'POST',
+                data: data,
+                responseType: 'json',
+                headers: { 
+                    'Content-Type': 'application/json',
+                },
+            }).then((data)=>{
+                if (data.hasOwnProperty("fail")) {
+                    if (data.fail) {
+                        reject(data.msg);
+                    } else {
+                        reslove(data.data);
+                    }
+                } else {
+                    reslove(data);
+                }
+            }).catch((err)=>reject(err));
+            
+        });
+    }
+    
+    /**
+    * 获取记录列表
+    */
+    GetRecords(req) {
+        return new Promise((reslove, reject)=>{
+            let data = req;
+            let url = `${this.host}/api/have_a_drink/v1/record/records`;
+            const query = Object.keys(data).map((x)=>(`${x}=${data[x]}`)).join('&');
+            
+            this.http_request(url, {
+                uri: '/api/have_a_drink/v1/record/records',
+                method: 'GET',
+                query: query,
+                data: data,
+                responseType: 'json',
+                headers: { 
+                },
+            }).then((data)=>{
+                if (data.hasOwnProperty("fail")) {
+                    if (data.fail) {
+                        reject(data.msg);
+                    } else {
+                        reslove(data.data);
+                    }
+                } else {
+                    reslove(data);
+                }
+            }).catch((err)=>reject(err));
+            
+        });
+    }
+    
+    /**
+    * 获取单条记录详情
+    */
+    GetRecordDetail(req) {
+        return new Promise((reslove, reject)=>{
+            let data = req;
+            let url = `${this.host}/api/have_a_drink/v1/record/records/detail`;
+            const query = Object.keys(data).map((x)=>(`${x}=${data[x]}`)).join('&');
+            
+            this.http_request(url, {
+                uri: '/api/have_a_drink/v1/record/records/detail',
+                method: 'GET',
+                query: query,
+                data: data,
+                responseType: 'json',
+                headers: { 
+                },
+            }).then((data)=>{
+                if (data.hasOwnProperty("fail")) {
+                    if (data.fail) {
+                        reject(data.msg);
+                    } else {
+                        reslove(data.data);
+                    }
+                } else {
+                    reslove(data);
+                }
+            }).catch((err)=>reject(err));
+            
+        });
+    }
+    
+    /**
+    * 删除记录
+    */
+    DeleteRecord(req) {
+        return new Promise((reslove, reject)=>{
+            let data = req;
+            let url = `${this.host}/api/have_a_drink/v1/record/records`;
+            
+            
+            this.http_request(url, {
+                uri: '/api/have_a_drink/v1/record/records',
+                method: 'DELETE',
+                data: data,
+                responseType: 'json',
+                headers: { 
+                    'Content-Type': 'application/json',
+                },
+            }).then((data)=>{
+                if (data.hasOwnProperty("fail")) {
+                    if (data.fail) {
+                        reject(data.msg);
+                    } else {
+                        reslove(data.data);
+                    }
+                } else {
+                    reslove(data);
+                }
+            }).catch((err)=>reject(err));
+            
+        });
+    }
+    
+    /**
+    * 获取日历打卡数据
+    */
+    GetCalendar(req) {
+        return new Promise((reslove, reject)=>{
+            let data = req;
+            let url = `${this.host}/api/have_a_drink/v1/record/records/calendar`;
+            const query = Object.keys(data).map((x)=>(`${x}=${data[x]}`)).join('&');
+            
+            this.http_request(url, {
+                uri: '/api/have_a_drink/v1/record/records/calendar',
+                method: 'GET',
+                query: query,
+                data: data,
+                responseType: 'json',
+                headers: { 
+                },
+            }).then((data)=>{
+                if (data.hasOwnProperty("fail")) {
+                    if (data.fail) {
+                        reject(data.msg);
+                    } else {
+                        reslove(data.data);
+                    }
+                } else {
+                    reslove(data);
+                }
+            }).catch((err)=>reject(err));
+            
+        });
+    }
+    
+    /**
+    * 获取用户统计概览
+    */
+    GetStatsOverview(req) {
+        return new Promise((reslove, reject)=>{
+            let data = req;
+            let url = `${this.host}/api/have_a_drink/v1/statistics/overview`;
+            const query = Object.keys(data).map((x)=>(`${x}=${data[x]}`)).join('&');
+            
+            this.http_request(url, {
+                uri: '/api/have_a_drink/v1/statistics/overview',
+                method: 'GET',
+                query: query,
+                data: data,
+                responseType: 'json',
+                headers: { 
+                },
+            }).then((data)=>{
+                if (data.hasOwnProperty("fail")) {
+                    if (data.fail) {
+                        reject(data.msg);
+                    } else {
+                        reslove(data.data);
+                    }
+                } else {
+                    reslove(data);
+                }
+            }).catch((err)=>reject(err));
+            
+        });
+    }
+    
+    /**
+    * 获取月度统计
+    */
+    GetMonthlyStats(req) {
+        return new Promise((reslove, reject)=>{
+            let data = req;
+            let url = `${this.host}/api/have_a_drink/v1/statistics/monthly`;
+            const query = Object.keys(data).map((x)=>(`${x}=${data[x]}`)).join('&');
+            
+            this.http_request(url, {
+                uri: '/api/have_a_drink/v1/statistics/monthly',
+                method: 'GET',
+                query: query,
+                data: data,
+                responseType: 'json',
+                headers: { 
+                },
+            }).then((data)=>{
+                if (data.hasOwnProperty("fail")) {
+                    if (data.fail) {
+                        reject(data.msg);
+                    } else {
+                        reslove(data.data);
+                    }
+                } else {
+                    reslove(data);
+                }
+            }).catch((err)=>reject(err));
+            
+        });
+    }
+    
+    /**
+    * 获取酒类分布统计
+    */
+    GetCategoryStats(req) {
+        return new Promise((reslove, reject)=>{
+            let data = req;
+            let url = `${this.host}/api/have_a_drink/v1/statistics/categories`;
+            const query = Object.keys(data).map((x)=>(`${x}=${data[x]}`)).join('&');
+            
+            this.http_request(url, {
+                uri: '/api/have_a_drink/v1/statistics/categories',
+                method: 'GET',
+                query: query,
+                data: data,
+                responseType: 'json',
+                headers: { 
+                },
+            }).then((data)=>{
+                if (data.hasOwnProperty("fail")) {
+                    if (data.fail) {
+                        reject(data.msg);
+                    } else {
+                        reslove(data.data);
+                    }
+                } else {
+                    reslove(data);
+                }
+            }).catch((err)=>reject(err));
+            
+        });
+    }
+    
+    /**
+    * 获取用户信息
+    */
+    GetUserProfile(req) {
+        return new Promise((reslove, reject)=>{
+            let data = req;
+            let url = `${this.host}/api/have_a_drink/v1/user/user/profile`;
+            const query = Object.keys(data).map((x)=>(`${x}=${data[x]}`)).join('&');
+            
+            this.http_request(url, {
+                uri: '/api/have_a_drink/v1/user/user/profile',
+                method: 'GET',
+                query: query,
+                data: data,
+                responseType: 'json',
+                headers: { 
+                },
+            }).then((data)=>{
+                if (data.hasOwnProperty("fail")) {
+                    if (data.fail) {
+                        reject(data.msg);
+                    } else {
+                        reslove(data.data);
+                    }
+                } else {
+                    reslove(data);
+                }
+            }).catch((err)=>reject(err));
+            
+        });
+    }
+    
+    /**
+    * 更新用户偏好
+    */
+    UpdatePreferences(req) {
+        return new Promise((reslove, reject)=>{
+            let data = req;
+            let url = `${this.host}/api/have_a_drink/v1/user/user/preferences`;
+            
+            
+            this.http_request(url, {
+                uri: '/api/have_a_drink/v1/user/user/preferences',
+                method: 'PUT',
+                data: data,
+                responseType: 'json',
+                headers: { 
+                    'Content-Type': 'application/json',
+                },
+            }).then((data)=>{
+                if (data.hasOwnProperty("fail")) {
+                    if (data.fail) {
+                        reject(data.msg);
+                    } else {
+                        reslove(data.data);
+                    }
+                } else {
+                    reslove(data);
+                }
+            }).catch((err)=>reject(err));
+            
+        });
+    }
+    
+    /**
+    * 上传文件
+    */
+    UploadImage(req) {
+        return new Promise((reslove, reject)=>{
+            let data = req;
+            let url = `${this.host}/api/have_a_drink/v1/upload/image`;
+            
+            
+            this.upload(url, {
+                uri: '/api/have_a_drink/v1/upload/image',
+                method: 'POST',
+                data: data,
+            }).then((data)=>{
+                if (data.hasOwnProperty("fail")) {
+                    if (data.fail) {
+                        reject(data.msg);
+                    } else {
+                        reslove(data.data);
+                    }
+                } else {
+                    reslove(data.data);
+                }
+            }).catch((err)=>reject(err));
+            
+        });
+    }
+    
+}
diff --git a/node_modules/HaveADrink/package.json b/node_modules/HaveADrink/package.json
new file mode 100644
index 0000000..7e8edbe
--- /dev/null
+++ b/node_modules/HaveADrink/package.json
@@ -0,0 +1,16 @@
+{
+  "name": "HaveADrink",
+  "type": "module",
+  "version": "v1.0.2",
+  "description": "喝酒了么 API 服务",
+  "main": "index.js",
+  "scripts": {
+    "build": "tsc",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "author": "cuishu",
+  "license": "ISC",
+  "publishConfig": {
+    "registry": "https://npm.wash-painting.cn"
+  }
+}
\ No newline at end of file
diff --git a/package-lock.json b/package-lock.json
new file mode 100644
index 0000000..a114846
--- /dev/null
+++ b/package-lock.json
@@ -0,0 +1,18 @@
+{
+  "name": "hejiu",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "dependencies": {
+        "HaveADrink": "^1.0.2"
+      }
+    },
+    "node_modules/HaveADrink": {
+      "version": "1.0.2",
+      "resolved": "https://npm.wash-painting.cn/HaveADrink/-/HaveADrink-1.0.2.tgz",
+      "integrity": "sha512-rhcILwsr6F1SBK7z+C4HMemUHHd63pl5ggxHisky0ZDgCOL7bITf3TGgvoiqXRoAGe4qmV+4FT8E6oCbvD1PIg==",
+      "license": "ISC"
+    }
+  }
+}
diff --git a/package.json b/package.json
new file mode 100644
index 0000000..1771a26
--- /dev/null
+++ b/package.json
@@ -0,0 +1,5 @@
+{
+  "dependencies": {
+    "HaveADrink": "^1.0.2"
+  }
+}
diff --git a/pages.json b/pages.json
index 7f446cd..9be7938 100644
--- a/pages.json
+++ b/pages.json
@@ -52,7 +52,7 @@
 		"backgroundColorBottom": "#0B0B14"
 	},
 	"tabBar": {
-		"color": "#4A4A62",
+		"color": "#9494AC",
 		"selectedColor": "#E8A838",
 		"backgroundColor": "#151520",
 		"borderStyle": "black",
diff --git a/pages/card/card.vue b/pages/card/card.vue
index 1d82e14..8cd1f74 100644
--- a/pages/card/card.vue
+++ b/pages/card/card.vue
@@ -1,5 +1,5 @@
 <template>
-  <view class="page-container card-page">
+  <view :class="themeClass" class="page-container card-page">
     <view class="card-nav">
       <view class="step-back" @click="goBack">
         <text class="step-back-arrow">‹</text>
@@ -29,12 +29,16 @@
 
 <script>
 import DrinkCard from '../../components/DrinkCard.vue'
+import client from '../../common/api'
 import { getRecords } from '../../common/mock-data'
-import { DRINK_CATEGORIES, FOOD_CATEGORIES, DRINK_QUOTES } from '../../common/constants'
+import { getThemeColors, calcStandardCups, unitToMl } from '../../common/utils'
+import { DRINK_CATEGORIES, FOOD_CATEGORIES, DRINK_QUOTES, FEELINGS } from '../../common/constants'
+import themeMixin from '../../common/theme-mixin'
 
 const UNIT_NAMES = { ml: 'ml', liang: '两', bottle: '瓶', cup: '杯', can: '听', shot: 'shot' }
 
 export default {
+  mixins: [themeMixin],
   components: { DrinkCard },
   data() {
     return {
@@ -43,12 +47,57 @@ export default {
       saved: false
     }
   },
-  onLoad(options) {
-    const records = getRecords()
-    if (options && options.recordId) this.record = records.find(r => r.id === options.recordId)
-    if (!this.record) this.record = records.find(r => r.mode === 'drank') || this.fallback()
+  async onLoad(options) {
+    if (options && options.recordId) {
+      try {
+        const resp = await client.GetRecordDetail({ id: options.recordId })
+        const rec = resp.data || resp
+        if (rec) {
+          this.record = {
+            ...rec,
+            mode: String(rec.mode),
+            feeling: rec.feeling ? String(rec.feeling) : null,
+            visibility: rec.visibility ? String(rec.visibility) : 'private',
+            drinks: (rec.drinks || []).map(d => ({
+              ...d,
+              category: String(d.category),
+              unit: String(d.unit)
+            }))
+          }
+        }
+      } catch (e) {
+        console.warn('获取记录详情失败，降级本地:', e)
+      }
+    }
+    if (!this.record) this.record = this.loadLocalRecord(options.recordId) || this.fallback()
   },
   methods: {
+    loadLocalRecord(id) {
+      if (!id) return null
+      try {
+        const records = getRecords()
+        const found = records.find(r => r.id === id)
+        if (!found) return null
+        return {
+          ...found,
+          mode: String(found.mode || 'drank'),
+          feeling: found.feeling ? String(found.feeling) : null,
+          visibility: found.visibility ? String(found.visibility) : 'private',
+          drinks: (found.drinks || []).map(d => {
+            const ml = unitToMl(d.amount || 0, d.unit || 'ml')
+            return {
+              ...d,
+              category: String(d.category || d.categoryId || ''),
+              unit: String(d.unit || 'ml'),
+              standardCups: d.standardCups || calcStandardCups(ml, d.degree || 0)
+            }
+          })
+        }
+      } catch (e) {
+        console.warn('读取本地记录失败:', e)
+        return null
+      }
+    },
     fallback() {
       return {
         date: new Date().toISOString().slice(0, 10), mode: 'drank',
@@ -86,10 +135,11 @@ export default {
       const W = 750, H = 1600
       const rec = this.record
 
-      const WHITE = '#F2F2F2'
-      const SUB = '#7E7E96'
-      const DIM = '#4A4A62'
-      const AMBER = '#E8A838'
+      const colors = getThemeColors(this.currentTheme)
+      const WHITE = colors.textPrimary
+      const SUB = colors.textSecondary
+      const DIM = colors.textTertiary
+      const AMBER = colors.amber
       const F = '-apple-system, PingFang SC, Helvetica Neue, sans-serif'
 
       const cardW = W
@@ -116,12 +166,13 @@ export default {
       const drinks = rec.drinks || []
       const drinkH = drinks.length * 52
       const foodH = rec.food ? 52 : 0
-      const cardH = 48 + 56 + photoAreaH + 32 + drinkH + foodH + 16 + 40 + 36 + 56 + 80 + 40
+      const feelingH = rec.feeling ? 48 : 0
+      const cardH = 48 + 56 + photoAreaH + 32 + drinkH + foodH + feelingH + 16 + 40 + 36 + 56 + 80 + 40
 
       // 卡片背景渐变（填满整个画布）
       const grad = ctx.createLinearGradient(0, 0, cardW, cardY + cardH)
-      grad.addColorStop(0, '#1A1510')
-      grad.addColorStop(1, '#0D0B08')
+      grad.addColorStop(0, colors.cardGradStart)
+      grad.addColorStop(1, colors.cardGradEnd)
       ctx.setFillStyle(grad)
       ctx.fillRect(0, 0, W, cardH)
 
@@ -148,7 +199,7 @@ export default {
           if (imgs[0]) {
             try { ctx.drawImage(imgs[0], P, y, maxW, heroH) } catch (e) {}
           } else {
-            ctx.setFillStyle('rgba(255,255,255,0.03)')
+            ctx.setFillStyle(colors.bgPlaceholder)
             ctx.fillRect(P, y, maxW, heroH)
           }
           ctx.restore()
@@ -193,7 +244,7 @@ export default {
             if (imgs[i]) {
               try { ctx.drawImage(imgs[i], pos.x, pos.y, pos.w, pos.h) } catch (e) {}
             } else {
-              ctx.setFillStyle('rgba(255,255,255,0.03)')
+              ctx.setFillStyle(colors.bgPlaceholder)
               ctx.fillRect(pos.x, pos.y, pos.w, pos.h)
             }
             ctx.restore()
@@ -203,7 +254,7 @@ export default {
         // emoji 圆形
         const eR = 100
         const eCx = W / 2, eCy = y + eR
-        ctx.setFillStyle('rgba(232,168,56,0.08)')
+        ctx.setFillStyle(colors.emojiBg)
         ctx.beginPath()
         ctx.arc(eCx, eCy, eR, 0, Math.PI * 2)
         ctx.fill()
@@ -222,7 +273,7 @@ export default {
         const emoji = cat ? cat.emoji : '🥃'
         const name = `${emoji} ${d.brand}`
         const unitName = UNIT_NAMES[d.unit] || d.unit
-        const detail = `${d.amount}${unitName}·${d.standardCups}杯`
+        const detail = `${d.amount}${unitName}`
 
         ctx.font = `500 28px ${F}`
         ctx.setFillStyle(WHITE)
@@ -246,11 +297,24 @@ export default {
         y += 52
       }
 
+      // 饮酒感受
+      if (rec.feeling) {
+        const feeling = FEELINGS.find(f => f.id === rec.feeling)
+        if (feeling) {
+          y += 8
+          const feelingText = `${feeling.emoji} ${feeling.name}`
+          ctx.font = `500 26px ${F}`
+          ctx.setFillStyle(AMBER)
+          ctx.fillText(feelingText, P, y)
+          y += 40
+        }
+      }
+
       // 分割线（渐变）
       y += 16
       const lineGrad = ctx.createLinearGradient(P, y, W - P, y)
       lineGrad.addColorStop(0, 'transparent')
-      lineGrad.addColorStop(0.5, 'rgba(232,168,56,0.15)')
+      lineGrad.addColorStop(0.5, colors.borderSubtle)
       lineGrad.addColorStop(1, 'transparent')
       ctx.setStrokeStyle(lineGrad)
       ctx.setLineWidth(2)
@@ -290,10 +354,10 @@ export default {
       const qrSize = 80
       const qrX = W - P - qrSize
       const qrY = y - 30
-      ctx.setStrokeStyle('rgba(232,168,56,0.15)')
+      ctx.setStrokeStyle(colors.borderSubtle)
       ctx.setLineWidth(2)
       this.rr(ctx, qrX, qrY, qrSize, qrSize, 8, 'stroke')
-      ctx.setFillStyle('rgba(255,255,255,0.03)')
+      ctx.setFillStyle(colors.bgPlaceholder)
       this.rr(ctx, qrX, qrY, qrSize, qrSize, 8, 'fill')
 
       return new Promise(resolve => {
@@ -453,7 +517,7 @@ export default {
   border-radius: $radius-full;
   font-size: $fs-base;
   background: transparent;
-  border: 2rpx solid rgba(255, 255, 255, 0.1);
+  border: 2rpx solid var(--border-active, rgba(255, 255, 255, 0.12));
   color: $text-secondary;
   display: flex;
   align-items: center;
diff --git a/pages/index/index.vue b/pages/index/index.vue
index a886a4b..e454ac4 100644
--- a/pages/index/index.vue
+++ b/pages/index/index.vue
@@ -1,15 +1,11 @@
 <template>
-  <view class="page-container home">
+  <view :class="themeClass" class="page-container home">
     <!-- 顶部问候 -->
     <view class="greeting-bar" :style="{ paddingTop: statusBarHeight + 'px' }">
       <view class="greeting-left">
         <text class="greeting-text">{{ greeting }}，{{ userName }}</text>
         <text class="greeting-sub">今晚喝一杯？</text>
       </view>
-      <image v-if="userAvatar" class="avatar" :src="userAvatar" mode="aspectFill"></image>
-      <view v-else class="avatar avatar-placeholder">
-        <text class="avatar-placeholder-icon">👤</text>
-      </view>
     </view>
 
     <!-- 核心CTA - 首页最醒目位置 -->
@@ -121,11 +117,13 @@
 
 <script>
 import DrinkCalendar from '../../components/DrinkCalendar.vue'
-import { getRecords, getUserInfo } from '../../common/mock-data'
-import { calcStats, getGreeting, formatDate, getWeekStart } from '../../common/utils'
+import client from '../../common/api'
+import { getGreeting, formatDate, getWeekStart } from '../../common/utils'
 import { FEELINGS } from '../../common/constants'
+import themeMixin from '../../common/theme-mixin'
 
 export default {
+  mixins: [themeMixin],
   components: { DrinkCalendar },
   data() {
     const now = new Date()
@@ -138,7 +136,6 @@ export default {
       stats: {},
       greeting: '',
       userName: '',
-      userAvatar: '',
       showDayDetail: false,
       selectedDate: '',
       selectedRecord: null
@@ -167,17 +164,100 @@ export default {
     this.loadData()
   },
   methods: {
-    loadData() {
-      this.records = getRecords()
-      const user = getUserInfo()
-      this.userName = user.nickname || '酒友'
-      this.userAvatar = user.avatar || ''
+    async loadData() {
       this.greeting = getGreeting()
-      this.stats = calcStats(this.records)
+      // 并行加载用户信息、统计概览、记录列表
+      try {
+        const [userResp, statsResp, recordsResp] = await Promise.allSettled([
+          client.GetUserProfile({}),
+          client.GetStatsOverview({}),
+          client.GetRecords({ page: 1, pageSize: 100 })
+        ])
+
+        // 用户信息
+        if (userResp.status === 'fulfilled' && userResp.value) {
+          const user = userResp.value
+          this.userName = user.nickname || '酒友'
+          uni.setStorageSync('user_info', JSON.stringify(user))
+        } else {
+          // 降级读取本地缓存
+          try {
+            const cached = JSON.parse(uni.getStorageSync('user_info') || '{}')
+            this.userName = cached.nickname || '酒友'
+          } catch (e) {
+            this.userName = '酒友'
+          }
+        }
+
+        // 统计概览
+        if (statsResp.status === 'fulfilled' && statsResp.value) {
+          const s = statsResp.value.data || statsResp.value
+          this.stats = {
+            weekDrinkCount: s.weekDrinkCount || 0,
+            weekCups: s.weekCups || 0,
+            monthDrinkCount: s.monthDrinkCount || 0,
+            monthCups: s.monthCups || 0,
+            streak: s.streak || 0,
+            streakType: String(s.streakType || 'drank'),
+            totalDays: s.totalDays || 0,
+            totalRecords: s.totalRecords || 0,
+            totalCups: s.totalCups || 0,
+            favCategory: s.favCategory ? String(s.favCategory) : null,
+            categoryVariety: s.categoryVariety || 0
+          }
+        }
+
+        // 记录列表
+        if (recordsResp.status === 'fulfilled' && recordsResp.value) {
+          const list = recordsResp.value.list || recordsResp.value
+          this.records = Array.isArray(list) ? list.map(r => ({
+            ...r,
+            mode: String(r.mode),
+            feeling: r.feeling ? String(r.feeling) : null,
+            visibility: r.visibility ? String(r.visibility) : 'private',
+            drinks: (r.drinks || []).map(d => ({
+              ...d,
+              category: String(d.category),
+              unit: String(d.unit)
+            }))
+          })) : []
+        }
+      } catch (e) {
+        console.warn('加载首页数据失败:', e)
+        // 降级：读取本地缓存
+        try {
+          const cached = JSON.parse(uni.getStorageSync('user_info') || '{}')
+          this.userName = cached.nickname || '酒友'
+        } catch (err) {
+          this.userName = '酒友'
+        }
+      }
     },
     onMonthChange({ year, month }) {
       this.calendarYear = year
       this.calendarMonth = month
+      // 切换月份时重新加载记录
+      this.loadRecordsForMonth(year, month)
+    },
+    async loadRecordsForMonth(year, month) {
+      try {
+        const monthStr = `${year}-${String(month).padStart(2, '0')}`
+        const resp = await client.GetRecords({ page: 1, pageSize: 100, month: monthStr })
+        const list = resp.list || resp
+        this.records = Array.isArray(list) ? list.map(r => ({
+          ...r,
+          mode: String(r.mode),
+          feeling: r.feeling ? String(r.feeling) : null,
+          visibility: r.visibility ? String(r.visibility) : 'private',
+          drinks: (r.drinks || []).map(d => ({
+            ...d,
+            category: String(d.category),
+            unit: String(d.unit)
+          }))
+        })) : []
+      } catch (e) {
+        console.warn('加载月度记录失败:', e)
+      }
     },
     onDateSelect(dateStr) {
       this.selectedDate = dateStr
@@ -240,8 +320,7 @@ export default {
 
 .greeting-bar {
   display: flex;
-  justify-content: space-between;
-  align-items: center;
+  align-items: flex-start;
   padding: $sp-md 0 $sp-sm;
 }
 
@@ -249,6 +328,7 @@ export default {
   display: block;
   font-size:38rpx;
   font-weight: $fw-bold;
+  color: $text-primary;
 }
 
 .greeting-sub {
@@ -258,27 +338,6 @@ export default {
   margin-top: 4rpx;
 }
 
-.avatar {
-  width: 72rpx;
-  height: 72rpx;
-  border-radius: $radius-full;
-  border: 4rpx solid $amber-glow;
-  flex-shrink: 0;
-}
-
-.avatar-placeholder {
-  background: $bg-elevated;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  border: 4rpx dashed rgba(232,168,56,0.3);
-}
-
-.avatar-placeholder-icon {
-  font-size: 40rpx;
-  opacity: 0.5;
-}
-
 .calendar-section {
   margin-bottom: $sp-md;
   padding: $sp-md;
@@ -299,6 +358,7 @@ export default {
 .stat-value {
   display: block;
   font-size: $fs-xl;
+  color: $text-primary;
   margin-bottom: 4rpx;
 }
 
@@ -328,6 +388,7 @@ export default {
   display: block;
   font-size: $fs-xl;
   font-weight: $fw-bold;
+  color: $text-primary;
   margin-bottom: 4rpx;
 }
 
@@ -338,7 +399,7 @@ export default {
 
 .week-divider {
   width: 2rpx;
-  background: rgba(255,255,255,0.06);
+  background: var(--divider-color, rgba(255, 255, 255, 0.08));
   margin: $sp-xs 0;
 }
 
@@ -395,7 +456,7 @@ export default {
     left: -100%;
     width: 100%;
     height: 100%;
-    background: linear-gradient(90deg, transparent, rgba(255,255,255,0.12), transparent);
+    background: linear-gradient(90deg, transparent, var(--btn-shimmer, rgba(255, 255, 255, 0.15)), transparent);
     animation: shimmer 4s infinite;
   }
 }
@@ -458,7 +519,7 @@ export default {
   left: 0;
   right: 0;
   bottom: 0;
-  background: rgba(0,0,0,0.6);
+  background: var(--overlay-mask, rgba(0, 0, 0, 0.6));
   display: flex;
   align-items: flex-end;
   z-index: 100;
@@ -468,6 +529,7 @@ export default {
 .day-detail {
   width: 100%;
   padding: $sp-xl;
+  color: $text-primary;
   border-radius: $radius-xl $radius-xl 0 0;
 }
 
@@ -478,7 +540,8 @@ export default {
 .day-drink-item {
   padding: $sp-sm 0;
   font-size: $fs-base;
-  border-bottom: 2rpx solid rgba(255,255,255,0.04);
+  color: $text-primary;
+  border-bottom: 2rpx solid var(--border-micro, rgba(255, 255, 255, 0.05));
 }
 
 .day-meta {
@@ -510,6 +573,6 @@ export default {
   width: 100%;
   font-size: $fs-sm;
   color: $text-secondary;
-  border-color: rgba(255,255,255,0.1);
+  border-color: var(--border-active, rgba(255, 255, 255, 0.12));
 }
 </style>
diff --git a/pages/login/login.vue b/pages/login/login.vue
index a894bf7..c886e96 100644
--- a/pages/login/login.vue
+++ b/pages/login/login.vue
@@ -1,5 +1,5 @@
 <template>
-  <view class="page-container login-page">
+  <view :class="themeClass" class="page-container login-page">
     <!-- 顶部品牌区 -->
     <view class="brand-area">
       <view class="brand-glow"></view>
@@ -99,7 +99,11 @@
 </template>
 
 <script>
+import themeMixin from '../../common/theme-mixin'
+import client, { saveAuthTokens } from '../../common/api'
+
 export default {
+  mixins: [themeMixin],
   data() {
     return {
       showNotice: true,
@@ -138,29 +142,43 @@ export default {
       }
       this.loginLoading = true
       try {
-        // 获取微信登录code（用于后续服务端鉴权）
-        const loginRes = await this.wxLogin().catch(() => null)
+        // 1. 获取微信登录 code
+        const loginRes = await this.wxLogin()
+        if (!loginRes || !loginRes.code) {
+          throw new Error('获取微信code失败')
+        }
+        // 2. 调用后端微信登录接口
+        const loginParams = {
+          code: loginRes.code,
+          nickName: this.nickname.trim() || '',
+          avatarUrl: this.avatarUrl || ''
+        }
+        const resp = await client.WechatLogin(loginParams)
 
+        // 3. 保存 token 和用户信息
+        saveAuthTokens(resp)
+        if (resp.user) {
+          uni.setStorageSync('user_info', JSON.stringify(resp.user))
+        }
+        uni.setStorageSync('is_logged_in', 'true')
+        uni.setStorageSync('is_guest', 'false')
+        uni.setStorageSync('is_first_launch', 'false')
+
+        this.finishLogin()
+      } catch (e) {
+        console.warn('后端登录失败，降级为本地模式:', e)
+        uni.showToast({ title: e.msg || '登录失败，使用本地模式', icon: 'none', duration: 2000 })
+        // 降级为本地登录
         const userInfo = {
           id: `user_${Date.now()}`,
           nickname: this.nickname.trim() || '酒友',
           avatar: this.avatarUrl || '',
-          wxCode: (loginRes && loginRes.code) || '',
-          joinedAt: new Date().toISOString().slice(0, 10),
-          preferences: null
-        }
-        uni.setStorageSync('user_info', JSON.stringify(userInfo))
-        this.finishLogin()
-      } catch (e) {
-        console.warn('登录失败，降级为本地登录:', e)
-        const userInfo = {
-          id: `user_${Date.now()}`,
-          nickname: this.nickname.trim() || '酒友',
-          avatar: '',
           joinedAt: new Date().toISOString().slice(0, 10),
           preferences: null
         }
         uni.setStorageSync('user_info', JSON.stringify(userInfo))
+        uni.setStorageSync('is_logged_in', 'true')
+        uni.setStorageSync('is_first_launch', 'false')
         this.finishLogin()
       } finally {
         this.loginLoading = false
@@ -334,7 +352,7 @@ export default {
   align-items: center;
   justify-content: space-between;
   padding: $sp-sm 0;
-  border-bottom: 2rpx solid rgba(255,255,255,0.04);
+  border-bottom: 2rpx solid var(--border-micro, rgba(255, 255, 255, 0.05));
 }
 
 .avatar-btn {
@@ -432,7 +450,7 @@ export default {
 .login-divider-line {
   flex: 1;
   height: 2rpx;
-  background: rgba(255,255,255,0.06);
+  background: var(--bg-hover, rgba(255, 255, 255, 0.08));
 }
 
 .login-divider-text {
diff --git a/pages/onboarding/onboarding.vue b/pages/onboarding/onboarding.vue
index e4a5adc..3ac5dd0 100644
--- a/pages/onboarding/onboarding.vue
+++ b/pages/onboarding/onboarding.vue
@@ -1,5 +1,5 @@
 <template>
-  <view class="page-container onboarding">
+  <view :class="themeClass" class="page-container onboarding">
     <!-- 跳过按钮 -->
     <view class="skip-bar">
       <text class="btn-text" @click="goLogin">跳过</text>
@@ -63,7 +63,10 @@
 </template>
 
 <script>
+import themeMixin from '../../common/theme-mixin'
+
 export default {
+  mixins: [themeMixin],
   data() {
     return {
       currentSlide: 0,
diff --git a/pages/profile/profile.vue b/pages/profile/profile.vue
index 42e55c6..f6b4c98 100644
--- a/pages/profile/profile.vue
+++ b/pages/profile/profile.vue
@@ -1,5 +1,5 @@
 <template>
-  <view class="page-container profile-page safe-bottom">
+  <view :class="themeClass" class="page-container profile-page safe-bottom">
     <!-- 用户头部 -->
     <view class="profile-header">
       <view class="profile-glow"></view>
@@ -108,11 +108,13 @@
 
 <script>
 import AchievementBadge from '../../components/AchievementBadge.vue'
-import { getRecords, getUserInfo } from '../../common/mock-data'
-import { calcStats, checkAchievements } from '../../common/utils'
+import client, { clearAuth } from '../../common/api'
+import { checkAchievements } from '../../common/utils'
 import { ACHIEVEMENTS, DRINK_CATEGORIES } from '../../common/constants'
+import themeMixin from '../../common/theme-mixin'
 
 export default {
+  mixins: [themeMixin],
   components: { AchievementBadge },
   data() {
     return {
@@ -136,11 +138,67 @@ export default {
     this.loadData()
   },
   methods: {
-    loadData() {
-      this.user = getUserInfo()
-      const records = getRecords()
-      this.stats = calcStats(records)
-      this.achievementList = checkAchievements(this.stats, ACHIEVEMENTS)
+    async loadData() {
+      try {
+        const [userResp, statsResp, achieveResp] = await Promise.allSettled([
+          client.GetUserProfile({}),
+          client.GetStatsOverview({}),
+          client.GetAchievements({})
+        ])
+
+        // 用户信息
+        if (userResp.status === 'fulfilled' && userResp.value) {
+          this.user = userResp.value.data || userResp.value
+        } else {
+          try {
+            this.user = JSON.parse(uni.getStorageSync('user_info') || '{}')
+          } catch (e) { this.user = {} }
+        }
+
+        // 统计概览
+        if (statsResp.status === 'fulfilled' && statsResp.value) {
+          const s = statsResp.value.data || statsResp.value
+          this.stats = {
+            weekDrinkCount: s.weekDrinkCount || 0,
+            weekCups: s.weekCups || 0,
+            monthDrinkCount: s.monthDrinkCount || 0,
+            monthCups: s.monthCups || 0,
+            streak: s.streak || 0,
+            streakType: String(s.streakType || 'drank'),
+            totalDays: s.totalDays || 0,
+            totalRecords: s.totalRecords || 0,
+            totalCups: s.totalCups || 0,
+            favCategory: s.favCategory ? String(s.favCategory) : null,
+            categoryVariety: s.categoryVariety || 0
+          }
+        }
+
+        // 成就列表
+        if (achieveResp.status === 'fulfilled' && achieveResp.value) {
+          const list = achieveResp.value.list || achieveResp.value.data || achieveResp.value
+          if (Array.isArray(list) && list.length > 0) {
+            this.achievementList = list.map(a => ({
+              id: a.achievement_id || a.id,
+              name: a.name,
+              desc: a.desc,
+              icon: a.icon,
+              condition: a.condition || '',
+              unlocked: !!a.unlocked
+            }))
+          } else {
+            // API 返回空，降级本地计算
+            this.achievementList = checkAchievements(this.stats, ACHIEVEMENTS)
+          }
+        } else {
+          this.achievementList = checkAchievements(this.stats, ACHIEVEMENTS)
+        }
+      } catch (e) {
+        console.warn('加载个人数据失败:', e)
+        try {
+          this.user = JSON.parse(uni.getStorageSync('user_info') || '{}')
+        } catch (err) { this.user = {} }
+        this.achievementList = checkAchievements(this.stats, ACHIEVEMENTS)
+      }
     },
     showAchievementDetail(a) {
       this.detailAchievement = a
@@ -172,9 +230,7 @@ export default {
         confirmColor: '#FF6B6B',
         success: (res) => {
           if (res.confirm) {
-            uni.removeStorageSync('is_logged_in')
-            uni.removeStorageSync('is_guest')
-            uni.removeStorageSync('user_info')
+            clearAuth()
             uni.reLaunch({ url: '/pages/login/login' })
           }
         }
@@ -239,6 +295,7 @@ export default {
 .profile-name {
   font-size: $fs-xl;
   font-weight: $fw-bold;
+  color: $text-primary;
   margin-bottom: $sp-xs;
 }
 
@@ -256,6 +313,7 @@ export default {
   display: block;
   font-size: $fs-lg;
   font-weight: $fw-bold;
+  color: $text-primary;
   margin-bottom: $sp-lg;
 }
 
@@ -274,6 +332,7 @@ export default {
   display: block;
   font-size: $fs-2xl;
   font-weight: $fw-bold;
+  color: $text-primary;
   margin-bottom: $sp-xs;
 }
 
@@ -299,6 +358,7 @@ export default {
   display: block;
   font-size: $fs-3xl;
   font-weight: $fw-black;
+  color: $text-primary;
 }
 
 .streak-emoji {
@@ -326,6 +386,7 @@ export default {
   align-items: center;
   gap: $sp-md;
   padding: $sp-lg 0;
+  color: $text-primary;
 
   &:active {
     opacity: 0.7;
@@ -364,7 +425,7 @@ export default {
   left: 0;
   right: 0;
   bottom: 0;
-  background: rgba(0,0,0,0.7);
+  background: var(--overlay-modal, rgba(0, 0, 0, 0.7));
   display: flex;
   align-items: center;
   justify-content: center;
diff --git a/pages/record/record.vue b/pages/record/record.vue
index 0a11649..59ba92a 100644
--- a/pages/record/record.vue
+++ b/pages/record/record.vue
@@ -1,5 +1,5 @@
 <template>
-  <view class="page-container record-page safe-bottom">
+  <view :class="themeClass" class="page-container record-page safe-bottom">
     <!-- 顶部进度 -->
     <view class="step-header">
       <view class="step-back" @click="handleBack">
@@ -336,9 +336,12 @@ import {
   FEELINGS, VISIBILITY_OPTIONS
 } from '../../common/constants'
 import { calcStandardCups, unitToMl, formatDate } from '../../common/utils'
+import client from '../../common/api'
 import { addRecord } from '../../common/mock-data'
+import themeMixin from '../../common/theme-mixin'
 
 export default {
+  mixins: [themeMixin],
   data() {
     return {
       currentStep: 1,
@@ -548,25 +551,48 @@ export default {
       }
       if (this.currentStep < this.totalSteps) this.currentStep++
     },
-    publishRecord() {
+    async publishRecord() {
       const allDrinks = this.allDrinks.length > 0 ? this.allDrinks : this.drinks
-      const record = {
+      const recordData = {
         date: this.backfillDate || formatDate(new Date(), 'YYYY-MM-DD'),
         mode: 'drank',
-        drinks: allDrinks,
-        food: this.selectedFood ? { category: this.selectedFood, name: this.foodName } : null,
+        drinks: allDrinks.map(d => ({
+          category: d.category,
+          brand: d.brand,
+          product: d.product || '',
+          amount: d.amount,
+          unit: d.unit,
+          degree: d.degree,
+          standardCups: d.standardCups
+        })),
+        food: this.selectedFood ? { category: this.selectedFood, name: this.foodName || '' } : null,
         feeling: this.selectedFeeling || null,
-        photos: this.photos,
+        photos: [],
         visibility: 'friends',
-        standardCupsTotal: this.totalCups
+        quote: ''
       }
 
-      const saved = addRecord(record)
+      try {
+        uni.showLoading({ title: '保存中...' })
+        // 调用后端创建记录
+        const resp = await client.CreateRecord(recordData)
+        const saved = resp.data || resp
+        uni.hideLoading()
 
-      // 跳转到卡片页，传递记录ID
-      uni.redirectTo({
-        url: `/pages/card/card?recordId=${saved.id}`
-      })
+        // 跳转到卡片页，传递记录ID
+        uni.redirectTo({
+          url: `/pages/card/card?recordId=${saved.id}`
+        })
+      } catch (e) {
+        uni.hideLoading()
+        console.warn('创建记录失败，降级本地保存:', e)
+        uni.showToast({ title: e.msg || '保存失败，已本地保存', icon: 'none', duration: 2000 })
+        // 降级：本地保存
+        const saved = addRecord(recordData)
+        uni.redirectTo({
+          url: `/pages/card/card?recordId=${saved.id}`
+        })
+      }
     }
   }
 }
@@ -575,6 +601,7 @@ export default {
 <style lang="scss" scoped>
 .record-page {
   padding: $sp-lg;
+  color: $text-primary;
   display: flex;
   flex-direction: column;
 }
@@ -639,6 +666,7 @@ export default {
   display: block;
   font-size: $fs-2xl;
   font-weight: $fw-black;
+  color: $text-primary;
   margin-bottom: $sp-xs;
 }
 
@@ -687,6 +715,7 @@ export default {
 .category-name {
   font-size: $fs-sm;
   font-weight: $fw-medium;
+  color: $text-primary;
 }
 
 .brand-section {
@@ -718,7 +747,7 @@ export default {
   padding: $sp-md $sp-lg;
   color: $text-primary;
   font-size: $fs-base;
-  border: 2rpx solid rgba(255,255,255,0.06);
+  border: 2rpx solid var(--border-faint, rgba(255, 255, 255, 0.08));
 }
 
 .input-placeholder {
@@ -840,6 +869,7 @@ export default {
 .standard-cup-value {
   font-size: $fs-xl;
   font-weight: $fw-bold;
+  color: $text-primary;
 }
 
 /* 标准杯说明弹窗 */
@@ -849,7 +879,7 @@ export default {
   left: 0;
   right: 0;
   bottom: 0;
-  background: rgba(0, 0, 0, 0.7);
+  background: var(--overlay-modal, rgba(0, 0, 0, 0.7));
   display: flex;
   align-items: center;
   justify-content: center;
@@ -874,6 +904,7 @@ export default {
 .cup-info-title {
   font-size: $fs-lg;
   font-weight: $fw-bold;
+  color: $text-primary;
 }
 
 .cup-info-close {
@@ -924,7 +955,7 @@ export default {
   justify-content: space-between;
   align-items: center;
   padding: $sp-sm 0;
-  border-bottom: 2rpx solid rgba(255, 255, 255, 0.04);
+  border-bottom: 2rpx solid var(--border-micro, rgba(255, 255, 255, 0.05));
 }
 
 .cup-info-cell {
@@ -1034,6 +1065,7 @@ export default {
 .food-name {
   font-size: $fs-sm;
   font-weight: $fw-medium;
+  color: $text-primary;
 }
 
 .food-detail {
@@ -1077,6 +1109,7 @@ export default {
 .feeling-name {
   font-size: $fs-lg;
   font-weight: $fw-bold;
+  color: $text-primary;
   margin-bottom: $sp-xs;
 }
 
@@ -1116,7 +1149,7 @@ export default {
   right: $sp-sm;
   width: 44rpx;
   height: 44rpx;
-  background: rgba(0,0,0,0.6);
+  background: var(--overlay-mask, rgba(0, 0, 0, 0.6));
   border-radius: $radius-full;
   display: flex;
   align-items: center;
@@ -1133,7 +1166,7 @@ export default {
   flex-direction: column;
   align-items: center;
   justify-content: center;
-  border: 3rpx dashed rgba(255,255,255,0.1);
+  border: 3rpx dashed var(--border-dashed, rgba(255, 255, 255, 0.12));
 
   &:active {
     background: $bg-card-alt;
@@ -1142,6 +1175,7 @@ export default {
 
 .photo-add-icon {
   font-size: $fs-3xl;
+  color: $text-tertiary;
   margin-bottom: $sp-sm;
   opacity: 0.5;
 }
@@ -1153,6 +1187,7 @@ export default {
 
 .photo-tip {
   text-align: center;
+  color: $text-secondary;
 }
 
 /* Step 6: 发布 */
@@ -1200,6 +1235,7 @@ export default {
   display: block;
   font-size: $fs-base;
   font-weight: $fw-medium;
+  color: $text-primary;
 }
 
 .visibility-desc {
@@ -1236,7 +1272,7 @@ export default {
   justify-content: space-between;
   align-items: center;
   padding-top: $sp-md;
-  border-top: 2rpx solid rgba(255,255,255,0.06);
+  border-top: 2rpx solid var(--border-faint, rgba(255, 255, 255, 0.08));
 }
 
 /* 保存提示卡片 */
diff --git a/uni.scss b/uni.scss
index d8d6532..c9ec30c 100644
--- a/uni.scss
+++ b/uni.scss
@@ -1,27 +1,122 @@
 /* ==========================================
  * 喝了么 - 设计令牌 (Design Tokens)
- * 设计概念: 琥珀夜光 Amber Night
+ * 设计概念: 琥珀夜光 Amber Night / 暖白琥珀 Warm Day
+ * 支持日夜主题自动切换
  * ========================================== */
 
-/* --- 色彩系统 --- */
-$bg-base:        #0B0B14;    // 深夜底色
-$bg-card:        #151520;    // 卡片底色
-$bg-card-alt:    #1C1C2A;    // 卡片悬浮/选中态
-$bg-elevated:    #222234;    // 弹出层/输入框底色
+/* --- 夜间主题（默认）--- */
+page, .theme-dark {
+  --bg-base:        #0B0B14;
+  --bg-card:        #1A1A28;
+  --bg-card-alt:    #222236;
+  --bg-elevated:    #28283E;
 
-$amber:          #E8A838;    // 琥珀金 - 品牌主色
-$amber-light:    #F5C563;    // 浅金 - 高亮/数字
-$amber-deep:     #C47F17;    // 深琥珀 - 按压态
-$amber-glow:     rgba(232, 168, 56, 0.15);  // 琥珀光晕
+  --amber:          #E8A838;
+  --amber-light:    #F5C563;
+  --amber-deep:     #C47F17;
+  --amber-glow:     rgba(232, 168, 56, 0.15);
 
-$coral:          #FF6B6B;    // 珊瑚红 - 警告/健康提醒
-$mint:           #5EC6A0;    // 薄荷绿 - 成功/正面
-$lavender:       #8B85B8;    // 淡紫灰 - 次要文本
+  --coral:          #FF6B6B;
+  --mint:           #5EC6A0;
+  --lavender:       #8B85B8;
 
-$text-primary:   #FFFFFF;    // 主文本
-$text-secondary: #7E7E96;    // 次要文本
-$text-tertiary:  #4A4A62;    // 辅助文本
-$text-on-amber:  #0B0B14;    // 琥珀色上的文字
+  --text-primary:   #FFFFFF;
+  --text-secondary: #C0C0D2;
+  --text-tertiary:  #9494AC;
+  --text-on-amber:  #0B0B14;
+
+  --border-subtle:  rgba(255, 255, 255, 0.10);
+  --border-faint:   rgba(255, 255, 255, 0.08);
+  --border-micro:   rgba(255, 255, 255, 0.05);
+  --border-dashed:  rgba(255, 255, 255, 0.12);
+  --border-active:  rgba(255, 255, 255, 0.12);
+  --divider-color:  rgba(255, 255, 255, 0.08);
+  --bg-subtle:      rgba(255, 255, 255, 0.03);
+  --bg-hover:       rgba(255, 255, 255, 0.08);
+  --bg-input:       rgba(255, 255, 255, 0.08);
+  --btn-shimmer:    rgba(255, 255, 255, 0.15);
+  --overlay-mask:   rgba(0, 0, 0, 0.6);
+  --overlay-modal:  rgba(0, 0, 0, 0.7);
+
+  --shadow-sm:      0 4rpx 12rpx rgba(0, 0, 0, 0.25);
+  --shadow-md:      0 8rpx 32rpx rgba(0, 0, 0, 0.35);
+  --shadow-amber:   0 8rpx 32rpx rgba(232, 168, 56, 0.25);
+  --shadow-lg:      0 16rpx 48rpx rgba(0, 0, 0, 0.45);
+
+  --card-gradient-start: #1A1510;
+  --card-gradient-end:   #0D0B08;
+  --nav-bar-bg:     #0B0B14;
+  --nav-bar-text:   white;
+  --tab-bar-bg:     #151520;
+  --tab-bar-color:  #9494AC;
+}
+
+/* --- 白天主题 --- */
+.theme-light {
+  --bg-base:        #FAF7F2;
+  --bg-card:        #FFFFFF;
+  --bg-card-alt:    #F0EDE6;
+  --bg-elevated:    #EAE5DA;
+
+  --amber:          #D49530;
+  --amber-light:    #E8A838;
+  --amber-deep:     #B87A1A;
+  --amber-glow:     rgba(212, 149, 48, 0.12);
+
+  --coral:          #E85555;
+  --mint:           #4AAF8A;
+  --lavender:       #7A7598;
+
+  --text-primary:   #2C2416;
+  --text-secondary: #8C8474;
+  --text-tertiary:  #B5AEA0;
+  --text-on-amber:  #FFFFFF;
+
+  --border-subtle:  rgba(0, 0, 0, 0.08);
+  --border-faint:   rgba(0, 0, 0, 0.06);
+  --border-micro:   rgba(0, 0, 0, 0.04);
+  --border-dashed:  rgba(0, 0, 0, 0.12);
+  --border-active:  rgba(0, 0, 0, 0.1);
+  --divider-color:  rgba(0, 0, 0, 0.06);
+  --bg-subtle:      rgba(0, 0, 0, 0.02);
+  --bg-hover:       rgba(0, 0, 0, 0.04);
+  --bg-input:       rgba(0, 0, 0, 0.04);
+  --btn-shimmer:    rgba(255, 255, 255, 0.4);
+  --overlay-mask:   rgba(0, 0, 0, 0.4);
+  --overlay-modal:  rgba(0, 0, 0, 0.5);
+
+  --shadow-sm:      0 4rpx 12rpx rgba(0, 0, 0, 0.06);
+  --shadow-md:      0 8rpx 32rpx rgba(0, 0, 0, 0.08);
+  --shadow-amber:   0 8rpx 32rpx rgba(212, 149, 48, 0.2);
+  --shadow-lg:      0 16rpx 48rpx rgba(0, 0, 0, 0.12);
+
+  --card-gradient-start: #F5F0E8;
+  --card-gradient-end:   #EDE8DF;
+  --nav-bar-bg:     #FAF7F2;
+  --nav-bar-text:   black;
+  --tab-bar-bg:     #FFFFFF;
+  --tab-bar-color:  #B5AEA0;
+}
+
+/* --- 色彩系统（SCSS变量桥接到CSS变量，含暗色回退值）--- */
+$bg-base:        var(--bg-base, #0B0B14);
+$bg-card:        var(--bg-card, #1A1A28);
+$bg-card-alt:    var(--bg-card-alt, #222236);
+$bg-elevated:    var(--bg-elevated, #28283E);
+
+$amber:          var(--amber, #E8A838);
+$amber-light:    var(--amber-light, #F5C563);
+$amber-deep:     var(--amber-deep, #C47F17);
+$amber-glow:     var(--amber-glow, rgba(232, 168, 56, 0.15));
+
+$coral:          var(--coral, #FF6B6B);
+$mint:           var(--mint, #5EC6A0);
+$lavender:       var(--lavender, #8B85B8);
+
+$text-primary:   var(--text-primary, #FFFFFF);
+$text-secondary: var(--text-secondary, #C0C0D2);
+$text-tertiary:  var(--text-tertiary, #9494AC);
+$text-on-amber:  var(--text-on-amber, #0B0B14);
 
 /* --- 字体 --- */
 $font-base:      -apple-system, 'PingFang SC', 'Microsoft YaHei', 'Helvetica Neue', sans-serif;
@@ -62,11 +157,11 @@ $radius-lg:      28rpx;
 $radius-xl:      40rpx;
 $radius-full:    999rpx;
 
-/* --- 阴影 --- */
-$shadow-sm:      0 4rpx 12rpx rgba(0, 0, 0, 0.25);
-$shadow-md:      0 8rpx 32rpx rgba(0, 0, 0, 0.35);
-$shadow-amber:   0 8rpx 32rpx rgba(232, 168, 56, 0.25);
-$shadow-lg:      0 16rpx 48rpx rgba(0, 0, 0, 0.45);
+/* --- 阴影（SCSS变量桥接到CSS变量，含暗色回退值）--- */
+$shadow-sm:      var(--shadow-sm, 0 4rpx 12rpx rgba(0, 0, 0, 0.25));
+$shadow-md:      var(--shadow-md, 0 8rpx 32rpx rgba(0, 0, 0, 0.35));
+$shadow-amber:   var(--shadow-amber, 0 8rpx 32rpx rgba(232, 168, 56, 0.25));
+$shadow-lg:      var(--shadow-lg, 0 16rpx 48rpx rgba(0, 0, 0, 0.45));
 
 /* --- 动画 --- */
 $ease-out:       cubic-bezier(0.22, 1, 0.36, 1);