pause

Author: hect0x7

README.md

@@ -117,7 +117,7 @@ jmcomic.download_album(123, option)
 ### 3. 使用命令行
 > 如果只想下载本子，使用命令行会比上述方式更加简单直接
 > 
-> 例如，在windows上，直接按下win+r键，输入jmcomic xxx就可以下载本子。
+> 例如，在windows上，直接按下 win+R 键，输入`jmcomic xxx`就可以下载本子。
 
 示例：
 
@@ -149,7 +149,9 @@ jmcomic 123
 
 ### 4. 查看本子详情（jmv 命令）
 
-> `jmv` 命令用于快速查看本子详情，无需下载。
+> `jmv` 命令用于快速查看本子详情，不做下载。
+> 
+> **适用场景**：在某些网站上看到一串*神秘车号*，想快速看看具体是啥本子。此时只需copy原文本，按下 win+R，输入`jmv [粘贴内容]`即可
 >
 > 支持从任意文本中提取数字作为车号，方便直接粘贴各种格式的车号。
 
@@ -164,6 +166,9 @@ jmv 350谁还没看过234
 
 # 指定option文件（也支持环境变量，用法同上）
 jmv 350234 --option="D:/a.yml"
+
+# -y 参数：执行完毕后直接退出，无需按回车确认
+jmv 350234 -y
 ```
 
 输出效果：
@@ -192,13 +197,17 @@ jmv 350234 --option="D:/a.yml"
      第1話  上  (id: 350234)
      第2話  下  (id: 350235)
 ──────────────────────────────────────────────────
+
+[运行结束] 请按回车键关闭窗口... (下次运行可附加 -y 参数跳过确认)
 ```
 
 
 
 ## 进阶使用
 
-请查阅文档首页→[jmcomic.readthedocs.io](https://jmcomic.readthedocs.io/zh-cn/latest)
+请查阅文档首页 → [jmcomic.readthedocs.io](https://jmcomic.readthedocs.io/zh-cn/latest)
+
+或者查看github仓库的文档 → [github-repo-docs](https://github.com/hect0x7/JMComic-Crawler-Python/blob/master/assets/docs/sources/tutorial/0_common_usage.md)
 
 （提示：jmcomic提供了很多下载配置项，大部分的下载需求你都可以尝试寻找相关配置项或插件来实现。）
 

assets/docs/sources/tutorial/2_command_line.md

@@ -4,7 +4,7 @@
 
 ### 1.1 基本用法
 
-```
+```sh
 # 下载album 123 456，下载photo 333。彼此之间使用空格间隔
 jmcomic 123 456 p333
 ```
@@ -44,14 +44,20 @@ jmv 350谁还没看过234
 jmv JM350234
 ```
 
-### 2.2 自定义option
+### 2.2 附加参数
 
 与 `jmcomic` 命令类似，支持 `--option` 参数和 `JM_OPTION_PATH` 环境变量：
 
 ```sh
 jmv 350234 --option="D:/a.yml"
 ```
 
+如果希望在执行完毕后立刻退出且不出现“请按回车键关闭窗口...”的停留提示（适用于自动化代码调用或常规终端使用时），可添加 `-y` 选项：
+
+```sh
+jmv 350234 -y
+```
+
 ### 2.3 输出示例
 
 ```text
@@ -78,6 +84,8 @@ jmv 350234 --option="D:/a.yml"
      第1話  上  (id: 350234)
      第2話  下  (id: 350235)
 ──────────────────────────────────────────────────
+
+[运行结束] 请按回车键关闭窗口... (下次运行可附加 -y 参数跳过确认)
 ```
 
 > **说明**: 当作者、标签、人物、作品超过10个时，会自动截断并显示总数（如 `...等25个`）。

src/jmcomic/cl.py

@@ -131,6 +131,7 @@ class JmViewUI:
     def __init__(self) -> None:
         self.raw_text: str = ''
         self.option_path: Optional[str] = None
+        self.auto_exit: bool = False
 
     def parse_arg(self):
         import argparse
@@ -148,9 +149,15 @@ def parse_arg(self):
             type=str,
             default=get_env('JM_OPTION_PATH', ''),
         )
+        parser.add_argument(
+            '-y', '--yes',
+            action='store_true',
+            help='执行完毕后直接退出，无需按回车确认',
+        )
 
         args = parser.parse_args()
         self.raw_text = args.text
+        self.auto_exit = args.yes
 
         option_str = args.option
         if len(option_str) == 0 or option_str == "''":
@@ -214,8 +221,16 @@ def print_album_detail(self, album):
 
         print(f'{sep}\n')
 
+    def _pause(self):
+        if not self.auto_exit:
+            input('\n[运行结束] 请按回车键关闭窗口... (下次运行可附加 -y 参数跳过确认)')
+
     def main(self):
         self.parse_arg()
+
+        import atexit
+        atexit.register(self._pause)
+
         album_id = self.extract_album_id()
 
         from .api import jm_log