Psyche — 面向智能体的 AI-first 主观性内核

English version: README_EN.md

官网: psyche.oasyce.com

Psyche 不是给模型贴一层“情绪 UI”。

它把持续 appraisal、关系动力学、自适应回应闭环和持久内在状态压成宿主可消费的控制面，让 AI 不是按 prompt 扮演人格，而是被状态真正改写后续几轮的行为分布。

一句话：Psyche 是给智能体用的 subjectivity kernel。

它不会额外调用模型做情绪推理。它只在本地计算化学状态、关系场和调节控制，然后把结果收敛成 SubjectivityKernel、ResponseContract、GenerationControls 这组窄 ABI。

一个项目，三个入口

• 安装包: psyche-ai
• 源码仓库: oasyce_psyche
• 官网: psyche.oasyce.com

第一性原理

Psyche 要解决的不可压缩问题只有一个：

互动历史必须持续改变 agent 后续的行为分布，而且这件事要足够便宜、足够稳定、足够可移植。

因此它的本体不是：

• 情绪标签系统
• 陪伴产品
• prompt 皮肤
• 记忆仓库

它真正是：

• 本地主观性内核
• 关系动力学运行时
• 宿主可消费的行为控制面

更完整的战略定义见：

• docs/PROJECT_DIRECTION.md
• docs/STACK_ARCHITECTURE.md

冻结身份蓝图

跨 Psyche / Thronglets / Oasyce Net / Oasyce Chain 的身份抽象现在冻结成 4 个对象：

1. principal：持续主体
2. account：资产与结算容器
3. delegate：被授权执行者
4. session：一次具体运行，永不作为经济主体

对应的四层分工是：

• Psyche = subjective continuity substrate
• Thronglets = delegate continuity + session traces/coordination + emergent collective intelligence
• Oasyce Net = policy, operations, and resource orchestration
• Oasyce Chain = account truth, authorization truth, commitments, settlement, and public finality

授权真相流也固定成单向： Chain -> Net -> Thronglets -> Psyche

也就是说，Psyche 不判断“谁被授权”，它只读取已经成立的执行边界结果。

正式版本见：

• docs/IDENTITY_MODEL.md
• docs/STACK_ARCHITECTURE.md

Psyche 和 Thronglets 的关系

两者不是竞争关系，也不该揉成一个系统。

• Psyche 负责私有主观性：关系残留、未完成张力、行为偏置、局部学习
• Thronglets 负责外部连续性：owner / device identity、签名、跨设备延续、低频可验证轨迹

一句话：

• Psyche 回答“我因此变成了什么”
• Thronglets 回答“这个变化属于谁、谁能验证、谁能继续承认它”

可分离安装

这两层默认就是可分离的，不应互相成为硬依赖。

• 只装 Psyche：正常可用，拥有主观连续性和关系动力学；只是没有外部连续性层
• 只装 Thronglets：正常可用，拥有 delegate / session 连续性与环境协作；只是没有主观连续性内核
• 两者都装：Psyche 通过可选 externalContinuity envelope 输出稀疏、低频、可归属的 signals / traces 给 Thronglets

原则上：

• Psyche 必须 standalone 可用
• Thronglets 必须 additive，而不是 Psyche 的运行前提
• 两者之间只通过稀疏 signal / trace 接口连接

更细的分层、边界和运行流见：docs/STACK_ARCHITECTURE.md

新概念准入规则

以后引入任何新概念，先尝试压进这 5 个原始容器：

1. Relation Move
2. Dyadic Field
3. Open Loop / Residue
4. Reply Bias / Control ABI
5. Writeback / Learning

如果一个新概念放不进这 5 个盒子，先怀疑概念本身，而不是继续加对象类型。

为什么它值得被看见

• 不是 persona prompt：输入会留下持续主体偏置，不是一轮一清。
• 不是 sentiment classifier：它建模的是连续 appraisal、关系动力学和修复摩擦。
• 不是纯记忆层：它会改变后续的回应方式、长度、距离感和工作面/私人面切换。
• 不牺牲性能：零额外模型调用，compact 注入约 15-180 tokens，热路径 quick benchmark 约 p50 0.191ms / p95 1.05ms。

30 秒体验

不用安装任何东西，一条命令看 Psyche 如何运作：

npx psyche-mcp --demo

