mirror of
https://github.com/kuaifan/dootask.git
synced 2026-08-01 19:05:55 +00:00
53 lines
1.8 KiB
Markdown
53 lines
1.8 KiB
Markdown
---
|
||
id: messenger.read-receipt.concept
|
||
title: 已读未读状态
|
||
type: concept
|
||
feature: messenger
|
||
scope: end-user
|
||
locale: zh
|
||
aliases:
|
||
- 已读未读
|
||
- 谁看过了
|
||
- 消息已读
|
||
- 谁还没看
|
||
- 看消息回执
|
||
- 已读列表
|
||
related_tools: [get_message_list]
|
||
related_pages: [messenger, dialog_chat]
|
||
prerequisites: []
|
||
negative:
|
||
- 已读未读不支持手动关闭显示，是系统统一行为
|
||
- 通知类消息（notice）、系统消息不计入已读统计
|
||
- 离开会话不会自动标记已读，需要打开会话并向上滚动经过该消息
|
||
last_verified: v1.7.90
|
||
---
|
||
|
||
# 已读未读状态
|
||
|
||
DooTask 的「已读未读」（read receipt）以消息 + 用户两两组合粒度记录。每个对话成员对每条消息有一行 `web_socket_dialog_msg_reads`，未读 read_at=null，已读后写入时间戳。
|
||
|
||
## 定义
|
||
|
||
- 未读（unread）：read_at 为 null
|
||
- 已读（read）：read_at 有值
|
||
- @提及未读（mention）：未读 + mention=1 的子集，会在会话列表右侧显示带数字的「@」标记
|
||
- 红点（dot）：服务端推送轻提示，刷新会话即清除
|
||
|
||
## 关键属性
|
||
|
||
- 未读数：会话级 / 全局级两个统计；会话内可点「未读消息」气泡跳转最早未读
|
||
- 已读列表：群消息支持查看「谁已读 / 谁未读」，调用 readlist 接口
|
||
- 标记未读（mark_unread）：用户主动把已读会话再次置成未读，便于稍后处理
|
||
|
||
## 与其他概念的关系
|
||
|
||
- 与免打扰：开免打扰后不弹通知但仍累计未读；@仍强制提醒
|
||
- 与标记未读：mark_unread=1 时打开会话会自动清除标记
|
||
- 与隐藏：隐藏的会话依然计入未读总数
|
||
|
||
## 不支持
|
||
|
||
- 不支持「单条消息按用户级别已读时间戳」的展示，仅二元 has-read / not-read
|
||
- 不支持「24h 内未读自动清除」
|
||
- 不支持已读后再撤销已读
|