feat(contact): 支持备注字段

fixes #ICAWCE

Author: Jesse205

README.md

@@ -69,11 +69,11 @@ File list for each system:
 ## Usage
 
 1. Open the app.
-2. Copy the name and phone number in the format of `Name PhoneNumber` on each line into the editing box below;
+2. Copy the name and phone number in the format of `Name PhoneNumber Note` on each line into the editing box below. The note can be ignored.
    ```text
-   Hardy Buck	13445467890
-   Alva Mackintosh	13554678907
-   Hobart Baker	13645436748
+   Isaac Newton	13445467890	British mathematician
+   Muhammad		13554678907
+   Confucius		13645436748
    ```
 3. Click "生成" (Generate), select a path to save the file.
 4. Copy the generated VCF file to your phone, select "Contacts" when opening the file, and then follow the prompts.
@@ -85,11 +85,12 @@ File list for each system:
 > - The program will automatically remove excess spaces from the input box.
 > - If there are multiple spaces in each line, all characters before the last space will be treated as names.
 >
-> For example, ` Hardy Buck   13333333333   ` will be recognized as
+> For example, ` Han Meimei   13333333333   A   well-known girl` will be recognized as
 >
 > ```text
-> Name: Hardy Buck
+> Name: Han Meimei
 > Phone: 13333333333
+> Note: A well-known girl
 > ```
 
 ## Compatibility

README.zh.md

@@ -80,8 +80,9 @@ VCF 生成器，输入姓名与手机号则自动生成用于批量导入到通
 
 ## 使用方法
 
-1. 把名字和电话以每行 `姓名 电话号码` 的格式复制到下面的编辑框内；
+1. 把名字和电话以每行 `姓名 电话号码 备注` 的格式复制到下面的编辑框内，其中备注可忽略；
    ```text
+   张三	13345367789	著名的法外狂徒
    李四	13445467890
    王五	13554678907
    赵六	13645436748
@@ -92,15 +93,16 @@ VCF 生成器，输入姓名与手机号则自动生成用于批量导入到通
 
 > [!NOTE]
 >
-> - 制表符将会自动转换为空格处理。
+> - 制表符会自动转换为空格处理，您可以同时使用制表符和空格分割。
 > - 程序会自动去除输入框内多余的空格。
 > - 如果每行有多个空格，则会将最后一个空格以前所有的字符当作姓名处理。
 >
-> 比如 ` Wang lei   13333333333   ` 将会被识别为
+> 比如 `东坡居士 苏轼   13333333333  眉州眉山人` 将会被识别为
 >
 > ```text
-> 姓名：Wang lei
+> 姓名：东坡居士 苏轼
 > 电话：13333333333
+> 备注：眉州眉山人
 > ```
 
 ## 兼容性

src/vcf_generator_lite/models/contact.py

@@ -1,25 +1,33 @@
 import re
-from typing import NamedTuple
+from typing import NamedTuple, Optional
 
 CHINA_PHONE_PATTERN = re.compile(r"^1[356789]\d{9}$")
 
 
 class Contact(NamedTuple):
     name: str
     phone: str
+    note: Optional[str] = None
 
 
-def is_china_phone(phone: str) -> bool:
-    return CHINA_PHONE_PATTERN.match(phone) is not None
+def is_china_mobile_phone(phone: str) -> bool:
+    return len(phone) == 11 and CHINA_PHONE_PATTERN.match(phone) is not None
 
 
 def parse_contact(person_text: str):
-    info_list: list[str] = person_text.rsplit(None, 1)
-    if len(info_list) != 2:
+    # 修改分割逻辑以支持备注字段
+    parts = person_text.split()
+    if len(parts) < 2:
         raise ValueError(f"The person info is illegal: '{person_text}'.")
-    name, phone = info_list
-    if not name:
-        raise ValueError(f"The name is illegal: '{name}'.")
-    if not is_china_phone(phone):
-        raise ValueError(f"The phone number is illegal: '{phone}'.")
-    return Contact(name, phone)
+
+    for i, part in enumerate(parts):
+        if is_china_mobile_phone(part):
+            phone = part
+            name = " ".join(parts[:i])
+            note_parts = parts[i + 1:]
+            note = " ".join(note_parts) if note_parts else None
+            break
+    else:
+        raise ValueError(f"The person info is illegal: '{person_text}'.")
+
+    return Contact(name, phone, note)

src/vcf_generator_lite/services/vcf_generator.py

@@ -33,11 +33,11 @@ class GenerateResult:
 
 
 def serialize_to_vcard(contact: Contact):
-    name_encoded = binascii.b2a_qp(contact.name.encode("utf-8")).decode("utf-8")
     return f"""BEGIN:VCARD
 VERSION:2.1
-FN;CHARSET=UTF-8;ENCODING=QUOTED-PRINTABLE:{name_encoded}
-TEL;CELL:{contact.phone}
+FN;CHARSET=UTF-8;ENCODING=QUOTED-PRINTABLE:{binascii.b2a_qp(contact.name.encode("utf-8")).decode("utf-8")}
+TEL;CELL:{contact.phone}{f"""
+NOTE;CHARSET=UTF-8;ENCODING=QUOTED-PRINTABLE:{contact.note}""" if contact.note else ""}
 END:VCARD"""
 
 

src/vcf_generator_lite/window/main/constants.py

@@ -2,14 +2,14 @@
 EVENT_CLEAN_QUOTES = "<<CleanQuotes>>"
 EVENT_GENERATE = "<<Generate>>"
 
-DEFAULT_INPUT_CONTENT = """张三	13345367789
-李四	13445467890
-王五	13554678907
-赵六	13645436748
+DEFAULT_INPUT_CONTENT = """张三\t13345367789\t著名的法外狂徒
+李四\t13445467890
+王五\t13554678907
+赵六\t13645436748
 """
 
 USAGE = """使用说明：
-1. 把名字和电话以每行“姓名 电话号码”的格式复制到下面的编辑框内；
+1. 把名字和电话以每行“姓名 电话号码 备注”的格式复制到下面的编辑框内，其中备注可忽略；
 2. 点击“生成”，选择一个路径保存文件；
 3. 将生成后的 VCF 文件复制到手机内，打开文件时选择使用“通讯录”，然后根据提示操作。
 4. 等待导入完成"""