TimeLine大改

Signed-off-by: TRAfoer <lhf190@outlook.com>

Document/console.md

@@ -1,38 +1,128 @@
-# Console概要
+# 更新版 Console 文档
+
+## Console概要
 
 Editor内有console系统，用于执行某些方便的操作。
 
-在编辑界面内按   **`**  （esc下面）键可以唤出console输入框，在其中输入完成后按enter键即可尝试执行框内的指令。
+在编辑界面内按 **`** 键（Esc键下方）可以唤出console输入框，输入完成后按Enter键执行指令。
 
-输入框配有上下文，在输入时按上下箭头可以跳转到上一次的指令。
+输入框支持上下文历史记录，按上下箭头可浏览历史指令。
 
-输入格式按照 **func "abc123" 1 2 [0,1,2]** 的格式输入,也可以用**func(1,2,3,"a",[1,2,3])**输入，其中值大多是数字值，如果是字符的话，需要带上双引号（`"abc123"`），如果是向量（vector2，3），就需要用中括号括起来(` [0,0,1] `)。
+输入格式：
+- **func "abc123" 1 2 [0,1,2]**
+- 或 **func(1,2,3,"a",[1,2,3])**
+- 字符串需双引号包裹（`"abc123"`）
+- 向量需中括号包裹（`[0,0,1]`）
 
-如果因为某种原因而导致指令执行失败的话，会在下面的log window有提醒。
+执行失败时会在Log Window显示错误信息。部分指令依赖Inspector窗口当前选中对象，请提前选择目标对象。
 
-有一些指令是依托于右边的inspector窗口来获取物体的，所以在执行操作前注意选中要执行的物体。
+---
 
 ## 命令列表
 
-（格式：命令名字 值1 值2 …值x）
+### 基础操作
+```csharp
 tp(Vector3 pos)
-将场景相机移动到指定的三维坐标 pos。
+```
+- 将场景相机移动到指定坐标
+- 示例：`tp [10,5,0]`
 
+```csharp
 tp()
-将场景相机移动到当前 Inspector 选中元素的位置。
+```
+- 将场景相机移动到当前选中对象的位置
+- 需在Inspector中选中对象
 
-reName(string message)
-将当前 Inspector 选中元素的名称改为 message。
+```csharp
+ReName(string message)
+```
+- 重命名当前选中对象
+- 示例：`ReName "NewTrackName"`
 
-lgp(int loop, Vector3 start, Vector3 end)
-在选中的 Track 上，按线性插值方式批量生成 loop 个 PathNode，起止点为 start 和 end。
+### 路径生成
+```csharp
+Lgp(int loop, Vector3 start, Vector3 end)
+```
+- 在选中的Track上生成线性路径节点
+- 参数：
+  - `loop`：生成节点数量
+  - `start`：起始坐标
+  - `end`：结束坐标
+- 示例：`Lgp 10 [0,0,0] [5,0,5]`
 
-spiral(int loop, Vector3 center, float r, float h, int pointsPerTurn, string axis = "y")
-在选中的 Track 上，按指定主轴（x/y/z）和参数，批量生成螺旋线分布的 PathNode。
+```csharp
+Spiral(int loop, Vector3 center, float r, float h, int pointsPerTurn, string axis = "y")
+Spiral(int loop, Vector3 center, float r, float h, int pointsPerTurn, Vector3 dir)
+```
+- 在选中的Track上生成螺旋路径节点
+- 参数：
+  - `loop`：总节点数
+  - `center`：螺旋中心点
+  - `r`：螺旋半径
+  - `h`：螺旋高度
+  - `pointsPerTurn`：每圈节点数
+  - `axis`：主轴方向（"x"/"y"/"z"）
+  - `dir`：自定义方向向量
+- 示例：`Spiral 20 [0,0,0] 3 10 8 "z"`
 
-spiral(int loop, Vector3 center, float r, float h, int pointsPerTurn, Vector3 dir)
-在选中的 Track 上，按任意方向（dir 向量）和参数，批量生成螺旋线分布的 PathNode。
+### 数据处理
+```csharp
+SamplerImport(string inputData)
+```
+- 导入采样器格式的音符数据
+- 数据格式：`(动作类型, 轨道ID, 时间戳, X值, [Hold持续时间])`
+- 支持动作类型：Tap, Stay, Hold, Flick
+- 示例：`SamplerImport "(Tap, Track1, 12.5, 3.2)"`
+
+### 音符操作
+```csharp
+SetNoteHLInGame(bool forceSetOff = false, bool SameTheme = false)
+```
+- 全局高亮重复时间点的音符
+- 参数：
+  - `forceSetOff`：是否先关闭所有高亮
+  - `SameTheme`：是否要求音符类型相同
+
+```csharp
+SetNoteHLInElement(bool forceSetOff = false, bool SameTheme = false)
+```
+- 在当前元素内高亮重复时间点的音符
+- 参数同上
+
+```csharp
+AttachNoteInNearestTrail()
+```
+- 将轨道上的音符吸附到最近的轨迹线
+- 需选中Track对象
+
+### 动画操作
+```csharp
+swapDisplacement()
+```
+- 反转位移动画方向（正负值互换）
+- 需选中Displacement元素
+
+```csharp
+swapSwirl()
+```
+- 反转旋转动画方向
+- 需选中Swirl元素
+
+```csharp
+swapScale()
+```
+- 反转缩放动画方向
+- 需选中Scale元素
+
+### 对象管理
+```csharp
+DelSameInParent()
+```
+- 删除父对象中所有同类型的兄弟元素（包括自身）
+- 示例：删除当前选中类型的所有同级对象
+
+---
 
 ## 其他
 
-在做了
+更多功能持续开发中。使用console时可参考编辑器内的自动补全提示和参数类型检查功能。