文字修仙开源项目排行榜 Top 5

QQ「一念成仙」的技术链路：

Gensokyo（Go，QQ官方API → OneBot-v11）→ 自研修仙游戏逻辑 → QQ群/频道消息交互 → AI模型（赛博修仙玩法）

主流开发工具三大阵营：

Vue 系（最主流）：Vue 3 + Pinia + Vite，纯前端挂机游戏首选
Python + AI 系：FastAPI + LLM，做 AI 驱动的修仙世界模拟器
TypeScript 全栈系：Hono+Bun 或 Node.js，适合多人在线网游
AI 已成标配：Top 5 中有 3 个项目深度集成 AI（NPC自主决策、动态叙事、事件生成），未来文字修仙 = AI + 文字交互。

更新日期：2026年5月 | 按 GitHub Stars 排序

---

📊 排行榜总览

排名	项目名	Stars	主语言	类型	一句话描述
🥇	Cultivation World Simulator（修仙世界模拟器）	1.7k	Python	AI Agent 模拟器	AI Agent 驱动的开放修仙世界
🥈	vue-XiuXianGame（我的文字修仙全靠刷）	1.7k	JavaScript	Web 前端挂机	Vue 系最成熟修仙挂机游戏
🥉	Text-Legend（文字传奇）	60	JavaScript	Web 全栈网游	功能最完整的文字网游（含安卓端）
4	万界道友 Daoyou	55	TypeScript	Web 全栈	AIGC 深度集成的现代全栈修仙
5	Gensokoy（一念成仙底层框架）	31	Go	QQ 机器人框架	OneBot 标准 QQ 机器人协议层
6	渡界余生 daojie-yusheng	8	TypeScript	Web 全栈	企业级架构的文字修仙网游
7	九仙道 taro-jiuxiandao	6	TypeScript	跨端 H5	Taro 跨端（微信/支付宝/H5）
8	任逍遥 rxy	2	JavaScript	Web 前端	极简 Vue 3 武侠修仙 RPG
9	仙途 XianTu	—	Vue/Python	AI 驱动	AI 叙事 + SillyTavern 兼容
10	react-xiuxian-game	—	TypeScript	Web 前端	React + AI 驱动事件系统

💡 另有 Gitee 上的经典项目「仙寻纪」（PHP 原生开发），虽不在 GitHub，但曾帮助开发者登顶 TapTap 文游评分榜前十。

---

🥇 TOP 1：Cultivation World Simulator（修仙世界模拟器）

维度	详情
GitHub	4thfever/cultivation-world-simulator
Stars	⭐ 1,700+
语言占比	Python 71.2% / TypeScript 17.2% / Vue 8.4%
开源协议	自定义（非商业）
最新版本	v3.3.0（34 个 Release）

技术栈

层级	技术
后端	Python（核心引擎 + AI Agent 工作流）
前端	Vue + TypeScript
AI	LLM 接口（按任务需求分别接入 max/flash 模型）
部署	Docker + docker-compose + Nginx

核心亮点

• AI Agent 工作流：每个 NPC 都有独立的规则 AI + LLM AI 双驱动决策系统，支持协程化异步决策、多线程加速
• 完整世界系统：13 境界、8 门派、40 流派、五行属性、灵根系统
• 组织意志 AI：宗门/世家/朝廷有独立的 AI 决策，能下发任务、调配资源
• 小剧场系统：LLM 生成战斗/对话小剧场，多种文字风格
• 事件系统：拍卖会、秘境探索、天下武道会、天灾、宝物出世等大事件
• 长期规划：NPC 有长短期目标和记忆，能自主规划行为

做出来用的工具

Python 3.x + FastAPI/Flask（后端引擎）
Vue 3 + TypeScript（前端 UI）
LLM API（Gemini / Claude / OpenAI 等）
Docker + docker-compose（一键部署）
Git + GitHub Actions（CI/CD）

---

🥈 TOP 2：vue-XiuXianGame（我的文字修仙全靠刷）

