metowolf / vcards

📡️ vCards **黄页 - 优化 iOS/Android 来电、信息界面体验

vCards CN

导入常用联系人头像，优化 iOS 来电、信息界面体验。

使用指南

订阅：CardDAV 服务/ 或参考教程自建

采用订阅方式导入，优势是会自动更新，也更方便区分和管理个人通讯录和黄页，不会混合两种列表。

• 服务器：vcards.metowolf.com
• 用户名：cn
• 密码：cn 或任意填写

步骤：

1. iOS：「设置」--「通讯录」--「账户」--「添加账户」-- 「其他」--「添加 CardDAV 账户」
2. Mac：「通讯录」--「设置」--「账户」--「其他通讯录账户」

下载导入

1. 到 https://github.com/metowolf/vCards/releases 下载最新的打包文件 archive.zip；
2. 解压后，根据不同平台的指南导入 vcf 文件至 iCloud 中，推荐单独创建「黄页」分组方便管理和隐藏。

macOS

• 在 Mac 上的“通讯录”中创建联系人群组
• 在 Mac 上的“通讯录”中导入来自其他应用的联系人

iOS/web

• 在 iCloud 通讯录中创建群组
• 将联系人导入 iCloud 通讯录

---

请求收录

1. 打开 https://github.com/metowolf/vCards/issues/new/choose 页面，选择「vCard 新增请求」
2. 完整填写相关信息
3. 提交 issue，等待处理

参与维护

1. 在 /data/类别/ 里添加 yaml 与 png 文件
2. 在根目录下执行 yarn test 检查格式规范
3. 提交 pull requests，等待合并

号码收录

由于不同地区不同运营商的 106 短信推送号段存在差异，项目不作收录，建议将本项目作为一个基础模板，导入联系人后可以按以下方式自行补充其余号码

图标设计

• 采用 PNG 编码
• 画布大小 width：200px；height：200px
• logo 居中放置
  • 圆形尺寸 140w140h
  • 正矩形尺寸 120w120h
  • 长矩形尺寸 160w80h
  • 无 svg 需要使用 Inkscape 改绘转换
  • 特殊情况特殊处理
• 图像大小压缩在 20 kB 内

致谢

• 114 百事通提供查询接口
• 百度手机卫士提供查询接口
• **可信号码数据中心提供查询接口

vcards's Issues

国家电网

• 类别： 政府机构
• 组织名称：国家电网
• 电话号码：95598
• 官方网址：http://www.sgcc.com.cn/

重庆农商行，PayPal，阿里通信

• 类别： 「金融银行」

• 组织名称：「重庆农村商业银行」

• 电话号码：「95389」

• 官方网址：「http://www.cqrcb.com/」

• 类别： 「电商购物」

• 组织名称：「PayPal」

• 电话号码：「400-921-1000
  [phone]」

• 官方网址：「https://www.paypal.com/」

• 类别： 「应用软件」

• 组织名称：「阿里通信」

• 电话号码：「10029」

• 官方网址：「https://aliqin.tmall.com/」

上海公积金

• 类别： 社会服务
• 组织名称：上海住房公积金
• 电话号码：12329
• 官方网址：http://www.shgjj.com/

国际化 (i18n) 化

可以做个*扰电话的vCards导入手机直接拉黑那个联系人

• 类别： 「*扰电话」
• 组织名称：「这里填写公司组织的名称」
• 电话号码：「这里填写电话，如有多个请分行填写」
• 官方网址：「这里填写官方网址」

百世快递

• 类别： 「快递物流」
• 组织名称：「百世快递」
• 电话号码：「95320」
• 官方网址：「http://800bestex.com/」

**石油

• 常见企业： 「这里填写联系人的分类」
• **石油：「这里填写公司组织的名称」
• 95504：「这里填写电话，如有多个请分行填写」
• 官方网址：「这里填写官方网址」

哈尔滨银行

• 类别： 「金融银行」
• 组织名称：「哈尔滨银行」
• 电话号码：「95537」
• 官方网址：「www.hrbcb.com.cn」

