Ozvi

Ozvi

製品に溶け込む、ソース公開のバグ報告とアイデアボード。

ウェブサイト · ライブデモ · ドキュメント · 動画 · @ozvi/widget · @ozvi/sdk

• 2つのスペース。 ページ、アプリのバージョン、ブラウザー、コンソールエラー、フォームの値・メールアドレス・電話番号・カード番号をブラウザー上で隠したスクリーンショットなどのコンテキストが自動で添付される非公開のバグ報告フローと、投票、ロードマップ、変更履歴を備えた公開アイデアボードです。
• 報告者へのフィードバック。 「2.15.1で修正しました。問題なく動作しますか？」というメッセージを報告者に送れます。GitHubの課題やリリースを紐付ければステータスが自動で設定され、変更履歴を公開すると投票者全員にメールが届きます。
• お好みのデザイン。 1つのtheme.json（色、フォント、角の丸み、密度）でボード、ウィジェット、メールのスタイルを設定できます。
• お好みのログイン方法。 署名付きトークンまたはOIDCを使って、ユーザーがアプリからログインした状態を維持できます。ボードでメールコードによるログインを提供することもできます。
• お好みのツール。 組み込みのMCP サーバー（個人用トークンまたはOAuthコネクター）により、Claudeなどのエージェントが検索、要約、トリアージ、公開を行えます。取り消せない操作には確認が必要で、ユーザーのテキストは常にデータとして扱われます。Slack、Discord、またはバックエンド向けのWebhookも利用できます。
• AIは任意です。 重複検出（任意のOpenAI互換エンドポイントを使った埋め込み、またはファジーテキストマッチング）、スレッドの要約、変更履歴の下書き、週次チームダイジェストに対応します。生成には、Claudeをネイティブに使うか、任意のOpenAI互換API（OpenAI、Mistral、Ollama、vLLMなど）を利用できます。

すべての機能を無料でセルフホストできます（FSL-1.1-ALv2。ライセンスを参照）。ホステッドクラウドも同じイメージで動作します。

アプリに埋め込む

<script src="https://feedback.example.com/widget.js" defer></script>
<ozvi-widget project="myapp" token-url="/api/ozvi-token" app-version="1.4.0"></ozvi-widget>

// npm i @ozvi/sdk   (MIT, zero deps; Python and PHP without a library: ozvi.io/docs/widget#sign-in)
import { signOzviToken } from "@ozvi/sdk";
app.get("/api/ozvi-token", requireLogin, (req, res) =>
  res.json({ token: signOzviToken({ id: req.user.id, email: req.user.email, name: req.user.name }, process.env.OZVI_SSO_SECRET) }));

スクリーンショットでは、フォームの値、メールアドレス、電話番号、IBAN、カード番号、トークンが自動的に隠されます。それ以外の機密情報（名前、メモなど）を隠すには、data-ozvi-maskを指定するか、OzviConfig.mask = "all"を設定してすべてのテキストを隠します。詳しくはdocs/INTEGRACIA.mdをご覧ください。

セルフホスト

cd deploy && cp .env.example .env && docker compose up -d
docker compose exec ozvi node ozvi.mjs project:create myapp "My app" --origin https://app.example.com

イメージはghcr.io/xzamiska/ozviで公開されています（amd64およびarm64。1.2.8、1.2、1、latestなどのタグ）。任意のアップデーターコンテナを使うと、データベースをバックアップし、要求時または夜間に新しいバージョンをインストールできます。正常に動作しない場合はロールバックします。リリースノート：ozvi.io/releases。

docs/SELFHOST.mdをご覧ください。Fiderからの移行：docs/MIGRACIA-Z-FIDERU.md。クラウドモード：docs/CLOUD.md。設計上の決定事項：docs/adr。

任意の設定：OZVI_AI_PROVIDER（anthropicまたは任意のOpenAI互換API向けのopenai）とOZVI_AI_API_KEY、OZVI_AI_MODELを設定すると、AIによる文章作成支援が有効になります（docs/SELFHOST.mdを参照）。OZVI_EMBEDDINGS_URLとOZVI_EMBEDDINGS_MODELを設定すると、埋め込みを使った重複検出が有効になります。

AI アシスタントを接続する

claude mcp add --transport http ozvi https://feedback.example.com/mcp --header "Authorization: Bearer ozvi_pat_…"

または、Claudeにカスタムコネクターとしてhttps://feedback.example.com/<project>/mcpを追加します。ボード上でログインと同意を行います。ツール：packages/mcp/README.md。

開発

pnpm install
cp .env.example .env
pnpm dev            # Postgres 17 + Mailpit in Docker, migrations, web on :3300
pnpm test

pnpm dev と（.env.example 内の）OZVI_DEV_LOGIN=1 を使うと、http://localhost:3300/dev/login?project=billiwo&as=team で管理者としてサインインできます。http://localhost:3300/demo では、偽のホストアプリ内にウィジェットが表示されます。Mailpit は http://localhost:8046 で利用できます。

パス	内容
apps/web	Next.js のボード、ロードマップ、変更履歴、管理機能、/app（クラウド）、ウィジェット API、MCP、ワーカー、Fider インポーター
packages/db	Drizzle スキーマとマイグレーション（Postgres 17）
packages/theme	theme.json スキーマ、プリセット、CSS 変数、コントラストチェック
packages/sdk	ホストアプリの SSO 用 signOzviToken（MIT）
packages/widget	埋め込み可能な <ozvi-widget>（Preact、shadow DOM、gzip 圧縮で約 10 kB）
packages/mcp	/mcp で提供される MCP ツール

ライセンス

FSL-1.1-ALv2（Functional Source License、将来的に Apache 2.0 ライセンス）：競合する商用サービスとして提供する場合を除き、Ozvi をあらゆる目的で使用、変更、セルフホストできます。各リリースは公開から 2 年後に Apache 2.0 になります。

packages/sdk と packages/widget は MIT ライセンスのため、クローズドソースのホストアプリに組み込んで配布できます。