feat: 首页推荐逻辑-排除序言尾声,精选按点击量,小程序接入featuredSections

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/error.tsx

@@ -0,0 +1,41 @@
+'use client'
+
+import { useEffect } from 'react'
+
+export default function AdminError({
+  error,
+  reset,
+}: {
+  error: Error & { digest?: string }
+  reset: () => void
+}) {
+  useEffect(() => {
+    console.error('[Admin] 页面错误:', error)
+  }, [error])
+
+  return (
+    <div className="min-h-screen flex items-center justify-center bg-[#0a1628]">
+      <div className="bg-[#0f2137] border border-gray-700/50 rounded-2xl p-8 max-w-md w-full mx-4 shadow-xl">
+        <div className="text-center">
+          <div className="text-5xl mb-4">😞</div>
+          <h2 className="text-xl font-bold text-white mb-2">哎呀，出错了</h2>
+          <p className="text-gray-400 text-sm mb-6">页面遇到了一些问题，请稍后再试</p>
+          <div className="flex gap-3">
+            <button
+              onClick={reset}
+              className="flex-1 py-2.5 rounded-lg bg-[#38bdac] hover:bg-[#2da396] text-white text-sm font-medium"
+            >
+              重试
+            </button>
+            <a
+              href="/admin"
+              className="flex-1 py-2.5 rounded-lg bg-gray-700 hover:bg-gray-600 text-gray-200 text-sm font-medium text-center"
+            >
+              返回后台
+            </a>
+          </div>
+        </div>
+      </div>
+    </div>
+  )
+}

app/admin/page.tsx

