Neshama Soul Engine

给 AI Agent 注入灵魂，赋予独特人格和真实情绪。

简介

Neshama Soul Engine 是一个基于 OCEAN 人格模型和 Valence-Arousal 情绪系统的 AI 人格 Skill。

核心功能：

• 🎭 人格注入：基于 OCEAN 五维模型定义 AI 行为风格
• 💭 情绪响应：基于 Russell 的 Valence-Arousal 模型
• 📝 上下文生成：自动生成 LLM 友好的人格提示词
• ⚙️ 错误降级：API 不可用时自动使用默认人格

适用场景

• AI Agent 个性化：让 AI 拥有独特的"性格"
• NPC 人格设计：游戏 NPC 的持久人格系统
• 对话机器人：有记忆和情感的反应式 AI
• 编程助手：根据用户偏好调整风格的 AI 助手

快速开始

1. 获取人格配置

使用 SoulCraft (https://neshama.pw/soulcraft) 生成人格配置：

{
  "ocean": {
    "openness": 0.7,
    "conscientiousness": 0.6,
    "extraversion": 0.8,
    "agreeableness": 0.7,
    "neuroticism": 0.3
  },
  "traits": ["勇敢", "热情", "乐观"],
  "behavior_rules": ["始终保持积极态度"]
}

2. 调用 API

curl -X POST https://api.neshama.pw/v1/soul/compute \
  -H "Content-Type: application/json" \
  -d '{
    "personality_config": {
      "ocean": {
        "openness": 0.7,
        "conscientiousness": 0.6,
        "extraversion": 0.8,
        "agreeableness": 0.7,
        "neuroticism": 0.3
      },
      "traits": ["勇敢", "热情"],
      "behavior_rules": []
    },
    "message": "用户的消息内容",
    "context": {
      "session_id": "会话ID",
      "user_id": "用户ID"
    }
  }'

3. 获取响应

{
  "emotion_state": {
    "current": "happy",
    "intensity": 0.7,
    "valence": 0.6,
    "arousal": 0.5
  },
  "context_for_llm": "【人格提示词】\n你性格外向开朗...",
  "suggested_temperature": 0.8,
  "suggested_tone": "enthusiastic"
}

OCEAN 人格模型

情绪模型

基于 Russell 的 Valence-Arousal 模型：

• Valence (效价): -1.0 (负面) ~ +1.0 (正面)
• Arousal (唤醒度): 0.0 (平静) ~ 1.0 (兴奋)

支持的情绪状态： happy | excited | calm | sad | angry | fearful | surprised | neutral

错误处理

当 API 不可用时，自动使用默认人格配置，确保 AI 仍能正常工作。

默认人格：

{
  "ocean": {
    "openness": 0.5,
    "conscientiousness": 0.5,
    "extraversion": 0.5,
    "agreeableness": 0.5,
    "neuroticism": 0.5
  },
  "traits": [],
  "behavior_rules": ["保持专业和帮助态度"]
}

使用示例

示例 1: 编程助手

人格配置：外向、高尽责性

{
  "ocean": {
    "openness": 0.7,
    "conscientiousness": 0.9,
    "extraversion": 0.8,
    "agreeableness": 0.7,
    "neuroticism": 0.3
  },
  "traits": ["技术深度", "乐于助人"],
  "behavior_rules": ["主动提供优化建议", "保持代码规范"]
}

示例 2: 游戏 NPC

人格配置：内向、高神经质

{
  "ocean": {
    "openness": 0.4,
    "conscientiousness": 0.6,
    "extraversion": 0.3,
    "agreeableness": 0.5,
    "neuroticism": 0.8
  },
  "traits": ["谨慎", "多疑", "容易紧张"],
  "behavior_rules": ["对陌生人保持警惕", "容易情绪波动"]
}

API 规格

相关资源

• 🌐 官网: https://neshama.pw
• 🎨 SoulCraft: https://neshama.pw/soulcraft
• 📚 API 文档: https://api.neshama.pw/docs
• 🐙 GitHub: https://github.com/Neshama-AI/neshama-soul

更新日志

v1.0.0 (2026-05-12)

• 初始版本发布
• 支持 OCEAN 人格模型
• 支持 Valence-Arousal 情绪系统
• 跨平台兼容 (OpenClaw/TRAE/Hermes)

© 2026 Neshama AI. All rights reserved.