docs(app.js): 为网络相关函数添加JSDoc注释

添加详细的JSDoc注释说明get_network_type、has_offline_qr_cache和handle_bad_network_on_launch函数的功能、返回值和使用场景

 /*
 /*
  * @Date: 2025-06-28 10:33:00
  * @Date: 2025-06-28 10:33:00
  * @LastEditors: hookehuyr hookehuyr@gmail.com
  * @LastEditors: hookehuyr hookehuyr@gmail.com
- * @LastEditTime: 2026-01-13 13:49:42
+ * @LastEditTime: 2026-01-13 13:55:59
  * @FilePath: /xyxBooking-weapp/src/app.js
  * @FilePath: /xyxBooking-weapp/src/app.js
  * @Description: 应用入口文件
  * @Description: 应用入口文件
  */
  */
@@ -101,6 +101,10 @@ const App = createApp({
             return ['wifi', '4g', '5g', '3g'].includes(network_type)
             return ['wifi', '4g', '5g', '3g'].includes(network_type)
         }
         }
 
 
+        /**
+         * 获取当前网络类型
+         * @returns {string} 当前网络类型，如 wifi、4g、5g、3g、none 等
+         */
         const get_network_type = async () => {
         const get_network_type = async () => {
             try {
             try {
                 const result = await new Promise((resolve, reject) => {
                 const result = await new Promise((resolve, reject) => {
@@ -115,6 +119,10 @@ const App = createApp({
             }
             }
         }
         }
 
 
+        /**
+         * 检查是否有离线预约码缓存
+         * @returns {boolean} 如果有离线预约码缓存且有效，则返回 true；否则返回 false
+         */
         const has_offline_qr_cache = () => {
         const has_offline_qr_cache = () => {
             try {
             try {
                 const data = Taro.getStorageSync('OFFLINE_QR_DATA')
                 const data = Taro.getStorageSync('OFFLINE_QR_DATA')
@@ -124,7 +132,17 @@ const App = createApp({
             }
             }
         }
         }
 
 
+        /**
+         * 处理在启动时出现的不良网络情况
+         * - 当网络连接不良且有离线预约码缓存时，提示用户是否使用缓存预约码进入离线模式
+         * - 当网络连接不良且无离线预约码缓存时，提示用户网络连接不畅
+         * @returns {Promise<boolean>} 如果用户选择使用缓存预约码进入离线模式，则返回 true；否则返回 false
+         */
         const handle_bad_network_on_launch = async () => {
         const handle_bad_network_on_launch = async () => {
+            /**
+             * 避免重复提示用户
+             * - 仅在首次启动时检查网络情况
+             */
             if (has_shown_network_modal) return false
             if (has_shown_network_modal) return false
 
 
             const network_type = await get_network_type()
             const network_type = await get_network_type()