维度	详情
GitHub	setube/vue-XiuXianGame
Stars	⭐ 1,700+
Forks	293
语言占比	JavaScript 63.9% / Vue 36.0%
开源协议	CC BY-NC 4.0（非商用）
在线体验	xiuxian.wenzi.games

技术栈

层级	技术
前端框架	Vue.js 3
UI 组件库	Element Plus
状态管理	Pinia
构建工具	Vite
部署	Docker（一键部署），支持 NAS 挂载

核心亮点

• 挂机修炼：自动吸收灵气、突破境界，纯前端运行
• 装备/法宝收集：随机刷新稀有装备（紫晶破晓戟、寒霜凝露链等）
• 剧情分支：击败妖怪触发收服灵宠剧情
• 无尽塔：爬塔挑战，支持扫荡
• Docker 部署：docker compose up -d 一键启动
• MOD 支持：通过 Vue 插件系统添加新剧情线
• 可扩展：支持集成 TensorFlow.js（AI 对战）、IPFS（区块链存证）

做出来用的工具

Vue.js 3（前端框架）
Element Plus（UI 组件库）
Pinia（状态管理）
Vite（构建工具）
Docker + docker-compose（部署）

---

🥉 TOP 3：Text-Legend（文字传奇）

维度	详情
GitHub	e5sub/Text-Legend
Stars	⭐ 60
Forks	27
语言占比	JavaScript 75.4% / Kotlin 12.9% / HTML 6.1% / CSS 5.6%
开源协议	PolyForm Noncommercial 1.0.0（源码可见，非商用）
最新版本	v1.0.138（92 个 Release）
在线体验	cq.071717.xyz

技术栈

层级	技术
后端	Node.js（Express/Koa） + Socket.IO（实时战斗）
前端	原生 HTML/CSS/JS
安卓客户端	Kotlin + Jetpack Compose
数据库	SQLite / MySQL（双支持）
部署	Docker（一键 SQLite 模式）

核心亮点

• Web + Socket 实时战斗：网页端即时对战
• 安卓原生客户端：Kotlin + Jetpack Compose，通过 HTTP/Socket API 连接服务端
• GM 后台：可视化配置 BOSS、修炼、法宝、活动、掉率等参数
• 多区服：支持 realm 多区服架构
• 完整系统：行会、沙巴克、交易、寄售、邮件、宠物、法宝、修真塔
• 智能挂机：SVIP 离线托管（服务端托管，重启可恢复）
• 数据库工具：内置 db:cleanup-mob-respawns、db:purge-normal-mob-respawns 等运维脚本

做出来用的工具

Node.js + Express/Koa（后端）
Socket.IO（实时通信）
SQLite / MySQL（数据库）
Kotlin + Jetpack Compose（安卓客户端）
Docker（部署）

---

4️⃣ 万界道友 Daoyou

维度	详情
GitHub	ChurchTao/Daoyou
Stars	⭐ 55
语言占比	TypeScript 99.6%
开源协议	GPL-3.0
官网	daoyou.org

技术栈

层级	技术
服务端	Hono 4 + Bun（超高性能 JS Runtime）
前端	React 19 + React Router 7 + Vite 8
样式	Tailwind CSS 4
数据库	PostgreSQL + Drizzle ORM
认证	Better Auth
缓存/定时	Redis
AI	AI SDK + DeepSeek / 火山引擎 ARK / Kimi / Alibaba / OpenRouter
部署	Docker + docker-compose

核心亮点

• AIGC 全流程集成：角色背景、战斗播报、奇遇故事、物品描述全部 AI 生成
• 深度战斗引擎：基于时间轴的回合制，支持神通、法宝、Buff/Debuff、五行克制、伤害管道
• 水墨风 UI：基于自研 Ink 组件库（21 个组件），纯文字适配移动端
• 严谨修仙体系：完整境界（炼气至渡劫）、灵根（金木水火土风雷冰）、功法、命格
• 架构清晰：Engine/Service/API 三层分离，引擎层完全独立于 UI

做出来用的工具

