本工具旨在帮助用户高效地管理通讯录数据，并将其转换为手机可识别的 vCard (.vcf) 格式。支持从 Excel、CSV、VCF 文件导入，并提供批量去重和手动编辑功能

核心功能指南

1. 数据导入（四种方式）

• 手动粘贴：在界面左侧文本框中粘贴“姓名+号码”（支持空格、制表符、冒号或逗号分割），点击“解析粘贴”即可载入表格。

• Excel/CSV 导入：

  1. 点击“导入文件”，选择 .xlsx 或 .csv 文件。

  2. 在弹出的导入向导中，确认“首行是否为表头”。

  3. 选择“姓名列”和“号码列”（支持多选号码列）。

  4. 点击“导入（追加）”或“导入（覆盖）”。

• VCF 导入：支持直接读取旧的 .vcf 通讯录文件进行二次编辑。

• 拖拽导入：直接将文件拖入程序窗口即可快速触发导入（需安装 tkinterdnd2）。

2. 通讯录管理

• 实时搜索：在搜索框输入关键词，表格会自动筛选匹配的联系人。

• 快速编辑：

  • 新增：点击“新增”手动添加联系人。

  • 修改：在表格中双击某一行，或选中后点击“编辑”。

  • 删除：选中一行或多行，点击“删除”。

• 一键去重：支持按“姓名+号码”或“仅号码”进行智能去重。

3. VCF 导出设置

在导出前，您可以在右侧面板配置以下参数：

• vCard 版本：默认为 3.0（兼容性最强），也可选 4.0。

• 编码格式：推荐使用 UTF-8；若在旧款安卓机上显示乱码，请尝试改为 GBK。

• 导出模式：

  • 单文件：所有联系人合并为一个 .vcf 文件。

  • 多文件：每个联系人生成一个独立的文件。

• 号码类型：可标记为手机（CELL）、家庭（HOME）或工作（WORK）。

自动备份与状态恢复

工具具备草稿自动保存功能：

• 您的导入记录和编辑草稿会实时保存。

• 即使意外关闭程序，下次启动时也会自动加载上一次未导出的数据。

• 相关数据存储在用户目录下的 .vcf_generator_state 文件夹中。

⚠️ 注意事项

1. 数据规范：导入时请确保每条数据至少包含一个姓名和一个号码。

2. 号码清洗：工具会自动剔除号码中的非法字符（如括号、横杠），仅保留数字和开头的“+”号。

3. 软件激活：本工具启动时会进行授权校验，请确保在联网环境下初次运行。