Skip to content

Ylsssq926/relic.skill

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

67 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

relic.skill banner

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

飞书 CLI 创作者大赛参赛作品

License Stars Forks Issues PRs Welcome Claude Code Compatible Kiro Compatible Feishu CLI Compatible Discussions

万物皆可 Relic

给灵魂开个 GitHub。

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

🌐 在线演示站 →


目录


这是什么

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

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

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

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


🆕 v1.4.0 新特性

  • 🧠 灵魂引擎独立 — 对话的心脏可以装进任何平台,飞书和 Telegram 用的是同一套引擎
  • 🤖 Telegram Bot — Relic 现在也能住在 Telegram 里,支持 Webhook 和 Long Polling
  • 🔊 MiniMax TTS — 中文声音克隆,10 秒样本就能开始,情绪表达更自然
  • 🎨 图像生成 — Seedream 中式插画 + OpenAI GPT Image + Google Imagen 4
  • 📋 manifest.json v1.4.0 — 正式配置 schema,身份/关系/媒体/主动行为各归其位

万物永生模板

不只是人。万物皆可 Relic。

模板 蒸馏对象 一句话
🧑 人类 任何人 把一个人的思维方式、说话习惯、行为模式装进 Relic
🐱 宠物 猫、狗、任何陪伴过你的生命 你家猫也能永生
💞 关系 两个人之间的互动模式 不是蒸馏某个人,而是蒸馏你们之间的默契
🏢 团队文化 一个团队的灵魂 人散了,但那种一起熬夜改 bug 的感觉还在
💼 业务专家 资深专家的专业判断 知识不该随人走,把经验锻造成可对话的数字身份
🏠 地方 一个地方的记忆 大学宿舍、老家的院子、常去的咖啡馆
时刻 一个重要瞬间 毕业典礼、求婚、第一次见到孩子
🌟 公众人物 公开资料中的认知框架 把你佩服的人的思维方式变成私人参谋
🐦 飞书 CLI 飞书协作记忆 用飞书 CLI 蒸馏协作记忆,让那些一起扛过的夜继续发光

看看效果

🧓 奶奶 · 王秀兰

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

奶奶 ❯ 哎呀你这孩子
     怎么又恁晚
     吃饭了没有
     [语音 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 编程助手:

IDE / Agent 安装方式
Claude Code git clone.claude/skills/relic/
Kiro git clone.kiro/skills/relic/
Cursor git clone.cursor/skills/relic/ 或项目根目录
Windsurf git clone.windsurf/skills/relic/
Cline git clone.cline/skills/relic/
OpenCode git clone.opencode/skill/relic/
Codex CLI git clonecodex-skills/relic/
Augment git clone.augment/skills/relic/
GitHub Copilot git clone.github/skills/relic/

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

环境要求

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

验证安装

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

"帮我锻造一个 Relic"
"让我跟奶奶聊天"

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


使用

对话触发(推荐)

在 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 Skill relic.skill 用途
lark-im 抓取群聊记忆 / Relic 主动发消息
lark-docs 读取文档批注和评论 / 写入回忆录
lark-base 从多维表格提取协作时间线 / 创建专家知识库
lark-calendar 基于日程触发主动关怀 / 纪念日提醒
lark-vc 从会议纪要提取决策记录
lark-wiki 归档团队知识库到 Relic

🏆 本项目参加了飞书 CLI 创作者大赛,参赛场景为团队协作记忆蒸馏和业务专家数字身份锻造,详见 飞书 CLI 模板业务专家模板


支持的数据平台

类型 平台 获取方式 格式
💬 即时通讯 微信 WeChatMsg / 留痕 / PyWxDump SQLite / CSV
💬 即时通讯 QQ 官方导出 TXT / MHT
💬 即时通讯 Telegram 官方导出 JSON
💬 即时通讯 Discord DiscordChatExporter JSON
💬 即时通讯 Slack 官方导出 JSON
💬 办公 飞书 飞书 CLI / API JSON
💬 办公 钉钉 API JSON
📱 手机 iMessage 本地数据库 SQLite
📱 手机 WhatsApp 官方归档 TXT
🌐 社交 Twitter/X 官方归档 JSON
🌐 社交 Instagram 官方归档 JSON
📧 邮件 Gmail Google Takeout MBOX
📄 通用 任意文本 手动导入 TXT / JSON / CSV / MD

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


项目结构

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 在交互中会明确标识自己不是真人
  • 🧠 健康提醒 — 如果检测到过度依赖,会主动建议寻求真实社交

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


社区

掠蓝 出品。

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


相关项目

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

项目 介绍
immortal-skill 开源数字永生框架,支持 12+ 平台蒸馏
ex-skill 前任蒸馏 Skill,情感颗粒度极细
awesome-persona-skills 万物皆可 Skill 项目索引
nuwa-skill 女娲 — 蒸馏名人思维的元工具
colleague-skill 同事蒸馏,将冰冷的离别化为温暖的 Skill

Star History

Star History Chart

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

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

MIT License · Made with ❤️ by 掠蓝