Bun（JS Runtime，替代 Node.js）
Hono 4（轻量 Web 框架）
React 19 + Vite 8（前端）
PostgreSQL + Drizzle ORM（数据库）
Redis（缓存）
AI SDK + 多 LLM Provider（AI 生成）
Docker（部署）

---

5️⃣ Gensokyo（一念成仙底层框架）

维度	详情
GitHub	Hoshinonyaruko/Gensokyo
Stars	⭐ 31
语言占比	Go 86.1% / TypeScript 7.1% / Vue 5.4%
开源协议	GPL-3.0
最新版本	Release 529（306 个 Release）
官网	gensokyo.bot

技术栈

层级	技术
核心	Go（Golang 原生实现）
协议	OneBot-v11 标准 + QQ 官方 API
前端	Vue（WebUI 管理界面）
通信	HTTP API / 反向 HTTP POST / 正反向 WebSocket

核心亮点

• QQ 官方 API → OneBot 协议转换：将 QQ 官方 WebSocket/API 转换为 OneBot-v11 标准
• 生态兼容：可连接 koishi、nonebot2、yunzai、zerobot、MiraiCQ 等所有 OneBot 生态插件
• 一念成仙的底层：「一念成仙」是基于 Gensokyo 框架 + 自研修仙逻辑开发的 QQ 机器人文字游戏
• 轻量：10MB 内存占用，端口错开可多开
• 功能丰富：Markdown 发送、频道虚拟群事件、URL 自动转换、图片压缩/图床服务
• WebUI：可视化修改配置、查看频道列表、发送信息

一念成仙的完整技术栈

Gensokyo（Go，QQ 协议层）
  ↓ OneBot-v11 标准
自研修仙游戏逻辑（后端服务）
  ↓
QQ 群/频道消息交互
  ↓
AI 模型（赛博修仙玩法，非单机）

🎮 一念成仙曾获 QQ 开放平台官方活动奖项，在 QQ 群机器人娱乐类目排名靠前。有玩家社群、宗门群可一起玩。

---

6️⃣ 渡界余生 daojie-yusheng

维度	详情
GitHub	fruktoguo/daojie-yusheng
Stars	⭐ 8
语言占比	TypeScript 92.8% / CSS 2.9% / JavaScript 2.3%
开源协议	MIT

技术栈

层级	技术
架构	pnpm monorepo（多包管理）
后端	Node.js + TypeScript
前端	TypeScript SPA
数据库	PostgreSQL 16
缓存	Redis 7
部署	Docker Swarm + 腾讯云 CCR（容器镜像服务）
AI	AI Provider 基础设施（已集成）

核心亮点

• 企业级部署：Docker Swarm 编排，自动备份（backup-worker），CCR 自动更新器（每 60 秒检测镜像变更）
• 并行持久化：支持 lease 管理，保证数据一致性
• 自动战斗系统：改进了不可达目标的重新寻敌逻辑
• GM 工具：内置诊断系统
• CI/CD：GitHub Actions 自动构建 + 镜像推送

做出来用的工具

pnpm workspace（monorepo 管理）
Node.js + TypeScript（全栈）
PostgreSQL 16（数据库）
Redis 7（缓存）
Docker Swarm（生产编排）
腾讯云 CCR（镜像仓库）

---

7️⃣ 九仙道 taro-jiuxiandao

维度	详情
GitHub	xiaoxustudio/taro-jiuxiandao
Stars	⭐ 6
语言占比	TypeScript 97.2% / Less 2.5%
开源协议	MPL-2.0

技术栈

层级	技术
框架	Taro 4.x + React 18
语言	TypeScript
UI	antd-mobile
状态管理	Zustand
样式	Less
包管理	pnpm

核心亮点

• 真正跨端：一套代码 → H5 / 微信小程序 / 支付宝 / 百度 / 抖音 / QQ / 京东 / 鸿蒙
• 完整修仙系统：试炼、炼丹、功法、法宝、坊市、洞府
• 历史底蕴：九仙道始于 2016 年，本项目为 2024 年重构版
• 安卓端：配套独立安卓工程（Kotlin 原生）

