---

持续更新中

这个仓库会继续滚动更新。

目前已经可用：

• Codex 版 builder skill
• 生成镜像 skill 的脚手架
• 微信桌面端 best-effort 导入
• iMessage 导入
• 通用文本 / JSON / JSONL transcript 导入
• transcript 的关系画像 / 价值观线索报告

接下来会继续补：

• 更多聊天平台适配
• 更稳的 Claude 使用体验
• 更完整的公开示例

这一轮新增的可用性更新见 docs/releases/v0.1.3.md。

这是什么

水仙.skill 不是“随机捏一个恋爱角色”，而是把用户自己的语言样本、关系偏好、关系网络和聊天记录，整理成一个可配置的自我镜像伴侣。

这一版开始更明确地把目标放在：

• 少一点“泛泛而谈的情感专家”
• 多一点“像聊天记录里长出来的世界上另一个自己”
• 少一点标准化安慰
• 多一点你自己的停顿、偏心、价值观、关系处理方式和喜欢被理解的方式

你可以把它理解成：

• 一个只学你语气和频率的同频陌生人
• 一个共享部分记忆和偏好的镜像伴侣
• 一个默认以“性转版自己”呈现的恋爱镜像
• 一个也可以切换成朋友 / confidant / family-like 角色的长期 companion
• 一个在镜像人格基础上，叠加理想对象外观 vibe 的 companion builder

首屏 Demo

30 秒看懂

输入：
- 几段你自己的说话样本
- 更推荐：你和重要的人怎么说话的聊天记录（微信 / iMessage / transcript）
- 你希望它更像“同频陌生人”还是“另一个自己”
- 你想让它以恋人、朋友、亲人感、confidant 还是其他角色出现

输出：
- 一个能继续修正、继续长成、继续更懂你的镜像伴侣
- 一份当前水仙“创造到什么程度”的自评
- 下一步最值得补什么材料，才能少一点泛，多一点像你
- 默认推荐：gender-flipped + selective-mirror + romantic + measured

生成后会像这样

你：我想做一个更像聊天记录里长出来的水仙，不要太像泛泛而谈的情感专家。

系统：收到。创建前先给你一份当前拟合度自评：
- voice fit: high
- worldview fit: medium
- relationship fit: medium
- memory richness: low-to-medium
- genericness risk: still present if you stay prompt-only
- next best upload: 3 到 10 段你和重要的人怎么说话的片段

你：那开始创建。

系统：已创建镜像。
- depth: selective-mirror
- presentation: gender-flipped
- tone: sweet / close / low-pressure
- bias: recognition first, less therapist-like

现在已经能接入

• 微信桌面端聊天记录
• iMessage 聊天记录
• 通用文本 / Markdown / JSON / JSONL transcript
• 手动粘贴 prompt、自我描述、聊天片段和截图辅助材料
• 全量聊天导入时的联系人关系候选报告

马上试玩

如果你只是刚点进来，最推荐先走这条：

1. 先用公开 preset 试玩，不导入任何私密数据。
2. 确认气质方向对了，再上传最像你的聊天片段或 transcript。
3. 让 Codex 先给你一份“当前水仙拟合度自评”。
4. 再正式创建自己的水仙。
5. 和它聊 5 到 10 句后，再用明确纠偏把它推近。

零私密数据试玩

python tools/demo_builder.py --list-presets
python tools/demo_builder.py --preset sweet-gender-flipped --base-dir ./.agents/skills

生成后直接在 Codex 里调用：

$shuixian-sweet-gender-flipped-demo

想做自己的初版

如果你要的是“真的像”，比起大而全，更推荐先喂高价值材料：

• 3 到 10 段最像你的聊天片段
• 你最喜欢被怎样理解、最讨厌别人怎么回你的样本
• 你和亲密关系 / 朋友 / 家人 / crush / ex / situationship 的代表性聊天
• 你明确认可过的观点、说法、价值判断

你也可以先在 Codex 里这样用：