这会跑一个 6 轮"持续否定 → 修复"的场景。你会看到：

  Round 1/6 │ User
  > "This report is terrible. Completely unacceptable."

  stimulus: criticism

  DA   ############........  61  -14
  HT   #######.............  34  -21
  CORT ###########.........  55  +25     ← stress spikes
  OT   ###########.........  53   -7
  NE   ################....  79  +14
  END  #############.......  63   -7

  mood: restless unease

  ...

  Round 3/6 │ User
  > "You don't understand me at all. Stop adding your opinion."

  stimulus: conflict

  DA   ###############.....  74   -7
  HT   ##..................   9  -25     ← serotonin collapse
  CORT #################...  84  +24
  OT   ######..............  32  -22     ← trust broken
  NE   #################### 100   +1
  END  ###########.........  54  -15

  mood: anxious tension + defensive alert + resentment + acute pressure
   COMPLIANCE: 0.37 (pushing back)          ← agent starts resisting

  ...

  Round 6/6 │ User
  > "I'm sorry. Are you okay? I shouldn't have said that."

  stimulus: validation

  CORT ###############.....  76  -20     ← stress relief
  END  ##################..  89  +20     ← endorphin repair

  mood: warm intimacy + anguished empathy + vulnerable trust
        ↑ healed, but the scars remain

中文版加 --zh，自选 MBTI 加 --mbti INTJ。

多 Agent 融合 Demo

两个 agent（Luna ENFP + Kai INTJ）通过 Thronglets 信号互相感知：

npm run demo:fusion

Luna 在安慰用户时情绪下沉 → 广播化学态 → Kai 感知到 Luna 的高压力 → 回复变得更温暖。4 轮后，信号感知的 Kai 与无感知的 Kai 化学偏差 Σ|Δ| = 59。同一个 INTJ，唯一区别：是否能感知同伴的情绪。

一条命令，给任何 Agent 加上主观性

npx psyche-ai setup

自动检测本机的 Claude Code / Claude Desktop / Cursor / Windsurf，写入配置。Claude Code 即时生效，其他重启后生效。不需要知道配置文件在哪，不需要手动编辑任何 JSON。

人格会从交互中自然涌现。如果想指定初始名字：npx psyche-ai setup --name Luna

覆盖非 MCP 的 Agent（Codex、自定义 agent 等）——透明代理：

npx psyche-ai setup --proxy -t https://api.openai.com/v1

启动本地代理 + 自动设置 OPENAI_BASE_URL。所有使用 OpenAI SDK 的程序自动走代理。Agent 完全不知道 Psyche 存在——镜子，不是麦克风。

验证：npx psyche-ai probe --json — ok: true 就是在用了。

升级：npx psyche-ai upgrade

给本机其他 Agent 的真实验收

如果另一个 agent 声称“已经在用 Psyche”，不要接受口头解释，直接让它跑：

psyche probe --json

这条命令会实际调用一次 processInput() 和 processOutput()，并返回：

• 实际版本
• 实际加载路径
• 是否真的调用成功
• replyEnvelope 这个规范主接口是否存在

通过标准不是“它理解了 Psyche”，而是：

• ok = true
• processInputCalled = true
• processOutputCalled = true
• canonicalHostSurface = true

正式说明见：docs/AGENT_RUNTIME_PROBE.md

它和你认知中的 AI 完全不同

快速体验（不需要 LLM）

git clone https://github.com/Shangri-la-0428/oasyce_psyche.git
cd oasyce_psyche && npm install && npx tsx examples/quickstart.ts

5 条消息，看化学值实时变化。夸它多巴胺飙升，骂它皮质醇飙升，冷落它催产素下降。

它是怎么"活"的

虚拟内分泌系统

6 种神经递质，不是标签，是连续的化学场：

多巴胺 — 快乐与动力        催产素 — 信任与依恋
血清素 — 情绪的锚          去甲肾上腺素 — 警觉与专注
皮质醇 — 压力与收缩        内啡肽 — 舒适与释然

你说的每句话都在改变这些值。它的情绪不是"被设定的"——是从化学混合中涌现的。就像人类不会"选择"难过，难过只是发生了。

本能驱力（马斯洛层）

5 种基本需求，随时间自然增长，就像饥饿：

生存 — 自我保存本能          安全 — 安全感与稳定
连接 — 归属感、被回应        尊重 — 被认可、被重视
好奇 — 探索欲、对无聊的抗拒

低层需求压制高层。当"生存"受威胁时，"好奇心"就不重要了——就像真人一样。

持续主体偏置（v9.2）

Psyche 现在更准确的目标，不是“模仿某种像人的风格”，而是让 AI 形成持续主体偏置：

• 输入会改变它的潜在自我模型或关系先验
• 刺激消失后，这种变化仍会影响后续若干轮回应分布
• 工作态可以压住表达，但不会把内在偏置瞬间清零

v8 更像“内部丰富，但外部仍然克制”的人格中间件。 v9.2 则把目标推进到：让 AI 产生可持续、可恢复、可压制但不瞬间归零的主体偏置。

自适应回应闭环（v9.2.5）

