🤖 Open-source, local-first alternative to Grok Bot, OpenAI dots and Claude Duet. Your own AI bots on any model: GPT, Claude, Gemini, Grok, DeepSeek, Kimi, GLM and 70+ more through one Modelflare key. Reach them in the app, WeChat or Feishu; they remember you, work in the background, run commands and use your computer. Pay per use.
貢献ガイド
简体中文 | English | 日本語 | 한국어 | Русский
AnyModelBot の改善にご協力いただきありがとうございます。不具合報告、修正、文書、アイデアのいずれも歓迎します。
質問とフィードバック
- 質問、アイデア、活用事例: GitHub Discussions
- 不具合と機能要望: テンプレートを使って GitHub Issues へ
- セキュリティの問題: 公開 Issue は作成せず、セキュリティポリシー に従って非公開で報告してください
- その他: [email protected]
不具合の報告には、次の情報を添えてください。
- バージョン(設定 → このアプリについて)、OS とアーキテクチャ(例:Windows 11 x64、macOS 15 Apple silicon)、実行方法(デスクトップ / CLI / Docker)
- 再現手順、期待した動作、実際の動作
- 診断情報:設定 → トラブルシューティング → 診断情報をコピー(API キーとトークンは
***に置換)。ログはデータディレクトリ内のlogs/app.logにあります。場所は プライバシー文書 をご覧ください。 - 特定のモデルに関する問題ならモデル ID
開発環境の準備
Node.js 22.13 以降と、同梱の magpie ゲートウェイをコンパイルするための Go 1.26.8 以降が必要です。
git clone https://github.com/modelflare-ai/AnyModelBot.git
cd AnyModelBot
npm install
npm run setup # vendor/magpie サブモジュールを取得し build/bin/ にコンパイル
| コマンド | 内容 |
|---|---|
npm start |
CLI でゲートウェイ、ボット、http://127.0.0.1:3600/ のコンソールを起動 |
npm run dev |
同上。コード変更時に再起動 |
npm run electron:dev |
開発モードのデスクトップアプリ |
npm run electron:smoke |
デスクトップのスモークテスト(画面のない Linux は xvfb-run を使用) |
npm run typecheck |
TypeScript の型チェック |
npm test |
単体テスト、オフライン E2E、ゲートウェイ統合テスト |
npm run test:dsh-bundle |
Electron で実際の DSH を使う統合テスト(先に prepare:dsh と bundle:dsh を実行) |
npm run docs:check |
README の検証 |
リポジトリ構成、パッケージ作成、チャネル設定は 開発ガイド を参照してください。
ブランチとプルリクエスト
リポジトリをフォークし、
masterからブランチを作成します。プッシュする前に次を実行してください。
npm run typecheck && npm testREADME や
docs/を変更した場合はnpm run docs:checkも実行します。masterを対象にプルリクエストを作成し、変更内容、理由、検証方法を書きます。画面の変更にはスクリーンショットを添えてください。小さな修正を超える変更(新機能、構成変更、新たな依存関係)は、先に Issue で方針を相談してください。
一つの PR には一つの変更をまとめ、既存のコミット形式(
feat(scope): …、fix(scope): …)に従ってください。
画面の変更
ui/designのトークンとコンポーネントを使ってください(ui/design/README.md参照)。個別の色や文字サイズを追加しないでください。- ブランドのアクセントは蛍光イエローグリーン
#d7ff00です。画面に青を持ち込まないでください。 - コンソールはビルド不要の Preact + htm です。バンドラーやコンパイルが必要なフロントエンド依存関係は追加しないでください。
- ライトとダークの両テーマを確認してください。
- 画面の文言を直接埋め込まず、
ui/locales/zh-CN/とui/locales/en/の両方に追加してt()を使ってください。提出前にnode scripts/i18n-check.mjsを実行します。英語のほうが長くなりやすいため、両言語を確認してください。
第三者のコードと依存関係
- 依存関係の追加や外部コードの移植・改変を行ったら、
THIRD_PARTY_NOTICES.mdに出典、バージョン、ライセンスを記載してください。 - AGPL、SSPL、FSL など、MIT での配布と両立しないライセンスの構成要素は追加しないでください。
行動規範
親切に、事実に基づいてやり取りしてください。参加者を尊重し、人ではなくアイデアについて議論してください。嫌がらせ、個人攻撃、差別的な発言は認めません。管理者はこの方針に反する内容を削除することがあります。懸念があれば [email protected] へお知らせください。
ライセンス
提出された貢献は、このリポジトリの MIT ライセンス で公開されます。