開発設定

LangBotはフロントエンドとバックエンドに分かれています。フロントエンドはNext.js + shadcnを使用して開発され、バックエンドはQuart(Flaskの非同期版)を使用して開発されています。

バックエンド

コードはpkgディレクトリにあり、ルートディレクトリのmain.pyファイルによって起動されます。依存関係をインストールします。依存関係の管理にはuvを使用します。

pip install uv
uv sync --dev

バックエンドを起動します

uv run main.py

この時点で、設定ファイルはdata/config.yamlファイルに自動的に生成されます。

コードはwebディレクトリにあり、Node.jsとpnpmが必要です。 .env.exampleを.envにコピーして、値を入力します。

cp .env.example .env

copy .env.example .env

依存関係をインストールしてフロントエンドを起動します

pnpm install
pnpm dev

# pnpmがインストールされていない場合は、npmを使用して依存関係を解決して起動することもできます
npm install
npm run dev

その後、出力情報に従って、http://127.0.0.1:3000にアクセスして、スタンドアロンフロントエンドページを表示します。

本番環境では、フロントエンドは静的ファイルにプリコンパイルされ、バックエンドによって提供され、フロントエンドは同じドメインのバックエンドアドレスに自動的にアクセスします。

リポジトリにはlintとformatのチェックワークフローが含まれており、コードをプッシュすると自動的にチェックされます。pre-commitを設定して、コードをローカルで事前にチェックしてください。

uv run pre-commit install

各インターフェースを開発する前に、APIFoxでAPIドキュメントを作成します。APIドキュメント(中国語)を参照してください。