-
-
-
-
-
+
+
+
+
+ {report.ticker}
+
+ {report.market ? ({ US: '美股', HK: '港股', CN: 'A股' } as Record)[report.market] ?? report.market : '—'}
+
+
+
{report.company_name}
+
+
+ {report.trading_decision || decision?.verdictLabel || '待裁决'}
+
+
+
+ {report.summary || '暂无摘要'}
+
+
+ {report.created_at ? new Date(report.created_at).toLocaleDateString('zh-CN') : '—'}
+ 示例 / 延迟
-
+
);
}
diff --git a/web/frontend/src/app/report/page.tsx b/web/frontend/src/app/report/page.tsx
new file mode 100644
index 0000000..976ef8a
--- /dev/null
+++ b/web/frontend/src/app/report/page.tsx
@@ -0,0 +1,87 @@
+'use client';
+
+import { useQuery } from '@tanstack/react-query';
+import Link from 'next/link';
+import { useSearchParams } from 'next/navigation';
+import { Suspense } from 'react';
+import { RoleChainReportView } from '@/components/report/RoleChainReport';
+import { DisclaimerBanner } from '@/components/site/DisclaimerBanner';
+import { SiteLayout } from '@/components/site/SiteLayout';
+import { reportAPI } from '@/lib/api/reports';
+
+function ReportInner() {
+ const params = useSearchParams();
+ const id = params.get('id') ?? '';
+
+ const { data, isLoading, error } = useQuery({
+ queryKey: ['report', id],
+ queryFn: () => reportAPI.get(id),
+ enabled: !!id,
+ });
+
+ if (!id) {
+ return (
+
+
+
+ );
+ }
+
+ return (
+
+ {isLoading && (
+
+ 正在加载报告…
+
+ )}
+ {error && !isLoading && (
+
+
+
报告不存在或暂不可见
+
该报告可能为私有，需登录其作者账号查看。
+
返回公开榜单
+
+
+
+ {data.role_chain ? (
+
+ ) : (
+
+ )}
+
+ );
+}
+
+function LegacyReportView() {
+ return (
+
+
+
该报告尚无结构化角色链数据
+
可能是较早的分析或仍在进行中。新分析完成后将自动渲染完整多智能体角色链。
+
+ );
+}
+
+export default function ReportPage() {
+ return (
+
+
+
+ );
+}
+
diff --git a/web/frontend/src/app/research/page.tsx b/web/frontend/src/app/research/page.tsx
new file mode 100644
index 0000000..31e63be
--- /dev/null
+++ b/web/frontend/src/app/research/page.tsx
@@ -0,0 +1,91 @@
+'use client';
+
+import { useRouter, useSearchParams } from 'next/navigation';
+import { Suspense } from 'react';
+import { SearchBar } from '@/components/site/SearchBar';
+import { SiteLayout } from '@/components/site/SiteLayout';
+import { useAuth } from '@/lib/auth';
+import { analysisAPI } from '@/lib/apiClient';
+import { useState } from 'react';
+
+function ResearchInner() {
+ const router = useRouter();
+ const params = useSearchParams();
+ const q = params.get('q') ?? '';
+ const { user } = useAuth();
+ const [launching, setLaunching] = useState(false);
+ const [error, setError] = useState('');
+
+ const launch = async () => {
+ if (!q) return;
+ if (!user) {
+ router.push('/auth?next=/research?q=' + encodeURIComponent(q));
+ return;
+ }
+ setLaunching(true);
+ setError('');
+ try {
+ const res = await analysisAPI.startAnalysis({ ticker: q, of_company: q });
+ const aid = res?.analysis_id || res?.id;
+ if (aid) router.push('/me?analysis=' + aid);
+ else setError('已提交，请到「我的分析」查看进度。');
+ } catch (e) {
+ setError(e instanceof Error ? e.message : '启动分析失败');
+ } finally {
+ setLaunching(false);
+ }
+ };
+
+ return (
+
+ 发起研究
+ 确认你的研究目标，多智能体团队将开始全维度分析。
+
+
+
+
+
研究目标
+
{q || '（请在上方输入）'}
+
+
+ {[
+ { i: 'fa-chart-line', t: '市场 / 技术面' },
+ { i: 'fa-comments', t: '舆情 / 情绪' },
+ { i: 'fa-newspaper', t: '新闻 / 宏观' },
+ { i: 'fa-table-list', t: '基本面 / 财务' },
+ { i: 'fa-users-rays', t: '多空研究辩论' },
+ { i: 'fa-shield-halved', t: '风险裁决' },
+ ].map((s) => (
+
+
+ {s.t}
+
+ ))}
+
+
+ {!user && (
+
+ 保存分析结果与公开报告需要先登录。
+
+ )}
+ {error &&
{error}
}
+
+
+
研究建议 · 非下单执行 · 示例 / 延迟数据
+
+
+
+ );
+}
+
+export default function ResearchPage() {
+ return (
+
+
+
+ );
+}
+
diff --git a/web/frontend/src/app/scheduled-tasks/page.tsx b/web/frontend/src/app/scheduled-tasks/page.tsx
index 7aafc24..1b2a14c 100644
--- a/web/frontend/src/app/scheduled-tasks/page.tsx
+++ b/web/frontend/src/app/scheduled-tasks/page.tsx
@@ -22,7 +22,7 @@ export default function ScheduledTasksPage() {
const limit = 10; // 每页显示10条
const isMobile = useIsMobile();
- const { data: listData, isLoading, error } = useScheduledTasks(page, limit);
+ const { data: listData, isLoading, error, refetch } = useScheduledTasks(page, limit);
const { data: statsData } = useScheduledTaskStats();
const deleteTask = useDeleteScheduledTask();
const updateTask = useUpdateScheduledTask();
diff --git a/web/frontend/src/app/settings/page.tsx b/web/frontend/src/app/settings/page.tsx
new file mode 100644
index 0000000..c4db12e
--- /dev/null
+++ b/web/frontend/src/app/settings/page.tsx
@@ -0,0 +1,89 @@
+'use client';
+
+import { useState } from 'react';
+import { SiteLayout } from '@/components/site/SiteLayout';
+import { useAuth } from '@/lib/auth';
+import { useLocalLLMKeys } from '@/hooks/useLocalLLMKeys';
+
+const PROVIDERS = [
+ { key: 'openai', label: 'OpenAI', url: 'https://api.openai.com/v1', models: 'gpt-4o / gpt-4o-mini' },
+ { key: 'deepseek', label: 'DeepSeek', url: 'https://api.deepseek.com/v1', models: 'deepseek-chat / deepseek-reasoner' },
+ { key: 'openrouter', label: 'OpenRouter', url: 'https://openrouter.ai/api/v1', models: '多模型聚合' },
+ { key: 'custom', label: '自定义兼容端点', url: '', models: '兼容 OpenAI 协议' },
+];
+
+export default function SettingsPage() {
+ const { user } = useAuth();
+ const { hasLocalKey, saveLocalKey, clearLocalKey } = useLocalLLMKeys();
+ const [drafts, setDrafts] = useState
>({});
+ const [saved, setSaved] = useState(null);
+
+ const setDraft = (k: string, v: string) => setDrafts((p) => ({ ...p, [k]: v }));
+
+ const save = (k: string) => {
+ const val = drafts[k]?.trim();
+ if (!val) return;
+ saveLocalKey(k, val);
+ setDrafts((p) => ({ ...p, [k]: '' }));
+ setSaved(k);
+ setTimeout(() => setSaved(null), 1800);
+ };
+
+ return (
+
+ 本地模型设置
+
+ 配置自定义 LLM 接口与密钥。这些信息仅保存在你的浏览器本地，服务端不存储、不传输持久化。
+
+
+
+
+
+ 本地 Key 仅写入浏览器 localStorage（按账户隔离），不会随分析请求持久化到服务端，也不会出现在公开报告中。
+ 清除浏览器数据将一并清除。配置后，分析将优先使用你的本地模型。
+
+
+
+ {!user && (
+
+ 本地 Key 按账户隔离保存，登录后才会启用。
+
+ )}
+
+
+ {PROVIDERS.map((p) => {
+ const has = user ? hasLocalKey(p.key) : false;
+ return (
+
+
+
+
{p.label}
+
{p.url || '需填写 Base URL'} · {p.models}
+
+ {has &&
已配置}
+
+
+ setDraft(p.key, e.target.value)}
+ placeholder={has ? '••••••••（输入新值可替换）' : '粘贴 API Key'}
+ className="h-10 flex-1 rounded-lg border border-dark-border bg-dark-input px-3 text-sm text-text-primary placeholder:text-text-tertiary focus:border-accent-primary focus:outline-none"
+ />
+
+ {has && (
+
+ )}
+
+
+ );
+ })}
+
订阅中心
+
+ 按次订阅。没有配置本地模型 Key 时，可消耗订阅次数使用系统大模型完成研究分析。
+
+
+
+
+
+
+
当前可用次数（示例）
+
{user ? '—' : '登录后查看'}
+
+
+
每完成一次研究分析扣除 1 次，使用本地 Key 不扣次数。
+
+ {PLANS.map((plan) => (
+
+ {plan.tag && (
+
{plan.tag}
+ )}
+
{plan.credits} 次
+
{plan.price}
+
{plan.per}
+
+
+ ))}
+
+
计费说明
+
+ - · 系统模型分析按完成报告扣除订阅次数，启动前预扣，失败自动回补。
+ - · 配置并使用本地模型 Key 时，不消耗订阅次数。
+ - · 所有行情与价格为示例 / 延迟数据，研究结论非投资建议。
+
+ {!user && (
+
登录后管理订阅
+ )}
+
+
+ {a.code}
+ {STANCE_LABEL[a.stance]}
+
+
{a.title}
+
暂无产出，待后续复核。
+
+
+ {a.code}
+ {STANCE_LABEL[a.stance]}
+
+
{a.title}
+
{a.summary}
+
+
+
+ {title}
+
+
{side.headline}
+
{side.summary}
+
+ {/* 0. Pinned decision */}
+
+
+
+
+ Risk Judge 最终裁决
+
+
{report.company} {report.ticker}
+
+
+
+ {d.confidence != null && (
+ 置信度 {d.confidence}%
+ )}
+
+
{d.rationale}
+
+
)[report.market] : undefined} />
+
{RISK_LABEL[d.riskLevel]}
+
{d.horizon ? {d.horizon} : 未给出}
+
{report.meta.sources} 条
+
+
+ {/* 1. Analyst team */}
+
+
+ {report.analysts.map((a) =>
)}
+
+
+ {/* 2. Research debate */}
+
+
+
+
+
+
+
+ 研究经理裁决
+
+
{report.debate.manager.summary}
+
+
+
+ {/* 3. Trader plan */}
+
+
+
+
+
)[report.market] : undefined} />
+ {report.traderPlan.positionCapPct != null && (
+ 仓位上限 {report.traderPlan.positionCapPct}%
+ )}
+
+ {report.traderPlan.hasContent && (
+
{report.traderPlan.summary}
+ )}
+
+ {report.traderPlan.note}
+
+
+
+ {/* 4. Risk debate */}
+
+
+
+
+
+
+
+
+ {/* 5. Summary */}
+ {report.summary && (
+
+ {report.summary}
+
+ )}
+
+
{report.meta.disclaimer}
+
+ {index}
+
{title}
+ {subtitle && · {subtitle}}
+
+ {children}
+
+ );
+}
diff --git a/web/frontend/src/components/site/DisclaimerBanner.tsx b/web/frontend/src/components/site/DisclaimerBanner.tsx
new file mode 100644
index 0000000..b5540a5
--- /dev/null
+++ b/web/frontend/src/components/site/DisclaimerBanner.tsx
@@ -0,0 +1,9 @@
+export function DisclaimerBanner() {
+ return (
+
+
+ 所有行情与价格为示例 / 延迟数据，本报告仅供研究参考，非投资建议，本站无任何下单执行入口。
+
+ );
+}
+
diff --git a/web/frontend/src/components/site/SearchBar.tsx b/web/frontend/src/components/site/SearchBar.tsx
new file mode 100644
index 0000000..34dc153
--- /dev/null
+++ b/web/frontend/src/components/site/SearchBar.tsx
@@ -0,0 +1,63 @@
+'use client';
+
+import { useRouter } from 'next/navigation';
+import { FormEvent, useState } from 'react';
+
+const EXAMPLES = [
+ '宁德时代海外扩张对未来 12 个月利润的影响',
+ '拆解小米汽车业务对整体估值的拉动',
+ '0700',
+ '招商银行 600036',
+];
+
+export function SearchBar({ size = 'lg' }: { size?: 'lg' | 'md' }) {
+ const router = useRouter();
+ const [value, setValue] = useState('');
+
+ const submit = (e: FormEvent) => {
+ e.preventDefault();
+ const q = value.trim();
+ if (!q) return;
+ router.push(`/research?q=${encodeURIComponent(q)}`);
+ };
+
+ const height = size === 'lg' ? 'h-14' : 'h-11';
+ const textSize = size === 'lg' ? 'text-base' : 'text-sm';
+
+ return (
+
+
+ {size === 'lg' && (
+
+ 快捷示例：
+ {EXAMPLES.map((ex) => (
+
+ ))}
+
+ )}
+
+
+
+
+ TradingAgents
+
+
多智能体研究
+
+
+
+
+
+ {user ? (
+
+
+ {user.username}
+
+
+
+ ) : (
+
+ 登录
+
+ )}
+
+
+
+
+ {children}
+
+
+ );
+}
+
diff --git a/web/frontend/src/lib/api/reports.ts b/web/frontend/src/lib/api/reports.ts
new file mode 100644
index 0000000..5501218
--- /dev/null
+++ b/web/frontend/src/lib/api/reports.ts
@@ -0,0 +1,66 @@
+import { apiClient, publicApiClient } from '@/lib/apiClient';
+import type { ReportPreview, RoleChainReport } from '@/types/report';
+
+// Detail payload from GET /api/reports/{id}
+export interface ReportDetail {
+ id: string;
+ ticker: string;
+ company_name: string;
+ market: 'US' | 'HK' | 'CN' | null;
+ source: { type: string; session_id: string | null; task_id: number | null };
+ conclusion: {
+ rating: number;
+ rating_label: string;
+ summary: string;
+ key_points: string[];
+ };
+ sections: Array<{
+ key: string;
+ title: string;
+ summary: string;
+ content: string;
+ }>;
+ status: string;
+ created_at: string | null;
+ updated_at: string | null;
+ role_chain?: RoleChainReport;
+}
+
+function unwrap(res: { data?: T }): T {
+ return res.data as T;
+}
+
+export const reportAPI = {
+ // Authenticated: my reports + public
+ list: async (params: { page?: number; limit?: number; ticker?: string; market?: string } = {}) => {
+ const { page = 1, limit = 20, ticker, market } = params;
+ const qs = new URLSearchParams({ page: String(page), limit: String(limit) });
+ if (ticker) qs.set('ticker', ticker);
+ if (market) qs.set('market', market);
+ const res = await apiClient.get<{ data: ReportPreview[]; meta: { total: number; has_next: boolean } }>(
+ `/api/reports?${qs.toString()}`,
+ );
+ return unwrap(res);
+ },
+
+ // Public feed for the home / leaderboard (no auth required)
+ publicFeed: async (limit = 12) => {
+ try {
+ const res = await publicApiClient.get<{ data: ReportPreview[]; meta: { total: number } }>(
+ `/api/reports/public?limit=${limit}`,
+ );
+ return unwrap(res);
+ } catch {
+ return { data: [], meta: { total: 0 } };
+ }
+ },
+
+ // Full report detail incl. role_chain
+ get: async (id: string) => {
+ const res = await apiClient.get<{ data: ReportDetail }>(`/api/reports/${id}`);
+ return res.data.data;
+ },
+
+ exportUrl: (id: string, format: 'md' | 'json' | 'pdf') =>
+ `/api/reports/${id}/export?format=${format}`,
+};
diff --git a/web/frontend/src/types/report.ts b/web/frontend/src/types/report.ts
new file mode 100644
index 0000000..f4c501e
--- /dev/null
+++ b/web/frontend/src/types/report.ts
@@ -0,0 +1,133 @@
+// Role-chain report contract — mirrors docs/report-role-chain-contract.md
+// and tradingagents/utils/role_chain.py 1:1.
+
+export type Market = 'US' | 'HK' | 'CN';
+export type Verdict = 'strong_buy' | 'buy' | 'overweight' | 'hold' | 'reduce' | 'watch';
+export type RiskLevel = 'low' | 'moderate' | 'elevated' | 'high';
+export type Stance = 'positive' | 'warm' | 'neutral' | 'cooling' | 'negative';
+export type Currency = 'USD' | 'HKD' | 'CNY';
+
+export interface PriceBand {
+ low: number;
+ high: number;
+ currency: Currency;
+ basis: '示例' | '延迟' | '收盘';
+}
+
+export interface RoleDecision {
+ verdict: Verdict;
+ verdictLabel: string;
+ rationale: string;
+ priceBand: PriceBand | null; // null -> show "示例 / 延迟", never invent
+ riskLevel: RiskLevel;
+ horizon: string | null;
+ confidence: number | null; // 0-100, null -> hide
+}
+
+export interface AnalystNode {
+ role: 'market' | 'social' | 'news' | 'fundamentals';
+ code: 'MKT' | 'SOC' | 'NEWS' | 'FND';
+ title: string;
+ subtitle: string;
+ stance: Stance;
+ summary: string;
+ evidence: string[];
+ hasContent: boolean;
+}
+
+export interface DebateSide {
+ headline: string;
+ summary: string;
+}
+
+export interface TraderPlan {
+ verdict: Verdict;
+ verdictLabel: string;
+ priceBand: PriceBand | null;
+ positionCapPct: number | null;
+ note: string; // fixed: "研究建议，非下单执行入口"
+ hasContent: boolean;
+ summary: string;
+}
+
+export interface RoleChainReport {
+ id: string;
+ ticker: string;
+ company: string;
+ market: Market | null;
+ title: string;
+ publishedAt: string;
+ author: { name: string };
+ modelId: string;
+ depth: 'lite' | 'standard' | 'deep';
+ decision: RoleDecision;
+ analysts: AnalystNode[];
+ debate: {
+ bull: DebateSide;
+ bear: DebateSide;
+ manager: { summary: string };
+ };
+ traderPlan: TraderPlan;
+ riskDebate: {
+ risky: DebateSide;
+ safe: DebateSide;
+ neutral: DebateSide;
+ };
+ summary: string;
+ meta: { sources: number; generatedAt: string; disclaimer: string };
+}
+
+// Trimmed shape returned by report list / leaderboard previews.
+export interface ReportPreview {
+ id: string;
+ ticker: string;
+ company_name: string;
+ market: Market | null;
+ rating: number;
+ rating_label: string;
+ summary: string;
+ status: string;
+ created_at: string | null;
+ trading_decision?: string;
+ role_chain?: { decision: RoleDecision; analysts: AnalystNode[] };
+}
+
+// verdict -> pill class + color helpers
+export const VERDICT_PILL: Record = {
+ strong_buy: 'verdict-bull',
+ buy: 'verdict-bull',
+ overweight: 'verdict-hold',
+ hold: 'verdict-hold',
+ reduce: 'verdict-bear',
+ watch: 'verdict-neutral',
+};
+
+export const STANCE_PILL: Record = {
+ positive: 'verdict-bull',
+ warm: 'verdict-hold',
+ neutral: 'verdict-neutral',
+ cooling: 'verdict-bear',
+ negative: 'verdict-bear',
+};
+
+export const STANCE_LABEL: Record = {
+ positive: '积极',
+ warm: '偏多',
+ neutral: '中性',
+ cooling: '偏空',
+ negative: '看空',
+};
+
+export const RISK_LABEL: Record = {
+ low: '低',
+ moderate: '中等',
+ elevated: '偏高',
+ high: '高',
+};
+
+export const MARKET_LABEL: Record = {
+ US: '美股',
+ HK: '港股',
+ CN: 'A股',
+};
+
diff --git a/web/frontend/tailwind.config.js b/web/frontend/tailwind.config.js
index 1c7a140..f903563 100644
--- a/web/frontend/tailwind.config.js
+++ b/web/frontend/tailwind.config.js
@@ -13,21 +13,32 @@ module.exports = {
colors: {
// Dark surfaces (mapped 1:1 onto the prior semantic tokens so the whole
// app re-skins without per-file edits).
- dark: {
- primary: '#0a0d12', // ink — application background (was #0a0e1a)
- secondary: '#171f2b', // surface — panels / cards (was #141824)
- tertiary: '#202b39', // raised — hover / secondary btns (was #1a1f2e)
- elevated: '#27333f', // elevated surfaces (was #1f2937)
- border: '#304154', // structural line (was #2d3748)
+ dark: {
+ primary: '#060a10', // ink — deep finance base
+ secondary: '#0e1620', // surface — panels / cards
+ tertiary: '#16202d', // raised — hover / secondary btns
+ elevated: '#1d2937', // elevated surfaces
+ border: '#243243', // structural line
+ input: '#0a1119', // recessed inputs
+ rail: '#0b131c', // side rail
+ hover: '#1a2636', // generic hover
},
// Workflow Desk accents
accent: {
- primary: '#9bffbe', // mint — primary action / current stage / success
- secondary: '#8acbff', // sky blue — flow / node identity
+ primary: '#9ee5c9', // mint — bull / primary action / success
+ secondary: '#81bbed', // sky blue — safe / flow / info
tertiary: '#5fb6e8', // tertiary blue
- hover: '#9bffbe', // hover state (mint)
+ hover: '#9ee5c9', // hover state (mint)
focus: '#8acbff', // focus state (blue)
},
+ // Verdict / stance semantic palette for the research report
+ verdict: {
+ bull: '#9ee5c9', // 看多 / 买入 / 积极
+ hold: '#e5bd72', // 持有 / 审慎 / 中性偏多
+ bear: '#f48b8b', // 看空 / 减持 / 偏空
+ safe: '#81bbed', // Safe / 稳健 / 信息
+ neutral: '#9aa9b8', // 中性
+ },
// Text colors for the dark theme
text: {
primary: '#f1f5f7', // primary text
@@ -110,11 +121,15 @@ module.exports = {
},
},
// Workflow Desk typography
- fontFamily: {
- sans: ['"Noto Sans SC"', '-apple-system', 'BlinkMacSystemFont', '"Segoe UI"', 'Roboto', '"Helvetica Neue"', 'Arial', 'sans-serif'],
- serif: ['"Instrument Serif"', 'ui-serif', 'Georgia', '"Times New Roman"', 'serif'],
- mono: ['"DM Mono"', 'ui-monospace', 'SFMono-Regular', 'Menlo', 'Consolas', 'monospace'],
- },
+ fontFamily: {
+ sans: ['"Noto Sans SC"', '-apple-system', 'BlinkMacSystemFont', '"Segoe UI"', 'Roboto', '"Helvetica Neue"', 'Arial', 'sans-serif'],
+ // Noto Serif SC for Chinese financial headlines (authoritative, editorial)
+ serif: ['"Noto Serif SC"', '"Songti SC"', 'ui-serif', 'Georgia', '"Times New Roman"', 'serif'],
+ // Tabular monospace for tickers / prices / verdicts / confidence
+ mono: ['"DM Mono"', '"JetBrains Mono"', 'ui-monospace', 'SFMono-Regular', 'Menlo', 'Consolas', 'monospace'],
+ num: ['"DM Mono"', 'ui-monospace', 'SFMono-Regular', 'Menlo', 'Consolas', 'monospace'],
+ heading: ['"Noto Serif SC"', '"Noto Sans SC"', 'ui-serif', 'Georgia', 'serif'],
+ },
// Bootstrap-compatible spacing
spacing: {
'0.5': '0.125rem', // 2px