docs: 修正使用说明中的标点和格式

Jesse205 · Jesse205 · commit 80cb722c17c3 · 2025-05-31T06:05:38.000+08:00
diff --git a/README.md b/README.md
@@ -20,7 +20,7 @@ _The application currently only supports the Chinese language._
 
 </div>
 
-VCF generator, input name and phone number to automatically generate VCF files for batch import into the address book.
+VCF generator, input name and phone number to automatically generate VCF files for batch importing into the address book.
 
 [![License](https://img.shields.io/github/license/HelloTool/VCFGeneratorLiteForTkinter)](./LICENSE)
 [![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg)](./docs/CODE_OF_CONDUCT.md)
@@ -51,7 +51,7 @@ Different application packages have different environment requirements. Please c
 | Installer/Portable Package | Windows 7+               | x86_64          | Windows 7 requires patch files (see below for details) |
 | Zip Application            | Python 3.12+ and Tkinter | No restrictions | -                                                      |
 
-### File Download List
+### Get the Software Package
 
 Get the software package through the following channels:
 
@@ -69,7 +69,7 @@ File list for each system:
 ## Usage
 
 1. Open the app.
-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.
+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 omitted.
    ```text
    Isaac Newton	13445467890	British mathematician
    Muhammad		13554678907
@@ -79,19 +79,19 @@ File list for each system:
 4. Copy the generated VCF file to your phone, select "Contacts" when opening the file, and then follow the prompts.
 5. Wait for the import to complete.
 
-> [!NOTE]
+> [!NOTE] Note
 >
 > - Tabs will be automatically converted to spaces for processing.
-> - The program will automatically remove excess spaces from the input box.
+> - The program will automatically remove extra 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, ` Han Meimei   13333333333   A   well-known girl` will be recognized as
 >
-> ```text
-> Name: Han Meimei
-> Phone: 13333333333
-> Note: A well-known girl
-> ```
+>
+> > - Name: Han Meimei
+> > - Phone: 13333333333
+> > - Note: A well-known girl
+>
 
 ## Compatibility
 
@@ -103,7 +103,7 @@ File list for each system:
 | Windows 10+        | Display Scaling | Unable to auto-scale when switching DPI; scaling adaptation is handled by the operating system |
 | Windows 10+        | Font Scaling    | Font scaling not supported                                                                     |
 | Windows 7+         | Display Scaling | Icon scaling only supports 100%, 125%, and 150% levels                                         |
-| Windows 7 - 8.1    | App Launch      | Requires patch                                                                                 |
+| Windows 7 ~ 8.1    | App Launch      | Requires patches                                                                               |
 
 #### Special Notes
 
@@ -124,7 +124,7 @@ File list for each system:
 
 ### vCard File Compatibility
 
-This APP only supports generating version 2.1 vCard files that contain only name and phone number.
+This app only supports generating version 2.1 vCard files that contain only name and phone number.
 
 | Third-party Application | Compatibility                                              |
 | ----------------------- | ---------------------------------------------------------- |
diff --git a/README.zh.md b/README.zh.md
@@ -42,10 +42,6 @@ VCF 生成器，输入姓名与手机号则自动生成用于批量导入到通
 | 便携包   | 解压即用（支持U盘随身携带） | 免安装/临时使用           |
 | Zip 应用 | 双击直接运行                | 快速启动/跨平台使用       |
 
-<!-- | Chocolatey         | 命令行一键部署              | 自动化安装/集中管理/快速版本更新 |
-| Android 应用软件包 | 安装后使用                  | 移动设备使用/临时处理需求        |
-| 网站               | 进入网站即可运行            | 临时使用/跨平台使用              | -->
-
 ### 环境要求
 
 不同的应用包有一不同环境要求，您需要根据您的系统环境选择对应的应用包。
@@ -55,11 +51,7 @@ VCF 生成器，输入姓名与手机号则自动生成用于批量导入到通
 | 安装器/便携包 | Windows 7+              | x86_64   | Windows 7 需补丁文件（见下方说明） |
 | Zip 应用      | Python 3.12+ 与 Tkinter | 无限制   | -                                  |
 
-<!-- | Chocolatey         | Chocolatey 2.0.0       | x86_64   | 需安装 Chocolatey                            |
-| Android 应用软件包 | Android 系统环境       | 未知     | Windows 11 需安装 WSA，Linux 需安装 Waydroid |
-| 网站               | 浏览器                 | 无限制   | 需安装浏览器                                 | -->
-
-### 文件下载列表
+### 获取软件包
 
 通过以下渠道获取软件包：
 
@@ -74,48 +66,43 @@ VCF 生成器，输入姓名与手机号则自动生成用于批量导入到通
 | 便携包     | `*_portable.zip`      | 暂未提供                | 暂未提供                | 不支持  |
 | Zip 应用   | `*_zipapp.pyzw`       | `*_zipapp.pyzw`（推荐） | `*_zipapp.pyzw`（推荐） | 不支持  |
 
-<!-- | Chocolatey         | 暂未提供                  | 不支持                            | 不支持                            | 不支持           |
-| Android 应用软件包 | 暂未提供                  | 暂未提供                          | 不支持                            | 暂未提供（推荐） |
-| 网站               | 暂未提供                  | 暂未提供                          | 不支持                            | 暂未提供         | -->
-
 ## 使用方法
 
-1. 把名字和电话以每行 `姓名 电话号码 备注` 的格式复制到下面的编辑框内，其中备注可忽略；
+1. 把名字和电话以每行 `姓名 电话号码 备注` 的格式复制到下面的编辑框内，其中备注可忽略。
    ```text
    张三	13345367789	著名的法外狂徒
    李四	13445467890
    王五	13554678907
    赵六	13645436748
    ```
-2. 点击“生成”，选择一个路径保存文件；
-3. 将生成后的 VCF 文件复制到手机内，打开文件时选择使用“通讯录”，然后根据提示操作；
+2. 点击“生成”，选择一个路径保存文件。
+3. 将生成后的 VCF 文件复制到手机内，打开文件时选择使用“通讯录”，然后根据提示操作。
 4. 等待导入完成。
 
-> [!NOTE]
+> [!NOTE] 说明
 >
 > - 制表符会自动转换为空格处理，您可以同时使用制表符和空格分割。
 > - 程序会自动去除输入框内多余的空格。
 > - 如果每行有多个空格，则会将最后一个空格以前所有的字符当作姓名处理。
 >
 > 比如 `东坡居士 苏轼   13333333333  眉州眉山人` 将会被识别为
 >
-> ```text
-> 姓名：东坡居士 苏轼
-> 电话：13333333333
-> 备注：眉州眉山人
-> ```
+> > - 姓名：东坡居士 苏轼
+> > - 电话：13333333333
+> > - 备注：眉州眉山人
+>
 
 ## 兼容性
 
 ### 应用兼容性
 
-| 系统环境        | 特性     | 兼容性                                          |
-| --------------- | -------- | ----------------------------------------------- |
-| Windows 10+     | 深色模式 | 不支持深色模式                                  |
-| Windows 10+     | 显示缩放 | 切换 DPI 时无法自动缩放，缩放适配由操作系统完成 |
-| Windows 10+     | 字体缩放 | 不支持字体缩放                                  |
-| Windows 7+      | 显示缩放 | 仅支持 100%、125%、150% 级别图标缩放            |
-| Windows 7 - 8.1 | 应用启动 | 需要补丁                                        |
+| 系统环境       | 特性     | 兼容性                                          |
+| -------------- | -------- | ----------------------------------------------- |
+| Windows 10+    | 深色模式 | 不支持深色模式                                  |
+| Windows 10+    | 显示缩放 | 切换 DPI 时无法自动缩放，缩放适配由操作系统完成 |
+| Windows 10+    | 字体缩放 | 不支持字体缩放                                  |
+| Windows 7+     | 显示缩放 | 仅支持 100%、125%、150% 级别图标缩放            |
+| Windows 7～8.1 | 应用启动 | 需要补丁                                        |
 
 #### 特别说明
 
diff --git a/docs/CODE_OF_CONDUCT.md b/docs/CODE_OF_CONDUCT.md
@@ -21,23 +21,23 @@ diverse, inclusive, and healthy community.
 Examples of behavior that contributes to a positive environment for our
 community include:
 
-* Demonstrating empathy and kindness toward other people
-* Being respectful of differing opinions, viewpoints, and experiences
-* Giving and gracefully accepting constructive feedback
-* Accepting responsibility and apologizing to those affected by our mistakes,
+- Demonstrating empathy and kindness toward other people
+- Being respectful of differing opinions, viewpoints, and experiences
+- Giving and gracefully accepting constructive feedback
+- Accepting responsibility and apologizing to those affected by our mistakes,
   and learning from the experience
-* Focusing on what is best not just for us as individuals, but for the overall
+- Focusing on what is best not just for us as individuals, but for the overall
   community
 
 Examples of unacceptable behavior include:
 
-* The use of sexualized language or imagery, and sexual attention or advances of
+- The use of sexualized language or imagery, and sexual attention or advances of
   any kind
-* Trolling, insulting or derogatory comments, and personal or political attacks
-* Public or private harassment
-* Publishing others' private information, such as a physical or email address,
+- Trolling, insulting or derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information, such as a physical or email address,
   without their explicit permission
-* Other conduct which could reasonably be considered inappropriate in a
+- Other conduct which could reasonably be considered inappropriate in a
   professional setting
 
 ## Enforcement Responsibilities
diff --git a/docs/CODE_OF_CONDUCT.zh.md b/docs/CODE_OF_CONDUCT.zh.md
@@ -14,19 +14,19 @@
 
 有助于为我们的社区创造积极环境的行为例子包括但不限于：
 
-* 表现出对他人的同情和善意
-* 尊重不同的主张、观点和感受
-* 提出和大方接受建设性意见
-* 承担责任并向受我们错误影响的人道歉
-* 注重社区共同诉求，而非个人得失
+- 表现出对他人的同情和善意
+- 尊重不同的主张、观点和感受
+- 提出和大方接受建设性意见
+- 承担责任并向受我们错误影响的人道歉
+- 注重社区共同诉求，而非个人得失
 
 不当行为例子包括：
 
-* 使用情色化的语言或图像，及性引诱或挑逗
-* 嘲弄、侮辱或诋毁性评论，以及人身或政治攻击
-* 公开或私下的骚扰行为
-* 未经他人明确许可，公布他人的私人信息，如物理或电子邮件地址
-* 其他有理由认定为违反职业操守的不当行为
+- 使用情色化的语言或图像，及性引诱或挑逗
+- 嘲弄、侮辱或诋毁性评论，以及人身或政治攻击
+- 公开或私下的骚扰行为
+- 未经他人明确许可，公布他人的私人信息，如物理或电子邮件地址
+- 其他有理由认定为违反职业操守的不当行为
 
 ## 责任和权力
 
diff --git a/docs/CONTRIBUTING.md b/docs/CONTRIBUTING.md
@@ -4,45 +4,49 @@
 
 为了更好地理解开源贡献的流程，您可以参考《如何开源软件指南》中的“[为开源做贡献](https://opensource.guide/zh-hans/how-to-contribute/)”章节。此外，《开源指北》中的“[尝试参与开源](https://gitee.com/opensource-guide/guide/participating/roles.html)”章节也提供了详细的入门指导。
 
-在提交贡献时，您需要遵守[贡献者公约](./CODE_OF_CONDUCT.zh.md)、各平台的规则以及当地法律法规。
+在提交贡献时，您需要遵守[贡献者公约](./CODE_OF_CONDUCT.zh.md)、当前平台的规则以及当地法律法规。
 
 ## 翻译应用
 
-敬请期待
+敬请期待。
 
 ## 提交反馈
 
 您可以在 [Gitee Issues][IssuesOnGitee] 或 [GitHub Issues][IssuesOnGithub] 平台中提交反馈。
 
 ## 参与开发
 
-1. 确保 [Gitee][RepositoryOnGitee] 或 [GitHub][RepositoryOnGithub] 中没有相关的 PR；
-2. Fork 本仓库；
-3. 使用 [Git](https://git-scm.com/) 克隆仓库到本地；
-4. 阅读[开发指南](./dev/README.md)，熟悉项目开发方法；
-5. 创建分支，如 `feature/xxx` 或 `bugfix/xxx`；
-6. 编写并提交代码；
-7. 向本仓库提交 Pull Request。
+1. 确保 [Gitee][RepositoryOnGitee] 或 [GitHub][RepositoryOnGithub] 中没有相关的拉取请求（PR）
+2. Fork 本仓库
+3. 使用 [Git](https://git-scm.com/) 克隆仓库到本地
+4. 阅读[开发指南](./dev/README.md)，熟悉项目开发方法
+5. 创建分支，如 `feature/xxx` 或 `bugfix/xxx`
+6. 编写并提交代码
+7. 向本仓库提交 PR
 
 此外，有一些规范规则，请遵守：
 
 ## 代码规范
 
-**Python（`.py`）：**
+**Python (`.py`)：**
 
-- 函数参数必须声明类型；
-- 单行最大字符数：120；
-- 其他情况以 [PEP8](https://peps.python.org/pep-0008/) 为准。
+- 函数参数必须声明类型
+- 单行最大 120 字符
+- 其他情况以 [PEP8](https://peps.python.org/pep-0008/) 为准
 
-**Markdown（`.md`）：**
+**Markdown (`.md`)：**
 
-- 不限制最大行数；
-- 详情请参考 `.markdownlint.json`；
-- 其他情况以 [Markdownlint](https://github.com/DavidAnson/markdownlint) 为准。
+- 不限制单行最大字符数
+- 详情请参考 `.markdownlint.json`
+- 其他情况以 [Markdownlint](https://github.com/DavidAnson/markdownlint) 为准
 
 详情请参考 `.editorconfig`。
 
-## GIT 提交规范
+## 文档规范
+
+遵守[《中文技术文档写作风格指南》](https://zh-style-guide.readthedocs.io/zh-cn/latest/index.html)和以下规则：
+
+## Git 提交规范
 
 遵循 [约定式提交](https://www.conventionalcommits.org/zh-hans/v1.0.0/)。
 
diff --git a/src/vcf_generator_lite/window/main/constants.py b/src/vcf_generator_lite/window/main/constants.py
@@ -9,7 +9,7 @@
 """
 
 USAGE = """使用说明：
-1. 把名字和电话以每行“姓名 电话号码 备注”的格式复制到下面的编辑框内，其中备注可忽略；
-2. 点击“生成”，选择一个路径保存文件；
+1. 把名字和电话以每行“姓名 电话号码 备注”的格式复制到下面的编辑框内，其中备注可忽略。
+2. 点击“生成”，选择一个路径保存文件。
 3. 将生成后的 VCF 文件复制到手机内，打开文件时选择使用“通讯录”，然后根据提示操作。
-4. 等待导入完成"""
+4. 等待导入完成。"""
