chattercatcher 0.2.5 → 0.2.7

package/dist/index.js

@@ -916,6 +916,7 @@ function migrateDatabase(database) {
       chat_id TEXT NOT NULL REFERENCES chats(id) ON DELETE CASCADE,
       sender_id TEXT NOT NULL,
       sender_name TEXT NOT NULL,
+      person_id TEXT REFERENCES persons(id) ON DELETE SET NULL,
       message_type TEXT NOT NULL,
       text TEXT NOT NULL,
       raw_payload_json TEXT NOT NULL,
@@ -953,6 +954,80 @@ function migrateDatabase(database) {
       UNIQUE(chat_id, started_at, ended_at)
     );
 
+    CREATE TABLE IF NOT EXISTS persons (
+      id TEXT PRIMARY KEY,
+      primary_name TEXT NOT NULL,
+      notes TEXT,
+      created_at TEXT NOT NULL,
+      updated_at TEXT NOT NULL
+    );
+
+    CREATE TABLE IF NOT EXISTS person_identities (
+      id TEXT PRIMARY KEY,
+      person_id TEXT NOT NULL REFERENCES persons(id) ON DELETE CASCADE,
+      platform TEXT NOT NULL,
+      platform_chat_id TEXT NOT NULL,
+      external_user_id TEXT NOT NULL,
+      external_open_id TEXT,
+      external_union_id TEXT,
+      external_user_id_raw TEXT,
+      display_name TEXT NOT NULL,
+      alias TEXT,
+      source TEXT NOT NULL CHECK(source IN ('message','feishu_member','manual','inferred')),
+      first_seen_at TEXT NOT NULL,
+      last_seen_at TEXT NOT NULL,
+      UNIQUE(platform, platform_chat_id, external_user_id)
+    );
+
+    CREATE INDEX IF NOT EXISTS person_identities_person_idx ON person_identities(person_id);
+    CREATE INDEX IF NOT EXISTS person_identities_lookup_idx ON person_identities(platform, platform_chat_id, external_user_id);
+    CREATE INDEX IF NOT EXISTS person_identities_name_idx ON person_identities(display_name, alias);
+
+    CREATE TABLE IF NOT EXISTS person_profile_entries (
+      id TEXT PRIMARY KEY,
+      person_id TEXT NOT NULL REFERENCES persons(id) ON DELETE CASCADE,
+      category TEXT NOT NULL,
+      content TEXT NOT NULL,
+      entry_type TEXT NOT NULL CHECK(entry_type IN ('fact','inferred')),
+      confidence REAL NOT NULL,
+      status TEXT NOT NULL CHECK(status IN ('active','superseded','deleted')),
+      source TEXT NOT NULL CHECK(source IN ('dream','explicit_user_request','manual')),
+      created_at TEXT NOT NULL,
+      updated_at TEXT NOT NULL,
+      last_observed_at TEXT NOT NULL
+    );
+
+    CREATE INDEX IF NOT EXISTS person_profile_entries_person_status_idx ON person_profile_entries(person_id, status, updated_at);
+
+    CREATE TABLE IF NOT EXISTS person_profile_evidence (
+      entry_id TEXT NOT NULL REFERENCES person_profile_entries(id) ON DELETE CASCADE,
+      message_id TEXT NOT NULL REFERENCES messages(id) ON DELETE CASCADE,
+      quote TEXT NOT NULL,
+      reason TEXT NOT NULL,
+      PRIMARY KEY (entry_id, message_id, quote)
+    );
+
+    CREATE TABLE IF NOT EXISTS profile_dream_state (
+      platform TEXT NOT NULL,
+      platform_chat_id TEXT NOT NULL,
+      last_message_id TEXT,
+      last_message_sent_at TEXT,
+      updated_at TEXT NOT NULL,
+      PRIMARY KEY (platform, platform_chat_id)
+    );
+
+    CREATE TABLE IF NOT EXISTS profile_dream_runs (
+      id TEXT PRIMARY KEY,
+      platform TEXT NOT NULL,
+      platform_chat_id TEXT NOT NULL,
+      status TEXT NOT NULL CHECK(status IN ('succeeded','failed','skipped')),
+      processed_message_count INTEGER NOT NULL,
+      generated_entry_count INTEGER NOT NULL,
+      error TEXT,
+      started_at TEXT NOT NULL,
+      finished_at TEXT NOT NULL
+    );
+
     CREATE TABLE IF NOT EXISTS memory_episode_messages (
       episode_id TEXT NOT NULL REFERENCES memory_episodes(id) ON DELETE CASCADE,
       message_id TEXT NOT NULL REFERENCES messages(id) ON DELETE CASCADE,
@@ -995,6 +1070,7 @@ function migrateDatabase(database) {
       answer TEXT NOT NULL,
       citations_json TEXT NOT NULL,
       retrieval_debug_json TEXT NOT NULL,
+      trace_json TEXT NOT NULL DEFAULT '{}',
       status TEXT NOT NULL CHECK(status IN ('answered','failed')),
       error TEXT,
       created_at TEXT NOT NULL
@@ -1079,6 +1155,11 @@ function migrateDatabase(database) {
     CREATE INDEX IF NOT EXISTS feishu_chat_members_chat_name_idx
     ON feishu_chat_members(chat_id, user_name);
   `);
+  const messageColumns = database.prepare("PRAGMA table_info(messages)").all();
+  if (!messageColumns.some((column) => column.name === "person_id")) {
+    database.prepare("ALTER TABLE messages ADD COLUMN person_id TEXT REFERENCES persons(id) ON DELETE SET NULL").run();
+  }
+  database.prepare("CREATE INDEX IF NOT EXISTS messages_person_idx ON messages(person_id, sent_at)").run();
   const cronJobColumns = database.prepare("PRAGMA table_info(cron_jobs)").all();
   const ensureCronJobColumn = (name, definition) => {
     if (!cronJobColumns.some((column) => column.name === name)) {
@@ -1089,6 +1170,10 @@ function migrateDatabase(database) {
   ensureCronJobColumn("mention_target_name", "mention_target_name TEXT");
   ensureCronJobColumn("mention_open_id", "mention_open_id TEXT");
   ensureCronJobColumn("mention_user_id", "mention_user_id TEXT");
+  const qaLogColumns = database.prepare("PRAGMA table_info(qa_logs)").all();
+  if (!qaLogColumns.some((column) => column.name === "trace_json")) {
+    database.prepare("ALTER TABLE qa_logs ADD COLUMN trace_json TEXT NOT NULL DEFAULT '{}'").run();
+  }
 }
 
 // src/doctor/checks.ts
@@ -1784,6 +1869,10 @@ function buildScopeWhere(scope) {
     clauses.push("c.platform_chat_id = ?");
     params.push(scope.platformChatId);
   }
+  if (scope?.personId) {
+    clauses.push("m.person_id = ?");
+    params.push(scope.personId);
+  }
   return {
     where: clauses.length > 0 ? `AND ${clauses.join(" AND ")}` : "",
     params
@@ -1828,14 +1917,15 @@ var MessageRepository = class {
         `
           INSERT INTO messages (
             id, platform, platform_message_id, chat_id, sender_id, sender_name,
-            message_type, text, raw_payload_json, sent_at, received_at, created_at
+            person_id, message_type, text, raw_payload_json, sent_at, received_at, created_at
           )
           VALUES (
             @id, @platform, @platformMessageId, @chatId, @senderId, @senderName,
-            @messageType, @text, @rawPayloadJson, @sentAt, @receivedAt, @createdAt
+            @personId, @messageType, @text, @rawPayloadJson, @sentAt, @receivedAt, @createdAt
           )
           ON CONFLICT(platform, platform_message_id)
           DO UPDATE SET
+            person_id = COALESCE(excluded.person_id, messages.person_id),
             message_type = excluded.message_type,
             text = excluded.text,
             raw_payload_json = excluded.raw_payload_json,
@@ -1848,6 +1938,7 @@ var MessageRepository = class {
         chatId,
         senderId: input.senderId,
         senderName: input.senderName,
+        personId: input.personId ?? null,
         messageType: input.messageType,
         text: input.text,
         rawPayloadJson,
@@ -1890,6 +1981,7 @@ var MessageRepository = class {
           m.chat_id AS chatId,
           m.sender_id AS senderId,
           m.sender_name AS senderName,
+          m.person_id AS personId,
           m.sent_at AS sentAt,
           c.platform_chat_id AS platformChatId,
           c.name AS chatName
@@ -1912,6 +2004,7 @@ ${input.summary.trim()}` : `[\u56FE\u7247\u8F6C\u8FF0] ${input.summary.trim()}`;
       platformMessageId: derivedPlatformMessageId,
       senderId: source.senderId,
       senderName: source.senderName,
+      personId: source.personId ?? void 0,
       messageType: "image_summary",
       text: summaryText,
       sentAt: source.sentAt,
@@ -1938,7 +2031,9 @@ ${input.summary.trim()}` : `[\u56FE\u7247\u8F6C\u8FF0] ${input.summary.trim()}`;
           1.0 AS score,
           m.message_type AS messageType,
           c.name AS chatName,
+          m.sender_id AS senderId,
           m.sender_name AS senderName,
+          m.person_id AS personId,
           m.sent_at AS sentAt
         FROM message_chunks mc
         JOIN messages m ON m.id = mc.message_id
@@ -1959,7 +2054,9 @@ ${input.summary.trim()}` : `[\u56FE\u7247\u8F6C\u8FF0] ${input.summary.trim()}`;
           1.0 AS score,
           m.message_type AS messageType,
           c.name AS chatName,
+          m.sender_id AS senderId,
           m.sender_name AS senderName,
+          m.person_id AS personId,
           m.sent_at AS sentAt
         FROM message_chunks mc
         JOIN messages m ON m.id = mc.message_id
@@ -1983,7 +2080,9 @@ ${input.summary.trim()}` : `[\u56FE\u7247\u8F6C\u8FF0] ${input.summary.trim()}`;
           1.0 AS score,
           m.message_type AS messageType,
           c.name AS chatName,
+          m.sender_id AS senderId,
           m.sender_name AS senderName,
+          m.person_id AS personId,
           m.sent_at AS sentAt
         FROM message_chunks mc
         JOIN messages m ON m.id = mc.message_id
@@ -1999,7 +2098,7 @@ ${input.summary.trim()}` : `[\u56FE\u7247\u8F6C\u8FF0] ${input.summary.trim()}`;
     const excludedIds = options.excludeMessageIds ?? [];
     const excludedWhere = excludedIds.length > 0 ? `AND fts.message_id NOT IN (${excludedIds.map(() => "?").join(", ")})` : "";
     const scope = buildScopeWhere(options.scope);
-    const ftsResults = this.database.prepare(
+    const ftsRows = this.database.prepare(
       `
         SELECT
           fts.chunk_id AS chunkId,
@@ -2009,8 +2108,11 @@ ${input.summary.trim()}` : `[\u56FE\u7247\u8F6C\u8FF0] ${input.summary.trim()}`;
           bm25(message_chunks_fts) * -1 AS score,
           m.message_type AS messageType,
           c.name AS chatName,
+          m.sender_id AS senderId,
           m.sender_name AS senderName,
-          m.sent_at AS sentAt
+          m.person_id AS personId,
+          m.sent_at AS sentAt,
+          mc.chunk_index AS chunkIndex
         FROM message_chunks_fts fts
         JOIN message_chunks mc ON mc.id = fts.chunk_id
         JOIN messages m ON m.id = fts.message_id
@@ -2018,10 +2120,23 @@ ${input.summary.trim()}` : `[\u56FE\u7247\u8F6C\u8FF0] ${input.summary.trim()}`;
         WHERE message_chunks_fts MATCH ?
         ${excludedWhere}
         ${scope.where}
-        ORDER BY bm25(message_chunks_fts)
+        ORDER BY bm25(message_chunks_fts), m.sent_at DESC, mc.chunk_index ASC
         LIMIT ?
       `
-    ).all(ftsQuery, ...excludedIds, ...scope.params, limit);
+    ).all(ftsQuery, ...excludedIds, ...scope.params, Math.max(limit * 8, limit));
+    const ftsResults = [];
+    const seenMessageIds = /* @__PURE__ */ new Set();
+    for (const row of ftsRows) {
+      if (seenMessageIds.has(row.messageId)) {
+        continue;
+      }
+      seenMessageIds.add(row.messageId);
+      const { chunkIndex: _chunkIndex, ...result } = row;
+      ftsResults.push(result);
+      if (ftsResults.length >= limit) {
+        break;
+      }
+    }
     if (ftsResults.length > 0) {
       return ftsResults;
     }
@@ -2035,22 +2150,30 @@ ${input.summary.trim()}` : `[\u56FE\u7247\u8F6C\u8FF0] ${input.summary.trim()}`;
     return this.database.prepare(
       `
         SELECT
-          mc.id AS chunkId,
-          m.id AS messageId,
-          m.platform AS platform,
-          mc.text AS text,
-          0.1 AS score,
-          m.message_type AS messageType,
-          c.name AS chatName,
-          m.sender_name AS senderName,
-          m.sent_at AS sentAt
-        FROM message_chunks mc
-        JOIN messages m ON m.id = mc.message_id
-        JOIN chats c ON c.id = m.chat_id
-        WHERE (${where})
-        ${likeExcludedWhere}
-        ${scope.where}
-        ORDER BY m.sent_at DESC
+          *
+        FROM (
+          SELECT
+            mc.id AS chunkId,
+            m.id AS messageId,
+            m.platform AS platform,
+            mc.text AS text,
+            0.1 AS score,
+            m.message_type AS messageType,
+            c.name AS chatName,
+            m.sender_id AS senderId,
+            m.sender_name AS senderName,
+            m.person_id AS personId,
+            m.sent_at AS sentAt,
+            ROW_NUMBER() OVER (PARTITION BY m.id ORDER BY mc.chunk_index ASC) AS rowNumber
+          FROM message_chunks mc
+          JOIN messages m ON m.id = mc.message_id
+          JOIN chats c ON c.id = m.chat_id
+          WHERE (${where})
+          ${likeExcludedWhere}
+          ${scope.where}
+        ) ranked
+        WHERE rowNumber = 1
+        ORDER BY sentAt DESC
         LIMIT ?
       `
     ).all(...params, ...excludedIds, ...scope.params, limit);
@@ -2465,19 +2588,20 @@ var HybridRetriever = class {
 
 // src/rag/message-retriever.ts
 function toEvidenceSource(result) {
-  if (result.messageType === "file") {
-    return {
-      type: "file",
-      label: result.senderName,
-      timestamp: result.sentAt
-    };
-  }
-  return {
-    type: "message",
-    label: result.chatName,
-    sender: result.senderName,
+  const source = {
+    type: result.messageType === "file" ? "file" : "message",
+    label: result.messageType === "file" ? result.senderName : result.chatName,
     timestamp: result.sentAt
   };
+  if (result.messageType !== "file") {
+    source.sender = result.senderName;
+  }
+  source.senderId = result.senderId;
+  source.profileAvailable = Boolean(result.personId);
+  if (result.personId) {
+    source.personId = result.personId;
+  }
+  return source;
 }
 var MessageFtsRetriever = class {
   constructor(messages, options = {}) {
@@ -2606,6 +2730,9 @@ function toEvidenceSource2(row) {
     type: "message",
     label: row.chatName,
     sender: row.senderName,
+    senderId: row.senderId,
+    personId: row.personId,
+    profileAvailable: Boolean(row.personId),
     timestamp: row.sentAt
   };
 }
@@ -2620,6 +2747,10 @@ function buildScopeWhere3(scope) {
     clauses.push("c.platform_chat_id = ?");
     params.push(scope.platformChatId);
   }
+  if (scope?.personId) {
+    clauses.push("m.person_id = ?");
+    params.push(scope.personId);
+  }
   return {
     where: clauses.length > 0 ? `AND ${clauses.join(" AND ")}` : "",
     params
@@ -2670,7 +2801,9 @@ var SqliteVectorStore = class {
           mc.id AS chunkId,
           mc.text AS text,
           c.name AS chatName,
+          m.sender_id AS senderId,
           m.sender_name AS senderName,
+          m.person_id AS personId,
           m.sent_at AS sentAt,
           e.embedding_json AS embeddingJson
         FROM message_chunk_embeddings e
@@ -2751,8 +2884,12 @@ async function createAgenticRagSearchTools(input) {
     new SqliteVectorStore(input.database, { model: input.config.embedding.model })
   ) : void 0;
   const hybrid = new HybridRetriever(semantic ? [episodes, messages, semantic] : [episodes, messages]);
+  const tools = createRagSearchTools({ hybrid, messages, episodes, semantic, scope: input.scope });
+  if (input.profileTools && input.profileTools.length > 0) {
+    tools.push(...input.profileTools);
+  }
   return {
-    tools: createRagSearchTools({ hybrid, messages, episodes, semantic, scope: input.scope }),
+    tools,
     close: () => {
     }
   };
@@ -3360,6 +3497,588 @@ function parseExactNumber2(field, min, max) {
   return value;
 }
 
+// src/profiles/rag-tools.ts
+var getProfileInputSchema = {
+  type: "object",
+  properties: {
+    personId: { type: "string", description: "Stable person identifier from retrieved evidence." },
+    senderId: { type: "string", description: "Message sender id when personId is unavailable." },
+    platformChatId: { type: "string", description: "Chat id paired with senderId for profile lookup." },
+    includeEvidence: { type: "boolean", description: "Whether to include evidence snippets in the profile text." },
+    includeInferred: { type: "boolean", description: "Whether to include inferred profile entries." }
+  },
+  additionalProperties: false
+};
+var searchMessagesInputSchema = {
+  type: "object",
+  properties: {
+    personId: { type: "string", description: "The stable person identifier whose messages to search." },
+    query: { type: "string", description: "Search query written by the model." },
+    limit: { type: "number", description: "Maximum number of evidence blocks to return." }
+  },
+  required: ["personId", "query"],
+  additionalProperties: false
+};
+function readString2(value) {
+  return typeof value === "string" && value.trim() ? value.trim() : void 0;
+}
+function resolvePersonId(profiles, input) {
+  const raw = typeof input === "object" && input !== null ? input : {};
+  const personId = readString2(raw.personId);
+  if (personId) return personId;
+  const senderId = readString2(raw.senderId);
+  const platformChatId = readString2(raw.platformChatId);
+  if (senderId && platformChatId) {
+    const resolved = profiles.resolvePersonIdForSender({ senderId, platformChatId });
+    if (resolved) return resolved;
+  }
+  throw new Error("personId \u6216 senderId + platformChatId \u5FC5\u987B\u63D0\u4F9B\u3002");
+}
+function parseBoolean(input, key, defaultValue) {
+  const value = typeof input === "object" && input !== null ? input[key] : void 0;
+  return typeof value === "boolean" ? value : defaultValue;
+}
+function parseQuery(input) {
+  const rawQuery = typeof input === "object" && input !== null && "query" in input ? input.query : void 0;
+  if (typeof rawQuery !== "string") {
+    throw new Error("\u641C\u7D22 query \u5FC5\u987B\u662F\u975E\u7A7A\u5B57\u7B26\u4E32\u3002");
+  }
+  const query = rawQuery.trim();
+  if (!query) {
+    throw new Error("\u641C\u7D22 query \u5FC5\u987B\u662F\u975E\u7A7A\u5B57\u7B26\u4E32\u3002");
+  }
+  return query;
+}
+function parseLimit(input) {
+  const rawLimit = typeof input === "object" && input !== null && "limit" in input ? input.limit : void 0;
+  const numericLimit = typeof rawLimit === "number" && Number.isFinite(rawLimit) ? rawLimit : 5;
+  return Math.min(12, Math.max(1, Math.floor(numericLimit)));
+}
+function createGetPersonProfileTool(profiles) {
+  return {
+    name: "get_person_profile",
+    description: "Retrieve an evidence-backed profile for a person. Use this when the question depends on who someone is, their role, preferences, personality, relationships, or recent state.",
+    inputSchema: getProfileInputSchema,
+    execute: async (input) => {
+      const personId = resolvePersonId(profiles, input);
+      const includeEvidence = parseBoolean(input, "includeEvidence", false);
+      const includeInferred = parseBoolean(input, "includeInferred", true);
+      const profile = profiles.getPersonProfile(personId, { includeEvidence, includeInferred });
+      if (!profile) {
+        return [];
+      }
+      const aliases = profile.identities.map((identity) => identity.displayName).filter(Boolean).join("\u3001");
+      const entries = profile.entries.map((entry) => {
+        const evidence = includeEvidence && entry.evidence?.length ? `
+  \u8BC1\u636E\uFF1A${entry.evidence.map((item) => `${item.quote}\uFF08${item.reason}\uFF09`).join("\uFF1B")}` : "";
+        return `- [${entry.entryType}] ${entry.category}\uFF1A${entry.content}\uFF08\u7F6E\u4FE1\u5EA6 ${entry.confidence}\uFF0C\u6765\u6E90 ${entry.source}\uFF09${evidence}`;
+      });
+      return [{
+        id: `person_profile:${profile.person.id}`,
+        text: [`\u4EBA\u7269\uFF1A${profile.person.primaryName}`, aliases ? `\u8EAB\u4EFD/\u6635\u79F0\uFF1A${aliases}` : void 0, ...entries].filter(Boolean).join("\n"),
+        score: 1,
+        source: {
+          type: "person_profile",
+          label: profile.person.primaryName,
+          personId: profile.person.id,
+          profileAvailable: true
+        }
+      }];
+    }
+  };
+}
+function createSearchPersonMessagesTool(profiles) {
+  return {
+    name: "search_person_messages",
+    description: "Search chat messages sent by a specific person only. Use this when the question is explicitly about what a particular person said, or when you need to find messages from a specific person.",
+    inputSchema: searchMessagesInputSchema,
+    execute: async (input) => {
+      const personId = resolvePersonId(profiles, input);
+      const query = parseQuery(input);
+      const limit = parseLimit(input);
+      const results = profiles.searchPersonMessages(personId, query, limit);
+      return results.map((result) => ({
+        id: result.chunkId,
+        text: result.text,
+        score: result.score,
+        source: {
+          type: result.messageType === "file" ? "file" : "message",
+          label: result.chatName,
+          sender: result.senderName,
+          senderId: result.senderId,
+          timestamp: result.sentAt,
+          personId: result.personId ?? void 0,
+          profileAvailable: Boolean(result.personId)
+        }
+      }));
+    }
+  };
+}
+function createPersonProfileTools({ profiles }) {
+  return [createGetPersonProfileTool(profiles), createSearchPersonMessagesTool(profiles)];
+}
+
+// src/profiles/repository.ts
+import crypto5 from "crypto";
+function nowIso4() {
+  return (/* @__PURE__ */ new Date()).toISOString();
+}
+function createId(prefix, parts) {
+  return `${prefix}_${crypto5.createHash("sha256").update(parts.join("")).digest("hex").slice(0, 24)}`;
+}
+function mapPerson(row) {
+  return {
+    id: row.id,
+    primaryName: row.primaryName,
+    notes: row.notes ?? void 0,
+    createdAt: row.createdAt,
+    updatedAt: row.updatedAt
+  };
+}
+var ProfileRepository = class {
+  constructor(database) {
+    this.database = database;
+  }
+  database;
+  resolvePersonForSender(input) {
+    const observedAt = input.observedAt ?? nowIso4();
+    const personId = createId("person", [input.platform, input.platformChatId, input.senderId]);
+    const identityId = createId("identity", [input.platform, input.platformChatId, input.senderId]);
+    const findPerson = this.database.prepare(
+      `
+        SELECT id, primary_name AS primaryName, notes, created_at AS createdAt, updated_at AS updatedAt
+        FROM persons
+        WHERE id = ?
+      `
+    );
+    const transaction = this.database.transaction(() => {
+      this.database.prepare(
+        `
+          INSERT INTO persons (id, primary_name, notes, created_at, updated_at)
+          VALUES (?, ?, NULL, ?, ?)
+          ON CONFLICT(id) DO NOTHING
+        `
+      ).run(personId, input.senderName, observedAt, observedAt);
+      this.database.prepare(
+        `
+          INSERT INTO person_identities (
+            id, person_id, platform, platform_chat_id, external_user_id, external_open_id,
+            external_union_id, external_user_id_raw, display_name, alias, source, first_seen_at, last_seen_at
+          ) VALUES (?, ?, ?, ?, ?, NULL, NULL, ?, ?, NULL, ?, ?, ?)
+          ON CONFLICT(platform, platform_chat_id, external_user_id)
+          DO UPDATE SET
+            display_name = excluded.display_name,
+            source = excluded.source,
+            last_seen_at = excluded.last_seen_at
+        `
+      ).run(identityId, personId, input.platform, input.platformChatId, input.senderId, input.senderId, input.senderName, input.source, observedAt, observedAt);
+      this.database.prepare(
+        `
+          UPDATE persons
+          SET primary_name = ?, updated_at = ?
+          WHERE id = ?
+        `
+      ).run(input.senderName, observedAt, personId);
+      return findPerson.get(personId);
+    });
+    return transaction();
+  }
+  listPersons() {
+    const rows = this.database.prepare(
+      `
+        SELECT id, primary_name AS primaryName, notes, created_at AS createdAt, updated_at AS updatedAt
+        FROM persons
+        ORDER BY updated_at DESC, created_at DESC
+      `
+    ).all();
+    return rows.map(mapPerson);
+  }
+  getPersonProfile(personId, options = {}) {
+    const personRow = this.database.prepare(
+      `
+        SELECT id, primary_name AS primaryName, notes, created_at AS createdAt, updated_at AS updatedAt
+        FROM persons
+        WHERE id = ?
+      `
+    ).get(personId);
+    if (!personRow) {
+      return void 0;
+    }
+    const includeInferred = options.includeInferred ?? true;
+    const entryRows = this.database.prepare(
+      `
+        SELECT
+          id,
+          person_id AS personId,
+          category,
+          content,
+          entry_type AS entryType,
+          confidence,
+          status,
+          source,
+          created_at AS createdAt,
+          updated_at AS updatedAt,
+          last_observed_at AS lastObservedAt
+        FROM person_profile_entries
+        WHERE person_id = ?
+          AND status = 'active'
+          ${includeInferred ? "" : "AND entry_type = 'fact'"}
+        ORDER BY updated_at DESC, created_at DESC
+      `
+    ).all(personId);
+    const entries = options.includeEvidence ? entryRows.map((entry) => ({ ...entry, evidence: this.getEvidence(entry.id) })) : entryRows;
+    const identities = this.database.prepare(
+      `
+        SELECT
+          platform,
+          platform_chat_id AS platformChatId,
+          external_user_id AS externalUserId,
+          display_name AS displayName,
+          alias,
+          source,
+          first_seen_at AS firstSeenAt,
+          last_seen_at AS lastSeenAt
+        FROM person_identities
+        WHERE person_id = ?
+        ORDER BY last_seen_at DESC, first_seen_at DESC
+      `
+    ).all(personId);
+    return {
+      person: mapPerson(personRow),
+      identities,
+      entries
+    };
+  }
+  upsertProfileEntry(input) {
+    if (input.evidence.length === 0) {
+      throw new Error("Profile entry evidence is required.");
+    }
+    const timestamp = input.observedAt ?? nowIso4();
+    const entryId = createId("profile_entry", [input.personId, input.category, input.content]);
+    const transaction = this.database.transaction(() => {
+      this.database.prepare(
+        `
+          INSERT INTO person_profile_entries (
+            id, person_id, category, content, entry_type, confidence, status, source, created_at, updated_at, last_observed_at
+          ) VALUES (?, ?, ?, ?, ?, ?, 'active', ?, ?, ?, ?)
+          ON CONFLICT(id) DO UPDATE SET
+            confidence = MAX(person_profile_entries.confidence, excluded.confidence),
+            status = 'active',
+            source = excluded.source,
+            updated_at = excluded.updated_at,
+            last_observed_at = excluded.last_observed_at
+        `
+      ).run(entryId, input.personId, input.category, input.content, input.entryType, input.confidence, input.source, timestamp, timestamp, timestamp);
+      const insertEvidence = this.database.prepare(
+        `
+        INSERT INTO person_profile_evidence (entry_id, message_id, quote, reason)
+        VALUES (?, ?, ?, ?)
+        ON CONFLICT(entry_id, message_id, quote) DO UPDATE SET reason = excluded.reason
+      `
+      );
+      for (const evidence of input.evidence) {
+        insertEvidence.run(entryId, evidence.messageId, evidence.quote, evidence.reason);
+      }
+    });
+    transaction();
+    return entryId;
+  }
+  backfillMessagePersons({ limit }) {
+    const rows = this.database.prepare(
+      `
+        SELECT
+          m.id AS id,
+          m.platform AS platform,
+          c.platform_chat_id AS platformChatId,
+          m.sender_id AS senderId,
+          m.sender_name AS senderName,
+          m.sent_at AS sentAt
+        FROM messages m
+        JOIN chats c ON c.id = m.chat_id
+        WHERE m.person_id IS NULL
+        ORDER BY m.sent_at ASC
+        LIMIT ?
+      `
+    ).all(limit);
+    const update = this.database.prepare("UPDATE messages SET person_id = ? WHERE id = ?");
+    const transaction = this.database.transaction(() => {
+      for (const row of rows) {
+        const person = this.resolvePersonForSender({
+          platform: row.platform,
+          platformChatId: row.platformChatId,
+          senderId: row.senderId,
+          senderName: row.senderName,
+          source: "inferred",
+          observedAt: row.sentAt
+        });
+        update.run(person.id, row.id);
+      }
+    });
+    transaction();
+    return { updatedMessages: rows.length };
+  }
+  getDreamState(platform, platformChatId) {
+    return this.database.prepare(
+      `
+        SELECT
+          platform,
+          platform_chat_id AS platformChatId,
+          last_message_id AS lastMessageId,
+          last_message_sent_at AS lastMessageSentAt,
+          updated_at AS updatedAt
+        FROM profile_dream_state
+        WHERE platform = ? AND platform_chat_id = ?
+      `
+    ).get(platform, platformChatId);
+  }
+  updateDreamState(input) {
+    this.database.prepare(
+      `
+        INSERT INTO profile_dream_state (platform, platform_chat_id, last_message_id, last_message_sent_at, updated_at)
+        VALUES (?, ?, ?, ?, ?)
+        ON CONFLICT(platform, platform_chat_id)
+        DO UPDATE SET
+          last_message_id = excluded.last_message_id,
+          last_message_sent_at = excluded.last_message_sent_at,
+          updated_at = excluded.updated_at
+      `
+    ).run(input.platform, input.platformChatId, input.lastMessageId ?? null, input.lastMessageSentAt ?? null, input.updatedAt);
+  }
+  listMessagesForDream(input) {
+    const afterWhere = input.afterSentAt ? "AND m.sent_at > ?" : "";
+    const params = input.afterSentAt ? [input.platform, input.platformChatId, input.afterSentAt, input.limit] : [input.platform, input.platformChatId, input.limit];
+    return this.database.prepare(
+      `
+        SELECT
+          m.id AS messageId,
+          m.person_id AS personId,
+          m.sender_name AS senderName,
+          m.sent_at AS sentAt,
+          m.text AS text
+        FROM messages m
+        JOIN chats c ON c.id = m.chat_id
+        WHERE m.platform = ?
+          AND c.platform_chat_id = ?
+          AND m.person_id IS NOT NULL
+          ${afterWhere}
+        ORDER BY m.sent_at ASC, m.created_at ASC
+        LIMIT ?
+      `
+    ).all(...params);
+  }
+  listChatsWithPendingDreamMessages() {
+    return this.database.prepare(
+      `
+        SELECT DISTINCT m.platform AS platform, c.platform_chat_id AS platformChatId
+        FROM messages m
+        JOIN chats c ON c.id = m.chat_id
+        LEFT JOIN profile_dream_state pds ON pds.platform = m.platform AND pds.platform_chat_id = c.platform_chat_id
+        WHERE m.person_id IS NOT NULL
+          AND (pds.last_message_sent_at IS NULL OR m.sent_at > pds.last_message_sent_at)
+        ORDER BY c.platform_chat_id ASC
+      `
+    ).all();
+  }
+  recordDreamRun(input) {
+    const id = input.id ?? createId("profile_dream_run", [input.platform, input.platformChatId, input.status, input.startedAt, input.finishedAt, crypto5.randomUUID()]);
+    this.database.prepare(
+      `
+        INSERT INTO profile_dream_runs (
+          id, platform, platform_chat_id, status, processed_message_count, generated_entry_count, error, started_at, finished_at
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+      `
+    ).run(
+      id,
+      input.platform,
+      input.platformChatId,
+      input.status,
+      input.processedMessageCount,
+      input.generatedEntryCount,
+      input.error ?? null,
+      input.startedAt,
+      input.finishedAt
+    );
+    return id;
+  }
+  resolvePersonIdForSender(input) {
+    const platform = input.platform ?? "feishu";
+    const row = this.database.prepare(
+      `
+        SELECT person_id AS personId
+        FROM person_identities
+        WHERE platform = ? AND platform_chat_id = ? AND external_user_id = ?
+        LIMIT 1
+      `
+    ).get(platform, input.platformChatId, input.senderId);
+    return row?.personId;
+  }
+  searchPersonMessages(personId, query, limit, options = {}) {
+    const cleaned = query.trim().split(/\s+/).map((term) => term.replace(/"/g, '""')).filter(Boolean);
+    const wrapped = cleaned.map((term) => `"${term}"`).join(" ");
+    if (!wrapped) {
+      return [];
+    }
+    const excludedIds = options.excludeMessageIds ?? [];
+    const excludedWhere = excludedIds.length > 0 ? `AND fts.message_id NOT IN (${excludedIds.map(() => "?").join(", ")})` : "";
+    const rows = this.database.prepare(
+      `
+        SELECT
+          fts.chunk_id AS chunkId,
+          fts.message_id AS messageId,
+          m.platform AS platform,
+          mc.text AS text,
+          bm25(message_chunks_fts) * -1 AS score,
+          m.message_type AS messageType,
+          c.name AS chatName,
+          m.sender_id AS senderId,
+          m.sender_name AS senderName,
+          m.person_id AS personId,
+          m.sent_at AS sentAt,
+          mc.chunk_index AS chunkIndex
+        FROM message_chunks_fts fts
+        JOIN message_chunks mc ON mc.id = fts.chunk_id
+        JOIN messages m ON m.id = fts.message_id
+        JOIN chats c ON c.id = m.chat_id
+        WHERE message_chunks_fts MATCH ?
+        ${excludedWhere}
+        AND m.person_id = ?
+        ORDER BY bm25(message_chunks_fts), m.sent_at DESC, mc.chunk_index ASC
+        LIMIT ?
+      `
+    ).all(wrapped, ...excludedIds, personId, Math.max(limit * 8, limit));
+    const results = [];
+    const seenMessageIds = /* @__PURE__ */ new Set();
+    for (const row of rows) {
+      if (seenMessageIds.has(row.messageId)) {
+        continue;
+      }
+      seenMessageIds.add(row.messageId);
+      const { chunkIndex: _chunkIndex, ...result } = row;
+      results.push(result);
+      if (results.length >= limit) {
+        break;
+      }
+    }
+    if (results.length > 0) {
+      return results;
+    }
+    const terms = query.split(/[ 　]+/).map((term) => term.trim()).filter((term) => term.length > 0);
+    if (terms.length === 0) {
+      return [];
+    }
+    const where = terms.map(() => "mc.text LIKE ? ESCAPE '\\'").join(" OR ");
+    const params = terms.map((term) => `%${term.replace(/[%_]/g, "\\$&")}%`);
+    const likeExcludedWhere = excludedIds.length > 0 ? `AND m.id NOT IN (${excludedIds.map(() => "?").join(", ")})` : "";
+    return this.database.prepare(
+      `
+        SELECT
+          *
+        FROM (
+          SELECT
+            mc.id AS chunkId,
+            m.id AS messageId,
+            m.platform AS platform,
+            mc.text AS text,
+            0.1 AS score,
+            m.message_type AS messageType,
+            c.name AS chatName,
+            m.sender_id AS senderId,
+            m.sender_name AS senderName,
+            m.person_id AS personId,
+            m.sent_at AS sentAt,
+            ROW_NUMBER() OVER (PARTITION BY m.id ORDER BY mc.chunk_index ASC) AS rowNumber
+          FROM message_chunks mc
+          JOIN messages m ON m.id = mc.message_id
+          JOIN chats c ON c.id = m.chat_id
+          WHERE (${where})
+          ${likeExcludedWhere}
+          AND m.person_id = ?
+        ) ranked
+        WHERE rowNumber = 1
+        ORDER BY sentAt DESC
+        LIMIT ?
+      `
+    ).all(...params, ...excludedIds, personId, limit);
+  }
+  getProfileEntry(entryId) {
+    const row = this.database.prepare(
+      `
+        SELECT
+          id,
+          person_id AS personId,
+          category,
+          content,
+          entry_type AS entryType,
+          confidence,
+          status,
+          source,
+          created_at AS createdAt,
+          updated_at AS updatedAt,
+          last_observed_at AS lastObservedAt
+        FROM person_profile_entries
+        WHERE id = ?
+      `
+    ).get(entryId);
+    if (!row) {
+      return void 0;
+    }
+    return { ...row, evidence: this.getEvidence(entryId) };
+  }
+  replaceProfileEntry(input) {
+    if (input.input.evidence.length === 0) {
+      throw new Error("Profile entry evidence is required.");
+    }
+    const timestamp = input.input.observedAt ?? nowIso4();
+    const newEntryId = createId("profile_entry", [input.input.personId, input.input.category, input.input.content]);
+    const transaction = this.database.transaction(() => {
+      this.database.prepare(
+        `
+          INSERT INTO person_profile_entries (
+            id, person_id, category, content, entry_type, confidence, status, source, created_at, updated_at, last_observed_at
+          ) VALUES (?, ?, ?, ?, ?, ?, 'active', ?, ?, ?, ?)
+        `
+      ).run(newEntryId, input.input.personId, input.input.category, input.input.content, input.input.entryType, input.input.confidence, input.input.source, timestamp, timestamp, timestamp);
+      this.database.prepare(
+        `
+          UPDATE person_profile_entries
+          SET status = 'superseded', updated_at = ?
+          WHERE id = ? AND status = 'active'
+        `
+      ).run(timestamp, input.supersedeEntryId);
+      const insertEvidence = this.database.prepare(
+        `
+        INSERT INTO person_profile_evidence (entry_id, message_id, quote, reason)
+        VALUES (?, ?, ?, ?)
+        ON CONFLICT(entry_id, message_id, quote) DO UPDATE SET reason = excluded.reason
+      `
+      );
+      for (const evidence of input.input.evidence) {
+        insertEvidence.run(newEntryId, evidence.messageId, evidence.quote, evidence.reason);
+      }
+    });
+    transaction();
+    return newEntryId;
+  }
+  markProfileEntryDeleted(entryId) {
+    const timestamp = nowIso4();
+    this.database.prepare("UPDATE person_profile_entries SET status = 'deleted', updated_at = ? WHERE id = ?").run(timestamp, entryId);
+  }
+  personExists(personId) {
+    const row = this.database.prepare("SELECT 1 AS existsFlag FROM persons WHERE id = ? LIMIT 1").get(personId);
+    return Boolean(row);
+  }
+  getEvidence(entryId) {
+    return this.database.prepare(
+      `
+        SELECT entry_id AS entryId, message_id AS messageId, quote, reason
+        FROM person_profile_evidence
+        WHERE entry_id = ?
+        ORDER BY message_id ASC, quote ASC
+      `
+    ).all(entryId);
+  }
+};
+
 // src/rag/indexer.ts
 var EMBEDDING_INDEX_BATCH_SIZE = 64;
 async function indexMessageChunks(input) {
@@ -3447,12 +4166,12 @@ async function processMessagesNow(input) {
 }
 
 // src/multimodal/tasks.ts
-import crypto5 from "crypto";
-function nowIso4() {
+import crypto6 from "crypto";
+function nowIso5() {
   return (/* @__PURE__ */ new Date()).toISOString();
 }
 function stableId3(sourceMessageId, imageKey) {
-  return crypto5.createHash("sha256").update(`${sourceMessageId}${imageKey}`).digest("hex").slice(0, 32);
+  return crypto6.createHash("sha256").update(`${sourceMessageId}${imageKey}`).digest("hex").slice(0, 32);
 }
 function mapRow(row) {
   if (!row) {
@@ -3480,7 +4199,7 @@ var ImageMultimodalTaskRepository = class {
   database;
   enqueue(input) {
     const id = stableId3(input.sourceMessageId, input.imageKey);
-    const timestamp = nowIso4();
+    const timestamp = nowIso5();
     this.database.prepare(
       `
           INSERT INTO image_multimodal_tasks (
@@ -3568,7 +4287,7 @@ var ImageMultimodalTaskRepository = class {
               updated_at = @updatedAt
           WHERE id = @id AND status = 'pending'
         `
-    ).run({ id, updatedAt: nowIso4() });
+    ).run({ id, updatedAt: nowIso5() });
     if (result.changes === 0) {
       throw new Error(`\u56FE\u7247\u591A\u6A21\u6001\u4EFB\u52A1\u72B6\u6001\u65E0\u6CD5\u66F4\u65B0\uFF1A${id}`);
     }
@@ -3584,7 +4303,7 @@ var ImageMultimodalTaskRepository = class {
               updated_at = @updatedAt
           WHERE id = @id
         `
-    ).run({ id, derivedMessageId, updatedAt: nowIso4() });
+    ).run({ id, derivedMessageId, updatedAt: nowIso5() });
     return this.requireById(id);
   }
   markSkipped(id, reason) {
@@ -3597,7 +4316,7 @@ var ImageMultimodalTaskRepository = class {
               updated_at = @updatedAt
           WHERE id = @id
         `
-    ).run({ id, reason, updatedAt: nowIso4() });
+    ).run({ id, reason, updatedAt: nowIso5() });
     return this.requireById(id);
   }
   markFailed(id, error, finalFailure) {
@@ -3610,7 +4329,7 @@ var ImageMultimodalTaskRepository = class {
               updated_at = @updatedAt
           WHERE id = @id
         `
-    ).run({ id, status: finalFailure ? "failed" : "pending", error, updatedAt: nowIso4() });
+    ).run({ id, status: finalFailure ? "failed" : "pending", error, updatedAt: nowIso5() });
     return this.requireById(id);
   }
   getById(id) {
@@ -3892,11 +4611,23 @@ function createFeishuChatMembersClient(client) {
 }
 
 // src/rag/qa-logs.ts
-import crypto6 from "crypto";
+import crypto7 from "crypto";
+
+// src/rag/qa-trace.ts
+function hasQaTrace(trace) {
+  return Object.keys(trace).length > 0;
+}
+
+// src/rag/qa-logs.ts
 function clampLimit(limit) {
   return Math.max(1, Math.min(200, Math.trunc(limit)));
 }
+function parseTrace(value) {
+  const parsed = JSON.parse(value);
+  return parsed && typeof parsed === "object" ? parsed : {};
+}
 function mapQaLogRow(row) {
+  const trace = parseTrace(row.trace_json);
   return {
     id: row.id,
     chatId: row.chat_id,
@@ -3905,6 +4636,8 @@ function mapQaLogRow(row) {
     answer: row.answer,
     citations: JSON.parse(row.citations_json),
     retrievalDebug: JSON.parse(row.retrieval_debug_json),
+    trace,
+    hasTrace: hasQaTrace(trace),
     status: row.status,
     error: row.error,
     createdAt: row.created_at
@@ -3916,14 +4649,17 @@ var QaLogRepository = class {
   }
   database;
   create(input) {
+    const trace = input.trace ?? {};
     const record = {
-      id: `qa_${crypto6.randomUUID()}`,
+      id: `qa_${crypto7.randomUUID()}`,
       chatId: input.chatId ?? null,
       questionMessageId: input.questionMessageId ?? null,
       question: input.question,
       answer: input.answer,
       citations: input.citations,
       retrievalDebug: input.retrievalDebug,
+      trace,
+      hasTrace: hasQaTrace(trace),
       status: input.status,
       error: input.error ?? null,
       createdAt: input.createdAt
@@ -3938,6 +4674,7 @@ var QaLogRepository = class {
             answer,
             citations_json,
             retrieval_debug_json,
+            trace_json,
             status,
             error,
             created_at
@@ -3950,6 +4687,7 @@ var QaLogRepository = class {
             @answer,
             @citationsJson,
             @retrievalDebugJson,
+            @traceJson,
             @status,
             @error,
             @createdAt
@@ -3963,6 +4701,7 @@ var QaLogRepository = class {
       answer: record.answer,
       citationsJson: JSON.stringify(record.citations),
       retrievalDebugJson: JSON.stringify(record.retrievalDebug),
+      traceJson: JSON.stringify(record.trace),
       status: record.status,
       error: record.error,
       createdAt: record.createdAt
@@ -3980,6 +4719,7 @@ var QaLogRepository = class {
             answer,
             citations_json,
             retrieval_debug_json,
+            trace_json,
             status,
             error,
             created_at
@@ -4001,6 +4741,7 @@ var QaLogRepository = class {
             answer,
             citations_json,
             retrieval_debug_json,
+            trace_json,
             status,
             error,
             created_at
@@ -4012,6 +4753,27 @@ var QaLogRepository = class {
     ).all(chatId, clampLimit(limit));
     return rows.map(mapQaLogRow);
   }
+  getById(id) {
+    const row = this.database.prepare(
+      `
+          SELECT
+            id,
+            chat_id,
+            question_message_id,
+            question,
+            answer,
+            citations_json,
+            retrieval_debug_json,
+            trace_json,
+            status,
+            error,
+            created_at
+          FROM qa_logs
+          WHERE id = ?
+        `
+    ).get(id);
+    return row ? mapQaLogRow(row) : null;
+  }
   getCount() {
     const row = this.database.prepare("SELECT COUNT(*) AS count FROM qa_logs").get();
     return row.count;
@@ -4069,6 +4831,18 @@ ${block.text}`;
 function toToolErrorContent(message) {
   return JSON.stringify({ ok: false, error: message });
 }
+function nowIso6() {
+  return (/* @__PURE__ */ new Date()).toISOString();
+}
+function finalizeTrace(trace, status, finalAnswer, startedAtMs) {
+  return {
+    ...trace,
+    completedAt: nowIso6(),
+    durationMs: Date.now() - startedAtMs,
+    status,
+    finalAnswer
+  };
+}
 async function executeFeishuTool(tool, input) {
   const result = await tool.execute(input);
   if (isEvidenceBlockArray(result)) {
@@ -4080,6 +4854,13 @@ async function runFeishuToolLoop(input) {
   if (!input.model.completeWithTools) {
     throw new Error("\u5F53\u524D LLM \u5BA2\u6237\u7AEF\u4E0D\u652F\u6301\u5DE5\u5177\u8C03\u7528\u3002");
   }
+  const startedAtMs = Date.now();
+  const trace = {
+    startedAt: new Date(startedAtMs).toISOString(),
+    modelTurns: [],
+    toolResults: [],
+    fallbacks: []
+  };
   const maxModelTurns = input.maxModelTurns ?? DEFAULT_MAX_MODEL_TURNS;
   const maxToolCalls = input.maxToolCalls ?? DEFAULT_MAX_TOOL_CALLS;
   const systemPromptParts = [FEISHU_TOOL_SYSTEM_PROMPT];
@@ -4108,19 +4889,36 @@ async function runFeishuToolLoop(input) {
       toolCalls: assistantResult.toolCalls,
       reasoningContent: assistantResult.reasoningContent
     });
+    trace.modelTurns?.push({
+      index: turn,
+      content: assistantResult.content,
+      reasoningContent: assistantResult.reasoningContent,
+      toolCalls: assistantResult.toolCalls,
+      createdAt: nowIso6()
+    });
     if (assistantResult.toolCalls.length === 0) {
       if (hasRawToolCallMarkup) {
+        trace.fallbacks?.push({ type: "raw_tool_markup", message: "\u6A21\u578B\u8F93\u51FA\u4E86\u539F\u59CB\u5DE5\u5177\u8C03\u7528\u6807\u8BB0\uFF0C\u8F6C\u5165\u6700\u7EC8\u8865\u6551\u56DE\u7B54\u3002", createdAt: nowIso6() });
         break;
       }
-      return assistantResult.content || FEISHU_TOOL_LOOP_FALLBACK;
+      const answer = assistantResult.content || FEISHU_TOOL_LOOP_FALLBACK;
+      return { answer, trace: finalizeTrace(trace, "answered", answer, startedAtMs) };
     }
     for (const toolCall of assistantResult.toolCalls) {
       if (toolCallsUsed >= maxToolCalls) {
-        return FEISHU_TOOL_LOOP_LIMIT_REACHED;
+        trace.fallbacks?.push({ type: "tool_limit", message: FEISHU_TOOL_LOOP_LIMIT_REACHED, createdAt: nowIso6() });
+        return { answer: FEISHU_TOOL_LOOP_LIMIT_REACHED, trace: finalizeTrace(trace, "failed", FEISHU_TOOL_LOOP_LIMIT_REACHED, startedAtMs) };
       }
       toolCallsUsed += 1;
       const tool = toolsByName.get(toolCall.name);
       if (!tool) {
+        trace.toolResults?.push({
+          toolCallId: toolCall.id,
+          name: toolCall.name,
+          input: toolCall.input,
+          error: `\u672A\u77E5\u5DE5\u5177\uFF1A${toolCall.name}`,
+          createdAt: nowIso6()
+        });
         messages.push({
           role: "tool",
           toolCallId: toolCall.id,
@@ -4130,6 +4928,13 @@ async function runFeishuToolLoop(input) {
       }
       try {
         const result = await executeFeishuTool(tool, toolCall.input);
+        trace.toolResults?.push({
+          toolCallId: toolCall.id,
+          name: toolCall.name,
+          input: toolCall.input,
+          content: result,
+          createdAt: nowIso6()
+        });
         messages.push({
           role: "tool",
           toolCallId: toolCall.id,
@@ -4137,6 +4942,13 @@ async function runFeishuToolLoop(input) {
         });
       } catch (error) {
         const message = error instanceof Error ? error.message : String(error);
+        trace.toolResults?.push({
+          toolCallId: toolCall.id,
+          name: toolCall.name,
+          input: toolCall.input,
+          error: message,
+          createdAt: nowIso6()
+        });
         messages.push({
           role: "tool",
           toolCallId: toolCall.id,
@@ -4150,9 +4962,13 @@ async function runFeishuToolLoop(input) {
       ...messages,
       { role: "system", content: "\u8BF7\u57FA\u4E8E\u4EE5\u4E0A\u6240\u6709\u5DE5\u5177\u8FD4\u56DE\u7684\u4FE1\u606F\uFF0C\u76F4\u63A5\u7ED9\u51FA\u6700\u7EC8\u7B54\u6848\u3002\u4E0D\u8981\u518D\u8C03\u7528\u5DE5\u5177\u3002" }
     ]);
-    return salvageAnswer || "\u62B1\u6B49\uFF0C\u56DE\u7B54\u751F\u6210\u5931\u8D25\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5\u3002";
+    const answer = salvageAnswer || "\u62B1\u6B49\uFF0C\u56DE\u7B54\u751F\u6210\u5931\u8D25\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5\u3002";
+    trace.fallbacks?.push({ type: "salvage_completion", message: "\u5DE5\u5177\u5FAA\u73AF\u7ED3\u675F\u540E\u4F7F\u7528\u65E0\u5DE5\u5177\u8865\u6551\u56DE\u7B54\u3002", createdAt: nowIso6() });
+    return { answer, trace: finalizeTrace(trace, "answered", answer, startedAtMs) };
   } catch {
-    return "\u62B1\u6B49\uFF0C\u56DE\u7B54\u751F\u6210\u5931\u8D25\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5\u3002";
+    const answer = "\u62B1\u6B49\uFF0C\u56DE\u7B54\u751F\u6210\u5931\u8D25\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5\u3002";
+    trace.fallbacks?.push({ type: "answer_generation_failed", message: answer, createdAt: nowIso6() });
+    return { answer, trace: finalizeTrace(trace, "failed", answer, startedAtMs) };
   }
 }
 function formatConversationContext(records) {
@@ -4258,7 +5074,8 @@ var FeishuQuestionHandler = class {
       secrets: this.options.secrets,
       database: this.options.database,
       messages: new MessageRepository(this.options.database),
-      excludeMessageIds: options.excludeMessageIds
+      excludeMessageIds: options.excludeMessageIds,
+      profileTools: createPersonProfileTools({ profiles: new ProfileRepository(this.options.database) })
     });
     try {
       try {
@@ -4272,7 +5089,7 @@ var FeishuQuestionHandler = class {
         const memberRepository = this.options.memberRepository ?? new FeishuMemberRepository(this.options.database);
         const memberPrompt = formatFeishuMemberPrompt(memberRepository.listByChat(decision.chatId));
         const conversationContext = formatConversationContext(qaLogs.listRecentByChat(decision.chatId, 6));
-        const answer = await runFeishuToolLoop({
+        const result = await runFeishuToolLoop({
           question: decision.question,
           now,
           tools: allTools,
@@ -4284,27 +5101,38 @@ var FeishuQuestionHandler = class {
           chatId: decision.chatId,
           questionMessageId,
           question: decision.question,
-          answer,
+          answer: result.answer,
           citations: [],
           retrievalDebug: {},
+          trace: result.trace,
           status: "answered",
           createdAt: (/* @__PURE__ */ new Date()).toISOString()
         });
-        await this.sendResponse(decision.chatId, questionMessageId, answer);
+        await this.sendResponse(decision.chatId, questionMessageId, result.answer);
       } catch (error) {
         const message = error instanceof Error ? error.message : String(error);
+        const failedAt = (/* @__PURE__ */ new Date()).toISOString();
+        const failedAnswer = `\u6682\u65F6\u65E0\u6CD5\u56DE\u7B54\uFF1A${message}`;
         qaLogs.create({
           chatId: decision.chatId,
           questionMessageId,
           question: decision.question,
-          answer: `\u6682\u65F6\u65E0\u6CD5\u56DE\u7B54\uFF1A${message}`,
+          answer: failedAnswer,
           citations: [],
           retrievalDebug: {},
+          trace: {
+            startedAt: now.toISOString(),
+            completedAt: failedAt,
+            durationMs: Math.max(0, Date.parse(failedAt) - now.getTime()),
+            status: "failed",
+            finalAnswer: failedAnswer,
+            fallbacks: [{ type: "answer_generation_failed", message, createdAt: failedAt }]
+          },
           status: "failed",
           error: message,
-          createdAt: (/* @__PURE__ */ new Date()).toISOString()
+          createdAt: failedAt
         });
-        await this.sendResponse(decision.chatId, questionMessageId, `\u6682\u65F6\u65E0\u6CD5\u56DE\u7B54\uFF1A${message}`);
+        await this.sendResponse(decision.chatId, questionMessageId, failedAnswer);
       }
       return decision;
     } finally {
@@ -4724,7 +5552,8 @@ function createFeishuGateway(options) {
         secrets: options.secrets,
         database: options.cronJobProcessor.database,
         messages: new MessageRepository(options.cronJobProcessor.database),
-        scope: { platform: "feishu", platformChatId: job.chatId }
+        scope: { platform: "feishu", platformChatId: job.chatId },
+        profileTools: createPersonProfileTools({ profiles: new ProfileRepository(options.cronJobProcessor.database) })
       });
       try {
         const memberPrompt = formatFeishuMemberPrompt(
@@ -4984,7 +5813,7 @@ var FeishuResourceDownloader = class _FeishuResourceDownloader {
 };
 
 // src/files/ingest.ts
-import crypto7 from "crypto";
+import crypto8 from "crypto";
 import fs12 from "fs/promises";
 import path15 from "path";
 
@@ -5048,7 +5877,7 @@ function ensureSupportedTextFile(filePath) {
   }
 }
 function stableStoredName(sourcePath, fileName) {
-  const digest = crypto7.createHash("sha256").update(sourcePath).digest("hex").slice(0, 16);
+  const digest = crypto8.createHash("sha256").update(sourcePath).digest("hex").slice(0, 16);
   return `${digest}-${fileName}`;
 }
 async function ingestLocalFile(input) {
@@ -5148,16 +5977,32 @@ function isMultimodalReady(config, secrets) {
   return Boolean(config.multimodal.baseUrl && config.multimodal.model && secrets.multimodal.apiKey);
 }
 var GatewayIngestor = class {
-  constructor(database) {
+  constructor(database, options = {}) {
     this.database = database;
+    this.options = options;
     this.messages = new MessageRepository(database);
     this.jobs = new FileJobRepository(database);
     this.imageTasks = new ImageMultimodalTaskRepository(database);
   }
   database;
+  options;
   messages;
   jobs;
   imageTasks;
+  enrichWithPerson(input) {
+    const person = this.options.profiles?.resolvePersonForSender({
+      platform: input.platform,
+      platformChatId: input.platformChatId,
+      senderId: input.senderId,
+      senderName: input.senderName,
+      source: "message",
+      observedAt: input.sentAt
+    });
+    return {
+      ...input,
+      personId: person?.id
+    };
+  }
   ingestFeishuEvent(payload) {
     const normalized = normalizeFeishuReceiveMessageEvent(payload);
     if (!normalized) {
@@ -5166,12 +6011,13 @@ var GatewayIngestor = class {
         reason: "\u4E8B\u4EF6\u4E0D\u662F\u53EF\u5165\u5E93\u7684\u98DE\u4E66\u6D88\u606F\u3002"
       };
     }
-    const duplicate = this.messages.hasPlatformMessage(normalized.platform, normalized.platformMessageId);
-    const messageId = this.messages.ingest(normalized);
+    const enriched = this.enrichWithPerson(normalized);
+    const duplicate = this.messages.hasPlatformMessage(enriched.platform, enriched.platformMessageId);
+    const messageId = this.messages.ingest(enriched);
     return {
       accepted: true,
       messageId,
-      message: normalized,
+      message: enriched,
       duplicate
     };
   }
@@ -5185,7 +6031,7 @@ var GatewayIngestor = class {
     }
     const openId = extractFeishuSenderOpenId(normalized);
     const senderName = openId ? await input.memberResolver.resolveOpenIdName(normalized.platformChatId, openId) : normalized.senderName;
-    const enriched = { ...normalized, senderName };
+    const enriched = this.enrichWithPerson({ ...normalized, senderName });
     const duplicate = this.messages.hasPlatformMessage(enriched.platform, enriched.platformMessageId);
     const messageId = this.messages.ingest(enriched);
     return {
@@ -5413,7 +6259,7 @@ var MemoryVectorStore = class {
 };
 
 // src/web/server.ts
-import crypto8 from "crypto";
+import crypto9 from "crypto";
 import Fastify from "fastify";
 function buildHtml() {
   return `<!doctype html>
@@ -5755,6 +6601,10 @@ function buildHtml() {
         <svg class="nav-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"/><path d="M9.09 9a3 3 0 0 1 5.83 1c0 2-3 3-3 3"/><line x1="12" y1="17" x2="12.01" y2="17"/></svg>
         <span>\u95EE\u7B54\u65E5\u5FD7</span>
       </button>
+      <button class="nav-item" data-view="persons">
+        <svg class="nav-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M17 21v-2a4 4 0 0 0-4-4H5a4 4 0 0 0-4 4v2"/><circle cx="9" cy="7" r="4"/><path d="M23 21v-2a4 4 0 0 0-3-3.87"/><path d="M16 3.13a4 4 0 0 1 0 7.75"/></svg>
+        <span>\u4E2A\u4EBA\u6863\u6848</span>
+      </button>
       <button class="nav-item" data-view="settings">
         <svg class="nav-icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="3"/><path d="M19.4 15a1.65 1.65 0 0 0 .33 1.82l.06.06a2 2 0 0 1 0 2.83 2 2 0 0 1-2.83 0l-.06-.06a1.65 1.65 0 0 0-1.82-.33 1.65 1.65 0 0 0-1 1.51V21a2 2 0 0 1-2 2 2 2 0 0 1-2-2v-.09A1.65 1.65 0 0 0 9 19.4a1.65 1.65 0 0 0-1.82.33l-.06.06a2 2 0 0 1-2.83 0 2 2 0 0 1 0-2.83l.06-.06A1.65 1.65 0 0 0 4.6 15a1.65 1.65 0 0 0-1.51-1H3a2 2 0 0 1-2-2 2 2 0 0 1 2-2h.09A1.65 1.65 0 0 0 4.6 9a1.65 1.65 0 0 0-.33-1.82l-.06-.06a2 2 0 0 1 0-2.83 2 2 0 0 1 2.83 0l.06.06a1.65 1.65 0 0 0 1.82.33H9a1.65 1.65 0 0 0 1-1.51V3a2 2 0 0 1 2-2 2 2 0 0 1 2 2v.09a1.65 1.65 0 0 0 1 1.51 1.65 1.65 0 0 0 1.82-.33l.06-.06a2 2 0 0 1 2.83 0 2 2 0 0 1 0 2.83l-.06.06a1.65 1.65 0 0 0-.33 1.82V9a1.65 1.65 0 0 0 1.51 1H21a2 2 0 0 1 2 2 2 2 0 0 1-2 2h-.09a1.65 1.65 0 0 0-1.51 1z"/></svg>
         <span>\u8BBE\u7F6E</span>
@@ -5786,6 +6636,10 @@ function buildHtml() {
       <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M12 20h9"/><path d="M16.5 3.5a2.121 2.121 0 0 1 3 3L7 19l-4 1 1-4L16.5 3.5z"/></svg>
       <span>\u4EFB\u52A1</span>
     </button>
+    <button class="mobile-nav-item" data-view="persons">
+      <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M17 21v-2a4 4 0 0 0-4-4H5a4 4 0 0 0-4 4v2"/><circle cx="9" cy="7" r="4"/><path d="M23 21v-2a4 4 0 0 0-3-3.87"/><path d="M16 3.13a4 4 0 0 1 0 7.75"/></svg>
+      <span>\u6863\u6848</span>
+    </button>
     <button class="mobile-nav-item" data-view="settings">
       <svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="3"/><path d="M19.4 15a1.65 1.65 0 0 0 .33 1.82l.06.06a2 2 0 0 1 0 2.83 2 2 0 0 1-2.83 0l-.06-.06a1.65 1.65 0 0 0-1.82-.33 1.65 1.65 0 0 0-1 1.51V21a2 2 0 0 1-2 2 2 2 0 0 1-2-2v-.09A1.65 1.65 0 0 0 9 19.4a1.65 1.65 0 0 0-1.82.33l-.06.06a2 2 0 0 1-2.83 0 2 2 0 0 1 0-2.83l.06-.06A1.65 1.65 0 0 0 4.6 15a1.65 1.65 0 0 0-1.51-1H3a2 2 0 0 1-2-2 2 2 0 0 1 2-2h.09A1.65 1.65 0 0 0 4.6 9a1.65 1.65 0 0 0-.33-1.82l-.06-.06a2 2 0 0 1 0-2.83 2 2 0 0 1 2.83 0l.06.06a1.65 1.65 0 0 0 1.82.33H9a1.65 1.65 0 0 0 1-1.51V3a2 2 0 0 1 2-2 2 2 0 0 1 2 2v.09a1.65 1.65 0 0 0 1 1.51 1.65 1.65 0 0 0 1.82-.33l.06-.06a2 2 0 0 1 2.83 0 2 2 0 0 1 0 2.83l-.06.06a1.65 1.65 0 0 0-.33 1.82V9a1.65 1.65 0 0 0 1.51 1H21a2 2 0 0 1 2 2 2 2 0 0 1-2 2h-.09a1.65 1.65 0 0 0-1.51 1z"/></svg>
       <span>\u8BBE\u7F6E</span>
@@ -5882,6 +6736,18 @@ function buildHtml() {
       <div class="content-panel glass"><div id="qa-logs-list"></div></div>
     </div>
 
+    <div class="view" id="view-persons">
+      <div class="section-header"><div><h1 class="section-title">\u4E2A\u4EBA\u6863\u6848</h1><p class="page-subtitle">\u7FA4\u6210\u5458\u6863\u6848\u4E0E\u4E8B\u5B9E\u4FE1\u606F</p></div></div>
+      <div class="content-panel glass" id="persons-list-panel"><div id="persons-list"></div></div>
+      <div class="content-panel glass mt-lg" id="person-profile-panel" style="display:none;">
+        <div class="panel-header">
+          <h2 class="panel-title" id="person-profile-name"></h2>
+          <button class="btn btn-sm" onclick="navigateTo('persons')">\u8FD4\u56DE\u5217\u8868</button>
+        </div>
+        <div id="person-profile-detail"></div>
+      </div>
+    </div>
+
     <div class="view" id="view-settings">
       <div class="section-header"><div><h1 class="section-title">\u8BBE\u7F6E</h1><p class="page-subtitle">\u7CFB\u7EDF\u914D\u7F6E\u4E0E\u64CD\u4F5C</p></div></div>
       <div class="settings-group glass" id="settings-config"></div>
@@ -5917,12 +6783,16 @@ function buildHtml() {
     let allFileJobs = [];
     let allCronJobs = [];
     let allQaLogs = [];
+    let allPersons = [];
+    let selectedPersonId = null;
     let statusData = null;
 
     function fmt(value) { return value == null || value === "" ? "-" : String(value); }
     function escapeHtml(value) {
       return fmt(value).replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;");
     }
+    function renderJson(value) { return '<pre style="white-space:pre-wrap;overflow:auto;max-height:320px;">' + escapeHtml(JSON.stringify(value, null, 2)) + '</pre>'; }
+    function renderTextBlock(value) { return '<pre style="white-space:pre-wrap;overflow:auto;max-height:320px;">' + escapeHtml(value || "") + '</pre>'; }
     function isOpaqueId(value) { return /^(ou|oc|om|cli|on|un|uid)_?[a-z0-9]+/i.test(fmt(value)); }
     function formatDateTime(value) {
       var date = new Date(value);
@@ -5958,6 +6828,7 @@ function buildHtml() {
       if (view === "files") renderFilesView();
       if (view === "tasks") renderTasksView();
       if (view === "qa-logs") renderQaLogsView();
+      if (view === "persons") renderPersonsView();
     }
 
     document.querySelectorAll(".nav-item, .mobile-nav-item").forEach(function(el) {
@@ -6000,6 +6871,55 @@ function buildHtml() {
       return result;
     }
 
+    function toJsArgument(value) {
+      return escapeHtml(JSON.stringify(fmt(value)));
+    }
+
+    function findEntryEvidenceMessage(entry) {
+      var evidence = entry.evidence || [];
+      return evidence.length > 0 ? evidence[0].messageId : "";
+    }
+
+    function findEntryEvidenceQuote(entry) {
+      var evidence = entry.evidence || [];
+      return evidence.length > 0 ? evidence[0].quote : "";
+    }
+
+    async function correctPersonProfileEntry(personId, entryId, category, content, entryType, confidence, evidenceMessageId, quote) {
+      var nextContent = prompt("\u4FEE\u6B63\u6863\u6848\u5185\u5BB9", content);
+      if (!nextContent || !nextContent.trim()) return;
+      var reason = prompt("\u4FEE\u6B63\u7406\u7531", "\u7528\u6237\u5728 Web UI \u663E\u5F0F\u4FEE\u6B63") || "\u7528\u6237\u5728 Web UI \u663E\u5F0F\u4FEE\u6B63";
+      try {
+        await postJson("/api/persons/" + encodeURIComponent(personId) + "/profile/entries/" + encodeURIComponent(entryId) + "/correct", {
+          headers: { "content-type": "application/json" },
+          body: JSON.stringify({
+            category: category,
+            content: nextContent.trim(),
+            entryType: entryType,
+            confidence: confidence,
+            evidenceMessageId: evidenceMessageId,
+            quote: quote || content,
+            reason: reason
+          })
+        });
+        showToast("\u6863\u6848\u6761\u76EE\u5DF2\u4FEE\u6B63", "success");
+        await showPersonProfile(personId);
+      } catch (error) {
+        showToast(error instanceof Error ? error.message : String(error), "error");
+      }
+    }
+
+    async function deletePersonProfileEntry(personId, entryId) {
+      if (!confirm("\u786E\u8BA4\u5220\u9664\u8FD9\u6761\u6863\u6848\u6761\u76EE\uFF1F")) return;
+      try {
+        await deleteJson("/api/persons/" + encodeURIComponent(personId) + "/profile/entries/" + encodeURIComponent(entryId));
+        showToast("\u6863\u6848\u6761\u76EE\u5DF2\u5220\u9664", "success");
+        await showPersonProfile(personId);
+      } catch (error) {
+        showToast(error instanceof Error ? error.message : String(error), "error");
+      }
+    }
+
     function renderMetrics(status) {
       var gatewayClass = status.gateway.configured ? "status-dot online" : "status-dot offline";
       var gatewayText = status.gateway.connection === "running" ? "\u8FD0\u884C\u4E2D" : (!status.gateway.configured ? "\u672A\u914D\u7F6E" : "\u5F85\u542F\u52A8");
@@ -6195,13 +7115,158 @@ function buildHtml() {
       for (var i = 0; i < allQaLogs.length; i++) {
         var item = allQaLogs[i];
         var citationCount = Array.isArray(item.citations) ? item.citations.length : 0;
-        var statusClass = item.status === 'success' ? 'tag-success' : 'tag-warning';
+        var statusClass = item.status === 'answered' ? 'tag-success' : 'tag-warning';
         html += '<div class="qa-card"><div class="message-meta" style="margin-bottom:var(--space-sm);">' +
           '<span>' + escapeHtml(formatDateTime(item.createdAt)) + '</span>' +
           '<span class="tag ' + statusClass + '">' + escapeHtml(item.status) + '</span>' +
-          '<span>' + citationCount + ' \u6761\u5F15\u7528</span></div>' +
+          '<span>' + citationCount + ' \u6761\u5F15\u7528</span>' +
+          '<span class="tag ' + (item.hasTrace ? 'tag-info' : 'tag-warning') + '">' + (item.hasTrace ? '\u6709 trace' : '\u65E0 trace') + '</span></div>' +
           '<div class="qa-question">' + escapeHtml(item.question) + '</div>' +
-          '<div class="qa-answer">' + escapeHtml(item.answer) + '</div></div>';
+          '<div class="qa-answer">' + escapeHtml(item.answer) + '</div>' +
+          '<button class="btn btn-sm" style="margin-top:var(--space-sm);" data-view-qa-log="' + escapeHtml(item.id) + '">\u67E5\u770B\u8BE6\u60C5</button>' +
+          '<div id="qa-detail-' + escapeHtml(item.id) + '" style="margin-top:var(--space-md);"></div></div>';
+      }
+      el.innerHTML = html;
+    }
+
+    async function showQaLogDetail(id) {
+      selectedQaLogId = id;
+      var container = document.getElementById("qa-detail-" + id);
+      if (!container) return;
+      container.innerHTML = '<div class="empty-state">\u6B63\u5728\u52A0\u8F7D\u95EE\u7B54\u8BE6\u60C5...</div>';
+      try {
+        var item = await fetchJson("/api/qa-logs/" + encodeURIComponent(id));
+        renderQaLogDetail(item);
+      } catch (error) {
+        container.innerHTML = '<div class="empty-state">\u8BE6\u60C5\u52A0\u8F7D\u5931\u8D25\uFF1A' + escapeHtml(error instanceof Error ? error.message : String(error)) + '</div>';
+      }
+    }
+
+    function renderQaLogDetail(item) {
+      var container = document.getElementById("qa-detail-" + item.id);
+      if (!container) return;
+      var trace = item.trace || {};
+      var html = '<div class="content-panel" style="margin-top:var(--space-sm);background:rgba(255,255,255,0.03);">';
+      html += '<h3 style="font-size:15px;margin-bottom:var(--space-sm);">\u95EE\u7B54\u8BE6\u60C5</h3>';
+      html += '<div class="message-meta" style="margin-bottom:var(--space-sm);"><span>\u72B6\u6001\uFF1A' + escapeHtml(item.status) + '</span><span>\u521B\u5EFA\uFF1A' + escapeHtml(formatDateTime(item.createdAt)) + '</span><span>\u8017\u65F6\uFF1A' + escapeHtml(trace.durationMs == null ? '-' : trace.durationMs + 'ms') + '</span></div>';
+      if (item.error) html += '<div style="color:var(--danger);margin-bottom:var(--space-sm);">\u9519\u8BEF\uFF1A' + escapeHtml(item.error) + '</div>';
+      html += '<div class="qa-question">' + escapeHtml(item.question) + '</div>';
+      html += '<div class="qa-answer" style="margin-bottom:var(--space-md);">' + escapeHtml(item.answer) + '</div>';
+      if (!item.hasTrace) {
+        html += '<div class="empty-state">\u8FD9\u6761\u95EE\u7B54\u6CA1\u6709 trace\uFF0C\u53EF\u80FD\u6765\u81EA\u65E7\u7248\u672C\u8BB0\u5F55\u3002</div></div>';
+        container.innerHTML = html;
+        return;
+      }
+      var turns = trace.modelTurns || [];
+      html += '<h4 style="margin:var(--space-md) 0 var(--space-sm);">Reasoning</h4>';
+      if (turns.length === 0) html += '<div class="empty-state">\u65E0 reasoningContent</div>';
+      for (var i = 0; i < turns.length; i++) {
+        html += '<div style="margin-bottom:var(--space-sm);"><div class="message-meta"><span>\u6A21\u578B\u8F6E\u6B21 ' + escapeHtml(turns[i].index) + '</span><span>' + escapeHtml(formatDateTime(turns[i].createdAt)) + '</span></div>' + renderTextBlock(turns[i].reasoningContent || '\u65E0 reasoningContent') + '</div>';
+      }
+      html += '<h4 style="margin:var(--space-md) 0 var(--space-sm);">\u6A21\u578B\u8F6E\u6B21\u4E0E\u5DE5\u5177\u8C03\u7528</h4>';
+      for (var j = 0; j < turns.length; j++) {
+        html += '<div style="margin-bottom:var(--space-sm);"><div class="message-meta"><span>\u8F6E\u6B21 ' + escapeHtml(turns[j].index) + '</span></div>' + renderTextBlock(turns[j].content || '') + renderJson(turns[j].toolCalls || []) + '</div>';
+      }
+      html += '<h4 style="margin:var(--space-md) 0 var(--space-sm);">\u5DE5\u5177\u7ED3\u679C</h4>';
+      var toolResults = trace.toolResults || [];
+      if (toolResults.length === 0) html += '<div class="empty-state">\u6CA1\u6709\u5DE5\u5177\u7ED3\u679C\u3002</div>';
+      for (var k = 0; k < toolResults.length; k++) {
+        html += '<div style="margin-bottom:var(--space-sm);"><div class="message-meta"><span>' + escapeHtml(toolResults[k].name) + '</span><span>' + escapeHtml(toolResults[k].toolCallId) + '</span><span>' + escapeHtml(formatDateTime(toolResults[k].createdAt)) + '</span></div>' + renderJson(toolResults[k].input) + (toolResults[k].error ? '<div style="color:var(--danger);">' + escapeHtml(toolResults[k].error) + '</div>' : renderTextBlock(toolResults[k].content || '')) + '</div>';
+      }
+      html += '<h4 style="margin:var(--space-md) 0 var(--space-sm);">\u5F15\u7528\u4E0E\u68C0\u7D22</h4>' + renderJson({ citations: item.citations || [], retrievalDebug: item.retrievalDebug || {} });
+      html += '<h4 style="margin:var(--space-md) 0 var(--space-sm);">Fallback</h4>';
+      var fallbacks = trace.fallbacks || [];
+      html += fallbacks.length === 0 ? '<div class="empty-state">\u6CA1\u6709 fallback\u3002</div>' : renderJson(fallbacks);
+      html += '</div>';
+      container.innerHTML = html;
+    }
+
+    function renderPersonsView() {
+      var listEl = document.getElementById("persons-list");
+      var profilePanel = document.getElementById("person-profile-panel");
+      if (profilePanel) profilePanel.style.display = "none";
+      if (!allPersons || allPersons.length === 0) {
+        listEl.innerHTML = '<div class="empty-state">\u8FD8\u6CA1\u6709\u4E2A\u4EBA\u6863\u6848\u3002\u7CFB\u7EDF\u4F1A\u81EA\u52A8\u4ECE\u804A\u5929\u8BB0\u5F55\u4E2D\u8BC6\u522B\u7FA4\u6210\u5458\u3002</div>';
+        return;
+      }
+      var html = '<table class="data-table"><thead><tr><th>\u6210\u5458</th><th>\u6863\u6848\u6761\u76EE</th><th>\u6D88\u606F\u6570</th></tr></thead><tbody>';
+      for (var i = 0; i < allPersons.length; i++) {
+        var p = allPersons[i];
+        html += '<tr data-view-person="' + escapeHtml(p.id) + '" style="cursor:pointer;">' +
+          '<td><span style="font-weight:500;">' + escapeHtml(p.primaryName) + '</span></td>' +
+          '<td>' + escapeHtml(p.profileEntryCount) + '</td>' +
+          '<td>' + escapeHtml(p.messageCount) + '</td></tr>';
+      }
+      html += '</tbody></table>';
+      listEl.innerHTML = html;
+    }
+
+    async function showPersonProfile(id) {
+      selectedPersonId = id;
+      var listEl = document.getElementById("persons-list-panel");
+      var profilePanel = document.getElementById("person-profile-panel");
+      var detailEl = document.getElementById("person-profile-detail");
+      if (listEl) listEl.style.display = "none";
+      if (profilePanel) profilePanel.style.display = "block";
+      detailEl.innerHTML = '<div class="empty-state">\u6B63\u5728\u52A0\u8F7D\u4E2A\u4EBA\u6863\u6848...</div>';
+      try {
+        var profile = await fetchJson("/api/persons/" + encodeURIComponent(id) + "/profile");
+        var messages = await fetchJson("/api/persons/" + encodeURIComponent(id) + "/messages?limit=50");
+        renderPersonProfile(id, profile, messages.items || []);
+      } catch (error) {
+        detailEl.innerHTML = '<div class="empty-state">\u52A0\u8F7D\u5931\u8D25\uFF1A' + escapeHtml(error instanceof Error ? error.message : String(error)) + '</div>';
+      }
+    }
+
+    function renderPersonProfile(id, profile, messages) {
+      var el = document.getElementById("person-profile-detail");
+      var nameEl = document.getElementById("person-profile-name");
+      if (nameEl) nameEl.textContent = profile.person.primaryName;
+      var html = '';
+      var identities = profile.identities || [];
+      if (identities.length > 0) {
+        html += '<div class="mb-md"><span style="color:var(--text-muted);font-size:13px;">\u8EAB\u4EFD\uFF1A</span> ';
+        html += identities.map(function(id) { return escapeHtml(id.displayName) + ' (' + escapeHtml(id.platform) + ')'; }).join('\uFF0C');
+        html += '</div>';
+      }
+      var entries = profile.entries || [];
+      if (entries.length === 0) {
+        html += '<div class="empty-state">\u8FD8\u6CA1\u6709\u6863\u6848\u6761\u76EE\u3002</div>';
+      } else {
+        html += '<div class="grid-2">';
+        for (var i = 0; i < entries.length; i++) {
+          var entry = entries[i];
+          var evidence = entry.evidence || [];
+          html += '<div class="content-panel" style="background:rgba(255,255,255,0.03);padding:var(--space-md);">' +
+            '<div style="display:flex;gap:var(--space-sm);margin-bottom:var(--space-sm);align-items:center;flex-wrap:wrap;">' +
+            '<span class="tag">' + escapeHtml(entry.category) + '</span>' +
+            '<span class="tag ' + (entry.entryType === 'fact' ? 'tag-success' : 'tag-info') + '">' + escapeHtml(entry.entryType) + '</span>' +
+            '<span style="font-size:12px;color:var(--text-muted);">' + escapeHtml(Math.round(entry.confidence * 100)) + '%</span>' +
+            '<span style="flex:1;"></span>' +
+            '<button class="btn btn-sm" onclick="correctPersonProfileEntry(' + toJsArgument(id) + ',' + toJsArgument(entry.id) + ',' + toJsArgument(entry.category) + ',' + toJsArgument(entry.content) + ',' + toJsArgument(entry.entryType) + ',' + Number(entry.confidence || 0) + ',' + toJsArgument(findEntryEvidenceMessage(entry)) + ',' + toJsArgument(findEntryEvidenceQuote(entry)) + ')">\u4FEE\u6B63</button>' +
+            '<button class="btn btn-sm btn-danger" onclick="deletePersonProfileEntry(' + toJsArgument(id) + ',' + toJsArgument(entry.id) + ')">\u5220\u9664</button>' +
+            '</div>' +
+            '<div style="font-weight:500;margin-bottom:var(--space-xs);">' + escapeHtml(entry.content) + '</div>';
+          if (evidence.length > 0) {
+            html += '<div style="font-size:12px;color:var(--text-muted);">\u8BC1\u636E\uFF1A' +
+              evidence.map(function(e) { return '<span style="display:block;margin-top:2px;">"' + escapeHtml(e.quote) + '" (' + escapeHtml(e.reason) + ')</span>'; }).join('') +
+              '</div>';
+          }
+          html += '</div>';
+        }
+        html += '</div>';
+      }
+      if (messages && messages.length > 0) {
+        html += '<h3 style="margin:var(--space-lg) 0 var(--space-sm);font-size:16px;">\u6700\u8FD1\u6D88\u606F</h3>';
+        html += '<div class="message-list">';
+        for (var j = 0; j < Math.min(messages.length, 10); j++) {
+          var msg = messages[j];
+          html += '<div class="message-card"><div class="message-meta">' +
+            '<span>' + escapeHtml(formatDateTime(msg.sentAt)) + '</span>' +
+            '<span>' + escapeHtml(displayChatName(msg.chatName, msg.platform)) + '</span>' +
+            '</div><div class="message-text">' + escapeHtml(msg.text) + '</div></div>';
+        }
+        html += '</div>';
       }
       el.innerHTML = html;
     }
@@ -6236,11 +7301,19 @@ function buildHtml() {
       await loadSection("/api/file-jobs", function(data) { allFileJobs = data.items || []; });
       await loadSection("/api/qa-logs?limit=20", function(data) { allQaLogs = data.items || []; });
       await loadSection("/api/cron-jobs", function(data) { allCronJobs = data.items || []; });
+      await loadSection("/api/persons", function(data) { allPersons = data.items || []; });
       if (currentView === "messages") renderMessagesView();
       if (currentView === "episodes") renderEpisodesView();
       if (currentView === "files") renderFilesView();
       if (currentView === "tasks") renderTasksView();
-      if (currentView === "qa-logs") renderQaLogsView();
+      if (currentView === "qa-logs") {
+        renderQaLogsView();
+        if (selectedQaLogId) void showQaLogDetail(selectedQaLogId);
+      }
+      if (currentView === "persons") {
+        renderPersonsView();
+        if (selectedPersonId) void showPersonProfile(selectedPersonId);
+      }
     }
 
     async function processNow() {
@@ -6262,6 +7335,16 @@ function buildHtml() {
     document.addEventListener("click", async function(event) {
       var target = event.target;
       if (!(target instanceof HTMLElement)) return;
+      var qaLogId = target.dataset.viewQaLog;
+      if (qaLogId) {
+        void showQaLogDetail(qaLogId);
+        return;
+      }
+      var personId = target.dataset.viewPerson || target.closest('[data-view-person]')?.dataset.viewPerson;
+      if (personId) {
+        void showPersonProfile(personId);
+        return;
+      }
       var id = target.dataset.deleteCronJob;
       if (!id) return;
       target.disabled = true;
@@ -6281,7 +7364,7 @@ function buildHtml() {
 </body>
 </html>`;
 }
-function parseLimit(value, fallback, max) {
+function parseLimit2(value, fallback, max) {
   const rawLimit = Number(value ?? fallback);
   return Number.isFinite(rawLimit) ? Math.min(Math.max(Math.trunc(rawLimit), 1), max) : fallback;
 }
@@ -6305,6 +7388,20 @@ function parseCookies(header) {
 function isAuthorizedWebAction(request, token) {
   return parseCookies(request.headers.cookie).chattercatcher_web_token === token;
 }
+function readStringField(input, key) {
+  if (!input || typeof input !== "object" || Array.isArray(input)) return void 0;
+  const value = input[key];
+  return typeof value === "string" && value.trim() ? value.trim() : void 0;
+}
+function readNumberField(input, key, fallback) {
+  if (!input || typeof input !== "object" || Array.isArray(input)) return fallback;
+  const value = input[key];
+  return typeof value === "number" && Number.isFinite(value) ? value : fallback;
+}
+function toQaLogListItem(log) {
+  const { trace: _trace, ...item } = log;
+  return item;
+}
 function createWebApp(config, options = {}) {
   const app = Fastify({ logger: false });
   const database = openDatabase(config);
@@ -6314,11 +7411,12 @@ function createWebApp(config, options = {}) {
   const fileJobs = new FileJobRepository(database);
   const qaLogs = new QaLogRepository(database);
   const cronJobs = new CronJobRepository(database);
+  const profiles = new ProfileRepository(database);
   let webActionToken = "";
   const tokenReady = (async () => {
     const secrets = await loadSecrets();
     if (!secrets.web.actionToken) {
-      secrets.web.actionToken = crypto8.randomBytes(32).toString("hex");
+      secrets.web.actionToken = crypto9.randomBytes(32).toString("hex");
       await saveSecrets(secrets);
     }
     webActionToken = getWebActionToken(secrets);
@@ -6356,38 +7454,47 @@ function createWebApp(config, options = {}) {
     items: messages.listChats()
   }));
   app.get("/api/files", async (request) => {
-    const limit = parseLimit(request.query.limit, 50, 200);
+    const limit = parseLimit2(request.query.limit, 50, 200);
     return {
       items: messages.listFiles(limit)
     };
   });
   app.get("/api/file-jobs", async (request) => {
-    const limit = parseLimit(request.query.limit, 50, 200);
+    const limit = parseLimit2(request.query.limit, 50, 200);
     const status = request.query.status;
     return {
       items: fileJobs.list(limit, status === "processing" || status === "indexed" || status === "failed" ? { status } : {})
     };
   });
   app.get("/api/messages/recent", async (request) => {
-    const limit = parseLimit(request.query.limit, 20, 100);
+    const limit = parseLimit2(request.query.limit, 20, 100);
     return {
       items: messages.listRecentMessages(limit)
     };
   });
   app.get("/api/episodes", async (request) => {
-    const limit = parseLimit(request.query.limit, 20, 100);
+    const limit = parseLimit2(request.query.limit, 20, 100);
     return {
       items: episodes.listRecentEpisodes(limit)
     };
   });
   app.get("/api/qa-logs", async (request) => {
-    const limit = parseLimit(request.query.limit, 20, 100);
+    const limit = parseLimit2(request.query.limit, 20, 100);
     return {
-      items: qaLogs.listRecent(limit)
+      items: qaLogs.listRecent(limit).map(toQaLogListItem)
     };
   });
+  app.get("/api/qa-logs/:id", async (request, reply) => {
+    const id = request.params.id;
+    const log = qaLogs.getById(id);
+    if (!log) {
+      reply.code(404);
+      return { ok: false, message: "\u6CA1\u6709\u627E\u5230\u95EE\u7B54\u65E5\u5FD7\u3002" };
+    }
+    return log;
+  });
   app.get("/api/cron-jobs", async (request) => {
-    const limit = parseLimit(request.query.limit, 50, 200);
+    const limit = parseLimit2(request.query.limit, 50, 200);
     return {
       items: cronJobs.list(limit)
     };
@@ -6407,6 +7514,105 @@ function createWebApp(config, options = {}) {
     const ok = cronJobs.deleteByChat(id, job.chatId);
     return { ok };
   });
+  app.get("/api/persons", async (_request) => {
+    const persons = profiles.listPersons();
+    const items = persons.map((person) => {
+      const profile = profiles.getPersonProfile(person.id, { includeEvidence: false, includeInferred: true });
+      return {
+        id: person.id,
+        primaryName: person.primaryName,
+        profileEntryCount: profile?.entries.length ?? 0,
+        messageCount: database.prepare(
+          "SELECT COUNT(1) AS count FROM messages WHERE person_id = ?"
+        ).get(person.id).count
+      };
+    });
+    return { items };
+  });
+  app.get("/api/persons/:id/profile", async (request, reply) => {
+    const id = request.params.id;
+    const profile = profiles.getPersonProfile(id, { includeEvidence: true, includeInferred: true });
+    if (!profile) {
+      reply.code(404);
+      return { ok: false, message: "\u6CA1\u6709\u627E\u5230\u8BE5\u6210\u5458\u3002" };
+    }
+    return profile;
+  });
+  app.get("/api/persons/:id/messages", async (request) => {
+    const id = request.params.id;
+    const limit = parseLimit2(request.query.limit, 50, 200);
+    const rows = database.prepare(
+      `SELECT m.id, m.platform, m.platform_message_id AS platformMessageId, m.sender_id AS senderId,
+        m.sender_name AS senderName, m.message_type AS messageType, m.text, m.sent_at AS sentAt,
+        c.name AS chatName, c.platform_chat_id AS platformChatId
+      FROM messages m
+      JOIN chats c ON c.id = m.chat_id
+      WHERE m.person_id = ?
+      ORDER BY m.sent_at DESC, m.created_at DESC
+      LIMIT ?`
+    ).all(id, limit);
+    return { items: rows };
+  });
+  app.post("/api/persons/:id/profile/entries/:entryId/correct", async (request, reply) => {
+    await tokenReady;
+    if (!isAuthorizedWebAction(request, webActionToken)) {
+      reply.code(403);
+      return { ok: false, message: "Web \u64CD\u4F5C\u672A\u6388\u6743\u3002" };
+    }
+    const { id, entryId } = request.params;
+    const existing = profiles.getProfileEntry(entryId);
+    if (!existing || existing.personId !== id || existing.status !== "active") {
+      reply.code(404);
+      return { ok: false, message: "\u6CA1\u6709\u627E\u5230\u8BE5\u6863\u6848\u6761\u76EE\u3002" };
+    }
+    const body = request.body;
+    const category = readStringField(body, "category") ?? existing.category;
+    const content = readStringField(body, "content");
+    const entryType = readStringField(body, "entryType") ?? existing.entryType;
+    const evidenceMessageId = readStringField(body, "evidenceMessageId");
+    const quote = readStringField(body, "quote");
+    const reason = readStringField(body, "reason") ?? "\u7528\u6237\u5728 Web UI \u663E\u5F0F\u4FEE\u6B63";
+    if (!content || !evidenceMessageId || !quote) {
+      reply.code(400);
+      return { ok: false, message: "\u4FEE\u6B63\u5FC5\u987B\u5305\u542B content\u3001evidenceMessageId \u548C quote\u3002" };
+    }
+    if (entryType !== "fact" && entryType !== "inferred") {
+      reply.code(400);
+      return { ok: false, message: "entryType \u5FC5\u987B\u662F fact \u6216 inferred\u3002" };
+    }
+    if (category === existing.category && content === existing.content) {
+      reply.code(400);
+      return { ok: false, message: "\u4FEE\u6B63\u5185\u5BB9\u6CA1\u6709\u53D8\u5316\u3002" };
+    }
+    const entryIdNew = profiles.replaceProfileEntry({
+      supersedeEntryId: entryId,
+      input: {
+        personId: id,
+        category,
+        content,
+        entryType,
+        confidence: Math.min(1, Math.max(0, readNumberField(body, "confidence", existing.confidence))),
+        source: "explicit_user_request",
+        evidence: [{ messageId: evidenceMessageId, quote, reason }]
+      }
+    });
+    return { ok: true, entryId: entryIdNew };
+  });
+  app.delete("/api/persons/:id/profile/entries/:entryId", async (request, reply) => {
+    await tokenReady;
+    if (!isAuthorizedWebAction(request, webActionToken)) {
+      reply.code(403);
+      return { ok: false, message: "Web \u64CD\u4F5C\u672A\u6388\u6743\u3002" };
+    }
+    const { id, entryId } = request.params;
+    const existing = profiles.getProfileEntry(entryId);
+    if (!existing || existing.personId !== id || existing.status !== "active") {
+      reply.code(404);
+      return { ok: false, message: "\u6CA1\u6709\u627E\u5230\u8BE5\u6863\u6848\u6761\u76EE\u3002" };
+    }
+    profiles.markProfileEntryDeleted(entryId);
+    return { ok: true };
+  });
   app.post("/api/process/messages", async (request, reply) => {
     await tokenReady;
     if (!isAuthorizedWebAction(request, webActionToken)) {