refactor: 尾盘策略统一更名为加密价差策略

- 前端：菜单父级「加密价差策略」，子项「策略配置」「实时监控」；i18n 与类型注释全部替换 - 后端：i18n、ErrorCode、DTO/实体/服务注释与日志「尾盘」→「加密价差策略」；TG 通知文案 - 文档：README、中英文用户指南、UI 规格、任务、流程、价差流程、市场数据、动态系数等全部更新 - 不修改 API 路径、路由、表名与类名，保持兼容 Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-25 21:30:50 +08:00
parent 4b277eaeab
commit c5d59dfdf9
39 changed files with 197 additions and 197 deletions
@@ -1,6 +1,6 @@
-# 尾盘策略文档 (Crypto Tail Strategy)
+# 加密价差策略文档 (Crypto Spread Strategy)

-本目录集中存放与 Polymarket 加密市场尾盘策略相关的文档。
+本目录集中存放与 Polymarket 加密市场加密价差策略相关的文档。

 ## 目录结构

@@ -55,7 +55,7 @@ effectiveMinSpread = baseSpread × coefficient

 - 需要策略的 `windowStartSeconds`、`windowEndSeconds` 传入计算处；若窗口长度为 0，可退化为系数 = 1.0 或 0.5（需约定）。

-**优点**：与「尾盘只在窗口内触发」一致，时间语义清晰；毫秒级 progress 更精确。  
+**优点**：与「加密价差策略只在窗口内触发」一致，时间语义清晰；毫秒级 progress 更精确。  
 **缺点**：`getAutoMinSpread` 需要增加当前时间（毫秒）和窗口参数（或传整个 strategy）。

 ---
@@ -1,8 +1,8 @@
-# Crypto Tail Strategy Configuration Guide
+# Crypto Spread Strategy Configuration Guide

-## Part 1: What is Crypto Tail Strategy?
+## Part 1: What is Crypto Spread Strategy?

-Crypto Tail Strategy is an automated trading strategy designed specifically for Polymarket crypto markets' **5-minute** or **15-minute** "Up or Down" markets.
+Crypto Spread Strategy is an automated trading strategy designed specifically for Polymarket crypto markets' **5-minute** or **15-minute** "Up or Down" markets.

 **Core Logic**: Within a specified time window, when the market price enters your set price range, the system will automatically buy at a fixed price (0.99) without manual operation.

@@ -39,7 +39,7 @@ Cycle Start → Within Time Window → Price Enters Range → Auto Order

 - **Maximum one trigger per cycle**: Within the same cycle, even if conditions are met multiple times, only one order is placed
 - **Fixed order price**: All orders are submitted at price 0.99
- **Requires separate wallet**: It's recommended to use a dedicated wallet for tail strategies to avoid conflicts with other operations (manual trading, copy trading, etc.)
+- **Requires separate wallet**: It's recommended to use a dedicated wallet for crypto spread strategies to avoid conflicts with other operations (manual trading, copy trading, etc.)

 ---

@@ -50,7 +50,7 @@ Cycle Start → Within Time Window → Price Enters Range → Auto Order
 | Parameter | Description | Required | Example |
 |-----------|-------------|----------|---------|
 | **Account** | Select the wallet account for trading | ✅ | Account A |
-| **Strategy Name** | Name your strategy for easy identification | ❌ | "BTC 15min Tail Strategy" |
+| **Strategy Name** | Name your strategy for easy identification | ❌ | "BTC 15min Crypto Spread Strategy" |
 | **Market** | Select the market to trade (5-minute or 15-minute) | ✅ | btc-updown-15m |

 ### 3.2 Cycle Settings
@@ -341,7 +341,7 @@ Enabled: On
 2. **Position conflicts**: Manual trading and strategy trading may conflict
 3. **Management confusion**: Difficult to distinguish which orders are from strategy vs manual

-**Recommendation**: Create a dedicated wallet, only for tail strategies.
+**Recommendation**: Create a dedicated wallet, only for crypto spread strategies.

 ### Q7: Why is the order price fixed at 0.99?

@@ -352,7 +352,7 @@ Enabled: On

 ### Q8: Does the strategy depend on auto-redeem functionality?

-**A**: Yes, tail strategy depends on auto-redeem functionality.
+**A**: Yes, crypto spread strategy depends on auto-redeem functionality.

 **Reasons**:
 - Strategy orders create positions after execution
