浮生十梦（TenCyclesofFate）

Web
浮生十梦（TenCyclesofFate）

浮生十梦（TenCyclesofFate）

Webベースの没入型テキストアドベンチャー「浮生十梦（TenCyclesofFate）」の実装リポジトリ。プレイヤーは1日に10回の「夢境（輪廻）」を通じてAI生成の物語を体験し、「知足」と「貪欲」の選択により結末が変化する。バックエンドはPython、前後リアルタイム通信はWebSocket、認証はOAuth2、コンテンツ生成に大型言語モデル（GPT等）を用いるなど、AIとリアルタイム技術を組み合わせた試みが特徴。開発運用・拡張のためのスクリプトやフロント実装も含む。プレイ体験の多様性とランダム性を重視した設計が伺える。

https://github.com/CassiopeiaCode/TenCyclesofFate

概要

《浮生十梦（TenCyclesofFate）》は、Web上で動作する文字主体の没入型アドベンチャーゲームです。プレイヤーは“命運”と向き合い、1日に10回の「夢境（生命輪回）」へ入り、各回ごとにAIが動的に生成する一連の人生ドラマを体験します。キーメカニクスは「知足（撤退）」と「貪欲（継続）」の選択で、ある行動はD100による判定（成功/失敗/大成功/大失敗）をトリガーし、物語と報酬に即時の影響を与えます。技術面では大型言語モデルの利用、WebSocketによるリアルタイム通信、OAuth2認証、UIデザインなどが統合されており、毎回ユニークな体験を提供することを目指しています。

GitHub

リポジトリの統計情報

  • スター数: 25
  • フォーク数: 6
  • ウォッチャー数: 25
  • コミット数: 6
  • ファイル数: 6
  • メインの言語: Python

主な特徴

  • AIによるリアルタイムな物語生成（大型言語モデルを利用）
  • WebSocketでの前後通信による即時反応型インタラクション
  • OAuth2（Linux.do）を用いた認証フローの組み込み
  • D100判定＋反作弊（アンチチート）によるゲーム的ランダム性と公平性の担保

技術的なポイント

README と構成から読み取れる設計上の注目点を整理します。まずバックエンドはPythonで構築されており、AI生成コンテンツは外部の大型言語モデル（例：GPT 系）を呼び出して動的にテキストを生成する設計です。各プレイは状態管理が必要で、ユーザーごとの「夢境」回数や選択履歴、D100の結果とその影響をセッションとして保持する必要があります。リアルタイム性を担保するため WebSocket を使い、フロントからの選択やAIの応答、判定結果などを逐次プッシュする想定です。

OAuth2 による認証は Linux.do を用いると明記されており、これによりユーザー識別とトークン管理が行われます。外部API（LLM）との通信にはレイテンシやコストの制御、レート制限の対策が重要です。プロンプト設計（プロンプトテンプレート、テンプレート内でのコンテキスト長管理）や生成結果のフィルタリング（安全対策、NSFW判定など）も実装上の主要課題です。

ゲーム性の核となるD100判定は「一回の要求でAIが投骰を求める」挙動を持ち、成功判定に応じた物語分岐をリアルタイムに反映します。判定の乱数ソースはサーバー側で管理することで改ざん防止を図り、READMEが示す「智能反作弊機制（アンチチート）」はこの乱数・セッション管理・行動制限（1日に10回など）の監査ログで実現されると推測されます。

フロントエンドは“江南園林”風のUIを目指したデザインで没入感を重視。静的資産・アニメーション・テキストストリーミング表示を組み合わせ、WebSocket受信に応じてテキストを逐次表示することで「リアルタイムで語られる物語」を演出します。運用面では run.sh のような起動スクリプトが同梱されているため、開発用の簡易起動やデプロイ前の準備がしやすくなっています。なお、ドキュメント・テスト・CIの記載が薄ければ、商用運用やスケールを考える際に補強が必要です。

拡張ポイントとしては（1）LLMコスト最適化（キャッシュ、部分生成の活用）、（2）多言語対応やシナリオテンプレート化、（3）セッション復元とストレージ設計（永続化）、（4）負荷対策（WebSocketセッション数増加時のスケーリング）などが挙げられます。安全性・プライバシー面ではOAuthトークン管理とAPIキーの秘匿、生成コンテンツの検閲ルール整備が重要です。

プロジェクトの構成

主要なファイルとディレクトリ：

  • .gitignore: file
  • README.md: file
  • backend: dir
  • frontend: dir
  • run.sh: file

…他 1 ファイル

リポジトリを開いてみると、バックエンド／フロントエンドが分離された典型的な構成で、ローカル実行や開発用スクリプトが用意されています。コードベースは小規模ながら、AI連携や認証・リアルタイム通信など実運用を見据えた基盤技術が実装されている点が特徴です。

まとめ

AI生成テキストとリアルタイム通信を組み合わせた、実験的で拡張性の高い文字アドベンチャー実装。

リポジトリ情報：

  • 名前: TenCyclesofFate
  • 説明: 《浮生十梦》 是一款基于 Web 的沉浸式文字冒险游戏。玩家在游戏中扮演一个与命运博弈的角色，每天有十次机会进入不同的“梦境”（即生命轮回），体验由 AI 动态生成的、独一无二的人生故事。游戏的核心在于“知足”与“贪欲”之间的抉择：是见好就收，还是追求更高的回报但可能失去一切？
  • スター数: 25
  • 言語: Python
  • URL: https://github.com/CassiopeiaCode/TenCyclesofFate
  • オーナー: CassiopeiaCode
  • アバター: https://avatars.githubusercontent.com/u/212207110?v=4

READMEの抜粋：

《浮生十梦》

《浮生十梦》 是一款基于 Web 的沉浸式文字冒险游戏。玩家在游戏中扮演一个与命运博弈的角色，每天有十次机会进入不同的“梦境”（即生命轮回），体验由 AI 动态生成的、独一无二的人生故事。游戏的核心在于“知足”与“贪欲”之间的抉择：是见好就收，还是追求更高的回报但可能失去一切？

✨ 功能特性

  • 动态 AI 生成内容:每一次游戏体验都由大型语言模型（如 GPT）实时生成，确保了故事的独特性和不可预测性。
  • 实时交互: 通过 WebSocket 实现前端与后端的实时通信，提供流畅的游戏体验。
  • OAuth2 认证: 集成 Linux.do OAuth2 服务，实现安全便捷的用户登录。
  • 精美的前端界面: 采用具有“江南园林”风格的 UI 设计，提供沉浸式的视觉体验。
  • 互动式判定系统: 游戏中的关键行动可能触发“天命判定”。AI 会根据情境请求一次 D100 投骰，其“成功”、“失败”、“大成功”或“大失败”的结果将实时影响叙事走向，增加了游戏的随机性和戏剧性。
  • 智能反作弊机制: 内置一套…