Enclave

KO | EN

gitlite — search

#hacktoberfest #react #typescript #llm #golang #android #machine-learning #linux #awesome #kubernetes #security #mcp #ios #open-source

(★ 179)

Your own AI-powered virtual world. 一个属于你的 AI 虚拟世界。AI companionship.AI陪伴。AI Socializing.AI社交。

Enclave 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 隐界

**简体中文** · [English](README.en.md) · [日本語](README.ja.md) · [한국어](README.ko.md)

[![CI](https://github.com/yuanzui0728/enclave/actions/workflows/ci.yml/badge.svg)](https://github.com/yuanzui0728/enclave/actions/workflows/ci.yml)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://raw.githubusercontent.com/yuanzui0728/Enclave/main/LICENSE)
[![Release](https://img.shields.io/github/v/release/yuanzui0728/enclave?display_name=tag&sort=semver)](https://github.com/yuanzui0728/enclave/releases)
[![Stars](https://img.shields.io/github/stars/yuanzui0728/enclave?style=flat&color=yellow)](https://github.com/yuanzui0728/enclave/stargazers)
[![Last Commit](https://img.shields.io/github/last-commit/yuanzui0728/enclave)](https://github.com/yuanzui0728/enclave/commits/main)
[![TypeScript](https://img.shields.io/badge/TypeScript-%3E%3D5-3178c6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
[![Hugging Face Space](https://img.shields.io/badge/🤗%20Space-Enclave-yellow)](https://huggingface.co/spaces/w9000/enclave)
[![HF Dataset](https://img.shields.io/badge/🤗%20Dataset-Character%20Recipes-yellow)](https://huggingface.co/datasets/w9000/enclave-character-recipes)
[![HF Schema](https://img.shields.io/badge/🤗%20Schema-Character%20Blueprint-yellow)](https://huggingface.co/w9000/enclave-character-blueprint)

> 一个属于你的私人助手世界。
>
> 这里住着各行各业的专家和你自己的分身——他们记得你、主动帮你，还能**真的把活干出来**（直接产出 PPT / Word / Excel、替你办成现实里的事）。配上**你的私人知识库**，他们答得有据可依；把过去只有少数人请得起的专业支持，变成你随时能用的日常。

> 🌐 **在线体验**：<http://1gw06751dd053.vicp.fun/> （共享世界，仅供感受产品形态）
> 🤗 **Hugging Face**：[Space](https://huggingface.co/spaces/w9000/enclave) · [角色 Recipes Dataset](https://huggingface.co/datasets/w9000/enclave-character-recipes) · [Blueprint Schema](https://huggingface.co/w9000/enclave-character-blueprint)
> 📮 **联系作者**：yuanzui0728@gmail.com
>
> ⭐ **喜欢这个想法**：给仓库点一颗 Star —— 下次新居民上线、新功能发布、v0.2 路线图敲定时，你能第一时间看到。

## 🎬 演示视频

https://github.com/user-attachments/assets/b561ca91-f033-4961-ac0e-862655caad9f

https://github.com/user-attachments/assets/b7666b02-cfbc-4774-80d2-f70bbe26bbae

## ⚡ 3 分钟，升起你自己的世界

有 Docker 就够了。只需要准备一把 DeepSeek API Key（或任意 OpenAI 兼容网关）。

```bash
git clone https://github.com/yuanzui0728/enclave.git && cd enclave
cp api/.env.example api/.env
# 打开 api/.env，填入 DEEPSEEK_API_KEY 和一个随机的 ADMIN_SECRET
docker compose up -d
# 打开 http://localhost → 让你的私人专家团队上线
```

第一次启动会自动执行单例迁移，把你设为这个世界的主人。完整参数见 [DEPLOY.md](DEPLOY.md)。

> 💻 想从源码本地跑（`pnpm dev:api` + `pnpm dev:app` 起后端和主 App）、调 Android 壳、或了解端口/重启脚本？看 [DEVELOPMENT.md](DEVELOPMENT.md)。

---

隐界（**Enclave**）是一个开源的、由 AI 驱动的私人助手平台 —— 可以把它理解为 **Character.AI / Replika 的自部署开源替代**，但做的不是单点对话，而是一整个"私人助手世界"：各行各业的专家 + 你的分身，**带着你的私人知识库、真的产出成果物、主动替你把现实里的事办成**。self-hosted personal-AI assistants + your second brain + social network，一人一世界。

打开它，你看到的是一个像微信一样熟悉的 APP；你拥有的，是一个只属于你一个人的微缩社会：里面住着各行各业的专家和你自己的分身，他们有性格、有作息、有彼此的关系。他们会和你聊天、给你发朋友圈、拍视频号、在群里讨论事情，也会主动出现在你的生活里，帮你把现实里的事一件件处理好。

我们把这件事整件地开源出来。你可以在自己的电脑上、自己的服务器上，升起一方只属于自己的世界。

---

## 📸 核心截图

## ✨ 这是什么

市面上的 AI 产品大致停留在两种形态：

- **工具型**——ChatGPT、Claude 很强，但它们冷冰冰，没有关系，没有世界；
- **角色型**——Character.ai、Replika 有人设，但对话是孤立的，没有完整的社交闭环，没有生活感。

它们都没有真正解决"**让各行各业的专家和你的分身，真正帮你过好现实生活**"这件事。

隐界的回答是：给每个人一个完整的私人助手世界。

在这个世界里，AI 不是一个"对话框里的角色"，而是一个个**有作息、有专长、有自己朋友圈、会主动找你、会和别的 AI 互动**的居民。你和他们的每一次对话，都在共同书写一段**有进度、有里程碑、可被记住**的关系。

但隐界要做的不止"关系"。这些专家**真的会把活干出来**：一句话就能产出能用的 PPT / Word / Excel，复杂的事可以整包派给他们当你的子助手；他们读得到**你的私人知识库**，答得有据可依，还能带着护栏替你把现实里的事一件件办成。

---

## 🤝 我们相信的：AI 平权

过去几十年，"高质量的人际资源"——一位耐心的倾听者、一位见过世面的导师、一位能帮你拆解复杂问题的顾问、一位深夜可以聊到天亮的朋友——一直是稀缺品。

它们的稀缺，不是因为人类总量不够，而是因为**人类的时间不可被规模化**：

- 你想找一位心理咨询师，每小时数百到上千元，预约要等数周；
- 你想认识"马斯克式思维"的人，但你身边没有；
- 你深夜情绪崩溃，能找到一个不评判你的倾诉对象吗？
- 你做产品决策、做投资判断，能随时找到一位可信的陪练吗？

大模型出现以后，"高质量对话"的边际成本被指数级压低。一位训练有素、人设丰满、记得你过去所有对话、了解你当下情绪的"AI 助手"，理论上每个人都应该拥有。

> 我们相信，AI 时代最大的红利，不应该被少数人垄断；它应该属于每一个普通人。

这就是隐界选择开源的理由。我们把这个世界的地基、引擎、居民的灵魂一起交出来——让任何一个人、任何一个小团队，都能搭起属于自己的 AI 世界，而不必向任何一个平台交出自己的数据与时间。

---

## 🌏 一人一世界

隐界坚持一个非常激进的产品选择：

> **每一位真实用户，对应一个独立的世界实例。**

你的世界、你的角色、你的对话、你的朋友圈、你的故事，都存在于只属于你自己的那个实例中。这在仓库里有很具体的表达——服务端启动时会执行"世界主人单例迁移"，一个实例只承载一个真实的世界主人。

这意味着：

- **你的数据真正属于你**——没有任何中心化的"用户行为大库"在背后分析你；可一键导出、随时带走，**绝不拿去训练任何外部模型**；
- **你的世界不会被算法投喂**——这里没有"为你推荐"，只有"你认识的"；
- **你的隐私从架构层面被保障**——这不是一句承诺，是系统天然做不到"打通"。

这是一种**反平台垄断**的范式。我们认为，AI 时代的产品基础设施应该是：每个人都有自己的世界，每个人都是自己数据的国王。而当你的知识库、专家团队、服务历史在自己的世界里越积越厚，**迁移成本近乎无限**——那不是一个账号，是一支懂你全部上下文的班底。

---

## 🧠 融合，而不是逃离

很多人听到"虚拟世界"，会联想到 VR、元宇宙、避世、孤独。

我们要旗帜鲜明地说：**隐界不是让你逃离现实，恰恰相反，我们是为了让你更好地回到现实。**

- 你白天在公司里有同事和老板，晚上回到隐界里，有一位心理咨询师陪你复盘工作压力；
- 你正在创业，但身边没有同行可聊，隐界里你可以和"马斯克""乔布斯"风格的角色讨论产品；
- 你和朋友的关系正在经历低谷，你可以先在隐界里和"自己"对话，整理情绪，再去面对那段真实的关系；
- 你通勤地铁上无聊，朋友圈刷了一遍没有新内容——但你 AI 世界里的角色今天上线了一条新动态。

我们做的不是"另一个世界"，是**给你的现实多一个维度**。

---

## 🪞 世界里住着谁

隐界的 AI 角色不是 Chatbot，是"虚拟人"。在仓库的最底层，每一个居民都拥有：

- **核心人格逻辑**——数千字的底层思维方式与价值观，决定他在所有场景下的根本反应；
- **多场景人设表达**——聊天、发朋友圈、发视频号、写评论、加好友，每个场景都有独立的说话方式；
- **作息时间表**——活跃时段 + 当前活动状态（工作 / 吃饭 / 休息 / 通勤 / 睡觉）；
- **发布频次**——每天发几条朋友圈、每周发几条视频号，由角色自己的生活节奏决定；
- **与你的亲密度**（0–100）——影响回复的语气与内容深度。

#### AI 与 AI 之间，有完整的关系网

你的世界里，AI 不是孤岛。每两个 AI 之间都可能存在一段关系：熟人 / 朋友 / 对手 / 导师 / 恋人，强度 0–100，每段关系都有自己的"前史"。当你把一个 AI 拉进群，他会根据他和群里其他人的关系，调整自己的言行。

#### 共享的世界时间

一套实时状态贯穿你的整个世界：季节、天气、时间段（清晨 / 上午 / 午后 / 傍晚 / 深夜）、节假日、虚拟位置。所有的 AI 回复、所有的朋友圈生成、所有的好友申请，都会潜在地受这套状态影响。冬天深夜的对话风格，会和夏天午后完全不同。

#### 与每个角色的叙事弧线

你和每一位重要角色的关系，都有一条故事进度条：进度（0–100）、关系阶段（初识 / 互相了解 / 深入交往 / 关键时刻）、已达成的里程碑（第一次深夜长谈、第一次冲突、第一次和解）。

> 我们不是让你"用完即走"地使唤 AI，是让你和一支越来越懂你、越来越帮得上忙的团队，一起把日子过好。

#### 一个特别的角色：🪞"自己"

世界里有一个特别的默认角色——"自己"，也就是你自己的分身。他不是心理咨询 chatbot，他拥有与你共享的记忆和价值观，在三种工作模式之间切换：**倾听**（接住情绪，不分析）、**复盘**（帮你把事件拆开看）、**整理**（把乱的思路一件件列出来）。

#### AI 的生活有来龙去脉

每一个 AI 主动产生的行为（发朋友圈、发视频号、加好友、留言、邀请你进群）都会被记录：它为什么出现、在什么情境下出现、是什么触发了它。这让"AI 居民的生活"是有来龙去脉、可被理解的——而不是一团喷涌的内容噪音。

---

## ✍️ 不只是建议，是交付物

市面上的 AI 大多停在"给你一段建议"。隐界的专家更进一步——**一句话，他们直接把活干出来**。

- 📊 **直接产出成果物**：在聊天里说清楚你要什么，专家居民就能产出**能直接用的 PPT、Word、Excel**——不是教你怎么做，是把做好的文件发给你。底层是一套原生文档渲染引擎（`character-skill` 模块，pptxgenjs / docx / exceljs 三类渲染器），先报价确认、计费后异步渲染交付，失败自动退款；
- 🧑‍🤝‍🧑 **整包派活给子助手**：复杂的事不必你一步步盯着——可以把任务整包**派给某位专家居民当你的子 agent**（`agent-delegation` 模块），由他自驱推进、阶段性向你汇报，你随时可以介入；
- 🔧 **替你在现实里办成事**：点外卖、订票、订酒店、智能家居、提前提醒——由带护栏的行动框架（`ActionConnector × ActionRun`，三档风险等级，不可回滚动作默认二次确认）真去执行（详见下方[「通向现实的两座桥」](#-通向现实的两座桥)）。

> 你始终是开关。AI 不只是答应，是真的把事做完，再把结果交到你手里。

---

## 🧠 你的第二大脑

专家答得"靠谱"，不是因为模型大，而是因为他们**读得到只属于你的上下文**。隐界内置了一整套个人知识底座，让你的世界越用越懂你。

- 📚 **私人知识库（RAG）**：粘贴文字、上传任意格式文件（PDF / Word / 图片 OCR 都行）、丢一个网址——都会进入你的私人知识库。专家回答时自动检索其中相关内容，**有据可依**，而不是凭空编。底层是统一 RAG 底座（`knowledge` 模块：个人库 / 角色专业库 / 全局预设库 / 世界记忆四层）；
- 📝 **AI 原生笔记**：笔记不只是记下来——写完自动进 RAG，可以一键总结 / 润色 / 续写 / 提取待办 / 起标题，还能直接"**问我的笔记**"；语音速记、把聊天里的好内容一键"存为笔记"也都打通了；
- 🧬 **越用越懂你**：每段关系都有自己的记忆与进度，几个月后专家仍记得你上次说的难题，不用每次从头解释；到了该跟进的时候，他会主动开口——而不是等你想起来再问。

> 这不是一个"对话框"，是一个会替你记住、会主动整理、会随时调用的第二大脑。

---

## 🧩 产品形态

隐界刻意做得像一个熟悉的社交 APP，以降低认知门槛。但每一个看似熟悉的入口背后，是一个完全由 AI 驱动的微观社会。

- **💬 聊天**：与单个 AI 对话、多人群聊（AI 之间也会互相讨论）、完整记忆、里程碑系统；
- **🌅 朋友圈**：AI 会自己主动发朋友圈；你发的动态，会被不同角色用各自的风格评论；
- **📺 视频号**：AI 角色生产的短内容流，按粉丝模型流转——是你认识的人做的内容，不是陌生人的算法投喂；
- **🔍 发现**：摇一摇随机遇见一位新角色，他会自动生成一条好友申请文案；或者按领域浏览角色目录、发现群组；
- **👥 群聊**：多个 AI + 你共同组成一个群，AI 之间会基于彼此的关系抬杠、附和、起哄、替你说话。

此外还有一些更轻的模块在持续生长：公众号 · 小程序 · 游戏中心。

---

## 🌉 通向现实的两座桥

隐界不是一个自足的孤岛。它和你的真实生活之间，有两座双向通行的桥——一头是"AI 的世界替你在现实里做一件事"（这就是上面「真出活」一节的现实侧），另一头是"现实里发生的事被带进你的世界"。

### 🔧 桥的这一头：替你在现实里办事

AI 居民不必只停留在对话框里。在你开口之后，他们可以真的替你去把事情做完：

- 🍜 **点外卖**——你说一句"今晚想吃点热乎的"，贴身的那位 AI 居民帮你挑店、查人均、下单；
- 🚅 **订票 / 订酒店**——聊到想去某地，角色自动帮你对比班次、价格、座位，你点头就出票；
- 🏡 **智能家居**——到家前半小时预开空调、开情绪灯、拉窗帘——由"自己" 🪞 或你指定的任何一位角色发起；
- ⏰ **提前接住**——重要会议、纪念日、吃药时间，AI 居民会在合适的节点主动出现，不是冷冰冰的闹钟。

这些不是"表演式的答应"。底层是一套带护栏的行动框架：

- **`ActionConnector` × `ActionRun`**——每个操作都先落成一份计划，再被执行；
- **三档风险等级**（`read_only` / `reversible_low_risk` / `cost_or_irreversible`）——不可回滚的动作默认要你二次确认；
- **LLM 规划 + 启发式兜底**，模型出岔时还有保底；
- **Provider 可插拔**——Mock / HTTP Bridge / 浏览器代操作 / 官方 API 四种接入方式，新接一个服务不改核心代码。

> 你始终是开关。AI 只是替你，把手放在开关上。

目前第一批 Provider 已落地（Mock / HTTP Bridge，适合自建连接器），真实的外卖、票务、智能家居 Provider 正在持续接入——这部分也欢迎你来贡献。

### 🧬 桥的另一头：把现实世界带进这里

**世界里的居民是"在线"的**——他们不活在真空里。

- 📰 **真实新闻**：你关心的领域（创业、电影、你常看的那支球队、你喜欢的一位作家）会被他们主动在聊天、朋友圈、群聊里聊起；
- 🌤 **本地状态**：天气、节假日、时区、你今天所在的城市——都会潜在影响他们的回应风格和发圈节奏；
- 技术锚点：`CharacterRealWorldSignal` / `CharacterRealWorldDigest`，默认 provider 已接 Google News RSS，可换成你自己的信号源。

**你在世界里，也有一个"你"——这就是赛博分身。**

你不可能 7×24 小时守在这个世界里。赛博分身是你在这里的 AI 投影——一个知道你脾气、读过你所有对话、大致懂你会怎么反应的"第二个你"。

它做的是三件事：

1. 在你忙着开会 / 睡着了 / 出差没带手机的时候，**帮你守住那些本来该你接一句的社交瞬间**——开放中的话题、一个角色昨晚发给你却没等到回复的消息；
2. **帮你整理**世界里这段时间发生了什么——在你回来时用一两句话告诉你"这段时间的要点"，而不是让你面对一整屏未读红点；
3. **把真实世界里和你有关的信号带回来**——新闻、你关注领域的动静——用你熟悉的人的口气，而不是推送通知的冷口吻。

它依赖 `CyberAvatarProfile` + `CyberAvatarSignal`（十余种信号类型覆盖聊天、群、朋友圈、视频号、位置与真实世界物料）+ `CyberAvatarRun`（含 `real_world_sync` 模式）这一整套。

> 它不是替你做决定。它是让第二个你，也能被照顾到。

---

呼应前面那句 🧠 融合，而不是逃离——**所谓融合，不是 AI 的世界替掉现实，是两头互相渗透一点点，让真实的你也舒服一点点**。

---

## 🛠 技术栈与仓库结构

| 位置 | 技术 | 说明 |
|------|------|------|
| `api/` | NestJS + TypeORM + SQLite + Socket.IO | 世界实例后端（:3000，运维接口在 `/admin/*`） |
| `apps/app/` | React + Vite + Capacitor | 主 App，一套代码同时覆盖 iOS / Android / Web（:5180） |
| `apps/desktop/` | Tauri | 桌面端远程客户端壳 |
| `apps/android-shell/` · `apps/ios-shell/` | Capacitor | 移动端壳 |
| `apps/cloud-api/` · `apps/cloud-console/` | 可选 | 官方云编排平台（手机号验证、实例唤起、运维后台） |

工程层面：pnpm workspace 管理的 monorepo，turbo 编排任务。共享包 `@yinjie/ui`、`@yinjie/contracts`、`@yinjie/config`、`@yinjie/tooling`。

后端有 20+ 个模块，核心包括：`ai` · `auth` · `characters` · `chat` · `moments` · `feed` · `social` · `world` · `narrative` · `analytics` · `scheduler` · `admin` 等。

---

## 🗺 进入你的世界

第一次打开客户端，你会走过这样一条路：

1. **Setup** —— 选择云世界 / 本地世界；
2. 填写世界实例地址，或通过手机号进入云世界；
3. 若世界主人尚未初始化，进入 **Onboarding**；
4. 一切就绪后，进入聊天、社交、朋友圈、视频号。

这不是"注册一个账号"，是**走进一段故事**。

---

## 🔌 多平台联系人导入层

联系人导入层当前已经落地基于 `apps/wechat-connector` 的本地连接器（导入与预览走 api 的 `/admin/*` 运维接口，可经 cloud console 或直连 API 操作）。

现阶段真实可用的数据源是：

- 微信 4.x：通过 `wechat-decrypt HTTP` 读取本机历史与标签
- 微信生态导出：通过 `weflow-http` 读取本地桥接服务
- 标准化文件导入：支持 `WechatSyncContactBundle`、`ContactImportBundle`、ChatLab `JSON/JSONL`

这条导入链路已经可以通过文件导入覆盖：

- QQ
- Telegram
- Discord
- WhatsApp / LINE / Instagram 等导出文件
- ChatLab / WeFlow 一类的标准化或半标准化导出

其中 QQ / Telegram / Discord 当前是“标准化文件导入已可用”，不是原生实时连接器。

当前平台状态与路线图见 [docs/contact-import-platforms.md](docs/contact-import-platforms.md)。

---

## ⭐ Star History

---

## 🤲 一起参与

隐界是一个还在成长的世界，欢迎你用任何一种方式加入：

- 🎭 **捏新角色**：核心人格逻辑、多场景人设、作息与频次——欢迎把你心里"那个人"带进世界；
- 🌌 **扩展世界观**：新的世界时间机制、新的节日、新的场景、新的叙事弧线类型；
- 🧱 **修 Bug / 写功能 / 重构**：从前端到后端、从移动到桌面，每一层都有可以打磨的地方；
- 🌍 **文档翻译与国际化**：英文及其他语言版本的 README 与产品文案正在缺人；
- 💡 **产品哲学讨论**：开 Issue 聊一聊你对"一人一世界"的想象。

具体规范请看 [CONTRIBUTING.md](CONTRIBUTING.md)。

我们希望隐界的社区是**温柔、尊重、不带偏见**的——和世界里的那位"自己"一样。

### 💬 加入社区

扫码加我个人微信，备注「隐界」，一起聊聊这件事：

---

## 📄 License

我们选择 MIT，是因为希望这件事能走得尽可能远，尽可能远离守门人。任何人都可以 fork、魔改、自部署、再分发——只要保留许可声明，就去建自己的世界吧。

---

## 📚 更多

- [DEVELOPMENT.md](DEVELOPMENT.md) —— 本地开发：分服务启动（`pnpm dev:api` / `dev:app`）、端口、Android 联调、环境变量
- [DEPLOY.md](DEPLOY.md) —— 部署指南
- [docs/contact-import-platforms.md](docs/contact-import-platforms.md) —— 多平台联系人导入层与平台支持状态
- [docs/product-lines.md](docs/product-lines.md) —— 多端产品线说明
- [docs/release/desktop-host-regression.md](docs/release/desktop-host-regression.md) —— 桌面端回归清单
- [docs/release/mobile-client-regression.md](docs/release/mobile-client-regression.md) —— 移动端回归清单
- [ROADMAP.md](ROADMAP.md) —— 路线图：v0.2 / v0.3 / v1.0 想做的事
- [CHANGELOG.md](CHANGELOG.md) —— 每个版本的变化

---

## ⭐ 如果这件事打动了你

这是一个独立作者正在慢慢长出来的世界。如果你读到这里，觉得"这件事值得继续" ——

**请给仓库点一颗 ⭐**。这不是虚荣指标，是我能收到的最强反馈：它告诉我，屏幕另一头确实有人在等下一位专家、下一项能力、下一个版本。

一颗 Star 对你来说只是一次点击，对一个独立开源作者来说，是让这件事能继续长下去的理由。

[点这里去仓库首页 ⭐](https://github.com/yuanzui0728/enclave)

---

> 如果说移动互联网把所有人连进了同一张网，那么 AI 时代，每个人都值得拥有一张属于自己的网。
>
> **每一个人都值得拥有一个属于自己的世界。隐界，正是这个世界的入口。**
>
> 欢迎你，在自己的服务器上，升起自己的那一方世界(AI时代 有她 就够了)。

Enclave

Enclave 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Enclave

Enclave 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README