Normalize fullwidth punctuation to ASCII across codebase.

Add scripts/normalize_ambiguous_unicode.py; fix corrupted patch_instance_theme_templates.py. Preserves curly quotes in string literals; removes Git homoglyph warnings on .env.example.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
dekun
2026-07-08 23:42:26 +08:00
parent aaa72c7961
commit b733e551a0
392 changed files with 71522 additions and 71369 deletions
+42 -42
View File
@@ -1,12 +1,12 @@
# 系统设置页说明
本文档描述各交易实例 Web 端 **「系统设置」** 页各区块功能与 env 配置页的分工以及导航显示开关规则
本文档描述各交易实例 Web 端 **「系统设置」** 页各区块功能,与 env 配置页的分工,以及导航显示开关规则.
---
## 1. 页面结构
系统设置为 **两列卡片** 布局各区块可在「导航显示」中单独开关见第 2 节)。
系统设置为 **两列卡片** 布局,各区块可在「导航显示」中单独开关(见第 2 节).
| 区块 | 默认显示 | 说明 |
|------|----------|------|
@@ -16,9 +16,9 @@
| 数据导出 | 可关 | 下载 CSV |
| 币种兑换 | 可关 | 仅 OKX 期权相关 |
| 期权资金划转 | 可关 | 仅 OKX |
| 期权设置面板 | OKX 有模块时 | 较大块占整行 |
| 期权设置面板 | OKX 有模块时 | 较大块,占整行 |
**固定不可隐藏**顶栏):关键位监控实盘下单系统设置
**固定不可隐藏**(顶栏):关键位监控,实盘下单,系统设置.
---
@@ -34,9 +34,9 @@
| 统计分析 | 统计分析 |
| 风控说明 | 风控说明 |
| env 配置 | env 配置 |
| 期权 | 期权仅 OKX 等有期权模块时有效 |
| 期权 | 期权(仅 OKX 等有期权模块时有效) |
保存后 **立即生效**无需重启中控 iframe 内嵌导航同步生效
保存后 **立即生效**,无需重启.中控 iframe 内嵌导航同步生效.
### 2.2 系统设置内区块开关
@@ -54,28 +54,28 @@
### 用途
- 修改 **直链打开实例**`/login` 使用的用户名与密码
- 写入本实例目录 `.env``APP_USERNAME``APP_PASSWORD`
- **三所建议使用相同账号**便于记忆本页仅改 **当前实例**`.env`若需三所一致请分别保存或后续做批量同步
- 修改 **直链打开实例**`/login` 使用的用户名与密码.
- 写入本实例目录 `.env``APP_USERNAME`,`APP_PASSWORD`.
- **三所建议使用相同账号**,便于记忆;本页仅改 **当前实例**`.env`,若需三所一致请分别保存或后续做批量同步.
### 与中控 / 密钥的关系
| 项目 | 是否在系统设置改 | 说明 |
|------|------------------|------|
| 网页登录密码 | ✅ | 本区块 |
| 中控通信密钥 `HUB_BRIDGE_TOKEN` | ❌ | 部署时自动生成中控与实例一致 |
| 登录会话密钥 `FLASK_SECRET_KEY` | ❌ | 部署时自动生成三所相同 |
| 交易所 API | ❌ | 在 **env 配置**各所自配 |
| AI 复盘 / OpenAI | ❌ | 在中控 **系统设置 → AI 配置**同步三所 |
| 中控通信密钥 `HUB_BRIDGE_TOKEN` | ❌ | 部署时自动生成,中控与实例一致 |
| 登录会话密钥 `FLASK_SECRET_KEY` | ❌ | 部署时自动生成,三所相同 |
| 交易所 API | ❌ | 在 **env 配置**(各所自配) |
| AI 复盘 / OpenAI | ❌ | 在中控 **系统设置 → AI 配置**(同步三所) |
### 操作流程
1. 输入 **当前密码**`.env``APP_PASSWORD` 一致)。
2. 可选填 **新用户名**不填则保持原用户名
3. 输入 **新密码****确认密码**至少 6 位)。
4. 保存后 **自动重启当前实例**PM2),请用新密码登录
1. 输入 **当前密码**(`.env``APP_PASSWORD` 一致).
2. 可选填 **新用户名**;不填则保持原用户名.
3. 输入 **新密码****确认密码**(至少 6 位).
4. 保存后 **自动重启当前实例**(PM2),请用新密码登录.
经中控 SSO 打开实例时通常无需输入实例密码改密主要影响 **直链访问**
经中控 SSO 打开实例时,通常无需输入实例密码;改密主要影响 **直链访问**.
---
@@ -83,7 +83,7 @@
### 用途
**子账户永续** 场景下**资金账户funding****交易账户swap** 之间手动划转 USDT
**子账户永续** 场景下,**资金账户(funding)****交易账户(swap)** 之间手动划转 USDT.
### 与 env 配置的关系
@@ -92,36 +92,36 @@
| **手动**划转一笔 | ✅ 本区块 | ❌ |
| **自动**每日划转规则 | ❌ | ✅「自动划转」卡片 |
自动划转规则开关目标余额整点等在 env 配置中维护见 [env配置说明.md](./env配置说明.md)
自动划转规则(开关,目标余额,整点等)在 env 配置中维护,见 [env配置说明.md](./env配置说明.md).
---
## 5. 数据导出
提供 CSV 下载版本号见页内标注):
提供 CSV 下载(版本号见页内标注):
| 链接 | 内容 |
|------|------|
| 交易记录 | 成交/订单相关导出 |
| 复盘记录 | 复盘日记 |
| 关键位当前 | 当前关键位列表 |
| 关键位(当前) | 当前关键位列表 |
| 关键位历史 | 历史关键位 |
导出为只读操作不修改配置
导出为只读操作,不修改配置.
---
## 6. 期权相关仅 OKX
## 6. 期权相关(仅 OKX)
当实例启用期权模块时系统设置可能包含
当实例启用期权模块时,系统设置可能包含:
- **币种兑换**期权账户内币种兑换操作
- **期权资金划转**期权与永续/资金账户间划转
- **期权设置面板**页内期权参数与状态大块区域
- **币种兑换**:期权账户内币种兑换操作
- **期权资金划转**:期权与永续/资金账户间划转
- **期权设置面板**:页内期权参数与状态(大块区域)
是否在顶栏显示「期权」Tab**导航显示 → 期权** 控制是否在设置页显示兑换/划转卡片由对应子开关控制
是否在顶栏显示「期权」Tab,**导航显示 → 期权** 控制;是否在设置页显示兑换/划转卡片,由对应子开关控制.
期权 env 参数API预算策略默认值**env 配置 → 期权账户** 维护见 [期权用法.md](./期权用法.md)
期权 env 参数(API,预算,策略默认值)**env 配置 → 期权账户** 维护,见 [期权用法.md](./期权用法.md).
---
@@ -129,30 +129,30 @@
| 页面 | 顶栏资金信息 | 说明 |
|------|--------------|------|
| 关键位实盘策略等 | 显示 | 含资金盈亏等 |
| 系统设置风控说明env 配置 | 隐藏资金条 | 与实盘顶栏共用组件设置类页面简化展示 |
| 关键位,实盘,策略等 | 显示 | 含资金,盈亏等 |
| 系统设置,风控说明,env 配置 | 隐藏资金条 | 与实盘顶栏共用组件,设置类页面简化展示 |
主题切换明/暗在系统设置页可用若已接入主题切换 UI)。
主题切换(明/暗)在系统设置页可用(若已接入主题切换 UI).
---
## 8. 权限与安全
- 所有设置 API 需 **已登录**或部署时 `APP_AUTH_DISABLED=true` 的联调环境)。
- 改密env 保存PM2 重启等写操作 **不接受** 仅带 `X-Hub-Token` 的中控请求修改防止中控误改实例配置)。
- 生产环境建议 `APP_AUTH_DISABLED=false`公网务必开启登录校验
- 所有设置 API 需 **已登录**(或部署时 `APP_AUTH_DISABLED=true` 的联调环境).
- 改密,env 保存,PM2 重启等写操作 **不接受** 仅带 `X-Hub-Token` 的中控请求修改(防止中控误改实例配置).
- 生产环境建议 `APP_AUTH_DISABLED=false`,公网务必开启登录校验.
---
## 9. 首次部署时的账号与密钥规划
## 9. 首次部署时的账号与密钥(规划)
以下由 **部署脚本** 自动完成**不在** 系统设置或 env 配置页手工填写
以下由 **部署脚本** 自动完成,**不在** 系统设置或 env 配置页手工填写:
1. **生成 `HUB_BRIDGE_TOKEN`** → 写入中控 + 三实例 `.env`相同)。
2. **生成 `FLASK_SECRET_KEY`** → 写入三实例 `.env`三所相同)。
3. **生成初始 `APP_USERNAME=admin``APP_PASSWORD=admin123`** → 写入三实例仅当尚未配置时);用户日后在 **系统设置** 改密
1. **生成 `HUB_BRIDGE_TOKEN`** → 写入中控 + 三实例 `.env`(相同).
2. **生成 `FLASK_SECRET_KEY`** → 写入三实例 `.env`(三所相同).
3. **生成初始 `APP_USERNAME=admin`,`APP_PASSWORD=admin123`** → 写入三实例(仅当尚未配置时);用户日后在 **系统设置** 改密.
脚本应对 **已有非空值** 跳过写入避免覆盖生产环境
脚本应对 **已有非空值** 跳过写入,避免覆盖生产环境.
---