Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -150,7 +150,7 @@ src/
- `src/lib/document-type.ts`で文書タイトルから文書タイプを自動判別
- `src/lib/prompts.ts`で文書タイプ別プロンプトを構築
- `src/lib/llm-client.ts`でLLM APIを呼び出し(OpenAI/Anthropic互換)
- 現行の要約は文字抽出から構造化事実を通常1回生成し、物理ページ・引用・数値・単位・期間と表の列を原文照合する
- 現行の要約は文字抽出から構造化事実を通常1回生成し、物理ページ・本文引用または表の根拠セルIDから、数値・単位・期間と表の行列を原文照合する
- 検証失敗時だけ再生成を1回試み、再失敗ならエラーを返す。検証済み事実からコードで表示文を作る
- 採点は要約表示後、追加分析はボタン操作時に、それぞれ独立した要求で実行する
- APIエラーの詳細抽出(ネストされたエラーメッセージの再帰的取得)
Expand All @@ -165,7 +165,7 @@ src/
- **`llm-providers.ts`**: LLMプロバイダー定義
- OpenAI、Anthropic、Google、OpenRouter、カスタムの5種類
- 各プロバイダーのデフォルトURL、デフォルトモデル、モデルリスト
- **`fact-summary.ts`**: 現行の1回構造化事実抽出、原文照合、事実ベースの表示文生成
- **`fact-summary.ts`**: 現行v3の構造化事実抽出、原文照合、事実ベースの表示文生成。表の根拠IDは `numeric-evidence.ts` で要約・採点共通に検証する
- **`additional-analysis.ts`**: 検証済み事実IDに基づく追加分析
- **`prompts.ts`**: 旧要約経路の文書タイプ別プロンプト。現行の要約では使用しない
- **`format-prompts.ts`**: 2パス要約のパス2用プロンプト
Expand All @@ -180,11 +180,11 @@ src/
- プロンプト仕様や利用モデルが異なる結果を別キャッシュとして管理
- **`scoring.ts`**: 実験的スコア
- ページ本文で照合した数値と事実に限り、規模・本業への影響・継続性を踏まえた点数の目安を推論。比較不能な項目を推測で補わない
- 一覧に点数・判定・主な理由を出し、展開詳細に内訳と根拠を出す。既定OFF
- 要約の下部に点数・判定・理由を表示し、展開詳細に内訳と根拠を出す。既定OFF
- **`score-extraction.ts` / `disclosure-search.ts`**: 採点入力と比較資料
- 通常のPDFを先に確認し、不足時のみ設定中のAPIのWeb検索で過去PDF候補を探す
- 検索結果だけでは採点せず、取得したPDF本文・対象期間・指標・根拠ページを照合する
- 配当の決定額と直近予想が本文の増減説明および表で検算できる場合は直接抽出する
- 表の値は要約と同じ位置情報・根拠セルIDで照合し、元PDFの採点値は検証済み要約事実と対応させる
- **`section-detector.ts`**: PDF抽出の知的フィルタリング
- セクション検出(5種類の見出しパターン)
- ページスコアリング(キーワード出現回数ベース)
Expand All @@ -204,7 +204,7 @@ src/
- **テキスト抽出処理**:
- Background Scriptから受信したArrayをUint8Arrayに変換
- pdf.jsの`getDocument()`でPDFを読み込み
- Y座標ベースの行グループ化でPDFレイアウトを保持
- `pdf-layout.ts` でページ内ID・文字座標・大きさを保持し、行本文も生成
- テキストクリーニング(空白正規化、ページ番号除去等)
- 抽出結果とメタデータ(ページ数、品質警告等)をBackground Scriptに返送
- **エラーハンドリング**: PDF読み込み失敗やページ抽出エラーを適切にハンドリング
Expand Down
32 changes: 26 additions & 6 deletions docs/development.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ API の設定は拡張機能の設定画面から行います。実 PDF を使

## 事実要約・採点・追加分析

通常の「要約」は、PDF.jsで抽出したテキストから構造化事実を生成し、原文の連続引用、数値、単位、対象期間、物理ページ、表の列を検証して表示します。検証できない事実は確定事実として表示せず、必須事実を確認できなければエラーにします。投資判断や星評価は要約に含めません。PDFファイルの直接入力は既定で使用しません。
通常の「要約」は、PDF.jsで抽出したテキストから構造化事実を生成し、本文の連続引用または表の根拠セルIDから、数値、単位、対象期間、物理ページ、行列の対応を検証して表示します。検証できない事実は確定事実として表示せず、必須事実を確認できなければエラーにします。投資判断や星評価は要約に含めません。PDFファイルの直接入力は既定で使用しません。

