# 合体版タグ辞書（共有版）説明書

Danbooruタグ辞書と、日本語タグCSV（pixiv系）を合体させた SQLite データベースです。
この共有版は、ファイルサイズ制限（10MB）に収めるため、検索用の索引（インデックス）を外してあります。**データの中身は通常版とすべて同じ**です。

## 受け取るファイル

- `tags-share.db.xz`（約8.3MB）— xz形式で圧縮されています。

## 手順1: 解凍する

- Windows: 7-Zip（無料）で右クリック →「7-Zip」→「ここに展開」。中から `tags-share.db`（約27MB）が出てきます。
- Mac: Keka や The Unarchiver で開けます。
- Linux: `xz -d tags-share.db.xz`

## 手順2: 開く

- `tags-share.db` は SQLite 形式です。「DB Browser for SQLite」（無料）のような SQLite 対応ツールでそのまま開けます。
- プログラムから使う場合は、各言語の SQLite ライブラリで開けます。

## 中身

| テーブル | 件数 | 主な列 | 内容 |
|---|---|---|---|
| tags | 200,000 | name, post_count, category, category_name, is_deprecated, words | Danbooruタグ（正式名・カテゴリ・投稿数） |
| tag_aliases | 41,540 | antecedent_name, consequent_name, status | 別名 → 正式名の変換表 |
| tag_jp | 117,482 | tag, trans, synonyms, jp_group, source_count | 日本語タグ（日本語訳・同義語・グループ） |

## 注意（大事）

- **Danbooru側は投稿数（post_count）の多い順に上位20万件だけ**です。最小の post_count は 24 で、**投稿数23以下のタグは入っていません**。
- 日本語タグ側（tag_jp）は件数で切らず **全件** 入っています。
- **この共有版には索引（インデックス）がありません。** 検索はできますが、大きな範囲の検索は少し遅いことがあります。速くしたい場合は、開いたあとに次の文を実行すると索引が付きます（任意）:
  ```sql
  CREATE INDEX idx_tags_name ON tags(name);
  CREATE INDEX idx_alias_ant ON tag_aliases(antecedent_name);
  CREATE INDEX idx_jp_tag ON tag_jp(tag);
  ```
- Danbooruタグはアンダースコア形式です（例: `g41_(girls'_frontline)`）。NovelAI等のプロンプトで使う時は、アンダースコアをスペースに変換してください（例: `g41 (girls' frontline)`）。

## 検索の例

```sql
-- 正式タグを名前で引く
SELECT name, post_count, category_name FROM tags WHERE name = 'hatsune_miku';

-- 別名から正式名へ
SELECT consequent_name FROM tag_aliases WHERE antecedent_name = 'vocaloid';

-- 日本語から英語タグを探す
SELECT tag, trans, synonyms FROM tag_jp WHERE trans LIKE '%初音%';
```

## 由来

- Danbooru側: Danbooru公開APIから投稿数の多い順に取得（2026-11-03 構築）。
- 日本語側: pixiv系日本語タグのCSVを全件取り込み（2026-11-05 合体）。両側で一致したタグは 108,301 件でした。
