顶栏那颗胶囊改成全站唯一的「项目概况」入口:点开右侧抽屉,项目层只在这一处说话

症状(2026-11 第十一轮 · 用户第 2 条原话「上面那个项目总览、展开、归档(删除)和顶部
系统 Header 的项目总览应该整合到一处(要不保留最顶部作为入口,点击展开侧面的面板,把
项目概况、操作按钮都放到那个对应的面板中)」):同一条项目身份在一屏里说了三遍——顶栏
流程控制台(名称·状态·进度·当前节点)、工作台外壳那条面包屑工具条(项目名 + 镜头/合格/
任务/成本 + 展开概况 + 删除项目)、概览页页头(归档项目);而它点下去是「跳流程概览」,
既不是看项目详情也不是做项目操作,语义含混。另外控制台以前只在 `wide` 才渲染,
900~991 与手机档整块消失,窄屏根本够不到归档与删除。

做法:①新增 `app/layout/ProjectBriefDrawer.tsx`(约 207 行)= 项目层唯一载体。
`Drawer` 宽 `min(620px, calc(100vw - 32px))`,标题是项目名、副标题「状态 · 流程 83% ·
720p / 16:9」;正文自上而下:`ErrorText` → 「项目身份」Panel(`Info` 回显画幅/分辨率/
题材/时长/默认模型/创建时间/简介)→ `StatGrid cols={2}` 四张指标(镜头合格、时长、
任务、成本)→ 「流程进度」Panel(`WorkflowBar compact`,容器自适应网格)→ 「项目环节」
Panel 七行 `.nex-brief-row`(图标 + 序号 + 站名 + 右端汇总状态 Tag,当前站标「当前」)
→ footer「返回项目总览(text, mr-auto)| 归档/取消归档 | 删除项目(全站唯一一颗
primary + danger,点第一次变「确认删除」并在正文里出一条 danger Notice 说明会连带清除
分镜、任务与素材)」。数据一律读 `stores/project.ts` 那份 6 秒轮询,抽屉不发第二个请求;
认「加载成功的那份数据自己的 id」而不是路由号,项目 404 时不会残留上一个项目。
列数跟着视口降档(`Grid.useBreakpoint()`:sm 以下 `Info` 收单列、简介那条 span 同步降),
否则 `Descriptions` 会报「Sum of column span in a line not match column」。
②`app/App.tsx` 把开合状态记在外壳(`briefOpen`),抽屉挂在 `MediaLightbox` 旁边而不是
任何路由里——它是跨七站的常驻面板,离开某一站不该关掉。
③`PipelineConsole` 从 `NavLink` 改成 kit 的 `<Button type="text" className="nex-console">`
(它是展开/收起一段内容,不是导航;R8/R15),带 `aria-haspopup="dialog"` +
`aria-expanded` + 尾部随开合翻转的下箭头;`AppHeader` 的渲染条件从 `projectId && wide`
放宽成 `projectId`——窄屏不许把唯一入口弄丢,轨道与状态由它自己的断点隐件(实测 375
整块 174×32,与右侧工具簇留 16px,Header 无横向滚动)。同一处还改了项目名的收缩份额:
原先 `flex-[0_1_auto]` 让「当前节点:…」那段散文先把名字吃到只剩 30px,现在名字
`max-w-[200px] flex-none` 不给收缩份额,额度不够先让散文缩到 0(1440 实测名字 149→178
可整条读完)。

为什么用右侧抽屉而不是弹窗:这是「随时查一眼项目全局」的辅助面板,遮罩之下正文还在原地,
关掉就回到刚才那一站,不需要重新载入;跳转型入口(七站列表)也放在同一块里,看完顺手就过去。
项目级的归档/删除只出现在 footer,与它们的作用域(整个项目)对齐,而不是散在页面级位置上。
main
mula.liu 2026-11-03 21:27:17 +08:00
parent 401deb84ea
commit 787a687238
4 changed files with 259 additions and 16 deletions

