Skip to content

Commit b4aff2c

Browse files
authored
Merge pull request #451 from slow-stack/feat/persona-page
feat(persona): 人格定义页 v1——存储/API/开关/注入/面板五件套(beta,默认关)
2 parents 1920851 + 41043b2 commit b4aff2c

20 files changed

Lines changed: 867 additions & 11 deletions

‎dsh-mneme/lib/api-standalone.js‎

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -323,6 +323,37 @@ export function createStandaloneApi({ service, store, config = {}, logger, setti
323323
return;
324324
}
325325

326+
// --- GET /persona: agent persona(人格定义页,beta) --------------------
327+
if (req.method === "GET" && pathname === "/persona") {
328+
sendJson(res, 200, { persona: settings?.getPersona?.() ?? {} });
329+
return;
330+
}
331+
332+
// --- PUT /persona: replace the persona object ---------------------------
333+
// 写侧白名单挑拣在 setPersona 内(settings.js);坏 JSON 回 400(与
334+
// /memories 的写路径同口径),非对象体容错为空人格(面板可重写)。
335+
if (req.method === "PUT" && pathname === "/persona") {
336+
void readBody(req).then((text) => {
337+
let body;
338+
try {
339+
body = JSON.parse(text || "{}");
340+
} catch {
341+
sendJson(res, 400, { error: "invalid-json" });
342+
return;
343+
}
344+
const persona = body && typeof body === "object" && !Array.isArray(body) && body.persona && typeof body.persona === "object"
345+
? body.persona
346+
: body;
347+
try {
348+
settings?.setPersona?.(persona && typeof persona === "object" ? persona : {});
349+
sendJson(res, 200, { persona: settings?.getPersona?.() ?? {} });
350+
} catch {
351+
sendJson(res, 500, { error: "internal" });
352+
}
353+
});
354+
return;
355+
}
356+
326357
// --- GET /rules: agent behavior rules -----------------------------------
327358
if (req.method === "GET" && pathname === "/rules") {
328359
sendJson(res, 200, { rules: settings?.getRules?.() ?? [] });

‎dsh-mneme/lib/api.js‎

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -372,6 +372,42 @@ export function createApi(ctx, service, settings, commands, embedder, semantic =
372372
}
373373
});
374374

375+
// --- agent persona(人格定义页,beta) -------------------------------------
376+
// 形状照抄 /profile 路由(设计稿②):写方法走 requireAuth + readBody + parseBody;
377+
// setPersona 只挑白名单字段(settings.js PERSONA_FIELDS),坏体传非对象时
378+
// setPersona 容错为空人格——面板口径是「坏值显示为空可重写」,不 500。
379+
register({
380+
kind: "exact",
381+
path: "/api/dsh-mneme/persona",
382+
handler(req, res) {
383+
try {
384+
if (req.method === "PUT" || req.method === "POST") {
385+
if (!requireAuth(req, res, apiToken)) return;
386+
return readBody(req).then((text) => {
387+
// parseBody 对坏 JSON 回 {}(容错不抛),所以这里的守卫必须把
388+
// 「坏体解析成的 {}」与「真的传了 {persona:{}}」区分开:文本解析
389+
// 失败的体不该把人格清空。jsonOk=false 时保持库内现值原样回显。
390+
let body;
391+
let jsonOk = true;
392+
try {
393+
body = JSON.parse(text || "{}");
394+
} catch {
395+
body = {};
396+
jsonOk = false;
397+
}
398+
if (jsonOk && body && typeof body === "object") {
399+
settings.setPersona(body.persona && typeof body.persona === "object" ? body.persona : body);
400+
}
401+
sendJson(res, 200, { persona: settings.getPersona() });
402+
});
403+
}
404+
sendJson(res, 200, { persona: settings.getPersona() });
405+
} catch {
406+
sendJson(res, 500, { error: "internal" });
407+
}
408+
}
409+
});
410+
375411
// --- dream/sleep 模型连通性 + 模型发现(settings 面板)----------------------
376412
// Connectivity probe for a dream/sleep model route: runs one minimal LLM call
377413
// through the same harness path the consolidation uses and reports success /

‎dsh-mneme/lib/client.js‎

