{"id":15027137,"url":"https://github.com/metowolf/vcards","last_synced_at":"2026-05-14T14:02:07.632Z","repository":{"id":37677799,"uuid":"192521247","full_name":"metowolf/vCards","owner":"metowolf","description":"📡️ vCards 中国黄页 - 优化 iOS/Android 来电、信息界面体验","archived":false,"fork":false,"pushed_at":"2025-04-16T09:31:09.000Z","size":2547,"stargazers_count":5853,"open_issues_count":249,"forks_count":279,"subscribers_count":56,"default_branch":"master","last_synced_at":"2025-04-28T11:56:13.290Z","etag":null,"topics":["china","ios","macos","vcards"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/metowolf.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-06-18T10:49:34.000Z","updated_at":"2025-04-27T18:59:32.000Z","dependencies_parsed_at":"2023-02-10T19:30:31.634Z","dependency_job_id":"1646b7fe-46f6-4852-a1d5-3f08014274b0","html_url":"https://github.com/metowolf/vCards","commit_stats":null,"previous_names":[],"tags_count":178,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/metowolf%2FvCards","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/metowolf%2FvCards/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/metowolf%2FvCards/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/metowolf%2FvCards/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/metowolf","download_url":"https://codeload.github.com/metowolf/vCards/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251311332,"owners_count":21569008,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["china","ios","macos","vcards"],"created_at":"2024-09-24T20:05:50.388Z","updated_at":"2026-05-04T09:03:51.014Z","avatar_url":"https://github.com/metowolf.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# vCards CN\n\n导入常用联系人头像，优化 iOS 来电、信息界面体验。\n\n![Screenshot](https://user-images.githubusercontent.com/2666735/59692672-0b6bdf00-9218-11e9-881e-5856e263f3aa.png)\n\n---\n\n## 使用指南\n\n### 方法一：安装 CardDAV 描述文件（推荐）\n\n1. 使用**系统相机**扫描下方二维码，下载配置描述文件  \n\u003e   \u003ca href=\"https://vcards.metowolf.com/vcards.mobileconfig\"\u003e\u003cimg src=\"https://github.com/user-attachments/assets/238f9d9a-5aa6-4636-8e67-4829535eaab9\" width=\"150px\" height=\"150px\" /\u003e\u003c/a\u003e\n\n2. 打开“设置”App，轻点“已下载描述文件”或“注册 [组织的名称]”  \n\u003e   \u003cimg src=\"https://github.com/user-attachments/assets/12997c2d-6172-49f0-9236-0b4f30ad9ebd\" width=\"300px\" /\u003e\n\n3. 在右上角点击“安装”，按屏幕提示操作完成导入。\n\n---\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e方法二：手动订阅 CardDAV 服务\u003c/strong\u003e\u003c/summary\u003e\n\n采用订阅方式导入，优势是会自动更新，也方便区分和管理个人通讯录和黄页，避免混合两种列表。\n\n- 服务器：`vcards.metowolf.com`\n- 用户名：`cn`\n- 密码：`cn` 或任意填写\n\n如担心隐私问题，可参考 [自建教程](https://github.com/metowolf/vCards/issues/208)。\n\n#### 设置步骤\n\n- **iOS**  \n  「设置」→「通讯录」→「账户」→「添加账户」→「其他」→「添加 CardDAV 账户」  \n  参考：[官方文档](https://support.apple.com/zh-cn/guide/iphone/ipha0d932e96/ios)\n\n- **Mac**  \n  「通讯录」→「设置」→「账户」→「其他通讯录账户」  \n  参考：[官方文档](https://support.apple.com/zh-cn/guide/contacts/adrb7e5aaa2a/mac)\n\n\u003e ⚠️ 默认 iOS 获取新资料的方式为「自动」，此情况下只有连接电源和 WLAN 时才会推送数据，请耐心等待。\n\n\u003c/details\u003e\n\n---\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003e方法三：下载导入\u003c/strong\u003e\u003c/summary\u003e\n\n1. 前往 [Releases 页面](https://github.com/metowolf/vCards/releases) 下载最新打包文件 `archive.zip`\n2. 解压后，根据不同平台指南导入 `vcf` 文件至 iCloud（建议单独创建「黄页」分组以便管理与隐藏）\n\n#### macOS\n- [在 Mac 上的“通讯录”中创建联系人群组](https://support.apple.com/zh-cn/guide/contacts/adrb3280fe91/12.0/mac/10.14)\n- [在 Mac 上的“通讯录”中导入来自其他应用的联系人](https://support.apple.com/zh-cn/guide/contacts/adrbk1457/mac)\n\n#### iOS / Web\n- [在 iCloud 通讯录中创建群组](https://support.apple.com/kb/PH2667?locale=zh_CN)\n- [将联系人导入 iCloud 通讯录](https://support.apple.com/kb/ph3605?locale=zh_CN)\n\n\u003c/details\u003e\n\n---\n\n## 请求收录\n\n1. 打开 [新增 vCard 请求](https://github.com/metowolf/vCards/issues/new/choose) 页面，选择「vCard 新增请求」\n2. 完整填写相关信息\n3. 提交 Issue，等待处理\n\n---\n\n## 参与维护\n\n1. 在 `/data/类别/` 目录下添加 `yaml` 和 `png` 文件\n2. 在根目录执行 `npm test` 检查格式规范\n3. 提交 Pull Request，等待合并\n\n---\n\n## 号码收录说明\n\n鉴于不同地区及运营商的 106 短信推送号段存在差异，项目不做统一收录。建议将本项目作为基础模板，导入联系人后可按下图方式自行补充所需号码：\n\n![Screenshot](https://user-images.githubusercontent.com/2666735/59747105-ccd33480-92aa-11e9-90e0-93f295dcb504.png)\n\n---\n\n## 图标设计规范\n\n- 采用 `PNG` 编码\n- 画布大小：`200px × 200px` 或 `512px × 512px`\n- logo 居中放置：\n  - 圆形：140 × 140 px\n  - 正方形：120 × 120 px\n  - 长方形：160 × 80 px\n  - 特殊情况特殊处理\n- **不支持 SVG**，如需转换请使用 Inkscape 改绘\n- 图像大小压缩在 `20 kB`（200px）或 `50 kB`（512px）内\n\n![Design](https://user-images.githubusercontent.com/2666735/60966995-224fae00-a34c-11e9-970c-ea5fa15186c6.png)\n\n---\n\n## 致谢\n\n- [114 百事通](http://www.114best.com/) 提供查询接口\n- [百度手机卫士](https://haoma.baidu.com/yellowPage) 提供查询接口\n- [中国可信号码数据中心](https://www.kexinhaoma.org/) 提供查询接口\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmetowolf%2Fvcards","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmetowolf%2Fvcards","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmetowolf%2Fvcards/lists"}