KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #ai-agents #dsh-plugin #codex #developer-tools #claude-code #windows #desktop-app #typescript #rust #ai-agent #cli

Touhou-Isekai-Izakaya

★ 48 Open GitHub ↗

《东方异界食堂》是一款融合了大语言模型叙事、模拟经营与 RPG 战斗的 Web 小游戏，使用 Vue3+Typescript 搭建；游戏目前还处于早期开发版本，未来接入的更多游戏功能分支也将在此仓库更新

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<img src="https://capsule-render.vercel.app/api?type=waving&color=0:B91C1C,50:EF4444,100:FCA5A5&height=220&section=header&text=Touhou%20Isekai%20Izakaya&fontSize=52&fontColor=ffffff&fontAlignY=35&desc=%E6%9D%B1%E6%96%B9%E7%95%B0%E7%95%8C%E9%A3%9F%E5%A0%82&descSize=28&descAlignY=60&animation=twinkling&fontAlign=50" width="100%"/>

<br/>

<a href="https://github.com/YoKONCy/touhou-isekai-izakaya">
  <img src="https://readme-typing-svg.demolab.com?font=Noto+Serif+SC&weight=600&size=28&duration=4000&pause=1000&color=B91C1C&center=true&vCenter=true&multiline=true&repeat=false&width=600&height=50&lines=LLM-Driven+Roleplay+Experience;LLM+%E9%A9%B1%E5%8A%A8%E7%9A%84%E8%A7%92%E8%89%B2%E6%89%AE%E6%BC%94%E4%BD%93%E9%AA%8C;Simulation+%E2%9C%A6+RPG+%E2%9C%A6+Management" alt="Title" />
</a>

<br/>

<a href="./README.md">
  <img src="https://img.shields.io/badge/Status-Beta-red?style=for-the-badge&logo=fire&logoColor=white&labelColor=000000" alt="Beta">
</a>
&nbsp;
<a href="https://vuejs.org/">
  <img src="https://img.shields.io/badge/Vue.js-3.5-4FC08D?style=for-the-badge&logo=vue.js&logoColor=white&labelColor=000000" alt="Vue">
</a>
&nbsp;
<a href="https://www.typescriptlang.org/">
  <img src="https://img.shields.io/badge/TypeScript-5.x-3178C6?style=for-the-badge&logo=typescript&logoColor=white&labelColor=000000" alt="TS">
</a>
&nbsp;
<a href="https://webassembly.org/">
  <img src="https://img.shields.io/badge/Wasm-SQLite-654FF0?style=for-the-badge&logo=webassembly&logoColor=white&labelColor=000000" alt="WASM">
</a>
&nbsp;
<a href="https://capacitorjs.com/">
  <img src="https://img.shields.io/badge/Capacitor-Android-119EFF?style=for-the-badge&logo=capacitor&logoColor=white&labelColor=000000" alt="Capacitor">
</a>
&nbsp;
<a href="./LICENSE">
  <img src="https://img.shields.io/badge/License-AGPL--3.0-blue.svg?style=for-the-badge&logo=gnu&logoColor=white" alt="License">
</a>
&nbsp;
<a href="./TECHNICAL_DESIGN.md">
  <img src="https://img.shields.io/badge/Technical-Design-blue?style=for-the-badge&logo=gitbook&logoColor=white&labelColor=000000" alt="Docs">
</a>
&nbsp;
<a href="#-quick-start">
  <img src="https://img.shields.io/badge/Quick-Start-success?style=for-the-badge&logo=rocket&logoColor=white&labelColor=000000" alt="Start">
</a>

> **"Welcome to the boundary between fantasy and reality. What can I get for you today?"**

</div>

<img src="https://user-images.githubusercontent.com/73097560/115834477-dbab4500-a447-11eb-908a-139a6edaec5c.gif" width="100%">

<br/>

## 📋 Table of Contents

<details open>
<summary><b>Quick Navigation</b></summary>
<br/>

