Files
worldquant-alpha-system/frontend/src/research/FeaturesPage.tsx
T

387 lines
12 KiB
TypeScript
Raw Normal View History

import { useEffect, useRef, useState } from "react";
import {
Banner,
Button,
Input,
Pagination,
TextArea,
Toast,
} from "@douyinfe/semi-ui-19";
import { api, post } from "../api";
import type { PageContext, UIAction } from "../ai/types";
import { TemplateEditor } from "./TemplateEditor";
import { ResearchSelect } from "./ResearchSelect";
import { blankTemplate } from "./workspaceTypes";
import type { Asset, InputSnapshot, Template } from "./workspaceTypes";
import "./workspace.css";
type Feature = {
name: string;
hypothesis: string;
input_ids: string[];
steps: { name: string; rationale: string; expression: string }[];
template: Template | null;
};
type FeatureAsset = Omit<Asset, "content"> & { content: Feature };
const blank = (): Feature => ({
name: "新特征方案",
hypothesis: "",
input_ids: [],
steps: [],
template: blankTemplate(),
});
export function FeaturesPage({
active,
onAction,
onContext,
action,
}: {
active: boolean;
action?: UIAction | null;
onAction: (action: UIAction) => void;
onContext: (context: PageContext) => void;
}) {
const [draft, setDraft] = useState<Feature>(blank);
const [asset, setAsset] = useState<FeatureAsset | null>(null);
const [items, setItems] = useState<FeatureAsset[]>([]);
const [inputs, setInputs] = useState<InputSnapshot[]>([]);
const [versions, setVersions] = useState<{ version: number }[]>([]);
const [page, setPage] = useState(1);
const [total, setTotal] = useState(0);
const [q, setQ] = useState("");
const [busy, setBusy] = useState("");
const [error, setError] = useState("");
const [revision, setRevision] = useState(0);
useEffect(() => {
if (!active) return;
const controller = new AbortController();
Promise.all([
api<{ items: FeatureAsset[]; total: number }>(
`/research/assets?kind=feature&q=${encodeURIComponent(q)}&offset=${(page - 1) * 25}`,
{ signal: controller.signal },
),
api<{ items: InputSnapshot[] }>("/research/inputs", {
signal: controller.signal,
}),
])
.then(([list, fixed]) => {
setItems(list.items);
setTotal(list.total);
setInputs(fixed.items);
})
.catch((e) => {
if (!controller.signal.aborted) setError(e.message);
});
return () => controller.abort();
}, [active, page, q, revision]);
useEffect(() => {
if (active) onContext({ page: "features", research_asset_id: asset?.id });
}, [active, asset?.id, onContext]);
const handled = useRef(0);
useEffect(() => {
if (
!active ||
action?.type !== "open_feature" ||
handled.current === action.nonce
)
return;
handled.current = action.nonce;
void run("load", async () =>
load(
await api(
`/research/assets/${action.asset_id}${action.version ? `?version=${action.version}` : ""}`,
),
),
);
}, [active, action]);
async function load(item: FeatureAsset) {
setAsset(item);
setDraft(item.content);
setVersions(await api(`/research/assets/${item.id}/versions`));
}
async function run(name: string, work: () => Promise<void>) {
setBusy(name);
setError("");
try {
await work();
} catch (e) {
setError((e as Error).message);
} finally {
setBusy("");
}
}
async function save() {
const saved = await api<FeatureAsset>(
`/research/assets${asset ? `/${asset.id}` : ""}`,
{
method: asset ? "PUT" : "POST",
body: JSON.stringify({
kind: "feature",
version: asset?.version,
content: draft,
}),
},
);
await load(saved);
setRevision((n) => n + 1);
return saved;
}
return (
<section className="research-workspace">
<div className="section-toolbar">
<div>
<h2>特征工程</h2>
<p className="muted">
围绕固定字段记录处理步骤与经济假设,再进入模板、候选和回测闭环。
</p>
</div>
<Button
onClick={() => {
setAsset(null);
setDraft(blank());
setVersions([]);
}}
>
新建特征方案
</Button>
</div>
{error && <Banner type="danger" description={error} />}
<div className="research-layout">
<aside className="research-library">
<Input
aria-label="搜索特征方案"
placeholder="搜索方案"
value={q}
onChange={(v) => {
setQ(v);
setPage(1);
}}
/>
{items.map((item) => (
<Button
key={item.id}
block
theme={asset?.id === item.id ? "light" : "borderless"}
onClick={() => void run("load", () => load(item))}
>
{item.name} · v{item.version}
</Button>
))}
<Pagination
size="small"
currentPage={page}
pageSize={25}
total={total}
onPageChange={setPage}
/>
</aside>
<div className="research-main">
<div className="inline-actions">
{asset && (
<>
<span>版本</span>
<ResearchSelect
label="特征方案版本"
value={asset.version}
optionList={versions.map((v) => ({
value: v.version,
label: `v${v.version}`,
}))}
onChange={(v) =>
void run("load", async () => {
await load(
await api(`/research/assets/${asset.id}?version=${v}`),
);
})
}
/>
</>
)}
</div>
<label>
方案名称
<Input
aria-label="特征方案名称"
value={draft.name}
onChange={(name) => setDraft({ ...draft, name })}
/>
</label>
<label>
经济假设
<TextArea
aria-label="特征经济假设"
value={draft.hypothesis}
onChange={(hypothesis) => setDraft({ ...draft, hypothesis })}
/>
</label>
<label>
固定输入
<ResearchSelect
label="特征固定输入"
multiple
filter
value={draft.input_ids}
optionList={inputs.map((i) => ({
value: i.id,
label: `${i.dataset_id} · ${i.scope.region}/${i.scope.universe}/D${i.scope.delay} · ${i.field_ids.length} 字段 · ${i.id.slice(0, 8)}`,
}))}
onChange={(v) => setDraft({ ...draft, input_ids: v as string[] })}
/>
</label>
{inputs
.filter((i) => draft.input_ids.includes(i.id))
.map((i) => (
<details key={i.id}>
<summary>{i.dataset_id} 的固定字段</summary>
<p className="muted">{i.field_ids.join("、")}</p>
</details>
))}
<div className="section-toolbar">
<h3>处理与迭代步骤</h3>
<Button
onClick={() =>
setDraft({
...draft,
steps: [
...draft.steps,
{ name: "", rationale: "", expression: "" },
],
})
}
>
添加处理步骤
</Button>
</div>
{draft.steps.map((step, index) => (
<div className="research-card" key={index}>
<label>
步骤 {index + 1}
<Input
aria-label={`步骤 ${index + 1} 名称`}
value={step.name}
onChange={(name) =>
setDraft({
...draft,
steps: draft.steps.map((s, i) =>
i === index ? { ...s, name } : s,
),
})
}
/>
</label>
<label>
理由
<TextArea
aria-label={`步骤 ${index + 1} 理由`}
value={step.rationale}
onChange={(rationale) =>
setDraft({
...draft,
steps: draft.steps.map((s, i) =>
i === index ? { ...s, rationale } : s,
),
})
}
/>
</label>
<label>
候选表达式
<TextArea
aria-label={`步骤 ${index + 1} 表达式`}
value={step.expression}
onChange={(expression) =>
setDraft({
...draft,
steps: draft.steps.map((s, i) =>
i === index ? { ...s, expression } : s,
),
})
}
/>
</label>
<Button
type="danger"
theme="borderless"
onClick={() =>
setDraft({
...draft,
steps: draft.steps.filter((_, i) => i !== index),
})
}
>
删除此步骤
</Button>
</div>
))}
<h3>输出模板</h3>
<TemplateEditor
value={draft.template || blankTemplate()}
inputs={inputs.filter((i) => draft.input_ids.includes(i.id))}
onChange={(template) => setDraft({ ...draft, template })}
/>
<div className="inline-actions">
<Button
theme="solid"
loading={busy === "save"}
disabled={Boolean(busy)}
onClick={() =>
void run("save", async () => {
await save();
Toast.success("特征方案版本已保存");
})
}
>
保存特征方案
</Button>
<Button
disabled={Boolean(busy)}
loading={busy === "convert"}
onClick={() =>
void run("convert", async () => {
const fixed = await save();
const template = await post<Asset>(
`/research/features/${fixed.id}/template`,
{ version: fixed.version },
);
onAction({
type: "open_template",
asset_id: template.id,
version: template.version,
nonce: Date.now(),
});
})
}
>
保存并转为模板
</Button>
<Button
disabled={
Boolean(busy) || !draft.input_ids.length || !draft.hypothesis
}
loading={busy === "generate"}
onClick={() =>
void run("generate", async () => {
await load(
await post<FeatureAsset>("/research/generate", {
name: draft.name,
hypothesis: draft.hypothesis,
input_ids: draft.input_ids,
method: "feature",
}),
);
setRevision((n) => n + 1);
})
}
>
AI 生成新方案
</Button>
</div>
<p className="research-hint">
保存步骤不会计算原始时间序列。转换后的模板保留此方案的完整版本,回测前仍需展开校验并确认候选。
</p>
</div>
</div>
</section>
);
}