﻿━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
【タイトル】TyranoTagScanner
【Version 】2.00
【ファイル】TyranoTagScanner.zip
【著 作 者】朋美姫（Lyrical Limited）
【連 絡 先】ホームページ
            https://lyricallimited.blog.jp/
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
《はじめに》

朋美姫のアプリ「TyranoTagScanner」をダウンロードしていただき、誠にありがとうございます！

本ツールは、ティラノスクリプトでゲーム制作を行う方向けの静的解析・制作監査支援ツールです。 
.ksスクリプトの確認、タグや素材参照の問題候補の発見、未使用候補の確認、リリース前の品質管理などにお役立てください。

Ver1.00系は従来のコンソールアプリ版、Ver2.00はWindows FormsによるGUI版です。

《インストール方法》

配布ZIP「TyranoTagScanner.zip」を任意のフォルダーへ解凍してください。
解凍したフォルダー内の「TyranoTagScanner.exe」を起動してください。
アプリ上で解析したいTyranoScriptプロジェクトのフォルダーを選択してください。
Ver2.00では、旧コンソール版のようにEXEを制作中プロジェクトのdataフォルダーへコピーしたり、 
「TyranoTagScanner_config.csv」を用意したりする必要はありません。

《アンインストール方法》

配布したTyranoTagScannerのフォルダーを削除してください。

※Ver2.00は設定・作業状態の一部をユーザー環境に保存する場合があります。通常はそのままでも問題ありません。

《起動方法》

「TyranoTagScanner.exe」をダブルクリックします。
「参照」から解析対象のTyranoScriptプロジェクトを選択します。
「スタート」または「ホーム」から解析を実行します。
「問題一覧」や「概要」で結果を確認します。
作品側を修正した場合は再解析してください。

■■■使い方 / How to Use■■■

<<日本語>>

TyranoTagScannerを起動します。
解析するTyranoScriptプロジェクトのフォルダーを選択します。
解析を実行します。
アプリは.ksファイルや素材参照を調べ、静的な問題候補を整理します。
「問題一覧」で該当箇所を確認し、必要に応じて作品側を修正します。
修正後は再解析し、結果が改善したことを確認します。
静的な要対応が0件になった場合でも、最後は必ずゲーム本体を起動して実機確認してください。

主な確認内容
・TyranoScriptのタグ／記述に関する静的な問題候補
・画像、BGM、効果音などの素材参照
・存在しない素材の候補
・未使用素材の候補
・シナリオ遷移や参照関係の監査
・解析結果、基準、実機確認などを利用したリリース前チェック
・詳細監査モードによるRC封印、リリース台帳、完成アーカイブ等の制作管理

《通常モードと詳細監査モード》

通常モードでは、「スタート」「ホーム」「問題一覧」「概要」「公開版ガイド」「公開前チェック」「使い方」「設定」など、 普段の解析に必要な画面を中心に使用します。

詳細監査モードでは、素材監査、固定基準、実機確認、RC封印、リリース台帳、完成アーカイブなど、 作品のリリース前品質管理をより深く行うための機能を利用できます。

《未使用候補についての重要な注意》

「未使用候補」＝安全に削除できるファイル、ではありません。
変数で生成されるファイル名、JavaScript、プラグイン、条件分岐、独自マクロなどによる動的参照は、 静的解析だけでは完全に判定できない場合があります。素材を削除する場合は必ず作品をバックアップし、 削除後にゲーム本体を実行して主要ルート・画像・BGM・SE等を確認してください。

《解析結果について》

TyranoTagScannerの結果は、ゲーム制作を支援するための静的解析結果です。 「問題なし」や「要対応0件」であっても、実行時の完全な正常性を保証するものではありません。

逆に、表示された候補が作品の仕様上正しい場合もあります。最終判断は作品の実装内容と実機確認を合わせて行ってください。

《動作環境》

Windows x64
.NET Framework 4.8
具体的なWindowsバージョンの対応表記は、公開者が実際に動作確認した環境を基準にしてください。

《旧Ver1.00系からの主な変更》

コンソール操作からWindows Forms GUIへ全面移行
プロジェクトフォルダーを画面から選択して解析
問題一覧・概要・各種監査結果を画面上で確認
タグだけでなく素材・参照・遷移等の監査を強化
固定基準、実機確認、RC封印、リリース台帳、完成アーカイブ等の制作管理機能を追加
旧「TyranoTagScanner_config.csv」前提の操作を廃止

《English / Quick Guide》

Extract "TyranoTagScanner.zip" to a folder.
Run "TyranoTagScanner.exe".
Select the TyranoScript project folder you want to analyze.
Start the analysis and review the results in the Problems and Summary screens.
Fix the project as necessary and run the analysis again.
Even when no static issues remain, always test the game itself before release.
Version 2.00 is the Windows Forms GUI edition. Unlike the old console edition, it does not require placing the executable in the project's data folder or preparing TyranoTagScanner_config.csv.

Important: Static analysis cannot completely resolve every dynamic reference created by variables, JavaScript, plug-ins, conditions, or custom macros. Back up your project before deleting any file marked as potentially unused, and test the game afterward.

《バージョンアップ履歴 / Version History》

2025/06/25  1.00  TyranoTagScanner released
2025/06/25  1.01  Added sound/BGM file existence check, config.csv support
2025/06/25  1.02  Supports mp3, ogg, m4a, wav
2025/06/26  1.03  Changed error log encoding to UTF-8
2025/06/28  1.04  Added support for file names in subfolders
2025/07/13  1.05  Added #delete=true and #Allfiles=true to the console edition
2025/08/02  1.06  Added audio detection in arbitrary contexts to the console edition
2026/10/03  2.00  Windows Forms GUI版として全面刷新
                  プロジェクト選択、結果一覧、素材・参照監査、詳細監査、
                  固定基準、実機確認、RC封印、リリース台帳、完成アーカイブ等を統合
                  
《注意事項 / Notes》

本ツールはフリーソフトですが、著作権は朋美姫（Lyrical Limited）に帰属します。
再配布はご遠慮ください。リンクを共有する場合は公式HPをご利用ください。
バグ報告やご質問は、ホームページ（https://lyricallimited.blog.jp/）よりご連絡ください。
ファイルの削除・整理を行う場合は、重要な作品データを必ずバックアップしてください。
本ソフトはTyranoScript公式製品ではない独立した制作支援ツールです。

This is free software, but the copyright belongs to Tomomi Hime (Lyrical Limited).
Redistribution is prohibited. Please share the official website instead.
For bug reports or inquiries, contact us via the website.
Back up important project files before deleting or reorganizing assets.
This is an independent support tool and is not an official TyranoScript product.

《謝辞 / Acknowledgments》

本ツールの開発にあたり、ティラノスクリプトコミュニティの皆様のご意見を参考にさせていただきました。
ご利用いただくすべてのゲームクリエイターに感謝申し上げます！

TyranoTagScanner Ver2.00 / Copyright © 朋美姫（Lyrical Limited）