fix: 修复文档及代码中的错误

Author: seamile

README.md

@@ -41,19 +41,17 @@ If using uv as your Python package manager:
 uv pip install --torch-backend cpu imgsearch
 ```
 
-**Note**: ImgSearch's TinyCLIP models work on both CPU and GPU. GPU users can skip the CPU-specific steps and use the standard PyTorch installation for faster performance.
-
 ## Quick Start
 
 ### 1. Service Management
 
 ImgSearch follows a client-server architecture: the server handles indexing and search tasks, while the client manages user requests. Before using ImgSearch, start the server process.
 
-The server supports Unix domain sockets (default for local, efficient connections) or TCP binding. The default Unix socket is at `~/.isearch/isearch.sock`.
+The server supports unix domain sockets (default for local, efficient connections) or TCP binding. The default unix socket is at `~/.isearch/isearch.sock`.
 
 #### Basic Usage
 
-The default model is ViT-45LY (TinyCLIP-auto-ViT-45M-32-Text-18M-LAIONYFCC400M). See [Model Selection Guide](#model-selection-guide) for available options.
+The default model is ViT-45LY (`TinyCLIP-auto-ViT-45M-32-Text-18M-LAIONYFCC400M`). See [Model Selection Guide](#model-selection-guide) for available options.
 
 ##### i. Start Service
 
@@ -90,7 +88,7 @@ ImgSearch service is running
 
 #### Running as a System Service
 
-ImgSearch can run as a background system service that starts and stops with your system. On Linux, it uses `systemd`; on macOS, `launchd`. The tool auto-detects your environment—no manual configuration needed.
+ImgSearch can run as a background system service that starts and stops with your system. On Linux, it uses `systemd`; on macOS, `launchd`. The tool auto-detects your environment — no manual configuration needed.
 
 ##### i. Set Up Service
 
@@ -131,39 +129,37 @@ The `add` command extracts 512-dimensional feature vectors from images using Tin
 
 The `search` subcommand handles image searches, but for ease of use, it's the default—omit it if your arguments don't match other commands.
 
-Search syntax: `isearch [search] QUERY` (`[search]` optional).
+Search command: `isearch [search] QUERY`.
 
 #### Search by Image
 
 ```shell
 # Search similar images, return top 10 results (similarity ≥0%)
 isearch ./query.jpg
-# Equivalent: isearch search ./query.jpg
+
+# Equivalent:
+isearch search ./query.jpg
 
 # Set minimum similarity threshold and result count
-isearch -n 5 -m 80 ./query.jpg
-# Equivalent: isearch search -n 5 -m 80 ./query.jpg
+isearch -n 5 -t 80 ./query.jpg
 
-# Automatically open result images
+# Automatically open result images (the Label when adding an image must be a path)
 isearch -o ./query.jpg
-# Equivalent: isearch search -o ./query.jpg
 ```
 
 #### Search by Text
 
 ```shell
 # Search for "red flower" related images
 isearch "red flower"
-# Equivalent: isearch search "red flower"
 
 # Specify count and threshold
-isearch -n 3 -m 70 "sunset beach"
-# Equivalent: isearch search -n 3 -m 70 "sunset beach"
+isearch -n 3 -t 70 "sports car"
 ```
 
 Results sorted by similarity descending, show path and percentage. Example:
 ```
-Searching red flower...
+Searching sports car...
 Found 5 similar images (similarity ≥ 70.0%):
  1. /path/to/img1.jpg	92.3%
  2. /path/to/img2.png	85.1%
@@ -341,10 +337,10 @@ uv pip install --torch-backend cpu imgsearch
 
 ## 使用方法
 
-ImgSearch 整体为 C-S 架构，服务端处理索引和搜索，客户端处理用户请求。使用前需先开启他的服务端程序。
-
 ### 1. 服务管理
 
+ImgSearch 整体为 C-S 架构，服务端处理索引和搜索，客户端处理用户请求。使用前需先开启他的服务端程序。
+
 ImgSearch 服务端支持 Unix 域套接字或 TCP 绑定。默认使用 Unix 域套接字运行在本地，稳定且高效。默认 UDS 位置为 `~/.isearch/isearch.sock`。
 
 #### 基本用法
@@ -425,7 +421,7 @@ isearch add -d my_gallery ./photos/ -B ./isearch.sock
 
 搜索图片使用 `search` 子命令，为了操作方便，isearch 已将它设为默认子命令，使用时可以省略。
 
-搜图语法：`isearch [search] QUERY`（`[search]` 可选）。
+搜图方式：`isearch [search] QUERY`。
 
 #### 以图搜图
 
@@ -437,9 +433,9 @@ isearch ./query.jpg
 isearch search ./query.jpg
 
 # 设置最小相似度阈值和结果数量
-isearch -n 5 -m 80 ./query.jpg
+isearch -n 5 -t 80 ./query.jpg
 
-# 自动打开结果图片
+# 自动打开结果图片（添加图片时的 Label 必须是 path）
 isearch -o ./query.jpg
 ```
 
@@ -450,7 +446,7 @@ isearch -o ./query.jpg
 isearch "red flower"
 
 # 指定数量和阈值
-isearch -n 3 -m 70 "sports car"
+isearch -n 3 -t 70 "sports car"
 ```
 
 搜索结果按相似度降序排列，显示路径和相似度。示例：
@@ -585,3 +581,4 @@ ImgSearch 支持多种 TinyCLIP 模型，默认的 `ViT-45LY` 平衡了速度、
 # 重启 isearch 服务
 isearch service stop
 isearch service start -m NEW_MODEL_KEY
+```

src/imgsearch/client.py

@@ -258,7 +258,7 @@ def create_parser() -> ArgumentParser:
         help=f'Search images {ut.bold("(default)")}',
         formatter_class=DefaultFmt,
     )
-    cmd_search.add_argument('-m', dest='sim_thr', type=int, default=0, help='Similarity threshold, 0 - 100')
+    cmd_search.add_argument('-t', dest='sim_thr', type=int, default=0, help='Similarity threshold, 0 - 100')
     cmd_search.add_argument('-n', dest='num', type=int, default=10, help='Number of search results')
     cmd_search.add_argument('-o', dest='open_res', action='store_true', help='Open the searched images')
     cmd_search.add_argument('target', nargs='?', help='Search target (image path or keyword)')

src/imgsearch/setup.py

@@ -17,7 +17,7 @@
 Group={usergroup}
 WorkingDirectory={base_dir}
 Environment=PATH={py_bin}:/usr/local/bin:/usr/bin:/bin
-ExecStart={py_bin}/isearch service start -b {base_dir} -m {model_key} -B {bind} -l {log_level}
+ExecStart={py_bin}/isearch service start -b {base_dir} -m {model_key} -B {bind} -L {log_level}
 ExecStop=kill $MAINPID
 Restart=on-failure
 RestartSec=30
@@ -50,7 +50,7 @@
       <string>{model_key}</string>
       <string>-B</string>
       <string>{bind}</string>
-      <string>-l</string>
+      <string>-L</string>
       <string>{log_level}</string>
     </array>
 
@@ -141,6 +141,8 @@ def setup_service(
 ) -> bool:
     """Install service on the current platform."""
     base_dir = Path(base_dir).resolve()
+    if not base_dir.exists():
+        base_dir.mkdir(parents=True, exist_ok=True)
     if not base_dir.is_dir():
         raise NotADirectoryError(f'Base directory {base_dir} does not exist.')