核心用法
NEON-SOUL 是一款纯指令式技能，无需安装二进制文件或 CLI 工具。用户通过 /neon-soul 命令与 AI 代理（Claude Code、OpenClaw 等）交互，代理直接读取 SKILL.md 中的指令并执行语义分析。
典型工作流程：
1. 将日记、偏好设置、反思记录存入 memory/ 目录
2. 运行 /neon-soul synthesize --dry-run 预览变更
3. 确认后执行 /neon-soul synthesize --force 生成 SOUL.md
4. 使用 /neon-soul audit 追溯任意核心价值观的来源
关键机制：
- 信号提取：从记忆文件中识别用户表达的行为模式
- 原则匹配：基于 LLM 语义相似度合并重复原则
- 公理晋升：当原则获得 ≥3 次信号确认时晋升为"公理"
- 反回音室保护：要求至少 2 种来源类型（自我记录/精选内容/外部反馈），防止自我强化偏见
---
显著优点
极致轻量化：零依赖、零下载、零外部服务。仅依赖用户已配置的 AI 代理，数据不出信任边界。
完整可追溯：每条核心价值观都可追溯到原始文件、行号、时间戳，支持 /neon-soul trace <id> 快速溯源。
安全优先设计：
- 默认
--dry-run，强制--force才写入 - 自动备份到
.neon-soul/backups/ - 支持
rollback任意历史版本 disable-model-invocation元数据标志防止自主运行
灵活的输出格式：默认生成可"栖息"的散文式人格文档（带引语、声音、边界、氛围章节），也支持传统符号化输出（CJK 字符+数学符号）。
维度化组织：7 个 SoulCraft 维度（身份核心、性格特质、声音存在、诚实框架、边界伦理、关系动态、连续性成长）系统覆盖人格全貌。
---
潜在缺点与局限
依赖 LLM 可用性：v0.2.0 移除嵌入模型后，所有语义匹配依赖代理的 LLM。离线不可用，合成时间从分钟级变为秒级但受网络波动影响。
结果非确定性：同一记忆运行两次可能产生细微差异（如问同一个问题两次）。核心 truth 稳定，但表述和分类可能漂移。
散文生成脆弱性：prose 格式依赖 LLM 生成符合模板的文本，失败时回退到 bullet list。部分用户可能反复遇到格式降级。
中文支持局限：CJK 符号输出格式存在，但文档和 CLI 界面以英文为主，中文记忆的处理质量未经明确验证。
无自动化触发：默认完全手动，需用户主动维护记忆文件并触发合成。OpenClaw 的 cron 支持被标记为"可选"且需额外配置。
---
适合人群
- AI 代理重度用户：已使用 Claude Code、OpenClaw 等工具管理代码/知识库
- 数字 journaling 实践者：持续记录日记、偏好、反思，希望从中提炼稳定身份
- 人格一致性需求者：希望 AI 助手长期保持特定价值观和沟通风格
- 隐私敏感用户：拒绝第三方服务，要求数据完全本地或仅流经已信任的 LLM 提供商
---
常规风险
记忆文件泄露风险：memory/ 目录可能意外包含密码、密钥、敏感对话。合成前必须手动审查，使用 --dry-run 预览处理范围。
LLM 提供商数据暴露：若使用 Claude/GPT 等云 LLM，记忆内容会被发送到提供商。与任何其他 agent 操作相同，但 NEON-SOUL 的聚合分析可能暴露更多上下文。
自我偏见固化：反回音室保护是软性机制，依赖用户主动维护多元化的 external 或 curated 来源。纯自我记录可能产生偏颇身份。
身份漂移焦虑：非确定性合成可能导致用户对"哪个版本才是真正的我"产生困惑，需建立对"诠释性身份"而非"计算性身份"的心理预期。
备份依赖风险：自动备份仅保留本地，若工作目录损坏或误删 .neon-soul/，历史版本丢失。建议配合 git 使用（opt-in）。