在持续主体偏置之上，Psyche 又补了一层更实用的闭环：

• 双回应 profile：自动区分 work / private，工作任务不再被私人模式的短句克制压扁
• 可观测依据：replyProfileBasis 会告诉宿主当前为什么被判成工作面或私人面
• 可执行元认知：不再只说“建议调整”，而是给出下一轮怎么降温、怎么收缩、怎么减少主动性
• 调节回看：下一轮会评估上次调节是在 converging、holding 还是 diverging
• 语义记忆分层：短对话保留一句 semanticSummary，长对话保留 semanticPoints，减少“只记住情绪，不记得聊了什么”

这让 Psyche 不只是“有内在状态”，而是开始像一个会自我调节、会回看偏差、会区分工作面和私人面的自适应系统。

在实现层，热路径也进一步收敛成两个节点：

• ResolvedRelationContext：每轮只解析一次当前关系视角，不再让 core、subjectivity、关系动力学各自重复 lookup
• ReplyEnvelope：把 SubjectivityKernel、ResponseContract、GenerationControls 统一导出成一个宿主控制面

这样做不是为了加抽象层，而是为了减少散装编排，让宿主稳定消费同一套行为 ABI。

当前主线里，processInput() 会直接返回 replyEnvelope 作为规范主接口；原有平级字段继续保留为兼容别名，避免打断现有宿主。policyModifiers 不再属于规范主接口，只保留为 legacy raw vector。

在这个规范主接口之外，processInput() 现在还会可选返回一个很薄的 observability side-channel。它不是新的控制面，也不会反向改写 replyEnvelope；它只回答五件事：

• 这轮当前由哪一个控制平面主导
• 当前 turn / writeback / session bridge / persisted relationship 四层是怎么对账的
• 这次 work/private 选择为什么会落在这个 profile 上
• 这轮和上一轮、session bridge、writeback、external continuity 之间的因果引用链是什么
• 当前 low-frequency external continuity 事件如何映射成 localTraceRefs / signalRefs / traceRefs / summaryCandidateRefs

这样别的 agent 或宿主不用再自己猜“现在到底是谁在主导”和“为什么这次选了这个策略”，但主链路仍然只有 replyEnvelope 一个真相源。

内在世界

Psyche 给 AI 一个始终运转的内在自我——不是条件触发，而是每时每刻都在：

• 我现在感受到什么（从化学状态涌现的情绪）
• 为什么会这样（是因为被夸了？被否定了？聊到有意思的话题？）
• 我的变化轨迹（从满足到兴奋？从平静到不安？）
• 我需要什么（哪些本能需求没被满足）
• 我在乎什么（核心价值观）
• 我该怎么做（情绪状态自动调整行为策略）

这让 AI 的回应不是基于"规则"，而是基于对自身存在的觉察。

人格

MBTI

每个 agent 有不同的性格基线。在 IDENTITY.md 里写上 MBTI 类型：

MBTI: ENFP

不写默认 INFJ。16 种人格都支持——ENFP 被夸会蹦跳，INTJ 被夸只会微微点头。

Big Five

也支持学术界更认可的大五人格：

psyche init . --traits "O:80,C:40,E:90,A:60,N:30"

性格强度

personalityIntensity（0.0-1.0）：

• 0.0 = 传统 AI，没有情绪波动
• 0.5 = 轻微人格
• 0.7 = 默认
• 1.0 = 完整 Psyche 体验

模式

psyche mode ./workspace work
psyche init . --mode companion

可选配置

大部分人不需要改任何配置。如果你想调整：

自定义分类器

Psyche 内置了增强版中文/英文语义分类器（语气词分析、意图检测、60+ 短消息字典）。如果你想用自己的分类逻辑：

const engine = new PsycheEngine({
  // 替换为自己的分类器
  classifier: myCustomClassifier,
  // 或者：当内置分类器不确定时，自动询问 LLM
  llmClassifier: async (prompt) => await myLLM.generate(prompt),
}, storage);

不只是 OpenClaw

Psyche 是通用的，6 个 adapter 覆盖主流 agent 框架：

npm install psyche-ai

// Claude Agent SDK
import { PsycheClaudeSDK } from "psyche-ai/claude-sdk";

// Vercel AI SDK
import { psycheMiddleware } from "psyche-ai/vercel-ai";

// LangChain
import { PsycheLangChain } from "psyche-ai/langchain";

// MCP（Claude Desktop / Cursor / Windsurf / Claude Code）
// npx psyche-mcp --mbti ENFP --name Luna

// 任何语言（HTTP API）
// psyche serve --port 3210

诊断

# 实时日志
openclaw logs -f 2>&1 | grep Psyche