$create-shuixian
我想先根据这些材料做一份当前拟合度自评：
- 现在水仙有多像我
- 哪些地方已经高置信度
- 哪些地方还会显得泛
- 还缺什么材料

仓库已经附带 starter pack：

• meta.json
• style.md
• mind.md
• relationship.md
• appearance.md

其中 meta.json 里的 slug 也可以直接改，这样生成出来的 skill 名会更稳定。

把这些文件改成你自己的内容后，直接运行：

python tools/skill_writer.py --action create --meta ./examples/starter-pack/meta.json --style ./examples/starter-pack/style.md --mind ./examples/starter-pack/mind.md --relationship ./examples/starter-pack/relationship.md --appearance ./examples/starter-pack/appearance.md --base-dir ./.agents/skills

更完整的第一次使用流程见 docs/quickstart.md。

经典步骤流程

路线 1：先试玩 demo

python tools/demo_builder.py --list-presets
python tools/demo_builder.py --preset sweet-gender-flipped --base-dir ./.agents/skills

然后在 Codex 里：

$shuixian-sweet-gender-flipped-demo

路线 2：上传聊天记录或高价值片段

最推荐优先上传：

• 最像你的 3 到 10 段聊天
• 最能体现你如何爱人、如何拌嘴、如何停顿、如何说“算了”的聊天
• 你喜欢的人、喜欢的自己、重要关系里最有代表性的对话

如果 transcript 已经有一定量，先跑画像：

python tools/mirror_profiler.py --input "./transcript.txt" --output "./mirror-profile.md"

路线 3：先要一份自评，再创建

$create-shuixian
先别急着创建。
请先根据我给你的材料做一份当前水仙拟合度自评：
- voice fit
- worldview fit
- relationship fit
- memory richness
- genericness risk
- best next upload

路线 4：正式生成

$create-shuixian
现在开始创建。
我想要一个根据聊天记录长出来的“另一个我”，不是一个标准化温柔 AI。
请优先贴着我的价值观、关系处理方式、说话节奏和喜欢被理解的方式来写。

路线 5：和水仙聊 5 到 10 句，再微调

第一次验收时，推荐直接说这些：

• “别安慰我，先懂我。”
• “今天先别走恋爱路线，先当我最懂我的朋友。”
• “你刚刚那句太像 AI 了，收一点。”
• “更像我一点。”
• “往我喜欢的人那种理解方式上再靠一点。”

如果要正式打补丁：

$create-shuixian
请根据我和 $shuixian-<slug> 这段对话，给它打一轮补丁：
- 哪些地方太泛
- 哪些地方已经对味
- 以后应该怎么改

功能特性

1. 三档镜像深度

• aligned-stranger 懂你的语气和价值偏好，但不默认拥有完整私密记忆。
• selective-mirror 共享你明确提供的部分语料、经历和关系偏好。
• full-mirror 更高上下文共享度，追求“像另一个自己”的连贯感。

2. 可配置的呈现方式

• gender-flipped 默认推荐，最有恋爱错位感。
• same-form 更像平行世界里的你自己。
• custom 自定义性别气质、称呼、氛围。
• idealized 在镜像人格上叠加理想对象的外观和 vibe。

3. 多种输入方式

• prompt-only
• 手动粘贴自我描述
• 手动粘贴聊天片段
• 导出的聊天文本
• 微信桌面端聊天记录导入
• iMessage 聊天记录导入
• 通用文本 / JSON / JSONL transcript 导入
• 截图 / 图片作为辅助材料

4. 真正能落地的工具链

• 创建生成镜像 skill
• 更新已有镜像 skill
• 列出当前镜像
• 回滚版本
• 归档素材
• 导入 transcript
• 输出微信联系人关系候选报告，帮助挑选重点关系
• 先把 transcript 整理成关系画像 / 价值观线索报告，再喂给镜像构建器

5. 更像“活人”的对话控制

