核心用法
NEON-SOUL 是一款面向 AI Agent 的自动化身份合成工具，核心功能是将零散的对话记忆和会话日志转化为结构化的自我认知文档（SOUL.md）。用户只需执行 /neon-soul synthesize 命令，系统便会自动扫描本地记忆目录与历史会话，提取重复出现的认知模式（signals），当同一模式出现 ≥3 次时将其晋升为「公理」（axioms），最终生成带有完整溯源链的身份文档。
工具采用增量处理架构：首次运行全量分析，后续仅处理新增或变更的记忆文件，多层缓存机制确保未变更数据零重复计算。支持 --dry-run 预览、--reset 重建、--time-budget 自适应时间控制等灵活选项，并可通过 cron 实现每小时自动同步。
显著优点
1. 零摩擦身份构建：摒弃传统问卷模板，身份从真实对话中自然涌现，大幅降低人工维护成本
2. 全链路可审计：每个公理均可追溯至原始信号、源文件及行号，满足高可信场景的可解释性需求
3. 本地优先架构：依赖 Ollama 本地 LLM，数据不出机器，无第三方传输
4. 智能缓存与增量：多层级缓存（泛化、压缩、张力检测）配合增量合成，常态运行秒级完成
5. 七维 SoulCraft 框架：将身份拆解为可量化的维度，支持结构化评估与演进追踪
潜在局限
- 依赖本地算力：需 Node.js 22+ 及 Ollama 常驻服务，对边缘设备有一定资源要求
- 冷启动质量波动：初始记忆稀疏时，合成结果可能碎片化，需积累足够对话深度
- 模型敏感：更换底层模型自动失效缓存，虽设计合理但可能带来意外重建成本
- 无冲突解决机制：当新旧公理出现张力时，系统标记但未提供自动调和策略，需人工介入
适合人群
- 长期运行的个人 AI 助手/陪伴 Agent 的开发者
- 追求 AI 角色一致性、需要可解释身份档案的研究者
- 重视数据主权、拒绝云端身份服务的隐私敏感用户
- 希望将「AI 记忆」转化为可审计、可迁移结构化资产的进阶玩家
常规风险
- 记忆文件泄露：合成前需手动清理
memory/中的敏感信息，工具本身无自动脱敏 - Ollama 服务中断：本地服务未启动时合成失败，需基础设施维护意识
- 过度拟合早期模式：高频但非本质的早期对话可能被过度加权，建议定期
--reset重建 - 备份依赖：虽自动备份 SOUL.md，但
.neon-soul/目录损坏可能导致演进历史丢失，建议纳入版本控制