SuperAPI AI 工具集

configure-messaging

部署与运维

查看项目

更新于 11-03 23:38

技能介绍

用途 configure-messaging 用于在 opensteer 项目中设置、添加或测试消息提供商及其渠道传输。使用前应阅读 docs/messaging.md 与 packages/channel-core/src/catalog.ts。

Slack 配置 在 https://api.slack.com/apps 使用目录中的 setup manifest 创建应用。启用 Socket Mode,将应用安装到工作区,获取机器人 OAuth 令牌,以及带 connections:write 权限的应用级令牌,并通过 Messaging setup 输入这些令牌。将机器人邀请到每个频道。路由和发送者准入需分别配置;集成 OAuth 登录不等于配置消息功能。

新增提供商 在 packages/channel-<provider> 中实现 ChannelAdapter,并支持可注入的传输层。在确认前提交 onEvent,仅在承载消息时调用 onReady,遵守 actor audience,并对投递 ID 进行协调或记录重复风险。将清单添加到静态目录,并在 apps/channel-runtime/src/main.ts 注册工厂,或为计算机传输准备 prepareMessagingModule。授权保留在 Host 中。

测试 只运行受影响的聚焦检查: pnpm exec vitest run packages/channel-slack/src/connection.test.ts packages/channel-slack/src/events.test.ts packages/channel-slack/src/outbound.test.ts packages/channel-slack/src/mrkdwn.test.ts pnpm test:integration -- apps/host/src/channels/messaging-end-to-end.integration.test.ts pnpm test:integration -- apps/host/src/channels/channel-pipeline.integration.test.ts 另一提供商需替换适配器测试。iMessage 的 Host/Runner 契约使用 pnpm test:integration -- apps/host/src/channels/imessage-channel.integration.test.ts,其中桌面桥接为模拟。真实 Messages 交互应使用 computer-use/VM 指引,而非主机屏幕。在成本最低的相关层确认 DM、提及与跟进路由、私有身份通知、准入/撤销及不确定发送恢复。失败后也停止已启动的服务。

适用场景 适用于配置 Slack 消息渠道、实现新的消息提供商适配器、验证消息路由与准入逻辑。限制包括:文档未提供支持提供商完整列表、版本要求、令牌权限细节以外的收费或平台信息;具体实现依赖仓库内文档与代码。