拼ui 一些业务逻辑x实现

2026-03-19 06:15:09 +08:00
parent f5c6f143c0
commit 49e45ac464
1118 changed files with 246518 additions and 5368 deletions
@@ -0,0 +1,138 @@
+# JSON Injection 面板
+
+本章说明 `Unity Easy Chart/Library Editor` 窗口左侧底部的 **JSON Injection** 面板。
+
+它的定位是：用一段可读/可复制的 JSON 来表达当前 `ChartProfile` 的配置（或外部导入的配置），并支持 **ApplyToChart** 将 JSON 解析后回写到选中的 Profile。
+
+---
+
+## 面板位置与作用
+
+- **位置**：Library 面板（资源树）下方。
+- **主要用途**：
+  - **导出**：把当前选中 `ChartProfile` 转成示例 JSON（Feed）
+  - **编辑**：在文本框里手动修改 JSON
+  - **导入/应用**：点击 **ApplyToChart**，把 JSON 解析并应用到当前选中的 `ChartProfile`
+
+适用场景：
+
+- **调试**：快速定位“某个字段是否生效”。
+- **批量修改**：复制 JSON 到外部编辑器（支持多光标/查找替换），再粘贴回来 Apply。
+- **与外部系统对接**：例如你的工具链/脚本生成 Feed，再在编辑器里 Apply。
+
+---
+
+## 控件说明（标题栏）
+
+标题栏从左到右一般包含：
+
+- **Min/Max**（按钮文字会变化）
+  - 用于切换面板高度。
+  - `Min`：收起为较小高度（更偏“辅助工具”）。
+  - `Max`：展开为较大高度（更适合长 JSON）。
+
+- **ApplyToChart**（图标按钮）
+  - 把当前文本框里的 JSON 尝试解析为 Feed，并应用到选中的 `ChartProfile`。
+  - 成功后会：
+    - 标记资产为 Dirty 并 `SaveAssets()`
+    - 刷新 Series 列表
+    - 刷新 Preview
+
+- **Help**（图标按钮）
+  - 打开本章节。
+
+---
+
+## 控件说明（按钮行）
+
+标题栏下方还有一行按钮（可能会自动换行）：
+
+- **API Envelope**（图标开关）
+  - 控制示例 JSON 是否包裹为“API 返回格式”。
+  - 你需要把 Feed 直接交给某个 HTTP API/服务时，这个选项会更方便。
+  - 切换后会重新生成示例，并覆盖文本框（详见“覆盖规则”）。
+
+- **Feed Mode**（下拉框）
+  - 用于控制“示例 JSON 输出包含哪些层级/字段”。
+  - 选项来自内部枚举（常见有）：
+    - `Lite`
+    - `Standard / ID`
+    - `Standard / Default`
+    - `Standard / With Axes`
+    - `Full`
+  - 一般建议：
+    - **快速看结构**：用 `Lite`
+    - **需要稳定引用**：用 `Standard / ID`
+    - **需要包含轴配置**：用 `Standard / With Axes`
+    - **需要完整复制/迁移**：用 `Full`
+
+- **Datas Format**（下拉框）
+  - 控制 `seriesData`（数据点）字段的输出格式。
+  - 常见选项：
+    - `Values`：更精简，偏“只关心数值”。
+    - `Standard`：默认格式，适合一般编辑与 Apply。
+    - `Full`：更完整（可能包含更多字段/结构），适合迁移/还原。
+
+- **Copy**（图标按钮）
+  - 复制当前文本框内容到剪贴板。
+
+---
+
+## 文本框与“覆盖规则”（非常重要）
+
+JSON 文本框是可编辑的，但为了避免你手写的内容被自动覆盖，面板内部有一个“脏标记”逻辑：
+
+- **只要你手动改过文本框内容**，就会认为“用户已修改”（dirty）。
+- 当处于 dirty 状态时：
+  - 编辑器不会自动用示例 JSON 覆盖你的内容。
+- 但当你切换以下选项时，会**强制覆盖**（同时清除 dirty）：
+  - `API Envelope`
+  - `Feed Mode`
+  - `Datas Format`
+  - 或在切换选中 Profile 时（会重置为该 Profile 的示例）
+
+建议：
+
+- 如果你要做大幅改动：
+  - 先 Copy 到外部编辑器改
+  - 改完再粘贴回来 Apply
+
+---
+
+## ApplyToChart 的行为与注意事项
+
+- **ApplyToChart 会修改当前选中的 `ChartProfile` 资产**。
+- 如果 JSON 解析失败，会在 Console 输出错误：
+  - `ApplyToChart failed: invalid JSON or unsupported format.`
+- `Full` 模式下会允许覆盖更多“Meta/结构”信息（例如某些标识/配置），因此更强大也更危险。
+
+建议：
+
+- 在 Apply 前确保：
+  - 左侧已选中正确的 `ChartProfile`
+  - JSON 格式正确（括号/逗号）
+  - 你理解当前 Feed Mode 会覆盖哪些内容
+
+---
+
+## 推荐工作流
+
+### 1) 从当前 Profile 导出并微调
+
+- 选中一个 `ChartProfile`
+- 选择合适的 `Feed Mode` / `Datas Format`
+- Copy 到外部编辑器微调
+- 粘贴回来
+- ApplyToChart
+
+### 2) 从外部导入配置
+
+- 把外部 JSON 粘贴到文本框
+- ApplyToChart
+- 去 Inspector / Series 进一步精调
+
+---
+
+## Help
+
+- 点击标题栏最右侧 **Help** 图标可回到本章节。