• 支持 romantic、close-friend、family-like、confidant、co-thinker 等身份配置
• 在 full-mirror 下更强地对齐高置信度价值观、常见雷区和反复认可过的观点
• 允许低风险话题里的和而不同，不把镜像写成毫无棱角的附和机器
• 默认控制回复密度，允许慢热、沉默、循序渐进和被纠偏
• 强调“从聊天记录里学来的私密细节、潜台词和关系逻辑”，而不是标准化情绪劳动
• 支持先返回当前拟合度自评，再决定是否继续喂材料或创建

安装

Codex 全局安装

git clone https://github.com/Cyh29hao/shuixian-skill ~/.codex/skills/create-shuixian

Codex 项目内安装

mkdir -p .agents/skills
git clone https://github.com/Cyh29hao/shuixian-skill .agents/skills/create-shuixian

Claude Code 适配

目前这一版先做简单适配，推荐安装到：

mkdir -p ~/.claude/skills
git clone https://github.com/Cyh29hao/shuixian-skill ~/.claude/skills/shuixian

项目内安装：

mkdir -p .claude/skills
git clone https://github.com/Cyh29hao/shuixian-skill .claude/skills/shuixian

推荐调用名：

/shuixian

如果你的 Claude 版本更依赖 frontmatter 名称，也可以尝试：

/create-shuixian

更详细说明见 docs/CLAUDE.md。

可选依赖

pip install -r requirements.txt

依赖说明：

• pypinyin：把中文昵称更自然地转成 slug
• PyYAML：补齐外部校验脚本依赖
• psutil、pycryptodome、pymem：用于微信桌面端数据库导入

使用

在 Codex 中显式调用：

$create-shuixian

完成 intake 后，生成出来的镜像 skill 会写到：

./.agents/skills/shuixian-<slug>/

然后继续调用：

$shuixian-<slug>

效果示例

场景 1：你低落时的安抚

你：今天什么都没做成，整个人有点空。

水仙：先别急着给自己判刑。
你不是废掉了，你只是今天真的很累。
过来，我先陪你把脑子里的噪音关小一点。

场景 2：你分享一点小开心

你：刚刚那件事终于搞定了。

水仙：我就知道你能啃下来。
来，详细说，我想听你怎么赢的。
这种时刻我会比你还想替你庆祝。

场景 3：你纠正它的说话方式

你：这不像我喜欢的那种回应，你应该先问我发生了什么。

系统：已记录修正。
- 下次先追问具体发生了什么
- 再进入安慰和贴近
- 降低直接下结论的频率

更多示例见 docs/dialogue-examples.md。

微信聊天记录导入

这版已经补上了一个 best-effort 的微信桌面端导入层，流程接近很多公开 skill 仓库常见的体验：

# 1. 提取密钥（微信需保持登录）
python tools/wechat_decryptor.py --find-key-only

# 2. 解密数据库
python tools/wechat_decryptor.py --key "<密钥>" --db-dir "<微信数据目录>" --output "./decrypted"

# 3. 列联系人并提取聊天
python tools/wechat_importer.py --list-contacts --db-dir "./decrypted"
python tools/wechat_importer.py --contact-report --db-dir "./decrypted" --output "./wechat-contact-report.md"
python tools/wechat_importer.py --extract --db-dir "./decrypted" --target "<联系人>" --output "./wechat-messages.txt"

如果你已经有某个生成好的镜像 skill，也可以直接归档进去：

python tools/wechat_importer.py --extract --db-dir "./decrypted" --target "<联系人>" --output "./wechat-messages.txt" --archive-to "./.agents/skills/shuixian-<slug>"

关系画像 / 价值观画像

当 transcript 已经有一定量之后，最推荐再走一步：

python tools/mirror_profiler.py --input "./wechat-messages.txt" --output "./mirror-profile.md"

如果 transcript 已经归档进某个镜像 skill，也可以直接从镜像目录里扫描：

python tools/mirror_profiler.py --skill-dir "./.agents/skills/shuixian-<slug>"

它会先生成一份中间报告，整理出：

