# VCF 生成器 轻量版 
**仓库**：
[][repository-gitee]
[][repository-github]
**平台**：
[][release-gitee]
[][release-gitee]
**语言**：
**简体中文** |
[English](./README.md) |
期待您的翻译！
VCF 生成器 轻量版 是一个简单高效的应用，可以将联系人列表转换为单个 vCard (`.vcf`) 文件。生成的文件可以批量导入到手机通讯录或用于其他各种用途。
基于 Python 与 Tkinter 构建，提供原生桌面应用体验。
[](./LICENSE)
[](./CODE_OF_CONDUCT.zh-CN.md)
[][workflow-test]
[][release-github]
[][stargazers-gitee]
## 特性
### 核心功能
- **智能解析**：自动识别并以 `姓名 电话 备注` 格式解析，多空格自动合并。
- **区域号码支持**：覆盖中国大陆及港澳台地区的电话号码规则。
- **辅助编辑**：文本框内置行号，支持一键去除单元格引号。
- **号码校验**：自动过滤无效号码，并定位到出错行，便于快速修正。
- **批量导出**：将所有联系人合并导出为单个 `.vcf` 文件。
- **海量处理**：单次可处理百万级联系人，上限仅取决于可用内存。
### 界面与交互
- **原生界面风格**：布局遵循 Windows 7 设计规范，样式跟随操作系统。
- **界面缩放**：自动适配高 DPI 与系统缩放设置，在高分屏上清晰不模糊。
- **多屏优化**：子窗口自动跟随父窗口位置，并确保在当前显示屏内完整显示。
- **多语言**：内置中英双语界面，跟随系统语言自动切换。
### 分发、授权与隐私
- **极致轻量**：依赖极少，Python ZIP 应用体积不足 100KB，下载即用。
- **完全免费**：所有功能永久免费，无需注册或付费。
- **纯净无扰**：无广告、无捆绑、无推广。
- **无磁盘日志**：日志仅输出至标准输出，不写入磁盘。
- **开源授权**：基于 Apache License 2.0 开源协议，允许自由修改、分发及商用。
## 使用场景
- **企业通讯录分发**：HR 或行政人员将公司通讯录批量导入员工手机。
- **活动参与者联络**：会议、培训、团建等活动组织者快速分发参与者联系方式。
- **客户资料迁移**：销售、客服人员在换手机或设备时批量迁移客户联系方式。
- **数据迁移**：从 Excel、旧系统或其他格式导出联系人到新手机。
- **家校联系分发**：教师或管理员分发班级学生及家长联系方式。
## 软件截图
## 下载与安装
通过以下渠道下载软件包：
- [Gitee 发行版][release-gitee]（推荐中国大陆地区用户使用）
- [GitHub Releases][release-github]
根据您的平台选择软件包，点击指南查看详细的安装和启动方法：
| 平台 | 软件包类型 | 需要安装 | 文件 | 指南 |
| ------- | --------------- | -------- | ----------------------------------------------------------- | ------------------------------------------------------------------- |
| Windows | 安装程序 | 是 | VCFGeneratorLite-v\<应用版本\>-**win-amd64**-*setup.exe* | [Windows 安装程序](./docs/guides/installation/windows-installer.md) |
| Windows | 便携包 | 否 | VCFGeneratorLite-v\<应用版本\>-**win-amd64**-*portable.zip* | [Windows 便携包](./docs/guides/installation/windows-portable.md) |
| 跨平台 | Python Wheel | 可选 | vcf_generator_lite-\<应用版本\>-**py3-none-any**.*whl* | [Python Wheel](./docs/guides/installation/wheel.md) |
| 跨平台 | Python ZIP 应用 | 否 | VCFGeneratorLite-v\<应用版本\>-**py3**.*pyzw* | [Python ZIP 应用](./docs/guides/installation/zipapp.md) |
## 使用方法
1. 把名字和电话以每行 `姓名 电话 备注` 的格式复制到主界面的文本框中，其中备注可忽略。例如：
```text
屈原 13333333333 战国时期诗人
曹操 13444444444
陶渊明 13555555555
谢灵运 13666666666
```
2. 点击 **开始生成**，选择一个路径保存文件。
3. 然后就可以在需要的地方使用生成的 vCard 文件。详情请参考 [使用 vCard 文件](./docs/guides/vcard-usage.md)。
有关更多内容请参考 [用户文档](./docs/index.md)。
有关系统要求、vCard 兼容性、已知问题等请参考 [兼容性说明](./docs/reference/compatibility.md)。
## 致谢
### AI 辅助
本项目的部分内容通过 AI 辅助生成：
- **Trae**：生成代码、文档优化、代码优化、语言翻译
- **Qoder**：补全代码、文档优化、指导编码
- **DeepSeek**：指导编码、生成代码、文档优化、语言翻译
- **元宝**：指导编码、生成代码、语言翻译
- **WorkBuddy**：审查代码、文档优化
- **OpenCode**：文档优化
## 许可证
本项目以 Apache 2.0 许可证授权，详情请参阅 [许可证文件](./LICENSE)。
## 第三方声明
本项目使用了第三方开源代码，您可以在 [声明文件](./NOTICES.zh-CN.md) 中查看详细信息。
## 更多文档
- [贡献指南](./CONTRIBUTING.zh-CN.md)
- [开发文档](./docs/dev/index.md)
- [用户文档](./docs/index.md)
---