@@ -411,7 +411,7 @@ Enabled: On

 ### 7.1 View Strategy List

-On the "Crypto Tail Strategy" page, you can view all strategies:
+On the "Crypto Spread Strategy" page, you can view all strategies:
 - Strategy name
 - Market information
 - Time window
@@ -453,7 +453,7 @@ After deleting a strategy:

 ## Part 8: Summary

-Crypto Tail Strategy is a powerful automated trading tool that can help you:
+Crypto Spread Strategy is a powerful automated trading tool that can help you:

 1. **Automated Trading**: No need for manual monitoring, system executes automatically
 2. **Precise Control**: Precisely control trigger conditions through time windows and price ranges
@@ -1,4 +1,4 @@
-# 加密市场尾盘策略 - 流程图
+# 加密价差策略 - 流程图

 ## 一、整体架构

@@ -1,4 +1,4 @@
-# 加密市场尾盘策略 - 5/15 分钟市场数据获取说明
+# 加密价差策略 - 5/15 分钟市场数据获取说明

 > 前端 UI 与交互详见 `crypto-tail-strategy-ui-spec.md`。

@@ -1,8 +1,8 @@
-# 尾盘策略 - 最小价差参数流程分析
+# 加密价差策略 - 最小价差参数流程分析

 ## 一、需求摘要

-在现有尾盘策略上增加**最小价差**参数：当策略条件（时间窗、价格区间）满足时，再判断**当前周期 Binance K 线的开盘价与收盘价价差**是否满足最小价差；满足才下单，不满足则等待，直到价差满足再下单。
+在现有加密价差策略上增加**最小价差**参数：当策略条件（时间窗、价格区间）满足时，再判断**当前周期 Binance K 线的开盘价与收盘价价差**是否满足最小价差；满足才下单，不满足则等待，直到价差满足再下单。

 - **后端**：需订阅币安对应币对（如 BTC/USDC）的 K 线，维护当前周期的**开盘价**与**实时收盘价**，并在触发时做价差校验。
 - **前端**：可配置三种场景——无、固定、自动（见下）。
@@ -244,4 +244,4 @@ sequenceDiagram
 3. **下单与去重**  
   - 仍保持「每周期最多触发一次」；价差不满足时不写触发记录，直到某次同时满足价格与价差后才下单并写记录。

-按上述流程即可在现有尾盘策略上接入「最小价差」参数，并由后端订阅币安 K 线、在触发前做价差校验；固定与自动的时序差异见**第六节时序图**。
+按上述流程即可在现有加密价差策略上接入「最小价差」参数，并由后端订阅币安 K 线、在触发前做价差校验；固定与自动的时序差异见**第六节时序图**。
@@ -1,4 +1,4 @@
-# 加密市场尾盘策略 - 任务梳理
+# 加密价差策略 - 任务梳理

 > 需求与 UI 见 `crypto-tail-strategy-ui-spec.md`，市场数据与执行规则见 `crypto-tail-strategy-market-data.md`。

@@ -66,7 +66,7 @@

 | 序号 | 任务 | 说明 |
 |------|------|------|
-| B16 | 自动赎回包含尾盘策略仓位 | 尾盘策略产生的仓位与跟单/手动一视同仁，纳入现有自动赎回逻辑，不排除（见 UI 规格附录 A）。 |
+| B16 | 自动赎回包含加密价差策略仓位 | 加密价差策略产生的仓位与跟单/手动一视同仁，纳入现有自动赎回逻辑，不排除（见 UI 规格附录 A）。 |
 | B17 | 调度/定时或常驻 | 对已启用策略按周期（如每 10–30 秒）检查：当前周期、是否在时间窗口内、是否已触发、价格是否进区间；满足则执行下单并写触发记录。 |

 ---
@@ -78,7 +78,7 @@
 | 序号 | 任务 | 说明 |
 |------|------|------|
 | F1 | 路由 | App.tsx 增加 `/crypto-tail-strategy`、可选 `/crypto-tail-strategy/records/:id`。 |
-| F2 | 菜单 | Layout 中增加「尾盘策略」菜单项，与跟单同级或在其下；key 与路由一致。 |
+| F2 | 菜单 | Layout 中增加「加密价差策略」菜单项，与跟单同级或在其下；key 与路由一致。 |

 ### 4.2 列表页

