feat: add Pyramid home dashboard

This commit is contained in:
yuxuanhui
2026-09-09 18:20:08 +08:00
parent be76b89e9d
commit e57b1f7a2e
17 changed files with 950 additions and 34 deletions
+8
View File
@@ -25,6 +25,7 @@ import { MCPKeysPage } from "./pages/MCPKeysPage";
import { AccountPage } from "./pages/AccountPage";
import { DatasetPage } from "./pages/DatasetPage";
import { AlphaPage } from "./pages/AlphaPage";
import { HomePage } from "./pages/HomePage";
import { JobPanel } from "./components/JobPanel";
import { BacktestPage } from "./backtests/BacktestPage";
import { WorkspacePreferences } from "./components/WorkspacePreferences";
@@ -319,6 +320,12 @@ export default function App() {
<main
className={`page-content ${page !== "account" ? "bounded-page" : "account-page"}`}
>
{page === "home" && (
<HomePage
account={account}
onAccount={() => changePage("account")}
/>
)}
{page === "mcp-keys" && <MCPKeysPage />}
{pollError && (
<Banner
@@ -479,6 +486,7 @@ export default function App() {
onClose={() => setChatOpen(false)}
context={
{
home: { page: "home" as const },
quantflow:
researchContext.page === "quantflow"
? researchContext
+1
View File
@@ -12,6 +12,7 @@ export type ModelSettings = {
};
export type PageContext = {
page:
| "home"
| "alphas"
| "account"
| "datasets"
+2 -3
View File
@@ -5,6 +5,7 @@ const contextLabels: Record<
PageContext["page"],
(context: PageContext) => string
> = {
home: () => "上下文:首页看板",
alphas: (context) =>
`上下文:${context.alpha_id ? `Alpha ${context.alpha_id}` : "Alpha 列表"}${context.selected_ids?.length ? ` · 已选 ${context.selected_ids.length} 条` : ""}`,
operators: () => "上下文:算子库",
@@ -30,9 +31,7 @@ export function pageFromHash(hash: string): WorkspacePage {
const value = hash.replace(/^#/, "").split("?")[0];
const page = value.startsWith("quantflow/") ? "quantflow" : value;
if (page === "mcp-keys") return page;
return Object.hasOwn(contextLabels, page)
? (page as WorkspacePage)
: "alphas";
return Object.hasOwn(contextLabels, page) ? (page as WorkspacePage) : "home";
}
type Destination = {
+34 -28
View File
@@ -16,6 +16,7 @@ import type { Account } from "../types";
import type { WorkspacePage } from "../ai/workspace";
const navigation = [
{ id: "home", label: "首页看板", icon: IconGridView, group: "概览" },
{ id: "datasets", label: "数据目录", icon: IconList, group: "数据与素材" },
{ id: "operators", label: "算子库", icon: IconList, group: "数据与素材" },
{
@@ -173,35 +174,40 @@ export function AppSidebar({
</div>
)}
<nav className="sidebar-nav" aria-label="主导航">
{["数据与素材", "研究实验", "研究编排", "研究成果", "系统管理"].map(
(group) => (
<div key={group}>
{!collapsed && (
<div className="sidebar-group-heading">{group}</div>
)}
{navigation
.filter((item) => item.group === group)
.map(({ id, label, icon: Icon }) => (
<Tooltip
key={id}
content={label}
position="right"
visible={collapsed ? undefined : false}
{[
"概览",
"数据与素材",
"研究实验",
"研究编排",
"研究成果",
"系统管理",
].map((group) => (
<div key={group}>
{!collapsed && (
<div className="sidebar-group-heading">{group}</div>
)}
{navigation
.filter((item) => item.group === group)
.map(({ id, label, icon: Icon }) => (
<Tooltip
key={id}
content={label}
position="right"
visible={collapsed ? undefined : false}
>
<button
className={`sidebar-nav-item ${id === page ? "active" : ""}`}
aria-label={label}
aria-current={id === page ? "page" : undefined}
onClick={() => navigate(id)}
>
<button
className={`sidebar-nav-item ${id === page ? "active" : ""}`}
aria-label={label}
aria-current={id === page ? "page" : undefined}
onClick={() => navigate(id)}
>
<Icon style={{ fontSize: 17 }} />
{!collapsed && <span>{label}</span>}
</button>
</Tooltip>
))}
</div>
),
)}
<Icon style={{ fontSize: 17 }} />
{!collapsed && <span>{label}</span>}
</button>
</Tooltip>
))}
</div>
))}
</nav>
<div className="sidebar-footer">
{!collapsed && (
+376
View File
@@ -0,0 +1,376 @@
import { useEffect, useState } from "react";
import { Banner, Button, Input, Spin } from "@douyinfe/semi-ui-19";
import { api, formatTime } from "../api";
import type { Account } from "../types";
import "./home.css";
type PyramidRow = {
region: string;
delay: number;
category_id: string;
category_name: string;
value: number | null;
};
type Snapshot = {
items: PyramidRow[];
fetched_at: string;
start_date: string | null;
end_date: string | null;
};
function useSnapshot(
path: string,
enabled: boolean,
version: number,
identity: string,
) {
const [data, setData] = useState<Snapshot | null>(null);
const [error, setError] = useState("");
const [loading, setLoading] = useState(false);
const [retry, setRetry] = useState(0);
useEffect(() => {
let ignore = false;
const controller = new AbortController();
setData(null);
setError("");
setLoading(enabled);
if (enabled) {
api<Snapshot>(path, { signal: controller.signal })
.then((next) => {
if (!ignore) setData(next);
})
.catch((e: Error) => {
if (!ignore) setError(e.message);
})
.finally(() => {
if (!ignore) setLoading(false);
});
}
return () => {
ignore = true;
controller.abort();
};
}, [path, enabled, version, identity, retry]);
return {
data: enabled ? data : null,
error: enabled ? error : "",
loading: enabled && loading,
refresh: () => setRetry((value) => value + 1),
};
}
type ResourceState = ReturnType<typeof useSnapshot>;
export function HomePage({
account,
onAccount,
}: {
account: Account | null;
onAccount: () => void;
}) {
const [version, setVersion] = useState(0);
const [start, setStart] = useState("");
const [end, setEnd] = useState("");
const [period, setPeriod] = useState({ start: "", end: "" });
const connected =
account?.connection_status === "connected" && !!account?.wq_user_id;
const identity = account?.wq_user_id ?? "";
const params = new URLSearchParams();
if (period.start) params.set("start_date", period.start);
if (period.end) params.set("end_date", period.end);
const multipliers = useSnapshot(
"/dashboard/pyramid-multipliers",
connected,
version,
identity,
);
const alphas = useSnapshot(
`/dashboard/pyramid-alphas?${params}`,
connected,
version,
identity,
);
const multiplierValues =
multipliers.data?.items.flatMap((item) =>
item.value === null ? [] : [item.value],
) ?? [];
const counts = alphas.data?.items;
const completeCounts = counts && counts.every((item) => item.value !== null);
const coverage = completeCounts
? counts.filter((item) => item.value! > 0).length
: null;
const total = completeCounts
? counts.reduce((sum, item) => sum + item.value!, 0)
: null;
const invalidDates = !!(start && end && start > end);
const dirtyDates = start !== period.start || end !== period.end;
const metrics = [
["Pyramid 类别", multipliers.data?.items.length, "当前乘数列表中的类别"],
[
"最高乘数",
multiplierValues.length &&
multiplierValues.length === multipliers.data?.items.length
? `${Math.max(...multiplierValues).toLocaleString("zh-CN")}×`
: null,
"平台当前鼓励程度",
],
["已覆盖类别", coverage, "所选范围内 Alpha 数量大于 0"],
["Alpha 归属次数", total, "跨类别累计,同一 Alpha 可能重复计入"],
] as const;
return (
<section className="home-page" aria-label="首页看板">
<header className="home-heading">
<div>
<h1>首页看板</h1>
<p>了解 Pyramid 的平台乘数与 Alpha 分布。</p>
</div>
<Button
disabled={!connected || multipliers.loading || alphas.loading}
onClick={() => setVersion((value) => value + 1)}
>
刷新看板
</Button>
</header>
{!account ? (
<div className="home-empty">
<Spin />
<span>正在读取账户状态…</span>
</div>
) : (
!connected && (
<div className="home-connect">
<div>
<strong>连接 WorldQuant 后查看看板</strong>
<p>请到个人信息页连接账户;如需人工验证,请先完成验证。</p>
</div>
<Button theme="solid" onClick={onAccount}>
前往个人信息
</Button>
</div>
)
)}
<div className="home-metrics">
{metrics.map(([label, value, hint]) => (
<article className="home-metric" key={label} aria-label={label}>
<span>{label}</span>
<strong>
{typeof value === "number"
? value.toLocaleString("zh-CN")
: (value ?? "—")}
</strong>
<small>{hint}</small>
</article>
))}
</div>
<div className="home-panels">
<PyramidPanel
title="Pyramid 乘数"
description="按乘数从高到低排列,日期筛选不影响当前乘数。"
metric="乘数"
state={multipliers}
connected={connected}
timezone={account?.timezone}
/>
<PyramidPanel
title="Alpha 分布"
description="按归属数量从高到低排列;数量为 0 的类别也会保留。"
metric="Alpha 数量"
state={alphas}
connected={connected}
timezone={account?.timezone}
>
<form
className="home-period"
onSubmit={(event) => {
event.preventDefault();
if (invalidDates) return;
if (dirtyDates) setPeriod({ start, end });
else alphas.refresh();
}}
>
<div className="home-date-fields">
<label>
开始日期
<input
aria-label="分布开始日期"
type="date"
value={start}
max={end || "9999-12-31"}
onChange={(event) => setStart(event.target.value)}
/>
</label>
<label>
结束日期
<input
aria-label="分布结束日期"
type="date"
value={end}
min={start || undefined}
max="9999-12-31"
onChange={(event) => setEnd(event.target.value)}
/>
</label>
</div>
<div className="inline-actions">
<Button
htmlType="submit"
disabled={!connected || invalidDates || alphas.loading}
>
应用日期
</Button>
<Button
disabled={!start && !end && !period.start && !period.end}
onClick={() => {
setStart("");
setEnd("");
setPeriod({ start: "", end: "" });
}}
>
恢复默认
</Button>
<small>按平台日期查询;留空使用平台默认范围。</small>
</div>
{invalidDates && <p role="alert">开始日期不能晚于结束日期。</p>}
{dirtyDates && !invalidDates && (
<p className="muted">日期已修改,点击“应用日期”更新分布。</p>
)}
</form>
</PyramidPanel>
</div>
</section>
);
}
function PyramidPanel({
title,
description,
metric,
state,
connected,
timezone,
children,
}: {
title: string;
description: string;
metric: "乘数" | "Alpha 数量";
state: ResourceState;
connected: boolean;
timezone?: string;
children?: React.ReactNode;
}) {
const [search, setSearch] = useState("");
const query = search.trim().toLowerCase();
const rows = (state.data?.items ?? [])
.filter((item) =>
`${item.region} D${item.delay} ${item.category_id} ${item.category_name}`
.toLowerCase()
.includes(query),
)
.sort(
(a, b) =>
(b.value ?? -1) - (a.value ?? -1) ||
a.region.localeCompare(b.region) ||
a.delay - b.delay ||
a.category_id.localeCompare(b.category_id),
);
const maximum = Math.max(1, ...rows.map((row) => row.value ?? 0));
return (
<section
className="home-panel"
aria-label={title}
aria-busy={state.loading}
>
<header>
<h2>{title}</h2>
<p>{description}</p>
</header>
{children}
{state.error ? (
<div className="home-panel-error">
<Banner type="warning" description={state.error} />
<Button onClick={state.refresh}>重试{title}</Button>
</div>
) : state.loading ? (
<div className="home-empty" role="status">
<Spin />
<span>正在加载{title}…</span>
</div>
) : !connected ? (
<div className="home-empty">连接账户后显示{title}。</div>
) : state.data ? (
<>
<div className="home-table-tools">
<Input
aria-label={`搜索${title}`}
value={search}
onChange={setSearch}
placeholder="搜索地区、延迟或类别"
showClear
/>
<span>
{rows.length} / {state.data.items.length} 类
</span>
</div>
<div className="home-table-wrap">
<table>
<thead>
<tr>
<th>地区</th>
<th>延迟</th>
<th>数据类别</th>
<th>{metric}</th>
</tr>
</thead>
<tbody>
{rows.map((row, index) => (
<tr
key={`${row.region}:${row.delay}:${row.category_id}:${index}`}
>
<td>{row.region}</td>
<td>D{row.delay}</td>
<td>
<strong>{row.category_name}</strong>
<small>{row.category_id}</small>
</td>
<td>
<div className="home-value">
{row.value === null
? "—"
: `${row.value.toLocaleString("zh-CN")}${metric === "乘数" ? "×" : ""}`}
</div>
<div className="home-bar" aria-hidden="true">
<i
style={{
width: `${((row.value ?? 0) / maximum) * 100}%`,
}}
/>
</div>
</td>
</tr>
))}
</tbody>
</table>
{!rows.length && (
<div className="home-empty">
{state.data.items.length
? "没有匹配的 Pyramid 类别。"
: "平台暂未返回 Pyramid 数据。"}
</div>
)}
</div>
<footer>
{metric === "Alpha 数量" && (
<span>
查询范围:
{state.data.start_date || state.data.end_date
? `${state.data.start_date ?? "不限开始"} 至 ${state.data.end_date ?? "不限结束"}`
: "平台默认"}
</span>
)}
<span>更新于 {formatTime(state.data.fetched_at, timezone)}</span>
</footer>
</>
) : null}
</section>
);
}
+217
View File
@@ -0,0 +1,217 @@
.home-page {
flex: 1;
min-height: 0;
overflow: auto;
padding: 8px 4px 24px;
}
.home-heading {
display: flex;
align-items: center;
justify-content: space-between;
gap: 16px;
margin-bottom: 24px;
}
.home-heading p,
.home-panel header p,
.home-connect p {
color: var(--muted);
margin-top: 4px;
}
.home-metrics {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(180px, 1fr));
gap: 16px;
margin-bottom: 24px;
}
.home-metric,
.home-panel {
border: 1px solid var(--line);
border-radius: 8px;
background: var(--surface);
min-width: 0;
}
.home-metric {
display: flex;
flex-direction: column;
gap: 8px;
padding: 20px;
}
.home-metric > span {
color: var(--muted);
}
.home-metric > strong {
font-size: 30px;
font-weight: 600;
font-variant-numeric: tabular-nums;
line-height: 1.3;
}
.home-metric small,
.home-period small,
.home-panel footer {
color: var(--muted);
font-size: 12px;
line-height: 1.6;
}
.home-panels {
display: grid;
grid-template-columns: repeat(auto-fit, minmax(min(100%, 440px), 1fr));
gap: 20px;
align-items: start;
}
.home-panel {
overflow: hidden;
}
.home-panel header {
padding: 20px;
border-bottom: 1px solid var(--line);
}
.home-panel header p {
font-size: 12px;
}
.home-connect {
display: flex;
align-items: center;
justify-content: space-between;
flex-wrap: wrap;
gap: 16px;
background: var(--semi-color-primary-light-default);
border-radius: 8px;
padding: 20px;
margin-bottom: 20px;
}
.home-empty {
display: flex;
justify-content: center;
align-items: center;
gap: 12px;
padding: 48px 20px;
color: var(--muted);
text-align: center;
}
.home-period {
padding: 16px 20px;
background: var(--canvas);
border-bottom: 1px solid var(--line);
}
.home-date-fields {
display: grid;
grid-template-columns: repeat(2, minmax(0, 1fr));
gap: 12px;
}
.home-date-fields input {
width: 100%;
min-width: 0;
height: 32px;
padding: 4px 8px;
color: var(--ink);
background: var(--surface);
border: 1px solid var(--line);
border-radius: 4px;
}
body[theme-mode="dark"] .home-date-fields input {
color-scheme: dark;
}
.home-table-tools {
display: flex;
align-items: center;
gap: 12px;
padding: 16px 20px;
}
.home-table-tools > span {
flex-shrink: 0;
color: var(--muted);
font-size: 12px;
}
.home-table-wrap {
max-height: 420px;
overflow: auto;
}
.home-panel table {
width: 100%;
border-collapse: separate;
border-spacing: 0;
text-align: left;
font-size: 13px;
}
.home-panel th {
position: sticky;
top: 0;
z-index: 1;
background: var(--canvas);
font-weight: 500;
color: var(--muted);
white-space: nowrap;
}
.home-panel td,
.home-panel th {
padding: 12px 16px;
border-bottom: 1px solid var(--line);
}
.home-panel td:first-child,
.home-panel td:nth-child(2) {
white-space: nowrap;
}
.home-panel td strong {
font-weight: 400;
overflow-wrap: anywhere;
}
.home-panel td small {
display: block;
margin-top: 3px;
color: var(--muted);
overflow-wrap: anywhere;
}
.home-panel td:last-child {
min-width: 96px;
text-align: right;
}
.home-value {
font-variant-numeric: tabular-nums;
font-weight: 500;
}
.home-bar {
height: 3px;
background: var(--canvas);
border-radius: 2px;
margin-top: 6px;
}
.home-bar i {
display: block;
height: 100%;
border-radius: inherit;
background: var(--accent);
opacity: 0.7;
}
.home-panel footer {
display: flex;
justify-content: space-between;
flex-wrap: wrap;
gap: 8px;
padding: 12px 20px;
border-top: 1px solid var(--line);
}
.home-panel-error {
display: grid;
justify-items: start;
gap: 16px;
padding: 20px;
}
@media (max-width: 600px) {
.home-metrics {
grid-template-columns: repeat(2, minmax(0, 1fr));
gap: 10px;
}
.home-metric {
padding: 14px;
}
.home-metric > strong {
font-size: 26px;
}
.home-heading {
align-items: flex-start;
}
.home-panel td,
.home-panel th {
padding: 10px;
}
}