spectrum

Spectrum

Spectrum 是 Photon's 的统一消息 SDK。针对一个 app.messages 流编写处理程序逻辑，并通过 iMessage、WhatsApp Business、Terminal 或自定义提供方发送消息。本技能适用于 spectrum-ts 12.2.0；代码示例使用 TypeScript。

契约检查

编写提供方专属代码前，先确定提供方并加载其主题文件。只有当每个导入、方法、内容形状、平台 ID、回退方案和抛出的错误都属于 spectrum-ts 12.2.0 及所选提供方的契约时，示例才算完整。通用方法的存在并不能证明每个提供方都实现了该方法；当支持情况会影响正确性时，请阅读 capability-semantics.md。

本技能的组织方式

每个主题都位于此目录中的独立文件内。请阅读与用户问题相关的文件。

文件	适用场景
getting-started.md	安装、Spectrum() 应用实例、多平台配置、四个核心原语。
messages.md	接收消息、Message 形状、按 content.type 缩窄类型、过滤自己的消息。
content.md	用于发送消息的内容构建器：text、markdown、attachment、voice、contact、richlink、app、poll、group、custom。
spaces-and-users.md	Space 接口、正在输入指示器、responding、创建私信和群组。
reactions-and-replies.md	message.react(...)、线程式 message.reply(...)，以及两者的适用场景。
capability-semantics.md	原生支持与回退、警告并跳过、接受但不执行，以及抛出错误。
platform-narrowing.md	从通用 Spectrum 原语中恢复平台专属类型。
providers/imessage.md	iMessage——独立的云端／本地提供方、共享／专用云线路模式、按电话号码路由、消息效果、点按回应。
providers/terminal.md	Terminal TUI 提供方——聊天侧边栏、回应、回复、附件、斜杠命令。
providers/whatsapp-business.md	WhatsApp Business Cloud API。仅支持一对一。
custom-events-and-lifecycle.md	按提供方划分的事件流（app.typing 等）、app.stop()、信号处理。
custom-platforms.md	使用 definePlatform 编写自己的提供方——完整字段参考。
best-practices.md	Photon 内部使用的生产架构模式——防抖流水线、进行中请求取消、向前传递、幂等重试、按资源存储记忆、作业失败审计日志。

另请参阅

• Spectrum 文档
• GitHub 上的 spectrum-ts