@@ -146,5 +146,5 @@ F10 触发记录
 - **时间区间**：仅当周期内当前时间落在 [windowStartSeconds, windowEndSeconds] 时才判断价格并下单；前端区间开始 ≤ 结束，且不超出 5min/15min。
 - **每周期一次**：同一策略同一周期只触发一次（先满足价格的 outcome 买入，反方向不买）。
 - **重试**：下单失败最多重试 2 次，共 3 次；仍失败记入触发记录为失败。
- **自动赎回**：尾盘策略产生的仓位可被自动赎回，无排除逻辑。
+- **自动赎回**：加密价差策略产生的仓位可被自动赎回，无排除逻辑。
 - **创建前检查**：未配置自动赎回时点击新增策略弹出「去配置」弹窗，不打开表单。
@@ -1,4 +1,4 @@
-# 加密市场尾盘策略 - 前端 UI 规格
+# 加密价差策略 - 前端 UI 规格

 > 周期推导与市场数据获取详见 `crypto-tail-strategy-market-data.md`。

@@ -10,7 +10,7 @@

 | 项目 | 说明 |
 |------|------|
-| **菜单** | 在「跟单管理」同级或其下增加一项，如「尾盘策略」，key 建议 `/crypto-tail-strategy`。 |
+| **菜单** | 在「跟单管理」同级或其下增加一项，如「加密价差策略」，key 建议 `/crypto-tail-strategy`。 |
 | **路由** | 列表页 `/crypto-tail-strategy`；可选详情/触发记录 `/crypto-tail-strategy/records/:id`。 |

 参考：`Layout.tsx` 中 `/copy-trading`、`/backtest` 的配置；`App.tsx` 中对应 `Route`。
@@ -26,7 +26,7 @@

 | 元素 | 类型 | 说明 |
 |------|------|------|
-| 页面标题 | 标题文案 | 如「加密尾盘策略」，用 `t('cryptoTailStrategy.list.title')`。 |
+| 页面标题 | 标题文案 | 如「加密价差策略」，用 `t('cryptoTailStrategy.list.title')`。 |
 | **钱包使用提示** | **Alert（Warning）** | **必须**在页面顶部或标题下方展示：提示用户**使用单独/专用钱包**运行本策略，避免该钱包用于手动交易、跟单等其他操作，否则可能导致余额或仓位变化，进而造成策略执行异常（如余额不足、下单失败等）。文案走多语言 `t('cryptoTailStrategy.list.walletTip')`，可带 `showIcon`。 |
 | 新增策略 | Button（Primary） | 点击时**先检查自动赎回相关配置**（见 2.4）；若未配置则弹出「去配置」简易弹窗，若已配置则打开「新增策略」表单弹窗。图标可用 `PlusOutlined`。 |
 | 筛选（可选） | Select / 筛选项 | 按账户、启用状态筛选；移动端可收起到抽屉或折叠。 |
@@ -59,7 +59,7 @@
 1. **检查**：请求系统配置（如 `apiService.systemConfig.getConfig()` 或已有接口），判断是否已配置 Builder API Key（及可选：自动赎回已开启）。若 `builderApiKeyConfigured === false`（或后端约定之「未配置」状态），视为未配置。
 2. **未配置时**：不打开新增策略表单，改为弹出**简易弹窗**（Modal），内容建议：
   - **标题**：如「请先配置自动赎回」，`t('cryptoTailStrategy.redeemRequiredModal.title')`。
-   - **正文**：简短说明尾盘策略依赖自动赎回，需要先在「系统设置」中配置 Builder API Key 及自动赎回。文案 `t('cryptoTailStrategy.redeemRequiredModal.description')`。
+   - **正文**：简短说明加密价差策略依赖自动赎回，需要先在「系统设置」中配置 Builder API Key 及自动赎回。文案 `t('cryptoTailStrategy.redeemRequiredModal.description')`。
   - **操作**：
     - **去配置**：主按钮，点击后关闭弹窗并跳转到系统设置页（如 `/system-settings`，该页含 Relayer 配置与自动赎回开关）。
     - **取消**：次按钮或关闭图标，仅关闭弹窗。
@@ -133,7 +133,7 @@
 |------|------|
 | **钱包提示** | 列表页与新增/编辑表单**必须**包含「使用单独钱包」的 Alert 提示，避免用户用混用钱包导致异常；文案走多语言。 |
 | **创建前检查** | 点击「新增策略」时先检查自动赎回/Builder API 是否已配置；未配置则弹出简易「去配置」弹窗，引导用户到系统设置配置 API Key 与自动赎回，不打开策略表单。 |
