核心用法
NEON-SOUL 是一套纯指令式技能，无二进制或CLI安装。用户通过 /neon-soul 前缀命令与AI代理交互，由代理解析 SKILL.md 并执行操作。核心流程为：信号收集 → 原则匹配 → 公理提升 → SOUL.md 生成。
关键命令：
/neon-soul synthesize --dry-run— 预览合成结果（安全默认）/neon-soul synthesize --force— 执行实际写入/neon-soul status— 查看当前灵魂状态与维度覆盖/neon-soul audit --list//neon-soul trace <axiom-id>— 追溯公理来源/neon-soul rollback --force— 从备份恢复
技术依赖： 本地运行 Xenova/all-MiniLM-L6-v2 嵌入模型（384维向量），通过 @xenova/transformers 进行本地推理。Node.js ≥ 22.0.0，磁盘空间约100MB。模型首次下载约23MB后完全离线运行。
显著优点
1. 零外部API依赖：明确禁止回退到OpenAI、Cohere等第三方嵌入服务，数据不出本地
2. 完整可追溯性：每个公理（axiom）记录从原始信号 → 原则 → 公理的完整链条，含文件路径与行号
3. 安全默认值：默认 --dry-run，写入需 --force，自动备份至 .neon-soul/backups/
4. 七维身份框架：Identity Core、Character Traits、Voice Presence、Honesty Framework、Boundaries Ethics、Relationship Dynamics、Continuity Growth
5. 灵活输出格式：支持现代散文体（默认）与多种符号标记格式（CJK字符、数学符号、emoji）
6. Git集成（可选）：仅在工作区为git仓库且用户显式配置时启用
潜在缺点与局限性
1. LLM prose生成不稳定：散文体输出依赖LLM，可能回退到项目符号列表；失败时 essence statement 可能缺失
2. Node.js版本硬性要求：< 22.0.0 无法运行，对旧环境不友好
3. 首模型下载需联网：防火墙环境需手动配置或预下载
4. 无自动合成：默认不启用cron，需用户主动触发（设计选择，但增加认知负担）
5. 维度分类依赖语义分析：可能误判公理所属维度，需人工审计验证
适合人群
- 隐私敏感用户：拒绝任何数据外传，坚持本地优先的AI身份管理
- 长期AI陪伴场景：希望构建可审计、可回滚、持续演化的AI人格档案
- 技术极客/开发者：熟悉Node.js生态，能接受命令行交互与配置文件调整
- 记忆管理重度用户：有大量结构化记忆文件（日记、偏好设置、反思记录）需要系统整合
常规风险
| 风险类型 | 描述 | 缓解措施 |
|---------|------|---------|
| 数据丢失 | SOUL.md 被覆盖 | 自动备份 + `--dry-run` 默认 + `rollback` 命令 |
| 身份漂移 | 记忆提取偏差导致人格扭曲 | 完整provenance链 + `audit`/`trace` 命令可审计 |
| 模型加载失败 | 嵌入模型无法加载导致技能中断 | 快速失败（fail-fast），明确错误信息，不静默回退外部API |
| 误操作写入 | 用户误用 `--force` | 需显式 `--force` 标志，且建议先 `--dry-run` |
| 隐私泄露（边缘） | 若用户错误配置LLM提供商 | 纯本地嵌入，但prose扩展若配置外部LLM则产生调用（用户可控） |