SuperAPI AI 工具集

pp-superhuman

智能体与模型

查看项目

更新于 10-16 01:32

技能介绍

用途:把 Superhuman 邮箱的读取、草拟、回复、搜索等操作搬到终端或 Claude Code 中,供脚本和智能体调用,底层由本地 SQLite 存储与 JSON 输入输出支撑。

主要能力:会话的读取、列表、搜索、归档、加标签(threads);单条消息获取与语义搜索(messages);草稿创建、更新、发送、删除(drafts);发送、定时、提醒(send);贪睡提醒(reminders);附件上传、列表、下载(attachments);联系人实时增强(lookup,含姓名、简介、位置、时区、头像、社交链接、Twitter 账号);Ask AI 语义搜索(ai);本地联系人分析(participants);等待回复的会话(awaiting-reply);Gmail 历史变更流(watch);团队与账号信息(teams、users);复用片段(snippets);自然语言能力解析(which)以及低层 CRDT 写入(userdata write,默认演练,需 --apply 才执行,路径须以 users/ 开头)。

使用方式:先安装 CLI,需确认二进制已就绪。安装命令 npx -y @mvanhorn/printing-press-library install superhuman --cli-only,验证 superhuman-pp-cli --version。若安装失败,可回退 go install github.com/mvanhorn/printing-press-library/library/productivity/superhuman/cmd/superhuman-pp-cli@latest(需 Go 1.26.6 或更新)。调用时加 --agent 会展开为 --json --compact --no-input --no-color --yes。可用 which 做自然语言到命令的匹配(退出码 0 表示匹配成功,2 表示无把握匹配)。认证方面无公开 API 密钥,可读取 Chrome 磁盘会话并存储可刷新令牌:superhuman-pp-cli auth login --disk,配合 auth status 与 doctor 检查。也提供 MCP 注册:claude mcp add superhuman-pp-mcp -- superhuman-pp-mcp。

适用场景:终端或 Claude Code 中收发邮件、批量分拣会话、按 Gmail 搜索语法查找消息、发送带撤销窗口或定时投递的邮件、对联系人做增强后起草、把 Ask AI 语义搜索结果接入其他工具。

限制与注意:邮件经 Gmail API 投递,而非 Superhuman 的 /messages/send MTA,因此不能承诺仅 Superhuman 服务端才有的发送行为。目前没有团队草稿共享或邮件合并命令,也无法生成某些仅 Superhuman 接口需要的 iOS 受众令牌。读取命令默认会先做一次轻量 Gmail 历史刷新,可用 --no-refresh 或环境变量 SUPERHUMAN_NO_AUTO_REFRESH=1 关闭。默认非交互、不提权;输出可用 --select 裁剪字段、--envelope 控制封装、--deliver 路由到 stdout、文件或 webhook。反馈默认仅存于本地。部分命令的收费、配额与平台差异等细节暂未提供。