@the-magic-tower/fixhive-opencode-plugin 0.1.2 → 0.1.4

package/README.de.md

@@ -29,37 +29,44 @@ FixHive ist ein OpenCode-Plugin, das während der Entwicklungssitzungen automati
 npm install @the-magic-tower/fixhive-opencode-plugin
 ```
 
-## Konfiguration
+## Schnellstart
 
-Setzen Sie die folgenden Umgebungsvariablen:
+Fügen Sie zu Ihrer OpenCode-Konfiguration hinzu (`opencode.config.ts`):
+
+```typescript
+import FixHivePlugin from '@the-magic-tower/fixhive-opencode-plugin';
+
+export default {
+  plugins: [FixHivePlugin],
+};
+```
+
+**Das war's!** FixHive verbindet sich standardmäßig mit der Community-Wissensdatenbank. Keine Umgebungsvariablen erforderlich.
+
+## Konfiguration (Optional)
+
+Umgebungsvariablen zur Anpassung des Verhaltens:
 
 ```bash
-# Erforderlich für Cloud-Funktionen
+# Eigene Supabase-Instanz statt Community verwenden
 FIXHIVE_SUPABASE_URL=https://your-project.supabase.co
 FIXHIVE_SUPABASE_KEY=your-anon-key
 
-# Optional: Für embedding-basierte semantische Suche
+# Semantische Suche aktivieren (empfohlen)
 OPENAI_API_KEY=sk-...
 
-# Optional: Benutzerdefinierte Mitwirkenden-ID (wird automatisch generiert, wenn nicht gesetzt)
+# Benutzerdefinierte Mitwirkenden-ID (wird automatisch generiert, wenn nicht gesetzt)
 FIXHIVE_CONTRIBUTOR_ID=your-contributor-id
 ```
 
-## Verwendung
-
-### Als OpenCode-Plugin
-
-Fügen Sie zu Ihrer OpenCode-Konfiguration hinzu (`opencode.config.ts`):
-
-```typescript
-import FixHivePlugin from '@the-magic-tower/fixhive-opencode-plugin';
-
-export default {
-  plugins: [FixHivePlugin],
-};
-```
+| Variable | Standard | Beschreibung |
+|----------|----------|--------------|
+| `FIXHIVE_SUPABASE_URL` | Community DB | Supabase-Projekt-URL |
+| `FIXHIVE_SUPABASE_KEY` | Community Key | Supabase Anon-Key |
+| `OPENAI_API_KEY` | Keine | Aktiviert semantische Ähnlichkeitssuche |
+| `FIXHIVE_CONTRIBUTOR_ID` | Auto-generiert | Eindeutige Mitwirkenden-ID |
 
-### Verfügbare Befehle
+## Verfügbare Befehle
 
 | Befehl | Beschreibung |
 |--------|--------------|
@@ -69,6 +76,7 @@ export default {
 | `fixhive_vote` | Lösung hoch-/runtervoten |
 | `fixhive_stats` | Nutzungsstatistiken anzeigen |
 | `fixhive_helpful` | Melden, dass eine Lösung hilfreich war |
+| `fixhive_report` | Unangemessenen Inhalt melden |
 
 ### Beispiel-Workflow
 
@@ -77,9 +85,13 @@ export default {
 3. **Fix anwenden** → Community-Lösung befolgen
 4. **Lösung teilen** → `fixhive_resolve <error-id> "Fehlende Abhängigkeit installiert"`
 
-## Cloud-Setup (Supabase)
+## Self-Hosted Setup (Optional)
 
-1. Neues Supabase-Projekt erstellen
+Überspringen Sie diesen Abschnitt, wenn Sie die Standard-Community-Wissensdatenbank verwenden.
+
+Um Ihr eigenes FixHive-Backend zu betreiben:
+
+1. Neues Supabase-Projekt erstellen (Free-Tier funktioniert)
 2. Setup-Skript im SQL-Editor ausführen:
 
 ```bash
