📖 DocReview Studio Official Manual
🌐 English 🚀 Webアプリを起動

DocReview Studio ユーザーズマニュアル

DocReview Studio は、ブラウザ単体でローカルのHTMLマニュアルやMarkdownドキュメント(.md / .markdown)を読み込み、直感的なレビュー指摘の記録、AI修正指示プロンプトの一括自動生成、インライン差分ハイライト、およびWinMerge風の左右Diff差分検証を行える完全クライアントサイド型 AI協働ドキュメント校正スタジオです。


📑 目次

1. DocReview Studio の特徴・設計思想
2. 画面構成(UIレイアウトと3ペイン構造)
3. クイックスタート(3ステップで始める)
4. 基本レビュー手順(指摘の記録・画像指摘・エビデンス管理)
5. AIプロンプト連携(LLM指示の一括生成)
6. ビジュアルDiff検証機能(インライン差分ハイライト&左右Diff比較)
7. 世代管理&スナップショット機能(版管理・安全退避・別名保存)
8. 便利な操作・ショートカット・IDE拡張機能


1. DocReview Studio の特徴・設計思想

全体レイアウト

🤖 人間とAIが協働する「ドキュメント改修サイクル」

🔒 サーバー通信ゼロ・完全ローカル完結

📝 HTML & Markdown(.md)の高速プレビュー

🚀 インストーラー不要・Windows / macOS 即座に起動


2. 画面構成(UIレイアウトと3ペイン構造)

DocReview Studio は、長時間のドキュメント校正作業を快適に行うための3ペイン構造を採用しています。

エリア 名称 主な役割
ヘッダー コントロールバー 原本フォルダ開く、履歴、世代管理(セーブ/別名保存)、エビデンス(JSON/MD)、AIプロンプト生成、Diff切替
左ペイン ファイルツリー 作業フォルダ内のHTML/Markdown階層一覧(検索フィルタ・種別バッジ付・拡大縮小ウィジェット付)
中央ペイン プレビュー / Diff検証 HTML/Markdown本文のレンダリング、インライン差分ハイライト、左右並列Diff比較
右ペイン 指摘一覧(Evidence) 選択テキスト、概算行番号、指摘区分、指示入力カードの一覧管理(拡大縮小ウィジェット付)

💡 リサイズ自由自在: 各ペインの境界線(リサイザー)をマウスドラッグすることで、ファイルツリーや指摘一覧の幅を自由に調整できます。


3. クイックスタート(3ステップで始める)

原本と退避の指定

STEP 1: 原本フォルダを開く

  1. ヘッダーの 「📁 原本を開く」 ボタンをクリックします。
  2. レビュー・校正対象のHTMLまたはMarkdownファイル群が含まれるローカルフォルダを選択し、アクセスを許可します。
  3. 左ペインにファイル一覧が読み込まれます(上部の検索ボックスで素早く絞り込み可能)。
  4. 過去に作業したフォルダがある場合は、「🕒 履歴」 ボタンからワンクリックで前回の作業状態を再開することもできます。

STEP 2: レビュー対象のファイルを選択(初回原本が自動保護)

  1. 左ペインのファイルツリーからレビューしたいファイルをクリックします。
  2. 中央ペインにプレビューが表示されると同時に、開いたファイルの初期状態(修正前)が自動的に 「v0: 初回原本」 として内部で安全に記録されます。
  3. これによって、面倒な事前バックアップを行わなくても、AI修正後に即座に差分検証を行えます。

STEP 3: テキストを選択して指摘を追加

  1. 本文プレビュー上で気になる文言をドラッグ選択し、ツールバーの 「📌 指摘リストに追加」 を押します。
  2. 右ペインの指摘カードに指示(例:「〜に修正」「誤字を訂正」など)を入力します。

4. 基本レビュー手順(指摘の記録・画像指摘・エビデンス管理)

テキスト選択と指摘カード

1. テキスト選択からの指摘追加

  1. 中央のプレビュー画面で、修正・指摘したいテキストをマウスでドラッグ選択します。
  2. 選択部分のすぐ上に表示される 「📌 指摘に追加」 フローティングボタン、またはツールバーの 「📌 指摘リストに追加」 をクリックします。
  3. 右ペインに新しい指摘カードが自動生成され、入力欄にフォーカスが当たります。

2. 画像・図表のレビュー(右クリックで一発追加)

