carddav-contacts

CardDAV Contacts 是一款基于成熟开源工具 vdirsyncer 和 khard 的联系人管理技能，专为需要通过命令行高效管理 CardDAV 协议联系人的用户设计。该技能的核心工作流程分为同步与管理两个阶段：首先通过 vdirsyncer 将 Google、iCloud、Nextcloud 等远程 CardDAV 服务中的联系人同步至本地 .vcf 文件，然后利用 khard 提供强大的本地查询和管理能力。

核心用法涵盖联系人生命周期管理的全流程。用户可通过简单的关键词搜索快速定位联系人，支持模糊匹配和特定字段（如邮箱、电话、地址）的精确提取。查看功能提供美观的格式化输出和 YAML 结构化数据，便于阅读和后续处理。管理操作包括新建、编辑、删除和跨地址簿移动联系人，所有操作均通过交互式编辑器完成，确保数据准确性。

该技能的显著优点在于将联系人数据完全控制在本地，有效避免云端服务的隐私风险，同时支持离线访问。基于成熟的 Python 生态工具，稳定性和可靠性经过广泛验证。命令行界面配合管道支持，可轻松集成到自动化脚本和日常工作流中，极大提升批量处理效率。

然而，该技能也存在一定局限性。首先，纯命令行界面对非技术用户存在学习门槛，配置过程涉及 INI 文件编辑和 CardDAV 服务凭证设置。其次，作为 T3 级别的个人开源项目，长期维护的持续性存在一定不确定性。功能上依赖外部系统包（vdirsyncer 和 khard），需要用户自行处理安装和版本兼容性问题，且不具备实时同步能力。

适合使用该技能的用户群体包括：注重隐私保护的技术从业者、习惯命令行操作的高效工作者、需要离线访问联系人数据的移动办公人员，以及希望将联系人管理集成到自动化工作流中的开发者。对于追求图形界面或需要实时双向同步的商业场景则不太适用。

使用风险主要集中于配置与数据安全方面：CardDAV 账户凭证需要妥善保管，建议设置严格的文件权限（700）并使用应用专用密码而非主密码。同步过程可能产生冲突，虽然支持冲突解决策略，但初次配置时需谨慎测试。此外，作为外部依赖型技能，vdirsyncer 和 khard 的版本更新可能影响功能稳定性，建议通过系统包管理器安装以获取自动更新。删除操作不可逆，执行前建议备份 ~/.local/share/vdirsyncer/ 目录。