SuperAPI AI 工具集

outlook_contacts

通用与其它

查看项目

更新于 10-15 17:20

技能介绍

用途:通过本地辅助 CLI(outlook-contacts)管理 Outlook 联系人,使提示保持简洁,支持个人微软账户及 Microsoft 365 工作或学校账户。

主要能力:核心子命令包括 disconnect、list、get、search、create、update、delete。list 支持 --page-size 与 --page-token 分页;search 可按姓名、邮箱或电话查找;get 按联系人 ID 获取详情;create/update/delete 用于增改删。通用选项 --timeout-secs N(默认 30)。--top、--limit、--max-results 仅为兼容别名,新命令中不应使用。

使用方式:命令格式为 outlook-contacts <subcommand> [options]。例如 list [--page-size 10] [--page-token <token>]、get "AAMkAD..."、search "alice smith" --page-size 10、create --given-name "Alice" --family-name "Smith" --email alice@example.com --phone "+15551234567"、update "AAMkAD..." --given-name "Alice" --email newalice@example.com、delete "AAMkAD..."。输出为 JSON,需解析 ok、count、next_page_token、total_people、contacts[] 等字段;next_page_token 需回传为 --page-token。

认证:依赖由 outlook-contacts 管理的 Outlook 连接器,使用 outlook-contacts --status 查看状态。连接或重连时,将返回的 <connect_url> 替换后以 Markdown 链接 Connect Outlook Contacts 分享,不要单独粘贴原始 URL;断开时运行 outlook-contacts disconnect,若有 disconnect_url 则以 Disconnect Outlook Contacts 分享,若不存在则说明已断开。不要为 Outlook Contacts 使用共享连接器辅助 CLI,不要手写令牌文件或猜测连接状态。

限制与规则:联系人 ID 为不透明的 Graph 字符串(如 AAMkAD...),须使用 list 或 search 返回的精确值;更新时仅修改指定字段,未指定字段保持原值;认证错误时重新检查状态并引导重连;除非用户明确要求,不要打印连接器密钥或原始联系人负载;不要在展示给用户的文本中暴露原始 Graph 标识符或内部响应字段(变更键、分页/跳过令牌、原始 JSON),仅在内部用于串联后续命令。create、update、delete 在用户请求清晰无歧义时可直接执行,无需额外确认。