3. ファイル全体・全般に対する指摘

特定の1行ではなくファイル全体に対する要望(例:「全体的にトーン&マナーを統一」「SEOキーワードを各見出しに反映」等)を追加したい場合:

4. 指摘カードの編集

各指摘カードには以下の情報が自動記録・設定されます:

5. エビデンスのエクスポート・復元

ヘッダーの Evidence グループからレビュー結果を保存・共有できます。


5. AIプロンプト連携(LLM指示の一括生成)

AIプロンプトコピー機能

蓄積した指摘データから、LLM(Claude, Gemini, ChatGPT 等)がそのまま解釈して正確にコード修正できる形式のプロンプトを一括生成します。

指示プロンプトのコピー方法

生成されるプロンプト形式例

【対象ファイル: 01_intro.html】
以下の指定箇所について、対象ファイルのみを直接編集して指摘内容を反映してください。

【厳守ルール】
1. 完全単一ファイル完結: 外部Web検索や他ファイルの走査・grepは一切行わないこと。
2. リンク先・外部構造の不問: HTML内のリンク先(href等)や参照先の存在・整合性は一切意識・検証せず、対象テキストのみをシンプルに検索・置換すること。
3. 構造・識別子の保護: 既存のHTMLタグ、属性値、クラス名、およびコード・メソッド等の英語識別子は維持し、指示のない前後の文言は変更しないこと。

========================================
[指摘 #1] 【修正】
対象ファイル: 01_intro.html (L.18付近)
対象テキスト:
"インメモリ全文検索: 数百ファイルのExcelデータをメモリ上に展開し、瞬時に結果を表示します。"
周辺文脈:
"...主な特徴: インメモリ全文検索: 数百ファイルのExcelデータをメモリ上に展開し、瞬時に結果を表示します。 完全オフライン動作..."
指示内容:
最新ベンチマークの数値(100ファイル約0.8秒)を追記し、速度メリットを具体化してください。

6. ビジュアルDiff検証機能(インライン差分ハイライト&左右Diff比較)

Diff検証画面

AIやエディタによる修正が完了したら、2つの方法で直感的に変更差分を目視検証できます。

1. インライン差分ハイライト(推奨)

2. WinMerge風 左右ブロック差分検証

3. 高精度なHTMLトークン字句解析エンジン

4. 🔄 高速再読込ボタン


7. 世代管理&スナップショット機能(版管理・安全退避・別名保存)

DocReview Studio では、Gitなどのバージョン管理ツールを開くことなく、ブラウザ上で直感的な版管理(世代管理)が行えます。

世代の仕組み

  1. v0: 初回原本: ファイルを開いた時点の純粋な原本データ。自動的に保護され、いつでも差分の基準点にできます。
  2. 📸 セーブ(スナップショット): AIに一連の修正を行わせた後、納得がいった段階で「📸 セーブ」を押すと、その状態が「v1」「v2」として新しい版に固定されます。
  3. 最新(作業中): 現在リアルタイムにディスク上で編集している作業ファイル。
  4. 世代セレクタ: ツールバーのプルダウンから過去の世代を選択し、どの版を比較基準にするかをいつでも切り替えられます。
  5. 📥 別名保存: 選択中の世代ファイルを安全に別名(例: index_v0_snapshot.html)でエクスポート可能。

8. 便利な操作・ショートカット・IDE拡張機能

サイドバー折りたたみ

⌨️ キーボードショートカット (Windows & Mac 両対応)

機能 Windows macOS (Mac)
左ペイン(ファイルツリー) 表示 / 非表示トグル Alt + 1 Option + 1 (⌥1)
右ペイン(指摘一覧) 表示 / 非表示トグル Alt + 2 Option + 2 (⌥2)
カーソル下ペインの個別拡大縮小 (ズーム) Ctrl + ホイール
または Alt + ホイール
Cmd + スクロール (⌘)
または Option + スクロール (⌥)
各ペインのズーム倍率を 100% にリセット Ctrl + 0
または 中クリック / Alt + 0
Cmd + 0 (⌘0)
または 中クリック / Option + 0

🔍 ペイン別独立ズーム機能

左(ファイルツリー)、中央(本文)、右(指摘一覧)のヘッダーにそれぞれ ズームウィジェット(− 100% +) を搭載。

🖥️ マルチディスプレイ向け「独立別窓」表示

↑