| Section | Description | Link |
|:-------:|:------------|:----:|
| 🎯 | **Overview** - 项目概述与核心特色 | [Jump](#-overview) |
| 🤖 | **AI Agent** - 智能体架构解析 | [Jump](#-ai-agent-architecture) |
| 🧠 | **Memory System** - 独特的长记忆机制 | [Jump](#-long-term-memory) |
| 🏗️ | **Architecture** - 系统架构与技术栈 | [Jump](#️-architecture) |
| 🌐 | **Multiplayer** - 全能联机中心 | [Jump](#-multiplayer-hub) |
| ⚔️ | **Combat System** - 策略弹幕战斗 | [Jump](#-combat-system) |
| 🚀 | **Quick Start** - 快速开始指南 | [Jump](#-quick-start) |
| 📦 | **Build & Packaging** - 打包构建与代码规范 | [Jump](#-build--packaging) |
| 🖼️ | **AI Drawing** - AI 绘图与隐私说明 | [Jump](#-ai-drawing-privacy) |
| 📅 | **Roadmap** - 开发计划与待办 | [Jump](#-roadmap) |
| ⚠️ | **Disclaimer** - 版权与声明 | [Jump](#-disclaimer) |

</details>

<br/>

<img src="https://user-images.githubusercontent.com/73097560/115834477-dbab4500-a447-11eb-908a-139a6edaec5c.gif" width="100%">

<br/>

## 🎯 Overview

<table>
<tr>
<td align="center" width="160">
<img src="https://img.shields.io/badge/LLM-Driven-B91C1C?style=for-the-badge&labelColor=1c1c1e" alt="LLM"/><br/>
<b>无限叙事</b><br/>
<sub>Infinite Narrative</sub>
</td>
<td align="center" width="160">
<img src="https://img.shields.io/badge/Quartet-Arch-F59E0B?style=for-the-badge&labelColor=1c1c1e" alt="Architecture"/><br/>
<b>四重奏架构</b><br/>
<sub>4-Model Collaboration</sub>
</td>
<td align="center" width="160">
<img src="https://img.shields.io/badge/SQLite-Wasm-003B57?style=for-the-badge&logo=sqlite&logoColor=white&labelColor=1c1c1e" alt="SQLite"/><br/>
<b>高性能存储</b><br/>
<sub>SQLite + OPFS</sub>
</td>
<td align="center" width="160">
<img src="https://img.shields.io/badge/Memory-Graph-10B981?style=for-the-badge&logo=target&logoColor=white&labelColor=1c1c1e" alt="Memory"/><br/>
<b>联想记忆图谱</b><br/>
<sub>PeroCore PEDSA</sub>
</td>
<td align="center" width="160">
<img src="https://img.shields.io/badge/Management-Sim-3B82F6?style=for-the-badge&labelColor=1c1c1e" alt="Sim"/><br/>
<b>模拟经营</b><br/>
<sub>Izakaya Management</sub>
</td>
<td align="center" width="160">
<img src="https://img.shields.io/badge/Turn-Based-8B5CF6?style=for-the-badge&labelColor=1c1c1e" alt="Combat"/><br/>
<b>策略战斗</b><br/>
<sub>Danmaku & Persuasion</sub>
</td>
</tr>
</table>

<br/>

<h3>🎮 <a href="https://touhouisk.cn/">立即试玩 / Live Demo</a></h3>
<p>
  <b><a href="https://izakaya.touhou.best/">👉 点击进入幻想乡 / Enter Gensokyo</a></b>
  <br/>
  <sub>⛩️ 东方异界食堂 beta 🍵 还没有任何对话... 点一杯茶，开始你的幻想乡物语吧。</sub>
</p>

### 🚧 Beta Version Notice / 测试版说明

当前游戏处于 **Beta 测试阶段**，功能仍在快速迭代中：
- **存档兼容性**: 随着版本更新，存档结构可能会发生变化（虽然我们会尽力保持兼容）。
- **LLM 稳定性**: 角色扮演与逻辑判断正在持续调优。
- **经营系统**: 居酒屋经营模块目前为实验性功能。
- **静态资源**: 部分图片与音频资源可能仍在替换中。

如遇到 Bug 或有改进建议，欢迎提交 Issue 或 PR。

<br/>

**东方异界食堂** 是一款融合了 **LLM (大语言模型)** 叙事、**模拟经营** 与 **RPG 战斗** 的 Web 游戏。
在一次时空乱流的作用下，你穿越来到了幻想乡。初来乍到的你决定通过开店来体验这个奇妙的世界。
美食与力量，你将用何种方式与幻想乡的少女们进行邂逅呢？一切都取决于你自己。

</div>

### ✨ Key Features

- **🎭 LLM 驱动的无限叙事**: 每一位角色都由 AI 驱动。角色会根据性格、好感度以及过往记忆与你交流。
- **🍶 沉浸式居酒屋经营**: 利用程序化生成的瓦片地图系统，自由装修厨房、用餐区。收集食材，研究菜谱，制作出让妖怪和神明都赞不绝口的料理。
- **⚔️ 策略与嘴遁并存的战斗**: 回合制弹幕战与嘴遁系统 (Persuasion) 结合。通过输入文本试图说服对手，AI 将判定你的话语是否能动摇对方的战意。
- **👥 丰富的角色生态**: 收录了百余位东方 Project 经典角色，每人拥有独立的属性、符卡和行为逻辑。

<br/>

<img src="https://user-images.githubusercontent.com/73097560/115834477-dbab4500-a447-11eb-908a-139a6edaec5c.gif" width="100%">

<br/>

## 🤖 AI Agent Architecture

> 本项目不仅仅是一个简单的 LLM 调用程序，而是一个拥有**感知、记忆、决策、行动**完整回路的 **智能体 (Autonomous Agent)**。

### ⚙️ Core Loop

#### 1. Perception (感知层)
Agent 不仅接收用户的文本输入，还实时监控**游戏环境状态**（如当前时间、金钱、好感度、任务进度）。所有环境信息会被编码为 System Prompt 的一部分，让 AI "看到" 现在的世界。

#### 2. Brain & Memory (大脑与记忆)
核心 LLM (Storyteller) 结合**短期上下文**（最近的对话）与**长期记忆**（检索到的历史摘要）进行推理。它不仅生成回复，还在思考："玩家现在的意图是什么？" "我应该推进剧情还是闲聊？" "是否需要触发战斗？"

#### 3. Decision & Action (决策与行动)
基于推理结果，Agent 会输出**结构化指令 (XML/JSON)** 而非纯文本。
- **Dialogue**: 生成符合角色性格的回复。
- **State Change**: 修改好感度、扣除金钱、获得物品。
- **System Trigger**: 启动战斗模式、切换场景、发放任务。

这使得 NPC 真正“活”在游戏世界中，而非仅仅是一个聊天机器人。

<br/>

<img src="https://user-images.githubusercontent.com/73097560/115834477-dbab4500-a447-11eb-908a-139a6edaec5c.gif" width="100%">

<br/>

## 🧠 Long-term Memory

> 本项目采用了一套结合 **"SQLite FTS5"** 与 **"PeroCore 联想激活算法 (PEDSA)"** 的记忆机制，旨在模拟人类的联想记忆，解决传统 LLM 游戏“聊久了就忘”的通病。

### ⚙️ Mechanism

#### 1. The Scribe & Graph Builder (记录者与建图)
每一轮对话结束后，独立的 **LLM #3 (Scribe)** 会将原始对话压缩为结构化的记忆片段。系统会自动将其接入图谱：
- **时间轴 (Sequence)**: 将记忆按发生顺序连接，形成叙事连续性。
- **实体网络 (Entity Star)**: 围绕 NPC、地点、物品等实体建立星型关联，形成语义网络。

#### 2. PEDSA Spreading Activation (能量扩散检索)
本项目实现了与 PeroCore 同款的**并行能量衰减扩散激活算法 (Parallel Energy-Decay Spreading Activation)**：
- **种子选取**: 通过 SQLite FTS5 全文搜索锁定与当前上下文最相关的核心记忆。
- **激活联想**: 核心记忆作为“种子”获得能量，沿图谱边向邻近节点扩散。
- **智能召回**: 即使不包含当前关键词，只要在语义图谱中与当前话题紧密相关（如提到“博丽神社”联想到“塞钱箱”），也会被高能量激活并注入上下文。
 
### 💾 Memory Types

| Type | Icon | Description |
|:---:|:---:|:---|
| **Summary** | 📜 | **剧情摘要**: 自然语言总结，包含谁做了什么、关键情感波动。 |
| **Facility** | 🏗️ | **设施档案**: 记录店铺/房屋改造。当玩家处于相关区域时优先检索。 |
| **Variable** | 🔢 | **状态快照**: 数值层面的“硬事实”（如金钱变动、物品获取）。 |
| **Alliance** | 🤝 | **盟约与情报**: 全局性重要记忆，具有极高检索优先级。 |

<br/>

<img src="https://user-images.githubusercontent.com/73097560/115834477-dbab4500-a447-11eb-908a-139a6edaec5c.gif" width="100%">

<br/>

## ⚔️ Combat System

> 幻想乡的解决异变方式——符卡规则 (Spell Card System) 与 LLM 逻辑判断的完美结合。

### 🎮 系统特色

- **符卡决斗 (Spell Card Duel)**: 完美还原原作设定，角色拥有独特的符卡、弹幕类型与奥义演出。
- **P 点系统 (P-Point System)**: 通过行动积攒 P 点，当 P 点达到 80% 以上时进入“爆发状态”，强化所有输出并解锁特殊视觉特效。
- **动态血条与护盾**: 结合了实时数值反馈，包含护盾 (Shield)、闪避 (Dodge) 以及多种 Buff/Debuff 机制。
- **友军支援 (Ally Support)**: 玩家可以与幻想乡的少女们组队，通过卡片堆栈系统自由切换当前激活的支援角色。
- **LLM 嘴遁 (Persuasion)**: 除了武力解决，你还可以尝试通过对话说服对手。AI 会根据你的发言内容、当前好感度以及性格逻辑，判定对手是否会产生动摇甚至直接结束战斗。

<br/>

<img src="https://user-images.githubusercontent.com/73097560/115834477-dbab4500-a447-11eb-908a-139a6edaec5c.gif" width="100%">

<br/>

## 🏗️ Architecture

### 🛠️ Tech Stack

</div>

### 🧩 Quartet Architecture

系统将任务分发给四个独立的 LLM，详见 [TECHNICAL_DESIGN.md](./TECHNICAL_DESIGN.md)。

| ID | Role | Responsibility | Service |
|:---|:---|:---|:---|
| **#1** | **Storyteller** | 扮演 NPC，生成剧情与 XML 触发器 | `gameLoop.ts` |
| **#2** | **Game Master** | 分析剧情，处理逻辑与状态变更 | `logic.ts` |
| **#3** | **Scribe** | 记忆摘要与向量化检索 | `memory.ts` |
| **#4** | **Misc / Tool** | 战斗裁判、瓦片地图生成等杂项 | `MapGenerator.ts` |

<br/>

<img src="https://user-images.githubusercontent.com/73097560/115834477-dbab4500-a447-11eb-908a-139a6edaec5c.gif" width="100%">

<br/>

## 🌐 Multiplayer Hub

> 跨越维度的连接——在幻想乡与你的伙伴并肩作战。

### 📡 核心功能

- **实时联机同步**: 基于 WebSocket 的高性能数据同步，支持多人同屏互动。
- **全能联机中心**: 
    - **大厅浏览**: 实时查看公开房间列表。
    - **快速加入**: 通过房间 ID 一键进入伙伴的世界。
    - **私人空间**: 支持设置房间密码，保护隐私。
- **端到端安全加密**: 所有玩家间的通信均经过 AES-GCM 高强度加密，确保聊天内容与游戏数据仅在玩家间可见。
- **灵活的服务器选择**:
    - **官方中继**: 极速连接，无需配置（仅作为数据转发，不存储任何内容）。
    - **自定义服务器**: 支持玩家部署自己的中继节点，彻底掌握数据。

<br/>

<img src="https://user-images.githubusercontent.com/73097560/115834477-dbab4500-a447-11eb-908a-139a6edaec5c.gif" width="100%">

<br/>

## 🚀 Quick Start
 
 ### 前置要求 (Prerequisites)
 - Node.js 16+
 - API Key (支持 OpenAI 格式)
 
 ### 安装步骤 (Installation)
 
 1. **克隆仓库 (Clone the repository)**
    ```bash
    git clone https://github.com/YoKONCy/touhou-isekai-izakaya.git
    cd touhou-isekai-izakaya
    ```
 
 2. **安装依赖 (Install dependencies)**
    ```bash
    npm install
    ```
 
 3. **启动开发服务器 (Start development server)**
    ```bash
    npm run dev
    ```
 
 4. **配置 API (Configure API)**
    - 访问 `http://localhost:14791`
    - 点击 **设置 (⚙️)** 图标
    - 输入您的 API Base URL 和 Key

<br/>

<img src="https://user-images.githubusercontent.com/73097560/115834477-dbab4500-a447-11eb-908a-139a6edaec5c.gif" width="100%">

<br/>

## 📦 Build & Packaging

### 🌐 Web 生产构建 (Production Build)

```bash
# 类型检查 + 构建
pnpm run build
# 或跳过类型检查，仅构建
pnpm run static-build
# 预览构建产物
pnpm run preview
```

构建产物输出到 `dist/` 目录，可直接部署到任何静态文件托管服务（GitHub Pages, Vercel, Cloudflare Pages 等）。

> **⚠️ 重要**: 为了在 Web 端启用 OPFS 持久化存储，你的服务器必须设置以下 HTTP 响应头（或使用项目内置的 `coi-serviceworker.js` 自动注入）:
> ```
> Cross-Origin-Opener-Policy: same-origin
> Cross-Origin-Embedder-Policy: require-corp
> ```

### 📱 Android 打包 (Android Build)

本项目使用 [Capacitor](https://capacitorjs.com/) 将 Web 应用打包为 Android 原生应用。

#### 前置要求
- **Android Studio** (最新版)
- **JDK 21+**
- **Android SDK** (API Level 36，见 `android/variables.gradle`)

#### 打包步骤

```bash
# 1. 构建 Web 产物
pnpm run build

# 2. 同步 Web 产物到 Android 工程
npx cap copy android

# 3. 同步原生插件 (如有新增依赖)
npx cap sync android

# 4. 在 Android Studio 中打开工程
npx cap open android
```

在 Android Studio 中，选择 **Build → Generate Signed Bundle / APK** 即可生成发布包。

#### 🔧 Android 存储兼容性说明

Android WebView **不支持** `crossOriginIsolated`（这是 Chromium 的已知限制），因此标准的 OPFS VFS 无法工作。本项目采用了**三级梯度回退策略**自动处理：

| 优先级 | 存储方案 | 适用环境 | 需要 SharedArrayBuffer? |
|:---:|:---|:---|:---:|
| 1 | **OPFS** (标准) | 桌面浏览器 (Chrome, Firefox, Safari) | ✅ 是 |
| 2 | **opfs-sahpool** | Android WebView, 移动端浏览器 | ❌ 否 |
| 3 | **内存数据库** (兜底) | 极端环境 (数据不持久化) | ❌ 否 |

> `opfs-sahpool` 使用 OPFS 的 `FileSystemSyncAccessHandle` API，不依赖 `SharedArrayBuffer`，兼容所有 2023 年 3 月后发布的主流浏览器内核（Chrome 108+, Safari 16.4+, Firefox 111+）。

### 🧹 代码规范 (Code Quality)

项目已配置 **Prettier** + **ESLint** 进行代码规范化：

```bash
# 格式化所有源代码
npx prettier --write src/

# 自动修复 ESLint 问题
npx eslint --fix src/

# 类型检查 (不输出文件)
npx vue-tsc --noEmit
```

配置文件：
- `.prettierrc` — Prettier 规则（单引号、2 空格缩进、行宽 100）
- `eslint.config.js` — ESLint 规则（含 Vue + TypeScript 插件）
- `.prettierignore` — 排除 `dist/`, `node_modules/`, `android/` 等目录

<br/>

<img src="https://user-images.githubusercontent.com/73097560/115834477-dbab4500-a447-11eb-908a-139a6edaec5c.gif" width="100%">

<br/>

## 🖼️ AI Drawing Privacy

本项目支持使用 **NovelAI** 或 **OpenAI** 生成剧情插画。为了保障您的隐私与安全，请知悉以下说明：

1. **API Key 安全性**:
   - 您的 API Key **仅存储在浏览器本地** (`localStorage`)，不会上传至本项目开发者的服务器。
   - 本项目是纯前端 Web 应用，数据持久化通过浏览器端的 **SQLite Wasm + OPFS** 技术实现，无需后端服务器即可在本地存储大规模存档、对话历史与记忆图谱。

2. **中转服务器 (Proxy) 说明**:
   - 由于浏览器跨域 (CORS) 限制，直接从网页调用 NovelAI API 通常会失败。因此，本项目默认提供了一个基于 **Cloudflare Workers** 的中转地址。
   - 该中转服务仅负责 **透传 (Forwarding)** 您的请求，即：将请求转发给 NovelAI 官方服务器并将响应返回给您的浏览器。
   - **中转服务器不会记录或存储** 您的 API Key、提示词 (Prompt) 或生成的图像。Cloudflare Workers 的无服务器架构保证了处理过程的瞬时性与私密性。

3. **风险提示**:
   - 尽管默认中转服务是安全的，但如果您对隐私有极高要求，可以随时在“设置”中修改为自己的中转服务器地址。
   - 请务必妥善保管您的 API Key，不要在不受信任的环境中输入。

<br/>

<img src="https://user-images.githubusercontent.com/73097560/115834477-dbab4500-a447-11eb-908a-139a6edaec5c.gif" width="100%">

<br/>

## 📅 Roadmap

- [ ] **角色立绘**: 施工中... (11枚差分/人)
- [ ] **角色像素绘**: 施工中... (用于小游戏)
- [ ] **店铺经营 V2.0**: 自由装修与高级经营

<br/>

<img src="https://user-images.githubusercontent.com/73097560/115834477-dbab4500-a447-11eb-908a-139a6edaec5c.gif" width="100%">

<br/>

## 🗣️ Feedback

如在游玩过程中发现任何问题，或有好的建议，都可以直接在 [Issues](https://github.com/YoKONCy/touhou-isekai-izakaya/issues) 中提出。

<br/>

## ⚠️ Disclaimer

**非盈利性质 (Non-Profit)** • **AIPR 性质 (AI Roleplay)** • **二次创作 (Fan-fiction)**

</div>

- 本项目是 **上海爱丽丝幻乐团 (Team Shanghai Alice)** 原作《东方Project》的二次创作游戏。
- 所有的角色、世界观版权归原作者 **ZUN** 所有。
- 本项目遵循《东方Project》的二次创作通过准则。
- 游戏内素材（立绘、音乐）均为 AI 生成或来源于网络开源/同人授权，仅供学习交流使用。

### 🌐 联机服务特别声明 (Multiplayer Service)
本项目提供的官方联机中继服务（Relay Server）遵循以下隐私与合规原则：
1. **数据不存储**：官方中继服务器仅作为数据转发节点，**不存储任何** 玩家之间的聊天内容、游戏数据或存档。
2. **端到端加密**：所有敏感通信均支持端到端加密（需设置房间密码），确保即使是服务器运维人员也无法解析您的对话内容。
3. **内容监管**：由于技术上无法解密和存储数据，开发者无法对玩家在私密房间内的言论进行实时监控。请玩家自觉遵守当地法律法规，严禁发送非法、违规内容。
4. **服务免责**：中继服务为非盈利性质的技术交流设施，不保证 100% 的稳定性与可用性。

<br/>

Touhou-Isekai-Izakaya

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README