the1812 · Jul 29, 2023 · Aug 4, 2023 · Aug 4, 2023 · Aug 4, 2023 · Aug 4, 2023
diff --git a/.eslintignore b/.eslintignore
@@ -0,0 +1,4 @@
+dist/
+node_modules/
+test-files/
+patches/
diff --git a/.eslintrc.cjs b/.eslintrc.cjs
@@ -0,0 +1,24 @@
+module.exports = {
+  extends: ['@the1812/eslint-config'],
+  rules: {
+    'class-methods-use-this': 'off',
+  },
+  overrides: [
+    {
+      files: ['*-mappings.ts'],
+      rules: {
+        '@typescript-eslint/naming-convention': [
+          'error',
+          {
+            selector: 'property',
+            format: ['strictCamelCase', 'StrictPascalCase'],
+            filter: {
+              regex: '[-/]|^[.]',
+              match: false,
+            },
+          },
+        ],
+      },
+    },
+  ],
+}
diff --git a/.github/workflows/npmpublish.yml b/.github/workflows/npmpublish.yml
@@ -17,9 +17,8 @@ jobs:
         with:
           node-version: 18
           registry-url: https://registry.npmjs.org/
-      - uses: pnpm/action-setup@v2.2.4
+      - uses: pnpm/action-setup@v4
         with:
-          version: ^8.6.5
           run_install: true
       - run: pnpm build
       - run: npm publish

diff --git a/.vscode/settings.json b/.vscode/settings.json
@@ -6,17 +6,23 @@
     "Doujin",
     "doujininfo",
     "flac",
+    "formatversion",
     "imageinfo",
     "linkedom",
     "Matthiola",
     "metadatas",
+    "mozjpeg",
     "musicgenres",
     "ogmusic",
+    "opensearch",
     "ORIGINALYEAR",
     "postprocess",
     "promisify",
+    "squoosh",
     "STREAMINFO",
+    "thbwiki",
     "thtag",
+    "thwiki",
     "TLMC",
     "touhou",
     "TRACKNUMBER",
@@ -25,5 +31,11 @@
     "Violetium",
     "Vorbis",
     "wikitable"
-  ]
+  ],
+  "[javascript]": {
+    "editor.defaultFormatter": "dbaeumer.vscode-eslint"
+  },
+  "[typescript]": {
+    "editor.defaultFormatter": "dbaeumer.vscode-eslint"
+  }
 }
diff --git a/.vscode/tasks.json b/.vscode/tasks.json
diff --git a/README.md b/README.md
@@ -1,4 +1,9 @@
 # Touhou Tagger
