message

package

v1.2.0 Latest Latest Go to latest Published: Jun 11, 2026 License: MIT Imports: 2 Imported by: 0

Details

message 包定义 AnyBot 的协议中立消息链。

This section is empty.

This section is empty.

This section is empty.

type Chain []Segment

Chain 是按顺序排列的协议中立消息段。

func New(segments ...Segment) Chain

New 根据消息段构造新的消息链。

func (c Chain) Append(segments ...Segment) Chain

Append 返回追加消息段后的新消息链，不修改原链。

func (c Chain) Clone() Chain

Clone 返回消息链副本，避免异步观察者和处理链共享可变段数据。

func (c Chain) IsZero() bool

IsZero 判断消息链是否为空。

func (c Chain) MarshalJSON() ([]byte, error)

MarshalJSON 将 nil 消息链编码为空数组，便于适配器直接作为消息参数传递。

func (c Chain) Text() string

Text 返回所有文本消息段按顺序拼接后的内容。

type Segment struct {
	Type string         `json:"type"`
	Data map[string]any `json:"data,omitempty"`
}

Segment 表示一个协议中立的消息段。

func Image(file string) Segment

Image 创建图片消息段，file 通常为 URL、file URI 或协议端可识别的路径。

func Raw(kind string, data map[string]any) Segment

Raw 创建带自定义类型和数据的消息段，供适配器或协议扩展使用。

func Text(text string) Segment

Text 创建纯文本消息段。

func Video(file string) Segment

Video 创建视频消息段。