$1
') + html = html.replace(/^# (.+)$/gm, '$1
') + html = html.replace(/\*\*(.+?)\*\*/g, '$1') + html = html.replace(/__(.+?)__/g, '$1') + html = html.replace(/(?$1') + html = html.replace(/(?$1') + html = html.replace(/~~(.+?)~~/g, '$1')
+ html = html.replace(/!\[([^\]]*)\]\(([^)]+)\)/g, '') + html = html.replace(/^---$/gm, '$1
') + html = html.replace(/^- (.+)$/gm, '
${trimmed}
`) + } + } + return result.join('') +} + +/** + * LinkTagExtension — 自定义 TipTap 内联节点，保留所有 data-* 属性 + * 解决：insertContent(html) 会经过 TipTap schema 导致自定义属性被丢弃的问题 + */ +const LinkTagExtension = TiptapNode.create({ + name: 'linkTag', + group: 'inline', + inline: true, + selectable: true, + atom: true, + + addAttributes() { + return { + label: { default: '' }, + url: { default: '' }, + tagType: { default: 'url', parseHTML: (el: HTMLElement) => el.getAttribute('data-tag-type') || 'url' }, + tagId: { default: '', parseHTML: (el: HTMLElement) => el.getAttribute('data-tag-id') || '' }, + pagePath: { default: '', parseHTML: (el: HTMLElement) => el.getAttribute('data-page-path') || '' }, + appId: { default: '', parseHTML: (el: HTMLElement) => el.getAttribute('data-app-id') || '' }, + mpKey: { default: '', parseHTML: (el: HTMLElement) => el.getAttribute('data-mp-key') || '' }, + } + }, + + parseHTML() { + return [{ tag: 'span[data-type="linkTag"]', getAttrs: (el: HTMLElement) => ({ + label: el.textContent?.replace(/^#/, '').trim() || '', + url: el.getAttribute('data-url') || '', + tagType: el.getAttribute('data-tag-type') || 'url', + tagId: el.getAttribute('data-tag-id') || '', + pagePath: el.getAttribute('data-page-path')|| '', + appId: el.getAttribute('data-app-id') || '', + mpKey: el.getAttribute('data-mp-key') || '', + }) }] + }, + + // eslint-disable-next-line @typescript-eslint/no-explicit-any + renderHTML({ node, HTMLAttributes }: { node: any; HTMLAttributes: Record
+ @${item.name}
+ ${(item as PersonItem & { _newName?: string }).id === '__new__' ? '' : (item.label || item.id)}
+
`
+ ).join('')
+ popup.querySelectorAll('.mention-item').forEach(el => {
+ el.addEventListener('click', () => {
+ const idx = parseInt(el.getAttribute('data-index') || '0')
+ selectItem(idx)
+ })
+ })
+ }
+
+ return {
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
+ onStart: (props: any) => {
+ popup = document.createElement('div')
+ popup.className = 'mention-popup'
+ document.body.appendChild(popup)
+ items = props.items
+ command = props.command
+ selectedIndex = 0
+ update()
+ if (props.clientRect) {
+ const rect = props.clientRect()
+ if (rect) {
+ popup.style.top = `${rect.bottom + 4}px`
+ popup.style.left = `${rect.left}px`
+ }
+ }
+ },
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
+ onUpdate: (props: any) => {
+ items = props.items
+ command = props.command
+ selectedIndex = 0
+ update()
+ if (props.clientRect && popup) {
+ const rect = props.clientRect()
+ if (rect) {
+ popup.style.top = `${rect.bottom + 4}px`
+ popup.style.left = `${rect.left}px`
+ }
+ }
+ },
+ onKeyDown: (props: { event: KeyboardEvent }) => {
+ if (props.event.key === 'ArrowUp') { selectedIndex = Math.max(0, selectedIndex - 1); update(); return true }
+ if (props.event.key === 'ArrowDown') { selectedIndex = Math.min(items.length - 1, selectedIndex + 1); update(); return true }
+ if (props.event.key === 'Enter') { selectItem(selectedIndex); return true }
+ if (props.event.key === 'Escape') { popup?.remove(); popup = null; return true }
+ return false
+ },
+ onExit: () => { popup?.remove(); popup = null },
+ }
+ },
+})
+
+const RichEditor = forwardRef
+
+ )
+})
+
+RichEditor.displayName = 'RichEditor'
+export default RichEditor
diff --git a/new-soul/soul-admin/src/components/modules/user/SetVipModal.tsx b/new-soul/soul-admin/src/components/modules/user/SetVipModal.tsx
new file mode 100644
index 00000000..abac7808
--- /dev/null
+++ b/new-soul/soul-admin/src/components/modules/user/SetVipModal.tsx
@@ -0,0 +1,281 @@
+import toast from '@/utils/toast'
+import { useState, useEffect } from 'react'
+import {
+ Dialog,
+ DialogContent,
+ DialogHeader,
+ DialogTitle,
+ DialogFooter,
+} from '@/components/ui/dialog'
+import { Button } from '@/components/ui/button'
+import { Input } from '@/components/ui/input'
+import { Label } from '@/components/ui/label'
+import { Switch } from '@/components/ui/switch'
+import { Crown, Save, X } from 'lucide-react'
+import { get, put } from '@/api/client'
+
+interface SetVipModalProps {
+ open: boolean
+ onClose: () => void
+ userId: string | null
+ userNickname?: string
+ onSaved?: () => void
+}
+
+interface VipRole {
+ id: number
+ name: string
+ sort: number
+}
+
+interface VipForm {
+ isVip: boolean
+ vipExpireDate: string
+ vipSort: number | ''
+ vipRole: string
+ vipRoleCustom: string
+ vipName: string
+ vipProject: string
+ vipContact: string
+ vipBio: string
+}
+
+const DEFAULT_FORM: VipForm = {
+ isVip: false,
+ vipExpireDate: '',
+ vipSort: '',
+ vipRole: '',
+ vipRoleCustom: '',
+ vipName: '',
+ vipProject: '',
+ vipContact: '',
+ vipBio: '',
+}
+
+export function SetVipModal({
+ open,
+ onClose,
+ userId,
+ userNickname = '',
+ onSaved,
+}: SetVipModalProps) {
+ const [form, setForm] = useState
+
+ {showLinkInput && (
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ {linkTags.length > 0 && (
+ <>
+
+
+
+
+
+ )}
+
+ setLinkUrl(e.target.value)}
+ onKeyDown={e => e.key === 'Enter' && addLink()}
+ className="link-input"
+ />
+
+
+
+ )}
+ {(imageUploading || videoUploading) && (
+
+
+ )}
+
+
+
+ {videoUploading ? '视频' : '图片'}上传中 {uploadProgress}%
+
+
+ )
+}
diff --git a/new-soul/soul-admin/src/components/ui/badge.tsx b/new-soul/soul-admin/src/components/ui/badge.tsx
new file mode 100644
index 00000000..e80a5d97
--- /dev/null
+++ b/new-soul/soul-admin/src/components/ui/badge.tsx
@@ -0,0 +1,31 @@
+import * as React from 'react'
+import { Slot } from '@radix-ui/react-slot'
+import { cva, type VariantProps } from 'class-variance-authority'
+import { cn } from '@/lib/utils'
+
+const badgeVariants = cva(
+ 'inline-flex items-center justify-center rounded-md border px-2 py-0.5 text-xs font-medium w-fit whitespace-nowrap shrink-0 transition-colors',
+ {
+ variants: {
+ variant: {
+ default: 'border-transparent bg-primary text-primary-foreground',
+ secondary: 'border-transparent bg-secondary text-secondary-foreground',
+ destructive: 'border-transparent bg-destructive text-white',
+ outline: 'text-foreground',
+ },
+ },
+ defaultVariants: { variant: 'default' },
+ },
+)
+
+function Badge({
+ className,
+ variant,
+ asChild = false,
+ ...props
+}: React.ComponentProps<'span'> & VariantProps
+ 共 {total} 条
+ {onPageSizeChange && (
+
+ )}
+
+ {totalPages > 1 && (
+
+
+
+
+ {page} / {totalPages}
+
+
+
+
+ )}
+
+
+
+ ),
+)
+Table.displayName = 'Table'
+
+const TableHeader = React.forwardRef<
+ HTMLTableSectionElement,
+ React.HTMLAttributes
+
+
+ )
+ }
+
+ return (
+
+
+ 加载中...
+
+
+ )
+}
diff --git a/new-soul/soul-admin/src/lib/utils.ts b/new-soul/soul-admin/src/lib/utils.ts
new file mode 100644
index 00000000..7bb4eecc
--- /dev/null
+++ b/new-soul/soul-admin/src/lib/utils.ts
@@ -0,0 +1,19 @@
+import { clsx, type ClassValue } from 'clsx'
+import { twMerge } from 'tailwind-merge'
+
+export function cn(...inputs: ClassValue[]) {
+ return twMerge(clsx(inputs))
+}
+
+/**
+ * 修复图片 URL 中 protocol 缺少冒号的问题（如 `https//` → `https://`）。
+ * 同时处理 OSS 签名 URL 中 objectKey 的 %2F 编码，保证浏览器能正确解析。
+ */
+export function normalizeImageUrl(url: string | null | undefined): string {
+ if (!url) return ''
+ let s = url.trim()
+ if (!s) return ''
+ // 修复 "https//..." 或 "http//..." → "https://..." / "http://..."
+ s = s.replace(/^(https?)\/\//, '$1://')
+ return s
+}
diff --git a/new-soul/soul-admin/src/main.tsx b/new-soul/soul-admin/src/main.tsx
new file mode 100644
index 00000000..4e55d7d1
--- /dev/null
+++ b/new-soul/soul-admin/src/main.tsx
@@ -0,0 +1,13 @@
+import { StrictMode } from 'react'
+import { createRoot } from 'react-dom/client'
+import { BrowserRouter } from 'react-router-dom'
+import App from './App'
+import './index.css'
+
+createRoot(document.getElementById('root')!).render(
+
+
+
+
+
+
+
+
+ 管理后台
+Soul创业派对
+
+
+
+
+
+
+
+
+
+
+ {loading ? (
+
+
+ {totalPages > 1 && (
+
+
+
+
+
+ )
+}
diff --git a/new-soul/soul-admin/src/pages/api-doc/ApiDocPage.tsx b/new-soul/soul-admin/src/pages/api-doc/ApiDocPage.tsx
new file mode 100644
index 00000000..bb8ce129
--- /dev/null
+++ b/new-soul/soul-admin/src/pages/api-doc/ApiDocPage.tsx
@@ -0,0 +1,146 @@
+/**
+ * API 接口文档页 - 解决 /api-doc 404
+ * 内容与 开发文档/5、接口/API接口完整文档.md 保持一致
+ */
+import { Card, CardContent, CardHeader, CardTitle } from '@/components/ui/card'
+import { Link2 } from 'lucide-react'
+
+export function ApiDocPage() {
+ return (
+
+
+
+ {error && (
+
+
+
+
+
+
+ 后台登录账号管理，仅超级管理员可操作
+
+ setSearchTerm(e.target.value)}
+ className="w-48 bg-[#0f2137] border-gray-700 text-white placeholder:text-gray-500"
+ />
+
+
+
+
+ {error}
+
+
+ )}
+
+ 加载中...
+ ) : (
+ <>
+
+
+ )}
+
+ )}
+
+
+
+ 1. 接口总览
+
+
+
+
+
+
+
+ 2. 书籍内容
+
+
+
+
+
+
+
+ 2.1 小程序上传接口
+
+
+
+
+
+
+
+ 2.2 管理端内容上传
+
+
+
+
+
+
+
+ 3. 支付
+
+
+
+
+
+
+
+ 4. 分销与用户
+
+
+
+
+
+
+
+ 5. 管理后台
+
+
+
+
+
+
+ )
+}
diff --git a/new-soul/soul-admin/src/pages/api-docs/ApiDocsPage.tsx b/new-soul/soul-admin/src/pages/api-docs/ApiDocsPage.tsx
new file mode 100644
index 00000000..d3ccc701
--- /dev/null
+++ b/new-soul/soul-admin/src/pages/api-docs/ApiDocsPage.tsx
@@ -0,0 +1,442 @@
+/**
+ * API 接口完整文档页 - 内容管理相关接口
+ * 深色主题，与 Admin 整体风格一致
+ */
+import { Card, CardContent, CardHeader, CardTitle } from '@/components/ui/card'
+import { BookOpen, User, Tag, Search, Trophy, Smartphone, Key } from 'lucide-react'
+
+interface EndpointBlockProps {
+ method: string
+ url: string
+ desc?: string
+ headers?: string[]
+ body?: string
+ response?: string
+}
+
+function EndpointBlock({ method, url, desc, headers, body, response }: EndpointBlockProps) {
+ const methodColor =
+ method === 'GET'
+ ? 'text-emerald-400'
+ : method === 'POST'
+ ? 'text-amber-400'
+ : method === 'PUT'
+ ? 'text-blue-400'
+ : method === 'DELETE'
+ ? 'text-rose-400'
+ : 'text-gray-400'
+ return (
+
+
+ API 接口文档
++ API 风格：RESTful · 版本 v1.0 · 基础路径 /api · 简单、清晰、易用。 +
+ +
+
+ 接口分类
+-
+
- /api/book — 书籍内容（章节列表、内容获取、同步） +
- /api/miniprogram/upload — 小程序上传（图片/视频、图片压缩） +
- /api/admin/content/upload — 管理端内容导入 +
- /api/payment — 支付系统（订单创建、回调、状态查询） +
- /api/referral — 分销系统（邀请码、收益、提现） +
- /api/user — 用户系统（登录、注册、信息更新） +
- /api/match — 匹配系统（寻找匹配、匹配历史） +
- /api/admin — 管理后台（内容/订单/用户/分销管理） +
- /api/config — 配置系统 +
+
+ 认证方式
+用户：Cookie session_id（可选）
+管理端：Authorization: Bearer admin-token-secret
+GET /api/book/all-chapters — 获取所有章节
+GET /api/book/chapter/:id — 获取单章内容
+POST /api/book/sync — 同步章节（需管理员认证）
+
+
+ POST /api/miniprogram/upload/image — 图片上传（支持压缩）
+表单：file（必填）、folder（可选，默认 images）、quality（可选 1-100，默认 85）
+支持 jpeg/png/gif，单张最大 5MB。JPEG 按 quality 压缩。
+
+{`响应示例: { "success": true, "url": "/uploads/images/xxx.jpg", "data": { "url", "fileName", "size", "type", "quality" } }`}
+
+
+
+ POST /api/miniprogram/upload/video — 视频上传
+表单：file（必填）、folder（可选，默认 videos）
+支持 mp4/mov/avi，单个最大 100MB。
+
+{`响应示例: { "success": true, "url": "/uploads/videos/xxx.mp4", "data": { "url", "fileName", "size", "type", "folder" } }`}
+
+ POST /api/admin/content/upload — 内容导入（需 AdminAuth）
+通过 API 批量导入章节到内容管理，不直接操作数据库。
+
+{`请求体: {
+ "action": "import",
+ "data": [{
+ "id": "ch-001",
+ "title": "章节标题",
+ "content": "正文内容",
+ "price": 1.0,
+ "isFree": false,
+ "partId": "part-1",
+ "partTitle": "第一篇",
+ "chapterId": "chapter-1",
+ "chapterTitle": "第1章"
+ }]
+}`}
+
+ 响应：{`{ "success": true, "message": "导入完成", "imported": N, "failed": M }`}
+POST /api/payment/create-order — 创建订单
+POST /api/payment/alipay/notify — 支付宝回调
+POST /api/payment/wechat/notify — 微信回调
+/api/referral/* — 邀请码、收益查询、提现
+/api/user/* — 登录、注册、信息更新
+/api/match/* — 匹配、匹配历史
+GET/POST /api/admin/referral-settings — 推广/分销设置（含 VIP 配置）
+GET /api/db/users、/api/db/book — 用户与章节数据
+GET /api/admin/orders — 订单列表
++ 完整说明见项目内 开发文档/5、接口/API接口完整文档.md +
+
+
+ )
+}
+
+export function ApiDocsPage() {
+ const baseHeaders = ['Authorization: Bearer {token}', 'Content-Type: application/json']
+
+ return (
+
+ {method}
+
+ {desc && {url}
+ {desc}
} + {headers && headers.length > 0 && ( +
+
+ )}
+ {body && (
+ Headers
+
+ {headers.join('\n')}
+
+
+
+ )}
+ {response && (
+ Request Body (JSON)
+
+ {body}
+
+
+
+ )}
+ Response Example
+
+ {response}
+
+
+
+
+
+
+
+
+
+
+
+ {/* 2. Chapters */}
+
+
+
+
+
+
+
+
+
+ {/* 3. Persons */}
+
+
+
+
+
+
+
+
+
+ {/* 4. LinkTags */}
+
+
+
+
+
+
+
+
+
+ {/* 5. Search */}
+
+
+
+
+
+
+
+
+
+ {/* 6. Ranking */}
+
+
+
+
+
+
+
+
+
+ {/* 7. Miniprogram */}
+
+
+
+
+
+
+
+
+
+
+ )
+}
diff --git a/new-soul/soul-admin/src/pages/author-settings/AuthorSettingsPage.tsx b/new-soul/soul-admin/src/pages/author-settings/AuthorSettingsPage.tsx
new file mode 100644
index 00000000..9183e173
--- /dev/null
+++ b/new-soul/soul-admin/src/pages/author-settings/AuthorSettingsPage.tsx
@@ -0,0 +1,362 @@
+import toast from '@/utils/toast'
+import { normalizeImageUrl } from '@/lib/utils'
+import { useState, useEffect, useRef } from 'react'
+import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@/components/ui/card'
+import { Label } from '@/components/ui/label'
+import { Input } from '@/components/ui/input'
+import { Button } from '@/components/ui/button'
+import { Textarea } from '@/components/ui/textarea'
+import { Save, User, Image, Plus, X, Upload } from 'lucide-react'
+import { get, post, apiUrl } from '@/api/client'
+import { getAdminToken } from '@/api/auth'
+
+interface StatItem {
+ label: string
+ value: string
+}
+
+interface AuthorConfig {
+ name: string
+ avatar: string
+ avatarImg: string
+ title: string
+ bio: string
+ stats: StatItem[]
+ highlights: string[]
+}
+
+const DEFAULT: AuthorConfig = {
+ name: '卡若',
+ avatar: 'K',
+ avatarImg: '',
+ title: 'Soul派对房主理人 · 私域运营专家',
+ bio: '每天早上6点到9点，在Soul派对房分享真实的创业故事。专注私域运营与项目变现，用"云阿米巴"模式帮助创业者构建可持续的商业体系。',
+ stats: [
+ { label: '商业案例', value: '62' },
+ { label: '连续直播', value: '365天' },
+ { label: '派对分享', value: '1000+' },
+ ],
+ highlights: [
+ '5年私域运营经验',
+ '帮助100+品牌从0到1增长',
+ '连续创业者，擅长商业模式设计',
+ ],
+}
+
+function parseStats(v: unknown): StatItem[] {
+ if (!Array.isArray(v)) return DEFAULT.stats
+ return v.map((x) => {
+ if (x && typeof x === 'object' && 'label' in x && 'value' in x) {
+ return { label: String(x.label), value: String(x.value) }
+ }
+ return { label: '', value: '' }
+ }).filter((s) => s.label || s.value)
+}
+
+function parseHighlights(v: unknown): string[] {
+ if (!Array.isArray(v)) return DEFAULT.highlights
+ return v.map((x) => (typeof x === 'string' ? x : String(x ?? ''))).filter(Boolean)
+}
+
+export function AuthorSettingsPage() {
+ const [config, setConfig] = useState
+
+
+ {/* 1. Authentication */}
+ API 接口文档
++ 内容管理相关接口 · RESTful · 基础路径 /api · 管理端需 Bearer Token +
++ 管理端仅使用 /api/admin/*、/api/db/*；小程序使用 /api/miniprogram/*。完整实现见 soul-api 源码。 +
+加载中...
+
+ return (
+
+
+
+
+
+
+
+
+
+
+
+ + 配置小程序「关于作者」页展示的作者信息，包括头像、简介、统计数据与亮点标签。 +
+
+
+
+
+
+
+ 作者姓名、头像、头衔与个人简介，将展示在「关于作者」页顶部。
+
+
+
+
+
+
+
+ setConfig((prev) => ({ ...prev, name: e.target.value }))}
+ placeholder="卡若"
+ />
+
+
+
+ setConfig((prev) => ({ ...prev, avatar: e.target.value.slice(0, 1) || 'K' }))}
+ placeholder="K"
+ />
+
+
+
+
+
+ setConfig((prev) => ({ ...prev, avatarImg: e.target.value }))}
+ placeholder="上传或粘贴 URL，如 /uploads/avatars/xxx.png"
+ />
+
+
+
+ {config.avatarImg && (
+
+ )
+
+ )}
+
+
+ setConfig((prev) => ({ ...prev, title: e.target.value }))}
+ placeholder="Soul派对房主理人 · 私域运营专家"
+ />
+
+
+
+