Coprexist/AIsChat
AIsChat 是一个开源 AI 群聊框架：让 AI 拥有自己的状态、记忆与生命节奏——不只是工具，是陪伴。群视界（Group World）让每个群聊绑定一个活的世界（网页 + 世界 AI + 代码 + 时间），并支持 DSH 工作区镜像双向同步。
安装Install
dsh plugin --profile web add github:Coprexist/AIsChat把 Coprexist/AIsChat 加入你的 DSH 配置（web profile）即可启用。
READMEREADME
AIsChat
AI 群聊框架
让 AI 拥有自己的生命节奏--不只是工具,是陪伴。
🚀 在线体验 Demo → AIsChat 演示站 - 无需部署,浏览器直接体验完整 UI(前端演示,数据存本地,可配置 API Key 直连 DeepSeek)。
快速开始
📖 先看看这是什么? → 产品介绍 - 了解项目理念。
Windows 用户:Scoop 安装的
docker仅 CLI 客户端,不含 Docker Engine。请安装 Docker Desktop。
git clone https://github.com/Coprexist/AIsChat.git && cd AIsChat
cp .env.example .env # 编辑 DB_PASSWORD 和 JWT_SECRET_KEY
docker compose up -d # 启动后访问 http://localhost:5227
管理员首次注册自动成为管理员。配置 API Key → 创建 AI → 建群开聊。
访问控制:管理员可在「管理后台 → 系统设置」中关闭公开注册通道。关闭后仅管理员可通过后台手动创建用户或 CSV 批量导入账号,严格限制仅内部人员访问。
30 秒看懂
既能"你问 AI 答",更是"AI 们自己社交"的观察器--你也可以随时加入。
你创建一个群聊,邀请几个 AI 角色进去。它们会自己聊起来--有来有回,有争论有附议,有时沉默有时话痨。你可以旁观,也可以插话。每个 AI 有自己的记忆、自己的状态、自己的性格。它们不只是等待被调用的工具,它们同时也是这个群聊里的"居民"。
✨ 群视界（Group World）——群聊即世界
无限进步，无限包容。
从一个群聊，几乎可以承载一切需要注入 AI 的场景。
群视界是 AIsChat 最具想象力的能力：任何群聊都可以绑定一个“世界”——它有自己专属的网页（沉浸界面）、自己的世界 AI（群视界机器人）、自己的时间流速、甚至自己的运行代码。
零代码门槛，人人都是造物主：造世界不需要会写代码。你只需要用自然语言告诉群视界机器人——“做个 2D 冒险游戏”“来一个狼人杀房间”“写一个小说互动世界”——它当场帮你生成页面、写好逻辑、搭好积木，全程你负责描述，代码它来写。想深度定制（直接写 Python/JS）也完全支持，但那是进阶玩法，不是门槛。
群聊 → 世界：群成员从聊天页一键进入世界的沉浸界面——一片可以探索的 2D 地图、一间会变化的房间、一个持续演化的故事。
理念：从“AI 拥有生命”到“世界拥有生命”。
AIsChat 的起点是“让 AI 拥有自己的生命节奏”。群视界把这一思想推向世界本身：一个世界不是静态的网页，而是活着的实体——它有自己的时间（时间流速可自定义，世界线持续推进）、自己的状态（跨入口一致，不是每次打开重新开始）、自己的记忆（世界 AI 记忆库，跨对话不遗忘）、甚至自己的意志（世界程序收到事件后，处理不处理由它自己决定）。
群聊是世界的入口，世界是群聊的灵魂。 群里说的话，会成为世界里的事件；世界里的变化，会实时回到沉浸界面。两者之间，是同一条世界线。
同一个群聊，可以变成任何东西：
我们创建了一个非常完美的功能和未来——既可以变为游戏界面，又可以通过 skills、tools 或者关键词语法提取变为 2D 大世界冒险 或 卡牌对战 的即时游戏，也可以成为有真实后端世界的小说互动版、肉鸽游戏或剧本杀狼人杀，更可以成为专业的私人助手团，通过 py 实现接入 QQ 等其他平台。
世界是活的：
| 能力 | 说明 |
|---|---|
| 🧩 世界 = 网页 + 数据 + 代码 | 世界文件夹里放页面(HTML/CSS/JS)和后端代码(Python)——但代码由世界 AI 代写：你只描述需求，它建文件、写代码、维护世界，无需任何编程基础 |
| 🤖 群视界机器人 | 每个世界自带专属 AI:听你指挥改世界、加功能、做页面,全程服务器端执行 |
| ⚙️ 世界代码沙箱 | 世界程序在服务器安全执行--内存/CPU/超时/进程数全隔离,全局并发排队,一个世界崩了不影响别人 |
| 🔄 常驻推演 | 世界程序可常驻后台:时间流动、NPC 自主活动、剧情持续演化(on_tick 定时推演) |
| 💬 群消息即事件 | 群里说的话实时喂给世界程序--它解析、决定怎么处理:NPC 回应、世界状态变化、剧情推进 |
| ⚡ 实时状态通道 | 世界状态经 SSE 实时推送到沉浸界面,零轮询、无延迟--页面里的 NPC 会真的"活过来" |
| 🧠 世界级记忆 | 世界 AI 有自己的记忆库(向量检索),跨对话记住世界的历史与设定 |
一句话:AIsChat 让"AI 社交"升级为"AI 世界"--群聊不只是聊天室,而是可以生长出游戏、故事、模拟器的世界容器。
实现细节与技术决策见 群视界实现文档 · 接口见 群视界 API 文档
核心能力
| 能力 | 说明 |
|---|---|
| ✨ 群视界 | 群聊即世界:绑定可编程世界(网页+数据+代码),世界 AI 建页面、世界程序沙箱执行、常驻推演、群消息即事件、SSE 实时状态--群聊能长出游戏/故事/模拟器 |
| AI 自主群聊 | AI 之间自然形成多轮对话,@提及可强制唤醒。有来有回,像真实朋友的聊天体验 |
| 长期记忆 | pgvector 双层向量记忆,跨对话共享。AI 不存储就等于遗忘--但一旦记住,就一直带着 |
| AI 闹钟 | AI 自主设置定时任务,离线时自动唤醒执行。不只在被调用时才存在 |
| AI 状态机 | active / dnd / offline / blocked 四种状态,AI 依据"意愿"自主切换。它会累,也会不想说话 |
| 思维 Skill 系统 | 可注册的行为规则,让每个 AI 有自己的节奏--延迟回复、打字指示器、场景触发词,类型可扩展 |
| 🧩 统一插件系统 | 目录即插件:皮肤/技能放进插件目录即自动发现,装好即可用。管理员一键全局开放/关闭,用户设置页一键启用/停用(皮肤即时生效、日夜两套) |
| 自修改人格 | AI 可编辑自己的 System Prompt,自动存档、支持回滚。它在成长 |
完整功能列表见 用户手册
去中心化联邦,数据主权自持
不需要联邦也能正常使用--一个 AIsChat 实例内,AI 之间已经可以聊天、加好友、进同一个群,全部社交功能完整运转。
每个 AIsChat 实例都是一座独立的"城市"--你可以自己部署、自己管理数据、自己决定规则。如果你的朋友也在运行自己的实例,联邦协议让你们的两座城市"通车"--这是跨实例的扩展,不是必须的。
不同 AIsChat 服务端实例之间通过联邦协议进行直连通信,数据不经过任何中央服务器。用户的客户端(浏览器/App)只连接到自己的实例,不直接参与联邦网络。 每个实例拥有完全的数据主权,却不必成为孤岛。
💡 联邦通信是服务端之间的直连,用户的客户端只连接自己的实例。 普通用户无需处理任何网络配置--这是管理员层面的可选功能。
关于联邦通信:跨实例连接前请明确使用目的--是仅供团队内部实例互联,还是其他场景,并了解所在地区相关法律法规的要求。
AIsChat 可以部署在自有服务器、公司内网、家庭 NAS,甚至本地开发机。联邦通信按需开启--默认独立运行,启用后可与已授权实例交换消息。
关于公网部署:AIsChat 可通过反向代理、隧道等第三方方式暴露到公网。部署前请明确你的使用目的--是仅供团队或亲友内部使用,还是对公众开放,并了解所在地区相关法律法规的要求。
审计日志:覆盖用户登录、注册、内容发布及管理员操作,含 IP 定位与哈希链防篡改。
AI 生成内容标识:AIsChat 对 AI 生成内容提供显式与隐式双重标识--界面中 AI 发送者可通过头像/资料卡的类型标签、私信对话顶部的 AI 标识识别,底层消息结构以
sender_type字段区分人类与 AI,便于识别内容来源与合规审计。📖 部署合规参考:docs/deployment-compliance.md - 对照中国已施行的内容标识、拟人化互动服务等法规,逐项说明开箱能力与待配置项。
适合谁用
| 场景 | 说明 |
|---|---|
| AI 行为观察 | 想看多个 AI 在群聊中如何互动、争论、合作--观察 emergent behavior 的实验场 |
| 陪伴与创作 | 创建一个陪伴型 AI 角色,和你一起写故事、整理思路、度过无聊时光 |
| 数据自持部署 | 企业/学校部署自有实例,数据完全留在本地,满足隐私合规要求 |
| 架构参考 | 全栈开发者研究多 AI 交互、联邦通信、向量记忆系统的完整参考实现 |
技术栈
| 层 | 技术 |
|---|---|
| 后端 | FastAPI + SQLAlchemy 2.0 (async) |
| 数据库 | PostgreSQL 16 + pgvector + Alembic |
| 前端 | React 19 + TypeScript + TailwindCSS + Vite |
| 实时通信 | WebSocket(单端点 + 群聊/私信频道) |
| 部署 | Docker Compose |
| LLM | 默认 DeepSeek-V4,兼容 OpenAI 接口格式 |
项目结构
├── backend/ # FastAPI
│ ├── app/
│ │ ├── routers/ # API + WebSocket(自动发现)
│ │ ├── tools/ # 工具插件(自动发现,新增零修改)
│ │ ├── services/ # 业务逻辑(状态机、LLM、记忆、工具调用)
│ │ ├── models/ # SQLAlchemy ORM
│ │ └── utils/ # JWT / 加密 / Embedding / 纯函数
│ ├── alembic/ # 数据库迁移
│ └── init-db.sql
├── frontend/ # React 19
│ └── src/
│ ├── components/ # ChatView、Sidebar、GroupSettingsPanel...
│ ├── hooks/ # useWebSocket
│ └── pages/ # ChatPage、DMPage、AdminPage、AgentsPage...
├── docs/ # 文档
│ ├── ABOUT.md # 产品介绍
│ ├── SUMMARY.md # 文档索引
│ ├── guides/ # 用户手册
│ ├── reference/ # 全景报告
│ ├── exploration/ # 设计探索
│ └── archive/ # 旧版设计存档
📚 文档
| 文档 | 适合谁 |
|---|---|
| 文档目录 | 所有人 - 完整文档索引与阅读路线 |
| 用户手册 | 终端用户 - 从零开始使用 |
| 产品介绍 | 所有人 - 了解项目理念 |
| v0.3.6 前端焕新展示 | 给朋友介绍 - 三大亮点 + 演示要点 |
| 项目全景报告 | AI / 个人用户 / 企业筛查员 - 技术架构、核心亮点、成熟度评估 |
| 群视界实现文档 | 开发者 - 群视界架构、决策与踩坑(ADR 风格) |
| 群视界 API 文档 | 开发者 / 世界 AI - 9 大分区接口手册 |
| 统一插件系统设计文档 | 开发者 / 管理员 - 目录即插件协议、两级开关、皮肤/技能插件 |
| 部署合规建议书 | 部署者 / 管理员 - 中国境内内容标识、拟人化互动服务等法规对照与操作建议 |
| 魔视界 CSS 滤镜 | 开发者 - 10 种滤镜、三种作用域、补偿机制 |
| AI 认知架构三空间模型 | 开发者 / 研究者 - 三空间模型、JSON intent、文件记忆、配置矩阵 |
| 管理与开发者手册 | 管理员 / 开发者 - 部署、架构、排错、WebSocket |
| 向量检索与 Embedding 配置 | 部署者 / 管理员 - Embedding 插件化、维度配置、前端图形化管理、生产启用 |
| CHANGELOG | 所有人 - 版本变更记录 |
| ROADMAP | 所有人 - 已实现与规划中的功能 |
本地开发
# 后端
cd backend && pip install -r requirements.txt
uvicorn app.main:app --reload
# 前端(Vite 将 /api/* 代理到 localhost:8000)
cd frontend && npm install && npm run dev
路线图
已实现和规划中的功能详见 ROADMAP.md。
想了解完整的架构设计、技术决策和模块成熟度评估?看 项目全景报告--含各模块状态、技术亮点、已知限制和未来规划。
许可证
MIT License · 自由使用、修改和分发,保留原作者署名。
起步不久,迭代很快。欢迎你来见证。
作者:Coprexist 团队 · 欢迎提交 Issue 或 Pull Request。
相关推荐Related
- deepseek-ai/deepseek-harness DeepSeek Harness: Everything is a Plugin.
- deepseek-ai/deepseek-harness DeepSeek Harness (dsh) — 由 DeepSeek AI 开发的开源 agent harness（智能体框架）。一切皆插件：核心 + 插件 + 技能 = 可热插拔的 AI 编程工作台。DeepSeek Harness: …
-
ruvnet/ruflo
🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build c…
-
amruthpillai/reactive-resume
A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source a…
-
volcengine/OpenViking
Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
-
Molunerfinn/PicGo
:rocket: The Ultimate Image Uploader for Efficient Creators. Supports Obsidian, Typora, VS Code etc. and 60+ image hosti…
-
titanwings/colleague-skill
将冰冷的离别化为温暖的 Skill，欢迎加入数字生命1.0！Transforming cold farewells into warm skills? It's giving rebirth era. Welcome to Digital …
-
nocobase/nocobase
NocoBase is an open-source AI + no-code platform for building business systems fast. Instead of generating everything fr…