Quay lại README

Hướng dẫn Cấu hình Kênh Matrix

1. Cấu hình Mẫu

Thêm vào config.json:

json

{
  "channel_list": {
    "matrix": {
      "enabled": true,
      "type": "matrix",
      "homeserver": "https://matrix.org",
      "user_id": "@your-bot:matrix.org",
      "access_token": "YOUR_MATRIX_ACCESS_TOKEN",
      "device_id": "",
      "join_on_invite": true,
      "allow_from": [],
      "group_trigger": {
        "mention_only": true
      },
      "placeholder": {
        "enabled": true,
        "text": "Thinking..."
      },
      "reasoning_channel_id": "",
      "message_format": "richtext"
    }
  }
}

2. Tham chiếu Trường

Trường	Kiểu	Bắt buộc	Mô tả
enabled	bool	Có	Bật hoặc tắt kênh Matrix
homeserver	string	Có	URL homeserver Matrix (ví dụ `https://matrix.org`)
user_id	string	Có	ID người dùng Matrix của bot (ví dụ `@bot:matrix.org`)
access_token	string	Có	Token truy cập của bot
device_id	string	Không	ID thiết bị Matrix tùy chọn
join_on_invite	bool	Không	Tự động tham gia phòng được mời
allow_from	[]string	Không	Danh sách trắng người dùng (ID Matrix)
group_trigger	object	Không	Chiến lược kích hoạt nhóm (`mention_only` / `prefixes`)
placeholder	object	Không	Cấu hình tin nhắn giữ chỗ
reasoning_channel_id	string	Không	Kênh đích cho đầu ra suy luận
message_format	string	Không	Định dạng đầu ra: `"richtext"` (mặc định) render markdown thành HTML; `"plain"` chỉ gửi văn bản thuần

3. Tính năng Hiện tại

Gửi/nhận tin nhắn văn bản với render markdown (đậm, nghiêng, tiêu đề, khối code, v.v.)
Định dạng tin nhắn có thể cấu hình (richtext / plain)
Tải xuống hình ảnh/âm thanh/video/tệp đến (MediaStore trước, fallback đường dẫn cục bộ)
Chuẩn hóa âm thanh đến vào luồng phiên âm hiện có ([audio: ...])
Tải lên và gửi hình ảnh/âm thanh/video/tệp đi
Quy tắc kích hoạt nhóm (bao gồm chế độ chỉ đề cập)
Trạng thái đang gõ (m.typing)
Tin nhắn giữ chỗ + thay thế phản hồi cuối cùng
Tự động tham gia phòng được mời (có thể tắt)

4. TODO

Cải thiện metadata phương tiện phong phú (ví dụ kích thước và hình thu nhỏ hình ảnh/video)