SuperAPI AI 工具集

outlook_contacts

通用与其它

查看项目

更新于 10-16 02:35

技能介绍

用途:用本地助手 CLI 管理 Outlook 联系人,让对话保持简洁,支持个人微软账户与 Microsoft 365 工作或学校账户。

主要能力:命令行 outlook-contacts <subcommand> [options] 提供 disconnect、accounts(仅身份元数据,不含令牌)、list [--page-size 10] [--page-token <token>]、get "AAMkAD..."、search "alice smith" --page-size 10、create、update、delete 等子命令。create 可带 --given-name、--family-name、--email、--phone;update 仅修改指定字段,未指定字段保持原值。搜索可用于按姓名、邮箱或电话查找;list 支持通过 --page-token 分页。通用选项 --timeout-secs N,默认 30。--page-size 控制结果数量;--top、--limit、--max-results 仅为兼容别名,不建议在新命令中使用。

用法与账户选择:默认使用已关联的联系人账户,也可用 --account <account_id> 指定;当用户明确指向某账户时,先运行 outlook-contacts accounts,匹配其 display_name 后传入其 account_id,匹配有歧义时须询问,不可静默改用默认账户。--account 仅适用于联系人操作;--status、accounts、disconnect 为连接器级别。选定账户后,后续使用该账户结果的分页、get、update、delete 都需重复同一 --account。

认证:依赖由 outlook-contacts 管理的 Outlook 连接器,用 outlook-contacts --status 查看状态。若返回 connect_url,分享 Connect Outlook Contacts;若需新增账户,分享 Add Outlook Contacts account;断开时运行 outlook-contacts disconnect,若有 disconnect_url 则分享 Disconnect Outlook Contacts,否则说明已断开。出现认证失败应停止并检查状态,必要时按提示重新登录,切勿重跑不带 --account 的失败命令。不要手写令牌文件或猜测连接器状态。

输出约定:list/search 解析 ok、count、next_page_token、total_people 及 contacts 字段;get 解析 contact 的 resource_name、display_name、emails、phones、organization、title;create/update/delete 解析 ok、action、resource_name。

限制:未经用户明确要求,不要打印连接器密钥或原始联系人负载;不要在给用户的文本中暴露原始 Graph 标识符(如 AAMkAD...)及 change key、分页令牌等内部字段,仅在内部串联后续命令时复用。联系人 ID 与分页令牌仅在其返回账户内有效。缺失计费、平台支持范围等信息暂未提供。