View File

@ -26,6 +26,7 @@ import { useLocalStorage } from '../hooks/use-local-storage'
import MediaLightbox from '../components/media/MediaLightbox'
import AppHeader from './layout/AppHeader'
import AppSider from './layout/AppSider'
import ProjectBriefDrawer from './layout/ProjectBriefDrawer'
import ErrorBoundary from './ErrorBoundary'
import type { RouteHandle } from './router'
@ -74,6 +75,9 @@ export default function App() {
const [ready, setReady] = useState(() => authState().checked)
/* 侧栏折叠:记忆到人,换页不换档;窄屏由 Sider 的 breakpoint 自己收 */
const [collapsed, setCollapsed] = useLocalStorage('nex.sider.collapsed', false)
/* 「项目概况」抽屉:顶栏流程控制台是唯一入口,开合状态记在外壳,
这样控制台那颗胶囊才能同时显示 aria-expanded 与箭头的方向 */
const [briefOpen, setBriefOpen] = useState(false)
/* 未鉴权路由在快照回来之前不渲染内容,避免先闪一屏 401 报错再跳登录页 */
useEffect(() => {
@ -134,7 +138,8 @@ export default function App() {
return (
<Layout style={{ minHeight: '100vh' }}>
<AppHeader projectId={projectId} collapsed={collapsed} onCollapse={setCollapsed} />
<AppHeader projectId={projectId} collapsed={collapsed} onCollapse={setCollapsed}
onOpenBrief={() => setBriefOpen((v) => !v)} briefOpen={briefOpen} />
<Layout>
<AppSider projectId={projectId} collapsed={collapsed} onCollapse={setCollapsed} />
<Layout.Content className="min-w-0 p-6 max-lg:p-4 max-md:p-3"
@ -158,6 +163,8 @@ export default function App() {
</Layout.Content>
</Layout>
<MediaLightbox />
{/* 项目层(身份 / 指标 / 流程 / 七站跳转 / 归档 / 删除)只在这里说一遍 */}
<ProjectBriefDrawer open={briefOpen} onClose={() => setBriefOpen(false)} projectId={projectId} />
</Layout>
)
}

View File

@ -22,10 +22,13 @@ import { useSystemStore } from '../../stores/system'
import PipelineConsole from './PipelineConsole'
import UserMenu from './UserMenu'
export function AppHeader({ projectId, collapsed, onCollapse }: {
export function AppHeader({ projectId, collapsed, onCollapse, onOpenBrief, briefOpen }: {
projectId: string
collapsed: boolean
onCollapse: (next: boolean) => void
/** 展开/收起右侧「项目概况」抽屉(项目层唯一入口,实现在 app/App.tsx) */
onOpenBrief: () => void
briefOpen: boolean
}) {
const navigate = useNavigate()
const screens = Grid.useBreakpoint()
@ -70,7 +73,12 @@ export function AppHeader({ projectId, collapsed, onCollapse }: {
)}
</Flex>
{projectId && wide && <PipelineConsole projectId={projectId} />}
{/* 控制台在 md 就要出现:它是项目层唯一入口(点开概况抽屉),
以前跟着 wide(=折叠或 ≥lg)走,900~991 这段整块没有,手机上就再也够不到归档/删除。
窄档由它自己的断点隐件换:轨道与状态 <xl 隐、当前节点 <lg 隐,md 只剩名字+百分比。 */}
{projectId && (
<PipelineConsole projectId={projectId} onOpenBrief={onOpenBrief} briefOpen={briefOpen} />
)}
<Flex align="center" gap="small" justify="flex-end" className={cn('min-w-max flex-[1_1_0]', !wide && 'flex-none')}>
{!offline && health && (

View File

@ -1,6 +1,13 @@
/**
* 顶栏「流程进度控制台」:项目名 + 状态 + 12~13 段节点轨道 + 进度 + 当前节点。
*
* 2026-11 第十一轮 · 用户第 2 条:这颗胶囊是**全站的 project switcher**——
* 点击不再跳「流程概览」,而是展开右侧「项目概况」抽屉(ProjectBriefDrawer),
* 项目身份、指标、流程、七站跳转、归档与删除都在那一处说。
* 于是工作台外壳不再需要自己那条面包屑工具条,项目信息也从三处收成一处。
* 它是按钮不是链接(展开/收起一段内容),所以用 kit 的 <Button type="text">
* (R8:页面与外壳也只从 kit 取按钮;R15:文案自带语义,图形只是暗示)。
*
* 数据源不额外发请求:ProjectDetail 每 6 秒把项目详情写进 useProjectStore,
* 这里只读。但 store 的 id 在请求发出前就被赋值,项目 404(或已删除)时会残留
* 上一个项目的数据,所以这里认「已经加载成功的那份项目数据自己的 id」,不认路由号。
@ -24,9 +31,9 @@
* 不要改成 margin-inline:auto:那居中的是「品牌右缘↔工具左缘」空档的中点,
* 工具区比品牌区宽约 140px,整块会偏左 70px。
*/
import { NavLink } from 'react-router-dom'
import { Typography } from 'antd'
import { Tag, type TagTone } from '../../components/ui'
import { Button, Tag, type TagTone } from '../../components/ui'
import { IconChevronDown } from '../../components/icons'
import { cn } from '../../lib/cn'
import { statusLabel } from '../../lib/format'
import { openNode } from '../../lib/pipeline'
@ -72,7 +79,12 @@ const SEG_BG: Record<string, string> = {
pending: 'var(--ant-color-fill)'
}
export function PipelineConsole({ projectId }: { projectId: string }) {
export function PipelineConsole({ projectId, onOpenBrief, briefOpen }: {
projectId: string
/** 展开/收起「项目概况」抽屉(入口只有这一颗) */
onOpenBrief: () => void
briefOpen?: boolean
}) {
const project = useProjectStore((s) => s.project)
const workflow = useProjectStore((s) => s.workflow)
/* 认「加载成功的那份数据自己的 id」,不认路由号 */
@ -123,15 +135,20 @@ export function PipelineConsole({ projectId }: { projectId: string }) {
+ (pipeCurrent ? (allDone ? ' · ' : ' · 当前节点:') + pipeCurrent.label : '')
return (
<NavLink to={`/projects/${projectId}/overview`} title={summary + '(点击查看流程)'}
className={cn(
'flex h-8 min-w-0 max-w-[520px] flex-[0_1_auto] items-center gap-3 overflow-hidden',
'rounded-md border border-solid bg-bg-elevated px-3 leading-normal no-underline',
'transition-colors hover:border-primary-border-hover',
muted ? 'border-border-secondary' : 'border-primary-border'
)}>
<Button type="text" className="nex-console" onClick={onOpenBrief}
aria-haspopup="dialog" aria-expanded={!!briefOpen}
title={summary + '(点击展开项目概况)'}
style={{ borderColor: muted ? 'var(--ant-color-border-secondary)' : 'var(--ant-color-primary-border)' }}>
{/* 名字是这颗胶囊唯一不许压扁的信息(它现在就是 project switcher):
2026-11 第十一轮实测 1440,「当前节点:+ detail」那段长文把 520 的额度吃光,
项目名只剩 30px(「跨…」),所以给名字定最小宽度,长文自己封顶。
第十二轮补一刀:`flex-[0_1_auto]` 允许收缩,于是「封顶」是双向失效的——
实测 1440 名字只剩 149(要 178)、1200 只剩 101、992 只剩 106,min-width 96
根本没机会生效,shrinking 先按 basis 比例把名字吃了。改成 **不给它收缩份额**
(flex-none):额度不够时先由「当前 · …」那句散文(min-w-0 + shrink)自己缩到 0,
再不够由状态 Tag 让位,名字要么整条读完、要么只在超过 200px 上限时折成省略号。 */}
<Typography.Text strong ellipsis={{ tooltip: projectTitle }}
className="min-w-0 max-w-[140px] flex-[0_1_auto] text-text">
className="max-w-[200px] flex-none text-text">
{projectTitle}
</Typography.Text>
{proj?.status && (
@ -159,12 +176,16 @@ export function PipelineConsole({ projectId }: { projectId: string }) {
{pipeCurrent && (
<Typography.Text type={allDone ? undefined : 'secondary'} ellipsis={{ tooltip: pipeCurText }}
className="min-w-0 flex-[0_1_auto] max-lg:hidden"
className="min-w-0 max-w-[150px] flex-[0_1_auto] max-lg:hidden"
style={allDone ? { color: fg } : undefined}>
{pipeCurText}
</Typography.Text>
)}
</NavLink>
{/* 尾部那颗下箭头只说「这儿能展开」,不承载信息:对读屏隐藏,
抽屉的开合状态由上面的 aria-expanded 说 */}
<IconChevronDown aria-hidden className={cn('flex-none transition-transform', briefOpen && 'rotate-180')} />
</Button>
)
}

View File

@ -0,0 +1,207 @@
/**
* 「项目概况」抽屉:项目身份 + 指标 + 流程 + 七站跳转 + 项目级操作,全部收在一处。
*
* 症状(2026-11 第十一轮 · 用户第 2 条原话「项目总览、展开、归档(删除)和顶部系统
* Header 的项目总览应该整合到一处…点击展开侧面的面板,把项目概况、操作按钮都放到
* 那个对应的面板中」「要进一步把各级的信息归拢并提供交互的层次清晰」):
* 项目身份在**同一屏说了三遍**——顶栏那颗胶囊(名称·状态·进度·当前节点)、
* 外壳那条面包屑工具条(项目名 + 镜头/合格/任务/成本 + 展开概况 + 删除项目)、
* 概览页的「流程概览」页头(归档项目);而 4 张指标卡 + 12 节点流程条坐在正文上方,
* 每个环节页都要先滚过这两屏才看到自己真正的内容。层级也是乱的:
* 「项目级」的操作(归档 / 删除)出现在「页面级」的位置上。
* 做法:四级层次各归各位——
* ① 顶栏控制台 = 唯一的项目身份入口(点击展开本抽屉,不再跳页);
* ② 本抽屉 = 项目层(身份回显 / 指标 / 流程 / 七站跳转 / 归档 / 删除);
* ③ NodeHead = 环节层页头(每站一张带底纹的卡,见 components/ui/Page.tsx);
* ④ Panel = 内容层。于是工作台外壳可以一行可见块都不渲染(见 pages/ProjectDetail.tsx)。
* 为什么用右侧抽屉而不是弹窗:这是「随时查一眼项目全局」的辅助面板,
* 遮罩之下正文还在原地,关掉就回到刚才那一站,不需要重新载入。
* 数据一律读 useProjectStore(外壳每 6 秒轮询),这里不发第二个请求。
*/
import { useState } from 'react'
import { useLocation, useNavigate } from 'react-router-dom'
import { Flex, Grid } from 'antd'
import * as api from '../../api/client'
import { fmtMoney, fmtTime, pct, statusLabel } from '../../lib/format'
import { moduleState } from '../../lib/pipeline'
import {
Button, Drawer, ErrorText, Info, Loading, Notice, PageStack, Panel,
Stat, StatGrid, Status, Tag, Value, type TagTone
} from '../../components/ui'
import { WorkflowBar } from '../../components/media/WorkflowBar'
import {
IconChart, IconClose, IconDelete, IconFolder, IconBolt, IconClock,
IconProjects, IconSync, IconTracks
} from '../../components/icons'
import { pathOf, projectModules, type NavItem } from './nav'
import { refresh, useProjectStore } from '../../stores/project'
import { notify } from '../../stores/notice'
/** 环节汇总状态 → 标签(口径与 lib/pipeline 的节点状态一致,只是从 12 个节点折成 7 站) */
const MODULE_TAG: Record<string, { label: string; tone: TagTone }> = {
done: { label: '已完成', tone: 'ok' },
active: { label: '进行中', tone: 'accent' },
failed: { label: '需处理', tone: 'bad' },
pending: { label: '待处理', tone: 'default' }
}
/** 环节项 → 路由最后一段(NODE_MODULE 的取值口径就是它) */
const slugOf = (m: NavItem): string => pathOf(m, '0').split('/').pop() || ''
export function ProjectBriefDrawer({ open, onClose, projectId }: {
open: boolean
onClose: () => void
projectId: string
}) {
const navigate = useNavigate()
const location = useLocation()
/* 抽屉宽度是 min(620, 100vw-32):手机上是 398,回显表两列会把「分辨率 / 帧率」
这种标签挤到折行,所以列数跟着视口降档。antd Descriptions 要求每行的 span 之和
等于 column,简介那条通栏的 span 也必须跟着算——写死 span:2 在单列下会报
「Sum of column span in a line not match column」。 */
const twoCol = !!Grid.useBreakpoint().sm
const [busy, setBusy] = useState(false)
const [confirming, setConfirming] = useState(false)
const [error, setError] = useState('')
const project = useProjectStore((s) => s.project)
const workflow = useProjectStore((s) => s.workflow)
const stats = useProjectStore((s) => s.stats)
/* 认「加载成功的那份数据自己的 id」,不认路由号:项目 404 时 store 里还留着上一个 */
const proj = projectId && project?.id === Number(projectId) ? project : null
const st = stats || {}
const isArchived = proj?.status === 'archived'
const curSlug = slugOf(projectModules.find((m) => pathOf(m, projectId) === location.pathname) || projectModules[0])
function go(to: string) {
onClose()
navigate(to)
}
async function run(fn: () => Promise<void>) {
setBusy(true)
setError('')
try { await fn() } catch (exc: any) { setError(exc?.message || String(exc)) } finally { setBusy(false) }
}
const setArchived = (on: boolean) => run(async () => {
await api.patch(`/api/projects/${projectId}`, { status: on ? 'archived' : 'draft' })
notify(on ? '项目已归档,不再自动推进流程' : '已取消归档,流程状态按镜头真实进度重算')
await refresh()
})
const removeProject = () => run(async () => {
await api.del(`/api/projects/${projectId}`, { purge_files: true })
navigate('/')
})
const taskHint = Object.entries<any>(st.task_status || {}).map(([k, v]) => `${statusLabel(k)} ${v}`).join(' · ')
const nextStep = workflow.find((s: any) => s.state === 'active' || s.state === 'failed')
return (
<Drawer open={open} onClose={onClose} label="项目概况"
width="min(620px, calc(100vw - 32px))"
title={proj?.name || `项目 #${projectId}`}
sub={proj ? `${statusLabel(proj.status)} · 流程 ${pctDone(workflow)} · ${proj.resolution || '—'} / ${proj.aspect_ratio || '—'}` : '项目概况'}
actions={<>
<Button type="text" className="mr-auto" icon={<IconProjects />} onClick={() => go('/')}>
返回项目总览
</Button>
<Button disabled={busy} icon={isArchived ? <IconSync /> : <IconFolder />}
title="归档后后端不再自动推进流程节点;取消归档后按镜头真实进度重算"
onClick={() => void setArchived(!isArchived)}>
{isArchived ? '取消归档' : '归档项目'}
</Button>
{confirming && (
<Button disabled={busy} icon={<IconClose />} onClick={() => setConfirming(false)}>取消</Button>
)}
<Button type="primary" danger disabled={busy} icon={<IconDelete />}
title={confirming ? '分镜、任务与已生成素材一起清除,不可恢复' : '删除整个项目'}
onClick={() => { if (confirming) void removeProject(); else setConfirming(true) }}>
{confirming ? '确认删除' : '删除项目'}
</Button>
</>}>
{!proj
? <Loading>正在载入项目概况…</Loading>
: (
<PageStack>
<ErrorText>{error}</ErrorText>
<Panel size="small" title="项目身份"
extra={<Status value={proj.status} />}>
<Info className="mb-0" column={twoCol ? 2 : 1} items={[
{ label: '画幅', value: proj.aspect_ratio || '—' },
{ label: '分辨率 / 帧率', value: `${proj.resolution || '—'} · ${proj.fps || '—'}fps` },
{ label: '题材', value: proj.genre || '—' },
{ label: '目标时长', value: `${proj.target_duration ?? '—'}s` },
{ label: '默认模型', value: proj.default_provider ? `${proj.default_provider}/${proj.default_model || '—'}` : '未指定' },
{ label: '创建时间', value: fmtTime(proj.created_at) },
{ label: '简介', value: proj.description || '—', span: twoCol ? 2 : 1 }
]} />
</Panel>
<StatGrid cols={2}>
<Stat icon={<IconTracks />} label="镜头(合格/总数)"
value={<>{st.shots_approved || 0}<i>/ {st.shots || 0}</i></>}
hint={`驳回 ${st.shots_rejected || 0} · 合格进度 ${pct(st.progress_ratio)}`} />
<Stat icon={<IconClock />} label="时长(计划/已生成)"
value={<>{(st.planned_duration || 0).toFixed(1)}s<i>/ {(st.generated_duration || 0).toFixed(1)}s</i></>}
hint={taskHint || '暂无任务'} />
<Stat icon={<IconBolt />} label="任务(活跃/总数)"
value={<>{st.tasks_active || 0}<i>/ {st.tasks || 0}</i></>}
hint={taskHint || '暂无任务'} />
<Stat icon={<IconChart />} label="成本 / 成片"
value={fmtMoney(st.cost?.total_cost, st.cost?.currency)}
hint={`${(st.exports || []).length} 个导出记录`} />
</StatGrid>
<Panel size="small" title="流程进度"
extra={nextStep ? <Value>下一步:{nextStep.label}</Value> : <Value>全部 {workflow.length} 个节点已完成</Value>}>
<WorkflowBar workflow={workflow} compact />
</Panel>
<Panel size="small" title="项目环节"
sub="每一站的汇总状态由它覆盖的那几个节点折算而来,点一行直接过去。">
<Flex vertical gap={2}>
{projectModules.map((m, i) => {
const slug = slugOf(m)
const tag = MODULE_TAG[moduleState(workflow, slug)] || MODULE_TAG.pending
const isCur = slug === curSlug
return (
<Button key={slug} type="text" block className="nex-brief-row"
title={m.hint} onClick={() => go(pathOf(m, projectId))}>
<Flex component="span" align="center" gap={8} className="w-full min-w-0">
<span className="nex-nodehead-mark">{m.icon}</span>
<span className="min-w-0 truncate text-xs font-semibold">
{i + 1}. {m.label}
</span>
<span className="ms-auto flex-none">
{isCur
? <Tag tone="accent">当前</Tag>
: <Tag tone={tag.tone}>{tag.label}</Tag>}
</span>
</Flex>
</Button>
)
})}
</Flex>
</Panel>
{confirming && (
<Notice danger onClose={() => setConfirming(false)}>
删除《{proj.name}》会同时清除分镜、任务与已生成素材,且不可恢复。
</Notice>
)}
</PageStack>
)}
</Drawer>
)
}
/** 轨道百分比:与顶栏控制台同一个算法(已完成节点 / 全部节点),不用后端的镜头合格率 */
function pctDone(nodes: any[]): string {
const total = nodes.length
if (!total) return '流程未生成'
return `${Math.round((nodes.filter((n: any) => n.state === 'done').length / total) * 100)}%`
}
export default ProjectBriefDrawer