Upload 8 files

.github/close-label.yml

@@ -0,0 +1,2 @@
+🐛 Bug: ✅ Fixed
+🦄 Feature Request: ✅ Implemented

.github/issue-auto-comments.yml

@@ -0,0 +1,62 @@
+comment:
+  footer: |
+    ---
+    > I am a bot, and this is an automated message 🤖
+labels:
+  - name: ✖️ Invalid
+    labeled:
+      issue:
+        action: close
+        body: >
+          Hello @{{ issue.user.login }} your ticket has been marked as invalid.
+          Please ensure you follow the issue template, provide all requested info,
+          and be sure to check the docs + previous issues prior to raising tickets.
+      pr:
+        body: Thank you @{{ pull_request.user.login }} for suggesting this. Please follow the pull request templates.
+        action: close
+
+  - name: 👩‍💻 Good First Issue
+    labeled:
+      issue:
+        body: >
+          This issue has been marked as a good first issue for first-time contributors to implement!
+          This is a great way to support the project, while also improving your skills, you'll also be credited as a contributor once your PR is merged.
+          If you're new to SillyTavern [here are a collection of resources](https://docs.sillytavern.app/)
+          If you need any support at all, feel free to reach out via [Discord](https://discord.gg/sillytavern).
+
+  - name: ❌ wontfix
+    labeled:
+      issue:
+        action: close
+        body: >
+          This ticked has been marked as 'wontfix', which usually means it is out-of-scope, or not feasible at this time.
+          You can still fork the project and make the changes yourself.
+
+  - name: ✅ Fixed
+    labeled:
+      issue:
+        body: >
+          Hello @{{ issue.user.login }}! It looks like all or part of this issue has now been implemented.
+
+  
+  - name: ‼️ High Priority
+    labeled:
+      issue:
+        body: >
+          This ticket has been marked as high priority, and has been bumped to the top of the priority list.
+          You should expect an implementation to be pushed out soon. Thank you for your patience.
+
+  - name: 💀 Spam
+    labeled:
+      issue:
+        action: close
+        locking: lock
+        lock_reason: spam
+        body: >
+           This issue has been identified as spam, and is now locked.
+           Users who repeatedly raise spam issues may be blocked or reported.
+          
+  - name: ⛔ Don't Merge
+    labeled:
+      pr:
+        body: This PR has been temporarily blocked from merging.

.github/labeler.yml

@@ -0,0 +1,18 @@
+# Add/remove 'critical' label if issue contains the words 'urgent' or 'critical'
+#critical:
+#    - '(critical|urgent)'
+
+🪟 Windows:
+    - '(🪟 Windows)'
+
+🍎 Mac:
+    - '(🍎 Mac)'
+
+🐋 Docker:
+    - '(🐋 Docker)'
+
+📱 Termux:
+    - '(📱 Termux)'
+
+🐧 Linux:
+    - '(🐧 Linux)'

.github/pull_request_template.md

@@ -0,0 +1,5 @@
+<!-- Put X in the box below to confirm -->
+
+## Checklist:
+
+- [ ] I have read the [Contributing guidelines](https://github.com/SillyTavern/SillyTavern/blob/release/CONTRIBUTING.md).

.github/readme-ja_jp.md

@@ -0,0 +1,314 @@
+[English](readme.md) | [中文](readme-zh_cn.md) | 日本語 | [Русский](readme-ru_ru.md)
+
+![SillyTavern-Banner](https://github.com/SillyTavern/SillyTavern/assets/18619528/c2be4c3f-aada-4f64-87a3-ae35a68b61a4)
+
+モバイルデバイスにも適したレイアウト・マルチAPI（KoboldAI/CPP、Horde、NovelAI、Ooba、OpenAI、OpenRouter、Claude、Scale）、VN ライクな Waifu モード、Stable Diffusion、TTS、WorldInfo（伝承本）、カスタマイズ可能なUI、自動翻訳、大量のプロンプトオプション＋サードパーティの拡張機能をインストールする機能
+
+[TavernAI](https://github.com/TavernAI/TavernAI) v.1.2.8 のフォークに基づいています。
+
+## 重要事項
+
+1. 私たちは[ドキュメントウェブサイト](https://docs.sillytavern.app/) を作成し、ほとんどの質問にお答えしています。
+
+2. アップデートしたら使っていた拡張機能を見失いましたか？リリースバージョン 1.10.6 以降、これまで内蔵されていた拡張機能のほとんどがダウンロード可能なアドオンに変更されました。ダウンロードは、拡張機能パネル（トップバーのスタックドブロックアイコン）にある内蔵の "Download Extensions and Assets" メニューから行えます。
+
+### Cohee、RossAscends、SillyTavern コミュニティがお届けします
+
+### SillyTavern または TavernAI とは何ですか？
+
+SillyTavern は、あなたのコンピュータ（および Android スマホ）にインストールできるユーザーインターフェイスで、テキスト生成 AI と対話したり、あなたやコミュニティが作成したキャラクターとチャットやロールプレイをすることができます。
+
+SillyTavern は TavernAI 1.2.8 のフォークで、より活発な開発が行われており、多くの主要な機能が追加されています。現時点では、これらは完全に独立したプログラムと考えることができます。
+
+### ブランチ
+
+SillyTavern は、すべてのユーザーにスムーズな体験を保証するために、2 つのブランチシステムを使用して開発されています。
+
+* release -🌟 **ほとんどのユーザーにお勧め。** これは最も安定した推奨ブランチで、メジャーリリースがプッシュされた時のみ更新されます。大半のユーザーに適しています。
+* staging - ⚠️ **カジュアルな使用にはお勧めしない。** このブランチには最新の機能がありますが、いつ壊れるかわからないので注意してください。パワーユーザーとマニア向けです。
+
+git CLI の使い方に慣れていなかったり、ブランチが何なのかわからなかったりしても、心配はいりません！releaseブランチが良い選択肢となります。
+
+### Tavern 以外に何が必要ですか？
+
+Tavern は単なるユーザーインターフェイスなので、それだけでは何もできません。ロールプレイキャラクターとして機能する AI システムのバックエンドにアクセスする必要があります。様々なバックエンドがサポートされています。リストはこちらです： OpenAPI API (GPT)、KoboldAI (ローカルまたは Google Colab 上で動作)、その他。詳しくは [FAQ](https://docs.sillytavern.app/usage/faq/) をご覧ください。
+
+### Tavern を実行するには、ハイスペックなPCが必要ですか？
+
+Tavern は単なるフロントエンドのUIであり、必要なハードウェアはごくわずかです。パワフルである必要があるのは、AI システムのバックエンドです。
+
+## モバイルサポート
+
+> **注**
+
+> **このフォークは Termux を使って Android スマホで実行できます。ArroganceComplex#2659 のガイドを参照してください:**
+
+<https://rentry.org/STAI-Termux>
+
+## ご質問やご提案
+
+### コミュニティ Discord サーバーを開設しました
+
+サポートを受けたり、作成したキャラを共有したり、コミュニティの作ったキャラと遊びたいですか？:
+
+### [参加](https://discord.gg/RZdyAEUPvj)
+
+***
+
+開発者と直接連絡:
+
+* Discord: cohee または rossascends
+* Reddit: /u/RossAscends または /u/sillylossy
+* [GitHub issue を投稿](https://github.com/SillyTavern/SillyTavern/issues)
+
+## このバージョンには以下のコードが含まれます
+
+* 大幅に修正された TavernAI 1.2.8 (コードの 50% 以上が書き換えまたは最適化されています)
+* スワイプ
+* グループチャット: キャラクター同士が会話できるマルチボットルーム
+* チャットチェックポイント / ブランチ
+* 高度なKoboldAI / TextGen生成設定と、コミュニティが作成した多くのプリセット
+* ワールド情報サポート: 豊富な伝承を作成したり、キャ��クターカードにトークンを保存したりできます
+* [OpenRouter](https://openrouter.ai) 各種 API(Claude、GPT-4/3.5 など)の接続
+* [Oobabooga's TextGen WebUI](https://github.com/oobabooga/text-generation-webui) API 接続
+* [AI Horde](https://horde.koboldai.net/) 接続
+* プロンプト生成フォーマットの調整
+
+## 拡張機能
+
+SillyTavern は拡張できるようになっており、[SillyTavern Extras API](https://github.com/SillyTavern/SillyTavern-extras) でいくつかの追加AIモジュールをホストしています
+
+* 作者ノート/キャラクターバイアス
+* キャラクターの感情表現（スプライト）
+* チャット履歴の自動サマリー
+* チャットに画像を送り、AI が内容を解釈する
+* Stable Diffusion 画像生成 (5 つのチャット関連プリセットと 'free mode')
+* AI 応答メッセージの音声合成（ElevenLabs、Silero、または OS のシステム TTS 経由）
+
+含まれている拡張機能の完全なリストとその使い方のチュートリアルは [Docs](https://docs.sillytavern.app/) にあります。
+
+## RossAscends による UI/CSS/クオリティオブライフの調整
+
+* iOS 用に最適化されたモバイル UI で、ホーム画面へのショートカット保存とフルスクリーンモードでの起動をサポート。
+* ホットキー
+  * Up = チャットの最後のメッセージを編集する
+  * Ctrl+Up = チャットで最後のユーザーメッセージを編集する
+  * Left = 左スワイプ
+  * Right = 右スワイプ (注: チャットバーに何か入力されている場合、スワイプホットキーが無効になります)
+  * Ctrl+Left = ローカルに保存された変数を見る（ブラウザのコンソールウィンドウにて）
+  * Enter (チャットバー選択時) = AI にメッセージを送る
+  * Ctrl+Enter = 最後の AIのレスポンスを再生成する
+
+* ユーザー名の変更と文字の削除でページが更新されなくなりました。
+
+* ページロード時に API に自動的に接続するかどうかを切り替えます。
+* ページの読み込み時に、最近見た文字を自動的に読み込むかどうかを切り替えます。
+* より良いトークンカウンター - 保存されていないキャラクターに対して機能し、永続的なトークンと一時的なトークンの両方を表示する。
+
+* より良い過去のチャット
+  * 新しいチャットのファイル名は、"(文字) - (作成日)" という読みやすい形式で保存されます
+  * チャットのプレビューが 40 文字から 300 文字に増加。
+  * 文字リストの並べ替えに複数のオプション（名前順、作成日順、チャットサイズ順）があります。
+
+* デフォルトでは、左右の設定パネルはクリックすると閉じます。
+* ナビパネルのロックをクリックすると、パネルが開いたままになり、この設定はセッションをまたいで記憶されます。
+* ナビパネルの開閉状態もセッションをまたいで保存されます。
+
+* カスタマイズ可能なチャット UI:
+  * 新しいメッセージが届いたときにサウンドを再生する
+  * 丸型、長方形のアバタースタイルの切り替え
+  * デスクトップのチャットウィンドウを広くする
+  * オプションの半透明ガラス風パネル
+  * 'メインテキスト'、'引用テキスト'、'斜体テキスト'のページカラーをカスタマイズ可能。
+  * カスタマイズ可能な UI 背景色とぼかし量
+
+## インストール
+
+*注: このソフトウェアはローカルにインストールすることを目的としており、colab や他のクラウドノートブックサービス上では十分にテストされていません。*
+
+> **警告**
+
+> WINDOWS が管理しているフォルダ（Program Files、System32 など）にはインストールしないでください
+
+> START.BAT を管理者権限で実行しないでください
+
+### Windows
+
+Git 経由でのインストール（更新を容易にするため推奨）
+
+写真付きのわかりやすいガイドはこちらです:
+<https://docs.sillytavern.app/installation/windows/>
+
+  1. [NodeJS](https://nodejs.org/en) をインストール(最新の LTS 版を推奨)
+  2. [GitHub Desktop](https://central.github.com/deployments/desktop/desktop/latest/win32) をインストールする
+  3. Windows エクスプローラーを開く (`Win+E`)
+  4. Windows によって制御または監視されていないフォルダを参照または作成する。（例: C:\MySpecialFolder\）
+  5. 上部のアドレスバーをクリックし、`cmd` と入力して Enter キーを押し、そのフォルダーの中にコマンドプロンプトを開きます。
+  6. 黒いボックス（コマンドプロンプト）がポップアップしたら、そこに以下のいずれかを入力し、Enter を押します:
+
+* Release ブランチの場合: `git clone https://github.com/SillyTavern/SillyTavern -b release`
+* Staging ブランチの場合: `git clone https://github.com/SillyTavern/SillyTavern -b staging`
+
+  7. すべてをクローンしたら、`Start.bat` をダブルクリックして、NodeJS に要件をインストールさせる。
+  8. サーバーが起動し、SillyTavern がブラウザにポップアップ表示されます。
+
+ZIP ダウンロードによるインストール（推奨しない）
+
+  1. [NodeJS](https://nodejs.org/en) をインストールする(最新の LTS 版を推奨)
+  2. GitHub のリポジトリから zip をダウンロードする。(`ソースコード(zip)` は [Releases](https://github.com/SillyTavern/SillyTavern/releases/latest) から入手)
+  3. お好きなフォルダに解凍してください
+  4. `Start.bat` をダブルクリックまたはコマンドラインで実行する。
+  5. サーバーが準備できれば、ブラウザのタブを開きます。
+
+### Linux
+
+  1. `node -v` を実行して、Node.js v18 以上（最新の [LTS バージョン](https://nodejs.org/en/download/) を推奨）がインストールされていることを確認してください。
+または、[Node Version Manager](https://github.com/nvm-sh/nvm#installing-and-updating) スクリプトを使用して、迅速かつ簡単に Node のインストールを管理します。
+  2. `start.sh` スクリプトを実行する。
+  3. お楽しみください。
+
+## API キー管理
+
+SillyTavern は API キーをサーバーディレクトリの `secrets.json` ファイルに保存します。
+
+デフォルトでは、入力後にページをリロードしても、フロントエンドには表示されません。
+
+API ブロックのボタンをクリックして、キーを閲覧できるようにする:
+
+1. ファイル `config.yaml` で `allowKeysExposure` の値を `true` に設定する。
+2. SillyTavern サーバを再起動します。
+
+## リモート接続
+
+SillyTavern をスマホで使用しながら、同じ Wifi ネットワーク上で ST サーバーを PC で実行したい場合に使用します。
+
+しかし、これはどこからでもリモート接続を許可するために使用することができます。
+
+**重要: SillyTavern はシングルユーザーのプログラムなので、ログインすれば誰でもすべてのキャラクターとチャットを見ることができ、UI 内で設定を変更することができます。**
+
+### 1. ホワイトリスト IP の管理
+
+* SillyTavern のベースインストールフォルダ内に `whitelist.txt` という新しいテキストファイルを作成します。
+* テキストエディタでこのファイルを開き、接続を許可したい IP のリストを追加します。
+
+*個々の IP とワイルドカード IP 範囲の両方が受け入れられる。例:*
+
+```txt
+192.168.0.1
+192.168.0.20
+```
+
+または
+
+```txt
+192.168.0.*
+```
+
+(上記のワイルドカード IP 範囲は、ローカルネットワーク上のどのデバイスでも)
+
+CIDR マスクも受け付ける（例：10.0.0.0/24）。
+
+* `whitelist.txt` ファイルを保存する。
+* TAI サーバーを再起動する。
+
+これでファイルに指定された IP を持つデバイスが接続できるようになります。
+
+*注: `config.yaml` にも `whitelist` 配列があり、同じように使うことができるが、`whitelist.txt` が存在する場合、この配列は無視される。*
+
+### 2. ST ホストマシンの IP の取得
+
+ホワイトリストの設定後、ST ホストデバイスの IP が必要になります。
+
+ST ホストデバイスが同じ無線 LAN ネットワーク上にある場合、ST ホストの内部無線 LAN IP を使用します:
+
+* Windows の場合: ウィンドウズボタン > 検索バーに `cmd.exe` と入力 > コンソールに `ipconfig` と入力して Enter > `IPv4` のリストを探す。
+
+同じネットワーク上にいない状態で、ホストしているSTに接続したい場合は、STホスト機器のパブリックIPが必要です。
+
+* ST ホストデバイスを使用中に、[このページ](https://whatismyipaddress.com/)にアクセスし、`IPv4` を探してください。これはリモートデバイスからの接続に使用するものです。
+
+### 3. リモートデバイスを ST ホストマシンに接続します。
+
+最終的に使用する IP が何であれ、その IP アドレスとポート番号をリモートデバイスのウェブブラウザに入力します。
+
+同じ無線 LAN ネットワーク上の ST ホストの典型的なアドレスは以下のようになります:
+
+`http://192.168.0.5:8000`
+
+http:// を使用し、https:// は使用しないでください
+
+### ST をすべての IP に開放する
+
+これはお勧めしませんが、`config.yaml` を開き、`whitelistMode` を `false` に変更してください。
+
+SillyTavern のベースインストールフォルダにある `whitelist.txt` が存在する場合は削除（または名前の変更）する必要があります。
+
+これは通常安全ではないので、これを行う際にはユーザー名とパスワードを設定する必要があります。
+
+ユーザー名とパスワードは `config.yaml` で設定します。
+
+ST サーバを再起動すると、ユーザ名とパスワードさえ知っていれば、IP に関係なくどのデバイスでも ST サーバに接続できるようになる。
+
+### まだ接続できませんか？
+
+* `config.yaml` で見つかったポートに対して、インバウンド/アウトバウンドのファイアウォールルールを作成します。これをルーターのポートフォワーディングと間違えないでください。そうしないと、誰かがあなたのチャットログを見つける可能性があり、それはマジで止めましょう。
+* 設定 > ネットワークとインターネット > イーサネットで、プライベートネットワークのプロファイルタイプを有効にします。そうしないと、前述のファイアウォールルールを使っても接続できません。
+
+## パフォーマンスに問題がありますか？
+
+ユーザー設定パネルでブラー効果なし（高速 UI）モードを有効にしてみてください。
+
+## このプロジェクトが気に入りました！どうすれば貢献できますか？
+
+### やるべきこと
+
+1. プルリクエストを送る
+2. 確立されたテンプレートを使って機能提案と課題レポートを送る
+3. 何か質問する前に、readme ファイルや組み込みのドキュメントを読んでください
+
+### やるべきではないこと
+
+1. 金銭の寄付を申し出る
+2. 何の脈絡もなくバグ報告を送る
+3. すでに何度も回答されている質問をする
+
+## 古い背景画像はどこにありますか？
+
+100％ オリジナルコンテンツのみのポリシーに移行しているため、古い背景画像はこのリポジトリから削除されました。
+
+アーカイブはこちら:
+
+<https://files.catbox.moe/1xevnc.zip>
+
+## スクリーンショット
+
+<img width="400" alt="image" src="https://user-images.githubusercontent.com/18619528/228649245-8061c60f-63dc-488e-9325-f151b7a3ec2d.png">
+<img width="400" alt="image" src="https://user-images.githubusercontent.com/18619528/228649856-fbdeef05-d727-4d5a-be80-266cbbc6b811.png">
+
+## ライセンスとクレジット
+
+**このプログラムは有用であることを願って配布されていますが、いかなる保証もありません;
+また、商品性または特定目的への適合性についての黙示の保証もありません。
+詳細は GNU Affero General Public License をご覧ください。**
+
+* Humi によるTAI Base: 不明ライセンス
+* Cohee の修正と派生コード: AGPL v3
+* RossAscends の追加: AGPL v3
+* CncAnon の TavernAITurbo 改造の一部: 不明ライセンス
+* kingbri のさまざまなコミットと提案 (<https://github.com/bdashore3>)
+* city_unit の拡張機能と様々な QoL 機能 (<https://github.com/city-unit>)
+* StefanDanielSchwarz のさまざまなコミットとバグ報告 (<https://github.com/StefanDanielSchwarz>)
+* PepperTaco の作品にインスパイアされた Waifu モード (<https:/fugithub.com/peppertaco/Tavern/>)
+* ピグマリオン大学の皆さん、素晴らしいテスターとしてクールな機能を提案してくれてありがとう！
+* TextGen のプリセットをコンパイルしてくれた obabooga に感謝
+* KAI Lite の KoboldAI プリセット: <https://lite.koboldai.net/>
+* Google による Noto Sans フォント（OFLライセンス）
+* Font Awesome によるアイコンテーマ <https://fontawesome.com> (アイコン: CC BY 4.0、フォント: SIL OFL 1.1、コード: MIT License)
+* ZeldaFan0225 による AI Horde クライアントライブラリ: <https://github.com/ZeldaFan0225/ai_horde>
+* AlpinDale による Linux 起動スクリプト
+* FAQ を提供してくれた paniphons に感謝
+* 10K ディスコード・ユーザー記念背景 by @kallmeflocc
+* デフォルトコンテンツ（キャラクターと伝承書）の提供: @OtisAlejandro、@RossAscends、@kallmeflocc
+* @doloroushyeonse による韓国語翻訳
+* k_euler_a による Horde のサポート <https://github.com/Teashrock>
+* [@XXpE3](https://github.com/XXpE3) による中国語翻訳、中国語 ISSUES の連絡先は @XXpE3

.github/readme-ru_ru.md

@@ -0,0 +1,359 @@
+<a name="readme-top"></a>
+
+[English](readme.md) | [中文](readme-zh_cn.md) | [日本語](readme-ja_jp.md) | Русский
+
+![][cover]
+
+Мобайл-френдли интерфейс, поддержка множества API (KoboldAI/CPP, Horde, NovelAI, Ooba, OpenAI, OpenRouter, Claude, Scale), ВН-образный режим Вайфу, Stable Diffusion, TTS, поддержка миров (лорбуков), кастомизируемый UI, автоперевод, тончайшая настройка промптов + возможность устанавливать расширения.
+
+Основано на форке [TavernAI](https://github.com/TavernAI/TavernAI) версии 1.2.8
+
+## Важные новости!
+
+1. Чтобы помочь вам быстрее разобраться в SillyTavern, мы создали [сайт с документацией](https://docs.sillytavern.app/). Ответы на большинство вопросов можно найти там.
+
+2. Почему пропали расширения после апдейта? Начиная с версии 1.10.6, большинство встроенных расширений были конвертированы в формат загружаемых аддонов. Их можно установить обратно через меню "Download Extensions and Assets" на панели расширений (значок с тремя кубиками сверху).
+
+3. Не поддерживается следующая платформа: android arm LEtime-web. 32-битный Android требует внешнюю зависимость, которую нельзя установить посредством npm. Для её установки потребуется следующая команда: `pkg install esbuild`. После этого продолжайте установку по общей инструкции.
+
+### Разрабатывается Cohee, RossAscends и всем сообществом SillyTavern
+
+### Что такое SillyTavern и TavernAI?
+
+SillyTavern — это интерфейс, который устанавливается на ПК (и на Android), который даёт возможность общаться с генеративным ИИ и чатиться/ролеплеить с вашими собственными персонажами или персонажами других пользователей.
+
+SillyTavern — это форк версии TavernAI 1.2.8, который разрабатывается более активно и имеет множество новых функций. Сейчас уже можно сказать, что это две отдельные и абсолютно самостоятельные программы.
+
+## Скриншоты
+
+<img width="400" alt="image" src="https://github.com/SillyTavern/SillyTavern/assets/61471128/e902c7a2-45a6-4415-97aa-c59c597669c1"> 
+<img width="400" alt="image" src="https://github.com/SillyTavern/SillyTavern/assets/61471128/f8a79c47-4fe9-4564-9e4a-bf247ed1c961">
+
+### Ветки
+
+SillyTavern разрабатывается в двух ветках, чтобы всем категориям пользователей было удобно.
+
+* release -🌟 **Рекомендовано для большинства пользователей.** Самая стабильная ветка, рекомендуем именно её. Обновляется только в момент крупных релизов. Подходит для большей части пользователей.
+* staging - ⚠️ **Не рекомендуется для повседневного использования.** В этой ветке весь самый свежий и новый функционал, но будьте аккуратны, поскольку сломаться может в любом месте и в любое время. Только для продвинутых пользователей и энтузиастов.
+
+Если вы не умеете обращаться с git через командную строку, или не знаете, что такое ветка, то не переживайте! Наилучшим вариантом всегда остаётся ветка release.
+
+### Что ещё нужно, кроме SillyTavern?
+
+Сама по себе SillyTavern бесполезна, ведь это просто интерфейс. Вам потребуется доступ к бэкенду с ИИ, который и будет отыгрывать выбранного вами персонажа. Поддерживаются разные виды бэкендов: OpenAPI API (GPT), KoboldAI (локально или на Google Colab), и многое другое. Больше информации в [FAQ](https://docs.sillytavern.app/usage/faq/).
+
+### Требуется ли для SillyTavern мощный ПК?
+
+SillyTavern — это просто интерфейс, поэтому запустить его можно на любой картошке. Мощным должен быть бэкенд с ИИ.
+
+## Есть вопросы или предложения?
+
+### У нас появился сервер в Discord
+
+| [![][discord-shield-badge]][discord-link] | [Вступайте в наше Discord-сообщество!](https://discord.gg/sillytavern) Задавайте вопросы, делитесь любимыми персонажами и промптами. |
+| :---------------------------------------- | :----------------------------------------------------------------------------------------------------------------- |
+
+Также можно написать разработчикам напрямую:
+
+* Discord: cohee или rossascends
+* Reddit: [/u/RossAscends](https://www.reddit.com/user/RossAscends/) или [/u/sillylossy](https://www.reddit.com/user/sillylossy/)
+* [Запостить issue на GitHub](https://github.com/SillyTavern/SillyTavern/issues)
+
+## Эта версия включает
+
+* Глубоко переработанную TavernAI 1.2.8 (переписано и оптимизировано более 50% кода)
+* Свайпы
+* Групповые чаты: комнаты для нескольких ботов, где персонажи могут говорить друг с другом и с вами
+* Чекпоинты и ветки для чатов
+* Продвинутые настройки для KoboldAI / TextGen со множеством созданных сообществом пресетов
+* Поддержка миров (функция "Информация о мире" / WorldInfo): создавайте свой богатый лор, или экономьте токены для карточек персонажей
+* Соединение через [OpenRouter](https://openrouter.ai) для разных API (Claude, GPT-4/3.5 и других)
+* Соединение с API [Oobabooga's TextGen WebUI](https://github.com/oobabooga/text-generation-webui)
+* Соединение с [AI Horde](https://horde.koboldai.net/)
+* Настройку форматирования промптов
+
+## Расширения
+
+SillyTavern поддерживает расширения, при этом некоторые из ИИ-модулей работают через [SillyTavern Extras API](https://github.com/SillyTavern/SillyTavern-extras)
+
+* Заметки автора / Смещение характера
+* Эмоции для персонажей (спрайты)
+* Автоматический саммарайз (краткий пересказ) истории чата
+* Возможность отправить в чат картинку, которую ИИ сможет рассмотреть и понять
+* Генерация картинок в Stable Diffusion (5 пресетов для чата, плюс свободный режим)
+* Text-to-speech для сообщений ИИ (с помощью ElevenLabs, Silero, или родной TTS вашей ОС)
+
+Полный список расширений и инструкций к ним можно найти в [документации](https://docs.sillytavern.app/).
+
+## Улучшения от RossAscends для UI/CSS/общего удобства
+
+* Мобильный интерфейс адаптирован для iOS, добавлена возможность сохранить ярлык на главный экран и открыть приложение в полноэкранном режиме.
+* Горячие клавиши
+  * Up = Редактировать последнее сообщение в чате
+  * Ctrl+Up = Редактировать ВАШЕ последнее сообщение в чате
+  * Left = свайп влево
+  * Right = свайп вправо (ОБРАТИТЕ ВНИМАНИЕ: когда в окне ввода что-то напечатано, клавиши для свайпа не работают)
+  * Ctrl+Left = посмотреть локальные переменные (в консоли браузера)
+  * Enter (при нахождении внутри окна ввода) = отправить ваше сообщение ИИ
+  * Ctrl+Enter = Повторная генерация последнего ответа ИИ
+
+* Страница больше не перезагружается при смене имени пользователя или удалении персонажа
+
+* Отключаемая возможность автоматически соединяться с API при загрузке страницы.
+* Отключаемая возможность автоматически загружать последнего открытого персонажа при загрузк�� страницы.
+* Улучшенный счётчик токенов - работает с несохранёнными персонажами, отображает и перманентные, и временные токены
+
+* Улучшенный менеджер чатов
+  * Файлы с новыми чатами получают читабельные названия вида "(персонаж) - (когда создано)"
+  * Увеличен размер превью чата с 40 символов до 300.
+  * Несколько вариантов сортировки списка персонажей (по имени, дате создания, размеру чата).
+
+* Панели настроек слева и справа автоматически скрываются, если щёлкнуть за их пределы.
+* При нажатии на значок замка навигационная панель будет закреплена на экране, и эта настройка сохранится между сессиями
+* Сам статус панели (открыта или закрыта) также сохраняется между сессиями
+
+* Кастомизируемый интерфейс чата:
+  * Настройте звук при получении нового ответа
+  * Переключайтесь между круглыми и прямоугольными аватарками
+  * Увеличенное вширь окно чата для стационарных ПК
+  * Возможность включать полупрозрачные панели, стилизованные под стекло
+  * Настраиваемые цвета для обычного текста, курсива, цитат
+  * Настраиваемый цвет фона и интенсивность размытия
+
+# ⌛ Установка
+
+> **Внимание!**
+> * НЕ УСТАНАВЛИВАЙТЕ В ПАПКИ, КОТОРЫЕ КОНТРОЛИРУЕТ WINDOWS (Program Files, System32 и т.п.).
+> * НЕ ЗАПУСКАЙТЕ START.BAT С ПРАВАМИ АДМИНИСТРАТОРА
+> * УСТАНОВКА НА WINDOWS 7 НЕВОЗМОЖНА ИЗ-ЗА ОТСУТСТВИЯ NODEJS 18.16
+
+## 🪟 Windows
+
+## Установка через Git
+  1. Установите [NodeJS](https://nodejs.org/en) (рекомендуется последняя LTS-версия)
+  2. Установите [Git for Windows](https://gitforwindows.org/)
+  3. Откройте Проводник (`Win+E`)
+  4. Перейдите в папку, которую не контролирует Windows, или создайте её. (пример: C:\MySpecialFolder\)
+  5. Откройте командную строку. Для этого нажмите на адресную строку (сверху), введите `cmd` и нажмите Enter.
+  6. Когда появится чёрное окошко (командная строка), введите ОДНУ из перечисленных ниже команд:
+
+- для ветки release: `git clone https://github.com/SillyTavern/SillyTavern -b release`
+- для ветки staging: `git clone https://github.com/SillyTavern/SillyTavern -b staging`
+
+  7. Когда клонирование закончится, дважды щёлкните по `Start.bat`, чтобы установить зависимости для NodeJS.
+  8. После этого сервер запустится, и SillyTavern откроется в вашем браузере.
+
+## Установка с помощью SillyTavern Launcher
+ 1. Установите [Git for Windows](https://gitforwindows.org/)
+ 2. Откройте Проводник (`Win+E`) и создайте или выберите папку, в которую будет установлен лаунчер
+ 3. Откройте командную строку. Для этого нажмите на адресную строку (сверху), введите `cmd` и нажмите Enter.
+ 4. Когда появится чёрное окошко, введите следующую команду: `git clone https://github.com/SillyTavern/SillyTavern-Launcher.git`
+ 5. Дважды щёлкните по `installer.bat` и выберите, что именно хотите установить
+ 6. После завершения установки дважды щёлкните по `launcher.bat`
+
+## Установка с помощью GitHub Desktop
+(Тут речь про git **только** в рамках GitHub Desktop, если хотите использовать `git` в командной строке, вам также понадобится [Git for Windows](https://gitforwindows.org/))
+  1. Установите [NodeJS](https://nodejs.org/en) (latest LTS version is recommended)
+  2. Установите [GitHub Desktop](https://central.github.com/deployments/desktop/desktop/latest/win32)
+  3. После завершения установки GitHub Desktop, нажмите `Clone a repository from the internet....` (обратите внимание: для этого шага **НЕ требуется** аккаунт на GitHub)
+  4. В меню перейдите на вкладку URL, введите адрес `https://github.com/SillyTavern/SillyTavern`, и нажмите Clone. В поле Local path можно изменить директорию, в которую будет загружена SillyTavern.
+  6. Чтобы запустить SillyTavern, откройте Проводник и перейдите в выбранную на предыдущем шаге папку. По умолчанию репозиторий будет склонирован сюда: `C:\Users\[Имя пользователя]\Documents\GitHub\SillyTavern`
+  7. Дважды щёлкните по файлу `start.bat`. (обратите внимание: окончание `.bat` может быть скрыто настройками вашей ОС. Таким образом, имя файла будет выглядеть как "`Start`". Дважды щёлкните по нему, чтобы запустить SillyTavern)
+  8. После того, как вы дважды щёлкнули по файлу, должно открыться чёрное окошко, и SillyTavern начнёт устанавливать свои зависимости.
+  9. Если установка прошла успешно, то в командной строке будет вот такое, а в браузере откроется вкладка с SillyTavern:
+  10. Подключайтесь к любому из [поддерживаемых API](https://docs.sillytavern.app/usage/api-connections/) и начинайте переписку!
+
+## 🐧 Linux и 🍎 MacOS
+
+В MacOS и Linux всё это делается через Терминал.
+
+1. Установите git и nodeJS (как именно - зависит от вашей ОС)
+2. Клонируйте репозиторий
+
+- для ветки release: `git clone https://github.com/SillyTavern/SillyTavern -b release`
+- для ветки staging: `git clone https://github.com/SillyTavern/SillyTavern -b staging`
+
+3. Перейдите в папку установки с помощью `cd SillyTavern`.
+4. Запустите скрипт `start.sh` с помощью одной из команд:
+
+- `./start.sh`
+- `bash start.sh`
+
+## Установка с помощью SillyTavern Launcher
+
+### Для пользователей Linux
+1. Откройте любимый терминал и установите git
+2. Загрузите Sillytavern Launcher с помощью команды: `git clone https://github.com/SillyTavern/SillyTavern-Launcher.git`
+3. Перейдите в SillyTavern-Launcher: `cd SillyTavern-Launcher`
+4. Запустите лаунчер установки: `chmod +x install.sh && ./install.sh`, затем выберите, что конкретно хотите установить
+5. После завершения установки, запустите лаунчер следующей командой: `chmod +x launcher.sh && ./launcher.sh`
+
+### Для пользователей Mac
+1. Откройте терминал и установите brew: `/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"`
+2. Затем установите git: `brew install git`
+3. Загрузите Sillytavern Launcher: `git clone https://github.com/SillyTavern/SillyTavern-Launcher.git`
+4. Перейдите в SillyTavern-Launcher: `cd SillyTavern-Launcher`
+5. Запустите лаунчер установки: `chmod +x install.sh && ./install.sh` and choose what you wanna install
+6. После завершения установки, запустите лаунчер следующей командой: `chmod +x launcher.sh && ./launcher.sh`
+
+## 📱 Мобильные устройства - Установка при помощи termux
+
+> **ОБРАТИТЕ ВНИМАНИЕ!**
+> 
+> **На Android-телефонах SillyTavern можно запускать нативно посредством Termux. Обратитесь к гайду, написанному ArroganceComplex#2659:**
+> 
+> * <https://rentry.org/STAI-Termux>
+
+
+## Управление ключами от API
+
+SillyTavern сохраняет ключи от ваших API в файле `secrets.json` в папке на сервере.
+
+По умолчанию, ключи не будут отображаться на фронте после их ввода и перезагрузки страницы.
+
+Чтобы включить возможность отображения ключей путём нажатия кнопки в блоке API:
+
+1. Зайдите в файл `config.yaml` и уст��новите `allowKeysExposure` в положение `true`.
+2. Перезапустите сервер SillyTavern.
+
+## Удалённое подключение
+
+В основном этим пользуются тогда, когда хотят использовать SillyTavern с телефона, запустив сервер SillyTavern на стационарном ПК в той же Wi-Fi-сети.
+
+Однако это позволит подключаться откуда угодно, а не только вам.
+
+**ВАЖНО: в SillyTavern не предусмотрена возможность использования программы несколькими людьми. Поэтому любой, кто подключится к вашему серверу, получит доступ ко всем вашим персонажам и чатам, а также сможет менять настройки через UI.**
+
+### 1. Заведение "белого списка" IP-адресов
+
+* Создайте в корневой папке SillyTavern файл с названием `whitelist.txt`.
+* Откройте файл в текстовом редакторе и внесите список IP-адресов, с которых хотите разрешить подключение.
+
+*Принимаются как обычные IP-адреса, так и целые диапазоны, размеченные с помощью астериска. Примеры:*
+
+```txt
+192.168.0.1
+192.168.0.20
+```
+
+или
+
+```txt
+192.168.0.*
+```
+
+(диапазон из примера сверху позволит подключаться всем устройствам в локальной сети)
+
+Также принимаются маски CIDR (вида 10.0.0.0/24).
+
+* Сохраните файл `whitelist.txt`.
+* Перезапустите сервер ST.
+
+После этого устройства из белого списка смогут подключаться к вашему серверу.
+
+*Обратите внимание: в файле `config.yaml` также имеется массив `whitelist`, который работает по тому же принципу. Однако если существует файл `whitelist.txt`, то этот массив игнорируется.*
+
+### 2. Получение IP хост-машины с ST
+
+После настройки белого списка адресов, следующим шагом будет получение IP-адреса хост-машины, на которой запущена SillyTavern.
+
+Если хост-машина находится в той же Wi-Fi-сети, то можно воспользоваться её внутренним Wi-Fi-IP-адресом:
+
+* На Windows: нажмите Пуск > введите `cmd.exe` в поиске > в консоли введите команду `ipconfig` и нажмите Enter > найдите пункт `IPv4-адрес`.
+
+Если вы (или кто-то другой) хотите подключаться к хост-машине из другой сети, то вам понадобится ваш публичный IP-адрес.
+
+* Откройте [эту страницу](https://whatismyipaddress.com/) с вашей хост-машины и найдите пункт `IPv4`. На этот адрес и будет подключаться удалённое устройство.
+
+### 3. Соединить удалённое устройство с хост-машиной ST
+
+Какой бы IP-адрес вы ни выбрали, вам нужно будет вводить его в адресной строке браузера вашего удалённого устройства.
+
+Обычный адрес хост-машины, находящейся в той же Wi-Fi-сети, выглядит примерно так:
+
+`http://192.168.0.5:8000`
+
+НЕ используйте https://
+Только http://
+
+### Открытие доступа до ST для всех IP-адресов
+
+Мы не рекомендуем так делать, но вы можете открыть файл `config.yaml` и изменить `whitelistMode` на `false`.
+
+Обязательно нужно удалить (или переименовать) файл `whitelist.txt`, если такой файл есть в корневой директории SillyTavern.
+
+Эта практика считается небезопасной, поэтому, если вы решите так сделать, мы попросим вас установить логин и пароль.
+
+Оба этих параметра настраиваются в `config.yaml` (username и password).
+
+Останется только перезапустить сервер ST, и после этого к вам сможет подключитьс�� любой пользователь вне зависимости от IP-адреса его устройства. Главное, чтобы он знал логин и пароль.
+
+### Не получается соединиться?
+
+* Создайте входящее/исходящее правило в вашем фаерволле для порта, указанного в `config.yaml`. НЕ ПУТАЙТЕ этот процесс с пробросом портов на роутере. Если по ошибке перепутаете, то на ваш сервер сможет забраться посторонний человек и украсть ваши логи, этого следует избегать.
+* Переключите Сетевой профиль на значение "Частные". Для этого зайдите в Параметры > Сеть и Интернет > Ethernet. КРАЙНЕ важно для Windows 11, без этого не получится подключиться даже с правилом фаервола.
+
+## Проблемы с производительностью?
+
+Попробуйте включить опцию "Отключить эффект размытия" в меню "Пользовательские настройки".
+
+## Нравится ваш проект! Как помочь?
+
+### ЧТО ДЕЛАТЬ
+
+1. Присылайте пулл реквесты
+2. Присылайте идеи и баг-репорты, оформленные по установленным шаблонам
+3. Прежде чем задавать вопросы, прочтите readme и документацию
+
+### ЧЕГО НЕ ДЕЛАТЬ
+
+1. Предлагать донаты
+2. Присылать баг-репорты безо всякого контекста
+3. Задавать вопросы, на которые уже отвечали
+
+## Где найти старые фоны?
+
+Мы двигаемся в сторону 100% уникальности всего используемого контента, поэтому старые фоны были убраны из репозитория.
+
+Они отправлены в архив, скачать их можно здесь:
+
+<https://files.catbox.moe/1xevnc.zip>
+
+
+
+
+## Авторы и лицензии
+
+**Мы надеемся, что эта программа принесёт людям пользу,
+но мы не даём НИКАКИХ ГАРАНТИЙ; мы ни в коем случае не гарантируем того,
+что программа СООТВЕТСТВУЕТ КАКИМ-ЛИБО КРИТЕРИЯМ или ПРИГОДНА ДЛЯ КАКОЙ-ЛИБО ЦЕЛИ.
+Подробнее можно узнать в GNU Affero General Public License.**
+
+* Базовая TAI от Humi: Лицензия неизвестна
+* Модификации от Cohee и производная кодовая база: AGPL v3
+* Дополнения RossAscends: AGPL v3
+* Кусочки TavernAITurbo мода от CncAnon: Лицензия неизвестна
+* Различные коммиты и предложения от kingbri (<https://github.com/bdashore3>)
+* Расширения и внедрение разного рода удобств - city_unit (<https://github.com/city-unit>)
+* Различные коммиты и баг-репорты от StefanDanielSchwarz (<https://github.com/StefanDanielSchwarz>)
+* Режим Вайфу вдохновлён работой PepperTaco (<https://github.com/peppertaco/Tavern/>)
+* Благодарность Pygmalion University за прекрасную работу по тестированию и за все предлагаемые крутые фичи!
+* Благодарность oobabooga за компиляцию пресетов для TextGen
+* Пресеты для KoboldAI из KAI Lite: <https://lite.koboldai.net/>
+* Шрифт Noto Sans от Google (OFL license)
+* Тема Font Awesome <https://fontawesome.com> (Иконки: CC BY 4.0, Шрифты: SIL OFL 1.1, Код: MIT License)
+* Клиентская библиотека для AI Horde от ZeldaFan0225: <https://github.com/ZeldaFan0225/ai_horde>
+* Пусковой скрипт для Linux от AlpinDale
+* Благодарность paniphons за оформление документа с FAQ
+* Фон в честь 10 тысяч пользователей в Discord от @kallmeflocc
+* Стандартный контент (персонажи и лорбуки) предоставлен пользователями @OtisAlejandro, @RossAscends и @kallmeflocc
+* Корейский перевод от @doloroushyeonse
+* Поддержка k_euler_a для Horde от <https://github.com/Teashrock>
+* Китайский перевод от [@XXpE3](https://github.com/XXpE3), 中文 ISSUES 可以联系 @XXpE3
+
+<!-- LINK GROUP -->
+[back-to-top]: https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square
+[cover]: https://github.com/SillyTavern/SillyTavern/assets/18619528/c2be4c3f-aada-4f64-87a3-ae35a68b61a4
+[discord-link]: https://discord.gg/sillytavern
+[discord-shield]: https://img.shields.io/discord/1100685673633153084?color=5865F2&label=discord&labelColor=black&logo=discord&logoColor=white&style=flat-square
+[discord-shield-badge]: https://img.shields.io/discord/1100685673633153084?color=5865F2&label=discord&labelColor=black&logo=discord&logoColor=white&style=for-the-badge

.github/readme-zh_cn.md

@@ -0,0 +1,306 @@
+[English](readme.md) | 中文 | [日本語](readme-ja_jp.md) | [Русский](readme-ru_ru.md)
+
+![image](https://github.com/SillyTavern/SillyTavern/assets/18619528/c2be4c3f-aada-4f64-87a3-ae35a68b61a4)
+
+移动设备界面友好，多种人工智能服务或模型支持（KoboldAI/CPP, Horde, NovelAI, Ooba, OpenAI, OpenRouter, Claude, Scale），类似 Galgame 的 老 婆 模 式，Horde SD，文本系统语音生成，世界信息（Lorebooks），可定制的界面，自动翻译，和比你所需要的更多的 Prompt。附带扩展服务，支持文本绘画生成与语音生成和基于向量数据库 的聊天信息总结。
+
+基于 TavernAI 1.2.8 的分叉版本
+
+### 由 Cohee、RossAscends 和 SillyTavern 社区为您呈现
+
+注意：我们创建了一个 [帮助文档](https://docs.sillytavern.app/) 网站来回答各类问题与帮助您开始使用。
+
+### SillyTavern 或 TavernAI 是什么？
+
+SillyTavern 是一个可以安装在电脑（和安卓手机）上的用户界面，让您可以与文本生成的人工智能互动，并与您或社区创建的角色聊天/玩角色扮演游戏。
+
+SillyTavern 是 TavernAI 1.2.8 的一个分支，正在进行更积极地开发，并添加了许多重要功能。在这一点上，它可以被视为完全独立的程序。
+
+### 分支
+
+SillyTavern 采用双分支进行开发，以确保所有用户都能获得流畅的使用体验。
+
+* release -🌟 **推荐给大多数用户。** 这是最稳定、最推荐的分支，只有在重大版本推送时才会更新。适合大多数用户使用。
+* staging - ⚠️ **不建议随意使用。** 该分支拥有最新功能，但要谨慎，因为它随时可能崩溃。仅适用于高级用户和爱好者。
+
+如果你不熟悉使用 Git 命令，或者不了解什么是分支，别担心！release 分支始终是您的首选。
+
+### 除了 SillyTavern，我还需要什么？
+
+SillyTavern 本身并无用处，因为它只是一个用户聊天界面。你必须接入一个能充当角色扮演的人工智能系统。支持的人工智能系统有多种：OpenAPI API (GPT)、KoboldAI（可在本地或 Google Colab 上运行）等。您可以在 [常见问题](https://docs.sillytavern.app/usage/faq/) 中阅读更多相关信息。
+
+### 我需要一台性能强大的电脑来运行 SillyTavern 吗？
+
+由于 SillyTavern 只是一个用户聊天界面，它对硬件性能的要求很低，可以在任何电脑上运行。需要强大性能的是人工智能系统。
+
+### 移动设备支持
+
+> 注意
+
+> **此分叉可使用 Termux 在安卓手机上原生运行。请参考 ArroganceComplex#2659 编写的指南：**
+
+<https://rentry.org/STAI-Termux>
+
+## 有问题或建议？
+
+### 我们现在有了 Discord 社区
+
+获取支持，或分享喜爱的角色和 Prompt：
+
+### [加入 Discord 社区](https://discord.gg/sillytavern)
+
+***
+
+直接与开发人员联系：
+
+* Discord: cohee 或 rossascends
+* Reddit：/u/RossAscends 或 /u/sillylossy
+* [发布 GitHub 问题](https://github.com/SillyTavern/SillyTavern/issues)
+
+## 此版本包括
+
+* 经过大量修改的 TavernAI 1.2.8（超过 50% 的代码经过重写或优化）
+* 根据自定义规则自动重新生成消息
+* 群聊：多机器人房间，供角色与你或彼此交谈
+* 聊天书签/分支（复制当前状态下的对话）
+* 先进的 KoboldAI / TextGen 生成设置，包含大量社区预设
+* 支持世界信息（Lorebooks）：创建丰富的传说
+* 支持 Window AI 浏览器扩展（运行 Claude、GPT 4 等模型）：<https://windowai.io/>
+* [Oobabooga's TextGen WebUI](https://github.com/oobabooga/text-generation-webui) API 连接
+* 连接 [AI Horde](https://horde.koboldai.net/)
+* Prompt 生成格式调整
+* Webp 角色卡支持（PNG 仍是内部格式）
+
+## 扩展
+
+SillyTavern 支持扩展服务，一些额外的人工智能模块可通过 [SillyTavern Extras API](https://github.com/SillyTavern/SillyTavern-extras) 提供。
+
+* 作者注释/角色偏见
+* 角色情绪识别
+* 聊天记录自动摘要
+* 在聊天窗口发送图片，并由人工智能解释图片内容
+* 文本图像生成（5 预设，以及 "自由模式"）
+* 聊天信息的文字转语音（通过 ElevenLabs、Silero 或操作系统的语音生成）
+
+扩展服务的完整功能介绍和使用教程，请参阅 [Docs](https://docs.sillytavern.app/)。
+
+## 界面/CSS/性能，由 RossAscends 调整并优化
+
+* 针对 iOS 系统优化了界面，并支持将快捷方式保存到主屏幕，在全屏模式下打开。
+* 热键
+  * 上 = 编辑聊天中的最后一条信息
+  * Ctrl+P = 编辑聊天中最后一条用户信息
+  * 左 = 向左滑动
+  * 右 = 向右滑动（注意：当聊天窗口输入内容时，轻扫快捷键将被禁用）
+  * Ctrl+左 = 查看本地存储的变量（在浏览器控制台窗口中）
+  * 回车（选择聊天栏）= 向人工智能发送信息
+  * Ctrl+Enter = 重新生成人工智能最后的回复
+
+* 用户名更改和角色删除不再强制重新刷新页面。
+
+* 增加在页面加载时自动连接 API 的选项。
+* 增加选项，在页面加载时自动加载最近的聊天信息。
+* 更好的 Tokens 计算器 - 适用于未保存的文字，并显示永久和临时 Tokens 数量
+
+* 更好的聊天历史查询窗口
+  * 聊天的文件名以"（角色卡名称）+（创建时间）"的可读格式保存
+  * 聊天历史预览从 40 个字符增加到 300 个字符。
+  * 聊天历史排序有多种选择（按名称、创建日期、聊天记录大小）。
+
+* 默认情况下，左侧和右侧弹出的设置面板会在点击其他区域时自动关闭。
+* 点击导航面板上的 "锁按钮" 将保持弹出面板打开，并在不同聊天中记住此设置。
+* 导航面板的打开或关闭状态也会跨聊天保存。
+
+* 自定义聊天界面：
+  * 收到新消息时播放提示音
+  * 切换圆形或长方形头像样式
+  * 在台式电脑上拥有更宽的聊天窗口
+  * 可选的半透明玻璃效果聊天窗口
+  * 可定制 "主文本"、"引用文本 "和 "斜体文本 "的字体颜色。
+  * 可定制聊天界面的背景颜色和透明模糊程度
+
+## 安装
+
+*注意：SillyTavern 用于本地安装，尚未在 Colab 或其他云服务上进行全面测试。
+
+> **警告**
+
+> 切勿安装到任何受 Windows 控制的系统文件夹（Program Files, System32, etc）中。
+
+> 不要以管理员权限运行 start.bat
+
+### Windows
+
+通过 Git 安装（推荐使用，便于更新）
+
+附有精美图片示例的简易指南：
+<https://docs.sillytavern.app/installation/windows/>
+
+  1. 安装 [NodeJS](https://nodejs.org/en)（建议使用最新的 LTS 版本）
+  2. 安装 [GitHub 客户端](https://central.github.com/deployments/desktop/desktop/latest/win32)
+  3. 打开 Windows 资源管理器 (`Win+E`)
+  4. 浏览或创建一个不受 Windows 控制或监控的文件夹。(例如：C:\MySpecialFolder\)
+  5. 点击顶部的 "地址栏"，在该文件夹内打开命令提示符，输入 `cmd`，然后按回车。
+  6. 弹出黑框（CMD 命令提示符）后，键入以下其中一项并按 Enter：
+
+* 稳定分支：`git clone https://github.com/SillyTavern/SillyTavern -b release`
+* 开发分支： `git clone https://github.com/SillyTavern/SillyTavern -b staging`
+
+  7. 等待 Git 克隆完成后，双击文件夹中的 `Start.bat` 将启动 NodeJS 并开始自动安装需要的软件包。
+  8. 然后 SillyTavern 服务就会自动启动，同时在浏览器新标签页中自动打开。
+
+通过压缩包下载安装（不推荐）
+
+  1. 安装 [NodeJS](https://nodejs.org/en)（建议使用最新的 LTS 版本）
+  2. 从该 GitHub 仓库下载压缩包。(从 [Releases](https://github.com/SillyTavern/SillyTavern/releases/latest) 获取 "Source code（zip）"）。
+  3. 将压缩包解压到您选择的文件夹中
+  4. 双击或在命令行中运行 `Start.bat`。
+  5. SillyTavern 服务自动为你准备好一切后，会在你的浏览器中打开一个新标签页。
+
+### Linux
+
+  1.运行 `start.sh` 脚本。
+  2.等待自动完成，然后开始享受
+
+## API 密钥管理
+
+SillyTavern 会将 API 密钥保存在目录中的 `secrets.json` 文件内。
+
+默认情况下，输入密钥并重新加载页面后，密钥会自动隐藏以保证安全。
+
+如果要想通过点击 API 输入框旁边的按钮来查看密钥，请按照以下设置：
+
+1. 打开 `config.yaml` 文件，将里面的 `allowKeysExposure` 设置为 `true`。
+2. 然后重启 SillyTavern 服务。
+
+## 远程访问
+
+这通常是为那些想在手机上使用 SillyTavern 的人准备的，而他们的电脑和手机在同一个局域网中。
+
+不过，SillyTavern 也可以被设置为允许从任何地方进行远程访问。
+
+**重要提示：SillyTavern 是单用户程序，因此任何人登录后都能看到所有的角色卡和聊天内容，并能更改任何设置。
+
+### 1.管理白名单 IP
+
+* 在你的 SillyTavern 文件夹中新建一个文本文件，名为 `whitelist.txt`。
+* 用文本编辑器打开该文件，添加你希望允许连接的 IP 地址列表。
+* 接受单个 IP 地址和 IP 范围，示例：
+
+```
+192.168.0.1
+192.168.0.20
+```
+
+或者
+
+```
+192.168.0.*
+```
+
+(上述 IP 范围将允许局域网中的任何设备连接）
+
+也接受子网掩码设置（如 10.0.0.0/24）。
+
+* 保存`whitelist.txt`文件。
+* 重启 SillyTavern 服务。
+
+然后，文件中设置的 IP 就可以访问 SillyTavern 了。
+
+*注意："config.yaml" 文件内也有一个 "whitelist" 设置，你可以用同样的方法设置它，但如果 "whitelist.txt" 文件存在，这个设置将被忽略。
+
+### 2.获取 SillyTavern 服务的 IP 地址
+
+白名单设置完成后，您需要 SillyTavern 服务的 IP 地址。
+
+如果 SillyTavern 服务设备在同一个局域网上，则使用安装 SillyTavern 服务的电脑的局域网 IP 地址：
+
+* Windows：Windows 按钮 > 在搜索栏中输入 `cmd.exe` > 在打开的控制台中输入 `ipconfig`，回�� > 然后在输出中查找 `IPv4` 地址。
+
+如果您（或其他人）想在互联网中访问你自己的 SillyTavern 服务，则需要运行 SillyTavern 服务的设备的互联网 IP 地址。
+
+* 使用运行 SillyTavern 的设备，访问 [this page](https://whatismyipaddress.com/) 并查找 `IPv4`。这是您从互联网访问时要用到的。
+
+### 3. 使用其他设备访问 SillyTavern 服务
+
+无论你最终使用的是什么 IP 地址，都要将该 IP 地址和端口号输入其他设备网络浏览器。
+
+同一局域网中的 SillyTavern 服务的典型默认地址如下：
+
+`http://192.168.0.5:8000`
+
+使用 http:// 而不是 https://
+
+### 向所有 IP 开放您的 SillyTavern 服务
+
+我们不建议这样做，但您可以打开 `config.yaml` 并将里面的 `whitelistMode` 设置改为 `false`。
+
+你必须删除（或重命名）SillyTavern 文件夹中的 `whitelist.txt` 文件（如果有的话）。
+
+这通常是不安全的做法，所以我们要求在这样做时必须设置用户名和密码。
+
+用户名和密码在`config.yaml`文件中设置。
+
+重启 SillyTavern 服务后，只要知道用户名和密码，任何设备都可以访问。
+
+### 还是无法访问？
+
+* 为 `config.yaml` 文件中的端口创建一条入站/出站防火墙规则。切勿将此误认为是路由器上的端口转发，否则，有人可能会发现你的聊天隐私，那就大错特错了。
+* 在 "设置" > "网络和 Internet" > "以太网" 中启用 "专用网络" 配置。这对 Windows 11 非常重要，否则即使添加了上述防火墙规则也无法连接。
+
+### 性能问题？
+
+尝试在用户设置面板上关闭模糊效果（快速用户界面）模式。
+
+## 我喜欢你的项目！我该如何贡献自己的力量？
+
+### 应该
+
+1. 发送 Fork 请求
+2. 使用规定的模板发送功能建议和问题报告
+3. 在提出任何问题之前，请先阅读 Readme 文件和文档
+
+#### 不应该
+
+1. 提供金钱捐赠
+2. 发送错误报告而不提供任何详细信息
+3. 提出已经回答过无数次的问题
+
+## 我在哪里可以找到以前的聊天背景图片？
+
+我们正在实行 100% 原创内容的政策，因此旧的背景图片已从该资源库中删除。
+
+不过你可以在这里找到它们的存档：
+
+<https://files.catbox.moe/1xevnc.zip>
+
+## 屏幕截图
+
+<img width="400" alt="image" src="https://user-images.githubusercontent.com/18619528/228649245-8061c60f-63dc-488e-9325-f151b7a3ec2d.png">
+<img width="400" alt="image" src="https://user-images.githubusercontent.com/18619528/228649856-fbdeef05-d727-4d5a-be80-266cbbc6b811.png">
+
+## 许可证和贡献
+
+**发布本程序是希望它能有所帮助，但不做任何保证；甚至没有明示的性能、稳定性和其他任何特定用途的可用性保证。更多详情，请参阅 GNU Affero 通用公共许可证。**
+
+**This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.**
+
+* TAI Base by Humi: Unknown license
+* Cohee's modifications and derived code: AGPL v3
+* RossAscends' additions: AGPL v3
+* Portions of CncAnon's TavernAITurbo mod: Unknown license
+* kingbri's various commits and suggestions (<https://github.com/bdashore3>)
+* StefanDanielSchwarz's various commits and bug reports (<https://github.com/StefanDanielSchwarz>)
+* Waifu mode inspired by the work of PepperTaco (<https://github.com/peppertaco/Tavern/>)
+* Thanks Pygmalion University for being awesome testers and suggesting cool features!
+* Thanks oobabooga for compiling presets for TextGen
+* KoboldAI Presets from KAI Lite: <https://lite.koboldai.net/>
+* Noto Sans font by Google (OFL license)
+* Icon theme by Font Awesome <https://fontawesome.com> (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License)
+* AI Horde client library by ZeldaFan0225: <https://github.com/ZeldaFan0225/ai_horde>
+* Linux startup script by AlpinDale
+* Thanks paniphons for providing a FAQ document
+* 10K Discord Users Celebratory Background by @kallmeflocc
+* Default content (characters and lore books) provided by @OtisAlejandro, @RossAscends and @kallmeflocc
+* Korean translation by @doloroushyeonse
+* 中文翻译由 [@XXpE3](https://github.com/XXpE3) 完成，中文 ISSUES 可以联系 @XXpE3

.github/readme.md

@@ -0,0 +1,419 @@
+<a name="readme-top"></a>
+
+English | [中文](readme-zh_cn.md) | [日本語](readme-ja_jp.md) | [Русский](readme-ru_ru.md)
+
+![][cover]
+
+Mobile-friendly layout, Multi-API (KoboldAI/CPP, Horde, NovelAI, Ooba, OpenAI, OpenRouter, Claude, Scale), VN-like Waifu Mode, Stable Diffusion, TTS, WorldInfo (lorebooks), customizable UI, auto-translate, and more prompt options than you'd ever want or need + ability to install third-party extensions.
+
+Based on a fork of [TavernAI](https://github.com/TavernAI/TavernAI) 1.2.8
+
+## Important news!
+
+1. We have created a [Documentation website](https://docs.sillytavern.app/) to answer most of your questions and help you get started.
+
+2. Missing extensions after the update? Since the 1.10.6 release version, most of the previously built-in extensions have been converted to downloadable add-ons. You can download them via the built-in "Download Extensions and Assets" menu in the extensions panel (stacked blocks icon in the top bar).
+
+3. Unsupported platform: android arm LEtime-web. 32-bit Android requires an external dependency that can't be installed with npm. Use the following command to install it: `pkg install esbuild`. Then run the usual installation steps.
+
+### Brought to you by Cohee, RossAscends, and the SillyTavern community
+
+### What is SillyTavern or TavernAI?
+
+SillyTavern is a user interface you can install on your computer (and Android phones) that allows you to interact with text generation AIs and chat/roleplay with characters you or the community create.
+
+SillyTavern is a fork of TavernAI 1.2.8 which is under more active development and has added many major features. At this point, they can be thought of as completely independent programs.
+
+## Screenshots
+
+<img width="400" alt="image" src="https://github.com/SillyTavern/SillyTavern/assets/61471128/e902c7a2-45a6-4415-97aa-c59c597669c1"> 
+<img width="400" alt="image" src="https://github.com/SillyTavern/SillyTavern/assets/61471128/f8a79c47-4fe9-4564-9e4a-bf247ed1c961">
+
+### Branches
+
+SillyTavern is being developed using a two-branch system to ensure a smooth experience for all users.
+
+* release -🌟 **Recommended for most users.** This is the most stable and recommended branch, updated only when major releases are pushed. It's suitable for the majority of users.
+* staging - ⚠️ **Not recommended for casual use.** This branch has the latest features, but be cautious as it may break at any time. Only for power users and enthusiasts.
+
+If you're not familiar with using the git CLI or don't understand what a branch is, don't worry! The release branch is always the preferable option for you.
+
+### What do I need other than SillyTavern?
+
+On its own SillyTavern is useless, as it's just a user interface. You have to have access to an AI system backend that can act as the roleplay character. There are various supported backends: OpenAPI API (GPT), KoboldAI (either running locally or on Google Colab), and more. You can read more about this in [the FAQ](https://docs.sillytavern.app/usage/faq/).
+
+### Do I need a powerful PC to run SillyTavern?
+
+Since SillyTavern is only a user interface, it has tiny hardware requirements, it will run on anything. It's the AI system backend that needs to be powerful.
+
+## Questions or suggestions?
+
+### We now have a community Discord server
+
+| [![][discord-shield-badge]][discord-link] | [Join our Discord community!](https://discord.gg/sillytavern) Get support, share favorite characters and prompts. |
+| :---------------------------------------- | :----------------------------------------------------------------------------------------------------------------- |
+
+Or get in touch with the developers directly:
+
+* Discord: cohee or rossascends
+* Reddit: [/u/RossAscends](https://www.reddit.com/user/RossAscends/) or [/u/sillylossy](https://www.reddit.com/user/sillylossy/)
+* [Post a GitHub issue](https://github.com/SillyTavern/SillyTavern/issues)
+
+## This version includes
+
+* A heavily modified TavernAI 1.2.8 (more than 50% of code rewritten or optimized)
+* Swipes
+* Group chats: multi-bot rooms for characters to talk to you or each other
+* Chat checkpoints / branching
+* Advanced KoboldAI / TextGen generation settings with a lot of community-made presets
+* World Info support: create rich lore or save tokens on your character card
+* [OpenRouter](https://openrouter.ai) connection for various APIs (Claude, GPT-4/3.5 and more)
+* [Oobabooga's TextGen WebUI](https://github.com/oobabooga/text-generation-webui) API connection
+* [AI Horde](https://horde.koboldai.net/) connection
+* Prompt generation formatting tweaking
+
+## Extensions
+
+SillyTavern has extensibility support, with some additional AI modules hosted via [SillyTavern Extras API](https://github.com/SillyTavern/SillyTavern-extras)
+
+* Author's Note / Character Bias
+* Character emotional expressions (sprites)
+* Auto-Summary of the chat history
+* Sending images to chat, and the AI interpreting the content
+* Stable Diffusion image generation (5 chat-related presets plus 'free mode')
+* Text-to-speech for AI response messages (via ElevenLabs, Silero, or the OS's System TTS)
+
+A full list of included extensions and tutorials on how to use them can be found in the [Docs](https://docs.sillytavern.app/).
+
+## UI/CSS/Quality of Life tweaks by RossAscends
+
+* Mobile UI optimized for iOS, and supports saving a shortcut to the home screen and opening in fullscreen mode.
+* HotKeys
+  * Up = Edit last message in chat
+  * Ctrl+Up = Edit last USER message in chat
+  * Left = swipe left
+  * Right = swipe right (NOTE: swipe hotkeys are disabled when the chat bar has something typed into it)
+  * Ctrl+Left = view locally stored variables (in the browser console window)
+  * Enter (with chat bar selected) = send your message to AI
+  * Ctrl+Enter = Regenerate the last AI response
+
+* User Name Changes and Character Deletion no longer force the page to refresh.
+
+* Toggle option to automatically connect to API on page load.
+* Toggle option to automatically load the most recently viewed character on page load.
+* Better Token Counter - works on unsaved characters, and shows both permanent and temporary tokens.
+
+* Better Past Chats View
+  * New Chat filenames are saved in a readable format of "(character) - (when it was created)"
+  * Chat preview increased from 40 characters to 300.
+  * Multiple options for characters list sorting (by name, creation date, chat sizes).
+
+* By default the left and right settings panel will close when you click away from it.
+* Clicking the Lock on the nav panel will hold the panel open, and this setting be remembered across sessions.
+* Nav panel status of open or closed will also be saved across sessions.
+
+* Customizable chat UI:
+  * Play a sound when a new message arrives
+  * Switch between round or rectangle avatar styles
+  * Have a wider chat window on the desktop
+  * Optional semi-transparent glass-like panels
+  * Customizable page colors for 'main text', 'quoted text', and 'italics text'.
+  * Customizable UI background color and blur amount
+
+# ⌛ Installation
+
+> \[!WARNING]
+> * DO NOT INSTALL INTO ANY WINDOWS CONTROLLED FOLDER (Program Files, System32, etc).
+> * DO NOT RUN START.BAT WITH ADMIN PERMISSIONS
+> * INSTALLATION ON WINDOWS 7 IS IMPOSSIBLE AS IT CAN NOT RUN NODEJS 18.16
+
+## 🪟 Windows
+
+## Installing via Git
+  1. Install [NodeJS](https://nodejs.org/en) (latest LTS version is recommended)
+  2. Install [Git for Windows](https://gitforwindows.org/)
+  3. Open Windows Explorer (`Win+E`)
+  4. Browse to or Create a folder that is not controlled or monitored by Windows. (ex: C:\MySpecialFolder\)
+  5. Open a Command Prompt inside that folder by clicking in the 'Address Bar' at the top, typing `cmd`, and pressing Enter.
+  6. Once the black box (Command Prompt) pops up, type ONE of the following into it and press Enter:
+
+- for Release Branch: `git clone https://github.com/SillyTavern/SillyTavern -b release`
+- for Staging Branch: `git clone https://github.com/SillyTavern/SillyTavern -b staging`
+
+  7. Once everything is cloned, double-click `Start.bat` to make NodeJS install its requirements.
+  8. The server will then start, and SillyTavern will pop up in your browser.
+
+## Installing via SillyTavern Launcher
+1.  On your keyboard: press **`WINDOWS + R`** to open Run dialog box. Then, run the following command to install git:
+```shell
+cmd /c winget install -e --id Git.Git
+```
+2. On your keyboard: press **`WINDOWS + E`** to open File Explorer, then navigate to the folder where you want to install the launcher. Once in the desired folder, type `cmd` into the address bar and press enter. Then, run the following command:
+```shell
+git clone https://github.com/SillyTavern/SillyTavern-Launcher.git && cd SillyTavern-Launcher && start installer.bat
+```
+
+## Installing via GitHub Desktop
+(This allows git usage **only** in GitHub Desktop, if you want to use `git` on the command line too, you also need to install [Git for Windows](https://gitforwindows.org/))
+  1. Install [NodeJS](https://nodejs.org/en) (latest LTS version is recommended)
+  2. Install [GitHub Desktop](https://central.github.com/deployments/desktop/desktop/latest/win32)
+  3. After installing GitHub Desktop, click on `Clone a repository from the internet....` (Note: You **do NOT need** to create a GitHub account for this step)
+  4. On the menu, click the URL tab, enter this URL `https://github.com/SillyTavern/SillyTavern`, and click Clone. You can change the Local path to change where SillyTavern is going to be downloaded.
+  6. To open SillyTavern, use Windows Explorer to browse into the folder where you cloned the repository. By default, the repository will be cloned here: `C:\Users\[Your Windows Username]\Documents\GitHub\SillyTavern`
+  7. Double-click on the `start.bat` file. (Note: the `.bat` part of the file name might be hidden by your OS, in that case, it will look like a file called "`Start`". This is what you double-click to run SillyTavern)
+  8. After double-clicking, a large black command console window should open and SillyTavern will begin to install what it needs to operate.
+  9. After the installation process, if everything is working, the command console window should look like this and a SillyTavern tab should be open in your browser:
+  10. Connect to any of the [supported APIs](https://docs.sillytavern.app/usage/api-connections/) and start chatting!
+
+## 🐧 Linux & 🍎 MacOS
+
+For MacOS / Linux all of these will be done in a Terminal.
+
+1. Install git and nodeJS (the method for doing this will vary depending on your OS)
+2. Clone the repo
+
+- for Release Branch: `git clone https://github.com/SillyTavern/SillyTavern -b release`
+- for Staging Branch: `git clone https://github.com/SillyTavern/SillyTavern -b staging`
+
+3. `cd SillyTavern` to navigate into the install folder.
+4. Run the `start.sh` script with one of these commands:
+
+- `./start.sh`
+- `bash start.sh`
+
+## Installing via SillyTavern Launcher
+
+### For Linux users
+1. Open your favorite terminal and install git
+2. Git clone the Sillytavern-Launcher with: 
+```shell
+git clone https://github.com/SillyTavern/SillyTavern-Launcher.git && cd SillyTavern-Launcher
+```
+3. Start the installer.sh with: 
+```shell
+chmod +x install.sh && ./install.sh
+```
+4. After installation start the launcher.sh with: 
+```shell
+chmod +x launcher.sh && ./launcher.sh
+```
+
+### For Mac users
+1. Open a terminal and install brew with: 
+```shell
+/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+```
+2. Install git with: 
+```shell
+brew install git
+```
+3. Git clone the Sillytavern-Launcher with: 
+```shell
+git clone https://github.com/SillyTavern/SillyTavern-Launcher.git && cd SillyTavern-Launcher
+```
+4. Start the installer.sh with: 
+```shell
+chmod +x install.sh && ./install.sh
+```
+5. After installation start the launcher.sh with: 
+```shell
+chmod +x launcher.sh && ./launcher.sh
+```
+
+## 🐋 Installing via Docker
+
+These instructions assume you have installed Docker, are able to access your command line for the installation of containers, and familiar with their general operation.
+
+### Building the image yourself
+
+We have a comprehensive guide on using SillyTavern in Docker [here](http://docs.sillytavern.app/installation/docker/) which covers installations on Windows, macOS and Linux! Give it a read if you wish to build the image yourself.
+
+### Using the GitHub Container Registry (easiest)
+
+You will need two mandatory directory mappings and a port mapping to allow SillyTavern to function. In the command, replace your selections in the following places:
+
+#### Container Variables
+
+##### Volume Mappings
+
+- [config] - The directory where SillyTavern configuration files will be stored on your host machine
+- [data] - The directory where SillyTavern user data (including characters) will be stored on your host machine
+- [plugins] - (optional) The directory where SillyTavern server plugins will be stored on your host machine
+
+##### Port Mappings
+
+- [PublicPort] - The port to expose the traffic on. This is mandatory, as you will be accessing the instance from outside of its virtual machine container. DO NOT expose this to the internet without implementing a separate service for security.
+
+##### Additional Settings
+
+- [DockerNet] - The docker network that the container should be created with a connection to. If you don't know what it is, see the [official Docker documentation](https://docs.docker.com/reference/cli/docker/network/).
+- [version] - On the right-hand side of this GitHub page, you'll see "Packages". Select the "sillytavern" package and you'll see the image versions. The image tag "latest" will keep you up-to-date with the current release. You can also utilize "staging" and "release" tags that point to the nightly images of the respective branches, but this may not be appropriate, if you are utilizing extensions that could be broken, and may need time to update.
+
+#### Install command
+
+1. Open your Command Line
+2. Run the following command
+
+`docker create --name='sillytavern' --net='[DockerNet]' -p '8000:8000/tcp' -v '[plugins]':'/home/node/app/plugins':'rw' -v '[config]':'/home/node/app/config':'rw' -v '[data]':'/home/node/app/data':'rw' 'ghcr.io/sillytavern/sillytavern:[version]'`
+
+> Note that 8000 is a default listening port. Don't forget to use an appropriate port if you change it in the config.
+
+## 📱 Mobile - Installing via termux
+
+> \[!NOTE]
+> **SillyTavern can be run natively on Android phones using Termux. Please refer to this guide by ArroganceComplex#2659:**
+> * <https://rentry.org/STAI-Termux>
+
+
+## API keys management
+
+SillyTavern saves your API keys to a `secrets.json` file in the user data directory (`/data/default-user/secrets.json` is the default path).
+
+By default, they will not be exposed to a frontend after you enter them and reload the page.
+
+In order to enable viewing your keys by clicking a button in the API block:
+
+1. Set the value of `allowKeysExposure` to `true` in `config.yaml` file.
+2. Restart the SillyTavern server.
+
+## Remote connections
+
+Most often this is for people who want to use SillyTavern on their mobile phones while their PC runs the ST server on the same wifi network.
+
+However, it can be used to allow remote connections from anywhere as well.
+
+**IMPORTANT: Refer to the official guide if you want to configure SillyTavern user accounts with (optional) password protection: [Users](https://docs.sillytavern.app/installation/st-1.12.0-migration-guide/#users).**
+
+### 1. Managing whitelisted IPs
+
+* Create a new text file inside your SillyTavern base install folder called `whitelist.txt`.
+* Open the file in a text editor, and add a list of IPs you want to be allowed to connect.
+
+*Both individual IPs and wildcard IP ranges are accepted. Examples:*
+
+```txt
+192.168.0.1
+192.168.0.20
+```
+
+or
+
+```txt
+192.168.0.*
+```
+
+(the above wildcard IP range will allow any device on the local network to connect)
+
+CIDR masks are also accepted (eg. 10.0.0.0/24).
+
+* Save the `whitelist.txt` file.
+* Restart your ST server.
+
+Now devices which have the IP specified in the file will be able to connect.
+
+*Note: `config.yaml` also has a `whitelist` array, which you can use in the same way, but this array will be ignored if `whitelist.txt` exists.*
+
+### 2. Getting the IP for the ST host machine
+
+After the whitelist has been setup, you'll need the IP of the ST-hosting device.
+
+If the ST-hosting device is on the same wifi network, you will use the ST-host's internal wifi IP:
+
+* For Windows: windows button > type `cmd.exe` in the search bar > type `ipconfig` in the console, hit Enter > look for `IPv4` listing.
+
+If you (or someone else) want to connect to your hosted ST while not being on the same network, you will need the public IP of your ST-hosting device.
+
+* While using the ST-hosting device, access [this page](https://whatismyipaddress.com/) and look for `IPv4`. This is what you would use to connect from the remote device.
+
+### 3. Connect the remote device to the ST host machine
+
+Whatever IP you ended up with for your situation, you will put that IP address and port number into the remote device's web browser.
+
+A typical address for an ST host on the same wifi network would look like this:
+
+`http://192.168.0.5:8000`
+
+Use http:// NOT https://
+
+### Opening your ST to all IPs
+
+We do not recommend doing this, but you can open `config.yaml` and change `whitelistMode` to `false`.
+
+You must remove (or rename) `whitelist.txt` in the SillyTavern base install folder if it exists.
+
+This is usually an insecure practice, so we require you to set a username and password when you do this.
+
+The username and password are set in `config.yaml`.
+
+After restarting your ST server, any device will be able to connect to it, regardless of their IP as long as they know the username and password.
+
+### Still Unable To Connect?
+
+* Create an inbound/outbound firewall rule for the port found in `config.yaml`. Do NOT mistake this for port-forwarding on your router, otherwise, someone could find your chat logs and that's a big no-no.
+* Enable the Private Network profile type in Settings > Network and Internet > Ethernet. This is VERY important for Windows 11, otherwise, you would be unable to connect even with the aforementioned firewall rules.
+
+## Performance issues?
+
+Try enabling the No Blur Effect (Fast UI) mode on the User settings panel.
+
+## I like your project! How do I contribute?
+
+### DO's
+
+1. Send pull requests
+2. Send feature suggestions and issue reports using established templates
+3. Read the readme file and built-in documentation before asking anything
+
+### DONT's
+
+1. Offer monetary donations
+2. Send bug reports without providing any context
+3. Ask the questions that were already answered numerous times
+
+## Where can I find the old backgrounds?
+
+We're moving to a 100% original content only policy, so old background images have been removed from this repository.
+
+You can find them archived here:
+
+<https://files.catbox.moe/1xevnc.zip>
+
+
+
+
+## License and credits
+
+**This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU Affero General Public License for more details.**
+
+* TAI Base by Humi: MIT
+* Cohee's modifications and derived code: AGPL v3
+* RossAscends' additions: AGPL v3
+* Portions of CncAnon's TavernAITurbo mod: Unknown license
+* kingbri's various commits and suggestions (<https://github.com/bdashore3>)
+* city_unit's extensions and various QoL features (<https://github.com/city-unit>)
+* StefanDanielSchwarz's various commits and bug reports (<https://github.com/StefanDanielSchwarz>)
+* Waifu mode inspired by the work of PepperTaco (<https://github.com/peppertaco/Tavern/>)
+* Thanks Pygmalion University for being awesome testers and suggesting cool features!
+* Thanks oobabooga for compiling presets for TextGen
+* KoboldAI Presets from KAI Lite: <https://lite.koboldai.net/>
+* Noto Sans font by Google (OFL license)
+* Icon theme by Font Awesome <https://fontawesome.com> (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License)
+* AI Horde client library by ZeldaFan0225: <https://github.com/ZeldaFan0225/ai_horde>
+* Linux startup script by AlpinDale
+* Thanks paniphons for providing a FAQ document
+* 10K Discord Users Celebratory Background by @kallmeflocc
+* Default content (characters and lore books) provided by @OtisAlejandro, @RossAscends and @kallmeflocc
+* Korean translation by @doloroushyeonse
+* k_euler_a support for Horde by <https://github.com/Teashrock>
+* Chinese translation by [@XXpE3](https://github.com/XXpE3), 中文 ISSUES 可以联系 @XXpE3
+* Docker guide by [@mrguymiah](https://github.com/mrguymiah) and [@Bronya-Rand](https://github.com/Bronya-Rand)
+
+<!-- LINK GROUP -->
+[back-to-top]: https://img.shields.io/badge/-BACK_TO_TOP-151515?style=flat-square
+[cover]: https://github.com/SillyTavern/SillyTavern/assets/18619528/c2be4c3f-aada-4f64-87a3-ae35a68b61a4
+[discord-link]: https://discord.gg/sillytavern
+[discord-shield]: https://img.shields.io/discord/1100685673633153084?color=5865F2&label=discord&labelColor=black&logo=discord&logoColor=white&style=flat-square
+[discord-shield-badge]: https://img.shields.io/discord/1100685673633153084?color=5865F2&label=discord&labelColor=black&logo=discord&logoColor=white&style=for-the-badge