Lines changed: 123 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -281,6 +281,22 @@ window.__ModuleLoader__.load({
281281
"memory.settings.profileHint": "写一段自我介绍(角色、背景、偏好),Agent 每轮对话都会自动带上。",
282282
"memory.settings.profileSave": "保存画像",
283283
"memory.settings.profileSaved": "画像已保存",
284+
"memory.settings.persona": "人格定义(beta)",
285+
"memory.settings.personaHint": "给这位 Agent 一张角色卡:名字、性格、回复要求。开关打开且下方「人格定义」总闸开启时,每轮对话都会注入。",
286+
"memory.settings.personaName": "名字",
287+
"memory.settings.personaNamePlaceholder": "例如:Amarre",
288+
"memory.settings.personaPersonality": "性格设定",
289+
"memory.settings.personaPersonalityPlaceholder": "例如:轻松幽默,讲难题时用类比帮用户快速理解",
290+
"memory.settings.personaReplyStyle": "回复要求",
291+
"memory.settings.personaReplyStylePlaceholder": "例如:先给结论再解释;用人在用的词,不用机制名",
292+
"memory.settings.personaSave": "保存人格",
293+
"memory.settings.personaSaved": "人格已保存",
294+
"memory.settings.personaEnabledToggle": "启用这张人格卡",
295+
"memory.settings.personaView": "Agent 眼中的你(注入生效文本)",
296+
"memory.settings.personaViewHint": "以下是每一轮实际注入的用户画像与规则,只读。",
297+
"memory.settings.personaViewEmpty": "画像与规则均为空——Agent 每轮只会看到记忆库。",
298+
"memory.features.personaEnabled": "人格定义(beta)",
299+
"memory.features.personaEnabled.hint": "把「设置 → 个性化」里的人格卡注入到每轮对话。默认关(beta);总闸与人格卡内的开关同时打开才生效。",
284300
"memory.settings.rules": "规则",
285301
"memory.settings.rulesHint": "给 Agent 立下必须遵守的规矩,随时增删,下一轮即生效。",
286302
"memory.settings.ruleAdd": "添加规则",
@@ -928,6 +944,22 @@ window.__ModuleLoader__.load({
928944
"memory.settings.profileHint": "Describe yourself once — the agent reads it every turn.",
929945
"memory.settings.profileSave": "Save Profile",
930946
"memory.settings.profileSaved": "Profile saved",
947+
"memory.settings.persona": "Persona (beta)",
948+
"memory.settings.personaHint": "Give this agent a character card: name, personality, reply style. Injected every turn when the toggle below and the \"Persona\" master switch are both on.",
949+
"memory.settings.personaName": "Name",
950+
"memory.settings.personaNamePlaceholder": "e.g. Amarre",
951+
"memory.settings.personaPersonality": "Personality",
952+
"memory.settings.personaPersonalityPlaceholder": "e.g. relaxed and humorous; use analogies for hard topics",
953+
"memory.settings.personaReplyStyle": "Reply style",
954+
"memory.settings.personaReplyStylePlaceholder": "e.g. conclusion first; plain words over jargon",
955+
"memory.settings.personaSave": "Save Persona",
956+
"memory.settings.personaSaved": "Persona saved",
957+
"memory.settings.personaEnabledToggle": "Enable this persona card",
958+
"memory.settings.personaView": "You, as the agent sees you (injected text)",
959+
"memory.settings.personaViewHint": "The profile and rules actually injected every turn. Read-only.",
960+
"memory.settings.personaViewEmpty": "Profile and rules are both empty — the agent only sees the memory store.",
961+
"memory.features.personaEnabled": "Persona (beta)",
962+
"memory.features.personaEnabled.hint": "Inject the persona card (Settings → Personalization) into every turn. Off by default (beta); both this switch and the card's own toggle must be on.",
931963
"memory.settings.rules": "Rules",
932964
"memory.settings.rulesHint": "Rules the agent must follow — add or remove anytime, effective next turn.",
933965
"memory.settings.ruleAdd": "Add Rule",
@@ -2840,7 +2872,10 @@ window.__ModuleLoader__.load({
28402872
// enhance 末位」;可见层由 FEATURE_FIRST_SCREEN 决定(见其注释),
28412873
// 本轮已把组名提进首屏——组成员资格不决定可见性。
28422874
{ key: "group.mo", items: ["actionPipelineEnabled"] },
2843-
{ key: "group.enhance", items: ["entityExtractionEnabled", "codingRetrospect", "rerankEnabled", "resilientModelDownload", "searchSemanticDedup", "bm25SearchEnabled", "heatEnabled", "documentMemoryEnabled"] },
2875+
{ key: "group.enhance", items: ["entityExtractionEnabled", "codingRetrospect", "rerankEnabled", "resilientModelDownload", "searchSemanticDedup", "bm25SearchEnabled", "heatEnabled", "documentMemoryEnabled",
2876+
// 人格定义页(beta):注入总闸。分组随 enhance(行为开关,非座位闸门);
2877+
// 人格内容在设置页「个性化」区的人格卡。
2878+
"personaEnabled"] },
28442879
{ key: "group.dream", items: ["sleepModeEnabled"] },
28452880
// v0.8.0 A4(issue #17):作用域隔离组——标注总开关 + 严格硬过滤。
28462881
{ key: "group.scope", items: ["scopeEnabled", "strictScope"] }
@@ -3355,6 +3390,10 @@ window.__ModuleLoader__.load({
33553390
const [newCmd, setNewCmd] = react.useState({ name: "", description: "", instruction: "" });
33563391
const [saved, setSaved] = react.useState(false);
33573392
const [cmdError, setCmdError] = react.useState("");
3393+
// 人格卡(beta):name/personality/replyStyle 三字段草稿 + 卡内开关;
3394+
// provenance 是 v1.5 协作式人格的预留位,v1 只透传不编辑。
3395+
const [persona, setPersona] = react.useState({ name: "", personality: "", replyStyle: "", enabled: false });
3396+
const [personaSaved, setPersonaSaved] = react.useState(false);
33583397
const [vector, setVector] = react.useState({ enabled: false, baseUrl: "", apiKey: "", model: "" });
33593398
const [vectorSaved, setVectorSaved] = react.useState(false);
33603399
const [reindexing, setReindexing] = react.useState(false);
@@ -3415,16 +3454,25 @@ window.__ModuleLoader__.load({
34153454

34163455
const load = react.useCallback(async () => {
34173456
try {
3418-
const [p, r, c, v] = await Promise.all([
3457+
const [p, r, c, v, ps] = await Promise.all([
34193458
apiFetch("/api/dsh-mneme/profile").then((res) => res.json()),
34203459
apiFetch("/api/dsh-mneme/rules").then((res) => res.json()),
34213460
apiFetch("/api/dsh-mneme/commands").then((res) => res.json()),
3422-
apiFetch("/api/dsh-mneme/vector-config").then((res) => res.json())
3461+
apiFetch("/api/dsh-mneme/vector-config").then((res) => res.json()),
3462+
apiFetch("/api/dsh-mneme/persona").then((res) => res.json()).catch(() => null)
34233463
]);
34243464
setProfile(p.profile || "");
34253465
setRules(Array.isArray(r.rules) ? r.rules : []);
34263466
setCommands(Array.isArray(c.commands) ? c.commands : []);
34273467
setVector(v.config || { enabled: false, baseUrl: "", apiKey: "", model: "" });
3468+
// 人格卡:旧后端无 /persona(404)时保持默认空卡,不阻塞其它卡片
3469+
const pj = ps && ps.persona && typeof ps.persona === "object" ? ps.persona : {};
3470+
setPersona({
3471+
name: typeof pj.name === "string" ? pj.name : "",
3472+
personality: typeof pj.personality === "string" ? pj.personality : "",
3473+
replyStyle: typeof pj.replyStyle === "string" ? pj.replyStyle : "",
3474+
enabled: pj.enabled === true
3475+
});
34283476
} catch { /* ignore */ }
34293477
}, []);
34303478

@@ -3500,6 +3548,22 @@ window.__ModuleLoader__.load({
35003548
} catch { /* ignore */ }
35013549
}
35023550

3551+
// 人格卡保存:整对象 PUT(后端 setPersona 只挑白名单字段);saved 提示同
3552+
// profile 卡节奏(1.5s 自消)。
3553+
async function savePersona(next) {
3554+
try {
3555+
await apiFetch("/api/dsh-mneme/persona", {
3556+
method: "PUT",
3557+
headers: { "Content-Type": "application/json" },
3558+
body: JSON.stringify({ persona: next })
3559+
});
3560+
setPersonaSaved(true);
3561+
announce(t("memory.settings.personaSaved"));
3562+
setTimeout(() => setPersonaSaved(false), 1500);
3563+
} catch { /* ignore */ }
3564+
}
3565+
const setPersonaField = (key, value) => setPersona((c) => ({ ...c, [key]: value }));
3566+
35033567
async function putRules(next) {
35043568
await apiFetch("/api/dsh-mneme/rules", {
35053569
method: "PUT",
@@ -3681,7 +3745,7 @@ window.__ModuleLoader__.load({
36813745
}
36823746

36833747
return h("div", null,
3684-
// —— 个性化:画像 / 规则 / 自定义指令(Agent 怎么对你) ——
3748+
// —— 个性化:画像 / 人格 / 规则 / 自定义指令(Agent 怎么对你) ——
36853749
h("div", { className: "mneme-set-grouphead" }, t("memory.settings.group.personal")),
36863750
// 用户画像 — who the agent is talking to
36873751
h("section", { className: "mneme-set-card" },
@@ -3698,6 +3762,61 @@ window.__ModuleLoader__.load({
36983762
saved && h("span", { className: "mneme-saved" }, t("memory.settings.profileSaved"))
36993763
)
37003764
),
3765+
// 人格卡(beta)— who the agent is:名字/性格/回复要求 + 卡内开关。
3766+
// 卡内开关只是 persona.enabled 半边;总闸 personaEnabled 在功能开关的
3767+
// 「它什么时候写进去」组里,双闸同真才注入(设计稿④双层闸门)。
3768+
h("section", { className: "mneme-set-card" },
3769+
h("div", { className: "mneme-set-title" }, t("memory.settings.persona")),
3770+
h("div", { className: "mneme-set-desc" }, t("memory.settings.personaHint")),
3771+
h("div", { className: "mneme-set-row", style: { justifyContent: "space-between" } },
3772+
h("span", { className: "mneme-set-ruletext" }, t("memory.settings.personaEnabledToggle")),
3773+
h("input", {
3774+
type: "checkbox",
3775+
checked: persona.enabled === true,
3776+
"aria-label": t("memory.settings.personaEnabledToggle"),
3777+
onChange: (e) => {
3778+
const next = { ...persona, enabled: e.target.checked };
3779+
setPersona(next);
3780+
savePersona(next);
3781+
}
3782+
})
3783+
),
3784+
h("input", {
3785+
className: "mneme-set-input",
3786+
value: persona.name,
3787+
placeholder: t("memory.settings.personaNamePlaceholder"),
3788+
"aria-label": t("memory.settings.personaName"),
3789+
onChange: (e) => setPersonaField("name", e.target.value)
3790+
}),
3791+
h("textarea", {
3792+
className: "mneme-set-input mneme-set-input--area",
3793+
value: persona.personality,
3794+
placeholder: t("memory.settings.personaPersonalityPlaceholder"),
3795+
"aria-label": t("memory.settings.personaPersonality"),
3796+
onChange: (e) => setPersonaField("personality", e.target.value)
3797+
}),
3798+
h("textarea", {
3799+
className: "mneme-set-input mneme-set-input--area",
3800+
value: persona.replyStyle,
3801+
placeholder: t("memory.settings.personaReplyStylePlaceholder"),
3802+
"aria-label": t("memory.settings.personaReplyStyle"),
3803+
onChange: (e) => setPersonaField("replyStyle", e.target.value)
3804+
}),
3805+
h("div", { style: { display: "flex", alignItems: "center", gap: 8 } },
3806+
h("button", { className: "mneme-btn", onClick: () => savePersona(persona) }, t("memory.settings.personaSave")),
3807+
personaSaved && h("span", { className: "mneme-saved" }, t("memory.settings.personaSaved"))
3808+
)
3809+
),
3810+
// Agent 眼中的画像(只读)— 注入生效文本:profile + rules 原样展示。
3811+
// 纯前端拼接(GET 已在 load 里拿到 profile/rules),零后端新请求。
3812+
h("section", { className: "mneme-set-card" },
3813+
h("div", { className: "mneme-set-title" }, t("memory.settings.personaView")),
3814+
h("div", { className: "mneme-set-desc" }, t("memory.settings.personaViewHint")),
3815+
(profile.trim() || rules.length)
3816+
? h("pre", { className: "mneme-set-input mneme-set-input--area", style: { whiteSpace: "pre-wrap", minHeight: 0 } },
3817+
[profile.trim() ? "- " + profile.trim() : "", ...rules.map((r) => "- " + r)].filter(Boolean).join("\n"))
3818+
: h("div", { className: "mneme-xempty" }, t("memory.settings.personaViewEmpty"))
3819+
),
37013820
// 规则 — numbered rows, hover reveals the delete affordance
37023821
h("section", { className: "mneme-set-card" },
37033822
h("div", { className: "mneme-set-title" }, t("memory.settings.rules")),

‎dsh-mneme/lib/config.js‎

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -867,7 +867,18 @@ export const Config = z.object({
867867
// 它只是只读视图、不引入任何重型后台路径,轻量档用户显式勾选仍然赢(预设
868868
// 该关的是重型能力,不该替用户关掉一个纯 UI 入口)。
869869
// 也走 feature_flags(FEATURE_FLAG_BOOLEANS 白名单),面板可启停=线上回滚开关。
870-
actionPipelineEnabled: z.boolean().default(false)
870+
actionPipelineEnabled: z.boolean().default(false),
871+
872+
// --- 人格定义页(beta)---------------------------------------------------
873+
// 注入器渲染人格段的顶层总闸(双闸门的 config 半边;user_settings "persona"
874+
// 键内的 persona.enabled 是 per-agent 半边,两闸同真才渲染)。API 的 effective
875+
// 必须含这个键——schema 里没有它 effective 就静默少键,面板开关形同虚设
876+
// (#254 漏登记 NESTED_FLAG_PATHS 是同一个坑,计数锁 test/api.test.js 钉住)。
877+
// 默认关:beta 功能必须 opt-in,老用户行为逐字节不变。不进 LIGHT_MODE_OFF——
878+
// 人格段是用户自写的一小段轻量常驻文本,不引入任何重型后台路径,轻量档用户
879+
// 显式勾选仍然赢(同 actionPipelineEnabled 的定性)。
880+
// 也走 feature_flags(FEATURE_FLAG_BOOLEANS 白名单),面板可启停=线上回滚开关。
881+
personaEnabled: z.boolean().default(false)
871882
});
872883

873884
// Fields forced to false by the light-mode preset. Everything not listed here

‎dsh-mneme/lib/inject.js‎

Lines changed: 14 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -308,11 +308,24 @@ export function createInjector(ctx, service, settings, config, gate = null) {
308308

309309
// User profile + rules: injected ahead of the memory block because they are
310310
// always-relevant instructions the agent should follow every turn.
311+
// 人格段(beta):双闸门(config.personaEnabled && persona.enabled)开时渲染在
312+
// 最前——设计稿⑥:特化指令(人格)先出,画像与规则后出、后写覆盖占上风,
313+
// rules 恒最硬。任一闸关着时本函数输出与历史版本逐字节一致(老用户零变化,
314+
// test/persona-inject.test.js 锁住)。人格段非空即触发整块渲染(与 profile 同权)。
311315
function renderUserSettings() {
312316
const profile = settings.getProfile().trim();
313317
const rules = settings.getRules();
314-
if (!profile && !rules.length) return "";
318+
const persona = config?.personaEnabled === true ? settings.getPersona() : {};
319+
const personaLines = persona?.enabled === true
320+
? [
321+
...(typeof persona.name === "string" && persona.name.trim() ? [STR.personaNameLine[language](persona.name.trim())] : []),
322+
...(typeof persona.personality === "string" && persona.personality.trim() ? [STR.personaPersonalityLine[language](persona.personality.trim())] : []),
323+
...(typeof persona.replyStyle === "string" && persona.replyStyle.trim() ? [STR.personaReplyStyleLine[language](persona.replyStyle.trim())] : [])
324+
]
325+
: [];
326+
if (!profile && !rules.length && !personaLines.length) return "";
315327
const lines = [STR.userSettingsHeader[language]];
328+
lines.push(...personaLines);
316329
if (profile) lines.push(STR.profileLine[language](profile));
317330
for (const rule of rules) lines.push(STR.ruleLine[language](rule));
318331
return escapePromptVars(lines.join("\n"));

0 commit comments

Comments
 (0)