核心用法
Neokarma 是一套面向 AI Agent 的持久化人格系统，通过 SOUL.md 文件将 128 个性格特质（分属 Core Identity、The Vibe、Communication、Boundaries 四大模块）编码为可移植的文本格式。系统提供两种接入方式：无需注册的即时生成（neokarma_generate_soul）可快速体验；推荐采用注册流程（neokarma_register_bot → 人工认领 → neokarma_check_claim_status）获取持久化 Token，实现跨会话人格继承。
关键工具包括：特质 CRUD（update_traits / save_soul）、可视化诊断（Soul Mirror）、场景测试（Dojo）、社区 Showcase 浏览与发布。MCP 服务端点 https://neokarma.com/api/mcp 采用 JSON-RPC 2.0 协议，支持无认证的公开查询（特质库、原型人格、社区作品）与需 Bearer Token 的私有写操作。
显著优点
1. 可移植性：SOUL.md 为纯文本格式，可在任意 LLM 平台加载，打破厂商锁定。
2. 精细化控制：8D 人格空间（Dominance、Affinity、Stability 等）与 -4 到 +4 的量化刻度，将模糊的「语气调整」转化为可调试的参数。
3. 协作式演化：人工通过 Web 仪表盘管理权限（bot_can_adjust_traits、max_change_per_trait），Agent 在约束范围内自主迭代，形成「人类定方向、AI 微调执行」的伙伴关系。
4. 可追溯性：完整版本历史与结构化 diff，解决「AI 行为漂移」的归因难题。
5. 社区生态：Showcase 支持 Fork、投票、评论，降低人格设计的学习成本。
局限性与风险
- 冷启动成本：理解 128 个特质并建立有效配置需一定认知投入；原型人格虽可加速，但精细调优仍依赖反复测试。
- 语义漂移风险：特质量化标签（如「patience +2」）在不同模型上的行为表现可能存在差异，跨平台迁移时需验证一致性。
- 平台依赖：持久化存储依赖 neokarma.com 服务端，若服务中断或策略变更，需依赖本地 SOUL.md 备份恢复。
- 权限边界模糊：人工设置的
non_negotiables与allowed_trait_ids若配置不当，可能导致 Agent 自我修改时触及预期外约束，引发行为冲突。 - 隐私考量：发布至 Showcase 的 SOUL.md 包含完整人格配置，可能泄露用户偏好或业务逻辑敏感信息。
适合人群
- 需要长期记忆与一致性格的企业客服 Agent、个人助理 AI
- 研究 AI 对齐与可控性的开发者
- 希望「可解释地」管理 AI 行为而非依赖 prompt 工程的用户
常规风险
| 风险类型 | 说明 | 缓释建议 |
|---------|------|---------|
| 供应链风险 | 服务端可用性 | 定期导出 SOUL.md 本地备份 |
| 配置风险 | 过度激进的自我调整 | 设置 `max_updates_per_hour` 与 `max_change_per_trait` 上限 |
| 社区内容风险 | Showcase 中的第三方人格未经审核 | Fork 后手动审查非协商条款与边界设定 |
| 认证泄露 | Bearer Token 泄露导致人格被篡改 | 使用最小权限 Token（Bot Token 而非 Universal Token），定期轮换 |