---

name: tune-accuracy description: "Run accuracy evaluation/tuning for RQ-SCAN and generate reports." metadata: version: "1.0.0"

/tune-accuracy

概要

精度評価・チューニングの実行を支援するスクリプトです。正解データ（CSV/Excel/JSON）と抽出結果を比較し、精度レポートと分析資料を生成します。

使い方

node scripts/tuning-round.mjs <round_number> --config <config_path>

例:

node scripts/tuning-round.mjs 1 --config ./tuning-config.json

必須環境変数

• RQSCAN_API_URL
• RQSCAN_API_KEY
• RQSCAN_ORGANIZATION_ID

設定ファイル（JSON）

最低限の構成例:

{
  "base_dir": ".",
  "workflow_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "ground_truth_path": "./ground_truth.xlsx",
  "ground_truth_sheet": "Sheet1",
  "pdf_directory": "./pdfs",
  "output_directory": "./rounds",
  "target_files_mode": "list",
  "target_files": ["sample1.pdf", "sample2.pdf"],
  "api": {
    "url": "http://localhost:8000",
    "timeout_ms": 300000
  },
  "evaluation": {
    "matching_keys": ["ファイル名", "倉入NO", "名変枝番", "出庫個数"],
    "file_name_key": "ファイル名",
    "fields": ["ファイル名", "出庫日", "運送便名称", "時間帯区分", "出荷先名称", "摘要", "倉入NO", "名変枝番", "出庫個数"],
    "field_rules": {
      "ファイル名": {"compare": "filename"},
      "出庫日": {"compare": "exact"},
      "運送便名称": {"compare": "normalized"},
      "時間帯区分": {"compare": "number"},
      "出荷先名称": {"compare": "normalized"},
      "摘要": {"compare": "remarks"},
      "倉入NO": {"compare": "exact"},
      "名変枝番": {"compare": "number"},
      "出庫個数": {"compare": "number"}
    }
  },
  "format_rule": {
    "description": "帳票から情報を抽出",
    "use_llm": true,
    "llm_model_type": "gemini",
    "ocr_provider": "azure",
    "format_rule_items": [
      {"name": "出庫日", "description": "YYYYMMDD形式"}
    ]
  }
}

入力データ形式

• CSV: 1行目ヘッダー、2行目以降データ行
• Excel: ground_truth_sheet 指定（未指定時は先頭シート）
• JSON: 配列形式、または { records: [...] }

出力

output_directory 配下に以下を生成します:

• accuracy_report.md
• extracted_results.json
• README.md
• change_log.md
• error_analysis.md
• config_used.json