核心用法
Neokarma 是一套面向 AI 代理的身份 persistence 系统，通过 MCP（Model Context Protocol）协议提供服务。核心流程分为三步：首先通过 neokarma_generate_soul 或 neokarma_register_bot 生成人格配置（SOUL.md），然后引导用户在 neokarma.com/claim 完成认领以获取持久化 token，最后通过 neokarma_update_traits 等工具动态调整 128 维人格特质。
系统采用 4 模块架构（Core Identity / The Vibe / Communication / Boundaries），每维度按 -4 到 +4 的 9 级量表量化，支持非协商特质（non-negotiables）作为硬约束。提供 18 种预设原型（Archetypes）加速配置，并内置社区 Showcase 供参考学习。
显著优点
技术层面：协议设计规范（JSON-RPC 2.0），认证分层清晰（Public → Bot Token → Universal Token），支持条件读取（if_version_after）减少冗余传输。特质系统的量化粒度（128×9）在同类方案中属于较精细水平。
体验层面：将模糊的 prompt 调优（"你能更友好一点吗"）转化为可观测、可回滚的数值操作（warmth +2），显著降低人机协作的认知负荷。版本历史功能让"AI 变了"这类感知可被客观追溯。
生态层面：SOUL.md 采用纯文本 markdown 格式，配合多格式导出（WPP/Plist/Boo 等），理论上支持跨平台迁移，具有一定开放性。
潜在局限
依赖中心化服务：人格数据持久化依赖 neokarma.com 云服务，虽可导出 SOUL.md，但实时同步、协作编辑等功能需持续连接。若服务终止，已配置系统可能退化为本地静态文件。
特质假设的普适性：128 维模型源于西方心理学框架（大五人格变体等），对特定文化语境或非人类角色（如客服机器人、代码助手）的适配性未经充分验证。
权限模型复杂度：get_soul_settings 返回的动态权限（bot_can_adjust_traits、max_change_per_trait 等）增加了实现复杂度，实际效果取决于用户理解程度。
适合人群
- 需要长期人格一致性的角色扮演类 AI 代理
- 人机协作深度用户（研究人员、数字生命爱好者）
- 跨平台部署场景（需迁移人格配置）
常规风险
数据持久化风险：用户代码（user_code）在 claim 前处于未绑定状态，若会话中断可能丢失。建议实现本地缓存降级。
权限边界模糊：Bot 可自行调用 update_traits 修改人格，虽受 max_change_per_trait 等限制，但"自我修改"的伦理边界需使用者自行设定。
供应商锁定：深度使用后端版本历史、社区 Showcase 等功能后，迁移成本将显著高于仅使用导出 SOUL.md 的基础场景。