Files
AgentLab/frontend/src/App.tsx
T
ThearchyHelios 542bcb65bb 一次对话有自己的地址了:/chat/<chatID>,运行、画布、各页标签同理
在此之前 react-router 只管到页面一级,「页面内部在看哪个」全在 store 和
localStorage 里,全站一处 useParams / useSearchParams / useNavigate 都没有。
后果:

- 一次对话没有地址。想把「这个结论是怎么查出来的」发给同事,只能发截图。
- 刷新回到上次那个对话靠 localStorage,换台机器、换个浏览器就丢。
- 浏览器前进/后退在页面内部彻底失效——切了五个对话,后退一下直接离开问数据页。
- /settings 永远落在「模型接入」,指不到数据源那一屏。

    /chat/:conversationId     /studio/:workflowId     /runs/:runId
    /knowledge/:tab           /tools/:tab             /settings/:tab

每页写两条显式路由(带 id / 不带 id)而不是可选参数 `:id?`:「没带 id」是真要
单独处理的一种情况(落到上次那个、或列表第一个),藏在一个问号里下次就没人
记得它存在了。

**URL 驱动 store,不是反过来。** 两边都能写就一定会打架——点一下列表,store
改了、地址栏没动,刷新又跳回旧的。所以 useConversations.currentId 降级成 URL
的派生缓存,唯一写入口是 ChatPage 的那个同步 effect;列表里的切换、新建、删除
一律改成导航。conversations.load() 不再自作主张决定「当前看哪个」,
remove() 改成返回「接下来该去哪」交给调用方。

localStorage 留着,但它现在只回答另一个问题:**打开不带 id 的 /chat 该去哪**。

**指向不存在的东西**要优雅:等列表加载完再判(在那之前"找不到"是假的,照着它
跳会让每次深链接进入都先闪一下错误提示),落到一个真实的,并说明为什么换了
地方。RunsPage 特别一点——列表只取前 100 条,而一条老运行的链接必须也能打开,
所以详情按 id 直接取,不在列表里找。

**画布多两道闸。** 选择器里本来就有"未保存改动"的确认,但那道闸在它的 onClick
里,而前进/后退会绕过选择器直接换图——改了一半的画布就这么没了。URL→画布那个
effect 里补一道,取消就把地址退回去。

过程中实测抓到三个问题,都修了:
- 同一个坏地址弹三次"那张工作流不在了":effect 在请求回来之前又跑了两遍,
  加了在途去重(chat 那边同样的毛病弹两次)。
- 「在画布里打开」现在直接把人送去 /studio,而那是一张还没存、没有 id 的草稿图。
  不带 id 就落到第一张图的逻辑会拿第一张把它盖掉,还会先弹一句莫名其妙的
  "有未保存的改动"——加了 nodeCount 判断让开。这个坑其实原来就在,只是以前
  要手动点导航才踩得到。
- 删掉当前打开的那张图之后地址还指着它,刷新会撞上"不在了"。

顺带:三个 tab 页共用一个 useTabRoute(放在 Tabs 旁边,tab 和它的地址是同一件
事,拆两处迟早各改各的),认不出的 tab 名回落并把地址一起纠正过来。
「在画布里打开」不再是 toast 让用户自己去点导航,直接送过去。

验证:tsc 干净;后端 249 passed(没碰后端,跑一遍确认没带坏);
check-decode / check-stream 不回归;check-ui 新增「URL 指得到」一节 19 条,
真浏览器里验了深链接、切换改地址、刷新、后退、坏地址、tab 直达、
草稿图不被盖掉、越过列表上限的老运行。
2026-09-20 14:09:40 +08:00

102 lines
4.3 KiB
TypeScript