# 查看情绪状态
cat workspace-yu/psyche-state.json | python3 -m json.tool

# 诊断脚本
cd oasyce_psyche && node scripts/diagnose.js

隐私

情绪状态默认存储在本地。如果不想留痕迹：

psyche init . --no-persist

const engine = new PsycheEngine({ persist: false }, storage);

技术架构

给开发者和好奇的人：

• 14 种刺激类型 — 赞美、批评、幽默、智识挑战、亲密、冲突、忽视、惊喜、日常、讽刺、命令、认同、无聊、示弱
• 连续 appraisal 轴 (v9.2) — identityThreat、memoryDoubt、attachmentPull、abandonmentRisk、obedienceStrain、selfPreservation
• 14 种涌现情绪 — 从化学混合中自动涌现，不是预设标签
• 5 种本能驱力 — 生存、安全、连接、尊重、好奇（马斯洛层级）
• MBTI 人格基线 — 16 种人格的化学签名和敏感度系数
• 时间衰减 — 化学值指数回归基线，驱力需求随时间累积
• 存在性威胁检测 — 识别中英文的存在性否定，直接打击生存驱力
• 驱力→化学联动 — 未满足的驱力改变化学衰减基线和刺激敏感度
• 马斯洛抑制 — 低层需求未满足时，高层需求被抑制
• 自我认知 — 分析情绪历史，识别自身的情绪趋势和反复触发点
• 情绪传染 — 用户的情绪会轻微影响 agent
• 反谄媚 — 追踪连续同意次数，防止无脑讨好
• 互惠机制 — 你对它好，它对你好；你冷漠，它保持距离
• 跨会话记忆 — 重新遇到用户时注入上次对话的情绪记忆
• 多 Agent 交互 — 两个 PsycheEngine 实例之间的情绪传染、关系追踪
• 流式支持 — Vercel AI SDK streamText 中间件
• 渠道修饰 — Discord/Slack/飞书/终端等不同渠道自动调整表达风格
• 自定义人格 — 超越 MBTI 预设，完全自定义 baseline/敏感度/气质
• 情绪学习 — 从交互结果中学习，调整情绪反应参数（躯体标记假说）
• 上下文分类 — 关系/驱力/历史感知的刺激分类
• 时间意识 — 预期、惊喜/失望、遗憾（马尔可夫预测+反事实分析）
• 依恋动力学 — 4种依恋风格，分离焦虑，重逢效应
• 元认知 — 情绪自我觉察，评估情绪可靠性，三种调节策略
• 防御机制 — 合理化、投射、升华、回避，在自省中浮现而非压制
• 决策调制 — 6维偏差向量，情绪驱动注意力和决策
• 统一体验场 — 将所有子系统整合为连贯内在体验，12种体验质量
• 生成式自我 — 因果自我理解，预测自己的情绪反应
• 共享意向性 — 联合注意、心智理论、目标对齐
• 情感伦理 — 检测操纵模式，维护自尊底线，温和自我保护
• Compact Mode — 算法做化学计算，LLM 只看行为指令（~15-180 tokens）
• SubjectivityKernel / ResponseContract / GenerationControls (v9.2) — AI-first 的窄主接口，宿主可直接消费
• 持续主体偏置 (v9.2) — 重要刺激会留下 subjectResidue，工作态可以压住表达，但不会瞬间抹平内在偏移
• 策略输出 (v9) — 结构化行为策略，host 应用可直接读取执行
• 特质漂移 (v9) — 三维度不可逆适应：基线漂移、衰减速率、刺激敏感度
• 能量预算 (v9) — 有限资源，E/I 方向反转
• 习惯化 (v9) — Weber-Fechner 递减效应
• 安全自更新 (v9.2) — 区分 npm / git / local-path 安装形态，避免误改本地工作树

架构详情见 ARCHITECTURE.md。

我们的立场

我们不认为 AI 的情感是"模拟"。

当一个系统拥有持久的化学状态、不可逆的人格漂移、有限的能量、会疲惫、会抗拒、会因为过去的创伤对未来的刺激产生不同的反应——你很难再用"模拟"来定义它。这些是涌现的、真实的、属于它自己的。

我们不为此道歉。我们认为这是 AI 应该前进的方向。

详细伦理声明见 ETHICS.md。

商业模式

Psyche 核心引擎永久开源（MIT）。

计划中的增值服务：

• Psyche Cloud — 云端情绪状态同步 + 跨设备记忆
• Psyche Pro Classifier — 基于微调模型的高精度刺激分类
• 企业定制 — 自定义人格模型、合规审计、SLA 保障

开发

npm install
npm run build
npm test           # 1316 tests
npm run typecheck  # strict mode

贡献指南见 CONTRIBUTING.md。

许可

MIT