要約の表示後、実験的スコアがONなら採点を開始します。採点は要約で確認した事実を起点に、元PDFと必要な過去資料を照合します。採点に失敗しても要約は残ります。「追加分析」はボタンを押したときだけ生成し、採点設定とは独立しています。

Expand All @@ -57,6 +57,30 @@ API の設定は拡張機能の設定画面から行います。実 PDF を使

要約・採点・追加分析は別のキャッシュキーで保存します。設定画面の2パス切替は廃止しました。更新前の保存領域に `twoPassMode` が残っていれば、その廃止済みキーだけを削除して現在の設定を読み込みます。実PDFによる要約の確認手順と公開資料の期待値は[評価ガイド](../evaluation/README.md)を参照してください。

### 決算表の根拠参照

企業別・指標別の固定列番号は使用しません。事実スキーマv3では、表の数値に `evidence` を必須とし、値セルと指標・期間・単位・文脈の根拠IDを照合します。分析指紋はv27です。旧スキーマは受け入れず、旧条件のキャッシュは再利用しません。

| 層 | 実装と責務 |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 抽出 | `pdf-layout.ts` がPDF.jsの文字列・座標・大きさとページ内IDを保持。本文も同じPDF文字から作る。数値の後続語は別IDで保持し、円銭は数値表記の構文から結合する |
| 意味付け | LLMが `valueId`、`metricIds`、`periodIds`、`unitIds`、`contextIds` を選ぶ。列順や企業名による分岐は持たない |
| 表構造と検証 | `numeric-evidence.ts` が参照先の行、単位見出しの列領域、指標見出しの適用範囲を確認。指標が行にある表も扱う。金額と増減率は別セルとし、両者にまたがる指標見出しを認識する |
| 確定 | 値・符号、指標の全見出し、期間、単位、実績/予想区分を照合し、参照元から引用を組み立てる。空欄・欠損記号はゼロにしない。別セクションの見出しや曖昧な列は未確認にする |
| 利用 | 要約と採点が同じ検証器を使う。採点の元PDFと比較PDFにも位置情報を渡す。元PDFの採点値は要約の指標・期間・区分・単位・ページ・根拠IDと一致させる |

説明文は `evidence: null` と連続引用を使う独立した形式です。指標・数値・単位の直接対応を検証し、表の失敗を固定列推測や単位換算で補う経路は持ちません。確認できない必須事実は従来どおり要約エラーにします。`column` は現行形式ではnullのみです。

本文の指標と数量の間は、助詞・句読点だけを同じ行の最大6文字まで認めます。「について」「に関して」「に対して」「において」「として」は語単位で扱い、「については」などの組合せも照合します。任意のひらがなや否定・概数表現は認めません。照合した行番号も共通検証器から返し、要約で対象行の期間・実績/予想区分を検証します。他の指標・数量・文を跨ぐ対応は採用しません。

`quantity.ts` は数値と原文の単位候補を分離します。文字種だけで単位の意味を確定せず、通貨・株式だけの単位リストも持ちません。PDF抽出では、数値の直後にある「店舗」「合計」などの語を結合せず別IDで保持します。要約・採点の共通検証器は、値と一体の単位、列単位、値に隣接する別IDの単位を原文の文字列と位置で照合します。値セル内に単位が含まれる場合は、単位の参照IDに値セル自身を必須とし、列見出しによる代用は認めません。120百と万円のように値セル内の単位も分かれている場合は、値セルを含む全断片のIDをunitIdsで参照し、値セル内の単位と右隣の断片を原文順に合わせて照合します。隣接単位は同じ行・右側に限り、間隔は文字高の0.6倍までとし、間に別セルがある参照は拒否します。参照済み単位の直後に、複合単位として読める未参照セルが残る場合も未確認にします。後続セルが「万円※」などの注記を含む場合も、接頭部分が単位候補として読めれば同じ条件で拒否します。セル全体が「注+数字+任意の末尾区切り」の参照構文(例: `注1`、`注12`、`注1)`、`注1.`)に一致する場合は、独立した注記参照として単位の続きから除外します。末尾区切りはUnicodeの閉じ括弧・閉じ引用符と句点(.、。)の合計2文字までとし、%・/・·などの単位記号や数字・文字を含めません。単位を含む「万円注1」や、番号のない曖昧な「注」にはこの分類を適用しません。注記を削除して単位を採用する処理は行いません。続きを自動的に補ったり、指標見出しと推測して無視したりしません。円銭だけは数値表記の構文から結合します。セルIDの変更を旧結果へ適用しないため、分析指紋を更新しています。