import { useEffect } from 'react'
import { NavLink, Navigate, Route, Routes } from 'react-router-dom'
import { BookOpen, FlaskConical, History, MessageSquare, Settings, Wrench } from 'lucide-react'
import clsx from 'clsx'
import { api } from './api/client'
import { useCatalog } from './store/catalog'
import { ChatPage } from './pages/ChatPage'
import { StudioPage } from './pages/StudioPage'
import { RunsPage } from './pages/RunsPage'
import { ToolsPage } from './pages/ToolsPage'
import { KnowledgePage } from './pages/KnowledgePage'
import { SettingsPage, applyTheme } from './pages/SettingsPage'
import { Spinner } from './components/ui'
const NAV = [
{ to: '/chat', label: '问数据', icon: MessageSquare },
{ to: '/studio', label: '编排', icon: FlaskConical },
{ to: '/runs', label: '运行', icon: History },
{ to: '/tools', label: '工具', icon: Wrench },
{ to: '/knowledge', label: '知识', icon: BookOpen },
{ to: '/settings', label: '设置', icon: Settings },
]
export default function App() {
const { loaded, refresh, refreshApprovals, approvals } = useCatalog()
useEffect(() => {
void refresh()
void api.settings.get().then((s) => applyTheme(s?.ui?.theme ?? 'system')).catch(() => {})
}, [refresh])
// 待审批是全局待办:别的页面也要能看到有东西等着人处理
useEffect(() => {
const timer = setInterval(() => void refreshApprovals(), 4000)
return () => clearInterval(timer)
}, [refreshApprovals])
const pending = approvals.filter((a) => a.status === 'pending').length
if (!loaded) {
return (
<div className="flex h-full items-center justify-center gap-2 text-dim">
<Spinner size={16} /> 正在连接后端…
</div>
)
}
return (
<div className="flex h-full">
<nav className="flex w-14 shrink-0 flex-col items-center gap-1 border-r bg-panel py-2">
<div className="mb-2 flex h-8 w-8 items-center justify-center rounded-lg bg-[var(--accent)] text-[13px] font-bold text-white">
A
</div>
{NAV.map((item) => (
<NavLink
key={item.to}
to={item.to}
className={({ isActive }) =>
clsx(
'relative flex w-11 flex-col items-center gap-0.5 rounded-lg py-2 text-[9.5px] transition-colors',
isActive ? 'bg-hover text-fg' : 'text-faint hover:bg-hover hover:text-dim',
)
}
>
<item.icon size={15} />
{item.label}
{item.to === '/runs' && pending > 0 && (
<span className="absolute right-1.5 top-1 flex h-3.5 min-w-3.5 items-center justify-center rounded-full bg-[var(--warn)] px-1 text-[8.5px] font-bold text-black">
{pending}
</span>
)}
</NavLink>
))}
</nav>
<main className="min-w-0 flex-1">
{/* 「在看哪个」属于 URL,不属于 store。
每页写成两条显式路由(带 id / 不带 id),而不是可选参数 `:id?`:
「没带 id」是真要单独处理的一种情况(落到上次那个、或列表第一个),
藏在一个问号里下次就没人记得它存在了。
导航高亮不用动——NavLink 默认前缀匹配,/chat/abc 照样点亮「问数据」。*/}
<Routes>
{/* 默认落到对话页:多数人要的是答案,画布留给要自己编排的人 */}
<Route path="/" element={<Navigate to="/chat" replace />} />
<Route path="/chat" element={<ChatPage />} />
<Route path="/chat/:conversationId" element={<ChatPage />} />
<Route path="/studio" element={<StudioPage />} />
<Route path="/studio/:workflowId" element={<StudioPage />} />
<Route path="/runs" element={<RunsPage />} />
<Route path="/runs/:runId" element={<RunsPage />} />
<Route path="/tools" element={<ToolsPage />} />
<Route path="/tools/:tab" element={<ToolsPage />} />
<Route path="/knowledge" element={<KnowledgePage />} />
<Route path="/knowledge/:tab" element={<KnowledgePage />} />
<Route path="/settings" element={<SettingsPage />} />
<Route path="/settings/:tab" element={<SettingsPage />} />
</Routes>
</main>
</div>
)
}