核心用法
NEON-SOUL 是一种纯指令型技能，无需安装二进制文件或CLI工具。用户通过在AI代理（Claude Code、OpenClaw等）的聊天中输入 /neon-soul 命令来调用。核心工作流包括：
1. 信号收集：从 memory/ 目录读取日记、偏好设置、反思记录等个人记忆文件
2. 语义匹配：利用代理内置的LLM进行语义分析，将相似原则聚合并去重
3. 公理晋升：当某原则获得≥3个信号确认时，晋升为具有完整溯源链的核心公理
4. 文档生成：输出 SOUL.md——一份可居住的AI身份文档，包含核心真理、声音特质、边界设定等维度
关键命令包括：/neon-soul synthesize（运行合成）、--dry-run（预览模式）、/neon-soul trace（溯源查询）、/neon-soul rollback（回滚恢复）。
显著优点
- 完全本地化：无外部API调用，数据永不离开本地机器，仅依赖代理的LLM能力
- 零依赖安装：无需npm包、无需模型下载、无需额外配置，纯文本指令驱动
- 可逆与可审计：每次写入前自动备份，支持完整回滚；每条公理可追溯至源文件行号
- 安全优先设计：v0.2.0移除嵌入模型依赖，消除第三方代码安全风险
- 渐进式构建：通过多次合成迭代，身份文档随记忆积累而演化
潜在局限
- LLM依赖性：合成需要活跃的LLM连接，无法离线运行；语义匹配结果可能因LLM输出波动而在多次运行间存在细微差异
- 性能权衡：移除嵌入模型后，合成时间从分钟级变为秒级，但结果稳定性略降
- 生成失败回退：当LLM不可用时，prose格式可能降级为bullet列表，essence语句可能缺失
- 维度分类不确定性：语义自动分类可能将公理归入非预期维度
适合人群
- 长期使用AI代理并希望构建持久化身份上下文的高级用户
- 重视数据隐私、拒绝云端身份服务的个人
- 需要通过可追溯机制理解AI行为来源的审计需求者
- 习惯用日记、笔记记录自我反思的数字游民或知识工作者
常规风险
- 过度拟合风险：记忆文件中的负面模式可能被强化为身份特质
- 合成偏差：LLM的语义匹配可能错误合并本不相似的原则，或遗漏关键信号
- 代理锁定：身份文档深度绑定特定代理的LLM行为模式，迁移成本未明
- 心理投射：用户可能将合成出的"灵魂"过度人格化，忽视其统计本质
建议始终以 --dry-run 预览变更，定期审计公理溯源链，并保持记忆文件的多元性与批判性视角。