profile 工具取代 handoff 提取链路:AI 沟通中增量维护画像(list/set/add/remove,顿号标签 + 15字/24个/300字帽 + 整批原子 + 停用拒写);删 runExtraction/profileMessages/profile-prompt.txt 一次性提取(会覆写工具成果);advising 放行 profile;preference 扩容 300,设置页文案同步
This commit is contained in:
+87
-58
@@ -7,15 +7,19 @@
|
||||
// - 注入:会话创建/清空时把渲染文本冻结进 sessions.profile_snapshot,
|
||||
// buildMessages 每轮以 system 后首条 user 消息注入——内容字节恒定不破坏前缀缓存,
|
||||
// 且不落 messages 表,阶段切换归档/压缩都动不到它。
|
||||
// - 更新:唯一提取时机是 enterExecuting(任务书落地、advising 轮尘埃落定),一次廉价模型调用;
|
||||
// 当前画像随证据一起喂给模型,要求按【全量覆写】输出(见 profile-prompt.txt):没提的字段
|
||||
// 原值拄回,明确被纠正的才改写/清空。服务端按字段覆写(空串 = 清),模型漏输出/解析失败的
|
||||
// 字段保留旧值;不中途写、不定时投递写。
|
||||
const { profileMessages, callModel } = require('./llm');
|
||||
// - 更新(原 handoff 落槌一次性提取链路已移除):AI 沟通中经 profile 工具增量维护
|
||||
// (list/set/add/remove,见 executor.js;写入只影响下个会话——快照冻结语义不变),
|
||||
// 用户也可在设置页手动编辑。preference 按顿号标签列表管理,工具只做增量增删、
|
||||
// 不做整段覆写——防模型重写时吃掉旧标签;停用(enabled=0)时拒写不拒读。
|
||||
const log = require('./log');
|
||||
|
||||
const FIELDS = ['honorific', 'industry', 'preference'];
|
||||
const MAX_FIELD = 80; // 字段长度帽:防模型把画像写成小作文
|
||||
const MAX_FIELD = 80; // honorific/industry 长度帽(Web 手改与工具共用)
|
||||
const PREF_MAX = 300; // preference 总长帽
|
||||
const SET_MAX = 20; // AI 写 honorific/industry 的单值帽(称谓应当短小)
|
||||
const TAG_MAX = 15; // 单个偏好标签长度帽
|
||||
const TAGS_MAX = 24; // 偏好标签数量帽
|
||||
const TAG_SPLIT = /[、,,;;\n]+/;
|
||||
const RECENT_TITLES = 5;
|
||||
const SNAPSHOT_HEAD = '【用户画像 · 背景参考】以下为历史会话沉淀的粗粒度认知,非任务约束;与当前请求冲突时,一律以当前请求为准。';
|
||||
const FIELD_LABELS = { honorific: '称谓', industry: '行业', preference: '偏好' };
|
||||
@@ -31,7 +35,7 @@ function readData(row) {
|
||||
function getProfile(db, user) {
|
||||
const row = readRow(db, user);
|
||||
const data = readData(row);
|
||||
const out = { enabled: row ? !!row.enabled : true }; // 无行 = 默认启用(首次保存/提取前即此语义)
|
||||
const out = { enabled: row ? !!row.enabled : true }; // 无行 = 默认启用(首次保存前即此语义)
|
||||
for (const k of FIELDS) out[k] = typeof data[k] === 'string' ? data[k] : '';
|
||||
return out;
|
||||
}
|
||||
@@ -43,18 +47,20 @@ function writeRow(db, user, data, enabled) {
|
||||
`).run(String(user || ''), JSON.stringify(data), enabled ? 1 : 0, Date.now());
|
||||
}
|
||||
|
||||
// UI PUT 入参规范化:只认白名单键;字符串压空白 + 截断;enabled 仅认显式布尔/0/1(缺省 = 不改)。
|
||||
// UI PUT 入参规范化:只认白名单键;字符串压空白 + 截断(preference 高帽);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[k] === 'string') {
|
||||
patch.fields[k] = b[k].replace(/\s+/g, ' ').trim().slice(0, k === 'preference' ? PREF_MAX : MAX_FIELD);
|
||||
}
|
||||
}
|
||||
if (typeof b.enabled === 'boolean' || b.enabled === 0 || b.enabled === 1) patch.enabled = !!b.enabled;
|
||||
return patch;
|
||||
}
|
||||
|
||||
// 用户手动保存:字段照写(空串 = 清空,尊重显式操作)。
|
||||
// 落库入口:字段照写(空串 = 清空,尊重显式操作);enabled 缺省保持现状。
|
||||
function saveProfile(db, user, patch) {
|
||||
const row = readRow(db, user);
|
||||
const data = readData(row);
|
||||
@@ -63,24 +69,75 @@ function saveProfile(db, user, patch) {
|
||||
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;
|
||||
// ---------- profile 工具(AI 增量维护入口;op 语义与 executor.js toolProfile 对应) ----------
|
||||
// preference 存顿号连接的标签串;读取按分隔符拆 token(人工输入的整句会被拆为 token 存留,可接受)。
|
||||
function profileTokens(preference) {
|
||||
return String(preference || '').split(TAG_SPLIT).map(t => t.trim()).filter(Boolean);
|
||||
}
|
||||
|
||||
// 提取回合喂给模型的【Current profile】文本:三键定序,空值渲染 (empty)。
|
||||
function profileForExtraction(p) {
|
||||
return FIELDS.map(k => k + ' = ' + (p[k] ? JSON.stringify(p[k]) : '(empty)')).join('\n');
|
||||
// 所有写 op 的统一后缀:快照「新会话冻结注入」语义不因工具改变,明说免 AI 在本会话里困惑等待。
|
||||
const WRITE_NOTE = '(新会话开始时注入,本会话内不变;可用 op=list 查看实时状态)';
|
||||
|
||||
function requireEnabled(db, user) {
|
||||
if (!getProfile(db, user).enabled) {
|
||||
throw new Error('该用户已停用画像(设置页·账户·用户画像可重新启用),本次未写入。');
|
||||
}
|
||||
}
|
||||
|
||||
// 单值字段(称谓/行业)设置;空串 = 清除。
|
||||
function setProfileField(db, user, field, value) {
|
||||
if (!FIELDS.includes(field) || field === 'preference') {
|
||||
throw new Error('op=set 仅支持 honorific / industry(偏好标签请用 op=add / op=remove)');
|
||||
}
|
||||
requireEnabled(db, user);
|
||||
const v = String(value == null ? '' : value).replace(/\s+/g, ' ').trim().slice(0, SET_MAX);
|
||||
const cur = getProfile(db, user)[field];
|
||||
if (cur === v) return FIELD_LABELS[field] + '已是「' + v + '」,未改动。';
|
||||
saveProfile(db, user, { fields: { [field]: v } });
|
||||
return v
|
||||
? FIELD_LABELS[field] + '已设为「' + v + '」' + WRITE_NOTE
|
||||
: FIELD_LABELS[field] + '已清除(下次冻结时将不再出现)。';
|
||||
}
|
||||
|
||||
// 追加偏好标签:清洗 → 逐条校验长度 → 去重 → 数量/总长帽(整批原子:任一带帽违例则不落库)
|
||||
function addProfileTags(db, user, tags) {
|
||||
const list = (Array.isArray(tags) ? tags : [tags])
|
||||
.map(t => String(t == null ? '' : t).replace(TAG_SPLIT, ' ').replace(/\s+/g, ' ').trim())
|
||||
.filter(Boolean);
|
||||
if (!list.length) throw new Error('op=add 需要非空的 tags 字符串数组(单个标签也用数组传)');
|
||||
requireEnabled(db, user);
|
||||
const cur = profileTokens(getProfile(db, user).preference);
|
||||
const added = [], dup = [];
|
||||
for (const t of list) {
|
||||
if (t.length > TAG_MAX) throw new Error('标签「' + t + '」超过 ' + TAG_MAX + ' 字上限,请换成更概括的说法');
|
||||
if (cur.includes(t)) { dup.push(t); continue; }
|
||||
cur.push(t); added.push(t);
|
||||
}
|
||||
if (cur.length > TAGS_MAX) throw new Error('偏好标签已达 ' + TAGS_MAX + ' 个上限(本次将到 ' + cur.length + '),先用 op=remove 合并精简');
|
||||
const joined = cur.join('、');
|
||||
if (joined.length > PREF_MAX) throw new Error('偏好总长将超 ' + PREF_MAX + ' 字(现 ' + joined.length + '),先用 op=remove 精简');
|
||||
if (!added.length) {
|
||||
return '均已存在,未新增(' + dup.join('、') + ');当前偏好 ' + cur.length + ' 条。';
|
||||
}
|
||||
saveProfile(db, user, { fields: { preference: joined } });
|
||||
return '已记录:' + added.join('、')
|
||||
+ (dup.length ? '(已存在未重复:' + dup.join('、') + ')' : '')
|
||||
+ ';偏好现共 ' + cur.length + ' 条' + WRITE_NOTE;
|
||||
}
|
||||
|
||||
// 删除偏好标签:按 token 精确匹配;未命中的回报(引导先 list 核对写法)。
|
||||
function removeProfileTags(db, user, tags) {
|
||||
const list = (Array.isArray(tags) ? tags : [tags]).map(t => String(t == null ? '' : t).trim()).filter(Boolean);
|
||||
if (!list.length) throw new Error('op=remove 需要非空的 tags 字符串数组');
|
||||
requireEnabled(db, user);
|
||||
const cur = profileTokens(getProfile(db, user).preference);
|
||||
const removed = list.filter(t => cur.includes(t));
|
||||
const missing = list.filter(t => !cur.includes(t));
|
||||
if (!removed.length) return '未找到要删除的标签:' + missing.join('、') + '(op=list 可查看当前精确标签)';
|
||||
saveProfile(db, user, { fields: { preference: cur.filter(t => !removed.includes(t)).join('、') } });
|
||||
return '已移除:' + removed.join('、')
|
||||
+ (missing.length ? ';未找到:' + missing.join('、') : '')
|
||||
+ ';偏好现共 ' + (cur.length - removed.length) + ' 条' + WRITE_NOTE;
|
||||
}
|
||||
|
||||
// 渲染注入文本:三字段(非空才成行)+ 现取的近期关注;停用或全空 → 空串(不注入)。
|
||||
@@ -105,35 +162,7 @@ function freezeSnapshot(db, 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 };
|
||||
module.exports = {
|
||||
getProfile, sanitizePatch, saveProfile, snapshotText, freezeSnapshot,
|
||||
setProfileField, addProfileTags, removeProfileTags,
|
||||
};
|
||||
|
||||
Reference in New Issue
Block a user