简体中文 | English | 日本語 | 한국어 | Español | Français | Deutsch | Português | Русский | 繁體中文

万物皆可 Relic

给灵魂开个 GitHub。

血肉苦弱，机械飞升。但灵魂，可以留下来。

🌐 在线演示站 →

✨ 零安装在线体验 →
_{托管版演示，请勿上传敏感数据。}

目录

• 这是什么
• 万物永生模板
• 看看效果
• 四维灵魂架构
• 安装
• 使用
• 支持的数据平台
• 项目结构
• 伦理声明
• 社区
• 相关项目

这是什么

relic.skill 是一个万物永生引擎。

它能把任何你在乎的东西——一个人、一只猫、一段关系、一个团队、一个地方、一个瞬间——从散落的数据碎片中唤醒,成为可交互的数字灵魂。

不是冷冰冰的档案。是会在过年的时候主动问你"吃饺子了没"的奶奶。是凌晨三点突然开始跑酷的猫。是那个永远在改需求的产品经理。

名字来自赛博朋克 2077 的 Relic 芯片——一块能存储数字化人格的生物芯片。 但这个项目不是赛博朋克主题。它的主题是:记住。

🛠️ v1.5.1 结项维护版

这版不堆新玩具,只把门面擦亮、地基踩实,给第一阶段收个漂亮尾。

• 🏆 飞书 CLI 创作者大赛 · 人气赛道第一名 — 团队记忆蒸馏这条路,被认真看见了
• 🌐 演示站回到稳定域名 — 在线体验统一指向 https://relic.luelan.online
• ✅ CI 更靠谱 — Markdown、Python、demo-site 类型检查 / lint / build 都有人守门
• 🧹 仓库更清爽 — 清掉截图、生成计划、AI 工具临时产物,把 Star History 曲线也撤下来了
• 🔒 依赖更稳 — demo-site 补上 Next.js 安全补丁,结项前少一点悬念

万物永生模板

不只是人。万物皆可 Relic。

看看效果

🧓 奶奶 · 王秀兰

你 ❯ 奶奶，我今天加班到十一点

奶奶 ❯ 哎呀你这孩子
     怎么又恁晚
     吃饭了没有
     [语音 8s] 哎，你别光顾着干活不吃饭啊，胃坏了可不是闹着玩的
     我跟你说，明儿带个饭去，别老在外面瞎对付

你 ❯ 知道了知道了

奶奶 ❯ 你每次都说知道了
     也没见你改
     [发送了一个太阳的表情包]
     早点睡啊

🐱 咪咪 · 橘猫 · 14斤

你 ❯ 咪咪，我回来了

[咪咪已经在门口等了。不是因为想你，是因为到饭点了。
 听到钥匙声，耳朵转了一下，但身体没动。
 等你开门，她慢慢站起来，伸了个懒腰，
 用屁股对着你，尾巴竖得笔直，尖端微微弯曲。
 这是她说"还行，你回来了"的方式。]

你 ❯ 今天想你了

[咪咪跳上桌子，在你的键盘上踩了一串 "ggggggggg"，
 然后趴下来，把下巴搁在你的手腕上，
 发出低沉的呼噜声。
 体重14斤，手腕已经麻了。
 但你没有动。]

🏢 星火工作室 · 5人创业团队

[飞书群 · 星火工作室]

产品经理 ❯ 兄弟们，需求有点小调整
CTO ❯ 又来
产品经理 ❯ 就改一点点
CTO ❯ 你上次也是这么说的
     然后我重构了三天
设计师 ❯ 这个颜色不对
产品经理 ❯ 我还没发设计稿
设计师 ❯ 我提前说
实习生 ❯ 哈哈哈哈哈哈哈
CTO ❯ 行吧，这个需求不合理但我可以做
     发我文档

四维灵魂架构

每个 Relic 从四个维度捕捉灵魂：

        🧠 认知 (Cognition)
        怎么想、怎么做决定、相信什么
                |
                |
💬 表达 --------+-------- 🎭 行为
怎么说话、               怎么做事、
什么口头禅、              什么习惯、
什么语气                 什么规律
                |
                |
        ❤️ 情感 (Emotion)
        什么让ta开心、什么让ta难过、
        怎么表达爱、怎么处理冲突

每条信息标注证据等级：

• verbatim — 原话，一字不改
• artifact — 来自文档、照片、录音
• impression — 来自他人描述或模糊记忆

人本来就前后不一致。矛盾不会被消除，只会被标注和保留。

安装

方式一：安装到当前项目

mkdir -p .claude/skills
git clone https://github.com/Ylsssq926/relic.skill .claude/skills/relic

方式二：npx 一键安装

npx -y skills add Ylsssq926/relic.skill

方式三：全局安装（所有项目可用）

