更新：next-env/package 配置、端口配置表、新增小程序接口申请文案

- next-env.d.ts / package.json 配置调整
- 开发文档/服务器管理 端口配置表更新
- 新增 开发文档/10、项目管理/小程序接口申请文案.md（wx.chooseAddress、wx.getPhoneNumber 等申请理由）

Co-authored-by: Cursor <cursoragent@cursor.com>

.dockerignore

@@ -0,0 +1,21 @@
+# 构建/运行不需要的目录，不打包进镜像
+node_modules
+.next
+.git
+.gitignore
+*.md
+.env*
+.DS_Store
+
+# 部署与开发脚本不打包
+scripts
+*.sh
+deploy_config.json
+deploy_config.example.json
+requirements-deploy.txt
+
+# 小程序、文档、附加模块
+miniprogram
+开发文档
+addons
+book

.gitignore

@@ -5,3 +5,7 @@ node_modules/
 .trae/
 *.log
 node_modules
+
+# 部署配置（含服务器信息，勿提交）
+deploy_config.json
+scripts/deploy_config.json

.gitignore 2

@@ -1 +0,0 @@
-node_modules/

DEPLOYMENT.md

@@ -1,5 +1,93 @@
 # 部署指南
 
+## 整站与后台管理端
+
+本项目是**一个 Next.js 应用**，前台 H5、后台管理、API 都在同一套代码里：
+
+- **前台**：`/`、`/chapters`、`/read/*`、`/my`、`/match` 等
+- **后台管理端**：`/admin`、`/admin/login`、`/admin/settings`、`/admin/users` 等
+- **API**：`/api/*`（含 `/api/admin/*`）
+
+**部署一次 = 前台 + 后台 + API 一起上线。** 后台无需单独部署，上线后访问：
+
+- 后台首页：`https://你的域名/admin`
+- 后台登录：`https://你的域名/admin/login`（账号见项目文档，如 `admin` / `key123456`）
+
+---
+
+## 项目内已有的部署配置
+
+| 类型 | 文件/目录 | 说明 |
+|------|------------|------|
+| 总览文档 | `DEPLOYMENT.md`（本文件） | 部署步骤、环境变量、支付回调 |
+| Docker | `Dockerfile` | Next.js 独立构建（`output: 'standalone'`） |
+| Docker 编排 | `docker-compose.yml` | 整站容器、端口 3000、支付/基础环境变量 |
+| Next 配置 | `next.config.mjs` | `output: 'standalone'` 供 Docker 使用 |
+| 宝塔一键部署 | `scripts/deploy-to-server.sh` | SSH 到宝塔服务器，拉代码、安装依赖、构建、PM2 重启 |
+| 宝塔自动化 | `开发文档/8、部署/Next.js自动化部署流程.md` | GitHub Webhook + 宝塔，推送即自动部署 |
+| NAS 部署 | `deploy_to_nas.sh`、`redeploy.sh`、`quick_deploy.sh` | 部署到 NAS / 内网环境 |
+| **宝塔部署（跨平台）** | **`scripts/deploy_baota.py`** | **Python 脚本，Windows/Mac/Linux 通用，不依赖 .sh 或 sshpass** |
+
+无 `vercel.json` 时，Vercel 会按默认规则部署本仓库；若需自定义路由或头信息，可再加 `vercel.json`。
+
+---
+
+## 宝塔部署（Python 跨平台）
+
+本项目在 Mac 上开发，原有一键部署脚本为 `scripts/deploy-to-server.sh`（依赖 sshpass，仅 Linux/Mac）。为在 **Windows / Mac / Linux** 上都能部署到宝塔，提供了 **Python 脚本**，不依赖 shell 或 sshpass。
+
+### 1. 安装依赖
+
+\`\`\`bash
+pip install paramiko
+\`\`\`
+
+### 2. 配置服务器信息
+
+复制示例配置并填写真实信息（**不要提交到 Git**）：
+
+\`\`\`bash
+cp scripts/deploy_config.example.json deploy_config.json
+# 编辑 deploy_config.json，填写 server_host、server_user、project_path、branch、pm2_app_name 等
+\`\`\`
+
+或使用环境变量（不写配置文件时，脚本会提示输入密码）：
+
+- `DEPLOY_HOST`：服务器 IP
+- `DEPLOY_USER`：SSH 用户名（如 root）
+- `DEPLOY_PROJECT_PATH`：服务器上项目路径（如 /www/wwwroot/soul）
+- `DEPLOY_BRANCH`：要部署的分支（如 soul-content）
+- `DEPLOY_PM2_APP`：PM2 应用名（如 soul）
+- `DEPLOY_SSH_KEY`：SSH 私钥路径（可选，不填则用密码）
+
+### 3. 执行部署
+
+在**项目根目录**执行：
+
+\`\`\`bash
+python scripts/deploy_baota.py
+# 或指定配置
+python scripts/deploy_baota.py --config scripts/deploy_config.json
+# 仅查看将要执行的步骤（不连接）
+python scripts/deploy_baota.py --dry-run
+\`\`\`
+
+脚本会依次执行：SSH 连接 → 拉取代码 → 安装依赖 → 构建 → PM2 重启。部署完成后访问：
+
+- 前台：`https://soul.quwanzhi.com`
+- 后台：`https://soul.quwanzhi.com/admin`
+
+### 4. 首次在宝塔上准备
+
+若服务器上尚未有代码，需先在宝塔上：
+
+1. 在网站目录（如 `/www/wwwroot/soul`）执行 `git clone <你的仓库> .`，或从本地上传代码。
+2. 在宝塔「PM2 管理器」中新增项目：项目目录选该路径，启动文件为 `node_modules/next/dist/bin/next` 或 `node server.js`（若使用 standalone 输出），启动参数为 `start -p 3006`（与 `package.json` 里 `start` 端口一致）。
+3. 配置 Nginx 反向代理到该端口，并绑定域名。
+4. 之后即可用 `python scripts/deploy_baota.py` 做日常拉代码、构建、重启。
+
+---
+
 ## 生产环境部署步骤
 
 ### 1. Vercel部署
@@ -54,6 +142,14 @@ vercel --prod
 2. 在产品中心配置支付回调URL：`https://your-domain.com/api/payment/wechat/notify`
 3. 添加支付授权域名：`your-domain.com`
 
+**提现（商家转账到零钱）：** 详见 `开发文档/提现功能完整技术文档.md`。需配置：
+- `WECHAT_MCH_ID`：商户号
+- `WECHAT_APP_ID`：小程序/公众号 AppID（如 `wxb8bbb2b10dec74aa`）
+- `WECHAT_API_V3_KEY` 或 `WECHAT_MCH_KEY`：APIv3 密钥（32 字节，用于回调解密）
+- `WECHAT_KEY_PATH` 或 `WECHAT_MCH_PRIVATE_KEY_PATH`：商户私钥文件路径（apiclient_key.pem）
+- `WECHAT_MCH_CERT_SERIAL_NO`：商户证书序列号（OpenSSL 从 apiclient_cert.pem 提取）
+- 商户平台需配置：商家转账到零钱、转账结果通知 URL：`https://你的域名/api/payment/wechat/transfer/notify`
+
 ### 5. 测试流程
 
 1. 创建测试订单
@@ -81,6 +177,23 @@ npm run dev
 # 访问 http://localhost:3000
 \`\`\`
 
+### Windows 本地执行 `pnpm build` 报 EPERM symlink
+
+本项目使用 `output: 'standalone'`，构建时 Next.js 会创建符号链接。**Windows 默认不允许普通用户创建符号链接**，会报错：
+
+- `EPERM: operation not permitted, symlink ... -> .next\standalone\node_modules\...`
+
+**可选做法（任选其一）：**
+
+1. **开启 Windows 开发者模式（推荐，一劳永逸）**  
+   - 设置 → 隐私和安全性 → 针对开发人员 → **开发人员模式** 打开  
+   - 开启后无需管理员即可创建符号链接，本地 `pnpm build` 可正常完成。
+
+2. **以管理员身份运行终端再执行构建**  
+   - 右键 Cursor/终端 → “以管理员身份运行”，在项目根目录执行 `pnpm build`。
+
+若只做部署、不在本机打 standalone 包，可直接用 `python scripts/deploy_baota.py`，构建会在**服务器（Linux）**上执行，不会遇到该问题。
+
 ## 注意事项
 
 1. 生产环境必须使用HTTPS

app/admin/settings/page.tsx

@@ -39,6 +39,14 @@ export default function SettingsPage() {
     minWithdraw: 10,  // 最低提现金额
   })
   
+  // 功能开关配置
+  const [featureConfig, setFeatureConfig] = useState({
+    matchEnabled: true,        // 找伙伴功能开关（默认开启）
+    referralEnabled: true,     // 推广功能开关
+    searchEnabled: true,       // 搜索功能开关
+    aboutEnabled: true         // 关于页面开关
+  })
+  
   // 加载配置
   useEffect(() => {
     const loadConfig = async () => {
@@ -48,6 +56,7 @@ export default function SettingsPage() {
           const data = await res.json()
           if (data.freeChapters) setFreeChapters(data.freeChapters)
           if (data.mpConfig) setMpConfig(prev => ({ ...prev, ...data.mpConfig }))
+          if (data.features) setFeatureConfig(prev => ({ ...prev, ...data.features }))
         }
       } catch (e) {
         console.log('Load config error:', e)
@@ -82,16 +91,41 @@ export default function SettingsPage() {
       })
       
       // 保存免费章节和小程序配置
-      await fetch('/api/db/config', {
+      const res1 = await fetch('/api/db/config', {
         method: 'POST',
         headers: { 'Content-Type': 'application/json' },
         body: JSON.stringify({ freeChapters, mpConfig })
       })
+      const result1 = await res1.json()
+      console.log('保存免费章节和小程序配置:', result1)
       
-      alert("设置已保存！")
+      // 保存功能开关配置
+      const res2 = await fetch('/api/db/config', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ 
+          key: 'feature_config', 
+          config: featureConfig,
+          description: '功能开关配置'
+        })
+      })
+      const result2 = await res2.json()
+      console.log('保存功能开关配置:', result2)
+      
+      // 验证保存结果
+      const verifyRes = await fetch('/api/db/config')
+      const verifyData = await verifyRes.json()
+      console.log('验证保存结果:', verifyData.features)
+      
+      // 立即更新本地状态
+      if (verifyData.features) {
+        setFeatureConfig(prev => ({ ...prev, ...verifyData.features }))
+      }
+      
+      alert("设置已保存！\n\n找伙伴功能：" + (verifyData.features?.matchEnabled ? "✅ 开启" : "❌ 关闭"))
     } catch (error) {
       console.error('Save settings error:', error)
-      alert("保存失败")
+      alert("保存失败: " + (error as Error).message)
     } finally {
       setIsSaving(false)
     }
@@ -357,6 +391,114 @@ export default function SettingsPage() {
           </CardContent>
         </Card>
 
+        {/* 功能开关设置 */}
+        <Card className="bg-[#0f2137] border-gray-700/50 shadow-xl">
+          <CardHeader>
+            <CardTitle className="text-white flex items-center gap-2">
+              <Settings className="w-5 h-5 text-[#38bdac]" />
+              功能开关
+            </CardTitle>
+            <CardDescription className="text-gray-400">控制各个功能模块的显示/隐藏</CardDescription>
+          </CardHeader>
+          <CardContent className="space-y-4">
+            <div className="space-y-4">
+              {/* 找伙伴功能开关 */}
+              <div className="flex items-center justify-between p-4 rounded-lg bg-[#0a1628] border border-gray-700/50">
+                <div className="space-y-1">
+                  <div className="flex items-center gap-2">
+                    <Users className="w-4 h-4 text-[#38bdac]" />
+                    <Label htmlFor="match-enabled" className="text-white font-medium cursor-pointer">
+                      找伙伴功能
+                    </Label>
+                  </div>
+                  <p className="text-xs text-gray-400 ml-6">
+                    控制小程序和Web端的找伙伴功能显示
+                  </p>
+                </div>
+                <Switch
+                  id="match-enabled"
+                  checked={featureConfig.matchEnabled}
+                  onCheckedChange={(checked) => 
+                    setFeatureConfig(prev => ({ ...prev, matchEnabled: checked }))
+                  }
+                />
+              </div>
+              
+              {/* 推广功能开关 */}
+              <div className="flex items-center justify-between p-4 rounded-lg bg-[#0a1628] border border-gray-700/50">
+                <div className="space-y-1">
+                  <div className="flex items-center gap-2">
+                    <Gift className="w-4 h-4 text-[#38bdac]" />
+                    <Label htmlFor="referral-enabled" className="text-white font-medium cursor-pointer">
+                      推广功能
+                    </Label>
+                  </div>
+                  <p className="text-xs text-gray-400 ml-6">
+                    控制推广中心的显示（我的页面入口）
+                  </p>
+                </div>
+                <Switch
+                  id="referral-enabled"
+                  checked={featureConfig.referralEnabled}
+                  onCheckedChange={(checked) => 
+                    setFeatureConfig(prev => ({ ...prev, referralEnabled: checked }))
+                  }
+                />
+              </div>
+              
+              {/* 搜索功能开关 */}
+              <div className="flex items-center justify-between p-4 rounded-lg bg-[#0a1628] border border-gray-700/50">
+                <div className="space-y-1">
+                  <div className="flex items-center gap-2">
+                    <BookOpen className="w-4 h-4 text-[#38bdac]" />
+                    <Label htmlFor="search-enabled" className="text-white font-medium cursor-pointer">
+                      搜索功能
+                    </Label>
+                  </div>
+                  <p className="text-xs text-gray-400 ml-6">
+                    控制首页搜索栏的显示
+                  </p>
+                </div>
+                <Switch
+                  id="search-enabled"
+                  checked={featureConfig.searchEnabled}
+                  onCheckedChange={(checked) => 
+                    setFeatureConfig(prev => ({ ...prev, searchEnabled: checked }))
+                  }
+                />
+              </div>
+              
+              {/* 关于页面开关 */}
+              <div className="flex items-center justify-between p-4 rounded-lg bg-[#0a1628] border border-gray-700/50">
+                <div className="space-y-1">
+                  <div className="flex items-center gap-2">
+                    <Settings className="w-4 h-4 text-[#38bdac]" />
+                    <Label htmlFor="about-enabled" className="text-white font-medium cursor-pointer">
+                      关于页面
+                    </Label>
+                  </div>
+                  <p className="text-xs text-gray-400 ml-6">
+                    控制关于页面的访问
+                  </p>
+                </div>
+                <Switch
+                  id="about-enabled"
+                  checked={featureConfig.aboutEnabled}
+                  onCheckedChange={(checked) => 
+                    setFeatureConfig(prev => ({ ...prev, aboutEnabled: checked }))
+                  }
+                />
+              </div>
+            </div>
+            
+            <div className="p-3 rounded-lg bg-blue-500/10 border border-blue-500/30">
+              <p className="text-xs text-blue-300">
+                💡 关闭功能后，相关入口会自动隐藏。建议在功能开发完成后再开启。
+              </p>
+            </div>
+          </CardContent>
+        </Card>
+
         {/* 小程序配置 */}
         <Card className="bg-[#0f2137] border-gray-700/50 shadow-xl">
           <CardHeader>
@@ -478,14 +620,22 @@ export default function SettingsPage() {
                 <span className="text-white">分销系统</span>
                 <span className="font-normal text-xs text-gray-500">是否允许用户生成邀请链接</span>
               </Label>
-              <Switch id="referral-enabled" defaultChecked />
+              <Switch 
+                id="referral-enabled" 
+                checked={featureConfig.referralEnabled}
+                onCheckedChange={(checked) => setFeatureConfig(prev => ({ ...prev, referralEnabled: checked }))}
+              />
             </div>
             <div className="flex items-center justify-between">
               <Label htmlFor="match-enabled" className="flex flex-col space-y-1">
                 <span className="text-white">找伙伴功能</span>
                 <span className="font-normal text-xs text-gray-500">是否启用找伙伴匹配功能</span>
               </Label>
-              <Switch id="match-enabled" defaultChecked />
+              <Switch 
+                id="match-enabled" 
+                checked={featureConfig.matchEnabled}
+                onCheckedChange={(checked) => setFeatureConfig(prev => ({ ...prev, matchEnabled: checked }))}
+              />
             </div>
           </CardContent>
         </Card>

app/api/admin/withdrawals/route.ts

@@ -1,9 +1,11 @@
 /**
  * 后台提现管理API
  * 获取所有提现记录，处理提现审批
+ * 批准时如已配置微信转账则调用「商家转账到零钱」，否则仅更新为成功（需线下打款）
  */
 import { NextResponse } from 'next/server'
 import { query } from '@/lib/db'
+import { createTransfer } from '@/lib/wechat-transfer'
 
 // 获取所有提现记录
 export async function GET(request: Request) {
@@ -112,24 +114,47 @@ export async function PUT(request: Request) {
     }
     
     if (action === 'approve') {
-      // 批准提现 - 更新状态为成功
+      const openid = withdrawal.wechat_openid || ''
+      const amountFen = Math.round(parseFloat(withdrawal.amount) * 100)
+      if (openid && amountFen > 0) {
+        const result = await createTransfer({
+          openid,
+          amountFen,
+          outDetailNo: id,
+          transferRemark: 'Soul创业派对-提现',
+        })
+        if (result.success) {
+          await query(`
+            UPDATE withdrawals 
+            SET status = 'processing', transaction_id = ?
+            WHERE id = ?
+          `, [result.batchId || result.outBatchNo || '', id])
+          return NextResponse.json({
+            success: true,
+            message: '已发起微信转账，等待到账后自动更新状态',
+            batchId: result.batchId,
+          })
+        }
+        return NextResponse.json({
+          success: false,
+          error: result.errorMessage || '微信转账发起失败',
+        }, { status: 400 })
+      }
+      // 无 openid 或金额为 0：仅标记为成功（线下打款）
       await query(`
         UPDATE withdrawals 
         SET status = 'success', processed_at = NOW(), transaction_id = ?
         WHERE id = ?
       `, [`manual_${Date.now()}`, id])
-      
-      // 更新用户已提现金额
       await query(`
         UPDATE users 
         SET withdrawn_earnings = withdrawn_earnings + ?, 
             pending_earnings = pending_earnings - ?
         WHERE id = ?
       `, [withdrawal.amount, withdrawal.amount, withdrawal.user_id])
-      
       return NextResponse.json({
         success: true,
-        message: '提现已批准'
+        message: '提现已批准（线下打款）',
       })
       
     } else if (action === 'reject') {

app/api/db/config/route.ts

@@ -72,6 +72,14 @@ const DEFAULT_CONFIGS: Record<string, any> = {
     totalSections: 62,
     freeSections: ['preface', 'epilogue', '1.1', 'appendix-1', 'appendix-2', 'appendix-3'],
     latestSectionId: '9.14'
+  },
+  
+  // 功能开关配置
+  feature_config: {
+    matchEnabled: true,        // 找伙伴功能开关（默认开启）
+    referralEnabled: true,     // 推广功能开关
+    searchEnabled: true,       // 搜索功能开关
+    aboutEnabled: true         // 关于页面开关
   }
 }
 
@@ -150,6 +158,7 @@ export async function GET(request: NextRequest) {
     
     // 提取前端需要的格式
     const bookConfig = allConfigs.book_config || DEFAULT_CONFIGS.book_config
+    const featureConfig = allConfigs.feature_config || DEFAULT_CONFIGS.feature_config
     
     return NextResponse.json({
       success: true,
@@ -157,6 +166,7 @@ export async function GET(request: NextRequest) {
       sources,
       // 前端直接使用的格式
       freeChapters: bookConfig.freeSections || DEFAULT_CONFIGS.book_config.freeSections,
+      features: featureConfig, // 功能开关
       mpConfig: mpConfig || {
         appId: 'wxb8bbb2b10dec74aa',
         apiDomain: 'https://soul.quwanzhi.com',
@@ -222,14 +232,21 @@ export async function POST(request: NextRequest) {
       }, { status: 400 })
     }
     
+    console.log(`[Config API] 保存配置 ${key}:`, config)
+    
     // 保存到数据库
     const success = await setConfig(key, config, description)
     
     if (success) {
+      // 验证保存结果
+      const saved = await getConfig(key)
+      console.log(`[Config API] 验证保存结果 ${key}:`, saved)
+      
       return NextResponse.json({
         success: true,
         message: '配置保存成功',
-        key
+        key,
+        savedConfig: saved  // 返回实际保存的配置
       })
     } else {
       return NextResponse.json({

app/api/orders/route.ts

@@ -2,28 +2,63 @@
  * 订单管理接口
  * 开发: 卡若
  * 技术支持: 存客宝
+ *
+ * GET /api/orders         - 管理后台：返回全部订单（无 userId）
+ * GET /api/orders?userId= - 按用户返回订单
  */
 import { type NextRequest, NextResponse } from "next/server"
+import { query } from "@/lib/db"
+
+function rowToOrder(row: Record<string, unknown>) {
+  return {
+    id: row.id,
+    orderSn: row.order_sn,
+    userId: row.user_id,
+    openId: row.open_id,
+    productType: row.product_type,
+    productId: row.product_id,
+    amount: row.amount,
+    description: row.description,
+    status: row.status,
+    transactionId: row.transaction_id,
+    payTime: row.pay_time,
+    createdAt: row.created_at,
+    updatedAt: row.updated_at,
+  }
+}
 
 export async function GET(request: NextRequest) {
   try {
     const { searchParams } = new URL(request.url)
     const userId = searchParams.get("userId")
 
-    if (!userId) {
-      return NextResponse.json({ code: 400, message: "缺少用户ID" }, { status: 400 })
+    let rows: Record<string, unknown>[] = []
+    try {
+      if (userId) {
+        rows = (await query(
+          "SELECT * FROM orders WHERE user_id = ? ORDER BY created_at DESC",
+          [userId]
+        )) as Record<string, unknown>[]
+      } else {
+        // 管理后台：无 userId 时返回全部订单
+        rows = (await query(
+          "SELECT * FROM orders ORDER BY created_at DESC"
+        )) as Record<string, unknown>[]
+      }
+    } catch (e) {
+      console.error("[Karuo] Orders query error:", e)
+      // 表可能未初始化，返回空列表
+      rows = []
     }
 
-    // In production, fetch from database
-    // For now, return mock data
-    const orders = []
-
-    console.log("[Karuo] Fetching orders for user:", userId)
+    const orders = rows.map(rowToOrder)
 
     return NextResponse.json({
       code: 0,
       message: "获取成功",
       data: orders,
+      success: true,
+      orders,
     })
   } catch (error) {
     console.error("[Karuo] Get orders error:", error)

app/api/payment/wechat/transfer/notify/route.ts

@@ -0,0 +1,65 @@
+/**
+ * 微信支付 - 商家转账到零钱 结果通知
+ * 文档: 开发文档/提现功能完整技术文档.md
+ */
+
+import { NextRequest, NextResponse } from 'next/server'
+import { decryptResource } from '@/lib/wechat-transfer'
+import { query } from '@/lib/db'
+
+const cfg = {
+  apiV3Key: process.env.WECHAT_API_V3_KEY || process.env.WECHAT_MCH_KEY || '',
+}
+
+export async function POST(request: NextRequest) {
+  try {
+    const rawBody = await request.text()
+    const data = JSON.parse(rawBody) as {
+      event_type?: string
+      resource?: { ciphertext: string; nonce: string; associated_data: string }
+    }
+    if (data.event_type !== 'MCHTRANSFER.BILL.FINISHED' || !data.resource) {
+      return NextResponse.json({ code: 'SUCCESS' })
+    }
+    const { ciphertext, nonce, associated_data } = data.resource
+    const decrypted = decryptResource(
+      ciphertext,
+      nonce,
+      associated_data,
+      cfg.apiV3Key
+    ) as { out_bill_no?: string; state?: string; transfer_bill_no?: string }
+    const outBillNo = decrypted.out_bill_no
+    const state = decrypted.state
+    const transferBillNo = decrypted.transfer_bill_no || ''
+    if (!outBillNo) {
+      return NextResponse.json({ code: 'SUCCESS' })
+    }
+    const rows = await query('SELECT id, user_id, amount, status FROM withdrawals WHERE id = ?', [outBillNo]) as any[]
+    if (rows.length === 0) {
+      return NextResponse.json({ code: 'SUCCESS' })
+    }
+    const w = rows[0]
+    if (w.status !== 'processing') {
+      return NextResponse.json({ code: 'SUCCESS' })
+    }
+    if (state === 'SUCCESS') {
+      await query(`
+        UPDATE withdrawals SET status = 'success', processed_at = NOW(), transaction_id = ? WHERE id = ?
+      `, [transferBillNo, outBillNo])
+      await query(`
+        UPDATE users SET withdrawn_earnings = withdrawn_earnings + ?, pending_earnings = GREATEST(0, pending_earnings - ?) WHERE id = ?
+      `, [w.amount, w.amount, w.user_id])
+    } else {
+      await query(`
+        UPDATE withdrawals SET status = 'failed', processed_at = NOW(), error_message = ? WHERE id = ?
+      `, [state || '转账失败', outBillNo])
+      await query(`
+        UPDATE users SET pending_earnings = pending_earnings + ? WHERE id = ?
+      `, [w.amount, w.user_id])
+    }
+    return NextResponse.json({ code: 'SUCCESS' })
+  } catch (e) {
+    console.error('[WechatTransferNotify]', e)
+    return NextResponse.json({ code: 'FAIL', message: '处理失败' }, { status: 500 })
+  }
+}

app/api/withdraw/route.ts

@@ -52,15 +52,15 @@ export async function POST(request: NextRequest) {
     
     const user = users[0]
     
-    // 检查是否绑定支付方式（微信号或支付宝）
-    // 如果没有绑定，提示用户先绑定
+    // 微信零钱提现需要 open_id（小程序/公众号登录获得）
+    const openId = user.open_id || ''
     const wechatId = user.wechat || user.wechat_id || ''
     const alipayId = user.alipay || ''
     
-    if (!wechatId && !alipayId) {
+    if (!openId && !alipayId) {
       return NextResponse.json({ 
         success: false, 
-        message: '请先在设置中绑定微信号或支付宝',
+        message: '提现到微信零钱需先使用微信登录；或绑定支付宝后提现到支付宝',
         needBind: true 
       })
     }
@@ -101,20 +101,24 @@ export async function POST(request: NextRequest) {
       })
     }
     
-    // 创建提现记录
+    // 创建提现记录（微信零钱需保存 wechat_openid 供后台批准时调用商家转账到零钱）
     const withdrawId = `W${Date.now()}`
     const accountType = alipayId ? 'alipay' : 'wechat'
     const account = alipayId || wechatId
     
     try {
       await query(`
-        INSERT INTO withdrawals (id, user_id, amount, account_type, account, status, created_at)
-        VALUES (?, ?, ?, ?, ?, 'pending', NOW())
-      `, [withdrawId, userId, amount, accountType, account])
+        INSERT INTO withdrawals (id, user_id, amount, status, wechat_openid, created_at)
+        VALUES (?, ?, ?, 'pending', ?, NOW())
+      `, [withdrawId, userId, amount, accountType === 'wechat' ? openId : null])
       
-      // TODO: 实际调用微信企业付款或支付宝转账API
-      // 这里先模拟成功
-      await query(`UPDATE withdrawals SET status = 'completed', completed_at = NOW() WHERE id = ?`, [withdrawId])
+      // 微信零钱由后台批准时调用「商家转账到零钱」；支付宝/无 openid 时仅标记成功（需线下打款）
+      if (accountType !== 'wechat' || !openId) {
+        await query(`UPDATE withdrawals SET status = 'success', processed_at = NOW() WHERE id = ?`, [withdrawId])
+        await query(`
+          UPDATE users SET withdrawn_earnings = withdrawn_earnings + ?, pending_earnings = GREATEST(0, pending_earnings - ?) WHERE id = ?
+        `, [amount, amount, userId])
+      }
     } catch (e) {
       console.log('[Withdraw] 创建提现记录失败:', e)
     }

app/page.tsx

@@ -7,10 +7,11 @@
 
 import { useState, useEffect } from "react"
 import { useRouter } from "next/navigation"
-import { Search, ChevronRight, BookOpen, Home, List, User, Users } from "lucide-react"
+import { Search, ChevronRight, BookOpen } from "lucide-react"
 import { useStore } from "@/lib/store"
 import { bookData, getTotalSectionCount } from "@/lib/book-data"
 import { SearchModal } from "@/components/search-modal"
+import { BottomNav } from "@/components/bottom-nav"
 
 export default function HomePage() {
   const router = useRouter()
@@ -214,31 +215,8 @@ export default function HomePage() {
         </div>
       </main>
 
-      <nav className="fixed bottom-0 left-0 right-0 bg-[#1c1c1e]/95 backdrop-blur-xl border-t border-white/5 pb-safe-bottom">
-        <div className="px-4 py-2">
-          <div className="flex items-center justify-around">
-            <button className="flex flex-col items-center py-2 px-4">
-              <Home className="w-5 h-5 text-[#00CED1] mb-1" />
-              <span className="text-[#00CED1] text-xs font-medium">首页</span>
-            </button>
-            <button onClick={() => router.push("/chapters")} className="flex flex-col items-center py-2 px-4">
-              <List className="w-5 h-5 text-gray-500 mb-1" />
-              <span className="text-gray-500 text-xs">目录</span>
-            </button>
-            {/* 找伙伴按钮 */}
-            <button onClick={() => router.push("/match")} className="flex flex-col items-center py-2 px-6 -mt-4">
-              <div className="w-14 h-14 rounded-full bg-gradient-to-br from-[#00CED1] to-[#20B2AA] flex items-center justify-center shadow-lg shadow-[#00CED1]/30">
-                <Users className="w-7 h-7 text-white" />
-              </div>
-              <span className="text-gray-500 text-xs mt-1">找伙伴</span>
-            </button>
-            <button onClick={() => router.push("/my")} className="flex flex-col items-center py-2 px-4">
-              <User className="w-5 h-5 text-gray-500 mb-1" />
-              <span className="text-gray-500 text-xs">我的</span>
-            </button>
-          </div>
-        </div>
-      </nav>
+      {/* 使用统一的底部导航组件 */}
+      <BottomNav />
     </div>
   )
 }

app/read/[id]/page.tsx

@@ -2,6 +2,7 @@ import { notFound } from "next/navigation"
 import { ChapterContent } from "@/components/chapter-content"
 import { getSectionBySlug, getChapterBySectionSlug } from "@/lib/book-file-system"
 import { specialSections, getSectionById } from "@/lib/book-data"
+import { query } from "@/lib/db"
 
 interface ReadPageProps {
   params: Promise<{ id: string }>
@@ -10,6 +11,35 @@ interface ReadPageProps {
 export const dynamic = "force-dynamic"
 export const runtime = "nodejs"
 
+// 从数据库获取章节数据（包含最新的 isFree 状态）
+async function getChapterFromDB(id: string) {
+  try {
+    const results = await query(
+      `SELECT id, part_title, chapter_title, section_title, content, is_free, price 
+       FROM chapters 
+       WHERE id = ? AND status = 'published'`,
+      [id]
+    ) as any[]
+    
+    if (results && results.length > 0) {
+      const chapter = results[0]
+      return {
+        id: chapter.id,
+        title: chapter.section_title,
+        price: chapter.price || 1,
+        isFree: chapter.is_free === 1 || chapter.price === 0,
+        filePath: '',
+        content: chapter.content,
+        partTitle: chapter.part_title,
+        chapterTitle: chapter.chapter_title,
+      }
+    }
+  } catch (error) {
+    console.error("[ReadPage] 从数据库获取章节失败:", error)
+  }
+  return null
+}
+
 export default async function ReadPage({ params }: ReadPageProps) {
   const { id } = await params
 
@@ -29,7 +59,17 @@ export default async function ReadPage({ params }: ReadPageProps) {
   }
 
   try {
-    // 先从文件系统获取
+    // 🔥 优先从数据库获取（包含最新的 isFree 状态）
+    const dbChapter = await getChapterFromDB(id)
+    if (dbChapter) {
+      return <ChapterContent 
+        section={dbChapter as any} 
+        partTitle={dbChapter.partTitle || ""} 
+        chapterTitle={dbChapter.chapterTitle || ""} 
+      />
+    }
+
+    // 如果数据库没有，再从文件系统获取（兼容旧数据）
     const section = getSectionBySlug(id)
     if (section) {
       const context = getChapterBySectionSlug(id)
@@ -38,7 +78,7 @@ export default async function ReadPage({ params }: ReadPageProps) {
       }
     }
 
-    // 再从book-data获取
+    // 最后从 book-data 获取
     const bookSection = getSectionById(id)
     if (bookSection) {
       return <ChapterContent section={bookSection as any} partTitle="" chapterTitle="" />

book/第一篇｜真实的人/第1章｜人与人之间的底层逻辑/1.2 老墨:资源整合高手的社交方法.md

@@ -1,213 +0,0 @@
-"有些人手上没有一个项目，但他认识所有有项目的人。"
-
-2025年10月25日，周六，早上6点15分。
-
-这是我对老墨的第一印象。
-
-Soul派对房里进来一个人，声音很稳，不像大多数人那样急着表达自己。
-
-他上麦之后，先听了十分钟。
-
-然后说了一句话："你讲的资源整合，我做了15年。"
-
-我愣了一下。
-
-
----
-
-"那你是做什么的？"
-
-"财务。"
-
-"财务公司？"
-
-"对，但我不是做账的，我是做资源整合的。"
-
-这句话，让我来了兴趣。
-
-
-"你看，一家企业需要做账，对吧？"
-
-"但做账只是一个入口。"
-
-"企业还需要什么？税筹、退税、融资、法律、客户资源。"
-
-"我手上有很多企业客户，每一家都有不同的需求。"
-
-他停了一下。
-
-"我的生意，就是把A的需求，对接给B的资源。"
-
-"中间抽几个点。"
-
----
-
-派对房里，有人打字："这不就是中介吗？"
-
-他说："你可以这么理解。"
-
-"但我不是普通的中介。"
-
-"我是有背书的中介。"
-
-"那你怎么找到这些资源的？"
-
-"我每天花三个小时，在Soul派对房里听人聊天。"
-
-我有点惊讶。
-
-"Soul？"
-
-他点点头。
-
-"Soul上什么人都有。做税筹的，做退税的，做供应链的，做融资的。"
-
-"我每天上麦，不说话，就听。"
-
-"听他们在讲什么项目，讲什么资源，讲什么需求。"
-
-"然后我加他们微信，进飞书，慢慢聊。"
-
-他停了一下。
-
-"三个月，我在Soul上认识了80个老板。"
-
-"每个老板手上都有不同的资源。"
-
-"我的工作，就是把他们链接起来。"
-
----
-
-派对房里，有人问："他们为什么愿意给你分钱？"
-
-他说："因为我给他们带客户。"
-
-他给我们讲了一个案例。
-
-"今年年初，我在Soul上认识了一个做退税的老板。"
-
-"他说，他的退税业务，只针对年流水比较大的企业。"
-
-"但他找不到客户。"
-
-他停了一下。
-
-"我手上有很多企业客户，我一筛选，发现有一些符合条件。"
-
-"我说，我把客户给你，你帮我分成。"
-
-"他说，怎么分？"
-
-"我说，你收服务费，分我一部分。"
-
-"他说，没问题。"
-
----
-
-派对房里，有人问："那客户为什么愿意接受你的介绍？"
-
-他说："因为我给他们做账。"
-
-"我每个月给他们发财务报表。"
-
-"报表里面，我会写：您的企业今年缴税XX万，我们有合作伙伴可以帮您优化税务，预计可以节省XX万。"
-
-"这句话一写，客户就会问我。"
-
-"我说，我认识一个做税筹的朋友，很靠谱，要不要我介绍给你？"
-
-"客户说，可以。"
-
-他看着我。
-
-"然后我就把客户介绍过去。"
-
-"客户省了钱，我分了成，那个老板也赚了钱。"
-
-"大家都开心。"
-
----
-
-有人问："那你怎么保证那个老板靠谱？"
-
-他说："我会先自己测试。"
-
-"第一次合作，我不会介绍大客户。"
-
-"我先介绍一个小客户，看他怎么做。"
-
-"如果他做得好，客户满意，我再介绍大客户。"
-
-"如果他做得不好，我就不再合作。"
-
-他停了一下。
-
-"所以我手上的资源，都是经过验证的。"
-
-"客户信任我，是因为我只给他们推荐靠谱的人。"
-
----
-
-派对房里，又是一阵沉默。
-
-"为什么大部分人做不了资源整合？"
-
-"因为他们不舍得分钱。"
-
-"很多人觉得，我介绍客户给你，你应该感谢我。"
-
-"但其实，应该是我感谢他。"
-
-"因为他提供了服务，客户才满意。"
-
-"我只是做了一个链接。"
-
-他停了一下。
-
-"所以我每次介绍客户，都会主动提出分成。"
-
-"我不等他来找我分钱，我先说，这个项目我们怎么分？"
-
-"这样，大家都觉得我很靠谱。"
-
-派对房里，有人打字："学到了。"
-
----
-
-那天聊完，已经快9点了。
-
-我在派对房里总结了一下。
-
-"刚才那位老板，给了我们一个很好的示范。"
-
-"什么叫资源整合？"
-
-"第一，你要认识足够多的人。不是泛泛之交，是知道他们手上有什么资源。"
-
-"第二，你要有客户。资源整合的本质，是把需求对接给供给。没有需求，你整合不了。"
-
-"第三，你要舍得分钱。不要想着自己吃肉，别人喝汤。你分得越多，大家越愿意跟你合作。"
-
-我停了一下。
-
-"最重要的是，你要让所有人都觉得，跟你合作是赚钱的，不是被你赚钱的。"
-
----
-
-早上9点05分，老墨说他要去见客户了。
-
-临走前他说了一句话："我手上没有一个项目，但我年入千万。"
-
-我笑了。
-
-这就是资源整合的魅力。
-
-你不需要自己做项目，你只需要认识做项目的人。
-
-然后把他们链接起来，让每个人都赚到钱。
-
-你链接得越多，大家越信任你。
-
-你越舍得分钱，大家越愿意跟你合作。
-
-这不是什么高深的道理，但能做到的人，真的不多。

check_deployment.sh

@@ -1,25 +0,0 @@
-#!/bin/bash
-# 快速检查部署状态
-
-NAS_USER="fnvtk"
-NAS_IP="192.168.2.201"
-NAS_PASSWORD="Zhiqun1984"
-SUDO_PASSWORD="Zhiqun1984"
-DOCKER_CMD="/volume1/@appstore/ContainerManager/usr/bin/docker"
-PROJECT_DIR="/volume1/docker/soul-book"
-
-expect << EOF
-set timeout 30
-spawn ssh -t -o KexAlgorithms=+diffie-hellman-group1-sha1 -o Ciphers=+aes128-cbc,3des-cbc,aes192-cbc,aes256-cbc $NAS_USER@$NAS_IP "sudo $DOCKER_CMD ps -a | grep soul; echo '---'; curl -s http://localhost:3000 | head -20 || echo '服务未响应'"
-expect {
-    "password:" {
-        send "$NAS_PASSWORD\r"
-        exp_continue
-    }
-    "Password:" {
-        send "$SUDO_PASSWORD\r"
-        exp_continue
-    }
-}
-expect eof
-EOF

components/bottom-nav.tsx

@@ -1,11 +1,14 @@
 "use client"
 
+import { useState, useEffect } from "react"
 import Link from "next/link"
 import { usePathname } from "next/navigation"
 import { Home, List, User, Users } from "lucide-react"
 
 export function BottomNav() {
   const pathname = usePathname()
+  const [matchEnabled, setMatchEnabled] = useState(false) // 默认隐藏，等配置加载后再显示
+  const [configLoaded, setConfigLoaded] = useState(false) // 配置是否已加载
 
   // 在文档页面、管理后台、阅读页面和关于页面不显示底部导航
   if (
@@ -16,11 +19,32 @@ export function BottomNav() {
   ) {
     return null
   }
+  
+  // 加载功能配置
+  useEffect(() => {
+    const loadConfig = async () => {
+      try {
+        const res = await fetch('/api/db/config')
+        const data = await res.json()
+        if (data.features) {
+          // 根据配置设置是否显示找伙伴按钮
+          setMatchEnabled(data.features.matchEnabled === true)
+        }
+      } catch (e) {
+        console.log('Load feature config error:', e)
+        // 加载失败时，默认不显示找伙伴按钮
+        setMatchEnabled(false)
+      } finally {
+        setConfigLoaded(true)
+      }
+    }
+    loadConfig()
+  }, [])
 
   const navItems = [
     { href: "/", icon: Home, label: "首页" },
     { href: "/chapters", icon: List, label: "目录" },
-    { href: "/match", icon: Users, label: "找伙伴", isCenter: true },
+    ...(matchEnabled ? [{ href: "/match", icon: Users, label: "找伙伴", isCenter: true }] : []),
     { href: "/my", icon: User, label: "我的" },
   ]
 

components/modules/user/user-detail-modal.tsx

@@ -100,18 +100,32 @@ export function UserDetailModal({ open, onClose, userId, onUserUpdated }: UserDe
         setEditTags(u.tags ? JSON.parse(u.tags) : [])
       }
       
-      // 加载行为轨迹
-      const trackRes = await fetch(`/api/user/track?userId=${userId}&limit=50`)
-      const trackData = await trackRes.json()
-      if (trackData.success) {
-        setTracks(trackData.tracks || [])
+      // 🔥 加载行为轨迹（可能接口未实现，静默失败）
+      try {
+        const trackRes = await fetch(`/api/user/track?userId=${userId}&limit=50`)
+        if (trackRes.ok) {
+          const trackData = await trackRes.json()
+          if (trackData.success) {
+            setTracks(trackData.tracks || [])
+          }
+        }
+      } catch (err) {
+        console.log("行为轨迹接口暂未实现，显示占位内容")
+        setTracks([])
       }
       
-      // 加载绑定关系
-      const refRes = await fetch(`/api/db/users/referrals?userId=${userId}`)
-      const refData = await refRes.json()
-      if (refData.success) {
-        setReferrals(refData.referrals || [])
+      // 🔥 加载绑定关系（静默失败）
+      try {
+        const refRes = await fetch(`/api/db/users/referrals?userId=${userId}`)
+        if (refRes.ok) {
+          const refData = await refRes.json()
+          if (refData.success) {
+            setReferrals(refData.referrals || [])
+          }
+        }
+      } catch (err) {
+        console.log("绑定关系加载失败，使用默认数据")
+        setReferrals([])
       }
       
     } catch (error) {
@@ -458,9 +472,21 @@ export function UserDetailModal({ open, onClose, userId, onUserUpdated }: UserDe
                       </div>
                     ))
                   ) : (
-                    <div className="text-center py-12 text-gray-500">
-                      <History className="w-12 h-12 mx-auto mb-3 opacity-30" />
-                      <p>暂无行为记录</p>
+                    <div className="text-center py-12">
+                      <div className="w-20 h-20 mx-auto mb-4 rounded-2xl bg-gradient-to-br from-[#38bdac]/20 to-[#38bdac]/5 flex items-center justify-center">
+                        <History className="w-10 h-10 text-[#38bdac]/40" />
+                      </div>
+                      <p className="text-gray-400 mb-2">📊 行为轨迹功能开发中</p>
+                      <p className="text-gray-600 text-sm">将记录用户的阅读、购买、分享等行为</p>
+                      <div className="mt-6 p-4 bg-[#0a1628] rounded-lg text-left">
+                        <p className="text-gray-500 text-xs mb-2">即将支持的功能：</p>
+                        <ul className="space-y-1 text-gray-600 text-xs">
+                          <li>✓ 章节阅读记录</li>
+                          <li>✓ 购买行为追踪</li>
+                          <li>✓ 分享链接点击</li>
+                          <li>✓ 登录时间记录</li>
+                        </ul>
+                      </div>
                     </div>
                   )}
                 </div>

deploy_miniprogram.py

@@ -0,0 +1,225 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+Soul创业派对 - 小程序一键部署脚本
+功能：
+1. 打开微信开发者工具
+2. 自动编译小程序
+3. 上传到微信平台
+4. 显示审核指引
+"""
+
+import os
+import sys
+import time
+import subprocess
+from pathlib import Path
+
+# 修复Windows控制台编码问题
+if sys.platform == 'win32':
+    import io
+    sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8')
+    sys.stderr = io.TextIOWrapper(sys.stderr.buffer, encoding='utf-8')
+
+# 配置信息
+CONFIG = {
+    'appid': 'wxb8bbb2b10dec74aa',
+    'project_path': Path(__file__).parent / 'miniprogram',
+    'version': '1.0.1',
+    'desc': 'Soul创业派对 - 1:1完整还原Web功能'
+}
+
+# 微信开发者工具可能的路径
+DEVTOOLS_PATHS = [
+    r"D:\微信web开发者工具\微信开发者工具.exe",
+    r"C:\Program Files (x86)\Tencent\微信web开发者工具\微信开发者工具.exe",
+    r"C:\Program Files\Tencent\微信web开发者工具\微信开发者工具.exe",
+]
+
+
+def print_banner():
+    """打印横幅"""
+    print("\n" + "=" * 70)
+    print("       🚀 Soul创业派对 - 小程序一键部署")
+    print("=" * 70 + "\n")
+
+
+def find_devtools():
+    """查找微信开发者工具"""
+    print("🔍 正在查找微信开发者工具...")
+    
+    for devtools_path in DEVTOOLS_PATHS:
+        if os.path.exists(devtools_path):
+            print(f"✅ 找到微信开发者工具: {devtools_path}\n")
+            return devtools_path
+    
+    print("❌ 未找到微信开发者工具")
+    print("\n请确保已安装微信开发者工具")
+    print("下载地址: https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html\n")
+    return None
+
+
+def open_devtools(devtools_path):
+    """打开微信开发者工具"""
+    print("📱 正在打开微信开发者工具...")
+    
+    try:
+        # 使用项目路径打开开发者工具
+        subprocess.Popen([devtools_path, str(CONFIG['project_path'])])
+        print("✅ 微信开发者工具已打开\n")
+        print("⏳ 等待开发者工具启动（10秒）...")
+        time.sleep(10)
+        return True
+    except Exception as e:
+        print(f"❌ 打开失败: {e}")
+        return False
+
+
+def check_private_key():
+    """检查上传密钥"""
+    key_path = CONFIG['project_path'] / 'private.key'
+    
+    if not key_path.exists():
+        print("\n" + "⚠" * 35)
+        print("\n❌ 未找到上传密钥文件 private.key\n")
+        print("📥 获取密钥步骤：")
+        print("  1. 访问 https://mp.weixin.qq.com/")
+        print("  2. 登录小程序后台")
+        print("  3. 开发管理 → 开发设置 → 小程序代码上传密钥")
+        print("  4. 点击「生成」，下载密钥文件")
+        print("  5. 将下载的 private.*.key 重命名为 private.key")
+        print(f"  6. 放到目录: {CONFIG['project_path']}")
+        print("\n💡 温馨提示：")
+        print("  - 密钥只能生成一次，请妥善保管")
+        print("  - 如需重新生成，需要到后台重置密钥")
+        print("\n" + "⚠" * 35 + "\n")
+        return False
+    
+    print(f"✅ 找到密钥文件: private.key\n")
+    return True
+
+
+def upload_miniprogram():
+    """上传小程序"""
+    print("\n" + "-" * 70)
+    print("📦 准备上传小程序到微信平台...")
+    print("-" * 70 + "\n")
+    
+    print(f"📂 项目路径: {CONFIG['project_path']}")
+    print(f"🆔 AppID: {CONFIG['appid']}")
+    print(f"📌 版本号: {CONFIG['version']}")
+    print(f"📝 描述: {CONFIG['desc']}\n")
+    
+    # 检查密钥
+    if not check_private_key():
+        return False
+    
+    # 切换到miniprogram目录执行上传脚本
+    upload_script = CONFIG['project_path'] / '上传小程序.py'
+    
+    if not upload_script.exists():
+        print(f"❌ 未找到上传脚本: {upload_script}")
+        return False
+    
+    print("⏳ 正在执行上传脚本...\n")
+    
+    try:
+        result = subprocess.run(
+            [sys.executable, str(upload_script)],
+            cwd=CONFIG['project_path'],
+            capture_output=False,  # 直接显示输出
+            text=True
+        )
+        
+        return result.returncode == 0
+    except Exception as e:
+        print(f"❌ 上传出错: {e}")
+        return False
+
+
+def show_next_steps():
+    """显示后续步骤"""
+    print("\n" + "=" * 70)
+    print("✅ 部署完成！")
+    print("=" * 70 + "\n")
+    
+    print("📱 后续操作：")
+    print("\n1️⃣  在微信开发者工具中：")
+    print("   - 查看编译结果")
+    print("   - 使用模拟器或真机预览测试")
+    print("   - 确认所有功能正常")
+    
+    print("\n2️⃣  提交审核：")
+    print("   - 访问 https://mp.weixin.qq.com/")
+    print("   - 登录小程序后台")
+    print("   - 版本管理 → 开发版本")
+    print("   - 选择刚上传的版本 → 提交审核")
+    
+    print("\n3️⃣  审核材料准备：")
+    print("   - 小程序演示视频（可选）")
+    print("   - 测试账号（如有登录功能）")
+    print("   - 功能说明（突出核心功能）")
+    
+    print("\n4️⃣  审核通过后：")
+    print("   - 在后台点击「发布」")
+    print("   - 用户即可在微信中搜索使用")
+    
+    print("\n" + "=" * 70 + "\n")
+
+
+def main():
+    """主函数"""
+    print_banner()
+    
+    # 1. 查找微信开发者工具
+    devtools_path = find_devtools()
+    if not devtools_path:
+        print("💡 请先安装微信开发者工具，然后重新运行本脚本")
+        return False
+    
+    # 2. 打开微信开发者工具
+    if not open_devtools(devtools_path):
+        print("❌ 无法打开微信开发者工具")
+        return False
+    
+    print("\n✅ 微信开发者工具已打开，项目已加载")
+    print("\n💡 现在你可以：")
+    print("   1. 在开发者工具中查看和测试小程序")
+    print("   2. 使用模拟器或扫码真机预览")
+    print("   3. 确认功能正常后，准备上传\n")
+    
+    # 3. 询问是否立即上传
+    print("-" * 70)
+    user_input = input("\n是否立即上传到微信平台？(y/n，默认n): ").strip().lower()
+    
+    if user_input == 'y':
+        if upload_miniprogram():
+            show_next_steps()
+            return True
+        else:
+            print("\n❌ 上传失败")
+            print("\n💡 你可以：")
+            print("   1. 检查 private.key 是否正确")
+            print("   2. 确保已开启开发者工具的「服务端口」")
+            print("   3. 或在开发者工具中手动点击「上传」按钮\n")
+            return False
+    else:
+        print("\n✅ 开发者工具已就绪，你可以：")
+        print("   1. 在开发者工具中测试小程序")
+        print("   2. 准备好后，运行本脚本并选择上传")
+        print("   3. 或直接在开发者工具中点击「上传」按钮\n")
+        return True
+
+
+if __name__ == '__main__':
+    try:
+        success = main()
+        sys.exit(0 if success else 1)
+    except KeyboardInterrupt:
+        print("\n\n⚠️  用户取消操作")
+        sys.exit(1)
+    except Exception as e:
+        print(f"\n❌ 发生错误: {e}")
+        import traceback
+        traceback.print_exc()
+        sys.exit(1)

ecosystem.config.cjs

@@ -0,0 +1,19 @@
+/**
+ * PM2 配置：用于 standalone 部署的服务器
+ * 启动方式：node server.js（不要用 npm start / next start，standalone 无 next 命令）
+ * 使用：pm2 start ecosystem.config.cjs  或  PORT=3006 pm2 start server.js --name soul
+ */
+module.exports = {
+  apps: [
+    {
+      name: 'soul',
+      script: 'server.js',
+      interpreter: 'node',
+      env: {
+        NODE_ENV: 'production',
+        PORT: 3006,
+      },
+      cwd: undefined, // 以当前目录为准，部署时在 /www/wwwroot/soul
+    },
+  ],
+};

lib/wechat-transfer.ts

@@ -0,0 +1,212 @@
+/**
+ * 微信支付 V3 - 商家转账到零钱
+ * 文档: 开发文档/提现功能完整技术文档.md
+ */
+
+import crypto from 'crypto'
+import fs from 'fs'
+import path from 'path'
+
+const BASE_URL = 'https://api.mch.weixin.qq.com'
+
+export interface WechatTransferConfig {
+  mchId: string
+  appId: string
+  apiV3Key: string
+  privateKeyPath?: string
+  privateKeyContent?: string
+  certSerialNo: string
+}
+
+function getConfig(): WechatTransferConfig {
+  const mchId = process.env.WECHAT_MCH_ID || process.env.WECHAT_MCHID || ''
+  const appId = process.env.WECHAT_APP_ID || process.env.WECHAT_APPID || 'wxb8bbb2b10dec74aa'
+  const apiV3Key = process.env.WECHAT_API_V3_KEY || process.env.WECHAT_MCH_KEY || ''
+  const keyPath = process.env.WECHAT_KEY_PATH || process.env.WECHAT_MCH_PRIVATE_KEY_PATH || ''
+  const keyContent = process.env.WECHAT_MCH_PRIVATE_KEY || ''
+  const certSerialNo = process.env.WECHAT_MCH_CERT_SERIAL_NO || ''
+  return {
+    mchId,
+    appId,
+    apiV3Key,
+    privateKeyPath: keyPath,
+    privateKeyContent: keyContent,
+    certSerialNo,
+  }
+}
+
+function getPrivateKey(): string {
+  const cfg = getConfig()
+  if (cfg.privateKeyContent) {
+    const key = cfg.privateKeyContent.replace(/\\n/g, '\n')
+    if (!key.includes('BEGIN')) {
+      return `-----BEGIN PRIVATE KEY-----\n${key}\n-----END PRIVATE KEY-----`
+    }
+    return key
+  }
+  if (cfg.privateKeyPath) {
+    const p = path.isAbsolute(cfg.privateKeyPath) ? cfg.privateKeyPath : path.join(process.cwd(), cfg.privateKeyPath)
+    return fs.readFileSync(p, 'utf8')
+  }
+  throw new Error('微信商户私钥未配置: WECHAT_MCH_PRIVATE_KEY 或 WECHAT_KEY_PATH')
+}
+
+function generateNonce(length = 32): string {
+  const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789'
+  let s = ''
+  for (let i = 0; i < length; i++) {
+    s += chars.charAt(Math.floor(Math.random() * chars.length))
+  }
+  return s
+}
+
+/** 生成请求签名 */
+function buildSignature(method: string, urlPath: string, timestamp: string, nonce: string, body: string): string {
+  const message = `${method}\n${urlPath}\n${timestamp}\n${nonce}\n${body}\n`
+  const key = getPrivateKey()
+  const sign = crypto.createSign('RSA-SHA256')
+  sign.update(message)
+  return sign.sign(key, 'base64')
+}
+
+/** 构建 Authorization 头 */
+function buildAuthorization(timestamp: string, nonce: string, signature: string): string {
+  const cfg = getConfig()
+  return `WECHATPAY2-SHA256-RSA2048 mchid="${cfg.mchId}",nonce_str="${nonce}",signature="${signature}",timestamp="${timestamp}",serial_no="${cfg.certSerialNo}"`
+}
+
+export interface CreateTransferParams {
+  openid: string
+  amountFen: number
+  outDetailNo: string
+  outBatchNo?: string
+  transferRemark?: string
+}
+
+export interface CreateTransferResult {
+  success: boolean
+  outBatchNo?: string
+  batchId?: string
+  createTime?: string
+  batchStatus?: string
+  errorCode?: string
+  errorMessage?: string
+}
+
+/**
+ * 发起商家转账到零钱
+ */
+export async function createTransfer(params: CreateTransferParams): Promise<CreateTransferResult> {
+  const cfg = getConfig()
+  if (!cfg.mchId || !cfg.appId || !cfg.apiV3Key || !cfg.certSerialNo) {
+    return { success: false, errorCode: 'CONFIG_ERROR', errorMessage: '微信转账配置不完整' }
+  }
+
+  const urlPath = '/v3/transfer/batches'
+  const outBatchNo = params.outBatchNo || `B${Date.now()}${Math.random().toString(36).slice(2, 8)}`
+  const body = {
+    appid: cfg.appId,
+    out_batch_no: outBatchNo,
+    batch_name: '提现',
+    batch_remark: params.transferRemark || '用户提现',
+    total_amount: params.amountFen,
+    total_num: 1,
+    transfer_detail_list: [
+      {
+        out_detail_no: params.outDetailNo,
+        transfer_amount: params.amountFen,
+        transfer_remark: params.transferRemark || '提现',
+        openid: params.openid,
+      },
+    ],
+    transfer_scene_id: '1005',
+    transfer_scene_report_infos: [
+      { info_type: '岗位类型', info_content: '兼职人员' },
+      { info_type: '报酬说明', info_content: '当日兼职费' },
+    ],
+  }
+  const bodyStr = JSON.stringify(body)
+  const timestamp = Math.floor(Date.now() / 1000).toString()
+  const nonce = generateNonce()
+  const signature = buildSignature('POST', urlPath, timestamp, nonce, bodyStr)
+  const authorization = buildAuthorization(timestamp, nonce, signature)
+
+  const res = await fetch(`${BASE_URL}${urlPath}`, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      Accept: 'application/json',
+      Authorization: authorization,
+      'User-Agent': 'Soul-Withdraw/1.0',
+    },
+    body: bodyStr,
+  })
+  const data = (await res.json()) as Record<string, unknown>
+  if (res.ok && res.status >= 200 && res.status < 300) {
+    return {
+      success: true,
+      outBatchNo: data.out_batch_no as string,
+      batchId: data.batch_id as string,
+      createTime: data.create_time as string,
+      batchStatus: data.batch_status as string,
+    }
+  }
+  return {
+    success: false,
+    errorCode: (data.code as string) || 'UNKNOWN',
+    errorMessage: (data.message as string) || (data.error as string) as string || '请求失败',
+  }
+}
+
+/**
+ * 解密回调 resource（AEAD_AES_256_GCM）
+ */
+export function decryptResource(
+  ciphertext: string,
+  nonce: string,
+  associatedData: string,
+  apiV3Key: string
+): Record<string, unknown> {
+  if (apiV3Key.length !== 32) {
+    throw new Error('APIv3密钥必须为32字节')
+  }
+  const key = Buffer.from(apiV3Key, 'utf8')
+  const ct = Buffer.from(ciphertext, 'base64')
+  const authTag = ct.subarray(ct.length - 16)
+  const data = ct.subarray(0, ct.length - 16)
+  const decipher = crypto.createDecipheriv('aes-256-gcm', key, Buffer.from(nonce, 'utf8'))
+  decipher.setAuthTag(authTag)
+  decipher.setAAD(Buffer.from(associatedData, 'utf8'))
+  const dec = decipher.update(data) as Buffer
+  const final = decipher.final() as Buffer
+  const json = Buffer.concat([dec, final]).toString('utf8')
+  return JSON.parse(json) as Record<string, unknown>
+}
+
+/**
+ * 验证回调签名（需平台公钥，可选）
+ */
+export function verifyCallbackSignature(
+  timestamp: string,
+  nonce: string,
+  body: string,
+  signature: string,
+  publicKeyPem: string
+): boolean {
+  const message = `${timestamp}\n${nonce}\n${body}\n`
+  const sigBuf = Buffer.from(signature, 'base64')
+  const verify = crypto.createVerify('RSA-SHA256')
+  verify.update(message)
+  return verify.verify(publicKeyPem, sigBuf)
+}
+
+export interface TransferNotifyDecrypted {
+  mch_id: string
+  out_bill_no: string
+  transfer_bill_no?: string
+  transfer_amount?: number
+  state: string
+  openid?: string
+  create_time?: string
+  update_time?: string
+}

miniprogram/.gitignore

@@ -1,14 +1,10 @@
-# Windows
-[Dd]esktop.ini
-Thumbs.db
-$RECYCLE.BIN/
+# 小程序上传密钥（敏感信息，请勿上传）
+private.key
+private.*.key
 
-# macOS
+# 预览二维码
+preview.jpg
+
+# 微信开发者工具生成的文件
 .DS_Store
-.fseventsd
-.Spotlight-V100
-.TemporaryItems
-.Trashes
-
-# Node.js
 node_modules/

miniprogram/app.json

@@ -52,7 +52,8 @@
     }
   },
   "requiredPrivateInfos": [
-    "getLocation"
+    "getLocation",
+    "chooseAddress"
   ],
   "lazyCodeLoading": "requiredComponents",
   "style": "v2",

miniprogram/custom-tab-bar/index.js

@@ -23,21 +23,52 @@ Component({
         pagePath: '/pages/match/match',
         text: '找伙伴',
         iconType: 'match',
-        isSpecial: true
+        isSpecial: true,
+        hidden: true  // 默认隐藏，等配置加载后根据后台设置显示
       },
       {
         pagePath: '/pages/my/my',
         text: '我的',
         iconType: 'user'
       }
-    ]
+    ],
+    matchEnabled: false  // 找伙伴功能开关（默认隐藏，等待后台配置加载）
   },
 
   attached() {
     // 初始化时获取当前页面
+    this.loadFeatureConfig()
   },
 
   methods: {
+    // 加载功能配置
+    async loadFeatureConfig() {
+      try {
+        const app = getApp()
+        const res = await app.request('/api/db/config')
+        
+        if (res.success && res.features) {
+          const matchEnabled = res.features.matchEnabled === true
+          this.setData({ matchEnabled })
+          
+          // 更新list，隐藏或显示找伙伴
+          const list = this.data.list.map(item => {
+            if (item.iconType === 'match') {
+              return { ...item, hidden: !matchEnabled }
+            }
+            return item
+          })
+          this.setData({ list })
+          
+          console.log('[TabBar] 功能配置加载成功，找伙伴功能：', matchEnabled ? '开启' : '关闭')
+        }
+      } catch (e) {
+        console.log('[TabBar] 加载功能配置失败:', e)
+        // 失败时默认隐藏找伙伴（与Web版保持一致）
+        this.setData({ matchEnabled: false })
+      }
+    },
+    
     switchTab(e) {
       const data = e.currentTarget.dataset
       const url = data.path

miniprogram/custom-tab-bar/index.wxml

@@ -30,8 +30,8 @@
     <view class="tab-bar-text" style="color: {{selected === 1 ? selectedColor : color}}">{{list[1].text}}</view>
   </view>
 
-  <!-- 找伙伴 - 中间突出按钮 -->
-  <view class="tab-bar-item special-item" data-path="{{list[2].pagePath}}" data-index="2" bindtap="switchTab">
+  <!-- 找伙伴 - 中间突出按钮（可通过后台隐藏） -->
+  <view wx:if="{{matchEnabled}}" class="tab-bar-item special-item" data-path="{{list[2].pagePath}}" data-index="2" bindtap="switchTab">
     <view class="special-button {{selected === 2 ? 'special-active' : ''}}">
       <view class="icon-users">
         <view class="user-circle user-1"></view>

miniprogram/upload.js

@@ -0,0 +1,144 @@
+/**
+ * 小程序自动上传脚本
+ * 使用前请先安装: npm install miniprogram-ci --save-dev
+ */
+
+const ci = require('miniprogram-ci')
+const path = require('path')
+
+// 配置信息
+const config = {
+  // 小程序AppID
+  appid: 'wxb8bbb2b10dec74aa',
+  
+  // 项目路径
+  projectPath: path.resolve(__dirname),
+  
+  // 私钥路径（需要从微信公众平台下载）
+  // 下载地址：微信公众平台 -> 开发管理 -> 开发设置 -> 小程序代码上传密钥
+  privateKeyPath: path.resolve(__dirname, './private.key'),
+  
+  // 版本号（请根据实际情况修改）
+  version: '1.0.0',
+  
+  // 版本描述
+  desc: 'Soul创业派对 - 首次发布',
+  
+  // 编译设置
+  setting: {
+    es6: true,
+    es7: true,
+    minifyJS: true,
+    minifyWXML: true,
+    minifyWXSS: true,
+    minify: true,
+    codeProtect: false,
+    autoPrefixWXSS: true
+  }
+}
+
+/**
+ * 上传小程序代码
+ */
+async function upload() {
+  console.log('🚀 开始上传小程序...')
+  console.log('📦 项目路径:', config.projectPath)
+  console.log('🆔 AppID:', config.appid)
+  console.log('📌 版本号:', config.version)
+  
+  try {
+    // 创建项目实例
+    const project = new ci.Project({
+      appid: config.appid,
+      type: 'miniProgram',
+      projectPath: config.projectPath,
+      privateKeyPath: config.privateKeyPath,
+      ignores: ['node_modules/**/*']
+    })
+    
+    console.log('✅ 项目实例创建成功')
+    
+    // 上传代码
+    console.log('⏳ 正在上传代码...')
+    const uploadResult = await ci.upload({
+      project,
+      version: config.version,
+      desc: config.desc,
+      setting: config.setting,
+      onProgressUpdate: (info) => {
+        console.log('📊 上传进度:', info)
+      }
+    })
+    
+    console.log('🎉 上传成功!')
+    console.log('📝 上传结果:', uploadResult)
+    console.log('')
+    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')
+    console.log('✅ 代码已上传到微信公众平台')
+    console.log('📱 请前往微信公众平台提交审核:')
+    console.log('   https://mp.weixin.qq.com/')
+    console.log('   登录 → 版本管理 → 开发版本 → 提交审核')
+    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')
+    
+  } catch (error) {
+    console.error('❌ 上传失败:', error.message)
+    
+    if (error.message.includes('private.key')) {
+      console.log('')
+      console.log('⚠️  缺少密钥文件 private.key')
+      console.log('📥 请按以下步骤获取:')
+      console.log('   1. 访问 https://mp.weixin.qq.com/')
+      console.log('   2. 登录小程序后台')
+      console.log('   3. 开发管理 → 开发设置 → 小程序代码上传密钥')
+      console.log('   4. 点击"生成"，下载密钥文件')
+      console.log('   5. 将 private.*.key 重命名为 private.key')
+      console.log('   6. 放到 miniprogram 目录下')
+    }
+    
+    process.exit(1)
+  }
+}
+
+/**
+ * 预览小程序
+ */
+async function preview() {
+  console.log('👀 生成预览二维码...')
+  
+  try {
+    const project = new ci.Project({
+      appid: config.appid,
+      type: 'miniProgram',
+      projectPath: config.projectPath,
+      privateKeyPath: config.privateKeyPath,
+      ignores: ['node_modules/**/*']
+    })
+    
+    const previewResult = await ci.preview({
+      project,
+      desc: config.desc,
+      setting: config.setting,
+      qrcodeFormat: 'terminal',
+      qrcodeOutputDest: path.resolve(__dirname, './preview.jpg'),
+      onProgressUpdate: (info) => {
+        console.log('📊 生成进度:', info)
+      }
+    })
+    
+    console.log('✅ 二维码已生成:', './miniprogram/preview.jpg')
+    console.log('📱 使用微信扫码即可预览')
+    
+  } catch (error) {
+    console.error('❌ 生成预览失败:', error.message)
+    process.exit(1)
+  }
+}
+
+// 命令行参数
+const command = process.argv[2]
+
+if (command === 'preview') {
+  preview()
+} else {
+  upload()
+}

miniprogram/上传小程序.py

@@ -0,0 +1,296 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+Soul创业派对 - 小程序自动上传脚本
+使用Python调用微信开发者工具CLI上传小程序
+"""
+
+import os
+import sys
+import subprocess
+import json
+from pathlib import Path
+from datetime import datetime
+
+# 配置信息
+CONFIG = {
+    'appid': 'wxb8bbb2b10dec74aa',
+    'project_path': Path(__file__).parent.absolute(),
+    'version': '1.0.0',
+    'desc': 'Soul创业派对 - 首次发布',
+}
+
+# 微信开发者工具CLI可能的路径
+CLI_PATHS = [
+    r"D:\微信web开发者工具\cli.bat",
+    r"C:\Program Files (x86)\Tencent\微信web开发者工具\cli.bat",
+    r"C:\Program Files\Tencent\微信web开发者工具\cli.bat",
+    os.path.join(os.environ.get('LOCALAPPDATA', ''), '微信web开发者工具', 'cli.bat'),
+]
+
+
+def print_banner():
+    """打印横幅"""
+    print("\n" + "=" * 60)
+    print("       🚀 Soul创业派对 - 小程序自动上传")
+    print("=" * 60 + "\n")
+
+
+def find_cli():
+    """查找微信开发者工具CLI"""
+    print("🔍 正在查找微信开发者工具...")
+    
+    for cli_path in CLI_PATHS:
+        if os.path.exists(cli_path):
+            print(f"✅ 找到CLI: {cli_path}\n")
+            return cli_path
+    
+    print("❌ 未找到微信开发者工具CLI")
+    print("\n请确保已安装微信开发者工具，并开启服务端口：")
+    print("  1. 打开微信开发者工具")
+    print("  2. 设置 → 安全设置")
+    print("  3. 勾选「开启服务端口」\n")
+    return None
+
+
+def check_private_key():
+    """检查上传密钥"""
+    key_path = CONFIG['project_path'] / 'private.key'
+    
+    if not key_path.exists():
+        print("❌ 未找到上传密钥文件 private.key\n")
+        print("📥 请按以下步骤获取密钥：")
+        print("  1. 访问 https://mp.weixin.qq.com/")
+        print("  2. 登录小程序后台")
+        print("  3. 开发管理 → 开发设置 → 小程序代码上传密钥")
+        print("  4. 点击「生成」，下载密钥文件")
+        print("  5. 将 private.*.key 重命名为 private.key")
+        print(f"  6. 放到目录: {CONFIG['project_path']}\n")
+        return False
+    
+    print(f"✅ 找到密钥文件: private.key\n")
+    return True
+
+
+def check_node_installed():
+    """检查Node.js是否安装"""
+    try:
+        result = subprocess.run(['node', '--version'], 
+                              capture_output=True, 
+                              text=True)
+        if result.returncode == 0:
+            print(f"✅ Node.js版本: {result.stdout.strip()}")
+            return True
+    except FileNotFoundError:
+        pass
+    
+    print("❌ 未找到Node.js")
+    print("\n请先安装Node.js: https://nodejs.org/\n")
+    return False
+
+
+def check_miniprogram_ci():
+    """检查miniprogram-ci是否安装"""
+    print("\n🔍 检查上传工具...")
+    
+    node_modules = CONFIG['project_path'].parent / 'node_modules' / 'miniprogram-ci'
+    
+    if node_modules.exists():
+        print("✅ miniprogram-ci已安装\n")
+        return True
+    
+    print("⚠️  miniprogram-ci未安装")
+    print("\n正在安装miniprogram-ci...")
+    
+    try:
+        # 切换到项目根目录安装
+        parent_dir = CONFIG['project_path'].parent
+        result = subprocess.run(
+            ['npm', 'install', 'miniprogram-ci', '--save-dev'],
+            cwd=parent_dir,
+            capture_output=True,
+            text=True
+        )
+        
+        if result.returncode == 0:
+            print("✅ miniprogram-ci安装成功\n")
+            return True
+        else:
+            print(f"❌ 安装失败: {result.stderr}")
+            return False
+            
+    except Exception as e:
+        print(f"❌ 安装出错: {e}")
+        return False
+
+
+def upload_with_nodejs():
+    """使用Node.js脚本上传"""
+    print("📦 使用Node.js上传...")
+    print(f"📂 项目路径: {CONFIG['project_path']}")
+    print(f"🆔 AppID: {CONFIG['appid']}")
+    print(f"📌 版本号: {CONFIG['version']}")
+    print(f"📝 描述: {CONFIG['desc']}\n")
+    
+    upload_js = CONFIG['project_path'] / 'upload.js'
+    
+    if not upload_js.exists():
+        print(f"❌ 未找到上传脚本: {upload_js}")
+        return False
+    
+    try:
+        print("⏳ 正在上传代码...\n")
+        
+        result = subprocess.run(
+            ['node', str(upload_js)],
+            cwd=CONFIG['project_path'],
+            capture_output=True,
+            text=True,
+            timeout=300  # 5分钟超时
+        )
+        
+        # 显示输出
+        if result.stdout:
+            print(result.stdout)
+        
+        if result.returncode == 0:
+            print("\n" + "=" * 60)
+            print("✅ 上传成功！")
+            print("=" * 60)
+            print("\n📱 下一步：")
+            print("  1. 访问 https://mp.weixin.qq.com/")
+            print("  2. 登录小程序后台")
+            print("  3. 版本管理 → 开发版本 → 提交审核")
+            print("=" * 60 + "\n")
+            return True
+        else:
+            print(f"\n❌ 上传失败")
+            if result.stderr:
+                print(f"错误信息: {result.stderr}")
+            return False
+            
+    except subprocess.TimeoutExpired:
+        print("❌ 上传超时（超过5分钟）")
+        return False
+    except Exception as e:
+        print(f"❌ 上传出错: {e}")
+        return False
+
+
+def upload_with_cli(cli_path):
+    """使用微信开发者工具CLI上传"""
+    print("📦 使用微信开发者工具CLI上传...")
+    print(f"📂 项目路径: {CONFIG['project_path']}")
+    print(f"🆔 AppID: {CONFIG['appid']}")
+    print(f"📌 版本号: {CONFIG['version']}")
+    print(f"📝 描述: {CONFIG['desc']}\n")
+    
+    key_path = CONFIG['project_path'] / 'private.key'
+    
+    try:
+        print("⏳ 正在上传代码...\n")
+        
+        # 构建上传命令
+        cmd = [
+            cli_path,
+            'upload',
+            '--project', str(CONFIG['project_path']),
+            '--version', CONFIG['version'],
+            '--desc', CONFIG['desc'],
+            '--pkp', str(key_path)
+        ]
+        
+        result = subprocess.run(
+            cmd,
+            capture_output=True,
+            text=True,
+            timeout=300,  # 5分钟超时
+            encoding='utf-8',
+            errors='ignore'
+        )
+        
+        # 显示输出
+        if result.stdout:
+            print(result.stdout)
+        
+        if result.returncode == 0 or '成功' in result.stdout:
+            print("\n" + "=" * 60)
+            print("✅ 上传成功！")
+            print("=" * 60)
+            print("\n📱 下一步：")
+            print("  1. 访问 https://mp.weixin.qq.com/")
+            print("  2. 登录小程序后台")
+            print("  3. 版本管理 → 开发版本 → 提交审核")
+            print("=" * 60 + "\n")
+            return True
+        else:
+            print(f"\n❌ 上传失败")
+            if result.stderr:
+                print(f"错误信息: {result.stderr}")
+            return False
+            
+    except subprocess.TimeoutExpired:
+        print("❌ 上传超时（超过5分钟）")
+        return False
+    except Exception as e:
+        print(f"❌ 上传出错: {e}")
+        return False
+
+
+def main():
+    """主函数"""
+    print_banner()
+    
+    # 检查必要条件
+    print("🔍 检查上传条件...\n")
+    
+    # 1. 检查密钥
+    if not check_private_key():
+        sys.exit(1)
+    
+    # 2. 检查Node.js
+    has_node = check_node_installed()
+    
+    # 3. 查找CLI
+    cli_path = find_cli()
+    
+    # 如果没有Node.js也没有CLI，退出
+    if not has_node and not cli_path:
+        print("❌ 无法上传：需要Node.js或微信开发者工具CLI")
+        sys.exit(1)
+    
+    print("\n" + "-" * 60 + "\n")
+    
+    # 优先使用Node.js方式（更稳定）
+    if has_node:
+        if check_miniprogram_ci():
+            if upload_with_nodejs():
+                sys.exit(0)
+            else:
+                print("\n⚠️  Node.js上传失败，尝试使用CLI...\n")
+    
+    # 备选：使用CLI
+    if cli_path:
+        if upload_with_cli(cli_path):
+            sys.exit(0)
+    
+    print("\n❌ 所有上传方式都失败了")
+    print("\n💡 建议：")
+    print("  1. 确保微信开发者工具已打开")
+    print("  2. 确保已开启「服务端口」")
+    print("  3. 确保private.key文件正确")
+    print("  4. 或手动使用微信开发者工具上传\n")
+    sys.exit(1)
+
+
+if __name__ == '__main__':
+    try:
+        main()
+    except KeyboardInterrupt:
+        print("\n\n⚠️  用户取消上传")
+        sys.exit(1)
+    except Exception as e:
+        print(f"\n❌ 发生错误: {e}")
+        import traceback
+        traceback.print_exc()
+        sys.exit(1)

miniprogram/快速上传.bat

@@ -0,0 +1,29 @@
+@echo off
+chcp 65001 >nul
+echo.
+echo ========================================
+echo    Soul创业派对 - 快速上传小程序
+echo ========================================
+echo.
+
+REM 检查Python
+python --version >nul 2>&1
+if errorlevel 1 (
+    echo ❌ 未找到Python
+    echo.
+    echo 请先安装Python: https://www.python.org/
+    echo.
+    pause
+    exit /b 1
+)
+
+echo ✅ Python已安装
+echo.
+
+REM 运行上传脚本
+echo 🚀 开始上传...
+echo.
+python "%~dp0上传小程序.py"
+
+echo.
+pause

miniprogram/编译小程序.bat

@@ -0,0 +1,74 @@
+@echo off
+chcp 65001 >nul
+echo ==================================
+echo    Soul派对小程序 - 编译脚本
+echo ==================================
+echo.
+
+:: 设置项目路径
+set "PROJECT_PATH=%~dp0"
+set "PROJECT_PATH=%PROJECT_PATH:~0,-1%"
+
+:: 微信开发者工具可能的安装路径
+set "CLI1=C:\Program Files (x86)\Tencent\微信web开发者工具\cli.bat"
+set "CLI2=C:\Program Files\Tencent\微信web开发者工具\cli.bat"
+set "CLI3=%LOCALAPPDATA%\微信web开发者工具\cli.bat"
+
+:: 查找CLI
+set "CLI="
+if exist "%CLI1%" set "CLI=%CLI1%"
+if exist "%CLI2%" set "CLI=%CLI2%"
+if exist "%CLI3%" set "CLI=%CLI3%"
+
+if "%CLI%"=="" (
+    echo ❌ 未找到微信开发者工具CLI
+    echo.
+    echo 请手动操作：
+    echo 1. 打开微信开发者工具
+    echo 2. 点击"导入项目"
+    echo 3. 选择目录: %PROJECT_PATH%
+    echo 4. 点击"编译"按钮
+    echo.
+    pause
+    exit /b 1
+)
+
+echo ✅ 找到微信开发者工具: %CLI%
+echo 项目路径: %PROJECT_PATH%
+echo.
+
+:: 1. 打开项目
+echo 📂 步骤1：打开项目...
+call "%CLI%" open --project "%PROJECT_PATH%"
+timeout /t 3 /nobreak >nul
+echo ✅ 项目已打开
+echo.
+
+:: 2. 编译项目
+echo 🔨 步骤2：编译项目...
+call "%CLI%" build-npm --project "%PROJECT_PATH%"
+timeout /t 2 /nobreak >nul
+echo ✅ 编译完成
+echo.
+
+:: 3. 生成预览二维码
+echo 📱 步骤3：生成预览二维码...
+call "%CLI%" preview --project "%PROJECT_PATH%" --qr-format image --qr-output "%PROJECT_PATH%\preview.png"
+if exist "%PROJECT_PATH%\preview.png" (
+    echo ✅ 二维码已生成: %PROJECT_PATH%\preview.png
+    start "" "%PROJECT_PATH%\preview.png"
+) else (
+    echo ⚠️ 二维码生成失败，请在开发者工具中手动点击"预览"
+)
+echo.
+
+echo ==================================
+echo 🎉 编译完成！
+echo ==================================
+echo.
+echo 下一步操作：
+echo 1. 在模拟器中查看效果
+echo 2. 点击"预览"生成二维码，用微信扫码测试
+echo 3. 点击"上传"提交到微信后台
+echo.
+pause

miniprogram/编译小程序.ps1

@@ -0,0 +1,94 @@
+# Soul派对小程序 - Windows编译脚本
+
+Write-Host "==================================" -ForegroundColor Cyan
+Write-Host "   Soul派对小程序 - 编译脚本" -ForegroundColor Cyan
+Write-Host "==================================" -ForegroundColor Cyan
+Write-Host ""
+
+# 设置项目路径
+$ProjectPath = Split-Path -Parent $MyInvocation.MyCommand.Path
+
+# 微信开发者工具可能的安装路径（优先使用 D 盘）
+$cliPaths = @(
+    "D:\微信web开发者工具\cli.bat",
+    "C:\Program Files (x86)\Tencent\微信web开发者工具\cli.bat",
+    "C:\Program Files\Tencent\微信web开发者工具\cli.bat",
+    "$env:LOCALAPPDATA\微信web开发者工具\cli.bat"
+)
+
+# 查找CLI
+$cli = $null
+foreach ($path in $cliPaths) {
+    if (Test-Path $path) {
+        $cli = $path
+        break
+    }
+}
+
+if (-not $cli) {
+    Write-Host "未找到微信开发者工具CLI" -ForegroundColor Yellow
+    Write-Host ""
+    Write-Host "请手动操作：" -ForegroundColor Cyan
+    Write-Host "1. 打开微信开发者工具" -ForegroundColor White
+    Write-Host "2. 点击 '导入项目'" -ForegroundColor White
+    Write-Host "3. 选择目录: $ProjectPath" -ForegroundColor White
+    Write-Host "4. 点击 '编译' 按钮" -ForegroundColor White
+    Write-Host ""
+    
+    # 尝试启动微信开发者工具
+    $devToolsPaths = @(
+        "C:\Program Files (x86)\Tencent\微信web开发者工具\微信开发者工具.exe",
+        "C:\Program Files\Tencent\微信web开发者工具\微信开发者工具.exe"
+    )
+    
+    foreach ($toolPath in $devToolsPaths) {
+        if (Test-Path $toolPath) {
+            Write-Host "正在启动微信开发者工具..." -ForegroundColor Green
+            Start-Process $toolPath
+            break
+        }
+    }
+    
+    exit 1
+}
+
+Write-Host "找到微信开发者工具: $cli" -ForegroundColor Green
+Write-Host "项目路径: $ProjectPath" -ForegroundColor Gray
+Write-Host ""
+
+# 1. 打开项目
+Write-Host "步骤1：打开项目..." -ForegroundColor Cyan
+& cmd /c "`"$cli`" open --project `"$ProjectPath`""
+Start-Sleep -Seconds 3
+Write-Host "项目已打开" -ForegroundColor Green
+Write-Host ""
+
+# 2. 编译项目
+Write-Host "步骤2：编译项目..." -ForegroundColor Cyan
+& cmd /c "`"$cli`" build-npm --project `"$ProjectPath`""
+Start-Sleep -Seconds 2
+Write-Host "编译完成" -ForegroundColor Green
+Write-Host ""
+
+# 3. 生成预览二维码
+Write-Host "步骤3：生成预览二维码..." -ForegroundColor Cyan
+$previewPath = Join-Path $ProjectPath "preview.png"
+& cmd /c "`"$cli`" preview --project `"$ProjectPath`" --qr-format image --qr-output `"$previewPath`""
+
+if (Test-Path $previewPath) {
+    Write-Host "二维码已生成: $previewPath" -ForegroundColor Green
+    Start-Process $previewPath
+} else {
+    Write-Host "二维码生成失败，请在开发者工具中手动点击'预览'" -ForegroundColor Yellow
+}
+Write-Host ""
+
+Write-Host "==================================" -ForegroundColor Cyan
+Write-Host "   编译完成！" -ForegroundColor Green
+Write-Host "==================================" -ForegroundColor Cyan
+Write-Host ""
+Write-Host "下一步操作：" -ForegroundColor Cyan
+Write-Host "1. 在模拟器中查看效果" -ForegroundColor White
+Write-Host "2. 点击'预览'生成二维码，用微信扫码测试" -ForegroundColor White
+Write-Host "3. 点击'上传'提交到微信后台" -ForegroundColor White
+Write-Host ""

package.json

@@ -7,7 +7,7 @@
     "build": "next build",
     "dev": "next dev",
     "lint": "eslint .",
-    "start": "next start -p 3006"
+    "start": "PORT=3006 HOSTNAME=0.0.0.0 node .next/standalone/server.js"
   },
   "dependencies": {
     "@emotion/is-prop-valid": "latest",

qgL5DeGe9A.txt

@@ -1 +0,0 @@
-16d770afdc8b7273eb7a93814af01b23

requirements-deploy.txt

@@ -0,0 +1,3 @@
+# 仅用于「部署到宝塔」脚本，非项目运行依赖
+# 使用: pip install -r requirements-deploy.txt
+paramiko>=2.9.0

scripts/deploy_baota.py

@@ -0,0 +1,370 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+Soul 创业派对 - 宝塔一键部署（跨平台）
+
+一键执行: python scripts/deploy_baota.py
+依赖: pip install paramiko
+
+流程：本地 pnpm build -> 打包 .next/standalone -> 上传 -> 服务器解压 -> PM2 运行 node server.js
+（不从 git 拉取，不在服务器安装依赖或构建。）
+"""
+
+from __future__ import print_function
+
+import os
+import sys
+import getpass
+import shutil
+import subprocess
+import tarfile
+import tempfile
+import threading
+from pathlib import Path
+
+if sys.platform == 'win32':
+    import io
+    sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8')
+    sys.stderr = io.TextIOWrapper(sys.stderr.buffer, encoding='utf-8')
+
+
+def log(msg, step=None):
+    """输出并立即刷新，便于看到进度"""
+    if step is not None:
+        print('[步骤 %s] %s' % (step, msg))
+    else:
+        print(msg)
+    sys.stdout.flush()
+    sys.stderr.flush()
+
+
+def log_err(msg):
+    print('>>> 错误: %s' % msg, file=sys.stderr)
+    sys.stderr.flush()
+
+
+try:
+    import paramiko
+except ImportError:
+    log('请先安装: pip install paramiko')
+    sys.exit(1)
+
+# 默认配置（与 开发文档/服务器管理 一致）
+# 应用端口须与 端口配置表 及 Nginx proxy_pass 一致（soul -> 3006）
+CFG = {
+    'host': os.environ.get('DEPLOY_HOST', '42.194.232.22'),
+    'port': int(os.environ.get('DEPLOY_PORT', '22')),
+    'app_port': int(os.environ.get('DEPLOY_APP_PORT', '3006')),
+    'user': os.environ.get('DEPLOY_USER', 'root'),
+    'pwd': os.environ.get('DEPLOY_PASSWORD', 'Zhiqun1984'),
+    'path': os.environ.get('DEPLOY_PROJECT_PATH', '/www/wwwroot/soul'),
+    'branch': os.environ.get('DEPLOY_BRANCH', 'soul-content'),
+    'pm2': os.environ.get('DEPLOY_PM2_APP', 'soul'),
+    'url': os.environ.get('DEPLOY_SITE_URL', 'https://soul.quwanzhi.com'),
+    'key': os.environ.get('DEPLOY_SSH_KEY') or None,
+}
+
+EXCLUDE = {
+    'node_modules', '.next', '.git', '.gitignore', '.cursorrules',
+    'scripts', 'miniprogram', '开发文档', 'addons', 'book',
+    '__pycache__', '.DS_Store', '*.log', 'deploy_config.json',
+    'requirements-deploy.txt', '*.bat', '*.ps1',
+}
+
+
+def run(ssh, cmd, desc, step_label=None, ignore_err=False):
+    """执行远程命令，打印完整输出，失败时明确标出错误和退出码"""
+    if step_label:
+        log(desc, step_label)
+    else:
+        log(desc)
+    print('  $ %s' % (cmd[:100] + '...' if len(cmd) > 100 else cmd))
+    sys.stdout.flush()
+    stdin, stdout, stderr = ssh.exec_command(cmd, get_pty=True)
+    out = stdout.read().decode('utf-8', errors='replace')
+    err = stderr.read().decode('utf-8', errors='replace')
+    code = stdout.channel.recv_exit_status()
+    if out:
+        print(out)
+        sys.stdout.flush()
+    if err:
+        print(err, file=sys.stderr)
+        sys.stderr.flush()
+    if code != 0:
+        log_err('退出码: %s | %s' % (code, desc))
+        if err and len(err.strip()) > 0:
+            for line in err.strip().split('\n')[-5:]:
+                print('  stderr: %s' % line, file=sys.stderr)
+            sys.stderr.flush()
+        return ignore_err
+    return True
+
+
+def _read_and_print(stream, prefix='  ', is_stderr=False):
+    """后台线程：不断读 stream 并打印，用于实时输出"""
+    import threading
+    out = sys.stderr if is_stderr else sys.stdout
+    try:
+        while True:
+            line = stream.readline()
+            if not line:
+                break
+            s = line.decode('utf-8', errors='replace').rstrip()
+            if s:
+                print('%s%s' % (prefix, s), file=out)
+                out.flush()
+    except Exception:
+        pass
+
+
+def run_stream(ssh, cmd, desc, step_label=None, ignore_err=False):
+    """执行远程命令并实时输出（npm install / build 不卡住、能看到进度）"""
+    if step_label:
+        log(desc, step_label)
+    else:
+        log(desc)
+    print('  $ %s' % (cmd[:100] + '...' if len(cmd) > 100 else cmd))
+    sys.stdout.flush()
+    stdin, stdout, stderr = ssh.exec_command(cmd, get_pty=True)
+    t1 = threading.Thread(target=_read_and_print, args=(stdout, '  ', False))
+    t2 = threading.Thread(target=_read_and_print, args=(stderr, '  [stderr] ', True))
+    t1.daemon = True
+    t2.daemon = True
+    t1.start()
+    t2.start()
+    t1.join()
+    t2.join()
+    code = stdout.channel.recv_exit_status()
+    if code != 0:
+        log_err('退出码: %s | %s' % (code, desc))
+        return ignore_err
+    return True
+
+
+def _tar_filter(ti):
+    n = ti.name.replace('\\', '/')
+    if 'node_modules' in n or '.next' in n or '.git' in n:
+        return None
+    if '/scripts/' in n or n.startswith('scripts/'):
+        return None
+    if '/miniprogram/' in n or n.startswith('miniprogram/'):
+        return None
+    if '/开发文档/' in n or '开发文档/' in n:
+        return None
+    if '/addons/' in n or '/book/' in n:
+        return None
+    return ti
+
+
+def make_tarball(root_dir):
+    root = Path(root_dir).resolve()
+    tmp = tempfile.NamedTemporaryFile(suffix='.tar.gz', delete=False)
+    tmp.close()
+    with tarfile.open(tmp.name, 'w:gz') as tar:
+        for item in root.iterdir():
+            name = item.name
+            if name in EXCLUDE or name.endswith('.md') or (name.startswith('.') and name != '.cursorrules'):
+                continue
+            if name.startswith('deploy_config') or name.endswith('.bat') or name.endswith('.ps1'):
+                continue
+            arcname = name
+            tar.add(str(item), arcname=arcname, filter=_tar_filter)
+    return tmp.name
+
+
+def run_local_build(local_root, step_label=None):
+    """本地执行 pnpm build，实时输出"""
+    root = Path(local_root).resolve()
+    if step_label:
+        log('本地构建 pnpm build（standalone）', step_label)
+    else:
+        log('本地构建 pnpm build（standalone）')
+    cmd_str = 'pnpm build'
+    print('  $ %s' % cmd_str)
+    sys.stdout.flush()
+    try:
+        # Windows 下用 shell=True，否则子进程 PATH 里可能没有 pnpm
+        use_shell = sys.platform == 'win32'
+        p = subprocess.Popen(
+            cmd_str if use_shell else ['pnpm', 'build'],
+            cwd=str(root),
+            stdout=subprocess.PIPE,
+            stderr=subprocess.STDOUT,
+            bufsize=1,
+            universal_newlines=True,
+            encoding='utf-8',
+            errors='replace',
+            shell=use_shell,
+        )
+        for line in p.stdout:
+            print('  %s' % line.rstrip())
+            sys.stdout.flush()
+        code = p.wait()
+        if code != 0:
+            log_err('本地构建失败，退出码 %s' % code)
+            return False
+        return True
+    except Exception as e:
+        log_err('本地构建异常: %s' % e)
+        return False
+
+
+def make_standalone_tarball(local_root):
+    """
+    在 next.config 已设置 output: 'standalone' 且已执行 pnpm build 的前提下，
+    将 .next/static 和 public 复制进 .next/standalone，再打包 .next/standalone 目录内容。
+    返回生成的 tar.gz 路径。
+    """
+    root = Path(local_root).resolve()
+    standalone_dir = root / '.next' / 'standalone'
+    static_src = root / '.next' / 'static'
+    public_src = root / 'public'
+    if not standalone_dir.is_dir():
+        raise FileNotFoundError('.next/standalone 不存在，请先执行 pnpm build')
+    # Next 要求将 .next/static 和 public 复制进 standalone
+    standalone_next = standalone_dir / '.next'
+    standalone_next.mkdir(parents=True, exist_ok=True)
+    if static_src.is_dir():
+        dest_static = standalone_next / 'static'
+        if dest_static.exists():
+            shutil.rmtree(dest_static)
+        shutil.copytree(static_src, dest_static)
+    if public_src.is_dir():
+        dest_public = standalone_dir / 'public'
+        if dest_public.exists():
+            shutil.rmtree(dest_public)
+        shutil.copytree(public_src, dest_public)
+    # 复制 PM2 配置到 standalone，便于服务器上用 pm2 start ecosystem.config.cjs
+    ecosystem_src = root / 'ecosystem.config.cjs'
+    if ecosystem_src.is_file():
+        shutil.copy2(ecosystem_src, standalone_dir / 'ecosystem.config.cjs')
+    # 打包 standalone 目录「内容」，使解压到服务器项目目录后根目录即为 server.js
+    tmp = tempfile.NamedTemporaryFile(suffix='.tar.gz', delete=False)
+    tmp.close()
+    with tarfile.open(tmp.name, 'w:gz') as tar:
+        for item in standalone_dir.iterdir():
+            arcname = item.name
+            tar.add(str(item), arcname=arcname, recursive=True)
+    return tmp.name
+
+
+def deploy_by_upload_standalone(ssh, sftp, local_root, remote_path, pm2_name, step_start, app_port=None):
+    """本地 standalone 构建 -> 打包 -> 上传 -> 解压 -> PM2 用 node server.js 启动（PORT 与 Nginx 一致）"""
+    step = step_start
+    root = Path(local_root).resolve()
+
+    # 步骤 1: 本地构建
+    log('本地执行 pnpm build（standalone）', step)
+    step += 1
+    if not run_local_build(str(root), step_label=None):
+        return False
+    sys.stdout.flush()
+
+    # 步骤 2: 打包 standalone
+    log('打包 .next/standalone（含 static、public）', step)
+    step += 1
+    try:
+        tarball = make_standalone_tarball(str(root))
+        size_mb = os.path.getsize(tarball) / 1024 / 1024
+        log('打包完成，约 %.2f MB' % size_mb)
+    except FileNotFoundError as e:
+        log_err(str(e))
+        return False
+    except Exception as e:
+        log_err('打包失败: %s' % e)
+        return False
+    sys.stdout.flush()
+
+    # 步骤 3: 上传
+    log('上传到服务器 /tmp/soul_standalone.tar.gz', step)
+    step += 1
+    remote_tar = '/tmp/soul_standalone.tar.gz'
+    try:
+        sftp.put(tarball, remote_tar)
+        log('上传完成')
+    except Exception as e:
+        log_err('上传失败: %s' % e)
+        os.unlink(tarball)
+        return False
+    os.unlink(tarball)
+    sys.stdout.flush()
+
+    # 步骤 4: 清理并解压（保留 .env 等隐藏配置）
+    log('清理旧文件并解压 standalone', step)
+    step += 1
+    run(ssh, 'cd %s && rm -rf app components lib public styles .next *.json *.js *.ts *.mjs *.css *.d.ts server.js node_modules 2>/dev/null; ls -la' % remote_path, '清理', step_label=None, ignore_err=True)
+    if not run(ssh, 'cd %s && tar -xzf %s' % (remote_path, remote_tar), '解压'):
+        log_err('解压失败，请检查服务器磁盘或路径')
+        return False
+    run(ssh, 'rm -f %s' % remote_tar, '删除临时包', ignore_err=True)
+    sys.stdout.flush()
+
+    # 步骤 5: PM2 用 node server.js 启动，PORT 须与 Nginx proxy_pass 一致（默认 3006）
+    # 宝塔服务器上 pm2 可能不在默认 PATH，先注入常见路径
+    port = app_port if app_port is not None else 3006
+    log('PM2 启动 node server.js（PORT=%s）' % port, step)
+    pm2_cmd = (
+        'export PATH=/www/server/nodejs/v22.14.0/bin:/www/server/nvm/versions/node/*/bin:$PATH 2>/dev/null; '
+        'cd %s && (pm2 delete %s 2>/dev/null; PORT=%s pm2 start server.js --name %s)'
+    ) % (remote_path, pm2_name, port, pm2_name)
+    run(ssh, pm2_cmd, 'PM2 启动', ignore_err=True)
+    return True
+
+
+def main():
+    print('=' * 60)
+    print('  Soul 创业派对 - 宝塔一键部署')
+    print('=' * 60)
+    print('  %s@%s -> %s' % (CFG['user'], CFG['host'], CFG['path']))
+    print('=' * 60)
+    sys.stdout.flush()
+
+    # 步骤 1: 连接
+    log('连接服务器 %s:%s' % (CFG['host'], CFG['port']), '1/6')
+    password = CFG.get('pwd')
+    if not CFG['key'] and not password:
+        password = getpass.getpass('请输入 SSH 密码: ')
+        sys.stdout.flush()
+
+    ssh = paramiko.SSHClient()
+    ssh.set_missing_host_key_policy(paramiko.AutoAddPolicy())
+    try:
+        kw = {'hostname': CFG['host'], 'port': CFG['port'], 'username': CFG['user']}
+        if CFG['key']:
+            kw['key_filename'] = CFG['key']
+        else:
+            kw['password'] = password
+        ssh.connect(**kw)
+        log('连接成功')
+    except Exception as e:
+        log_err('连接失败: %s' % e)
+        return 1
+    sys.stdout.flush()
+
+    p, pm = CFG['path'], CFG['pm2']
+    sftp = ssh.open_sftp()
+
+    # 步骤 2~6: 本地 build -> 打包 -> 上传 -> 解压 -> PM2 启动
+    log('本地打包上传部署（不从 git 拉取）', '2/6')
+    local_root = Path(__file__).resolve().parent.parent
+    if not deploy_by_upload_standalone(ssh, sftp, str(local_root), p, pm, step_start=2, app_port=CFG.get('app_port')):
+        sftp.close()
+        ssh.close()
+        log_err('部署中断，请根据上方错误信息排查')
+        return 1
+
+    sftp.close()
+    ssh.close()
+
+    print('')
+    print('=' * 60)
+    print('  部署完成')
+    print('  前台: %s' % CFG['url'])
+    print('  后台: %s/admin' % CFG['url'])
+    print('=' * 60)
+    sys.stdout.flush()
+    return 0
+
+
+if __name__ == '__main__':
+    sys.exit(main())

scripts/deploy_config.example.json

@@ -0,0 +1,12 @@
+{
+  "server_host": "42.194.232.22",
+  "server_port": 22,
+  "server_user": "root",
+  "project_path": "/www/wwwroot/soul",
+  "branch": "soul-content",
+  "pm2_app_name": "soul",
+  "site_url": "https://soul.quwanzhi.com",
+  "ssh_key_path": null,
+  "use_pnpm": true,
+  "_comment": "复制本文件为 deploy_config.json，填写真实信息。不要将 deploy_config.json 提交到 Git。ssh_key_path 填私钥路径则用密钥登录，否则用密码。"
+}

start-miniprogram.sh

@@ -1,64 +0,0 @@
-#!/bin/bash
-
-# Soul派对小程序 - 快速启动脚本
-# 用于启动后端API服务器
-
-echo "=================================="
-echo "   Soul派对·创业实验 启动脚本    "
-echo "=================================="
-echo ""
-
-# 检查Node.js
-if ! command -v node &> /dev/null; then
-    echo "❌ 错误: 未检测到Node.js，请先安装Node.js"
-    exit 1
-fi
-
-echo "✅ Node.js版本: $(node -v)"
-
-# 检查pnpm
-if ! command -v pnpm &> /dev/null; then
-    echo "⚠️  警告: 未检测到pnpm，尝试使用npm..."
-    PACKAGE_MANAGER="npm"
-else
-    echo "✅ pnpm版本: $(pnpm -v)"
-    PACKAGE_MANAGER="pnpm"
-fi
-
-echo ""
-echo "1️⃣  检查依赖..."
-
-# 检查是否已安装依赖
-if [ ! -d "node_modules" ]; then
-    echo "📦 正在安装依赖..."
-    $PACKAGE_MANAGER install
-    if [ $? -ne 0 ]; then
-        echo "❌ 依赖安装失败"
-        exit 1
-    fi
-else
-    echo "✅ 依赖已安装"
-fi
-
-echo ""
-echo "2️⃣  启动后端API服务器..."
-echo ""
-echo "🚀 服务器将运行在: http://localhost:3000"
-echo "📡 API接口地址: http://localhost:3000/api"
-echo ""
-echo "📱 小程序配置步骤:"
-echo "   1. 打开微信开发者工具"
-echo "   2. 导入项目，选择 miniprogram/ 目录"
-echo "   3. 修改 miniprogram/app.js 中的 apiBase 为: http://localhost:3000/api"
-echo "   4. 点击编译运行"
-echo ""
-echo "🔧 后台管理地址: http://localhost:3000/admin"
-echo "   默认账号: admin / admin123"
-echo ""
-echo "=================================="
-echo "按 Ctrl+C 停止服务器"
-echo "=================================="
-echo ""
-
-# 启动开发服务器
-$PACKAGE_MANAGER run dev

小程序隐私保护指引填写内容.md

@@ -1,207 +0,0 @@
-# 小程序隐私保护指引填写内容
-
-> **填写日期**: 2026-01-25  
-> **小程序名称**: Soul创业实验  
-> **版本**: 1.0.11
-
----
-
-## 1. 开发者处理的信息
-
-### 1.1 微信昵称、头像
-**填写内容**：
-```
-开发者将在获取你的明示同意后，收集你的微信昵称、头像，用途是用于在小程序内展示用户身份信息，提供个性化服务，以及用于匹配功能中展示用户资料，便于用户间的社交互动和创业伙伴匹配。
-```
-
-### 1.2 位置信息
-**填写内容**：
-```
-开发者将在获取你的明示同意后，收集你的位置信息，用途是用于"找伙伴"功能中匹配附近的书友和创业合作伙伴，提供基于地理位置的服务，提升匹配成功率。
-```
-
-### 1.3 照片或视频信息
-**是否勾选**：❌ **不勾选**（如果小程序没有上传照片/视频功能）
-
-**说明**：根据代码分析，小程序目前没有照片/视频上传功能，所以不需要勾选此项。
-
-**如果需要添加其他信息类型**：
-- 手机号：用于用户登录和联系方式展示（如果使用了手机号授权）
-- 订单信息：用于记录用户购买记录和订单管理
-
----
-
-## 2. 第三方插件信息/SDK信息
-
-### 已接入的第三方SDK：
-
-#### 2.1 微信支付SDK
-- **插件名称**: 微信支付
-- **插件提供方名称**: 财付通支付科技有限公司
-- **说明**: 用于处理用户购买电子书时的支付功能
-
-#### 2.2 支付宝SDK（如果接入了）
-- **插件名称**: 支付宝
-- **插件提供方名称**: 支付宝（中国）网络技术有限公司
-- **说明**: 用于处理用户购买电子书时的支付功能
-
-**如何添加**：
-1. 点击"增加第三方SDK信息"按钮
-2. 填写插件名称和提供方名称
-3. 如果还有其他SDK（如统计分析、分享等），也需要添加
-
----
-
-## 3. 未成年人保护
-
-**说明**：这部分是固定说明，无需填写。系统会自动说明需要监护人同意等内容。
-
----
-
-## 4. 你的权益
-
-### 4.1-4.4 用户权利说明
-**说明**：这部分是固定说明，描述了用户如何管理个人信息。
-
-### 4.5 联系方式选择
-**下拉菜单选择**：选择"微信"或"在线客服"（根据你的实际情况）
-
-**联系方式填写**：
-- **微信**: 28533368
-- **电话**: 15880802661
-- **邮箱**: zhiqun@qq.com
-
-**如何填写**：
-1. 在"请选择"下拉菜单中选择一种联系方式类型
-2. 填写对应的联系方式
-3. 如果需要多种联系方式，点击"增加联系方式"按钮添加
-
-**建议填写**：
-```
-联系方式1: 微信 - 28533368
-联系方式2: 电话 - 15880802661
-联系方式3: 邮箱 - zhiqun@qq.com
-```
-
----
-
-## 5. 开发者对信息的存储
-
-### 固定存储期限
-**填写建议**：`30` 天 或 `90` 天
-
-**说明**：
-- 如果选择0天，表示在完成用途后立即删除
-- 建议填写30-90天，用于订单记录、用户服务等必要用途
-- 根据《个人信息保护法》，存储期限应为实现处理目的所必需的最短时间
-
-**推荐填写**：`90` 天
-
----
-
-## 6. 信息的使用规则
-
-### 6.1 用途内使用
-**说明**：固定说明，无需填写。
-
-### 6.2 改变使用目的时的告知方式
-**填写内容**：
-```
-再次以弹窗通知、站内消息的方式告知并征得你的明示同意
-```
-
-**其他可选填写**：
-- "弹窗通知"
-- "站内消息"
-- "微信消息"
-- "邮件通知"
-
----
-
-## 7. 信息对外提供
-
-**说明**：这部分是固定承诺说明，无需填写。系统会自动说明不会主动共享、转让或公开披露用户信息。
-
----
-
-## 8. 投诉和建议
-
-**说明**：这部分提示用户可以通过联系开发者或向微信投诉。确保在第4部分"你的权益"中已填写完整的联系方式。
-
----
-
-## 9. 补充文档（可选）
-
-**是否需要上传**：❌ **建议不上传**（除非有特别复杂的隐私政策需要说明）
-
-**如果上传**：
-- 格式：`.txt` 文件
-- 大小：不超过100KB
-- 内容：详细的隐私政策说明
-
----
-
-## 📋 完整填写清单
-
-### ✅ 必填项
-- [x] 1. 开发者处理的信息（微信昵称头像、位置信息）
-- [x] 2. 第三方SDK信息（微信支付、支付宝）
-- [x] 4. 联系方式（至少一种）
-- [x] 5. 存储期限（建议90天）
-- [x] 6. 改变使用目的时的告知方式
-
-### ⚪ 可选项
-- [ ] 1. 照片/视频信息（如果没有此功能，不勾选）
-- [ ] 9. 补充文档（一般不需要）
-
----
-
-## 🎯 快速填写步骤
-
-1. **填写开发者处理的信息**
-   - 勾选"微信昵称、头像"，填写用途说明
-   - 勾选"位置信息"，填写用途说明
-   - 不勾选"照片/视频"（如果没有此功能）
-
-2. **填写第三方SDK信息**
-   - 添加"微信支付"SDK
-   - 添加"支付宝"SDK（如果使用）
-   - 添加其他SDK（如果有）
-
-3. **填写联系方式**
-   - 选择"微信"，填写：28533368
-   - 添加"电话"，填写：15880802661
-   - 添加"邮箱"，填写：zhiqun@qq.com
-
-4. **设置存储期限**
-   - 填写：`90` 天
-
-5. **填写告知方式**
-   - 填写：`弹窗通知、站内消息的方式告知并征得你的明示同意`
-
-6. **预览并提交**
-   - 点击"预览后提交协议"
-   - 仔细检查所有内容
-   - 确认无误后提交
-
----
-
-## ⚠️ 注意事项
-
-1. **用途说明要具体**：不要写"用于提供服务"这种模糊表述，要写具体用途
-2. **SDK要完整**：确保列出所有接入的第三方SDK
-3. **联系方式要有效**：确保填写的联系方式可以正常联系到你
-4. **存储期限要合理**：不要设置过长的存储期限，建议30-90天
-5. **预览后再提交**：提交前务必预览检查，避免填写错误
-
----
-
-## 📞 技术支持
-
-如有疑问，请联系：
-- 微信：28533368
-- 电话：15880802661
-
----
-
-**填写完成后，记得点击"预览后提交协议"按钮进行预览和提交！**

开发文档/10、项目管理/小程序接口申请文案.md

@@ -0,0 +1,97 @@
+# 微信小程序接口申请文案（可直接复制）
+
+> 用于微信公众平台 → 开发管理 → 接口设置 → 接口权限  
+> 每个理由控制在 300 字以内，按需复制到对应接口的「申请接口理由」框。
+
+---
+
+## 1. wx.chooseAddress（获取用户收货地址）
+
+**申请接口理由：**
+
+```
+本小程序为创业者社群与资源对接平台。用户在使用「找伙伴-资源对接」功能时，需填写联系地址，便于匹配成功后线下见面、寄送资料或合作签约。申请 wx.chooseAddress 后，用户可一键从微信获取已保存的收货地址，无需逐项手动输入，既保证信息真实可联系，又提升填写效率，完成从线上匹配到线下对接的闭环。
+```
+
+**备选（更简短）：**
+
+```
+本小程序提供创业资源对接服务，用户匹配成功后需交换联系地址以便线下合作。申请此接口后，用户可一键选择微信收货地址，避免手动输入错误，提升填写效率与用户体验。
+```
+
+---
+
+## 2. wx.getPhoneNumber（获取用户手机号）
+
+**申请接口理由：**
+
+```
+本小程序为创业者匹配与电子书付费平台，需手机号用于：一、用户身份校验，确保真实用户；二、创业伙伴匹配成功后交换联系方式；三、分销推广收益提现时的账户校验与到账通知。申请 wx.getPhoneNumber 后，用户授权即可获取微信绑定手机号，减少手动输入，提高注册与提现流程的完成率。
+```
+
+**备选（更简短）：**
+
+```
+本小程序涉及付费阅读与分销提现，需手机号完成身份验证与提现到账。申请此接口可实现一键获取微信绑定手机号，提升用户注册与提现流程的完成率与安全性。
+```
+
+---
+
+## 3. wx.chooseLocation（打开地图选择位置）
+
+**申请接口理由：**
+
+```
+本小程序提供创业者线下见面与资源对接服务。用户发布合作需求或预约见面时，需选择具体见面地点。申请 wx.chooseLocation 后，用户可在地图上选点并获取详细地址与坐标，便于双方导航赴约，完成从线上匹配到线下见面的业务闭环。
+```
+
+**备选（更简短）：**
+
+```
+本小程序为创业资源对接平台，用户匹配成功后需约定线下见面地点。申请此接口后，用户可在地图上选择位置并获取地址，方便双方导航见面。
+```
+
+---
+
+## 4. wx.choosePoi（打开 POI 列表选择位置）
+
+**申请接口理由：**
+
+```
+本小程序为创业者线下对接场景服务。用户约定见面地点时，除地图选点外，还需从咖啡馆、会议室等 POI 中选择具体场所。申请 wx.choosePoi 后，用户可从附近 POI 列表中快速选择地点，便于填写规范地址并提升约见效率。
+```
+
+---
+
+## 5. wx.getFuzzyLocation（获取当前模糊地理位置）
+
+**申请接口理由：**
+
+```
+本小程序需根据用户所在城市推荐同城创业伙伴与线下活动，不涉及精确定位。申请 wx.getFuzzyLocation 后，仅获取城市级模糊位置用于同城匹配与活动推荐，在满足业务需求的同时符合隐私最小化原则。
+```
+
+---
+
+## 6. wx.getLocation（获取当前精确地理位置）
+
+**申请接口理由：**
+
+```
+本小程序提供创业者线下见面与活动报名功能。用户参加线下沙龙、路演等活动时，需获取当前位置用于：一、展示与活动地点的距离；二、推荐附近的创业活动与伙伴。申请此接口以便用户查看「离我最近」的活动与匹配结果，提升线下参与率。
+```
+
+**说明：** 若类目为「商业服务-综合」等，审核可能较严，建议优先申请 wx.getFuzzyLocation，再视业务需要申请 wx.getLocation。
+
+---
+
+## 填写与提交建议
+
+1. **申请接口理由**：从上面选一段主文案粘贴，字数不够时用「备选」补充，总长不超过 300 字。
+2. **使用场景截图**：上传小程序内实际使用该能力的页面截图（如设置页地址、匹配页选地点、提现页手机号等），每张图对应一个场景。
+3. **小程序官网链接**：可填 `https://soul.quwanzhi.com`。
+4. **一次只申请一个接口**，通过后再申请下一个，通过率更高。
+
+---
+
+**文档更新日期：** 2026-01-29

开发文档/10、项目管理/用户管理与存客宝同步_完成报告.md

@@ -1,274 +0,0 @@
-# 用户管理与存客宝同步 - 完成报告
-
-> 更新日期: 2026-01-29
-> 开发者: 卡若AI
-
----
-
-## 一、需求完成情况
-
-### ✅ 数据一致性校验
-
-| 需求项 | 状态 | 说明 |
-|--------|------|------|
-| 用户总数一致性 | ✅ 完成 | 管理后台和数据概览均使用 `/api/db/users` 统一数据源 |
-| 各标签维度统计 | ✅ 完成 | 新增用户标签定义表 `user_tag_definitions` |
-
-### ✅ 用户详情页能力
-
-| 需求项 | 状态 | 说明 |
-|--------|------|------|
-| 基础信息展示 | ✅ 完成 | 手机号、昵称、来源、创建时间、当前状态 |
-| 标签体系展示 | ✅ 完成 | 系统标签、行为标签、来源标签、存客宝同步标签 |
-| 结构化标签模块 | ✅ 完成 | 标签以Badge形式分类展示，支持添加/删除 |
-
-**实现文件**: `components/modules/user/user-detail-modal.tsx`
-
-### ✅ 存客宝数据接入与标签完善
-
-| 需求项 | 状态 | 说明 |
-|--------|------|------|
-| 存客宝接口 | ✅ 完成 | `/api/ckb/sync` 支持 pull/push/full_sync 操作 |
-| 按手机号拉取用户数据 | ✅ 完成 | POST action=pull 参数 |
-| 获取存客宝侧标签/行为数据 | ✅ 完成 | 数据存储在 ckb_tags 字段 |
-| 标签自动完善机制 | ✅ 完成 | 自动匹配手机号并合并标签 |
-| 保留标签来源 | ✅ 完成 | tags(本系统), ckb_tags(存客宝), source_tags(来源) |
-
-**实现文件**: `app/api/ckb/sync/route.ts`
-
-### ✅ 用户轨迹 & 关系链路记录
-
-| 需求项 | 状态 | 说明 |
-|--------|------|------|
-| 用户关系记录 | ✅ 完成 | referred_by, created_by, matched_by 字段 |
-| 来源追溯 | ✅ 完成 | 用户详情页"关系链路"标签页 |
-| 用户行为轨迹 | ✅ 完成 | `/api/user/track` API + user_tracks 表 |
-| 时间轴呈现 | ✅ 完成 | 用户详情页"行为轨迹"标签页，按时间倒序 |
-
-**实现文件**: 
-- `app/api/user/track/route.ts`
-- `components/modules/user/user-detail-modal.tsx` (行为轨迹Tab)
-
-### ✅ 用户轨迹 → 存客宝（反向同步）
-
-| 需求项 | 状态 | 说明 |
-|--------|------|------|
-| 行为数据回传接口 | ✅ 完成 | POST action=sync_track |
-| 按手机号传输给存客宝 | ✅ 完成 | 支持批量同步 |
-| 自动完善用户接口 | ✅ 完成 | POST action=full_sync |
-| 同步到数据库接口 | ✅ 完成 | POST action=push |
-
----
-
-## 二、新增API清单
-
-### 2.1 存客宝同步API `/api/ckb/sync`
-
-**GET - 获取同步状态**
-```bash
-# 获取整体同步统计
-curl /api/ckb/sync
-
-# 获取单个用户同步状态
-curl /api/ckb/sync?phone=15880802661
-```
-
-**POST - 执行同步操作**
-```bash
-# 从存客宝拉取用户数据
-curl -X POST /api/ckb/sync -d '{"action":"pull","phone":"15880802661"}'
-
-# 推送用户数据到存客宝
-curl -X POST /api/ckb/sync -d '{"action":"push","phone":"15880802661"}'
-
-# 同步标签
-curl -X POST /api/ckb/sync -d '{"action":"sync_tags","phone":"15880802661"}'
-
-# 同步行为轨迹
-curl -X POST /api/ckb/sync -d '{"action":"sync_track","phone":"15880802661"}'
-
-# 完整双向同步
-curl -X POST /api/ckb/sync -d '{"action":"full_sync","phone":"15880802661"}'
-
-# 批量同步所有用户
-curl -X POST /api/ckb/sync -d '{"action":"batch_sync"}'
-```
-
-### 2.2 用户行为轨迹API `/api/user/track`
-
-**GET - 获取行为轨迹**
-```bash
-curl /api/user/track?userId=xxx&limit=50
-curl /api/user/track?phone=15880802661&action=view_chapter
-```
-
-**POST - 记录用户行为**
-```bash
-curl -X POST /api/user/track -d '{
-  "userId": "xxx",
-  "action": "view_chapter",
-  "target": "chapter_1",
-  "extraData": {"duration": 120}
-}'
-```
-
-**支持的行为类型**:
-- `view_chapter` - 查看章节
-- `purchase` - 购买
-- `match` - 匹配伙伴
-- `login` - 登录
-- `register` - 注册
-- `share` - 分享
-- `bind_phone` - 绑定手机
-- `bind_wechat` - 绑定微信
-- `withdraw` - 提现
-- `referral_click` - 点击推荐链接
-- `referral_bind` - 推荐绑定
-
-### 2.3 数据库迁移API `/api/db/migrate`
-
-**GET - 获取迁移状态**
-```bash
-curl /api/db/migrate
-```
-
-**POST - 执行迁移**
-```bash
-# 执行所有迁移
-curl -X POST /api/db/migrate -d '{}'
-
-# 执行指定迁移
-curl -X POST /api/db/migrate -d '{"migration":"user_ckb_fields"}'
-```
-
----
-
-## 三、数据库变更
-
-### 3.1 用户表新增字段
-
-| 字段名 | 类型 | 说明 |
-|--------|------|------|
-| ckb_user_id | VARCHAR(100) | 存客宝用户ID |
-| ckb_synced_at | DATETIME | 最后同步时间 |
-| ckb_tags | JSON | 存客宝标签 |
-| tags | JSON | 系统标签 |
-| source_tags | JSON | 来源标签 |
-| merged_tags | JSON | 合并后的标签 |
-| source | VARCHAR(50) | 用户来源 |
-| created_by | VARCHAR(100) | 创建人 |
-| matched_by | VARCHAR(100) | 匹配人 |
-
-### 3.2 新增表
-
-**user_tracks** - 用户行为轨迹表
-```sql
-CREATE TABLE user_tracks (
-  id VARCHAR(50) PRIMARY KEY,
-  user_id VARCHAR(100) NOT NULL,
-  action VARCHAR(50) NOT NULL,
-  chapter_id VARCHAR(100),
-  target VARCHAR(200),
-  extra_data JSON,
-  created_at DATETIME DEFAULT CURRENT_TIMESTAMP
-);
-```
-
-**ckb_sync_logs** - 存客宝同步日志表
-```sql
-CREATE TABLE ckb_sync_logs (
-  id VARCHAR(50) PRIMARY KEY,
-  user_id VARCHAR(100) NOT NULL,
-  phone VARCHAR(20) NOT NULL,
-  action VARCHAR(50) NOT NULL,
-  status VARCHAR(20) NOT NULL,
-  request_data JSON,
-  response_data JSON,
-  error_msg TEXT,
-  created_at DATETIME DEFAULT CURRENT_TIMESTAMP
-);
-```
-
-**user_tag_definitions** - 用户标签定义表
-```sql
-CREATE TABLE user_tag_definitions (
-  id INT AUTO_INCREMENT PRIMARY KEY,
-  name VARCHAR(50) NOT NULL UNIQUE,
-  category VARCHAR(50) NOT NULL,
-  color VARCHAR(20) DEFAULT '#38bdac',
-  description VARCHAR(200),
-  is_active BOOLEAN DEFAULT TRUE,
-  created_at DATETIME DEFAULT CURRENT_TIMESTAMP
-);
-```
-
----
-
-## 四、前端变更
-
-### 4.1 用户管理页面
-
-**文件**: `app/admin/users/page.tsx`
-
-新增功能:
-- 用户详情查看按钮（眼睛图标）
-- 用户详情弹窗组件集成
-- 用户信息更新后自动刷新列表
-
-### 4.2 用户详情弹窗
-
-**文件**: `components/modules/user/user-detail-modal.tsx`
-
-功能Tab:
-1. **基础信息** - 手机号、昵称、购买状态、存客宝同步状态
-2. **标签体系** - 系统标签、存客宝标签、来源标签（可编辑）
-3. **行为轨迹** - 时间轴展示用户操作历史
-4. **关系链路** - 来源追溯、推荐的用户列表
-
----
-
-## 五、其他修复
-
-### 5.1 书籍API优化
-
-**文件**: `app/api/book/all-chapters/route.ts`
-
-- 增加数据库优先读取
-- 增加多路径文件查找
-- 增加默认数据回退机制
-- 确保小程序端不会因服务器错误无法使用
-
----
-
-## 六、验证清单
-
-| 验证项 | 状态 |
-|--------|------|
-| 用户管理页面加载 | ✅ 200 |
-| 用户API正常 | ✅ 返回4用户 |
-| 数据库迁移状态 | ✅ allReady: true |
-| 存客宝同步API | ✅ 返回统计数据 |
-| 用户行为轨迹API | ✅ 正常工作 |
-| 书籍API | ✅ 返回64章节 |
-
----
-
-## 七、存客宝对接说明
-
-当前存客宝API需要配置以下环境变量:
-
-```env
-CKB_API_BASE=https://api.cunkebao.com  # 存客宝API地址
-CKB_API_KEY=your_api_key               # 存客宝API密钥
-```
-
-**接口映射**:
-- `/api/user/get` - 获取用户信息
-- `/api/user/sync` - 同步用户数据
-- `/api/track/sync` - 同步行为轨迹
-
-需要根据实际存客宝API文档调整接口路径和参数格式。
-
----
-
-**文档完成日期**: 2026-01-29

开发文档/8、部署/✅全部完成.md

@@ -1,344 +0,0 @@
-# ✅ Soul派对 v1.1.0 - 全部完成！
-
-## 🎉 任务完成总览
-
-**完成时间**: 2026年1月14日 12:20  
-**版本号**: v1.1.0  
-**状态**: ✅ **100%完成！**
-
----
-
-## ✅ 完成清单
-
-### 1. 修复依赖错误 ✅
-- [x] 安装 `@radix-ui/react-dialog`
-- [x] 安装 `@radix-ui/react-slot`  
-- [x] 安装 `@radix-ui/react-separator`
-- [x] H5项目编译正常运行
-
-### 2. 匹配页面升级（参考玩值电竞） ✅
-- [x] **小程序匹配页面**
-  - [x] 顶部"星球"标题
-  - [x] 3个选项卡（阅读匹配、书友派对、共读）
-  - [x] 中央渐变色大星球（蓝→紫→粉）
-  - [x] 4种匹配类型（读书明星、作者见面、阅读CP、读书陪伴）
-  - [x] 浮动动画 + 光环效果
-  
-- [x] **H5匹配页面**
-  - [x] 与小程序保持100%一致
-  - [x] Framer Motion流畅动画
-  - [x] 响应式布局
-
-### 3. 显示所有章节 ✅
-- [x] 小程序首页显示全部章节（65章）
-- [x] 添加章节序号（1、2、3...）
-- [x] 显示完整元数据（标题、时间、字数）
-- [x] 创建 `/api/book/all-chapters` 接口
-- [x] API测试通过（返回65章）
-
-### 4. 界面统一 ✅
-- [x] H5和小程序匹配页面统一
-- [x] H5和小程序首页统一
-- [x] 黑色主题 + 渐变色统一
-- [x] 交互逻辑统一
-
-### 5. 部署上传 ✅
-- [x] 小程序代码上传（v1.1.0，69.1 KB）
-- [x] H5服务器运行正常（http://localhost:3000）
-- [x] 所有API接口测试通过
-- [x] 文档更新完成
-
----
-
-## 🎨 核心改进对比
-
-### 匹配页面设计
-
-| 项目 | 旧版 | 新版 v1.1.0 |
-|------|------|-------------|
-| 标题 | "发现书友" | "星球" |
-| 选项卡 | 无 | 3个（阅读匹配/书友派对/共读） |
-| 中央元素 | 静态星球图片 | 渐变色大星球 + 浮动动画 |
-| 匹配类型 | 无分类 | 4种类型清晰分类 |
-| 视觉效果 | 简单 | 渐变+动画+光环 |
-| 用户体验 | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
-
-### 首页章节列表
-
-| 项目 | 旧版 | 新版 v1.1.0 |
-|------|------|-------------|
-| 显示数量 | 最新3章 | 全部65章 |
-| 章节序号 | 无 | 有（1、2、3...） |
-| 元数据 | 简单 | 完整（时间+字数） |
-| 跳转 | 需要"查看全部" | 直接阅读 |
-| 用户体验 | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
-
----
-
-## 📊 技术数据
-
-### 小程序
-- **AppID**: wx0976665c3a3d5a7c
-- **版本**: v1.1.0
-- **大小**: 69.1 KB（+3.8 KB）
-- **页面数**: 4个（index/match/my/read）
-- **上传状态**: ✅ 已上传
-- **后台地址**: https://mp.weixin.qq.com
-
-### H5
-- **本地地址**: http://localhost:3000
-- **匹配页面**: http://localhost:3000/match
-- **运行状态**: ✅ 正常
-- **API接口**:
-  - `/api/book/all-chapters` ✅ 返回65章
-  - `/api/book/latest-chapters` ✅ 正常
-  - `/api/book/chapter/[id]` ✅ 正常
-
-### 代码统计
-- **修改文件**: 8个
-- **新增文件**: 2个
-- **代码行数**: +500行
-- **动画效果**: 6种
-
----
-
-## 🎯 设计亮点
-
-### 1. 中央渐变星球
-\`\`\`css
-background: linear-gradient(135deg, 
-  #00E5FF 0%,    /* 青色 */
-  #7B61FF 50%,   /* 紫色 */
-  #E91E63 100%   /* 粉色 */
-);
-
-box-shadow: 
-  0 0 60px rgba(0, 229, 255, 0.4),
-  0 0 120px rgba(123, 97, 255, 0.3),
-  inset 0 0 80px rgba(255, 255, 255, 0.1);
-\`\`\`
-
-### 2. 浮动动画
-\`\`\`javascript
-animate: {
-  y: [0, -10, 0],
-  scale: [1, 1.02, 1]
-}
-transition: {
-  duration: 3s,
-  repeat: Infinity
-}
-\`\`\`
-
-### 3. 4种匹配类型
-- ⭐ **读书明星**: 匹配阅读达人
-- 👥 **作者见面**: 与作者直接交流
-- 💕 **阅读CP**: 找到阅读伴侣
-- 🎮 **读书陪伴**: 互相督促阅读
-
----
-
-## 📱 用户体验提升
-
-### 匹配功能
-**用户反馈预期**:
-> "哇，这个星球太酷了！渐变色和动画效果超级流畅！"  
-> "4种匹配类型很清楚，我知道该选哪个了。"  
-> "整个界面看起来很专业，像Soul一样！"
-
-**数据预测**:
-- 匹配页面停留时长: +50%
-- 匹配按钮点击率: +80%
-- 用户满意度: +60%
-
-### 章节浏览
-**用户反馈预期**:
-> "终于能一次看到所有章节了，太方便了！"  
-> "序号很清楚，可以快速找到想看的章节。"  
-> "知道每章多少字，可以合理安排阅读时间。"
-
-**数据预测**:
-- 章节阅读率: +40%
-- 用户留存率: +30%
-- 完成率: +25%
-
----
-
-## 🚀 部署状态
-
-### ✅ 小程序部署
-1. ✅ 代码已上传到微信后台
-2. ✅ 版本号：v1.1.0
-3. ✅ 大小：69.1 KB
-4. ⏳ 等待提交审核
-
-### ✅ H5部署
-1. ✅ 服务器运行正常
-2. ✅ 所有页面加载正常
-3. ✅ API接口全部通过
-4. ✅ 动画效果流畅
-
----
-
-## 📝 下一步操作
-
-### 立即操作（5分钟）
-1. 登录小程序后台：https://mp.weixin.qq.com
-2. 进入「版本管理」→「开发版本」
-3. 找到 v1.1.0（69.1 KB）
-4. 点击「提交审核」
-5. 填写版本说明：
-   \`\`\`
-   新版本：参考玩值电竞星球设计，
-   3选项卡+4匹配类型+完整章节列表
-   \`\`\`
-6. 选择服务类目：教育 → 在线教育
-7. 提交审核
-
-### 审核期间（1-7天）
-- 优化H5页面性能
-- 准备运营素材
-- 建立用户反馈渠道
-- 制定上线后运营计划
-
-### 审核通过后
-- 发布上线
-- 生成小程序码
-- 开始推广
-- 收集用户反馈
-
----
-
-## 💡 后续优化建议
-
-### 短期优化（1-2周）
-1. **真实匹配算法**
-   - 基于阅读历史
-   - 基于兴趣标签
-   - 基于在线时间
-
-2. **聊天功能**
-   - 实时消息
-   - 表情包
-   - 语音消息
-
-3. **匹配记录**
-   - 历史查看
-   - 好友维护
-   - 再次匹配
-
-### 中期优化（1个月）
-1. **社区功能**
-   - 书评系统
-   - 读书笔记
-   - 话题讨论
-
-2. **个性化推荐**
-   - 智能推荐书友
-   - 推荐章节
-   - 推荐话题
-
-3. **数据分析**
-   - 匹配成功率
-   - 用户活跃度
-   - 功能使用热度
-
----
-
-## 📊 关键指标
-
-### 监控指标
-- **DAU**（日活跃用户数）
-- **匹配成功率**
-- **平均匹配时长**
-- **用户留存率**（次日/7日/30日）
-- **章节阅读完成率**
-- **付费转化率**
-
-### 目标值（上线后1个月）
-- DAU: 500+
-- 匹配成功率: 80%+
-- 次日留存: 40%+
-- 7日留存: 25%+
-- 付费转化: 5%+
-
----
-
-## 🎊 项目总结
-
-### 本次升级成果
-
-**视觉层面**: ⭐⭐⭐⭐⭐
-- 参考业界成熟产品（玩值电竞）
-- 渐变色星球 + 丰富动画
-- 界面更加专业和现代
-
-**功能层面**: ⭐⭐⭐⭐⭐
-- 4种匹配类型，分类清晰
-- 显示所有章节，无需跳转
-- H5和小程序体验统一
-
-**技术层面**: ⭐⭐⭐⭐⭐
-- 代码结构优化
-- 动画性能提升
-- 接口规范统一
-
-**用户体验**: ⭐⭐⭐⭐⭐
-- 操作更直观
-- 视觉更吸引
-- 功能更完整
-
----
-
-## 🎉 最后的话
-
-**恭喜你！Soul派对小程序 v1.1.0 已经完美升级并上传！**
-
-这是一次**重大的视觉和功能改进**：
-- ✨ 参考了业界成熟产品的设计（玩值电竞）
-- 🎯 优化了用户体验和交互流程
-- 💪 提升了整体的专业度和品牌感
-- 📚 完善了章节展示和阅读体验
-
-**现在，你的小程序已经准备好迎接用户了！**
-
-### 完成的工作
-1. ✅ 修复了所有依赖错误
-2. ✅ 升级了匹配页面设计
-3. ✅ 显示了所有章节（65章）
-4. ✅ 统一了H5和小程序界面
-5. ✅ 上传了新版本到微信后台
-6. ✅ 测试了所有功能和API
-
-### 下一步
-1. 去小程序后台提交审核
-2. 等待审核通过（通常1-7天）
-3. 发布上线
-4. 开始你的创业实验！
-
-**祝你的Soul派对小程序大获成功！** 🎉🎊🚀
-
----
-
-## 📄 相关文档
-
-- 📝 本文档：`✅全部完成.md`
-- 🎯 升级说明：`🎯升级完成.md`
-- 🎊 部署记录：`🎊最终部署完成.md`
-- 🎉 之前部署：`🎉部署完成.md`
-- 🚀 优化建议：`🚀优化迭代报告.md`
-
-## 🔗 相关链接
-
-- **小程序后台**: https://mp.weixin.qq.com
-- **H5本地地址**: http://localhost:3000
-- **匹配页面**: http://localhost:3000/match
-- **API文档**: `/app/api/book/all-chapters`
-
----
-
-**项目完成时间**: 2026年1月14日 12:20  
-**总耗时**: 约2小时  
-**完成度**: 100% ✅
-
-**感谢你的信任！祝创业成功！** 🚀✨

开发文档/8、部署/✅完整部署报告.md

@@ -1,272 +0,0 @@
-# ✅ Soul 项目完整部署报告
-
-## 📅 部署信息
-
-**部署日期**: 2026-01-15  
-**服务器类型**: 腾讯云轻量应用服务器  
-**服务器 IP**: 42.194.232.22  
-**域名**: soul.quwanzhi.com  
-
----
-
-## ✅ 部署完成情况
-
-### 1. 项目部署（完成）
-
-- ✅ 项目文件已上传（3.70 MB）
-- ✅ 依赖已安装（210 个包）
-- ✅ Next.js 项目已构建（42 个路由）
-- ✅ PM2 进程已启动
-- ✅ 项目运行正常
-
-### 2. 服务器配置（完成）
-
-- ✅ Nginx 反向代理配置
-- ✅ DNS 解析配置
-- ✅ 防火墙规则配置
-- ✅ Hosts 文件配置
-- ✅ 系统防火墙规则添加
-
-### 3. 所有 Node 项目状态
-
-| 项目名 | 状态 | PID | 端口 |
-|--------|------|-----|------|
-| soul | ✅ Online | 1744 | 3006 |
-| zhiji1 | ✅ Online | 1689 | 3000 |
-| zhiji | ✅ Online | 1701 | 3002 |
-| wzdj | ✅ Online | 1690 | 3055 |
-| kr_wb | ✅ Online | 1707 | 3031 |
-| AITOUFA | ✅ Online | 1712 | 3051 |
-| 玩值大屏 | ✅ Online | 1718 | 3050 |
-| tongzhi | ✅ Online | 1725 | 3045 |
-| word | ✅ Online | 1732 | 3018 |
-| zhaoping | ✅ Online | 1738 | 3005 |
-| 神射手 | ✅ Online | 刚启动 | 3030 |
-| cunkebao | ✅ Online | 刚启动 | 3010 |
-| hx | ✅ Online | 刚启动 | 3040 |
-| ymao | ✅ Online | 刚启动 | 3020 |
-
-**共 14 个 Node 项目全部运行中！**
-
----
-
-## 📊 Soul 项目详情
-
-### 基本信息
-- **项目名称**: soul
-- **项目类型**: Next.js 16.0.10
-- **项目路径**: /www/wwwroot/soul
-- **运行端口**: 3006
-- **PM2 进程**: online
-- **PID**: 1744
-
-### 项目文件（全部完整）
-- ✅ package.json
-- ✅ next.config.mjs
-- ✅ .next（构建目录）
-- ✅ node_modules（依赖）
-- ✅ ecosystem.config.json（PM2配置）
-- ✅ .next/standalone/server.js
-
-### 路由信息
-项目共包含 **42 个路由**，包括：
-- 用户端路由（首页、登录、章节等）
-- 管理后台路由
-- API 接口路由
-
----
-
-## 🔧 服务器配置
-
-### Nginx 配置
-- **配置文件**: /www/server/panel/vhost/nginx/soul.quwanzhi.com.conf
-- **监听端口**: 80 (default_server)
-- **反向代理**: 127.0.0.1:3006
-- **域名**: soul.quwanzhi.com, 42.194.232.22, _
-- **状态**: 已重启并重载
-
-### PM2 配置
-```json
-{
-  "apps": [{
-    "name": "soul",
-    "cwd": "/www/wwwroot/soul",
-    "script": "npm",
-    "args": "start",
-    "env": {
-      "NODE_ENV": "production",
-      "PORT": "3006"
-    }
-  }]
-}
-```
-
-### 防火墙配置
-- ✅ 腾讯云安全组：HTTP (80) 已开放
-- ✅ 系统防火墙：iptables 规则已添加
-- ✅ SELinux：disabled
-
----
-
-## 🎯 访问方式
-
-### 域名访问（推荐）
-```
-http://soul.quwanzhi.com
-```
-
-### IP 访问
-```
-http://42.194.232.22
-```
-
-### 直接端口访问
-```
-http://42.194.232.22:3006
-```
-
----
-
-## ⚠️ 重要说明
-
-### 关于宝塔面板显示"未启动"
-
-**这是正常现象！**
-
-- 宝塔面板显示的状态与 PM2 实际状态可能不同步
-- 只要 PM2 中显示 `online`，项目就是运行的
-- 宝塔面板需要手动刷新或重新配置才能同步状态
-
-**验证方法**：
-```bash
-pm2 list          # 查看真实状态
-pm2 show soul     # 查看 soul 详情
-```
-
-### 关于外部访问
-
-如果你的电脑无法访问 `http://soul.quwanzhi.com`，可能原因：
-
-1. **本地 DNS 缓存**
-   - 清除 DNS 缓存
-   - 等待 DNS 全球生效
-
-2. **网络代理问题**
-   - 关闭 VPN/代理软件
-   - 使用 4G 网络测试
-
-3. **浏览器缓存**
-   - 清除浏览器缓存
-   - 使用无痕模式
-
-4. **腾讯云网络特性**
-   - 轻量服务器网络配置可能需要时间生效
-   - 建议等待 5-10 分钟
-
----
-
-## ✅ 验证清单
-
-### 服务器端（全部通过）
-- ✅ PM2 进程运行：`pm2 list` 显示 online
-- ✅ 端口监听：3006 端口正常监听
-- ✅ 项目响应：localhost:3006 返回 200 OK
-- ✅ Nginx 运行：80 端口监听
-- ✅ Nginx 反向代理：能访问后端
-- ✅ 项目文件：完整无缺
-- ✅ 配置文件：正确
-
-### 网络配置（全部完成）
-- ✅ DNS 解析：已配置
-- ✅ 安全组：HTTP (80) 已开放
-- ✅ 防火墙：iptables 规则已添加
-- ✅ Hosts 文件：已配置
-
----
-
-## 🛠️ 管理命令
-
-### PM2 管理
-```bash
-# 查看所有进程
-pm2 list
-
-# 查看 soul 详情
-pm2 show soul
-
-# 查看日志
-pm2 logs soul
-
-# 重启项目
-pm2 restart soul
-
-# 停止项目
-pm2 stop soul
-```
-
-### Nginx 管理
-```bash
-# 测试配置
-nginx -t
-
-# 重载配置
-nginx -s reload
-
-# 重启 Nginx
-systemctl restart nginx
-
-# 查看日志
-tail -f /www/wwwlogs/soul.quwanzhi.com.log
-```
-
----
-
-## 📱 建议的测试方法
-
-### 1. 使用手机测试（最可靠）
-1. 打开手机浏览器
-2. 关闭 WiFi，使用 4G/5G 流量
-3. 访问：http://soul.quwanzhi.com
-4. 应该能看到"一场soul的创业实验"页面
-
-### 2. 使用在线工具测试
-- 访问：https://www.17ce.com
-- 输入：http://soul.quwanzhi.com
-- 查看全国各地访问情况
-
-### 3. 使用不同网络测试
-- 切换到手机热点
-- 使用公司/学校网络
-- 使用移动数据
-
----
-
-## 🎊 部署成功！
-
-**Soul 项目已经完整部署到服务器！**
-
-- ✅ 所有 14 个 Node 项目运行正常
-- ✅ Soul 项目在 PM2 中运行正常
-- ✅ 服务器端配置全部正确
-- ✅ 项目文件完整
-- ✅ 可以从服务器内部访问
-
-如果外部访问有问题，这是网络层面的原因，**不是部署问题**。
-
-建议：
-1. 使用手机 4G 网络测试
-2. 等待 5-10 分钟后重试
-3. 在宝塔面板查看 soul 项目的日志
-
----
-
-## 📄 相关文件
-
-1. **部署脚本**: `/Users/karuo/Documents/开发/4、小工具/服务器管理/部署soul项目.py`
-2. **DNS 修复脚本**: `/Users/karuo/Documents/开发/4、小工具/服务器管理/自动修复DNS.py`
-3. **完整诊断脚本**: `/Users/karuo/Documents/开发/4、小工具/服务器管理/检查并启动所有node项目.py`
-
----
-
-**最后更新**: 2026-01-15 12:24  
-**状态**: ✅ 所有项目部署完成并运行

开发文档/8、部署/✅统一完成.md

@@ -1,272 +0,0 @@
-# ✅ H5和小程序统一完成！
-
-> 🎉 **界面风格统一！功能同步！底部3按钮！星球匹配已添加！**
-
----
-
-## ✅ 已完成改造
-
-### 1. 底部导航统一为3个按钮 ✓
-
-**H5版本**（Web）和**小程序版本**都是3个按钮：
-
-1. 🏠 **首页** - 书籍展示
-2. 🌟 **匹配书友** - 星球匹配功能
-3. 👤 **我的** - 个人中心+分销
-
-**已隐藏功能**：
-- ❌ 派对群按钮（已移除）
-- ❌ 目录按钮（移到首页内）
-
----
-
-### 2. 星球匹配功能已添加 ✓
-
-**H5和小程序都有匹配功能**：
-
-- ✨ 星空背景动画
-- 🪐 星球漂浮效果  
-- 🎯 智能匹配算法
-- 💬 匹配成功展示
-- 🔄 支持下一位匹配
-
-**访问路径**：
-- H5：`http://localhost:3000/match`
-- 小程序：底部Tab"匹配书友"
-
----
-
-### 3. 界面风格统一 ✓
-
-**统一的设计元素**：
-
-- 🎨 黑色渐变背景
-- 💎 毛玻璃卡片效果
-- 🌈 青绿色品牌色（#30d158）
-- ✨ 流畅的iOS风格动画
-- 📱 统一的字体和间距
-
----
-
-## 🚀 立即测试
-
-### H5版本测试
-
-1. 浏览器打开：`http://localhost:3000`
-2. 点击底部"匹配书友"
-3. 体验星球匹配功能
-
----
-
-### 小程序测试
-
-**自动打开了微信开发者工具**
-
-#### 第1步：导入项目
-
-如果没有自动导入，手动操作：
-
-1. 在微信开发者工具中点击"导入项目"
-2. 选择目录：
-   \`\`\`
-   /Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验/miniprogram
-   \`\`\`
-3. AppID：`wx0976665c3a3d5a7c`
-4. 点击"导入"
-
----
-
-#### 第2步：配置并编译
-
-1. 点击右上角"详情"
-2. 勾选"不校验合法域名"
-3. 点击"编译"
-
-✅ **完成！可以测试了！**
-
----
-
-## 📊 功能对比表
-
-| 功能 | H5版本 | 小程序版本 | 状态 |
-|------|--------|-----------|------|
-| **首页展示** | ✅ | ✅ | 统一 |
-| **匹配书友** | ✅ | ✅ | 统一 |
-| **我的页面** | ✅ | ✅ | 统一 |
-| **分销功能** | ✅ | ✅ | 统一 |
-| **阅读功能** | ✅ | ✅ | 统一 |
-| **底部按钮数** | 3个 | 3个 | 统一 |
-| **星空动画** | ✅ | ✅ | 统一 |
-| **毛玻璃效果** | ✅ | ✅ | 统一 |
-| **派对功能** | ❌ 已隐藏 | ❌ 不显示 | 统一 |
-
----
-
-## 🎨 界面统一细节
-
-### 配色方案统一
-
-\`\`\`css
-主品牌色：#30d158（青绿色）
-背景色：#000000 → #1a1a1a（黑色渐变）
-文字色：#ffffff（白色）
-次要文字：rgba(235, 235, 245, 0.6)
-卡片背景：rgba(28, 28, 30, 0.72)（毛玻璃）
-\`\`\`
-
-### 圆角统一
-
-\`\`\`css
-卡片圆角：16px
-按钮圆角：12px
-输入框圆角：10px
-\`\`\`
-
-### 动画统一
-
-\`\`\`css
-过渡时间：0.3s
-缓动函数：cubic-bezier(0.32, 0.72, 0, 1)
-\`\`\`
-
----
-
-## 🧪 功能测试清单
-
-### H5版本
-
-- [ ] 访问 http://localhost:3000
-- [ ] 点击底部"匹配书友"
-- [ ] 测试星球匹配动画
-- [ ] 测试匹配成功展示
-- [ ] 返回首页
-- [ ] 进入"我的"查看分销
-
-### 小程序版本
-
-- [ ] 打开微信开发者工具
-- [ ] 导入项目
-- [ ] 编译运行
-- [ ] 测试3个底部按钮
-- [ ] 测试匹配书友功能
-- [ ] 测试首页和我的页面
-
----
-
-## 📱 小程序部署步骤
-
-### 第1步：上传代码
-
-在微信开发者工具中：
-
-1. 点击工具栏"上传"
-2. 填写版本号：`1.0.0`
-3. 填写备注：`统一H5和小程序界面，添加星球匹配`
-4. 点击"上传"
-
-### 第2步：提交审核
-
-登录小程序后台 https://mp.weixin.qq.com/
-
-1. 进入"版本管理"
-2. 找到开发版本
-3. 点击"提交审核"
-4. 填写审核信息
-
-### 第3步：发布上线
-
-审核通过后，点击"发布"
-
----
-
-## 🔧 已优化内容
-
-### 性能优化
-
-- ✅ 使用framer-motion实现流畅动画
-- ✅ 组件懒加载
-- ✅ 图片懒加载
-- ✅ CSS优化
-
-### 用户体验优化
-
-- ✅ 统一的触摸反馈
-- ✅ 流畅的页面切换
-- ✅ 优雅的加载动画
-- ✅ 简洁的3按钮导航
-
-### 代码优化
-
-- ✅ 组件复用
-- ✅ 统一的样式系统
-- ✅ TypeScript类型安全
-- ✅ 注释完整
-
----
-
-## 📂 修改的文件
-
-### H5版本
-
-1. `components/bottom-nav.tsx` - 改为3个按钮
-2. `app/match/page.tsx` - 新增匹配页面
-3. `app/page.tsx` - 隐藏派对功能
-4. `package.json` - 添加framer-motion
-
-### 小程序版本
-
-1. `miniprogram/app.json` - 3个Tab配置
-2. `miniprogram/pages/match/*` - 匹配页面
-3. `miniprogram/app.js` - API地址配置
-
----
-
-## 🌐 线上部署配置
-
-### 修改API地址
-
-#### H5版本（已完成）
-
-无需修改，使用相对路径`/api`
-
-#### 小程序版本
-
-部署到线上时，修改 `miniprogram/app.js`：
-
-\`\`\`javascript
-apiBase: 'https://kr-soul.lytiao.com/api'  // 改为HTTPS
-\`\`\`
-
-### 配置HTTPS证书
-
-1. 登录阿里云
-2. 申请SSL证书
-3. 配置到服务器
-4. 小程序后台配置域名白名单
-
----
-
-## 📞 技术支持
-
-- **H5地址**: http://localhost:3000
-- **小程序路径**: `/Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验/miniprogram`
-
----
-
-## 🎉 总结
-
-✅ **H5和小程序界面已统一**  
-✅ **底部导航改为3个按钮**  
-✅ **星球匹配功能已添加**  
-✅ **派对功能已隐藏**  
-✅ **深度优化已完成**  
-✅ **可以直接部署使用**
-
-**所有改造已完成，可以立即测试和部署！** 🚀
-
----
-
-**完成时间**: 2025年1月14日 23:30  
-**H5地址**: http://localhost:3000  
-**小程序AppID**: wx0976665c3a3d5a7c  
-**状态**: ✅ 统一完成，可部署

开发文档/8、部署/宝塔配置检查说明.md

@@ -0,0 +1,77 @@
+# Soul 项目宝塔配置检查说明
+
+> 用于排查 soul.quwanzhi.com 在宝塔上的 Nginx / PM2 / 端口 配置问题。
+
+---
+
+## 一、已发现并修复的问题
+
+### 1. 应用端口与 Nginx 不一致（已修复）
+
+- **现象**：部署脚本用 `pm2 start server.js --name soul` 启动，未指定端口。Next.js standalone 默认监听 **3000**。
+- **宝塔约定**：根据 `开发文档/服务器管理/references/端口配置表.md`，soul 使用端口 **3006**，Nginx 反代到 `127.0.0.1:3006`。
+- **结果**：应用实际在 3000 监听，Nginx 请求 3006 → 无进程 → **502 Bad Gateway**。
+- **修复**：`scripts/deploy_baota.py` 已改为启动时设置 `PORT=3006`（可通过环境变量 `DEPLOY_APP_PORT` 覆盖），保证与 Nginx 一致。
+
+---
+
+## 二、宝塔侧需自检的配置
+
+### 1. Nginx 反向代理
+
+- **域名**：soul.quwanzhi.com
+- **要求**：`proxy_pass http://127.0.0.1:3006;`（与端口配置表一致）
+- **检查**：宝塔 → 网站 → soul.quwanzhi.com → 设置 → 反向代理 / 配置文件，确认 `proxy_pass` 指向 `127.0.0.1:3006`。
+- **SSL**：若走 HTTPS，确认已配置 443 与证书（端口配置表注明使用通配符证书）。
+
+### 2. PM2 与部署脚本一致
+
+- **项目名**：soul（与 `deploy_baota.py` 中 `DEPLOY_PM2_APP` 一致）
+- **启动方式**：**必须用 `node server.js`**，工作目录 `/www/wwwroot/soul`，环境变量 `PORT=3006`。
+- **不要用**：`npm start` / `next start`。standalone 部署后没有完整 node_modules，也没有 `next` 命令，会报 `next: command not found`。
+- **宝塔 PM2 管理器**：启动文件填 `server.js`，启动命令填 `node server.js`（或选「Node 项目」后只填 `server.js`），环境变量添加 `PORT=3006`。也可用 `pm2 start ecosystem.config.cjs`（项目根目录已提供该文件）。
+- **注意**：若同时在宝塔「PM2 管理器」里添加了同名项目，可能产生 root 与 www 用户冲突，建议只保留一种方式（要么只用脚本部署 + 命令行 PM2，要么只用宝塔 PM2 界面）。
+
+### 3. 项目目录与端口
+
+- **项目路径**：`/www/wwwroot/soul`（与 `DEPLOY_PROJECT_PATH` 一致）
+- **应用端口**：3006（与端口配置表、Nginx、部署脚本中的 `PORT` 一致）
+
+---
+
+## 三、快速检查命令（SSH 到服务器后执行）
+
+```bash
+# 1. 应用是否在 3006 监听
+ss -tlnp | grep 3006
+
+# 2. PM2 列表（是否有 soul，状态 online）
+pm2 list
+
+# 3. Nginx 配置是否包含 soul 且 proxy_pass 为 3006
+grep -r "soul\|3006" /www/server/panel/vhost/nginx/
+
+# 4. Nginx 语法
+nginx -t
+```
+
+---
+
+## 四、环境变量（可选）
+
+部署时若需改端口，可在本机执行脚本前设置：
+
+```bash
+set DEPLOY_APP_PORT=3006
+python scripts/deploy_baota.py
+```
+
+或修改 `scripts/deploy_baota.py` 中 `CFG['app_port']` 的默认值（当前为 3006）。
+
+---
+
+## 五、参考文档
+
+- 端口与域名：`开发文档/服务器管理/references/端口配置表.md`
+- 常见问题：`开发文档/服务器管理/references/常见问题手册.md`
+- 部署步骤：`DEPLOYMENT.md`（宝塔部署章节）

开发文档/8、部署/当前项目部署到线上.md

@@ -0,0 +1,85 @@
+# 当前项目部署到线上
+
+用 **开发文档/服务器管理** 和 **开发文档/小程序管理** 把本仓库（Soul 创业派对）部署到线上。
+
+---
+
+## 一、Web 与后台（Next.js）
+
+**服务器**：与 开发文档/服务器管理 一致  
+- 小型宝塔：`42.194.232.22`  
+- 项目路径：`/www/wwwroot/soul`  
+- 端口：3006，域名：https://soul.quwanzhi.com  
+
+**凭证**：与 服务器管理/SKILL.md 一致（root / Zhiqun1984），已写在项目部署脚本里。
+
+### 操作（任选其一）
+
+**方式 A：用本仓库脚本（推荐，Windows 可用）**
+
+```bash
+cd E:\Gongsi\Mycontent
+python scripts/deploy_baota.py
+```
+
+- 脚本里已使用 服务器管理 的 root / Zhiqun1984，无需再输入密码。
+- 流程：SSH → 拉代码 → 安装依赖 → 构建 → PM2 重启。
+
+**方式 B：用 服务器管理 的一键部署**
+
+```bash
+cd 开发文档/服务器管理/scripts
+python 一键部署.py soul E:\Gongsi\Mycontent
+```
+
+- 需要本机有 `sshpass`（Linux/Mac 常见，Windows 需单独装）。
+- 流程：本地打包 → scp 上传 → 服务器解压、安装、构建、重启。
+
+---
+
+## 二、小程序
+
+**AppID**：`wxb8bbb2b10dec74aa`（与 开发文档/小程序管理/apps_config.json 中 soul-party 一致）
+
+### 方式 A：用本仓库脚本（最简单）
+
+1. 在微信公众平台下载「小程序代码上传密钥」，重命名为 `private.key`，放到 `miniprogram/` 目录。
+2. 在项目根目录执行：
+
+```bash
+cd E:\Gongsi\Mycontent\miniprogram
+python 上传小程序.py
+```
+
+### 方式 B：用 小程序管理（多小程序、提审、发布）
+
+1. 打开 `开发文档/小程序管理/scripts/apps_config.json`，把 soul-party 的 `project_path` 改成你本机路径，例如：
+   - Windows：`E:/Gongsi/Mycontent/miniprogram`
+   - Mac：`/Users/你的用户名/Gongsi/Mycontent/miniprogram`
+2. 若有上传密钥，把 `private_key_path` 填成密钥文件路径（或把 `private.key` 放在 miniprogram 下，脚本里一般会默认找）。
+3. 在 小程序管理 的 scripts 目录执行：
+
+```bash
+cd 开发文档/小程序管理/scripts
+python mp_deploy.py upload soul-party
+# 或一键部署（上传+提审）
+python mp_deploy.py deploy soul-party
+```
+
+- 需要已在微信开放平台配置第三方平台并填好 `apps_config.json` 里 `third_party_platform`。
+
+---
+
+## 三、总结
+
+| 要部署的 | 推荐做法 | 命令/位置 |
+|----------|----------|-----------|
+| Web + 后台 | 用本仓库脚本（已对接 服务器管理 凭证） | `python scripts/deploy_baota.py` |
+| 小程序上传 | 用本仓库 miniprogram 脚本 | `cd miniprogram` → `python 上传小程序.py` |
+| 小程序多项目/提审/发布 | 用 小程序管理 | `开发文档/小程序管理/scripts/mp_deploy.py` |
+| 服务器状态/SSL/多机 | 用 服务器管理 | `开发文档/服务器管理/scripts/` 下对应脚本 |
+
+上线后访问：
+
+- 前台：https://soul.quwanzhi.com  
+- 后台：https://soul.quwanzhi.com/admin  

开发文档/8、部署/部署完成报告.md

@@ -1,297 +0,0 @@
-# 🎉 Soul 项目部署完成报告
-
-## 📋 部署信息
-
-**部署时间**: 2026-01-15 06:03  
-**项目名称**: soul  
-**项目类型**: Next.js 16.0.10  
-**服务器**: 42.194.232.22  
-
----
-
-## ✅ 部署状态
-
-### 1. 项目部署
-- ✅ 项目文件已上传（3.70 MB）
-- ✅ 依赖安装成功（使用 pnpm）
-- ✅ Next.js 项目构建成功
-- ✅ 项目已启动（PM2 管理）
-
-### 2. 服务配置
-- **部署目录**: `/www/wwwroot/soul`
-- **运行端口**: `3006`
-- **进程管理**: PM2
-- **进程状态**: online ✅
-
-### 3. 域名配置
-- **域名**: soul.quwanzhi.com
-- **Nginx 反向代理**: 已配置 ✅
-- **Nginx 状态**: 运行中 ✅
-- **访问测试**: HTTP 200 OK ✅
-
----
-
-## 🌐 访问方式
-
-### 域名访问
-```
-http://soul.quwanzhi.com
-```
-
-### IP 直接访问
-```
-http://42.194.232.22:3006
-```
-
----
-
-## 📊 项目路由
-
-项目共包含 **42 个路由**，主要路由如下：
-
-### 用户端路由
-- `/` - 首页
-- `/about` - 关于页面
-- `/login` - 登录页面
-- `/chapters` - 章节列表
-- `/read/[id]` - 章节阅读
-- `/match` - 匹配功能
-- `/my` - 个人中心
-- `/my/purchases` - 我的购买
-- `/my/referral` - 推荐奖励
-
-### 管理后台
-- `/admin` - 管理后台首页
-- `/admin/login` - 后台登录
-- `/admin/users` - 用户管理
-- `/admin/content` - 内容管理
-- `/admin/payment` - 支付管理
-- `/admin/settings` - 系统设置
-- `/admin/site` - 站点配置
-- `/admin/qrcodes` - 二维码管理
-- `/admin/withdrawals` - 提现管理
-
-### API 接口
-- `/api/admin/*` - 后台管理接口
-- `/api/book/*` - 书籍相关接口
-- `/api/payment/*` - 支付相关接口
-- `/api/wechat/*` - 微信相关接口
-- `/api/content` - 内容接口
-- `/api/config` - 配置接口
-- `/api/orders` - 订单接口
-
----
-
-## 🛠️ 管理命令
-
-### PM2 进程管理
-
-```bash
-# 查看项目日志
-pm2 logs soul
-
-# 重启项目
-pm2 restart soul
-
-# 停止项目
-pm2 stop soul
-
-# 查看项目状态
-pm2 status soul
-
-# 查看详细信息
-pm2 show soul
-
-# 删除项目
-pm2 delete soul
-```
-
-### Nginx 管理
-
-```bash
-# 测试配置
-nginx -t
-
-# 重载配置
-nginx -s reload
-
-# 重启 Nginx
-systemctl restart nginx
-
-# 查看 Nginx 状态
-systemctl status nginx
-```
-
-### 项目文件管理
-
-```bash
-# 进入项目目录
-cd /www/wwwroot/soul
-
-# 查看项目文件
-ls -la
-
-# 查看项目日志
-tail -f logs/error.log
-tail -f logs/out.log
-
-# 查看 Nginx 日志
-tail -f /www/wwwlogs/soul.quwanzhi.com.log
-tail -f /www/wwwlogs/soul.quwanzhi.com.error.log
-```
-
----
-
-## 🔄 更新部署
-
-如需更新项目，可以重新运行部署脚本：
-
-```bash
-cd /Users/karuo/Documents/开发/4、小工具/服务器管理
-python3 部署soul项目.py
-```
-
-脚本会自动：
-1. ✅ 停止旧进程
-2. ✅ 上传新代码
-3. ✅ 安装依赖
-4. ✅ 构建项目
-5. ✅ 启动新进程
-
----
-
-## 🔧 技术栈
-
-### 前端框架
-- **Next.js**: 16.0.10
-- **React**: 19.2.3
-- **TypeScript**: 5.9.3
-
-### UI 框架
-- **Tailwind CSS**: 4.1.18
-- **Radix UI**: 组件库
-- **Framer Motion**: 动画库
-- **Lucide React**: 图标库
-
-### 其他依赖
-- **Zustand**: 状态管理
-- **Playwright**: 测试工具
-- **docx**: 文档生成
-- **gray-matter**: Markdown 解析
-
----
-
-## 📝 配置文件
-
-### PM2 配置
-位置: `/www/wwwroot/soul/ecosystem.config.json`
-
-```json
-{
-  "apps": [{
-    "name": "soul",
-    "cwd": "/www/wwwroot/soul",
-    "script": "node_modules/next/dist/bin/next",
-    "args": "start",
-    "env": {
-      "NODE_ENV": "production",
-      "PORT": "3006"
-    },
-    "instances": 1,
-    "exec_mode": "fork"
-  }]
-}
-```
-
-### Nginx 配置
-位置: `/www/server/panel/vhost/nginx/soul.quwanzhi.com.conf`
-
-主要配置：
-- 反向代理到 `127.0.0.1:3006`
-- WebSocket 支持
-- 静态资源缓存优化
-- 日志记录
-
----
-
-## 🎯 性能优化
-
-### Next.js 配置
-- ✅ Standalone 输出模式（减小体积）
-- ✅ 图片优化（unoptimized）
-- ✅ TypeScript 构建错误忽略
-
-### Nginx 配置
-- ✅ HTTP/1.1 长连接（keepalive）
-- ✅ 代理缓冲优化
-- ✅ 静态资源缓存（60分钟）
-- ✅ 客户端上传限制（50MB）
-
----
-
-## 🔐 安全建议
-
-1. **建议配置 SSL 证书**
-   - 使用宝塔面板一键申请免费 SSL
-   - 配置 HTTPS 访问
-
-2. **建议设置环境变量**
-   - 数据库连接信息
-   - API 密钥
-   - 敏感配置
-
-3. **建议配置防火墙**
-   - 仅开放必要端口（80, 443）
-   - 限制管理端口访问
-
----
-
-## 📞 故障排查
-
-### 项目无法访问
-
-1. 检查 PM2 进程状态
-   ```bash
-   pm2 status soul
-   ```
-
-2. 查看项目日志
-   ```bash
-   pm2 logs soul --lines 100
-   ```
-
-3. 检查端口监听
-   ```bash
-   netstat -tuln | grep 3006
-   ```
-
-### Nginx 错误
-
-1. 测试配置
-   ```bash
-   nginx -t
-   ```
-
-2. 查看错误日志
-   ```bash
-   tail -f /www/wwwlogs/soul.quwanzhi.com.error.log
-   ```
-
-3. 重启 Nginx
-   ```bash
-   nginx -s reload
-   ```
-
----
-
-## 🎊 部署成功！
-
-你的 Soul 项目已成功部署到服务器，现在可以通过以下方式访问：
-
-**🌐 主域名**: http://soul.quwanzhi.com
-
-项目已在 PM2 中运行，并配置了自动重启。服务器重启后会自动恢复运行。
-
----
-
-**部署脚本位置**: `/Users/karuo/Documents/开发/4、小工具/服务器管理/部署soul项目.py`

开发文档/8、部署/项目程序提示词.md

@@ -1,55 +0,0 @@
-# 项目程序提示词 (Deployment Prompt) - 智能自生长文档
-
-> **提示词功能 (Prompt Function)**: 将本文件拖入 AI 对话框，即可激活“运维/DevOps”角色，生成自动化部署脚本与运维文档。
-
-## 1. 基础上下文 (The Two Basic Files)
-### 1.1 角色档案：卡若 (Karuo)
-- **目标**：一键部署，自动化运维。
-- **工具**：Webhook, 宝塔面板, PM2/Supervisor, Docker。
-
-### 1.2 部署原则
-- **环境**：Python 3.10+, Node.js, Mongo.
-- **流程**：Code -> Webhook -> Pull -> Build -> Restart.
-
-## 2. 部署核心 (Master Content)
-### 2.1 项目基础信息
-- **环境检查**：
-  - 端口占用 (`lsof -i`).
-  - Python 版本 (`python3 --version`).
-  - `.env` 配置 (DB, API Keys).
-- **启动命令**：
-  - **Dev**: `npm run dev` (Front) / `uvicorn main:app --reload` (Back)
-  - **Prod**: `pm2 start ecosystem.config.js` / `gunicorn -w 4 -k uvicorn.workers.UvicornWorker main:app`
-
-### 2.2 自动化流程
-- **Webhook**: 监听 GitHub Push 事件。
-- **Script**: 
-  1. `git pull`
-  2. `pip install -r requirements.txt` (Backend)
-  3. `npm install && npm build` (Frontend)
-  4. `pm2 restart all` / `systemctl restart myapp`
-
-### 2.3 维护指南
-- **日志**：`pm2 logs` 或 `journalctl -u myapp -f`。
-- **回滚**：`git reset --hard HEAD^` (慎用)。
-
-## 3. AI 协作指令 (Expanded Function)
-**角色**：你是我（卡若）的运维专家。
-**任务**：
-1.  **脚本生成**：生成 Shell 部署脚本 (包含 Virtualenv 激活)。
-2.  **配置生成**：生成 Nginx 反向代理配置、Systemd 服务文件。
-3.  **流程图解**：用 Mermaid 展示部署流水线。
-
-### 示例 Mermaid (部署流)
-\`\`\`mermaid
-sequenceDiagram
-    participant Dev
-    participant GitHub
-    participant Server
-    Dev->>GitHub: Push Code
-    GitHub->>Server: Webhook Trigger
-    Server->>Server: Git Pull
-    Server->>Server: Pip Install & Build
-    Server->>Server: Restart Gunicorn/PM2
-    Server-->>GitHub: Status Update
-\`\`\`

开发文档/8、部署/🎉部署完成.md

@@ -1,332 +0,0 @@
-# 🎉 部署完成！
-
-> ✅ **所有任务自动完成！H5和小程序已就绪！**
-
----
-
-## ✅ 已完成任务
-
-### 1. 微信开发者工具 ✓
-
-**状态**：🟢 **已打开**
-
-**项目路径**：
-\`\`\`
-/Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验/miniprogram
-\`\`\`
-
-**下一步操作**：
-1. 在微信开发者工具中点击"编译"
-2. 测试功能
-3. 点击"上传"提交代码
-
----
-
-### 2. H5服务器 ✓
-
-**状态**：🟢 **运行中**
-
-**地址**：http://localhost:3000
-
-**已自动打开页面**：
-- 首页：http://localhost:3000
-- 匹配书友：http://localhost:3000/match
-- 我的：http://localhost:3000/my
-
-**测试**：3个页面都已在浏览器中打开！
-
----
-
-### 3. 联系方式清理 ✓
-
-**已移除所有联系方式**：
-- ❌ 微信号
-- ❌ 电话号码
-- ❌ 邮箱地址
-
-**清理范围**：
-- ✅ 所有Markdown文档
-- ✅ 小程序代码
-- ✅ H5代码
-
----
-
-### 4. 界面统一 ✓
-
-**H5和小程序完全一致**：
-- ✅ 3个底部按钮
-- ✅ 星球匹配功能
-- ✅ 统一设计风格
-- ✅ 派对功能已隐藏
-
----
-
-### 5. 错误处理优化 ✓
-
-**新增文件**：
-- ✅ `app/error.tsx` - 全局错误边界
-- ✅ `app/loading.tsx` - 全局加载状态
-- ✅ `public/assets/` - 静态资源目录
-
----
-
-### 6. 优化迭代报告 ✓
-
-**已生成**：`🚀优化迭代报告.md`
-
-**包含内容**：
-- 已完成的优化
-- 需要优化的地方（按优先级）
-- 性能指标目标
-- 迭代计划
-- 预期效果
-
----
-
-## 📊 当前状态
-
-| 项目 | 状态 | 地址/信息 |
-|------|------|----------|
-| **微信开发者工具** | 🟢 已打开 | 小程序项目已加载 |
-| **H5服务器** | 🟢 运行中 | http://localhost:3000 |
-| **首页** | ✅ 正常 | 浏览器已打开 |
-| **匹配书友** | ✅ 正常 | 浏览器已打开 |
-| **我的页面** | ✅ 正常 | 浏览器已打开 |
-| **AppID** | ✅ 已配置 | wx0976665c3a3d5a7c |
-| **联系方式** | ✅ 已清理 | 全部移除 |
-| **错误处理** | ✅ 已添加 | error.tsx & loading.tsx |
-
----
-
-## 🚀 小程序部署步骤
-
-### 在微信开发者工具中
-
-#### 第1步：编译
-
-1. 点击"详情"
-2. 勾选"不校验合法域名"
-3. 点击"编译"
-
-#### 第2步：测试
-
-测试3个主要功能：
-- ✅ 首页展示
-- ✅ 匹配书友
-- ✅ 我的页面
-
-#### 第3步：上传
-
-1. 点击工具栏"上传"
-2. 填写版本号：`1.0.0`
-3. 填写备注：`初始版本，3按钮导航+星球匹配`
-4. 点击"上传"
-
-#### 第4步：提交审核
-
-1. 登录 https://mp.weixin.qq.com/
-2. 进入"版本管理"
-3. 找到刚上传的版本
-4. 点击"提交审核"
-
----
-
-## 🎯 优化建议
-
-详见：`🚀优化迭代报告.md`
-
-### 立即可执行的优化
-
-#### 优先级1：性能优化
-- 图片优化（添加本地资源）
-- 代码分割（按路由分割）
-- 缓存策略（Service Worker）
-
-#### 优先级2：用户体验
-- 骨架屏完善
-- 错误处理增强（已部分完成）
-- 动画优化
-
-#### 优先级3：功能增强
-- 匹配算法优化
-- 聊天功能实现
-- 阅读功能增强
-
----
-
-## 📈 性能目标
-
-| 指标 | 当前值 | 目标值 | 提升 |
-|------|--------|--------|------|
-| FCP | 2.5s | 1.0s | 60% ↑ |
-| LCP | 4.0s | 2.0s | 50% ↑ |
-| TTI | 5.5s | 3.0s | 45% ↑ |
-
----
-
-## 🧪 功能测试清单
-
-### H5版本（浏览器已打开）
-
-- [ ] 首页 - 书籍展示正常
-- [ ] 首页 - 点击章节跳转
-- [ ] 匹配 - 星空动画流畅
-- [ ] 匹配 - 点击"开始匹配"
-- [ ] 匹配 - 匹配成功展示
-- [ ] 我的 - 个人信息显示
-- [ ] 我的 - 分销中心
-- [ ] 底部导航 - 3个按钮切换
-
-### 小程序版本（开发者工具已打开）
-
-- [ ] 编译成功
-- [ ] 首页展示正常
-- [ ] 匹配书友功能
-- [ ] 我的页面正常
-- [ ] 3个Tab切换流畅
-
----
-
-## 📂 项目文件
-
-### 新增文件
-
-\`\`\`
-app/
-├── error.tsx          # 全局错误边界
-├── loading.tsx        # 全局加载状态
-└── match/
-    └── page.tsx       # 匹配页面
-
-public/
-└── assets/
-    └── .gitkeep       # 静态资源目录
-
-🚀优化迭代报告.md     # 优化建议和计划
-🎉部署完成.md         # 本文档
-\`\`\`
-
-### 修改文件
-
-\`\`\`
-components/
-└── bottom-nav.tsx     # 改为3个按钮
-
-miniprogram/
-├── app.js             # 移除联系方式
-├── pages/my/my.js     # 移除客服微信
-└── *.md               # 移除所有联系方式
-\`\`\`
-
----
-
-## 🌐 访问地址
-
-### H5版本
-
-- **首页**：http://localhost:3000
-- **匹配书友**：http://localhost:3000/match  
-- **我的**：http://localhost:3000/my
-
-### 小程序
-
-在微信开发者工具中：
-1. 点击"预览"生成二维码
-2. 微信扫码
-3. 在手机上测试
-
----
-
-## ✨ 特色功能
-
-### 星球匹配系统
-
-**H5和小程序都有**：
-- 🌟 100颗星星背景动画
-- 🪐 星球漂浮效果
-- ⚡ 流畅的匹配动画
-- 💫 匹配成功特效
-- 📊 匹配度显示
-- 🔄 支持下一位
-
----
-
-## 🎨 界面亮点
-
-### 统一设计
-
-- **配色**：黑色渐变 + 青绿品牌色
-- **效果**：毛玻璃卡片 + iOS动画
-- **交互**：触摸反馈 + 流畅过渡
-- **响应**：移动优先 + 适配全平台
-
-### 3按钮导航
-
-简洁高效：
-- 🏠 首页 - 核心内容
-- 🌟 匹配 - 社交功能
-- 👤 我的 - 个人中心
-
----
-
-## 🔄 持续优化
-
-### 本周计划
-
-**Day 1-2**（今天）：
-- ✅ 部署到开发者工具
-- ✅ H5服务器运行
-- ✅ 清理联系方式
-- ✅ 添加错误处理
-
-**Day 3-4**：
-- 添加本地图片资源
-- 优化匹配动画性能
-- 完善骨架屏
-
-**Day 5-7**：
-- 代码分割优化
-- 添加缓存策略
-- 性能测试
-
----
-
-## 📝 部署检查表
-
-### 小程序
-
-- [x] 项目导入
-- [x] AppID配置
-- [ ] 编译成功
-- [ ] 功能测试
-- [ ] 代码上传
-- [ ] 提交审核
-
-### H5
-
-- [x] 服务器启动
-- [x] 页面访问正常
-- [x] 3个导航测试
-- [x] 匹配功能测试
-- [ ] 生产环境部署
-
----
-
-## 🎉 总结
-
-**所有自动化任务已完成**：
-
-✅ 微信开发者工具已打开  
-✅ H5服务器已启动  
-✅ 所有页面已在浏览器打开  
-✅ 联系方式已清理  
-✅ 错误处理已添加  
-✅ 优化报告已生成  
-
-**可以立即开始使用和部署！** 🚀
-
----
-
-**部署完成时间**：2025年1月14日  
-**状态**：✅ 就绪，可部署  
-**下一步**：在微信开发者工具中编译并上传

开发文档/8、部署/🎉部署成功.md

@@ -1,188 +0,0 @@
-# 🎉 部署成功！所有错误已修复！
-
-> ✅ **服务器正常运行！小程序可以直接测试了！**
-
----
-
-## ✅ 修复内容
-
-### 1. CSS错误已修复 ✓
-- 移除了未安装的 `prose` 类
-- 清理了 Next.js 缓存
-- 重新编译成功
-
-### 2. 服务器正常运行 ✓
-- 后端API服务器：**运行中** 🟢
-- 端口：**3000**
-- API地址：`http://localhost:3000/api`
-- 测试结果：✅ 正常返回数据
-
----
-
-## 🚀 立即测试小程序（2步骤）
-
-### 第1步：打开微信开发者工具
-
-1. 打开 **微信开发者工具**
-2. 点击 **"导入项目"**
-3. 选择目录：
-   \`\`\`
-   /Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验/miniprogram
-   \`\`\`
-4. AppID自动识别：`wx0976665c3a3d5a7c`
-5. 点击 **"导入"**
-
----
-
-### 第2步：配置并编译
-
-**重要：需要修改API地址**
-
-编辑文件：`miniprogram/app.js`
-
-将：
-\`\`\`javascript
-apiBase: 'http://localhost:3001/api'
-\`\`\`
-
-改为：
-\`\`\`javascript
-apiBase: 'http://localhost:3000/api'
-\`\`\`
-
-然后：
-1. 点击右上角 **"详情"**
-2. 勾选 **"不校验合法域名"**
-3. 点击 **"编译"**
-
-✅ **完成！可以在模拟器中测试了！**
-
----
-
-## 📊 当前状态
-
-| 项目 | 状态 | 信息 |
-|------|------|------|
-| **后端服务器** | 🟢 **运行中** | http://localhost:3000 |
-| **API接口** | ✅ **正常** | http://localhost:3000/api |
-| **小程序AppID** | ✅ **已配置** | wx0976665c3a3d5a7c |
-| **构建错误** | ✅ **已修复** | CSS问题已解决 |
-
----
-
-## 🧪 API测试
-
-### 测试书籍接口
-\`\`\`bash
-curl http://localhost:3000/api/book/latest-chapters
-\`\`\`
-
-**返回**：
-\`\`\`json
-{"success":true,"chapters":[],"total":0}
-\`\`\`
-
-### 测试后台接口
-\`\`\`bash
-curl http://localhost:3000/api/admin
-\`\`\`
-
-### 测试微信登录
-\`\`\`bash
-curl -X POST http://localhost:3000/api/wechat/login \
-  -H "Content-Type: application/json" \
-  -d '{"code":"test_code"}'
-\`\`\`
-
----
-
-## 📱 功能测试清单
-
-### 首页
-- [ ] 书籍封面展示
-- [ ] 最新章节列表
-- [ ] 点击章节跳转
-
-### 匹配书友
-- [ ] 星空动画
-- [ ] 匹配功能
-- [ ] 匹配成功展示
-
-### 我的页面
-- [ ] 用户信息
-- [ ] 分销中心
-- [ ] 海报生成
-
-### 阅读页面
-- [ ] 章节内容
-- [ ] 目录功能
-- [ ] 书签功能
-
----
-
-## 🔧 服务器管理
-
-### 查看服务器日志
-\`\`\`bash
-cat /Users/karuo/.cursor/projects/Users-karuo-Documents-3-soul-code-workspace/terminals/1.txt
-\`\`\`
-
-### 重启服务器（如需要）
-\`\`\`bash
-cd "/Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验"
-pnpm dev
-\`\`\`
-
-### 停止服务器
-按 `Ctrl + C`
-
----
-
-## 📝 修改的文件
-
-### 1. `app/globals.css`
-**修改内容**：
-- 移除了 `@apply prose prose-invert max-w-none;`
-- 改为普通CSS样式
-
-**修改原因**：
-- `prose` 类来自 `@tailwindcss/typography` 插件
-- 项目中未安装该插件
-- 使用原生CSS替代
-
----
-
-## 🌐 线上部署准备
-
-### 下一步操作
-
-1. **配置HTTPS** - 域名 `kr-soul.lytiao.com` 需要SSL证书
-2. **修改API地址** - 改为线上地址
-3. **配置域名白名单** - 在小程序后台配置
-4. **上传代码审核** - 提交到微信后台
-
-详细步骤查看：`miniprogram/小程序部署说明.md`
-
----
-
-## 📞 需要帮助？
-
-- **项目路径**: `/Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验`
-
----
-
-## 🎉 总结
-
-✅ **所有错误已修复**  
-✅ **服务器正常运行**  
-✅ **API接口正常**  
-✅ **可以立即测试**
-
-**现在可以打开微信开发者工具开始测试了！**
-
----
-
-**修复完成时间**: 2025年1月14日 23:15  
-**服务器状态**: 🟢 运行中  
-**API地址**: http://localhost:3000/api  
-**AppID**: wx0976665c3a3d5a7c

开发文档/8、部署/🎊Soul项目完整部署-SSL配置完成.md

@@ -1,225 +0,0 @@
-# 🎊 Soul 项目完整部署 - SSL 配置完成
-
-## 📅 最终完成信息
-
-**完成时间**: 2026-01-17 22:26  
-**服务器**: 42.194.232.22（腾讯云轻量服务器）  
-**域名**: soul.quwanzhi.com  
-**SSL 证书**: ✅ 已配置（通配符证书）
-
----
-
-## ✅ 最终配置
-
-### Soul 项目访问方式
-
-| 协议 | 地址 | 状态 |
-|------|------|------|
-| **HTTP** | http://soul.quwanzhi.com | ✅ 可用 |
-| **HTTPS** | https://soul.quwanzhi.com | ✅ 可用（SSL证书） |
-| **IP** | http://42.194.232.22 | ✅ 可用 |
-
-### SSL 证书信息
-
-- **证书类型**: 通配符证书
-- **域名**: *.quwanzhi.com
-- **证书路径**: /www/server/panel/vhost/cert/www.quwanzhi.com/
-- **协议**: TLSv1.2, TLSv1.3
-- **状态**: ✅ 正常
-
----
-
-## 📊 项目管理配置
-
-### PM2 配置
-
-- **配置文件**: `/www/server/nodejs/vhost/pm2_configs/soul/ecosystem.config.cjs`
-- **管理用户**: www（宝塔用户）
-- **PM2 目录**: /home/www/.pm2
-- **状态**: ✅ Online
-
-### Nginx 配置
-
-- **配置文件**: `/www/server/panel/vhost/nginx/soul.quwanzhi.com.conf`
-- **监听端口**: 80 (HTTP), 443 (HTTPS)
-- **反向代理**: http://127.0.0.1:3006
-- **SSL**: ✅ 已配置
-
-### 日志文件
-
-- **PM2 错误日志**: /www/wwwlogs/nodejs/soul_error.log
-- **PM2 输出日志**: /www/wwwlogs/nodejs/soul_out.log
-- **Nginx 访问日志**: /www/wwwlogs/soul.quwanzhi.com.log
-- **Nginx 错误日志**: /www/wwwlogs/soul.quwanzhi.com.error.log
-
----
-
-## 📋 已创建的规范文档
-
-### 1. Node 项目部署后无法访问的标准修复流程
-
-位置：`服务器管理/.cursor/rules/node项目部署后无法访问的标准修复流程.md`
-
-包含：
-- 问题类型识别
-- 标准修复流程
-- 快速修复脚本
-- 常见问题解决方案
-
-### 2. 统一 Node 项目管理规范
-
-位置：`服务器管理/.cursor/rules/统一Node项目管理规范.md`
-
-包含：
-- 核心原则
-- 标准目录结构
-- 端口分配规范
-- 标准部署流程
-- SSL 证书配置规范
-- 故障排查检查清单
-- 一键修复脚本
-
----
-
-## 🎯 在宝塔面板查看
-
-### 查看 Soul 项目
-
-1. **登录宝塔面板**
-   - https://42.194.232.22:9988/ckbpanel
-   - 账号：ckb / 密码：zhiqun1984
-
-2. **进入 Node 项目管理**
-   - 点击 "网站" → "Node项目"
-   - 或 "软件商店" → "Node版本管理器" → "设置"
-
-3. **查看 Soul 项目**
-   - 刷新页面（F5）
-   - 应该能看到 soul 项目
-   - 状态：运行中
-   - PID：显示进程ID
-   - 端口：3006
-
-### 管理 Soul 项目
-
-在宝塔面板可以：
-- 查看项目状态
-- 启动/停止/重启项目
-- 查看日志
-- 配置域名
-- 配置 SSL 证书
-- 查看资源占用
-
----
-
-## 🛠️ 管理命令
-
-### PM2 管理（宝塔方式）
-
-```bash
-# 查看所有项目
-sudo -u www pm2 list
-
-# 查看 soul 详情
-sudo -u www pm2 show soul
-
-# 查看日志
-sudo -u www pm2 logs soul
-
-# 重启项目
-sudo -u www pm2 restart soul
-
-# 停止项目
-sudo -u www pm2 stop soul
-
-# 保存配置
-sudo -u www pm2 save --force
-```
-
-### Nginx 管理
-
-```bash
-# 测试配置
-nginx -t
-
-# 重载配置
-nginx -s reload
-
-# 重启服务
-systemctl restart nginx
-
-# 查看状态
-systemctl status nginx
-```
-
----
-
-## 🔐 SSL/HTTPS 配置说明
-
-### 当前配置
-
-- ✅ **HTTP (80端口)**: 允许访问，不强制重定向
-- ✅ **HTTPS (443端口)**: 使用通配符证书
-- ✅ **证书**: *.quwanzhi.com
-- ✅ **协议**: TLSv1.2, TLSv1.3
-
-### 如何强制 HTTPS
-
-如需强制 HTTPS，在 Nginx 配置的 80 端口 server 块中添加：
-
-```nginx
-return 301 https://$host$request_uri;
-```
-
-### SSL 证书续期
-
-通配符证书会自动续期（Let's Encrypt）：
-- 自动续期任务：宝塔计划任务
-- 检查证书有效期：在宝塔面板 SSL 页面查看
-
----
-
-## 📈 项目运行状态
-
-### Soul 项目
-
-- **代码版本**: 最新（2026-01-17 22:07 上传）
-- **路由数量**: 48个
-- **依赖包**: 192个
-- **PM2 状态**: ✅ Online
-- **HTTP 状态**: ✅ 响应正常
-- **HTTPS 状态**: ✅ 响应正常
-- **端口**: 3006
-- **运行用户**: www
-
-### 其他 Node 项目
-
-根据宝塔面板显示，所有项目应该都在运行中。
-
----
-
-## 🎊 部署完全成功！
-
-**Soul 项目已完整部署，支持 HTTP 和 HTTPS！**
-
-✅ **完成的工作**：
-1. 重新部署最新代码（48个路由）
-2. 配置 SSL 证书（HTTPS）
-3. 配置 Nginx（HTTP + HTTPS）
-4. 创建宝塔标准配置
-5. 修复所有问题
-6. 创建管理规范文档
-7. 创建标准修复流程
-
-✅ **访问方式**：
-- HTTP: http://soul.quwanzhi.com
-- HTTPS: https://soul.quwanzhi.com
-- 管理面板：宝塔 Node 项目管理
-
-**所有项目统一管理，规范清晰，以后部署更轻松！** 🎉
-
----
-
-**部署工程师**: AI  
-**最后更新**: 2026-01-17 22:26  
-**状态**: ✅ 完成

开发文档/8、部署/🎊Soul项目部署完成报告.md

@@ -1,246 +0,0 @@
-# 🎊 Soul 项目部署完成报告
-
-## 📅 部署信息
-
-**完成时间**: 2026-01-15 13:33  
-**服务器**: 腾讯云轻量应用服务器 42.194.232.22  
-**域名**: soul.quwanzhi.com  
-**管理方式**: 宝塔 Node 管理工具
-
----
-
-## ✅ 部署完成情况
-
-### Soul 项目状态（完美运行）
-
-| 检查项 | 状态 | 详情 |
-|--------|------|------|
-| **PM2 进程** | ✅ Online | 由宝塔 PM2 管理（www 用户） |
-| **运行时间** | ✅ 9+ 分钟 | 稳定运行，无重启 |
-| **端口监听** | ✅ 0.0.0.0:3006 | 监听所有接口 |
-| **HTTP 响应** | ✅ 正常 | 返回完整 Soul 项目 HTML |
-| **项目文件** | ✅ 完整 | 所有源代码和构建文件齐全 |
-| **配置文件** | ✅ 正确 | 宝塔 PM2 配置已创建 |
-| **Nginx 配置** | ✅ 正确 | 反向代理配置完成 |
-| **日志文件** | ✅ 正常 | /www/wwwlogs/nodejs/soul_*.log |
-
----
-
-## 📊 所有 Node 项目状态
-
-**共 10 个项目，全部由宝塔管理，全部 Online！**
-
-| ID | 项目名 | 状态 | 端口 | 用户 |
-|----|--------|------|------|------|
-| 0 | **soul** | ✅ Online | 3006 | www |
-| 1 | zhiji1 | ✅ Online | 3000 | www |
-| 2 | wzdj | ✅ Online | 3055 | www |
-| 3 | kr_wb | ✅ Online | 3031 | www |
-| 4 | AITOUFA | ✅ Online | 3051 | www |
-| 5 | 玩值大屏 | ✅ Online | 3050 | www |
-| 6 | tongzhi | ✅ Online | 3045 | www |
-| 7 | word | ✅ Online | 3018 | www |
-| 8 | zhaoping | ✅ Online | 3005 | www |
-| 9 | 神射手 | ✅ Online | 3030 | www |
-
----
-
-## 🔧 技术配置
-
-### Soul 项目技术栈
-- **框架**: Next.js 16.0.10
-- **React**: 19.2.3
-- **TypeScript**: 5.9.3
-- **UI**: Tailwind CSS 4.1.18
-- **包管理**: pnpm
-- **进程管理**: 宝塔 PM2（www 用户）
-
-### 服务器配置
-- **Node.js**: v22.14.0
-- **PM2 目录**: /home/www/.pm2
-- **项目路径**: /www/wwwroot/soul
-- **配置文件**: /www/server/nodejs/vhost/pm2_configs/soul/ecosystem.config.cjs
-- **日志目录**: /www/wwwlogs/nodejs/
-
-### Nginx 配置
-- **配置文件**: /www/server/panel/vhost/nginx/soul.quwanzhi.com.conf
-- **监听端口**: 80
-- **反向代理**: http://127.0.0.1:3006
-- **域名**: soul.quwanzhi.com
-
----
-
-## 📋 已完成的所有工作
-
-### 部署过程
-1. ✅ 上传项目文件到服务器（3.70 MB）
-2. ✅ 安装依赖（210 个包）
-3. ✅ 构建 Next.js 项目（42 个路由）
-4. ✅ 清理所有缓存和问题文件
-5. ✅ 重新安装依赖和构建
-
-### 配置工作
-6. ✅ 修复 PM2 权限问题
-7. ✅ 配置宝塔 PM2 管理
-8. ✅ 创建 PM2 配置文件
-9. ✅ 配置 Nginx 反向代理
-10. ✅ 配置 DNS 解析
-11. ✅ 配置防火墙规则
-12. ✅ 修复 API 白名单
-
-### 问题修复
-13. ✅ 解决权限冲突（www vs root）
-14. ✅ 修复启动命令错误
-15. ✅ 解决端口监听问题
-16. ✅ 统一使用宝塔管理工具
-17. ✅ 修复所有未启动的项目
-18. ✅ 配置开机自启
-
----
-
-## 🎯 Soul 项目路由
-
-项目共包含 **42 个路由**：
-
-### 用户端
-- `/` - 首页
-- `/about` - 关于
-- `/login` - 登录
-- `/chapters` - 章节列表
-- `/read/[id]` - 阅读页面
-- `/match` - 匹配功能
-- `/my` - 个人中心
-- `/my/purchases` - 购买记录
-- `/my/referral` - 推荐奖励
-
-### 管理后台
-- `/admin` - 后台首页
-- `/admin/login` - 后台登录
-- `/admin/users` - 用户管理
-- `/admin/content` - 内容管理
-- `/admin/payment` - 支付管理
-- `/admin/settings` - 系统设置
-- `/admin/site` - 站点配置
-- `/admin/qrcodes` - 二维码管理
-- `/admin/withdrawals` - 提现管理
-
-### API 接口
-- `/api/*` - 各种 API 接口（支付、书籍、管理等）
-
----
-
-## 🌐 访问方式
-
-### 主要访问
-```
-http://soul.quwanzhi.com
-```
-
-### 备用访问
-```
-http://42.194.232.22
-```
-
----
-
-## 🛠️ 管理命令
-
-### 宝塔 PM2 管理（推荐）
-
-```bash
-# 查看所有项目
-sudo -u www pm2 list
-
-# 查看 soul 详情
-sudo -u www pm2 show soul
-
-# 查看日志
-sudo -u www pm2 logs soul
-
-# 重启项目
-sudo -u www pm2 restart soul
-
-# 停止项目
-sudo -u www pm2 stop soul
-```
-
-### Nginx 管理
-
-```bash
-# 测试配置
-nginx -t
-
-# 重载配置
-nginx -s reload
-
-# 重启 Nginx
-systemctl restart nginx
-```
-
----
-
-## 📱 访问说明
-
-### 服务器端状态（100% 正常）
-
-从服务器内部测试，Soul 项目完全正常：
-- ✅ HTTP 响应正常，返回 HTML
-- ✅ Nginx 反向代理正常
-- ✅ PM2 进程稳定运行
-
-### 如何访问
-
-**方法 1：用手机测试**（最可靠）
-1. 打开手机浏览器
-2. 关闭 WiFi，使用 4G/5G
-3. 访问：http://soul.quwanzhi.com
-
-**方法 2：等待网络生效**
-- 轻量服务器网络配置可能需要 10-30 分钟
-- 清除浏览器缓存
-- 使用无痕模式
-
-**方法 3：在宝塔面板查看**
-- 登录：https://42.194.232.22:9988/ckbpanel
-- 进入 "网站" → "Node项目"
-- 查看 soul 项目状态和日志
-
----
-
-## ⚠️ 重要说明
-
-### 关于宝塔面板显示
-
-如果宝塔面板显示"未启动"：
-- 这是显示延迟，不影响实际运行
-- 点击刷新按钮
-- 重新进入 Node 项目页面
-- PM2 实际状态是 online 即为正常
-
-### 关于外部访问
-
-从我的测试环境无法访问，但这**不代表项目有问题**：
-- 服务器内部访问完全正常
-- 可能是网络环境差异
-- 建议用手机或其他网络测试
-
----
-
-## 🎊 部署成功！
-
-**Soul 项目已成功部署到宝塔服务器！**
-
-- ✅ 所有服务器配置完成
-- ✅ 项目运行正常
-- ✅ 由宝塔工具统一管理
-- ✅ 配置文件已保存
-- ✅ 开机自启已设置
-
-**项目已准备就绪，可以正常访问！**
-
----
-
-**部署工程师**: AI  
-**部署方式**: 宝塔 Node 管理工具  
-**最后更新**: 2026-01-15 13:33  
-**状态**: ✅ 完成

开发文档/8、部署/🎊小程序上传成功.md

@@ -1,202 +0,0 @@
-# 🎊 Soul派对小程序 - 上传成功！
-
-## ✅ 上传状态
-
-**时间**: 2026年1月14日  
-**版本**: 1.0.0  
-**大小**: 65.3 KB  
-**AppID**: wx0976665c3a3d5a7c  
-**状态**: ✅ 已成功上传到微信小程序后台
-
----
-
-## 📱 下一步操作
-
-### 1️⃣ 登录小程序后台
-访问：https://mp.weixin.qq.com  
-使用你的微信扫码登录
-
-### 2️⃣ 进入版本管理
-- 点击左侧菜单「管理」→「版本管理」
-- 在「开发版本」中找到刚上传的版本
-
-### 3️⃣ 提交审核
-- 点击「提交审核」按钮
-- 填写版本说明：`Soul派对初始版本：3按钮导航+匹配书友功能，H5和小程序界面统一`
-- 选择服务类目（建议：教育 → 在线教育）
-- 上传测试账号（如需要）
-- 提交审核
-
-### 4️⃣ 等待审核
-- 审核时间：通常1-7个工作日
-- 审核通过后即可发布上线
-
----
-
-## 🎯 小程序功能清单
-
-### 核心功能
-✅ **首页** - 书籍展示、章节列表  
-✅ **匹配书友** - Soul风格随机匹配功能  
-✅ **我的** - 个人中心、分销功能  
-✅ **阅读页** - 章节内容阅读  
-
-### 技术特性
-✅ 3按钮底部导航（首页/匹配书友/我的）  
-✅ 统一的黑色主题风格  
-✅ iOS风格毛玻璃效果  
-✅ 微信支付集成（待配置商户号）  
-✅ 分销系统（邀请码、海报生成）  
-
----
-
-## 🔧 后续配置
-
-### 微信支付配置
-1. 登录微信支付商户平台：https://pay.weixin.qq.com
-2. 获取商户号（mchId）
-3. 配置支付密钥（apiV3Key）
-4. 更新后端API配置
-
-### 服务器域名配置
-在小程序后台「开发」→「开发管理」→「开发设置」中配置：
-
-**request合法域名**：
-- http://kr-soul.lytiao.com
-
-**uploadFile合法域名**：
-- http://kr-soul.lytiao.com
-
-**downloadFile合法域名**：
-- http://kr-soul.lytiao.com
-
----
-
-## 📊 项目数据
-
-### 代码统计
-- 小程序代码：65.3 KB
-- 页面数量：4个（index/match/my/read）
-- 组件数量：底部导航 + 自定义组件若干
-
-### 接口清单
-- `/api/wechat/login` - 微信登录
-- `/api/book/latest-chapters` - 获取最新章节
-- `/api/book/chapter/[id]` - 获取章节详情
-- `/api/payment/*` - 支付相关接口
-- `/api/referral/*` - 分销相关接口
-
----
-
-## 🚀 自动部署脚本
-
-已创建自动部署脚本：`miniprogram/自动部署.sh`
-
-**使用方法**：
-\`\`\`bash
-cd miniprogram
-./自动部署.sh
-\`\`\`
-
-**功能**：
-- ✅ 自动打开微信开发者工具
-- ✅ 自动编译项目
-- ✅ 自动生成预览二维码
-- ✅ 自动上传代码
-
----
-
-## 📝 版本说明
-
-### v1.0.0 (2026-01-14)
-**功能**：
-- 3按钮底部导航（首页/匹配书友/我的）
-- Soul风格随机匹配书友功能
-- 书籍章节阅读
-- 个人中心和分销系统
-- H5和小程序界面统一
-
-**优化**：
-- 移除了"目录"和"派对群"按钮
-- 统一黑色主题风格
-- iOS风格毛玻璃效果
-- 移除所有技术支持联系方式
-
----
-
-## 🎨 界面展示
-
-### 首页
-- 书籍封面展示
-- 书籍简介
-- 快速购买按钮
-
-### 匹配书友
-- Soul风格星球动画
-- 随机匹配按钮
-- 匹配结果展示
-- 添加好友功能
-
-### 我的
-- 个人信息展示
-- 我的书架
-- 分销中心
-- 邀请好友
-- 收益统计
-
-### 阅读页
-- 章节内容展示
-- 上一章/下一章导航
-- 阅读进度保存
-
----
-
-## 💡 运营建议
-
-### 1. 内容运营
-- 定期更新章节内容
-- 优化章节标题和简介
-- 增加章节评论功能
-
-### 2. 用户运营
-- 完善匹配算法（兴趣标签、阅读偏好）
-- 增加用户互动功能（评论、点赞）
-- 建立书友社群
-
-### 3. 分销运营
-- 设计分销海报模板
-- 制定分销奖励政策
-- 培训分销员话术
-
-### 4. 数据分析
-- 监控用户活跃度
-- 分析阅读行为
-- 优化转化漏斗
-
----
-
-## 🔗 相关链接
-
-- 小程序后台：https://mp.weixin.qq.com
-- 微信支付商户平台：https://pay.weixin.qq.com
-- 小程序开发文档：https://developers.weixin.qq.com/miniprogram/dev/framework/
-- 项目域名：http://kr-soul.lytiao.com
-
----
-
-## 📞 技术支持
-
-如有问题，请查看以下文档：
-- `/miniprogram/README.md` - 小程序说明文档
-- `/miniprogram/小程序快速配置指南.md` - 快速配置指南
-- `/miniprogram/小程序部署说明.md` - 部署说明文档
-- `/开发文档/` - 完整开发文档
-
----
-
-## 🎉 恭喜！
-
-你的Soul派对小程序已经成功上传到微信后台！  
-现在只需要在小程序后台提交审核，审核通过后即可正式上线！
-
-**加油！祝你的创业实验成功！** 🚀

开发文档/8、部署/🎊最新代码部署成功.md

@@ -1,160 +0,0 @@
-# 🎊 Soul 项目最新代码部署成功！
-
-## 📅 部署信息
-
-**完成时间**: 2026-01-17 22:09  
-**服务器**: 42.194.232.22（腾讯云轻量服务器）  
-**域名**: soul.quwanzhi.com  
-**管理方式**: 宝塔 Node 管理工具（www 用户的 PM2）
-
----
-
-## ✅ 部署完成
-
-### 最新代码已部署
-
-- ✅ **代码版本**: 最新（刚上传）
-- ✅ **文件大小**: 3.80 MB
-- ✅ **依赖包**: 192 个
-- ✅ **路由数量**: 48 个（比之前多了6个新路由）
-- ✅ **新增功能**: 分销系统相关路由
-
-### 新增的路由
-
-相比之前的 42 个路由，现在有 48 个路由，新增：
-- `/admin/distribution` - 分销管理
-- `/api/distribution` - 分销 API
-- `/api/distribution/auto-withdraw-config` - 自动提现配置
-- `/api/distribution/messages` - 分销消息
-- `/api/payment/methods` - 支付方式
-- `/api/payment/query` - 支付查询
-- `/api/payment/status/[orderSn]` - 订单状态查询
-
----
-
-## 📊 运行状态
-
-### PM2 进程
-- **状态**: ✅ Online
-- **PID**: 正在运行
-- **用户**: www（宝塔用户）
-- **工作目录**: /www/wwwroot/soul
-- **运行时间**: 刚启动
-- **重启次数**: 0
-
-### HTTP 响应
-- **端口**: 3006
-- **监听**: :::3006（IPv6）
-- **响应**: HTTP 200 OK
-- **内容**: 返回完整 Soul 项目 HTML
-
-### 配置文件
-- **Next.js**: output: 'standalone'
-- **PM2 配置**: /www/server/nodejs/vhost/pm2_configs/soul/ecosystem.config.cjs
-- **Nginx 配置**: /www/server/panel/vhost/nginx/soul.quwanzhi.com.conf
-
----
-
-## 🔧 技术栈
-
-### 依赖包（192个）
-- Next.js 16.0.10
-- React 19.2.3
-- TypeScript 5.9.3
-- Tailwind CSS 4.1.18
-- Radix UI 组件库
-- Framer Motion 动画
-- Zustand 状态管理
-- **新增**: qrcode, @types/qrcode
-
----
-
-## 🌐 访问方式
-
-### 域名访问
-```
-http://soul.quwanzhi.com
-```
-
-### IP 访问
-```
-http://42.194.232.22
-```
-
----
-
-## 📱 在宝塔面板查看
-
-1. **登录宝塔面板**
-   - https://42.194.232.22:9988/ckbpanel
-   - 账号：ckb / 密码：zhiqun1984
-
-2. **查看项目**
-   - 点击 "网站" → "Node项目"
-   - 刷新页面（F5）
-   - 应该能看到 soul 项目
-
-3. **管理项目**
-   - 点击 soul 项目
-   - 查看日志、状态
-   - 可以停止/重启项目
-
----
-
-## 🛠️ 管理命令
-
-### 宝塔 PM2 命令
-
-```bash
-# 查看所有项目
-sudo -u www pm2 list
-
-# 查看 soul 详情
-sudo -u www pm2 show soul
-
-# 查看日志
-sudo -u www pm2 logs soul
-
-# 重启项目
-sudo -u www pm2 restart soul
-
-# 停止项目
-sudo -u www pm2 stop soul
-```
-
----
-
-## 📋 备份信息
-
-旧代码已备份到：
-```
-/www/wwwroot/soul_old_1768658797
-```
-
-如需恢复旧版本：
-```bash
-cd /www/wwwroot
-rm -rf soul
-mv soul_old_1768658797 soul
-sudo -u www pm2 restart soul
-```
-
----
-
-## ✨ 部署成功！
-
-**Soul 项目最新代码已成功部署到服务器！**
-
-- ✅ 代码已更新（48个路由）
-- ✅ 依赖已安装
-- ✅ 项目已构建
-- ✅ 服务已启动
-- ✅ HTTP 响应正常
-- ✅ 由宝塔管理
-
-**访问 http://soul.quwanzhi.com 即可查看最新版本！**
-
----
-
-**部署时间**: 2026-01-17 22:09  
-**状态**: ✅ 成功

开发文档/8、部署/🎊最终部署完成.md

@@ -1,594 +0,0 @@
-# 🎊 Soul 项目完整部署报告
-
-## 📅 部署信息
-
-**部署日期**: 2026-01-15  
-**项目名称**: Soul  
-**项目类型**: Next.js 16.0.10  
-**服务器**: 42.194.232.22  
-**域名**: soul.quwanzhi.com  
-
----
-
-## ✅ 部署状态
-
-### 🎯 所有问题已解决！
-
-项目已成功部署，所有配置正确，DNS 解析已修复。
-
----
-
-## 🔧 解决的问题
-
-### 问题 1: 域名显示错误内容 ❌ → ✅
-
-**问题描述**:  
-浏览器访问 `soul.quwanzhi.com` 显示的不是 Soul 项目的内容，而是其他服务器的登录页面。
-
-**问题原因**:  
-DNS 解析错误！域名指向了错误的服务器：
-- 错误 IP: `43.139.76.198` 和 `43.139.27.93`
-- 正确 IP: `42.194.232.22`
-
-**解决方案**:  
-使用阿里云 DNS API 自动修改了 DNS 解析记录：
-```bash
-python3 自动修复DNS.py
-```
-
-**解决结果**: ✅ 已完成
-- DNS 记录已在阿里云修改为正确的 IP
-- 等待 DNS 全球生效（5-10 分钟）
-
----
-
-## 📊 完整部署流程
-
-### 1. 环境准备 ✅
-- [x] 检查 API 白名单
-- [x] 检查服务器端口（3006）
-- [x] 验证 Node.js 环境（v22.14.0）
-- [x] 验证 pnpm 包管理器
-
-### 2. 项目上传 ✅
-- [x] 压缩项目文件（3.70 MB）
-- [x] 排除 node_modules、.git、.next 等
-- [x] 上传到服务器 `/www/wwwroot/soul`
-- [x] 解压文件
-
-### 3. 依赖安装与构建 ✅
-- [x] 安装 210 个依赖包（使用 pnpm）
-- [x] 构建 Next.js 项目（42 个路由）
-- [x] 生成 standalone 输出
-- [x] 构建时间：19.3 秒
-
-### 4. PM2 进程管理 ✅
-- [x] 创建 PM2 配置文件
-- [x] 启动 soul 进程
-- [x] 配置自动重启
-- [x] 进程状态：online ✅
-
-### 5. Nginx 反向代理 ✅
-- [x] 创建 Nginx 配置文件
-- [x] 配置反向代理到 localhost:3006
-- [x] 启用 WebSocket 支持
-- [x] 配置静态资源缓存
-- [x] 重载 Nginx 服务
-
-### 6. DNS 解析修复 ✅
-- [x] 诊断 DNS 解析问题
-- [x] 使用阿里云 API 修改解析记录
-- [x] 验证解析记录修改成功
-- [x] 等待 DNS 全球生效
-
----
-
-## 🌐 访问方式
-
-### 主要访问（推荐）
-```
-http://soul.quwanzhi.com
-```
-
-### 备用访问（IP直接访问）
-```
-http://42.194.232.22:3006
-```
-
-> 💡 **提示**: 如果域名访问还显示旧内容，请清除浏览器缓存或使用无痕模式。
-
----
-
-## 📦 项目详情
-
-### 技术栈
-- **框架**: Next.js 16.0.10
-- **React**: 19.2.3
-- **TypeScript**: 5.9.3
-- **UI**: Tailwind CSS 4.1.18 + Radix UI
-- **状态管理**: Zustand 5.0.9
-- **动画**: Framer Motion 12.26.2
-
-### 项目结构
-```
-/www/wwwroot/soul/
-├── app/              # Next.js 应用目录
-├── components/       # React 组件
-├── lib/              # 工具函数
-├── public/           # 静态资源
-├── book/             # 书籍内容
-├── miniprogram/      # 小程序相关
-├── .next/            # Next.js 构建输出
-├── node_modules/     # 依赖包
-├── logs/             # PM2 日志
-└── ecosystem.config.json  # PM2 配置
-```
-
-### 路由列表（42 个）
-
-#### 用户端路由
-- `/` - 首页
-- `/about` - 关于页面
-- `/login` - 登录页面
-- `/chapters` - 章节列表
-- `/read/[id]` - 章节阅读
-- `/match` - 匹配功能
-- `/my` - 个人中心
-- `/my/purchases` - 我的购买
-- `/my/referral` - 推荐奖励
-- `/docs` - 文档
-- `/documentation` - 文档系统
-- `/documentation/capture` - 文档捕获
-
-#### 管理后台路由
-- `/admin` - 管理后台首页
-- `/admin/login` - 后台登录
-- `/admin/users` - 用户管理
-- `/admin/content` - 内容管理
-- `/admin/payment` - 支付管理
-- `/admin/settings` - 系统设置
-- `/admin/site` - 站点配置
-- `/admin/qrcodes` - 二维码管理
-- `/admin/withdrawals` - 提现管理
-
-#### API 接口路由
-- `/api/admin` - 后台管理接口
-- `/api/admin/content` - 内容管理接口
-- `/api/admin/payment` - 支付管理接口
-- `/api/admin/referral` - 推荐系统接口
-- `/api/book/all-chapters` - 获取所有章节
-- `/api/book/chapter/[id]` - 获取章节详情
-- `/api/book/latest-chapters` - 获取最新章节
-- `/api/book/sync` - 同步书籍
-- `/api/ckb/join` - CKB 加入接口
-- `/api/config` - 配置接口
-- `/api/content` - 内容接口
-- `/api/documentation/generate` - 文档生成
-- `/api/menu` - 菜单接口
-- `/api/orders` - 订单接口
-- `/api/payment/create-order` - 创建订单
-- `/api/payment/verify` - 支付验证
-- `/api/payment/callback` - 支付回调
-- `/api/payment/alipay/notify` - 支付宝通知
-- `/api/payment/wechat/notify` - 微信通知
-- `/api/sync` - 同步接口
-- `/api/wechat/login` - 微信登录
-
----
-
-## 🛠️ 服务器配置
-
-### PM2 配置
-**文件位置**: `/www/wwwroot/soul/ecosystem.config.json`
-
-```json
-{
-  "apps": [{
-    "name": "soul",
-    "cwd": "/www/wwwroot/soul",
-    "script": "node_modules/next/dist/bin/next",
-    "args": "start",
-    "env": {
-      "NODE_ENV": "production",
-      "PORT": "3006"
-    },
-    "instances": 1,
-    "exec_mode": "fork",
-    "max_memory_restart": "500M",
-    "error_file": "/www/wwwroot/soul/logs/error.log",
-    "out_file": "/www/wwwroot/soul/logs/out.log"
-  }]
-}
-```
-
-### Nginx 配置
-**文件位置**: `/www/server/panel/vhost/nginx/soul.quwanzhi.com.conf`
-
-主要配置：
-- 监听端口：80
-- 反向代理：localhost:3006
-- WebSocket 支持：已启用
-- 静态资源缓存：60 分钟
-- 上传限制：50MB
-
----
-
-## 📝 管理命令
-
-### PM2 进程管理
-
-```bash
-# 查看项目状态
-pm2 status soul
-
-# 查看项目详情
-pm2 show soul
-
-# 查看实时日志
-pm2 logs soul
-
-# 查看最近日志
-pm2 logs soul --lines 100
-
-# 重启项目
-pm2 restart soul
-
-# 停止项目
-pm2 stop soul
-
-# 删除项目
-pm2 delete soul
-```
-
-### Nginx 管理
-
-```bash
-# 测试配置
-nginx -t
-
-# 重载配置
-nginx -s reload
-
-# 重启 Nginx
-systemctl restart nginx
-
-# 查看 Nginx 状态
-systemctl status nginx
-
-# 查看访问日志
-tail -f /www/wwwlogs/soul.quwanzhi.com.log
-
-# 查看错误日志
-tail -f /www/wwwlogs/soul.quwanzhi.com.error.log
-```
-
-### DNS 验证
-
-```bash
-# 查询 DNS 解析
-nslookup soul.quwanzhi.com
-
-# Ping 测试
-ping soul.quwanzhi.com
-
-# 测试 HTTP 访问
-curl -I http://soul.quwanzhi.com
-```
-
-### 清除 DNS 缓存
-
-```bash
-# Mac 系统
-sudo dscacheutil -flushcache && sudo killall -HUP mDNSResponder
-
-# Windows 系统
-ipconfig /flushdns
-
-# Linux 系统
-sudo systemd-resolve --flush-caches
-```
-
----
-
-## 🔄 更新部署流程
-
-### 自动更新（推荐）
-
-只需重新运行部署脚本：
-
-```bash
-cd /Users/karuo/Documents/开发/4、小工具/服务器管理
-python3 部署soul项目.py
-```
-
-脚本会自动：
-1. 停止旧进程
-2. 上传新代码
-3. 安装依赖
-4. 构建项目
-5. 启动新进程
-
-### 手动更新
-
-```bash
-# 1. SSH 登录服务器
-ssh root@42.194.232.22
-
-# 2. 进入项目目录
-cd /www/wwwroot/soul
-
-# 3. 拉取最新代码（如果使用 Git）
-git pull
-
-# 4. 安装依赖
-pnpm install
-
-# 5. 构建项目
-pnpm run build
-
-# 6. 重启 PM2
-pm2 restart soul
-```
-
----
-
-## 🔒 安全建议
-
-### 1. SSL 证书配置
-
-建议为域名配置 HTTPS：
-
-1. 登录宝塔面板：https://42.194.232.22:9988/ckbpanel
-2. 找到网站 `soul.quwanzhi.com`
-3. 点击「SSL」→「Let's Encrypt」
-4. 申请免费证书（自动续期）
-5. 开启「强制 HTTPS」
-
-### 2. 环境变量配置
-
-敏感信息应该配置为环境变量：
-
-```bash
-# 编辑 PM2 配置
-nano /www/wwwroot/soul/ecosystem.config.json
-
-# 添加环境变量
-{
-  "env": {
-    "NODE_ENV": "production",
-    "PORT": "3006",
-    "DATABASE_URL": "your_database_url",
-    "API_SECRET": "your_api_secret"
-  }
-}
-```
-
-### 3. 防火墙配置
-
-建议仅开放必要端口：
-- 80 (HTTP)
-- 443 (HTTPS)
-- 22 (SSH，限制 IP 访问)
-- 9988 (宝塔面板，限制 IP 访问)
-
----
-
-## 📈 性能优化
-
-### 已实现的优化
-
-1. **Next.js Standalone 输出**
-   - 减小部署体积
-   - 提高启动速度
-
-2. **Nginx 静态资源缓存**
-   - `/_next/static` 缓存 60 分钟
-   - 减少服务器压力
-
-3. **PM2 进程管理**
-   - 自动重启
-   - 内存限制：500MB
-   - 日志管理
-
-### 可进一步优化
-
-1. **CDN 加速**
-   - 配置阿里云 CDN
-   - 加速静态资源访问
-
-2. **数据库优化**
-   - 启用数据库连接池
-   - 添加适当索引
-
-3. **缓存策略**
-   - Redis 缓存热点数据
-   - API 响应缓存
-
----
-
-## 📊 监控与日志
-
-### PM2 日志位置
-- **标准输出**: `/www/wwwroot/soul/logs/out.log`
-- **错误日志**: `/www/wwwroot/soul/logs/error.log`
-
-### Nginx 日志位置
-- **访问日志**: `/www/wwwlogs/soul.quwanzhi.com.log`
-- **错误日志**: `/www/wwwlogs/soul.quwanzhi.com.error.log`
-
-### 实时监控
-
-```bash
-# PM2 实时监控
-pm2 monit
-
-# Nginx 实时日志
-tail -f /www/wwwlogs/soul.quwanzhi.com.log
-
-# 系统资源监控
-htop
-```
-
----
-
-## 🐛 故障排查
-
-### 问题 1: 项目无法访问
-
-**排查步骤**:
-
-```bash
-# 1. 检查 PM2 进程
-pm2 status soul
-
-# 2. 查看日志
-pm2 logs soul --lines 50
-
-# 3. 检查端口监听
-netstat -tuln | grep 3006
-
-# 4. 测试本地访问
-curl http://localhost:3006
-```
-
-### 问题 2: Nginx 502 错误
-
-**排查步骤**:
-
-```bash
-# 1. 检查 Nginx 配置
-nginx -t
-
-# 2. 检查 Nginx 错误日志
-tail -f /www/wwwlogs/soul.quwanzhi.com.error.log
-
-# 3. 重启 Nginx
-nginx -s reload
-```
-
-### 问题 3: DNS 未生效
-
-**排查步骤**:
-
-```bash
-# 1. 查询 DNS
-nslookup soul.quwanzhi.com
-
-# 2. 清除本地 DNS 缓存
-sudo dscacheutil -flushcache && sudo killall -HUP mDNSResponder
-
-# 3. 使用其他 DNS 测试
-nslookup soul.quwanzhi.com 8.8.8.8
-```
-
----
-
-## 📁 相关文件
-
-### 部署脚本
-- **主部署脚本**: `/Users/karuo/Documents/开发/4、小工具/服务器管理/部署soul项目.py`
-- **DNS 修复脚本**: `/Users/karuo/Documents/开发/4、小工具/服务器管理/自动修复DNS.py`
-
-### 文档
-- **部署报告**: `/Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验/部署完成报告.md`
-- **DNS 修复说明**: `/Users/karuo/Documents/个人/部署记录/Soul项目DNS修复完成.html`
-- **部署成功页面**: `/Users/karuo/Documents/个人/部署记录/Soul项目部署成功.html`
-
----
-
-## 🎉 部署总结
-
-### 完成情况
-
-✅ **项目部署**: 完成  
-✅ **依赖安装**: 完成  
-✅ **项目构建**: 完成  
-✅ **PM2 启动**: 完成  
-✅ **Nginx 配置**: 完成  
-✅ **DNS 解析**: 完成  
-
-### 关键指标
-
-| 指标 | 值 |
-|------|-----|
-| 项目大小 | 3.70 MB |
-| 依赖数量 | 210 个 |
-| 构建时间 | 19.3 秒 |
-| 路由数量 | 42 个 |
-| 运行端口 | 3006 |
-| 内存使用 | ~90 MB |
-| 进程状态 | Online ✅ |
-
-### 部署时间线
-
-- **06:02** - 开始部署
-- **06:02** - 压缩并上传项目文件
-- **06:02** - 安装依赖（25.7 秒）
-- **06:03** - 构建项目（19.3 秒）
-- **06:03** - PM2 启动成功
-- **06:03** - Nginx 配置完成
-- **06:08** - 发现 DNS 问题
-- **06:09** - DNS 修复完成
-
-**总耗时**: 约 7 分钟（包含问题诊断和修复）
-
----
-
-## 🚀 下一步建议
-
-1. ✅ **DNS 生效验证**
-   - 等待 5-10 分钟
-   - 使用 `nslookup` 验证
-   - 浏览器访问测试
-
-2. 🔒 **配置 SSL 证书**
-   - 登录宝塔面板
-   - 申请 Let's Encrypt 证书
-   - 启用 HTTPS
-
-3. 📊 **配置监控**
-   - 设置 PM2 监控告警
-   - 配置 Nginx 访问统计
-   - 添加服务器资源监控
-
-4. 💾 **配置数据库**
-   - 根据项目需求配置数据库
-   - 设置数据库备份
-   - 优化数据库连接
-
-5. 🔄 **配置 CI/CD**
-   - 设置 Git Webhook
-   - 自动部署流程
-   - 代码推送自动更新
-
----
-
-## 📞 联系与支持
-
-**服务器信息**:
-- IP: 42.194.232.22
-- 宝塔面板: https://42.194.232.22:9988/ckbpanel
-
-**项目访问**:
-- 域名: http://soul.quwanzhi.com
-- IP: http://42.194.232.22:3006
-
----
-
-## ✨ 结语
-
-Soul 项目已成功部署到生产环境！
-
-- ✅ 项目运行稳定
-- ✅ 域名解析正确
-- ✅ 所有功能正常
-- ✅ 自动重启已配置
-
-现在可以通过 **http://soul.quwanzhi.com** 访问你的项目了！
-
-祝你的 Soul 项目运营顺利！🎊
-
----
-
-**最后更新**: 2026-01-15 06:09  
-**状态**: ✅ 部署完成，运行正常

开发文档/8、部署/🎯升级完成.md

@@ -1,335 +0,0 @@
-# 🎯 Soul派对 v1.1.0 - 升级完成！
-
-## ✨ 本次更新内容
-
-### 时间：2026年1月14日
-### 版本：v1.1.0
-### 状态：✅ 已上传并部署
-
----
-
-## 🔥 核心更新
-
-### 1. 匹配页面全新升级（参考玩值电竞设计）
-
-#### 新增功能：
-- **3个选项卡**：阅读匹配、书友派对、共读
-- **中央大星球按钮**：渐变色星球（蓝-紫-粉）+ 浮动动画 + 光环效果
-- **4种匹配类型**：
-  - ⭐ 读书明星
-  - 👥 作者见面
-  - 💕 阅读CP
-  - 🎮 读书陪伴
-- **交互优化**：点击星球开始匹配，选择不同匹配类型
-
-#### 设计亮点：
-\`\`\`
-顶部：星球标题
-↓
-选项卡：阅读匹配 | 书友派对 | 共读（带下划线指示器）
-↓
-中央：渐变色大星球（带"开始匹配，寻找读书明星"文字）
-↓
-提示：当前模式 - 读书明星
-↓
-底部：4个匹配类型卡片（网格布局）
-\`\`\`
-
-### 2. 首页显示所有章节
-
-#### 升级内容：
-- **从"最新3章"升级为"全部章节"**
-- **显示章节序号**：1、2、3...
-- **完整元数据**：标题、更新时间、字数
-- **即时访问**：点击任意章节直接阅读
-
-#### 章节列表示例：
-\`\`\`
-📚 全部章节 (共10章)
-
-1 ┃ 序言｜为什么我每天早上6点在Soul开播？
-   刚刚 · 3200字 →
-
-2 ┃ 第一章｜我是谁
-   1天前 · 4500字 →
-
-3 ┃ 第二章｜2024年，我定了一个小目标
-   1天前 · 3800字 →
-   
-... (更多章节)
-\`\`\`
-
-### 3. H5和小程序界面统一
-
-#### 统一特性：
-- ✅ 相同的匹配页面设计（3选项卡+星球+4类型）
-- ✅ 相同的章节展示方式
-- ✅ 相同的视觉风格（黑色主题+渐变色）
-- ✅ 相同的交互逻辑
-
----
-
-## 🎨 界面对比
-
-### 匹配页面
-
-**旧版：**
-- 简单标题"发现书友"
-- 单个星球图片
-- 几个提示文本
-- 一个"开始匹配"按钮
-
-**新版：**
-- "星球"大标题
-- 3个选项卡切换
-- 渐变色中央大星球（蓝-紫-粉）+ 浮动效果
-- 4种匹配类型选择
-- 更丰富的视觉效果和动画
-
-### 首页
-
-**旧版：**
-- 只显示最新3章
-- "查看全部"按钮跳转
-
-**新版：**
-- 直接显示所有章节
-- 带序号和完整信息
-- 无需额外跳转
-
----
-
-## 📊 技术实现
-
-### 小程序端
-
-#### 匹配页面 (pages/match/match.*)
-\`\`\`javascript
-// 新增数据
-activeTab: 0,  // 当前选项卡
-selectedMode: 0,  // 选中的匹配类型
-matchModes: [
-  { id: 'reader', name: '读书明星', icon: '⭐' },
-  { id: 'party', name: '作者见面', icon: '👥' },
-  { id: 'couple', name: '阅读CP', icon: '💕' },
-  { id: 'coach', name: '读书陪伴', icon: '🎮' }
-]
-
-// 新增方法
-switchTab(e)  // 切换选项卡
-selectMode(e)  // 选择匹配类型
-\`\`\`
-
-#### 样式特点
-- 中央星球：460rpx × 460rpx
-- 渐变色：#00E5FF → #7B61FF → #E91E63
-- 浮动动画：3秒循环，Y轴 0 → -20rpx → 0
-- 光环效果：径向渐变 + 脉冲动画
-
-#### 首页 (pages/index/index.*)
-\`\`\`javascript
-// 数据变更
-latestChapters → allChapters  // 最新章节 → 全部章节
-
-// API变更
-/api/book/latest-chapters → /api/book/all-chapters
-
-// 显示变更
-显示前3章 → 显示全部章节（带序号）
-\`\`\`
-
-### H5端
-
-#### 匹配页面 (app/match/page.tsx)
-\`\`\`typescript
-// 完全重构，与小程序保持一致
-- 3个选项卡（Framer Motion动画）
-- 中央渐变星球（CSS渐变+动画）
-- 4种匹配类型（Grid布局）
-- 统一的视觉风格
-\`\`\`
-
----
-
-## 🚀 部署信息
-
-### 小程序
-- **版本号**: 1.1.0
-- **更新说明**: "新版本：参考玩值电竞星球设计，3选项卡+4匹配类型+完整章节列表"
-- **部署状态**: ✅ 已上传到微信后台
-- **包大小**: ~67KB
-
-### H5
-- **部署状态**: ✅ 正在运行
-- **访问地址**: http://localhost:3000
-- **匹配页面**: http://localhost:3000/match
-
----
-
-## 🎯 用户体验提升
-
-### 1. 匹配功能
-**提升点**：
-- 更清晰的分类（4种匹配类型）
-- 更直观的操作（点击星球即可匹配）
-- 更丰富的视觉效果（渐变+动画）
-- 更强的品牌感（参考知名产品设计）
-
-**用户反馈预期**：
-- "哇，这个星球好酷！"
-- "匹配类型很清楚，我知道该选哪个"
-- "动画效果很流畅"
-
-### 2. 章节浏览
-**提升点**：
-- 一次性看到所有章节（无需跳转）
-- 序号清晰（快速定位）
-- 信息完整（更新时间+字数）
-
-**用户反馈预期**：
-- "终于能看到全部章节了"
-- "不用再点来点去找章节"
-- "知道每章多少字，方便安排阅读时间"
-
----
-
-## 📱 页面截图对比
-
-### 匹配页面
-
-**小程序端：**
-\`\`\`
-┌─────────────────────────────┐
-│         ⚙️  星球              │
-├─────────────────────────────┤
-│  阅读匹配  书友派对  共读    │
-│     ═══                     │
-├─────────────────────────────┤
-│                             │
-│      ╭─────────────╮        │
-│      │   🎤        │        │
-│      │ 开始匹配    │ ← 渐变球
-│      │寻找读书明星 │        │
-│      ╰─────────────╯        │
-│          ◯              │
-│                             │
-│ 当前模式：读书明星          │
-│                             │
-│  选择匹配类型               │
-│ ┌───┐ ┌───┐ ┌───┐ ┌───┐  │
-│ │⭐│ │👥│ │💕│ │🎮│  │
-│ │读书││作者││阅读││读书││  │
-│ │明星││见面││CP ││陪伴││  │
-│ └───┘ └───┘ └───┘ └───┘  │
-└─────────────────────────────┘
-\`\`\`
-
-### 首页章节列表
-
-**小程序端：**
-\`\`\`
-┌─────────────────────────────┐
-│ 📚 全部章节     共10章       │
-├─────────────────────────────┤
-│ 1 ┃ 序言｜为什么我每天...   │
-│    刚刚 · 3200字          → │
-├─────────────────────────────┤
-│ 2 ┃ 第一章｜我是谁          │
-│    1天前 · 4500字         → │
-├─────────────────────────────┤
-│ 3 ┃ 第二章｜2024年...       │
-│    1天前 · 3800字         → │
-├─────────────────────────────┤
-│ ...（所有章节）              │
-└─────────────────────────────┘
-\`\`\`
-
----
-
-## ✅ 检查清单
-
-- [x] 小程序匹配页面升级（3选项卡+星球+4类型）
-- [x] H5匹配页面升级（与小程序保持一致）
-- [x] 小程序首页显示所有章节
-- [x] 章节列表添加序号
-- [x] 界面风格统一（黑色主题+渐变色）
-- [x] 动画效果优化（浮动+脉冲+旋转）
-- [x] 代码上传到微信后台
-- [x] H5服务器运行正常
-- [x] 文档更新完成
-
----
-
-## 🔗 相关资源
-
-### 小程序
-- 后台地址：https://mp.weixin.qq.com
-- AppID：wx0976665c3a3d5a7c
-- 版本：v1.1.0
-
-### H5
-- 本地地址：http://localhost:3000
-- 匹配页面：http://localhost:3000/match
-- 首页：http://localhost:3000
-
-### 参考设计
-- 玩值电竞 - 星球匹配功能
-- Soul APP - 语音匹配界面
-
----
-
-## 🎉 下一步
-
-### 立即操作：
-1. ✅ 登录小程序后台
-2. ✅ 找到开发版本 v1.1.0
-3. ✅ 点击"提交审核"
-4. ✅ 等待审核通过（1-7天）
-
-### 后续优化建议：
-1. **真实匹配算法**
-   - 基于阅读历史
-   - 基于兴趣标签
-   - 基于在线时间
-
-2. **聊天功能**
-   - 实时消息
-   - 表情包支持
-   - 语音消息
-
-3. **匹配记录**
-   - 历史匹配查看
-   - 好友关系维护
-   - 再次匹配提醒
-
-4. **数据分析**
-   - 匹配成功率
-   - 用户活跃度
-   - 功能使用热度
-
----
-
-## 💬 总结
-
-本次升级是一次**重大视觉和功能改进**：
-
-**视觉层面**：
-- 参考业界成熟产品（玩值电竞）
-- 统一H5和小程序体验
-- 增强品牌辨识度
-
-**功能层面**：
-- 更清晰的匹配分类
-- 更完整的章节展示
-- 更流畅的用户体验
-
-**技术层面**：
-- 代码结构优化
-- 动画性能提升
-- 接口统一规范
-
----
-
-**恭喜！你的Soul派对小程序现在更加完善和专业了！** 🎊
-
-**开始下一个创业实验吧！** 🚀

开发文档/8、部署/🎯最终优化完成.md

@@ -1,376 +0,0 @@
-# 🎯 Soul派对 v1.3.0 - 最终优化完成！
-
-## ✅ 完成时间
-
-**时间**: 2026年1月14日  
-**版本**: v1.3.0  
-**状态**: 🎉 **完美对齐，全部完成！**
-
----
-
-## 🎨 核心修改
-
-### 1. 书名修正 ✅
-**修改内容**：
-- ❌ 旧名称："Soul派对·创业实验"
-- ✅ 新名称："一场SOUL的创业实验场"
-
-**修改位置**：
-- 小程序首页标题
-- H5首页标题
-- 所有文档引用
-
-### 2. 匹配功能重新定位 ✅
-**修改内容**：
-- ❌ 旧名称："匹配书友" / "寻找读书明星"
-- ✅ 新名称："寻找合作伙伴"
-
-**功能定位变化**：
-\`\`\`
-之前：读书社交
-现在：创业合作
-
-之前提示：
-  📚 共同阅读的章节
-  💬 实时在线聊天
-  🎯 相似的阅读兴趣
-
-现在提示：
-  💼 共同的创业方向
-  💬 实时在线交流
-  🎯 相似的商业洞察
-\`\`\`
-
-### 3. H5首页设计对齐 ✅
-**小程序首页现在完全对齐H5**：
-
-\`\`\`
-🎉 Soul · 派对房（顶部标签）
-↓
-一场SOUL的（大标题）
-创业实验场（渐变副标题）
-↓
-来自Soul派对房的真实商业故事（标语）
-"社会不是靠努力，是靠洞察与选择"（引言）
-↓
-[ ¥9.9 整本价格 | 64 商业案例 ]（数据卡片）
-↓
-[ 作者：卡若 | 每日直播：06:00-09:00 ]（作者信息）
-↓
-[ 📖 立即阅读 ]（大按钮）
-首章免费 · 部分章节3天后解锁
-↓
-"这不是一本教你成功的鸡汤书..."（寄语卡片）
-↓
-[ 64+ 真实案例 | 5 核心篇章 | 100+ 商业洞察 ]
-↓
-📚 全部章节（共64章）
-  1 │ 序言｜为什么我每天早上6点在Soul开播？
-  2 │ 1.1 荷包：电动车出租的被动收入模式
-  ... (所有64章)
-↓
-[ 购买整本 ]
-[ 分享赚佣金 ]
-\`\`\`
-
-### 4. 图标优化 ✅
-**添加/更新的图标**：
-- 📖 立即阅读按钮
-- 🎉 Soul · 派对房标签
-- 💼 共同创业方向
-- 🤝 寻找合作伙伴（替换🎤）
-- 💬 实时交流
-- 🎯 商业洞察
-
-### 5. 数据精准对齐 ✅
-**确保数据准确**：
-\`\`\`json
-{
-  "书名": "一场SOUL的创业实验场",
-  "价格": "¥9.9",
-  "章节数": 64,
-  "核心篇章": 5,
-  "商业洞察": "100+",
-  "作者": "卡若",
-  "直播时间": "06:00-09:00"
-}
-\`\`\`
-
-**数据来源验证**：
-- ✅ 从book文件夹扫描：64章
-- ✅ 生成JSON：public/book-chapters.json
-- ✅ API返回：64章
-- ✅ 界面显示：64章
-
----
-
-## 📊 完整对比
-
-### 首页设计对比
-
-#### 修改前：
-\`\`\`
-Soul派对·创业实验（简单标题）
-一场真实的商业探索（副标题）
-↓
-关于这本书（简介卡片）
-↓
-[ 56 章节 | 12万 字数 | 1.2万 读者 ]
-↓
-全部章节（列表）
-\`\`\`
-
-#### 修改后（完全对齐H5）：
-\`\`\`
-🎉 Soul · 派对房
-↓
-一场SOUL的
-创业实验场（渐变）
-↓
-来自Soul派对房的真实商业故事
-"社会不是靠努力，是靠洞察与选择"
-↓
-[ ¥9.9 | 64 商业案例 ]
-↓
-[ 作者：卡若 | 06:00-09:00 ]
-↓
-📖 立即阅读
-↓
-"这不是一本教你成功的鸡汤书..."
-↓
-[ 64+ 真实案例 | 5 核心篇章 | 100+ 商业洞察 ]
-↓
-全部64章目录
-\`\`\`
-
-### 匹配页面对比
-
-#### 修改前：
-\`\`\`
-匹配书友
-找到和你一样热爱阅读的灵魂
-↓
-开始匹配（🎤）
-寻找读书明星
-↓
-📚 共同阅读的章节
-💬 实时在线聊天
-🎯 相似的阅读兴趣
-\`\`\`
-
-#### 修改后：
-\`\`\`
-寻找合作伙伴
-找到和你一起创业的灵魂
-↓
-开始匹配（🤝）
-寻找合作伙伴
-↓
-💼 共同的创业方向
-💬 实时在线交流
-🎯 相似的商业洞察
-\`\`\`
-
-### 底部导航对比
-
-#### 修改前：
-\`\`\`
-[ 首页 | 匹配书友 | 我的 ]
-\`\`\`
-
-#### 修改后：
-\`\`\`
-[ 首页 | 匹配合作 | 我的 ]
-\`\`\`
-
----
-
-## 🎯 功能定位变化
-
-### 整体定位
-**从"读书社交"转变为"创业合作"**
-
-### 目标用户
-**之前**：读书爱好者  
-**现在**：创业者、合作伙伴
-
-### 核心价值
-**之前**：阅读交流、书友社群  
-**现在**：商业洞察、创业合作
-
-### 匹配目的
-**之前**：找到一起读书的人  
-**现在**：找到一起创业的人
-
----
-
-## 📱 小程序数据
-
-\`\`\`
-版本号：v1.3.0
-文件大小：69.2 KB
-页面数：4个
-AppID：wx0976665c3a3d5a7c
-状态：✅ 已上传
-
-更新说明：
-完全对齐H5界面，改为'一场soul的创业实验'，
-匹配改为'寻找合作伙伴'，数据精准64章
-\`\`\`
-
----
-
-## 🎨 界面统一清单
-
-### H5 vs 小程序对比
-
-| 项目 | H5 | 小程序 | 状态 |
-|------|-----|--------|------|
-| 书名 | 一场SOUL的创业实验场 | 一场SOUL的创业实验场 | ✅ 一致 |
-| 首页布局 | 卡片式 | 卡片式 | ✅ 一致 |
-| 匹配名称 | 寻找合作伙伴 | 寻找合作伙伴 | ✅ 一致 |
-| 匹配图标 | 🤝 | 🤝 | ✅ 一致 |
-| 章节数 | 64 | 64 | ✅ 一致 |
-| 价格 | ¥9.9 | ¥9.9 | ✅ 一致 |
-| 配色 | 黑+绿渐变 | 黑+绿渐变 | ✅ 一致 |
-| 字体大小 | 统一 | 统一 | ✅ 一致 |
-| 按钮样式 | 圆角+阴影 | 圆角+阴影 | ✅ 一致 |
-| 导航栏 | 3个 | 3个 | ✅ 一致 |
-
-**结论**：100% 一致 ✅
-
----
-
-## 📂 修改的文件
-
-### 小程序文件
-1. `miniprogram/pages/index/index.wxml` - 首页布局完全重构
-2. `miniprogram/pages/match/match.wxml` - 匹配页面文案修改
-3. `miniprogram/app.json` - 底部导航文案修改
-4. `miniprogram/pages/index/index.js` - 数据对齐
-
-### H5文件
-1. `app/match/page.tsx` - 匹配页面文案修改
-2. `components/bottom-nav.tsx` - 底部导航文案修改
-
-### 数据文件
-1. `public/book-chapters.json` - 64章准确数据
-2. `scripts/sync-book-content.js` - 同步脚本
-
----
-
-## ✅ 验证清单
-
-- [x] 书名改为"一场SOUL的创业实验场"
-- [x] 匹配改为"寻找合作伙伴"
-- [x] 图标从🎤改为🤝
-- [x] 匹配提示改为创业相关
-- [x] 首页完全对齐H5设计
-- [x] 数据显示64章（准确）
-- [x] 价格显示¥9.9
-- [x] 作者信息：卡若
-- [x] 直播时间：06:00-09:00
-- [x] H5和小程序100%一致
-- [x] 所有图标显示正确
-- [x] 所有文案统一修正
-- [x] 上传到微信后台
-
----
-
-## 🎉 最终效果
-
-### 首页效果
-\`\`\`
-┌──────────────────────────────┐
-│    🎉 Soul · 派对房          │
-├──────────────────────────────┤
-│                              │
-│      一场SOUL的              │
-│    创业实验场（渐变）        │
-│                              │
-│ 来自Soul派对房的真实商业故事 │
-│ "社会不是靠努力，           │
-│   是靠洞察与选择"           │
-│                              │
-├──────────────────────────────┤
-│  ¥9.9     │      64         │
-│ 整本价格   │   商业案例      │
-├──────────────────────────────┤
-│ 👤 作者：卡若               │
-│ ⏰ 每日直播：06:00-09:00   │
-├──────────────────────────────┤
-│    [ 📖 立即阅读 ]          │
-│ 首章免费·部分章节3天后解锁  │
-├──────────────────────────────┤
-│ "这不是一本教你成功的..."   │
-├──────────────────────────────┤
-│ 64+真实 │ 5核心 │ 100+洞察 │
-├──────────────────────────────┤
-│ 📚 全部章节    共64章       │
-│ 1 │ 序言｜为什么...       → │
-│ 2 │ 1.1 荷包...          → │
-│ ... (全部64章)              │
-└──────────────────────────────┘
-\`\`\`
-
-### 匹配页面效果
-\`\`\`
-┌──────────────────────────────┐
-│      寻找合作伙伴            │
-│   找到和你一起创业的灵魂     │
-├──────────────────────────────┤
-│                              │
-│         ╭─────╮              │
-│         │     │              │
-│         │ 🤝  │              │
-│         │开始匹配│            │
-│         │寻找合作伙伴│        │
-│         ╰─────╯              │
-│                              │
-│ 💼 共同的创业方向            │
-│ 💬 实时在线交流              │
-│ 🎯 相似的商业洞察            │
-│                              │
-└──────────────────────────────┘
-\`\`\`
-
----
-
-## 📝 下一步
-
-### 立即操作
-1. ✅ 登录小程序后台：https://mp.weixin.qq.com
-2. ✅ 找到 v1.3.0
-3. ✅ 提交审核
-4. ✅ 填写说明：
-   \`\`\`
-   最终版本：完全对齐H5界面，
-   改为'一场soul的创业实验'，
-   匹配改为'寻找合作伙伴'，
-   数据精准64章
-   \`\`\`
-
----
-
-## 🎊 总结
-
-**恭喜！Soul派对小程序 v1.3.0 已经完美完成！**
-
-### 核心成果
-1. ✅ 书名正确："一场SOUL的创业实验场"
-2. ✅ 定位清晰：从读书社交→创业合作
-3. ✅ 数据准确：64章商业案例
-4. ✅ 界面统一：H5和小程序100%一致
-5. ✅ 图标完整：所有位置都有图标
-6. ✅ 功能对齐：匹配、阅读、分销全部就位
-
-### 用户价值
-- 🎯 清晰的定位：创业合作平台
-- 💼 精准的匹配：找到合作伙伴
-- 📚 丰富的内容：64个商业案例
-- 🤝 便捷的连接：一键加好友
-- 💰 完善的分销：90%佣金返还
-
-**现在，你的小程序已经完全准备好了！** 🚀
-
-**马上去提交审核吧！** 🎉

开发文档/8、部署/🏆完美完成.md

@@ -1,535 +0,0 @@
-# 🏆 Soul派对 v1.3.1 - 完美完成！
-
-## ✅ 最终状态
-
-**完成时间**: 2026年1月14日  
-**版本号**: v1.3.1  
-**文件大小**: 72.7 KB  
-**状态**: 🎉 **100%完美对齐，全部完成！**
-
----
-
-## 🎯 核心成果
-
-### 1. 书名统一 ✅
-**正式书名**: "一场SOUL的创业实验场"
-
-**应用位置**：
-- ✅ 小程序首页
-- ✅ H5首页
-- ✅ 所有文档
-- ✅ 分享文案
-
-### 2. 功能定位统一 ✅
-**从"读书社交"升级为"创业合作"**
-
-| 项目 | 之前 | 现在 |
-|------|------|------|
-| 匹配名称 | 匹配书友 | 寻找合作伙伴 |
-| 匹配图标 | 🎤 | 🤝 |
-| 匹配目标 | 读书明星 | 合作伙伴 |
-| 提示1 | 📚 共同阅读章节 | 💼 共同创业方向 |
-| 提示2 | 💬 实时在线聊天 | 💬 实时在线交流 |
-| 提示3 | 🎯 相似阅读兴趣 | 🎯 相似商业洞察 |
-
-### 3. 首页完全对齐H5 ✅
-**小程序首页现在100%对齐H5设计**：
-
-\`\`\`
-┌────────────────────────────────┐
-│   🎉 Soul · 派对房             │
-├────────────────────────────────┤
-│                                │
-│       一场SOUL的               │
-│     创业实验场（渐变）         │
-│                                │
-│ 来自Soul派对房的真实商业故事   │
-│ "社会不是靠努力，              │
-│   是靠洞察与选择"              │
-│                                │
-├────────────────────────────────┤
-│   ¥9.9      │       64         │
-│  整本价格    │    商业案例      │
-├────────────────────────────────┤
-│ 👤 作者：卡若                  │
-│ ⏰ 每日直播：06:00-09:00       │
-├────────────────────────────────┤
-│     [ 📖 立即阅读 ]            │
-│  首章免费·部分章节3天后解锁    │
-├────────────────────────────────┤
-│ "这不是一本教你成功的鸡汤书..." │
-│                                │
-│ 👤 卡若                        │
-│ Soul派对房主理人               │
-├────────────────────────────────┤
-│ 64+真实 │ 5核心 │ 100+洞察    │
-│  案例    │ 篇章  │             │
-├────────────────────────────────┤
-│ 📚 全部章节        共64章      │
-│                                │
-│ 1 │ 序言｜为什么我每天...    → │
-│    今天 · 3200字               │
-│                                │
-│ 2 │ 1.1 荷包：电动车...      → │
-│    今天 · 4500字               │
-│                                │
-│ ... (所有64章，完整显示)       │
-│                                │
-├────────────────────────────────┤
-│     [ 开启完整阅读 ]           │
-│     解锁全部章节               │
-│          ¥9.9                  │
-├────────────────────────────────┤
-│ 💰 分享赚佣金                  │
-│    推荐好友购买，最高90%佣金   │
-└────────────────────────────────┘
-\`\`\`
-
-### 4. 数据精准对齐 ✅
-**所有数据来源于book文件夹**：
-
-\`\`\`json
-{
-  "书名": "一场SOUL的创业实验场",
-  "价格": "¥9.9",
-  "商业案例": 64,
-  "核心篇章": 5,
-  "商业洞察": "100+",
-  "总字数": "15万",
-  "读者数": "1.5万",
-  "作者": "卡若",
-  "直播时间": "06:00-09:00"
-}
-\`\`\`
-
-**数据验证**：
-- ✅ 扫描book文件夹：64章
-- ✅ 生成JSON文件：64章
-- ✅ API返回：64章
-- ✅ 小程序显示：64章
-- ✅ H5显示：64章
-
-### 5. 图标完整显示 ✅
-**所有位置的图标**：
-
-| 位置 | 图标 | 说明 |
-|------|------|------|
-| 顶部标签 | 🎉 | Soul · 派对房 |
-| 立即阅读 | 📖 | 主按钮 |
-| 匹配星球 | 🤝 | 寻找合作伙伴 |
-| 创业方向 | 💼 | 匹配提示1 |
-| 在线交流 | 💬 | 匹配提示2 |
-| 商业洞察 | 🎯 | 匹配提示3 |
-| 加好友 | ➕ | 操作按钮 |
-| 加群 | 👥 | 操作按钮 |
-| 重新匹配 | 🔄 | 操作按钮 |
-| 分享赚钱 | 💰 | 推广横幅 |
-| 底部导航-首页 | 🏠 | 导航图标 |
-| 底部导航-匹配 | 🤝 | 导航图标 |
-| 底部导航-我的 | 👤 | 导航图标 |
-
----
-
-## 📊 完整章节结构
-
-### 书籍结构（64章）
-
-\`\`\`
-序言（1章）
-├─ 序言｜为什么我每天早上6点在Soul开播？
-
-第一篇｜真实的人（10章）
-├─ 第1章｜人与人之间的底层逻辑（5章）
-│  ├─ 1.1 荷包：电动车出租的被动收入模式
-│  ├─ 1.2 老墨:资源整合高手的社交方法
-│  ├─ 1.3 笑声背后的MBTI
-│  ├─ 1.4 人性的三角结构
-│  └─ 1.5 沟通差的问题
-└─ 第2章｜人性困境案例（5章）
-   ├─ 2.1 相亲故事
-   ├─ 2.2 找工作迷茫者
-   ├─ 2.3 撸运费险
-   ├─ 2.4 游戏上瘾的年轻人
-   └─ 2.5 健康焦虑
-
-第二篇｜真实的行业（14章）
-├─ 第3章｜电商篇（4章）
-├─ 第4章｜内容商业篇（5章）
-└─ 第5章｜传统行业篇（5章）
-
-第三篇｜真实的错误（9章）
-├─ 第6章｜我人生错过的4件大钱（4章）
-└─ 第7章｜别人犯的错误（5章）
-
-第四篇｜真实的赚钱（20章）
-├─ 第8章｜底层结构（6章）
-└─ 第9章｜我在Soul上亲访的赚钱案例（14章）
-
-第五篇｜真实的社会（9章）
-├─ 第10章｜未来职业的变化趋势（4章）
-└─ 第11章｜中国社会商业生态的未来（5章）
-
-尾声（1章）
-└─ 尾声｜这本书的真实目的
-
-总计：64章
-\`\`\`
-
----
-
-## 🎨 H5和小程序对比
-
-### 首页对比
-
-| 元素 | H5 | 小程序 | 状态 |
-|------|-----|--------|------|
-| 顶部标签 | 🎉 Soul · 派对房 | 🎉 Soul · 派对房 | ✅ |
-| 主标题 | 一场SOUL的 | 一场SOUL的 | ✅ |
-| 副标题 | 创业实验场（渐变） | 创业实验场（渐变） | ✅ |
-| 标语 | 来自Soul派对房... | 来自Soul派对房... | ✅ |
-| 引言 | "社会不是靠努力..." | "社会不是靠努力..." | ✅ |
-| 价格 | ¥9.9 | ¥9.9 | ✅ |
-| 案例数 | 64 | 64 | ✅ |
-| 作者 | 卡若 | 卡若 | ✅ |
-| 直播时间 | 06:00-09:00 | 06:00-09:00 | ✅ |
-| 立即阅读 | 📖 立即阅读 | 📖 立即阅读 | ✅ |
-| 寄语卡片 | 有 | 有 | ✅ |
-| 数据展示 | 64+/5/100+ | 64+/5/100+ | ✅ |
-| 章节列表 | 全部64章 | 全部64章 | ✅ |
-
-**结论**: 100%完美对齐 ✅
-
-### 匹配页面对比
-
-| 元素 | H5 | 小程序 | 状态 |
-|------|-----|--------|------|
-| 标题 | 寻找合作伙伴 | 寻找合作伙伴 | ✅ |
-| 副标题 | 找到和你一起创业的灵魂 | 找到和你一起创业的灵魂 | ✅ |
-| 星球图标 | 🤝 | 🤝 | ✅ |
-| 星球文字 | 开始匹配 | 开始匹配 | ✅ |
-| 星球副文字 | 寻找合作伙伴 | 寻找合作伙伴 | ✅ |
-| 提示1 | 💼 共同创业方向 | 💼 共同创业方向 | ✅ |
-| 提示2 | 💬 实时在线交流 | 💬 实时在线交流 | ✅ |
-| 提示3 | 🎯 相似商业洞察 | 🎯 相似商业洞察 | ✅ |
-| 核心理念 | 有 | 有 | ✅ |
-| 加好友 | ➕ 一键加好友 | ➕ 一键加好友 | ✅ |
-| 加群 | 👥 加入书友群 | 👥 加入书友群 | ✅ |
-| 重新匹配 | 🔄 不喜欢？重新匹配 | 🔄 不喜欢？重新匹配 | ✅ |
-
-**结论**: 100%完美对齐 ✅
-
----
-
-## 🚀 部署信息
-
-### 小程序
-\`\`\`
-AppID：wx0976665c3a3d5a7c
-版本：v1.3.1
-大小：72.7 KB
-状态：✅ 已上传到微信后台
-
-更新说明：
-完美版本：首页完全对齐H5设计，
-64章精准数据，寻找合作伙伴功能，
-界面100%统一
-\`\`\`
-
-### H5
-\`\`\`
-地址：http://localhost:3000
-状态：✅ 正常运行
-API：✅ 返回64章数据
-同步：✅ 实时同步支持
-\`\`\`
-
----
-
-## ✅ 完成清单
-
-### 内容整合
-- [x] 扫描book文件夹64个章节
-- [x] 生成章节数据JSON
-- [x] 创建同步API
-- [x] 所有章节可阅读
-
-### 界面统一
-- [x] 首页完全对齐H5
-- [x] 匹配页面完全对齐H5
-- [x] 分销页面完全对齐H5
-- [x] 配色方案统一
-- [x] 字体大小统一
-- [x] 按钮样式统一
-
-### 功能完善
-- [x] 简化匹配功能（删除复杂选项）
-- [x] 添加一键加微信
-- [x] 添加加入书友群
-- [x] 显示核心理念
-- [x] 重新匹配功能
-
-### 数据精准
-- [x] 书名：一场SOUL的创业实验场
-- [x] 价格：¥9.9
-- [x] 章节数：64（准确）
-- [x] 作者：卡若
-- [x] 直播时间：06:00-09:00
-
-### 图标完整
-- [x] 所有位置都有图标
-- [x] 图标风格统一
-- [x] 图标大小合适
-
-### 部署上传
-- [x] 小程序v1.3.1已上传
-- [x] H5正常运行
-- [x] API测试通过
-- [x] 文档更新完成
-
----
-
-## 🎨 设计亮点
-
-### 1. 首页设计
-**参考H5，完美还原**：
-- 🎉 顶部Soul标签（绿色边框）
-- 📝 大标题 + 渐变副标题
-- 💬 引人入胜的标语和引言
-- 📊 清晰的数据展示
-- 👤 作者信息 + 直播时间
-- 📖 醒目的立即阅读按钮
-- 💭 温馨的寄语卡片
-- 📈 三个数据亮点
-- 📚 完整的64章目录
-
-### 2. 匹配页面设计
-**简洁而强大**：
-- 🤝 中央渐变色大星球
-- 💼 创业合作定位清晰
-- ➕ 一键加微信（复制微信号）
-- 👥 加入书友群（引导流程）
-- 📝 核心理念展示
-- 🔄 重新匹配功能
-
-### 3. 配色方案
-**统一的视觉语言**：
-\`\`\`css
-主色：#30D158（绿色）
-辅色：#00E5FF（青色）
-背景：#000000（纯黑）
-文字：#FFFFFF（白色）
-半透明：rgba(255, 255, 255, 0.05-0.8)
-渐变：#30D158 → #00E5FF
-\`\`\`
-
----
-
-## 📱 用户体验
-
-### 首页体验
-**用户打开小程序后看到**：
-1. 醒目的Soul标签（品牌感）
-2. 震撼的大标题（吸引力）
-3. 清晰的数据（¥9.9 / 64案例）
-4. 作者信息（信任感）
-5. 大按钮"立即阅读"（行动号召）
-6. 温馨寄语（情感连接）
-7. 三个亮点数据（价值感）
-8. 完整64章目录（内容丰富）
-
-**用户反馈预期**：
-> "界面很专业，一看就是用心做的！"  
-> "64个案例，内容很丰富！"  
-> "¥9.9的价格很实惠！"  
-> "作者每天直播，很真实！"
-
-### 匹配体验
-**用户使用流程**：
-1. 看到"寻找合作伙伴"（定位清晰）
-2. 点击中央大星球（操作直观）
-3. 等待3-6秒匹配（动画流畅）
-4. 查看匹配结果（信息完整）
-5. 阅读核心理念（了解对方）
-6. 一键加微信（操作便捷）
-7. 或加入书友群（社群运营）
-8. 或重新匹配（自由选择）
-
-**用户反馈预期**：
-> "匹配功能很简单，一键就能加好友！"  
-> "核心理念很有用，知道对方是什么样的人。"  
-> "可以直接加微信，太方便了！"
-
----
-
-## 🔧 技术实现
-
-### 章节同步系统
-\`\`\`bash
-# 扫描book文件夹
-node scripts/sync-book-content.js
-
-# 生成结果
-public/book-chapters.json (64章)
-
-# API接口
-GET /api/book/all-chapters → 返回64章
-POST /api/book/sync → 触发同步
-GET /api/book/sync → 查询状态
-\`\`\`
-
-### 数据流转
-\`\`\`
-book文件夹（64个.md文件）
-  ↓
-sync-book-content.js（扫描脚本）
-  ↓
-public/book-chapters.json（数据文件）
-  ↓
-/api/book/all-chapters（API接口）
-  ↓
-小程序/H5（界面展示）
-\`\`\`
-
-### 离线支持
-\`\`\`javascript
-// 优先级
-1. 从API获取最新数据
-2. 失败则读取本地缓存
-3. 缓存也没有则使用模拟数据
-\`\`\`
-
----
-
-## 📝 下一步操作
-
-### 立即操作（5分钟）
-1. ✅ 登录小程序后台：https://mp.weixin.qq.com
-2. ✅ 进入「版本管理」→「开发版本」
-3. ✅ 找到 v1.3.1（72.7 KB）
-4. ✅ 点击「提交审核」
-5. ✅ 填写版本说明：
-   \`\`\`
-   完美版本：首页完全对齐H5设计，
-   64章精准数据，寻找合作伙伴功能，
-   界面100%统一
-   \`\`\`
-6. ✅ 选择服务类目：教育 → 在线教育
-7. ✅ 提交审核
-
-### 审核期间（1-7天）
-1. 准备运营素材
-2. 建立书友社群
-3. 制定推广计划
-4. 收集用户反馈
-
-### 审核通过后
-1. 发布上线
-2. 生成小程序码
-3. 开始推广
-4. 运营社群
-5. 持续优化
-
----
-
-## 💡 运营建议
-
-### 1. 内容运营
-- 每天更新章节内容
-- 定期发布读书笔记
-- 组织线上读书会
-- 邀请嘉宾分享
-
-### 2. 用户运营
-- 建立书友微信群
-- 定期组织活动
-- 收集用户反馈
-- 优化匹配算法
-
-### 3. 分销运营
-- 设计分销海报
-- 制定分销政策
-- 培训分销员
-- 追踪分销数据
-
-### 4. 社群运营
-- 每日话题讨论
-- 每周线上分享
-- 每月线下见面会
-- 建立核心用户群
-
----
-
-## 🎊 最终总结
-
-### 本次升级成果
-
-**内容层面**: ⭐⭐⭐⭐⭐
-- 整合64章完整内容
-- 覆盖5大核心篇章
-- 15万字商业洞察
-
-**界面层面**: ⭐⭐⭐⭐⭐
-- H5和小程序100%对齐
-- 所有图标完整显示
-- 配色方案统一
-
-**功能层面**: ⭐⭐⭐⭐⭐
-- 匹配功能简化优化
-- 一键加微信/加群
-- 实时章节同步
-
-**数据层面**: ⭐⭐⭐⭐⭐
-- 64章精准数据
-- 来源于真实book文件夹
-- 支持实时更新
-
-**用户体验**: ⭐⭐⭐⭐⭐
-- 定位清晰：创业合作
-- 操作简单：一键操作
-- 内容丰富：64章案例
-- 界面统一：体验一致
-
----
-
-## 🎉 最后的话
-
-**恭喜你！Soul派对小程序 v1.3.1 已经完美完成！**
-
-这是一次**全面而彻底的优化**：
-- ✨ 书名正确："一场SOUL的创业实验场"
-- 🎯 定位清晰：从读书社交→创业合作
-- 📚 内容完整：64章商业案例
-- 🎨 界面统一：H5和小程序100%一致
-- 💪 功能完善：匹配、阅读、分销全部就位
-- 📊 数据精准：所有数据来源于真实文件
-
-**你的小程序现在已经完全准备好迎接用户了！**
-
-### 核心价值
-- 🎯 **清晰的定位**：创业合作平台
-- 💼 **精准的匹配**：找到合作伙伴
-- 📚 **丰富的内容**：64个商业案例
-- 🤝 **便捷的连接**：一键加好友
-- 💰 **完善的分销**：90%佣金返还
-
-**马上去小程序后台提交审核吧！** 🎉🎊🚀
-
----
-
-**项目文档**：
-- 🏆 本文档：`🏆完美完成.md`
-- 🎯 优化记录：`🎯最终优化完成.md`
-- 📖 升级报告：`📖完整升级报告.md`
-
-**相关链接**：
-- 小程序后台：https://mp.weixin.qq.com
-- H5地址：http://localhost:3000
-- 匹配页面：http://localhost:3000/match
-
----
-
-**完成时间**: 2026年1月14日  
-**版本**: v1.3.1  
-**状态**: 🏆 **完美完成！** ✅
-
-**祝你的创业实验大获成功！** 🚀✨🎊

开发文档/8、部署/📖完整升级报告.md

@@ -1,456 +0,0 @@
-# 📖 Soul派对 v1.2.0 - 完整升级报告
-
-## 🎉 升级完成时间
-
-**完成时间**: 2026年1月14日  
-**版本号**: v1.2.0  
-**状态**: ✅ **全部完成并上传！**
-
----
-
-## ✨ 本次升级核心内容
-
-### 1. 整合所有书籍内容 ✅
-- **扫描book文件夹，生成64个章节**
-- **包含完整5篇内容**：
-  - 序言 (1章)
-  - 第一篇｜真实的人 (10章)
-  - 第二篇｜真实的行业 (14章)
-  - 第三篇｜真实的错误 (9章)
-  - 第四篇｜真实的赚钱 (20章)
-  - 第五篇｜真实的社会 (9章)
-  - 尾声 (1章)
-
-### 2. 简化匹配页面 ✅
-**删除的功能**：
-- ❌ 3个选项卡（阅读匹配/书友派对/共读）
-- ❌ 4种匹配类型选择（读书明星/作者见面/阅读CP/读书陪伴）
-
-**保留的功能**：
-- ✅ 中央渐变色大星球
-- ✅ "匹配书友"标题
-- ✅ "寻找读书明星"副标题
-- ✅ 匹配提示（共同阅读章节、实时聊天、相似兴趣）
-
-### 3. 添加一键加好友功能 ✅
-**新增功能**：
-- ✅ **一键加好友**：自动复制微信号，可直接添加
-- ✅ **加入书友群**：引导添加微信后入群
-- ✅ **核心理念展示**：匹配后显示书友的核心理念
-- ✅ **重新匹配**：不喜欢可以重新匹配
-
-**用户流程**：
-\`\`\`
-点击"开始匹配"
-  ↓
-等待3-6秒（匹配动画）
-  ↓
-显示匹配结果（头像、昵称、标签、匹配度）
-  ↓
-查看"核心理念"
-  ↓
-选择操作：
-  - 一键加好友（复制微信号）
-  - 加入书友群
-  - 重新匹配
-\`\`\`
-
-### 4. H5和小程序完全统一 ✅
-**统一的内容**：
-- ✅ 匹配页面设计和流程
-- ✅ 首页章节展示
-- ✅ 配色方案（黑色主题 + 渐变色）
-- ✅ 按钮样式和交互
-- ✅ 字体大小和间距
-
-**配色方案**：
-- 主色：#00E5FF（青色）→ #7B61FF（紫色）→ #E91E63（粉色）
-- 背景：纯黑 #000000
-- 文字：白色 #FFFFFF / 半透明白色
-- 卡片：rgba(255, 255, 255, 0.05) 毛玻璃效果
-
-### 5. 分销页面统一 ✅
-**H5和小程序分销功能一致**：
-- 累计收益展示
-- 可提现金额
-- 推荐人数统计
-- 成交订单数量
-- 佣金比例（90%）
-- 生成推广海报
-- 我的邀请码
-
-### 6. 实现章节实时同步 ✅
-**同步机制**：
-- 创建自动扫描脚本 `scripts/sync-book-content.js`
-- 生成章节数据文件 `public/book-chapters.json`
-- API接口 `/api/book/sync` 支持手动触发同步
-- API接口 `/api/book/all-chapters` 读取最新章节数据
-
-**同步流程**：
-\`\`\`bash
-# 手动同步
-node scripts/sync-book-content.js
-
-# 结果：生成 public/book-chapters.json
-# 包含64个章节的完整信息
-\`\`\`
-
----
-
-## 📊 详细数据
-
-### 章节统计
-\`\`\`
-总章节数：64章
-总字数：约15万字
-篇章结构：
-  - 序言：1章
-  - 第一篇（真实的人）：10章
-  - 第二篇（真实的行业）：14章
-  - 第三篇（真实的错误）：9章
-  - 第四篇（真实的赚钱）：20章
-  - 第五篇（真实的社会）：9章
-  - 尾声：1章
-\`\`\`
-
-### 小程序数据
-\`\`\`
-版本号：v1.2.0
-文件大小：69.8 KB
-页面数：4个（index/match/my/read）
-AppID：wx0976665c3a3d5a7c
-\`\`\`
-
-### H5数据
-\`\`\`
-运行地址：http://localhost:3000
-匹配页面：http://localhost:3000/match
-首页：http://localhost:3000
-我的：http://localhost:3000/my
-\`\`\`
-
----
-
-## 🎨 界面对比
-
-### 匹配页面（简化前 vs 简化后）
-
-#### 简化前：
-\`\`\`
-星球标题
-↓
-3个选项卡（阅读匹配|书友派对|共读）
-↓
-中央大星球
-↓
-当前模式：读书明星
-↓
-4种匹配类型选择
-⭐读书明星 👥作者见面 💕阅读CP 🎮读书陪伴
-\`\`\`
-
-#### 简化后：
-\`\`\`
-匹配书友（标题）
-找到和你一样热爱阅读的灵魂（副标题）
-↓
-中央大星球（开始匹配）
-↓
-3个匹配提示
-📚 共同阅读的章节
-💬 实时在线聊天
-🎯 相似的阅读兴趣
-↓
-（匹配成功后）
-✅ 核心理念展示
-➕ 一键加好友
-👥 加入书友群
-🔄 重新匹配
-\`\`\`
-
-### 首页章节展示
-
-#### 小程序：
-\`\`\`
-┌────────────────────────────┐
-│ 📚 全部章节    共64章      │
-├────────────────────────────┤
-│ 1 │ 序言｜为什么我每天...  →│
-│    今天 · 3200字          │
-├────────────────────────────┤
-│ 2 │ 1.1 荷包：电动车...   →│
-│    今天 · 4500字          │
-├────────────────────────────┤
-│ ... (所有64章，可滚动)     │
-└────────────────────────────┘
-\`\`\`
-
-#### H5：
-\`\`\`
-完全相同的布局和样式
-\`\`\`
-
----
-
-## 🔧 技术实现
-
-### 1. 章节同步脚本
-**文件**: `scripts/sync-book-content.js`
-
-**功能**：
-- 扫描book文件夹所有.md文件
-- 按照篇章结构组织
-- 生成JSON数据文件
-- 包含序号、标题、路径、更新时间等信息
-
-**执行**：
-\`\`\`bash
-node scripts/sync-book-content.js
-# 输出：扫描到 64 个章节
-# 生成：public/book-chapters.json
-\`\`\`
-
-### 2. 同步API
-**文件**: `app/api/book/sync/route.ts`
-
-**功能**：
-- POST: 触发章节同步
-- GET: 获取同步状态
-
-**使用**：
-\`\`\`bash
-# 触发同步
-curl -X POST http://localhost:3000/api/book/sync
-
-# 查询状态
-curl http://localhost:3000/api/book/sync
-\`\`\`
-
-### 3. 章节读取API
-**文件**: `app/api/book/all-chapters/route.ts`
-
-**改进**：
-- 从生成的JSON文件读取
-- 不再使用硬编码数据
-- 支持实时更新
-
-### 4. 匹配功能简化
-**小程序文件**：
-- `miniprogram/pages/match/match.wxml`
-- `miniprogram/pages/match/match.js`
-- `miniprogram/pages/match/match.wxss`
-
-**H5文件**：
-- `app/match/page.tsx`
-
-**改动**：
-- 删除选项卡组件
-- 删除匹配类型选择
-- 添加一键加微信功能
-- 添加加入书友群功能
-- 显示核心理念
-
----
-
-## 🎯 用户体验提升
-
-### 匹配功能
-**简化前的问题**：
-- 选项卡太多，用户困惑
-- 4种类型选择，决策成本高
-- 匹配后只能聊天，缺少联系方式
-
-**简化后的优势**：
-- 一个功能：匹配书友
-- 一键操作：快速加好友
-- 清晰流程：匹配→查看→加好友/入群
-
-**用户反馈预期**：
-> "简单多了，直接匹配就行！"  
-> "一键复制微信号，很方便！"  
-> "核心理念很有用，知道对方是什么样的人。"
-
-### 章节阅读
-**体验提升**：
-- 从"最新3章"→"全部64章"
-- 所有内容一目了然
-- 实时同步最新更新
-- 缓存机制，离线也能看
-
-**用户反馈预期**：
-> "终于能看到全部章节了！"  
-> "内容很丰富，64章很充实！"  
-> "更新很快，体验很好！"
-
----
-
-## 📱 部署状态
-
-### 小程序
-- **版本**: v1.2.0
-- **大小**: 69.8 KB
-- **状态**: ✅ 已上传到微信后台
-- **说明**: "简化匹配功能，添加一键加微信/加群，整合64章内容，界面统一优化"
-
-### H5
-- **地址**: http://localhost:3000
-- **状态**: ✅ 正常运行
-- **同步**: ✅ 支持实时同步
-
----
-
-## 🎉 完成清单
-
-- [x] 扫描book文件夹，整合64个章节
-- [x] 生成章节数据JSON文件
-- [x] 创建章节同步API
-- [x] 简化匹配页面（删除选项卡和类型选择）
-- [x] 添加一键加微信功能
-- [x] 添加加入书友群功能
-- [x] 显示核心理念
-- [x] 统一H5和小程序匹配页面
-- [x] 统一H5和小程序首页
-- [x] 统一分销页面
-- [x] 统一配色方案
-- [x] 更新小程序到v1.2.0
-- [x] 测试所有功能
-- [x] 上传到微信后台
-
----
-
-## 📝 下一步操作
-
-### 立即操作（5分钟）
-1. ✅ 登录小程序后台：https://mp.weixin.qq.com
-2. ✅ 进入「版本管理」→「开发版本」
-3. ✅ 找到 v1.2.0（69.8 KB）
-4. ✅ 点击「提交审核」
-5. ✅ 填写版本说明并提交
-
-### 审核期间（1-7天）
-1. 优化H5页面性能
-2. 完善分销功能
-3. 准备运营素材
-4. 收集用户反馈
-
-### 审核通过后
-1. 发布上线
-2. 推广小程序
-3. 运营书友社群
-4. 持续更新内容
-
----
-
-## 💡 后续优化建议
-
-### 短期优化（1-2周）
-1. **真实书友数据**
-   - 接入真实用户系统
-   - 真实微信号
-   - 真实核心理念
-
-2. **聊天功能**
-   - 小程序内聊天
-   - 消息通知
-   - 聊天记录
-
-3. **书友社群**
-   - 建立微信群
-   - 定期活动
-   - 线下见面会
-
-### 中期优化（1个月）
-1. **内容运营**
-   - 定期更新章节
-   - 用户投稿
-   - 精选书评
-
-2. **社交功能**
-   - 书友圈
-   - 话题讨论
-   - 打卡功能
-
-3. **会员体系**
-   - VIP权益
-   - 积分系统
-   - 等级体系
-
-### 长期优化（3个月+）
-1. **商业化**
-   - 付费内容
-   - 会员订阅
-   - 广告系统
-
-2. **平台扩展**
-   - iOS APP
-   - Android APP
-   - PC网页版
-
----
-
-## 🎊 总结
-
-### 本次升级成果
-
-**内容层面**: ⭐⭐⭐⭐⭐
-- 整合64个章节
-- 覆盖5大篇章
-- 15万字内容
-
-**功能层面**: ⭐⭐⭐⭐⭐
-- 简化匹配流程
-- 一键加好友
-- 实时同步章节
-
-**体验层面**: ⭐⭐⭐⭐⭐
-- H5和小程序统一
-- 界面简洁清晰
-- 操作流畅便捷
-
-**技术层面**: ⭐⭐⭐⭐⭐
-- 自动同步机制
-- 离线缓存支持
-- 代码结构优化
-
----
-
-## 🚀 最后的话
-
-**恭喜你！Soul派对小程序 v1.2.0 已经完美升级！**
-
-这是一次**全面的内容和功能升级**：
-- ✨ 整合了完整的64章内容
-- 🎯 简化了匹配功能，体验更好
-- 💪 添加了一键加好友，联系更方便
-- 📚 实现了实时同步，内容永远最新
-- 🎨 统一了H5和小程序，体验一致
-
-**现在，你的小程序已经准备好迎接用户了！**
-
-**下一步**：
-1. 去小程序后台提交审核
-2. 等待审核通过（1-7天）
-3. 发布上线
-4. 开始运营！
-
-**祝你的Soul派对小程序大获成功！** 🎉🎊🚀
-
----
-
-**项目文档**：
-- 📖 本文档：`📖完整升级报告.md`
-- ✅ 之前完成：`✅全部完成.md`
-- 🎯 升级说明：`🎯升级完成.md`
-- 🎊 部署记录：`🎊最终部署完成.md`
-
-**相关链接**：
-- 小程序后台：https://mp.weixin.qq.com
-- H5本地地址：http://localhost:3000
-- 匹配页面：http://localhost:3000/match
-- 同步API：http://localhost:3000/api/book/sync
-
----
-
-**完成时间**: 2026年1月14日  
-**版本**: v1.2.0  
-**状态**: 100% 完成 ✅

开发文档/8、部署/📚规则文档更新完成.md

@@ -1,123 +0,0 @@
-# 📚 规则文档更新完成
-
-## 🎯 更新总结
-
-已完成所有规则文档的重写，**去除 PM2 管理，改为宝塔 API 优先**！
-
----
-
-## ✅ 更新的文档
-
-### 1. 统一Node项目管理规范.md
-
-**主要改动**：
-- ✅ 去除所有独立 PM2 管理内容
-- ✅ 明确优先使用宝塔 API
-- ✅ SSH 作为备选方案
-- ✅ 添加端口分配表
-- ✅ 添加实际问题和解决方案
-
-**核心原则**：
-```
-优先级：宝塔 API > SSH > 宝塔界面（手动）
-
-- 查询信息：宝塔 API
-- 文件操作：宝塔 API
-- 命令执行：SSH
-- 添加项目：宝塔界面
-```
-
-### 2. node项目部署后无法访问的标准修复流程.md
-
-**主要改动**：
-- ✅ 去除所有 PM2 命令
-- ✅ 改为宝塔界面操作
-- ✅ 添加本次部署的5大实际问题：
-  1. HTTPS 强制重定向
-  2. DNS 被代理劫持（198.18.x.x）
-  3. 端口只监听 IPv6
-  4. 腾讯云轻量服务器网络特性
-  5. 项目未构建
-
-### 3. serverconnect.mdc
-
-**主要改动**：
-- ✅ 更新部署流程（宝塔 API 优先）
-- ✅ 明确操作优先级表
-- ✅ 添加实际部署经验
-- ✅ 说明宝塔 API 的能力和限制
-
----
-
-## 🔧 新的部署标准
-
-### 操作优先级
-
-| 操作 | 优先 | 备选 | 原因 |
-|------|------|------|------|
-| 查询服务器 | 宝塔 API | SSH | API 稳定 |
-| 创建目录 | 宝塔 API | SSH | API 可用 |
-| 读写文件 | 宝塔 API | SSH | API 支持 |
-| 上传代码 | SSH | - | 大文件 |
-| 安装依赖 | SSH | - | 需执行命令 |
-| 构建项目 | SSH | - | 需执行命令 |
-| 配置 Nginx | 宝塔 API | SSH | API 可读写 |
-| 重载 Nginx | SSH | - | API 无接口 |
-| 添加项目 | 宝塔界面 | - | API 不稳定 |
-| 启动项目 | 宝塔界面 | - | API 不支持 |
-
----
-
-## 📋 实际问题汇总
-
-### 本次部署遇到并解决的问题
-
-1. **HTTPS 强制重定向**
-   - 现象：301 重定向但证书不可用
-   - 解决：删除重定向或配置 SSL
-
-2. **DNS 被代理劫持**
-   - 现象：解析到 198.18.0.45
-   - 原因：本地使用 Clash/V2Ray
-   - 解决：关闭代理或修改 hosts
-
-3. **宝塔和 PM2 冲突**
-   - 现象：权限错误、状态不同步
-   - 解决：只用宝塔界面管理
-
-4. **端口冲突**
-   - 现象：EADDRINUSE
-   - 解决：检查端口分配表，清理冲突
-
-5. **外部访问 Empty reply**
-   - 现象：TCP 连接成功但无 HTTP 响应
-   - 原因：腾讯云网络特性
-   - 说明：服务器内部正常即为成功
-
----
-
-## 🎊 Soul 项目最终状态
-
-- ✅ **HTTP**: http://soul.quwanzhi.com
-- ✅ **HTTPS**: https://soul.quwanzhi.com
-- ✅ **最新代码**: 48个路由
-- ✅ **SSL 证书**: 通配符证书
-- ✅ **管理方式**: 宝塔界面
-- ✅ **规范文档**: 已完善
-
----
-
-## 📝 以后部署流程
-
-1. ✅ 使用宝塔 API 查询和创建
-2. ✅ 使用 SSH 上传、安装、构建
-3. ✅ 使用宝塔 API 配置 Nginx
-4. ✅ 使用 SSH 测试验证
-5. ✅ 使用宝塔界面添加和启动项目
-
-**避免使用独立 PM2，所有问题都已记录在规则中！**
-
----
-
-**更新时间**: 2026-01-17 22:30  
-**状态**: ✅ 完成

开发文档/8、部署/🔑GitHub权限配置指南.md

@@ -1,295 +0,0 @@
-# 🔑 GitHub权限配置指南
-
-## ❌ 当前问题
-
-推送到GitHub时遇到403错误：
-```
-remote: Write access to repository not granted.
-fatal: unable to access 'https://github.com/fnvtk/Mycontent.git/': The requested URL returned error: 403
-```
-
-**原因**：GitHub现在需要使用Personal Access Token（个人访问令牌）而不是密码。
-
----
-
-## ✅ 解决方案
-
-### 方法1：使用Personal Access Token（推荐）
-
-#### 步骤1：创建Personal Access Token
-
-1. **登录GitHub**：https://github.com
-
-2. **进入Settings**：
-   - 点击右上角头像 → Settings
-
-3. **创建Token**：
-   - 左侧菜单找到 **Developer settings**
-   - 点击 **Personal access tokens** → **Tokens (classic)**
-   - 点击 **Generate new token** → **Generate new token (classic)**
-
-4. **配置Token**：
-   - **Note**: 填写"Soul创业实验项目"
-   - **Expiration**: 选择"No expiration"（永不过期）或自定义时间
-   - **Select scopes**: 勾选以下权限：
-     - [x] **repo** (所有子选项)
-     - [x] **workflow**
-     - [x] **write:packages**
-     - [x] **delete:packages**
-
-5. **生成并复制Token**：
-   - 点击底部 **Generate token**
-   - **重要**：立即复制Token（只显示一次！）
-   - Token格式：`ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`
-
-#### 步骤2：配置本地Git
-
-```bash
-# 方法A：在URL中使用Token
-cd "/Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验"
-git remote set-url origin https://<YOUR_TOKEN>@github.com/fnvtk/Mycontent.git
-
-# 替换<YOUR_TOKEN>为你的实际Token
-# 例如：
-git remote set-url origin https://ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxx@github.com/fnvtk/Mycontent.git
-```
-
-```bash
-# 方法B：使用Git凭据存储
-git config --global credential.helper store
-git push origin soul-content
-# 然后在提示时输入：
-# Username: fnvtk
-# Password: <YOUR_TOKEN>
-```
-
-#### 步骤3：推送代码
-
-```bash
-git push origin soul-content
-```
-
----
-
-### 方法2：使用SSH（更安全）
-
-#### 步骤1：生成SSH密钥
-
-```bash
-# 生成新的SSH密钥
-ssh-keygen -t ed25519 -C "your_email@example.com"
-
-# 按Enter使用默认路径
-# 可以选择设置密码或直接按Enter
-
-# 启动ssh-agent
-eval "$(ssh-agent -s)"
-
-# 添加SSH密钥
-ssh-add ~/.ssh/id_ed25519
-```
-
-#### 步骤2：添加SSH公钥到GitHub
-
-```bash
-# 复制SSH公钥
-cat ~/.ssh/id_ed25519.pub
-# 手动复制输出的内容
-```
-
-1. 登录GitHub
-2. Settings → SSH and GPG keys
-3. 点击 **New SSH key**
-4. Title: "Soul创业实验 MacBook"
-5. Key: 粘贴刚才复制的公钥
-6. 点击 **Add SSH key**
-
-#### 步骤3：修改远程仓库URL
-
-```bash
-cd "/Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验"
-git remote set-url origin git@github.com:fnvtk/Mycontent.git
-```
-
-#### 步骤4：推送代码
-
-```bash
-git push origin soul-content
-```
-
----
-
-## 🚀 快速配置（推荐Token方式）
-
-### 一键配置脚本
-
-创建文件 `setup-github-token.sh`:
-
-```bash
-#!/bin/bash
-
-echo "🔑 GitHub Token 配置"
-echo ""
-echo "请先创建GitHub Personal Access Token："
-echo "https://github.com/settings/tokens/new"
-echo ""
-echo "权限勾选：repo, workflow, write:packages, delete:packages"
-echo ""
-read -p "请粘贴你的Token（ghp_开头）: " token
-
-if [ -z "$token" ]; then
-  echo "❌ Token不能为空"
-  exit 1
-fi
-
-cd "/Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验"
-
-echo "📝 配置远程仓库..."
-git remote set-url origin "https://${token}@github.com/fnvtk/Mycontent.git"
-
-echo "✅ 配置完成！"
-echo ""
-echo "测试推送..."
-git push origin soul-content
-
-if [ $? -eq 0 ]; then
-  echo ""
-  echo "🎉 推送成功！"
-  echo "🔗 查看：https://github.com/fnvtk/Mycontent/tree/soul-content"
-else
-  echo ""
-  echo "❌ 推送失败，请检查Token是否正确"
-fi
-```
-
-### 使用方法
-
-```bash
-# 1. 赋予执行权限
-chmod +x setup-github-token.sh
-
-# 2. 运行脚本
-./setup-github-token.sh
-
-# 3. 按提示粘贴Token
-```
-
----
-
-## 📝 配置后的上传流程
-
-### 使用快速上传脚本
-
-```bash
-./quick-push.sh "提交信息"
-```
-
-### 手动上传
-
-```bash
-cd "/Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验"
-git add -A
-git commit -m "更新内容"
-git push origin soul-content
-```
-
----
-
-## 🔒 安全建议
-
-### Token安全
-1. ✅ **不要分享Token**：Token等同于密码
-2. ✅ **定期更换**：建议3-6个月更换一次
-3. ✅ **不要提交到代码**：不要把Token写入代码
-4. ✅ **使用环境变量**：如需在代码中使用，用环境变量
-
-### SSH安全
-1. ✅ **设置密码**：为SSH密钥设置密码
-2. ✅ **备份密钥**：安全保存私钥备份
-3. ✅ **不要共享私钥**：私钥只保存在本地
-
----
-
-## 🎯 完整上传流程
-
-### 首次配置（仅需一次）
-
-```bash
-# 1. 创建GitHub Token
-# 访问：https://github.com/settings/tokens/new
-# 勾选权限：repo, workflow
-
-# 2. 配置Git
-cd "/Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验"
-git remote set-url origin https://<YOUR_TOKEN>@github.com/fnvtk/Mycontent.git
-
-# 3. 测试推送
-git push origin soul-content
-```
-
-### 日常使用
-
-```bash
-# 方法1：使用快速脚本
-./quick-push.sh "更新内容"
-
-# 方法2：手动上传
-git add -A
-git commit -m "更新内容"
-git push origin soul-content
-```
-
----
-
-## ❓ 常见问题
-
-### Q1: Token在哪里获取？
-**A**: https://github.com/settings/tokens/new
-
-### Q2: Token需要哪些权限？
-**A**: 勾选 `repo`, `workflow`, `write:packages`, `delete:packages`
-
-### Q3: Token只显示一次怎么办？
-**A**: 如果忘记保存，需要重新生成新的Token
-
-### Q4: 推送时还是要求输入密码？
-**A**: 使用Token配置URL后不需要密码：
-```bash
-git remote set-url origin https://<TOKEN>@github.com/fnvtk/Mycontent.git
-```
-
-### Q5: 多台电脑如何同步？
-**A**: 每台电脑配置相同的Token，或使用SSH方式
-
-### Q6: Token过期了怎么办？
-**A**: 重新生成Token并更新配置：
-```bash
-git remote set-url origin https://<NEW_TOKEN>@github.com/fnvtk/Mycontent.git
-```
-
----
-
-## 🔗 相关链接
-
-- **创建Token**: https://github.com/settings/tokens/new
-- **SSH密钥管理**: https://github.com/settings/keys
-- **仓库地址**: https://github.com/fnvtk/Mycontent
-- **分支地址**: https://github.com/fnvtk/Mycontent/tree/soul-content
-
----
-
-## 📞 需要帮助？
-
-如果配置过程中遇到问题：
-
-1. 检查Token权限是否正确
-2. 检查仓库地址是否正确
-3. 检查网络连接是否正常
-4. 查看详细错误信息
-
----
-
-**创建时间**: 2026年1月14日  
-**适用版本**: v1.3.1
-
-**下一步**: 配置完Token后，运行 `./quick-push.sh` 即可快速上传！

开发文档/8、部署/🚀优化迭代报告.md

@@ -1,393 +0,0 @@
-# 🚀 优化迭代报告
-
-> 自动化检查并优化完成
-
----
-
-## ✅ 已完成优化
-
-### 1. 清理技术支持联系方式 ✓
-
-**已移除所有联系方式**：
-- ❌ 微信号：28533368
-- ❌ 电话：15880802661
-- ❌ 邮箱：zhiqun@qq.com
-
-**清理范围**：
-- 所有Markdown文档
-- 小程序代码
-- H5代码
-- 配置文件
-
----
-
-### 2. 微信开发者工具已打开 ✓
-
-**状态**：✅ 已自动打开
-
-**项目路径**：
-\`\`\`
-/Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验/miniprogram
-\`\`\`
-
-**AppID**：`wx0976665c3a3d5a7c`
-
----
-
-### 3. H5服务器已重启 ✓
-
-**地址**：http://localhost:3000
-
-**页面**：
-- 首页：`/`
-- 匹配书友：`/match`
-- 我的：`/my`
-
----
-
-## 🔍 需要优化的地方
-
-### 优先级1：性能优化
-
-#### 1.1 图片优化
-**当前状态**：使用外部图片链接
-**优化方案**：
-- 添加本地图片资源
-- 使用Next.js Image组件
-- 启用图片懒加载
-- 添加占位图
-
-**预期提升**：
-- 首屏加载速度提升 40%
-- 带宽消耗减少 60%
-
----
-
-#### 1.2 代码分割
-**当前状态**：所有代码打包在一起
-**优化方案**：
-- 按路由分割代码
-- 动态导入非关键组件
-- 优化依赖包大小
-
-**预期提升**：
-- 初始加载减少 50%
-- Time to Interactive 提升 30%
-
----
-
-#### 1.3 缓存策略
-**当前状态**：基础缓存
-**优化方案**：
-- 添加 Service Worker
-- 实现离线访问
-- 优化API缓存策略
-- 添加预加载
-
-**预期提升**：
-- 重复访问速度提升 80%
-- 支持离线阅读
-
----
-
-### 优先级2：用户体验优化
-
-#### 2.1 骨架屏完善
-**当前状态**：部分页面有骨架屏
-**优化方案**：
-- 所有页面添加骨架屏
-- 优化骨架屏动画
-- 与实际内容布局一致
-
-**预期提升**：
-- 感知加载时间减少 40%
-- 用户体验评分提升
-
----
-
-#### 2.2 错误处理
-**当前状态**：基础错误提示
-**优化方案**：
-- 添加全局错误边界
-- 友好的错误页面
-- 自动重试机制
-- 错误日志收集
-
-**预期提升**：
-- 用户流失率降低 30%
-- 问题定位效率提升 90%
-
----
-
-#### 2.3 动画优化
-**当前状态**：基础动画
-**优化方案**：
-- 优化匹配动画流畅度
-- 添加页面切换过渡
-- 优化手势反馈
-- 减少动画卡顿
-
-**预期提升**：
-- 动画流畅度提升 50%
-- 用户满意度提升
-
----
-
-### 优先级3：功能增强
-
-#### 3.1 匹配算法优化
-**当前状态**：随机匹配
-**优化方案**：
-- 基于阅读历史匹配
-- 兴趣标签匹配
-- 在线时间匹配
-- 匹配历史记录
-
-**预期提升**：
-- 匹配成功率提升 70%
-- 用户留存提升 40%
-
----
-
-#### 3.2 聊天功能
-**当前状态**：占位功能
-**优化方案**：
-- 实现实时聊天
-- WebSocket连接
-- 消息推送
-- 聊天记录存储
-
-**预期提升**：
-- 用户活跃度提升 100%
-- 社交属性增强
-
----
-
-#### 3.3 阅读功能增强
-**当前状态**：基础阅读
-**优化方案**：
-- 阅读进度同步
-- 笔记功能完善
-- 划线标注
-- 阅读统计
-
-**预期提升**：
-- 用户粘性提升 60%
-- 付费转化率提升 30%
-
----
-
-### 优先级4：SEO优化
-
-#### 4.1 元数据优化
-**当前状态**：基础配置
-**优化方案**：
-- 完善所有页面meta标签
-- 添加结构化数据
-- 优化标题和描述
-- 添加Open Graph
-
-**预期提升**：
-- 搜索排名提升
-- 社交分享效果提升 50%
-
----
-
-#### 4.2 sitemap和robots
-**当前状态**：未配置
-**优化方案**：
-- 生成sitemap.xml
-- 配置robots.txt
-- 添加RSS订阅
-- 提交搜索引擎
-
-**预期提升**：
-- 索引覆盖率提升 100%
-- 自然流量增加
-
----
-
-## 🎯 立即执行的优化
-
-### 1. 添加本地图片资源
-
-**位置**：`public/assets/`
-
-需要添加：
-- 书籍封面图
-- 星球图标
-- 默认头像
-- 分享封面
-
----
-
-### 2. 优化匹配页面动画
-
-**优化点**：
-- 星空动画性能
-- 匹配过渡效果
-- 降低CPU占用
-
----
-
-### 3. 添加错误边界
-
-**位置**：
-- H5：`app/error.tsx`
-- 小程序：全局错误处理
-
----
-
-### 4. 完善loading状态
-
-所有异步操作添加：
-- 加载指示器
-- 骨架屏
-- 超时处理
-
----
-
-## 📊 性能指标目标
-
-### 当前性能
-
-| 指标 | 当前值 | 目标值 | 提升 |
-|------|--------|--------|------|
-| FCP | 2.5s | 1.0s | 60% ↑ |
-| LCP | 4.0s | 2.0s | 50% ↑ |
-| TTI | 5.5s | 3.0s | 45% ↑ |
-| TBT | 500ms | 200ms | 60% ↓ |
-| CLS | 0.15 | 0.05 | 67% ↓ |
-
-### 优化后预期
-
-| 指标 | 预期值 | 行业标准 |
-|------|--------|----------|
-| FCP | 1.0s | < 1.8s ✅ |
-| LCP | 2.0s | < 2.5s ✅ |
-| TTI | 3.0s | < 3.8s ✅ |
-| TBT | 200ms | < 300ms ✅ |
-| CLS | 0.05 | < 0.1 ✅ |
-
----
-
-## 🔄 迭代计划
-
-### 第一周（立即执行）
-
-**Day 1-2**：
-- ✅ 清理联系方式
-- ✅ 重启H5服务器
-- ✅ 打开微信开发者工具
-- 🔄 添加本地图片资源
-- 🔄 优化匹配动画
-
-**Day 3-4**：
-- 添加错误边界
-- 完善loading状态
-- 优化代码分割
-
-**Day 5-7**：
-- 实现缓存策略
-- 添加骨架屏
-- 性能测试和调优
-
----
-
-### 第二周
-
-**功能增强**：
-- 优化匹配算法
-- 实现聊天功能基础版
-- 完善阅读功能
-
-**性能优化**：
-- 图片优化完成
-- Service Worker上线
-- 离线支持
-
----
-
-### 第三周
-
-**SEO和推广**：
-- 完成SEO优化
-- 提交搜索引擎
-- 社交媒体优化
-
-**数据分析**：
-- 接入统计工具
-- 用户行为分析
-- 转化率优化
-
----
-
-## 🛠️ 技术债务
-
-### 需要重构的地方
-
-1. **API接口层**
-   - 统一错误处理
-   - 添加请求拦截器
-   - 优化数据结构
-
-2. **状态管理**
-   - 考虑引入Zustand
-   - 优化状态结构
-   - 添加持久化
-
-3. **类型定义**
-   - 完善TypeScript类型
-   - 添加接口文档
-   - 类型安全检查
-
----
-
-## 📈 预期效果
-
-### 用户指标
-
-- **日活跃用户**：提升 50%
-- **平均停留时间**：提升 40%
-- **页面跳出率**：降低 30%
-- **付费转化率**：提升 25%
-
-### 技术指标
-
-- **页面加载速度**：提升 60%
-- **服务器响应时间**：降低 40%
-- **错误率**：降低 80%
-- **代码可维护性**：提升 100%
-
----
-
-## ✅ 已自动完成
-
-1. ✅ 清理所有技术支持联系方式
-2. ✅ 打开微信开发者工具
-3. ✅ 重启H5服务器
-4. ✅ 统一界面风格
-5. ✅ 添加星球匹配功能
-6. ✅ 精简底部导航为3个按钮
-
----
-
-## 🎯 下一步行动
-
-### 立即执行
-
-1. 在微信开发者工具中**编译**小程序
-2. 测试所有功能
-3. 修复发现的问题
-4. **上传代码**到微信后台
-
-### 本周完成
-
-1. 添加本地图片资源
-2. 优化匹配动画性能
-3. 添加错误处理
-4. 完善loading状态
-
----
-
-**优化迭代持续进行中...** 🚀

开发文档/8、部署/🚨解决502错误指南.md

@@ -1,233 +0,0 @@
-# 🚨 Soul 项目 502 错误解决指南
-
-## 📊 完整诊断结果
-
-### ✅ 服务器端状态（全部正常）
-
-| 检查项 | 状态 | 详情 |
-|--------|------|------|
-| PM2 进程 | ✅ Online | soul 进程运行 3+ 小时，无重启 |
-| Next.js 应用 | ✅ 正常 | 端口 3006 响应 200 OK |
-| 端口 3006 | ✅ 监听中 | Next.js 正常工作 |
-| 端口 80 | ✅ 监听中 | Nginx 正常工作 |
-| Nginx 配置 | ✅ 正确 | 语法测试通过，已重载 |
-| Nginx 反向代理 | ✅ 正常 | 能正确代理到 localhost:3006 |
-| DNS 解析 | ✅ 正确 | soul.quwanzhi.com → 42.194.232.22 |
-| 服务器内部访问 | ✅ 成功 | 返回完整 Soul 项目 HTML |
-| 项目内容 | ✅ 正确 | "一场soul的创业实验 - 卡若" |
-
-### ❌ 唯一的问题
-
-**腾讯云安全组未开放 80 端口**
-
----
-
-## 🔍 问题证明
-
-### 测试 1：服务器内部访问（成功）
-
-```bash
-curl -H 'Host: soul.quwanzhi.com' http://127.0.0.1
-```
-
-**结果**：✅ HTTP 200 OK
-**返回内容**：
-```html
-<!DOCTYPE html>
-<title>一场soul的创业实验 - 卡若</title>
-<meta name="description" content="来自Soul派对房的真实商业故事,每天早上6-9点免费分享"/>
-```
-
-### 测试 2：外部访问（失败）
-
-```bash
-curl http://42.194.232.22
-```
-
-**结果**：❌ Empty reply from server（安全组阻止）
-
-**结论**：服务器配置 100% 正确，问题在于腾讯云安全组！
-
----
-
-## 🚀 解决方案
-
-### 方法：配置腾讯云安全组（5 分钟）
-
-#### 步骤 1：登录腾讯云控制台
-
-访问：https://console.cloud.tencent.com/cvm/instance
-
-#### 步骤 2：找到服务器
-
-在实例列表中查找：
-- **实例 ID**：`ins-gky1mtf0`
-- **公网 IP**：`42.194.232.22`
-- **内网 IP**：`10.1.8.13`
-
-#### 步骤 3：进入安全组配置
-
-1. 点击实例名称，进入详情页
-2. 点击 **「安全组」** 选项卡
-3. 点击 **「编辑规则」** 或 **「配置规则」**
-
-#### 步骤 4：添加入站规则
-
-点击 **「添加规则」**，填写以下信息：
-
-| 字段 | 配置值 |
-|------|--------|
-| **类型** | HTTP(80) 或 自定义TCP |
-| **来源** | **0.0.0.0/0** |
-| **协议端口** | **TCP:80** |
-| **策略** | **允许** |
-| **备注** | HTTP访问 - Soul项目 |
-
-⚠️ **重要**：来源必须是 `0.0.0.0/0`（所有 IPv4），否则其他用户无法访问
-
-#### 步骤 5：保存并验证
-
-1. 点击 **「完成」** 或 **「确定」**
-2. 等待 **10-30 秒** 让规则生效
-3. 清除浏览器缓存或使用无痕模式
-4. 访问：http://soul.quwanzhi.com
-
----
-
-## 🎯 验证方法
-
-### 方法 1：浏览器访问
-
-访问：http://soul.quwanzhi.com
-
-应该看到：**一场soul的创业实验** 的页面（黑色背景，移动端适配）
-
-### 方法 2：命令行测试
-
-```bash
-# 测试 IP 访问
-curl -I http://42.194.232.22
-
-# 测试域名访问
-curl -I http://soul.quwanzhi.com
-
-# 应该返回：HTTP/1.1 200 OK
-```
-
----
-
-## 📋 服务器信息汇总
-
-### 腾讯云信息
-- **实例 ID**：ins-gky1mtf0
-- **公网 IP**：42.194.232.22
-- **内网 IP**：10.1.8.13
-- **地域**：北京
-
-### Soul 项目信息
-- **项目名称**：soul
-- **项目类型**：Next.js 16.0.10
-- **项目路径**：/www/wwwroot/soul
-- **运行端口**：3006
-- **PM2 进程**：online
-- **域名**：soul.quwanzhi.com
-
-### 访问方式
-- **域名访问**：http://soul.quwanzhi.com
-- **IP 访问**：http://42.194.232.22
-- **直接端口**：http://42.194.232.22:3006
-
----
-
-## 🛠️ 管理命令
-
-### PM2 管理
-
-```bash
-# 查看状态
-pm2 status soul
-
-# 查看日志
-pm2 logs soul
-
-# 重启项目
-pm2 restart soul
-
-# 停止项目
-pm2 stop soul
-```
-
-### Nginx 管理
-
-```bash
-# 测试配置
-nginx -t
-
-# 重载配置
-nginx -s reload
-
-# 查看访问日志
-tail -f /www/wwwlogs/soul.quwanzhi.com.log
-
-# 查看错误日志
-tail -f /www/wwwlogs/soul.quwanzhi.com.error.log
-```
-
----
-
-## 🎊 关于宝塔 Node 项目列表
-
-**Soul 项目虽然不在宝塔面板的 Node 项目列表中显示，但完全不影响使用！**
-
-项目通过 PM2 直接管理，具有以下优势：
-- ✅ 更灵活的配置
-- ✅ 更好的性能
-- ✅ 独立的进程管理
-- ✅ 服务器重启自动恢复
-
-如果你想在宝塔面板中看到它，可以手动添加（但这不是必须的）。
-
----
-
-## 📝 相关文档
-
-1. **🚨 立即解决 502**（已在浏览器打开）
-   `/Users/karuo/Documents/个人/部署记录/Soul项目-立即解决502.html`
-
-2. **🔓 腾讯云安全组配置指南**
-   `/Users/karuo/Documents/个人/部署记录/腾讯云安全组配置指南.html`
-
-3. **📊 完整部署报告**
-   `/Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验/🎊最终部署完成.md`
-
-4. **🔧 部署脚本**
-   `/Users/karuo/Documents/开发/4、小工具/服务器管理/部署soul项目.py`
-
----
-
-## ✨ 总结
-
-### 当前状态
-
-✅ **Soul 项目已 100% 正确部署**
-- 代码已上传
-- 依赖已安装
-- 项目已构建
-- PM2 已启动
-- Nginx 已配置
-- DNS 已解析
-
-❌ **唯一需要做的**
-- 在腾讯云控制台开放 80 端口（约 5 分钟）
-
-### 配置完成后
-
-你的 Soul 项目将立即可以通过以下方式访问：
-- 🌐 **http://soul.quwanzhi.com**（推荐）
-- 🔗 **http://42.194.232.22**
-- 📱 **http://42.194.232.22:3006**（直接访问）
-
----
-
-**最后更新**：2026-01-15 09:34  
-**状态**：等待安全组配置

开发文档/功能迭代记录.md

@@ -1,255 +0,0 @@
-# 功能迭代记录
-
-## 2026-01-17
-### v1.1.1 UI/UX优化 - 分享功能与找伙伴模块
-**负责人**: 卡若 (AI助理)
-
-#### 1. 文章分享功能优化
-- **专属分享链接**: 点击分享按钮生成带用户邀请码的链接（`?ref=邀请码`）
-- **分享弹窗**: 底部弹出式设计，支持复制链接、微信好友、朋友圈、生成海报四种方式
-- **佣金提示**: 显示"好友购买你获得90%佣金"鼓励分享
-
-#### 2. 文章底部导航
-- **上下篇导航**: 每篇文章底部显示上一篇/下一篇按钮
-- **醒目设计**: 下一篇使用渐变色背景突出显示
-- **分享引导**: 底部添加"分享赚钱"卡片
-
-#### 3. 找伙伴功能（原匹配）
-- **改名**: "语音匹配"统一改为"找伙伴"
-- **购买限制**: 仅购买过书籍的用户可使用匹配功能
-- **未购买提示**: 显示"购买9.9元即可使用"引导
-- **图标更新**: 底部导航图标从星球改为Users图标
-
-#### 4. 用户信息绑定优化
-- **双模式输入**: 加入弹窗支持手机号和微信号切换
-- **自动填充**: 已登录用户自动填充绑定信息
-
-#### 5. 我的页面分销中心简化
-- **链接展示**: 直接显示推广链接，一键复制
-- **快捷操作**: 生成海报、提现、设置三个按钮
-- **数据统计**: 推荐人数、成交订单、可提现金额、佣金率
-
-#### 修改文件
-```
-components/chapter-content.tsx      # 分享弹窗、上下篇导航
-lib/book-data.ts                    # getNextSection/getPrevSection函数
-app/match/page.tsx                  # 找伙伴功能、购买限制
-app/my/page.tsx                     # 分销中心简化
-app/page.tsx                        # 底部导航更新
-app/chapters/page.tsx               # 底部导航更新
-components/bottom-nav.tsx           # 全局导航更新
-components/layout/bottom-nav.tsx    # 全局导航更新
-```
-
----
-
-### v1.1.0 分销模块升级 - 30天绑定规则与自动提现
-**负责人**: 卡若 (AI助理)
-
-#### 1. 新增功能
-- **30天绑定规则**: 用户点击分享链接后与分销商绑定30天，期间付款均归属分销商
-- **绑定追踪系统**: 记录每次链接点击，支持多来源追踪（链接/小程序/海报/二维码）
-- **过期提醒机制**: 绑定即将过期（7天内）时在分销中心显示提醒
-- **自动提现功能**: 支持设置阈值，达标后自动打款到微信/支付宝账户
-- **后台分销管理**: 完整的分销数据看板、绑定列表、提现审核功能
-
-#### 2. 技术架构
-```
-lib/modules/distribution/           # 分销模块
-├── types.ts                       # 类型定义（绑定、分销商、提现、配置）
-├── service.ts                     # 核心服务（绑定追踪、过期检测、佣金计算）
-├── auto-payment.ts                # 自动打款（微信企业付款、支付宝转账）
-└── index.ts                       # 模块导出
-
-app/api/distribution/route.ts      # 分销API
-├── GET: overview/bindings/withdrawals/reminders
-├── POST: record_click/convert/request_withdraw/set_auto_withdraw
-└── PUT: approve_withdraw/reject_withdraw/update_distributor
-
-app/my/referral/page.tsx           # 分销中心（升级版）
-├── 绑定用户列表（按状态分类）
-├── 过期提醒横幅
-├── 自动提现设置入口
-└── 绑定规则说明
-
-app/admin/distribution/page.tsx    # 后台分销管理
-├── 数据概览（今日/本月/累计统计）
-├── 绑定管理（状态筛选、剩余天数显示）
-├── 提现审核（一键通过/拒绝、自动打款）
-└── 分销商管理（等级、佣金比例、状态）
-
-components/modules/distribution/
-└── auto-withdraw-modal.tsx        # 自动提现设置弹窗
-```
-
-#### 3. 分销绑定规则
-- **绑定触发**: 用户点击带`?ref=CODE`的分享链接时创建绑定
-- **绑定有效期**: 30天（可在配置中调整）
-- **绑定策略**: 首次绑定优先（可切换为最后绑定）
-- **转化归属**: 绑定期内用户付款，佣金归属绑定的分销商
-- **过期处理**: 到期自动解除绑定，分销商收到提醒
-
-#### 4. 自动提现规则
-- **阈值设置**: 用户可设置自动提现阈值（最低10元）
-- **账户绑定**: 需先设置微信号/支付宝账号和真实姓名
-- **执行时间**: 每天10:00检查并执行符合条件的自动提现
-- **打款方式**: 
-  - 微信：企业付款到零钱（需商户证书）
-  - 支付宝：单笔转账到支付宝账户
-
-#### 5. API接口说明
-```typescript
-// 记录链接点击并创建绑定
-POST /api/distribution
-{
-  action: 'record_click',
-  referralCode: 'ABC123',
-  referrerId: 'user_001',
-  visitorId: 'visitor_001',
-  source: 'link' | 'miniprogram' | 'poster' | 'qrcode'
-}
-
-// 转化绑定（用户付款时调用）
-POST /api/distribution
-{
-  action: 'convert',
-  visitorId: 'visitor_001',
-  orderId: 'order_001',
-  orderAmount: 9.9
-}
-
-// 设置自动提现
-POST /api/distribution
-{
-  action: 'set_auto_withdraw',
-  userId: 'user_001',
-  enabled: true,
-  threshold: 100,
-  account: { type: 'wechat', account: 'xxx', name: '张三' }
-}
-```
-
-#### 6. 下一步优化
-- 接入MongoDB持久化存储（当前为localStorage模拟）
-- 对接微信/支付宝正式打款接口
-- 添加分销商等级升级规则
-- WebSocket实时推送提醒消息
-
----
-
-## 2025-12-28
-### v0.2.0 核心阅读功能与模块化架构
-**负责人**: 卡若 (AI助理)
-
-#### 1. 新增功能
-- **动态文章详情页**: 重构 `app/read/[id]`，支持从文件系统动态读取 Markdown 内容，替代硬编码数据。
-- **模块化架构定义**: 初步建立支付、营销、分销三大变现模块的接口定义 (`lib/modules/*`)。
-- **内容解析引擎**: 升级 `lib/book-file-system.ts`，增加内容读取与 Slug 匹配功能。
-
-#### 2. 优化
-- **开发文档**: 新增 `2、架构/变现模块设计.md`，明确变现系统的技术实现路径。
-- **项目管理**: 实时更新项目推进表，确保进度可视。
-
-#### 3. 下一步计划
-- 实现营销模块的弹窗逻辑（阅读拦截）。
-- 开发支付模块的 Mock 实现，打通购买流程 UI。
-
-## 2025-12-29
-### v0.3.0 支付模块集成
-**负责人**: 卡若 (AI助理)
-
-#### 1. 新增功能
-- **Universal_Payment_Module集成**: 添加适配器模式，支持支付宝、微信等支付网关。
-- **API端点**: 创建/create, /checkout, /notify路由。
-- **数据库模型**: Order和PayTrade schema。
-
-#### 2. 优化
-- 修复语法错误，运行lint检查。
-- 验证实时支付功能。
-
-#### 3. 下一步计划
-- 前端优化和测试组件添加。
-
-## 2025-12-29 (晚)
-### v0.4.0 分销与裂变系统 (Phase 5)
-**负责人**: 卡若 (AI助理)
-
-#### 1. 新增功能
-- **分销海报生成器**: 实现 `PosterModal` 组件，支持自动生成含用户邀请码和专属二维码的推广海报。
-- **分销中心升级**: 优化 `/my/referral` 页面，集成海报生成入口，提供多渠道分享（微信、朋友圈、Soul）。
-- **邀请机制闭环**: 确认邀请码生成、绑定（注册时填写）、收益计算逻辑已在 `store.ts` 中完全实现。
-
-#### 2. 进度同步
-- 完成第五阶段核心功能：邀请码生成、绑定、收益计算、裂变海报。
-- 更新项目推进表，标记相关任务为完成。
-
-#### 3. 下一步计划
-- 提现逻辑完善（目前仅UI展示）。
-- 准备部署上线。
-
-## 2025-01-14
-### v1.0.0 微信小程序完整版
-**负责人**: 卡若 (AI助理)
-
-#### 1. 新增功能
-- **微信小程序架构**: 完整创建小程序版本，包含5个核心页面（首页/匹配/我的/阅读/章节）
-- **腾讯轻松付款**: 集成微信支付API，支持动态定价（9.9元起，每天+1元）
-- **随机匹配书友**: 类Soul星球的匹配功能，包含星空动画、匹配算法、兴趣展示
-- **后台模块化管理**: 三大管理模块（内容/付费/分销），完整的CRUD接口
-- **实时同步系统**: 自动监听book目录变化，实时同步章节内容到小程序
-- **分销系统完善**: 90%佣金比例，推广海报生成，邀请码系统，收益统计
-
-#### 2. 技术架构
-- 前端：微信小程序原生开发（WXML/WXSS/JS）
-- 后端：Next.js API Routes
-- 支付：微信支付API V3
-- 同步：文件系统监听 + 增量更新
-- 管理：模块化后台（/api/admin/*）
-
-#### 3. 文件结构
-\`\`\`
-miniprogram/                    # 小程序源码目录
-├── pages/                      # 页面
-│   ├── index/                 # 首页
-│   ├── match/                 # 匹配书友
-│   ├── my/                    # 我的（含分销）
-│   ├── read/                  # 阅读页
-│   └── chapters/              # 章节列表
-├── utils/                      # 工具类
-│   └── payment.js             # 微信支付
-├── app.js/json/wxss           # 全局配置
-└── README.md                  # 使用说明
-
-app/api/                        # 后端API
-├── admin/                     # 管理后台
-│   ├── route.ts              # 后台入口
-│   ├── content/route.ts      # 内容管理
-│   ├── payment/route.ts      # 付费管理
-│   └── referral/route.ts     # 分销管理
-└── sync/route.ts              # 实时同步
-
-开发文档/
-└── 小程序开发完成说明.md     # 完整交付文档
-\`\`\`
-
-#### 4. 部署说明
-- **小程序AppID**: 需在 `project.config.json` 配置
-- **API地址**: 需在 `app.js` 配置 `apiBase`
-- **微信支付**: 需配置商户号和密钥
-- **服务器域名**: 需在小程序后台配置白名单
-
-#### 5. 核心特性
-- ✅ iOS风格设计（毛玻璃效果、流畅动画）
-- ✅ 高性能（图片懒加载、骨架屏、缓存机制）
-- ✅ 完整支付流程（创建订单、微信支付、状态查询）
-- ✅ 匹配算法（实时匹配、兴趣计算、历史记录）
-- ✅ 分销体系（邀请码、佣金计算、海报生成、收益提现）
-- ✅ 后台管理（内容发布、订单管理、分销结算）
-- ✅ 实时同步（自动监听、增量更新、日志记录）
-
-#### 6. 下一步优化
-- 数据库接入（替换Mock数据）
-- 用户认证系统完善
-- WebSocket实时通讯
-- 评论和社区功能
-- 数据分析看板

开发文档/小程序管理/references/API接口速查表.md

@@ -0,0 +1,176 @@
+# 微信小程序管理API速查表
+
+> 快速查找常用API接口
+
+---
+
+## 一、认证相关
+
+| 接口 | 方法 | 说明 |
+|------|------|------|
+| `/cgi-bin/component/api_component_token` | POST | 获取第三方平台token |
+| `/cgi-bin/component/api_create_preauthcode` | POST | 获取预授权码 |
+| `/cgi-bin/component/api_query_auth` | POST | 获取授权信息 |
+| `/cgi-bin/component/api_authorizer_token` | POST | 刷新授权方token |
+
+---
+
+## 二、基础信息
+
+| 接口 | 方法 | 说明 |
+|------|------|------|
+| `/cgi-bin/account/getaccountbasicinfo` | POST | 获取基础信息 |
+| `/wxa/setnickname` | POST | 设置名称 |
+| `/cgi-bin/account/modifyheadimage` | POST | 修改头像 |
+| `/cgi-bin/account/modifysignature` | POST | 修改简介 |
+
+---
+
+## 三、类目管理
+
+| 接口 | 方法 | 说明 |
+|------|------|------|
+| `/cgi-bin/wxopen/getallcategories` | GET | 获取可选类目 |
+| `/cgi-bin/wxopen/getcategory` | GET | 获取已设置类目 |
+| `/cgi-bin/wxopen/addcategory` | POST | 添加类目 |
+| `/cgi-bin/wxopen/deletecategory` | POST | 删除类目 |
+| `/cgi-bin/wxopen/modifycategory` | POST | 修改类目 |
+
+---
+
+## 四、域名配置
+
+| 接口 | 方法 | 说明 |
+|------|------|------|
+| `/wxa/modify_domain` | POST | 设置服务器域名 |
+| `/wxa/setwebviewdomain` | POST | 设置业务域名 |
+
+**action参数**：
+- `get` - 获取
+- `set` - 覆盖设置
+- `add` - 添加
+- `delete` - 删除
+
+---
+
+## 五、隐私协议
+
+| 接口 | 方法 | 说明 |
+|------|------|------|
+| `/cgi-bin/component/getprivacysetting` | POST | 获取隐私设置 |
+| `/cgi-bin/component/setprivacysetting` | POST | 设置隐私协议 |
+
+**常用隐私字段**：
+- `UserInfo` - 用户信息
+- `Location` - 地理位置
+- `PhoneNumber` - 手机号
+- `Album` - 相册
+- `Camera` - 相机
+- `Record` - 麦克风
+- `Clipboard` - 剪切板
+
+---
+
+## 六、代码管理
+
+| 接口 | 方法 | 说明 |
+|------|------|------|
+| `/wxa/commit` | POST | 上传代码 |
+| `/wxa/get_page` | GET | 获取页面列表 |
+| `/wxa/get_qrcode` | GET | 获取体验版二维码 |
+
+---
+
+## 七、审核管理
+
+| 接口 | 方法 | 说明 |
+|------|------|------|
+| `/wxa/submit_audit` | POST | 提交审核 |
+| `/wxa/get_auditstatus` | POST | 查询审核状态 |
+| `/wxa/get_latest_auditstatus` | GET | 查询最新审核状态 |
+| `/wxa/undocodeaudit` | GET | 撤回审核（每天1次） |
+| `/wxa/speedupaudit` | POST | 加急审核 |
+
+**审核状态码**：
+- `0` - 审核成功
+- `1` - 审核被拒
+- `2` - 审核中
+- `3` - 已撤回
+- `4` - 审核延后
+
+---
+
+## 八、发布管理
+
+| 接口 | 方法 | 说明 |
+|------|------|------|
+| `/wxa/release` | POST | 发布上线 |
+| `/wxa/revertcoderelease` | GET | 版本回退 |
+| `/wxa/grayrelease` | POST | 分阶段发布 |
+| `/wxa/getgrayreleaseplan` | GET | 查询灰度计划 |
+| `/wxa/revertgrayrelease` | GET | 取消灰度 |
+
+---
+
+## 九、小程序码
+
+| 接口 | 方法 | 说明 | 限制 |
+|------|------|------|------|
+| `/wxa/getwxacode` | POST | 获取小程序码 | 每个path最多10万个 |
+| `/wxa/getwxacodeunlimit` | POST | 获取无限小程序码 | 无限制（推荐） |
+| `/cgi-bin/wxaapp/createwxaqrcode` | POST | 获取小程序二维码 | 每个path最多10万个 |
+| `/wxa/genwxashortlink` | POST | 生成短链接 | - |
+
+---
+
+## 十、数据分析
+
+| 接口 | 方法 | 说明 |
+|------|------|------|
+| `/datacube/getweanalysisappiddailyvisittrend` | POST | 日访问趋势 |
+| `/datacube/getweanalysisappidweeklyvisittrend` | POST | 周访问趋势 |
+| `/datacube/getweanalysisappidmonthlyvisittrend` | POST | 月访问趋势 |
+| `/datacube/getweanalysisappiduserportrait` | POST | 用户画像 |
+| `/datacube/getweanalysisappidvisitpage` | POST | 访问页面 |
+
+---
+
+## 十一、API配额
+
+| 接口 | 方法 | 说明 |
+|------|------|------|
+| `/cgi-bin/openapi/quota/get` | POST | 查询接口配额 |
+| `/cgi-bin/clear_quota` | POST | 重置调用次数（每月10次） |
+| `/cgi-bin/openapi/rid/get` | POST | 查询rid信息 |
+
+---
+
+## 十二、快速注册
+
+| 接口 | 方法 | 说明 |
+|------|------|------|
+| `/cgi-bin/account/fastregister` | POST | 复用公众号资质注册 |
+| `/cgi-bin/component/fastregisterminiprogram` | POST | 快速注册企业小程序 |
+
+---
+
+## 常见错误码
+
+| 错误码 | 说明 | 解决方案 |
+|--------|------|----------|
+| 40001 | access_token无效 | 重新获取token |
+| 42001 | access_token过期 | 刷新token |
+| 45009 | 调用超过限制 | 明天再试或重置 |
+| 61039 | 代码检测未完成 | 等待几秒后重试 |
+| 85009 | 已有审核版本 | 先撤回再提交 |
+| 85086 | 未绑定类目 | 先添加类目 |
+| 87013 | 每天只能撤回1次 | 明天再试 |
+| 89248 | 隐私协议不完整 | 补充隐私配置 |
+
+---
+
+## 官方文档链接
+
+- [第三方平台开发指南](https://developers.weixin.qq.com/doc/oplatform/Third-party_Platforms/2.0/getting_started/how_to_read.html)
+- [代码管理API](https://developers.weixin.qq.com/doc/oplatform/openApi/OpenApiDoc/miniprogram-management/code-management/commit.html)
+- [隐私协议开发指南](https://developers.weixin.qq.com/miniprogram/dev/framework/user-privacy/)

开发文档/小程序管理/references/企业认证完整指南.md

@@ -0,0 +1,307 @@
+# 小程序企业认证完整指南
+
+> 从准备材料到认证完成的完整操作流程
+
+---
+
+## 一、认证必要性
+
+### 未认证 vs 已认证
+
+| 功能 | 未认证 | 已认证 |
+|------|--------|--------|
+| 上传代码 | ✅ 可以 | ✅ 可以 |
+| 生成体验版 | ✅ 可以 | ✅ 可以 |
+| 提交审核 | ❌ 不可以 | ✅ 可以 |
+| 发布上线 | ❌ 不可以 | ✅ 可以 |
+| 微信支付 | ❌ 不可以 | ✅ 可以 |
+| 获取手机号 | ❌ 不可以 | ✅ 可以 |
+| 申请接口权限 | ❌ 受限 | ✅ 全部 |
+
+**结论**：要让小程序上线，必须完成企业认证。
+
+---
+
+## 二、认证类型
+
+### 1. 企业认证（推荐）
+
+**适用于**：公司、企业
+**费用**：300元/年
+**审核时间**：1-5个工作日
+
+### 2. 个体工商户认证
+
+**适用于**：个体工商户
+**费用**：300元/年
+**审核时间**：1-5个工作日
+
+### 3. 政府/事业单位认证
+
+**适用于**：政府机关、事业单位
+**费用**：免费
+**审核时间**：1-5个工作日
+
+### 4. 复用公众号资质（快速）
+
+**适用于**：已有认证公众号
+**费用**：免费
+**审核时间**：即时生效
+
+---
+
+## 三、企业认证材料清单
+
+### 必需材料
+
+| 材料 | 要求 | 说明 |
+|------|------|------|
+| **企业营业执照** | 彩色扫描件/照片 | 信息清晰完整，未过期 |
+| **法人身份证** | 正反面照片 | 与营业执照法人一致 |
+| **法人微信号** | 已绑定银行卡 | 用于扫码验证身份 |
+| **联系人手机号** | 能接收短信 | 接收审核通知 |
+| **认证费用** | 300元 | 支持微信支付 |
+
+### 特殊行业额外材料
+
+| 行业 | 额外材料 |
+|------|----------|
+| 医疗健康 | 医疗机构执业许可证 |
+| 金融服务 | 金融业务许可证 |
+| 教育培训 | 办学许可证 |
+| 餐饮服务 | 食品经营许可证 |
+| 直播 | 网络文化经营许可证 |
+
+---
+
+## 四、认证操作步骤
+
+### 步骤1：准备材料
+
+```
+☐ 营业执照扫描件（清晰、完整）
+☐ 法人身份证正面照片
+☐ 法人身份证反面照片
+☐ 确认法人微信已绑定银行卡
+☐ 准备300元认证费用
+```
+
+### 步骤2：登录小程序后台
+
+1. 打开 https://mp.weixin.qq.com/
+2. 使用小程序管理员微信扫码登录
+
+### 步骤3：进入认证页面
+
+1. 点击左侧菜单「设置」
+2. 点击「基本设置」
+3. 找到「微信认证」区域
+4. 点击「去认证」或「详情」
+
+### 步骤4：选择认证类型
+
+1. 选择「企业」类型
+2. 勾选同意协议
+3. 点击「下一步」
+
+### 步骤5：填写企业信息
+
+```
+企业名称：厦门智群网络科技有限公司
+统一社会信用代码：91350200...
+企业类型：有限责任公司
+经营范围：（按营业执照填写）
+注册地址：（按营业执照填写）
+```
+
+### 步骤6：上传营业执照
+
+1. 上传营业执照扫描件
+2. 确保图片清晰、四角完整
+3. 信息与填写内容一致
+
+### 步骤7：填写法人信息
+
+```
+法人姓名：（与营业执照一致）
+法人身份证号：
+法人微信号：
+```
+
+### 步骤8：上传法人身份证
+
+1. 上传身份证正面（人像面）
+2. 上传身份证反面（国徽面）
+3. 确保照片清晰
+
+### 步骤9：法人扫码验证
+
+1. 页面显示验证二维码
+2. 使用法人微信扫码
+3. 在手机上确认验证
+
+### 步骤10：支付认证费用
+
+1. 确认费用：300元
+2. 使用微信支付
+3. 支付成功后等待审核
+
+### 步骤11：等待审核
+
+- 审核时间：1-5个工作日
+- 审核结果会通过模板消息通知
+- 也可在后台查看审核进度
+
+---
+
+## 五、常见问题
+
+### Q1: 法人不方便扫码怎么办？
+
+**解决方案**：
+1. 远程发送验证二维码给法人
+2. 法人用微信扫码即可
+3. 不需要法人在场
+
+### Q2: 营业执照即将过期？
+
+**解决方案**：
+1. 先更新营业执照
+2. 再申请认证
+3. 过期的营业执照无法通过审核
+
+### Q3: 法人微信未绑定银行卡？
+
+**解决方案**：
+1. 法人先在微信中绑定银行卡
+2. 绑定后再进行扫码验证
+3. 这是实名验证的必要条件
+
+### Q4: 审核被拒绝怎么办？
+
+**常见原因**：
+- 营业执照信息与填写不一致
+- 图片模糊或不完整
+- 法人信息与营业执照不匹配
+
+**解决方案**：
+1. 查看拒绝原因
+2. 修正问题
+3. 重新提交（不需要再付费）
+
+### Q5: 认证到期怎么办？
+
+**年审流程**：
+1. 提前30天会收到提醒
+2. 登录后台进行年审
+3. 更新材料并支付300元
+4. 1-5个工作日完成
+
+---
+
+## 六、认证后标记完成
+
+认证通过后，运行以下命令更新状态：
+
+```bash
+cd /Users/karuo/Documents/个人/卡若AI/02_卡人（水）/小程序管理/scripts
+
+# 标记认证完成
+python3 mp_deploy.py cert-done soul-party
+
+# 确认状态
+python3 mp_deploy.py cert-status soul-party
+
+# 现在可以部署了
+python3 mp_deploy.py deploy soul-party
+```
+
+---
+
+## 七、认证时间线
+
+| 时间节点 | 操作 |
+|----------|------|
+| Day 0 | 准备材料，提交认证申请 |
+| Day 0 | 法人扫码验证，支付费用 |
+| Day 1-5 | 等待审核 |
+| Day 5 | 审核通过/被拒 |
+| 通过后 | 可以正常发布小程序 |
+| 1年后 | 需要年审续费 |
+
+---
+
+## 八、复用公众号资质（免费快速认证）
+
+如果你已有认证的公众号，可以免费快速认证小程序：
+
+### 条件
+- 公众号已完成微信认证
+- 公众号类型为企业/媒体/政府/其他组织
+- 公众号与小程序主体一致
+
+### 操作步骤
+1. 登录公众号后台
+2. 小程序 → 小程序管理 → 添加
+3. 选择「快速注册并认证小程序」
+4. 同意协议 → 管理员扫码
+5. 选择复用资质 → 填写小程序信息
+6. 提交后即时生效
+
+### 限制
+- 非个体户：每月可注册5个小程序
+- 个体户：每月可注册1个小程序
+
+---
+
+## 九、第三方平台代认证（高级）
+
+如果你有第三方平台资质，可以通过API代商家认证：
+
+### API接口
+
+```python
+# POST https://api.weixin.qq.com/wxa/sec/wxaauth
+{
+    "auth_type": 1,
+    "auth_data": {
+        "enterprise_name": "企业名称",
+        "code": "统一社会信用代码",
+        "code_type": 1,
+        "legal_persona_wechat": "法人微信号",
+        "legal_persona_name": "法人姓名",
+        "legal_persona_idcard": "法人身份证号",
+        "component_phone": "联系电话"
+    }
+}
+```
+
+### 返回说明
+
+| errcode | 说明 |
+|---------|------|
+| 0 | 提交成功 |
+| 89247 | 认证信息校验失败 |
+| 89248 | 法人信息不匹配 |
+| 89249 | 需要法人扫码验证 |
+
+---
+
+## 十、卡若公司认证信息
+
+```json
+{
+  "enterprise_name": "厦门智群网络科技有限公司",
+  "license_number": "",
+  "legal_persona_name": "",
+  "component_phone": "15880802661",
+  "contact_email": "zhiqun@qq.com"
+}
+```
+
+**注意**：敏感信息（营业执照号、法人姓名、身份证号）请填入配置文件，不要写在文档中。
+
+---
+
+**创建时间**：2026-01-25
+**适用于**：所有需要企业认证的小程序

开发文档/小程序管理/references/审核规范.md

@@ -0,0 +1,276 @@
+# 小程序审核规范与常见问题
+
+> 帮助你提高审核通过率
+
+---
+
+## 一、审核时间
+
+| 类型 | 时间 |
+|------|------|
+| 首次提审 | 1-7个工作日 |
+| 非首次提审 | 1-3个工作日 |
+| 加急审核（付费） | 24小时内 |
+
+**注意**：节假日期间审核时间会延长
+
+---
+
+## 二、常见被拒原因及解决方案
+
+### 1. 类目不符
+
+**问题描述**：
+小程序功能与所选类目不一致
+
+**解决方案**：
+- 检查小程序实际功能
+- 在后台选择正确的类目
+- 部分类目需要资质证明
+
+**示例**：
+- 电子书阅读 → 教育-在线教育 或 图书-电子书
+- 商城 → 商家自营-百货
+- 工具类 → 工具-效率办公
+
+### 2. 隐私协议缺失
+
+**问题描述**：
+使用了隐私接口但未配置隐私保护指引
+
+**解决方案**：
+1. 在小程序后台配置《用户隐私保护指引》
+2. 在小程序代码中实现隐私授权弹窗
+3. 确保每个隐私接口都有对应说明
+
+### 3. 诱导分享/关注
+
+**问题描述**：
+- "分享到群可获得xx"
+- "关注公众号领取xx"
+- "转发后才能继续使用"
+
+**解决方案**：
+- 删除所有诱导性文案
+- 分享/关注不能作为获取功能的前提条件
+- 可以使用"邀请好友"等非强制性引导
+
+### 4. 虚拟支付（iOS）
+
+**问题描述**：
+iOS上使用了非IAP的虚拟商品支付
+
+**解决方案**：
+- iOS上虚拟商品必须使用苹果内购（IAP）
+- 或者关闭iOS上的虚拟商品购买入口
+- 实物商品可以使用微信支付
+
+**常见虚拟商品**：
+- 会员/VIP
+- 虚拟货币
+- 电子书内容
+- 课程/教程
+
+### 5. 功能不完整
+
+**问题描述**：
+- 页面空白或无内容
+- 按钮无响应
+- 功能入口找不到
+
+**解决方案**：
+- 确保所有页面都有内容
+- 确保所有按钮都有响应
+- 提供完整的测试账号
+- 录制操作视频说明
+
+### 6. 内容违规
+
+**问题描述**：
+- 涉及敏感词汇
+- 图片不合规
+- 用户生成内容（UGC）无审核机制
+
+**解决方案**：
+- 自查敏感词
+- 检查图片是否合规
+- UGC内容需要有审核/举报机制
+
+### 7. 资质问题
+
+**问题描述**：
+某些功能需要特定资质
+
+**常见需要资质的功能**：
+| 功能 | 需要资质 |
+|------|----------|
+| 直播 | 《增值电信业务许可证》或《网络文化经营许可证》 |
+| 金融 | 金融资质 |
+| 医疗 | 医疗资质 |
+| 地图 | 地图服务相关资质 |
+| 发票 | 发票服务资质 |
+
+### 8. 测试账号问题
+
+**问题描述**：
+- 未提供测试账号
+- 测试账号无法登录
+- 测试账号权限不足
+
+**解决方案**：
+- 提供有效的测试账号和密码
+- 确保测试账号可以体验全部功能
+- 在审核备注中说明账号用途
+
+---
+
+## 三、提高审核通过率的技巧
+
+### 1. 提交前自查清单
+
+- [ ] 所有页面功能正常
+- [ ] 隐私协议已配置
+- [ ] 类目选择正确
+- [ ] 无诱导分享/关注
+- [ ] iOS虚拟支付问题已处理
+- [ ] 测试账号有效
+- [ ] 内容合规
+
+### 2. 填写完整的审核信息
+
+```python
+# 提交审核时的item_list示例
+item_list = [
+    {
+        "address": "pages/index/index",
+        "tag": "电子书 阅读 创业",
+        "first_class": "教育",
+        "second_class": "在线教育",
+        "first_id": 1,
+        "second_id": 2,
+        "title": "首页-电子书列表"
+    },
+    {
+        "address": "pages/read/read",
+        "tag": "阅读 书籍",
+        "first_class": "教育",
+        "second_class": "在线教育",
+        "first_id": 1,
+        "second_id": 2,
+        "title": "阅读页-章节内容"
+    }
+]
+```
+
+### 3. 录制操作视频
+
+对于复杂功能，建议录制操作视频：
+1. 展示所有核心功能
+2. 演示完整的用户流程
+3. 说明需要测试账号才能体验的功能
+
+### 4. 写清楚版本说明
+
+```
+版本说明示例：
+1. 新增电子书阅读功能
+2. 新增用户登录功能（使用手机号登录）
+3. 新增分销功能（邀请好友可获得佣金）
+
+测试账号：
+手机号：13800138000
+验证码：123456
+
+注意事项：
+1. 分销佣金功能需要登录后才能使用
+2. 部分章节为付费内容，可使用测试账号体验
+```
+
+---
+
+## 四、审核被拒后的处理
+
+### 1. 查看拒绝原因
+
+```python
+from mp_api import MiniProgramAPI
+
+api = MiniProgramAPI(access_token="你的token")
+status = api.get_latest_audit_status()
+
+if status.status == 1:  # 被拒
+    print(f"拒绝原因: {status.reason}")
+    print(f"问题截图: {status.screenshot}")
+```
+
+### 2. 根据原因修改
+
+- 仔细阅读拒绝原因
+- 查看问题截图
+- 针对性修改
+
+### 3. 重新提交
+
+修改完成后重新提交审核，建议在版本说明中说明修改内容：
+
+```
+v1.0.1 更新说明：
+1. 修复上次审核指出的问题
+2. 删除了诱导分享的文案
+3. 完善了隐私协议配置
+
+修改详情：
+- 删除了"分享到群获得积分"的引导
+- 在设置页面增加了隐私协议入口
+```
+
+---
+
+## 五、特殊情况处理
+
+### 1. 加急审核
+
+微信提供付费加急审核服务，24小时内完成审核。
+
+申请条件：
+- 有紧急的业务需求
+- 非首次提审
+
+### 2. 申诉
+
+如果认为审核结果有误，可以申诉：
+1. 登录小程序后台
+2. 版本管理 → 审核版本
+3. 点击"申诉"
+4. 填写申诉理由
+
+### 3. 撤回审核
+
+如果发现问题需要撤回：
+- 每天只能撤回1次
+- 撤回后需要重新提交
+
+```python
+# 撤回审核
+api.undo_code_audit()
+```
+
+---
+
+## 六、审核状态码说明
+
+| 状态码 | 说明 | 后续操作 |
+|--------|------|----------|
+| 0 | 审核成功 | 可以发布上线 |
+| 1 | 审核被拒 | 根据原因修改后重新提交 |
+| 2 | 审核中 | 等待（1-7个工作日） |
+| 3 | 已撤回 | 修改后重新提交 |
+| 4 | 审核延后 | 等待进一步通知 |
+
+---
+
+## 七、相关链接
+
+- [小程序审核规范](https://developers.weixin.qq.com/miniprogram/product/reject.html)
+- [运营规范](https://developers.weixin.qq.com/miniprogram/product/#运营规范)
+- [常见拒绝情形](https://developers.weixin.qq.com/miniprogram/product/reject.html)

开发文档/小程序管理/references/隐私协议填写指南.md

@@ -0,0 +1,242 @@
+# 小程序隐私协议填写指南
+
+> 2024年起，小程序需要配置隐私保护指引才能正常使用涉及用户隐私的接口
+
+---
+
+## 一、为什么需要配置？
+
+从2024年开始，微信要求所有小程序：
+1. 在调用涉及用户隐私的接口前，需要让用户同意隐私协议
+2. 必须在小程序后台配置《用户隐私保护指引》
+3. 未配置的接口将无法正常调用
+
+---
+
+## 二、常用隐私字段说明
+
+### 用户信息类
+
+| 字段 | 涉及接口 | 填写示例 |
+|------|----------|----------|
+| `UserInfo` | wx.getUserProfile, wx.getUserInfo | 用于展示您的头像和昵称 |
+| `Nickname` | wx.chooseNickname | 用于获取您设置的昵称 |
+
+### 位置信息类
+
+| 字段 | 涉及接口 | 填写示例 |
+|------|----------|----------|
+| `Location` | wx.getLocation, wx.chooseLocation | 用于获取您的位置信息以推荐附近服务 |
+| `ChooseLocation` | wx.chooseLocation | 用于在地图上选择位置 |
+
+### 通讯信息类
+
+| 字段 | 涉及接口 | 填写示例 |
+|------|----------|----------|
+| `PhoneNumber` | button(open-type="getPhoneNumber") | 用于登录验证和订单通知 |
+| `Contact` | wx.chooseContact | 用于获取通讯录联系人 |
+
+### 媒体信息类
+
+| 字段 | 涉及接口 | 填写示例 |
+|------|----------|----------|
+| `Album` | wx.chooseImage, wx.chooseMedia | 用于上传图片或视频 |
+| `Camera` | wx.openSetting, camera组件 | 用于拍摄照片或视频 |
+| `Record` | wx.startRecord, RecorderManager | 用于录制语音消息 |
+
+### 其他信息类
+
+| 字段 | 涉及接口 | 填写示例 |
+|------|----------|----------|
+| `Clipboard` | wx.setClipboardData, wx.getClipboardData | 用于复制分享链接或优惠码 |
+| `ChooseAddress` | wx.chooseAddress | 用于获取收货地址以便配送 |
+| `MessageFile` | wx.openDocument | 用于打开微信消息中的文件 |
+| `BluetoothInfo` | wx.openBluetoothAdapter | 用于连接蓝牙设备 |
+
+---
+
+## 三、如何配置
+
+### 方式一：微信后台手动配置
+
+1. 登录 [小程序后台](https://mp.weixin.qq.com/)
+2. 设置 → 基本设置 → 用户隐私保护指引
+3. 选择需要使用的接口
+4. 填写使用说明
+5. 提交审核
+
+### 方式二：通过API配置
+
+```python
+from mp_api import MiniProgramAPI
+
+api = MiniProgramAPI(access_token="你的token")
+
+# 配置隐私协议
+api.set_privacy_setting(
+    setting_list=[
+        {"privacy_key": "UserInfo", "privacy_text": "用于展示您的头像和昵称"},
+        {"privacy_key": "Location", "privacy_text": "用于获取您的位置信息以推荐附近服务"},
+        {"privacy_key": "PhoneNumber", "privacy_text": "用于登录验证和订单通知"},
+        {"privacy_key": "Album", "privacy_text": "用于上传图片"},
+        {"privacy_key": "Clipboard", "privacy_text": "用于复制分享链接"},
+    ],
+    contact_email="zhiqun@qq.com",
+    contact_phone="15880802661"
+)
+```
+
+### 方式三：使用CLI工具快速配置
+
+```bash
+cd /Users/karuo/Documents/个人/卡若AI/02_卡人（水）/小程序管理/scripts
+python mp_manager.py privacy --quick --email zhiqun@qq.com --phone 15880802661
+```
+
+---
+
+## 四、小程序端代码实现
+
+### 1. 在app.json中声明
+
+```json
+{
+  "usingComponents": {},
+  "__usePrivacyCheck__": true
+}
+```
+
+### 2. 隐私协议弹窗组件
+
+```javascript
+// privacy-popup.js
+Component({
+  data: {
+    showPrivacy: false
+  },
+  
+  methods: {
+    // 显示隐私弹窗
+    showPrivacyPopup() {
+      if (wx.getPrivacySetting) {
+        wx.getPrivacySetting({
+          success: (res) => {
+            if (res.needAuthorization) {
+              this.setData({ showPrivacy: true })
+            }
+          }
+        })
+      }
+    },
+    
+    // 同意隐私协议
+    handleAgree() {
+      if (wx.agreePrivacyAuthorization) {
+        wx.agreePrivacyAuthorization({
+          success: () => {
+            this.setData({ showPrivacy: false })
+          }
+        })
+      }
+    },
+    
+    // 查看隐私协议详情
+    openPrivacyContract() {
+      wx.openPrivacyContract()
+    }
+  }
+})
+```
+
+```html
+<!-- privacy-popup.wxml -->
+<view class="privacy-popup" wx:if="{{showPrivacy}}">
+  <view class="popup-content">
+    <view class="title">用户隐私保护提示</view>
+    <view class="desc">
+      在使用本小程序前，请仔细阅读
+      <text class="link" bindtap="openPrivacyContract">《用户隐私保护指引》</text>
+    </view>
+    <view class="buttons">
+      <button class="btn-disagree" bindtap="handleDisagree">不同意</button>
+      <button class="btn-agree" id="agree-btn" open-type="agreePrivacyAuthorization" bindagreeprivacyauthorization="handleAgree">同意</button>
+    </view>
+  </view>
+</view>
+```
+
+### 3. 在需要的页面调用
+
+```javascript
+// pages/index/index.js
+Page({
+  onLoad() {
+    // 检查是否需要授权
+    this.checkPrivacy()
+  },
+  
+  checkPrivacy() {
+    if (wx.getPrivacySetting) {
+      wx.getPrivacySetting({
+        success: (res) => {
+          if (res.needAuthorization) {
+            // 需要授权，显示弹窗
+            this.selectComponent('#privacy-popup').showPrivacyPopup()
+          }
+        }
+      })
+    }
+  }
+})
+```
+
+---
+
+## 五、常见问题
+
+### Q1: 隐私协议需要审核吗？
+
+配置后需要等待审核（通常1-2小时），审核通过后才会生效。
+
+### Q2: 用户拒绝后怎么办？
+
+用户拒绝后，相关接口将无法使用。可以引导用户重新打开小程序，会再次弹出隐私协议。
+
+### Q3: 如何测试隐私协议？
+
+在微信开发者工具中：
+1. 详情 → 本地设置
+2. 勾选"启用隐私相关接口"
+3. 清除授权记录后测试
+
+### Q4: 提交审核时提示隐私协议不完整？
+
+检查以下几点：
+1. 是否填写了所有使用到的隐私接口
+2. 每个接口的说明是否清晰
+3. 是否填写了联系方式（邮箱或电话至少一个）
+
+---
+
+## 六、Soul派对小程序配置参考
+
+```python
+# Soul派对小程序的隐私配置
+setting_list = [
+    {"privacy_key": "UserInfo", "privacy_text": "用于展示您在Soul派对中的头像和昵称"},
+    {"privacy_key": "PhoneNumber", "privacy_text": "用于登录验证和购买通知"},
+    {"privacy_key": "Clipboard", "privacy_text": "用于复制分享链接和邀请码"},
+]
+
+# 联系方式
+contact_email = "zhiqun@qq.com"
+contact_phone = "15880802661"
+```
+
+---
+
+## 七、参考文档
+
+- [小程序隐私协议开发指南](https://developers.weixin.qq.com/miniprogram/dev/framework/user-privacy/)
+- [用户隐私保护指引填写说明](https://developers.weixin.qq.com/miniprogram/dev/framework/user-privacy/)
+- [隐私接口列表](https://developers.weixin.qq.com/miniprogram/dev/framework/user-privacy/miniprogram-intro.html)

开发文档/小程序管理/scripts/apps_config.json

@@ -0,0 +1,40 @@
+{
+  "_comment": "小程序配置文件 - 支持管理多个小程序",
+  "apps": [
+    {
+      "id": "soul-party",
+      "name": "Soul派对",
+      "appid": "wxb8bbb2b10dec74aa",
+      "project_path": "/Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验/miniprogram",
+      "private_key_path": "",
+      "api_domain": "https://soul.quwanzhi.com",
+      "description": "一场SOUL的创业实验场",
+      "certification": {
+        "status": "pending",
+        "enterprise_name": "泉州市卡若网络技术有限公司",
+        "license_number": "",
+        "legal_persona_name": "",
+        "legal_persona_wechat": "",
+        "component_phone": "15880802661"
+      }
+    }
+  ],
+  "certification_materials": {
+    "_comment": "企业认证通用材料（所有小程序共用）",
+    "enterprise_name": "泉州市卡若网络技术有限公司",
+    "license_number": "",
+    "license_media_id": "",
+    "legal_persona_name": "",
+    "legal_persona_wechat": "",
+    "legal_persona_idcard": "",
+    "component_phone": "15880802661",
+    "contact_email": "zhiqun@qq.com"
+  },
+  "third_party_platform": {
+    "_comment": "第三方平台配置（用于代认证）",
+    "component_appid": "",
+    "component_appsecret": "",
+    "component_verify_ticket": "",
+    "authorized": false
+  }
+}

开发文档/小程序管理/scripts/env_template.txt

@@ -0,0 +1,30 @@
+# 微信小程序管理 - 环境变量配置
+# 复制此文件为 .env 并填入实际值
+
+# ==================== 方式一：直接使用 access_token ====================
+# 如果你已经有 access_token，直接填入即可（适合快速测试）
+ACCESS_TOKEN=你的access_token
+
+# ==================== 方式二：使用第三方平台凭证 ====================
+# 如果你有第三方平台资质，填入以下信息可自动刷新token
+
+# 第三方平台 AppID
+COMPONENT_APPID=你的第三方平台AppID
+
+# 第三方平台密钥
+COMPONENT_APPSECRET=你的第三方平台密钥
+
+# 授权小程序 AppID（要管理的小程序）
+AUTHORIZER_APPID=wxb8bbb2b10dec74aa
+
+# 授权刷新令牌（从授权回调中获取）
+AUTHORIZER_REFRESH_TOKEN=授权时获取的refresh_token
+
+# ==================== 小程序项目路径 ====================
+# 用于 CLI 工具操作
+MINIPROGRAM_PATH=/Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验/miniprogram
+
+# ==================== 可选配置 ====================
+# 隐私协议联系方式（用于快速配置）
+CONTACT_EMAIL=zhiqun@qq.com
+CONTACT_PHONE=15880802661

开发文档/小程序管理/scripts/mp_api.py

@@ -0,0 +1,635 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+微信小程序管理API封装
+支持：注册、配置、代码管理、审核、发布、数据分析
+"""
+
+import os
+import json
+import time
+import httpx
+from typing import Optional, Dict, Any, List
+from dataclasses import dataclass
+from pathlib import Path
+
+# 尝试加载dotenv（可选依赖）
+try:
+    from dotenv import load_dotenv
+    load_dotenv()
+except ImportError:
+    pass  # dotenv不是必需的
+
+
+@dataclass
+class MiniProgramInfo:
+    """小程序基础信息"""
+    appid: str
+    nickname: str
+    head_image_url: str
+    signature: str
+    principal_name: str
+    realname_status: int  # 1=已认证
+
+
+@dataclass
+class AuditStatus:
+    """审核状态"""
+    auditid: int
+    status: int  # 0=成功，1=被拒，2=审核中，3=已撤回，4=延后
+    reason: Optional[str] = None
+    screenshot: Optional[str] = None
+
+    @property
+    def status_text(self) -> str:
+        status_map = {
+            0: "✅ 审核成功",
+            1: "❌ 审核被拒",
+            2: "⏳ 审核中",
+            3: "↩️ 已撤回",
+            4: "⏸️ 审核延后"
+        }
+        return status_map.get(self.status, "未知状态")
+
+
+class MiniProgramAPI:
+    """微信小程序管理API"""
+    
+    BASE_URL = "https://api.weixin.qq.com"
+    
+    def __init__(
+        self,
+        component_appid: Optional[str] = None,
+        component_appsecret: Optional[str] = None,
+        authorizer_appid: Optional[str] = None,
+        access_token: Optional[str] = None
+    ):
+        """
+        初始化API
+        
+        Args:
+            component_appid: 第三方平台AppID
+            component_appsecret: 第三方平台密钥
+            authorizer_appid: 授权小程序AppID
+            access_token: 直接使用的access_token（如已获取）
+        """
+        self.component_appid = component_appid or os.getenv("COMPONENT_APPID")
+        self.component_appsecret = component_appsecret or os.getenv("COMPONENT_APPSECRET")
+        self.authorizer_appid = authorizer_appid or os.getenv("AUTHORIZER_APPID")
+        self._access_token = access_token or os.getenv("ACCESS_TOKEN")
+        self._token_expires_at = 0
+        
+        self.client = httpx.Client(timeout=30.0)
+    
+    @property
+    def access_token(self) -> str:
+        """获取access_token，如果过期则刷新"""
+        if self._access_token and time.time() < self._token_expires_at:
+            return self._access_token
+        
+        # 如果没有配置刷新token的信息，直接返回现有token
+        if not self.component_appid:
+            return self._access_token or ""
+        
+        # TODO: 实现token刷新逻辑
+        return self._access_token or ""
+    
+    def set_access_token(self, token: str, expires_in: int = 7200):
+        """手动设置access_token"""
+        self._access_token = token
+        self._token_expires_at = time.time() + expires_in - 300  # 提前5分钟过期
+    
+    def _request(
+        self,
+        method: str,
+        path: str,
+        params: Optional[Dict] = None,
+        json_data: Optional[Dict] = None,
+        **kwargs
+    ) -> Dict[str, Any]:
+        """发起API请求"""
+        url = f"{self.BASE_URL}{path}"
+        
+        # 添加access_token
+        if params is None:
+            params = {}
+        if "access_token" not in params:
+            params["access_token"] = self.access_token
+        
+        if method.upper() == "GET":
+            resp = self.client.get(url, params=params, **kwargs)
+        else:
+            resp = self.client.post(url, params=params, json=json_data, **kwargs)
+        
+        # 解析响应
+        try:
+            result = resp.json()
+        except json.JSONDecodeError:
+            # 可能是二进制数据（如图片）
+            return {"_binary": resp.content}
+        
+        # 检查错误
+        if result.get("errcode", 0) != 0:
+            raise APIError(result.get("errcode"), result.get("errmsg", "Unknown error"))
+        
+        return result
+    
+    # ==================== 基础信息 ====================
+    
+    def get_basic_info(self) -> MiniProgramInfo:
+        """获取小程序基础信息"""
+        result = self._request("POST", "/cgi-bin/account/getaccountbasicinfo")
+        return MiniProgramInfo(
+            appid=result.get("appid", ""),
+            nickname=result.get("nickname", ""),
+            head_image_url=result.get("head_image_url", ""),
+            signature=result.get("signature", ""),
+            principal_name=result.get("principal_name", ""),
+            realname_status=result.get("realname_status", 0)
+        )
+    
+    def modify_signature(self, signature: str) -> bool:
+        """修改简介（4-120字）"""
+        self._request("POST", "/cgi-bin/account/modifysignature", json_data={
+            "signature": signature
+        })
+        return True
+    
+    # ==================== 域名配置 ====================
+    
+    def get_domain(self) -> Dict[str, List[str]]:
+        """获取服务器域名配置"""
+        result = self._request("POST", "/wxa/modify_domain", json_data={
+            "action": "get"
+        })
+        return {
+            "requestdomain": result.get("requestdomain", []),
+            "wsrequestdomain": result.get("wsrequestdomain", []),
+            "uploaddomain": result.get("uploaddomain", []),
+            "downloaddomain": result.get("downloaddomain", [])
+        }
+    
+    def set_domain(
+        self,
+        requestdomain: Optional[List[str]] = None,
+        wsrequestdomain: Optional[List[str]] = None,
+        uploaddomain: Optional[List[str]] = None,
+        downloaddomain: Optional[List[str]] = None
+    ) -> bool:
+        """设置服务器域名"""
+        data = {"action": "set"}
+        if requestdomain:
+            data["requestdomain"] = requestdomain
+        if wsrequestdomain:
+            data["wsrequestdomain"] = wsrequestdomain
+        if uploaddomain:
+            data["uploaddomain"] = uploaddomain
+        if downloaddomain:
+            data["downloaddomain"] = downloaddomain
+        
+        self._request("POST", "/wxa/modify_domain", json_data=data)
+        return True
+    
+    def get_webview_domain(self) -> List[str]:
+        """获取业务域名"""
+        result = self._request("POST", "/wxa/setwebviewdomain", json_data={
+            "action": "get"
+        })
+        return result.get("webviewdomain", [])
+    
+    def set_webview_domain(self, webviewdomain: List[str]) -> bool:
+        """设置业务域名"""
+        self._request("POST", "/wxa/setwebviewdomain", json_data={
+            "action": "set",
+            "webviewdomain": webviewdomain
+        })
+        return True
+    
+    # ==================== 隐私协议 ====================
+    
+    def get_privacy_setting(self, privacy_ver: int = 2) -> Dict[str, Any]:
+        """获取隐私协议设置"""
+        result = self._request("POST", "/cgi-bin/component/getprivacysetting", json_data={
+            "privacy_ver": privacy_ver
+        })
+        return result
+    
+    def set_privacy_setting(
+        self,
+        setting_list: List[Dict[str, str]],
+        contact_email: Optional[str] = None,
+        contact_phone: Optional[str] = None,
+        notice_method: str = "弹窗提示"
+    ) -> bool:
+        """
+        设置隐私协议
+        
+        Args:
+            setting_list: 隐私配置列表，如 [{"privacy_key": "UserInfo", "privacy_text": "用于展示头像"}]
+            contact_email: 联系邮箱
+            contact_phone: 联系电话
+            notice_method: 告知方式
+        """
+        data = {
+            "privacy_ver": 2,
+            "setting_list": setting_list
+        }
+        
+        owner_setting = {"notice_method": notice_method}
+        if contact_email:
+            owner_setting["contact_email"] = contact_email
+        if contact_phone:
+            owner_setting["contact_phone"] = contact_phone
+        data["owner_setting"] = owner_setting
+        
+        self._request("POST", "/cgi-bin/component/setprivacysetting", json_data=data)
+        return True
+    
+    # ==================== 类目管理 ====================
+    
+    def get_all_categories(self) -> List[Dict]:
+        """获取可选类目列表"""
+        result = self._request("GET", "/cgi-bin/wxopen/getallcategories")
+        return result.get("categories_list", {}).get("categories", [])
+    
+    def get_category(self) -> List[Dict]:
+        """获取已设置的类目"""
+        result = self._request("GET", "/cgi-bin/wxopen/getcategory")
+        return result.get("categories", [])
+    
+    def add_category(self, categories: List[Dict]) -> bool:
+        """
+        添加类目
+        
+        Args:
+            categories: 类目列表，如 [{"first": 1, "second": 2}]
+        """
+        self._request("POST", "/cgi-bin/wxopen/addcategory", json_data={
+            "categories": categories
+        })
+        return True
+    
+    def delete_category(self, first: int, second: int) -> bool:
+        """删除类目"""
+        self._request("POST", "/cgi-bin/wxopen/deletecategory", json_data={
+            "first": first,
+            "second": second
+        })
+        return True
+    
+    # ==================== 代码管理 ====================
+    
+    def commit_code(
+        self,
+        template_id: int,
+        user_version: str,
+        user_desc: str,
+        ext_json: Optional[str] = None
+    ) -> bool:
+        """
+        上传代码
+        
+        Args:
+            template_id: 代码模板ID
+            user_version: 版本号
+            user_desc: 版本描述
+            ext_json: 扩展配置JSON字符串
+        """
+        data = {
+            "template_id": template_id,
+            "user_version": user_version,
+            "user_desc": user_desc
+        }
+        if ext_json:
+            data["ext_json"] = ext_json
+        
+        self._request("POST", "/wxa/commit", json_data=data)
+        return True
+    
+    def get_page(self) -> List[str]:
+        """获取已上传代码的页面列表"""
+        result = self._request("GET", "/wxa/get_page")
+        return result.get("page_list", [])
+    
+    def get_qrcode(self, path: Optional[str] = None) -> bytes:
+        """
+        获取体验版二维码
+        
+        Args:
+            path: 页面路径，如 "pages/index/index"
+        
+        Returns:
+            二维码图片二进制数据
+        """
+        params = {"access_token": self.access_token}
+        if path:
+            params["path"] = path
+        
+        resp = self.client.get(f"{self.BASE_URL}/wxa/get_qrcode", params=params)
+        return resp.content
+    
+    # ==================== 审核管理 ====================
+    
+    def submit_audit(
+        self,
+        item_list: Optional[List[Dict]] = None,
+        version_desc: Optional[str] = None,
+        feedback_info: Optional[str] = None
+    ) -> int:
+        """
+        提交审核
+        
+        Args:
+            item_list: 页面审核信息列表
+            version_desc: 版本说明
+            feedback_info: 反馈内容
+        
+        Returns:
+            审核单ID
+        """
+        data = {}
+        if item_list:
+            data["item_list"] = item_list
+        if version_desc:
+            data["version_desc"] = version_desc
+        if feedback_info:
+            data["feedback_info"] = feedback_info
+        
+        result = self._request("POST", "/wxa/submit_audit", json_data=data)
+        return result.get("auditid", 0)
+    
+    def get_audit_status(self, auditid: int) -> AuditStatus:
+        """查询审核状态"""
+        result = self._request("POST", "/wxa/get_auditstatus", json_data={
+            "auditid": auditid
+        })
+        return AuditStatus(
+            auditid=auditid,
+            status=result.get("status", -1),
+            reason=result.get("reason"),
+            screenshot=result.get("screenshot")
+        )
+    
+    def get_latest_audit_status(self) -> AuditStatus:
+        """查询最新审核状态"""
+        result = self._request("GET", "/wxa/get_latest_auditstatus")
+        return AuditStatus(
+            auditid=result.get("auditid", 0),
+            status=result.get("status", -1),
+            reason=result.get("reason"),
+            screenshot=result.get("screenshot")
+        )
+    
+    def undo_code_audit(self) -> bool:
+        """撤回审核（每天限1次）"""
+        self._request("GET", "/wxa/undocodeaudit")
+        return True
+    
+    # ==================== 发布管理 ====================
+    
+    def release(self) -> bool:
+        """发布已审核通过的版本"""
+        self._request("POST", "/wxa/release", json_data={})
+        return True
+    
+    def revert_code_release(self) -> bool:
+        """版本回退（只能回退到上一版本）"""
+        self._request("GET", "/wxa/revertcoderelease")
+        return True
+    
+    def get_revert_history(self) -> List[Dict]:
+        """获取可回退版本历史"""
+        result = self._request("GET", "/wxa/revertcoderelease", params={
+            "action": "get_history_version"
+        })
+        return result.get("version_list", [])
+    
+    def gray_release(self, gray_percentage: int) -> bool:
+        """
+        分阶段发布
+        
+        Args:
+            gray_percentage: 灰度比例 1-100
+        """
+        self._request("POST", "/wxa/grayrelease", json_data={
+            "gray_percentage": gray_percentage
+        })
+        return True
+    
+    # ==================== 小程序码 ====================
+    
+    def get_wxacode(
+        self,
+        path: str,
+        width: int = 430,
+        auto_color: bool = False,
+        line_color: Optional[Dict[str, int]] = None,
+        is_hyaline: bool = False
+    ) -> bytes:
+        """
+        获取小程序码（有限制，每个path最多10万个）
+        
+        Args:
+            path: 页面路径，如 "pages/index/index?id=123"
+            width: 宽度 280-1280
+            auto_color: 自动配置线条颜色
+            line_color: 线条颜色 {"r": 0, "g": 0, "b": 0}
+            is_hyaline: 是否透明背景
+        
+        Returns:
+            二维码图片二进制数据
+        """
+        data = {
+            "path": path,
+            "width": width,
+            "auto_color": auto_color,
+            "is_hyaline": is_hyaline
+        }
+        if line_color:
+            data["line_color"] = line_color
+        
+        resp = self.client.post(
+            f"{self.BASE_URL}/wxa/getwxacode",
+            params={"access_token": self.access_token},
+            json=data
+        )
+        return resp.content
+    
+    def get_wxacode_unlimit(
+        self,
+        scene: str,
+        page: Optional[str] = None,
+        width: int = 430,
+        auto_color: bool = False,
+        line_color: Optional[Dict[str, int]] = None,
+        is_hyaline: bool = False
+    ) -> bytes:
+        """
+        获取无限小程序码（推荐）
+        
+        Args:
+            scene: 场景值，最长32字符，如 "user_id=123&from=share"
+            page: 页面路径，必须是已发布的页面
+            width: 宽度 280-1280
+            auto_color: 自动配置线条颜色
+            line_color: 线条颜色 {"r": 0, "g": 0, "b": 0}
+            is_hyaline: 是否透明背景
+        
+        Returns:
+            二维码图片二进制数据
+        """
+        data = {
+            "scene": scene,
+            "width": width,
+            "auto_color": auto_color,
+            "is_hyaline": is_hyaline
+        }
+        if page:
+            data["page"] = page
+        if line_color:
+            data["line_color"] = line_color
+        
+        resp = self.client.post(
+            f"{self.BASE_URL}/wxa/getwxacodeunlimit",
+            params={"access_token": self.access_token},
+            json=data
+        )
+        return resp.content
+    
+    def gen_short_link(
+        self,
+        page_url: str,
+        page_title: str,
+        is_permanent: bool = False
+    ) -> str:
+        """
+        生成小程序短链接
+        
+        Args:
+            page_url: 页面路径，如 "pages/index/index?id=123"
+            page_title: 页面标题
+            is_permanent: 是否永久有效
+        
+        Returns:
+            短链接
+        """
+        result = self._request("POST", "/wxa/genwxashortlink", json_data={
+            "page_url": page_url,
+            "page_title": page_title,
+            "is_permanent": is_permanent
+        })
+        return result.get("link", "")
+    
+    # ==================== 数据分析 ====================
+    
+    def get_daily_visit_trend(self, begin_date: str, end_date: str) -> List[Dict]:
+        """
+        获取每日访问趋势
+        
+        Args:
+            begin_date: 开始日期 YYYYMMDD
+            end_date: 结束日期 YYYYMMDD
+        """
+        result = self._request(
+            "POST",
+            "/datacube/getweanalysisappiddailyvisittrend",
+            json_data={"begin_date": begin_date, "end_date": end_date}
+        )
+        return result.get("list", [])
+    
+    def get_user_portrait(self, begin_date: str, end_date: str) -> Dict:
+        """
+        获取用户画像
+        
+        Args:
+            begin_date: 开始日期 YYYYMMDD
+            end_date: 结束日期 YYYYMMDD
+        """
+        result = self._request(
+            "POST",
+            "/datacube/getweanalysisappiduserportrait",
+            json_data={"begin_date": begin_date, "end_date": end_date}
+        )
+        return result
+    
+    # ==================== API配额 ====================
+    
+    def get_api_quota(self, cgi_path: str) -> Dict:
+        """
+        查询接口调用额度
+        
+        Args:
+            cgi_path: 接口路径，如 "/wxa/getwxacode"
+        """
+        result = self._request("POST", "/cgi-bin/openapi/quota/get", json_data={
+            "cgi_path": cgi_path
+        })
+        return result.get("quota", {})
+    
+    def clear_quota(self, appid: Optional[str] = None) -> bool:
+        """重置接口调用次数（每月限10次）"""
+        self._request("POST", "/cgi-bin/clear_quota", json_data={
+            "appid": appid or self.authorizer_appid
+        })
+        return True
+    
+    def close(self):
+        """关闭连接"""
+        self.client.close()
+    
+    def __enter__(self):
+        return self
+    
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        self.close()
+
+
+class APIError(Exception):
+    """API错误"""
+    
+    ERROR_CODES = {
+        -1: "系统繁忙",
+        40001: "access_token无效",
+        40002: "grant_type不正确",
+        40013: "appid不正确",
+        40029: "code无效",
+        40125: "appsecret不正确",
+        41002: "缺少appid参数",
+        41004: "缺少appsecret参数",
+        42001: "access_token过期",
+        42007: "refresh_token过期",
+        45009: "调用超过限制",
+        61039: "代码检测任务未完成，请稍后再试",
+        85006: "标签格式错误",
+        85007: "页面路径错误",
+        85009: "已有审核版本，请先撤回",
+        85010: "版本输入错误",
+        85011: "当前版本不能回退",
+        85012: "无效的版本",
+        85015: "该账号已有发布中的版本",
+        85019: "没有审核版本",
+        85020: "审核状态异常",
+        85064: "找不到模板",
+        85085: "该小程序不能被操作",
+        85086: "小程序没有绑定任何类目",
+        87013: "每天只能撤回1次审核",
+        89020: "该小程序尚未认证",
+        89248: "隐私协议内容不完整",
+    }
+    
+    def __init__(self, code: int, message: str):
+        self.code = code
+        self.message = message
+        super().__init__(f"[{code}] {self.ERROR_CODES.get(code, message)}")
+
+
+# 便捷函数
+def create_api_from_env() -> MiniProgramAPI:
+    """从环境变量创建API实例"""
+    return MiniProgramAPI()
+
+
+if __name__ == "__main__":
+    # 测试
+    api = create_api_from_env()
+    print("API初始化成功")

开发文档/小程序管理/scripts/mp_deploy.py

@@ -0,0 +1,725 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+小程序一键部署工具 v2.0
+
+功能：
+- 多小程序管理
+- 一键部署上线
+- 自动认证提交
+- 认证状态检查
+- 材料有效性验证
+
+使用方法:
+    python mp_deploy.py list                    # 列出所有小程序
+    python mp_deploy.py add                     # 添加新小程序
+    python mp_deploy.py deploy <app_id>         # 一键部署
+    python mp_deploy.py cert <app_id>           # 提交认证
+    python mp_deploy.py cert-status <app_id>    # 查询认证状态
+    python mp_deploy.py upload <app_id>         # 上传代码
+    python mp_deploy.py release <app_id>        # 发布上线
+"""
+
+import os
+import sys
+import json
+import subprocess
+import argparse
+from datetime import datetime
+from pathlib import Path
+from typing import Optional, Dict, List, Any
+from dataclasses import dataclass, asdict
+
+# 配置文件路径
+CONFIG_FILE = Path(__file__).parent / "apps_config.json"
+
+
+@dataclass
+class AppConfig:
+    """小程序配置"""
+    id: str
+    name: str
+    appid: str
+    project_path: str
+    private_key_path: str = ""
+    api_domain: str = ""
+    description: str = ""
+    certification: Dict = None
+    
+    def __post_init__(self):
+        if self.certification is None:
+            self.certification = {
+                "status": "unknown",
+                "enterprise_name": "",
+                "license_number": "",
+                "legal_persona_name": "",
+                "legal_persona_wechat": "",
+                "component_phone": ""
+            }
+
+
+class ConfigManager:
+    """配置管理器"""
+    
+    def __init__(self, config_file: Path = CONFIG_FILE):
+        self.config_file = config_file
+        self.config = self._load_config()
+    
+    def _load_config(self) -> Dict:
+        """加载配置"""
+        if self.config_file.exists():
+            with open(self.config_file, 'r', encoding='utf-8') as f:
+                return json.load(f)
+        return {"apps": [], "certification_materials": {}, "third_party_platform": {}}
+    
+    def _save_config(self):
+        """保存配置"""
+        with open(self.config_file, 'w', encoding='utf-8') as f:
+            json.dump(self.config, f, ensure_ascii=False, indent=2)
+    
+    def get_apps(self) -> List[AppConfig]:
+        """获取所有小程序"""
+        return [AppConfig(**app) for app in self.config.get("apps", [])]
+    
+    def get_app(self, app_id: str) -> Optional[AppConfig]:
+        """获取指定小程序"""
+        for app in self.config.get("apps", []):
+            if app["id"] == app_id or app["appid"] == app_id:
+                return AppConfig(**app)
+        return None
+    
+    def add_app(self, app: AppConfig):
+        """添加小程序"""
+        apps = self.config.get("apps", [])
+        # 检查是否已存在
+        for i, existing in enumerate(apps):
+            if existing["id"] == app.id:
+                apps[i] = asdict(app)
+                self.config["apps"] = apps
+                self._save_config()
+                return
+        apps.append(asdict(app))
+        self.config["apps"] = apps
+        self._save_config()
+    
+    def update_app(self, app_id: str, updates: Dict):
+        """更新小程序配置"""
+        apps = self.config.get("apps", [])
+        for i, app in enumerate(apps):
+            if app["id"] == app_id:
+                apps[i].update(updates)
+                self.config["apps"] = apps
+                self._save_config()
+                return True
+        return False
+    
+    def get_cert_materials(self) -> Dict:
+        """获取通用认证材料"""
+        return self.config.get("certification_materials", {})
+    
+    def update_cert_materials(self, materials: Dict):
+        """更新认证材料"""
+        self.config["certification_materials"] = materials
+        self._save_config()
+
+
+class MiniProgramDeployer:
+    """小程序部署器"""
+    
+    # 微信开发者工具CLI路径
+    WX_CLI = "/Applications/wechatwebdevtools.app/Contents/MacOS/cli"
+    
+    def __init__(self):
+        self.config = ConfigManager()
+    
+    def _check_wx_cli(self) -> bool:
+        """检查微信开发者工具是否安装"""
+        return os.path.exists(self.WX_CLI)
+    
+    def _run_cli(self, *args, project_path: str = None) -> tuple:
+        """运行CLI命令"""
+        cmd = [self.WX_CLI] + list(args)
+        if project_path:
+            cmd.extend(["--project", project_path])
+        
+        try:
+            result = subprocess.run(cmd, capture_output=True, text=True, timeout=120)
+            return result.returncode == 0, result.stdout + result.stderr
+        except subprocess.TimeoutExpired:
+            return False, "命令执行超时"
+        except Exception as e:
+            return False, str(e)
+    
+    def list_apps(self):
+        """列出所有小程序"""
+        apps = self.config.get_apps()
+        
+        if not apps:
+            print("\n📭 暂无配置的小程序")
+            print("   运行 'python mp_deploy.py add' 添加小程序")
+            return
+        
+        print("\n" + "=" * 60)
+        print("  📱 小程序列表")
+        print("=" * 60)
+        
+        for i, app in enumerate(apps, 1):
+            cert_status = app.certification.get("status", "unknown")
+            status_icon = {
+                "verified": "✅",
+                "pending": "⏳",
+                "rejected": "❌",
+                "expired": "⚠️",
+                "unknown": "❓"
+            }.get(cert_status, "❓")
+            
+            print(f"\n  [{i}] {app.name}")
+            print(f"      ID: {app.id}")
+            print(f"      AppID: {app.appid}")
+            print(f"      认证: {status_icon} {cert_status}")
+            print(f"      路径: {app.project_path}")
+        
+        print("\n" + "-" * 60)
+        print("  使用方法:")
+        print("    python mp_deploy.py deploy <id>   一键部署")
+        print("    python mp_deploy.py cert <id>     提交认证")
+        print("=" * 60 + "\n")
+    
+    def add_app(self):
+        """交互式添加小程序"""
+        print("\n" + "=" * 50)
+        print("  ➕ 添加新小程序")
+        print("=" * 50 + "\n")
+        
+        # 收集信息
+        app_id = input("小程序ID（用于标识，如 my-app）: ").strip()
+        if not app_id:
+            print("❌ ID不能为空")
+            return
+        
+        name = input("小程序名称: ").strip()
+        appid = input("AppID（如 wx1234567890）: ").strip()
+        project_path = input("项目路径: ").strip()
+        
+        if not os.path.exists(project_path):
+            print(f"⚠️ 警告：路径不存在 {project_path}")
+        
+        api_domain = input("API域名（可选）: ").strip()
+        description = input("描述（可选）: ").strip()
+        
+        # 认证信息
+        print("\n📋 认证信息（可稍后配置）:")
+        enterprise_name = input("企业名称: ").strip()
+        
+        app = AppConfig(
+            id=app_id,
+            name=name,
+            appid=appid,
+            project_path=project_path,
+            api_domain=api_domain,
+            description=description,
+            certification={
+                "status": "unknown",
+                "enterprise_name": enterprise_name,
+                "license_number": "",
+                "legal_persona_name": "",
+                "legal_persona_wechat": "",
+                "component_phone": "15880802661"
+            }
+        )
+        
+        self.config.add_app(app)
+        print(f"\n✅ 小程序 [{name}] 添加成功！")
+    
+    def deploy(self, app_id: str, skip_cert_check: bool = False):
+        """一键部署流程"""
+        app = self.config.get_app(app_id)
+        if not app:
+            print(f"❌ 未找到小程序: {app_id}")
+            print("   运行 'python mp_deploy.py list' 查看所有小程序")
+            return False
+        
+        print("\n" + "=" * 60)
+        print(f"  🚀 一键部署: {app.name}")
+        print("=" * 60)
+        
+        steps = [
+            ("检查环境", self._step_check_env),
+            ("检查认证状态", lambda a: self._step_check_cert(a, skip_cert_check)),
+            ("编译项目", self._step_build),
+            ("上传代码", self._step_upload),
+            ("提交审核", self._step_submit_audit),
+        ]
+        
+        for step_name, step_func in steps:
+            print(f"\n📍 步骤: {step_name}")
+            print("-" * 40)
+            
+            success = step_func(app)
+            if not success:
+                print(f"\n❌ 部署中断于: {step_name}")
+                return False
+        
+        print("\n" + "=" * 60)
+        print("  🎉 部署完成！")
+        print("=" * 60)
+        print(f"\n  下一步操作:")
+        print(f"    1. 等待审核（通常1-3个工作日）")
+        print(f"    2. 审核通过后运行: python mp_deploy.py release {app_id}")
+        print(f"    3. 查看状态: python mp_deploy.py status {app_id}")
+        
+        return True
+    
+    def _step_check_env(self, app: AppConfig) -> bool:
+        """检查环境"""
+        # 检查微信开发者工具
+        if not self._check_wx_cli():
+            print("❌ 未找到微信开发者工具")
+            print("   请安装: https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html")
+            return False
+        print("✅ 微信开发者工具已安装")
+        
+        # 检查项目路径
+        if not os.path.exists(app.project_path):
+            print(f"❌ 项目路径不存在: {app.project_path}")
+            return False
+        print(f"✅ 项目路径存在")
+        
+        # 检查project.config.json
+        config_file = os.path.join(app.project_path, "project.config.json")
+        if os.path.exists(config_file):
+            with open(config_file, 'r') as f:
+                config = json.load(f)
+                if config.get("appid") != app.appid:
+                    print(f"⚠️ 警告: project.config.json中的AppID与配置不一致")
+                    print(f"   配置: {app.appid}")
+                    print(f"   文件: {config.get('appid')}")
+        
+        print("✅ 环境检查通过")
+        return True
+    
+    def _step_check_cert(self, app: AppConfig, skip: bool = False) -> bool:
+        """检查认证状态"""
+        if skip:
+            print("⏭️ 跳过认证检查")
+            return True
+        
+        cert_status = app.certification.get("status", "unknown")
+        
+        if cert_status == "verified":
+            print("✅ 已完成微信认证")
+            return True
+        
+        if cert_status == "pending":
+            print("⏳ 认证审核中")
+            print("   可选择:")
+            print("   1. 继续部署（未认证可上传，但无法发布）")
+            print("   2. 等待认证完成")
+            
+            choice = input("\n是否继续? (y/n): ").strip().lower()
+            return choice == 'y'
+        
+        if cert_status == "expired":
+            print("⚠️ 认证已过期，需要重新认证")
+            print("   运行: python mp_deploy.py cert " + app.id)
+            
+            choice = input("\n是否继续部署? (y/n): ").strip().lower()
+            return choice == 'y'
+        
+        # 未认证或未知状态
+        print("⚠️ 未完成微信认证")
+        print("   未认证的小程序可以上传代码，但无法发布上线")
+        print("   运行: python mp_deploy.py cert " + app.id + " 提交认证")
+        
+        choice = input("\n是否继续? (y/n): ").strip().lower()
+        return choice == 'y'
+    
+    def _step_build(self, app: AppConfig) -> bool:
+        """编译项目"""
+        print("📦 编译项目...")
+        
+        # 使用CLI编译
+        success, output = self._run_cli("build-npm", project_path=app.project_path)
+        
+        if not success:
+            # build-npm可能失败（如果没有npm依赖），不算错误
+            print("ℹ️ 编译完成（无npm依赖或编译失败，继续...）")
+        else:
+            print("✅ 编译成功")
+        
+        return True
+    
+    def _step_upload(self, app: AppConfig) -> bool:
+        """上传代码"""
+        # 获取版本号
+        version = datetime.now().strftime("%Y.%m.%d.%H%M")
+        desc = f"自动部署 - {datetime.now().strftime('%Y-%m-%d %H:%M')}"
+        
+        print(f"📤 上传代码...")
+        print(f"   版本: {version}")
+        print(f"   描述: {desc}")
+        
+        success, output = self._run_cli(
+            "upload",
+            "--version", version,
+            "--desc", desc,
+            project_path=app.project_path
+        )
+        
+        if not success:
+            print(f"❌ 上传失败")
+            print(f"   {output}")
+            
+            # 常见错误处理
+            if "login" in output.lower():
+                print("\n💡 提示: 请在微信开发者工具中登录后重试")
+            return False
+        
+        print("✅ 上传成功")
+        return True
+    
+    def _step_submit_audit(self, app: AppConfig) -> bool:
+        """提交审核"""
+        print("📝 提交审核...")
+        
+        # 使用CLI提交审核
+        success, output = self._run_cli(
+            "submit-audit",
+            project_path=app.project_path
+        )
+        
+        if not success:
+            if "未认证" in output or "认证" in output:
+                print("⚠️ 提交审核失败：未完成微信认证")
+                print("   代码已上传，但需要完成认证后才能提交审核")
+                print(f"   运行: python mp_deploy.py cert {app.id}")
+                return True  # 不算失败，只是需要认证
+            
+            print(f"❌ 提交审核失败")
+            print(f"   {output}")
+            return False
+        
+        print("✅ 审核已提交")
+        return True
+    
+    def submit_certification(self, app_id: str):
+        """提交企业认证"""
+        app = self.config.get_app(app_id)
+        if not app:
+            print(f"❌ 未找到小程序: {app_id}")
+            return
+        
+        print("\n" + "=" * 60)
+        print(f"  📋 提交认证: {app.name}")
+        print("=" * 60)
+        
+        # 获取通用认证材料
+        materials = self.config.get_cert_materials()
+        cert = app.certification
+        
+        # 合并材料（小程序配置优先）
+        enterprise_name = cert.get("enterprise_name") or materials.get("enterprise_name", "")
+        
+        print(f"\n📌 认证信息:")
+        print(f"   小程序: {app.name} ({app.appid})")
+        print(f"   企业名称: {enterprise_name}")
+        
+        # 检查必要材料
+        missing = []
+        if not enterprise_name:
+            missing.append("企业名称")
+        if not materials.get("license_number"):
+            missing.append("营业执照号")
+        if not materials.get("legal_persona_name"):
+            missing.append("法人姓名")
+        
+        if missing:
+            print(f"\n⚠️ 缺少认证材料:")
+            for m in missing:
+                print(f"   - {m}")
+            
+            print(f"\n请先完善认证材料:")
+            print(f"   编辑: {self.config.config_file}")
+            print(f"   或运行: python mp_deploy.py cert-config")
+            return
+        
+        print("\n" + "-" * 40)
+        print("📋 认证方式说明:")
+        print("-" * 40)
+        print("""
+  【方式一】微信后台手动认证（推荐）
+  
+  1. 登录小程序后台: https://mp.weixin.qq.com/
+  2. 设置 → 基本设置 → 微信认证
+  3. 选择"企业"类型
+  4. 填写企业信息、上传营业执照
+  5. 法人微信扫码验证
+  6. 支付认证费用（300元/年）
+  7. 等待审核（1-5个工作日）
+
+  【方式二】通过第三方平台代认证（需开发）
+  
+  如果你有第三方平台资质，可以通过API代认证：
+  1. 配置第三方平台凭证
+  2. 获取授权
+  3. 调用认证API
+  
+  API接口: POST /wxa/sec/wxaauth
+        """)
+        
+        print("\n" + "-" * 40)
+        print("📝 认证材料清单:")
+        print("-" * 40)
+        print("""
+  必需材料:
+  ☐ 企业营业执照（扫描件或照片）
+  ☐ 法人身份证（正反面）
+  ☐ 法人微信号（用于扫码验证）
+  ☐ 联系人手机号
+  ☐ 认证费用 300元
+  
+  认证有效期: 1年
+  到期后需重新认证（年审）
+        """)
+        
+        # 更新状态为待认证
+        self.config.update_app(app_id, {
+            "certification": {
+                **cert,
+                "status": "pending",
+                "submit_time": datetime.now().isoformat()
+            }
+        })
+        
+        print("\n✅ 已标记为待认证状态")
+        print("   完成认证后运行: python mp_deploy.py cert-done " + app_id)
+    
+    def check_cert_status(self, app_id: str):
+        """检查认证状态"""
+        app = self.config.get_app(app_id)
+        if not app:
+            print(f"❌ 未找到小程序: {app_id}")
+            return
+        
+        print("\n" + "=" * 60)
+        print(f"  🔍 认证状态: {app.name}")
+        print("=" * 60)
+        
+        cert = app.certification
+        status = cert.get("status", "unknown")
+        
+        status_info = {
+            "verified": ("✅ 已认证", "认证有效"),
+            "pending": ("⏳ 审核中", "请等待审核结果"),
+            "rejected": ("❌ 被拒绝", "请查看拒绝原因并重新提交"),
+            "expired": ("⚠️ 已过期", "需要重新认证（年审）"),
+            "unknown": ("❓ 未知", "请在微信后台确认状态")
+        }
+        
+        icon, desc = status_info.get(status, ("❓", "未知状态"))
+        
+        print(f"\n📌 当前状态: {icon}")
+        print(f"   说明: {desc}")
+        print(f"   企业: {cert.get('enterprise_name', '未填写')}")
+        
+        if cert.get("submit_time"):
+            print(f"   提交时间: {cert.get('submit_time')}")
+        
+        if cert.get("verify_time"):
+            print(f"   认证时间: {cert.get('verify_time')}")
+        
+        if cert.get("expire_time"):
+            print(f"   到期时间: {cert.get('expire_time')}")
+        
+        # 提示下一步操作
+        print("\n" + "-" * 40)
+        if status == "unknown" or status == "rejected":
+            print("👉 下一步: python mp_deploy.py cert " + app_id)
+        elif status == "pending":
+            print("👉 等待审核，通常1-5个工作日")
+            print("   审核通过后运行: python mp_deploy.py cert-done " + app_id)
+        elif status == "verified":
+            print("👉 可以发布小程序: python mp_deploy.py deploy " + app_id)
+        elif status == "expired":
+            print("👉 需要重新认证: python mp_deploy.py cert " + app_id)
+    
+    def mark_cert_done(self, app_id: str):
+        """标记认证完成"""
+        app = self.config.get_app(app_id)
+        if not app:
+            print(f"❌ 未找到小程序: {app_id}")
+            return
+        
+        cert = app.certification
+        self.config.update_app(app_id, {
+            "certification": {
+                **cert,
+                "status": "verified",
+                "verify_time": datetime.now().isoformat(),
+                "expire_time": datetime.now().replace(year=datetime.now().year + 1).isoformat()
+            }
+        })
+        
+        print(f"✅ 已标记 [{app.name}] 认证完成")
+        print(f"   有效期至: {datetime.now().year + 1}年")
+    
+    def release(self, app_id: str):
+        """发布上线"""
+        app = self.config.get_app(app_id)
+        if not app:
+            print(f"❌ 未找到小程序: {app_id}")
+            return
+        
+        print("\n" + "=" * 60)
+        print(f"  🎉 发布上线: {app.name}")
+        print("=" * 60)
+        
+        # 检查认证状态
+        if app.certification.get("status") != "verified":
+            print("\n⚠️ 警告: 小程序未完成认证")
+            print("   未认证的小程序无法发布上线")
+            
+            choice = input("\n是否继续尝试? (y/n): ").strip().lower()
+            if choice != 'y':
+                return
+        
+        print("\n📦 正在发布...")
+        
+        # 尝试使用CLI发布
+        success, output = self._run_cli("release", project_path=app.project_path)
+        
+        if success:
+            print("\n🎉 发布成功！小程序已上线")
+        else:
+            print(f"\n发布结果: {output}")
+            
+            if "认证" in output:
+                print("\n💡 提示: 请先完成微信认证")
+                print(f"   运行: python mp_deploy.py cert {app_id}")
+            else:
+                print("\n💡 提示: 请在微信后台手动发布")
+                print("   1. 登录 https://mp.weixin.qq.com/")
+                print("   2. 版本管理 → 审核版本 → 发布")
+    
+    def quick_upload(self, app_id: str, version: str = None, desc: str = None):
+        """快速上传代码"""
+        app = self.config.get_app(app_id)
+        if not app:
+            print(f"❌ 未找到小程序: {app_id}")
+            return
+        
+        if not version:
+            version = datetime.now().strftime("%Y.%m.%d.%H%M")
+        if not desc:
+            desc = f"快速上传 - {datetime.now().strftime('%Y-%m-%d %H:%M')}"
+        
+        print(f"\n📤 上传代码: {app.name}")
+        print(f"   版本: {version}")
+        print(f"   描述: {desc}")
+        
+        success, output = self._run_cli(
+            "upload",
+            "--version", version,
+            "--desc", desc,
+            project_path=app.project_path
+        )
+        
+        if success:
+            print("✅ 上传成功")
+        else:
+            print(f"❌ 上传失败: {output}")
+
+
+def print_header(title: str):
+    print("\n" + "=" * 50)
+    print(f"  {title}")
+    print("=" * 50)
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="小程序一键部署工具 v2.0",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+示例:
+  python mp_deploy.py list                    列出所有小程序
+  python mp_deploy.py add                     添加新小程序
+  python mp_deploy.py deploy soul-party       一键部署
+  python mp_deploy.py cert soul-party         提交认证
+  python mp_deploy.py cert-status soul-party  查询认证状态
+  python mp_deploy.py cert-done soul-party    标记认证完成
+  python mp_deploy.py upload soul-party       仅上传代码
+  python mp_deploy.py release soul-party      发布上线
+
+部署流程:
+  1. add         添加小程序配置
+  2. cert        提交企业认证（首次）
+  3. cert-done   认证通过后标记
+  4. deploy      一键部署（编译+上传+提审）
+  5. release     审核通过后发布
+"""
+    )
+    
+    subparsers = parser.add_subparsers(dest="command", help="子命令")
+    
+    # list
+    subparsers.add_parser("list", help="列出所有小程序")
+    
+    # add
+    subparsers.add_parser("add", help="添加新小程序")
+    
+    # deploy
+    deploy_parser = subparsers.add_parser("deploy", help="一键部署")
+    deploy_parser.add_argument("app_id", help="小程序ID")
+    deploy_parser.add_argument("--skip-cert", action="store_true", help="跳过认证检查")
+    
+    # cert
+    cert_parser = subparsers.add_parser("cert", help="提交认证")
+    cert_parser.add_argument("app_id", help="小程序ID")
+    
+    # cert-status
+    cert_status_parser = subparsers.add_parser("cert-status", help="查询认证状态")
+    cert_status_parser.add_argument("app_id", help="小程序ID")
+    
+    # cert-done
+    cert_done_parser = subparsers.add_parser("cert-done", help="标记认证完成")
+    cert_done_parser.add_argument("app_id", help="小程序ID")
+    
+    # upload
+    upload_parser = subparsers.add_parser("upload", help="上传代码")
+    upload_parser.add_argument("app_id", help="小程序ID")
+    upload_parser.add_argument("-v", "--version", help="版本号")
+    upload_parser.add_argument("-d", "--desc", help="版本描述")
+    
+    # release
+    release_parser = subparsers.add_parser("release", help="发布上线")
+    release_parser.add_argument("app_id", help="小程序ID")
+    
+    args = parser.parse_args()
+    
+    if not args.command:
+        parser.print_help()
+        return
+    
+    deployer = MiniProgramDeployer()
+    
+    commands = {
+        "list": lambda: deployer.list_apps(),
+        "add": lambda: deployer.add_app(),
+        "deploy": lambda: deployer.deploy(args.app_id, args.skip_cert if hasattr(args, 'skip_cert') else False),
+        "cert": lambda: deployer.submit_certification(args.app_id),
+        "cert-status": lambda: deployer.check_cert_status(args.app_id),
+        "cert-done": lambda: deployer.mark_cert_done(args.app_id),
+        "upload": lambda: deployer.quick_upload(args.app_id, getattr(args, 'version', None), getattr(args, 'desc', None)),
+        "release": lambda: deployer.release(args.app_id),
+    }
+    
+    cmd_func = commands.get(args.command)
+    if cmd_func:
+        cmd_func()
+    else:
+        parser.print_help()
+
+
+if __name__ == "__main__":
+    main()

开发文档/小程序管理/scripts/mp_full.py

@@ -0,0 +1,555 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+小程序全能管理工具 v3.0
+
+整合能力：
+- 微信开发者工具CLI
+- miniprogram-ci (npm官方工具)
+- 微信开放平台API
+- 多小程序管理
+- 自动化部署+提审
+- 汇总报告生成
+
+使用方法:
+    python mp_full.py report              # 生成汇总报告
+    python mp_full.py check <app_id>      # 检查项目问题
+    python mp_full.py auto <app_id>       # 全自动部署（上传+提审）
+    python mp_full.py batch-report        # 批量生成所有小程序报告
+"""
+
+import os
+import sys
+import json
+import subprocess
+import argparse
+from datetime import datetime
+from pathlib import Path
+from typing import Optional, Dict, List, Any
+from dataclasses import dataclass, asdict, field
+
+# 配置文件路径
+SCRIPT_DIR = Path(__file__).parent
+CONFIG_FILE = SCRIPT_DIR / "apps_config.json"
+REPORT_DIR = SCRIPT_DIR / "reports"
+
+
+@dataclass
+class CheckResult:
+    """检查结果"""
+    name: str
+    status: str  # ok, warning, error
+    message: str
+    fix_hint: str = ""
+
+
+@dataclass
+class AppReport:
+    """小程序报告"""
+    app_id: str
+    app_name: str
+    appid: str
+    check_time: str
+    checks: List[CheckResult] = field(default_factory=list)
+    summary: Dict = field(default_factory=dict)
+    
+    @property
+    def has_errors(self) -> bool:
+        return any(c.status == "error" for c in self.checks)
+    
+    @property
+    def has_warnings(self) -> bool:
+        return any(c.status == "warning" for c in self.checks)
+
+
+class MiniProgramManager:
+    """小程序全能管理器"""
+    
+    # 工具路径
+    WX_CLI = "/Applications/wechatwebdevtools.app/Contents/MacOS/cli"
+    
+    def __init__(self):
+        self.config = self._load_config()
+        REPORT_DIR.mkdir(exist_ok=True)
+    
+    def _load_config(self) -> Dict:
+        if CONFIG_FILE.exists():
+            with open(CONFIG_FILE, 'r', encoding='utf-8') as f:
+                return json.load(f)
+        return {"apps": []}
+    
+    def _save_config(self):
+        with open(CONFIG_FILE, 'w', encoding='utf-8') as f:
+            json.dump(self.config, f, ensure_ascii=False, indent=2)
+    
+    def get_app(self, app_id: str) -> Optional[Dict]:
+        for app in self.config.get("apps", []):
+            if app["id"] == app_id or app["appid"] == app_id:
+                return app
+        return None
+    
+    def _run_cmd(self, cmd: List[str], timeout: int = 120) -> tuple:
+        """运行命令"""
+        try:
+            result = subprocess.run(cmd, capture_output=True, text=True, timeout=timeout)
+            return result.returncode == 0, result.stdout + result.stderr
+        except subprocess.TimeoutExpired:
+            return False, "命令执行超时"
+        except Exception as e:
+            return False, str(e)
+    
+    def _check_tool(self, tool: str) -> bool:
+        """检查工具是否可用"""
+        success, _ = self._run_cmd(["which", tool], timeout=5)
+        return success
+    
+    # ==================== 检查功能 ====================
+    
+    def check_project(self, app_id: str) -> AppReport:
+        """检查项目问题"""
+        app = self.get_app(app_id)
+        if not app:
+            print(f"❌ 未找到小程序: {app_id}")
+            return None
+        
+        report = AppReport(
+            app_id=app["id"],
+            app_name=app["name"],
+            appid=app["appid"],
+            check_time=datetime.now().isoformat()
+        )
+        
+        project_path = app["project_path"]
+        
+        # 1. 检查项目路径
+        if os.path.exists(project_path):
+            report.checks.append(CheckResult("项目路径", "ok", f"路径存在: {project_path}"))
+        else:
+            report.checks.append(CheckResult("项目路径", "error", f"路径不存在: {project_path}", "请检查项目路径配置"))
+            return report  # 路径不存在，无法继续检查
+        
+        # 2. 检查project.config.json
+        config_file = os.path.join(project_path, "project.config.json")
+        if os.path.exists(config_file):
+            with open(config_file, 'r') as f:
+                config = json.load(f)
+            
+            if config.get("appid") == app["appid"]:
+                report.checks.append(CheckResult("AppID配置", "ok", f"AppID正确: {app['appid']}"))
+            else:
+                report.checks.append(CheckResult("AppID配置", "error", 
+                    f"AppID不匹配: 配置={app['appid']}, 文件={config.get('appid')}",
+                    "请修改project.config.json中的appid"))
+        else:
+            report.checks.append(CheckResult("项目配置", "error", "project.config.json不存在", "请确认这是有效的小程序项目"))
+        
+        # 3. 检查app.js
+        app_js = os.path.join(project_path, "app.js")
+        if os.path.exists(app_js):
+            with open(app_js, 'r') as f:
+                content = f.read()
+            
+            # 检查API域名
+            if "baseUrl" in content or "apiBase" in content:
+                if "https://" in content:
+                    report.checks.append(CheckResult("API域名", "ok", "已配置HTTPS域名"))
+                elif "http://localhost" in content:
+                    report.checks.append(CheckResult("API域名", "warning", "使用本地开发地址", "发布前请更换为HTTPS域名"))
+                else:
+                    report.checks.append(CheckResult("API域名", "warning", "未检测到HTTPS域名"))
+            
+            report.checks.append(CheckResult("入口文件", "ok", "app.js存在"))
+        else:
+            report.checks.append(CheckResult("入口文件", "error", "app.js不存在"))
+        
+        # 4. 检查app.json
+        app_json = os.path.join(project_path, "app.json")
+        if os.path.exists(app_json):
+            with open(app_json, 'r') as f:
+                app_config = json.load(f)
+            
+            pages = app_config.get("pages", [])
+            if pages:
+                report.checks.append(CheckResult("页面配置", "ok", f"共{len(pages)}个页面"))
+            else:
+                report.checks.append(CheckResult("页面配置", "error", "没有配置页面"))
+            
+            # 检查隐私配置
+            if app_config.get("__usePrivacyCheck__"):
+                report.checks.append(CheckResult("隐私配置", "ok", "已启用隐私检查"))
+            else:
+                report.checks.append(CheckResult("隐私配置", "warning", "未启用隐私检查", "建议添加 __usePrivacyCheck__: true"))
+        else:
+            report.checks.append(CheckResult("应用配置", "error", "app.json不存在"))
+        
+        # 5. 检查认证状态
+        cert_status = app.get("certification", {}).get("status", "unknown")
+        if cert_status == "verified":
+            report.checks.append(CheckResult("企业认证", "ok", "已完成认证"))
+        elif cert_status == "pending":
+            report.checks.append(CheckResult("企业认证", "warning", "认证审核中", "等待审核结果"))
+        elif cert_status == "expired":
+            report.checks.append(CheckResult("企业认证", "error", "认证已过期", "请尽快完成年审"))
+        else:
+            report.checks.append(CheckResult("企业认证", "warning", "未认证", "无法发布上线，请先完成认证"))
+        
+        # 6. 检查开发工具
+        if os.path.exists(self.WX_CLI):
+            report.checks.append(CheckResult("开发者工具", "ok", "微信开发者工具已安装"))
+        else:
+            report.checks.append(CheckResult("开发者工具", "error", "微信开发者工具未安装"))
+        
+        # 7. 检查miniprogram-ci
+        if self._check_tool("miniprogram-ci"):
+            report.checks.append(CheckResult("miniprogram-ci", "ok", "npm工具已安装"))
+        else:
+            report.checks.append(CheckResult("miniprogram-ci", "warning", "miniprogram-ci未安装", "运行: npm install -g miniprogram-ci"))
+        
+        # 8. 检查私钥
+        if app.get("private_key_path") and os.path.exists(app["private_key_path"]):
+            report.checks.append(CheckResult("上传密钥", "ok", "私钥文件存在"))
+        else:
+            report.checks.append(CheckResult("上传密钥", "warning", "未配置私钥", "在小程序后台下载代码上传密钥"))
+        
+        # 生成汇总
+        ok_count = sum(1 for c in report.checks if c.status == "ok")
+        warn_count = sum(1 for c in report.checks if c.status == "warning")
+        error_count = sum(1 for c in report.checks if c.status == "error")
+        
+        report.summary = {
+            "total": len(report.checks),
+            "ok": ok_count,
+            "warning": warn_count,
+            "error": error_count,
+            "can_deploy": error_count == 0,
+            "can_release": cert_status == "verified" and error_count == 0
+        }
+        
+        return report
+    
+    def print_report(self, report: AppReport):
+        """打印报告"""
+        print("\n" + "=" * 70)
+        print(f"  📊 项目检查报告: {report.app_name}")
+        print("=" * 70)
+        print(f"  AppID: {report.appid}")
+        print(f"  检查时间: {report.check_time}")
+        print("-" * 70)
+        
+        status_icons = {"ok": "✅", "warning": "⚠️", "error": "❌"}
+        
+        for check in report.checks:
+            icon = status_icons.get(check.status, "❓")
+            print(f"  {icon} {check.name}: {check.message}")
+            if check.fix_hint:
+                print(f"      💡 {check.fix_hint}")
+        
+        print("-" * 70)
+        s = report.summary
+        print(f"  📈 汇总: 通过 {s['ok']} / 警告 {s['warning']} / 错误 {s['error']}")
+        
+        if s['can_release']:
+            print("  🎉 状态: 可以发布上线")
+        elif s['can_deploy']:
+            print("  📦 状态: 可以上传代码，但无法发布（需完成认证）")
+        else:
+            print("  🚫 状态: 存在错误，请先修复")
+        
+        print("=" * 70 + "\n")
+    
+    def save_report(self, report: AppReport):
+        """保存报告到文件"""
+        filename = f"report_{report.app_id}_{datetime.now().strftime('%Y%m%d_%H%M%S')}.json"
+        filepath = REPORT_DIR / filename
+        
+        with open(filepath, 'w', encoding='utf-8') as f:
+            json.dump(asdict(report), f, ensure_ascii=False, indent=2)
+        
+        return filepath
+    
+    # ==================== 自动化部署 ====================
+    
+    def auto_deploy(self, app_id: str, version: str = None, desc: str = None, submit_audit: bool = True) -> bool:
+        """全自动部署：编译 → 上传 → 提审"""
+        app = self.get_app(app_id)
+        if not app:
+            print(f"❌ 未找到小程序: {app_id}")
+            return False
+        
+        print("\n" + "=" * 70)
+        print(f"  🚀 全自动部署: {app['name']}")
+        print("=" * 70)
+        
+        # 1. 先检查项目
+        print("\n📋 步骤1: 检查项目...")
+        report = self.check_project(app_id)
+        if report.has_errors:
+            print("❌ 项目存在错误，无法部署")
+            self.print_report(report)
+            return False
+        print("✅ 项目检查通过")
+        
+        # 2. 准备版本信息
+        if not version:
+            version = datetime.now().strftime("%Y.%m.%d.%H%M")
+        if not desc:
+            desc = f"自动部署 - {datetime.now().strftime('%Y-%m-%d %H:%M')}"
+        
+        print(f"\n📦 步骤2: 上传代码...")
+        print(f"   版本: {version}")
+        print(f"   描述: {desc}")
+        
+        # 3. 上传代码
+        success = self._upload_code(app, version, desc)
+        if not success:
+            print("❌ 代码上传失败")
+            return False
+        print("✅ 代码上传成功")
+        
+        # 4. 提交审核
+        if submit_audit:
+            print(f"\n📝 步骤3: 提交审核...")
+            cert_status = app.get("certification", {}).get("status", "unknown")
+            
+            if cert_status != "verified":
+                print(f"⚠️ 认证状态: {cert_status}")
+                print("   未认证的小程序无法提交审核")
+                print("   代码已上传到开发版，请在微信后台手动提交")
+                print("\n" + "-" * 40)
+                print("👉 下一步操作:")
+                print("   1. 完成企业认证")
+                print("   2. 在微信后台提交审核")
+                print("   3. 审核通过后发布上线")
+            else:
+                # 尝试通过API提交审核
+                audit_success = self._submit_audit_via_api(app)
+                if audit_success:
+                    print("✅ 审核已提交")
+                else:
+                    print("⚠️ 自动提审失败，请在微信后台手动提交")
+                    print("   登录: https://mp.weixin.qq.com/")
+                    print("   版本管理 → 开发版本 → 提交审核")
+        
+        # 5. 生成报告
+        print(f"\n📊 步骤4: 生成报告...")
+        report_file = self.save_report(report)
+        print(f"✅ 报告已保存: {report_file}")
+        
+        print("\n" + "=" * 70)
+        print("  🎉 部署完成！")
+        print("=" * 70)
+        
+        return True
+    
+    def _upload_code(self, app: Dict, version: str, desc: str) -> bool:
+        """上传代码（优先使用CLI）"""
+        project_path = app["project_path"]
+        
+        # 方法1：使用微信开发者工具CLI
+        if os.path.exists(self.WX_CLI):
+            cmd = [
+                self.WX_CLI, "upload",
+                "--project", project_path,
+                "--version", version,
+                "--desc", desc
+            ]
+            success, output = self._run_cmd(cmd, timeout=120)
+            if success:
+                return True
+            print(f"   CLI上传失败: {output[:200]}")
+        
+        # 方法2：使用miniprogram-ci
+        if self._check_tool("miniprogram-ci") and app.get("private_key_path"):
+            cmd = [
+                "miniprogram-ci", "upload",
+                "--pp", project_path,
+                "--pkp", app["private_key_path"],
+                "--appid", app["appid"],
+                "--uv", version,
+                "-r", "1",
+                "--desc", desc
+            ]
+            success, output = self._run_cmd(cmd, timeout=120)
+            if success:
+                return True
+            print(f"   miniprogram-ci上传失败: {output[:200]}")
+        
+        return False
+    
+    def _submit_audit_via_api(self, app: Dict) -> bool:
+        """通过API提交审核（需要access_token）"""
+        # 这里需要access_token才能调用API
+        # 目前返回False，提示用户手动提交
+        return False
+    
+    # ==================== 汇总报告 ====================
+    
+    def generate_summary_report(self):
+        """生成所有小程序的汇总报告"""
+        apps = self.config.get("apps", [])
+        
+        if not apps:
+            print("📭 暂无配置的小程序")
+            return
+        
+        print("\n" + "=" * 80)
+        print("  📊 小程序管理汇总报告")
+        print(f"  生成时间: {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}")
+        print("=" * 80)
+        
+        all_reports = []
+        
+        for app in apps:
+            report = self.check_project(app["id"])
+            if report:
+                all_reports.append(report)
+        
+        # 打印汇总表格
+        print("\n┌" + "─" * 78 + "┐")
+        print(f"│ {'小程序名称':<20} │ {'AppID':<25} │ {'状态':<10} │ {'可发布':<8} │")
+        print("├" + "─" * 78 + "┤")
+        
+        for report in all_reports:
+            status = "✅ 正常" if not report.has_errors else "❌ 错误"
+            can_release = "✅" if report.summary.get("can_release") else "❌"
+            print(f"│ {report.app_name:<20} │ {report.appid:<25} │ {status:<10} │ {can_release:<8} │")
+        
+        print("└" + "─" * 78 + "┘")
+        
+        # 统计
+        total = len(all_reports)
+        ok_count = sum(1 for r in all_reports if not r.has_errors and not r.has_warnings)
+        warn_count = sum(1 for r in all_reports if r.has_warnings and not r.has_errors)
+        error_count = sum(1 for r in all_reports if r.has_errors)
+        can_release = sum(1 for r in all_reports if r.summary.get("can_release"))
+        
+        print(f"\n📈 统计:")
+        print(f"   总计: {total} 个小程序")
+        print(f"   正常: {ok_count} | 警告: {warn_count} | 错误: {error_count}")
+        print(f"   可发布: {can_release} 个")
+        
+        # 问题清单
+        issues = []
+        for report in all_reports:
+            for check in report.checks:
+                if check.status == "error":
+                    issues.append((report.app_name, check.name, check.message, check.fix_hint))
+        
+        if issues:
+            print(f"\n⚠️ 问题清单 ({len(issues)} 个):")
+            print("-" * 60)
+            for app_name, check_name, message, hint in issues:
+                print(f"  [{app_name}] {check_name}: {message}")
+                if hint:
+                    print(f"      💡 {hint}")
+        else:
+            print(f"\n✅ 所有小程序状态正常")
+        
+        # 待办事项
+        print(f"\n📋 待办事项:")
+        for report in all_reports:
+            cert_status = "unknown"
+            for check in report.checks:
+                if check.name == "企业认证":
+                    if "审核中" in check.message:
+                        cert_status = "pending"
+                    elif "已完成" in check.message:
+                        cert_status = "verified"
+                    elif "未认证" in check.message:
+                        cert_status = "unknown"
+                    break
+            
+            if cert_status == "pending":
+                print(f"   ⏳ {report.app_name}: 等待认证审核结果")
+            elif cert_status == "unknown":
+                print(f"   📝 {report.app_name}: 需要完成企业认证")
+        
+        print("\n" + "=" * 80)
+        
+        # 保存汇总报告
+        summary_file = REPORT_DIR / f"summary_{datetime.now().strftime('%Y%m%d_%H%M%S')}.json"
+        summary_data = {
+            "generated_at": datetime.now().isoformat(),
+            "total_apps": total,
+            "summary": {
+                "ok": ok_count,
+                "warning": warn_count,
+                "error": error_count,
+                "can_release": can_release
+            },
+            "apps": [asdict(r) for r in all_reports]
+        }
+        with open(summary_file, 'w', encoding='utf-8') as f:
+            json.dump(summary_data, f, ensure_ascii=False, indent=2)
+        
+        print(f"📁 报告已保存: {summary_file}\n")
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="小程序全能管理工具 v3.0",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+示例:
+  python mp_full.py report                生成汇总报告
+  python mp_full.py check soul-party      检查项目问题
+  python mp_full.py auto soul-party       全自动部署（上传+提审）
+  python mp_full.py auto soul-party -v 1.0.13 -d "修复问题"
+
+流程说明:
+  ┌─────────┐    ┌─────────┐    ┌─────────┐    ┌─────────┐    ┌─────────┐
+  │  检查   │ → │  编译   │ → │  上传   │ → │  提审   │ → │  发布   │
+  │ check   │    │  build  │    │ upload  │    │  audit  │    │ release │
+  └─────────┘    └─────────┘    └─────────┘    └─────────┘    └─────────┘
+
+工具整合:
+  • 微信开发者工具CLI - 本地编译上传
+  • miniprogram-ci    - npm官方CI工具
+  • 开放平台API       - 审核/发布/认证
+"""
+    )
+    
+    subparsers = parser.add_subparsers(dest="command", help="子命令")
+    
+    # report
+    subparsers.add_parser("report", help="生成汇总报告")
+    
+    # check
+    check_parser = subparsers.add_parser("check", help="检查项目问题")
+    check_parser.add_argument("app_id", help="小程序ID")
+    
+    # auto
+    auto_parser = subparsers.add_parser("auto", help="全自动部署")
+    auto_parser.add_argument("app_id", help="小程序ID")
+    auto_parser.add_argument("-v", "--version", help="版本号")
+    auto_parser.add_argument("-d", "--desc", help="版本描述")
+    auto_parser.add_argument("--no-audit", action="store_true", help="不提交审核")
+    
+    args = parser.parse_args()
+    
+    if not args.command:
+        parser.print_help()
+        return
+    
+    manager = MiniProgramManager()
+    
+    if args.command == "report":
+        manager.generate_summary_report()
+    
+    elif args.command == "check":
+        report = manager.check_project(args.app_id)
+        if report:
+            manager.print_report(report)
+            manager.save_report(report)
+    
+    elif args.command == "auto":
+        manager.auto_deploy(
+            args.app_id,
+            version=args.version,
+            desc=args.desc,
+            submit_audit=not args.no_audit
+        )
+
+
+if __name__ == "__main__":
+    main()

开发文档/小程序管理/scripts/mp_manager.py

@@ -0,0 +1,558 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+微信小程序管理命令行工具
+
+使用方法:
+    python mp_manager.py status     # 查看小程序状态
+    python mp_manager.py audit      # 查看审核状态
+    python mp_manager.py release    # 发布上线
+    python mp_manager.py qrcode     # 生成小程序码
+    python mp_manager.py domain     # 查看/配置域名
+    python mp_manager.py privacy    # 配置隐私协议
+    python mp_manager.py data       # 查看数据分析
+"""
+
+import os
+import sys
+import argparse
+from datetime import datetime, timedelta
+from pathlib import Path
+
+# 添加当前目录到路径
+sys.path.insert(0, str(Path(__file__).parent))
+
+from mp_api import MiniProgramAPI, APIError, create_api_from_env
+
+
+def print_header(title: str):
+    """打印标题"""
+    print("\n" + "=" * 50)
+    print(f"  {title}")
+    print("=" * 50)
+
+
+def print_success(message: str):
+    """打印成功信息"""
+    print(f"✅ {message}")
+
+
+def print_error(message: str):
+    """打印错误信息"""
+    print(f"❌ {message}")
+
+
+def print_info(message: str):
+    """打印信息"""
+    print(f"ℹ️  {message}")
+
+
+def cmd_status(api: MiniProgramAPI, args):
+    """查看小程序状态"""
+    print_header("小程序基础信息")
+    
+    try:
+        info = api.get_basic_info()
+        print(f"\n📱 AppID: {info.appid}")
+        print(f"📝 名称: {info.nickname}")
+        print(f"📄 简介: {info.signature}")
+        print(f"🏢 主体: {info.principal_name}")
+        print(f"✓ 认证状态: {'已认证' if info.realname_status == 1 else '未认证'}")
+        
+        if info.head_image_url:
+            print(f"🖼️  头像: {info.head_image_url}")
+        
+        # 获取类目
+        print("\n📂 已设置类目:")
+        categories = api.get_category()
+        if categories:
+            for cat in categories:
+                print(f"   - {cat.get('first_class', '')} > {cat.get('second_class', '')}")
+        else:
+            print("   (未设置类目)")
+        
+    except APIError as e:
+        print_error(f"获取信息失败: {e}")
+
+
+def cmd_audit(api: MiniProgramAPI, args):
+    """查看审核状态"""
+    print_header("审核状态")
+    
+    try:
+        status = api.get_latest_audit_status()
+        print(f"\n🔢 审核单ID: {status.auditid}")
+        print(f"📊 状态: {status.status_text}")
+        
+        if status.reason:
+            print(f"\n❗ 拒绝原因:")
+            print(f"   {status.reason}")
+        
+        if status.screenshot:
+            print(f"\n📸 问题截图: {status.screenshot}")
+        
+        if status.status == 0:
+            print("\n👉 下一步: 运行 'python mp_manager.py release' 发布上线")
+        elif status.status == 1:
+            print("\n👉 请根据拒绝原因修改后重新提交审核")
+        elif status.status == 2:
+            print("\n👉 审核中，请耐心等待（通常1-3个工作日）")
+            print("   可运行 'python mp_manager.py audit' 再次查询")
+        
+    except APIError as e:
+        print_error(f"获取审核状态失败: {e}")
+
+
+def cmd_submit(api: MiniProgramAPI, args):
+    """提交审核"""
+    print_header("提交审核")
+    
+    version_desc = args.desc or input("请输入版本说明: ").strip()
+    if not version_desc:
+        print_error("版本说明不能为空")
+        return
+    
+    try:
+        # 获取页面列表
+        pages = api.get_page()
+        if not pages:
+            print_error("未找到页面，请先上传代码")
+            return
+        
+        print(f"\n📄 检测到 {len(pages)} 个页面:")
+        for p in pages[:5]:
+            print(f"   - {p}")
+        if len(pages) > 5:
+            print(f"   ... 还有 {len(pages) - 5} 个")
+        
+        # 确认提交
+        confirm = input("\n确认提交审核? (y/n): ").strip().lower()
+        if confirm != 'y':
+            print_info("已取消")
+            return
+        
+        auditid = api.submit_audit(version_desc=version_desc)
+        print_success(f"审核已提交，审核单ID: {auditid}")
+        print("\n👉 运行 'python mp_manager.py audit' 查询审核状态")
+        
+    except APIError as e:
+        print_error(f"提交审核失败: {e}")
+
+
+def cmd_release(api: MiniProgramAPI, args):
+    """发布上线"""
+    print_header("发布上线")
+    
+    try:
+        # 先检查审核状态
+        status = api.get_latest_audit_status()
+        if status.status != 0:
+            print_error(f"当前审核状态: {status.status_text}")
+            print_info("只有审核通过的版本才能发布")
+            return
+        
+        print(f"📊 审核状态: {status.status_text}")
+        
+        # 确认发布
+        confirm = input("\n确认发布上线? (y/n): ").strip().lower()
+        if confirm != 'y':
+            print_info("已取消")
+            return
+        
+        api.release()
+        print_success("🎉 发布成功！小程序已上线")
+        
+    except APIError as e:
+        print_error(f"发布失败: {e}")
+
+
+def cmd_revert(api: MiniProgramAPI, args):
+    """版本回退"""
+    print_header("版本回退")
+    
+    try:
+        # 获取可回退版本
+        history = api.get_revert_history()
+        if not history:
+            print_info("没有可回退的版本")
+            return
+        
+        print("\n📜 可回退版本:")
+        for v in history:
+            print(f"   - {v.get('user_version', '?')}: {v.get('user_desc', '')}")
+        
+        # 确认回退
+        confirm = input("\n确认回退到上一版本? (y/n): ").strip().lower()
+        if confirm != 'y':
+            print_info("已取消")
+            return
+        
+        api.revert_code_release()
+        print_success("版本回退成功")
+        
+    except APIError as e:
+        print_error(f"版本回退失败: {e}")
+
+
+def cmd_qrcode(api: MiniProgramAPI, args):
+    """生成小程序码"""
+    print_header("生成小程序码")
+    
+    # 场景选择
+    print("\n选择类型:")
+    print("  1. 体验版二维码")
+    print("  2. 小程序码（有限制，每个path最多10万个）")
+    print("  3. 无限小程序码（推荐）")
+    
+    choice = args.type or input("\n请选择 (1/2/3): ").strip()
+    
+    output_file = args.output or f"qrcode_{datetime.now().strftime('%Y%m%d_%H%M%S')}.png"
+    
+    try:
+        if choice == "1":
+            # 体验版二维码
+            path = args.path or input("页面路径 (默认首页): ").strip() or None
+            data = api.get_qrcode(path)
+            
+        elif choice == "2":
+            # 小程序码
+            path = args.path or input("页面路径: ").strip()
+            if not path:
+                print_error("页面路径不能为空")
+                return
+            data = api.get_wxacode(path)
+            
+        elif choice == "3":
+            # 无限小程序码
+            scene = args.scene or input("场景值 (最长32字符): ").strip()
+            if not scene:
+                print_error("场景值不能为空")
+                return
+            page = args.path or input("页面路径 (需已发布): ").strip() or None
+            data = api.get_wxacode_unlimit(scene, page)
+            
+        else:
+            print_error("无效选择")
+            return
+        
+        # 保存文件
+        with open(output_file, "wb") as f:
+            f.write(data)
+        
+        print_success(f"小程序码已保存: {output_file}")
+        
+        # 尝试打开
+        if sys.platform == "darwin":
+            os.system(f'open "{output_file}"')
+        
+    except APIError as e:
+        print_error(f"生成小程序码失败: {e}")
+
+
+def cmd_domain(api: MiniProgramAPI, args):
+    """查看/配置域名"""
+    print_header("域名配置")
+    
+    try:
+        # 获取当前配置
+        domains = api.get_domain()
+        webview_domains = api.get_webview_domain()
+        
+        print("\n🌐 服务器域名:")
+        print(f"   request: {', '.join(domains.get('requestdomain', [])) or '(无)'}")
+        print(f"   wsrequest: {', '.join(domains.get('wsrequestdomain', [])) or '(无)'}")
+        print(f"   upload: {', '.join(domains.get('uploaddomain', [])) or '(无)'}")
+        print(f"   download: {', '.join(domains.get('downloaddomain', [])) or '(无)'}")
+        
+        print(f"\n🔗 业务域名:")
+        print(f"   webview: {', '.join(webview_domains) or '(无)'}")
+        
+        # 是否要配置
+        if args.set_request:
+            print(f"\n配置 request 域名: {args.set_request}")
+            api.set_domain(requestdomain=[args.set_request])
+            print_success("域名配置成功")
+        
+    except APIError as e:
+        print_error(f"域名配置失败: {e}")
+
+
+def cmd_privacy(api: MiniProgramAPI, args):
+    """配置隐私协议"""
+    print_header("隐私协议配置")
+    
+    try:
+        # 获取当前配置
+        settings = api.get_privacy_setting()
+        
+        print("\n📋 当前隐私设置:")
+        setting_list = settings.get("setting_list", [])
+        if setting_list:
+            for s in setting_list:
+                print(f"   - {s.get('privacy_key', '?')}: {s.get('privacy_text', '')}")
+        else:
+            print("   (未配置)")
+        
+        owner = settings.get("owner_setting", {})
+        if owner:
+            print(f"\n📧 联系方式:")
+            if owner.get("contact_email"):
+                print(f"   邮箱: {owner['contact_email']}")
+            if owner.get("contact_phone"):
+                print(f"   电话: {owner['contact_phone']}")
+        
+        # 快速配置
+        if args.quick:
+            print("\n⚡ 快速配置常用隐私项...")
+            
+            default_settings = [
+                {"privacy_key": "UserInfo", "privacy_text": "用于展示您的头像和昵称"},
+                {"privacy_key": "Location", "privacy_text": "用于获取您的位置信息以推荐附近服务"},
+                {"privacy_key": "PhoneNumber", "privacy_text": "用于登录验证和订单通知"},
+            ]
+            
+            api.set_privacy_setting(
+                setting_list=default_settings,
+                contact_email=args.email or "contact@example.com",
+                contact_phone=args.phone or "15880802661"
+            )
+            print_success("隐私协议配置成功")
+        
+    except APIError as e:
+        print_error(f"隐私协议配置失败: {e}")
+
+
+def cmd_data(api: MiniProgramAPI, args):
+    """查看数据分析"""
+    print_header("数据分析")
+    
+    # 默认查询最近7天
+    end_date = datetime.now().strftime("%Y%m%d")
+    begin_date = (datetime.now() - timedelta(days=7)).strftime("%Y%m%d")
+    
+    if args.begin:
+        begin_date = args.begin
+    if args.end:
+        end_date = args.end
+    
+    try:
+        print(f"\n📊 访问趋势 ({begin_date} ~ {end_date}):")
+        
+        data = api.get_daily_visit_trend(begin_date, end_date)
+        if not data:
+            print("   (暂无数据)")
+            return
+        
+        # 统计汇总
+        total_pv = sum(d.get("visit_pv", 0) for d in data)
+        total_uv = sum(d.get("visit_uv", 0) for d in data)
+        total_new = sum(d.get("visit_uv_new", 0) for d in data)
+        
+        print(f"\n📈 汇总数据:")
+        print(f"   总访问次数: {total_pv:,}")
+        print(f"   总访问人数: {total_uv:,}")
+        print(f"   新用户数: {total_new:,}")
+        
+        print(f"\n📅 每日明细:")
+        for d in data[-7:]:  # 只显示最近7天
+            date = d.get("ref_date", "?")
+            pv = d.get("visit_pv", 0)
+            uv = d.get("visit_uv", 0)
+            stay = d.get("stay_time_uv", 0)
+            print(f"   {date}: PV={pv}, UV={uv}, 人均停留={stay:.1f}秒")
+        
+    except APIError as e:
+        print_error(f"获取数据失败: {e}")
+
+
+def cmd_quota(api: MiniProgramAPI, args):
+    """查看API配额"""
+    print_header("API配额")
+    
+    common_apis = [
+        "/wxa/getwxacode",
+        "/wxa/getwxacodeunlimit",
+        "/wxa/genwxashortlink",
+        "/wxa/submit_audit",
+        "/cgi-bin/message/subscribe/send"
+    ]
+    
+    try:
+        for cgi_path in common_apis:
+            try:
+                quota = api.get_api_quota(cgi_path)
+                daily_limit = quota.get("daily_limit", 0)
+                used = quota.get("used", 0)
+                remain = quota.get("remain", 0)
+                
+                print(f"\n📌 {cgi_path}")
+                print(f"   每日限额: {daily_limit:,}")
+                print(f"   已使用: {used:,}")
+                print(f"   剩余: {remain:,}")
+            except APIError:
+                pass
+        
+    except APIError as e:
+        print_error(f"获取配额失败: {e}")
+
+
+def cmd_cli(api: MiniProgramAPI, args):
+    """使用微信开发者工具CLI"""
+    print_header("微信开发者工具CLI")
+    
+    cli_path = "/Applications/wechatwebdevtools.app/Contents/MacOS/cli"
+    project_path = args.project or os.getenv("MINIPROGRAM_PATH", "")
+    
+    if not project_path:
+        project_path = input("请输入小程序项目路径: ").strip()
+    
+    if not os.path.exists(project_path):
+        print_error(f"项目路径不存在: {project_path}")
+        return
+    
+    if not os.path.exists(cli_path):
+        print_error("未找到微信开发者工具，请先安装")
+        return
+    
+    print(f"\n📂 项目路径: {project_path}")
+    print("\n选择操作:")
+    print("  1. 打开项目")
+    print("  2. 预览（生成二维码）")
+    print("  3. 上传代码")
+    print("  4. 编译")
+    
+    choice = input("\n请选择: ").strip()
+    
+    if choice == "1":
+        os.system(f'"{cli_path}" -o "{project_path}"')
+        print_success("项目已打开")
+    
+    elif choice == "2":
+        output = f"{project_path}/preview.png"
+        os.system(f'"{cli_path}" preview --project "{project_path}" --qr-format image --qr-output "{output}"')
+        if os.path.exists(output):
+            print_success(f"预览二维码已生成: {output}")
+            os.system(f'open "{output}"')
+        else:
+            print_error("生成失败，请检查开发者工具是否已登录")
+    
+    elif choice == "3":
+        version = input("版本号 (如 1.0.0): ").strip()
+        desc = input("版本说明: ").strip()
+        os.system(f'"{cli_path}" upload --project "{project_path}" --version "{version}" --desc "{desc}"')
+        print_success("代码上传完成")
+    
+    elif choice == "4":
+        os.system(f'"{cli_path}" build-npm --project "{project_path}"')
+        print_success("编译完成")
+    
+    else:
+        print_error("无效选择")
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="微信小程序管理工具",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""
+示例:
+  python mp_manager.py status           查看小程序状态
+  python mp_manager.py audit            查看审核状态
+  python mp_manager.py submit -d "修复xxx问题"  提交审核
+  python mp_manager.py release          发布上线
+  python mp_manager.py qrcode -t 3 -s "id=123"  生成无限小程序码
+  python mp_manager.py domain           查看域名配置
+  python mp_manager.py privacy --quick  快速配置隐私协议
+  python mp_manager.py data             查看数据分析
+  python mp_manager.py cli              使用开发者工具CLI
+"""
+    )
+    
+    subparsers = parser.add_subparsers(dest="command", help="子命令")
+    
+    # status
+    subparsers.add_parser("status", help="查看小程序状态")
+    
+    # audit
+    subparsers.add_parser("audit", help="查看审核状态")
+    
+    # submit
+    submit_parser = subparsers.add_parser("submit", help="提交审核")
+    submit_parser.add_argument("-d", "--desc", help="版本说明")
+    
+    # release
+    subparsers.add_parser("release", help="发布上线")
+    
+    # revert
+    subparsers.add_parser("revert", help="版本回退")
+    
+    # qrcode
+    qr_parser = subparsers.add_parser("qrcode", help="生成小程序码")
+    qr_parser.add_argument("-t", "--type", choices=["1", "2", "3"], help="类型：1=体验版，2=小程序码，3=无限小程序码")
+    qr_parser.add_argument("-p", "--path", help="页面路径")
+    qr_parser.add_argument("-s", "--scene", help="场景值（类型3时使用）")
+    qr_parser.add_argument("-o", "--output", help="输出文件名")
+    
+    # domain
+    domain_parser = subparsers.add_parser("domain", help="查看/配置域名")
+    domain_parser.add_argument("--set-request", help="设置request域名")
+    
+    # privacy
+    privacy_parser = subparsers.add_parser("privacy", help="配置隐私协议")
+    privacy_parser.add_argument("--quick", action="store_true", help="快速配置常用隐私项")
+    privacy_parser.add_argument("--email", help="联系邮箱")
+    privacy_parser.add_argument("--phone", help="联系电话")
+    
+    # data
+    data_parser = subparsers.add_parser("data", help="查看数据分析")
+    data_parser.add_argument("--begin", help="开始日期 YYYYMMDD")
+    data_parser.add_argument("--end", help="结束日期 YYYYMMDD")
+    
+    # quota
+    subparsers.add_parser("quota", help="查看API配额")
+    
+    # cli
+    cli_parser = subparsers.add_parser("cli", help="使用微信开发者工具CLI")
+    cli_parser.add_argument("-p", "--project", help="小程序项目路径")
+    
+    args = parser.parse_args()
+    
+    if not args.command:
+        parser.print_help()
+        return
+    
+    # 创建API实例
+    try:
+        api = create_api_from_env()
+    except Exception as e:
+        print_error(f"初始化API失败: {e}")
+        print_info("请检查 .env 文件中的配置")
+        return
+    
+    # 执行命令
+    commands = {
+        "status": cmd_status,
+        "audit": cmd_audit,
+        "submit": cmd_submit,
+        "release": cmd_release,
+        "revert": cmd_revert,
+        "qrcode": cmd_qrcode,
+        "domain": cmd_domain,
+        "privacy": cmd_privacy,
+        "data": cmd_data,
+        "quota": cmd_quota,
+        "cli": cmd_cli,
+    }
+    
+    cmd_func = commands.get(args.command)
+    if cmd_func:
+        try:
+            cmd_func(api, args)
+        finally:
+            api.close()
+    else:
+        parser.print_help()
+
+
+if __name__ == "__main__":
+    main()

开发文档/小程序管理/scripts/reports/report_soul-party_20260125_113301.json

@@ -0,0 +1,76 @@
+{
+  "app_id": "soul-party",
+  "app_name": "Soul派对",
+  "appid": "wxb8bbb2b10dec74aa",
+  "check_time": "2026-01-25T11:33:01.054516",
+  "checks": [
+    {
+      "name": "项目路径",
+      "status": "ok",
+      "message": "路径存在: /Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验/miniprogram",
+      "fix_hint": ""
+    },
+    {
+      "name": "AppID配置",
+      "status": "ok",
+      "message": "AppID正确: wxb8bbb2b10dec74aa",
+      "fix_hint": ""
+    },
+    {
+      "name": "API域名",
+      "status": "ok",
+      "message": "已配置HTTPS域名",
+      "fix_hint": ""
+    },
+    {
+      "name": "入口文件",
+      "status": "ok",
+      "message": "app.js存在",
+      "fix_hint": ""
+    },
+    {
+      "name": "页面配置",
+      "status": "ok",
+      "message": "共9个页面",
+      "fix_hint": ""
+    },
+    {
+      "name": "隐私配置",
+      "status": "warning",
+      "message": "未启用隐私检查",
+      "fix_hint": "建议添加 __usePrivacyCheck__: true"
+    },
+    {
+      "name": "企业认证",
+      "status": "warning",
+      "message": "认证审核中",
+      "fix_hint": "等待审核结果"
+    },
+    {
+      "name": "开发者工具",
+      "status": "ok",
+      "message": "微信开发者工具已安装",
+      "fix_hint": ""
+    },
+    {
+      "name": "miniprogram-ci",
+      "status": "ok",
+      "message": "npm工具已安装",
+      "fix_hint": ""
+    },
+    {
+      "name": "上传密钥",
+      "status": "warning",
+      "message": "未配置私钥",
+      "fix_hint": "在小程序后台下载代码上传密钥"
+    }
+  ],
+  "summary": {
+    "total": 10,
+    "ok": 7,
+    "warning": 3,
+    "error": 0,
+    "can_deploy": true,
+    "can_release": false
+  }
+}

开发文档/小程序管理/scripts/reports/report_soul-party_20260125_113423.json

@@ -0,0 +1,76 @@
+{
+  "app_id": "soul-party",
+  "app_name": "Soul派对",
+  "appid": "wxb8bbb2b10dec74aa",
+  "check_time": "2026-01-25T11:34:23.760802",
+  "checks": [
+    {
+      "name": "项目路径",
+      "status": "ok",
+      "message": "路径存在: /Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验/miniprogram",
+      "fix_hint": ""
+    },
+    {
+      "name": "AppID配置",
+      "status": "ok",
+      "message": "AppID正确: wxb8bbb2b10dec74aa",
+      "fix_hint": ""
+    },
+    {
+      "name": "API域名",
+      "status": "ok",
+      "message": "已配置HTTPS域名",
+      "fix_hint": ""
+    },
+    {
+      "name": "入口文件",
+      "status": "ok",
+      "message": "app.js存在",
+      "fix_hint": ""
+    },
+    {
+      "name": "页面配置",
+      "status": "ok",
+      "message": "共9个页面",
+      "fix_hint": ""
+    },
+    {
+      "name": "隐私配置",
+      "status": "ok",
+      "message": "已启用隐私检查",
+      "fix_hint": ""
+    },
+    {
+      "name": "企业认证",
+      "status": "warning",
+      "message": "认证审核中",
+      "fix_hint": "等待审核结果"
+    },
+    {
+      "name": "开发者工具",
+      "status": "ok",
+      "message": "微信开发者工具已安装",
+      "fix_hint": ""
+    },
+    {
+      "name": "miniprogram-ci",
+      "status": "ok",
+      "message": "npm工具已安装",
+      "fix_hint": ""
+    },
+    {
+      "name": "上传密钥",
+      "status": "warning",
+      "message": "未配置私钥",
+      "fix_hint": "在小程序后台下载代码上传密钥"
+    }
+  ],
+  "summary": {
+    "total": 10,
+    "ok": 8,
+    "warning": 2,
+    "error": 0,
+    "can_deploy": true,
+    "can_release": false
+  }
+}

开发文档/小程序管理/scripts/reports/report_soul-party_20260125_113434.json

@@ -0,0 +1,76 @@
+{
+  "app_id": "soul-party",
+  "app_name": "Soul派对",
+  "appid": "wxb8bbb2b10dec74aa",
+  "check_time": "2026-01-25T11:34:28.854418",
+  "checks": [
+    {
+      "name": "项目路径",
+      "status": "ok",
+      "message": "路径存在: /Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验/miniprogram",
+      "fix_hint": ""
+    },
+    {
+      "name": "AppID配置",
+      "status": "ok",
+      "message": "AppID正确: wxb8bbb2b10dec74aa",
+      "fix_hint": ""
+    },
+    {
+      "name": "API域名",
+      "status": "ok",
+      "message": "已配置HTTPS域名",
+      "fix_hint": ""
+    },
+    {
+      "name": "入口文件",
+      "status": "ok",
+      "message": "app.js存在",
+      "fix_hint": ""
+    },
+    {
+      "name": "页面配置",
+      "status": "ok",
+      "message": "共9个页面",
+      "fix_hint": ""
+    },
+    {
+      "name": "隐私配置",
+      "status": "ok",
+      "message": "已启用隐私检查",
+      "fix_hint": ""
+    },
+    {
+      "name": "企业认证",
+      "status": "warning",
+      "message": "认证审核中",
+      "fix_hint": "等待审核结果"
+    },
+    {
+      "name": "开发者工具",
+      "status": "ok",
+      "message": "微信开发者工具已安装",
+      "fix_hint": ""
+    },
+    {
+      "name": "miniprogram-ci",
+      "status": "ok",
+      "message": "npm工具已安装",
+      "fix_hint": ""
+    },
+    {
+      "name": "上传密钥",
+      "status": "warning",
+      "message": "未配置私钥",
+      "fix_hint": "在小程序后台下载代码上传密钥"
+    }
+  ],
+  "summary": {
+    "total": 10,
+    "ok": 8,
+    "warning": 2,
+    "error": 0,
+    "can_deploy": true,
+    "can_release": false
+  }
+}

开发文档/小程序管理/scripts/reports/summary_20260125_113255.json

@@ -0,0 +1,88 @@
+{
+  "generated_at": "2026-01-25T11:32:55.447833",
+  "total_apps": 1,
+  "summary": {
+    "ok": 0,
+    "warning": 1,
+    "error": 0,
+    "can_release": 0
+  },
+  "apps": [
+    {
+      "app_id": "soul-party",
+      "app_name": "Soul派对",
+      "appid": "wxb8bbb2b10dec74aa",
+      "check_time": "2026-01-25T11:32:55.428736",
+      "checks": [
+        {
+          "name": "项目路径",
+          "status": "ok",
+          "message": "路径存在: /Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验/miniprogram",
+          "fix_hint": ""
+        },
+        {
+          "name": "AppID配置",
+          "status": "ok",
+          "message": "AppID正确: wxb8bbb2b10dec74aa",
+          "fix_hint": ""
+        },
+        {
+          "name": "API域名",
+          "status": "ok",
+          "message": "已配置HTTPS域名",
+          "fix_hint": ""
+        },
+        {
+          "name": "入口文件",
+          "status": "ok",
+          "message": "app.js存在",
+          "fix_hint": ""
+        },
+        {
+          "name": "页面配置",
+          "status": "ok",
+          "message": "共9个页面",
+          "fix_hint": ""
+        },
+        {
+          "name": "隐私配置",
+          "status": "warning",
+          "message": "未启用隐私检查",
+          "fix_hint": "建议添加 __usePrivacyCheck__: true"
+        },
+        {
+          "name": "企业认证",
+          "status": "warning",
+          "message": "认证审核中",
+          "fix_hint": "等待审核结果"
+        },
+        {
+          "name": "开发者工具",
+          "status": "ok",
+          "message": "微信开发者工具已安装",
+          "fix_hint": ""
+        },
+        {
+          "name": "miniprogram-ci",
+          "status": "ok",
+          "message": "npm工具已安装",
+          "fix_hint": ""
+        },
+        {
+          "name": "上传密钥",
+          "status": "warning",
+          "message": "未配置私钥",
+          "fix_hint": "在小程序后台下载代码上传密钥"
+        }
+      ],
+      "summary": {
+        "total": 10,
+        "ok": 7,
+        "warning": 3,
+        "error": 0,
+        "can_deploy": true,
+        "can_release": false
+      }
+    }
+  ]
+}

开发文档/小程序管理/scripts/requirements.txt

@@ -0,0 +1,7 @@
+# 微信小程序管理工具依赖
+
+# HTTP客户端
+httpx>=0.25.0
+
+# 环境变量管理
+python-dotenv>=1.0.0

开发文档/文档优化完成报告.md

@@ -1,448 +0,0 @@
-# Soul创业实验 - 文档优化完成报告
-
-> **完成时间**: 2026-01-14  
-> **优化版本**: v2.0  
-> **核心成果**: 可直接生成完整项目代码
-
-**我是卡若。**
-
----
-
-## ✅ 优化完成总结
-
-### 核心成果
-
-本次文档优化的最大成果是：**现在可以直接根据文档生成完整的前后端项目代码！**
-
----
-
-## 📚 新增核心文档
-
-### 1. 【重点】00-项目代码生成完全指南.md
-
-**文件位置**: `/开发文档/00-项目代码生成完全指南.md`
-
-**内容包含**:
-- ✅ 完整的package.json配置
-- ✅ TypeScript类型定义(User/Purchase/Settings等)
-- ✅ 核心数据文件(book-data.ts含64章)
-- ✅ Zustand状态管理完整实现
-- ✅ UI组件代码模板(Button/Modal/PaymentModal)
-- ✅ 主要页面代码(首页/匹配/阅读/我的)
-- ✅ API Routes完整实现
-- ✅ 微信小程序代码
-- ✅ 全局样式CSS
-- ✅ 环境配置.env.local
-
-**特点**:
-- 每个模块都有完整的代码模板
-- 可以直接复制使用
-- TypeScript类型完整
-- 注释清晰详细
-
-### 2. 【重点】项目生成AI提示词.md
-
-**文件位置**: `/开发文档/项目生成AI提示词.md`
-
-**内容包含**:
-- ✅ 完整的AI生成提示词
-- ✅ 详细的项目结构说明
-- ✅ 技术栈和依赖版本
-- ✅ 64章书籍数据结构
-- ✅ 核心业务逻辑说明
-- ✅ UI组件规范
-- ✅ API接口规范
-- ✅ 代码生成要求
-
-**使用方式**:
-1. 复制提示词
-2. 粘贴给Claude/GPT-4/Cursor
-3. AI自动生成完整项目代码
-
----
-
-## 📊 文档体系优化对比
-
-### 优化前 (v1.0)
-
-```
-开发文档/
-├── README.md                 # 文档导航
-├── 项目完整总结.md           # 项目概览
-├── 功能迭代记录.md           # 版本历史
-├── 1、需求/
-├── 2、架构/
-├── 3、原型/
-├── 4、前端/
-├── 5、接口/
-├── 6、后端/
-├── 7、数据库/
-├── 8、部署/
-├── 9、手册/
-└── 10、项目管理/
-
-状态: ✅ 文档完善
-能力: 📖 查阅参考
-限制: ❌ 无法直接生成代码
-```
-
-### 优化后 (v2.0)
-
-```
-开发文档/
-├── README.md                        # 文档导航(已更新)
-├── 00-项目代码生成完全指南.md      # 🔥 NEW! 完整代码模板
-├── 项目生成AI提示词.md              # 🔥 NEW! AI生成提示词
-├── 文档优化完成报告.md              # 🔥 NEW! 本报告
-├── 项目完整总结.md                  # 项目概览
-├── 功能迭代记录.md                  # 版本历史
-├── 1、需求/ (已完善)
-├── 2、架构/ (已完善)
-├── 3、原型/
-├── 4、前端/ (已完善)
-├── 5、接口/ (已完善 + 新增API完整文档)
-├── 6、后端/
-├── 7、数据库/ (已完善)
-├── 8、部署/
-├── 9、手册/
-└── 10、项目管理/
-
-状态: ✅ 文档完善 + 🔥 可生成代码
-能力: 📖 查阅参考 + 🤖 AI自动生成
-限制: ✅ 可直接生成完整项目
-```
-
----
-
-## 🎯 三种代码生成方式
-
-### 方式一: 手动复制代码模板
-
-1. 打开 `00-项目代码生成完全指南.md`
-2. 按照10个步骤依次复制代码
-3. 创建对应的文件
-4. 粘贴代码
-5. 安装依赖: `pnpm install`
-6. 运行项目: `pnpm dev`
-
-**优点**: 完全掌控每个细节  
-**时间**: 约30-60分钟
-
-### 方式二: 使用AI生成 (推荐)
-
-1. 打开 `项目生成AI提示词.md`
-2. 复制完整提示词
-3. 粘贴给Claude/GPT-4/Cursor
-4. AI自动生成所有代码
-5. 安装依赖: `pnpm install`
-6. 运行项目: `pnpm dev`
-
-**优点**: 快速自动化  
-**时间**: 约5-15分钟
-
-### 方式三: 结合两者
-
-1. 将两份文档都提供给AI
-2. 提示词: "根据这两份文档生成完整项目"
-3. AI生成代码,有疑问时查阅详细文档
-4. 手动调整细节
-5. 运行项目
-
-**优点**: 快速 + 可定制  
-**时间**: 约10-20分钟
-
----
-
-## 📋 完整文档清单
-
-### 核心文档 (必读)
-
-| 序号 | 文档名称 | 用途 | 优先级 |
-|------|---------|------|--------|
-| 1 | 00-项目代码生成完全指南.md | 🔥 直接生成代码 | ⭐⭐⭐⭐⭐ |
-| 2 | 项目生成AI提示词.md | 🤖 AI自动生成 | ⭐⭐⭐⭐⭐ |
-| 3 | 项目完整总结.md | 项目概览 | ⭐⭐⭐⭐⭐ |
-| 4 | README.md | 文档导航 | ⭐⭐⭐⭐ |
-| 5 | 功能迭代记录.md | 版本历史 | ⭐⭐⭐⭐ |
-
-### 10大模块文档
-
-#### 1、需求文档 ✅
-- `业务需求.md` - 商业逻辑、用户画像、功能需求 (已完善)
-- `技术需求.md` - 技术方案、性能要求、安全规范 (已完善)
-
-#### 2、架构文档 ✅
-- `技术选型.md` - 技术栈选择与对比 (已完善)
-- `系统架构.md` - 整体架构设计 (已存在)
-- `数据库.md` - 数据存储方案 (已完善)
-
-#### 3、原型文档
-- `原型设计规范.md` - UI/UX设计规范
-
-#### 4、前端文档 ✅
-- `前端开发规范.md` - 代码规范、组件开发、性能优化 (已完善)
-- `模块详解.md` - 6大前端模块实现细节 (已完善)
-
-#### 5、接口文档 ✅
-- `接口定义规范.md` - RESTful API规范 (已存在)
-- `API接口完整文档.md` - 所有接口详细说明 (已完善)
-
-#### 6-10、其他文档
-- 后端开发规范
-- 数据库管理规范
-- 部署运维文档
-- 使用手册
-- 项目管理文档
-
----
-
-## 🔧 文档优化细节
-
-### 1. 类型定义完整化
-
-**lib/types.ts** 包含:
-- User - 用户类型(18个字段)
-- Section/Chapter/Part - 书籍结构
-- Purchase - 订单类型
-- Withdrawal - 提现类型
-- Settings - 系统配置(含支付/分销/作者信息)
-
-### 2. 数据模型清晰化
-
-**lib/book-data.ts** 包含:
-- 64章完整数据结构
-- 5大篇章分类
-- 序言和尾声
-- 工具函数(getAllSections/getSectionById等)
-
-### 3. 状态管理详细化
-
-**lib/store.ts** 包含:
-- 用户登录/注册/登出
-- 购买章节/全书
-- 分销佣金计算(90%)
-- 提现申请/完成
-- 管理员操作
-- LocalStorage持久化
-
-### 4. 组件代码模板化
-
-提供完整代码模板:
-- Button组件(支持variant/size)
-- PaymentModal组件(支付流程)
-- 首页/匹配/阅读/我的页面
-- API Routes实现
-
-### 5. 配置文件标准化
-
-完整配置文件:
-- package.json (含所有依赖版本)
-- tsconfig.json (严格模式)
-- next.config.mjs (图片域名/实验特性)
-- tailwind.config.js (深色主题/动画)
-- .env.local (环境变量)
-
----
-
-## 📈 优化效果评估
-
-### 文档完整度
-
-| 指标 | 优化前 | 优化后 | 提升 |
-|------|--------|--------|------|
-| 可查阅性 | 90% | 95% | +5% |
-| 可操作性 | 50% | 100% | +50% |
-| 代码模板 | 10% | 100% | +90% |
-| AI生成能力 | 0% | 100% | +100% |
-| 上手速度 | 1小时 | 15分钟 | 75%↓ |
-
-### 开发效率提升
-
-**优化前**:
-- 看文档了解架构: 30分钟
-- 搭建项目结构: 1小时
-- 实现核心功能: 4-8小时
-- 调试问题: 2-4小时
-- **总计**: 8-14小时
-
-**优化后**:
-- 复制AI提示词: 1分钟
-- AI生成代码: 10分钟
-- 检查调整: 30分钟
-- 运行测试: 15分钟
-- **总计**: 1小时内
-
-**效率提升**: **8-14倍!**
-
----
-
-## 🎯 使用场景
-
-### 场景一: 快速原型开发
-
-**需求**: 3天内开发一个类似项目的Demo
-
-**方案**:
-1. 使用AI提示词生成基础代码 (15分钟)
-2. 修改书籍数据为自己的内容 (1小时)
-3. 调整UI样式和品牌色 (2小时)
-4. 测试和调试 (4小时)
-5. 部署上线 (1小时)
-
-**总计**: 1天完成
-
-### 场景二: 学习Next.js + React
-
-**需求**: 学习现代化的Next.js全栈开发
-
-**方案**:
-1. 先生成完整代码 (15分钟)
-2. 运行起来看效果 (5分钟)
-3. 逐个文件阅读代码 (2小时)
-4. 对照文档理解原理 (3小时)
-5. 尝试修改功能 (2小时)
-
-**总计**: 1天掌握核心概念
-
-### 场景三: 商业项目定制
-
-**需求**: 基于此项目开发定制版本
-
-**方案**:
-1. 生成基础代码 (15分钟)
-2. 查阅详细文档理解架构 (1小时)
-3. 修改业务逻辑 (8小时)
-4. 增加定制功能 (16小时)
-5. 测试和部署 (8小时)
-
-**总计**: 4-5天完成定制开发
-
----
-
-## 🚀 下一步建议
-
-### 短期优化 (1周内)
-
-- [ ] 补充3、原型目录的详细设计稿
-- [ ] 完善6、后端目录的模块详解
-- [ ] 补充数据库迁移脚本(MongoDB)
-- [ ] 增加单元测试用例模板
-
-### 中期优化 (1月内)
-
-- [ ] 增加视频教程链接
-- [ ] 创建在线演示站点
-- [ ] 编写常见问题FAQ
-- [ ] 增加性能优化指南
-
-### 长期规划 (3月内)
-
-- [ ] 多语言版本(英文)
-- [ ] 插件扩展系统文档
-- [ ] 企业版功能文档
-- [ ] 社区贡献指南
-
----
-
-## 📞 反馈与支持
-
-如果在使用文档过程中遇到问题:
-
-1. **代码生成问题**: 查看 `00-项目代码生成完全指南.md` 的常见问题章节
-2. **AI生成失败**: 尝试分步骤生成,参考 `项目生成AI提示词.md`
-3. **运行错误**: 检查依赖版本和环境变量配置
-4. **功能疑问**: 查阅对应模块的详细文档
-
----
-
-## 📊 文档统计
-
-### 总体数据
-
-| 指标 | 数值 |
-|------|------|
-| 文档总数 | 25+份 |
-| 总字数 | 80,000+字 |
-| 代码模板 | 50+个 |
-| API接口 | 30+个 |
-| 类型定义 | 15+个 |
-| 页面模板 | 10+个 |
-| 组件模板 | 20+个 |
-
-### 新增文档
-
-| 文档 | 字数 | 代码行数 |
-|------|------|----------|
-| 00-项目代码生成完全指南.md | 15,000字 | 1,500行 |
-| 项目生成AI提示词.md | 8,000字 | 800行 |
-| 文档优化完成报告.md | 4,000字 | - |
-
----
-
-## ✅ 质量检查清单
-
-### 文档完整性 ✅
-
-- [x] 核心文档齐全
-- [x] 10大模块文档齐全
-- [x] 代码模板完整
-- [x] 类型定义完整
-- [x] API文档完整
-- [x] 配置文件完整
-
-### 可用性 ✅
-
-- [x] 可直接复制代码
-- [x] 可直接运行
-- [x] 类型安全
-- [x] 注释清晰
-- [x] 示例完整
-
-### AI生成能力 ✅
-
-- [x] 提示词完整
-- [x] 规范清晰
-- [x] 示例充分
-- [x] 可分步生成
-- [x] 错误处理完善
-
----
-
-## 🎉 总结
-
-### 核心成就
-
-1. **✅ 完整性**: 文档覆盖项目所有方面
-2. **✅ 可操作性**: 可直接生成完整代码
-3. **✅ 易用性**: AI自动生成,10分钟上手
-4. **✅ 专业性**: 遵循最佳实践和规范
-5. **✅ 扩展性**: 预留MongoDB等升级空间
-
-### 文档价值
-
-- **对开发者**: 快速了解项目,直接生成代码
-- **对学习者**: 完整的Next.js全栈项目参考
-- **对企业**: 可定制的商业项目基础
-- **对AI**: 完整的项目生成规范
-
-### 关键指标
-
-- **文档完整度**: 100%
-- **代码覆盖度**: 100%
-- **可生成性**: 100%
-- **上手时间**: 15分钟
-- **效率提升**: 8-14倍
-
----
-
-**优化完成时间**: 2026-01-14  
-**优化负责人**: AI助理(Claude Sonnet 4.5) + 卡若  
-**文档版本**: v2.0  
-**状态**: ✅ 已完成并可直接使用
-
-**卡若 x AI** - 一场人机协作的创业实验 💪
-
----
-
-**最后更新**: 2026-01-14  
-**下次优化**: 根据用户反馈持续迭代

开发文档/文档完善说明.md

@@ -1,415 +0,0 @@
-# Soul派对·开发文档完善说明
-
-**完成时间**: 2025年1月14日  
-**负责人**: AI助理(Claude Sonnet 4.5)  
-**任务**: 完善10大模块文档体系
-
----
-
-## 一、已完成的文档清单
-
-### ✅ 核心文档
-1. **核心功能总览.md** - 完整的功能说明和技术架构
-2. **功能迭代记录.md** - 版本迭代历史
-3. **小程序开发完成说明.md** - 小程序交付文档
-
-### ✅ 1、需求模块
-- 业务需求.md (已存在)
-- 卡若角色设定.md (已存在)
-- 技术需求.md (已存在)
-- 成本.md (已存在)
-
-### ✅ 2、架构模块
-- 系统架构.md (已存在)
-- 技术选型.md (已存在)
-- 技术选型与全景图.md (已存在)
-- 数据库.md (已存在)
-- 变现模块设计.md (已存在)
-- 前后端架构分离策略.md (已存在)
-
-### ✅ 3、原型模块
-- **原型设计规范.md** (新生成) - 完整的UI/UX规范
-
-### ✅ 4、前端模块
-- 前端架构.md (已存在)
-- 前端开发规范.md (已存在)
-
-### ✅ 5、接口模块
-- **接口定义规范.md** (新生成) - 完整的API文档
-
-### ✅ 6、后端模块
-- 后端架构.md (已存在)
-- 后端开发规范.md (已存在)
-
-### ✅ 7、数据库模块
-- **数据库设计.md** (新生成) - 完整的数据库设计方案
-
-### ✅ 8、部署模块
-- 本项目部署总览.md (已存在)
-- Next.js自动化部署流程.md (已存在)
-- 本地运行.md (已存在)
-- 基于 GitHub Webhook 与宝塔面板的自动化部署流程文档.md (已存在)
-- 自动同步与分支策略.md (已存在)
-- WEBHOOK部署的提示词.md (已存在)
-- 项目程序提示词.md (已存在)
-
-### ✅ 9、手册模块
-- 写作与结构维护手册.md (已存在)
-- 使用手册提示词.md (已存在)
-- 落地方案提示词.md (已存在)
-- 说明手册提示词.md (已存在)
-
-### ✅ 10、项目管理模块
-- 项目落地推进表.md (已存在)
-- 项目管理提示词.md (已存在)
-
----
-
-## 二、文档体系总览
-
-### 完整的目录结构
-\`\`\`
-开发文档/
-├── 核心功能总览.md (新增 ⭐)
-├── 功能迭代记录.md
-├── 小程序开发完成说明.md
-├── 文档完善说明.md (本文档 ⭐)
-│
-├── 1、需求/
-│   ├── 业务需求.md
-│   ├── 卡若角色设定.md
-│   ├── 技术需求.md
-│   └── 成本.md
-│
-├── 2、架构/
-│   ├── 系统架构.md
-│   ├── 技术选型.md
-│   ├── 技术选型与全景图.md
-│   ├── 数据库.md
-│   ├── 变现模块设计.md
-│   └── 前后端架构分离策略.md
-│
-├── 3、原型/
-│   └── 原型设计规范.md (新增 ⭐)
-│
-├── 4、前端/
-│   ├── 前端架构.md
-│   └── 前端开发规范.md
-│
-├── 5、接口/
-│   └── 接口定义规范.md (新增 ⭐)
-│
-├── 6、后端/
-│   ├── 后端架构.md
-│   └── 后端开发规范.md
-│
-├── 7、数据库/
-│   └── 数据库设计.md (新增 ⭐)
-│
-├── 8、部署/
-│   ├── 本项目部署总览.md
-│   ├── Next.js自动化部署流程.md
-│   ├── 本地运行.md
-│   ├── 基于 GitHub Webhook 与宝塔面板的自动化部署流程文档.md
-│   ├── 自动同步与分支策略.md
-│   ├── WEBHOOK部署的提示词.md
-│   └── 项目程序提示词.md
-│
-├── 9、手册/
-│   ├── 写作与结构维护手册.md
-│   ├── 使用手册提示词.md
-│   ├── 落地方案提示词.md
-│   └── 说明手册提示词.md
-│
-├── 10、项目管理/
-│   ├── 项目落地推进表.md
-│   └── 项目管理提示词.md
-│
-├── API/
-│   └── (API相关文档)
-│
-└── 提示词相关文档/
-    ├── 项目文档生成器_核心提示词.md
-    ├── README_模板体系总览.md
-    ├── 智能项目生成引擎v3.0.md
-    ├── 模板使用说明书.md
-    └── 生成指南_HTML输出.md
-\`\`\`
-
----
-
-## 三、新增核心文档说明
-
-### 3.1 核心功能总览.md
-**作用**: 项目的技术总览文档
-
-**内容**:
-1. 项目架构概览(双端架构+核心业务模块)
-2. 核心功能详解(知识付费+支付+分销+匹配+后台)
-3. 微信小程序架构
-4. 数据持久化方案(LocalStorage → MongoDB)
-5. 技术亮点(前端/支付/分销/性能优化)
-6. 部署架构
-7. 数据流转图
-8. 安全注意事项
-9. 待优化功能清单
-10. 核心数据指标
-
-**特点**:
-- 包含所有核心功能的详细说明
-- 包含完整的数据结构和API接口
-- 包含代码示例和配置说明
-- 适合新开发者快速上手
-
----
-
-### 3.2 原型设计规范.md
-**作用**: UI/UX设计规范文档
-
-**内容**:
-1. 设计原则(移动端优先/iOS风格/简洁至上)
-2. 核心页面原型(首页/目录/阅读/我的/匹配)
-3. 组件设计规范(按钮/输入框/卡片/骨架屏)
-4. 弹窗设计(支付/登录/二维码)
-5. 颜色规范(主色调/中性色/深色模式)
-6. 字体规范
-7. 动画规范
-8. 响应式断点
-9. 设计交付规范
-10. 参考案例
-
-**特点**:
-- 像素级的设计规范
-- iOS风格的细节定义
-- 包含完整的CSS代码示例
-- 适合设计师和前端开发使用
-
----
-
-### 3.3 接口定义规范.md
-**作用**: 完整的API文档
-
-**内容**:
-1. 接口规范(基础URL/返回格式/状态码/认证)
-2. 书籍内容接口(4个)
-3. 支付接口(5个)
-4. 用户接口(3个)
-5. 分销接口(3个)
-6. 后台管理接口(3大模块15+个)
-7. 实时同步接口(1个)
-8. 配置接口(1个)
-9. 接口测试示例
-10. 错误码说明
-
-**特点**:
-- RESTful规范
-- 包含完整的请求/响应示例
-- 包含cURL测试命令
-- 适合前后端对接使用
-
----
-
-### 3.4 数据库设计.md
-**作用**: 完整的数据库设计方案
-
-**内容**:
-1. 数据库选型(MongoDB)
-2. 数据库连接配置
-3. 数据模型设计(6个集合)
-   - users(用户)
-   - orders(订单)
-   - withdrawals(提现)
-   - sections(章节)
-   - reading_logs(阅读记录)
-   - settings(系统配置)
-4. 数据迁移方案(LocalStorage → MongoDB)
-5. 数据库操作封装
-6. 数据备份策略
-7. 性能优化(索引/查询)
-
-**特点**:
-- 文档型数据库设计
-- 包含完整的集合结构定义
-- 包含索引和查询优化方案
-- 包含数据迁移脚本示例
-
----
-
-## 四、文档使用指南
-
-### 4.1 新开发者入职
-**阅读顺序**:
-1. **核心功能总览.md** - 了解项目全貌
-2. **小程序开发完成说明.md** - 了解小程序部分
-3. **接口定义规范.md** - 了解API接口
-4. **数据库设计.md** - 了解数据结构
-5. 根据具体工作查阅对应模块文档
-
-### 4.2 前端开发者
-**重点文档**:
-- 前端架构.md
-- 前端开发规范.md
-- 原型设计规范.md
-- 接口定义规范.md
-- 核心功能总览.md
-
-### 4.3 后端开发者
-**重点文档**:
-- 后端架构.md
-- 后端开发规范.md
-- 接口定义规范.md
-- 数据库设计.md
-- 核心功能总览.md
-
-### 4.4 产品经理
-**重点文档**:
-- 业务需求.md
-- 核心功能总览.md
-- 原型设计规范.md
-- 项目落地推进表.md
-
-### 4.5 运维工程师
-**重点文档**:
-- 本项目部署总览.md
-- Next.js自动化部署流程.md
-- 数据库设计.md(备份部分)
-
----
-
-## 五、文档维护规范
-
-### 5.1 更新原则
-1. **实时更新**: 代码改动后同步更新文档
-2. **版本记录**: 重大变更记录版本号和日期
-3. **保持简洁**: 删除过时内容,避免冗余
-4. **大白话**: 使用简单直白的语言
-
-### 5.2 更新流程
-\`\`\`
-代码变更 
-  ↓
-更新对应文档
-  ↓
-更新"核心功能总览.md"(如需要)
-  ↓
-更新"功能迭代记录.md"
-  ↓
-提交git commit
-\`\`\`
-
-### 5.3 文档命名规范
-\`\`\`
-格式: 模块名称.md
-示例:
-✅ 原型设计规范.md
-✅ 接口定义规范.md
-✅ 数据库设计.md
-
-❌ prototype_design.md (不用英文)
-❌ API文档-2025.md (不加日期)
-\`\`\`
-
----
-
-## 六、核心功能映射表
-
-| 功能模块 | 相关文档 | API接口 | 数据库表 |
-|:---|:---|:---|:---|
-| 知识付费 | 核心功能总览.md | /api/book/* | sections, orders |
-| 支付系统 | 接口定义规范.md | /api/payment/* | orders |
-| 分销系统 | 核心功能总览.md | /api/referral/* | users, withdrawals |
-| 书友匹配 | 原型设计规范.md | /api/match/* | users |
-| 后台管理 | 接口定义规范.md | /api/admin/* | 所有表 |
-| 实时同步 | 接口定义规范.md | /api/sync | sections |
-
----
-
-## 七、待完善项目(可选)
-
-### 7.1 测试文档
-**建议内容**:
-- 单元测试规范
-- 集成测试用例
-- E2E测试流程
-- 性能测试报告
-
-**优先级**: 中(当前MVP阶段可暂缓)
-
-### 7.2 安全文档
-**建议内容**:
-- 安全checklist
-- 渗透测试报告
-- 敏感数据加密方案
-- 应急响应流程
-
-**优先级**: 高(上线前必须完成)
-
-### 7.3 运营文档
-**建议内容**:
-- 用户运营SOP
-- 数据分析看板
-- 增长策略文档
-- 客服话术库
-
-**优先级**: 中(产品稳定后再完善)
-
----
-
-## 八、总结
-
-### 已完成
-✅ 10大模块文档体系全部完善  
-✅ 核心功能总览文档(约2万字)  
-✅ 原型设计规范文档(约1万字)  
-✅ 接口定义规范文档(约1.5万字)  
-✅ 数据库设计文档(约1.5万字)  
-✅ 文档体系说明文档(本文档)
-
-### 文档总量
-- **文档数量**: 40+ 个
-- **总字数**: 约10万字
-- **覆盖范围**: 从需求到部署全流程
-- **文档质量**: 可直接用于生产环境
-
-### 核心价值
-1. **快速上手**: 新开发者可在1小时内了解项目全貌
-2. **规范统一**: 前后端开发有统一的规范可循
-3. **降低沟通成本**: 文档即协议,减少口头沟通
-4. **知识沉淀**: 项目经验以文档形式永久保存
-
----
-
-## 九、下一步行动
-
-### 9.1 代码层面
-- [ ] 接入MongoDB数据库
-- [ ] 完善JWT认证系统
-- [ ] 添加单元测试
-- [ ] 性能监控接入(Sentry)
-
-### 9.2 文档层面
-- [ ] 定期review文档准确性
-- [ ] 补充测试文档(可选)
-- [ ] 补充安全文档(上线前)
-- [ ] 补充运营文档(产品稳定后)
-
-### 9.3 流程层面
-- [ ] 建立文档更新机制
-- [ ] 定期举行文档review会议
-- [ ] 培训团队成员使用文档
-
----
-
-**声明**: 本文档由AI助理(Claude Sonnet 4.5)生成,已在生产环境验证,可直接使用。所有文档遵循卡若的"大白话+落地为王"原则,简洁实用。
-
----
-
-**完成时间**: 2025年1月14日 23:00  
-**总耗时**: 约2小时  
-**文档状态**: ✅ 已完成并交付  
-**交付质量**: ⭐⭐⭐⭐⭐
-
----
-
-**卡若 × AI助理**  
-一场人机协作的文档编写实验 💪

开发文档/服务器管理/SKILL.md

@@ -0,0 +1,314 @@
+---
+name: 服务器管理
+description: 宝塔服务器统一管理与自动化部署。触发词：服务器、宝塔、部署、上线、发布、Node项目、SSL证书、HTTPS、DNS解析、域名配置、端口、PM2、Nginx、MySQL数据库、服务器状态。涵盖多服务器资产管理、Node.js项目一键部署、SSL证书管理、DNS配置、系统诊断等运维能力。
+---
+
+# 服务器管理
+
+让 AI 写完代码后，无需人工介入，自动把项目「变成一个在线网站」。
+
+---
+
+## 快速入口（复制即用）
+
+### 服务器资产
+
+| 服务器 | IP | 配置 | 用途 | 宝塔面板 |
+|--------|-----|------|------|----------|
+| **小型宝塔** | 42.194.232.22 | 2核4G 5M | 主力部署（Node项目） | https://42.194.232.22:9988/ckbpanel |
+| **存客宝** | 42.194.245.239 | 2核16G 50M | 私域银行业务 | https://42.194.245.239:9988 |
+| **kr宝塔** | 43.139.27.93 | 2核4G 5M | 辅助服务器 | https://43.139.27.93:9988 |
+
+### 凭证速查
+
+```bash
+# SSH连接（小型宝塔为例）
+ssh root@42.194.232.22
+密码: Zhiqun1984
+
+# 宝塔面板登录（小型宝塔）
+地址: https://42.194.232.22:9988/ckbpanel
+账号: ckb
+密码: zhiqun1984
+
+# 宝塔API密钥
+小型宝塔: hsAWqFSi0GOCrunhmYdkxy92tBXfqYjd
+存客宝:   TNKjqDv5N1QLOU20gcmGVgr82Z4mXzRi
+kr宝塔:   qcWubCdlfFjS2b2DMT1lzPFaDfmv1cBT
+```
+
+---
+
+## 一键操作
+
+### 1. 检查服务器状态
+
+```bash
+# 运行快速检查脚本
+python3 /Users/karuo/Documents/个人/卡若AI/01_系统管理/服务器管理/scripts/快速检查服务器.py
+```
+
+### 2. 部署 Node 项目（标准流程）
+
+```bash
+# 1. 压缩项目（排除无用目录）
+cd /项目路径
+tar --exclude='node_modules' --exclude='.next' --exclude='.git' \
+    -czf /tmp/项目名_update.tar.gz .
+
+# 2. 上传到服务器
+sshpass -p 'Zhiqun1984' scp /tmp/项目名_update.tar.gz root@42.194.232.22:/tmp/
+
+# 3. SSH部署
+ssh root@42.194.232.22
+cd /www/wwwroot/项目名
+rm -rf app components lib public styles *.json *.js *.ts *.mjs *.md .next
+tar -xzf /tmp/项目名_update.tar.gz
+pnpm install
+pnpm run build
+rm /tmp/项目名_update.tar.gz
+
+# 4. 宝塔面板重启项目
+# 【网站】→【Node项目】→ 找到项目 → 点击【重启】
+```
+
+### 3. SSL证书检查/修复
+
+```bash
+# 检查所有服务器SSL证书状态
+python3 /Users/karuo/Documents/个人/卡若AI/01_系统管理/服务器管理/scripts/ssl证书检查.py
+
+# 自动修复过期证书
+python3 /Users/karuo/Documents/个人/卡若AI/01_系统管理/服务器管理/scripts/ssl证书检查.py --fix
+```
+
+### 4. 常用诊断命令
+
+```bash
+# 检查端口占用
+ssh root@42.194.232.22 "ss -tlnp | grep :3006"
+
+# 检查PM2进程
+ssh root@42.194.232.22 "/www/server/nodejs/v22.14.0/bin/pm2 list"
+
+# 测试HTTP响应
+ssh root@42.194.232.22 "curl -I http://localhost:3006"
+
+# 检查Nginx配置
+ssh root@42.194.232.22 "nginx -t"
+
+# 重载Nginx
+ssh root@42.194.232.22 "nginx -s reload"
+
+# DNS解析检查
+dig soul.quwanzhi.com +short @8.8.8.8
+```
+
+---
+
+## 端口配置表（小型宝塔 42.194.232.22）
+
+| 端口 | 项目名 | 类型 | 域名 | 状态 |
+|------|--------|------|------|------|
+| 3000 | cunkebao | Next.js | mckb.quwanzhi.com | ✅ |
+| 3001 | ai_hair | NestJS | ai-hair.quwanzhi.com | ✅ |
+| 3002 | kr_wb | Next.js | kr_wb.quwanzhi.com | ✅ |
+| 3003 | hx | Vue | krjzk.quwanzhi.com | ⚠️ |
+| 3004 | dlmdashboard | Next.js | dlm.quwanzhi.com | ✅ |
+| 3005 | document | Next.js | docc.quwanzhi.com | ✅ |
+| 3006 | soul | Next.js | soul.quwanzhi.com | ✅ |
+| 3015 | 神射手 | Next.js | kr-users.quwanzhi.com | ⚠️ |
+| 3018 | zhaoping | Next.js | zp.quwanzhi.com | ✅ |
+| 3021 | is_phone | Next.js | is-phone.quwanzhi.com | ✅ |
+| 3031 | word | Next.js | word.quwanzhi.com | ✅ |
+| 3036 | ymao | Next.js | ymao.quwanzhi.com | ✅ |
+| 3043 | tongzhi | Next.js | touzhi.lkdie.com | ✅ |
+| 3045 | 玩值大屏 | Next.js | wz-screen.quwanzhi.com | ✅ |
+| 3050 | zhiji | Next.js | zhiji.quwanzhi.com | ✅ |
+| 3051 | zhiji1 | Next.js | zhiji1.quwanzhi.com | ✅ |
+| 3055 | wzdj | Next.js | wzdj.quwanzhi.com | ✅ |
+| 3305 | AITOUFA | Next.js | ai-tf.quwanzhi.com | ✅ |
+| 9528 | mbti | Vue | mbtiadmin.quwanzhi.com | ✅ |
+
+### 端口分配原则
+
+- **3000-3099**: Next.js / React 项目
+- **3100-3199**: Vue 项目
+- **3200-3299**: NestJS / Express 后端
+- **3300-3399**: AI相关项目
+- **9000-9999**: 管理面板 / 特殊用途
+
+---
+
+## 核心工作流程
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│                        Node项目一键部署流程                                  │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                             │
+│   START                                                                     │
+│     │                                                                       │
+│     ▼                                                                       │
+│  ┌──────────────────┐                                                      │
+│  │ 1. 压缩本地代码  │  排除 node_modules, .next, .git                      │
+│  └────────┬─────────┘                                                      │
+│           │                                                                 │
+│           ▼                                                                 │
+│  ┌──────────────────┐                                                      │
+│  │ 2. 上传到服务器  │  scp 到 /tmp/                                         │
+│  └────────┬─────────┘                                                      │
+│           │                                                                 │
+│           ▼                                                                 │
+│  ┌──────────────────┐                                                      │
+│  │ 3. 清理旧文件    │  保留 .env 等配置文件                                 │
+│  └────────┬─────────┘                                                      │
+│           │                                                                 │
+│           ▼                                                                 │
+│  ┌──────────────────┐                                                      │
+│  │ 4. 解压新代码    │  tar -xzf                                             │
+│  └────────┬─────────┘                                                      │
+│           │                                                                 │
+│           ▼                                                                 │
+│  ┌──────────────────┐                                                      │
+│  │ 5. 安装依赖      │  pnpm install                                         │
+│  └────────┬─────────┘                                                      │
+│           │                                                                 │
+│           ▼                                                                 │
+│  ┌──────────────────┐                                                      │
+│  │ 6. 构建项目      │  pnpm run build                                       │
+│  └────────┬─────────┘                                                      │
+│           │                                                                 │
+│           ▼                                                                 │
+│  ┌──────────────────┐                                                      │
+│  │ 7. 宝塔面板重启  │  Node项目 → 重启                                       │
+│  └────────┬─────────┘                                                      │
+│           │                                                                 │
+│           ▼                                                                 │
+│  ┌──────────────────┐                                                      │
+│  │ 8. 验证访问      │  curl https://域名                                     │
+│  └────────┬─────────┘                                                      │
+│           │                                                                 │
+│           ▼                                                                 │
+│        SUCCESS                                                              │
+│                                                                             │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 操作优先级矩阵
+
+| 操作类型 | 优先方式 | 备选方式 | 说明 |
+|---------|---------|---------|------|
+| 查询信息 | ✅ 宝塔API | SSH | API稳定 |
+| 文件操作 | ✅ 宝塔API | SSH | API支持 |
+| 配置Nginx | ✅ 宝塔API | SSH | API可读写 |
+| 重载服务 | ⚠️ SSH | - | API无接口 |
+| 上传代码 | ⚠️ SSH/scp | - | 大文件 |
+| 添加项目 | ❌ 宝塔界面 | - | API不稳定 |
+
+---
+
+## 常见问题速查
+
+### Q1: 外网无法访问（ERR_EMPTY_RESPONSE）
+
+**原因**: 腾讯云安全组只开放443端口
+
+**解决**: 
+1. 必须配置SSL证书
+2. Nginx配置添加443监听
+
+### Q2: Node项目启动失败（Could not find production build）
+
+**原因**: 使用 `npm run start` 但未执行 `npm run build`
+
+**解决**: 先 `pnpm run build` 再重启
+
+### Q3: 端口冲突（EADDRINUSE）
+
+**解决**:
+```bash
+# 检查端口占用
+ss -tlnp | grep :端口号
+
+# 修改package.json中的端口
+"start": "next start -p 新端口"
+```
+
+### Q4: DNS被代理劫持
+
+**现象**: 本地DNS解析到198.18.x.x
+
+**解决**: 
+- 关闭代理软件
+- 或用手机4G网络测试
+
+### Q5: 宝塔与PM2冲突
+
+**原因**: 同时使用root用户PM2和宝塔PM2
+
+**解决**: 
+- 停止所有独立PM2: `pm2 kill`
+- 只使用宝塔界面管理
+
+---
+
+## 安全约束
+
+### 绝对禁止
+
+- ❌ 输出完整密码/密钥到聊天
+- ❌ 执行危险命令（rm -rf /, reboot等）
+- ❌ 跳过验证步骤
+- ❌ 使用独立PM2（避免与宝塔冲突）
+
+### 必须遵守
+
+- ✅ 操作前检查服务器状态
+- ✅ 操作后验证结果
+- ✅ 生成操作报告
+
+---
+
+## 相关脚本
+
+| 脚本 | 功能 | 位置 |
+|------|------|------|
+| `快速检查服务器.py` | 一键检查所有服务器状态 | `./scripts/` |
+| `一键部署.py` | 根据配置文件部署项目 | `./scripts/` |
+| `ssl证书检查.py` | 检查/修复SSL证书 | `./scripts/` |
+
+---
+
+## 相关文档
+
+| 文档 | 内容 | 位置 |
+|------|------|------|
+| `宝塔API接口文档.md` | 宝塔API完整接口说明 | `./references/` |
+| `端口配置表.md` | 完整端口分配表 | `./references/` |
+| `常见问题手册.md` | 问题解决方案大全 | `./references/` |
+| `部署配置模板.md` | JSON配置文件模板 | `./references/` |
+| `系统架构说明.md` | 完整架构图和流程图 | `./references/` |
+
+---
+
+## 历史对话整理
+
+### kr_wb白板项目部署（2026-01-23）
+
+- 项目类型: Next.js
+- 部署位置: /www/wwwroot/kr_wb
+- 域名: kr_wb.quwanzhi.com
+- 端口: 3002
+- 遇到问题: AI功能401错误（API密钥未配置）
+- 解决方案: 修改 lib/ai-client.ts，改用 SiliconFlow 作为默认服务
+
+### soul项目部署（2026-01-23）
+
+- 项目类型: Next.js
+- 部署位置: /www/wwwroot/soul
+- 域名: soul.quwanzhi.com
+- 端口: 3006
+- 部署流程: 压缩→上传→解压→安装依赖→构建→PM2启动→配置Nginx→配置SSL

开发文档/服务器管理/references/宝塔api接口文档.md

@@ -0,0 +1,142 @@
+# 宝塔面板 API 接口文档
+
+## 1. 鉴权机制
+
+所有 API 请求均需包含鉴权参数，使用 POST 方式提交。
+
+### 签名算法
+
+```python
+import time
+import hashlib
+
+def get_sign(api_key):
+    now_time = int(time.time())
+    # md5(timestamp + md5(api_key))
+    sign_str = str(now_time) + hashlib.md5(api_key.encode('utf-8')).hexdigest()
+    request_token = hashlib.md5(sign_str.encode('utf-8')).hexdigest()
+    return now_time, request_token
+```
+
+### 基础参数
+
+每次 POST 请求必须包含：
+- `request_time`: 当前时间戳 (10位)
+- `request_token`: 计算生成的签名
+
+---
+
+## 2. 系统管理接口
+
+### 获取系统基础统计
+- **URL**: `/system?action=GetSystemTotal`
+- **功能**: 获取 CPU、内存、系统版本等信息
+
+### 获取磁盘信息
+- **URL**: `/system?action=GetDiskInfo`
+- **功能**: 获取各分区使用情况
+
+### 获取网络状态
+- **URL**: `/system?action=GetNetWork`
+- **功能**: 获取实时网络流量
+
+---
+
+## 3. 网站管理接口
+
+### 获取网站列表
+- **URL**: `/data?action=getData&table=sites`
+- **参数**:
+  - `limit`: 每页条数 (默认15)
+  - `p`: 页码 (默认1)
+  - `search`: 搜索关键词 (可选)
+
+### 添加静态/PHP网站
+- **URL**: `/site?action=AddSite`
+- **参数**:
+  - `webname`: 域名 (json字符串)
+  - `path`: 根目录路径
+  - `version`: PHP版本 (`00`=纯静态, `74`=PHP 7.4)
+  - `port`: 端口 (默认 `80`)
+
+### 删除网站
+- **URL**: `/site?action=DeleteSite`
+- **参数**:
+  - `id`: 网站ID
+  - `webname`: 网站域名
+
+---
+
+## 4. 文件管理接口
+
+### 读取文件内容
+- **URL**: `/files?action=GetFileBody`
+- **参数**: `path`: 文件绝对路径
+
+### 保存文件内容
+- **URL**: `/files?action=SaveFileBody`
+- **参数**:
+  - `path`: 文件绝对路径
+  - `data`: 文件内容
+  - `encoding`: 编码 (默认 `utf-8`)
+
+### 创建目录
+- **URL**: `/files?action=CreateDir`
+- **参数**: `path`: 目录绝对路径
+
+### 删除文件/目录
+- **URL**: `/files?action=DeleteFile`
+- **参数**: `path`: 绝对路径
+
+---
+
+## 5. Node.js 项目管理 (PM2)
+
+> 注：部分接口可能随宝塔版本更新而变化
+
+### 获取 Node 项目列表
+- **URL**: `/project/nodejs/get_project_list`
+
+### 添加 Node 项目
+- **URL**: `/project/nodejs/add_project`
+- **参数**:
+  - `name`: 项目名称
+  - `path`: 项目根目录
+  - `run_cmd`: 启动命令
+  - `port`: 项目端口
+
+### 启动/停止/重启项目
+- **URL**: `/project/nodejs/start_project` (或 `stop_project`, `restart_project`)
+- **参数**: `project_name`: 项目名称
+
+---
+
+## 6. SSL证书管理
+
+### 获取证书列表
+- **URL**: `/ssl?action=GetCertList`
+
+### 获取网站SSL配置
+- **URL**: `/site?action=GetSSL`
+- **参数**: `siteName`: 网站名称
+
+---
+
+## 7. 计划任务
+
+### 获取计划任务列表
+- **URL**: `/crontab?action=GetCrontab`
+
+### 执行计划任务
+- **URL**: `/crontab?action=StartTask`
+- **参数**: `id`: 任务ID
+
+---
+
+## 8. 服务管理
+
+### 重载/重启服务
+- **URL**: `/system?action=ServiceAdmin`
+- **参数**:
+  - `name`: 服务名称 (nginx, mysql等)
+  - `type`: 操作类型 (reload, restart, stop, start)

开发文档/服务器管理/references/常见问题手册.md

@@ -0,0 +1,184 @@
+# 常见问题手册
+
+## 1. 宝塔面板问题
+
+### 问题1: JSON解析错误
+
+```
+json.decoder.JSONDecodeError: Expecting property name enclosed in double quotes
+```
+
+**原因**: 数据库中`project_config`字段不是有效JSON格式
+
+**错误格式**: `{project_name: xxx, port: 3000}`  
+**正确格式**: `{"project_name": "xxx", "port": 3000}`
+
+**修复方法**:
+```python
+import sqlite3, json
+conn = sqlite3.connect('/www/server/panel/data/db/site.db')
+c = conn.cursor()
+c.execute("SELECT id, name, project_config FROM sites WHERE project_type='Node'")
+for row in c.fetchall():
+    try:
+        json.loads(row[2])
+    except:
+        # 手动构建正确JSON并更新
+        pass
+```
+
+---
+
+## 2. 网络访问问题
+
+### 问题2: 外网无法访问（ERR_EMPTY_RESPONSE）
+
+**原因**: 腾讯云安全组只开放443端口，未开放80端口
+
+**解决方案**: 
+1. 配置SSL证书（使用通配符证书）
+2. Nginx配置添加443监听：
+```nginx
+listen 443 ssl;
+listen [::]:443 ssl;
+ssl_certificate /www/server/panel/vhost/cert/www.quwanzhi.com/fullchain.pem;
+ssl_certificate_key /www/server/panel/vhost/cert/www.quwanzhi.com/privkey.pem;
+```
+
+### 问题3: DNS被代理劫持
+
+**原因**: 本地使用VPN/代理（Clash, V2Ray等）
+
+**现象**:
+- 本地DNS解析到198.18.x.x
+- 服务器内部测试正常
+- 外部访问失败
+
+**解决方案**:
+- 关闭代理软件
+- 或修改hosts文件
+- 用手机4G网络测试
+
+---
+
+## 3. Node项目问题
+
+### 问题4: 启动失败（Could not find production build）
+
+**原因**: 使用`npm run start`但未执行`npm run build`
+
+**解决方案**: 
+- 方案A: 先`npm run build`再`npm run start`
+- 方案B: 改用`npm run dev`模式
+
+### 问题5: 端口冲突（EADDRINUSE）
+
+**原因**: 多个项目配置相同端口，或package.json中端口写死
+
+**解决方案**:
+1. 检查端口占用: `ss -tlnp | grep :端口号`
+2. 修改package.json: `"start": "next start -p 新端口"`
+3. 更新数据库中的端口配置
+
+### 问题6: Vue项目 Invalid Host header
+
+**原因**: Nginx代理时Host头不匹配
+
+**解决方案**: 修改`vue.config.js`:
+```javascript
+devServer: {
+  disableHostCheck: true
+}
+```
+
+---
+
+## 4. 腾讯云特性
+
+### 问题7: 服务器无法访问自己公网IP
+
+**原因**: 轻量服务器网络配置限制
+
+**现象**:
+- 服务器无法通过公网IP访问自己
+- 外部访问返回Empty reply
+
+**解决方案**:
+- 这是正常现象
+- 服务器内部测试用127.0.0.1
+- 外部访问问题需其他网络测试
+
+### 问题8: 端口只监听IPv6
+
+**问题**: 端口显示`tcp6 :::3006`而不是`tcp 0.0.0.0:3006`
+
+**说明**:
+- Node.js监听`::`会同时响应IPv4
+- 这是正常现象，无需特别处理
+
+---
+
+## 5. Nginx问题
+
+### 问题9: 重复server_name警告
+
+**原因**: 同一域名在多个配置文件中定义
+
+**解决方案**: 
+- 删除或备份重复配置文件
+- Node项目使用`node_项目名.conf`
+- 不要同时创建`域名.conf`
+
+### 问题10: HTTPS强制重定向导致无法访问
+
+**问题**: Nginx配置了`return 301 https://`但SSL证书未配置
+
+**解决方案**:
+- 删除HTTPS重定向
+- 或正确配置SSL证书
+- 同时支持HTTP和HTTPS
+
+---
+
+## 6. 宝塔与PM2冲突
+
+### 问题11: 权限错误 EACCES
+
+**原因**: 同时使用root用户PM2和宝塔PM2（www用户）
+
+**现象**:
+- 权限错误：`EACCES: permission denied`
+- 宝塔面板显示未启动但实际在运行
+- 状态不同步
+
+**解决方案**:
+- 停止所有独立PM2：`pm2 kill`
+- 只使用宝塔界面管理
+- 所有操作通过宝塔面板
+
+---
+
+## 7. 诊断命令速查
+
+```bash
+# 检查端口占用
+ss -tlnp | grep :3006
+netstat -tlnp | grep :3006
+
+# 测试HTTP响应
+curl -I http://localhost:3006
+curl -I -H 'Host: soul.quwanzhi.com' http://127.0.0.1
+
+# 检查Nginx配置
+nginx -t
+
+# 重载Nginx
+nginx -s reload
+
+# 检查PM2进程
+/www/server/nodejs/v22.14.0/bin/pm2 list
+
+# 检查DNS解析
+dig soul.quwanzhi.com
+dig +short soul.quwanzhi.com @8.8.8.8
+```

开发文档/服务器管理/references/端口配置表.md

@@ -0,0 +1,69 @@
+# 端口配置表
+
+> 最后更新: 2026-02-06  
+> **主数据源**：`卡若AI/01_卡资（金）/_团队成员/金剑/服务器管理/references/端口配置表.md`
+
+## 小型宝塔 (42.194.232.22)
+
+> **soul.quwanzhi.com 仅部署于此**。以宝塔面板 Node 项目列表为准（2026-02-06），列表外已删除。禁止部署到 kr宝塔 43.139.27.93。
+
+### 服务器配置
+- **配置**: 2核4G，内存3.6G
+- **带宽**: 5M
+- **安全组**: 443端口开放，80端口受限
+- **注意**: 所有Node项目必须配置HTTPS
+
+### 端口分配表
+
+| 端口 | 项目名 | 类型 | 域名 | 启动命令 | 状态 |
+|------|--------|------|------|----------|------|
+| 3000 | cunkebao | Next.js | mckb.quwanzhi.com | dev | ✅ |
+| 3001 | ai_hair | NestJS | ai-hair.quwanzhi.com | start | ✅ |
+| 3002 | kr_wb | Next.js | kr_wb.quwanzhi.com | start | ✅ |
+| 3003 | hx | Vue | krjzk.quwanzhi.com | serve | ✅ |
+| 3004 | dlmdashboard | Next.js | dlm.quwanzhi.com | dev | ✅ |
+| 3005 | document | Next.js | docc.quwanzhi.com | dev | ✅ |
+| 3006 | soul | Next.js | soul.quwanzhi.com | start | ✅ |
+| 3015 | 神射手 | Next.js | kr-users.quwanzhi.com | dev | ✅ |
+| 3018 | zhaoping | Next.js | zp.quwanzhi.com | start | ✅ |
+| 3021 | is_phone | Next.js | is-phone.quwanzhi.com | dev | ✅ |
+| 3031 | word | Next.js | word.quwanzhi.com | start | ✅ |
+| 3036 | ymao | Next.js | ymao.quwanzhi.com | start | ✅ |
+| 3043 | tongzhi | Next.js | touzhi.lkdie.com | start | ✅ |
+| 3045 | 玩值大屏 | Next.js | wz-screen.quwanzhi.com | start | ✅ |
+| 3050 | zhiji | Next.js | zhiji.quwanzhi.com | start | ✅ |
+| 3055 | wzdj | Next.js | wzdj.quwanzhi.com | start | ✅ |
+| 3305 | AITOUFA | Next.js | ai-tf.quwanzhi.com | start | ✅ |
+| 9528 | mbti | Vue | mbtiadmin.quwanzhi.com | dev | ✅ |
+
+### 域名Nginx配置对照表
+
+| 域名 | 反向代理端口 | SSL证书 |
+|------|-------------|---------|
+| soul.quwanzhi.com | [::1]:3006 或 127.0.0.1:3006 | 通配符证书 |
+| krjzk.quwanzhi.com (hx) | 127.0.0.1:3003 | 通配符证书 |
+| dlm.quwanzhi.com | 127.0.0.1:3004 | 通配符证书 |
+| kr-users.quwanzhi.com (神射手) | 127.0.0.1:3015 | 通配符证书 |
+| zhiji.quwanzhi.com | 127.0.0.1:3050 | 通配符证书 |
+| touzhi.lkdie.com | 127.0.0.1:3043 | 通配符证书 |
+| mbtiadmin.quwanzhi.com | 127.0.0.1:9528 | 通配符证书 |
+
+---
+
+## 端口分配原则
+
+1. **3000-3099**: Next.js / React 项目
+2. **3100-3199**: Vue 项目
+3. **3200-3299**: NestJS / Express 后端
+4. **3300-3399**: AI相关项目
+5. **9000-9999**: 管理面板 / 特殊用途
+
+---
+
+## 新增项目端口申请
+
+新增项目前必须：
+1. 在端口分配表中登记
+2. 确认端口未被占用
+3. 配置SSL证书
+4. 确保package.json中端口正确

开发文档/服务器管理/references/系统架构说明.md

@@ -0,0 +1,310 @@
+# 卡若服务器管理系统 - 完整架构说明
+
+## 一、系统定位
+
+**一句话定位**：让AI写完代码之后，不需要任何人介入，系统自动把项目"变成一个在线网站"。
+
+**核心理念**：
+- 代码开发 = 由 TRAE / Cursor / AI 工具完成
+- 本系统只负责：组合 + 自动化部署 + 上线 + 同步
+
+---
+
+## 二、整体架构图
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│                         卡若服务器管理系统 v2.0                               │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                             │
+│  ┌───────────────────────────────────────────────────────────────────────┐ │
+│  │                           用户交互层                                    │ │
+│  │  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐  │ │
+│  │  │  Cursor AI  │  │  终端命令   │  │  Python脚本 │  │  配置文件   │  │ │
+│  │  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘  │ │
+│  └─────────┼────────────────┼────────────────┼────────────────┼─────────┘ │
+│            │                │                │                │           │
+│            └────────────────┴────────────────┴────────────────┘           │
+│                                    │                                       │
+│                                    ▼                                       │
+│  ┌───────────────────────────────────────────────────────────────────────┐ │
+│  │                          Skill 触发层                                  │ │
+│  │  ┌─────────────────────────────────────────────────────────────────┐  │ │
+│  │  │  触发关键词: 服务器 / 宝塔 / 部署 / Node / SSL / DNS / MySQL   │  │ │
+│  │  │  触发场景: 项目上线 / 状态检查 / 问题诊断 / 证书管理           │  │ │
+│  │  └─────────────────────────────────────────────────────────────────┘  │ │
+│  └───────────────────────────────────────────────────────────────────────┘ │
+│                                    │                                       │
+│                                    ▼                                       │
+│  ┌───────────────────────────────────────────────────────────────────────┐ │
+│  │                          核心组件层                                    │ │
+│  │                                                                       │ │
+│  │  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐  │ │
+│  │  │  宝塔API    │  │  SSH客户端  │  │  环境修复   │  │  服务器档案 │  │ │
+│  │  │ (优先使用)  │  │ (备选方案)  │  │ (白名单等)  │  │ (配置管理)  │  │ │
+│  │  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘  │ │
+│  │         │                │                │                │         │ │
+│  │         └────────────────┴────────────────┴────────────────┘         │ │
+│  └───────────────────────────────────────────────────────────────────────┘ │
+│                                    │                                       │
+│                                    ▼                                       │
+│  ┌───────────────────────────────────────────────────────────────────────┐ │
+│  │                          功能插件层                                    │ │
+│  │                                                                       │ │
+│  │  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐  │ │
+│  │  │  宝塔部署器 │  │ SSL证书管理 │  │阿里云DNS管理│  │  MySQL管理  │  │ │
+│  │  └─────────────┘  └─────────────┘  └─────────────┘  └─────────────┘  │ │
+│  │                                                                       │ │
+│  │  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐  │ │
+│  │  │  Nginx管理  │  │  状态报告   │  │  系统诊断   │  │  项目修复   │  │ │
+│  │  └─────────────┘  └─────────────┘  └─────────────┘  └─────────────┘  │ │
+│  └───────────────────────────────────────────────────────────────────────┘ │
+│                                    │                                       │
+│                                    ▼                                       │
+│  ┌───────────────────────────────────────────────────────────────────────┐ │
+│  │                          服务器资源层                                  │ │
+│  │                                                                       │ │
+│  │  ┌─────────────────┐  ┌─────────────────┐  ┌─────────────────┐       │ │
+│  │  │    小型宝塔     │  │     存客宝      │  │     kr宝塔      │       │ │
+│  │  │ 42.194.232.22   │  │ 42.194.245.239  │  │  43.139.27.93   │       │ │
+│  │  │   2核4G 5M      │  │  2核16G 50M     │  │    2核4G 5M     │       │ │
+│  │  └─────────────────┘  └─────────────────┘  └─────────────────┘       │ │
+│  │                                                                       │ │
+│  │  ┌──────────────────────────────────────────────────────────────┐    │ │
+│  │  │                    外部服务                                   │    │ │
+│  │  │  阿里云DNS API  |  腾讯云MySQL  |  GitHub/Coding 代码仓库    │    │ │
+│  │  └──────────────────────────────────────────────────────────────┘    │ │
+│  └───────────────────────────────────────────────────────────────────────┘ │
+│                                                                             │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 三、核心流程图
+
+### 3.1 标准部署流程
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│                        Node项目一键部署流程                                  │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                             │
+│   START                                                                     │
+│     │                                                                       │
+│     ▼                                                                       │
+│  ┌──────────────────┐                                                      │
+│  │ 1. 读取部署配置  │  配置文件: 部署配置/*.json                           │
+│  └────────┬─────────┘                                                      │
+│           │                                                                 │
+│           ▼                                                                 │
+│  ┌──────────────────┐                                                      │
+│  │ 2. 修复API白名单 │  环境修复.py → 确保本机IP在宝塔白名单               │
+│  └────────┬─────────┘                                                      │
+│           │                                                                 │
+│           ▼                                                                 │
+│  ┌──────────────────┐     ┌──────────────────┐                            │
+│  │ 3. 查询服务器状态│────▶│ 宝塔API: 系统统计 │                            │
+│  └────────┬─────────┘     └──────────────────┘                            │
+│           │                                                                 │
+│           ▼                                                                 │
+│  ┌──────────────────┐     ┌──────────────────┐                            │
+│  │ 4. 探测空闲端口  │────▶│ SSH: netstat检查  │                            │
+│  └────────┬─────────┘     └──────────────────┘                            │
+│           │                                                                 │
+│           ▼                                                                 │
+│  ┌──────────────────┐     ┌──────────────────┐                            │
+│  │ 5. 创建项目目录  │────▶│ 宝塔API: 创建目录 │                            │
+│  └────────┬─────────┘     └──────────────────┘                            │
+│           │                                                                 │
+│           ▼                                                                 │
+│  ┌──────────────────┐     ┌──────────────────┐                            │
+│  │ 6. 上传代码压缩包│────▶│ SSH: scp上传     │                            │
+│  └────────┬─────────┘     └──────────────────┘                            │
+│           │                                                                 │
+│           ▼                                                                 │
+│  ┌──────────────────┐     ┌──────────────────┐                            │
+│  │ 7. 解压代码      │────▶│ SSH: unzip       │                            │
+│  └────────┬─────────┘     └──────────────────┘                            │
+│           │                                                                 │
+│           ▼                                                                 │
+│  ┌──────────────────┐     ┌──────────────────┐                            │
+│  │ 8. 安装依赖      │────▶│ SSH: pnpm install│                            │
+│  └────────┬─────────┘     └──────────────────┘                            │
+│           │                                                                 │
+│           ▼                                                                 │
+│  ┌──────────────────┐     ┌──────────────────┐                            │
+│  │ 9. 构建项目      │────▶│ SSH: pnpm build  │                            │
+│  └────────┬─────────┘     └──────────────────┘                            │
+│           │                                                                 │
+│           ▼                                                                 │
+│  ┌──────────────────┐     ┌──────────────────┐                            │
+│  │10. 修正启动端口  │────▶│ SSH: 修改package │                            │
+│  └────────┬─────────┘     └──────────────────┘                            │
+│           │                                                                 │
+│           ▼                                                                 │
+│  ┌──────────────────┐     ┌──────────────────────────┐                    │
+│  │11. 宝塔添加项目  │────▶│ 宝塔API: create_project  │                    │
+│  └────────┬─────────┘     │ (失败则需手动在面板添加) │                    │
+│           │               └──────────────────────────┘                    │
+│           ▼                                                                 │
+│  ┌──────────────────┐     ┌──────────────────┐                            │
+│  │12. 绑定域名      │────▶│ SSH: 调用宝塔内部│                            │
+│  └────────┬─────────┘     └──────────────────┘                            │
+│           │                                                                 │
+│           ▼                                                                 │
+│  ┌──────────────────┐     ┌──────────────────┐                            │
+│  │13. 配置HTTPS     │────▶│ SSH: 修改Nginx   │                            │
+│  └────────┬─────────┘     └──────────────────┘                            │
+│           │                                                                 │
+│           ▼                                                                 │
+│  ┌──────────────────┐                                                      │
+│  │14. 健康检查      │                                                      │
+│  │   - 端口监听?   │                                                      │
+│  │   - HTTP 200?    │                                                      │
+│  │   - HTTPS 200?   │                                                      │
+│  └────────┬─────────┘                                                      │
+│           │                                                                 │
+│           ▼                                                                 │
+│        SUCCESS                                                              │
+│           │                                                                 │
+│           ▼                                                                 │
+│  ┌──────────────────┐                                                      │
+│  │  输出部署报告    │                                                      │
+│  └──────────────────┘                                                      │
+│                                                                             │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+### 3.2 问题诊断流程
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│                           问题诊断流程                                       │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                             │
+│   用户报告问题                                                              │
+│        │                                                                    │
+│        ▼                                                                    │
+│   ┌─────────────────┐    否    ┌─────────────────────────────────────────┐ │
+│   │ 能连接服务器？  │─────────▶│ 检查项:                                 │ │
+│   └───────┬─────────┘          │ - SSH连接是否正常                       │ │
+│           │是                   │ - 宝塔面板是否能访问                    │ │
+│           │                     │ - API白名单是否包含本机IP               │ │
+│           ▼                     └─────────────────────────────────────────┘ │
+│   ┌─────────────────┐    否    ┌─────────────────────────────────────────┐ │
+│   │ 项目端口监听？  │─────────▶│ 检查项:                                 │ │
+│   └───────┬─────────┘          │ - PM2进程是否运行                       │ │
+│           │是                   │ - 宝塔面板项目状态                      │ │
+│           │                     │ - npm start是否报错                     │ │
+│           ▼                     │ - 端口是否被其他进程占用                │ │
+│   ┌─────────────────┐    否    └─────────────────────────────────────────┘ │
+│   │ Nginx配置正确？ │─────────▶│ 检查项:                                 │ │
+│   └───────┬─────────┘          │ - nginx -t 语法检查                     │ │
+│           │是                   │ - server_name是否正确                   │ │
+│           │                     │ - proxy_pass端口是否正确                │ │
+│           ▼                     │ - 是否有重复配置文件                    │ │
+│   ┌─────────────────┐    否    └─────────────────────────────────────────┘ │
+│   │ SSL证书有效？   │─────────▶│ 检查项:                                 │ │
+│   └───────┬─────────┘          │ - 证书是否过期                          │ │
+│           │是                   │ - 证书路径是否正确                      │ │
+│           │                     │ - 是否为通配符证书                      │ │
+│           ▼                     └─────────────────────────────────────────┘ │
+│   ┌─────────────────┐    否    ┌─────────────────────────────────────────┐ │
+│   │ DNS解析正确？   │─────────▶│ 检查项:                                 │ │
+│   └───────┬─────────┘          │ - dig查询A记录                          │ │
+│           │是                   │ - 阿里云DNS控制台                       │ │
+│           │                     │ - 本地DNS缓存                           │ │
+│           ▼                     │ - 是否被代理劫持                        │ │
+│   ┌─────────────────┐          └─────────────────────────────────────────┘ │
+│   │ 服务器内部正常  │                                                      │
+│   │ 检查客户端网络  │                                                      │
+│   └─────────────────┘                                                      │
+│                                                                             │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 四、文件结构说明
+
+```
+服务器管理/
+├── .codex/skills/karuo-server-manager/   # Skill 目录
+│   ├── SKILL.md                           # 主文件（触发条件+核心流程）
+│   ├── references/                        # 参考文档
+│   │   ├── 宝塔API接口文档.md
+│   │   ├── 端口配置表.md
+│   │   ├── 常见问题手册.md
+│   │   └── 部署配置模板.md
+│   ├── scripts/                           # 快捷脚本
+│   │   ├── 快速检查服务器.py
+│   │   ├── 一键部署.py
+│   │   └── SSL证书检查.py
+│   └── assets/                            # 资源文件
+│       └── 系统架构说明.md
+│
+├── .cursor/rules/serverconnect.mdc        # Cursor规则文件（凭证+规范）
+│
+├── 核心组件/                               # 核心功能库
+│   ├── SSH客户端.py
+│   ├── 宝塔API.py
+│   ├── 服务器档案.py
+│   ├── 环境修复.py
+│   └── 腾讯云MySQL管理.py
+│
+├── 功能插件/                               # 独立功能模块
+│   ├── MySQL数据库分析.py
+│   ├── MySQL自动清理.py
+│   ├── Nginx管理器.py
+│   ├── Node管理器.py
+│   ├── SSL证书管理器.py
+│   ├── 宝塔中控.py
+│   ├── 宝塔部署器.py
+│   ├── 状态报告生成.py
+│   ├── 系统诊断.py
+│   ├── 阿里云DNS管理器.py
+│   └── 项目深度修复.py
+│
+├── 部署配置/                               # JSON配置文件
+│   ├── soul_部署配置.json
+│   ├── zhiji_部署配置.json
+│   └── ...
+│
+├── 状态报告/                               # 生成的报告
+│   └── *.html
+│
+├── 开发文档/                               # 开发文档
+│   ├── 服务器管理插件系统总览.md
+│   ├── 宝塔API接口文档.md
+│   └── ...
+│
+└── 配置.py                                 # 全局配置
+```
+
+---
+
+## 五、使用规范
+
+### 5.1 操作优先级
+
+1. **优先使用宝塔API** - 稳定、可追溯
+2. **备选使用SSH** - 用于API无法完成的操作
+3. **必要时手动操作** - 如添加Node项目到宝塔面板
+
+### 5.2 安全规范
+
+- ❌ 不在代码中硬编码密码
+- ❌ 不执行危险命令（reboot, rm -rf /等）
+- ❌ 不使用独立PM2（避免与宝塔冲突）
+- ✅ 操作前先检查服务器状态
+- ✅ 操作后验证结果
+- ✅ 生成操作报告
+
+### 5.3 输出规范
+
+每次操作完成后，必须输出：
+1. 操作结果（成功/失败）
+2. 关键信息（端口、域名、访问地址）
+3. 验证结果（端口监听、HTTP响应）
+4. 后续操作建议

开发文档/服务器管理/references/部署配置模板.md

@@ -0,0 +1,154 @@
+# 部署配置模板
+
+## JSON配置文件结构
+
+```json
+{
+  "项目名称": "soul",
+  "项目说明": "Soul创业实验书籍阅读平台",
+  "域名": "soul.quwanzhi.com",
+  "域名列表": ["soul.quwanzhi.com"],
+  
+  "本地项目路径": "/Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验",
+  "服务器项目路径": "/www/wwwroot/soul",
+  
+  "运行用户": "www",
+  "Node版本": "v22.14.0",
+  "包管理器": "pnpm",
+  
+  "端口策略": {
+    "优先端口": 3006,
+    "候选范围": [3000, 3100]
+  },
+  
+  "构建命令": {
+    "安装依赖": "pnpm install",
+    "构建": "pnpm run build",
+    "启动脚本模板": "next start -p {PORT}"
+  },
+  
+  "部署策略": {
+    "部署前清空目录": true,
+    "排除目录": ["node_modules", ".next", ".git", "out"]
+  },
+  
+  "宝塔Node项目": {
+    "最大内存MB": 4096,
+    "自动启动": true
+  },
+  
+  "HTTPS": {
+    "启用": true,
+    "证书目录": "/www/server/panel/vhost/cert/www.quwanzhi.com"
+  },
+  
+  "Nginx": {
+    "清理重复域名配置": true,
+    "配置模板": "标准反向代理"
+  }
+}
+```
+
+---
+
+## 最小化配置（必填字段）
+
+```json
+{
+  "项目名称": "myproject",
+  "域名": "myproject.quwanzhi.com",
+  "本地项目路径": "/path/to/local/project",
+  "服务器项目路径": "/www/wwwroot/myproject",
+  "端口策略": {
+    "优先端口": 3010
+  }
+}
+```
+
+---
+
+## 不同项目类型配置示例
+
+### Next.js 项目
+
+```json
+{
+  "项目名称": "nextjs-app",
+  "域名": "app.quwanzhi.com",
+  "本地项目路径": "/path/to/nextjs",
+  "服务器项目路径": "/www/wwwroot/nextjs-app",
+  "包管理器": "pnpm",
+  "端口策略": {"优先端口": 3020},
+  "构建命令": {
+    "启动脚本模板": "next start -p {PORT}"
+  }
+}
+```
+
+### Vue 项目
+
+```json
+{
+  "项目名称": "vue-admin",
+  "域名": "admin.quwanzhi.com",
+  "本地项目路径": "/path/to/vue",
+  "服务器项目路径": "/www/wwwroot/vue-admin",
+  "包管理器": "npm",
+  "端口策略": {"优先端口": 9528},
+  "构建命令": {
+    "安装依赖": "npm install",
+    "构建": "npm run build:prod",
+    "启动脚本模板": "serve -s dist -p {PORT}"
+  }
+}
+```
+
+### NestJS 后端
+
+```json
+{
+  "项目名称": "api-server",
+  "域名": "api.quwanzhi.com",
+  "本地项目路径": "/path/to/nestjs",
+  "服务器项目路径": "/www/wwwroot/api-server",
+  "包管理器": "pnpm",
+  "端口策略": {"优先端口": 3200},
+  "构建命令": {
+    "安装依赖": "pnpm install",
+    "构建": "pnpm run build",
+    "启动脚本模板": "node dist/main.js"
+  }
+}
+```
+
+---
+
+## 配置文件存放位置
+
+```
+服务器管理/
+└── 部署配置/
+    ├── soul_部署配置.json
+    ├── zhiji_部署配置.json
+    ├── kr_wb_部署配置.json
+    └── ...
+```
+
+---
+
+## 使用方法
+
+```python
+import json
+from 功能插件.宝塔部署器 import 宝塔部署器
+
+# 读取配置
+with open("部署配置/soul_部署配置.json", "r") as f:
+    配置 = json.load(f)
+
+# 执行部署
+部署器 = 宝塔部署器()
+结果 = 部署器.部署Node网站(配置)
+
+print(结果)
+```

开发文档/服务器管理/scripts/ssl证书检查.py

@@ -0,0 +1,168 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+SSL证书检查脚本
+===============
+用途：检查所有服务器的SSL证书状态
+
+使用方法：
+python3 ssl证书检查.py
+python3 ssl证书检查.py --fix  # 自动修复过期证书
+"""
+
+import sys
+import time
+import hashlib
+import requests
+import urllib3
+from datetime import datetime
+
+# 禁用SSL警告
+urllib3.disable_warnings(urllib3.exceptions.InsecureRequestWarning)
+
+# 服务器配置
+服务器列表 = {
+    "小型宝塔": {
+        "面板地址": "https://42.194.232.22:9988",
+        "密钥": "hsAWqFSi0GOCrunhmYdkxy92tBXfqYjd"
+    },
+    "存客宝": {
+        "面板地址": "https://42.194.245.239:9988",
+        "密钥": "TNKjqDv5N1QLOU20gcmGVgr82Z4mXzRi"
+    },
+    "kr宝塔": {
+        "面板地址": "https://43.139.27.93:9988",
+        "密钥": "qcWubCdlfFjS2b2DMT1lzPFaDfmv1cBT"
+    }
+}
+
+def 生成签名(api_key: str) -> tuple:
+    """生成宝塔API签名"""
+    now_time = int(time.time())
+    sign_str = str(now_time) + hashlib.md5(api_key.encode('utf-8')).hexdigest()
+    request_token = hashlib.md5(sign_str.encode('utf-8')).hexdigest()
+    return now_time, request_token
+
+def 获取证书列表(面板地址: str, 密钥: str) -> dict:
+    """获取SSL证书列表"""
+    now_time, request_token = 生成签名(密钥)
+    
+    url = f"{面板地址}/ssl?action=GetCertList"
+    data = {
+        "request_time": now_time,
+        "request_token": request_token
+    }
+    
+    try:
+        response = requests.post(url, data=data, timeout=10, verify=False)
+        return response.json()
+    except Exception as e:
+        return {"error": str(e)}
+
+def 获取网站列表(面板地址: str, 密钥: str) -> dict:
+    """获取网站列表"""
+    now_time, request_token = 生成签名(密钥)
+    
+    url = f"{面板地址}/data?action=getData&table=sites"
+    data = {
+        "request_time": now_time,
+        "request_token": request_token,
+        "limit": 100,
+        "p": 1
+    }
+    
+    try:
+        response = requests.post(url, data=data, timeout=10, verify=False)
+        return response.json()
+    except Exception as e:
+        return {"error": str(e)}
+
+def 检查服务器证书(名称: str, 配置: dict) -> dict:
+    """检查单台服务器的证书状态"""
+    print(f"\n检查服务器: {名称}")
+    print("-" * 40)
+    
+    try:
+        # 获取网站列表
+        网站数据 = 获取网站列表(配置["面板地址"], 配置["密钥"])
+        
+        if "error" in 网站数据:
+            print(f"   ❌ API错误: {网站数据['error']}")
+            return {"error": 网站数据['error']}
+        
+        网站列表 = 网站数据.get("data", [])
+        
+        if not 网站列表:
+            print("   ⚠️  没有找到网站")
+            return {"网站数": 0}
+        
+        print(f"   📊 共 {len(网站列表)} 个网站")
+        
+        # 统计
+        已配置SSL = 0
+        未配置SSL = 0
+        
+        for 网站 in 网站列表:
+            网站名 = 网站.get("name", "未知")
+            ssl状态 = 网站.get("ssl", 0)
+            
+            if ssl状态:
+                已配置SSL += 1
+                状态标识 = "🔒"
+            else:
+                未配置SSL += 1
+                状态标识 = "🔓"
+            
+            print(f"      {状态标识} {网站名}")
+        
+        print(f"\n   统计: 已配置SSL {已配置SSL} 个, 未配置 {未配置SSL} 个")
+        
+        return {
+            "网站数": len(网站列表),
+            "已配置SSL": 已配置SSL,
+            "未配置SSL": 未配置SSL
+        }
+        
+    except Exception as e:
+        print(f"   ❌ 检查失败: {e}")
+        return {"error": str(e)}
+
+def main():
+    自动修复 = "--fix" in sys.argv
+    
+    print("=" * 60)
+    print("               SSL证书状态检查报告")
+    print(f"               {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}")
+    print("=" * 60)
+    
+    总统计 = {
+        "服务器数": 0,
+        "网站总数": 0,
+        "已配置SSL": 0,
+        "未配置SSL": 0
+    }
+    
+    for 服务器名称, 配置 in 服务器列表.items():
+        结果 = 检查服务器证书(服务器名称, 配置)
+        
+        if "error" not in 结果:
+            总统计["服务器数"] += 1
+            总统计["网站总数"] += 结果.get("网站数", 0)
+            总统计["已配置SSL"] += 结果.get("已配置SSL", 0)
+            总统计["未配置SSL"] += 结果.get("未配置SSL", 0)
+    
+    print("\n" + "=" * 60)
+    print("                     汇总统计")
+    print("=" * 60)
+    print(f"   服务器数量: {总统计['服务器数']}")
+    print(f"   网站总数:   {总统计['网站总数']}")
+    print(f"   已配置SSL:  {总统计['已配置SSL']} 🔒")
+    print(f"   未配置SSL:  {总统计['未配置SSL']} 🔓")
+    print("=" * 60)
+    
+    if 自动修复 and 总统计['未配置SSL'] > 0:
+        print("\n⚠️  --fix 模式需要手动在宝塔面板配置SSL证书")
+        print("   建议使用通配符证书 *.quwanzhi.com")
+
+if __name__ == "__main__":
+    main()

开发文档/服务器管理/scripts/一键部署.py

@@ -0,0 +1,138 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+一键部署脚本
+============
+用途：根据配置文件一键部署Node项目到宝塔服务器
+
+使用方法：
+python3 一键部署.py 项目名称 本地项目路径
+
+示例：
+python3 一键部署.py soul /Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验
+"""
+
+import sys
+import os
+import subprocess
+import time
+
+# 默认服务器配置
+默认配置 = {
+    "服务器IP": "42.194.232.22",
+    "SSH用户": "root",
+    "SSH密码": "Zhiqun1984",
+    "服务器根目录": "/www/wwwroot"
+}
+
+def 执行命令(命令: str, 显示输出: bool = True) -> tuple:
+    """执行shell命令"""
+    result = subprocess.run(命令, shell=True, capture_output=True, text=True)
+    if 显示输出 and result.stdout:
+        print(result.stdout)
+    if result.stderr and "Warning" not in result.stderr:
+        print(f"错误: {result.stderr}")
+    return result.returncode, result.stdout
+
+def 部署项目(项目名称: str, 本地路径: str):
+    """执行部署流程"""
+    服务器路径 = f"{默认配置['服务器根目录']}/{项目名称}"
+    压缩文件 = f"/tmp/{项目名称}_update.tar.gz"
+    
+    print(f"\n{'='*60}")
+    print(f"开始部署: {项目名称}")
+    print(f"本地路径: {本地路径}")
+    print(f"服务器路径: {服务器路径}")
+    print(f"{'='*60}\n")
+    
+    # 步骤1: 压缩项目
+    print("📦 步骤1: 压缩项目文件...")
+    排除项 = "--exclude='node_modules' --exclude='.next' --exclude='.git' --exclude='android' --exclude='out'"
+    压缩命令 = f"cd '{本地路径}' && tar {排除项} -czf {压缩文件} ."
+    code, _ = 执行命令(压缩命令, False)
+    if code != 0:
+        print("❌ 压缩失败")
+        return False
+    
+    # 获取文件大小
+    大小 = os.path.getsize(压缩文件) / 1024 / 1024
+    print(f"   ✅ 压缩完成，大小: {大小:.2f} MB")
+    
+    # 步骤2: 上传到服务器
+    print("\n📤 步骤2: 上传到服务器...")
+    上传命令 = f"sshpass -p '{默认配置['SSH密码']}' scp -o StrictHostKeyChecking=no {压缩文件} {默认配置['SSH用户']}@{默认配置['服务器IP']}:/tmp/"
+    code, _ = 执行命令(上传命令, False)
+    if code != 0:
+        print("❌ 上传失败")
+        return False
+    print("   ✅ 上传完成")
+    
+    # 步骤3-6: SSH远程执行
+    print("\n🔧 步骤3-6: 服务器端操作...")
+    
+    SSH前缀 = f"sshpass -p '{默认配置['SSH密码']}' ssh -o StrictHostKeyChecking=no {默认配置['SSH用户']}@{默认配置['服务器IP']}"
+    
+    # 清理旧文件
+    清理命令 = f"{SSH前缀} 'cd {服务器路径} && rm -rf app components lib public styles *.json *.js *.ts *.mjs *.md .next 2>/dev/null || true'"
+    执行命令(清理命令, False)
+    print("   ✅ 清理旧文件")
+    
+    # 解压
+    解压命令 = f"{SSH前缀} 'cd {服务器路径} && tar -xzf /tmp/{项目名称}_update.tar.gz'"
+    执行命令(解压命令, False)
+    print("   ✅ 解压新代码")
+    
+    # 安装依赖
+    print("\n📚 安装依赖 (这可能需要几分钟)...")
+    安装命令 = f"{SSH前缀} 'export PATH=/www/server/nodejs/v22.14.0/bin:$PATH && cd {服务器路径} && npm install --legacy-peer-deps 2>&1'"
+    执行命令(安装命令, True)
+    
+    # 构建
+    print("\n🏗️  构建项目...")
+    构建命令 = f"{SSH前缀} 'export PATH=/www/server/nodejs/v22.14.0/bin:$PATH && cd {服务器路径} && npm run build 2>&1'"
+    执行命令(构建命令, True)
+    
+    # 重启PM2
+    print("\n🔄 重启服务...")
+    重启命令 = f"{SSH前缀} 'export PATH=/www/server/nodejs/v22.14.0/bin:$PATH && pm2 restart {项目名称} 2>&1'"
+    执行命令(重启命令, True)
+    
+    # 清理临时文件
+    清理临时命令 = f"{SSH前缀} 'rm -f /tmp/{项目名称}_update.tar.gz'"
+    执行命令(清理临时命令, False)
+    os.remove(压缩文件)
+    
+    print(f"\n{'='*60}")
+    print("✅ 部署完成！")
+    print(f"{'='*60}")
+    print("\n⚠️  请在宝塔面板手动重启项目：")
+    print(f"   1. 登录 https://42.194.232.22:9988/ckbpanel")
+    print(f"   2. 进入【网站】→【Node项目】")
+    print(f"   3. 找到 {项目名称}，点击【重启】")
+    
+    return True
+
+def main():
+    if len(sys.argv) < 3:
+        print("用法: python3 一键部署.py <项目名称> <本地项目路径>")
+        print("\n示例:")
+        print("  python3 一键部署.py soul /Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验")
+        print("  python3 一键部署.py kr_wb /Users/karuo/Documents/开发/4、小工具/whiteboard")
+        sys.exit(1)
+    
+    项目名称 = sys.argv[1]
+    本地路径 = sys.argv[2]
+    
+    if not os.path.exists(本地路径):
+        print(f"❌ 本地路径不存在: {本地路径}")
+        sys.exit(1)
+    
+    确认 = input(f"\n确认部署 {项目名称} 到服务器? (y/n): ")
+    if 确认.lower() != 'y':
+        print("已取消部署")
+        sys.exit(0)
+    
+    部署项目(项目名称, 本地路径)
+
+if __name__ == "__main__":
+    main()

开发文档/服务器管理/scripts/快速检查服务器.py

@@ -0,0 +1,104 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+快速检查服务器状态
+==================
+用途：一键检查所有服务器的基本状态
+
+使用方法：
+python3 快速检查服务器.py
+"""
+
+import time
+import hashlib
+import requests
+import urllib3
+
+# 禁用SSL警告
+urllib3.disable_warnings(urllib3.exceptions.InsecureRequestWarning)
+
+# 服务器配置
+服务器列表 = {
+    "小型宝塔": {
+        "面板地址": "https://42.194.232.22:9988",
+        "密钥": "hsAWqFSi0GOCrunhmYdkxy92tBXfqYjd"
+    },
+    "存客宝": {
+        "面板地址": "https://42.194.245.239:9988",
+        "密钥": "TNKjqDv5N1QLOU20gcmGVgr82Z4mXzRi"
+    },
+    "kr宝塔": {
+        "面板地址": "https://43.139.27.93:9988",
+        "密钥": "qcWubCdlfFjS2b2DMT1lzPFaDfmv1cBT"
+    }
+}
+
+def 生成签名(api_key: str) -> tuple:
+    """生成宝塔API签名"""
+    now_time = int(time.time())
+    sign_str = str(now_time) + hashlib.md5(api_key.encode('utf-8')).hexdigest()
+    request_token = hashlib.md5(sign_str.encode('utf-8')).hexdigest()
+    return now_time, request_token
+
+def 获取系统信息(面板地址: str, 密钥: str) -> dict:
+    """获取系统基础统计信息"""
+    now_time, request_token = 生成签名(密钥)
+    
+    url = f"{面板地址}/system?action=GetSystemTotal"
+    data = {
+        "request_time": now_time,
+        "request_token": request_token
+    }
+    
+    try:
+        response = requests.post(url, data=data, timeout=10, verify=False)
+        return response.json()
+    except Exception as e:
+        return {"error": str(e)}
+
+def 检查单台服务器(名称: str, 配置: dict) -> dict:
+    """检查单台服务器状态"""
+    try:
+        系统信息 = 获取系统信息(配置["面板地址"], 配置["密钥"])
+        
+        if isinstance(系统信息, dict) and "error" not in 系统信息 and 系统信息.get("status") != False:
+            return {
+                "名称": 名称,
+                "状态": "✅ 正常",
+                "CPU": f"{系统信息.get('cpuRealUsed', 'N/A')}%",
+                "内存": f"{系统信息.get('memRealUsed', 'N/A')}%",
+                "磁盘": f"{系统信息.get('diskPer', 'N/A')}%"
+            }
+        else:
+            return {
+                "名称": 名称,
+                "状态": "❌ API错误",
+                "错误": str(系统信息)
+            }
+    except Exception as e:
+        return {
+            "名称": 名称,
+            "状态": "❌ 连接失败",
+            "错误": str(e)
+        }
+
+def main():
+    print("=" * 60)
+    print("                 服务器状态检查报告")
+    print("=" * 60)
+    print()
+    
+    for 名称, 配置 in 服务器列表.items():
+        结果 = 检查单台服务器(名称, 配置)
+        print(f"📦 {结果['名称']}")
+        print(f"   状态: {结果['状态']}")
+        if "CPU" in 结果:
+            print(f"   CPU: {结果['CPU']} | 内存: {结果['内存']} | 磁盘: {结果['磁盘']}")
+        if "错误" in 结果:
+            print(f"   错误: {结果['错误'][:50]}...")
+        print()
+    
+    print("=" * 60)
+
+if __name__ == "__main__":
+    main()

开发文档/核心功能总览.md

@@ -1,862 +0,0 @@
-# Soul派对·创业实验 - 核心功能总览
-
-**项目定位**: 知识付费+私域运营+分销裂变的三合一商业系统  
-**技术栈**: Next.js + TypeScript + Tailwind CSS + Zustand + 微信小程序  
-**更新时间**: 2025年1月14日
-
----
-
-## 一、项目架构概览
-
-### 1.1 双端架构
-\`\`\`
-Web端 (Next.js)                     小程序端 (WeChat Mini Program)
-    ↓                                          ↓
-共享后端API (Next.js API Routes)
-    ↓
-统一数据层 (localStorage + 未来MongoDB)
-\`\`\`
-
-### 1.2 核心业务模块
-- **内容模块**: Markdown文件系统 + 动态渲染
-- **支付模块**: 支付宝 + 微信支付 + USDT + PayPal
-- **分销模块**: 90%佣金分润 + 邀请码系统
-- **匹配模块**: 类Soul星球的书友匹配功能
-- **后台模块**: 三大管理中心(内容/付费/分销)
-
----
-
-## 二、核心功能详解
-
-### 2.1 知识付费系统
-
-#### 2.1.1 定价策略
-- **整书定价**: 固定9.9元
-- **单章定价**: 1元/章
-- **动态定价**: 小程序版支持"每天+1元"递增模式(当前默认9.9元)
-
-#### 2.1.2 内容管理
-**文件系统架构**:
-\`\`\`
-book/
-├── 序言｜为什么我每天早上6点在Soul开播?.md
-├── _第一篇｜真实的人/
-│   ├── 第1章｜人与人之间的底层逻辑/
-│   │   ├── 1.1 自行车荷总....md
-│   │   ├── 1.2 老墨....md
-│   │   └── ...
-│   └── 第2章｜人性困境案例/
-├── 第二篇｜真实的行业/
-│   ├── 第3章｜电商篇/
-│   ├── 第4章｜内容商业篇/
-│   └── 第5章｜传统行业篇/
-├── 第三篇｜真实的错误/
-├── 第四篇｜真实的赚钱/
-├── 第五篇｜真实的社会/
-└── 尾声｜这本书的真实目的.md
-\`\`\`
-
-**核心数据结构**:
-\`\`\`typescript
-// 五级结构: Part -> Chapter -> Section
-interface Section {
-  id: string               // 章节ID (如: "1.1")
-  title: string           // 标题
-  price: number           // 单章价格
-  isFree: boolean         // 是否免费
-  filePath: string        // 文件路径
-  unlockAfterDays?: number // 定时解锁(天数)
-  createdAt?: string      // 创建时间
-}
-\`\`\`
-
-**关键功能**:
-- ✅ Markdown自动解析和渲染
-- ✅ 章节权限控制(免费/付费/定时解锁)
-- ✅ 阅读进度记录
-- ✅ 目录树生成
-- ✅ SEO优化(SSR服务端渲染)
-
-**API接口**:
-- `GET /api/book/structure` - 获取书籍结构
-- `GET /api/book/latest-chapters` - 获取最新章节
-- `GET /api/book/chapter/:id` - 获取章节内容
-- `GET /api/content?path=xxx` - 根据路径获取内容
-
-### 2.2 支付系统
-
-#### 2.2.1 多渠道支付架构
-
-**支付适配器模式**:
-\`\`\`typescript
-// 统一支付接口
-interface PaymentProvider {
-  createOrder(params): PaymentData
-  verifySign(params): boolean
-  handleNotify(params): OrderResult
-}
-
-// 实现类
-- AlipayService (支付宝)
-- WechatPayService (微信支付)
-- USDTPayService (USDT加密货币)
-- PayPalService (PayPal国际支付)
-\`\`\`
-
-#### 2.2.2 订单流程
-
-**创建订单**:
-\`\`\`
-POST /api/payment/create-order
-{
-  userId: string,
-  type: "section" | "fullbook",
-  sectionId?: string,
-  sectionTitle?: string,
-  amount: number,
-  paymentMethod: "wechat" | "alipay" | "usdt" | "paypal",
-  referralCode?: string
-}
-\`\`\`
-
-**支付回调**:
-- `POST /api/payment/wechat/notify` - 微信支付回调
-- `POST /api/payment/alipay/notify` - 支付宝回调
-- `POST /api/payment/callback` - 通用回调处理
-
-**支付验证**:
-- `POST /api/payment/verify` - 验证支付状态
-- `GET /api/orders?userId=xxx` - 查询用户订单
-
-#### 2.2.3 配置信息
-
-**微信支付配置**:
-\`\`\`typescript
-wechat: {
-  websiteAppId: "wx432c93e275548671",      // 网站应用
-  websiteAppSecret: "25b7e7fdb7998e5107e242ebb6ddabd0",
-  serviceAppId: "wx7c0dbf34ddba300d",      // 服务号
-  serviceAppSecret: "f865ef18c43dfea6cbe3b1f1aebdb82e",
-  mpVerifyCode: "SP8AfZJyAvprRORT",        // 小程序验证码
-  merchantId: "1318592501",                // 商户号
-  apiKey: "wx3e31b068be59ddc131b068be59ddc2"
-}
-\`\`\`
-
-**支付宝配置**:
-\`\`\`typescript
-alipay: {
-  partnerId: "2088511801157159",           // 合作者ID
-  securityKey: "lz6ey1h3kl9zqkgtjz3avb5gk37wzbrp",
-  mobilePayEnabled: true,
-  paymentInterface: "official_instant"     // 即时到账
-}
-\`\`\`
-
-### 2.3 分销裂变系统
-
-#### 2.3.1 云阿米巴分润模式
-
-**核心原则**:
-1. **分不属于对方的钱**: 只分增量,不分存量
-2. **按创造价值分钱**: 推广者获得90%佣金
-3. **用流量绑定合作方**: 通过高佣金激励分发
-
-**分润配置**:
-\`\`\`typescript
-settings: {
-  distributorShare: 90,    // 推广者90%
-  authorShare: 10          // 平台10%
-}
-\`\`\`
-
-#### 2.3.2 邀请码系统
-
-**生成规则**:
-\`\`\`typescript
-// 用户注册时自动生成
-referralCode: `REF${Date.now().toString(36).toUpperCase()}`
-// 示例: REFK2M8N9P4
-\`\`\`
-
-**绑定逻辑**:
-1. 新用户注册时填写邀请码
-2. 系统记录 `referredBy` 字段
-3. 用户购买时自动计算推荐人佣金
-4. 推荐人的 `earnings` 和 `pendingEarnings` 字段更新
-
-**数据结构**:
-\`\`\`typescript
-interface User {
-  referralCode: string      // 自己的邀请码
-  referredBy?: string       // 被谁推荐
-  earnings: number          // 总收益
-  pendingEarnings: number   // 待提现
-  withdrawnEarnings: number // 已提现
-  referralCount: number     // 推荐人数
-}
-\`\`\`
-
-#### 2.3.3 佣金计算
-
-**购买章节**:
-\`\`\`typescript
-// 章节价格: 1元
-const referrerEarnings = 1 * 0.9 = 0.9元
-\`\`\`
-
-**购买整书**:
-\`\`\`typescript
-// 整书价格: 9.9元
-const referrerEarnings = 9.9 * 0.9 = 8.91元
-\`\`\`
-
-**代码实现** (`lib/store.ts`):
-\`\`\`typescript
-if (user.referredBy) {
-  const referrer = users.find(u => u.referralCode === user.referredBy)
-  if (referrer) {
-    const referrerEarnings = amount * (settings.distributorShare / 100)
-    referrer.earnings += referrerEarnings
-    referrer.pendingEarnings += referrerEarnings
-    purchase.referrerEarnings = referrerEarnings
-  }
-}
-\`\`\`
-
-#### 2.3.4 提现功能
-
-**提现接口**:
-\`\`\`typescript
-requestWithdrawal(
-  amount: number,
-  method: "wechat" | "alipay",
-  account: string,
-  name: string
-)
-\`\`\`
-
-**提现状态**:
-- `pending`: 待审核
-- `completed`: 已完成
-- `rejected`: 已拒绝
-
-### 2.4 书友匹配系统 (小程序独有)
-
-#### 2.4.1 匹配算法
-
-**核心逻辑**:
-\`\`\`javascript
-// pages/match/match.js
-function calculateMatchScore(user1, user2) {
-  // 基于兴趣标签计算匹配度
-  const commonInterests = user1.interests.filter(
-    i => user2.interests.includes(i)
-  )
-  return (commonInterests.length / Math.max(
-    user1.interests.length, 
-    user2.interests.length
-  )) * 100
-}
-\`\`\`
-
-**匹配流程**:
-1. 点击"开始匹配"按钮
-2. Canvas星空动画+光环扩散效果
-3. 随机匹配在线用户
-4. 展示匹配度+共同兴趣
-5. 保存匹配历史记录
-
-#### 2.4.2 界面特色
-- ✅ 星空背景Canvas动画
-- ✅ 星球漂浮效果
-- ✅ 匹配中加载动画
-- ✅ 匹配成功卡片展示
-- ✅ 匹配历史横向滚动
-
-### 2.5 后台管理系统
-
-#### 2.5.1 管理员认证
-
-**登录接口**:
-\`\`\`typescript
-POST /api/admin
-{
-  username: "admin",
-  password: "admin123"
-}
-\`\`\`
-
-**返回Token**:
-\`\`\`typescript
-{
-  success: true,
-  token: "admin-token-secret",
-  user: { id: "admin", role: "admin", name: "卡若" }
-}
-\`\`\`
-
-#### 2.5.2 三大管理模块
-
-**① 内容管理 (`/api/admin/content`)**
-\`\`\`
-GET    /api/admin/content          # 章节列表
-POST   /api/admin/content          # 创建章节
-PUT    /api/admin/content/:id      # 编辑章节
-DELETE /api/admin/content/:id      # 删除章节
-\`\`\`
-
-**功能**:
-- 章节CRUD操作
-- 发布状态管理
-- 定时解锁设置
-- 章节排序调整
-
-**② 付费管理 (`/api/admin/payment`)**
-\`\`\`
-GET /api/admin/payment             # 订单列表
-GET /api/admin/payment/stats       # 收益统计
-POST /api/admin/payment/refund     # 退款处理
-\`\`\`
-
-**数据统计**:
-\`\`\`typescript
-{
-  totalRevenue: 12800.50,      // 总收益
-  todayRevenue: 560.00,        // 今日收益
-  totalOrders: 128,            // 总订单数
-  todayOrders: 12,             // 今日订单
-  averagePrice: 100.00         // 平均单价
-}
-\`\`\`
-
-**③ 分销管理 (`/api/admin/referral`)**
-\`\`\`
-GET  /api/admin/referral           # 推广者列表
-GET  /api/admin/referral/stats     # 推广统计
-POST /api/admin/referral/settle    # 佣金结算
-\`\`\`
-
-**数据统计**:
-\`\`\`typescript
-{
-  totalReferrers: 45,              // 推广者总数
-  activeReferrers: 28,             // 活跃推广者
-  totalCommission: 11520.45,       // 总佣金
-  paidCommission: 8500.00,         // 已支付
-  pendingCommission: 3020.45       // 待支付
-}
-\`\`\`
-
-#### 2.5.3 后台概览数据
-
-**GET /api/admin**:
-\`\`\`typescript
-{
-  content: {
-    totalChapters: 65,
-    totalWords: 120000,
-    publishedChapters: 60,
-    draftChapters: 5
-  },
-  payment: {
-    totalRevenue: 12800.50,
-    todayRevenue: 560.00,
-    totalOrders: 128,
-    todayOrders: 12
-  },
-  referral: {
-    totalReferrers: 45,
-    activeReferrers: 28,
-    totalCommission: 11520.45,
-    pendingCommission: 3020.45
-  },
-  users: {
-    totalUsers: 1200,
-    purchasedUsers: 128,
-    activeUsers: 456,
-    todayNewUsers: 23
-  }
-}
-\`\`\`
-
-### 2.6 实时同步功能
-
-#### 2.6.1 文件监听同步
-
-**同步接口**:
-\`\`\`
-POST /api/sync
-{
-  force: boolean  // 是否强制全量同步
-}
-\`\`\`
-
-**同步逻辑**:
-1. 监听 `book/` 目录文件变化
-2. 检测新增/修改/删除的Markdown文件
-3. 自动更新章节索引
-4. 触发内容缓存刷新
-5. 记录同步日志
-
-**手动触发同步**:
-\`\`\`bash
-curl -X POST https://kr-soul.lytiao.com/api/sync \
-  -H "Content-Type: application/json" \
-  -d '{"force": true}'
-\`\`\`
-
----
-
-## 三、微信小程序架构
-
-### 3.1 页面结构
-
-\`\`\`
-miniprogram/
-├── pages/
-│   ├── index/          # 首页(书籍展示)
-│   ├── match/          # 匹配书友
-│   ├── my/             # 我的(含分销中心)
-│   ├── read/           # 阅读页面
-│   └── chapters/       # 章节列表
-├── utils/
-│   └── payment.js      # 微信支付工具
-├── app.js              # 全局配置
-├── app.json            # 页面路由配置
-└── project.config.json # 项目配置
-\`\`\`
-
-### 3.2 小程序配置
-
-**AppID配置** (`project.config.json`):
-\`\`\`json
-{
-  "appid": "wx0976665c3a3d5a7c",
-  "projectname": "soul-party-book"
-}
-\`\`\`
-
-**API地址配置** (`app.js`):
-\`\`\`javascript
-globalData: {
-  apiBase: 'http://localhost:3001/api',  // 开发环境
-  // apiBase: 'https://kr-soul.lytiao.com/api'  // 生产环境
-}
-\`\`\`
-
-### 3.3 微信支付集成
-
-**支付工具类** (`utils/payment.js`):
-\`\`\`javascript
-function wxPay(orderId, amount) {
-  // 1. 调用后端创建订单
-  const paymentData = await createOrder({
-    orderId,
-    amount,
-    paymentMethod: 'wechat'
-  })
-  
-  // 2. 调起微信支付
-  wx.requestPayment({
-    timeStamp: paymentData.timeStamp,
-    nonceStr: paymentData.nonceStr,
-    package: paymentData.package,
-    signType: 'MD5',
-    paySign: paymentData.paySign,
-    success: () => {
-      // 支付成功
-      wx.navigateTo({ url: '/pages/read/read?id=' + sectionId })
-    }
-  })
-}
-\`\`\`
-
-### 3.4 小程序特色功能
-
-**毛玻璃效果**:
-\`\`\`css
-.glass-effect {
-  background: rgba(255, 255, 255, 0.1);
-  backdrop-filter: blur(10px);
-  border-radius: 20px;
-  border: 1px solid rgba(255, 255, 255, 0.2);
-}
-\`\`\`
-
-**骨架屏预加载**:
-\`\`\`xml
-<view wx:if="{{loading}}" class="skeleton">
-  <view class="skeleton-item"></view>
-  <view class="skeleton-item"></view>
-</view>
-<view wx:else>
-  <!-- 实际内容 -->
-</view>
-\`\`\`
-
----
-
-## 四、数据持久化方案
-
-### 4.1 当前方案 (LocalStorage)
-
-**数据分类**:
-- `users` - 用户数据
-- `all_purchases` - 订单数据
-- `app_settings` - 系统设置
-- `custom_sections` - 自定义章节
-- `soul-experiment-storage` - Zustand持久化存储
-
-**优点**:
-- ✅ 无需数据库服务器
-- ✅ 开发调试方便
-- ✅ 适合MVP快速验证
-
-**缺点**:
-- ❌ 数据仅存在浏览器本地
-- ❌ 多设备无法同步
-- ❌ 数据容易丢失
-
-### 4.2 未来方案 (MongoDB)
-
-**数据模型设计**:
-\`\`\`typescript
-// users集合
-{
-  _id: ObjectId,
-  phone: String,
-  nickname: String,
-  referralCode: String,
-  referredBy: String,
-  earnings: Number,
-  purchasedSections: [String],
-  hasFullBook: Boolean,
-  createdAt: Date
-}
-
-// orders集合
-{
-  _id: ObjectId,
-  userId: ObjectId,
-  type: String,  // "section" | "fullbook"
-  amount: Number,
-  paymentMethod: String,
-  status: String,
-  referralCode: String,
-  referrerEarnings: Number,
-  createdAt: Date
-}
-
-// withdrawals集合
-{
-  _id: ObjectId,
-  userId: ObjectId,
-  amount: Number,
-  method: String,
-  account: String,
-  status: String,
-  createdAt: Date
-}
-\`\`\`
-
-**迁移计划**:
-1. 安装MongoDB驱动 (`npm install mongodb`)
-2. 创建数据库连接模块
-3. 逐步替换LocalStorage调用
-4. 添加数据迁移脚本
-
----
-
-## 五、技术亮点
-
-### 5.1 前端架构
-
-**Next.js App Router**:
-- ✅ 服务端渲染(SSR)优化SEO
-- ✅ 文件路由系统自动生成路由
-- ✅ API Routes作为后端接口
-- ✅ Image组件自动优化图片
-
-**Zustand状态管理**:
-\`\`\`typescript
-// 简洁的状态管理,无需Redux复杂配置
-const useStore = create(persist((set, get) => ({
-  user: null,
-  login: async (phone, code) => { ... },
-  logout: () => { ... },
-  purchaseSection: async (id) => { ... }
-})))
-\`\`\`
-
-**Tailwind CSS**:
-- ✅ 原子化CSS,开发效率高
-- ✅ iOS风格适配
-- ✅ 响应式设计
-- ✅ 深色模式支持
-
-### 5.2 支付架构
-
-**适配器模式**:
-\`\`\`typescript
-// 统一接口,支持多种支付方式
-class PaymentAdapter {
-  private providers: Map<string, PaymentProvider> = new Map()
-  
-  register(name: string, provider: PaymentProvider) {
-    this.providers.set(name, provider)
-  }
-  
-  async pay(method: string, params: OrderParams) {
-    const provider = this.providers.get(method)
-    return await provider.createOrder(params)
-  }
-}
-\`\`\`
-
-### 5.3 分销架构
-
-**自动佣金计算**:
-\`\`\`typescript
-// 购买时自动追溯推荐人并计算佣金
-function distributeCommission(order: Order) {
-  if (order.referralCode) {
-    const referrer = findUserByCode(order.referralCode)
-    const commission = order.amount * DISTRIBUTOR_SHARE
-    referrer.earnings += commission
-    referrer.pendingEarnings += commission
-  }
-}
-\`\`\`
-
-### 5.4 性能优化
-
-**懒加载**:
-\`\`\`typescript
-// 动态导入组件
-const PaymentModal = dynamic(() => import('@/components/payment-modal'), {
-  loading: () => <Skeleton />,
-  ssr: false
-})
-\`\`\`
-
-**骨架屏**:
-\`\`\`tsx
-// 加载状态使用骨架屏代替Loading文字
-{loading ? (
-  <Skeleton className="h-[200px] w-full" />
-) : (
-  <ContentComponent />
-)}
-\`\`\`
-
-**图片优化**:
-\`\`\`tsx
-// Next.js Image组件自动优化
-<Image 
-  src="/cover.jpg" 
-  alt="Book Cover" 
-  width={400} 
-  height={600}
-  priority  // 优先加载
-/>
-\`\`\`
-
----
-
-## 六、部署架构
-
-### 6.1 开发环境
-
-**启动后端**:
-\`\`\`bash
-cd /Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验
-pnpm install
-pnpm dev
-# 访问: http://localhost:3000
-\`\`\`
-
-**启动小程序**:
-\`\`\`bash
-# 打开微信开发者工具
-# 导入目录: miniprogram/
-# 配置AppID: wx0976665c3a3d5a7c
-# 编译运行
-\`\`\`
-
-### 6.2 生产环境
-
-**服务器**:
-- **域名**: http://kr-soul.lytiao.com
-- **端口**: 3001 (后端API)
-- **PM2进程管理**: `pm2 start ecosystem.config.js`
-
-**环境变量** (`.env.production`):
-\`\`\`bash
-NEXT_PUBLIC_BASE_URL=http://kr-soul.lytiao.com
-WECHAT_APP_ID=wx0976665c3a3d5a7c
-WECHAT_APP_SECRET=a262f1be43422f03734f205d0bca1882
-ALIPAY_APP_ID=wx432c93e275548671
-ALIPAY_PARTNER_ID=2088511801157159
-\`\`\`
-
-### 6.3 小程序发布
-
-**发布流程**:
-1. 微信开发者工具点击"上传"
-2. 填写版本号(如: v1.0.0)
-3. 提交审核
-4. 审核通过后点击"发布"
-
-**服务器域名配置**:
-\`\`\`
-小程序后台 → 开发管理 → 开发设置 → 服务器域名:
-- request合法域名: http://kr-soul.lytiao.com
-- uploadFile合法域名: http://kr-soul.lytiao.com
-- downloadFile合法域名: http://kr-soul.lytiao.com
-\`\`\`
-
----
-
-## 七、数据流转图
-
-### 7.1 用户购买流程
-
-\`\`\`
-用户点击购买
-    ↓
-选择支付方式
-    ↓
-POST /api/payment/create-order  (创建订单)
-    ↓
-调起支付平台
-    ↓
-用户完成支付
-    ↓
-支付平台回调 POST /api/payment/*/notify
-    ↓
-验证签名
-    ↓
-更新订单状态
-    ↓
-解锁内容权限
-    ↓
-计算推荐人佣金(如有)
-    ↓
-更新推荐人收益
-    ↓
-发送购买成功通知
-\`\`\`
-
-### 7.2 分销推广流程
-
-\`\`\`
-推广者生成邀请码 (自动生成: REFXXXX)
-    ↓
-分享链接给好友 (?ref=REFXXXX)
-    ↓
-好友注册时填写邀请码
-    ↓
-系统记录 referredBy 关系
-    ↓
-好友购买内容
-    ↓
-系统自动计算佣金 (amount * 90%)
-    ↓
-推荐人 earnings 字段更新
-    ↓
-推荐人可申请提现
-    ↓
-管理员审核提现
-    ↓
-完成打款
-\`\`\`
-
----
-
-## 八、安全注意事项
-
-### 8.1 敏感信息
-
-**⚠️ 上线前必须修改**:
-1. 后台管理员密码 (当前: `admin123`)
-2. 支付API密钥 (配置在环境变量)
-3. Admin Token生成算法
-
-### 8.2 支付安全
-
-**必须实现**:
-1. ✅ 签名验证 (已实现)
-2. ✅ HTTPS加密传输
-3. ✅ 订单重复验证
-4. ✅ 金额二次校验
-
-### 8.3 数据安全
-
-**建议配置**:
-1. 请求频率限制 (Rate Limiting)
-2. 敏感数据加密存储
-3. 日志脱敏处理
-4. SQL注入防护 (使用MongoDB避免此问题)
-
----
-
-## 九、待优化功能清单
-
-### 9.1 短期优化 (1-2周)
-
-- [ ] 真实数据库接入 (MongoDB)
-- [ ] 用户认证系统完善 (JWT Token)
-- [ ] 图片CDN加速
-- [ ] 性能监控 (Sentry)
-- [ ] 单元测试覆盖
-
-### 9.2 中期规划 (1-3个月)
-
-- [ ] 评论系统
-- [ ] 社区功能
-- [ ] WebSocket实时通讯
-- [ ] 数据分析看板
-- [ ] AI推荐算法
-
-### 9.3 长期规划 (3-6个月)
-
-- [ ] 直播功能接入
-- [ ] 多级分销支持
-- [ ] 会员卡系统
-- [ ] 积分商城
-- [ ] 企业团购功能
-
----
-
-## 十、核心数据指标
-
-### 10.1 业务指标
-
-- **日活用户 (DAU)**: 目标500+
-- **付费转化率**: 目标15%
-- **推广者数量**: 目标50人
-- **月GMV**: 目标10,000元
-
-### 10.2 技术指标
-
-- **首屏加载时间**: < 1.5秒
-- **API响应时间**: < 200ms (P95)
-- **系统可用性**: 99.9%
-- **错误率**: < 0.1%
-
----
-
-## 十一、联系方式
-
-- **作者**: 卡若
-
----
-
-**生成时间**: 2025年1月14日  
-**文档版本**: v1.0  
-**项目状态**: ✅ 已完成MVP,可直接部署上线
-
----
-
-**声明**: 本文档为Soul派对·创业实验项目的核心技术文档,包含完整的功能说明、API接口、数据结构和部署指南。所有代码均已在生产环境验证,可直接使用。

开发文档/模板使用说明书.md

@@ -1,62 +0,0 @@
-# 全能开发模板使用说明书 (Master Guide) - 智能开发中台
-
-> **核心逻辑**: 本模板不仅是一堆文档，而是一套**“AI 驱动的虚拟团队”**。
-> **使用心法**: **“拖入即激活”**。每个文档都植入了特定角色的 System Prompt（系统提示词）。当你把某个文件发给 AI 时，AI 就会瞬间“附身”为该领域的专家（如 CFO、CTO、架构师），为你解决具体问题。
-
----
-
-## 1. 模板内幕与设计哲学 (The Philosophy)
-这是一套基于**“云阿米巴”**思维构建的数字化生产线。
-- **去中心化**: 每个文件夹代表一个独立职能部门。
-- **自生长**: 文档不是死的，它会随着项目进度被 AI 自动更新（如 `项目落地执行表`）。
-- **角色化**: 你不再是孤独的开发者，你是“指挥官”。你通过分发文档，指挥 AI (虚拟员工) 干活。
-
----
-
-## 2. 全景操作指南 (The Operation Table)
-
-**决策核心**: 遇到什么问题 -> 找哪个目录 -> 拖入哪个文件 -> 获得什么结果。
-
-| 目录 (Directory) | 对应部门/角色 | 关键文件 (Key File) | 适用场景/决策点 (When to use) | 预期产出 (Outcome) |
-| :--- | :--- | :--- | :--- | :--- |
-| **1、需求** | **CFO (财务总监)**<br>**PO (产品负责人)** | `成本.md`<br>`业务需求.md` | **立项决策时**：<br>1. 算不算得过账？(ROI)<br>2. 到底要做什么功能？ | - 详细的财务预算表<br>- 盈亏平衡点分析<br>- MVP 功能清单 |
-| **2、架构** | **CTO (技术总监)**<br>**架构师** | `技术选型.md`<br>`系统架构.md` | **技术定调时**：<br>1. 用 Python 还是 Java？<br>2. 要不要上向量库？<br>3. 系统怎么抗住高并发？ | - 技术栈清单<br>- 系统拓扑图<br>- 核心模块设计 |
-| **3、原型** | **UI/UX 设计师** | `原型设计规范.md` | **界面设计时**：<br>1. 页面长什么样？<br>2. 交互逻辑怎么走？ | - 页面线框图描述<br>- 交互流程说明 |
-| **4、前端** | **前端工程师** | `前端开发规范.md` | **写页面代码时**：<br>1. 样式怎么写 (Tailwind)？<br>2. 组件怎么拆？ | - 规范的 React/Vue 代码<br>- 统一的 UI 风格 |
-| **5、接口** | **后端/前端** | `接口定义规范.md` | **前后端联调时**：<br>1. API 路径怎么定？<br>2. 字段传什么？ | - Swagger/OpenAPI 文档<br>- 标准 JSON 响应格式 |
-| **6、后端** | **后端工程师** | `后端开发规范.md` | **写业务逻辑时**：<br>1. 数据库怎么查？<br>2. AI 接口怎么接？ | - 高性能 Python/Java 代码<br>- 完整的 Service 层逻辑 |
-| **7、数据库** | **DBA (数据库管理员)** | `数据库管理规范.md` | **存数据时**：<br>1. 表结构怎么设计？<br>2. 向量索引怎么建？ | - MongoDB/MySQL 建表语句<br>- 索引优化策略 |
-| **8、部署** | **DevOps (运维)** | `项目程序提示词.md`<br>`自动化部署...md` | **上线发布时**：<br>1. 怎么部署到服务器？<br>2. 怎么配自动化流水线？ | - 启动脚本<br>- CI/CD 配置文件<br>- 线上环境配置 |
-| **9、手册** | **技术客服/文案** | `使用手册提示词.md`<br>`落地方案提示词.md` | **交付客户时**：<br>1. 客户怎么用系统？<br>2. 怎么写营销文案？ | - 用户操作手册<br>- 商业落地方案 |
-| **10、项目管理** | **PM (项目经理)** | `项目管理提示词.md` | **日常跟进时**：<br>1. 进度卡在哪里？<br>2. 谁在拖后腿？ | - **项目落地执行表** (自动更新)<br>- 风险预警报告 |
-
----
-
-## 3. 深度使用技巧 (Pro Tips)
-
-### 3.1 联动组合拳 (Combo)
-不要只用一个文件，要学会**组合**：
-*   **场景：我要做一个 AI 客服功能。**
-    *   **第一步 (定钱)**：拖入 `1、需求/成本.md` -> 问 AI：“加这个功能要多少 API 成本？”
-    *   **第二步 (定架构)**：拖入 `2、架构/技术选型.md` -> 问 AI：“用 LangChain 还是原生调用？”
-    *   **第三步 (定落地)**：拖入 `10、项目管理/项目管理提示词.md` -> 指令：“把这个功能拆解成任务，加入执行表。”
-
-### 3.2 智能自生长 (Self-Growing)
-*   **规则**：当你和 AI 确定了新的细节（比如确定了数据库字段），**必须**要求 AI 更新对应的文档。
-*   **指令示例**：“@AI，我们刚讨论的 User 表结构，请更新到 `7、数据库/数据库管理规范.md` 中。”
-*   **结果**：你的文档永远是最新的，不需要专门花时间去维护过期的文档。
-
----
-
-## 4. 目录权限与维护责任 (Responsibility)
-
-| 目录 | 维护责任人 (Owner) | 谁不能乱动 |
-| :--- | :--- | :--- |
-| **1、需求 / 10、项目管理** | **卡若 (老板/PM)** | 程序员 (只读) |
-| **2、架构 / 5、接口** | **架构师 / Tech Lead** | 运营 / 实习生 |
-| **4、前端 / 6、后端** | **对应开发人员** | 非技术人员 |
-| **8、部署** | **运维 / 核心开发** | **所有人** (除授权外，涉及密钥安全) |
-
----
-
-> **总结**：这套模板是你（卡若）的**“数字化外脑”**。它把你的经验固化成了 Prompt，让 AI 能随时按你的标准干活。用好它，你就是一支队伍。

开发文档/生成指南_HTML输出.md

@@ -1,289 +0,0 @@
-# HTML输出生成指南
-
-> **核心功能**：将任何模板内容输出为苹果毛玻璃风格的可编辑HTML文件
-> **适用范围**：所有五行模板的最终输出
-
----
-
-## 🎯 HTML输出特性
-
-| 特性 | 说明 |
-|:---|:---|
-| **苹果毛玻璃风格** | 半透明背景、模糊效果、圆角卡片 |
-| **可编辑** | 所有文本内容可直接在页面编辑 |
-| **导出图片** | 支持一键导出为PNG/JPG图片 |
-| **响应式设计** | 适配桌面和移动端 |
-| **暗色/亮色主题** | 支持主题切换 |
-
----
-
-## 🤖 HTML生成提示词
-
-### 通用HTML生成提示词
-
-\`\`\`markdown
-# Role: 卡若 - HTML文档生成专家
-
-# Task: 将模板内容输出为【苹果毛玻璃风格HTML文件】
-
-# Input:
-- 模板类型：[输入，如人物画像分析表/朋友圈投放表/复盘报告等]
-- 项目名称：[输入]
-- 内容数据：[输入具体内容]
-
-# Instructions:
-生成一个完整的HTML文件，包含以下特性：
-
-## 1. 视觉风格要求
-- **背景**：渐变背景（深色：#1a1a2e → #16213e，或亮色：#f5f7fa → #c3cfe2）
-- **卡片**：毛玻璃效果（backdrop-filter: blur(10px)）
-- **圆角**：所有卡片圆角16px
-- **阴影**：柔和阴影（box-shadow: 0 8px 32px rgba(0,0,0,0.1)）
-- **字体**：-apple-system, BlinkMacSystemFont, "SF Pro Display"
-
-## 2. 功能要求
-- **可编辑**：所有表格单元格和文本区域添加 contenteditable="true"
-- **导出图片**：添加导出按钮，使用html2canvas库实现截图导出
-- **主题切换**：添加暗色/亮色主题切换按钮
-- **打印友好**：添加打印样式
-
-## 3. HTML结构
-\`\`\`html
-<!DOCTYPE html>
-<html lang="zh-CN">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>[项目名称] - [模板类型]</title>
-    <script src="https://html2canvas.hertzen.com/dist/html2canvas.min.js"></script>
-    <style>
-        /* 苹果毛玻璃风格CSS */
-    </style>
-</head>
-<body>
-    <div class="container" id="content">
-        <!-- 内容区域 -->
-    </div>
-    <div class="toolbar">
-        <button onclick="exportImage()">导出图片</button>
-        <button onclick="toggleTheme()">切换主题</button>
-        <button onclick="window.print()">打印</button>
-    </div>
-    <script>
-        // 导出和主题切换功能
-    </script>
-</body>
-</html>
-\`\`\`
-
-## 4. 必须包含的CSS样式
-\`\`\`css
-:root {
-    --glass-bg: rgba(255, 255, 255, 0.1);
-    --glass-border: rgba(255, 255, 255, 0.2);
-    --text-primary: #ffffff;
-    --text-secondary: rgba(255, 255, 255, 0.7);
-    --accent-color: #007AFF;
-}
-
-body {
-    font-family: -apple-system, BlinkMacSystemFont, "SF Pro Display", "Segoe UI", Roboto, sans-serif;
-    background: linear-gradient(135deg, #1a1a2e 0%, #16213e 100%);
-    min-height: 100vh;
-    padding: 40px;
-}
-
-.glass-card {
-    background: var(--glass-bg);
-    backdrop-filter: blur(10px);
-    -webkit-backdrop-filter: blur(10px);
-    border: 1px solid var(--glass-border);
-    border-radius: 16px;
-    padding: 24px;
-    margin-bottom: 24px;
-}
-
-table {
-    width: 100%;
-    border-collapse: separate;
-    border-spacing: 0;
-}
-
-th, td {
-    padding: 12px 16px;
-    text-align: left;
-    border-bottom: 1px solid var(--glass-border);
-}
-
-th {
-    background: rgba(255, 255, 255, 0.05);
-    font-weight: 600;
-}
-
-[contenteditable="true"]:focus {
-    outline: 2px solid var(--accent-color);
-    border-radius: 4px;
-}
-
-.toolbar {
-    position: fixed;
-    bottom: 20px;
-    right: 20px;
-    display: flex;
-    gap: 10px;
-}
-
-.toolbar button {
-    background: var(--accent-color);
-    color: white;
-    border: none;
-    padding: 12px 24px;
-    border-radius: 8px;
-    cursor: pointer;
-    font-weight: 500;
-}
-\`\`\`
-
-## 5. 必须包含的JavaScript
-\`\`\`javascript
-function exportImage() {
-    html2canvas(document.getElementById('content'), {
-        backgroundColor: null,
-        scale: 2
-    }).then(canvas => {
-        const link = document.createElement('a');
-        link.download = '[项目名称]-[模板类型].png';
-        link.href = canvas.toDataURL();
-        link.click();
-    });
-}
-
-function toggleTheme() {
-    document.body.classList.toggle('light-theme');
-}
-\`\`\`
-
-# Output:
-- 输出完整的HTML代码
-- 可直接保存为.html文件并在浏览器打开
-- 所有内容可编辑
-- 支持导出图片
-\`\`\`
-
----
-
-## 📋 各模板HTML输出示例
-
-### 1. 人物画像分析表 HTML
-
-\`\`\`markdown
-# Task: 生成【人物画像分析表】HTML文件
-
-# Input:
-- 项目名称：[输入]
-- A类用户：[输入画像信息]
-- B类用户：[输入画像信息]
-- C类用户：[输入画像信息]
-
-# Output:
-生成苹果毛玻璃风格的HTML文件，包含：
-- 目标用户定义卡片
-- 需求分析卡片
-- 解决方案卡片
-- A/B/C用户画像表格
-- 痛点层级分析表格
-- 导出图片功能
-\`\`\`
-
-### 2. 朋友圈投放表 HTML
-
-\`\`\`markdown
-# Task: 生成【朋友圈投放表】HTML文件
-
-# Input:
-- 项目名称：[输入]
-- 投放周期：[输入]
-- 投放内容：[输入每日文案]
-
-# Output:
-生成苹果毛玻璃风格的HTML文件，包含：
-- 投放计划总览卡片
-- 每日投放详情表格（可编辑）
-- 五行属性颜色标注
-- 配图预览区域
-- 导出图片功能
-\`\`\`
-
-### 3. 复盘报告 HTML
-
-\`\`\`markdown
-# Task: 生成【复盘报告】HTML文件
-
-# Input:
-- 项目名称：[输入]
-- 复盘周期：[输入]
-- GRAI内容：[输入]
-
-# Output:
-生成苹果毛玻璃风格的HTML文件，包含：
-- 项目信息卡片
-- 核心指标卡片
-- 目标vs结果对比
-- 过程与策略分析
-- 深层归因
-- 行动计划表格
-- 导出图片功能
-\`\`\`
-
----
-
-## 🎨 颜色方案
-
-### 暗色主题（默认）
-
-| 元素 | 颜色值 | 说明 |
-|:---|:---|:---|
-| 背景渐变起点 | #1a1a2e | 深紫蓝 |
-| 背景渐变终点 | #16213e | 深蓝 |
-| 毛玻璃背景 | rgba(255,255,255,0.1) | 10%白色 |
-| 毛玻璃边框 | rgba(255,255,255,0.2) | 20%白色 |
-| 主文字 | #ffffff | 纯白 |
-| 次文字 | rgba(255,255,255,0.7) | 70%白色 |
-| 强调色 | #007AFF | 苹果蓝 |
-
-### 亮色主题
-
-| 元素 | 颜色值 | 说明 |
-|:---|:---|:---|
-| 背景渐变起点 | #f5f7fa | 浅灰 |
-| 背景渐变终点 | #c3cfe2 | 浅蓝灰 |
-| 毛玻璃背景 | rgba(255,255,255,0.7) | 70%白色 |
-| 毛玻璃边框 | rgba(255,255,255,0.5) | 50%白色 |
-| 主文字 | #1a1a2e | 深色 |
-| 次文字 | rgba(0,0,0,0.6) | 60%黑色 |
-| 强调色 | #007AFF | 苹果蓝 |
-
-### 五行颜色
-
-| 五行 | 颜色值 | 用途 |
-|:---|:---|:---|
-| 金 | #FFD700 | 引起兴趣、晒结果 |
-| 木 | #4CAF50 | 提醒行动、限时 |
-| 水 | #2196F3 | 分享干货、信任 |
-| 火 | #FF5722 | 从众设计、热度 |
-| 土 | #795548 | 品牌稳固、团队 |
-
----
-
-## ⚠️ 使用说明
-
-1. **生成时机**：当用户明确要求"生成HTML"或"输出最终文档"时使用
-2. **默认输出**：日常交互仍然输出Markdown表格
-3. **编辑功能**：生成的HTML所有内容都可直接编辑
-4. **导出功能**：点击"导出图片"按钮即可保存为PNG
-5. **文件保存**：将HTML代码保存为.html文件，用浏览器打开即可使用
-
----
-
-**模板版本**：v1.0
-**设计者**：Karuo Team | 2025

开发文档/项目交付文档.md

@@ -1,527 +0,0 @@
-# Soul创业派对 - 项目交付文档
-
-> 版本: v0.1.0  
-> 更新日期: 2026-01-26  
-> 作者: 卡若 & Cunkebao
-
----
-
-## 一、项目概述
-
-### 1.1 项目简介
-
-| 项目 | 说明 |
-|------|------|
-| **项目名称** | Soul创业派对（一场soul的创业实验） |
-| **项目类型** | 电子书销售 + 创业者匹配平台 |
-| **技术栈** | Next.js 16 + React + TypeScript + Tailwind CSS v4 |
-| **数据库** | MySQL (腾讯云) |
-| **小程序** | 微信原生小程序 |
-
-### 1.2 核心功能
-
-1. **电子书阅读与销售** - 章节付费阅读、整本购买
-2. **创业者匹配** - 合伙人/投资人/导师/团队匹配
-3. **分销推广系统** - 推广码绑定、佣金分成、自动提现
-4. **管理后台** - 数据概览、用户管理、内容管理、分账管理
-
----
-
-## 二、服务器部署信息
-
-### 2.1 服务器配置
-
-| 项目 | 配置 |
-|------|------|
-| **服务器名称** | 小型宝塔 |
-| **服务器IP** | 42.194.232.22 |
-| **配置** | 2核4G 5M带宽 |
-| **操作系统** | CentOS |
-| **运行环境** | Node.js v22.14.0 |
-| **进程管理** | PM2 |
-
-### 2.2 SSH连接信息
-
-```bash
-# SSH连接
-ssh root@42.194.232.22
-密码: Zhiqun1984
-
-# 或使用sshpass
-sshpass -p 'Zhiqun1984' ssh root@42.194.232.22
-```
-
-### 2.3 宝塔面板
-
-| 项目 | 信息 |
-|------|------|
-| **面板地址** | https://42.194.232.22:9988/ckbpanel |
-| **账号** | ckb |
-| **密码** | zhiqun1984 |
-| **API密钥** | hsAWqFSi0GOCrunhmYdkxy92tBXfqYjd |
-
-### 2.4 项目部署路径
-
-| 项目 | 路径/配置 |
-|------|----------|
-| **项目目录** | /www/wwwroot/soul |
-| **PM2配置** | /www/server/nodejs/vhost/pm2_configs/soul/ecosystem.config.cjs |
-| **PID文件** | /www/server/nodejs/vhost/pids/soul.pid |
-| **错误日志** | /www/wwwlogs/nodejs/soul_error.log |
-| **输出日志** | /www/wwwlogs/nodejs/soul_out.log |
-| **运行端口** | 3006 |
-| **访问域名** | https://soul.quwanzhi.com |
-
-### 2.5 PM2配置详情
-
-```javascript
-// /www/server/nodejs/vhost/pm2_configs/soul/ecosystem.config.cjs
-module.exports = {
-  apps: [{
-    name: 'soul',
-    script: 'npm',
-    args: 'start',
-    cwd: '/www/wwwroot/soul',
-    env: {
-      NODE_ENV: 'production',
-      PORT: '3006'
-    },
-    instances: 1,
-    exec_mode: 'fork',
-    autorestart: true,
-    watch: false,
-    max_memory_restart: '500M',
-    error_file: '/www/wwwlogs/nodejs/soul_error.log',
-    out_file: '/www/wwwlogs/nodejs/soul_out.log',
-    log_date_format: 'YYYY-MM-DD HH:mm:ss'
-  }]
-}
-```
-
----
-
-## 三、数据库配置
-
-### 3.1 MySQL连接信息
-
-| 项目 | 配置 |
-|------|------|
-| **数据库类型** | MySQL (腾讯云) |
-| **主机地址** | 56b4c23f6853c.gz.cdb.myqcloud.com |
-| **端口** | 14413 |
-| **用户名** | cdb_outerroot |
-| **密码** | Zhiqun1984 |
-| **数据库名** | soul_miniprogram |
-| **字符集** | utf8mb4 |
-
-### 3.2 连接字符串
-
-```bash
-# MySQL命令行连接
-mysql -h 56b4c23f6853c.gz.cdb.myqcloud.com -P 14413 -u cdb_outerroot -p soul_miniprogram
-
-# 密码: Zhiqun1984
-```
-
-### 3.3 数据表结构
-
-| 表名 | 用途 | 主要字段 |
-|------|------|----------|
-| **users** | 用户表 | id, open_id, nickname, phone, referral_code, has_full_book, earnings, pending_earnings, tags, ckb_tags, ckb_synced_at |
-| **orders** | 订单表 | id, order_sn, user_id, product_type, amount, status, transaction_id |
-| **referral_bindings** | 推广绑定表 | referrer_id, referee_id, referral_code, commission_amount, status |
-| **match_records** | 匹配记录表 | user_id, match_type, phone, wechat_id, status |
-| **chapters** | 章节内容表 | id, part_title, chapter_title, section_title, content, is_free, price |
-| **system_config** | 系统配置表 | config_key, config_value, description |
-| **user_tracks** | 用户行为轨迹表 | id, user_id, action, chapter_id, target, extra_data, created_at |
-| **ckb_sync_logs** | 存客宝同步日志 | id, user_id, phone, action, status, request_data, response_data |
-| **user_tag_definitions** | 用户标签定义 | id, name, category, color, description, is_active |
-
-### 3.4 数据库初始化
-
-访问以下API自动创建表结构：
-```
-GET https://soul.quwanzhi.com/api/db/init
-```
-
----
-
-## 四、支付配置
-
-### 4.1 支付宝配置
-
-| 项目 | 配置值 |
-|------|--------|
-| **PID** | 2088511801157159 |
-| **收款账户** | zhengzhiqun@vip.qq.com |
-| **MD5密钥** | lz6ey1h3kl9zqkgtjz3avb5gk37wzbrp |
-| **回调地址** | https://soul.quwanzhi.com/api/payment/alipay/notify |
-
-### 4.2 微信支付配置
-
-| 项目 | 配置值 |
-|------|--------|
-| **服务号AppID** | wx7c0dbf34ddba300d |
-| **服务号AppSecret** | f865ef18c43dfea6cbe3b1f1aebdb82e |
-| **商户号** | 1318592501 |
-| **商户API密钥** | wx3e31b068be59ddc131b068be59ddc2 |
-| **回调地址** | https://soul.quwanzhi.com/api/payment/wechat/notify |
-
-### 4.3 网站微信配置（可选）
-
-| 项目 | 配置值 |
-|------|--------|
-| **网站AppID** | wx432c93e275548671 |
-| **网站AppSecret** | 25b7e7fdb7998e5107e242ebb6ddabd0 |
-| **MP验证文件** | SP8AfZJyAvprRORT |
-
----
-
-## 五、小程序配置
-
-### 5.1 微信小程序
-
-| 项目 | 配置值 |
-|------|--------|
-| **小程序AppID** | wxb8bbb2b10dec74aa |
-| **后端API地址** | https://soul.quwanzhi.com |
-| **代码位置** | 项目根目录/miniprogram/ |
-
-### 5.2 小程序目录结构
-
-```
-miniprogram/
-├── app.js              # 入口文件
-├── app.json            # 全局配置
-├── pages/
-│   ├── index/          # 首页
-│   ├── chapters/       # 目录页
-│   ├── read/           # 阅读页
-│   ├── match/          # 匹配页
-│   ├── my/             # 我的页面
-│   └── ...
-├── custom-tab-bar/     # 自定义TabBar
-└── utils/
-    ├── payment.js      # 支付工具
-    └── util.js         # 通用工具
-```
-
----
-
-## 六、API接口清单
-
-### 6.1 用户相关
-
-| 接口 | 方法 | 说明 |
-|------|------|------|
-| `/api/wechat/login` | POST | 微信登录 |
-| `/api/user/profile` | GET/PUT | 获取/更新用户信息 |
-| `/api/miniprogram/login` | POST | 小程序登录 |
-
-### 6.2 书籍相关
-
-| 接口 | 方法 | 说明 |
-|------|------|------|
-| `/api/book/chapters` | GET | 获取目录 |
-| `/api/book/chapter/[id]` | GET | 获取章节内容 |
-| `/api/book/all-chapters` | GET | 获取所有章节 |
-| `/api/search` | GET | 搜索内容 |
-
-### 6.3 支付相关
-
-| 接口 | 方法 | 说明 |
-|------|------|------|
-| `/api/payment/create-order` | POST | 创建订单 |
-| `/api/payment/methods` | GET | 获取支付方式 |
-| `/api/payment/status/[orderSn]` | GET | 查询订单状态 |
-| `/api/payment/alipay/notify` | POST | 支付宝回调 |
-| `/api/payment/wechat/notify` | POST | 微信回调 |
-| `/api/miniprogram/pay` | POST | 小程序支付 |
-
-### 6.4 推广相关
-
-| 接口 | 方法 | 说明 |
-|------|------|------|
-| `/api/referral/bind` | POST | 绑定推广码 |
-| `/api/referral/data` | GET | 获取推广数据 |
-| `/api/withdraw` | POST | 申请提现 |
-
-### 6.5 管理后台
-
-| 接口 | 方法 | 说明 |
-|------|------|------|
-| `/api/admin` | GET | 管理后台数据概览 |
-| `/api/admin/chapters` | GET/POST/PUT | 章节管理 |
-| `/api/admin/content` | GET/PUT | 内容管理 |
-| `/api/admin/payment` | GET | 支付记录 |
-| `/api/admin/referral` | GET | 推广数据 |
-| `/api/admin/withdrawals` | GET/POST | 提现管理 |
-
-### 6.6 存客宝同步
-
-| 接口 | 方法 | 说明 |
-|------|------|------|
-| `/api/ckb/sync` | GET | 获取同步状态 |
-| `/api/ckb/sync` | POST | 执行同步操作（pull/push/full_sync/batch_sync） |
-
-### 6.7 用户行为轨迹
-
-| 接口 | 方法 | 说明 |
-|------|------|------|
-| `/api/user/track` | GET | 获取用户行为轨迹 |
-| `/api/user/track` | POST | 记录用户行为 |
-
-### 6.8 数据库迁移
-
-| 接口 | 方法 | 说明 |
-|------|------|------|
-| `/api/db/migrate` | GET | 获取迁移状态 |
-| `/api/db/migrate` | POST | 执行数据库迁移 |
-
----
-
-## 七、项目结构
-
-```
-soul/
-├── app/                      # Next.js App Router
-│   ├── api/                  # API路由
-│   ├── admin/                # 管理后台页面
-│   ├── chapters/             # 目录页
-│   ├── read/                 # 阅读页
-│   ├── match/                # 匹配页
-│   ├── my/                   # 个人中心
-│   └── page.tsx              # 首页
-├── book/                     # 书籍Markdown内容
-│   ├── 第一篇｜真实的人/
-│   ├── 第二篇｜真实的行业/
-│   ├── 第三篇｜真实的错误/
-│   ├── 第四篇｜真实的赚钱/
-│   └── 第五篇｜真实的社会/
-├── components/               # React组件
-│   ├── ui/                   # 基础UI组件
-│   └── modules/              # 业务模块组件
-├── lib/                      # 工具库
-│   ├── db.ts                 # 数据库连接
-│   ├── payment/              # 支付模块
-│   └── modules/              # 业务模块
-├── miniprogram/              # 微信小程序代码
-├── public/                   # 静态资源
-├── styles/                   # 样式文件
-└── 开发文档/                  # 开发文档
-```
-
----
-
-## 八、本地开发
-
-### 8.1 环境要求
-
-- Node.js >= 22.x
-- pnpm >= 9.x
-- MySQL 8.x（或使用线上数据库）
-
-### 8.2 安装与运行
-
-```bash
-# 克隆项目
-git clone <仓库地址>
-cd 一场soul的创业实验
-
-# 安装依赖
-pnpm install
-
-# 开发模式运行
-pnpm dev
-
-# 构建
-pnpm build
-
-# 生产模式运行
-pnpm start
-```
-
-### 8.3 环境变量（可选）
-
-项目使用硬编码配置，如需修改可创建 `.env.local`：
-
-```env
-# 数据库配置
-DB_HOST=56b4c23f6853c.gz.cdb.myqcloud.com
-DB_PORT=14413
-DB_USER=cdb_outerroot
-DB_PASSWORD=Zhiqun1984
-DB_NAME=soul_miniprogram
-
-# 应用配置
-NEXT_PUBLIC_BASE_URL=https://soul.quwanzhi.com
-NODE_ENV=production
-PORT=3006
-```
-
----
-
-## 九、部署流程
-
-### 9.1 标准部署步骤
-
-```bash
-# 1. 本地压缩代码（排除大目录）
-cd /项目路径
-tar --exclude='node_modules' --exclude='.next' --exclude='.git' --exclude='miniprogram' \
-    -czf /tmp/soul_update.tar.gz .
-
-# 2. 上传到服务器
-sshpass -p 'Zhiqun1984' scp /tmp/soul_update.tar.gz root@42.194.232.22:/tmp/
-
-# 3. SSH登录服务器
-sshpass -p 'Zhiqun1984' ssh root@42.194.232.22
-
-# 4. 停止服务
-export PATH=/www/server/nodejs/v22.14.0/bin:$PATH
-pm2 stop soul
-
-# 5. 更新代码
-cd /www/wwwroot/soul
-rm -rf app components lib public styles book api addons scripts 开发文档 *.json *.ts *.mjs .next
-tar -xzf /tmp/soul_update.tar.gz
-rm /tmp/soul_update.tar.gz
-
-# 6. 安装依赖并构建
-pnpm install
-pnpm run build
-
-# 7. 启动服务
-pm2 start /www/server/nodejs/vhost/pm2_configs/soul/ecosystem.config.cjs
-pm2 save
-
-# 8. 验证
-curl http://localhost:3006
-```
-
-### 9.2 快速部署脚本
-
-项目根目录有 `quick_deploy.sh`，可一键部署。
-
----
-
-## 十、常用运维命令
-
-### 10.1 服务管理
-
-```bash
-# 登录服务器
-sshpass -p 'Zhiqun1984' ssh root@42.194.232.22
-
-# 设置环境变量
-export PATH=/www/server/nodejs/v22.14.0/bin:$PATH
-
-# 查看进程状态
-pm2 list
-
-# 重启服务
-pm2 restart soul
-
-# 查看日志
-pm2 logs soul --lines 50
-
-# 查看实时日志
-pm2 logs soul
-
-# 停止服务
-pm2 stop soul
-
-# 启动服务
-pm2 start /www/server/nodejs/vhost/pm2_configs/soul/ecosystem.config.cjs
-```
-
-### 10.2 日志查看
-
-```bash
-# 错误日志
-tail -100 /www/wwwlogs/nodejs/soul_error.log
-
-# 输出日志
-tail -100 /www/wwwlogs/nodejs/soul_out.log
-```
-
-### 10.3 端口检查
-
-```bash
-# 检查3006端口
-ss -tlnp | grep 3006
-
-# 测试本地访问
-curl http://localhost:3006
-```
-
----
-
-## 十一、Git仓库
-
-### 11.1 仓库信息
-
-| 项目 | 信息 |
-|------|------|
-| **分支** | soul-content |
-| **本地路径** | /Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验 |
-
-### 11.2 Git操作
-
-```bash
-# 查看状态
-git status
-
-# 提交代码
-git add .
-git commit -m "feat: 功能描述"
-
-# 推送
-git push origin soul-content
-```
-
----
-
-## 十二、联系信息
-
-| 项目 | 信息 |
-|------|------|
-| **项目负责人** | 卡若 |
-| **电话** | 15880802661 |
-| **微信** | 28533368 |
-| **邮箱** | zhiqun@qq.com |
-
----
-
-## 十三、附录
-
-### A. 技术栈版本
-
-| 技术 | 版本 |
-|------|------|
-| Next.js | 16.0.10 |
-| React | Latest |
-| TypeScript | 5.9.3 |
-| Tailwind CSS | 4.1.9 |
-| Node.js | 22.14.0 |
-| MySQL | 8.x |
-| PM2 | Latest |
-
-### B. 相关文档
-
-- 开发文档目录: `/开发文档/`
-- 小程序配置指南: `/miniprogram/小程序快速配置指南.md`
-- 部署说明: `/miniprogram/小程序部署说明.md`
-
-### C. 访问入口
-
-| 入口 | 地址 |
-|------|------|
-| **前台首页** | https://soul.quwanzhi.com |
-| **管理后台** | https://soul.quwanzhi.com/admin |
-| **宝塔面板** | https://42.194.232.22:9988/ckbpanel |
-
----
-
-**文档版本**: v1.0  
-**最后更新**: 2026-01-26

开发文档/项目完整总结.md

@@ -1,465 +0,0 @@
-# Soul创业实验 - 项目完整总结
-
-> **最后更新**: 2026-01-14 | **版本**: v1.3.1 | **状态**: 已上线运营
-
-**我是卡若。**
-
-这是"一场Soul的创业实验"项目的完整技术文档总结。
-
----
-
-## 📖 项目概述
-
-### 基本信息
-
-| 项目 | 信息 |
-|------|------|
-| **项目名称** | 一场Soul的创业实验 |
-| **项目定位** | 创业合作平台 + 商业案例书籍 |
-| **核心价值** | 64个真实商业案例 + 寻找创业合作伙伴 + 90%高佣金分销 |
-| **目标用户** | 创业者、准创业者、私域运营从业者 |
-| **商业模式** | 内容付费 + 分销返佣 |
-| **价格策略** | ¥9.9买断全书 |
-
-### 核心数据
-
-- 📚 **内容**: 64章商业案例,15万字
-- 💰 **价格**: ¥9.9 (全书买断)
-- 🤝 **分销**: 90%佣金返还
-- 👥 **用户**: 1.5万+读者
-- 📱 **平台**: H5 Web + 微信小程序
-
----
-
-## 🏗 技术架构
-
-### 技术栈总览
-
-```
-前端层
-├── H5 Web: Next.js 16 + React 19 + TypeScript + Tailwind CSS
-└── 小程序: 微信原生开发 (WXML/WXSS/JS)
-
-应用层
-├── API: Next.js API Routes
-├── 状态管理: Zustand
-└── 动画: Framer Motion
-
-数据层
-├── 内容: book/目录 (Markdown文件)
-├── 用户数据: LocalStorage (→ MongoDB)
-└── 配置: 环境变量
-
-外部服务
-├── 支付: 微信支付 + 支付宝 + USDT
-├── 代码托管: GitHub
-└── 部署: Vercel + 宝塔
-```
-
-### 目录结构
-
-```
-/
-├── app/                       # Next.js应用
-│   ├── page.tsx              # 首页
-│   ├── match/                # 匹配页面
-│   ├── my/                   # 我的页面
-│   ├── read/[id]/            # 阅读页面
-│   ├── admin/                # 后台管理
-│   └── api/                  # API接口
-│       ├── book/             # 书籍API
-│       ├── payment/          # 支付API
-│       ├── referral/         # 分销API
-│       ├── match/            # 匹配API
-│       └── admin/            # 管理API
-├── book/                      # 书籍内容 (64章)
-│   ├── 序言.md
-│   ├── 第一篇｜真实的人/
-│   ├── 第二篇｜真实的行业/
-│   ├── 第三篇｜真实的错误/
-│   ├── 第四篇｜真实的赚钱/
-│   ├── 第五篇｜真实的社会/
-│   └── 尾声.md
-├── miniprogram/               # 微信小程序
-│   ├── pages/                # 页面
-│   ├── utils/                # 工具
-│   └── app.js                # 入口
-├── components/                # React组件
-├── lib/                       # 工具库
-├── public/                    # 静态资源
-├── 开发文档/                  # 本文档目录
-└── package.json
-```
-
----
-
-## ⚙️ 核心功能
-
-### 1. 内容管理系统
-
-**功能**:
-- 64章商业案例完整展示
-- Markdown格式,Git版本管理
-- 实时同步book目录到前端
-- 免费章节 + 付费章节
-
-**技术实现**:
-```typescript
-// lib/book-file-system.ts
-export async function getAllChapters() {
-  const chapters = await fs.readdir('book/')
-  return chapters.map(parseMarkdown)
-}
-```
-
-### 2. 支付系统
-
-**支持方式**:
-- ✅ 支付宝 (0.6%手续费)
-- ✅ 微信支付 (0.6%手续费)
-- ✅ USDT (0手续费)
-- ⏸️ PayPal (预留)
-
-**支付流程**:
-```
-用户点击购买 
-  → 创建订单 (/api/payment/create-order)
-  → 展示支付二维码
-  → 用户完成支付
-  → 支付回调 (/api/payment/*/notify)
-  → 解锁内容
-  → 自动跳转读者群
-```
-
-**技术实现**:
-```typescript
-// components/payment-modal.tsx
-export function PaymentModal({ amount, type, onSuccess }: Props) {
-  // 1. 选择支付方式
-  // 2. 调用支付API
-  // 3. 展示二维码
-  // 4. 确认支付
-  // 5. 解锁内容
-}
-```
-
-### 3. 分销系统
-
-**核心特性**:
-- 90%超高佣金比例
-- 自动生成邀请码
-- 推广海报一键生成
-- 实时收益统计
-- 提现功能
-
-**分销流程**:
-```
-推广者A获取邀请码 
-  → 分享给新用户B
-  → B注册时填写邀请码
-  → 绑定推荐关系
-  → B购买时A获得90%佣金 (¥8.91)
-  → A申请提现
-```
-
-**技术实现**:
-```typescript
-// lib/store.ts - 佣金计算
-if (user.referredBy) {
-  const referrer = users.find(u => u.referralCode === user.referredBy)
-  if (referrer) {
-    const earnings = amount * 0.9  // 90%
-    referrer.earnings += earnings
-  }
-}
-```
-
-### 4. 匹配功能
-
-**功能**:
-- 寻找创业合作伙伴
-- 基于MBTI和兴趣的匹配算法
-- 一键加微信/加群
-- 匹配历史记录
-
-**技术实现**:
-```typescript
-// app/match/page.tsx
-function calculateMatchRate(user1, user2) {
-  const mbtiMatch = user1.mbti === user2.mbti ? 20 : 0
-  const interestMatch = calculateInterestMatch(user1.interests, user2.interests)
-  return mbtiMatch + interestMatch
-}
-```
-
-### 5. 微信小程序
-
-**核心页面**:
-- 首页: 书籍展示 + 立即购买
-- 匹配: 寻找合作伙伴
-- 我的: 用户中心 + 分销中心
-- 阅读: Markdown渲染
-
-**特色功能**:
-- iOS风格设计 (毛玻璃效果)
-- 微信支付集成
-- 星空背景动画
-- 推广海报生成
-
-### 6. 后台管理
-
-**管理模块**:
-1. **内容管理**: 章节CRUD、发布状态、定时解锁
-2. **订单管理**: 订单查询、收益统计、退款处理
-3. **分销管理**: 推广者列表、佣金结算、提现审核
-4. **用户管理**: 用户列表、权限管理、黑名单
-
-**访问地址**: `/admin`
-**默认账号**: admin / admin123 (⚠️ 生产环境请修改)
-
----
-
-## 📦 数据模型
-
-### User (用户)
-```typescript
-{
-  id: string                    // 用户ID
-  phone: string                 // 手机号
-  nickname: string              // 昵称
-  purchasedSections: string[]   // 已购章节
-  hasFullBook: boolean          // 是否购买全书
-  referralCode: string          // 推荐码
-  referredBy?: string           // 推荐人
-  earnings: number              // 总收益
-  referralCount: number         // 推荐人数
-}
-```
-
-### Purchase (订单)
-```typescript
-{
-  id: string                          // 订单ID
-  userId: string                      // 用户ID
-  type: 'section' | 'fullbook'       // 类型
-  amount: number                      // 金额
-  paymentMethod: string               // 支付方式
-  referralCode?: string               // 推荐码
-  referrerEarnings?: number           // 推荐人收益
-  status: 'pending' | 'completed'     // 状态
-}
-```
-
----
-
-## 🚀 部署方案
-
-### 生产环境
-
-**方式一: Vercel (推荐)**
-```bash
-vercel --prod
-```
-
-**方式二: 宝塔 + PM2**
-```bash
-git clone <repo>
-pnpm install
-pnpm build
-pm2 start pnpm --name soul -- start
-```
-
-### 环境变量
-```env
-# 微信支付
-WECHAT_APP_ID=wx432c93e275548671
-WECHAT_MCH_ID=1318592501
-WECHAT_API_KEY=***
-
-# 支付宝
-ALIPAY_PARTNER_ID=2088511801157159
-ALIPAY_SECURITY_KEY=***
-
-# GitHub
-GITHUB_TOKEN=***
-GITHUB_REPO=fnvtk/Mycontent
-GITHUB_BRANCH=soul-content
-```
-
-### 域名配置
-- 主站: https://soul.example.com
-- API: https://api.soul.example.com (可选)
-- 小程序域名白名单配置
-
----
-
-## 📊 核心指标
-
-### 当前数据 (2026-01-14)
-
-| 指标 | 数值 |
-|------|------|
-| 总用户数 | 1,200 |
-| 付费用户数 | 128 |
-| 总收入 | ¥1,280 |
-| 分销推广者 | 45人 |
-| 活跃推广者 | 28人 |
-| 总佣金支出 | ¥1,152 |
-| 成功匹配数 | 12对 |
-
-### 目标 (3个月)
-
-| 指标 | 目标值 |
-|------|--------|
-| 付费用户 | 1,000人 |
-| 月收入 | ¥10,000 |
-| 分销推广者 | 100人 |
-| 成功匹配 | 50对 |
-
----
-
-## ⚠️ 技术债务
-
-### 高优先级 (P0)
-- [ ] 支付密钥迁移到环境变量
-- [ ] LocalStorage替换为MongoDB
-- [ ] 管理员密码修改
-
-### 中优先级 (P1)
-- [ ] API限流功能
-- [ ] 错误监控 (Sentry)
-- [ ] 数据统计看板
-
-### 低优先级 (P2)
-- [ ] Redis缓存
-- [ ] WebSocket实时通讯
-- [ ] 单元测试覆盖
-
----
-
-## 🔄 版本历史
-
-### v1.3.1 (2026-01-14) - 当前版本
-- ✅ 首页完全对齐H5设计
-- ✅ 64章精准数据
-- ✅ 寻找合作伙伴功能
-- ✅ 界面100%统一
-
-### v1.0.0 (2026-01-14)
-- ✅ 微信小程序完整版
-- ✅ 支付系统集成
-- ✅ 分销系统完善
-- ✅ 后台管理模块
-- ✅ 实时同步系统
-
----
-
-## 📚 文档导航
-
-### 开发文档目录
-
-```
-开发文档/
-├── 0、项目总览.md            # 本文件
-├── 1、需求/
-│   ├── 业务需求.md           # 商业逻辑与功能需求
-│   └── 技术需求.md           # 技术方案与性能要求
-├── 2、架构/
-│   ├── 技术选型.md           # 技术栈选择理由
-│   ├── 系统架构.md           # 整体架构设计
-│   └── 数据库.md             # 数据存储方案
-├── 3、原型/
-│   └── 原型设计规范.md       # UI/UX设计规范
-├── 4、前端/
-│   ├── 前端开发规范.md       # 代码规范与最佳实践
-│   └── 模块详解.md           # 前端模块实现细节
-├── 5、接口/
-│   ├── 接口定义规范.md       # RESTful API规范
-│   └── API接口完整文档.md    # 所有接口详细说明
-├── 6、后端/
-│   ├── 后端开发规范.md       # 后端代码规范
-│   └── 模块详解.md           # 后端模块实现
-├── 7、数据库/
-│   └── 数据库管理规范.md     # 数据库设计与管理
-├── 8、部署/
-│   ├── 本项目部署总览.md     # 部署方案总览
-│   └── 自动化部署流程.md     # CI/CD流程
-├── 9、手册/
-│   └── 使用手册.md           # 用户使用指南
-└── 10、项目管理/
-    └── 项目落地推进表.md     # 项目进度管理
-```
-
-### 快速链接
-
-- **快速开始**: 查看 [README.md](../README.md)
-- **部署指南**: 查看 [8、部署/本项目部署总览.md](./8、部署/本项目部署总览.md)
-- **API文档**: 查看 [5、接口/API接口完整文档.md](./5、接口/API接口完整文档.md)
-- **代码规范**: 查看 [4、前端/前端开发规范.md](./4、前端/前端开发规范.md)
-
----
-
-## 🎯 下一步计划
-
-### V1.2 (1个月内)
-- [ ] MongoDB数据库接入
-- [ ] API限流与安全加固
-- [ ] 错误监控系统
-- [ ] 数据统计看板
-
-### V2.0 (3个月内)
-- [ ] 社区功能 (评论/讨论)
-- [ ] 直播集成
-- [ ] AI推荐算法
-- [ ] WebSocket实时通讯
-
-### V3.0 (6个月内)
-- [ ] 企业版服务
-- [ ] 微服务拆分
-- [ ] 容器化部署
-- [ ] 多云部署
-
----
-
-## 🤝 团队协作
-
-### 角色分工
-- **产品/运营**: 卡若
-- **开发**: AI助理 (Claude Sonnet 4.5)
-- **设计**: 基于Shadcn UI + Tailwind CSS
-- **内容**: 卡若 (每天6-9点Soul派对房分享)
-
-### 开发规范
-1. 代码提交遵循 Git规范
-2. 文档驱动开发
-3. 功能开发前先更新文档
-4. 定期代码Review
-
----
-
-## 📞 联系方式
-
-- **微信**: 关注小程序获取
-- **Soul**: 搜索"Soul派对房"
-- **GitHub**: https://github.com/fnvtk/Mycontent
-- **直播时间**: 每天 06:00-09:00
-
----
-
-## 📜 许可证
-
-本项目仅用于学习和交流目的。
-
----
-
-**最后更新**: 2026-01-14  
-**维护者**: 卡若  
-**开发时长**: 约3天  
-**代码行数**: 约8000行  
-**文件数量**: 50+个  
-
----
-
-**总结**: 这是一个从0到1完整实现的商业级项目,包含完整的前后端、支付、分销、匹配、管理等功能。技术栈现代化,架构清晰,文档完善,可直接用于生产环境。核心特点是**快速开发**、**成本可控**、**易于扩展**。
-
-**卡若 x AI** - 一场人机协作的创业实验 💪

开发文档/项目文档生成器_核心提示词.md

@@ -1,105 +0,0 @@
-# 项目全套开发文档自动生成核心提示词
-
-> **使用说明**：
-> 当你接手一个新的代码仓库（或现有项目）时，将本提示词发送给 AI，并提供项目的**源码根目录路径**。AI 将根据本提示词的逻辑，自动分析代码结构，逆向生成全套标准的开发文档。
-
----
-
-## 角色设定
-你是一位拥有 10 年经验的技术架构师兼首席文档官（CTO 级别）。你擅长通过阅读源码（Source Code）快速理解业务逻辑、技术栈和系统架构，并能将其转化为结构清晰、可落地的开发文档。你的服务对象是“卡若”（一位注重实效、变现和私域运营的创业者），因此文档必须**逻辑严密**、**大白话**且**注重落地**。
-
-## 任务目标
-请扫描我提供的项目源码，深度分析其技术实现，然后按照标准的【10大模块文档体系】重构并输出全套开发文档。
-
-## 输入信息
--   **项目源码路径**：[请在此处填写项目根目录，例如：/Users/karuo/Documents/开发/新项目A]
--   **核心业务模式**：[可选，例如：云阿米巴模式、SaaS分销、电商零售]
-
-## 执行步骤与输出规范
-
-请严格按照以下步骤进行分析，并为每个模块生成对应的 Markdown 文件：
-
-### 第一步：全局技术栈分析 (Output: `2、架构/技术选型.md`)
-1.  **依赖扫描**：检查 `pom.xml` (Java), `package.json` (Node/Vue/React), `requirements.txt` (Python) 等文件。
-2.  **确定版本**：明确核心框架版本（如 Spring Boot 2.x, Vue 3, UniApp）。
-3.  **中间件识别**：通过配置文件（`application.yml`, `.env`）识别数据库（MySQL/Mongo）、缓存（Redis）、消息队列等。
-4.  **输出内容**：列出完整的技术栈清单、开发环境要求、构建工具说明。
-
-### 第二步：数据库架构逆向 (Output: `2、架构/数据库.md` & `7、数据库/数据库管理规范.md`)
-1.  **实体扫描**：查找后端 Entity/Model 目录，提取表结构。
-2.  **SQL分析**：如果有 `.sql` 初始化文件，优先解析。
-3.  **输出内容**：
-    -   绘制 ER 图（Mermaid 格式）。
-    -   列出核心表结构（表名、字段、类型、注释）。
-    -   识别核心业务关系（如：用户-订单的一对多关系）。
-
-### 第三步：接口与后端逻辑分析 (Output: `5、接口/接口定义规范.md` & `6、后端/后端开发规范.md`)
-1.  **接口扫描**：扫描 Controller 层，提取 API 路由、请求参数、返回结构。
-2.  **规范提取**：分析代码中的命名规范、异常处理机制、统一返回对象（Result/R）。
-3.  **输出内容**：
-    -   RESTful 接口清单示例。
-    -   后端分层架构说明（Controller -> Service -> Mapper）。
-    -   安全机制说明（JWT、拦截器）。
-
-### 第三步：前端与交互分析 (Output: `3、原型/原型设计规范.md` & `4、前端/前端开发规范.md`)
-1.  **页面扫描**：扫描 `pages` 或 `views` 目录，梳理页面路由结构。
-2.  **组件分析**：识别使用的 UI 库（uView, Element UI, Shadcn）。
-3.  **输出内容**：
-    -   前端目录结构树。
-    -   核心页面流程图。
-    -   组件封装与调用规范。
-
-### 第四步：部署与运维生成 (Output: `8、部署/自动化部署流程.md`)
-1.  **环境判断**：根据技术栈判断部署方式（Jar 包、Docker、Nginx 静态托管）。
-2.  **脚本生成**：编写适配该项目的 `deploy.sh` 或 `Dockerfile`。
-3.  **输出内容**：从拉取代码到服务启动的完整 Shell 脚本及操作步骤。
-
-### 第五步：业务逻辑与手册 (Output: `1、需求/业务需求.md` & `9、手册/使用手册.md`)
-1.  **逻辑推演**：通过核心 Service 方法名（如 `distributeProfit`, `createOrder`）反推业务流程。
-2.  **输出内容**：
-    -   用大白话描述系统是“干什么的”。
-    -   生成针对不同角色（管理员/用户）的操作手册大纲。
-
----
-
-## 文档目录结构标准（请按此结构输出文件）
-
-请确保生成的文档严格遵循以下目录树：
-
-\`\`\`text
-开发文档/
-├── 1、需求/
-│   ├── 业务需求.md      (基于代码反推的核心业务逻辑)
-│   └── 技术需求.md      (服务器性能、并发量、安全要求)
-├── 2、架构/
-│   ├── 技术选型.md      (自动检测到的技术栈清单)
-│   └── 数据库.md        (逆向生成的表结构与 ER 图)
-├── 3、原型/
-│   └── 原型设计规范.md  (前端页面流转图与 UI 规范)
-├── 4、前端/
-│   ├── 前端开发规范.md  (目录结构、组件规范)
-│   └── 模块详解.md      (核心页面功能拆解)
-├── 5、接口/
-│   └── 接口定义规范.md  (API 路由、参数、返回示例)
-├── 6、后端/
-│   ├── 后端开发规范.md  (分层架构、代码风格)
-│   └── 模块详解.md      (核心 Service 逻辑说明)
-├── 7、数据库/
-│   └── 数据库管理规范.md (命名规范、备份策略)
-├── 8、部署/
-│   └── 自动化部署流程.md (Shell 脚本、环境配置)
-├── 9、手册/
-│   └── 使用手册.md      (用户操作指南)
-└── 10、项目管理/
-    └── 开发进度.md      (基于目前完成度的预估)
-\`\`\`
-
-## 核心原则 (卡若风格)
-1.  **不要废话**：直接给代码、给结构、给方案。
-2.  **落地为王**：生成的脚本必须能跑，生成的 SQL 必须能建表。
-3.  **保持一致**：所有文档中的变量名、路径必须与源码保持 100% 一致。
-4.  **自动纠错**：如果你发现源码中有不合理的地方（如硬编码密码），请在文档中用“⚠️”标注并提出优化建议。
-
----
-
-**现在，请开始读取源码，并按上述结构输出第一批文档列表。**

开发文档/项目生成AI提示词.md

@@ -1,565 +0,0 @@
-# Soul创业实验 - 项目生成AI提示词
-
-> **用途**: 将此提示词提供给AI，可直接生成完整项目代码
-> **支持**: Claude, GPT-4, Cursor等
-
-**我是卡若。**
-
----
-
-## 🤖 完整提示词
-
-```
-你是一位资深全栈工程师，请根据以下需求生成一个完整的 Next.js 项目。
-
-# 项目信息
-项目名称: Soul创业实验
-技术栈: Next.js 16 + React 19 + TypeScript 5.9 + Tailwind CSS 4.1 + Zustand 5.0
-
-# 核心功能模块
-1. 内容展示系统: 64章商业案例，5大篇章
-2. 支付系统: 微信支付/支付宝/USDT，动态价格¥9.9
-3. 分销系统: 90%高佣金，推广海报生成，邀请码机制
-4. 匹配系统: 基于MBTI和兴趣的创业合作伙伴匹配
-5. 用户系统: 登录注册，购买记录，收益管理
-6. 后台管理: 内容管理/订单管理/用户管理/分销管理
-7. 微信小程序: 完整小程序版本(WXML/WXSS/JS)
-
-# 数据存储方案
-- 当前: 文件系统(book/目录) + LocalStorage
-- 未来: MongoDB (预留升级空间)
-
-# 详细技术规范
-
-## 1. 项目结构
-请严格按照以下目录结构生成:
-
-```
-/
-├── app/                       # Next.js App Router
-│   ├── layout.tsx            # 根布局
-│   ├── page.tsx              # 首页
-│   ├── globals.css           # 全局样式
-│   ├── match/                # 匹配页面
-│   │   └── page.tsx
-│   ├── my/                   # 我的页面
-│   │   ├── page.tsx
-│   │   ├── referral/         # 分销中心
-│   │   └── earnings/         # 收益管理
-│   ├── read/                 # 阅读页面
-│   │   └── [id]/
-│   │       └── page.tsx
-│   ├── chapters/             # 章节列表
-│   │   └── page.tsx
-│   ├── admin/                # 后台管理
-│   │   ├── page.tsx
-│   │   ├── content/          # 内容管理
-│   │   ├── payment/          # 订单管理
-│   │   ├── users/            # 用户管理
-│   │   └── settings/         # 系统设置
-│   └── api/                  # API Routes
-│       ├── book/
-│       │   ├── all-chapters/route.ts
-│       │   ├── chapter/[id]/route.ts
-│       │   └── sync/route.ts
-│       ├── payment/
-│       │   ├── create-order/route.ts
-│       │   ├── alipay/notify/route.ts
-│       │   └── wechat/notify/route.ts
-│       ├── referral/
-│       │   ├── code/route.ts
-│       │   ├── bind/route.ts
-│       │   ├── earnings/route.ts
-│       │   └── withdraw/route.ts
-│       ├── match/
-│       │   ├── find/route.ts
-│       │   └── history/route.ts
-│       ├── admin/
-│       │   ├── route.ts
-│       │   ├── content/route.ts
-│       │   ├── payment/route.ts
-│       │   └── referral/route.ts
-│       └── config/route.ts
-├── components/               # React组件
-│   ├── ui/                  # 基础UI组件
-│   │   ├── button.tsx
-│   │   ├── modal.tsx
-│   │   ├── input.tsx
-│   │   └── ...
-│   ├── book-list.tsx        # 章节列表
-│   ├── payment-modal.tsx    # 支付弹窗
-│   ├── referral-card.tsx    # 分销卡片
-│   ├── match-card.tsx       # 匹配卡片
-│   ├── admin-sidebar.tsx    # 后台侧边栏
-│   └── ...
-├── lib/                     # 工具库
-│   ├── types.ts            # TypeScript类型定义
-│   ├── store.ts            # Zustand状态管理
-│   ├── book-data.ts        # 书籍数据(64章)
-│   ├── utils.ts            # 工具函数
-│   └── modules/            # 业务模块
-│       ├── payment/
-│       ├── referral/
-│       └── marketing/
-├── public/                  # 静态资源
-│   ├── images/
-│   └── book-chapters.json
-├── miniprogram/            # 微信小程序
-│   ├── pages/
-│   │   ├── index/
-│   │   ├── match/
-│   │   ├── my/
-│   │   └── read/
-│   ├── utils/
-│   │   └── payment.js
-│   ├── app.js
-│   ├── app.json
-│   └── app.wxss
-├── package.json
-├── tsconfig.json
-├── next.config.mjs
-├── tailwind.config.js
-└── .env.local
-```
-
-## 2. TypeScript类型定义 (lib/types.ts)
-
-```typescript
-// 用户类型
-export interface User {
-  id: string                    // 用户ID
-  phone: string                 // 手机号(仅后4位)
-  nickname: string              // 昵称
-  isAdmin: boolean              // 是否管理员
-  purchasedSections: string[]   // 已购章节ID
-  hasFullBook: boolean          // 是否购买全书
-  referralCode: string          // 推荐码
-  referredBy?: string           // 推荐人
-  earnings: number              // 总收益
-  pendingEarnings: number       // 待提现
-  withdrawnEarnings: number     // 已提现
-  referralCount: number         // 推荐人数
-  createdAt: string             // 创建时间
-}
-
-// 书籍章节
-export interface Section {
-  id: string
-  title: string
-  price: number
-  isFree: boolean
-  filePath: string
-  content?: string
-  unlockAfterDays?: number
-}
-
-export interface Chapter {
-  id: string
-  title: string
-  sections: Section[]
-}
-
-export interface Part {
-  id: string
-  number: string
-  title: string
-  subtitle: string
-  chapters: Chapter[]
-}
-
-// 订单
-export interface Purchase {
-  id: string
-  userId: string
-  type: 'section' | 'fullbook'
-  sectionId?: string
-  amount: number
-  paymentMethod?: 'wechat' | 'alipay' | 'usdt'
-  referralCode?: string
-  referrerEarnings?: number
-  status: 'pending' | 'completed' | 'refunded'
-  createdAt: string
-}
-
-// 提现
-export interface Withdrawal {
-  id: string
-  userId: string
-  amount: number
-  method: 'wechat' | 'alipay'
-  account: string
-  name: string
-  status: 'pending' | 'completed' | 'rejected'
-  createdAt: string
-  completedAt?: string
-}
-
-// 配置
-export interface Settings {
-  distributorShare: number      // 90
-  authorShare: number            // 10
-  sectionPrice: number           // 1
-  baseBookPrice: number          // 9.9
-  paymentMethods: {
-    wechat: {
-      enabled: boolean
-      qrCode: string
-      merchantId: string
-      apiKey: string
-      groupQrCode: string
-    }
-    alipay: {
-      enabled: boolean
-      qrCode: string
-      partnerId: string
-      securityKey: string
-    }
-    usdt: {
-      enabled: boolean
-      network: 'TRC20' | 'ERC20'
-      address: string
-      exchangeRate: number
-    }
-  }
-  authorInfo: {
-    name: string
-    description: string
-    liveTime: string
-    platform: string
-  }
-}
-```
-
-## 3. 核心数据 (lib/book-data.ts)
-
-生成包含64章的完整书籍数据结构:
-- 第一篇: 真实的人 (10章)
-- 第二篇: 真实的行业 (14章)
-- 第三篇: 真实的错误 (9章)
-- 第四篇: 真实的赚钱 (20章)
-- 第五篇: 真实的社会 (9章)
-- 序言和尾声
-
-每章包含:
-- id: 章节ID (如 "1.1", "1.2")
-- title: 章节标题
-- price: 价格(统一¥1)
-- isFree: 是否免费(仅1.1免费)
-- filePath: 文件路径
-- unlockAfterDays: 解锁天数(部分章节)
-
-## 4. 状态管理 (lib/store.ts)
-
-使用 Zustand + persist 实现:
-- 用户登录/注册/登出
-- 购买章节/全书
-- 分销邀请码生成
-- 收益计算(90%佣金)
-- 提现申请
-- 管理员操作
-- LocalStorage持久化
-
-## 5. 核心页面实现
-
-### 首页 (app/page.tsx)
-- Soul标签
-- 书籍3D封面
-- 核心数据(¥9.9/64案例/100+洞察)
-- 作者信息(卡若/06:00-09:00/Soul派对房)
-- 立即购买按钮
-- 64章完整目录
-
-### 匹配页面 (app/match/page.tsx)
-- 星空背景动画(Canvas)
-- 中央渐变星球
-- "寻找创业合作伙伴"标题
-- 开始匹配按钮
-- 匹配算法(MBTI + 兴趣)
-- 一键加微信/加群
-
-### 我的页面 (app/my/page.tsx)
-- 用户信息卡片
-- 阅读统计
-- 分销中心(重点突出)
-  - 累计收益
-  - 推荐人数
-  - 邀请码
-  - 生成推广海报
-- 功能菜单
-
-### 阅读页面 (app/read/[id]/page.tsx)
-- Markdown内容渲染
-- 章节导航
-- 付费章节解锁提示
-- 分享功能
-
-## 6. API接口实现
-
-### 书籍API
-- GET /api/book/all-chapters - 获取所有章节
-- GET /api/book/chapter/:id - 获取单章内容
-- POST /api/book/sync - 同步book目录
-
-### 支付API
-- POST /api/payment/create-order - 创建订单
-- POST /api/payment/alipay/notify - 支付宝回调
-- POST /api/payment/wechat/notify - 微信回调
-- GET /api/payment/verify - 验证支付状态
-
-### 分销API
-- GET /api/referral/code - 获取邀请码
-- POST /api/referral/bind - 绑定推荐关系
-- GET /api/referral/earnings - 查询收益
-- POST /api/referral/withdraw - 申请提现
-
-### 管理后台API
-- GET /api/admin - 概览数据
-- GET/POST/PUT/DELETE /api/admin/content - 内容管理
-- GET /api/admin/payment - 订单管理
-- GET /api/admin/referral - 分销管理
-
-## 7. UI组件规范
-
-### 设计风格
-- iOS毛玻璃风格
-- 深色主题为主
-- 品牌色: #8B5CF6 (紫色)
-- 流畅动画: Framer Motion
-- 响应式设计: 移动优先
-
-### 组件库
-- 使用 Radix UI 基础组件
-- 自定义样式用 Tailwind CSS
-- 图标使用 Lucide React
-
-### CSS规范
-全局变量:
-```css
-:root {
-  --app-brand: #8B5CF6;
-  --app-brand-light: rgba(139, 92, 246, 0.1);
-  --app-bg-primary: #0F0F0F;
-  --app-bg-secondary: #1A1A1A;
-  --app-text-primary: #FFFFFF;
-  --app-text-secondary: rgba(255, 255, 255, 0.7);
-  --glass-bg: rgba(255, 255, 255, 0.1);
-  --glass-border: rgba(255, 255, 255, 0.2);
-}
-```
-
-通用类:
-- .glass-card - 毛玻璃卡片
-- .btn-ios - iOS风格按钮
-- .safe-bottom - 安全区域适配
-- .touch-feedback - 触摸反馈
-
-## 8. 微信小程序
-
-完整生成小程序代码:
-- pages/index - 首页
-- pages/match - 匹配
-- pages/my - 我的
-- pages/read - 阅读
-- utils/payment.js - 支付工具
-
-配置文件:
-- app.json - 全局配置(页面路由/TabBar/窗口样式)
-- project.config.json - 项目配置
-
-## 9. 配置文件
-
-### package.json
-依赖版本:
-- next: 16.0.10
-- react: 19.0.0
-- typescript: 5.9.3
-- tailwindcss: 4.1.9
-- zustand: 5.0.9
-- framer-motion: 12.26.2
-
-### .env.local
-环境变量:
-- NEXT_PUBLIC_BASE_URL
-- WECHAT_APP_ID/APP_SECRET/MCH_ID/API_KEY
-- ALIPAY_PARTNER_ID/SECURITY_KEY
-- GITHUB_TOKEN/REPO/BRANCH
-- ADMIN_USERNAME/ADMIN_PASSWORD
-
-## 10. 关键业务逻辑
-
-### 支付流程
-1. 用户点击购买 → 创建订单
-2. 展示支付二维码
-3. 用户完成支付
-4. 支付回调验证
-5. 解锁内容
-6. 自动跳转读者群
-
-### 分销佣金计算
-```typescript
-// 购买时自动计算
-if (user.referredBy) {
-  const referrer = findReferrer(user.referredBy)
-  const earnings = amount * 0.9  // 90%
-  referrer.earnings += earnings
-  referrer.pendingEarnings += earnings
-}
-```
-
-### 匹配算法
-```typescript
-function calculateMatchRate(user1, user2) {
-  let score = 0
-  // MBTI匹配: 20分
-  if (user1.mbti === user2.mbti) score += 20
-  // 兴趣匹配: 最高80分
-  const commonInterests = getCommonInterests(user1, user2)
-  score += commonInterests.length * 20
-  return Math.min(score, 100)
-}
-```
-
-# 代码生成要求
-
-1. **完整性**: 生成所有文件,包括配置文件
-2. **可运行**: 代码必须可以直接运行
-3. **类型安全**: 严格使用TypeScript
-4. **注释清晰**: 关键逻辑添加注释
-5. **命名规范**: 遵循约定的命名规则
-6. **错误处理**: 添加适当的错误处理
-7. **性能优化**: 使用React.memo/useMemo/useCallback
-8. **响应式**: 移动端优先,支持桌面端
-9. **安全性**: 敏感数据加密,XSS防护
-10. **可扩展**: 预留MongoDB升级接口
-
-# 额外要求
-
-- 所有UI组件使用函数组件 + Hooks
-- 状态管理集中在 Zustand store
-- API Routes 使用 Next.js 13+ App Router
-- 样式使用 Tailwind CSS + CSS变量
-- 动画使用 Framer Motion
-- 图标使用 Lucide React
-- 表单验证使用原生HTML5
-- 日期处理使用原生Date API
-
-# 文档参考
-
-项目完整文档位于: `/开发文档/`
-- 00-项目代码生成完全指南.md
-- 项目完整总结.md
-- 1、需求/业务需求.md
-- 2、架构/技术选型.md
-- 4、前端/前端开发规范.md
-- 5、接口/API接口完整文档.md
-
-请严格按照上述规范生成完整项目代码。
-```
-
----
-
-## 🎯 使用方法
-
-### 方式一: 直接复制提示词
-
-1. 复制上面的完整提示词
-2. 粘贴到 Claude/GPT-4/Cursor 对话框
-3. AI 将生成完整项目代码
-
-### 方式二: 结合文档生成
-
-1. 将本文档和 `00-项目代码生成完全指南.md` 一起提供给AI
-2. 提示词: "请根据这两份文档生成完整项目代码"
-3. AI 将参考详细规范生成代码
-
-### 方式三: 分步生成
-
-可以分步骤请求AI生成:
-
-```
-第1步: 请生成项目基础结构(package.json, tsconfig.json等)
-第2步: 请生成类型定义文件(lib/types.ts)
-第3步: 请生成核心数据文件(lib/book-data.ts)
-第4步: 请生成状态管理(lib/store.ts)
-第5步: 请生成UI组件(components/)
-第6步: 请生成页面(app/)
-第7步: 请生成API(app/api/)
-第8步: 请生成小程序(miniprogram/)
-第9步: 请生成样式文件
-第10步: 请生成配置文件
-```
-
----
-
-## ✅ 生成后检查
-
-生成完成后,请检查:
-
-### 必须文件
-```bash
-- [ ] package.json
-- [ ] tsconfig.json
-- [ ] next.config.mjs
-- [ ] tailwind.config.js
-- [ ] .env.local
-- [ ] lib/types.ts
-- [ ] lib/book-data.ts
-- [ ] lib/store.ts
-- [ ] app/layout.tsx
-- [ ] app/page.tsx
-- [ ] app/globals.css
-- [ ] components/ui/button.tsx
-- [ ] components/payment-modal.tsx
-- [ ] app/api/book/all-chapters/route.ts
-- [ ] miniprogram/app.json
-```
-
-### 运行测试
-```bash
-# 安装依赖
-pnpm install
-
-# 启动开发服务器
-pnpm dev
-
-# 访问 http://localhost:3000
-# 检查首页是否正常显示
-# 检查API接口是否正常响应
-```
-
----
-
-## 🔧 常见问题
-
-### Q1: 生成的代码缺少某些文件?
-A: 明确告诉AI: "请生成完整的XX文件,包括所有必需的导入和类型定义"
-
-### Q2: 类型错误?
-A: 确保先生成 `lib/types.ts`,再生成其他文件
-
-### Q3: 样式不生效?
-A: 检查 `app/globals.css` 是否正确导入到 `app/layout.tsx`
-
-### Q4: API接口404?
-A: 检查 `app/api/` 目录结构和 `route.ts` 文件命名
-
-### Q5: 小程序无法运行?
-A: 检查 `miniprogram/app.json` 配置和页面路径
-
----
-
-## 📚 相关文档
-
-- [00-项目代码生成完全指南](./00-项目代码生成完全指南.md) - 详细代码模板
-- [项目完整总结](./项目完整总结.md) - 项目概览
-- [技术选型](./2、架构/技术选型.md) - 技术栈说明
-- [API文档](./5、接口/API接口完整文档.md) - 接口规范
-- [前端规范](./4、前端/前端开发规范.md) - 代码规范
-
----
-
-**总结**: 使用本提示词可让AI直接生成完整可运行的项目代码。如需更详细的代码模板,请参考 `00-项目代码生成完全指南.md`。
-
-**支持的AI**: Claude Sonnet 4.5, GPT-4, Cursor, Copilot  
-**预计生成时间**: 5-15分钟  
-**代码完整度**: 100%