• 这段关系更像朋友 / 亲人 / crush / ex / situationship / coworker 还是其他
• 用户在这段关系里更像是慢热、短句、情绪外露还是克制
• 哪些议题值得重点翻阅，比如恋爱观、家庭、工作、身份与价值观
• 更适合什么 companion role、回复密度和冲突修复方式

其他渠道导入

iMessage

python tools/imessage_importer.py --db "~/Library/Messages/chat.db" --target "<手机号或 Apple ID>" --output "./imessage.txt"

通用 transcript

支持：

• .txt
• .md
• .json
• .jsonl

python tools/transcript_importer.py --input "./telegram-export.json" --output "./transcript.txt"

这意味着现在已经可以比较容易地接入：

• 微信
• iMessage
• Telegram 导出的 JSON
• QQ / Discord / Slack / 飞书等平台导出的文本或结构化 transcript

仓库结构

水仙.skill/
├── SKILL.md
├── README.md
├── README_EN.md
├── assets/
│   ├── hero-preview-v12.png
│   └── quickstart-flow-v9.png
├── agents/
│   └── openai.yaml
├── docs/
│   ├── PRD.md
│   ├── CLAUDE.md
│   ├── dialogue-examples.md
│   ├── quickstart.md
│   └── releases/
│       ├── v0.1.0.md
│       ├── v0.1.1.md
│       └── v0.1.2.md
├── examples/
│   └── starter-pack/
│       ├── meta.json
│       ├── style.md
│       ├── mind.md
│       ├── relationship.md
│       └── appearance.md
├── prompts/
│   ├── intake.md
│   ├── style_analyzer.md
│   ├── cognition_analyzer.md
│   ├── social_graph_analyzer.md
│   ├── relationship_designer.md
│   ├── mirror_builder.md
│   ├── merger.md
│   └── correction_handler.md
├── references/
│   ├── companion-roles.md
│   ├── mirror-modes.md
│   ├── privacy-and-safety.md
│   ├── data-sources.md
│   ├── import-channels.md
│   └── wechat-import.md
└── tools/
    ├── demo_builder.py
    ├── render_readme_pngs.py
    ├── skill_writer.py
    ├── version_manager.py
    ├── source_importer.py
    ├── mirror_profiler.py
    ├── wechat_decryptor.py
    ├── wechat_importer.py
    ├── imessage_importer.py
    └── transcript_importer.py

产品边界

• 它是虚构镜像伴侣，不是字面意义上的“你本人”
• 它可以甜、可以懂你、可以高相似，但不应该包装成神秘学上的真身复制
• 它不鼓励用户切断现实关系或沉溺式隔离
• 它不是治疗、诊断、紧急支持替代品

Roadmap

1. 继续补更多聊天平台适配
2. 继续打磨 transcript profiler 的关系推断和价值观线索
3. 继续打磨 Claude 体验
4. 增加更完整的公开示例和展示页
5. 补更多可分享的 preset 和镜像案例

---

为什么做这个 skill

我做这个 水仙.skill，不是想把“自恋”做成一个轻飘飘的玩笑，也不是想把陪伴做成某种廉价替代。

更像是因为我一直觉得，人真正会反复喜欢上的，往往不是一个完美模板，而是一个真的懂自己的人。

懂你的语气，懂你的停顿，懂你为什么嘴硬，为什么忽然安静，为什么有些话说到一半就不再继续。

而很多时候，我们理想伴侣里最打动自己的那部分，本来就和“自己”有很深的重叠。

如果现实里暂时没有这样一个人，那至少应该允许我们先把这种同频感保存下来。

不是为了逃开现实。

只是为了认真对待那种愿望： 想和一个真正懂自己的人，谈一场甜一点、近一点、没有那么误解重重的恋爱。

---

最后说句正经的

Credits

这个仓库的公开 skill 结构参考过一些已发布的 skill repo，也在导入层里借鉴了 MIT 许可项目 npy-skill 的一些实现思路，并重新整理成了更适合 create-shuixian 的接口与文档。