添加 腾讯视频

• 类别： 软件应用
• 组织名称：腾讯
• 电话号码：[phone]
• 官方网址：https://v.qq.com/

建议添加各银行信用卡电话及短信

信用卡电话一般都是400电话，部分银行还有VIP专线，
另外银行的短信号码一般都是固定的1069xx+955xx，所以银行业可以考虑添加短信1069号码

腾讯云

• 类别： 「互联网服务」
• 组织名称：「腾讯」
• 电话号码：「106918323720980」
• 官方网址：「https://cloud.tencent.com/」

Apple

• 类别： 「其他」
• 组织名称：「Apple」
• 电话号码：「
  400-666-8800（Apple Store）
  400-627-2273（Apple Care）
  400-619-8141（辅助功能和辅助技术）
  」
• 官方网址：「https://apple.com/cn/」

建议Description和README中增加适用对象：Android及AOSP

毕竟黄页这种东西几乎只存在于国内的xxUI当中，像Google pixel等国际版手机与其它AOSP based ROM基本都没有这一功能。同时本repo也十分适用于上述ROM。

iOS 如何创建黄页分组？

如何把所有的电话都存入黄页分组？谢谢。

山东航空

• 类别： 「出行购票」
• 组织名称：「山东航空」
• 电话号码：「95369」
• 官方网址：「http://www.sda.cn/」

Dior

• 类别： 「其他」
• 组织名称：「DIOR迪奥官方网站」
• 电话号码：「400 122 66 22」
• 官方网址：「https://www.dior.cn/」

丰巢 & 菜鸟裹裹

• 类别： 快递物流

• 组织名称：丰巢

• 电话号码：10691184148605

• 官方网址：https://www.fcbox.com/

• 类别： 快递物流

• 组织名称：菜鸟裹裹

• 电话号码：
  10691491211900016
  1069223991395900016
  10655000218419507900
  1069330011900016

• 官方网址：https://www.guoguo-app.com/

是否无限制地接受地方银行的issue有待讨论

全国性银行覆盖了大多数使用者，而持续添加地方银行使得工作量变得巨大。
添加地方银行是否应该有一个标准，达标才能收录？🤔

建议添加微众银行

• 类别： 「银行」
• 组织名称：「深圳前海微众银行」
• 电话号码：「95384、400-999-8800」
• 官方网址：「www.webank.com」

添加 豆瓣 闲鱼

杭州银行

• 类别： 「金融银行」
• 组织名称：「杭州银行」
• 电话号码：「95398」
• 官方网址：「http://www.hzbank.com.cn/」

什么值得买

• 类别： 「电商购物」
• 组织名称：「什么值得买」
• 电话号码：「010-56640700」
• 官方网址：「https://www.smzdm.com/」

南京银行

• 类别： 金融银行
• 组织名称：南京银行
• 电话号码：95302
• 官方网址：http://www.njcb.com.cn/

电话类型默认全部为移动电话 ?

能否默认更改为工作? 和/或固定电话

是不是可以弄成一个订阅呢？

当前 iOS 设备支持“CardDAV” 和 “LDAP” 方式订阅通讯录，弄成这两种模式是不是会比较方便呢？云端更新后，自动同步到本地。

请求添加 中原银行

• 类别： 「金融银行」
• 组织名称：「中原银行」
• 电话号码：「95186」
• 官方网址：「http://www.zybank.com.cn/」

京东到家

• 类别： 「电商购物」
• 组织名称：「京东到家」
• 电话号码：「」
• 官方网址：「http://www.jddj.com/」

学习强国 & 工信部

• 类别： 「学习类」

• 组织名称：「学习强国」

• 电话号码：「12361」

• 官方网址：「https://www.xuexi.cn」

• 类别： 「通信类」

• 组织名称：「沃邮箱」

• 电话号码：「10655462」

• 官方网址：「https://mail.wo.cn/」

• 类别： 「通信类」

• 组织名称：「沃音乐」

• 电话号码：「10655158」

• 官方网址：「http://www.10155.com/」

• 类别： 「通信类」