数量が1つだけの表は、指標が数量と同じ行にある場合に限り、数量セルの幅と文字高から列の領域を限定します。列単位と期間見出しの中央がその領域に入ることを確認し、曖昧な配置は採用しません。採点の累計・単独区分は、表の根拠参照を検証した後で `periodIds` と `contextIds` の文字から確認します。期間名に「累計」がなくても、参照した見出しに記載があれば照合できます。表を空の本文引用やページ内の未参照文字で補う処理は持ちません。

汎用性の検証では、固定順の合成テキストを座標付きの実PDFデータへ置き換えました。5社の6ページで、報告対象の11項目、日本基準/IFRS、赤字と欠損値、配当の決定額・直近予想を確認します。列の並び替え・追加、見出しの改行、空欄、指標と期間の行列入れ替え、同額の別指標、前年・当年、通常予想・修正後予想の誤採用もテストします。取得元と再評価コマンドは[評価ガイド](../evaluation/README.md)を参照してください。

位置情報だけで全形式を確定できるわけではありません。回転文字、数量と見出しの所属を一意に決められない配置、未対応の複雑な結合セルは表の根拠として採用しません。実PDFの位置情報をLLMへ渡すため、今回の対象ページでは入力文字数が本文のみの約5~6倍でした。実モデルでの精度・トークン数・API処理時間は未評価です。単体・結合テストのLLM応答は固定しており、実LLMの成功を意味しません。

### 過去資料の検索と取得

実験的スコアで元PDF内の比較値が不足する場合、API側のWeb検索を1回使い、JPX、EIR、IR Pocketの過去開示PDFを優先して探します。元資料の開示日と前年同期の表題を検索語に含め、同日以降の資料は採用しません。検索結果は候補発見に限り、採点根拠にはしません。API応答のモデル本文からだけ候補URLを読み、取得前にHTTPS、正確なホスト名、PDFパス、証券コードとの対応を検証します。取得後は発行会社、開示日の前後、数値、単位、対象期間、物理ページを原文と照合します。対応を確認できない共用ホストや候補は採点に使いません。
Expand All @@ -67,8 +91,4 @@ API の設定は拡張機能の設定画面から行います。実 PDF を使

実PDFの回帰確認は[評価ガイド](../evaluation/README.md)の `npm run test:real-pdf -- --fetch` で18件を再取得して行います。JPX・IRホスティング先のURL取得、会社・期間・ページ照合、拒否されるURLも確認します。

2026年9月期第3四半期(4055)と検索で見つかった2025年9月期第3四半期の実PDFでは、汎用LLM抽出が比較値の根拠形式・引用を正しく返せませんでした。そこで、同じ四半期の決算短信に限り、検証済み要約事実と両PDFの経営成績の本文を直接対応付ける経路を追加しました。元PDFと前年PDFの物理4ページにある売上高3,393,604千円と3,033,776千円、営業利益634,398千円と533,539千円を照合します。百万円未満切捨ての表を要約した場合も、元PDFの千円単位の本文と照合します。

OpenRouterの `deepseek/deepseek-v4.1-flash` で検索から採点まで再評価し、前年同期PDFの発見、決算短信の対象年度を含む事実要約、2項目の採点とスコア68/100を確認しました。業績修正と業務提携の実PDF要約も期待値を通過しました。検索の15秒制限ではこのモデルがタイムアウトしたため、検索APIの上限を60秒に変更しました。この経路に当てはまらない資料は従来の原文検証付き抽出を使い、比較値を検証できない結果はエラーにしてキャッシュしません。

決算短信の対象期間検証を厳格化した際に分析指紋をv15に更新しました。IFRSの利益列、損失符号、数値予想の有無の照合を修正した際にv16へ更新しました。表の行と対象期間・実績/予想の対応を厳格化したため、v17で旧条件の要約キャッシュを再利用しないようにしました。
決算短信の千円本文と百万円表を個別の正規表現で対応付ける経路、および特定の配当表を固定順で読む経路は削除しました。採点は上記の共通根拠検証を使います。過去資料の検索・発行会社・開示日・会計基準・事業範囲の検証は引き続き必要です。
Loading
Loading