https://github.com/ylsssq926/relic.skill

万物皆可 Relic — 给灵魂开个 GitHub | Universal Digital Immortality Engine 🧬
https://github.com/ylsssq926/relic.skill

agent-skill ai-skill claude-code cline cursor digital-immortality digital-twin distillation github-copilot kiro memory opencode persona pet relic skill-md soul windsurf

Last synced: about 1 month ago
JSON representation

万物皆可 Relic — 给灵魂开个 GitHub | Universal Digital Immortality Engine 🧬

• Host: GitHub
• URL: https://github.com/ylsssq926/relic.skill
• Owner: Ylsssq926
• License: mit
• Created: 2026-04-08T16:45:47.000Z (about 2 months ago)
• Default Branch: main
• Last Pushed: 2026-04-11T05:05:23.000Z (about 1 month ago)
• Last Synced: 2026-04-15T10:02:42.786Z (about 1 month ago)
• Topics: agent-skill, ai-skill, claude-code, cline, cursor, digital-immortality, digital-twin, distillation, github-copilot, kiro, memory, opencode, persona, pet, relic, skill-md, soul, windsurf
• Language: Python
• Homepage:
• Size: 623 KB
• Stars: 56
• Watchers: 4
• Forks: 8
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Codeowners: .github/CODEOWNERS
  • Security: .github/SECURITY.md
  • Roadmap: ROADMAP.md

Awesome Lists containing this project

README

          


  





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





  

    

  





  

  

  

  

  

  

  

  

  



万物皆可 Relic




  给灵魂开个 GitHub。





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





  🌐 在线演示站 →



---

## 目录