做出来用的工具

Taro 4.x（跨端框架，京东出品）
React 18 + TypeScript（开发语言）
antd-mobile（UI 组件库）
Zustand（状态管理）
pnpm（包管理）

---

8️⃣ 任逍遥 rxy

维度	详情
GitHub	Code4Bug/rxy
Stars	⭐ 2
语言占比	JavaScript 67.4% / Vue 30.5%
开源协议	MIT

技术栈

层级	技术
前端	Vue 3（Composition API）
状态管理	Pinia
样式	Tailwind CSS
构建	Vite

核心亮点

• 极简主义：纯文字描述，无图形界面，深色主题
• 四大系统联动：奇遇 ↔ 炼丹 ↔ 门派 ↔ 任务，跨系统数据同步
• Roguelike 元素：随机奇遇、多选择分支、冷却机制
• 三大门派：青山派（正道）、玄阴宗（魔道）、天机阁（中立）

---

9️⃣ 仙途 XianTu

维度	详情
GitHub	qianye60/XianTu
开源协议	个人免费 / 商用需授权

技术栈

层级	技术
前端	Vue 3 + TypeScript + Pinia + Vue Router + Webpack
可视化	Chart.js + Pixi.js
存储	IndexedDB（本地）
后端	Python + FastAPI + SQLite / PostgreSQL + JWT + WebSocket
AI	Gemini / Claude / OpenAI / DeepSeek API
兼容	SillyTavern（酒馆）嵌入式环境

核心亮点

• AI 动态叙事：多 LLM 实时生成个性化剧情
• 智能判定系统：基于境界、属性、装备、功法等多维度计算
• 酒馆兼容：可嵌入 SillyTavern 运行
• 开放世界：朝天大陆自由探索，触发奇遇，建立人物关系网
• 全平台适配：桌面 + 移动端，亮/暗双主题

---

🔟 react-xiuxian-game

维度	详情
GitHub	JeasonLoop/react-xiuxian-game
语言	TypeScript 99%
当前版本	v0.3.2

技术栈

层级	技术
前端	React 19.2 + TypeScript 5.8
构建	Vite 6.2
AI	默认 GLM（智谱AI），支持 SiliconFlow / OpenAI
状态管理	React Hooks（useState / useEffect）
持久化	localStorage

核心亮点

• AI 驱动事件：每次历练由 AI 生成独特事件
• 完整修仙体系：炼气→筑基→金丹→元婴→化神→炼虚→飞升，7 大境界 70 层
• 灵宠 + 本命法宝：祭炼后 50% 属性加成
• 抽奖保底：每 10 次必得稀有以上

---

📦 经典项目：仙寻纪（非 GitHub）

维度	详情
平台	Gitee（lao-ke1990/xunxianji）
语言	PHP 原生
数据库	MySQL
运行环境	Nginx + PHP 7.4

核心亮点

• PHP 原生开发：无需框架，源码结构清晰易修改
• 功能丰富：交易、打怪、宠物、任务、装备、金币、副本、套装、武功秘籍、天赋系统
• 历史地位：曾帮助开发者登顶 TapTap 文游评分榜前十，是早期最成熟的开源修仙文字游戏之一
• 二开活跃：社区有多版修复版和重写版，PHP 框架已被社区开发者重写升级

---

🛠️ 开发工具全景图：做一款文字修仙游戏需要什么？

一、前端技术选型

方案	代表项目	适用场景
Vue 3 + Pinia + Element Plus	vue-XiuXianGame、任逍遥	最主流，社区大，上手快
Vue 3 + Naive UI	我的放置仙途	更现代的 Vue UI 库
React 19 + TypeScript	react-xiuxian-game	React 生态，适合 AI 集成
Taro + React	九仙道	需要同时出 H5 + 小程序 + 多端
Vue 3 + TypeScript + Pixi.js	仙途	需要轻量图形/图表渲染
原生 HTML/CSS/JS	Text-Legend	极致轻量，无需构建

