客户 vCard 导出

解决的具体问题

在浏览器端或不需要 Node 服务端能力的场景中生成联系人文件时，引入完整的第三方库往往伴随着不必要的依赖负担。例如 vcards-js 在构建或运行时可能带来 fs 模块相关的依赖，这对纯前端工具或轻量级脚本而言是一种过度设计。本技能提供了一种极简方案：通过纯字符串拼接直接生成符合规范的 vCard 3.0 文件，并利用浏览器原生的 Blob 对象完成下载。这种方式避免了 Node fs 依赖，同时保留了对 text/vcard 格式和基本联系人信息的完整支持。

核心能力与关键步骤

该技能的核心逻辑围绕 vCard 3.0 的标准字段映射展开，所有能力映射至 vcard-io，但实现上完全依赖自研的拼接逻辑。

1. 必填项与可选项：必须提供姓名（FN 与 N 字段），手机号、邮箱和公司则作为可选字段，按需注入。
2. 字符串拼接：直接组装 BEGIN:VCARD、VERSION:3.0、FN、N、ORG、TEL;TYPE=CELL、EMAIL 和 END:VCARD 等核心行。
3. 字段转义：针对逗号、分号以及换行符进行转义处理，防止字段内容破坏 vCard 的行结构。
4. Blob 下载：将拼接完成的字符串封装为 text/vcard 类型的 Blob，并以姓名作为文件名触发下载。

适用边界与注意点

• 格式版本：仅输出 vCard 3.0，不涉及 vCard 4.0 的扩展特性。
• 字段范围：仅覆盖 FN、N、ORG、TEL、EMAIL 等基础字段，不处理头像或自定义扩展属性。
• 环境依赖：依赖运行环境支持 Blob 对象，适合浏览器或现代 JS 运行环境。