用途:pp-roam 通过 roam-pp-cli 二进制把 Roam HQ 的各类接口搬到 shell 或智能体里,适合做流水线、定时任务和本地优先搜索,例如追踪 Webhook 投递、发送部署通知、跨会议搜索转录、用 HRIS 名单核对 SCIM 成员、从录音中提取决策。
安装与验证:先确认 CLI 已安装,缺失时用 npx -y @mvanhorn/printing-press-library install roam --cli-only 安装(macOS/Linux 默认装到 $HOME/.local/bin,Windows 为 %LOCALAPPDATA%\Programs\PrintingPress\bin),并确保该目录在 $PATH。若 npx 失败,可回退到 Go 安装(需 Go 1.26.6 或更新):go install github.com/mvanhorn/printing-press-library/library/productivity/roam/cmd/roam-pp-cli@latest。用 roam-pp-cli --version 验证,报 command not found 时不要继续执行技能命令。
主要能力:grep 可跨聊天消息与会议转录搜索,支持 --since、--from-user、--in-meeting、--in-group 过滤;decisions 从已同步转录中提取决策型语句;onair-attendance-drift 对比受邀与实际出席;webhook-tail 追踪本地订阅的近期投递;mention-inbox 对消息文本做本地全文检索找 @提及;transcript-fanout 对日期范围内每个转录跑同一问题并给出答案与引用;relay 把 stdin 行经 /chat.post 转发进群组,带幂等键与 429 退避;doctor token 探测密钥可访问的接口族。变更类命令默认安全:onair-reaper 找出长期零出席的周期性 On-Air 活动,--apply 才取消;scim-diff 对比 CSV/JSON 名单与 SCIM 用户列表,--apply 才执行增删改。
命令范围:还包含聊天(chat-list/history/post/update/delete/typing/send-message)、群组(group-add/create/members/remove/rename/archive、groups 系列)、用户与 SCIM(users 系列、user-list/lookup/info、schemas、resource-types、service-provider-config)、会议与转录(meeting-list、transcript-list/info/prompt、recording-list)、On-Air(event/guest 系列)、Webhook(subscribe/unsubscribe)、lobby、magicast、meetinglink、reaction、item-upload、messageevent-export、userauditlog、token-info、addr-info、app-uninstall、test 等。不确定命令时可用 roam-pp-cli which "<能力>" 查询。
限制:需先安装并验证 CLI;部分接口仅限组织模式或需要特定 scope;On-Air 取消不可撤销;SCIM 与用户删除为软删除;资料未提供具体收费、价格与平台支持细节。