# lingyi-ai-pan

**Repository Path**: gdt/lingyi-ai-pan

## Basic Information

- **Project Name**: lingyi-ai-pan
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-04
- **Last Updated**: 2026-09-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 灵弈AI盘 · Lingyi AI Pan

> **黑底桌面 3D 角色养成 + 股票模拟盘 + AI 修仙剧情 + 真实行情事件触发**
> 把炒股变成养一个桌面小人 —— 你的虚拟资产涨，它升级；你的虚拟资产跌，它渡劫。

> ⚠️ 本项目为**纯娱乐模拟工具**：不构成任何投资建议，不接入任何实盘交易；游资故事、人物传记、剧情均为 AI 虚构演绎。

---

## ✨ 特性

- 🎮 **股海仙途**：黑底桌面 3D 角色（修仙/灵兽/战斗/萌系），随模拟盘资产成长、渡劫、突破
- 💰 **内置模拟盘**：不依赖第三方，本地虚拟账户买入/卖出/持仓/盈亏
- 📈 **真实行情联动**：A股实时行情驱动角色状态（上涨发光、大跌心魔）
- 🤖 **一切皆 AI**：对话、剧情、游资人物、行情解读、布局渲染全 AI 生成
- 🧩 **幻盘造物**：用户自由拖拽定义页面布局，一句话让 AI 排版
- 🏆 **盘界猎手**：涨停榜 / 龙虎榜 / 人气榜 / 情绪榜
- 🎯 **K线猎神**：K线识图训练，AI 打分，得分换修为
- 📚 **浮世股修录 / 浮仓战纪 / 临盘造化**：游资名录、战绩档案、题材资讯
- 🌐 **横竖屏适配**：竖屏桌面宠物式 / 横屏沉浸控制台式

---

## 📸 截图

> 待补充（M1 里程碑后更新）

---

## 🚀 快速开始

### 环境要求
- Node.js ≥ 18
- pnpm 或 npm

### 本地运行
```bash
git clone <repo-url>
cd lingyi-ai-pan
npm install
npm run dev
```
打开 `http://localhost:5173` 即可体验。

### 构建部署
```bash
npm run build     # 产物在 dist/
npm run preview
```
可部署到 Vercel / GitHub Pages / Gitee Pages。
### Android 手机打包（可选：独立 APK）
> 通过 Android Studio（电脑）或 **Android Code Studio**（手机，需自行安装 NDK/CMake）编译出 APK，手机独立使用。
```bash
# 1. 打包前端进 Android assets
npm run build:android        # 产物 → android/app/src/main/assets/www
# 2. 用 Android Studio 打开 android/ 目录编译（或手机用 ACS）
```
- 架构：WebView 加载前端 + **Chaquopy**（内嵌 Python 3.12）跑通达信桥接，行情直连 `127.0.0.1:8787`
- 前端产物已入库，手机端无 Node 环境也能直接编译
- 国内镜像已配置（阿里云 maven + 腾讯云 gradle）；Chaquopy 已迁移 Maven Central（17.0.0+），随依赖解析自动下载
- 详细步骤见 [`android/README.md`](android/README.md) 与 [`docs/06-部署运维说明.md`](docs/06-部署运维说明.md)

### 可选：通达信行情桥接（真实行情）
浏览器无法直连通达信服务器，需本地/国内服务器跑一个 Python 桥接：
```bash
pip install pytdx
python server/tdx_bridge.py          # 默认 http://localhost:8787
```
然后复制 `.env.example` 为 `.env.local`，设置 `VITE_QUOTE_SOURCE=tdx` 与 `VITE_TDX_BASE_URL=http://localhost:8787`，重启 `npm run dev` 即可用真实 A 股行情驱动角色。未配置时自动用 demo 数据兜底。

### 可选：AI 后端（真实 AI 对话）
```bash
cd server
cp .env.example .env   # 填入 AI_API_KEY
npm install
node index.js
```
未配置后端时，应用自动使用本地模板模式，核心功能不受影响。

---

## 🧱 技术栈

- **前端**：Vue 3 + Vite + TypeScript + Pinia
- **3D**：Three.js（WebGL）
- **行情**：通达信桥接服务（pytdx 直连，实时行情 + K线），demo 兜底
- **AI**：Node.js 后端代理大模型 API（可选）
- **存储**：localStorage / IndexedDB
- **Android 壳**：WebView + Chaquopy（内嵌 Python），可出独立 APK

---

## 📁 目录结构

```
lingyi-ai-pan/
├── src/                  # 前端源码
│   ├── views/            # 10 大页面
│   ├── components/       # 3D角色 / 可拖拽组件 / 公共组件
│   ├── stores/           # Pinia 状态（账户/角色/布局/事件）
│   ├── services/         # 行情 / AI / 存储服务
│   └── models/           # TS 数据模型
├── server/               # 可选服务（tdx_bridge.py 通达信桥接 / Node AI 代理）
├── android/              # Android 壳工程（WebView + Chaquopy 内嵌 Python）
├── docs/                 # 项目文档
└── ...
```

---

## 📚 文档

| 文档 | 说明 |
|------|------|
| [docs/01-技术方案文档.md](docs/01-技术方案文档.md) | 技术选型 / 架构 / 部署 |
| [docs/02-数据模型设计.md](docs/02-数据模型设计.md) | 数据模型定义 |
| [docs/03-API接口文档.md](docs/03-API接口文档.md) | 行情源与后端接口 |
| [docs/04-ROADMAP.md](docs/04-ROADMAP.md) | 开发路线图 |
| [docs/05-用户使用手册.md](docs/05-用户使用手册.md) | 用户使用说明 |
| [CONTRIBUTING.md](CONTRIBUTING.md) | 贡献指南 |

---

## 🗺️ Roadmap 一览

- **M1** MVP：黑底桌面 3D 角色 + 模拟盘 + 行情联动（★核心验证）
- **M2** AI 内容层：真实 AI 对话 / NPC / 剧情
- **M3** 八大模块铺开
- **M4** 幻盘造物：自由布局 + AI 排版（差异化终版）
- **M5** 开源发布与模板分享

详见 [docs/04-ROADMAP.md](docs/04-ROADMAP.md)。

---

## 🤝 贡献

欢迎提 Issue、提 PR！请先阅读 [CONTRIBUTING.md](CONTRIBUTING.md)。

- 🐛 Bug / 功能建议：提交 Issue
- 💻 想写代码：从 `good first issue` 开始

---

## 📄 开源协议

本项目基于 **MIT License** 开源，详见 [LICENSE](LICENSE)。

---

## ⚠️ 免责声明

1. 本产品为纯娱乐模拟工具，**不构成任何投资建议**。
2. **不接入任何实盘交易**，全部资金为模拟虚拟资金。
3. 游资人物故事、传记、语录为 AI 虚构二次演绎，不作为真实史料。
4. 行情数据仅供展示，不构成任何投资建议，不保证实时准确。

> 股市有风险，模拟亦有乐趣。修仙虽好，切勿当真。