-| 多语言 | 所有文案 `t('cryptoTailStrategy.xxx')`，在 `locales/zh-CN`、`zh-TW`、`en` 的 `common.json` 中增加键。需包含：`cryptoTailStrategy.list.walletTip`、`cryptoTailStrategy.form.walletTip`，以及 `cryptoTailStrategy.redeemRequiredModal.title`、`cryptoTailStrategy.redeemRequiredModal.description`、`cryptoTailStrategy.redeemRequiredModal.goToSettings`、`cryptoTailStrategy.redeemRequiredModal.cancel`。文案示例：列表页 `walletTip`：「请使用单独的钱包运行尾盘策略，避免该钱包用于手动交易、跟单等其他操作，否则可能导致余额或仓位变化，造成策略执行异常。」表单内 `walletTip`：「建议使用专用钱包，避免手动操作等导致余额或下单异常。」未配置赎回弹窗 `title`：「请先配置自动赎回」；`description`：「尾盘策略依赖自动赎回功能，请先在系统设置中配置 Builder API Key 并开启自动赎回。」；`goToSettings`：「去配置」；`cancel`：「取消」。 |
+| 多语言 | 所有文案 `t('cryptoTailStrategy.xxx')`，在 `locales/zh-CN`、`zh-TW`、`en` 的 `common.json` 中增加键。需包含：`cryptoTailStrategy.list.walletTip`、`cryptoTailStrategy.form.walletTip`，以及 `cryptoTailStrategy.redeemRequiredModal.title`、`cryptoTailStrategy.redeemRequiredModal.description`、`cryptoTailStrategy.redeemRequiredModal.goToSettings`、`cryptoTailStrategy.redeemRequiredModal.cancel`。文案示例：列表页 `walletTip`：「请使用单独的钱包运行加密价差策略，避免该钱包用于手动交易、跟单等其他操作，否则可能导致余额或仓位变化，造成策略执行异常。」表单内 `walletTip`：「建议使用专用钱包，避免手动操作等导致余额或下单异常。」未配置赎回弹窗 `title`：「请先配置自动赎回」；`description`：「加密价差策略依赖自动赎回功能，请先在系统设置中配置 Builder API Key 并开启自动赎回。」；`goToSettings`：「去配置」；`cancel`：「取消」。 |
 | 金额 | 统一 `formatUSDC`（见 frontend.mdc）。 |
 | 响应式 | `useMediaQuery`；按钮触摸目标 ≥ 44px；移动端主操作突出。 |
 | 类型 | 不用 `any`；为策略、触发记录定义 TypeScript 类型。 |
@@ -150,7 +150,7 @@
 | 新增/编辑弹窗 | `frontend/src/pages/CryptoTailStrategyList/FormModal.tsx` 或内嵌 Modal |
 | 触发记录 | `frontend/src/pages/CryptoTailStrategyList/TriggerRecordsModal.tsx` 或 `CryptoTailStrategyRecords.tsx` |
 | 路由 | `App.tsx` 中 `/crypto-tail-strategy`、可选 `/crypto-tail-strategy/records/:id` |
-| 菜单 | `Layout.tsx` 中增加「尾盘策略」菜单项 |
+| 菜单 | `Layout.tsx` 中增加「加密价差策略」菜单项 |
 | 类型 | `frontend/src/types/index.ts` 或 `types/cryptoTailStrategy.ts` 中增加策略与触发记录类型 |
 | 多语言 | `frontend/src/locales/{zh-CN,zh-TW,en}/common.json` 中增加 `cryptoTailStrategy.*` |

@@ -158,7 +158,7 @@

 ## 7. 小结：UI 包含的主要元素

- **导航**：主导航中「尾盘策略」入口。
+- **导航**：主导航中「加密价差策略」入口。
 - **列表页**：标题、钱包提示 Alert、新增按钮（点击前先检查赎回配置，未配置则弹「去配置」简易弹窗）、筛选、表格/卡片（策略名、市场、价格区间、投入方式、状态、最近触发、操作）、加载与空状态。
 - **未配置赎回弹窗**：简易 Modal，提示依赖自动赎回、需先配置 Builder API Key 与自动赎回；按钮「去配置」（跳转 `/system-settings`）、「取消」。
 - **表单弹窗**：策略名、账户、市场选择、minPrice/maxPrice、投入方式（比例/固定）、启用开关、提交/取消。