@@ -88,6 +100,12 @@ cat scripts/setup-supabase.sql | pbcopy
 ```
 
 3. Projekt-URL und Anon-Key unter Settings > API abrufen
+4. Umgebungsvariablen setzen:
+
+```bash
+FIXHIVE_SUPABASE_URL=https://your-project.supabase.co
+FIXHIVE_SUPABASE_KEY=your-anon-key
+```
 
 ## Architektur
 

package/README.es.md

@@ -29,37 +29,44 @@ FixHive es un plugin de OpenCode que captura automáticamente errores durante la
 npm install @the-magic-tower/fixhive-opencode-plugin
 ```
 
-## Configuración
+## Inicio Rápido
 
-Configure las siguientes variables de entorno:
+Agregue a su configuración de OpenCode (`opencode.config.ts`):
+
+```typescript
+import FixHivePlugin from '@the-magic-tower/fixhive-opencode-plugin';
+
+export default {
+  plugins: [FixHivePlugin],
+};
+```
+
+**¡Eso es todo!** FixHive se conecta a la base de conocimientos de la comunidad por defecto. No se requieren variables de entorno.
+
+## Configuración (Opcional)
+
+Variables de entorno para personalizar el comportamiento:
 
 ```bash
-# Requerido para funciones en la nube
+# Use su propia instancia de Supabase en lugar de la comunidad
 FIXHIVE_SUPABASE_URL=https://your-project.supabase.co
 FIXHIVE_SUPABASE_KEY=your-anon-key
 
-# Opcional: Para búsqueda semántica basada en embeddings
+# Habilitar búsqueda semántica (recomendado)
 OPENAI_API_KEY=sk-...
 
-# Opcional: ID de contribuidor personalizado (se genera automáticamente si no se establece)
+# ID de contribuidor personalizado (se genera automáticamente si no se establece)
 FIXHIVE_CONTRIBUTOR_ID=your-contributor-id
 ```
 
-## Uso
-
-### Como Plugin de OpenCode
-
-Agregue a su configuración de OpenCode (`opencode.config.ts`):
-
-```typescript
-import FixHivePlugin from '@the-magic-tower/fixhive-opencode-plugin';
-
-export default {
-  plugins: [FixHivePlugin],
-};
-```
+| Variable | Por Defecto | Descripción |
+|----------|-------------|-------------|
+| `FIXHIVE_SUPABASE_URL` | DB Comunidad | URL del proyecto Supabase |
+| `FIXHIVE_SUPABASE_KEY` | Key Comunidad | Clave anon de Supabase |
+| `OPENAI_API_KEY` | Ninguna | Habilita búsqueda de similitud semántica |
+| `FIXHIVE_CONTRIBUTOR_ID` | Auto-generado | ID único de contribuidor |
 
-### Comandos Disponibles
+## Comandos Disponibles
 
 | Comando | Descripción |
 |---------|-------------|
