feat: import Chinese-localized Buzz source snapshot

Signed-off-by: cls_宁波本机 <908705107@qq.com>

mobile/lib/features/channels/mentions/mention_candidates.dart

@@ -0,0 +1,146 @@
+import '../../../shared/mentions/agent_identity_provider.dart';
+import '../../profile/user_profile.dart';
+import '../channel_management_provider.dart';
+import 'mention_ranking.dart';
+
+/// Whether a non-member relay agent should be mentionable by the current
+/// user. Mirrors desktop's `relayAgentIsSharedWithUser`:
+/// - allowlist mode: user must be on the allowlist
+/// - anyone mode: agent must share at least one channel with the user
+bool agentIsSharedWithUser(
+  AgentDirectoryEntry agent,
+  Set<String> sharedChannelIds,
+  String? currentPubkey,
+) {
+  if (agent.respondTo == 'allowlist' && currentPubkey != null) {
+    return agent.respondToAllowlist.contains(currentPubkey.toLowerCase());
+  }
+  return agent.respondTo == 'anyone' &&
+      agent.channelIds.any(sharedChannelIds.contains);
+}
+
+/// Format the "managed by …" label. Mirrors desktop's `formatOwnerLabel`.
+String? formatOwnerLabel(
+  String? ownerPubkey,
+  String? currentPubkey,
+  Map<String, UserProfile> userCache, {
+  String currentUserLabel = 'you',
+}) {
+  if (ownerPubkey == null) return null;
+  final owner = ownerPubkey.toLowerCase();
+  if (currentPubkey != null && owner == currentPubkey.toLowerCase()) {
+    return currentUserLabel;
+  }
+  final profile = userCache[owner];
+  final name = profile?.displayName?.trim();
+  if (name != null && name.isNotEmpty) return name;
+  final handle = profile?.nip05Handle?.trim();
+  if (handle != null && handle.isNotEmpty) return handle;
+  return '${ownerPubkey.substring(0, 8)}…';
+}
+
+/// Assemble the full mention candidate list: channel members first-class,
+/// then eligible non-member relay agents, then global user-search results.
+/// Mirrors desktop's `useMentions` candidate assembly (minus personas and
+/// managed agents, which live in the desktop app's local store; the
+/// owner-check on search results below covers their mention-eligibility
+/// semantics).
+List<MentionCandidate> buildMentionCandidates({
+  required List<ChannelMember> members,
+  required List<AgentDirectoryEntry> relayAgents,
+  required Set<String> sharedChannelIds,
+  required Map<String, UserProfile> userCache,
+  required Map<String, String> ownerByAgentPubkey,
+  List<UserProfile> searchResults = const [],
+  String? currentPubkey,
+}) {
+  final candidates = <MentionCandidate>[];
+  final seen = <String>{};
+
+  for (final member in members) {
+    final pk = member.pubkey.toLowerCase();
+    if (!seen.add(pk)) continue;
+    final profile = userCache[pk];
+    final ownerPubkey = ownerByAgentPubkey[pk] ?? profile?.ownerPubkey;
+    final isAgent = member.isBot || ownerPubkey != null;
+    candidates.add(
+      MentionCandidate(
+        pubkey: pk,
+        displayName: profile?.displayName?.trim().isNotEmpty == true
+            ? profile!.displayName!.trim()
+            : member.displayName,
+        secondaryLabel: profile?.nip05Handle,
+        avatarUrl: profile?.avatarUrl,
+        isAgent: isAgent,
+        isMember: true,
+        role: member.role,
+        ownerPubkey: ownerPubkey,
+      ),
+    );
+  }
+
+  final directoryPubkeys = <String>{};
+  final sharedAgentPubkeys = <String>{};
+  for (final agent in relayAgents) {
+    directoryPubkeys.add(agent.pubkey);
+    if (agentIsSharedWithUser(agent, sharedChannelIds, currentPubkey)) {
+      sharedAgentPubkeys.add(agent.pubkey);
+    }
+  }
+
+  for (final agent in relayAgents) {
+    final pk = agent.pubkey;
+    if (seen.contains(pk)) continue;
+    if (!sharedAgentPubkeys.contains(pk)) continue;
+    seen.add(pk);
+    final profile = userCache[pk];
+    candidates.add(
+      MentionCandidate(
+        pubkey: pk,
+        displayName: profile?.displayName?.trim().isNotEmpty == true
+            ? profile!.displayName!.trim()
+            : agent.displayName,
+        secondaryLabel: profile?.nip05Handle,
+        avatarUrl: profile?.avatarUrl,
+        isAgent: true,
+        isMember: false,
+        ownerPubkey: ownerByAgentPubkey[pk] ?? profile?.ownerPubkey,
+      ),
+    );
+  }
+
+  final currentLower = currentPubkey?.toLowerCase();
+  for (final profile in searchResults) {
+    final pk = profile.pubkey.toLowerCase();
+    if (seen.contains(pk)) continue;
+    final ownerPubkey = ownerByAgentPubkey[pk] ?? profile.ownerPubkey;
+    final isAgent = ownerPubkey != null || directoryPubkeys.contains(pk);
+    if (isAgent) {
+      // Mirrors desktop's `shouldHideAgentFromMentions` for non-member
+      // agents: show only when invocable. Invocable = owned by the current
+      // user (desktop's managed-agent semantics, derived here from the
+      // verified NIP-OA owner) or shared via the relay agent directory.
+      final ownedByCurrentUser =
+          currentLower != null && ownerPubkey?.toLowerCase() == currentLower;
+      if (!ownedByCurrentUser && !sharedAgentPubkeys.contains(pk)) {
+        continue;
+      }
+    }
+    seen.add(pk);
+    candidates.add(
+      MentionCandidate(
+        pubkey: pk,
+        displayName: profile.displayName?.trim().isNotEmpty == true
+            ? profile.displayName!.trim()
+            : null,
+        secondaryLabel: profile.nip05Handle,
+        avatarUrl: profile.avatarUrl,
+        isAgent: isAgent,
+        isMember: false,
+        ownerPubkey: ownerPubkey,
+      ),
+    );
+  }
+
+  return candidates;
+}