@@ -169,9 +169,9 @@

 ## 附录 A 后端/产品要求：自动赎回须支持本策略仓位

-自动赎回逻辑**必须支持赎回由尾盘策略产生的订单所对应的仓位**。即：本策略触发的市价买入会形成仓位，这些仓位在满足「可赎回」条件时，应被纳入现有自动赎回流程并正常发起赎回，不得因来源为「尾盘策略」而被排除。后端实现时需保证：
+自动赎回逻辑**必须支持赎回由加密价差策略产生的订单所对应的仓位**。即：本策略触发的市价买入会形成仓位，这些仓位在满足「可赎回」条件时，应被纳入现有自动赎回流程并正常发起赎回，不得因来源为「加密价差策略」而被排除。后端实现时需保证：

- 尾盘策略下单产生的仓位，与跟单/手动下单等来源的仓位一视同仁，参与可赎回查询与批量赎回；
- 若当前自动赎回按账户或仓位类型过滤，需将「尾盘策略订单产生的仓位」包含在内。
+- 加密价差策略下单产生的仓位，与跟单/手动下单等来源的仓位一视同仁，参与可赎回查询与批量赎回；
+- 若当前自动赎回按账户或仓位类型过滤，需将「加密价差策略订单产生的仓位」包含在内。

 这样前端所依赖的「自动赎回」对该策略才完整有效。
@@ -1,8 +1,8 @@
-# 尾盘策略配置指南
+# 加密价差策略配置指南

-## 一、什么是尾盘策略？
+## 一、什么是加密价差策略？

-尾盘策略是一种自动化交易策略，专门用于 Polymarket 加密市场的 **5分钟** 或 **15分钟** "Up or Down" 市场。
+加密价差策略是一种自动化交易策略，专门用于 Polymarket 加密市场的 **5分钟** 或 **15分钟** "Up or Down" 市场。

 **核心逻辑**：在指定时间窗口内，当市场价格进入您设定的价格区间时，系统会自动以固定价格（0.99）买入，无需手动操作。

@@ -39,7 +39,7 @@

 - **每周期最多触发一次**：同一个周期内，即使多次满足条件，也只下单一次
 - **固定下单价格**：所有订单都以 0.99 的价格提交
- **需要单独钱包**：建议使用专门的钱包运行尾盘策略，避免与其他操作（手动交易、跟单等）冲突
+- **需要单独钱包**：建议使用专门的钱包运行加密价差策略，避免与其他操作（手动交易、跟单等）冲突

 ---

@@ -50,7 +50,7 @@
 | 参数 | 说明 | 必填 | 示例 |
 |------|------|------|------|
 | **账户** | 选择用于交易的钱包账户 | ✅ | 账户A |
-| **策略名称** | 给策略起个名字，方便识别 | ❌ | "BTC 15分钟尾盘策略" |
+| **策略名称** | 给策略起个名字，方便识别 | ❌ | "BTC 15分钟加密价差策略" |
 | **市场** | 选择要交易的市场（5分钟或15分钟） | ✅ | btc-updown-15m |

 ### 3.2 周期设置
@@ -341,7 +341,7 @@
 2. **仓位冲突**：手动交易和策略交易可能产生冲突
 3. **管理混乱**：难以区分哪些订单是策略产生的，哪些是手动产生的

-**建议**：创建一个专门的钱包，只用于尾盘策略。
+**建议**：创建一个专门的钱包，只用于加密价差策略。

 ### Q7：下单价格为什么是固定的 0.99？

@@ -352,7 +352,7 @@

 ### Q8：策略需要依赖自动赎回功能吗？

-**A**：是的，尾盘策略依赖自动赎回功能。
+**A**：是的，加密价差策略依赖自动赎回功能。

 **原因**：
 - 策略下单后会形成仓位
@@ -411,7 +411,7 @@

 ### 7.1 查看策略列表

-在「尾盘策略」页面可以查看所有策略：
+在「加密价差策略」页面可以查看所有策略：
 - 策略名称
 - 市场信息
 - 时间窗口
@@ -453,7 +453,7 @@

 ## 八、总结

-尾盘策略是一个强大的自动化交易工具，可以帮助您：
+加密价差策略是一个强大的自动化交易工具，可以帮助您：

 1. **自动化交易**：无需手动盯盘，系统自动执行
 2. **精准控制**：通过时间窗口和价格区间精确控制触发条件