From 6ee5c8ffdba970940bc141200beb9be05760638f Mon Sep 17 00:00:00 2001 From: seaislee1209 Date: Tue, 12 May 2026 18:19:36 +0800 Subject: [PATCH] =?UTF-8?q?feat(records):=20api=5Fprompt=20=E6=B0=B8?= =?UTF-8?q?=E4=B9=85=E7=95=99=E7=97=95=20+=20=E8=AF=A6=E6=83=85=E5=BC=B9?= =?UTF-8?q?=E7=AA=97=E8=B0=83=E8=AF=95=E4=BF=A1=E6=81=AF=E6=8A=98=E5=8F=A0?= =?UTF-8?q?=E5=8C=BA?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 后端: - GenerationRecord 加 api_prompt TextField(blank, default='') - 0021_add_api_prompt migration - video_generate_view 计算完 _format_prompt_for_ark 后立即 save api_prompt (即使 create_task 抛错也保留,方便事后查实际传了什么) - admin_records / team_records view 各回传 api_prompt 字段 前端: - AdminRecord 类型加 api_prompt?: string - RecordDetailModal 详情弹窗右侧底部加"调试信息(开发/客服参考)"折叠区 - 默认收起,小灰字 ▸/▾ toggle - 仅当 api_prompt && api_prompt !== prompt 才显示"实际发给火山"等宽字 box (历史记录 api_prompt 为空则不显示这栏) - 火山 Task ID + 复制按钮(showToast 反馈) - 失败任务才显示原始错误(raw_error) - 平时用户察觉不到,客服/财务复盘时点开就能看完整调试信息 Co-Authored-By: Claude Opus 4.7 (1M context) --- .../migrations/0021_add_api_prompt.py | 18 ++++ backend/apps/generation/models.py | 1 + backend/apps/generation/views.py | 5 + web/src/components/RecordDetailModal.tsx | 92 +++++++++++++++++++ web/src/types/index.ts | 1 + 5 files changed, 117 insertions(+) create mode 100644 backend/apps/generation/migrations/0021_add_api_prompt.py diff --git a/backend/apps/generation/migrations/0021_add_api_prompt.py b/backend/apps/generation/migrations/0021_add_api_prompt.py new file mode 100644 index 0000000..1cd24d6 --- /dev/null +++ b/backend/apps/generation/migrations/0021_add_api_prompt.py @@ -0,0 +1,18 @@ +# v0.20.1 — 给 GenerationRecord 加 api_prompt 字段（实际发给火山的提示词,永久留痕） + +from django.db import migrations, models + + +class Migration(migrations.Migration): + + dependencies = [ + ('generation', '0020_quotaconfig_base_token_price_1080p_and_more'), + ] + + operations = [ + migrations.AddField( + model_name='generationrecord', + name='api_prompt', + field=models.TextField(blank=True, default='', verbose_name='实际发给火山的提示词'), + ), + ] diff --git a/backend/apps/generation/models.py b/backend/apps/generation/models.py index f7f3ee0..4239f7d 100644 --- a/backend/apps/generation/models.py +++ b/backend/apps/generation/models.py @@ -34,6 +34,7 @@ class GenerationRecord(models.Model): task_id = models.UUIDField(default=uuid.uuid4, unique=True, verbose_name='任务ID') ark_task_id = models.CharField(max_length=100, blank=True, default='', verbose_name='火山ARK任务ID') prompt = models.TextField(blank=True, verbose_name='提示词') + api_prompt = models.TextField(blank=True, default='', verbose_name='实际发给火山的提示词') mode = models.CharField(max_length=20, choices=MODE_CHOICES, verbose_name='创作模式') model = models.CharField(max_length=30, choices=MODEL_CHOICES, verbose_name='模型') aspect_ratio = models.CharField(max_length=10, verbose_name='宽高比') diff --git a/backend/apps/generation/views.py b/backend/apps/generation/views.py index 984053a..d0fcfe7 100644 --- a/backend/apps/generation/views.py +++ b/backend/apps/generation/views.py @@ -563,6 +563,9 @@ def video_generate_view(request): api_prompt = _format_prompt_for_ark(prompt, sorted_pairs) logger.info('[ark-prompt] original=%s | converted=%s | mapping=%s', prompt, api_prompt, label_to_placeholder) + # 即使 create_task 抛错也保留 api_prompt 方便事后查看实际传了什么 + record.api_prompt = api_prompt + record.save(update_fields=['api_prompt']) try: ark_response = create_task( prompt=api_prompt, @@ -1820,6 +1823,7 @@ def admin_records_view(request): 'ark_task_id': r.ark_task_id or '', 'result_url': r.result_url or '', 'thumbnail_url': r.thumbnail_url or '', + 'api_prompt': r.api_prompt or '', }) return Response({ @@ -1886,6 +1890,7 @@ def team_records_view(request): 'ark_task_id': r.ark_task_id or '', 'result_url': r.result_url or '', 'thumbnail_url': r.thumbnail_url or '', + 'api_prompt': r.api_prompt or '', }) return Response({ diff --git a/web/src/components/RecordDetailModal.tsx b/web/src/components/RecordDetailModal.tsx index a8deeae..55828d3 100644 --- a/web/src/components/RecordDetailModal.tsx +++ b/web/src/components/RecordDetailModal.tsx @@ -1,6 +1,8 @@ +import { useState } from 'react'; import type { AdminRecord } from '../types'; import { ReferenceList } from './ReferenceList'; import { rewriteTosUrl } from '../lib/api'; +import { showToast } from './Toast'; const STATUS_MAP: Record = { completed: { label: '已完成', color: 'var(--color-success)', bg: 'var(--color-success-bg)' }, @@ -20,6 +22,13 @@ interface Props { export function RecordDetailModal({ record: r, onClose, showTeam, showCost }: Props) { const st = STATUS_MAP[r.status] || STATUS_MAP.processing; + const [debugOpen, setDebugOpen] = useState(false); + // 仅当转换后的 prompt 与原文不同(即 prompt 里有 @ 被转为「图片N」)才单独显示一栏 + const hasConvertedPrompt = !!(r.api_prompt && r.api_prompt !== r.prompt); + const handleCopyTaskId = () => { + if (!r.ark_task_id) return; + navigator.clipboard.writeText(r.ark_task_id).then(() => showToast('已复制')); + }; const elapsed = (() => { if (!r.completed_at) return '-'; @@ -100,6 +109,46 @@ export function RecordDetailModal({ record: r, onClose, showTeam, showCost }: Pr {/* Prompt */}
提示词
{r.prompt || '(无提示词)'}
+ + {/* 调试信息(开发/客服参考)— 默认收起 */} +
+ + {debugOpen && ( +
+ {hasConvertedPrompt && ( + <> +
实际发给火山(@素材名被自动转换为「图片N/视频N/音频N」):
+
{r.api_prompt}
+ + )} + {r.ark_task_id && ( +
+ 火山 Task ID: + {r.ark_task_id} + +
+ )} + {r.status === 'failed' && r.raw_error && ( + <> +
原始错误:
+
{r.raw_error}
+ + )} + {!hasConvertedPrompt && !r.ark_task_id && (r.status !== 'failed' || !r.raw_error) && ( +
(暂无调试信息)
+ )} +
+ )} +
@@ -365,3 +414,46 @@ const promptBox: React.CSSProperties = { color: 'var(--color-text-monochrome)', lineHeight: 1.6, whiteSpace: 'pre-wrap', wordBreak: 'break-all', maxHeight: 150, overflowY: 'auto', }; + +/* ── 调试信息折叠区(开发/客服参考)── */ +const debugSection: React.CSSProperties = { + marginTop: 20, + paddingTop: 12, + borderTop: '1px dashed var(--color-border-modal-soft)', +}; +const debugToggle: React.CSSProperties = { + display: 'flex', alignItems: 'center', gap: 4, + background: 'none', border: 'none', cursor: 'pointer', + color: 'var(--color-text-tertiary)', fontSize: 11, padding: 0, + fontFamily: 'inherit', +}; +const debugContent: React.CSSProperties = { + marginTop: 10, display: 'flex', flexDirection: 'column', gap: 8, +}; +const debugLabel: React.CSSProperties = { + fontSize: 11, color: 'var(--color-text-tertiary)', +}; +const debugCodeBox: React.CSSProperties = { + background: 'var(--color-bg-elevated)', borderRadius: 6, padding: 10, + fontSize: 12, lineHeight: 1.5, + fontFamily: "'JetBrains Mono', ui-monospace, Menlo, Consolas, monospace", + color: 'var(--color-text-monochrome)', + whiteSpace: 'pre-wrap', wordBreak: 'break-all', + maxHeight: 200, overflowY: 'auto', + border: '1px solid var(--color-border-modal-soft)', +}; +const debugRow: React.CSSProperties = { + display: 'flex', alignItems: 'center', gap: 8, flexWrap: 'wrap', +}; +const debugMono: React.CSSProperties = { + fontFamily: "'JetBrains Mono', ui-monospace, Menlo, Consolas, monospace", + fontSize: 12, color: 'var(--color-text-on-glass-soft)', + wordBreak: 'break-all', +}; +const debugCopyBtn: React.CSSProperties = { + background: 'var(--color-bg-elevated)', + border: '1px solid var(--color-border-modal-soft)', + borderRadius: 4, padding: '2px 8px', + fontSize: 11, color: 'var(--color-text-on-glass-soft)', + cursor: 'pointer', +}; diff --git a/web/src/types/index.ts b/web/src/types/index.ts index c9b1ee1..d2afd2a 100644 --- a/web/src/types/index.ts +++ b/web/src/types/index.ts @@ -219,6 +219,7 @@ export interface AdminRecord { ark_task_id?: string; result_url?: string; thumbnail_url?: string; + api_prompt?: string; } export interface SystemSettings {