feat(web): 字段库页 + 界面单位换算 + 因子目录参数化 + 选股策略条件表单
字段库与单位: - `/fields`:字段库管理页(中文名/说明可改、可停用;kind 是引擎事实不可改); 单位只在字段自己的阶梯里选(总市值 = 万元/亿元),越界 422 原样展示。 - `lib/units.ts`:界面单位 ⇄ 基准单位换算集中一处,条件输入按界面单位回显、 提交前换回基准单位(引擎只认基准单位,库里存的也永远是基准单位)。 - `SelectionStrategyForm` 取代 `StrategyParamsForm`:一个策略只定义「怎么选」 (股票池 + 因子 + 过滤条件),条件字段来自字段库接口而不是前端硬编码枚举。 因子参数化(名字即身份,界面不许藏): - `/factors` 新增「参数」列与展开行:精确引擎键、每个参数的允许范围、来源、依赖列 (依赖列标明「引擎事实,不可改」);说明文案从「不可修改」改为 「改参数 = 新建参数化因子 = 新身份,旧因子/既有策略不变义」。 - 「新建参数化因子」卡片:模板下拉 + 受控窗口(min/max)+ 方向枚举下拉, 实时预览规范键/中文名/渲染公式;后端 422 的原文原样展示,不静默截断。 - 因子下拉显示中文名(含参数)与短键,**value 一律是完整引擎键**; 停用的因子从各页候选里消失(/strategies、/selection、/signals、/factors/compose), 既有策略/归档仍按名字解析;`/factors/compose` 顺手修了勾选框点击目标过小。 - `/fields` 加提示:字段库只列内置因子名,参数化因子在 /factors 管理, 选股策略条件下拉里会一并出现。 tsc --noEmit 0 error;verify_ui_alignment 8 页 160 项全过(另跑 3 个选因子页 51/54)。
This commit is contained in:
@@ -1,22 +1,18 @@
|
||||
"use client";
|
||||
|
||||
/**
|
||||
* 策略说明的获取钩子。
|
||||
* 策略说明的获取钩子(2026-09 重构后简化)。
|
||||
*
|
||||
* 说明/公式由后端 `describe_strategy` 从 spec **真实推导**(不是前端拼字符串):
|
||||
* 这样「页面显示的公式」与「引擎实际执行的规则」只有一个来源,
|
||||
* 不会出现文案与实现漂移(本平台最怕的问题)。
|
||||
* 「页面显示的公式」与「引擎实际执行的规则」只有一个来源,不会文案与实现漂移。
|
||||
*
|
||||
* 两个入口:
|
||||
* - `useStrategyDoc(params)`:未保存的参数也能实时预览(POST /strategies/describe),
|
||||
* 带去抖,避免每次按键都请求。
|
||||
* - `useStrategyDocById(id)`:已保存策略(GET /strategies/{id}/describe)。
|
||||
* 重构后选股策略只含选股条件,说明走 `GET /strategies/{id}/describe`(需要已保存的 id);
|
||||
* 未保存参数的实时预览不再有意义(选股策略没有可即时预览的回测公式),故移除。
|
||||
*/
|
||||
import { useEffect, useMemo, useRef, useState } from "react";
|
||||
import { useEffect, useState } from "react";
|
||||
|
||||
import { apiGet, apiPost } from "@/lib/api";
|
||||
import { apiGet } from "@/lib/api";
|
||||
import type { StrategyDoc } from "@/lib/types";
|
||||
import { paramsToSpec, type StrategyParams } from "@/components/StrategyParamsForm";
|
||||
|
||||
export interface DocState {
|
||||
doc: StrategyDoc | null;
|
||||
@@ -26,54 +22,7 @@ export interface DocState {
|
||||
|
||||
const EMPTY: DocState = { doc: null, loading: false, error: "" };
|
||||
|
||||
/** 未保存参数 → 说明(去抖 500ms) */
|
||||
export function useStrategyDoc(params: StrategyParams | null, enabled = true): DocState {
|
||||
const [state, setState] = useState<DocState>(EMPTY);
|
||||
const timer = useRef<ReturnType<typeof setTimeout> | null>(null);
|
||||
// 只依赖会改变说明的字段,避免改「初始资金」也重新请求
|
||||
const key = useMemo(() => {
|
||||
if (!params) return "";
|
||||
return JSON.stringify({
|
||||
f: params.factors,
|
||||
a: params.priceAdjustment,
|
||||
n: params.topN,
|
||||
x: params.holdX,
|
||||
m: params.mMonths,
|
||||
y: params.yMonths,
|
||||
r: params.rebalance,
|
||||
fp: params.fillPolicy,
|
||||
c: params.conditions,
|
||||
s: params.excludeSt,
|
||||
l: params.minListingDays,
|
||||
cost: [params.commission, params.stamp, params.slippage, params.minCommission],
|
||||
});
|
||||
}, [params]);
|
||||
|
||||
useEffect(() => {
|
||||
if (!params || !enabled || !key) {
|
||||
setState(EMPTY);
|
||||
return;
|
||||
}
|
||||
let alive = true;
|
||||
if (timer.current) clearTimeout(timer.current);
|
||||
setState((s) => ({ ...s, loading: true }));
|
||||
timer.current = setTimeout(() => {
|
||||
apiPost<StrategyDoc>("/strategies/describe", paramsToSpec(params))
|
||||
.then((doc) => alive && setState({ doc, loading: false, error: "" }))
|
||||
.catch((e: Error) => alive && setState({ doc: null, loading: false, error: e.message }));
|
||||
}, 500);
|
||||
return () => {
|
||||
alive = false;
|
||||
if (timer.current) clearTimeout(timer.current);
|
||||
};
|
||||
// key 已覆盖所有影响说明的字段
|
||||
// eslint-disable-next-line react-hooks/exhaustive-deps
|
||||
}, [key, enabled]);
|
||||
|
||||
return state;
|
||||
}
|
||||
|
||||
/** 已保存策略 → 说明 */
|
||||
/** 已保存选股策略 → 说明(后端按选股条件推导) */
|
||||
export function useStrategyDocById(id: string | null): DocState {
|
||||
const [state, setState] = useState<DocState>(EMPTY);
|
||||
useEffect(() => {
|
||||
@@ -91,4 +40,4 @@ export function useStrategyDocById(id: string | null): DocState {
|
||||
};
|
||||
}, [id]);
|
||||
return state;
|
||||
}
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user