+
+<div align="center">
+  <img src="./logo.svg" height="300" />
+</div>
+
 从 [THBWiki](http://thwiki.cc/首页) 自动填写东方 Project CD 曲目信息.
 
 支持的曲目信息包括:
@@ -17,6 +22,10 @@
 - 发布年份
 - 封面图片
 
+<div align="center">
+  <img src="./example.jpg" width="1200" />
+</div>
+
 ## 安装 / 更新
 需要事先装有 [Node.js](https://nodejs.org/en/) 和 [pnpm](https://pnpm.io/installation), 然后使用以下命令来安装此工具:
 ```powershell
@@ -34,21 +43,6 @@ thtag
 
 如果最后输入的名称没有**精确匹配**的专辑(**精确匹配**在 THBWiki 中表现为输入到搜索框回车能直接跳转到词条), 则会列出以此名称在 THBWiki 中的搜索结果, 可以继续选择一项作为专辑信息. (有精确匹配的话会直接开始下载专辑信息)
 
-<details><summary><strong>图片示例</strong></summary>
-<div>
-  <img src="./before-files.jpg" alt="example" width="800">
-</div>
-<div>
-  <img src="./before.jpg" alt="example" width="400">
-</div>
-<div>
-  <img src="./after-files.jpg" alt="example" width="800">
-</div>
-<div>
-  <img src="./after.jpg" alt="example" width="400">
-</div>
-</details>
-
 ## 选项
 ### 保存封面为单独的文件
 文件名为 `cover`, 类型取决于 THBWiki 上的资源
@@ -76,7 +70,7 @@ thtag --comment-language eng
 ### 自动压缩封面图片
 `可自动保存的选项`
 
-可以设置当封面图片达到一定大小时, 自动进行压缩后再写入音乐文件中, 这有助于减少音乐文件的体积. 自动压缩**不会**作用于通过 `--cover` 选项保存的单独文件, 结合 `--cover` 可以做到写入较小体积的封面, 同时保存无损的原图.
+可以设置当封面图片达到一定大小时, 自动进行压缩 (使用 [MozJPEG](https://github.com/mozilla/mozjpeg)) 后再写入音乐文件中, 这有助于减少音乐文件的体积. 自动压缩**不会**作用于通过 `--cover` 选项保存的单独文件, 结合 `--cover` 可以做到写入较小体积的封面, 同时保存无损的原图.
 
 参数为数字, 单位为 MB, 设置为 `0` 时关闭此功能 (默认为 `0`). 下面的例子设置了当封面超过 2MB 时, 使用自动压缩.
 
@@ -88,7 +82,7 @@ thtag -ccs 2
 thtag --cover-compress-size 2
 ```
 
-此外, 还可以设置压缩的最大边长, 单位为 px, 设置为 `0` 时关闭此功能 (默认为 `0`).
+此外, 还可以设置压缩的最大边长 (需要当大小达到上面的 `--cover-compress-size` 设置时才会一同生效), 单位为 px, 设置为 `0` 时关闭此功能 (默认为 `0`).
 当封面的任意边长超过设定值时能够自动进行缩放. 下面的例子设置了当封面边长超过 2000px 时, 将尺寸缩放至 2000px (保持宽高比).
 
 ```powershell
@@ -111,32 +105,101 @@ thtag -s xxx
 thtag --source xxx
 ```
 
-此工具还内置了另外三种数据源:
+此工具还内置了另外一种数据源:
 
 #### doujin-meta
 从 [Doujin-Meta](https://github.com/the1812/Doujin-Meta) 获取曲目信息, 通常用于获取原创同人曲目信息.
 ```powershell
 thtag -s doujin-meta
 ```
 
-#### local-mp3
-从 MP3 文件提取曲目信息, 通常用于 FLAC 文件未填信息, 而已有填好信息的 MP3 文件. 可以使用此数据源按专辑进行信息复制.
+### 下载歌词
+`可自动保存的选项`
+
+歌词相关的处理, 除了 `--lyric` 外的选项都会自动保存.
+
+#### 选项说明
+- `-l` / `--lyric`: 启用歌词下载
+- `-t` / `--lyric-type`: 歌词类型
+  - **`original`(默认)**: 原版歌词
+  - `translated`: 译文歌词, 没有译文时会回退到原版歌词
+  - `mixed`: 混合原文和译文的歌词, 没有译文时同原版歌词
+- `-o` / `--lyric-output`: 歌词输出
+  - **`metadata`(默认)**: 写入到元数据中
+  - `lrc`: 创建额外的`.lrc`歌词文件 (**⚠此功能尚未完善**)
+- `--no-lyric-time`: 禁用元数据歌词时轴
+- `-lcs` / `--lyric-cache-size`: 设置歌词最大缓存数量, 用来加速重复曲目的歌词下载, **默认 16**
+
+#### 示例
+启用歌词下载, 写入原版歌词到元数据中
+```powershell
+thtag -l
+```
+启用歌词下载, 写入混合原文和译文的歌词到元数据中
+```powershell
+thtag -l -t mixed
+```
+
+### 禁止交互
+不做任何询问, 按照理想行为运行到底, 例如:
+- 专辑名称不再询问, 直接取文件夹的名称
+- 根据文件夹名称搜索:
+  - 搜索不到专辑时: 判为失败并退出
+  - 搜索到多个专辑时: 只有一个结果就取这个结果, 否则判为失败并退出
+```powershell
+thtag --no-interactive
+```
+
+### 批量运行
+假设总的文件夹叫 `folder`, 里面有多个文件夹, 每个文件夹包含一张专辑, 文件夹名称为专辑名称
+> 当前路径就在 `folder` 里的时候, 用 `thtag -b .` 就行了, `.` 表示当前文件夹
+
+```powershell
+thtag -b folder
+```
+或
 ```powershell
-thtag -s local-mp3
+thtag --batch folder
+```
+程序会将里面的子文件夹逐个进行专辑信息获取.
+
+#### 设置文件夹层级
+如果专辑文件夹并不是直接放在 `folder` 下的, 而是有更深的层级, 可以更改批量运行时搜索文件夹的层级来获取正确的专辑文件夹列表.
+
+例如按社团分类后, 专辑相对于 `folder` 隔了两层:
+```
+folder
+  ├─社团1
+  │  └─专辑A
+  └─社团2
+     └─专辑B
 ```
-在启动后, 询问专辑名称时填入 MP3 文件所在的文件夹即可.
 
-> 注意此数据源需要填入 MP3 的文件夹路径, 因此不能用于批量模式中
+将层级设为 `2` 就可以检测到里面的专辑:
+```powershell
+thtag -bd 2
+```
+或
+```powershell
+thtag --batch-depth 2
+```
 
-#### local-json
-从 JSON 文件读取曲目信息, JSON 内数据的类型为 `Metadata[]` (定义位于 `src/core/metadata.ts`). 可以使用此数据源处理一些原创专辑, 用法与 `local-mp3` 基本相同.
+### 超时 / 重试
+`可自动保存的选项`
 
-> 如果已存在名为 `metadata.json` 的文件, 程序会直接使用其中的曲目信息, 跳过曲目信息下载. 事先在各个文件夹中准备好 `metadata.json` 的话也是可以使用批量模式的.
+默认 30 秒后无法完成专辑信息下载判定为超时, 并自动进行重试, 总尝试次数到达默认的 3 次后, 程序会判为失败并停止.
 
+可以通过相应的开关调整以上的数值, 下面的例子为 60 秒超时, 最多试 5 次:
 ```powershell
-thtag -s local-json
+thtag --timeout 60 --retry 5
 ```
 
+## 专辑配置
+### 曲目信息配置
+在下载曲目信息前, 如果文件夹下已存在名为 `metadata.json` 的文件, 程序会直接使用其中的曲目信息, 跳过曲目信息下载.
+
+`metadata.json` 中数据的类型为 `Metadata[]` (定义位于 `src/core/metadata.ts`)
+
 为了方便使用, JSON 的内容可以进行一些省略:
 - 整张专辑中相同的数据, 例如专辑名称 / 社团名称等, 只需要在第一首曲目中写上即可, 后续曲目均会使用相同的数据.
 - 编曲者 (artists) 和作曲者 (composers) 相同时, 可以只写作曲者. (但不能只写编曲者, 因为东方同人曲的编曲者和作曲者一般是不同的, 作曲者从原曲信息就可以推断, 所以作曲者通常是省略的. 如果只写编曲者, 程序会让作曲者留空)
@@ -286,87 +349,27 @@ thtag -s local-json
 
 </details>
 
+### Touhou Tagger 运行配置
+可以为每一张专辑保存不同的运行配置, 无论是单独进行写入还是批量模式, 程序都会尝试读取专辑文件夹下的 `thtag.json` 文件. 可配置的内容有:
+- `defaultAlbumHint`: 默认用于搜索的专辑名称
+- `source`: 使用的数据源
 
-### 下载歌词
-`可自动保存的选项`
-
-歌词相关的处理, 除了 `--lyric` 外的选项都会自动保存.
-
-#### 选项说明
-- `-l` / `--lyric`: 启用歌词下载
-- `-t` / `--lyric-type`: 歌词类型
-  - **`original`(默认)**: 原版歌词
-  - `translated`: 译文歌词, 没有译文时会回退到原版歌词
-  - `mixed`: 混合原文和译文的歌词, 没有译文时同原版歌词
-- `-o` / `--lyric-output`: 歌词输出
-  - **`metadata`(默认)**: 写入到元数据中
-  - `lrc`: 创建额外的`.lrc`歌词文件 (**⚠此功能尚未完善**)
-- `--no-lyric-time`: 禁用元数据歌词时轴
-- `-lcs` / `--lyric-cache-size`: 设置歌词最大缓存数量, 用来加速重复曲目的歌词下载, **默认 16**
-
-#### 示例
-启用歌词下载, 写入原版歌词到元数据中
-```powershell
-thtag -l
-```
-启用歌词下载, 写入混合原文和译文的歌词到元数据中
-```powershell
-thtag -l -t mixed
-```
-
-### 禁止交互
-不做任何询问, 按照理想行为运行到底, 例如:
-- 专辑名称不再询问, 直接取文件夹的名称
-- 根据文件夹名称搜索:
-  - 搜索不到专辑时: 判为失败并退出
-  - 搜索到多个专辑时: 只有一个结果就取这个结果, 否则判为失败并退出
-```powershell
-thtag --no-interactive
-```
-
-### 批量运行
-假设总的文件夹叫 `folder`, 里面有多个文件夹, 每个文件夹包含一张专辑, 文件夹名称为专辑名称
-> 当前路径就在 `folder` 里的时候, 用 `thtag -b .` 就行了, `.` 表示当前文件夹
-
-```powershell
-thtag -b folder
-```
-或
-```powershell
-thtag --batch folder
-```
-程序会将里面的子文件夹逐个进行专辑信息获取.
-
-#### 设置文件夹层级
-如果专辑文件夹并不是直接放在 `folder` 下的, 而是有更深的层级, 可以更改批量运行时搜索文件夹的层级来获取正确的专辑文件夹列表.
-
-例如按社团分类后, 专辑相对于 `folder` 隔了两层:
+例子:
 ```
 folder
-  ├─社团1
-  │  └─专辑A
-  └─社团2
-     └─专辑B
+  ├─专辑A
+  │  └─thtag.json -> { "defaultAlbumHint": "Album A" }
+  ├─专辑B
+  │  └─thtag.json -> { "source": "doujin-meta" }
+  └─专辑C
 ```
 
-将层级设为 `2` 就可以检测到里面的专辑:
-```powershell
-thtag -bd 2
-```
-或
+当批量运行时
 ```powershell
-thtag --batch-depth 2
+thtag -b folder
 ```
 
-### 超时 / 重试
-`可自动保存的选项`
-
-默认 30 秒后无法完成专辑信息下载判定为超时, 并自动进行重试, 总尝试次数到达默认的 3 次后, 程序会判为失败并停止.
-
-可以通过相应的开关调整以上的数值, 下面的例子为 60 秒超时, 最多试 5 次:
-```powershell
-thtag --timeout 60 --retry 5
-```
+对 `专辑A`, 会使用 `Album A` 去 THBWiki 搜索; 对 `专辑B`, 会使用 `专辑B` 去 Doujin Meta 搜索; 对 `专辑C`, 会使用 `专辑C` 去 THBWiki 搜索.
 
 ## 提取曲目信息
 在专辑文件夹中运行:
@@ -378,8 +381,7 @@ thtag dump
 `thtag dump` 也可以和部分选项结合使用:
 - `--cover`: 同时提取封面图片
 - `--debug`: 额外保存一个 `metadata.debug.json` 文件, 记录原始的数据结构
-- `--batch`: (未完成) 批量进行提取
-
+- `--batch`: 批量进行提取
 
 ## 特别感谢
 - [THBWiki](http://thwiki.cc/首页)

diff --git a/after-files.jpg b/after-files.jpg
diff --git a/after.jpg b/after.jpg
diff --git a/before-files.jpg b/before-files.jpg
diff --git a/before.jpg b/before.jpg
diff --git a/example.jpg b/example.jpg