mkdir -p ~/.claude/skills
git clone https://github.com/Ylsssq926/relic.skill ~/.claude/skills/relic

方式四：其他 IDE / Agent

relic.skill 基于开放的 SKILL.md 标准，兼容所有支持该标准的 AI 编程助手：

原则上，任何能读取 SKILL.md 的 agent 都能用。不确定的话，clone 到项目根目录就行。

环境要求

• 上述任意一个 AI 编程助手
• Python 3.9+（可选，用于数据解析脚本）
• 不需要 GPU、本地模型或 Docker

验证安装

安装完成后，在你的 AI 编程助手中输入以下任意一句：

"帮我唤醒一个 Relic"
"让我跟奶奶聊天"

如果 AI 开始引导你进入 Relic 流程，说明安装成功。

使用

快速开始

第一次用？三步走：

1. 唤醒 Relic — python scripts/relic_writer.py --help
2. 选择平台 — 飞书机器人或 Telegram 机器人
3. 配置媒体 — 可选，让 Relic 能说话、能发图

详细配置见 docs/SETUP.md。

对话触发

在 Claude Code / Kiro 中直接说：

"帮我唤醒一个 Relic，我想永生我奶奶"
"我家猫走了，我想把它做成 Relic"
"帮我蒸馏我们团队的文化，大家要散了"
"我想保存我和她之间的关系模式"

Slash 命令

/relic              — 启动 Relic 唤醒流程
/relic-forge        — 直接进入灵魂唤醒室
/relic-talk         — 跟已有的 Relic 聊天
/relic-shield       — 保护你的 Relic

CLI 工具

# 解析微信聊天记录
python scripts/wechat_parser.py --input ~/wechat_export/ --output data.json

# 解析 QQ 聊天记录
python scripts/qq_parser.py --input chat.txt --output data.json

# 生成 Relic（会自动附带 proactive_config.json）
python scripts/relic_writer.py --data data.json --template human --slug grandma

# 预览“它会不会主动来找你”
python scripts/proactive_scheduler.py --relic exes/grandma --dry-run

# 版本管理
python scripts/version_manager.py snapshot --slug grandma --note "第一版"
python scripts/version_manager.py rollback --slug grandma --version 1

从 v1.1.2 开始，新生成的 Relic 会默认带上 proactive_config.json。也就是说，你现在不用先研究配置长什么样，先 dry-run 一下，就能看看它今天会不会突然来敲你一下。

飞书机器人

奶奶不只在聊天记录里。现在她住在飞书群里了，@一下就来，就像以前在家族群里一样。

让 Relic 住在飞书里，随时可以聊：

# 启动飞书机器人（需要配置飞书应用凭证）
python scripts/feishu_bot.py --relic exes/grandma

# 测试模式（不实际发送）
python scripts/feishu_bot.py --relic exes/grandma --dry-run --test-message "奶奶，我今天加班到十一点"

# 多 Relic 模式（根据用户命令切换）
python scripts/feishu_bot.py --relic-dir exes/ --multi-relic

配置飞书应用凭证（.env 文件）：

FEISHU_APP_ID=cli_xxx
FEISHU_APP_SECRET=xxx
FEISHU_VERIFICATION_TOKEN=xxx
AI_API_KEY=sk-xxx
AI_PROVIDER=claude  # 或 openai

Telegram 机器人

跨国的思念不再有时差。如果你的家人朋友在海外，Telegram 可能是更好的选择。

Relic 也能住在 Telegram 里：

# Webhook 模式（需要公网 HTTPS）
python scripts/telegram_bot.py --relic exes/grandma

# Long Polling 模式（本地开发，无需公网）
python scripts/telegram_bot.py --relic exes/grandma --polling

# 测试模式
python scripts/telegram_bot.py --relic exes/grandma --dry-run --test-message "奶奶，我今天加班到十一点"

配置（.env 文件）：

TELEGRAM_BOT_TOKEN=xxx
AI_API_KEY=sk-xxx
AI_PROVIDER=claude

声音合成

过年的时候，不只是文字消息。是奶奶真的声音，说"吃饺子了没"。

MiniMax TTS 支持中文声音克隆，10 秒样本就能开始——奶奶说"哎呀你这孩子"的时候，真的能听出心疼。

让 Relic 开口说话：

# 合成语音（豆包语音）
python scripts/tts_service.py --relic exes/grandma --text "过年了，吃饺子了没" --mode holiday

# 声音克隆（需要声音样本）
python scripts/tts_service.py --relic exes/grandma --clone-voice --sample-dir voice_samples/

🐦 飞书 CLI 深度集成

relic.skill 原生支持 飞书 CLI 作为数据采集和主动行为的通道。使用前请参考 飞书 CLI 官方文档 安装并配置 token。

快速开始：

