代码架构升级，功能分割，减少强制性依赖，API全新换代，文档全面更新，新一代音·创，音·创1.0.0

docs/库的生成与功能文档.md

@@ -10,19 +10,104 @@
 
 # 库的简单调用
 
-参见[example.py的相关部分](../example.py#L120)，使用此库进行MIDI转换非常简单。
+参见[example.py的相关部分](../example.py)，使用此库进行MIDI转换非常简单。
+
+-	在导入转换库后，使用 MidiConvert 类建立转换对象（读取Midi文件）
+
+	音·创库支持新旧两种execute语法，需要在对象实例化时指定
+	```python
+	# 导入音·创库
+	import Musicreater
+
+	# 指定是否使用旧的execute指令语法（即1.18及以前的《我的世界：基岩版》语法）
+	old_execute_format = False	
+
+	# 可以通过文件地址自动读取
+	cvt_mid = Musicreater.MidiConvert.from_midi_file(
+		"Midi文件地址", 
+		old_exe_format=old_execute_format
+	)
+
+	# 也可以导入Mido对象
+	cvt_mid = Musicreater.MidiConvert(
+		mido.MidiFile("Midi文件地址"), 
+		"音乐名称", 
+		old_exe_format=old_execute_format
+	)
+	```
+
+-	获取 Midi 音乐经转换后的播放指令
+
+	```python
+	# 通过函数 to_command_list_in_score, to_command_list_in_delay
+	# 分别可以得到
+	# 以计分板作为播放器的指令对象列表、以延迟作为播放器的指令对象列表
+	# 数据不仅存储在对象本身内，也会以返回值的形式返回，详见代码内文档
+	
+	# 使用 to_command_list_in_score 函数进行转换之后，返回值有三个
+	# 值得注意的是第一个返回值返回的是依照midi频道存储的指令对象列表
+	# 也就是列表套列表
+	# 但是，在对象内部所存储的数据却不会如此嵌套
+	command_channel_list, command_count, max_score = cvt_mid.to_command_list_in_score(
+		"计分板名称", 
+		1.0,	# 音量比率
+		1.0,	# 速度倍率
+	)
+
+	# 使用 to_command_list_in_delay 转换后的返回值只有两个
+	# 但是第一个返回值没有列表套列表
+	command_list, max_delay = cvt_mid.to_command_list_in_delay(
+		1.0,	# 音量比率
+		1.0,	# 速度倍率
+		"@a",	# 玩家选择器
+	)
+
+	# 运行之后，指令和总延迟会存储至对象内
+	print(
+		"音乐长度：{}/游戏刻".format(
+			cvt_mid.music_tick_num
+		)
+	)
+	print(
+		"指令如下：\n{}".format(
+			cvt_mid.music_command_list
+		)
+	)
+	```
+
+-	除了获取播放指令外，还可以获取进度条指令
+
+	```python
+	# 通过函数 form_progress_bar 可以获得
+	# 以计分板为载体所生成的进度条的指令对象列表
+	# 数据不仅存储在对象本身内，也会以返回值的形式返回，详见代码内文档
+	
+	# 使用 form_progress_bar 函数进行转换之后，返回值有三个
+	# 值得注意的是第一个返回值返回的是依照midi频道存储的指令对象列表
+	# 也就是列表套列表
+	cvt_mid.form_progress_bar(
+        max_score, 				# 音乐时长游戏刻
+		scoreboard_name, 		# 进度条使用的计分板名称
+		progressbar_style,		# 进度条样式组（详见下方）
+    )
+
+	# 同上面生成播放指令的理，进度条指令也混存储至对象内
+	print(
+		"进度条指令如下：\n{}".format(
+			cvt_mid.progress_bar_command
+		)
+	)
+	```
+
+	在上面的代码中，进度条样式是可以自定义的，详见[下方说明](%E5%BA%93%E7%9A%84%E7%94%9F%E6%88%90%E4%B8%8E%E5%8A%9F%E8%83%BD%E6%96%87%E6%A1%A3.md#进度条自定义)。
+
+- 转换成指令是一个方面，接下来是再转换为可以导入MC的格式
+
+***诶哟我好累不想写了，等有时间再写，你们就看样例程序的用法吧，无量天尊***
+
+***这后面一直到下一个小节的内容全是没改的旧内容，肯定有问题***
 
 ```python
-import Musicreater	# 导入转换库
-
-old_execute_format = False	# 指定是否使用旧的execute指令语法（即1.18及以前的《我的世界：基岩版》语法）
-
-# 首先新建转换对象。
-conversion = Musicreater.midiConvert(enable_old_exe_format = old_execute_format)
-# 值得注意的是，一个转换对象可以转换多个文件。
-# 也就是在实例化的时候不进行对文件的绑定。
-# 如果有调试需要，可以在实例化时传入参数 debug = True
-# 如：conversion = Musicreater.midiConvert(debug=True)
 
 # 设置输入输出地址，并指定execute指令语法
 # 地址都为字符串类型，不能传入文件流
@@ -51,7 +136,7 @@ convertion_result = conversion.to_BDX_file(method_id,*prompts)
 convertion_result = conversion.to_BDX_file_with_delay(method_id,*prompts)
 
 # 转换结果是一个元组。
-# 若其转换成功，则前三位必为
+# 若其转换成功，则前二位必为
 # True, 指令数量, 最大延迟
 # 其中，最大延迟可以理解为计分板的最大值
 # 如果转换失败，暂时还没有定返回值的规则
@@ -101,11 +186,11 @@ print(convertion_result)
 
 	所以，结构的生成形状依照给定的高度和内含指令的数量决定。其 $Z$ 轴延伸长度为指令方块数量对于给定高度之商的向下取整结果的平方根的向下取整。用数学公式的方式表达，则是：
 	
-	$$MaxZ = \left\lfloor\sqrt{\left\lfloor{\frac{NoC}{MaxH}}\right\rfloor}\right\rfloor$$
+	$$ MaxZ = \left\lfloor\sqrt{\left\lfloor{\frac{NoC}{MaxH}}\right\rfloor}\right\rfloor $$
 
-	其中，$MaxZ$即生成结构的$Z$轴最大延伸长度，$NoC$表示链结构中所含指令方块的个数，$MaxH$表示给定的生成结构的最大高度。
+	其中，$MaxZ$ 即生成结构的$Z$轴最大延伸长度，$NoC$ 表示链结构中所含指令方块的个数，$MaxH$ 表示给定的生成结构的最大高度。
 
-	我们的结构生成器在生成指令链时，将首先以相对坐标系 $(0, 0, 0)$ （即相对原点）开始，自下向上堆叠高度轴（即 $Y$ 轴）的长，当高度轴达到了限制的高度时，便将 $Z$ 轴向正方向堆叠`1`个方块，并开始自上向下重新堆叠，直至高度轴坐标达到相对为`0`。若当所生成结构的 $Z$ 轴长达到了其最大延伸长度，则此结构生成器将反转 $Z$ 轴的堆叠方向，直至 $Z$ 轴坐标相对为`0`。如此往复，直至指令链堆叠完成。
+	我们的结构生成器在生成指令链时，将首先以相对坐标系 $(0, 0, 0)$ （即相对原点）开始，自下向上堆叠高度轴（即 $Y$ 轴）的长，当高度轴达到了限制的高度时，便将 $Z$ 轴向正方向堆叠`1`个方块，并开始自上向下重新堆叠，直至高度轴坐标达到相对为 `0`。若当所生成结构的 $Z$ 轴长达到了其最大延伸长度，则此结构生成器将反转 $Z$ 轴的堆叠方向，直至 $Z$ 轴坐标相对为 `0`。如此往复，直至指令链堆叠完成。
 	
 ##	播放器
 
@@ -200,5 +285,5 @@ print(convertion_result)
 
 `(r'▶ %%N [ %%s/%^s %%% __________ %%t|%^t]',('§e=§r', '§7=§r'))`
 
-*对了！为了避免生成错误，请尽量避免使用标识符作为定义样式字符串的其他部分*
+*为了避免生成错误，请尽量避免使用标识符作为定义样式字符串的其他部分*