@@ -11,24 +11,25 @@ export default function AdminDashboard() {
   const [users, setUsers] = useState<any[]>([])
   const [purchases, setPurchases] = useState<any[]>([])
 
-  // 从API获取数据
+  // 从API获取数据（任意接口失败时仍保持页面可展示，不抛错）
   async function loadData() {
     try {
-      // 获取用户数据
       const usersRes = await fetch('/api/db/users')
-      const usersData = await usersRes.json()
-      if (usersData.success && usersData.users) {
+      const usersData = await usersRes.ok ? usersRes.json().catch(() => ({})) : { success: false }
+      if (usersData.success && Array.isArray(usersData.users)) {
         setUsers(usersData.users)
       }
-      
-      // 获取订单数据
+    } catch (e) {
+      console.warn('加载用户数据失败', e)
+    }
+    try {
       const ordersRes = await fetch('/api/orders')
-      const ordersData = await ordersRes.json()
-      if (ordersData.success && ordersData.orders) {
+      const ordersData = await ordersRes.ok ? ordersRes.json().catch(() => ({})) : { success: false }
+      if (ordersData.success && Array.isArray(ordersData.orders)) {
         setPurchases(ordersData.orders)
       }
     } catch (e) {
-      console.log('加载数据失败', e)
+      console.warn('加载订单数据失败', e)
     }
   }
 
@@ -63,7 +64,7 @@ export default function AdminDashboard() {
     )
   }
 
-  const totalRevenue = purchases.reduce((sum, p) => sum + (p.amount || 0), 0)
+  const totalRevenue = purchases.reduce((sum, p) => sum + (Number(p?.amount) || 0), 0)
   const totalUsers = users.length
   const totalPurchases = purchases.length
 
@@ -71,7 +72,7 @@ export default function AdminDashboard() {
     { title: "总用户数", value: totalUsers, icon: Users, color: "text-blue-400", bg: "bg-blue-500/20", link: "/admin/users" },
     {
       title: "总收入",
-      value: `¥${totalRevenue.toFixed(2)}`,
+      value: `¥${Number(totalRevenue).toFixed(2)}`,
       icon: TrendingUp,
       color: "text-[#38bdac]",
       bg: "bg-[#38bdac]/20",
@@ -80,7 +81,7 @@ export default function AdminDashboard() {
     { title: "订单数", value: totalPurchases, icon: ShoppingBag, color: "text-purple-400", bg: "bg-purple-500/20", link: "/admin/orders" },
     {
       title: "转化率",
-      value: `${totalUsers > 0 ? ((totalPurchases / totalUsers) * 100).toFixed(1) : 0}%`,
+      value: `${totalUsers > 0 ? (Number(totalPurchases) / Number(totalUsers) * 100).toFixed(1) : 0}%`,
       icon: BookOpen,
       color: "text-orange-400",
       bg: "bg-orange-500/20",
@@ -132,11 +133,11 @@ export default function AdminDashboard() {
                   >
                     <div>
                       <p className="text-sm font-medium text-white">{p.sectionTitle || "整本购买"}</p>
-                      <p className="text-xs text-gray-500">{new Date(p.createdAt).toLocaleString()}</p>
+                      <p className="text-xs text-gray-500">{p?.createdAt ? new Date(p.createdAt).toLocaleString() : "-"}</p>
                     </div>
                     <div className="text-right">
-                      <p className="text-sm font-bold text-[#38bdac]">+¥{p.amount}</p>
-                      <p className="text-xs text-gray-400">{p.paymentMethod || "微信支付"}</p>
+                      <p className="text-sm font-bold text-[#38bdac]">+¥{Number(p?.amount) || 0}</p>
+                      <p className="text-xs text-gray-400">{p?.paymentMethod || "微信支付"}</p>
                     </div>
                   </div>
                 ))}
@@ -169,7 +170,7 @@ export default function AdminDashboard() {
                       </div>
                     </div>
                     <p className="text-xs text-gray-400">
-                      {u.createdAt ? new Date(u.createdAt).toLocaleDateString() : "-"}
+                      {u?.createdAt ? new Date(u.createdAt).toLocaleDateString() : "-"}
                     </p>
                   </div>
                 ))}

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/logout/route.ts

@@ -0,0 +1,9 @@
+import { NextRequest, NextResponse } from 'next/server'
+import { getAdminCookieName, getAdminCookieOptions } from '@/lib/admin-auth'
+
+export async function POST(_req: NextRequest) {
+  const res = NextResponse.json({ success: true })
+  const opts = getAdminCookieOptions()
+  res.cookies.set(getAdminCookieName(), '', { ...opts, maxAge: 0 })
+  return res
+}

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/auth/login/route.ts

@@ -0,0 +1,72 @@
+/**
+ * Web 端登录：手机号 + 密码
+ * POST { phone, password } -> 校验后返回用户信息（不含密码）
+ */
+
+import { NextRequest, NextResponse } from 'next/server'
+import { query } from '@/lib/db'
+import { verifyPassword } from '@/lib/password'
+
+function mapRowToUser(r: any) {
+  return {
+    id: r.id,
+    phone: r.phone || '',
+    nickname: r.nickname || '',
+    isAdmin: !!r.is_admin,
+    purchasedSections: Array.isArray(r.purchased_sections)
+      ? r.purchased_sections
+      : (r.purchased_sections ? JSON.parse(String(r.purchased_sections)) : []) || [],
+    hasFullBook: !!r.has_full_book,
+    referralCode: r.referral_code || '',
+    earnings: parseFloat(String(r.earnings || 0)),
+    pendingEarnings: parseFloat(String(r.pending_earnings || 0)),
+    withdrawnEarnings: parseFloat(String(r.withdrawn_earnings || 0)),
+    referralCount: Number(r.referral_count) || 0,
+    createdAt: r.created_at || '',
+  }
+}
+
+export async function POST(request: NextRequest) {
+  try {
+    const body = await request.json()
+    const { phone, password } = body
+
+    if (!phone || !password) {
+      return NextResponse.json(
+        { success: false, error: '请输入手机号和密码' },
+        { status: 400 }
+      )
+    }
+
+    const rows = await query(
+      'SELECT id, phone, nickname, password, is_admin, has_full_book, referral_code, earnings, pending_earnings, withdrawn_earnings, referral_count, purchased_sections, created_at FROM users WHERE phone = ?',
+      [String(phone).trim()]
+    ) as any[]
+
+    if (!rows || rows.length === 0) {
+      return NextResponse.json(
+        { success: false, error: '用户不存在或密码错误' },
+        { status: 401 }
+      )
+    }
+
+    const row = rows[0]
+    const storedPassword = row.password == null ? '' : String(row.password)
+
+    if (!verifyPassword(String(password), storedPassword)) {
+      return NextResponse.json(
+        { success: false, error: '密码错误' },
+        { status: 401 }
+      )
+    }
+
+    const user = mapRowToUser(row)
+    return NextResponse.json({ success: true, user })
+  } catch (e) {
+    console.error('[Auth Login] error:', e)
+    return NextResponse.json(
+      { success: false, error: '登录失败' },
+      { status: 500 }
+    )
+  }
+}

app/api/auth/reset-password/route.ts

@@ -0,0 +1,54 @@
+/**
+ * 忘记密码 / 重置密码（Web 端）
+ * POST { phone, newPassword } -> 按手机号更新密码（无验证码版本，适合内测/内部使用）
+ */
+
+import { NextRequest, NextResponse } from 'next/server'
+import { query } from '@/lib/db'
+import { hashPassword } from '@/lib/password'
+
+export async function POST(request: NextRequest) {
+  try {
+    const body = await request.json()
+    const { phone, newPassword } = body
+
+    if (!phone || !newPassword) {
+      return NextResponse.json(
+        { success: false, error: '请输入手机号和新密码' },
+        { status: 400 }
+      )
+    }
+
+    const trimmedPhone = String(phone).trim()
+    const trimmedPassword = String(newPassword).trim()
+
+    if (trimmedPassword.length < 6) {
+      return NextResponse.json(
+        { success: false, error: '密码至少 6 位' },
+        { status: 400 }
+      )
+    }
+
+    const rows = await query('SELECT id FROM users WHERE phone = ?', [trimmedPhone]) as any[]
+    if (!rows || rows.length === 0) {
+      return NextResponse.json(
+        { success: false, error: '该手机号未注册' },
+        { status: 404 }
+      )
+    }
+
+    const hashed = hashPassword(trimmedPassword)
+    await query('UPDATE users SET password = ?, updated_at = NOW() WHERE phone = ?', [
+      hashed,
+      trimmedPhone,
+    ])
+
+    return NextResponse.json({ success: true, message: '密码已重置，请使用新密码登录' })
+  } catch (e) {
+    console.error('[Auth ResetPassword] error:', e)
+    return NextResponse.json(
+      { success: false, error: '重置失败' },
+      { status: 500 }
+    )
+  }
+}

app/api/book/all-chapters/route.ts

@@ -3,7 +3,72 @@ import fs from 'fs'
 import path from 'path'
 import { query } from '@/lib/db'
 
+/** 精选推荐：按 user_tracks 的 view_chapter 点击量排序，排除序言/尾声/附录 */
+async function getFeaturedSections(): Promise<Array<{ id: string; title: string; tag: string; tagClass: string; part: string }>> {
+  const tags = [
+    { tag: '热门', tagClass: 'tag-pink' },
+    { tag: '推荐', tagClass: 'tag-purple' },
+    { tag: '精选', tagClass: 'tag-free' }
+  ]
+  try {
+    // 优先按 view_chapter 点击量排序
+    const rows = (await query(`
+      SELECT c.id, c.section_title, c.part_title, c.is_free,
+             COALESCE(t.cnt, 0) as view_count
+      FROM chapters c
+      LEFT JOIN (
+        SELECT chapter_id, COUNT(*) as cnt
+        FROM user_tracks
+        WHERE action = 'view_chapter' AND chapter_id IS NOT NULL
+        GROUP BY chapter_id
+      ) t ON c.id = t.chapter_id
+      WHERE c.id NOT IN ('preface','epilogue')
+        AND c.id NOT LIKE 'appendix-%' AND c.id NOT LIKE 'appendix_%'
+        AND (c.part_title NOT LIKE '%序言%' AND c.part_title NOT LIKE '%尾声%')
+      ORDER BY view_count DESC, c.updated_at DESC
+      LIMIT 3
+    `)) as any[]
+    if (rows && rows.length > 0) {
+      return rows.map((r, i) => ({
+        id: r.id,
+        title: r.section_title || r.title || '',
+        part: (r.part_title || '真实的行业').replace(/^第[一二三四五六七八九十]+篇｜?/, '').trim() || '真实的行业',
+        tag: tags[i]?.tag || '推荐',
+        tagClass: tags[i]?.tagClass || 'tag-purple'
+      }))
+    }
+  } catch (e) {
+    console.log('[All Chapters API] 精选推荐查询失败:', (e as Error).message)
+  }
+  try {
+    const fallback = (await query(`
+      SELECT id, section_title, part_title, is_free
+      FROM chapters
+      WHERE id NOT IN ('preface','epilogue')
+        AND id NOT LIKE 'appendix-%' AND id NOT LIKE 'appendix_%'
+        AND (part_title NOT LIKE '%序言%' AND part_title NOT LIKE '%尾声%')
+      ORDER BY updated_at DESC
+      LIMIT 3
+    `)) as any[]
+    if (fallback?.length > 0) {
+      return fallback.map((r, i) => ({
+        id: r.id,
+        title: r.section_title || r.title || '',
+        part: (r.part_title || '真实的行业').replace(/^第[一二三四五六七八九十]+篇｜?/, '').trim() || '真实的行业',
+        tag: tags[i]?.tag || '推荐',
+        tagClass: tags[i]?.tagClass || 'tag-purple'
+      }))
+    }
+  } catch (_) {}
+  return [
+    { id: '1.1', title: '荷包：电动车出租的被动收入模式', tag: '免费', tagClass: 'tag-free', part: '真实的人' },
+    { id: '3.1', title: '3000万流水如何跑出来', tag: '热门', tagClass: 'tag-pink', part: '真实的行业' },
+    { id: '8.1', title: '流量杠杆:抖音、Soul、飞书', tag: '推荐', tagClass: 'tag-purple', part: '真实的赚钱' }
+  ]
+}
+
 export async function GET() {
+  const featuredSections = await getFeaturedSections()
   try {
     // 方案1: 优先从数据库读取章节数据
     try {
@@ -17,34 +82,87 @@ export async function GET() {
       `) as any[]
       
       if (dbChapters && dbChapters.length > 0) {
-        console.log('[All Chapters API] 从数据库读取成功，共', dbChapters.length, '章')
+        console.log('[All Chapters API] 从数据库读取成功，共', dbChapters.length, '条')
         
-        // 格式化数据
-        const allChapters = dbChapters.map((chapter: any) => ({
-          id: chapter.id,
-          sectionId: chapter.section_id,
-          title: chapter.title,
-          sectionTitle: chapter.section_title,
-          content: chapter.content,
-          isFree: !!chapter.is_free,
-          price: chapter.price || 0,
-          words: chapter.words || Math.floor(Math.random() * 3000) + 2000,
-          sectionOrder: chapter.section_order,
-          chapterOrder: chapter.chapter_order,
-          createdAt: chapter.created_at,
-          updatedAt: chapter.updated_at
-        }))
+        // 格式化并按 id 去重（保留首次出现）
+        const seen = new Set<string>()
+        const allChapters = dbChapters
+          .map((chapter: any) => ({
+            id: chapter.id,
+            sectionId: chapter.section_id ?? chapter.id,
+            title: chapter.title ?? chapter.section_title,
+            sectionTitle: chapter.section_title ?? chapter.title,
+            content: chapter.content,
+            isFree: !!chapter.is_free,
+            price: chapter.price || 0,
+            words: chapter.words || Math.floor(Math.random() * 3000) + 2000,
+            sectionOrder: chapter.section_order,
+            chapterOrder: chapter.chapter_order,
+            createdAt: chapter.created_at,
+            updatedAt: chapter.updated_at
+          }))
+          .filter((row: { id: string }) => {
+            if (seen.has(row.id)) return false
+            seen.add(row.id)
+            return true
+          })
         
         return NextResponse.json({
           success: true,
           data: allChapters,
           chapters: allChapters,
           total: allChapters.length,
-          source: 'database'
+          source: 'database',
+          featuredSections
         })
       }
     } catch (dbError) {
-      console.log('[All Chapters API] 数据库读取失败，尝试文件读取:', (dbError as Error).message)
+      console.log('[All Chapters API] sections 表读取失败，尝试 chapters 表:', (dbError as Error).message)
+    }
+    
+    // 方案1b: 从 chapters 表读取（与 lib/db 表结构一致）
+    try {
+      const dbChapters = await query(`
+        SELECT id, part_id, part_title, chapter_id, chapter_title, section_title, content,
+          is_free, price, word_count, sort_order, created_at, updated_at
+        FROM chapters
+        ORDER BY sort_order ASC, id ASC
+      `) as any[]
+      
+      if (dbChapters && dbChapters.length > 0) {
+        console.log('[All Chapters API] 从 chapters 表读取成功，共', dbChapters.length, '条')
+        const seen = new Set<string>()
+        const allChapters = dbChapters
+          .map((row: any) => ({
+            id: row.id,
+            sectionId: row.id,
+            title: row.section_title,
+            sectionTitle: row.section_title,
+            content: row.content,
+            isFree: !!row.is_free,
+            price: row.price || 0,
+            words: row.word_count || 0,
+            sectionOrder: row.sort_order ?? 0,
+            chapterOrder: 0,
+            createdAt: row.created_at,
+            updatedAt: row.updated_at
+          }))
+          .filter((row: { id: string }) => {
+            if (seen.has(row.id)) return false
+            seen.add(row.id)
+            return true
+          })
+        return NextResponse.json({
+          success: true,
+          data: allChapters,
+          chapters: allChapters,
+          total: allChapters.length,
+          source: 'database',
+          featuredSections
+        })
+      }
+    } catch (e2) {
+      console.log('[All Chapters API] chapters 表读取失败，尝试文件:', (e2 as Error).message)
     }
     
     // 方案2: 从JSON文件读取
@@ -72,11 +190,20 @@ export async function GET() {
     }
     
     if (chaptersData.length > 0) {
-      // 添加字数估算
-      const allChapters = chaptersData.map((chapter: any) => ({
-        ...chapter,
-        words: chapter.words || Math.floor(Math.random() * 3000) + 2000
-      }))
+      // 添加字数估算并按 id 去重
+      const seen = new Set<string>()
+      const allChapters = chaptersData
+        .map((chapter: any) => ({
+          ...chapter,
+          id: chapter.id ?? chapter.sectionId,
+          words: chapter.words || Math.floor(Math.random() * 3000) + 2000
+        }))
+        .filter((row: any) => {
+          const id = row.id || row.sectionId
+          if (!id || seen.has(String(id))) return false
+          seen.add(String(id))
+          return true
+        })
       
       return NextResponse.json({
         success: true,
@@ -84,7 +211,8 @@ export async function GET() {
         chapters: allChapters,
         total: allChapters.length,
         source: 'file',
-        path: usedPath
+        path: usedPath,
+        featuredSections
       })
     }
     
@@ -97,7 +225,8 @@ export async function GET() {
       data: defaultChapters,
       chapters: defaultChapters,
       total: defaultChapters.length,
-      source: 'default'
+      source: 'default',
+      featuredSections
     })
     
   } catch (error) {
@@ -111,7 +240,8 @@ export async function GET() {
       chapters: defaultChapters,
       total: defaultChapters.length,
       source: 'fallback',
-      warning: '使用默认数据'
+      warning: '使用默认数据',
+      featuredSections
     })
   }
 }

app/api/book/latest-chapters/route.ts

@@ -1,55 +1,109 @@
 // app/api/book/latest-chapters/route.ts
-// 获取最新章节列表
+// 获取最新章节：有2日内更新则取最新3章，否则随机取免费章节
+// 排除序言、尾声、附录，只推荐正文章节
 
-import { NextRequest, NextResponse } from 'next/server'
-import { getBookStructure } from '@/lib/book-file-system'
+import { NextResponse } from 'next/server'
+import { query } from '@/lib/db'
 
-export async function GET(req: NextRequest) {
+const TWO_DAYS_MS = 2 * 24 * 60 * 60 * 1000
+
+/** 是否应排除（序言、尾声、附录等特殊章节） */
+function isExcludedChapter(id: string, partTitle: string): boolean {
+  const lowerId = String(id || '').toLowerCase()
+  if (lowerId === 'preface' || lowerId === 'epilogue') return true
+  if (lowerId.startsWith('appendix-') || lowerId.startsWith('appendix_')) return true
+  const pt = String(partTitle || '')
+  if (/序言|尾声/.test(pt)) return true
+  return false
+}
+
+export async function GET() {
   try {
-    const bookStructure = getBookStructure()
-    
-    // 获取所有章节并按时间排序
-    const allChapters: any[] = []
-    
-    bookStructure.forEach((part: any) => {
-      part.chapters.forEach((chapter: any) => {
-        allChapters.push({
-          id: chapter.slug,
-          title: chapter.title,
-          part: part.title,
-          words: Math.floor(Math.random() * 3000) + 1500, // 模拟字数
-          updateTime: getRelativeTime(new Date(Date.now() - Math.random() * 30 * 24 * 60 * 60 * 1000)),
-          readTime: Math.ceil((Math.random() * 3000 + 1500) / 300)
-        })
+    let allChapters: Array<{
+      id: string
+      title: string
+      part: string
+      isFree: boolean
+      price: number
+      updatedAt: Date | string | null
+      createdAt: Date | string | null
+    }> = []
+
+    try {
+      const dbRows = (await query(`
+        SELECT id, part_title, section_title, is_free, price, created_at, updated_at
+        FROM chapters
+        ORDER BY sort_order ASC, id ASC
+      `)) as any[]
+
+      if (dbRows?.length > 0) {
+        allChapters = dbRows
+          .map((row: any) => ({
+            id: row.id,
+            title: row.section_title || row.title || '',
+            part: row.part_title || '真实的行业',
+            isFree: !!row.is_free,
+            price: row.price || 0,
+            updatedAt: row.updated_at || row.created_at,
+            createdAt: row.created_at
+          }))
+          .filter((c) => !isExcludedChapter(c.id, c.part))
+      }
+    } catch (e) {
+      console.log('[latest-chapters] 数据库读取失败:', (e as Error).message)
+    }
+
+    if (allChapters.length === 0) {
+      return NextResponse.json({
+        success: true,
+        banner: { id: '1.1', title: '荷包：电动车出租的被动收入模式', part: '真实的人' },
+        label: '为你推荐',
+        chapters: [],
+        hasNewUpdates: false
       })
+    }
+
+    const now = Date.now()
+    const sorted = [...allChapters].sort((a, b) => {
+      const ta = a.updatedAt ? new Date(a.updatedAt).getTime() : 0
+      const tb = b.updatedAt ? new Date(b.updatedAt).getTime() : 0
+      return tb - ta
     })
 
-    // 取最新的3章
-    const latestChapters = allChapters.slice(0, 3)
+    const mostRecentTime = sorted[0]?.updatedAt ? new Date(sorted[0].updatedAt).getTime() : 0
+    const hasNewUpdates = now - mostRecentTime < TWO_DAYS_MS
+
+    let banner: { id: string; title: string; part: string }
+    let label: string
+    let chapters: typeof allChapters
+
+    if (hasNewUpdates && sorted.length > 0) {
+      chapters = sorted.slice(0, 3)
+      banner = { id: chapters[0].id, title: chapters[0].title, part: chapters[0].part }
+      label = '最新更新'
+    } else {
+      const freeChapters = allChapters.filter((c) => c.isFree || c.price === 0)
+      const candidates = freeChapters.length > 0 ? freeChapters : allChapters
+      const shuffled = [...candidates].sort(() => Math.random() - 0.5)
+      chapters = shuffled.slice(0, 3)
+      banner = chapters[0]
+        ? { id: chapters[0].id, title: chapters[0].title, part: chapters[0].part }
+        : { id: allChapters[0].id, title: allChapters[0].title, part: allChapters[0].part }
+      label = '为你推荐'
+    }
 
     return NextResponse.json({
       success: true,
-      chapters: latestChapters,
-      total: allChapters.length
+      banner,
+      label,
+      chapters: chapters.map((c) => ({ id: c.id, title: c.title, part: c.part, isFree: c.isFree })),
+      hasNewUpdates
     })
   } catch (error) {
-    console.error('获取章节失败:', error)
+    console.error('[latest-chapters] Error:', error)
     return NextResponse.json(
-      { error: '获取章节失败' },
+      { success: false, error: '获取失败' },
       { status: 500 }
     )
   }
 }
-
-// 获取相对时间
-function getRelativeTime(date: Date): string {
-  const now = new Date()
-  const diff = now.getTime() - date.getTime()
-  const days = Math.floor(diff / (1000 * 60 * 60 * 24))
-  
-  if (days === 0) return '今天'
-  if (days === 1) return '昨天'
-  if (days < 7) return `${days}天前`
-  if (days < 30) return `${Math.floor(days / 7)}周前`
-  return `${Math.floor(days / 30)}个月前`
-}

app/api/content/upload/route.ts

@@ -0,0 +1,97 @@
+/**
+ * 内容上传 API
+ * 供科室/Skill 直接上传单篇文章到书籍内容，写入 chapters 表
+ * 字段：标题、定价、内容、格式、插入内容中的图片（URL 列表）
+ */
+
+import { NextRequest, NextResponse } from 'next/server'
+import { query } from '@/lib/db'
+
+function slug(id: string): string {
+  return id.replace(/\s+/g, '-').replace(/[^\w\u4e00-\u9fa5-]/g, '').slice(0, 30) || 'section'
+}
+
+export async function POST(request: NextRequest) {
+  try {
+    const body = await request.json()
+    const {
+      title,
+      price = 1,
+      content = '',
+      format = 'markdown',
+      images = [],
+      partId = 'part-1',
+      partTitle = '真实的人',
+      chapterId = 'chapter-1',
+      chapterTitle = '未分类',
+      isFree = false,
+      sectionId
+    } = body
+
+    if (!title || typeof title !== 'string') {
+      return NextResponse.json(
+        { success: false, error: '标题 title 不能为空' },
+        { status: 400 }
+      )
+    }
+
+    // 若内容中含占位符 {{image_0}} {{image_1}}，用 images 数组替换
+    let finalContent = typeof content === 'string' ? content : ''
+    if (Array.isArray(images) && images.length > 0) {
+      images.forEach((url: string, i: number) => {
+        finalContent = finalContent.replace(
+          new RegExp(`\\{\\{image_${i}\\}\\}`, 'g'),
+          url.startsWith('http') ? `![图${i + 1}](${url})` : url
+        )
+      })
+    }
+    // 未替换的占位符去掉
+    finalContent = finalContent.replace(/\{\{image_\d+\}\}/g, '')
+
+    const wordCount = (finalContent || '').length
+    const id = sectionId || `upload.${slug(title)}.${Date.now()}`
+
+    await query(
+      `INSERT INTO chapters (id, part_id, part_title, chapter_id, chapter_title, section_title, content, word_count, is_free, price, sort_order, status)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 9999, 'published')
+       ON DUPLICATE KEY UPDATE
+         section_title = VALUES(section_title),
+         content = VALUES(content),
+         word_count = VALUES(word_count),
+         is_free = VALUES(is_free),
+         price = VALUES(price),
+         updated_at = CURRENT_TIMESTAMP`,
+      [
+        id,
+        partId,
+        partTitle,
+        chapterId,
+        chapterTitle,
+        title,
+        finalContent,
+        wordCount,
+        !!isFree,
+        Number(price) || 1
+      ]
+    )
+
+    return NextResponse.json({
+      success: true,
+      id,
+      message: '内容已上传并写入 chapters 表',
+      title,
+      price: Number(price) || 1,
+      isFree: !!isFree,
+      wordCount
+    })
+  } catch (error) {
+    console.error('[Content Upload]', error)
+    return NextResponse.json(
+      {
+        success: false,
+        error: '上传失败: ' + (error as Error).message
+      },
+      { status: 500 }
+    )
+  }
+}

app/api/db/book/route.ts

@@ -146,13 +146,40 @@ export async function GET(request: NextRequest) {
     }
     
     // 列出所有章节（不含内容）
+    // 优先从数据库读取，确保新建章节能立即显示
     if (action === 'list') {
+      const sectionsFromDb = new Map<string, any>()
+      try {
+        const rows = await query(`
+          SELECT id, part_id, part_title, chapter_id, chapter_title, section_title, 
+                 price, is_free, content
+          FROM chapters ORDER BY part_id, chapter_id, id
+        `) as any[]
+        if (rows && rows.length > 0) {
+          for (const r of rows) {
+            sectionsFromDb.set(r.id, {
+              id: r.id,
+              title: r.section_title || '',
+              price: r.price ?? 1,
+              isFree: !!r.is_free,
+              partId: r.part_id || 'part-1',
+              partTitle: r.part_title || '',
+              chapterId: r.chapter_id || 'chapter-1',
+              chapterTitle: r.chapter_title || '',
+              filePath: ''
+            })
+          }
+        }
+      } catch (e) {
+        console.log('[Book API] list 从数据库读取失败，回退到 bookData:', (e as Error).message)
+      }
+      // 合并：以数据库为准，数据库没有的用 bookData 补
       const sections: any[] = []
-      
       for (const part of bookData) {
         for (const chapter of part.chapters) {
           for (const section of chapter.sections) {
-            sections.push({
+            const dbRow = sectionsFromDb.get(section.id)
+            sections.push(dbRow || {
               id: section.id,
               title: section.title,
               price: section.price,
@@ -163,14 +190,25 @@ export async function GET(request: NextRequest) {
               chapterTitle: chapter.title,
               filePath: section.filePath
             })
+            sectionsFromDb.delete(section.id)
           }
         }
       }
-      
+      // 数据库有但 bookData 没有的（新建章节）
+      for (const [, v] of sectionsFromDb) {
+        sections.push(v)
+      }
+      // 按 id 去重，避免数据库重复或合并逻辑导致同一文章出现多次
+      const seen = new Set<string>()
+      const deduped = sections.filter((s) => {
+        if (seen.has(s.id)) return false
+        seen.add(s.id)
+        return true
+      })
       return NextResponse.json({
         success: true,
-        sections,
-        total: sections.length
+        sections: deduped,
+        total: deduped.length
       })
     }
     
@@ -324,7 +362,7 @@ export async function POST(request: NextRequest) {
 export async function PUT(request: NextRequest) {
   try {
     const body = await request.json()
-    const { id, title, content, price, saveToFile = true } = body
+    const { id, title, content, price, saveToFile = true, partId, chapterId, partTitle, chapterTitle, isFree } = body
     
     if (!id) {
       return NextResponse.json({
@@ -334,28 +372,40 @@ export async function PUT(request: NextRequest) {
     }
     
     const sectionInfo = getSectionInfo(id)
+    const finalPartId = partId || sectionInfo?.partId || 'part-1'
+    const finalPartTitle = partTitle || sectionInfo?.partTitle || '未分类'
+    const finalChapterId = chapterId || sectionInfo?.chapterId || 'chapter-1'
+    const finalChapterTitle = chapterTitle || sectionInfo?.chapterTitle || '未分类'
+    const finalPrice = price ?? sectionInfo?.section?.price ?? 1
+    const finalIsFree = isFree ?? sectionInfo?.section?.isFree ?? false
     
-    // 更新数据库
+    // 更新数据库（含新建章节）
     try {
       await query(`
-        INSERT INTO chapters (id, part_id, part_title, chapter_id, chapter_title, section_title, content, word_count, price, status)
-        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, 'published')
+        INSERT INTO chapters (id, part_id, part_title, chapter_id, chapter_title, section_title, content, word_count, is_free, price, status)
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 'published')
         ON DUPLICATE KEY UPDATE 
+          part_id = VALUES(part_id),
+          part_title = VALUES(part_title),
+          chapter_id = VALUES(chapter_id),
+          chapter_title = VALUES(chapter_title),
           section_title = VALUES(section_title),
           content = VALUES(content),
           word_count = VALUES(word_count),
+          is_free = VALUES(is_free),
           price = VALUES(price),
           updated_at = CURRENT_TIMESTAMP
       `, [
         id,
-        sectionInfo?.partId || 'part-1',
-        sectionInfo?.partTitle || '未分类',
-        sectionInfo?.chapterId || 'chapter-1',
-        sectionInfo?.chapterTitle || '未分类',
-        title || sectionInfo?.section.title || '',
+        finalPartId,
+        finalPartTitle,
+        finalChapterId,
+        finalChapterTitle,
+        title || sectionInfo?.section?.title || '',
         content || '',
         (content || '').length,
-        price ?? sectionInfo?.section.price ?? 1
+        finalIsFree,
+        finalPrice
       ])
     } catch (e) {
       console.error('[Book API] 更新数据库失败:', e)

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/layout.tsx

@@ -41,7 +41,7 @@ export default function RootLayout({
     <html lang="zh-CN">
       <body className="bg-black">
         <LayoutWrapper>{children}</LayoutWrapper>
-        <Analytics />
+        {process.env.NODE_ENV === 'production' && <Analytics />}
       </body>
     </html>
   )

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.1 荷包：电动车出租的被动收入模式.md

@@ -1,219 +0,0 @@
-"每个人都在梦想特斯拉帮他挣钱，我现在电动车帮我挣钱。"
-
-2025年10月21日，周一，早上6点18分。
-
-Soul派对房里进来一个人，声音很稳。
-
-他上麦之后，先听了十分钟。
-
-然后说了一句话："你讲的被动收入，我做了好几年了。"
-
-我愣了一下。
-
-Soul上吹牛的人太多，但这个人的语气不像吹牛。
-
----
-
-"那你是做什么的？"
-
-"电动车。"
-
-"电动车？卖车的？"
-
-”不是，出租的。"
-
-"出租电动车？"
-
-"对，在泉州，我有1000辆电动车。"
-
-派对房里，突然安静了。
-
----
-
-"1000辆？怎么做的？"
-
-他笑了。
-
-"其实很简单。"
-
-"你找一个工厂、工业园区，那里有很多工人，对吧？"
-
-"工人上下班需要交通工具，骑电动车最方便。"
-
-"但买一辆电动车要两三千块，很多人舍不得。"
-
-"那我就租给他们。"
-
-他停了一下。
-
-"一个月三百六十几块，一天算下来才十几块钱。"
-
-"工人觉得划算，我也稳定赚钱。"
-
----
-
-派对房里，有人打字："那你一个月能赚多少？"
-
-他说："1000辆车，一个月就是三十多万流水。"
-
-"扣掉成本、维护、人工，净利润大概十几万。"
-
-"关键是，这是被动收入。"
-
-"车放在那里，每个月都有钱进来。"
-
----
-
-我问："那你怎么找到这些工厂的？"
-
-他说："一开始是自己一家一家跑。"
-
-"后来我发现，最好的办法是找做人力的人合作。"
-
-"做人力的，手上有大量的工厂资源。"
-
-"他给我介绍工厂，我给他分成。"
-
----
-
-派对房里，有人问："那你现在还在扩张吗？"
-
-他说："刚投了100多万，在河源又铺了500辆。"
-
-我有点惊讶。
-
-"河源？那不是广东那边吗？"
-
-他说："对，我在Soul上认识了一个小伙伴，姓李，大家叫他犟总。"
-
-"他在河源那边有个工业园区，5万多平，工人非常多。"
-
-"我们一聊，觉得这个事情可以做，就直接签了。"
-
----
-
-派对房里，有人说："等等，你们是在Soul上认识的？"
-
-他说："对，就是在这个派对房里。"
-
-我笑了。
-
-"这可能是我们派对房第一个真正落地的合作。"
-
-他说："可不是嘛。"
-
-"犟总那边做人力，我这边有车，一拍即合。"
-
-"他负责场地和工人，我负责车和运营。"
-
-"500辆车拉过去，直接就开始赚钱了。"
-
----
-
-派对房里，有人问："那你这个模式能复制吗？"
-
-他说："当然能。"
-
-"你只要找到有大量人口的地方，工厂、学校、工业园区都行。"
-
-"然后投车进去，租出去就完了。"
-
-他停了一下。
-
-"我现在还在看宝盖山那边。"
-
-"石狮那个理工学校，有两万六的学生。"
-
-"如果能摆电动车进去，又是一个新的点。"
-
----
-
-我问："那你这个生意最难的是什么？"
-
-他想了一下。
-
-"最难的是找到对的合作伙伴。"
-
-"你一个人做不了这个事情，你需要有人帮你搞定场地。"
-
-"场地有了，车铺进去，后面就是运营的事情了。"
-
-他继续说："所以我现在花很多时间在Soul上。"
-
-"因为这里能认识各种各样的人。"
-
-"做人力的、做地产的、做工厂的，什么人都有。"
-
-"你多聊，总能找到合适的合作伙伴。"
-
----
-
-派对房里，有人问："那你还做什么？"
-
-他说："车身广告。"
-
-"我1000辆电动车，每辆车身上都可以贴广告。"
-
-"一天一辆车才3毛钱，一个月9块钱。"
-
-"但1000辆车，一个月就是9000块额外收入。"
-
-"关键是，这个钱几乎没有成本，纯利润。"
-
----
-
-我问："所以你的生意模式是，车租出去赚租金，车身贴广告赚广告费？"
-
-他说："对，两条腿走路。"
-
-"租金是主要收入，广告是锦上添花。"
-
-"以后车多了，广告这块收入会越来越高。"
-
----
-
-那天聊完，已经快9点了。
-
-我在派对房里总结了一下。
-
-"刚才荷包分享的，是一个非常典型的被动收入模式。"
-
-"什么叫被动收入？"
-
-"就是你把资产放在那里，它自己给你赚钱。"
-
-"可以是房子出租，可以是电动车出租，可以是任何有需求的资产。"
-
-我停了一下。
-
-"但被动收入不是躺着赚钱。"
-
-"前期你要投入资金、要找合作伙伴、要铺设网络。"
-
-"等这些都做好了，后面才能相对轻松。"
-
----
-
-早上9点12分，荷包说他要去准备出发了。
-
-"今天500辆车都到河源了，我要过去盯一下。"
-
-"祝你顺利。"
-
-"谢了。下次回来给大家汇报进展。"
-
-派对房里有人说："这才是Soul的正确用法。"
-
-我笑了。
-
-确实，在这里认识的人，在这里谈成的合作，在这里落地的项目。
-
-这才是商业社会里社交的真正价值。
-
-不是认识多少人，而是能不能和对的人一起做对的事。
-
-荷包和犟总，一个有车，一个有场地。
-
-两个人在Soul上认识，在现实中落地。
-
-这就是资源整合最简单的样子。

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>

content-manager.html

@@ -0,0 +1,519 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>内容管理 - Soul创业派对</title>
+<style>
+*{margin:0;padding:0;box-sizing:border-box}
+body{background:#0a0e17;color:#e0e6ed;font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,sans-serif;min-height:100vh}
+a{color:#2dd4a8;text-decoration:none}
+a:hover{text-decoration:underline}
+.header{background:#111827;border-bottom:1px solid #1e293b;padding:16px 24px;display:flex;justify-content:space-between;align-items:center}
+.header h1{font-size:20px;font-weight:600}
+.header .back{color:#94a3b8;font-size:14px}
+.container{max-width:1200px;margin:0 auto;padding:24px}
+.tabs{display:flex;gap:8px;margin-bottom:24px;flex-wrap:wrap}
+.tab{padding:8px 20px;border-radius:8px;cursor:pointer;font-size:14px;border:1px solid #1e293b;background:#111827;color:#94a3b8;transition:all .2s}
+.tab.active{background:#2dd4a8;color:#0a0e17;border-color:#2dd4a8;font-weight:600}
+.tab:hover:not(.active){background:#1e293b}
+.card{background:#111827;border:1px solid #1e293b;border-radius:12px;padding:20px;margin-bottom:16px}
+.stats{display:grid;grid-template-columns:repeat(auto-fit,minmax(150px,1fr));gap:12px;margin-bottom:24px}
+.stat{background:#111827;border:1px solid #1e293b;border-radius:10px;padding:16px;text-align:center}
+.stat .num{font-size:28px;font-weight:700;color:#2dd4a8}
+.stat .label{font-size:12px;color:#64748b;margin-top:4px}
+.part-header{display:flex;justify-content:space-between;align-items:center;padding:12px 0;cursor:pointer;border-bottom:1px solid #1e293b}
+.part-title{font-size:16px;font-weight:600;color:#2dd4a8}
+.part-count{font-size:12px;color:#64748b;background:#1e293b;padding:2px 10px;border-radius:10px}
+.chapter-group{padding:8px 0 8px 16px}
+.chapter-title{font-size:14px;color:#94a3b8;margin:12px 0 8px;font-weight:500}
+.section-item{display:flex;justify-content:space-between;align-items:center;padding:10px 12px;border-radius:8px;transition:background .15s}
+.section-item:hover{background:#1e293b}
+.section-left{display:flex;align-items:center;gap:10px;flex:1;min-width:0}
+.section-id{font-size:12px;color:#64748b;min-width:40px}
+.section-title{font-size:14px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+.section-right{display:flex;align-items:center;gap:8px;flex-shrink:0}
+.badge{font-size:11px;padding:2px 8px;border-radius:4px;font-weight:500}
+.badge-free{background:rgba(45,212,168,.15);color:#2dd4a8}
+.badge-paid{background:rgba(234,179,8,.15);color:#eab308}
+.btn{padding:5px 12px;border-radius:6px;font-size:12px;cursor:pointer;border:1px solid #1e293b;background:#1e293b;color:#e0e6ed;transition:all .15s}
+.btn:hover{background:#334155}
+.btn-danger{border-color:#7f1d1d;color:#ef4444}
+.btn-danger:hover{background:#7f1d1d}
+.btn-primary{background:#2dd4a8;color:#0a0e17;border-color:#2dd4a8;font-weight:600}
+.btn-primary:hover{background:#22b896}
+.form-group{margin-bottom:16px}
+.form-group label{display:block;font-size:13px;color:#94a3b8;margin-bottom:6px;font-weight:500}
+.form-group input,.form-group select,.form-group textarea{width:100%;padding:10px 12px;background:#0a0e17;border:1px solid #1e293b;border-radius:8px;color:#e0e6ed;font-size:14px;outline:none;transition:border .2s}
+.form-group input:focus,.form-group select:focus,.form-group textarea:focus{border-color:#2dd4a8}
+.form-group textarea{min-height:200px;font-family:monospace;resize:vertical}
+.form-row{display:grid;grid-template-columns:1fr 1fr;gap:16px}
+.api-doc{font-family:monospace;font-size:13px;line-height:1.7}
+.api-doc pre{background:#0a0e17;border:1px solid #1e293b;border-radius:8px;padding:14px;overflow-x:auto;margin:8px 0 16px}
+.api-doc code{color:#2dd4a8}
+.api-doc h3{color:#e0e6ed;font-size:15px;margin:20px 0 8px;padding-top:12px;border-top:1px solid #1e293b}
+.api-doc h3:first-child{border-top:none;margin-top:0}
+.toast{position:fixed;top:20px;right:20px;padding:12px 20px;border-radius:8px;font-size:14px;z-index:9999;animation:slideIn .3s}
+.toast-success{background:#065f46;color:#6ee7b7}
+.toast-error{background:#7f1d1d;color:#fca5a5}
+@keyframes slideIn{from{transform:translateX(100%);opacity:0}to{transform:translateX(0);opacity:1}}
+.loading{text-align:center;padding:40px;color:#64748b}
+.empty{text-align:center;padding:60px;color:#475569}
+.search-bar{display:flex;gap:12px;margin-bottom:20px}
+.search-bar input{flex:1}
+.modal-overlay{position:fixed;inset:0;background:rgba(0,0,0,.6);z-index:100;display:flex;align-items:center;justify-content:center}
+.modal{background:#111827;border:1px solid #1e293b;border-radius:16px;width:90%;max-width:700px;max-height:85vh;overflow-y:auto;padding:24px}
+.modal h2{font-size:18px;margin-bottom:16px}
+.modal-actions{display:flex;justify-content:flex-end;gap:10px;margin-top:20px}
+.hidden{display:none}
+</style>
+</head>
+<body>
+<div class="header">
+  <h1>内容管理 · Soul创业派对</h1>
+  <a class="back" href="/">← 返回管理后台</a>
+</div>
+
+<div class="container">
+  <div class="tabs">
+    <div class="tab active" data-tab="chapters" onclick="switchTab('chapters')">章节管理</div>
+    <div class="tab" data-tab="upload" onclick="switchTab('upload')">上传内容</div>
+    <div class="tab" data-tab="api" onclick="switchTab('api')">API 接口文档</div>
+  </div>
+
+  <!-- 章节管理 -->
+  <div id="tab-chapters">
+    <div class="stats" id="stats"></div>
+    <div class="search-bar">
+      <input type="text" id="searchInput" placeholder="搜索章节标题..." oninput="filterSections()">
+      <button class="btn btn-primary" onclick="loadChapters()">刷新</button>
+    </div>
+    <div id="chapterList"><div class="loading">加载中...</div></div>
+  </div>
+
+  <!-- 上传内容 -->
+  <div id="tab-upload" class="hidden">
+    <div class="card">
+      <h2 style="margin-bottom:16px">上传新章节</h2>
+      <div class="form-row">
+        <div class="form-group">
+          <label>章节ID (如 1.6，留空自动生成)</label>
+          <input type="text" id="up_id" placeholder="自动生成">
+        </div>
+        <div class="form-group">
+          <label>定价 (0=免费)</label>
+          <input type="number" id="up_price" value="1" step="0.1" min="0">
+        </div>
+      </div>
+      <div class="form-group">
+        <label>标题 *</label>
+        <input type="text" id="up_title" placeholder="章节标题">
+      </div>
+      <div class="form-row">
+        <div class="form-group">
+          <label>所属篇</label>
+          <select id="up_part">
+            <option value="part-1">第一篇｜真实的人</option>
+            <option value="part-2">第二篇｜真实的行业</option>
+            <option value="part-3">第三篇｜真实的错误</option>
+            <option value="part-4">第四篇｜真实的赚钱</option>
+            <option value="part-5">第五篇｜真实的社会</option>
+            <option value="appendix">附录</option>
+            <option value="intro">序言</option>
+            <option value="outro">尾声</option>
+          </select>
+        </div>
+        <div class="form-group">
+          <label>所属章</label>
+          <select id="up_chapter">
+            <option value="chapter-1">第1章｜人与人之间的底层逻辑</option>
+            <option value="chapter-2">第2章｜人性困境案例</option>
+            <option value="chapter-3">第3章｜电商篇</option>
+            <option value="chapter-4">第4章｜内容商业篇</option>
+            <option value="chapter-5">第5章｜传统行业篇</option>
+            <option value="chapter-6">第6章｜我人生错过的4件大钱</option>
+            <option value="chapter-7">第7章｜别人犯的错误</option>
+            <option value="chapter-8">第8章｜底层结构</option>
+            <option value="chapter-9">第9章｜我在Soul上亲访的赚钱案例</option>
+            <option value="chapter-10">第10章｜未来职业的变化趋势</option>
+            <option value="chapter-11">第11章｜中国社会商业生态的未来</option>
+            <option value="appendix">附录</option>
+            <option value="preface">序言</option>
+            <option value="epilogue">尾声</option>
+          </select>
+        </div>
+      </div>
+      <div class="form-group">
+        <label>内容 (Markdown格式) *</label>
+        <textarea id="up_content" placeholder="# 标题&#10;&#10;正文内容...&#10;&#10;图片用 {{image_1}} 占位"></textarea>
+      </div>
+      <div class="form-group">
+        <label>图片URL (每行一个，替换 {{image_1}}, {{image_2}}...)</label>
+        <textarea id="up_images" style="min-height:80px" placeholder="https://example.com/img1.png&#10;https://example.com/img2.png"></textarea>
+      </div>
+      <button class="btn btn-primary" style="width:100%;padding:12px;font-size:15px" onclick="uploadContent()">上传章节</button>
+    </div>
+  </div>
+
+  <!-- API 接口文档 -->
+  <div id="tab-api" class="hidden">
+    <div class="card api-doc">
+      <h2 style="margin-bottom:16px;font-family:sans-serif">内容管理 API 接口文档</h2>
+      <p style="color:#94a3b8;margin-bottom:20px;font-family:sans-serif">基础域名：<code>https://soulapi.quwanzhi.com</code>（正式）/ <code>https://souldev.quwanzhi.com</code>（开发）</p>
+
+      <h3>1. 获取所有章节</h3>
+      <pre>GET /api/book/all-chapters
+
+# 无需认证，返回全部章节
+curl https://soulapi.quwanzhi.com/api/book/all-chapters</pre>
+      <p>响应：<code>{"success": true, "data": [{"id":"1.1", "sectionTitle":"...", "isFree":true, "price":0, ...}]}</code></p>
+
+      <h3>2. 获取单章内容</h3>
+      <pre>GET /api/book/chapter/:id
+
+curl https://soulapi.quwanzhi.com/api/book/chapter/1.1</pre>
+      <p>响应：<code>{"success": true, "data": {"id":"1.1", "content":"# 正文...", ...}}</code></p>
+
+      <h3>3. 管理员登录（获取Token）</h3>
+      <pre>POST /api/admin
+Content-Type: application/json
+
+{"username": "admin", "password": "admin123"}
+
+# 响应包含 token，后续请求需带 Authorization: Bearer {token}</pre>
+
+      <h3>4. 章节列表（管理员）</h3>
+      <pre>GET /api/db/book?action=list
+Authorization: Bearer {token}
+
+# 返回所有章节的元数据（不含正文）</pre>
+
+      <h3>5. 读取章节内容（管理员）</h3>
+      <pre>GET /api/db/book?action=read&id={section_id}
+Authorization: Bearer {token}</pre>
+
+      <h3>6. 创建/更新章节（管理员）</h3>
+      <pre>POST /api/db/book
+Authorization: Bearer {token}
+Content-Type: application/json
+
+{
+  "id": "1.6",           // 章节ID，不传则自动生成
+  "title": "章节标题",
+  "content": "Markdown正文",
+  "price": 1.0,          // 定价，0=免费
+  "partId": "part-1",    // 所属篇
+  "chapterId": "chapter-1" // 所属章
+}</pre>
+
+      <h3>7. 上传内容（数据库直写）</h3>
+      <p style="color:#94a3b8;font-family:sans-serif">支持从 Cursor Skill / 命令行 直接写入数据库：</p>
+      <pre># 命令行方式
+python3 content_upload.py \
+  --title "标题" \
+  --price 1.0 \
+  --content "正文内容" \
+  --part part-1 \
+  --chapter chapter-1 \
+  --format markdown
+
+# JSON方式
+python3 content_upload.py --json '{
+  "title": "标题",
+  "price": 1.0,
+  "content": "正文...",
+  "part_id": "part-1",
+  "chapter_id": "chapter-1",
+  "images": ["https://img.com/1.png"]
+}'
+
+# 查看篇章结构
+python3 content_upload.py --list-structure
+
+# 列出所有章节
+python3 content_upload.py --list-chapters</pre>
+
+      <h3>8. 删除章节</h3>
+      <pre>DELETE /api/admin/content/:id
+Authorization: Bearer {token}
+
+curl -X DELETE https://soulapi.quwanzhi.com/api/admin/content/1.6 \
+  -H "Authorization: Bearer {token}"</pre>
+
+      <h3>9. 数据库连接信息</h3>
+      <pre># 如需直连数据库
+Host: 56b4c23f6853c.gz.cdb.myqcloud.com
+Port: 14413
+User: cdb_outerroot
+DB:   soul_miniprogram
+表:   chapters (mid自增主键, id章节号唯一索引)</pre>
+    </div>
+  </div>
+</div>
+
+<!-- 编辑弹窗 -->
+<div id="editModal" class="modal-overlay hidden">
+  <div class="modal">
+    <h2 id="editTitle">编辑章节</h2>
+    <div class="form-group">
+      <label>标题</label>
+      <input type="text" id="edit_title">
+    </div>
+    <div class="form-row">
+      <div class="form-group">
+        <label>定价</label>
+        <input type="number" id="edit_price" step="0.1" min="0">
+      </div>
+      <div class="form-group">
+        <label>免费</label>
+        <select id="edit_free"><option value="1">是</option><option value="0">否</option></select>
+      </div>
+    </div>
+    <div class="form-group">
+      <label>内容 (Markdown)</label>
+      <textarea id="edit_content" style="min-height:300px"></textarea>
+    </div>
+    <div class="modal-actions">
+      <button class="btn" onclick="closeModal()">取消</button>
+      <button class="btn btn-primary" onclick="saveEdit()">保存</button>
+    </div>
+  </div>
+</div>
+
+<script>
+const API_PROD = 'https://soulapi.quwanzhi.com';
+const API_DEV = 'https://souldev.quwanzhi.com';
+const DB_API = 'https://souldev.quwanzhi.com';
+
+let token = localStorage.getItem('admin_token') || '';
+let allSections = [];
+let editingId = null;
+
+async function api(method, path, body, base) {
+  const url = (base || DB_API) + path;
+  const opts = {method, headers: {'Content-Type':'application/json'}};
+  if (token) opts.headers['Authorization'] = 'Bearer ' + token;
+  if (body) opts.body = JSON.stringify(body);
+  const r = await fetch(url, opts);
+  return r.json();
+}
+
+async function ensureAuth() {
+  if (token) {
+    const r = await api('GET', '/api/admin');
+    if (r.success) return true;
+  }
+  const r = await api('POST', '/api/admin', {username:'admin', password:'admin123'});
+  if (r.success && r.token) {
+    token = r.token;
+    localStorage.setItem('admin_token', token);
+    return true;
+  }
+  showToast('登录失败', 'error');
+  return false;
+}
+
+async function loadChapters() {
+  document.getElementById('chapterList').innerHTML = '<div class="loading">加载中...</div>';
+  if (!await ensureAuth()) return;
+
+  const r = await api('GET', '/api/db/book?action=list');
+  let items = r.sections || r.data || r.chapters || [];
+  allSections = items;
+
+  const parts = {};
+  items.forEach(s => {
+    const pk = s.partId || s.part_id || 'unknown';
+    const pt = s.partTitle || s.part_title || pk;
+    const ck = s.chapterId || s.chapter_id || 'unknown';
+    const ct = s.chapterTitle || s.chapter_title || ck;
+    if (!parts[pk]) parts[pk] = {title: pt, chapters: {}};
+    if (!parts[pk].chapters[ck]) parts[pk].chapters[ck] = {title: ct, sections: []};
+    parts[pk].chapters[ck].sections.push(s);
+  });
+
+  const partOrder = ['intro','part-1','part-2','part-3','part-4','part-5','outro','appendix'];
+  const sortedParts = Object.entries(parts).sort((a,b) => {
+    const ia = partOrder.indexOf(a[0]), ib = partOrder.indexOf(b[0]);
+    return (ia===-1?99:ia) - (ib===-1?99:ib);
+  });
+
+  const totalParts = sortedParts.length;
+  const freeCount = items.filter(s => s.isFree || s.is_free).length;
+  const paidCount = items.length - freeCount;
+
+  document.getElementById('stats').innerHTML = `
+    <div class="stat"><div class="num">${totalParts}</div><div class="label">篇</div></div>
+    <div class="stat"><div class="num">${items.length}</div><div class="label">节</div></div>
+    <div class="stat"><div class="num">${freeCount}</div><div class="label">免费</div></div>
+    <div class="stat"><div class="num">${paidCount}</div><div class="label">付费</div></div>
+  `;
+
+  let html = '';
+  let partIdx = 0;
+  sortedParts.forEach(([pk, pv]) => {
+    partIdx++;
+    const totalSec = Object.values(pv.chapters).reduce((s,c) => s + c.sections.length, 0);
+    html += `<div class="card">
+      <div class="part-header" onclick="this.nextElementSibling.classList.toggle('hidden')">
+        <span class="part-title">${String(partIdx).padStart(2,'0')} ${pv.title}</span>
+        <span class="part-count">${totalSec} 节</span>
+      </div>
+      <div class="chapter-group">`;
+
+    Object.entries(pv.chapters).forEach(([ck, cv]) => {
+      html += `<div class="chapter-title">${cv.title}</div>`;
+      cv.sections.forEach(s => {
+        const isFree = s.isFree || s.is_free;
+        const price = s.price || 0;
+        const title = s.sectionTitle || s.section_title || s.title || '';
+        html += `<div class="section-item" data-title="${title.toLowerCase()}" data-id="${s.id}">
+          <div class="section-left">
+            <span class="section-id">${s.id}</span>
+            <span class="section-title">${title}</span>
+          </div>
+          <div class="section-right">
+            <span class="badge ${isFree?'badge-free':'badge-paid'}">${isFree?'免费':'¥'+price}</span>
+            <button class="btn" onclick="editSection('${s.id}')">编辑</button>
+            <button class="btn btn-danger" onclick="deleteSection('${s.id}','${title.replace(/'/g,"\\'")}')">删除</button>
+          </div>
+        </div>`;
+      });
+    });
+    html += '</div></div>';
+  });
+
+  document.getElementById('chapterList').innerHTML = html || '<div class="empty">暂无内容</div>';
+}
+
+function filterSections() {
+  const q = document.getElementById('searchInput').value.toLowerCase();
+  document.querySelectorAll('.section-item').forEach(el => {
+    el.style.display = el.dataset.title.includes(q) ? '' : 'none';
+  });
+}
+
+async function editSection(id) {
+  if (!await ensureAuth()) return;
+  showToast('加载中...');
+  const r = await api('GET', `/api/db/book?action=read&id=${id}`);
+  const s = r.data || r.section || r;
+  editingId = id;
+  document.getElementById('editTitle').textContent = `编辑: ${id}`;
+  document.getElementById('edit_title').value = s.sectionTitle || s.section_title || s.title || '';
+  document.getElementById('edit_price').value = s.price || 0;
+  document.getElementById('edit_free').value = (s.isFree || s.is_free) ? '1' : '0';
+  document.getElementById('edit_content').value = s.content || '';
+  document.getElementById('editModal').classList.remove('hidden');
+}
+
+function closeModal() {
+  document.getElementById('editModal').classList.add('hidden');
+  editingId = null;
+}
+
+async function saveEdit() {
+  if (!editingId) return;
+  const data = {
+    id: editingId,
+    title: document.getElementById('edit_title').value,
+    content: document.getElementById('edit_content').value,
+    price: parseFloat(document.getElementById('edit_price').value) || 0,
+    isFree: document.getElementById('edit_free').value === '1'
+  };
+  const r = await api('POST', '/api/db/book', data);
+  if (r.success !== false) {
+    showToast('保存成功');
+    closeModal();
+    loadChapters();
+  } else {
+    showToast(r.error || '保存失败', 'error');
+  }
+}
+
+async function deleteSection(id, title) {
+  if (!confirm(`确定删除章节「${title}」(${id})？此操作不可恢复！`)) return;
+  if (!await ensureAuth()) return;
+
+  let r = await api('DELETE', `/api/admin/content/${id}`);
+  if (r.success === false && r.error) {
+    r = await api('POST', '/api/db/book', {action:'delete', id});
+  }
+  if (r.success !== false) {
+    showToast('已删除');
+    loadChapters();
+  } else {
+    const ok = confirm('API删除失败，是否通过数据库直接删除？');
+    if (ok) {
+      showToast('正在通过数据库删除...');
+      try {
+        const resp = await fetch(DB_API + `/api/db/book?action=delete&id=${id}`, {
+          method: 'DELETE',
+          headers: {'Authorization': 'Bearer ' + token}
+        });
+        const d = await resp.json();
+        if (d.success !== false) { showToast('已删除'); loadChapters(); }
+        else showToast('删除失败: ' + (d.error||''), 'error');
+      } catch(e) { showToast('删除失败', 'error'); }
+    }
+  }
+}
+
+async function uploadContent() {
+  const title = document.getElementById('up_title').value.trim();
+  const content = document.getElementById('up_content').value.trim();
+  if (!title) return showToast('请填写标题', 'error');
+  if (!content) return showToast('请填写内容', 'error');
+
+  const images = document.getElementById('up_images').value.trim().split('\n').filter(Boolean);
+  let processedContent = content;
+  images.forEach((url, i) => {
+    processedContent = processedContent.replace(`{{image_${i+1}}}`, `![图片${i+1}](${url.trim()})`);
+  });
+
+  const price = parseFloat(document.getElementById('up_price').value) || 0;
+  const data = {
+    id: document.getElementById('up_id').value.trim() || undefined,
+    title: title,
+    content: processedContent,
+    price: price,
+    isFree: price === 0,
+    partId: document.getElementById('up_part').value,
+    chapterId: document.getElementById('up_chapter').value
+  };
+
+  if (!await ensureAuth()) return;
+  showToast('上传中...');
+  const r = await api('POST', '/api/db/book', data);
+  if (r.success !== false) {
+    showToast('上传成功！');
+    document.getElementById('up_title').value = '';
+    document.getElementById('up_content').value = '';
+    document.getElementById('up_images').value = '';
+    document.getElementById('up_id').value = '';
+    switchTab('chapters');
+    loadChapters();
+  } else {
+    showToast('上传失败: ' + (r.error || ''), 'error');
+  }
+}
+
+function switchTab(name) {
+  document.querySelectorAll('.tab').forEach(t => t.classList.toggle('active', t.dataset.tab === name));
+  ['chapters','upload','api'].forEach(t => {
+    document.getElementById('tab-' + t).classList.toggle('hidden', t !== name);
+  });
+}
+
+function showToast(msg, type='success') {
+  const t = document.createElement('div');
+  t.className = `toast toast-${type}`;
+  t.textContent = msg;
+  document.body.appendChild(t);
+  setTimeout(() => t.remove(), 3000);
+}
+
+loadChapters();
+</script>
+</body>
+</html>

content_upload.py

@@ -0,0 +1,275 @@
+#!/usr/bin/env python3
+"""
+Soul 内容上传接口
+可从 Cursor Skill / 命令行直接调用，将新内容写入数据库
+
+用法:
+  python3 content_upload.py --title "标题" --price 1.0 --content "正文" \
+    --part part-1 --chapter chapter-1 --format markdown
+
+  python3 content_upload.py --json '{
+    "title": "标题",
+    "price": 1.0,
+    "content": "正文内容...",
+    "part_id": "part-1",
+    "chapter_id": "chapter-1",
+    "format": "markdown",
+    "images": ["https://xxx.com/img1.png"]
+  }'
+
+  python3 content_upload.py --list-structure  # 查看篇章结构
+
+环境依赖: pip install pymysql
+"""
+
+import argparse
+import json
+import sys
+import re
+from datetime import datetime
+
+try:
+    import pymysql
+except ImportError:
+    print("需要安装 pymysql: pip3 install pymysql")
+    sys.exit(1)
+
+DB_CONFIG = {
+    "host": "56b4c23f6853c.gz.cdb.myqcloud.com",
+    "port": 14413,
+    "user": "cdb_outerroot",
+    "password": "Zhiqun1984",
+    "database": "soul_miniprogram",
+    "charset": "utf8mb4",
+}
+
+PART_MAP = {
+    "part-1": "第一篇｜真实的人",
+    "part-2": "第二篇｜真实的行业",
+    "part-3": "第三篇｜真实的错误",
+    "part-4": "第四篇｜真实的赚钱",
+    "part-5": "第五篇｜真实的社会",
+    "appendix": "附录",
+    "intro": "序言",
+    "outro": "尾声",
+}
+
+CHAPTER_MAP = {
+    "chapter-1": "第1章｜人与人之间的底层逻辑",
+    "chapter-2": "第2章｜人性困境案例",
+    "chapter-3": "第3章｜电商篇",
+    "chapter-4": "第4章｜内容商业篇",
+    "chapter-5": "第5章｜传统行业篇",
+    "chapter-6": "第6章｜我人生错过的4件大钱",
+    "chapter-7": "第7章｜别人犯的错误",
+    "chapter-8": "第8章｜底层结构",
+    "chapter-9": "第9章｜我在Soul上亲访的赚钱案例",
+    "chapter-10": "第10章｜未来职业的变化趋势",
+    "chapter-11": "第11章｜中国社会商业生态的未来",
+    "appendix": "附录",
+    "preface": "序言",
+    "epilogue": "尾声",
+}
+
+
+def get_connection():
+    return pymysql.connect(**DB_CONFIG)
+
+
+def list_structure():
+    conn = get_connection()
+    cur = conn.cursor()
+    cur.execute("""
+        SELECT part_id, part_title, chapter_id, chapter_title, COUNT(*) as sections
+        FROM chapters
+        GROUP BY part_id, part_title, chapter_id, chapter_title
+        ORDER BY part_id, chapter_id
+    """)
+    rows = cur.fetchall()
+    print("篇章结构:")
+    for part_id, part_title, ch_id, ch_title, cnt in rows:
+        print(f"  {part_id} ({part_title}) / {ch_id} ({ch_title}) - {cnt}节")
+
+    cur.execute("SELECT COUNT(*) FROM chapters")
+    total = cur.fetchone()[0]
+    print(f"\n总计: {total} 节")
+    conn.close()
+
+
+def generate_section_id(cur, chapter_id):
+    """根据 chapter 编号自动生成下一个 section id"""
+    ch_num = re.search(r"\d+", chapter_id)
+    if not ch_num:
+        cur.execute("SELECT MAX(CAST(REPLACE(id, '.', '') AS UNSIGNED)) FROM chapters")
+        max_id = cur.fetchone()[0] or 0
+        return str(max_id + 1)
+
+    prefix = ch_num.group()
+    cur.execute(
+        "SELECT id FROM chapters WHERE id LIKE %s ORDER BY CAST(SUBSTRING_INDEX(id, '.', -1) AS UNSIGNED) DESC LIMIT 1",
+        (f"{prefix}.%",),
+    )
+    row = cur.fetchone()
+    if row:
+        last_num = int(row[0].split(".")[-1])
+        return f"{prefix}.{last_num + 1}"
+    return f"{prefix}.1"
+
+
+def upload_content(data):
+    title = data.get("title", "").strip()
+    if not title:
+        print("错误: 标题不能为空")
+        return False
+
+    content = data.get("content", "").strip()
+    if not content:
+        print("错误: 内容不能为空")
+        return False
+
+    price = float(data.get("price", 1.0))
+    is_free = 1 if price == 0 else 0
+    part_id = data.get("part_id", "part-1")
+    chapter_id = data.get("chapter_id", "chapter-1")
+    fmt = data.get("format", "markdown")
+    images = data.get("images", [])
+    section_id = data.get("id", "")
+
+    if images:
+        for i, img_url in enumerate(images):
+            placeholder = f"{{{{image_{i+1}}}}}"
+            if placeholder in content:
+                if fmt == "markdown":
+                    content = content.replace(placeholder, f"![图片{i+1}]({img_url})")
+                else:
+                    content = content.replace(placeholder, img_url)
+
+    word_count = len(re.sub(r"\s+", "", content))
+
+    part_title = PART_MAP.get(part_id, part_id)
+    chapter_title = CHAPTER_MAP.get(chapter_id, chapter_id)
+
+    conn = get_connection()
+    cur = conn.cursor()
+
+    if not section_id:
+        section_id = generate_section_id(cur, chapter_id)
+
+    cur.execute("SELECT mid FROM chapters WHERE id = %s", (section_id,))
+    existing = cur.fetchone()
+
+    try:
+        if existing:
+            cur.execute("""
+                UPDATE chapters SET
+                    section_title = %s, content = %s, word_count = %s,
+                    is_free = %s, price = %s, part_id = %s, part_title = %s,
+                    chapter_id = %s, chapter_title = %s, status = 'published'
+                WHERE id = %s
+            """, (title, content, word_count, is_free, price, part_id, part_title,
+                  chapter_id, chapter_title, section_id))
+            action = "更新"
+        else:
+            cur.execute("SELECT COALESCE(MAX(sort_order), 0) + 1 FROM chapters")
+            next_order = cur.fetchone()[0]
+
+            cur.execute("""
+                INSERT INTO chapters (id, part_id, part_title, chapter_id, chapter_title,
+                    section_title, content, word_count, is_free, price, sort_order, status)
+                VALUES (%s, %s, %s, %s, %s, %s, %s, %s, %s, %s, %s, 'published')
+            """, (section_id, part_id, part_title, chapter_id, chapter_title,
+                  title, content, word_count, is_free, price, next_order))
+            action = "创建"
+
+        conn.commit()
+
+        result = {
+            "success": True,
+            "action": action,
+            "data": {
+                "id": section_id,
+                "title": title,
+                "part": f"{part_id} ({part_title})",
+                "chapter": f"{chapter_id} ({chapter_title})",
+                "price": price,
+                "is_free": bool(is_free),
+                "word_count": word_count,
+                "format": fmt,
+                "images_count": len(images),
+            }
+        }
+        print(json.dumps(result, ensure_ascii=False, indent=2))
+        return True
+
+    except pymysql.err.IntegrityError as e:
+        print(json.dumps({"success": False, "error": f"ID冲突: {e}"}, ensure_ascii=False))
+        return False
+    except Exception as e:
+        conn.rollback()
+        print(json.dumps({"success": False, "error": str(e)}, ensure_ascii=False))
+        return False
+    finally:
+        conn.close()
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Soul 内容上传接口")
+    parser.add_argument("--json", help="JSON格式的完整数据")
+    parser.add_argument("--title", help="标题")
+    parser.add_argument("--price", type=float, default=1.0, help="定价(0=免费)")
+    parser.add_argument("--content", help="内容正文")
+    parser.add_argument("--content-file", help="从文件读取内容")
+    parser.add_argument("--format", default="markdown", choices=["markdown", "text", "html"])
+    parser.add_argument("--part", default="part-1", help="所属篇 (part-1 ~ part-5)")
+    parser.add_argument("--chapter", default="chapter-1", help="所属章 (chapter-1 ~ chapter-11)")
+    parser.add_argument("--id", help="指定 section ID (如 1.6)，不指定则自动生成")
+    parser.add_argument("--images", nargs="*", help="图片URL列表")
+    parser.add_argument("--list-structure", action="store_true", help="查看篇章结构")
+    parser.add_argument("--list-chapters", action="store_true", help="列出所有章节")
+
+    args = parser.parse_args()
+
+    if args.list_structure:
+        list_structure()
+        return
+
+    if args.list_chapters:
+        conn = get_connection()
+        cur = conn.cursor()
+        cur.execute("SELECT id, section_title, is_free, price FROM chapters ORDER BY sort_order")
+        for row in cur.fetchall():
+            free_tag = "[免费]" if row[2] else f"[¥{row[3]}]"
+            print(f"  {row[0]} {row[1]} {free_tag}")
+        conn.close()
+        return
+
+    if args.json:
+        data = json.loads(args.json)
+    else:
+        if not args.title or (not args.content and not args.content_file):
+            parser.print_help()
+            print("\n错误: 需要 --title 和 --content (或 --content-file)")
+            sys.exit(1)
+
+        content = args.content
+        if args.content_file:
+            with open(args.content_file, "r", encoding="utf-8") as f:
+                content = f.read()
+
+        data = {
+            "title": args.title,
+            "price": args.price,
+            "content": content,
+            "format": args.format,
+            "part_id": args.part,
+            "chapter_id": args.chapter,
+            "images": args.images or [],
+        }
+        if args.id:
+            data["id"] = args.id
+
+    upload_content(data)
+
+
+if __name__ == "__main__":
+    main()

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/admin-auth.ts

@@ -0,0 +1,92 @@
+/**
+ * 后台管理员登录鉴权：生成/校验签名 Cookie，不暴露账号密码
+ * 账号密码从环境变量读取，默认 admin / key123456（与 .cursorrules 一致）
+ */
+
+import { createHmac, timingSafeEqual } from 'crypto'
+
+const COOKIE_NAME = 'admin_session'
+const MAX_AGE_SEC = 7 * 24 * 3600 // 7 天
+const SECRET = process.env.ADMIN_SESSION_SECRET || 'soul-admin-secret-change-in-prod'
+
+export function getAdminCredentials() {
+  return {
+    username: process.env.ADMIN_USERNAME || 'admin',
+    password: process.env.ADMIN_PASSWORD || 'key123456',
+  }
+}
+
+export function verifyAdminCredentials(username: string, password: string): boolean {
+  const { username: u, password: p } = getAdminCredentials()
+  return username === u && password === p
+}
+
+function sign(payload: string): string {
+  return createHmac('sha256', SECRET).update(payload).digest('base64url')
+}
+
+/** 生成签名 token，写入 Cookie 用 */
+export function createAdminToken(): string {
+  const exp = Math.floor(Date.now() / 1000) + MAX_AGE_SEC
+  const payload = `${exp}`
+  const sig = sign(payload)
+  return `${payload}.${sig}`
+}
+
+/** 校验 Cookie 中的 token */
+export function verifyAdminToken(token: string | null | undefined): boolean {
+  if (!token || typeof token !== 'string') return false
+  const dot = token.indexOf('.')
+  if (dot === -1) return false
+  const payload = token.slice(0, dot)
+  const sig = token.slice(dot + 1)
+  const exp = parseInt(payload, 10)
+  if (Number.isNaN(exp) || exp < Math.floor(Date.now() / 1000)) return false
+  const expected = sign(payload)
+  if (typeof expected !== 'string' || typeof sig !== 'string') return false
+  if (sig.length !== expected.length) return false
+  try {
+    return timingSafeEqual(Buffer.from(sig, 'base64url'), Buffer.from(expected, 'base64url'))
+  } catch {
+    return false
+  }
+}
+
+export function getAdminCookieName() {
+  return COOKIE_NAME
+}
+
+export function getAdminCookieOptions() {
+  return {
+    httpOnly: true,
+    secure: process.env.NODE_ENV === 'production',
+    sameSite: 'lax' as const,
+    maxAge: MAX_AGE_SEC,
+    path: '/',
+  }
+}
+
+/** 从请求中读取 admin cookie 并校验，未通过时返回 null */
+export function getAdminTokenFromRequest(request: Request): string | null {
+  const cookieHeader = request.headers.get('cookie')
+  if (!cookieHeader) return null
+  const name = COOKIE_NAME + '='
+  const start = cookieHeader.indexOf(name)
+  if (start === -1) return null
+  const valueStart = start + name.length
+  const end = cookieHeader.indexOf(';', valueStart)
+  const value = end === -1 ? cookieHeader.slice(valueStart) : cookieHeader.slice(valueStart, end)
+  return value.trim() || null
+}
+
+/** 若未登录则返回 401 Response，供各 admin API 使用 */
+export function requireAdminResponse(request: Request): Response | null {
+  const token = getAdminTokenFromRequest(request)
+  if (!verifyAdminToken(token)) {
+    return new Response(JSON.stringify({ error: '未授权访问，请先登录' }), {
+      status: 401,
+      headers: { 'Content-Type': 'application/json' },
+    })
+  }
+  return null
+}

lib/book-data.ts

@@ -510,6 +510,20 @@ export const bookData: Part[] = [
             isFree: false,
             filePath: "book/第四篇｜真实的赚钱/第9章｜我在Soul上亲访的赚钱案例/9.14 大健康私域：一个月150万的70后.md",
           },
+          {
+            id: "9.15",
+            title: "第102场｜今年第一个红包你发给谁",
+            price: 1,
+            isFree: false,
+            filePath: "book/第四篇｜真实的赚钱/第9章｜我在Soul上亲访的赚钱案例/9.15 第102场｜今年第一个红包你发给谁.md",
+          },
+          {
+            id: "9.16",
+            title: "第103场｜号商、某客与炸房",
+            price: 1,
+            isFree: false,
+            filePath: "book/第四篇｜真实的赚钱/第9章｜我在Soul上亲访的赚钱案例/9.16 第103场｜号商、某客与炸房.md",
+          },
         ],
       },
     ],

lib/db.ts

@@ -1,31 +1,47 @@
 /**
  * 数据库连接配置
  * 使用MySQL数据库存储用户、订单、推广关系等数据
+ * 优先从环境变量读取，便于本地/部署分离；未设置时使用默认值
  */
 
 import mysql from 'mysql2/promise'
 
-// 腾讯云外网数据库配置
 const DB_CONFIG = {
-  host: '56b4c23f6853c.gz.cdb.myqcloud.com',
-  port: 14413,
-  user: 'cdb_outerroot',
-  password: 'Zhiqun1984',
-  database: 'soul_miniprogram',
+  host: process.env.MYSQL_HOST || '56b4c23f6853c.gz.cdb.myqcloud.com',
+  port: Number(process.env.MYSQL_PORT || '14413'),
+  user: process.env.MYSQL_USER || 'cdb_outerroot',
+  password: process.env.MYSQL_PASSWORD || 'Zhiqun1984',
+  database: process.env.MYSQL_DATABASE || 'soul_miniprogram',
   charset: 'utf8mb4',
   timezone: '+08:00',
-  acquireTimeout: 60000,
-  timeout: 60000,
+  connectTimeout: 10000,  // 10 秒，连接不可达时快速失败，避免长时间挂起
+  acquireTimeout: 15000,
   reconnect: true
 }
 
+// 本地无数据库时可通过 SKIP_DB=1 跳过连接，接口将使用默认配置
+const SKIP_DB = process.env.SKIP_DB === '1' || process.env.SKIP_DB === 'true'
+
 // 连接池
 let pool: mysql.Pool | null = null
+// 连接类错误只打一次日志，避免刷屏
+let connectionErrorLogged = false
+
+function isConnectionError(err: unknown): boolean {
+  const code = (err as NodeJS.ErrnoException)?.code
+  return (
+    code === 'ETIMEDOUT' ||
+    code === 'ECONNREFUSED' ||
+    code === 'PROTOCOL_CONNECTION_LOST' ||
+    code === 'ENOTFOUND'
+  )
+}
 
 /**
- * 获取数据库连接池
+ * 获取数据库连接池（SKIP_DB 时不创建）
  */
-export function getPool() {
+export function getPool(): mysql.Pool | null {
+  if (SKIP_DB) return null
   if (!pool) {
     pool = mysql.createPool({
       ...DB_CONFIG,
@@ -41,12 +57,30 @@ export function getPool() {
  * 执行SQL查询
  */
 export async function query(sql: string, params?: any[]) {
+  const connection = getPool()
+  if (!connection) {
+    throw new Error('数据库未配置或已跳过 (SKIP_DB)')
+  }
+  // mysql2 内部会读 params.length，不能传 undefined
+  const safeParams = Array.isArray(params) ? params : []
   try {
-    const connection = getPool()
-    const [results] = await connection.execute(sql, params)
-    return results
+    const [results] = await connection.execute(sql, safeParams)
+    // 确保调用方拿到的始终是数组，避免 undefined.length 报错
+    if (Array.isArray(results)) return results
+    if (results != null) return [results]
+    return []
   } catch (error) {
-    console.error('数据库查询错误:', error)
+    if (isConnectionError(error)) {
+      if (!connectionErrorLogged) {
+        connectionErrorLogged = true
+        console.warn(
+          '[DB] 数据库连接不可用，将使用本地默认配置。',
+          (error as Error).message
+        )
+      }
+    } else {
+      console.error('数据库查询错误:', error)
+    }
     throw error
   }
 }
@@ -57,7 +91,7 @@ export async function query(sql: string, params?: any[]) {
 export async function initDatabase() {
   try {
     console.log('开始初始化数据库表结构...')
-    
+
     // 用户表（完整字段）
     await query(`
       CREATE TABLE IF NOT EXISTS users (
@@ -88,33 +122,31 @@ export async function initDatabase() {
         INDEX idx_referred_by (referred_by)
       ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci
     `)
-    
+
     // 尝试添加可能缺失的字段（用于升级已有数据库）
-    try {
-      await query('ALTER TABLE users ADD COLUMN IF NOT EXISTS session_key VARCHAR(100)')
-    } catch (e) { /* 忽略 */ }
-    try {
-      await query('ALTER TABLE users ADD COLUMN IF NOT EXISTS password VARCHAR(100)')
-    } catch (e) { /* 忽略 */ }
-    try {
-      await query('ALTER TABLE users ADD COLUMN IF NOT EXISTS referred_by VARCHAR(50)')
-    } catch (e) { /* 忽略 */ }
-    try {
-      await query('ALTER TABLE users ADD COLUMN IF NOT EXISTS is_admin BOOLEAN DEFAULT FALSE')
-    } catch (e) { /* 忽略 */ }
-    try {
-      await query('ALTER TABLE users ADD COLUMN IF NOT EXISTS match_count_today INT DEFAULT 0')
-    } catch (e) { /* 忽略 */ }
-    try {
-      await query('ALTER TABLE users ADD COLUMN IF NOT EXISTS last_match_date DATE')
-    } catch (e) { /* 忽略 */ }
-    try {
-      await query('ALTER TABLE users ADD COLUMN IF NOT EXISTS withdrawn_earnings DECIMAL(10,2) DEFAULT 0')
-    } catch (e) { /* 忽略 */ }
-    
+    // 兼容 MySQL 5.7：IF NOT EXISTS 在 5.7 不支持，先检查列是否存在
+    const addColumnIfMissing = async (colName: string, colDef: string) => {
+      try {
+        const rows = await query(
+          "SELECT 1 FROM information_schema.COLUMNS WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'users' AND COLUMN_NAME = ?",
+          [colName]
+        ) as any[]
+        if (!rows?.length) {
+          await query(`ALTER TABLE users ADD COLUMN ${colName} ${colDef}`)
+        }
+      } catch (e) { /* 忽略 */ }
+    }
+    await addColumnIfMissing('session_key', 'VARCHAR(100)')
+    await addColumnIfMissing('password', 'VARCHAR(100)')
+    await addColumnIfMissing('referred_by', 'VARCHAR(50)')
+    await addColumnIfMissing('is_admin', 'BOOLEAN DEFAULT FALSE')
+    await addColumnIfMissing('match_count_today', 'INT DEFAULT 0')
+    await addColumnIfMissing('last_match_date', 'DATE')
+    await addColumnIfMissing('withdrawn_earnings', 'DECIMAL(10,2) DEFAULT 0')
+
     console.log('用户表初始化完成')
-    
-    // 订单表
+
+    // 订单表（含 referrer_id/referral_code、status 含 created/expired）
     await query(`
       CREATE TABLE IF NOT EXISTS orders (
         id VARCHAR(50) PRIMARY KEY,
@@ -125,9 +157,11 @@ export async function initDatabase() {
         product_id VARCHAR(50),
         amount DECIMAL(10,2) NOT NULL,
         description VARCHAR(200),
-        status ENUM('pending', 'paid', 'cancelled', 'refunded') DEFAULT 'pending',
+        status ENUM('created', 'pending', 'paid', 'cancelled', 'refunded', 'expired') DEFAULT 'created',
         transaction_id VARCHAR(100),
         pay_time TIMESTAMP NULL,
+        referrer_id VARCHAR(50) NULL COMMENT '推荐人用户ID，用于分销归属',
+        referral_code VARCHAR(20) NULL COMMENT '下单时使用的邀请码，便于对账与展示',
         created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
         updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
         FOREIGN KEY (user_id) REFERENCES users(id),
@@ -136,7 +170,7 @@ export async function initDatabase() {
         INDEX idx_status (status)
       ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci
     `)
-    
+
     // 推广绑定关系表
     await query(`
       CREATE TABLE IF NOT EXISTS referral_bindings (
@@ -162,7 +196,7 @@ export async function initDatabase() {
         INDEX idx_expiry_date (expiry_date)
       ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci
     `)
-    
+
     // 匹配记录表
     await query(`
       CREATE TABLE IF NOT EXISTS match_records (
@@ -181,7 +215,7 @@ export async function initDatabase() {
         INDEX idx_status (status)
       ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci
     `)
-    
+
     // 推广访问记录表（用于统计「通过链接进的人数」）
     await query(`
       CREATE TABLE IF NOT EXISTS referral_visits (
@@ -197,7 +231,7 @@ export async function initDatabase() {
         INDEX idx_created_at (created_at)
       ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci
     `)
-    
+
     // 系统配置表
     await query(`
       CREATE TABLE IF NOT EXISTS system_config (
@@ -210,7 +244,7 @@ export async function initDatabase() {
         INDEX idx_config_key (config_key)
       ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci
     `)
-    
+
     // 章节内容表 - 存储书籍所有章节
     await query(`
       CREATE TABLE IF NOT EXISTS chapters (
@@ -234,12 +268,12 @@ export async function initDatabase() {
         INDEX idx_sort_order (sort_order)
       ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci
     `)
-    
+
     console.log('数据库表结构初始化完成')
-    
+
     // 插入默认配置
     await initDefaultConfig()
-    
+
   } catch (error) {
     console.error('初始化数据库失败:', error)
     throw error
@@ -267,13 +301,13 @@ async function initDefaultConfig() {
         maxMatchesPerDay: 10
       }
     }
-    
+
     await query(`
-      INSERT INTO system_config (config_key, config_value, description) 
-      VALUES (?, ?, ?) 
+      INSERT INTO system_config (config_key, config_value, description)
+      VALUES (?, ?, ?)
       ON DUPLICATE KEY UPDATE config_value = VALUES(config_value)
     `, ['match_config', JSON.stringify(matchConfig), '匹配功能配置'])
-    
+
     // 推广配置
     const referralConfig = {
       distributorShare: 90, // 推广者分成比例
@@ -281,15 +315,15 @@ async function initDefaultConfig() {
       bindingDays: 30, // 绑定有效期（天）
       userDiscount: 5 // 用户优惠比例
     }
-    
+
     await query(`
-      INSERT INTO system_config (config_key, config_value, description) 
-      VALUES (?, ?, ?) 
+      INSERT INTO system_config (config_key, config_value, description)
+      VALUES (?, ?, ?)
       ON DUPLICATE KEY UPDATE config_value = VALUES(config_value)
     `, ['referral_config', JSON.stringify(referralConfig), '推广功能配置'])
-    
+
     console.log('默认配置初始化完成')
-    
+
   } catch (error) {
     console.error('初始化默认配置失败:', error)
   }
@@ -297,20 +331,23 @@ async function initDefaultConfig() {
 
 /**
  * 获取系统配置
+ * 连接不可达时返回 null，由上层使用本地默认配置，不重复打日志
  */
 export async function getConfig(key: string) {
   try {
     const results = await query(
       'SELECT config_value FROM system_config WHERE config_key = ?',
       [key]
-    ) as any[]
-    
-    if (results.length > 0) {
-      return results[0].config_value
+    )
+    const rows = Array.isArray(results) ? results : (results != null ? [results] : [])
+    if (rows != null && rows.length > 0) {
+      return (rows[0] as any)?.config_value ?? null
     }
     return null
   } catch (error) {
-    console.error('获取配置失败:', error)
+    if (!isConnectionError(error)) {
+      console.error('获取配置失败:', error)
+    }
     return null
   }
 }
@@ -321,13 +358,13 @@ export async function getConfig(key: string) {
 export async function setConfig(key: string, value: any, description?: string) {
   try {
     await query(`
-      INSERT INTO system_config (config_key, config_value, description) 
-      VALUES (?, ?, ?) 
-      ON DUPLICATE KEY UPDATE 
+      INSERT INTO system_config (config_key, config_value, description)
+      VALUES (?, ?, ?)
+      ON DUPLICATE KEY UPDATE
         config_value = VALUES(config_value),
         description = COALESCE(VALUES(description), description)
     `, [key, JSON.stringify(value), description])
-    
+
     return true
   } catch (error) {
     console.error('设置配置失败:', error)
@@ -336,4 +373,4 @@ export async function setConfig(key: string, value: any, description?: string) {
 }
 
 // 导出数据库实例
-export default { getPool, query, initDatabase, getConfig, setConfig }
+export default { getPool, query, initDatabase, getConfig, setConfig }

lib/password.ts

@@ -0,0 +1,56 @@
+/**
+ * 密码哈希与校验（仅用于 Web 用户注册/登录，与后台管理员密码无关）
+ * 使用 Node crypto.scrypt，存储格式 saltHex:hashHex，兼容旧明文密码
+ */
+
+import { scryptSync, timingSafeEqual, randomFillSync } from 'crypto'
+
+const SALT_LEN = 16
+const KEYLEN = 32
+
+function bufferToHex(buf: Buffer): string {
+  return buf.toString('hex')
+}
+
+function hexToBuffer(hex: string): Buffer {
+  return Buffer.from(hex, 'hex')
+}
+
+/**
+ * 对明文密码做哈希，存入数据库
+ * 格式: saltHex:hashHex（约 97 字符，适配 VARCHAR(100)）
+ * 与 verifyPassword 一致：内部先 trim，保证注册/登录/重置用同一套规则
+ */
+export function hashPassword(plain: string): string {
+  const trimmed = String(plain).trim()
+  const salt = Buffer.allocUnsafe(SALT_LEN)
+  randomFillSync(salt)
+  const hash = scryptSync(trimmed, salt, KEYLEN, { N: 16384, r: 8, p: 1 })
+  return bufferToHex(salt) + ':' + bufferToHex(hash)
+}
+
+/**
+ * 校验密码：支持新格式（salt:hash）与旧明文（兼容历史数据）
+ * 与 hashPassword 一致：对输入先 trim 再参与校验
+ */
+export function verifyPassword(plain: string, stored: string | null | undefined): boolean {
+  const trimmed = String(plain).trim()
+  if (stored == null || stored === '') {
+    return trimmed === ''
+  }
+  if (stored.includes(':')) {
+    const [saltHex, hashHex] = stored.split(':')
+    if (!saltHex || !hashHex || saltHex.length !== SALT_LEN * 2 || hashHex.length !== KEYLEN * 2) {
+      return false
+    }
+    try {
+      const salt = hexToBuffer(saltHex)
+      const expected = hexToBuffer(hashHex)
+      const derived = scryptSync(trimmed, salt, KEYLEN, { N: 16384, r: 8, p: 1 })
+      return derived.length === expected.length && timingSafeEqual(derived, expected)
+    } catch {
+      return false
+    }
+  }
+  return trimmed === stored
+}

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
+}

middleware.ts

@@ -0,0 +1,27 @@
+import { NextResponse } from 'next/server'
+import type { NextRequest } from 'next/server'
+
+const ALLOWED_ORIGINS = [
+  'https://souladmin.quwanzhi.com',
+  'http://localhost:5174',
+  'http://127.0.0.1:5174',
+]
+
+export function middleware(request: NextRequest) {
+  const origin = request.headers.get('origin')
+  const res = NextResponse.next()
+  if (origin && ALLOWED_ORIGINS.includes(origin)) {
+    res.headers.set('Access-Control-Allow-Origin', origin)
+  }
+  res.headers.set('Access-Control-Allow-Methods', 'GET,POST,PUT,DELETE,OPTIONS')
+  res.headers.set('Access-Control-Allow-Headers', 'Content-Type,Authorization')
+  res.headers.set('Access-Control-Allow-Credentials', 'true')
+  if (request.method === 'OPTIONS') {
+    return new NextResponse(null, { status: 204, headers: res.headers })
+  }
+  return res
+}
+
+export const config = {
+  matcher: '/api/:path*',
+}

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/pages/index/index.js

@@ -77,70 +77,87 @@ Page({
     this.setData({ loading: true })
     
     try {
-      // 获取书籍数据
       await this.loadBookData()
-      // 计算推荐章节
-      this.computeLatestSection()
+      await this.loadLatestSection()
     } catch (e) {
       console.error('初始化失败:', e)
+      this.computeLatestSectionFallback()
     } finally {
       this.setData({ loading: false })
     }
   },
 
-  // 计算推荐章节（根据用户ID随机、优先未付款）
-  computeLatestSection() {
-    const { hasFullBook, purchasedSections } = app.globalData
-    const userId = app.globalData.userInfo?.id || wx.getStorageSync('userId') || 'guest'
-    
-    // 所有章节列表
-    const allSections = [
-      { id: '9.14', title: '大健康私域：一个月150万的70后', part: '真实的赚钱' },
-      { id: '9.13', title: 'AI工具推广：一个隐藏的高利润赛道', part: '真实的赚钱' },
-      { id: '9.12', title: '美业整合：一个人的公司如何月入十万', part: '真实的赚钱' },
-      { id: '8.6', title: '云阿米巴:分不属于自己的钱', part: '真实的赚钱' },
-      { id: '8.1', title: '流量杠杆:抖音、Soul、飞书', part: '真实的赚钱' },
-      { id: '3.1', title: '3000万流水如何跑出来', part: '真实的行业' },
-      { id: '5.1', title: '拍卖行抱朴：一天240万的摇号生意', part: '真实的行业' },
-      { id: '4.1', title: '旅游号:30天10万粉的真实逻辑', part: '真实的行业' }
-    ]
-    
-    // 用户ID生成的随机种子（同一用户每天看到的不同）
-    const today = new Date().toISOString().split('T')[0]
-    const seed = (userId + today).split('').reduce((a, b) => a + b.charCodeAt(0), 0)
-    
-    // 筛选未付款章节
-    let candidates = allSections
-    if (!hasFullBook) {
-      const purchased = purchasedSections || []
-      const unpurchased = allSections.filter(s => !purchased.includes(s.id))
-      if (unpurchased.length > 0) {
-        candidates = unpurchased
+  // 从后端获取最新章节（2日内有新章取最新3章，否则随机免费章）
+  async loadLatestSection() {
+    try {
+      const res = await app.request('/api/book/latest-chapters')
+      if (res && res.success && res.banner) {
+        this.setData({
+          latestSection: res.banner,
+          latestLabel: res.label || '最新更新'
+        })
+        return
       }
+    } catch (e) {
+      console.warn('latest-chapters API 失败，使用兜底逻辑:', e.message)
     }
-    
-    // 根据种子选择章节
-    const index = seed % candidates.length
-    const selected = candidates[index]
-    
-    // 设置标签（如果有新增章节显示"最新更新"，否则显示"推荐阅读"）
-    const label = candidates === allSections ? '推荐阅读' : '为你推荐'
-    
-    this.setData({
-      latestSection: selected,
-      latestLabel: label
-    })
+    this.computeLatestSectionFallback()
   },
 
-  // 加载书籍数据
+  // 兜底：API 失败时从 bookData 计算（随机选免费章节）
+  computeLatestSectionFallback() {
+    const bookData = app.globalData.bookData || this.data.bookData || []
+    let sections = []
+    if (Array.isArray(bookData)) {
+      sections = bookData.map(s => ({
+        id: s.id,
+        title: s.title || s.sectionTitle,
+        part: s.part || s.sectionTitle || '真实的行业',
+        isFree: s.isFree,
+        price: s.price
+      }))
+    } else if (bookData && typeof bookData === 'object') {
+      const parts = bookData.parts || (Array.isArray(bookData) ? bookData : [])
+      if (Array.isArray(parts)) {
+        parts.forEach(p => {
+          (p.chapters || p.sections || []).forEach(c => {
+            (c.sections || [c]).forEach(s => {
+              sections.push({
+                id: s.id,
+                title: s.title || s.section_title,
+                part: p.title || p.part_title || c.title || '',
+                isFree: s.isFree,
+                price: s.price
+              })
+            })
+          })
+        })
+      }
+    }
+    const free = sections.filter(s => s.isFree !== false && (s.price === 0 || !s.price))
+    const candidates = free.length > 0 ? free : sections
+    if (candidates.length === 0) {
+      this.setData({ latestSection: { id: '1.1', title: '开始阅读', part: '真实的人' }, latestLabel: '为你推荐' })
+      return
+    }
+    const idx = Math.floor(Math.random() * candidates.length)
+    const selected = { id: candidates[idx].id, title: candidates[idx].title, part: candidates[idx].part || '真实的行业' }
+    this.setData({ latestSection: selected, latestLabel: '为你推荐' })
+  },
+
+  // 加载书籍数据（含精选推荐，按后端点击量排序）
   async loadBookData() {
     try {
       const res = await app.request('/api/book/all-chapters')
       if (res && res.data) {
-        this.setData({
+        const setData = {
           bookData: res.data,
-          totalSections: res.totalSections || 62
-        })
+          totalSections: res.totalSections || res.data?.length || 62
+        }
+        if (res.featuredSections && res.featuredSections.length) {
+          setData.featuredSections = res.featuredSections
+        }
+        this.setData(setData)
       }
     } catch (e) {
       console.error('加载书籍数据失败:', e)

miniprogram/pages/index/index.wxml

@@ -39,7 +39,7 @@
     <!-- Banner卡片 - 最新章节 -->
     <view class="banner-card" bindtap="goToRead" data-id="{{latestSection.id}}">
       <view class="banner-glow"></view>
-      <view class="banner-tag">最新更新</view>
+      <view class="banner-tag">{{latestLabel}}</view>
       <view class="banner-title">{{latestSection.title}}</view>
       <view class="banner-part">{{latestSection.part}}</view>
       <view class="banner-action">

miniprogram/pages/my/my.js

@@ -33,12 +33,10 @@ Page({
     // 最近阅读
     recentChapters: [],
     
-    // 菜单列表
     menuList: [
       { id: 'orders', title: '我的订单', icon: '📦', count: 0 },
       { id: 'referral', title: '推广中心', icon: '🎁', badge: '' },
-      { id: 'about', title: '关于作者', icon: '👤', iconBg: 'brand' },
-      { id: 'settings', title: '设置', icon: '⚙️', iconBg: 'gray' }
+      { id: 'about', title: '关于作者', icon: '👤', iconBg: 'brand' }
     ],
     
     // 登录弹窗
@@ -289,8 +287,7 @@ Page({
     const routes = {
       orders: '/pages/purchases/purchases',
       referral: '/pages/referral/referral',
-      about: '/pages/about/about',
-      settings: '/pages/settings/settings'
+      about: '/pages/about/about'
     }
     
     if (routes[id]) {
@@ -298,6 +295,55 @@ Page({
     }
   },
 
+  // 绑定微信号
+  bindWechat() {
+    wx.showModal({
+      title: '绑定微信号',
+      editable: true,
+      placeholderText: '请输入微信号',
+      success: async (res) => {
+        if (res.confirm && res.content) {
+          const wechat = res.content.trim()
+          if (!wechat) return
+          try {
+            wx.setStorageSync('user_wechat', wechat)
+            const userInfo = this.data.userInfo
+            userInfo.wechat = wechat
+            this.setData({ userInfo, userWechat: wechat })
+            app.globalData.userInfo = userInfo
+            wx.setStorageSync('userInfo', userInfo)
+            await app.request('/api/user/update', {
+              method: 'POST',
+              data: { userId: userInfo.id, wechat }
+            })
+            wx.showToast({ title: '绑定成功', icon: 'success' })
+          } catch (e) {
+            console.log('绑定微信号失败', e)
+            wx.showToast({ title: '已保存到本地', icon: 'success' })
+          }
+        }
+      }
+    })
+  },
+
+  // 清除缓存
+  clearCache() {
+    wx.showModal({
+      title: '清除缓存',
+      content: '确定要清除本地缓存吗？不会影响账号数据',
+      success: (res) => {
+        if (res.confirm) {
+          const userInfo = wx.getStorageSync('userInfo')
+          const token = wx.getStorageSync('token')
+          wx.clearStorageSync()
+          if (userInfo) wx.setStorageSync('userInfo', userInfo)
+          if (token) wx.setStorageSync('token', token)
+          wx.showToast({ title: '缓存已清除', icon: 'success' })
+        }
+      }
+    })
+  },
+
   // 跳转到阅读页
   goToRead(e) {
     const id = e.currentTarget.dataset.id

miniprogram/pages/my/my.wxml

@@ -107,6 +107,30 @@
         </view>
       </view>
     </view>
+
+    <!-- 账号设置 -->
+    <view class="settings-card card">
+      <view class="card-title">
+        <text class="title-icon">⚙️</text>
+        <text>账号设置</text>
+      </view>
+      <view class="settings-list">
+        <view class="settings-item" bindtap="bindWechat">
+          <text class="settings-label">绑定微信号</text>
+          <view class="settings-right">
+            <text class="settings-value">{{userWechat || '未绑定'}}</text>
+            <text class="menu-arrow">→</text>
+          </view>
+        </view>
+        <view class="settings-item" bindtap="clearCache">
+          <text class="settings-label">清除缓存</text>
+          <text class="menu-arrow">→</text>
+        </view>
+        <view class="settings-item logout-item" bindtap="handleLogout">
+          <text class="settings-label logout-text">退出登录</text>
+        </view>
+      </view>
+    </view>
   </view>
 
   <!-- 足迹内容 -->

miniprogram/pages/my/my.wxss

@@ -994,3 +994,51 @@
   font-size: 28rpx;
   color: #FFD700;
 }
+
+/* 账号设置 */
+.settings-card {
+  margin-top: 24rpx;
+}
+
+.settings-list {
+  margin-top: 16rpx;
+}
+
+.settings-item {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  padding: 28rpx 0;
+  border-bottom: 1rpx solid rgba(255, 255, 255, 0.06);
+}
+
+.settings-item:last-child {
+  border-bottom: none;
+}
+
+.settings-label {
+  font-size: 28rpx;
+  color: rgba(255, 255, 255, 0.85);
+}
+
+.settings-right {
+  display: flex;
+  align-items: center;
+  gap: 12rpx;
+}
+
+.settings-value {
+  font-size: 26rpx;
+  color: rgba(255, 255, 255, 0.4);
+}
+
+.logout-item {
+  justify-content: center;
+  margin-top: 16rpx;
+  border-bottom: none;
+}
+
+.logout-text {
+  color: #ff4d4f;
+  font-size: 28rpx;
+}

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 ""

next-env.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="next" />
 /// <reference types="next/image-types/global" />
-import "./.next/dev/types/routes.d.ts";
+import "./.next/types/routes.d.ts";
 
 // NOTE: This file should not be edited
 // see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

next.config.mjs

@@ -12,6 +12,18 @@ const nextConfig = {
     buildActivity: false,
     appIsrStatus: false,
   },
+  async headers() {
+    return [
+      {
+        source: '/api/:path*',
+        headers: [
+          { key: 'Access-Control-Allow-Methods', value: 'GET,POST,PUT,DELETE,OPTIONS' },
+          { key: 'Access-Control-Allow-Headers', value: 'Content-Type,Authorization' },
+          { key: 'Access-Control-Allow-Credentials', value: 'true' },
+        ],
+      },
+    ]
+  },
 }
 
 export default nextConfig

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 填私钥路径则用密钥登录，否则用密码。"
+}

scripts/fix_souladmin_login.sh

@@ -0,0 +1,40 @@
+#!/bin/bash
+# 修复 souladmin.quwanzhi.com 登录 "Failed to fetch" 错误
+# 1. Vue 管理后台 API 改为同源（O1=""），请求 /api
+# 2. souladmin Nginx 代理 /api 到 souldev.quwanzhi.com
+
+set -e
+cd "$(dirname "$0")/.."
+SSH_PORT="22022"
+BT_HOST="43.139.27.93"
+ADMIN_DIST="/www/wwwroot/自营/soul-admin/dist"
+
+echo "===== 1. 上传 patched index-CbOmKBRd.js ====="
+sshpass -p 'Zhiqun1984' scp -P "$SSH_PORT" -o ConnectTimeout=15 \
+  "soul-admin/dist/assets/index-CbOmKBRd.js" \
+  root@${BT_HOST}:${ADMIN_DIST}/assets/
+
+echo "===== 2. 配置 souladmin Nginx /api 代理 ====="
+sshpass -p 'Zhiqun1984' ssh -p "$SSH_PORT" -o ConnectTimeout=20 root@${BT_HOST} 'bash -s' << 'REMOTE'
+EXT_DIR="/www/server/panel/vhost/nginx/extension/souladmin.quwanzhi.com"
+mkdir -p "$EXT_DIR"
+API_CONF="$EXT_DIR/api-proxy.conf"
+cat > "$API_CONF" << 'NGX'
+location /api/ {
+    proxy_pass https://souldev.quwanzhi.com/api/;
+    proxy_ssl_server_name on;
+    proxy_http_version 1.1;
+    proxy_set_header Host souldev.quwanzhi.com;
+    proxy_set_header X-Real-IP $remote_addr;
+    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
+    proxy_set_header X-Forwarded-Proto $scheme;
+}
+NGX
+echo "api-proxy.conf 已写入"
+nginx -t 2>&1 && nginx -s reload 2>&1
+echo "Nginx 重载完成"
+REMOTE
+
+echo ""
+echo "===== souladmin 登录修复完成 ====="
+echo "请访问 https://souladmin.quwanzhi.com 尝试登录"

soul-admin/dist/index.html

@@ -0,0 +1,437 @@
+<!DOCTYPE html>
+<html lang="zh-CN">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>管理后台 - Soul创业派对</title>
+    <script type="module" crossorigin src="/assets/index-CbOmKBRd.js?v=5"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-DBQ1UORI.css">
+  </head>
+  <body>
+    <div id="root"></div>
+    <script>
+    (function(){
+      var CSS=document.createElement('style');
+      CSS.textContent=`
+.si-row-actions{display:inline-flex;align-items:center;gap:4px}
+.si-row-actions .si-del{opacity:0;visibility:hidden;transition:opacity .2s,visibility .2s}
+.si-row-actions:hover .si-del{opacity:1;visibility:visible}
+.si-del{padding:2px 8px;font-size:11px;border-radius:4px;cursor:pointer;background:transparent;
+  border:1px solid #7f1d1d;color:#ef4444;margin-left:6px;transition:all .15s}
+.si-del:hover{background:#7f1d1d;color:#fff}
+.si-plus{padding:2px 6px;font-size:12px;border-radius:4px;cursor:pointer;background:transparent;
+  border:1px solid #2dd4a8;color:#2dd4a8;margin-left:4px;transition:all .15s}
+.si-plus:hover{background:#2dd4a8;color:#0a0e17}
+.si-free-toggle{padding:2px 8px;font-size:11px;border-radius:4px;cursor:pointer;margin-left:6px;
+  border:1px solid #475569;color:#94a3b8;transition:all .15s;user-select:none}
+.si-free-toggle:hover{border-color:#2dd4a8;color:#2dd4a8}
+.si-free-toggle.paid{border-color:#f59e0b;color:#f59e0b}
+.si-drag-handle{cursor:grab;opacity:.5;padding:2px 6px;margin-right:4px;user-select:none}
+.si-drag-handle:active{cursor:grabbing}
+.si-dragging{opacity:.5;background:rgba(45,212,168,.1)}
+.si-drop-target{border:2px dashed #2dd4a8;border-radius:4px}
+.si-panel{background:#111827;border:1px solid #1e293b;border-radius:10px;padding:20px;margin:16px 0}
+.si-panel h3{font-size:15px;margin:0 0 14px;color:#e0e6ed}
+.si-panel label{display:block;font-size:12px;color:#94a3b8;margin:10px 0 4px}
+.si-panel input,.si-panel select,.si-panel textarea{width:100%;padding:8px 10px;box-sizing:border-box;
+  background:#0a0e17;border:1px solid #1e293b;border-radius:6px;color:#e0e6ed;font-size:13px;outline:none}
+.si-panel input:focus,.si-panel textarea:focus{border-color:#2dd4a8}
+.si-panel textarea{min-height:160px;font-family:monospace;resize:vertical}
+.si-row{display:grid;grid-template-columns:1fr 1fr;gap:12px}
+.si-submit{width:100%;padding:10px;margin-top:14px;background:#2dd4a8;color:#0a0e17;
+  border:none;border-radius:6px;font-size:14px;font-weight:600;cursor:pointer}
+.si-submit:hover{background:#22b896}
+.si-api{font-family:monospace;font-size:12px;line-height:1.7;color:#94a3b8}
+.si-api pre{background:#0a0e17;border:1px solid #1e293b;border-radius:6px;padding:12px;
+  overflow-x:auto;margin:6px 0 14px;font-size:12px;color:#2dd4a8;white-space:pre-wrap}
+.si-api h4{color:#e0e6ed;font-size:13px;margin:16px 0 4px;font-family:sans-serif}
+.si-token-box{background:#0a0e17;border:1px solid #2dd4a8;border-radius:8px;padding:14px;margin-bottom:20px}
+.si-token-box .si-token-row{display:flex;gap:8px;align-items:center;margin-top:8px}
+.si-token-box input{flex:1;padding:8px 10px;background:#111827;border:1px solid #1e293b;border-radius:6px;color:#2dd4a8;font-size:12px;font-family:monospace}
+.si-token-btn{padding:8px 16px;border-radius:6px;font-size:13px;cursor:pointer;border:none;background:#2dd4a8;color:#0a0e17;font-weight:600}
+.si-token-btn:hover{background:#22b896}
+.si-token-btn.copy{background:#1e293b;color:#e0e6ed}
+.si-token-btn.copy:hover{background:#334155}
+.si-toast{position:fixed;top:16px;right:16px;padding:10px 18px;border-radius:6px;
+  font-size:13px;z-index:99999;animation:siFade .25s}
+.si-toast.ok{background:#065f46;color:#6ee7b7}
+.si-toast.err{background:#7f1d1d;color:#fca5a5}
+@keyframes siFade{from{opacity:0;transform:translateY(-10px)}to{opacity:1;transform:translateY(0)}}
+`;
+      document.head.appendChild(CSS);
+
+      var API=(window.location.hostname||'').indexOf('souladmin')>=0?'':'https://souldev.quwanzhi.com';
+      var token=localStorage.getItem('admin_token')||'';
+
+      function toast(m,ok){var t=document.createElement('div');t.className='si-toast '+(ok!==false?'ok':'err');
+        t.textContent=m;document.body.appendChild(t);setTimeout(function(){t.remove()},3000)}
+      function apicall(method,path,body){
+        var opts={method:method,headers:{'Content-Type':'application/json'}};
+        if(token)opts.headers['Authorization']='Bearer '+token;
+        if(body)opts.body=JSON.stringify(body);
+        return fetch(API+path,opts).then(function(r){return r.json()}).catch(function(e){return{success:false,error:e.message}})
+      }
+      function auth(){
+        if(token)return apicall('GET','/api/admin').then(function(r){if(r.success)return true;return doLogin()});
+        return doLogin()
+      }
+      function doLogin(){
+        return apicall('POST','/api/admin',{username:'admin',password:'admin123'}).then(function(r){
+          if(r.success&&r.token){token=r.token;localStorage.setItem('admin_token',token);return true}
+          return false
+        })
+      }
+
+      function findBtn(text){
+        var all=document.querySelectorAll('button');
+        for(var i=0;i<all.length;i++){if(all[i].textContent.trim()===text)return all[i]}
+        return null
+      }
+
+      var done=false;
+
+      function hideRedundantButtons(){
+        ['初始化数据库','同步到数据库','导入','导出','同步飞书','上传内容'].forEach(function(t){
+          var b=findBtn(t);if(b)b.style.display='none';
+        });
+      }
+
+      function run(){
+        if(done)return;
+        if(!location.pathname.includes('content')&&!location.hash.includes('content'))return;
+        var initBtn=findBtn('初始化数据库');
+        if(!initBtn)return;
+        done=true;
+
+        // === 1. 移除5个按钮+上传内容，只保留一个"API 接口"（持续执行防重复页）===
+        hideRedundantButtons();
+        setInterval(hideRedundantButtons,800);
+
+        var btnParent=initBtn&&initBtn.parentElement;
+        if(btnParent&&!btnParent.querySelector('.si-api-only-btn')){
+          var apiBtn=document.createElement('button');
+          apiBtn.className='si-api-only-btn '+initBtn.className;apiBtn.style.display='inline-flex';
+          apiBtn.textContent='API 接口';
+          apiBtn.onclick=function(e){e.preventDefault();e.stopPropagation();togglePanel('api')};
+          btnParent.appendChild(apiBtn);
+        }
+
+        // === 2. 创建面板（插入到 tabs 之前） ===
+        var tabBar=document.querySelector('[role="tablist"]');
+        if(!tabBar){
+          var tabs=findBtn('章节管理');
+          if(tabs)tabBar=tabs.parentElement;
+        }
+        var insertTarget=tabBar||(initBtn&&initBtn.parentElement);
+
+        // 上传面板
+        var upP=document.createElement('div');
+        upP.className='si-panel';upP.id='si-upload';upP.style.display='none';
+        upP.innerHTML='<h3>上传新章节</h3>'
+          +'<div class="si-row"><div><label>章节ID (留空自动)</label><input id="si-uid" placeholder="如 1.6"></div>'
+          +'<div><label>定价 (0=免费)</label><input type="number" id="si-uprice" value="1" step="0.1" min="0"></div></div>'
+          +'<label>标题 *</label><input id="si-utitle" placeholder="章节标题">'
+          +'<div class="si-row"><div><label>所属篇</label><select id="si-upart">'
+          +'<option value="part-1">第一篇｜真实的人</option><option value="part-2">第二篇｜真实的行业</option>'
+          +'<option value="part-3">第三篇｜真实的错误</option><option value="part-4">第四篇｜真实的赚钱</option>'
+          +'<option value="part-5">第五篇｜真实的社会</option><option value="appendix">附录</option>'
+          +'<option value="intro">序言</option><option value="outro">尾声</option></select></div>'
+          +'<div><label>所属章</label><select id="si-uchap">'
+          +'<option value="chapter-1">第1章</option><option value="chapter-2">第2章</option>'
+          +'<option value="chapter-3">第3章</option><option value="chapter-4">第4章</option>'
+          +'<option value="chapter-5">第5章</option><option value="chapter-6">第6章</option>'
+          +'<option value="chapter-7">第7章</option><option value="chapter-8">第8章</option>'
+          +'<option value="chapter-9">第9章</option><option value="chapter-10">第10章</option>'
+          +'<option value="chapter-11">第11章</option><option value="appendix">附录</option>'
+          +'<option value="preface">序言</option><option value="epilogue">尾声</option></select></div></div>'
+          +'<label>内容 (Markdown) *</label><textarea id="si-ucontent" placeholder="正文内容... 图片占位用 {{image_1}}"></textarea>'
+          +'<label>图片URL (每行一个)</label><textarea id="si-uimgs" style="min-height:60px" placeholder="https://example.com/1.png"></textarea>'
+          +'<button class="si-submit" id="si-submit-btn">上传章节</button>';
+        insertTarget.parentElement.insertBefore(upP,insertTarget);
+
+        document.getElementById('si-submit-btn').onclick=function(){siUpload()};
+
+        // API文档面板
+        var apiP=document.createElement('div');
+        apiP.className='si-panel';apiP.id='si-apidoc';apiP.style.display='none';
+        apiP.innerHTML='<div class="si-api">'
+          +'<h3 style="font-family:sans-serif">内容管理 API 接口文档</h3>'
+          +'<div class="si-token-box"><strong style="color:#e0e6ed">生成 TOKEN</strong> — 用于上传新章节、删除等操作<br>'
+          +'<div class="si-token-row"><button class="si-token-btn" id="si-gen-token">生成 TOKEN</button>'
+          +'<input type="text" id="si-token-input" readonly placeholder="点击生成后显示，可复制用于 curl/Skill 上传" style="cursor:pointer">'
+          +'<button class="si-token-btn copy" id="si-copy-token">复制</button></div></div>'
+          +'<p>基础域名: <code>https://soulapi.quwanzhi.com</code> (正式) / <code>https://souldev.quwanzhi.com</code> (开发)</p>'
+          +'<h4>1. 获取所有章节 (无需认证)</h4><pre>GET /api/book/all-chapters\n\ncurl https://soulapi.quwanzhi.com/api/book/all-chapters</pre>'
+          +'<h4>2. 获取单章内容</h4><pre>GET /api/book/chapter/:id\n\ncurl https://soulapi.quwanzhi.com/api/book/chapter/1.1</pre>'
+          +'<h4>3. 管理员登录 (获取Token)</h4><pre>POST /api/admin\nBody: {"username":"admin","password":"admin123"}\n\ncurl -X POST https://souldev.quwanzhi.com/api/admin \\\n  -H "Content-Type: application/json" \\\n  -d \'{"username":"admin","password":"admin123"}\'</pre>'
+          +'<h4>4. 创建/更新章节 (需Token)</h4><pre>POST /api/db/book\nAuthorization: Bearer {token}\nBody: {\n  "id": "1.6",\n  "title": "标题",\n  "content": "Markdown正文",\n  "price": 1.0,\n  "partId": "part-1",\n  "chapterId": "chapter-1"\n}\n\ncurl -X POST https://souldev.quwanzhi.com/api/db/book \\\n  -H "Authorization: Bearer TOKEN" \\\n  -H "Content-Type: application/json" \\\n  -d \'{"id":"1.6","title":"新章节","content":"正文","price":1.0,"partId":"part-1","chapterId":"chapter-1"}\'</pre>'
+          +'<h4>5. 删除章节 (需Token)</h4><pre>DELETE /api/admin/content/:id\n\ncurl -X DELETE https://souldev.quwanzhi.com/api/admin/content/1.6 \\\n  -H "Authorization: Bearer TOKEN"</pre>'
+          +'<h4>6. 命令行上传 (数据库直写)</h4><pre>python3 content_upload.py --title "标题" --price 1.0 --content "正文" \\\n  --part part-1 --chapter chapter-1\n\npython3 content_upload.py --list-structure  # 查看篇章结构\npython3 content_upload.py --list-chapters   # 列出所有章节</pre>'
+          +'<h4>7. 数据库直连</h4><pre>Host: 56b4c23f6853c.gz.cdb.myqcloud.com:14413\nUser: cdb_outerroot\nDB: soul_miniprogram\n表: chapters</pre>'
+          +'</div>';
+        insertTarget.parentElement.insertBefore(apiP,insertTarget);
+
+        document.getElementById('si-gen-token').onclick=function(){
+          var inp=document.getElementById('si-token-input');
+          inp.value='获取中...';
+          doLogin().then(function(ok){
+            if(ok&&token){inp.value=token;toast('TOKEN 已生成，可复制使用')}
+            else{inp.value='';toast('获取失败',false)}
+          });
+        };
+        document.getElementById('si-copy-token').onclick=function(){
+          var inp=document.getElementById('si-token-input');
+          if(!inp.value||inp.value==='获取中...'){toast('请先生成 TOKEN',false);return}
+          inp.select();document.execCommand('copy');
+          toast('已复制到剪贴板');
+        };
+        document.getElementById('si-token-input').onclick=function(){this.select()};
+
+        // === 3. 内容操作：删除(hover)、免费/付费、加号在章节、拖拽 ===
+        addContentActions();
+        addChapterPlus();
+        addDragDrop();
+        new MutationObserver(function(){addContentActions();addChapterPlus();addDragDrop();}).observe(document.getElementById('root'),{childList:true,subtree:true});
+      }
+
+      var activePanel='';
+      var siPrefill={};
+      function togglePanel(name,prefill){
+        var up=document.getElementById('si-upload');
+        var ap=document.getElementById('si-apidoc');
+        if(!up||!ap)return;
+        if(prefill)siPrefill=prefill;
+        if(activePanel===name&&name!=='upload'){ap.style.display='none';activePanel='';return}
+        if(name==='upload'){up.style.display='block';ap.style.display='none';applyPrefill();activePanel='upload';return}
+        if(name==='api'){up.style.display='none';ap.style.display='block';activePanel='api';return}
+      }
+      function applyPrefill(){
+        if(siPrefill.partId){var s=document.getElementById('si-upart');if(s)s.value=siPrefill.partId}
+        if(siPrefill.chapterId){var c=document.getElementById('si-uchap');if(c)c.value=siPrefill.chapterId}
+      }
+      function getSectionInfo(row){
+        var p=row;
+        for(var i=0;i<8&&p;i++){p=p.parentElement;if(!p)break;
+          var t=(p.textContent||'').substring(0,80);
+          if(/附录/.test(t))return{partId:'appendix',chapterId:'appendix'};
+          if(/序言/.test(t))return{partId:'intro',chapterId:'preface'};
+          if(/尾声/.test(t))return{partId:'outro',chapterId:'epilogue'};
+          if(/第一篇/.test(t))return{partId:'part-1',chapterId:'chapter-1'};
+          if(/第二篇/.test(t))return{partId:'part-2',chapterId:'chapter-3'};
+          if(/第三篇/.test(t))return{partId:'part-3',chapterId:'chapter-6'};
+          if(/第四篇/.test(t))return{partId:'part-4',chapterId:'chapter-8'};
+          if(/第五篇/.test(t))return{partId:'part-5',chapterId:'chapter-10'};
+        }
+        return null;
+      }
+
+      function addContentActions(){
+        var all=document.querySelectorAll('button');
+        for(var i=0;i<all.length;i++){
+          var b=all[i];
+          if(b.textContent.trim()==='编辑'&&!b.dataset.sid){
+            b.dataset.sid='1';
+            var par=b.parentElement;
+            if(!par.classList.contains('si-row-actions'))par.classList.add('si-row-actions');
+            var plusInSection=par.querySelector('.si-plus');
+            if(plusInSection)plusInSection.remove();
+            var del=document.createElement('button');
+            del.className='si-del';
+            del.textContent='删除';
+            (function(editBtn){
+              del.onclick=function(e){
+                e.stopPropagation();e.preventDefault();
+                var row=editBtn.closest('[class]');
+                var txt=row?row.textContent:'';
+                var m=txt.match(/([\d]+\.[\d]+|appendix-[\w]+|preface|epilogue)/);
+                var sid=m?m[0]:'';
+                var name=txt.substring(0,40).replace(/读取|编辑|删除|免费|付费|¥[\d.]+|\+/g,'').trim();
+                if(!confirm('确定删除「'+name+'」'+(sid?' (ID:'+sid+')':'')+' ？'))return;
+                auth().then(function(ok){
+                  if(!ok){toast('认证失败',false);return}
+                  apicall('DELETE','/api/admin/content/'+(sid||name)).then(function(r){
+                    if(r.success!==false){toast('已删除');setTimeout(function(){location.reload()},800)}
+                    else{
+                      apicall('DELETE','/api/db/book?action=delete&id='+(sid||name)).then(function(r2){
+                        if(r2.success!==false){toast('已删除');setTimeout(function(){location.reload()},800)}
+                        else toast('删除失败: '+(r2.error||r.error||''),false)
+                      })
+                    }
+                  })
+                })
+              }
+            })(b);
+            par.appendChild(del);
+            addFreeToggle(b);
+          }
+        }
+      }
+      function addChapterPlus(){
+        var seen=new Set();
+        var rows=document.querySelectorAll('[class]');
+        for(var i=0;i<rows.length;i++){
+          var r=rows[i];
+          if(r.querySelector('.si-chap-plus')||seen.has(r))continue;
+          var t=(r.textContent||'').trim();
+          if((/序言|附录|尾声|第一篇|第二篇|第三篇|第四篇|第五篇/.test(t)&&/\d+节/.test(t))){
+            seen.add(r);
+            r.dataset.draggableItem='chapter';
+            var plus=document.createElement('button');
+            plus.className='si-plus si-chap-plus';plus.textContent='+';plus.title='在此章节下新建小节';
+            plus.onclick=function(e){e.stopPropagation();e.preventDefault();
+              var info=getSectionInfo(this.parentElement);
+              togglePanel('upload',info||{});
+            };
+            r.style.display=r.style.display||'flex';r.style.alignItems='center';
+            r.appendChild(plus);
+          }
+        }
+      }
+      function addDragDrop(){
+        var items=document.querySelectorAll('[data-draggable-item]');
+        items.forEach(function(el){if(el.dataset.siDrag)return;el.dataset.siDrag='1';
+          el.draggable=true;el.style.cursor='grab';
+          el.addEventListener('dragstart',onDragStart);
+          el.addEventListener('dragover',onDragOver);el.addEventListener('drop',onDrop);
+        });
+        var sect=document.querySelectorAll('button');
+        for(var j=0;j<sect.length;j++){
+          var sb=sect[j];
+          if(sb.textContent.trim()==='编辑'){
+            var row=sb.closest('[class]');
+            if(row&&!row.dataset.siDrag){
+              row.draggable=true;row.dataset.siDrag='1';row.dataset.draggableItem='section';
+              row.style.cursor='grab';
+              row.addEventListener('dragstart',onDragStart);
+              row.addEventListener('dragover',onDragOver);
+              row.addEventListener('drop',onDrop);
+            }
+          }
+        }
+      }
+      var dragEl=null;
+      function onDragStart(e){dragEl=e.currentTarget;e.dataTransfer.effectAllowed='move';
+        e.dataTransfer.setData('text/plain','');e.currentTarget.classList.add('si-dragging');}
+      function onDragOver(e){e.preventDefault();e.dataTransfer.dropEffect='move';
+        var t=e.currentTarget;
+        if(t!==dragEl){t.classList.add('si-drop-target');
+          var sibs=t.parentElement?t.parentElement.children:[];
+          for(var k=0;k<sibs.length;k++){if(sibs[k]!==t)sibs[k].classList.remove('si-drop-target')}
+        }}
+      function onDrop(e){e.preventDefault();
+        document.querySelectorAll('.si-drop-target').forEach(function(x){x.classList.remove('si-drop-target')});
+        if(!dragEl)return;
+        dragEl.classList.remove('si-dragging');
+        var dest=e.currentTarget;
+        if(dest!==dragEl&&dest.parentNode===dragEl.parentNode){
+          var par=dest.parentNode;
+          var list=Array.from(par.children).filter(function(c){return c.dataset.siDrag||c.draggable;});
+          var i0=list.indexOf(dragEl),i1=list.indexOf(dest);
+          if(i0>=0&&i1>=0&&i0!==i1){
+            if(i0<i1)par.insertBefore(dragEl,dest.nextSibling);
+            else par.insertBefore(dragEl,dest);
+            var newList=Array.from(par.children).filter(function(c){return c.dataset.siDrag||c.draggable;});
+            var ids=newList.map(function(x){return(x.textContent.match(/([\d]+\.[\d]+|appendix-[\w-]+|preface|epilogue)/)||[])[1]}).filter(Boolean);
+            if(ids.length>0)auth().then(function(ok){
+              if(ok)apicall('POST','/api/db/book/order',{ids:ids}).then(function(r){if(r&&r.success)toast('已排序');else toast('排序已更新(后端接口可后续对接)',false)})
+            });
+          }
+        }
+        dragEl=null;
+      }
+      document.addEventListener('dragend',function(){document.querySelectorAll('.si-dragging,.si-drop-target').forEach(function(x){x.classList.remove('si-dragging','si-drop-target')});dragEl=null});
+
+      function addFreeToggle(editBtn){
+        var row=editBtn.closest('[class]');
+        if(!row||row.querySelector('.si-free-toggle'))return;
+        var sid=(row.textContent.match(/([\d]+\.[\d]+|appendix-[\w-]+|preface|epilogue)/)||[])[1]||'';
+        var candidates=row.querySelectorAll('span, div, [class]');
+        for(var j=0;j<candidates.length;j++){
+          var el=candidates[j];
+          if(el.classList&&el.classList.contains('si-free-toggle'))continue;
+          var t=(el.textContent||'').trim();
+          if((t==='免费'||/^¥[\d.]+$/.test(t))&&el.children.length===0){
+            var isFree=t==='免费';
+            var toggle=document.createElement('span');
+            toggle.className='si-free-toggle'+(isFree?'':' paid');
+            toggle.textContent=isFree?'免费':'付费';
+            toggle.dataset.sectionId=sid;
+            toggle.dataset.price=isFree?'0':'1';
+            toggle.onclick=function(e){e.stopPropagation();e.preventDefault();
+              if(e.detail>=2)return;
+              var sectionId=toggle.dataset.sectionId;
+              if(!sectionId){toast('无法识别章节ID',false);return}
+              var toFree=toggle.textContent==='付费';
+              auth().then(function(ok){
+                if(!ok){toast('认证失败',false);return}
+                var pr=toFree?0:1;
+                apicall('POST','/api/db/book',{id:sectionId,isFree:toFree,price:pr}).then(function(r){
+                  if(r.success!==false){toggle.textContent=toFree?'免费':'¥'+pr;toggle.classList.toggle('paid',!toFree);toggle.dataset.price=pr;toast('已更新')}
+                  else toast('更新失败: '+(r.error||''),false)
+                })
+              })
+            };
+            toggle.ondblclick=function(e){e.stopPropagation();e.preventDefault();
+              var sectionId=toggle.dataset.sectionId;
+              if(!sectionId){toast('无法识别章节ID',false);return}
+              if(toggle.textContent==='免费'){
+                auth().then(function(ok){
+                  if(!ok){toast('认证失败',false);return}
+                  var pr=parseFloat(prompt('请输入付费金额','1'))||1;
+                  apicall('POST','/api/db/book',{id:sectionId,isFree:false,price:pr}).then(function(r){
+                    if(r.success!==false){toggle.textContent='¥'+pr;toggle.classList.add('paid');toggle.dataset.price=pr;toast('已更新')}
+                    else toast('更新失败',false)
+                  })
+                })
+              }else{
+                auth().then(function(ok){
+                  if(!ok){toast('认证失败',false);return}
+                  apicall('POST','/api/db/book',{id:sectionId,isFree:true,price:0}).then(function(r){
+                    if(r.success!==false){toggle.textContent='免费';toggle.classList.remove('paid');toggle.dataset.price='0';toast('已设为免费')}
+                    else toast('更新失败',false)
+                  })
+                })
+              }
+            };
+            el.parentNode.replaceChild(toggle,el);
+            break;
+          }
+        }
+      }
+
+      function siUpload(){
+        var title=document.getElementById('si-utitle').value.trim();
+        var content=document.getElementById('si-ucontent').value.trim();
+        if(!title){toast('请填写标题',false);return}
+        if(!content){toast('请填写内容',false);return}
+        var imgs=document.getElementById('si-uimgs').value.trim().split('\n').filter(Boolean);
+        imgs.forEach(function(u,i){content=content.replace('{{image_'+(i+1)+'}}','![图片'+(i+1)+']('+u.trim()+')')});
+        var price=parseFloat(document.getElementById('si-uprice').value)||0;
+        var data={
+          id:document.getElementById('si-uid').value.trim()||undefined,
+          title:title,content:content,price:price,isFree:price===0,
+          partId:document.getElementById('si-upart').value,
+          chapterId:document.getElementById('si-uchap').value
+        };
+        toast('上传中...');
+        auth().then(function(ok){
+          if(!ok){toast('认证失败',false);return}
+          apicall('POST','/api/db/book',data).then(function(r){
+            if(r.success!==false){
+              toast('上传成功！');
+              document.getElementById('si-utitle').value='';
+              document.getElementById('si-ucontent').value='';
+              document.getElementById('si-uimgs').value='';
+              document.getElementById('si-uid').value='';
+              setTimeout(function(){location.reload()},1000)
+            }else toast('失败: '+(r.error||''),false)
+          })
+        })
+      }
+
+      setInterval(run,500);
+      new MutationObserver(run).observe(document.getElementById('root'),{childList:true,subtree:true});
+    })();
+    </script>
+  </body>
+</html>

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

开发文档/10、项目管理/项目落地推进表.md

@@ -348,8 +348,77 @@ vercel --prod
 
 **项目状态**：✅ **已完成100%，可直接部署到生产环境**
 
-**建议下一步**：立即部署到Vercel，配置环境变量，测试支付流程
+**建议下一步**：按需接入永平版可选能力（定时任务、提现记录、地址管理、推广设置页等），见 `开发文档/永平版优化对比与合并说明.md`
 
-**最后更新时间**：2025-12-29 23:59  
+**最后更新时间**：2026-02-20  
 **最后更新人**：卡若 (智能助手)  
 **项目交付状态**：✅ 完整交付
+
+---
+
+## 九、永平版优化合并迭代（2026-02-20）
+
+### 9.1 对比范围
+
+- **主项目**：`一场soul的创业实验`（单 Next 仓，根目录 app/lib/book/miniprogram）
+- **永平版**：`一场soul的创业实验-永平`（多仓：soul-api Go、soul-admin Vue、soul Next 在 soul/dist）
+
+### 9.2 已合并优化项
+
+| 模块 | 内容 | 路径/说明 |
+|------|------|------------|
+| 数据库 | 环境变量 MYSQL_*、SKIP_DB、连接超时与单次错误日志 | `lib/db.ts` |
+| 数据库 | 订单表 status 含 created/expired，字段 referrer_id/referral_code；用户表 ALTER 兼容 MySQL 5.7 | `lib/db.ts` |
+| 认证 | 密码哈希/校验（scrypt，兼容旧明文） | `lib/password.ts`（新增） |
+| 认证 | Web 手机号+密码登录、重置密码 | `app/api/auth/login`、`app/api/auth/reset-password`（新增） |
+| 后台 | 管理员登出（清除 Cookie） | `app/api/admin/logout`（新增）、`lib/admin-auth.ts`（新增） |
+| 前端 | 仅生产环境加载 Vercel Analytics | `app/layout.tsx` |
+| 文档 | 本机/服务器运行说明 | `开发文档/本机运行文档.md`（新增） |
+| 文档 | 永平 vs 主项目对比与可选合并清单 | `开发文档/永平版优化对比与合并说明.md`（新增） |
+
+### 9.3 可选后续合并（见永平版优化对比与合并说明）
+
+定时任务（订单同步/过期解绑）、提现待确认与记录 API、用户购买状态/阅读进度/地址 API、分销概览与推广设置页、忘记密码页与我的地址页、standalone 构建脚本、Prisma 等；主项目保持现有 CORS 与扁平 app 路由。
+
+---
+
+## 十、链路优化与 yongpxu-soul 对照（2026-02-20）
+
+### 10.1 链路优化（不改文件结构）
+
+- **文档**：已新增 `开发文档/链路优化与运行指南.md`，明确四条链路及落地方式：
+  - **后台鉴权**：admin / key123456（store + admin-auth 一致），登出可调 `POST /api/admin/logout`。
+  - **进群**：支付成功后由前端根据 `groupQrCode` / 活码展示或跳转；配置来自 `/api/config` 与后台「二维码管理」（当前存前端 store，刷新以接口为准）。
+  - **营销策略**：推广、海报、分销比例等以 `api/referral/*`、`api/db/config` 及 store 配置为准；内容以 `book/`、`lib/book-data.ts` 为准。
+  - **支付**：create-order → 微信/支付宝 notify → 校验 → 进群/解锁内容；保持现有 `app/api/payment/*` 与 `lib/payment*` 不变。
+- **协同**：鉴权、进群、营销、支付可多角色并行优化，所有改动限于现有目录与文件，不新增一级目录。
+- **运行**：以第一目录为基准，`pnpm dev` / 生产 build+standalone，端口 3006；详见 `开发文档/本机运行文档.md` 与链路指南内运行检查清单。
+
+### 10.2 yongpxu-soul 分支变更要点（已对照）
+
+- **相对 soul-content**：yongpxu-soul 主要增加部署与文档，业务代码与主项目一致。
+  - 新增：`scripts/deploy_baota.py`、`开发文档/8、部署/宝塔配置检查说明.md`、`开发文档/8、部署/当前项目部署到线上.md`、小程序相关（miniprogram 上传脚本、开发文档/小程序管理、开发文档/服务器管理）、`开发文档/提现功能完整技术文档.md`、`lib/wechat-transfer.ts` 等。
+  - 删除/合并：大量历史部署报告与重复文档（如多份「部署完成」「升级完成」等），功能迭代记录合并精简。
+- **结论**：业务链路（鉴权→进群→营销→支付）以**第一目录现有实现**为准；yongpxu-soul 的修改用于**部署方式、小程序发布、文档与运维**，不改变主项目文件结构与上述四条链路的代码归属。
+- **可运行性**：按《链路优化与运行指南》第七节检查清单自检后，项目可在不修改文件结构的前提下完成落地与运行。
+
+### 10.3 运行检查已执行（2026-02-20）
+
+- 已执行：`pnpm install`、`pnpm run build`、`pnpm dev` 下验证 `GET /`、`GET /api/config` 返回 200。
+- 执行记录详见 `开发文档/链路优化与运行指南.md` 第八节。
+- 结论：构建与开发环境运行正常，链路就绪。
+
+---
+
+## 十一、下一步行动计划（2026-02-20）
+
+| 优先级 | 行动项 | 负责模块 | 说明 |
+|--------|--------|----------|------|
+| P0 | 生产部署与回调配置 | 支付/部署 | 将当前分支部署至宝塔（或现有环境），配置微信/支付宝回调 URL 指向 `/api/payment/wechat/notify`、`/api/payment/alipay/notify`，并验证支付→到账→进群展示。 |
+| P1 | 进群配置持久化（可选） | 进群/配置 | 若需多环境或刷新不丢失：让 `/api/config` 或单独接口读取/写入 `api/db/config` 的 `payment_config.wechatGroupUrl`、活码链接；或后台「二维码管理」保存时调用 db 配置 API。 |
+| P1 | 后台「退出登录」对接 | 鉴权 | 在 `app/admin/layout.tsx` 将「返回前台」旁增加「退出登录」按钮，点击请求 `POST /api/admin/logout` 后跳转 `/admin/login`（若后续改为服务端 Cookie 鉴权即可生效）。 |
+| P2 | Admin 密码环境变量统一（可选） | 鉴权 | 在 `lib/store.ts` 的 `adminLogin` 中从 `process.env.NEXT_PUBLIC_ADMIN_USERNAME` / `NEXT_PUBLIC_ADMIN_PASSWORD` 读取（或通过小 API 校验），与 `lib/admin-auth.ts` 一致。 |
+| P2 | 营销与内容迭代 | 营销/内容 | 在现有结构内更新：`book/` 下 Markdown、`lib/book-data.ts` 章节与免费列表、`api/referral/*` 与 `api/db/config` 分销/推广配置；后台「系统设置」「内容管理」按需调整。 |
+| P2 | 文档与分支同步 | 文档 | 定期将 yongpxu-soul 的部署/小程序/运维文档变更合并到主分支或文档目录，保持《链路优化与运行指南》《本机运行文档》与线上一致。 |
+
+以上按 P0 → P1 → P2 顺序推进；P0 完成即可上线跑通整条链路，P1/P2 为体验与可维护性增强。

开发文档/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  
-**状态**：等待安全组配置

开发文档/soul-admin变更记录_v2026-02.md

@@ -0,0 +1,79 @@
+# Soul 管理后台 (soul-admin) 变更记录 v2026-02
+
+> 更新时间：2026-02-21  
+> 适用站点：souladmin.quwanzhi.com  
+> 部署路径：`/www/wwwroot/自营/soul-admin/dist/`
+
+---
+
+## 一、变更概览
+
+| 模块 | 变更项 | 说明 |
+|:---|:---|:---|
+| 侧边栏 | 交易中心 → 推广中心 | 菜单及页面标题统一改为「推广中心」 |
+| 内容管理 | 顶部 5 按钮移除 | 移除：初始化数据库、同步到数据库、导入、导出、同步飞书 |
+| 内容管理 | 仅保留 API 接口 | 仅保留「API 接口」按钮，打开 API 文档面板 |
+| 内容管理 | 删除按钮 | 删除按钮改为悬停才显示（与读取/编辑一致） |
+| 内容管理 | 免费/付费 | 可点击切换免费 ↔ 付费 |
+| 内容管理 | 小节加号 | 每小节旁增加「+」按钮，可在此小节下新建章节 |
+
+---
+
+## 二、部署说明
+
+### 2.1 正确部署路径
+
+nginx 实际指向：
+
+```nginx
+root /www/wwwroot/自营/soul-admin/dist;
+```
+
+**重要**：需将 `soul-admin/dist` 部署到上述目录，而非 `/www/wwwroot/souladmin.quwanzhi.com/`。
+
+### 2.2 部署步骤
+
+```bash
+# 1. 本地打包
+cd /Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验/soul-admin/dist
+tar -czf /tmp/souladmin.tar.gz index.html assets/
+
+# 2. 上传并解压到正确路径
+scp -P 22022 /tmp/souladmin.tar.gz root@43.139.27.93:/tmp/
+ssh -p 22022 root@43.139.27.93 'cd /www/wwwroot/自营/soul-admin/dist && tar -xzf /tmp/souladmin.tar.gz && chown -R www:www . && rm /tmp/souladmin.tar.gz'
+```
+
+### 2.3 缓存处理
+
+- `index.html` 内引用 `index-CbOmKBRd.js?v=版本号`，每次发布建议递增版本号
+- 建议在 `index.html` 中调整：`?v=3` 或更高
+
+---
+
+## 三、技术说明
+
+### 3.1 修改文件
+
+- `index.html`：内联注入脚本（按钮改造、删除 hover、免费切换、加号新建）
+- `assets/index-CbOmKBRd.js`：侧边栏「交易中心」→「推广中心」
+
+### 3.2 注入脚本触发条件
+
+- 路径包含 `content`（如 `/content`）
+- 页面上存在「初始化数据库」按钮（内容管理页加载完成）
+
+### 3.3 免费/付费切换
+
+- 调用 `POST /api/db/book`，传入 `{ id, isFree, price }`
+- 需后端支持按 id 更新 isFree/price
+
+---
+
+## 四、问题排查
+
+| 现象 | 可能原因 | 处理方式 |
+|:---|:---|:---|
+| 界面未变化 | 部署到错误目录 | 确认部署到 `/www/wwwroot/自营/soul-admin/dist/` |
+| 界面未变化 | 浏览器/CDN 缓存 | 清除缓存或使用无痕模式，或增加 `?v=` 版本号 |
+| 内容管理注入不生效 | 路由为 hash 模式 | 检查 `location.pathname` 是否包含 `content`，必要时改用 `location.hash` |
+| 免费切换失败 | 后端未实现更新 | 检查 soul-api 是否支持 `POST /api/db/book` 的更新逻辑 |

开发文档/内容创建问题修复说明.md

@@ -0,0 +1,93 @@
+# 内容创建问题修复说明
+
+> 问题：souladmin 添加内容后显示「创建成功」，但目录和数据库未增加，前端也未显示。
+
+## 根因分析
+
+1. **两套后台数据源不一致**
+   - souladmin.quwanzhi.com 调用 soulapi.quwanzhi.com（Go API）
+   - soul.quwanzhi.com/admin 使用 Next.js API，list 此前仅从 bookData（静态）读取
+   - 新建章节写入数据库，但 list 不查库，导致新建内容不显示
+
+2. **PUT 创建未完整支持 partId/chapterId**
+   - 新建章节时 partId、chapterId、partTitle、chapterTitle 未正确写入数据库
+
+## 已做修复
+
+### 1. 修改 `/api/db/book` list 接口
+- **原逻辑**：仅从 bookData 读取
+- **现逻辑**：优先从数据库 chapters 表读取，再与 bookData 合并
+- **效果**：新建章节会立即出现在列表中
+
+### 2. 修改 PUT 接口支持新建章节
+- 支持 body 传入 `partId`、`chapterId`、`partTitle`、`chapterTitle`、`isFree`
+- 新建章节能正确写入数据库
+
+### 3. 在 book-data 中新增 9.15
+- 章节 ID: 9.15  
+- 标题: 第102场｜今年第一个红包你发给谁  
+- 文件: book/第四篇｜真实的赚钱/第9章｜我在Soul上亲访的赚钱案例/9.15 第102场｜今年第一个红包你发给谁.md  
+
+### 4. soul-admin 改用 soul.quwanzhi.com 作为 API
+- 修改 soul-admin 的 API 基址：soulapi → soul.quwanzhi.com
+- 在 Next.js 中为 souladmin.quwanzhi.com 配置 CORS
+
+## 部署步骤
+
+### 步骤 1：部署 soul 主站（小型宝塔）
+
+```bash
+cd /Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验
+# 按 .cursorrules 中的流程执行
+pnpm build
+# 然后执行部署脚本
+```
+
+### 步骤 2：同步 9.15 到数据库
+
+部署后访问 soul.quwanzhi.com/admin，在内容管理页面点击「同步到数据库」，将包含 9.15 的 bookData 同步进库。
+
+### 步骤 3：部署修改后的 soul-admin（KR 宝塔）
+
+```bash
+# 将 一场soul的创业实验-永平 中的 soul-admin/dist 上传到 KR 宝塔
+cd /Users/karuo/Documents/开发/3、自营项目/一场soul的创业实验-永平
+tar -czf soul-admin-dist.tar.gz soul-admin/dist
+sshpass -p 'Zhiqun1984' scp -P 22022 soul-admin-dist.tar.gz root@43.139.27.93:/tmp/
+sshpass -p 'Zhiqun1984' ssh -p 22022 root@43.139.27.93 "
+  cd /www/wwwroot/自营/soul-admin
+  rm -rf dist.bak
+  mv dist dist.bak 2>/dev/null || true
+  tar -xzf /tmp/soul-admin-dist.tar.gz -C .
+  rm /tmp/soul-admin-dist.tar.gz
+"
+```
+
+### 步骤 4：校验
+
+1. 打开 souladmin.quwanzhi.com/content  
+2. 新建章节，确认创建后列表中立即出现  
+3. 刷新 soul.quwanzhi.com 主站，确认新章节可读
+
+## 注意事项
+
+- souladmin 现改为调用 soul.quwanzhi.com，不再调用 soulapi（Go），需确保 soul 主站可用
+- 若仍需使用 Go API，需在 soul-api 源码中修复 list/create 逻辑
+
+---
+
+## 内容上传 API（供科室/Skill 调用）
+
+- **地址**：`POST /api/content/upload`
+- **Content-Type**：`application/json`
+- **Body 字段**：
+  - `title`（必填）：节标题
+  - `price`：定价，默认 1
+  - `content`：正文（Markdown 或 HTML）
+  - `format`：`markdown` | `html`，默认 `markdown`
+  - `images`：图片 URL 数组；正文中可用 `{{image_0}}`、`{{image_1}}` 占位，会替换为对应图片的 Markdown 图链
+  - `partId`、`partTitle`、`chapterId`、`chapterTitle`：归属篇/章，可选
+  - `isFree`：是否免费，默认 false
+  - `sectionId`：指定节 ID，不传则自动生成（如 `upload.标题slug.时间戳`）
+- **返回**：`{ success, id, message, title, price, isFree, wordCount }`
+- 写入数据库 `chapters` 表，list/目录会从库中读取并去重显示。

开发文档/功能迭代记录.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
+  }
+}