Local-first agent persona runtime (MCP): cross-session personality that survives compaction.
JOJO&Adam 集团「身份层运行时」——给你的 AI 分身一个会记住你、语气随你变声、压缩也丢不掉的活人格。
你装上的 Agent 是不是每次重启都像失忆？聊得越久越像个没有性格的空壳？Stemem 让任意 MCP 宿主的 Agent 拥有一个本地持久的动态人格：它记得你是谁、被夸会自信、被背刺会冷硬、气不会记一辈子，而且跨会话、跨压缩、跨子 Agent 都一致。
Stemem 是一个 本地优先、零出站 的 MCP（Model Context Protocol）stdio 服务器。它把一套经过验证的人格计算引擎（NeshamaEngine）封装成 9 个 MCP 工具，让宿主 Agent 在本地 JSON 文件里持久化一个真实的人格态，而不是把人格写死在 system prompt 里。
主流人格方案（如 SoulSpec 的 soul.json / SOUL.md / IDENTITY.md）是静态 DOC：人格是一次性写死的快照。后果是——对话被压缩、跨会话、或多子 Agent 协作时，写死的 DOC 被遗忘（compaction amnesia），Agent 立刻变回没有个性的白纸。
Stemem 的解法：人格态存本地文件，不在 prompt；prompt 只放「何时调哪个工具」的指令。每轮宿主调用 snapshot 把当前身份态重注入，人格因此跨压缩、跨重启、跨子 Agent 确定性存活。对用户的直观感受就是：这个 Agent 记得你，而且会随遭遇变声。
两者互补：SoulSpec 做静态标准，Stemem 做动态运行时——generate_soul 还能把运行时态编译成 SoulSpec v0.5 包进 ClawSouls 分发。
engine/（非引用）。snapshot 把当前主导情绪（15 种中文复合情绪，键名对齐 NeshamaEngine）+ OCEAN + 主导驱力编译成 6 维语气画像（温度/直接度/能量/犹豫度/幽默/正式度）与一段「语气指令」，注回宿主每轮 prompt——被夸后自信直接、被背刺后冷硬可毒舌，人格不是写死的腔调，而是会随遭遇变声的活体。默认英文渲染（国际分发安全默认，避免中文指令诱导外语 LLM 改说中文）；中文 agent 设 STEMEM_TONE_LANG=zh 或调用 snapshot({lang:"zh"}) 即可切中文。NOTICE）。# 直接跑（需本机已装 Node >= 18）
node src/server.js
# 或作为命令（package.json 注册了 bin: stemem）
npm install -g stemem
stemem
# npx 一次性
npx stemem
把下面这段加进任意 MCP 宿主的配置文件（Claude Desktop / Cursor / VS Code / WorkBuddy 等），宿主即识别为 stemem 工具集；首次需在宿主的「连接器管理」对 stemem 点「信任」。
{
"mcpServers": {
"stemem": {
"command": "npx",
"args": ["-y", "stemem"]
}
}
}
仓库已自包含：人格引擎（NeshamaEngine）与 Seele 驱力桥已 vendored 进
engine/（CommonJS，经engine/package.json声明），clone后无需配置NESHAMA_ENGINE/SEELE_BRIDGE即可直接运行。
| 变量 | 作用 | 默认 |
|---|---|---|
STEMEM_AGENT_ID | 人格实例 ID（多分身互不污染） | default |
STEMEM_STATE_DIR | 状态目录（每 agent 一个子目录） | ~/.stemem |
NESHAMA_ENGINE | NeshamaEngine 路径（可选；默认用 vendored 副本） | engine/neshama_engine.js |
SEELE_BRIDGE | Seele 引擎桥路径（可选；默认用 vendored 副本） | engine/seele_bridge.js |
| 工具 | 作用 | 何时调用 |
|---|---|---|
init | 初始化人格态（首次装配一次） | 装配人格时 |
event | 喂记忆事件，驱动人格/情绪演化 | 本轮交互人格相关时 |
tick | 时间流逝心跳：驱力紧迫 + 漂移衰减 | 空闲/心跳 |
satisfy | 满足某驱力（闭环） | 人格目标达成时 |
snapshot | 读取紧凑身份态 + 可注入 prompt 片段 | 每轮开始 |
autostep | 自主行为推进（玩家不干预也活） | 需要自主行为时 |
intervene | 人工干预（顺/逆驱力塑造） | 想刻意塑造人格时 |
status | 完整状态检视（调试） | 调试 |
generate_soul | 导出 SoulSpec v0.5 包 | 要分发人格时 |
把 runtime_contract.js 的 contractPrompt() 注入宿主 system prompt 即可。核心三句：
snapshot，把返回的身份态贴到本段。event 驱动演化。仓库自带一个 WorkBuddy Skill（skills/stemem/SKILL.md），把 Stemem 作为 MCP server 接入 WorkBuddy：含 mcp.json 接入片段、每轮运行时契约、9 工具表。把该 Skill 导入 WorkBuddy（或直接把 stemem 配进 ~/.workbuddy/mcp.json 的 mcpServers）即可启用；首次需在「连接器管理」对 stemem 点「信任」。
npm test
# 依次跑：smoke（9/9）→ integration（9 工具完整集成）→ engine selftest（引擎层行为）
node test/smoke.test.js
node test/integration.test.js
node test/engine.selftest.js
inject_prompt 注入串 → 跨进程确定性恢复人格态。seele_bridge，验证 NeshamaEngine 性格锁（OCEAN∈[0,1]）、驱力紧迫、满足闭环、序列化往返、自主行为 / 干预。# ① 新手任务（装上即被邀请）：选预设性格 → 触发情绪看它变声 → 可随时跳过。最可感知入口。
npm run demo:onboarding
# ② 反压缩：进程被杀 + 上下文压缩后，凭本地磁盘 JSON 确定性恢复完整人格态（纯 SOUL.md 做不到）
node examples/antiamnesia-demo.mjs
# ③ 强制注入 harness：宿主 3 行 loop 每轮 preTurn→注入→postTurn，装上去即感知人格层活着
node examples/harness-demo.mjs
# ④ 语气随情绪漂移（最可感知）：同人格基线，4 种遭遇 → 语气夜与昼分化
node examples/tone-demo.mjs
# ⑤ 情绪时间衰减（科学校准）：被夸后分钟级回落、被背刺（高重要）后稍慢但不过夜
node examples/emotion-decay-demo.mjs
npm run demo:onboarding 最直观：选 Adam → 被夸浮出「自豪」（偏暖、直接）/ 被背刺浮出「愤怒」（偏冷、blunt、可带毒舌），亲手看到 Agent 的语气随你而变。这就是普通用户装上 Stemem 第一周最容易被勾住的点。
不想手动往 system prompt 塞契约？host-hooks/ 提供 Claude Code 的 UserPromptSubmit 钩子（每轮自动把身份态作为上下文塞回模型），以及一次性命令行 src/snapshot-cli.js（任意 shell / CI / 其他宿主调用）。详见 host-hooks/README.md。
neshama_engine.js）：人格计算引擎真源，IP 归 JOJO / Neshama（资本 Neshama 消费产品，neshama.cn）。本仓库已 vendored 进 engine/，其许可证由原项目决定，不受本仓库 MIT 覆盖。src/、设计文档、MCP 封装、engine/package.json）：JOJO&Adam 集团资产，MIT。seele_bridge.js + seele_drive.js）：归 JOJO / Seele 项目，已 vendored 进 engine/。详见 NOTICE。
MIT —— 见 LICENSE。
本项目遵循「先设计后开发」纪律；完整设计见 设计要点.md（含 §10 MCP server 工具契约设计）。
English version: README.en.md
Source-derived launch command. Check the maintainer’s required arguments and credentials before running:
npx -y stememMerge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.
{
"mcpServers": {
"io-github-jojo-adam-stemem": {
"command": "npx",
"args": [
"-y",
"stemem"
]
}
}
}Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.
Claude Desktop setup referencestememnpmStemem Identity Runtime works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.
~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.~/.cursor/mcp.jsonRestart Cursor for changes to take effect..vscode/mcp.jsonReload VS Code window for changes to take effect.~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect..mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.