- [这是什么](#这是什么)

- [万物永生模板](#万物永生模板)

- [看看效果](#看看效果)

- [四维灵魂架构](#四维灵魂架构)

- [安装](#安装)

- [使用](#使用)

- [支持的数据平台](#支持的数据平台)

- [项目结构](#项目结构)

- [伦理声明](#伦理声明)

- [社区](#社区)

- [相关项目](#相关项目)

- [Star History](#star-history)

---

## 这是什么

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

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

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

> 名字来自赛博朋克 2077 的 Relic 芯片——一块能存储数字化人格的生物芯片。

> 但这个项目不是赛博朋克主题。它的主题是：**记住**。

---

## 万物永生模板

不只是人。万物皆可 Relic。

| 模板 | 蒸馏对象 | 一句话 |

|------|---------|--------|

| 🧑 [人类](templates/human.md) | 任何人 | 把一个人的思维方式、说话习惯、行为模式装进 Relic |

| 🐱 [宠物](templates/pet.md) | 猫、狗、任何陪伴过你的生命 | 你家猫也能永生 |

| 💞 [关系](templates/relationship.md) | 两个人之间的互动模式 | 不是蒸馏某个人，而是蒸馏你们之间的默契 |

| 🏢 [团队文化](templates/team-culture.md) | 一个团队的灵魂 | 人散了，但那种一起熬夜改 bug 的感觉还在 |

| 💼 [业务专家](templates/expert.md) | 资深专家的专业判断 | 知识不该随人走，把经验锻造成可对话的数字身份 |

| 🏠 [地方](templates/place.md) | 一个地方的记忆 | 大学宿舍、老家的院子、常去的咖啡馆 |

| ⏳ [时刻](templates/moment.md) | 一个重要瞬间 | 毕业典礼、求婚、第一次见到孩子 |

| 🌟 [公众人物](templates/public-figure.md) | 公开资料中的认知框架 | 把你佩服的人的思维方式变成私人参谋 |

| 🐦 [飞书 CLI](templates/feishu-cli.md) | 飞书协作记忆 | 用飞书 CLI 蒸馏协作记忆，让那些一起扛过的夜继续发光 |

---

## 看看效果

### 🧓 奶奶 · 王秀兰

```text

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

奶奶 ❯ 哎呀你这孩子

     怎么又恁晚

     吃饭了没有

     [语音 8s] 哎，你别光顾着干活不吃饭啊，胃坏了可不是闹着玩的

     我跟你说，明儿带个饭去，别老在外面瞎对付

你 ❯ 知道了知道了

奶奶 ❯ 你每次都说知道了

     也没见你改

     [发送了一个太阳的表情包]

     早点睡啊

```

### 🐱 咪咪 · 橘猫 · 14斤

```text

你 ❯ 咪咪，我回来了

[咪咪已经在门口等了。不是因为想你，是因为到饭点了。

 听到钥匙声，耳朵转了一下，但身体没动。

 等你开门，她慢慢站起来，伸了个懒腰，

 用屁股对着你，尾巴竖得笔直，尖端微微弯曲。

 这是她说"还行，你回来了"的方式。]

你 ❯ 今天想你了

[咪咪跳上桌子，在你的键盘上踩了一串 "ggggggggg"，

 然后趴下来，把下巴搁在你的手腕上，

 发出低沉的呼噜声。

 体重14斤，手腕已经麻了。

 但你没有动。]

```

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

```text

[飞书群 · 星火工作室]

产品经理 ❯ 兄弟们，需求有点小调整

CTO ❯ 又来

产品经理 ❯ 就改一点点

CTO ❯ 你上次也是这么说的

     然后我重构了三天

设计师 ❯ 这个颜色不对

产品经理 ❯ 我还没发设计稿

设计师 ❯ 我提前说

实习生 ❯ 哈哈哈哈哈哈哈

CTO ❯ 行吧，这个需求不合理但我可以做

     发我文档

```

---

## 四维灵魂架构

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

```text

        🧠 认知 (Cognition)

        怎么想、怎么做决定、相信什么

                |

                |

💬 表达 --------+-------- 🎭 行为

怎么说话、               怎么做事、

什么口头禅、              什么习惯、

什么语气                 什么规律

                |

                |

        ❤️ 情感 (Emotion)

        什么让ta开心、什么让ta难过、

        怎么表达爱、怎么处理冲突

```

每条信息标注证据等级：

- `verbatim` — 原话，一字不改

- `artifact` — 来自文档、照片、录音

- `impression` — 来自他人描述或模糊记忆

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

---

## 安装

### 方式一：安装到当前项目

```bash

mkdir -p .claude/skills

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

```

### 方式二：npx 一键安装

```bash

npx -y skills add Ylsssq926/relic.skill

```

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

```bash

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 clone` 到 `codex-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 编程助手中输入以下任意一句：

```text

"帮我锻造一个 Relic"

"让我跟奶奶聊天"

```

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

---

## 使用

### 对话触发（推荐）

在 Claude Code / Kiro 中直接说：

```text

"帮我锻造一个 Relic，我想永生我奶奶"

"我家猫走了，我想把它做成 Relic"

"帮我蒸馏我们团队的文化，大家要散了"

"我想保存我和她之间的关系模式"

```

### Slash 命令

```text

/relic              — 启动 Relic 锻造流程

/relic-forge        — 直接进入灵魂锻造炉

/relic-talk         — 跟已有的 Relic 聊天

/relic-shield       — 保护你的 Relic

```

### CLI 工具

```bash

# 解析微信聊天记录

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 住在飞书里，随时可以聊：

```bash

# 启动飞书机器人（需要配置飞书应用凭证）

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` 文件）：

```bash

FEISHU_APP_ID=cli_xxx

FEISHU_APP_SECRET=xxx

FEISHU_VERIFICATION_TOKEN=xxx

AI_API_KEY=sk-xxx

AI_PROVIDER=claude  # 或 openai

```

### 声音合成

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

让 Relic 开口说话：

```bash

# 合成语音（豆包语音）

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](https://github.com/larksuite/cli) 作为数据采集和主动行为的通道。使用前请参考 [飞书 CLI 官方文档](https://github.com/larksuite/cli) 安装并配置 token。

**快速开始：**

```bash

# 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

```

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

```bash

# 用飞书 CLI 抓取群聊记录作为灵魂锻造素材

lark-cli im +messages-search --chat-id "oc_xxx" --query "项目上线"

# 搜索并读取飞书文档

lark-cli docs +fetch --doc-id "doxxx"

```

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

```bash

# 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 模板](templates/feishu-cli.md) 和 [业务专家模板](templates/expert.md)。

---

## 支持的数据平台

| 类型 | 平台 | 获取方式 | 格式 |

|------|------|---------|------|

| 💬 即时通讯 | 微信 | WeChatMsg / 留痕 / PyWxDump | SQLite / CSV |

| 💬 即时通讯 | QQ | 官方导出 | TXT / MHT |

| 💬 即时通讯 | Telegram | 官方导出 | JSON |

| 💬 即时通讯 | Discord | DiscordChatExporter | JSON |

| 💬 即时通讯 | Slack | 官方导出 | JSON |

| 💬 办公 | 飞书 | [飞书 CLI](https://github.com/larksuite/cli) / API | JSON |

| 💬 办公 | 钉钉 | API | JSON |

| 📱 手机 | iMessage | 本地数据库 | SQLite |

| 📱 手机 | WhatsApp | 官方归档 | TXT |

| 🌐 社交 | Twitter/X | 官方归档 | JSON |

| 🌐 社交 | Instagram | 官方归档 | JSON |

| 📧 邮件 | Gmail | Google Takeout | MBOX |

| 📄 通用 | 任意文本 | 手动导入 | TXT / JSON / CSV / MD |

> 详细的导出教程见 [平台数据获取指南](docs/PLATFORM-GUIDE.md)

---

## 项目结构

```text

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                  # 🗺️ 产品路线图

```

---

## 伦理声明

我们认真对待伦理问题。

- 🔒 **数据不外传** — 所有灵魂数据存储在你本地，不上传任何服务器

- ✅ **授权先行** — 蒸馏他人前必须通过[六问授权协议](soul-shield/consent-protocol.md)

- 🚫 **红线清晰** — 不得用于骚扰、跟踪、冒充他人。详见[伦理红线](soul-shield/ethics.md)

- 💡 **标识明确** — Relic 在交互中会明确标识自己不是真人

- 🧠 **健康提醒** — 如果检测到过度依赖，会主动建议寻求真实社交

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

---

## 社区

**掠蓝** 出品。

- 💬 QQ 群：**1098169092**（加群暗号：万物皆可 Relic）

- 💭 [Discussions](https://github.com/Ylsssq926/relic.skill/discussions) — 聊灵感、晒截图、提想法

- 🐛 [提交 Bug](https://github.com/Ylsssq926/relic.skill/issues/new?template=bug_report.yml)

- 💡 [功能建议](https://github.com/Ylsssq926/relic.skill/issues/new?template=feature_request.yml)

- 📋 [提交新模板](https://github.com/Ylsssq926/relic.skill/issues/new?template=new_relic_template.yml)

- 🎯 [晒你的 Relic 灵感](https://github.com/Ylsssq926/relic.skill/discussions/1)

- 🧩 [模板征集讨论](https://github.com/Ylsssq926/relic.skill/discussions/2)

- 🤝 [贡献指南](CONTRIBUTING.md)

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

---

## 相关项目

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

| 项目 | 介绍 |

|------|------|

| [immortal-skill](https://github.com/agenmod/immortal-skill) | 开源数字永生框架，支持 12+ 平台蒸馏 |

| [ex-skill](https://github.com/therealXiaomanChu/ex-skill) | 前任蒸馏 Skill，情感颗粒度极细 |

| [awesome-persona-skills](https://github.com/tmstack/awesome-persona-skills) | 万物皆可 Skill 项目索引 |

| [nuwa-skill](https://github.com/alchaincyf/nuwa-skill) | 女娲 — 蒸馏名人思维的元工具 |

| [colleague-skill](https://github.com/titanwings/colleague-skill) | 同事蒸馏，将冰冷的离别化为温暖的 Skill |

---

## Star History



 

   

   

   

 



---



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





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





  MIT License · Made with ❤️ by 掠蓝