<img src="https://ddct.top/XianTu.png"> <table align="center"> <tr> <td><img src="https://ddct.top/XianTu_black.png" width="400" alt="黑色主题"/></td> <td><img src="https://ddct.top/XianTu_light.png" width="400" alt="浅色主题"/></td> </tr> </table> <h1 align="center">仙途（Xian Tu）</h1> AI 驱动的沉浸式修仙文字冒险游戏 <a href="https://qm.qq.com/q/mKtqgX0FSo">💬 QQ群：1079437686</a> • <a href="#功能概览">功能</a> • <a href="#技术栈">技术栈</a> • <a href="#快速开始">快速开始</a> • <a href="#许可证">许可证</a> <img src="https://img.shields.io/badge/Vue-3-4FC08D?style=flat-square&logo=vue.js&logoColor=white" alt="Vue 3"/> <img src="https://img.shields.io/badge/TypeScript-blue?style=flat-square&logo=typescript&logoColor=white" alt="TypeScript"/> <img src="https://img.shields.io/badge/Pinia-yellow?style=flat-square&logo=vue.js&logoColor=white" alt="Pinia"/> <img src="https://img.shields.io/badge/Webpack-5-8DD6F9?style=flat-square&logo=webpack&logoColor=black" alt="Webpack"/> <img src="https://img.shields.io/badge/Python-FastAPI-009688?style=flat-square&logo=fastapi&logoColor=white" alt="FastAPI"/> <img src="https://img.shields.io/badge/AI-Gemini-4285F4?style=flat-square&logo=google&logoColor=white" alt="Gemini"/> <img src="https://img.shields.io/badge/AI-Claude-orange?style=flat-square&logo=anthropic&logoColor=white" alt="Claude"/> <img src="https://img.shields.io/badge/AI-OpenAI-412991?style=flat-square&logo=openai&logoColor=white" alt="OpenAI"/> <img src="https://img.shields.io/badge/SillyTavern-兼容-purple?style=flat-square" alt="SillyTavern"/> <img src="https://visitor-badge.laobi.icu/badge?page_id=qianye60.XianTu&left_color=gray&right_color=blue" alt="visitors"/> <img src="https://img.shields.io/github/stars/qianye60/XianTu?style=flat-square&color=yellow" alt="stars"/> <img src="https://img.shields.io/github/forks/qianye60/XianTu?style=flat-square" alt="forks"/> <a href="https://qianye60.github.io/XianTu/游戏介绍.html">📖 游戏介绍</a> • <a href="https://www.ddct.top/">🎮 在线体验</a>

✨ 功能概览

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

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

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

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

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

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

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

🛠️ 技术栈

🚀 快速开始

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 支持一下！

XianTu

Install / Use

README