用途
Outlook Contacts 用于管理用户 Outlook 账户中的联系人,帮助在不冗长提示的前提下完成联系人的查看、检索与维护。
主要能力
通过本地辅助命令行工具 outlook-contacts 提供以下子命令:
- disconnect:断开关联
- list:分页浏览联系人,支持 --page-size 与 --page-token
- get:按联系人 ID 获取详情
- search:按姓名、邮箱或电话号码搜索
- create:创建联系人,可指定名、姓、邮箱、电话
- update:更新指定字段,未指定字段保持原值
- delete:删除联系人
通用选项 --timeout-secs N 默认 30 秒。--top、--limit、--max-results 仅为兼容别名,新命令中不建议使用。
输出约定
各子命令返回 JSON,包含 ok、action、status、count、next_page_token、total_people、contacts[](resource_name、display_name、emails、phones)、contact(resource_name、display_name、emails、phones、organization、title)等字段,具体因命令而异。
授权与连接
该技能依赖由 outlook-contacts 管理的 Outlook 连接器。使用 outlook-contacts --status 检查状态。连接或重连时,需以 Markdown 链接形式分享返回的 connect_url;断开时运行 disconnect,若返回 disconnect_url 则以 Markdown 链接形式分享,否则说明已断开。不得使用共享连接器辅助 CLI,不得手动编写令牌文件或猜测连接器状态。
使用方式与规则
- 按姓名、邮箱或电话查找联系人使用 search;浏览联系人使用 list,并通过 --page-token 分页。
- 联系人 ID 为不透明 Graph 字符串(如 AAMkAD...),须使用 list 或 search 返回的精确值。
- 在用户请求清晰明确时,create、update、delete 可直接执行,无需额外确认。
- 更新联系人时只修改指定字段。
- 若 CLI 报告授权错误,重新检查 --status 并引导用户重新连接。
- 不得打印连接器密钥或导出原始联系人数据,除非用户明确要求。
- 不得在面向用户的文本中展示原始 Graph 标识符或内部响应字段(变更键、分页令牌、原始 JSON),仅在内部串联后续命令时复用 ID;用户明确要求或排障时必须展示时除外。
适用场景
适合需要集中浏览、按条件检索或维护 Outlook 联系人信息的个人与工作场景。
限制
资料未提供安装命令、收费方式、价格、支持的平台范围及与其他系统的集成说明;具体功能以实际 CLI 行为为准。