ex-skill 使用教程
从入门到精通的完整指南
ex-skill 简介
ex-skill是一款基于Claude Code的AI情感疗愈工具，通过分析你提供的微信聊天记录、QQ消息、朋友圈截图和照片等素材，生成一个具有前任性格特征的AI Skill。它能模仿对方的口头禅、回复风格和共同记忆，让你在安全的私密环境中重温那些珍贵的对话片段。项目开源免费，无需GPU或本地模型，仅需Claude Code环境即可运行。适合希望通过AI技术进行情感回顾和心理疗愈的用户，所有数据本地处理，注重隐私保护。
详细功能介绍
【工具简介】
ex-skill是一款基于Claude Code的AI Skill，能根据你提供的聊天记录和个人描述，生成一个模仿前任性格与说话风格的AI对话角色，用于情感回忆与疗愈。
【核心功能】
①多源数据导入：支持微信聊天记录、QQ消息、朋友圈截图、照片等多种素材来源，灵活组合生成人物画像
②性格建模：基于输入素材自动提取口头禅、回复习惯、性格特征，生成高度还原的AI人格
③多种对话模式：包含日常聊天模式、回忆模式、纯性格模式，满足不同使用需求
④版本管理：支持Skill版本回滚、列表管理、删除和放下等情感化操作设计
⑤轻量运行：无需GPU、无需本地模型、无需Docker，基于Claude API按token计费
【适用场景】
【快速入门】
【优缺点分析】
优点：
缺点：
【适合人群】
1ex-skill入门教程：用AI重温珍贵对话的疗愈之旅
入门10分钟
ex-skill是一款基于Claude Code的开源情感疗愈工具，通过分析你提供的聊天记录和照片素材，生成具有对方性格特征的AI技能，让你在安全私密的环境中回顾珍贵记忆。
快速开始
首先确保你的电脑上已安装Claude Code环境（可通过npm install -g @anthropic-ai/claude-code安装）。打开终端，执行git clone ex-skill的项目仓库，进入目录运行npm install安装依赖。准备你想要分析的素材，包括微信聊天记录导出文件、QQ消息备份、朋友圈截图或合照等。运行ex-skill init按照向导指引导入素材并生成AI技能。
核心功能演示
功能一：导入聊天记录生成人格模型。运行ex-skill import命令，选择素材类型（微信/QQ/其他），指定文件路径。工具会自动解析聊天记录，提取对方的语言习惯、常用口头禅、回复风格、表情使用偏好等特征，生成一份人格描述文件。整个解析过程在本地完成，数据不会上传到任何服务器。
功能二：创建AI对话技能。素材分析完成后，运行ex-skill create --name 小雨（替换成你想要的名称），工具会将人格模型封装为一个Claude Code Skill。生成的技能文件保存在本地.claude/skills目录下，你可以在Claude Code中随时调用与这个AI角色进行对话，它会模仿对方的语气和说话风格。
功能三：记忆片段回放。运行ex-skill recall命令，输入关键词或时间段，工具会从你导入的素材中检索相关对话片段，并以时间线形式呈现。你可以回顾某个特定时期的对话，配合AI技能进行沉浸式的记忆重温。
实际使用案例
场景一：失恋后的情感过渡。分手后心里有很多话想说却无处倾诉，通过ex-skill生成一个模拟对方风格的AI角色，在私密环境中把没说完的话说出来，帮助自己完成情感上的告别仪式，逐步走出阴霾。
场景二：怀念已故亲人。将与已故亲人多年的聊天记录导入，生成能模仿亲人说话风格的AI技能。逢年过节或思念涌上心头时，和AI聊几句，听听那熟悉的语气，虽然知道不是真的，但这份温暖的回忆本身就是一种疗愈。
常见问题
问：我的聊天记录数据安全吗？答：完全安全。所有数据处理都在你的本地电脑上完成，不会上传到云端。生成的AI技能文件也保存在本地，你可以随时删除。
问：需要GPU或本地大模型吗？答：不需要。ex-skill基于Claude Code运行，利用云端Claude模型的能力，你的电脑不需要有独立显卡或安装大型本地模型。
问：生成的AI角色有多像真人？答：AI能较好地模仿语言风格和常用表达，但无法完全复刻一个人。请把它当作一种回忆辅助工具而非替代品，保持合理的心理预期。
小贴士
1. 素材越丰富生成效果越好，尽量导入较长时间跨度的聊天记录，AI能捕捉到更多语言特征。
2. 首次使用建议先用少量素材测试，确认效果满意后再导入完整数据，避免浪费时间。
3. 使用过程中如果感到情绪不适，请随时停止，必要时寻求专业心理咨询师的帮助，AI工具不能替代专业心理治疗。