Files
agent/app/server/user-profile.js
T

140 lines
7.6 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
// 用户画像:一行一个登录用户(user_profiles 表),跨会话共享、按登录用户隔离;
// 未启用认证时即空串键的隐式单用户,功能不变。
//
// 设计原则(「只记不知道就会做错的信息」):
// - 存储封闭三字段 honorific/industry/preference;「近期关注」不入库,
// 仅在快照冻结时从该用户最近会话标题现取现拼,UI 不展示也不编辑。
// - 注入:会话创建/清空时把渲染文本冻结进 sessions.profile_snapshot,
// buildMessages 每轮以 system 后首条 user 消息注入——内容字节恒定不破坏前缀缓存,
// 且不落 messages 表,阶段切换归档/压缩都动不到它。
// - 更新:唯一提取时机是 enterExecuting(任务书落地、advising 轮尘埃落定),一次廉价模型调用;
// 当前画像随证据一起喂给模型,要求按【全量覆写】输出(见 profile-prompt.txt):没提的字段
// 原值拄回,明确被纠正的才改写/清空。服务端按字段覆写(空串 = 清),模型漏输出/解析失败的
// 字段保留旧值;不中途写、不定时投递写。
const { profileMessages, callModel } = require('./llm');
const log = require('./log');
const FIELDS = ['honorific', 'industry', 'preference'];
const MAX_FIELD = 80; // 字段长度帽:防模型把画像写成小作文
const RECENT_TITLES = 5;
const SNAPSHOT_HEAD = '【用户画像 · 背景参考】以下为历史会话沉淀的粗粒度认知,非任务约束;与当前请求冲突时,一律以当前请求为准。';
const FIELD_LABELS = { honorific: '称谓', industry: '行业', preference: '偏好' };
function readRow(db, user) {
return db.prepare('SELECT data, enabled FROM user_profiles WHERE user = ?').get(String(user || ''));
}
function readData(row) {
try { const d = JSON.parse((row && row.data) || '{}'); return d && typeof d === 'object' ? d : {}; }
catch (_) { return {}; }
}
function getProfile(db, user) {
const row = readRow(db, user);
const data = readData(row);
const out = { enabled: row ? !!row.enabled : true }; // 无行 = 默认启用(首次保存/提取前即此语义)
for (const k of FIELDS) out[k] = typeof data[k] === 'string' ? data[k] : '';
return out;
}
function writeRow(db, user, data, enabled) {
db.prepare(`
INSERT INTO user_profiles (user, data, enabled, updated_at) VALUES (?, ?, ?, ?)
ON CONFLICT(user) DO UPDATE SET data = excluded.data, enabled = excluded.enabled, updated_at = excluded.updated_at
`).run(String(user || ''), JSON.stringify(data), enabled ? 1 : 0, Date.now());
}
// UI PUT 入参规范化:只认白名单键;字符串压空白 + 截断;enabled 仅认显式布尔/0/1(缺省 = 不改)。
function sanitizePatch(body) {
const b = body && typeof body === 'object' ? body : {};
const patch = { fields: {}, enabled: undefined };
for (const k of FIELDS) {
if (typeof b[k] === 'string') patch.fields[k] = b[k].replace(/\s+/g, ' ').trim().slice(0, MAX_FIELD);
}
if (typeof b.enabled === 'boolean' || b.enabled === 0 || b.enabled === 1) patch.enabled = !!b.enabled;
return patch;
}
// 用户手动保存:字段照写(空串 = 清空,尊重显式操作)。
function saveProfile(db, user, patch) {
const row = readRow(db, user);
const data = readData(row);
for (const k of FIELDS) if (typeof patch.fields[k] === 'string') data[k] = patch.fields[k];
const enabled = patch.enabled === undefined ? (row ? !!row.enabled : true) : patch.enabled;
writeRow(db, user, data, enabled);
}
// 提取结果应用:全量覆写——parseExtraction 只收录了模型确实返回的字符串字段,
// 其中空串 = 按对话证据清除;未返回的字段(漏输出/胡输出)不收录,保留旧值。
// 返回实际变化的字段名(无变化不写库、不刷 updated_at)。
function mergeExtraction(db, user, parsed) {
const row = readRow(db, user);
const data = readData(row);
const changed = [];
for (const k of FIELDS) {
const v = parsed[k]; // undefined = 模型没给这个字段 → 不动;'' = 显式清除
if (typeof v === 'string' && v !== (typeof data[k] === 'string' ? data[k] : '')) { data[k] = v; changed.push(k); }
}
if (changed.length) writeRow(db, user, data, row ? !!row.enabled : true);
return changed;
}
// 提取回合喂给模型的【Current profile】文本:三键定序,空值渲染 (empty)。
function profileForExtraction(p) {
return FIELDS.map(k => k + ' = ' + (p[k] ? JSON.stringify(p[k]) : '(empty)')).join('\n');
}
// 渲染注入文本:三字段(非空才成行)+ 现取的近期关注;停用或全空 → 空串(不注入)。
function snapshotText(db, user, excludeSessionId) {
const p = getProfile(db, user);
if (!p.enabled) return '';
const lines = [];
for (const k of FIELDS) if (p[k]) lines.push('- ' + FIELD_LABELS[k] + ':' + p[k]);
const titles = db.prepare(
"SELECT title FROM sessions WHERE user = ? AND id != ? AND title IS NOT NULL AND title != '' ORDER BY updated_at DESC LIMIT " + RECENT_TITLES
).all(String(user || ''), String(excludeSessionId || '')).map(r => r.title);
if (titles.length) lines.push('- 近期关注:' + titles.join(';'));
return lines.length ? SNAPSHOT_HEAD + '\n' + lines.join('\n') : '';
}
// 会话创建/清空时冻结画像快照。失败静默(大不了这轮不注入,不影响建会话/清空主流程)。
function freezeSnapshot(db, sessionId) {
try {
const s = db.prepare('SELECT user FROM sessions WHERE id = ?').get(sessionId);
if (!s) return;
db.prepare('UPDATE sessions SET profile_snapshot = ? WHERE id = ?').run(snapshotText(db, s.user, sessionId), sessionId);
} catch (e) { log.warn('profile', '画像快照冻结失败(忽略):' + (e && e.message || e)); }
}
// 提取输出解析:剥 ``` 围栏、JSON.parse、只取白名单字段(同样截断)。解析失败返回 null。
function parseExtraction(content) {
let text = String(content || '').trim();
const fence = /^```[a-zA-Z]*\r?\n?([\s\S]*?)\r?\n?```$/.exec(text);
if (fence) text = fence[1].trim();
if (!text.startsWith('{')) { const m = /\{[\s\S]*\}/.exec(text); if (m) text = m[0]; }
let obj;
try { obj = JSON.parse(text); } catch (_) { return null; }
if (!obj || typeof obj !== 'object') return null;
const out = {};
for (const k of FIELDS) if (typeof obj[k] === 'string') out[k] = obj[k].replace(/\s+/g, ' ').trim().slice(0, MAX_FIELD);
return out;
}
// advising→executing 落槌处调用的一次提取更新:fire-and-forget,永不抛出。
// 不传 key_slot:旁路调用回落到该模型首个 key 副本,避免与在跑的回合抢同一槽限流(失败本就静默)。
async function runExtraction(db, cfg, ctx) {
try {
const { sessionId, user, modelId, historyRows, briefText } = ctx || {};
const p = getProfile(db, user);
if (!modelId || !p.enabled) return;
if (!(historyRows || []).length || !String(briefText || '').trim()) return;
const msgs = profileMessages(historyRows, (cfg.agent || {}).language, profileForExtraction(p), briefText);
const r = await callModel(cfg, modelId, msgs, null, {});
const parsed = parseExtraction(r && r.content);
if (!parsed) { log.debug('profile', '提取输出不可解析,忽略:' + sessionId); return; }
const changed = mergeExtraction(db, user, parsed);
log.info('profile', '画像' + (changed.length ? '更新 ' + (user || '-') + ':' + changed.join(',') : '无变化') + ' ←' + sessionId);
} catch (e) { log.warn('profile', '画像提取失败(忽略):' + (e && e.message || e)); }
}
module.exports = { getProfile, sanitizePatch, saveProfile, snapshotText, freezeSnapshot, runExtraction };