test: 暂存代码

2026-08-18 12:07:01 +08:00 · 2026-08-06 20:29:25 +08:00
parent 307d247660
commit ad4b3a8074
43 changed files with 9978 additions and 512 deletions
@@ -0,0 +1,86 @@
+import type { Contact } from '../../shared/types'
+import {
+  emptyContactResolution,
+  normalizeContactName,
+  type ContactResolutionCandidate,
+  type ContactResolutionMatch,
+  type ContactResolutionResult
+} from '../../shared/contact-resolution'
+
+export type ContactResolutionScope = 'any' | 'person' | 'group'
+
+const displayName = (contact: Contact): string =>
+  contact.m_nsNickName || contact.remark || contact.wechatNickname || contact.m_nsUsrName
+
+const aliases = (contact: Contact): Array<{ value: string; primary: boolean }> =>
+  [
+    { value: contact.m_nsNickName, primary: true },
+    { value: contact.remark || '', primary: false },
+    { value: contact.wechatNickname || '', primary: false },
+    { value: contact.m_nsUsrName, primary: false }
+  ].filter((item) => Boolean(normalizeContactName(item.value)))
+
+/**
+ * The one main-process authority that converts a user/Agent supplied name to
+ * an existing conversation. It only auto-confirms an exact canonical alias.
+ * Fuzzy discovery intentionally returns candidates rather than a guessed ID.
+ */
+export function resolveContact(
+  query: string,
+  contacts: Contact[],
+  scope: ContactResolutionScope = 'any'
+): ContactResolutionResult {
+  const normalizedQuery = normalizeContactName(query)
+  if (!normalizedQuery) return emptyContactResolution()
+  const matches = new Map<string, { contact: Contact; matchedBy: ContactResolutionMatch }>()
+
+  for (const contact of contacts) {
+    if (!contact.md5) continue
+    if (scope === 'person' && contact.type !== 'user') continue
+    if (scope === 'group' && contact.type !== 'group') continue
+    for (const alias of aliases(contact)) {
+      if (normalizeContactName(alias.value) !== normalizedQuery) continue
+      const rawExact =
+        alias.value.trim().normalize('NFKC').toLocaleLowerCase() ===
+        query.trim().normalize('NFKC').toLocaleLowerCase()
+      const matchedBy: ContactResolutionMatch = rawExact
+        ? 'exact'
+        : alias.primary
+          ? 'normalized'
+          : 'alias'
+      const current = matches.get(contact.md5)
+      if (!current || (current.matchedBy === 'alias' && matchedBy !== 'alias')) {
+        matches.set(contact.md5, { contact, matchedBy })
+      }
+    }
+  }
+
+  const candidates: ContactResolutionCandidate[] = Array.from(matches.values())
+    .map(({ contact, matchedBy }) => ({
+      conversationId: contact.md5,
+      displayName: displayName(contact),
+      matchedBy,
+      confidence: 1
+    }))
+    .sort((left, right) => left.displayName.localeCompare(right.displayName, 'zh-CN'))
+  if (candidates.length !== 1) {
+    return {
+      ...emptyContactResolution(),
+      candidates,
+      ambiguous: candidates.length > 1
+    }
+  }
+  const candidate = candidates[0]
+  const contact = matches.get(candidate.conversationId)!.contact
+  return {
+    matched: true,
+    personId: contact.m_nsUsrName,
+    conversationId: contact.md5,
+    canonicalName: displayName(contact),
+    displayName: candidate.displayName,
+    matchedBy: candidate.matchedBy,
+    confidence: candidate.confidence,
+    candidates,
+    ambiguous: false
+  }
+}