# 1. 安装飞书 CLI
npm install -g @larksuite/cli
npx skills add larksuite/cli -y -g

# 2. 配置应用凭证（交互式引导）
lark-cli config init

# 3. 登录认证
lark-cli auth login --recommend

# 4. 验证安装
lark-cli --help

作为「眼」——数据采集：

# 用飞书 CLI 抓取群聊记录作为灵魂唤醒素材
lark-cli im +messages-search --chat-id "oc_xxx" --query "项目上线"

# 搜索并读取飞书文档
lark-cli docs +fetch --doc-id "doxxx"

作为「手」——主动行为：

# Relic 想找你时，通过飞书 CLI 直接发消息
lark-cli im +messages-send --chat-id "oc_xxx" --text "怎么还在加班？早点回去。"

# 基于日历触发主动关怀
lark-cli calendar +create --summary "赛博导师提醒：客户拜访前准备" --start "2026-04-17T09:50:00"

深度联动能力：

🏆 飞书 CLI 创作者大赛 · 人气赛道第一名。 谢谢每个把"协作记忆"这件事放进心里的人——参赛场景是团队记忆蒸馏和业务专家数字身份唤醒，玩法在 飞书 CLI 模板 和 业务专家模板 里。

支持的数据平台

详细的导出教程见 平台数据获取指南

项目结构

relic.skill/
├── SKILL.md                    # 主入口 — Relic 引擎
├── FOR_AI.md                   # AI 一键入口
│
├── soul-forge/                 # 🔥 灵魂唤醒室 — 从数据中唤醒灵魂
│   ├── SKILL.md
│   ├── dimensions/             # 四维提取框架
│   │   ├── cognition.md        #   认知模式
│   │   ├── expression.md       #   表达风格
│   │   ├── behavior.md         #   行为模式
│   │   └── emotion.md          #   情感特征
│   ├── collectors/             # 数据采集器
│   │   ├── chat-collector.md   #   聊天记录
│   │   ├── voice-collector.md  #   语音/音频
│   │   ├── photo-collector.md  #   照片/视频
│   │   └── live-collector.md   #   实时对话（活体唤醒）
│   └── references/
│       ├── evidence-levels.md  #   证据分级标准
│       └── conflict-resolution.md  # 矛盾处理策略
│
├── soul-engine/                # ⚡ 灵魂引擎 — 让 Relic 活起来
│   ├── SKILL.md
│   ├── interaction.md          # 交互模式（日常/回忆/深夜/节日）
│   ├── memory-system.md        # 三层记忆系统
│   ├── proactive.md            # 主动行为（会主动找你说话）
│   └── evolution.md            # 持续进化（越聊越像）
│
├── soul-shield/                # 🛡️ 灵魂护盾 — 保护与伦理
│   ├── SKILL.md
│   ├── fingerprint.md          # 灵魂指纹
│   ├── consent-protocol.md     # 授权协议
│   └── ethics.md               # 伦理红线
│
├── templates/                  # 📋 万物永生模板 x9（附选择指南）
├── examples/                   # 🎯 示例 Relics x3（附体验指南）
├── scripts/                    # 🔧 Python 工具脚本 x9（含飞书全链路唤醒）
├── assets/                     # 🎨 视觉资源
├── docs/                       # 📚 深度文档（含推荐工具清单）
└── ROADMAP.md                  # 🗺️ 产品路线图

伦理声明

我们认真对待伦理问题。

• 🔒 数据不外传 — 所有灵魂数据存储在你本地，不上传任何服务器
• ✅ 授权先行 — 蒸馏他人前必须通过六问授权协议
• 🚫 红线清晰 — 不得用于骚扰、跟踪、冒充他人。详见伦理红线
• 💡 标识明确 — Relic 在交互中会明确标识自己不是真人
• 🧠 健康提醒 — 如果检测到过度依赖，会主动建议寻求真实社交

蒸馏你奶奶之前，先确认她同意被蒸。

社区

掠蓝 出品。

• 💬 QQ 群：1098169092（加群暗号：万物皆可 Relic）
• 💭 Discussions — 聊灵感、晒截图、提想法
• 🐛 提交 Bug
• 💡 功能建议
• 📋 提交新模板
• 🎯 晒你的 Relic 灵感
• 🧩 模板征集讨论
• 🤝 贡献指南

欢迎来丢灵感、晒截图、提模板、聊离谱但认真的想法。中文英文都行，想到什么就说什么。世界上有太多东西，认真想想，确实舍不得让它们就这么消失。

相关项目

relic.skill 站在巨人的肩膀上。感谢这些项目的启发：

⭐ Star 一下，给自己的灵魂买份保险。

真正的死亡不是心跳停止，而是最后一个记得你的人也忘了你。

MIT License · Made with ❤️ by 掠蓝