/** * 虎牙外部单协作台账(`/huya/collab`)— 替代 Excel 多人协同表。 * * 设计:`docs/设计-虎牙外部CK协作台账.md`。三条要点: * 1. **一行 = 一单 = 一个外部虎牙 CK**,所有人共享同一张表,改动靠审计留痕; * 2. **绑定账号 / 绑定角色**来自「验证 CK」的只读探针快照(人工不可编辑,每次验证覆盖); * 3. **内联编辑必须带 `expected_version`**:别人先改过会 409,绝不静默覆盖(Excel 最痛的点)。 */ import { useCallback, useEffect, useMemo, useRef, useState } from 'react'; import { Alert, App, AutoComplete, Button, Card, Checkbox, Col, Descriptions, Divider, Drawer, Dropdown, Empty, Form, Image, Input, Modal, Popconfirm, Popover, Progress, Radio, Row, Select, Space, Statistic, Switch, Table, Tag, Timeline, Tooltip, Typography, Upload, } from 'antd'; import type { TableProps } from 'antd'; import { CheckCircleOutlined, CloudUploadOutlined, CopyOutlined, DeleteOutlined, EditOutlined, FileExcelOutlined, LinkOutlined, PlusOutlined, ReloadOutlined, SafetyCertificateOutlined, ShopOutlined, StopOutlined, SwapOutlined, SyncOutlined, UndoOutlined, } from '@ant-design/icons'; import { fileApi, huyaApi, type HuyaCollabAuditItem, type HuyaCollabCkExportResult, type HuyaCollabCkPreview, type HuyaCollabGift, type HuyaCollabImageSlot, type HuyaCollabMetric, type HuyaCollabOrder, type HuyaCollabOrderQuery, type HuyaCollabOrderUpdate, type HuyaCollabOwner, type HuyaCollabShop, type HuyaCollabStatus, type HuyaCollabSummary, } from '../api/modules'; import HuyaCollabShopModal from '../components/HuyaCollabShopModal'; import HuyaCollabShopPicker from '../components/HuyaCollabShopPicker'; import HuyaCollabHomeImageUploader from '../components/HuyaCollabHomeImageUploader'; import { message } from '../utils/antdMessage'; import { getErrorMessage } from '../utils/error'; import { copyTextToClipboard } from '../utils/clipboard'; import { usePermissions } from '../hooks/usePermissions'; import { useCollabRealtime, type CollabRealtimeEvent } from '../hooks/useCollabRealtime'; const { Text, Paragraph } = Typography; function hasTextInputFocus(): boolean { const active = document.activeElement; return ( active instanceof HTMLElement && (active.tagName === 'INPUT' || active.tagName === 'TEXTAREA' || active.isContentEditable) ); } const STATUS_META: Record = { pending: { label: '待处理', color: 'default' }, // 人工核对过「探针读到的绑定角色」与「主页截图」一致 bound: { label: '已确认绑定', color: 'blue' }, recharged: { label: '已充值', color: 'geekblue' }, scripted: { label: '已上脚本', color: 'purple' }, // 抢购成功(枚举值仍是 done):从「已上脚本」查到兑换记录 → 自动进这一步 done: { label: '抢购成功', color: 'success' }, // 旁路终态:抢购后查兑换记录没查到这一单的礼包(枚举值仍是 failed) failed: { label: '抢购失败', color: 'red' }, void: { label: '已作废', color: 'error' }, }; /** 判定结论的配色(生命周期时间线用):与「业务状态名」分开,这里说的是"兑换记录里查到没有" */ const VERDICT_META: Record = { success: { label: '兑换成功', color: 'success' }, failed: { label: '兑换失败', color: 'error' }, unknown: { label: '无法判定', color: 'default' }, }; /** 「改状态」能选的目标(顺序 = 业务流程顺序,回退要显式勾选) */ const STATUS_ORDER_OPTIONS: { value: HuyaCollabStatus; label: string }[] = [ { value: 'pending', label: '待处理' }, { value: 'bound', label: '已确认绑定' }, { value: 'recharged', label: '已充值' }, { value: 'scripted', label: '已上脚本' }, { value: 'done', label: '抢购成功' }, { value: 'failed', label: '抢购失败' }, { value: 'void', label: '已作废' }, ]; /** 「回退」能选的目标:只在流程链里选(要进「已作废 / 抢购失败」走「改状态」或「作废」入口) */ const FLOW_STATUS_OPTIONS = STATUS_ORDER_OPTIONS.filter( (option) => option.value !== 'failed' && option.value !== 'void', ); const CK_META: Record = { unverified: { label: '未验证', color: 'default' }, valid: { label: '有效', color: 'success' }, invalid: { label: '已失效', color: 'error' }, disabled: { label: '已停用', color: 'warning' }, }; const ACTION_LABELS: Record = { 'huya:collab:create': '新建', 'huya:collab:update': '编辑', 'huya:collab:status': '状态变更', 'huya:collab:ck': 'CK 变更', 'huya:collab:ck_status': 'CK 验证', 'huya:collab:probe_snapshot': '绑定快照刷新', 'huya:collab:image': '图片变更', 'huya:collab:delete': '删除', }; const SLOT_META: Record = { // 绑定图不再人工上传:绑定关系由探针自动读(2026-10-16 用户拍板),只留老数据只读展示 bind_images: { label: '历史绑定图', keysKey: 'bind_images' }, home_images: { label: '主页截图', keysKey: 'home_images' }, }; const IMPORT_PREVIEW_ROWS = 20; // 「记住最近选的礼包」的本地存储键(同一个礼包连开几单时不用反复选) const LAST_GIFT_KEY = 'huya.collab.lastGift'; // 「礼包列表」的本地缓存键:一个活动期间就那一批礼包,没必要每贴一份 CK 都去虎牙拉一次; // 要更新就点「强制刷新礼包」(活动换 SID 后必点一次)。 const GIFTS_CACHE_KEY = 'huya.collab.gifts'; const MAX_IMAGES_PER_SLOT = 20; /** 读礼包缓存(读不到 / 解析坏 / 空列表都当没缓存) */ function readGiftCache(): { gifts: HuyaCollabGift[]; at: number } | null { try { const raw = window.localStorage.getItem(GIFTS_CACHE_KEY); if (!raw) return null; const parsed = JSON.parse(raw) as { at?: number; gifts?: HuyaCollabGift[] }; const gifts = Array.isArray(parsed.gifts) ? parsed.gifts : []; if (gifts.length === 0) return null; return { gifts, at: Number(parsed.at) || 0 }; } catch { return null; } } /** 写礼包缓存:写不进去(隐私模式 / 配额满)也不影响功能,静静跳过 */ function writeGiftCache(gifts: HuyaCollabGift[]): void { try { window.localStorage.setItem(GIFTS_CACHE_KEY, JSON.stringify({ at: Date.now(), gifts })); } catch { // 忽略:缓存只是体验优化 } } function formatTime(value: string | null | undefined): string { if (!value) return '-'; const time = new Date(value); return Number.isNaN(time.getTime()) ? String(value) : time.toLocaleString(); } /** 点开即改、失焦提交(回车=失焦提交,Esc=放弃) */ function EditableText({ value, disabled, placeholder, onCommit, }: { value: string; disabled?: boolean; placeholder?: string; onCommit: (next: string) => void; }) { const [editing, setEditing] = useState(false); const [draft, setDraft] = useState(value); useEffect(() => { setDraft(value); setEditing(false); }, [value]); if (!editing || disabled) { return (
{ if (!disabled) setEditing(true); }} // wordBreak:礼品名 / 角色名里偶发的一长串不带空格的字符也不会顶穿这一列 style={{ cursor: disabled ? 'default' : 'text', minHeight: 22, wordBreak: 'break-word' }} title={disabled ? undefined : '点击编辑'} > {value || {placeholder || '—'}}
); } return ( setDraft(event.target.value)} onBlur={() => { setEditing(false); if (draft !== value) onCommit(draft); }} onPressEnter={(event) => event.currentTarget.blur()} onKeyDown={(event) => { if (event.key === 'Escape') { setDraft(value); setEditing(false); event.currentTarget.blur(); } }} /> ); } /** 两个图片槽位(object_key 数组,第一张是封面) */ function ImageSlotEditor({ order, slot, canEdit, busy, onUpload, onRemove, onSetCover, }: { order: HuyaCollabOrder; slot: HuyaCollabImageSlot; canEdit: boolean; busy: boolean; onUpload: (slot: HuyaCollabImageSlot, file: File) => void; onRemove: (slot: HuyaCollabImageSlot, key: string) => void; onSetCover: (slot: HuyaCollabImageSlot, key: string) => void; }) { const keys = slot === 'bind_images' ? order.bind_images : order.home_images; const urls = slot === 'bind_images' ? order.bind_image_urls : order.home_image_urls; const thumbs = slot === 'bind_images' ? order.bind_image_thumb_urls : order.home_image_thumb_urls; const full = keys.length >= MAX_IMAGES_PER_SLOT; return ( {keys.length === 0 && 还没有图} {keys.length > 0 && ( {keys.map((key, index) => (
{`${SLOT_META[slot].label}${index {index === 0 && ( 封面 )}
{canEdit && ( {index !== 0 && ( )}
); } export default function HuyaCollabPage() { const { modal } = App.useApp(); const { can, user } = usePermissions(); const canEdit = can('huya:collab:edit'); const canManage = can('huya:collab:manage'); // 导出 CK 是把凭据带出系统,单独一个权限点(默认只给运营,见 permissions.py) const canExportCk = can('huya:collab:ck_export'); const [rows, setRows] = useState([]); const [total, setTotal] = useState(0); const [page, setPage] = useState(1); const [pageSize, setPageSize] = useState(50); const [loading, setLoading] = useState(false); const [busy, setBusy] = useState(false); const [summary, setSummary] = useState(null); const [owners, setOwners] = useState([]); const [shops, setShops] = useState([]); const [giftNames, setGiftNames] = useState([]); const [shopModalOpen, setShopModalOpen] = useState(false); const [filters, setFilters] = useState({ include_void: false }); const [realtimePending, setRealtimePending] = useState(false); const [selectedIds, setSelectedIds] = useState([]); const [detail, setDetail] = useState(null); const [timeline, setTimeline] = useState([]); const [timelineLoading, setTimelineLoading] = useState(false); const [detailForm] = Form.useForm(); const [createOpen, setCreateOpen] = useState(false); const [createForm] = Form.useForm>(); const [ckPreview, setCkPreview] = useState(null); const [previewing, setPreviewing] = useState(false); // 这次预览有没有带「拉礼包」(没有就是纯探针 + 用本地礼包缓存),只影响提示文案 const [previewPullsGifts, setPreviewPullsGifts] = useState(false); const ckReady = !!ckPreview?.ok && !!ckPreview?.has_role; // 礼包列表:优先用浏览器缓存那份 —— 有数据就不去虎牙拉,要更新点「强制刷新礼包」。 // 直接拿缓存做初值(而不是等 useEffect):贴第一份 CK 时就已经有数据了,不会白拉一次。 const [giftOptions, setGiftOptions] = useState( () => readGiftCache()?.gifts ?? [], ); const [giftsCachedAt, setGiftsCachedAt] = useState( () => readGiftCache()?.at ?? null, ); const giftsRef = useRef(giftOptions); // 记忆里的礼包不在「这次拉到的列表」里时的提示(会顺手清空,免得提交一个拉不到的礼包名) const [giftHint, setGiftHint] = useState(''); const [importOpen, setImportOpen] = useState(false); const [importText, setImportText] = useState(''); const [importing, setImporting] = useState(false); const [importResult, setImportResult] = useState<{ created: number; updated: number; skipped: number; errors: { line: number; order_no: string; message: string }[]; } | null>(null); const [ckTarget, setCkTarget] = useState<{ order: HuyaCollabOrder; text: string } | null>(null); // 单行状态弹窗:set=人工往前切(可跳步)/ rollback=回退 / void=作废 const [statusAction, setStatusAction] = useState<{ order: HuyaCollabOrder; mode: 'void' | 'rollback' | 'set'; target?: HuyaCollabStatus; } | null>(null); const [statusReason, setStatusReason] = useState(''); const [rollbackTarget, setRollbackTarget] = useState('pending'); // 批量改状态(勾选多行一次切) const [batchStatusOpen, setBatchStatusOpen] = useState(false); const [batchStatusTarget, setBatchStatusTarget] = useState('bound'); const [batchStatusReason, setBatchStatusReason] = useState(''); const [batchStatusRollback, setBatchStatusRollback] = useState(false); // 积分 / 兑换记录(「账号全生命周期」) const [querying, setQuerying] = useState(false); const [metrics, setMetrics] = useState([]); const [metricsLoading, setMetricsLoading] = useState(false); // 勾选导出 CK(明文只在这一个弹窗里出现;复制走剪贴板) const [ckExportOpen, setCkExportOpen] = useState(false); const [ckExporting, setCkExporting] = useState(false); const [ckExport, setCkExport] = useState(null); const [ckExportFormat, setCkExportFormat] = useState<'plain' | 'with_order'>('plain'); const load = useCallback(async (options?: { silent?: boolean; withMeta?: boolean }) => { const silent = options?.silent === true; const withMeta = options?.withMeta !== false; if (!silent) setLoading(true); try { const [list, nextSummary, nextOwners, nextShops, nextGiftNames] = await Promise.all([ huyaApi.listCollabOrders({ ...filters, page, page_size: pageSize }), huyaApi.collabOrdersSummary(), withMeta ? huyaApi.collabOrderOwners() : Promise.resolve(null), withMeta ? huyaApi.listCollabShops() : Promise.resolve(null), withMeta ? huyaApi.collabOrderGifts() : Promise.resolve(null), ]); setRows(list.items); setTotal(list.total); setSummary(nextSummary); if (nextOwners) setOwners(nextOwners); if (nextShops) setShops(nextShops); if (nextGiftNames) setGiftNames(nextGiftNames); // 选中是「当前页」的概念:刷新后剔除已经不在这页上的行,避免点到别人的脏 id。 setSelectedIds((ids) => ids.filter((id) => list.items.some((row) => row.id === id))); } catch (e: unknown) { message.error(getErrorMessage(e)); } finally { setLoading(false); } }, [filters, page, pageSize]); useEffect(() => { void load(); }, [load]); const realtimeEnabled = can('huya:collab:view'); const collabModalOpen = Boolean( createOpen || detail || statusAction || batchStatusOpen || ckTarget || ckExportOpen || shopModalOpen, ); const handleRealtimeInvalidate = useCallback((event: CollabRealtimeEvent) => { if (!realtimeEnabled) return; if (collabModalOpen || hasTextInputFocus()) { setRealtimePending(true); return; } void load({ silent: true, withMeta: event.scope !== 'orders' }); }, [realtimeEnabled, collabModalOpen, load]); const { connected: realtimeConnected, reconnecting: realtimeReconnecting, } = useCollabRealtime({ enabled: realtimeEnabled, onInvalidate: handleRealtimeInvalidate, }); useEffect(() => { if (!realtimePending || collabModalOpen) return undefined; let cancelled = false; const flush = () => { if (cancelled || collabModalOpen || hasTextInputFocus()) return; setRealtimePending(false); void load({ silent: true, withMeta: true }); }; const timer = window.setTimeout(flush, 300); const handleFocusOut = () => window.setTimeout(flush, 0); window.addEventListener('focusout', handleFocusOut); return () => { cancelled = true; window.clearTimeout(timer); window.removeEventListener('focusout', handleFocusOut); }; }, [realtimePending, collabModalOpen, load]); // WebSocket 断开时用低频轮询兜底;连接正常时完全不轮询。 useEffect(() => { if (!realtimeEnabled || realtimeConnected) return undefined; const timer = window.setInterval(() => { if (document.visibilityState !== 'visible' || collabModalOpen) return; void load({ silent: true, withMeta: false }); }, 30_000); return () => window.clearInterval(timer); }, [realtimeEnabled, realtimeConnected, collabModalOpen, load]); const applyUpdated = useCallback((updated: HuyaCollabOrder) => { setRows((list) => list.map((row) => (row.id === updated.id ? updated : row))); setDetail((current) => (current && current.id === updated.id ? updated : current)); }, []); const previewTimer = useRef(null); // 预览请求序号:贴了新 CK 之后,旧请求迟到回来的结论一律丢掉(否则会显示上一份 CK 的"有效") const previewSeq = useRef(0); useEffect(() => { giftsRef.current = giftOptions; }, [giftOptions]); const emptyPreview = useCallback( (message: string): HuyaCollabCkPreview => ({ ok: false, message, uid: '', yyuid: '', hy_username: '', ck_status: 'invalid', bind_game_account: '', bind_game_role: '', bind_game_channel: '', has_role: false, gifts: [], gifts_message: '', uid_used_by: [], }), [], ); /** 跑一次预览(探针 + 可选拉礼包),只读,不写库 */ const runCkPreview = useCallback( async (text: string, withGifts: boolean) => { const seq = previewSeq.current; try { const preview = await huyaApi.previewCollabCk(text, withGifts); if (seq !== previewSeq.current) return; // 已经贴了新的 CK,旧结论丢掉 setCkPreview(preview); if (preview.gifts.length > 0) { // 真拉到列表了(首次或强制刷新):更新浏览器缓存,接下来几单直接用 setGiftOptions(preview.gifts); setGiftsCachedAt(Date.now()); writeGiftCache(preview.gifts); } if (preview.ok && preview.has_role) { message.success(`CK 有效:绑定角色 ${preview.bind_game_role}`); // 「记住的礼包」如果不在当前列表里就清掉重选;列表为空时不动它(允许手填) const options = preview.gifts.length > 0 ? preview.gifts : giftsRef.current; const picked = String(createForm.getFieldValue('gift_name') ?? '').trim(); if (picked && options.length > 0 && !options.some((gift) => gift.name === picked)) { createForm.setFieldValue('gift_name', undefined); setGiftHint(`上次选的「${picked}」不在当前的礼包列表里,已清空,请重新点选`); } else { setGiftHint(''); } } } catch (e: unknown) { if (seq !== previewSeq.current) return; setCkPreview(emptyPreview(getErrorMessage(e))); } finally { if (seq === previewSeq.current) setPreviewing(false); } }, [emptyPreview, createForm], ); /** * 输入 CK 后防抖预览;改动了就先作废旧结论(避免拿旧的"有效"去提交)。 * * ``forceGifts=true``(点了「强制刷新礼包」)才重新去虎牙拉列表;否则**本地有数据就用本地的** —— * 一个活动期间礼包清单基本不变,每次贴 CK 都拉一遍纯属白挨接口。 */ const scheduleCkPreview = useCallback( (ckText: string, immediate = false, forceGifts = false) => { if (previewTimer.current) window.clearTimeout(previewTimer.current); const text = (ckText || '').trim(); previewSeq.current += 1; // 无论跑不跑,都让在途请求作废 if (!text) { setCkPreview(null); setPreviewing(false); return; } setCkPreview(null); setPreviewing(true); // 有缓存(giftsRef 非空)就不带 with_gifts,只有没数据或用户强制刷新才真去拉 const withGifts = forceGifts || giftsRef.current.length === 0; setPreviewPullsGifts(withGifts); previewTimer.current = window.setTimeout( () => void runCkPreview(text, withGifts), immediate ? 0 : 600, ); }, [runCkPreview], ); /** 勾选多行一次改状态(往前可跳步;回退要在弹窗里勾「回退」) */ const submitBatchStatus = async () => { setBusy(true); try { const result = await huyaApi.batchUpdateCollabOrderStatus({ ids: selectedIds, status: batchStatusTarget, reason: batchStatusReason, rollback: batchStatusRollback, }); const failures = result.results.filter((item) => !item.ok); if (failures.length === 0) { message.success(`已把 ${result.updated} 条改成「${result.target_label}」`); } else { modal.info({ title: `改状态完成:成功 ${result.updated} / 未通过 ${result.failed}(目标「${result.target_label}」)`, width: 640, content: ( {failures.map((item) => ( {item.order_no}:{item.message} ))} ), }); } setBatchStatusOpen(false); setSelectedIds([]); void load(); } catch (e: unknown) { message.error(getErrorMessage(e)); } finally { setBusy(false); } }; /** 查这一单的积分 + 兑换记录(写一条生命周期快照;已上脚本的单会按结果自动改状态) */ const queryActivityOne = async (row: HuyaCollabOrder) => { setQuerying(true); try { const result = await huyaApi.queryCollabOrderActivity(row.id); message[result.verdict === 'success' ? 'success' : result.verdict === 'failed' ? 'warning' : 'info']( `${row.order_no}:${result.verdict_label} · ${result.message}` + (result.auto_status ? `;状态已自动改为「${result.auto_status_label}」` : ''), ); void load(); if (detail?.id === row.id) { await openDetail(await huyaApi.getCollabOrder(row.id)); } } catch (e: unknown) { message.error(getErrorMessage(e)); } finally { setQuerying(false); } }; /** 勾选批量查询(串行带间隔,防风控) */ const queryActivitySelected = async () => { if (selectedIds.length === 0) return; setQuerying(true); try { const result = await huyaApi.batchQueryCollabOrderActivity(selectedIds); modal.info({ title: `查询完成:成功 ${result.success} / 失败 ${result.failed} / 无法判定 ${result.unknown}` + (result.auto_changed ? `(${result.auto_changed} 条按结果自动改状态)` : ''), width: 760, content: ( {result.results.map((item) => ( {item.order_no}:{item.verdict_label} · {item.message} {item.auto_status ? `;状态已改为「${item.auto_status_label}」` : ''} ))} ), }); void load(); } catch (e: unknown) { message.error(getErrorMessage(e)); } finally { setQuerying(false); } }; /** 详情里的「账号全生命周期」时间线 */ const loadMetrics = async (orderId: number) => { setMetrics([]); setMetricsLoading(true); try { setMetrics(await huyaApi.collabOrderMetrics(orderId)); } catch (e: unknown) { message.error(getErrorMessage(e)); } finally { setMetricsLoading(false); } }; /** * 勾选导出 CK:先把明文拉回来(后端逐行写审计),再让用户复制。 * * 明文只活在这次弹窗的 state 里:不进 localStorage、不写 URL、 * 关掉弹窗就清掉(`closeCkExport()`)。 */ const openCkExport = async () => { if (selectedIds.length === 0) return; setCkExporting(true); try { const result = await huyaApi.exportCollabOrderCk(selectedIds); setCkExport(result); setCkExportOpen(true); } catch (e: unknown) { message.error(getErrorMessage(e)); } finally { setCkExporting(false); } }; const closeCkExport = () => { setCkExportOpen(false); setCkExport(null); }; /** 导出文本:默认每行一份纯 CK(直接粘),也可以带上订单号(多选时好对号) */ const ckExportText = useMemo(() => { if (!ckExport) return ''; return ckExport.items .map((item) => ( ckExportFormat === 'with_order' ? `${item.order_no}\t${item.ck_text}` : item.ck_text )) .join('\n'); }, [ckExport, ckExportFormat]); // 已失效 / 已停用的 CK 照样导出(用户可能就是要看它),但得在界面上点名 const ckExportRisky = useMemo( () => (ckExport?.items ?? []).filter( (item) => item.ck_status === 'invalid' || item.ck_status === 'disabled', ), [ckExport], ); const copyCkExport = async () => { if (!ckExport?.exported) return; try { await copyTextToClipboard(ckExportText); message.success(`已复制 ${ckExport.exported} 份 CK 到剪贴板`); } catch (e: unknown) { // 复制失败别吞:明文就在下面的框里,让人手动选中复制 message.error(`复制失败:${getErrorMessage(e)}(可以在下面的框里手动选中复制)`); } }; const patchOrder = async (row: HuyaCollabOrder, payload: HuyaCollabOrderUpdate) => { try { const updated = await huyaApi.updateCollabOrder(row.id, { ...payload, expected_version: row.version }); applyUpdated(updated); message.success('已保存'); } catch (e: unknown) { message.error(getErrorMessage(e)); void load(); } }; const openDetail = async (row: HuyaCollabOrder) => { setDetail(row); detailForm.setFieldsValue({ order_no: row.order_no, shop: row.shop, owner_id: row.owner_id, gift_name: row.gift_name, remark: row.remark, }); setTimeline([]); setTimelineLoading(true); void loadMetrics(row.id); try { setTimeline(await huyaApi.collabOrderTimeline(row.id)); } catch (e: unknown) { message.error(getErrorMessage(e)); } finally { setTimelineLoading(false); } }; /** 打开「同一买家的另一单」:先按 id 取最新数据,再复用详情抽屉 */ const openSiblingOrder = async (id: number) => { try { await openDetail(await huyaApi.getCollabOrder(id)); } catch (e: unknown) { message.error(getErrorMessage(e)); } }; const verifyOne = async (row: HuyaCollabOrder) => { setBusy(true); try { const updated = await huyaApi.verifyCollabOrder(row.id); applyUpdated(updated); if (updated.ck_status === 'valid') { message.success( updated.bind_game_role ? `CK 有效:绑定角色 ${updated.bind_game_role}` : 'CK 有效', ); } else { message.warning(updated.ck_check_message || 'CK 验证未通过'); } void load(); } catch (e: unknown) { message.error(getErrorMessage(e)); } finally { setBusy(false); } }; const verifySelected = async () => { if (selectedIds.length === 0) return; setBusy(true); try { const result = await huyaApi.verifyCollabOrders(selectedIds); const failures = result.results.filter((item) => !item.ok); if (failures.length === 0) { message.success(`验证完成:${result.valid} 条全部有效`); } else { modal.info({ title: `验证完成:有效 ${result.valid} / 未通过 ${result.failed}`, width: 640, content: ( {failures.map((item) => ( {item.order_no}:{item.message} ))} ), }); } setSelectedIds([]); void load(); } catch (e: unknown) { message.error(getErrorMessage(e)); } finally { setBusy(false); } }; const advance = async (row: HuyaCollabOrder) => { if (!row.next_status) return; setBusy(true); try { applyUpdated(await huyaApi.updateCollabOrderStatus(row.id, { status: row.next_status, expected_version: row.version, })); message.success(`已标记为「${STATUS_META[row.next_status].label}」`); void load(); } catch (e: unknown) { message.error(getErrorMessage(e)); void load(); } finally { setBusy(false); } }; /** * 单行状态弹窗的提交(三种模式共用): * - `void`:作废(必须填原因); * - `rollback`:回退到选定状态(`rollback=true`,会清掉后面阶段的时间戳); * - `set`:人工往前切,允许跳步(如 待处理 → 已上脚本),不用勾回退。 */ const submitStatusAction = async () => { if (!statusAction) return; const { order, mode, target } = statusAction; const nextStatus: HuyaCollabStatus = mode === 'void' ? 'void' : (target ?? rollbackTarget); // 服务层对「作废」一律要求原因(不管从哪个入口进来的) if (nextStatus === 'void' && !statusReason.trim()) { message.warning('作废必须填原因'); return; } setBusy(true); try { applyUpdated(await huyaApi.updateCollabOrderStatus(order.id, { status: nextStatus, reason: statusReason, rollback: mode === 'rollback', expected_version: order.version, })); message.success( mode === 'void' ? '已作废' : mode === 'rollback' ? '已回退' : `已改为「${STATUS_META[nextStatus].label}」`, ); setStatusAction(null); setStatusReason(''); void load(); } catch (e: unknown) { message.error(getErrorMessage(e)); } finally { setBusy(false); } }; const submitCk = async (action: 'paste' | 'rebuild') => { if (!ckTarget) return; if (action === 'paste' && !ckTarget.text.trim()) { message.warning('请先贴一份 CK'); return; } setBusy(true); try { const updated = await huyaApi.updateCollabOrderCk(ckTarget.order.id, { ck_text: ckTarget.text, action, expected_version: ckTarget.order.version, }); applyUpdated(updated); message.success(action === 'rebuild' ? '已从 App 原始凭据重建' : 'CK 已保存,待验证'); setCkTarget(null); } catch (e: unknown) { message.error(getErrorMessage(e)); } finally { setBusy(false); } }; const toggleCkDisabled = async (row: HuyaCollabOrder) => { const next = row.ck_status === 'disabled' ? 'unverified' : 'disabled'; setBusy(true); try { const updated = await huyaApi.updateCollabOrderCkStatus(row.id, { status: next, message: next === 'disabled' ? '人工停用' : '人工恢复,待验证', expected_version: row.version, }); applyUpdated(updated); message.success(next === 'disabled' ? '已停用这份 CK' : '已恢复(待验证)'); void load(); } catch (e: unknown) { message.error(getErrorMessage(e)); } finally { setBusy(false); } }; const removeOrder = async (row: HuyaCollabOrder) => { setBusy(true); try { await huyaApi.deleteCollabOrder(row.id); message.success(`已删除订单 ${row.order_no}`); if (detail?.id === row.id) setDetail(null); void load(); } catch (e: unknown) { message.error(getErrorMessage(e)); } finally { setBusy(false); } }; const commitSlot = async (row: HuyaCollabOrder, slot: HuyaCollabImageSlot, keys: string[]) => { const updated = await huyaApi.updateCollabOrderImages(row.id, { slot, images: keys, expected_version: row.version, }); applyUpdated(updated); }; const uploadImage = async (row: HuyaCollabOrder, slot: HuyaCollabImageSlot, file: File) => { setBusy(true); try { const uploaded = await fileApi.upload(file, 'collab'); const current = slot === 'bind_images' ? row.bind_images : row.home_images; await commitSlot(row, slot, [...current, uploaded.object_key]); message.success('图片已上传'); } catch (e: unknown) { message.error(getErrorMessage(e)); void load(); } finally { setBusy(false); } }; const removeImage = async (row: HuyaCollabOrder, slot: HuyaCollabImageSlot, key: string) => { setBusy(true); try { const current = slot === 'bind_images' ? row.bind_images : row.home_images; await commitSlot(row, slot, current.filter((item) => item !== key)); message.success('已从这一行移除'); } catch (e: unknown) { message.error(getErrorMessage(e)); } finally { setBusy(false); } }; const setCoverImage = async (row: HuyaCollabOrder, slot: HuyaCollabImageSlot, key: string) => { setBusy(true); try { const current = slot === 'bind_images' ? row.bind_images : row.home_images; await commitSlot(row, slot, [key, ...current.filter((item) => item !== key)]); message.success('已设为封面'); } catch (e: unknown) { message.error(getErrorMessage(e)); } finally { setBusy(false); } }; const submitCreate = async () => { if (!ckReady) { message.warning('这份 CK 没通过验证(或读不到绑定角色),不能提交'); return; } try { const values = await createForm.validateFields(); const created = await huyaApi.createCollabOrder({ order_no: String(values.order_no ?? '').trim(), shop: String(values.shop ?? ''), ck_text: String(values.ck_text ?? ''), // 「绑定斗鱼号」不再录入:绑了谁由探针读(bind_game_*),人工那一列已下线 gift_name: String(values.gift_name ?? ''), home_images: (values.home_images as string[] | undefined) ?? [], remark: String(values.remark ?? ''), require_verified: true, // 服务端再校验一次:CK 必须读到绑定角色才让建 }); if (created.gift_name) window.localStorage.setItem(LAST_GIFT_KEY, created.gift_name); message.success(`已新建 ${created.order_no}`); setCreateOpen(false); setCkPreview(null); setGiftHint(''); createForm.resetFields(); void load(); } catch (e: unknown) { if (e instanceof Error) message.error(getErrorMessage(e)); } }; const submitImport = async () => { if (!importText.trim()) { message.warning('请先粘贴表格内容'); return; } setImporting(true); try { const result = await huyaApi.importCollabOrders(importText); setImportResult(result); message.success(`导入完成:新建 ${result.created} / 更新 ${result.updated} / 跳过 ${result.skipped}`); void load(); } catch (e: unknown) { message.error(getErrorMessage(e)); } finally { setImporting(false); } }; /** 导入弹窗里的本地预览(后端还会再解析一次,这里只是让人确认列没串) */ const importPreview = useMemo(() => { const lines = importText.split('\n').map((line) => line.replace(/\r$/, '')).filter((line) => line.trim()); const cells = lines.map((line) => (line.includes('\t') ? line.split('\t') : line.split(','))); return { header: cells[0] ?? [], rows: cells.slice(1, IMPORT_PREVIEW_ROWS + 1), total: Math.max(0, cells.length - 1), }; }, [importText]); const ownerOptions = owners.map((owner) => ({ value: owner.id, label: owner.username })); // 筛选里的店铺也是点选(含停用店铺:历史订单还在用它们) const finished = summary ? (summary.by_status.done ?? 0) : 0; // 礼包来源提示:这次真去虎牙拉了就说拉了,用的是缓存就把缓存时间摆出来(让人知道要不要点强制刷新) const giftCacheLabel = giftsCachedAt ? formatTime(new Date(giftsCachedAt).toISOString()) : ''; const giftSourceText = ckPreview?.gifts?.length ? ckPreview.gifts_message : giftOptions.length > 0 ? `礼包用本地缓存(${giftOptions.length} 个${giftCacheLabel ? ` · ${giftCacheLabel}` : ''}),要更新点「强制刷新礼包」` : (ckPreview?.gifts_message || ''); const columns: TableProps['columns'] = [ { title: '序号', width: 70, fixed: 'left', align: 'center', render: (_, __, index) => ( // 跨页连续:第 2 页第 1 行 = pageSize + 1 {(page - 1) * pageSize + index + 1} ), }, { title: '订单编号', dataIndex: 'order_no', width: 170, fixed: 'left', render: (value: string, row) => ( {value} {row.status === 'void' && 已作废:{row.void_reason || '-'}} ), }, { title: '店铺', dataIndex: 'shop', width: 120, render: (value: string, row) => ( { if (next !== value) void patchOrder(row, { shop: next }); }} /> } > ), }, { title: '负责人', dataIndex: 'owner_id', width: 130, render: (value: number | null, row) => ( { setPage(1); setFilters((prev) => ({ ...prev, owner_id: value ?? null })); }} /> ({ value: key, label: meta.label }))} value={filters.ck_status || undefined} onChange={(value?: string) => { setPage(1); setFilters((prev) => ({ ...prev, ck_status: value })); }} /> )} 主页截图(第一张是封面) void uploadImage(detail, targetSlot, file)} onRemove={(targetSlot, key) => void removeImage(detail, targetSlot, key)} onSetCover={(targetSlot, key) => void setCoverImage(detail, targetSlot, key)} /> {detail.bind_images.length > 0 && ( // 老数据只读展示:绑定图已停用,但已经传过的图不该从界面上凭空消失 <> 历史绑定图(只读,已停用 —— 绑定关系改由「验证 CK」的探针读取) {detail.bind_images.map((key, index) => ( {`历史绑定图${index ))} )} {canEdit && ( {detail.next_status && ( )} {detail.status !== 'void' && ( )} )} 操作时间线 {timeline.length === 0 && !timelineLoading && } ({ color: item.success === false ? 'red' : 'blue', children: ( {ACTION_LABELS[item.action] || item.action} · {item.username || '-'} {formatTime(item.created_at)} {item.detail && ( {item.detail} )} ), }))} /> 账号全生命周期(积分 / 兑换记录) {canEdit && ( )} 每次查询都会追加一条快照(只追加、不修改);「已上脚本」的单会按结论自动改成「抢购成功」或「抢购失败」。 {!detail.has_cookie && ( 这单还没贴 CK,查不了积分 / 兑换记录。 )} {metrics.length === 0 && !metricsLoading && ( )} ({ color: item.verdict === 'success' ? 'green' : item.verdict === 'failed' ? 'red' : 'gray', children: ( {item.verdict_label} 积分 {item.score ?? '-'} 获得 {item.gained_score ?? '-'} / 消耗 {item.used_score ?? '-'} {' · '}兑换记录 {item.records_total} 条(命中 {item.records_matched}) {item.message && ( {item.message} )} {item.matched_preview.length > 0 && ( {item.matched_preview.map((matched, index) => ( {matched.prize_name || '(无礼包名)'} {' '} {matched.status_label} {matched.order_id ? ` · 兑换单 ${matched.order_id}` : ''} {matched.exchange_time ? ` · ${formatTime(new Date(matched.exchange_time * 1000).toISOString())}` : ''} ))} )} {formatTime(item.created_at)} · {item.created_by_name || '系统'} {' · '}{item.source === 'batch' ? '批量查询' : '手动查询'} ), }))} /> )} setCreateOpen(false)} onOk={() => void submitCreate()} confirmLoading={busy} okText="新建" okButtonProps={{ disabled: !ckReady || previewing }} // 内容比一屏高:给个滚动区,别让底部按钮被顶出可视范围 styles={{ body: { maxHeight: '78vh', overflowY: 'auto', paddingRight: 12 } }} destroyOnHidden >
) => { if (typeof changed.ck_text === 'string') scheduleCkPreview(changed.ck_text); }} > {user?.username || '-'}(默认) {/* 店铺独占一行:按钮要够宽才不会被挤到第二行(「新店」跟在同一行后面) */} {/* 高度随内容走:短 CK 就 3 行,别固定 5 行把弹窗撑高 */} {(previewing || ckPreview) && (
{previewing ? ( ) : ckPreview?.ok && ckPreview.has_role ? (
{`订单编号里的账号:${ckPreview.bind_game_account || '-'}` + `(${ckPreview.bind_game_channel || '-'})` + `;虎牙号 ${ckPreview.uid}` + (giftSourceText ? `;${giftSourceText}` : '')}
{ckPreview.uid_used_by.length > 0 && ( // 放开 uid 唯一性后同一份 CK 可以服务多单,这里只提示已经挂在哪些单上
{`这份 CK 的虎牙号已经挂在:${ckPreview.uid_used_by .map((item) => `${item.order_no}(${item.status_label || item.status})`) .join('、')} —— 同一个号服务多单是允许的,照常提交`}
)} } /> ) : ( )}
)} 0 ? `礼包列表缓存于 ${giftCacheLabel}(${giftOptions.length} 个)` : undefined)} validateStatus={giftHint ? 'warning' : undefined} > ({ value: gift.name, label: [ gift.category_name ? `[${gift.category_name}]` : '', gift.name, gift.price ? `· ${gift.price} 积分` : '', gift.remain_text ? `· 剩 ${gift.remain_text}` : '', ].filter(Boolean).join(' '), }))} filterOption={(input, option) => String(option?.value ?? '').toLowerCase().includes(input.toLowerCase())} onChange={(value: string) => { // 记住最近选的礼包:连开几单同一个礼包就不用反复点 setGiftHint(''); if (value) window.localStorage.setItem(LAST_GIFT_KEY, value); }} /> ( value && value.length > 0 ? Promise.resolve() : Promise.reject(new Error('请至少上传 1 张主页截图')) ), }]} >
setImportOpen(false)} onOk={() => void submitImport()} confirmLoading={importing} okText="导入" destroyOnHidden > 列顺序:店铺 / 订单编号 / 负责人 / 绑定斗鱼号 / 礼包 / 备注(首行表头可留)。 已存在的订单号按「更新」处理;单行出错不影响其他行。 setImportText(event.target.value)} placeholder={'佳佳\t2627501604891357\t张三\t用户123\t不朽伊人大礼包\t熟人'} /> {importPreview.rows.length > 0 && ( <> 预览(前 {importPreview.rows.length} 行,共 {importPreview.total} 行) {importPreview.header.length > 1 ? '' : ':未识别到表头,按固定列序解析'} String(index)} pagination={false} scroll={{ x: 700, y: 200 }} dataSource={importPreview.rows.map((cells, index) => ({ index, cells }))} columns={['店铺', '订单编号', '负责人', '绑定斗鱼号', '礼包', '备注'].map((title, columnIndex) => ({ title, dataIndex: ['cells', columnIndex], width: 120, ellipsis: true, render: (value: string | undefined) => value || -, }))} /> )} {importResult && ( 结果:新建 {importResult.created} / 更新 {importResult.updated} / 跳过 {importResult.skipped} {importResult.errors.map((error) => ( 第 {error.line} 行({error.order_no || '无订单号'}):{error.message} ))} )} setCkTarget(null)} footer={[ , , , ]} destroyOnHidden > 贴一份新的外部 CK:支持「纯 CK」或「账号----密码----CK」。保存后状态回到「未验证」, 点「验证 CK」用只读探针确认(探针通不通由服务端说了算)。 setCkTarget((current) => (current ? { ...current, text: event.target.value } : current))} placeholder="udb_uid=...;udb_passport=...;udb_cred=..." /> setStatusAction(null)} onOk={() => void submitStatusAction()} confirmLoading={busy} okButtonProps={{ danger: statusAction?.mode === 'void' }} okText={statusAction?.mode === 'void' ? '作废' : statusAction?.mode === 'set' ? '改状态' : '回退'} destroyOnHidden > {statusAction && statusAction.mode !== 'void' && ( setBatchStatusTarget(value)} options={STATUS_ORDER_OPTIONS} /> setBatchStatusReason(event.target.value)} placeholder={batchStatusTarget === 'void' ? '作废原因(必填)' : '改状态说明(可选)'} /> setBatchStatusRollback(event.target.checked)}> 回退(目标不是「往前」时必须勾选,比如 已上脚本 → 待处理) 逐行独立提交:某一行前置校验没过(例如没主页截图进不了「已确认绑定」)只跳过那一行, 结果会在弹窗里逐条列出来。一次最多 50 行。 关闭, , ]} destroyOnHidden > {ckExport && ckExport.skipped.length > 0 && ( 跳过 {ckExport.skipped.length} 条: {ckExport.skipped.map((item) => `${item.order_no}(${item.reason})`).join(';')} )} {ckExportRisky.length > 0 && ( 其中 {ckExportRisky.length} 条的 CK 已失效 / 已停用: {ckExportRisky.map((item) => `${item.order_no}(${item.ck_status_label})`).join(';')} )} setCkExportFormat(event.target.value)}> 每行一份纯 CK(直接粘) 订单号 + Tab + CK(多选时好对号) 共 {ckExport?.exported ?? 0} 份 · {ckExportText.length} 字符; 关掉这个弹窗就清掉,不会留在页面上。 setShopModalOpen(false)} onChanged={() => void load()} /> ); }