二、后端技术选型

方案	代表项目	适用场景
纯前端（无后端）	vue-XiuXianGame、任逍遥	单机/挂机游戏，localStorage 存档
Python + FastAPI	仙途、cultivation-world-simulator	AI 集成、异步高并发
Node.js + Socket.IO	Text-Legend	实时战斗、即时通信
Hono + Bun	万界道友	追求极致性能的现代全栈
Node.js + TypeScript（monorepo）	渡界余生	企业级架构、多包管理
Spring Boot + Vue	Foreworld（Gitee）	Java 生态、企业级
PHP 原生	仙寻纪	老牌项目、快速部署

三、数据库选型

数据库	代表项目	特点
localStorage / IndexedDB	vue-XiuXianGame、react-xiuxian-game	纯前端，无需服务器
SQLite	Text-Legend、仙途	零配置，适合小型部署
MySQL	Text-Legend、仙寻纪	成熟稳定，社区资源丰富
PostgreSQL	万界道友、渡界余生	现代 ORM（Drizzle）友好，JSON 支持好
Redis	万界道友、渡界余生	排行榜、世界聊天、缓存

四、AI 集成方案

方案	代表项目	说明
AI Agent 工作流	cultivation-world-simulator	NPC 独立决策 + LLM 驱动，最深度集成
AIGC 全流程	万界道友	AI 生成角色背景/战斗播报/奇遇故事/物品描述
AI 动态叙事	仙途	LLM 实时生成个性化剧情
AI 随机事件	react-xiuxian-game	AI 生成历练事件
赛博修仙	一念成仙	QQ 机器人 + AI 对话式修仙

五、部署方案

方案	代表项目	命令示例
Docker 一键部署	几乎所有项目	docker compose up -d
纯前端静态部署	vue-XiuXianGame	npm run build → CDN/Nginx
Docker Swarm	渡界余生	多服务编排 + 自动更新
腾讯云 CCR	渡界余生	私有镜像 + 自动拉取
NAS 自部署	vue-XiuXianGame	Docker + Syncthing 存档同步

六、机器人/对话式方案

组件	说明
Gensokyo（Go）	QQ 官方 API → OneBot-v11 协议转换
Koishi	OneBot 生态，插件丰富
NoneBot2	Python 异步机器人框架
Yunzai	MMD 生态机器人框架
MCP 服务	一念成仙已将 QQ 机器人封装为 MCP 服务

---

🎯 如何选择技术栈？

你想做什么？
│
├─ 🎮 单机挂机游戏 → Vue 3 + Pinia（纯前端，localStorage 存档）
│
├─ 🌐 多人在线网游 → Node.js + Socket.IO + MySQL/PostgreSQL
│
├─ 🤖 AI 驱动修仙 → Python + FastAPI + LLM API
│                     或 Hono + Bun + AI SDK（更现代）
│
├─ 📱 多端（H5+小程序）→ Taro + React + TypeScript
│
├─ 💬 QQ 机器人修仙 → Gensokyo（Go）+ 自研游戏逻辑
│
├─ 🏢 企业级生产部署 → TypeScript monorepo + Docker Swarm + PostgreSQL + Redis
│
└─ ⚡ 极致性能 + 现代 → Hono + Bun（替代 Node.js）

---

📎 快速链接

项目	GitHub 地址
修仙世界模拟器	github.com/4thfever/cultivation-world-simulator
我的文字修仙全靠刷	github.com/setube/vue-XiuXianGame
文字传奇	github.com/e5sub/Text-Legend
万界道友	github.com/ChurchTao/Daoyou
Gensokyo	github.com/Hoshinonyaruko/Gensokyo
渡界余生	github.com/fruktoguo/daojie-yusheng
九仙道	github.com/xiaoxustudio/taro-jiuxiandao
任逍遥	github.com/Code4Bug/rxy
仙途	github.com/qianye60/XianTu
React修仙	github.com/JeasonLoop/react-xiuxian-game