仙途（Xian Tu）

AI 驱动的沉浸式修仙文字冒险游戏

💬 QQ群：1079437686 • 功能 • 技术栈 • 快速开始 • 许可证

📖 游戏介绍 • 🎮 在线体验

---

✨ 功能概览

🤖 AI 动态叙事 — 支持 Gemini / Claude / OpenAI / DeepSeek 等多种大模型，实时生成个性化剧情

⚔️ 完整修仙体系 — 境界突破、三千大道、功法修炼、装备炼制、NPC 互动

🎲 智能判定系统 — 基于境界、属性、装备、功法等多维度计算判定结果

💾 多存档管理 — 多角色、多存档槽位，支持导入导出与云同步

🗺️ 开放世界 — 自由探索朝天大陆，触发奇遇事件，建立人物关系网络

📱 全平台适配 — 完美支持桌面端与移动端，亮/暗双主题

🍺 酒馆兼容 — 支持 SillyTavern 嵌入式环境与独立网页版

---

🛠️ 技术栈

前端	后端	AI
Vue 3 + TypeScript	Python + FastAPI	Gemini API
Pinia 状态管理	SQLite / PostgreSQL	Claude API
Vue Router	JWT 认证	OpenAI API
Webpack	WebSocket	SillyTavern
Chart.js + Pixi.js		DeepSeek
IndexedDB

---

🚀 快速开始

Docker 部署（推荐）

docker run -d -p 8080:80 qianye60/xiantu:latest

访问 http://localhost:8080 即可使用。

本地开发

# 安装依赖
npm install

# 开发模式
npm run serve

# 生产构建
npm run build

☁️ 自动构建/部署

推送 v* 格式的 tag 时自动触发：

• Docker 镜像：构建并推送到 Docker Hub
• GitHub Release：创建 Release 并上传构建产物 zip 包

git tag v3.7.0
git push origin v3.7.0

其他工作流：

• CI：.github/workflows/ci.yml（push/PR 自动 type-check + build）
• Pages：.github/workflows/pages.yml（push 到 master 自动部署到 GitHub Pages）

后端（可选）

后端用于提供账号/存档等 API，默认使用 SQLite，开箱即用。

pip install -r server/requirements.txt
uvicorn server.main:app --reload --port 12345

环境变量配置见 server/.env.example

---

📖 更新日志

查看完整更新历史：CHANGELOG.md

---

🤝 贡献

欢迎提交 Issue 和 Pull Request！

详见 CONTRIBUTING.md

---

📄 许可证

本项目个人学习、研究免费使用。商业用途请先联系作者。

详见 LICENSE | 联系方式：QQ 1538548527

---

☕ 支持项目

如果这个项目对你有帮助，欢迎赞助支持~

---

_{如果觉得有帮助，请给个 ⭐ Star 支持一下！}