1.没置顶的消息，到最上面去了 2.无法转发图片 3.用户ID 是一串字母+数字 4.视频无法显示 5.消息无法置顶 6.可以引用文字，无法艾特用户 7.图片点开只能显示一半 8.转发不能多选，只能一个个转发 9.转发有转发提示，需取消

dist-local/api/message_action.php

@@ -78,7 +78,7 @@ function fetchActionMessageRow(string $messageUid): array
     return is_array($row) ? $row : [];
 }
 
-function ensureMessageEditsTable(): void
+function ensureMessageEditsTable(): void
 {
     imDb()->exec(
         'create table if not exists `t_web_message_edits` ('
@@ -93,7 +93,55 @@ function ensureMessageEditsTable(): void
         . 'key `idx_edited_at_ms` (`edited_at_ms`)'
         . ') engine=InnoDB default charset=utf8mb4'
     );
-}
+}
+
+function ensurePinnedMessagesTable(): void
+{
+    $db = imAppDb();
+    $db->exec(
+        'create table if not exists `t_web_pinned_messages` ('
+        . '`user_id` varchar(64) not null,'
+        . '`conversation_type` varchar(16) not null,'
+        . '`target_id` varchar(128) not null,'
+        . '`message_uid` varchar(32) not null,'
+        . '`message_json` text null,'
+        . '`updated_at_ms` bigint not null,'
+        . 'primary key (`user_id`, `conversation_type`, `target_id`)'
+        . ') engine=InnoDB default charset=utf8mb4'
+    );
+    try {
+        $db->exec('alter table `t_web_pinned_messages` add column `message_json` text null after `message_uid`');
+    } catch (Throwable) {
+        // The column already exists.
+    }
+}
+
+function savePinnedMessage(string $userId, string $conversationType, string $targetId, string $messageUid, array $message): void
+{
+    ensurePinnedMessagesTable();
+    $statement = imAppDb()->prepare(
+        'insert into `t_web_pinned_messages` (`user_id`, `conversation_type`, `target_id`, `message_uid`, `message_json`, `updated_at_ms`)'
+        . ' values (?, ?, ?, ?, ?, ?) on duplicate key update `message_uid` = values(`message_uid`),'
+        . ' `message_json` = values(`message_json`), `updated_at_ms` = values(`updated_at_ms`)'
+    );
+    $statement->execute([
+        $userId,
+        $conversationType,
+        $targetId,
+        $messageUid,
+        json_encode($message, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),
+        nowTimestampMs(),
+    ]);
+}
+
+function removePinnedMessage(string $userId, string $conversationType, string $targetId): void
+{
+    ensurePinnedMessagesTable();
+    $statement = imAppDb()->prepare(
+        'delete from `t_web_pinned_messages` where `user_id` = ? and `conversation_type` = ? and `target_id` = ?'
+    );
+    $statement->execute([$userId, $conversationType, $targetId]);
+}
 
 function editTextMessage(string $operatorId, string $messageUid, string $text): array
 {
@@ -222,7 +270,22 @@ if ($action === '' || $messageUid <= 0) {
     respond(400, '缺少操作类型或消息ID');
 }
 
-try {
+try {
+    if ($action === 'pin' || $action === 'unpin') {
+        if ($userId === '') respond(400, '缺少操作者ID');
+        $targetId = trim((string)($payload['target'] ?? ''));
+        $conversationType = trim((string)($payload['conversationType'] ?? 'single'));
+        if ($targetId === '') respond(400, '缺少会话ID');
+        $userId = resolveActionUserId($userId);
+        if ($action === 'pin') {
+            $message = is_array($payload['message'] ?? null) ? $payload['message'] : [];
+            savePinnedMessage($userId, $conversationType, $targetId, $messageUidText, $message);
+        } else {
+            removePinnedMessage($userId, $conversationType, $targetId);
+        }
+        respond(0, 'success', ['messageUid' => $messageUidText, 'action' => $action]);
+    }
+
     if ($action === 'recall') {
         if ($userId === '') {
             respond(400, '缺少操作者ID');