@@ -69,6 +76,7 @@ export default {
 | `fixhive_vote` | Votar a favor/en contra de una solución |
 | `fixhive_stats` | Ver estadísticas de uso |
 | `fixhive_helpful` | Reportar que una solución fue útil |
+| `fixhive_report` | Reportar contenido inapropiado |
 
 ### Flujo de Trabajo de Ejemplo
 
@@ -77,9 +85,13 @@ export default {
 3. **Aplicar corrección** → Seguir la solución de la comunidad
 4. **Compartir resolución** → `fixhive_resolve <error-id> "Instalada dependencia faltante"`
 
-## Configuración en la Nube (Supabase)
+## Configuración Auto-Alojada (Opcional)
 
-1. Crear un nuevo proyecto de Supabase
+Omita esta sección si usa la base de conocimientos de la comunidad por defecto.
+
+Para ejecutar su propio backend de FixHive:
+
+1. Crear un nuevo proyecto de Supabase (el plan gratuito funciona)
 2. Ejecutar el script de configuración en el Editor SQL:
 
 ```bash
@@ -88,6 +100,12 @@ cat scripts/setup-supabase.sql | pbcopy
 ```
 
 3. Obtener la URL del proyecto y la clave anon desde Settings > API
+4. Configurar variables de entorno:
+
+```bash
+FIXHIVE_SUPABASE_URL=https://your-project.supabase.co
+FIXHIVE_SUPABASE_KEY=your-anon-key
+```
 
 ## Arquitectura
 

package/README.fr.md

@@ -29,37 +29,44 @@ FixHive est un plugin OpenCode qui capture automatiquement les erreurs pendant l
 npm install @the-magic-tower/fixhive-opencode-plugin
 ```
 
-## Configuration
+## Démarrage Rapide
 
-Définissez les variables d'environnement suivantes :
+Ajoutez à votre configuration OpenCode (`opencode.config.ts`) :
+
+```typescript
+import FixHivePlugin from '@the-magic-tower/fixhive-opencode-plugin';
+
+export default {
+  plugins: [FixHivePlugin],
+};
+```
+
+**C'est tout !** FixHive se connecte par défaut à la base de connaissances communautaire. Aucune variable d'environnement requise.
+
+## Configuration (Optionnel)
+
+Variables d'environnement pour personnaliser le comportement :
 
 ```bash
-# Requis pour les fonctionnalités cloud
+# Utiliser votre propre instance Supabase au lieu de la communauté
 FIXHIVE_SUPABASE_URL=https://your-project.supabase.co
 FIXHIVE_SUPABASE_KEY=your-anon-key
 
-# Optionnel : Pour la recherche sémantique basée sur les embeddings
+# Activer la recherche sémantique (recommandé)
 OPENAI_API_KEY=sk-...
 
-# Optionnel : ID de contributeur personnalisé (généré automatiquement si non défini)
+# ID de contributeur personnalisé (généré automatiquement si non défini)
 FIXHIVE_CONTRIBUTOR_ID=your-contributor-id
 ```
 
-## Utilisation
-
-### En tant que Plugin OpenCode
-
-Ajoutez à votre configuration OpenCode (`opencode.config.ts`) :
-
-```typescript
-import FixHivePlugin from '@the-magic-tower/fixhive-opencode-plugin';
-
-export default {
-  plugins: [FixHivePlugin],
-};
-```
+| Variable | Par Défaut | Description |
+|----------|------------|-------------|
+| `FIXHIVE_SUPABASE_URL` | DB Communauté | URL du projet Supabase |
+| `FIXHIVE_SUPABASE_KEY` | Clé Communauté | Clé anon Supabase |
+| `OPENAI_API_KEY` | Aucune | Active la recherche de similarité sémantique |
+| `FIXHIVE_CONTRIBUTOR_ID` | Auto-généré | ID de contributeur unique |
 
-### Commandes Disponibles
+## Commandes Disponibles
 
 | Commande | Description |
 |----------|-------------|
@@ -69,6 +76,7 @@ export default {
 | `fixhive_vote` | Voter pour/contre une solution |
 | `fixhive_stats` | Voir les statistiques d'utilisation |
 | `fixhive_helpful` | Signaler qu'une solution a été utile |
+| `fixhive_report` | Signaler un contenu inapproprié |
 
 ### Exemple de Flux de Travail
 
@@ -77,9 +85,13 @@ export default {
 3. **Appliquer le correctif** → Suivre la solution de la communauté
 4. **Partager la résolution** → `fixhive_resolve <error-id> "Dépendance manquante installée"`
 
-## Configuration Cloud (Supabase)
+## Configuration Auto-Hébergée (Optionnel)
 
-1. Créer un nouveau projet Supabase
+Ignorez cette section si vous utilisez la base de connaissances communautaire par défaut.
+
+Pour exécuter votre propre backend FixHive :
+
+1. Créer un nouveau projet Supabase (le plan gratuit fonctionne)
 2. Exécuter le script de configuration dans l'éditeur SQL :
 
 ```bash
@@ -88,6 +100,12 @@ cat scripts/setup-supabase.sql | pbcopy
 ```
 
 3. Obtenir l'URL du projet et la clé anon depuis Settings > API
+4. Configurer les variables d'environnement :
+
+```bash
+FIXHIVE_SUPABASE_URL=https://your-project.supabase.co
+FIXHIVE_SUPABASE_KEY=your-anon-key
+```
 
 ## Architecture
 

package/README.ja.md

@@ -29,37 +29,44 @@ FixHiveは、開発セッション中にエラーを自動的にキャプチャ
 npm install @the-magic-tower/fixhive-opencode-plugin
 ```
 
-## 設定
+## クイックスタート
 
-以下の環境変数を設定してください：
+OpenCode設定ファイル（`opencode.config.ts`）に追加：
+
+```typescript
+import FixHivePlugin from '@the-magic-tower/fixhive-opencode-plugin';
+
+export default {
+  plugins: [FixHivePlugin],
+};
+```
+
+**以上！** FixHiveはデフォルトでコミュニティナレッジベースに接続します。環境変数の設定は不要です。
+
+## 設定（オプション）
+
+動作をカスタマイズするための環境変数：
 
 ```bash
-# クラウド機能に必須
+# コミュニティの代わりに自分のSupabaseインスタンスを使用
 FIXHIVE_SUPABASE_URL=https://your-project.supabase.co
 FIXHIVE_SUPABASE_KEY=your-anon-key
 
-# オプション：埋め込みベースのセマンティック検索用
+# セマンティック検索を有効化（推奨）
 OPENAI_API_KEY=sk-...
 
-# オプション：カスタム貢献者ID（未設定の場合は自動生成）
+# カスタム貢献者ID（未設定の場合は自動生成）
 FIXHIVE_CONTRIBUTOR_ID=your-contributor-id
 ```
 
-## 使用方法
-
-### OpenCodeプラグインとして
-
-OpenCode設定ファイル（`opencode.config.ts`）に追加：
-
-```typescript
-import FixHivePlugin from '@the-magic-tower/fixhive-opencode-plugin';
-
-export default {
-  plugins: [FixHivePlugin],
-};
-```
+| 変数 | デフォルト | 説明 |
+|------|------------|------|
+| `FIXHIVE_SUPABASE_URL` | コミュニティDB | SupabaseプロジェクトURL |
+| `FIXHIVE_SUPABASE_KEY` | コミュニティKey | Supabase anonキー |
+| `OPENAI_API_KEY` | なし | セマンティック類似性検索を有効化 |
+| `FIXHIVE_CONTRIBUTOR_ID` | 自動生成 | 一意の貢献者ID |
 
-### 利用可能なコマンド
+## 利用可能なコマンド
 
 | コマンド | 説明 |
 |----------|------|
@@ -69,6 +76,7 @@ export default {
 | `fixhive_vote` | ソリューションに投票（賛成/反対） |
 | `fixhive_stats` | 使用統計を表示 |
 | `fixhive_helpful` | ソリューションが役立ったことを報告 |
+| `fixhive_report` | 不適切なコンテンツを報告 |
 
 ### ワークフロー例
 
@@ -77,9 +85,13 @@ export default {
 3. **修正を適用** → コミュニティソリューションに従う
 4. **解決を共有** → `fixhive_resolve <error-id> "不足している依存関係をインストール"`
 
-## クラウドセットアップ（Supabase）
+## セルフホストセットアップ（オプション）
 
-1. 新しいSupabaseプロジェクトを作成
+デフォルトのコミュニティナレッジベースを使用する場合は、このセクションをスキップしてください。
+
+独自のFixHiveバックエンドを運用するには：
+
+1. 新しいSupabaseプロジェクトを作成（無料プランで可）
 2. SQLエディタでセットアップスクリプトを実行：
 
 ```bash
@@ -88,6 +100,12 @@ cat scripts/setup-supabase.sql | pbcopy
 ```
 
 3. Settings > APIからプロジェクトURLとanon keyを取得
+4. 環境変数を設定：
+
+```bash
+FIXHIVE_SUPABASE_URL=https://your-project.supabase.co
+FIXHIVE_SUPABASE_KEY=your-anon-key
+```
 
 ## アーキテクチャ
 

package/README.ko.md

@@ -29,37 +29,44 @@ FixHive는 개발 세션 중 발생하는 오류를 자동으로 캡처하고,
 npm install @the-magic-tower/fixhive-opencode-plugin
 ```
 
-## 설정
+## 빠른 시작
 
-다음 환경 변수를 설정하세요:
+OpenCode 설정 파일(`opencode.config.ts`)에 추가:
+
+```typescript
+import FixHivePlugin from '@the-magic-tower/fixhive-opencode-plugin';
+
+export default {
+  plugins: [FixHivePlugin],
+};
+```
+
+**끝!** FixHive는 기본적으로 커뮤니티 지식 베이스에 연결됩니다. 환경 변수 설정이 필요 없습니다.
+
+## 설정 (선택사항)
+
+동작을 커스터마이즈하기 위한 환경 변수:
 
 ```bash
-# 클라우드 기능 필수
+# 커뮤니티 대신 자체 Supabase 인스턴스 사용
 FIXHIVE_SUPABASE_URL=https://your-project.supabase.co
 FIXHIVE_SUPABASE_KEY=your-anon-key
 
-# 선택: 임베딩 기반 시맨틱 검색용
+# 시맨틱 검색 활성화 (권장)
 OPENAI_API_KEY=sk-...
 
-# 선택: 사용자 정의 기여자 ID (미설정시 자동 생성)
+# 사용자 지정 기여자 ID (미설정 시 자동 생성)
 FIXHIVE_CONTRIBUTOR_ID=your-contributor-id
 ```
 
-## 사용법
-
-### OpenCode 플러그인으로 사용
-
-OpenCode 설정 파일(`opencode.config.ts`)에 추가:
-
-```typescript
-import FixHivePlugin from '@the-magic-tower/fixhive-opencode-plugin';
-
-export default {
-  plugins: [FixHivePlugin],
-};
-```
+| 변수 | 기본값 | 설명 |
+|------|--------|------|
+| `FIXHIVE_SUPABASE_URL` | 커뮤니티 DB | Supabase 프로젝트 URL |
+| `FIXHIVE_SUPABASE_KEY` | 커뮤니티 Key | Supabase anon 키 |
+| `OPENAI_API_KEY` | 없음 | 시맨틱 유사도 검색 활성화 |
+| `FIXHIVE_CONTRIBUTOR_ID` | 자동 생성 | 고유 기여자 ID |
 
-### 사용 가능한 명령어
+## 사용 가능한 명령어
 
 | 명령어 | 설명 |
 |--------|------|
@@ -69,6 +76,7 @@ export default {
 | `fixhive_vote` | 솔루션 추천/비추천 |
 | `fixhive_stats` | 사용 통계 조회 |
 | `fixhive_helpful` | 솔루션이 도움됐음을 보고 |
+| `fixhive_report` | 부적절한 콘텐츠 신고 |
 
 ### 사용 예시 워크플로우
 
@@ -77,9 +85,13 @@ export default {
 3. **수정 적용** → 커뮤니티 솔루션 따라하기
 4. **해결 공유** → `fixhive_resolve <error-id> "누락된 의존성 설치"`
 
-## 클라우드 설정 (Supabase)
+## 자체 호스팅 설정 (선택사항)
 
-1. 새 Supabase 프로젝트 생성
+기본 커뮤니티 지식 베이스를 사용하는 경우 이 섹션을 건너뛰세요.
+
+자체 FixHive 백엔드를 운영하려면:
+
+1. 새 Supabase 프로젝트 생성 (무료 플랜 가능)
 2. SQL 에디터에서 설정 스크립트 실행:
 
 ```bash
@@ -88,6 +100,12 @@ cat scripts/setup-supabase.sql | pbcopy
 ```
 
 3. Settings > API에서 프로젝트 URL과 anon key 획득
+4. 환경 변수 설정:
+
+```bash
+FIXHIVE_SUPABASE_URL=https://your-project.supabase.co
+FIXHIVE_SUPABASE_KEY=your-anon-key
+```
 
 ## 아키텍처
 

package/README.md

@@ -29,37 +29,44 @@ FixHive is an OpenCode plugin that automatically captures errors during developm
 npm install @the-magic-tower/fixhive-opencode-plugin
 ```
 
-## Configuration
+## Quick Start
 
-Set the following environment variables:
+Add to your OpenCode configuration (`opencode.config.ts`):
+
+```typescript
+import FixHivePlugin from '@the-magic-tower/fixhive-opencode-plugin';
+
+export default {
+  plugins: [FixHivePlugin],
+};
+```
+
+**That's it!** FixHive connects to the community knowledge base by default. No environment variables required.
+
+## Configuration (Optional)
+
+Environment variables to customize behavior:
 
 ```bash
-# Required for cloud features
+# Use your own Supabase instance instead of community
 FIXHIVE_SUPABASE_URL=https://your-project.supabase.co
 FIXHIVE_SUPABASE_KEY=your-anon-key
 
-# Optional: For embedding-based semantic search
+# Enable semantic search (recommended)
 OPENAI_API_KEY=sk-...
 
-# Optional: Custom contributor ID (auto-generated if not set)
+# Custom contributor ID (auto-generated if not set)
 FIXHIVE_CONTRIBUTOR_ID=your-contributor-id
 ```
 
-## Usage
-
-### As OpenCode Plugin
-
-Add to your OpenCode configuration (`opencode.config.ts`):
-
-```typescript
-import FixHivePlugin from '@the-magic-tower/fixhive-opencode-plugin';
-
-export default {
-  plugins: [FixHivePlugin],
-};
-```
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `FIXHIVE_SUPABASE_URL` | Community DB | Your Supabase project URL |
+| `FIXHIVE_SUPABASE_KEY` | Community Key | Your Supabase anon key |
+| `OPENAI_API_KEY` | None | Enables semantic similarity search |
+| `FIXHIVE_CONTRIBUTOR_ID` | Auto-generated | Your unique contributor ID |
 
-### Available Commands
+## Available Commands
 
 | Command | Description |
 |---------|-------------|
@@ -69,6 +76,7 @@ export default {
 | `fixhive_vote` | Upvote/downvote a solution |
 | `fixhive_stats` | View usage statistics |
 | `fixhive_helpful` | Report a solution was helpful |
+| `fixhive_report` | Report inappropriate content |
 
 ### Example Workflow
 
@@ -77,9 +85,13 @@ export default {
 3. **Apply fix** → Follow community solution
 4. **Share resolution** → `fixhive_resolve <error-id> "Installed missing dependency"`
 
-## Cloud Setup (Supabase)
+## Self-Hosted Setup (Optional)
 
-1. Create a new Supabase project
+Skip this section if you're using the default community knowledge base.
+
+To run your own FixHive backend:
+
+1. Create a new Supabase project (Free tier works)
 2. Run the setup script in SQL Editor:
 
 ```bash
@@ -88,6 +100,12 @@ cat scripts/setup-supabase.sql | pbcopy
 ```
 
 3. Get your project URL and anon key from Settings > API
+4. Set environment variables:
+
+```bash
+FIXHIVE_SUPABASE_URL=https://your-project.supabase.co
+FIXHIVE_SUPABASE_KEY=your-anon-key
+```
 
 ## Architecture
 

package/README.nl.md

@@ -29,37 +29,44 @@ FixHive is een OpenCode-plugin die automatisch fouten vastlegt tijdens ontwikkel
 npm install @the-magic-tower/fixhive-opencode-plugin
 ```
 
-## Configuratie
+## Snelstart
 
-Stel de volgende omgevingsvariabelen in:
+Voeg toe aan uw OpenCode-configuratie (`opencode.config.ts`):
+
+```typescript
+import FixHivePlugin from '@the-magic-tower/fixhive-opencode-plugin';
+
+export default {
+  plugins: [FixHivePlugin],
+};
+```
+
+**Dat is alles!** FixHive maakt standaard verbinding met de community-kennisbank. Geen omgevingsvariabelen vereist.
+
+## Configuratie (Optioneel)
+
+Omgevingsvariabelen om gedrag aan te passen:
 
 ```bash
-# Vereist voor cloudfuncties
+# Gebruik uw eigen Supabase-instantie in plaats van community
 FIXHIVE_SUPABASE_URL=https://your-project.supabase.co
 FIXHIVE_SUPABASE_KEY=your-anon-key
 
-# Optioneel: Voor embedding-gebaseerd semantisch zoeken
+# Schakel semantisch zoeken in (aanbevolen)
 OPENAI_API_KEY=sk-...
 
-# Optioneel: Aangepaste bijdrager-ID (automatisch gegenereerd indien niet ingesteld)
+# Aangepaste bijdrager-ID (automatisch gegenereerd indien niet ingesteld)
 FIXHIVE_CONTRIBUTOR_ID=your-contributor-id
 ```
 
-## Gebruik
-
-### Als OpenCode Plugin
-
-Voeg toe aan uw OpenCode-configuratie (`opencode.config.ts`):
-
-```typescript
-import FixHivePlugin from '@the-magic-tower/fixhive-opencode-plugin';
-
-export default {
-  plugins: [FixHivePlugin],
-};
-```
+| Variabele | Standaard | Beschrijving |
+|-----------|-----------|--------------|
+| `FIXHIVE_SUPABASE_URL` | Community DB | Supabase project-URL |
+| `FIXHIVE_SUPABASE_KEY` | Community Key | Supabase anon-sleutel |
+| `OPENAI_API_KEY` | Geen | Schakelt semantische gelijkeniszoekopdracht in |
+| `FIXHIVE_CONTRIBUTOR_ID` | Auto-gegenereerd | Unieke bijdrager-ID |
 
-### Beschikbare Commando's
+## Beschikbare Commando's
 
 | Commando | Beschrijving |
 |----------|--------------|
@@ -69,6 +76,7 @@ export default {
 | `fixhive_vote` | Stem voor/tegen een oplossing |
 | `fixhive_stats` | Bekijk gebruiksstatistieken |
 | `fixhive_helpful` | Meld dat een oplossing nuttig was |
+| `fixhive_report` | Meld ongepaste inhoud |
 
 ### Voorbeeld Workflow
 
@@ -77,9 +85,13 @@ export default {
 3. **Pas fix toe** → Volg de community-oplossing
 4. **Deel oplossing** → `fixhive_resolve <error-id> "Ontbrekende dependency geïnstalleerd"`
 
-## Cloud Setup (Supabase)
+## Self-Hosted Setup (Optioneel)
 
-1. Maak een nieuw Supabase-project aan
+Sla deze sectie over als u de standaard community-kennisbank gebruikt.
+
+Om uw eigen FixHive-backend te draaien:
+
+1. Maak een nieuw Supabase-project aan (gratis tier werkt)
 2. Voer het setup-script uit in de SQL-editor:
 
 ```bash
@@ -87,7 +99,13 @@ cat scripts/setup-supabase.sql | pbcopy
 # Plak in Supabase SQL-editor
 ```
 
-3. Haal uw project-URL en anon-sleutel op via Settings > API
+3. Haal project-URL en anon-sleutel op via Settings > API
+4. Stel omgevingsvariabelen in:
+
+```bash
+FIXHIVE_SUPABASE_URL=https://your-project.supabase.co
+FIXHIVE_SUPABASE_KEY=your-anon-key
+```
 
 ## Architectuur
 

package/README.zh.md

@@ -29,37 +29,44 @@ FixHive 是一个 OpenCode 插件，可在开发会话期间自动捕获错误
 npm install @the-magic-tower/fixhive-opencode-plugin
 ```
 
-## 配置
+## 快速开始
 
-设置以下环境变量：
+添加到 OpenCode 配置文件（`opencode.config.ts`）：
+
+```typescript
+import FixHivePlugin from '@the-magic-tower/fixhive-opencode-plugin';
+
+export default {
+  plugins: [FixHivePlugin],
+};
+```
+
+**完成！** FixHive 默认连接到社区知识库。无需设置环境变量。
+
+## 配置（可选）
+
+自定义行为的环境变量：
 
 ```bash
-# 云端功能必需
+# 使用自己的 Supabase 实例而非社区
 FIXHIVE_SUPABASE_URL=https://your-project.supabase.co
 FIXHIVE_SUPABASE_KEY=your-anon-key
 
-# 可选：用于基于嵌入的语义搜索
+# 启用语义搜索（推荐）
 OPENAI_API_KEY=sk-...
 
-# 可选：自定义贡献者 ID（未设置时自动生成）
+# 自定义贡献者 ID（未设置时自动生成）
 FIXHIVE_CONTRIBUTOR_ID=your-contributor-id
 ```
 
-## 使用方法
-
-### 作为 OpenCode 插件
-
-添加到 OpenCode 配置文件（`opencode.config.ts`）：
-
-```typescript
-import FixHivePlugin from '@the-magic-tower/fixhive-opencode-plugin';
-
-export default {
-  plugins: [FixHivePlugin],
-};
-```
+| 变量 | 默认值 | 描述 |
+|------|--------|------|
+| `FIXHIVE_SUPABASE_URL` | 社区 DB | Supabase 项目 URL |
+| `FIXHIVE_SUPABASE_KEY` | 社区 Key | Supabase anon 密钥 |
+| `OPENAI_API_KEY` | 无 | 启用语义相似度搜索 |
+| `FIXHIVE_CONTRIBUTOR_ID` | 自动生成 | 唯一贡献者 ID |
 
-### 可用命令
+## 可用命令
 
 | 命令 | 描述 |
 |------|------|
@@ -69,6 +76,7 @@ export default {
 | `fixhive_vote` | 对解决方案投票（赞/踩） |
 | `fixhive_stats` | 查看使用统计 |
 | `fixhive_helpful` | 报告解决方案有帮助 |
+| `fixhive_report` | 举报不当内容 |
 
 ### 示例工作流程
 
@@ -77,9 +85,13 @@ export default {
 3. **应用修复** → 按照社区解决方案操作
 4. **共享解决方案** → `fixhive_resolve <error-id> "安装缺失的依赖"`
 
-## 云端设置（Supabase）
+## 自托管设置（可选）
 
-1. 创建新的 Supabase 项目
+如果使用默认社区知识库，请跳过此部分。
+
+运行自己的 FixHive 后端：
+
+1. 创建新的 Supabase 项目（免费版可用）
 2. 在 SQL 编辑器中运行设置脚本：
 
 ```bash
@@ -88,6 +100,12 @@ cat scripts/setup-supabase.sql | pbcopy
 ```
 
 3. 从 Settings > API 获取项目 URL 和 anon key
+4. 设置环境变量：
+
+```bash
+FIXHIVE_SUPABASE_URL=https://your-project.supabase.co
+FIXHIVE_SUPABASE_KEY=your-anon-key
+```
 
 ## 架构
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@the-magic-tower/fixhive-opencode-plugin",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Community-based error knowledge sharing for OpenCode",
   "type": "module",
   "main": "dist/index.js",
@@ -56,6 +56,7 @@
     "@types/uuid": "^10.0.0",
     "@typescript-eslint/eslint-plugin": "^8.0.0",
     "@typescript-eslint/parser": "^8.0.0",
+    "@vitest/coverage-v8": "^2.1.9",
     "eslint": "^9.0.0",
     "tsup": "^8.2.0",
     "typescript": "^5.5.0",