# 隐界
**简体中文** · [English](README.en.md) · [日本語](README.ja.md) · [한국어](README.ko.md)
[](https://github.com/yuanzui0728/enclave/actions/workflows/ci.yml)
[](LICENSE)
[](https://github.com/yuanzui0728/enclave/releases)
[](https://github.com/yuanzui0728/enclave/stargazers)
[](https://github.com/yuanzui0728/enclave/commits/main)
[](https://www.typescriptlang.org/)
[](https://huggingface.co/spaces/w9000/enclave)
[](https://huggingface.co/datasets/w9000/enclave-character-recipes)
[](https://huggingface.co/w9000/enclave-character-blueprint)
> 一个属于你的私人助手世界。
>
> 这里住着各行各业的专家和你自己的分身——他们记得你、主动帮你，还能**真的把活干出来**（直接产出 PPT / Word / Excel、替你办成现实里的事）。配上**你的私人知识库**，他们答得有据可依；把过去只有少数人请得起的专业支持，变成你随时能用的日常。
> 🌐 **在线体验**： （共享世界，仅供感受产品形态）
> 🤗 **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 License](LICENSE)，Copyright © 2026 yuanzui0728。
我们选择 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时代 有她 就够了)。