• 组织名称：「**联通」

• 电话号码：「10655550」

• 电话号码：「10655117」

• 电话号码：「10017」

• 官方网址：「http://www.10010.com/」

• 类别： 「通信类」

• 组织名称：「工信部」

• 电话号码：「01012300」

• 官方网址：「http://www.miit.gov.cn/」

宁波银行

• 类别： 「金融银行」
• 组织名称：「宁波银行」
• 电话号码：「95574」
• 官方网址：「http://www.nbcb.com.cn/」

也许可以添加各地**领事馆联系方式

方便旅行者/华侨，尤其是在可能的紧急状况下。

沃钱包

10655025995188 支付宝
106980095566 **银行
106929395555 招商银行
1069117810170 腾讯科技
10655862 **联通
106559999 **联通
106900369611111 韩亚银行
106550010010 **联通
10188 沃钱包

Xbox**客服

400 886 6140

**太平

• 类别： 「证券保险」
• 组织名称：「**太平」
• 电话号码：「95589」
• 官方网址：「http://www.cntaiping.com/」

**银联

• 类别： 「金融银行」
• 组织名称：「**银联」
• 电话号码：「95516」
• 官方网址：「https://cn.unionpay.com/」

添加 哈啰出行

• 类别： 行车交通
• 组织名称：「这里填写公司组织的名称」
• 电话号码：9521-8900
• 官方网址：https://www.hellobike.com

麻烦新增携程

• 类别： 「出行购票」
• 组织名称：「携程」
• 电话号码：「95010」
• 官方网址：「https://www.ctrip.com」

强烈建议在release包里增加一个“以上全部”

强烈建议在release包里增加一个“以上全部”
这样就不用一个一个导入了

请求添加京东物流

• 类别： 「快递物流」
• 组织名称：「京东物流」
• 电话号码：「950616」
• 官方网址：「https://www.jdwl.com」

沃留言

• 类别： 通讯服务
• 组织名称：**联通
• 电话号码：10165
• 官方网址：https://wly.mail.wo.cn

健康160

• 类别： 「软件」
• 组织名称：「健康160」
• 电话号码：「106915506645191160」
• 官方网址：「https://www.91160.com/」

**人保

• 类别： 「证券保险」
• 组织名称：「**人保」
• 电话号码：「95591」
• 电话号码：「95518」
• 电话号码：「4008895518」
• 官方网址：「http://www.picc.com/」

**联通

• 类别： 「通信」
• 组织名称：「**联通」
• 电话号码：「106551588」
• 官方网址：「http://www.10010.com」

网易考拉

• 类别： 软件应用
• 组织名称：网易
• 电话号码：95163111
• 官方网址：https://www.kaola.com/

广州银行

• 类别： 「银行」
• 组织名称：「广州银行」
• 电话号码：「96699、400-83-96699」
• 官方网址：「http://www.gzcb.com.cn/i_index.shtml」

该有星巴克了！

• 类别： 「外卖订餐」
• 组织名称：「星巴克**」
• 电话号码：「400-820-6998」
• 官方网址：「https://www.starbucks.com.cn」

国际化 (i18n)

现在这个文件结构生成出来的内容只能是单个语言的，不是很方便平时用英文版系统的用户。如果可以修改一下结构，以便生成英文版 (或者其他任何语言的版本) 内容那就更好了。

小米移动

• 类别： 「通讯服务」
• 组织名称：「小米移动」
• 电话号码：「
  10046
  400-922-3838
  」
• 官方网址：「https://10046.mi.com/」

**移动手机报

• 类别： 「其它」
• 组织名称：「**移动手机报」
• 电话号码：「10658000」
• 官方网址：「http://www.10086.cn/」

麻烦新增飞猪

• 类别： 出行购票
• 组织名称：飞猪
• 电话号码：9510208
• 官方网址：https://www.fliggy.com

添加 吉祥航空

• 类别： 「出行购票」
• 组织名称：「吉祥航空」
• 电话号码：「95520
  1069029895520
  」
• 官方网址：「www.juneyaoair.com」