优化教程·其二

Dockerfile

@@ -36,7 +36,7 @@ RUN python3 -m venv /app/venv
 RUN . /app/venv/bin/activate && \
     pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/ && \
     /app/venv/bin/python3 -m pip install --upgrade pip && \
-    pip install --no-cache-dir --upgrade "Musicreater[full]" TrimLog requests zhDateTime "setuptools<80"
+    pip install --no-cache-dir --upgrade /app/Linglun-Converter/requirements_cli.txt
 
 # 切换到克隆下来的仓库目录
 WORKDIR /app/Linglun-Converter

docs/download&start/Android.md

@@ -4,6 +4,8 @@
 
 这里我们选用 **Termux** 作为我们的终端工具来安装，这是一个强大的终端模拟器，旨在安卓环境下模拟Linux的软件包环境。
 
+> **注意** 若你的设备中已经有终端工具（例如 Utermux 之类的），请跳过此步骤。
+
 1.	下载
 
 	下载可以通过 [GitHub源](https://github.com/termux/termux-app/releases) 或者 [F-Droid源](https://f-droid.org/en/packages/com.termux/) ，个人建议选择 F-Droid 源，因为在国内可以访问得到，而 GitHub 源就看运气。
@@ -26,6 +28,8 @@
 
 	首先，我估计你等不了多久，急得要死，所以我们要让下载速度稍微快一点，先来换个源。在 **Termux** 中，输入以下指令：
 
+	> **注意** 这条指令很长，执行时请左右滑动以复制全部内容。
+
 	```bash
 	echo "deb https://mirror.mwt.me/termux/main stable main" > /data/data/com.termux/files/usr/etc/apt/sources.list
 	```
@@ -33,8 +37,10 @@
 	*感谢 天如<QQ 3291691454>为我们带来的简单换源方法。*
     
 	-	*非必要步骤*：手动编辑换源
+
+		> **注意** 这是非必要的步骤，执行了也没有好处，小白别闲着没事干。
     
-		如果你闲着没事，非要要手动编辑个文档来换源，那用啥？用普通的编辑器肯定可以，于是我们就让他更普通一点，用**nano**吧！
+		如果你闲着没事，非要要手动编辑个文档来换源，那就可以遵循这一部分的内容，我们先打开 **nano** 吧。
 
 		在 **Termux** 中，输入以下指令：
 
@@ -59,13 +65,13 @@
 
 		然后键入 `Ctrl`+`S`，再键入 `Ctrl`+`X`，退出`nano`。
 
-	在换源之后，你可能会见到类似的提示：
+	在换源之后，你可能会见到类似的提示（“可能会”的意思是也可能不会）：
 
 	```bash
 	Your '/data/data/com.termux/files/usr/etc/apt/sources.list' file changed. Please run 'apt-get update'.
 	```
 
-	那就遵循它的指引，输入：
+	那就遵循它的指引（但无论出没出现上面的那个提示，都请执行下面的指令），输入：
 
 	```bash
 	apt-get update
@@ -94,37 +100,24 @@
 
 	如果输出了形如 `Python 3.X.X` 的提示，则完成。
 
-3.	安装依赖库
+3.	构建环境并安装依赖库
+
+	以下长段中井号“#”开头的是注释，无需复制输入。
 	
 	```bash
 	# 首先换源
 	pip config set global.index-url http://mirrors.aliyun.com/pypi/simple/
-	# 然后安装（依次执行下面的指令）
+	# 然后安装 numpy
     apt-get install python-numpy
-	pip install Musicreater[full] TrimLog
-	python -m pip install --upgrade pip setuptools wheel
+	# 新建虚拟环境
+	python -m venv ./.venv
 	```
 
-	- 如果出现以下情况，真是死了鬼的，我们要来再搞个设置：
-
-		<img height="512" src="https://foruda.gitee.com/images/1665933289612919459/b87b7804_9911226.jpeg">
-
-		我们来修改收信任的源设置：
-
-		```bash
-		pip config set global.trusted-host mirrors.aliyun.com/
-		```
-
-		之后再来安装即可
-
-		```bash
-	    pip install Musicreater[full] TrimLog
-	    python -m pip install --upgrade pip setuptools wheel
-		```
-
+	<!--
 	安装成功后您可能会见到类似下图的提示：
 
 	<img src="https://foruda.gitee.com/images/1662737676719454287/f61a70f7_9911226.png">
+	-->
 
 ###	安装下载工具
 
@@ -134,15 +127,23 @@
 apt install git
 ```
 
-安装完成后记得测试一下：
+安装完成后可以测试一下是否安装成功：
 
+```bash
+git --version
+```
+
+你可能会见到类似 `git version 2.x.x` 的提示，表示安装成功。
+
+<!--
 <img height="512" src="https://foruda.gitee.com/images/1665933331269483373/9374c85d_9911226.jpeg">
+-->
 
 ## 本软件的下载与使用
 
-1. 使用Git下载本程序代码
+0. 使用Git下载本程序代码
 
-	```bash
+	```git
 	git clone https://gitee.com/TriM-Organization/Linglun-Converter.git llc
 	```
 
@@ -155,13 +156,20 @@ apt install git
 
 1. 开始使用命令行程序
 
-	依照你的需要，执行以下命令以运行程序：
+	执行以下命令以运行伶伦转换器：
 
 	```bash
-	python llc_cli.py
+	source ./run_cli.sh
 	```
 
 	运行成功了，哦耶！
 
 	<img height="512" src="https://foruda.gitee.com/images/1686963721390700714/b82fb3d5_9911226.png">
 
+2. 软件更新
+
+	有时可能需要更新本程序，请在进入到本程序所在的文件夹（上述`cd llc`即此）后，执行以下命令：
+
+	```bash
+	git pull
+	```

docs/download&start/Linux.md

@@ -1,7 +1,20 @@
 
-##  运行环境安装
 
-### 检验Python运行环境
+## 一、【控制台】使用 Docker
+
+请使用根目录下的 `Dockerfile` 来构建镜像，并运行镜像。
+
+## 二、【图形化用户界面】暂无内容
+
+*未完待续*
+
+------
+
+## 三、【控制台】手动安装（*不建议*）
+
+###  运行环境安装
+
+#### 检验Python运行环境
 
 0.	一般的Linux发行版都有安装Python环境，我们只需要保证其版本即可，理论上 ≥Python3.6 都可以运行我们的库
 
@@ -43,7 +56,7 @@
 
 		暂无
 
-### 检查并安装pip包管理器依赖
+#### 检查并安装pip包管理器依赖
 
 1.	我们在安装依赖库之前，应该确认一下，Python自带的包管理器pip是否安装到位：
 
@@ -65,20 +78,19 @@
 	# 安装完成后一定要验证！！！
 	python -m pip
 	```
-
+<!--
 2.	确认完成之后，我们来安装一下依赖库：
 	
 	```bash
-	pip install Musicreater[full] -i https://mirrors.aliyun.com/pypi/simple/
-	pip install TrimLog -i https://mirrors.aliyun.com/pypi/simple/
+	pip install -r requirements_cli.txt -i https://mirrors.aliyun.com/pypi/simple/
 	```
 
 3.	安装成功后可能会见到类似下图的提示：
 
 	<img src="https://foruda.gitee.com/images/1662737676719454287/f61a70f7_9911226.png">
+-->
 
-
-## 本代码库的下载与使用
+### 本代码库的下载与使用
 
 1. 使用Git下载本库及其示例代码
 
@@ -93,11 +105,20 @@
 	cd llc
 	```
 
-1. 开始使用
+1. 新建虚拟环境
 
-	在目录下打开终端，执行以下命令以运行演示程序：
+	在目录下打开终端，或者继续沿用我们刚才已经`cd`过`llc`的终端，执行以下命令以新建虚拟环境：
 
 	```bash
-	python llc_cli.py
+	python -m venv ./.venv
+	```
+	
+2.	运行示例程序
+
+	执行以下命令以运行演示程序：
+
+	```bash
+	source ./run_cli.sh
 	```
 
+	该脚本会自动激活虚拟环境，你也可以通过手动执行`source ./.venv/bin/activate`来激活之。

docs/download&start/Windows.md

@@ -1,4 +1,4 @@
-## 运行打包文件（推荐）
+## 运行可执行文件（推荐）
 
 ### 一、下载打包好的应用程序
 
@@ -21,7 +21,7 @@
 	<img src=https://foruda.gitee.com/images/1699106948861444130/30c156bc_9911226.png>
 
 
-## 从代码运行（最新功能）
+## 从代码运行（不建议）
 
 ### 一、运行环境安装
 
@@ -29,7 +29,7 @@
 
 1.	首先需要下载Python的安装包，最好是 *Python3.10*，因为作者就用的是这个版本
 
-    ！注意！此程序现已不支持Python3.6。请更新到至少Python3.8，但是，我们对于Python3.8的支持也即将停止，为了更好的兼容，避免不必要的麻烦，我们强烈建议您更新到Python3.10。(这意味着我们即将放弃对Windows7的支持)
+    ！注意！此程序现已不支持 Python3.6。请更新到至少Python3.8，但是，我们对于 Python3.8 的支持也即将停止，为了更好的兼容，避免不必要的麻烦，我们强烈建议您更新到 Python3.10。（这意味着我们即将放弃对 Windows7 的支持）
 
 	> [下载64位Python3.10安装包](https://www.python.org/ftp/python/3.10.11/python-3.10.11-amd64.exe)
 	> [下载32位Python3.10安装包](https://www.python.org/ftp/python/3.10.11/python-3.10.11.exe)
@@ -38,13 +38,13 @@
 
 	<img src=https://foruda.gitee.com/images/1662736520757331846/e38efb81_9911226.png>
 
-	-   若您对Python一知半解或者不怎么了解、并对自己的系统盘（通常是C盘）有大约150*兆字节*(MB)的信心的话，您可以在安装时直接选择*快速安装*(Install Now)
+	-   若您对 Python 一知半解或者不怎么了解、并对自己的系统盘（通常是C盘）有大约 150 *兆字节*(MB)的信心的话，您可以在安装时直接选择*快速安装*(Install Now)
 
 3.	若您选择了*自定义安装*(Customize Installation)，请务必勾选 `pip` 和 `py launcher` 便于后续安装依赖，如下图：
 
 	<img src=https://foruda.gitee.com/images/1662736621235871190/2ac3d98f_9911226.png>
 
-4.	安装结束之后可以在*终端*(命令行/PowerShell/Bash/etc)中输入：`python -V` 试试是否安装成功，成功安装之后，在终端中输入python会显示诸如如下图片的提示：
+4.	安装结束之后可以在*终端*工具（例如 命令行/PowerShell/Bash 之类的都是终端工具）中输入：`python -V` 试试是否安装成功，成功安装之后，在终端中输入python会显示诸如如下图片的提示：
 
 	<img src=https://foruda.gitee.com/images/1699107336707287940/1837e2f6_9911226.png>
 
@@ -82,7 +82,7 @@
 
 1. 开始使用
 
-	您可以直接双击 `llc_cli.py` 以运行演示程序，或者按照以下步骤使用终端应用运行。
+	您可以直接双击 `llc_cli.py` 以运行软件，或者按照以下步骤使用终端应用运行。
 
 	在目录下打开终端。
 	

docs/download&start_EN/Linux.md

@@ -1,7 +1,21 @@
 
-## Install Runtime Environment
 
-### Install and Verify Python Runtime
+
+## 1 CLI - Docker
+
+Using the `Dockerfile` in the root directory to build a Docker image, and run it.
+
+## 2 GUI
+
+*to be written*
+
+------
+
+## 3 **Not Recommended** Manually Run the CLI code
+
+### Install Runtime Environment
+
+#### Install and Verify Python Runtime
 
 0.	Common Linux Distributions do include a Python Runtime Environment, what we should do is only to check whether it is a satisfied version to our program. If the version ≥Python3.6, theoretically our program can be run.
 
@@ -43,7 +57,7 @@
 
 		None yet.
 
-###	Install and Verify pip Package Manager
+####	Install and Verify pip Package Manager
 
 1.	Before installing, it is to be checked, wheather Python's pip is OK:
 
@@ -55,22 +69,21 @@
 	/usr/bin/python: No module named pip
 	# We can install pip via:
 	sudo pacman -S python-pip
-	# Verfy, remember.
+	# Check, remember.
 	python -m pip
 
 
 	# If you did but failed, we should use other methods to install pip:
 	wget https://bootstrap.pypa.io/get-pip.py
 	sudo python get-pip.py
-	# Verfy, must.
+	# Double check, must.
 	python -m pip
 	```
 
 2.	After checking, let's install the dependences.
 	
 	```bash
-	pip install mido -i
-	pip install brotli -i
+	pip install -r requirements_cli.txt -i https://mirrors.aliyun.com/pypi/simple/
 	```
 
 3.	See the tips below as successfully installed：
@@ -78,25 +91,25 @@
 	<img src="https://foruda.gitee.com/images/1662737676719454287/f61a70f7_9911226.png">
 
 
-## Download this lib's sources code and Using its demos.
+### Download this lib's sources code and Using its demos.
 
 1.	Download via Git
 
 	```bash
-	git clone -b pkgver https://github.com/TriM-Organization/Musicreater.git MSCTpkgver
+	git clone https://gitee.com/TriM-Organization/Linglun-Converter.git llc
 	```
 
-	If succeed, a directory named `MSCTpkgver` well be found in the path you run this command, and inside it is the source code and demo(s) we wantted to download.
-	What we want to use is the demo(s) so enter the folder via:
+	If succeed, a directory named `llc` well be found in the path you run this command, and inside it is the source codes we wantted to download.
+	What we want to use is in the folder so enter the folder via:
 
 	```bash
-	cd MSCTpkgver
+	cd llc
 	```
 
-1.	Starting Using Demo(s)
+1.	Starting Using
 
 	Via
 
 	```bash
-	python magicDemo.py
+	python llc_cli.py
 	```

llc_cli.py

@@ -19,28 +19,40 @@ The Licensor of _Linglun Converter CLI_("this project") is Eilles Wan.
 详细的准许和限制条款请见原协议文本。
 """
 
-__version__ = "0.0.9.1"
+__version__ = "0.0.9.2"
 
 
 import os
 import random
 
-import Musicreater
-from Musicreater import DEFAULT_PROGRESSBAR_STYLE
-from Musicreater.plugin.addonpack import (
-    to_addon_pack_in_delay,
-    to_addon_pack_in_repeater,
-    to_addon_pack_in_score,
-)
-from Musicreater.plugin.bdxfile import to_BDX_file_in_delay, to_BDX_file_in_score
-from Musicreater.plugin.mcstructfile import (
-    to_mcstructure_file_in_delay,
-    to_mcstructure_file_in_repeater,
-    to_mcstructure_file_in_score,
-)
+try:
 
-from utils.io import bool_str, float_str, int_str, ipt, isin, logger, prt
-from utils.yanlun import solar_date, yanlun_texts
+    import Musicreater
+    from Musicreater import DEFAULT_PROGRESSBAR_STYLE
+    from Musicreater.plugin.addonpack import (
+        to_addon_pack_in_delay,
+        to_addon_pack_in_repeater,
+        to_addon_pack_in_score,
+    )
+    from Musicreater.plugin.bdxfile import to_BDX_file_in_delay, to_BDX_file_in_score
+    from Musicreater.plugin.mcstructfile import (
+        to_mcstructure_file_in_delay,
+        to_mcstructure_file_in_repeater,
+        to_mcstructure_file_in_score,
+    )
+
+    from utils.io import bool_str, float_str, int_str, ipt, isin, logger, prt
+    from utils.yanlun import solar_date, yanlun_texts
+
+except ImportError:
+    if input("[ERROR] 当前环境中未安装所需依赖库，是否直接安装依赖库？[Y/n]") in (
+        "y",
+        "Y",
+    ):
+        os.system("pip install -r ./requirements_cli.txt")
+        print("[INFO] 安装完成，请重新启动。")
+
+    exit()
 
 # import sys
 
@@ -378,7 +390,7 @@ for singleMidi in midis:
                 else to_BDX_file_in_delay(cvt_mid, out_path, style, *prompts[3:])
             )
             if output_file_format == 1
-            else (cvt_method(cvt_mid, out_path, *prompts[2:])) # type: ignore
+            else (cvt_method(cvt_mid, out_path, *prompts[2:]))  # type: ignore
         )
     )
 

llc_win_wxPython.py

@@ -82,26 +82,28 @@ __version__ = "WXGUI 1.2.2"
 __zhver__ = "WX图形界面 初代次版二编"
 
 
-logger.info("检查更新")
+if __name__ == "__main__":
 
-down_paths = check_update_release(
-    "伶伦转换器",
-    "https://gitee.com/TriM-Organization/Linglun-Converter/releases/latest",
-    __version__,
-    go_update_tip,
-    logger,
-    "！有新版本！\n新版本 {app} {latest} 可用，当前仍是 {current}\n请前往下载地址更新\n",
-)
+    logger.info("检查更新")
 
-
-if down_paths:
-    wx.LaunchDefaultBrowser(
-        "https://gitee.com{}".format(
-            [v for i, v in down_paths.items() if sys.platform in i][0]
-        )
+    down_paths = check_update_release(
+        "伶伦转换器",
+        "https://gitee.com/TriM-Organization/Linglun-Converter/releases/latest",
+        __version__,
+        go_update_tip,
+        logger,
+        "！有新版本！\n新版本 {app} {latest} 可用，当前仍是 {current}\n请前往下载地址更新\n",
     )
-    exit()
-    # go_update_tip("点击下方链接下载更新：",'<a href="https://gitee.com{}">点击此处下载</a>'.format(list(down_paths.values())[0]))
+
+
+    if down_paths:
+        wx.LaunchDefaultBrowser(
+            "https://gitee.com{}".format(
+                [v for i, v in down_paths.items() if sys.platform in i][0]
+            )
+        )
+        exit()
+        # go_update_tip("点击下方链接下载更新：",'<a href="https://gitee.com{}">点击此处下载</a>'.format(list(down_paths.values())[0]))
 
 """
 msct_main = msct_plugin = msct_plugin_function = None
@@ -280,6 +282,7 @@ if down_paths:
     ) = msct_plugin_function
 """
 
+
 logger.info("注册变量并读取内容……")
 
 

requirements_cli.txt

@@ -0,0 +1,5 @@
+setuptools < 80
+Musicreater[full]>=2.1.0.1
+TrimLog>=0.8.3
+requests>=2.0.0
+zhDateTime>=2.0.0

resources/资源版权声明.md

@@ -8,11 +8,11 @@
 
 **金羿ELS**、**金羿**、**Eilles Wan**、**丌幂**、**诸葛亮与八卦阵**、**诸葛八卦**、**BgArray**、**鸣凤鸽子**、**鱼旧梦**、**ElapsingDreams**等一众具有显著特征的自然人网名、自然人姓名、自然人专有名称之类之辞皆为专有标记，未经其本人允许不得擅自使用。
 
-**伶伦工作站**、**伶伦转换器**、**LingLun Studio**、**LingLun Converter**、**音·创**、**Musicreater**等一众项目、软件、需求库之名称皆为专用之商业标记，未经其所有者允许不得擅自使用。
+**伶伦工作站**、**伶伦转换器**、**LingLun Studio**、**LingLun Converter**、**音·创**、**Musicreater**等一众项目、软件、需求库之名称皆为本项目专用之商业标记，未经其所有者允许不得擅自使用。
 
-睿乐组织的徽标[**【木制展框上的惊异媒体】（睿思乐发）**](https://gitee.com/TriM-Organization/Linglun-Converter/raw/master/resources/TriMO_Theme.mp4)之图案及相关动画是**丌幂**所作的、**睿乐组织**的共同标志，其著作权归属**丌幂**所有，并授权给**睿乐组织**使用。其相关声像信息、睿乐组织的主题音[**【悦搏音符之回响】（睿思乐发）**](https://gitee.com/TriM-Organization/Linglun-Converter/raw/master/resources/TriMO_Theme.mp4)是**诸葛亮与八卦阵**所制作的、**睿乐组织**的共同标记，其著作权归属**诸葛亮与八卦阵**所有，并授权给**睿乐组织**使用。上述之图形、动画、声音等相关媒体信息皆为**睿乐组织**所专用的商业标记，未经**睿乐组织**之允许不得使用。
+睿乐组织的徽标[**【木制展框上的惊异媒体】（睿思乐发）**](./TriMO_Theme.mp4)之图案及相关动画是**丌幂**所作的、**睿乐组织**的共同标志，其著作权归属**丌幂**所有，并授权给**睿乐组织**使用。其相关声像信息、睿乐组织的主题音[**【悦搏音符之回响】（睿思乐发）**](./TriMO_Theme.mp4)是**诸葛亮与八卦阵**所制作的、**睿乐组织**的共同标记，其著作权归属**诸葛亮与八卦阵**所有，并授权给**睿乐组织**使用。上述之图形、动画、声音等相关媒体信息皆为**睿乐组织**所专用的商业标记，未经**睿乐组织**之允许不得使用。
 
-[**木制框架中的乐灵**](https://gitee.com/TriM-Organization/Linglun-Converter/raw/master/resources/LLC_LOGO_OK_PLAIN_BANNER.png)之图案及相关动画、声音均为**伶伦工作站**之专用标记，未经**睿乐组织**之允许不得使用。
+[**木制框架中的乐灵**](./LLC_LOGO_OK_PLAIN_BANNER.png)之图案及相关动画、声音均为**伶伦工作站**之专用标记，未经**睿乐组织**之允许不得使用。
 
 [**瓷板上的方块音符**](https://gitee.com/TriM-Organization/Musicreater/raw/master/resources/msctIcon.png)之图案及相关动画、声音均为**音·创库**之专用标记，未经**睿乐组织**之允许不得使用。
 
@@ -26,4 +26,4 @@
 不允许脱离于本项目而独立存在
 不得随任何其他非本项目之内的软件连带发布
 不得用于商业用途
-若本项目之源码被用于商业用途，应当将其从中剔除
+若本项目之源码被用于商业用途，除必要出现的显示外，应当将上述资源从中剔除

run_cli.sh

@@ -0,0 +1,2 @@
+source ./.venv/bin/activate
+python ./llc_cli.py

utils/yanlun.py

@@ -41,7 +41,7 @@ else:
     try:
         yanlun_texts = (
             requests.get(
-                "https://nd.liteyuki.icu/api/v3/share/content/Xpue?path=null",
+                "https://nd.liteyuki.org/api/v3/share/content/Xpue?path=null",
             )
             .text.strip("\n")
             .split("\n")