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
12 changes: 12 additions & 0 deletions docs/additional-analysis.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,15 @@
# 論点型追加分析とPDF CMap


## 全体の見立てとコンパクトな補足表示(2026-10-10)

追加分析は同じ1要求の中で `overallSummary: { text, evidenceIds } | null` と個別論点を生成する。全体の見立ては論点より前に常時表示し、個別の結論を流用せず、資料全体の変化・強弱・主要条件を統合するよう指示する。根拠不足ならnullを許し、追加の有料要求や先頭論点からの代替生成は行わない。

- 全体の見立ては入力の引用可能な根拠IDと独立照合する。隔離された論点を根拠にせず、入力から根拠本文・属性・ページを再構成する。形式・根拠参照が不正、または個別論点の見出し/結論/読みと完全一致する場合は見立てのみを隔離し、有効な論点は残す。参照の一致は文章の意味検証ではなく、全体の見立てもAI推論として表示する。
- v4に任意の保存フィールドを追加し、候補・表示文・根拠・注意を保存再検証する。旧v4の見立てなし結果も読めるが、見立てを捏造しない。診断には元応答と隔離理由を保持する。
- 要約の「補足要約の未整理部分」は本文では短い未反映の注意にし、章別一覧を原文と同じ一つの閉じた展開欄にまとめる。Markdown原本・コピー・原文とページ参照は保持する。
- 担当テスト: additional-analysis(根拠・隔離・コピー拒否・保存改変)、additional-analysis-transport(実通信コード+固定応答で1要求・診断・復元)、summaryHtmlBuilder(冒頭配置・閉じた根拠・HTMLエスケープ)、summary-presentation(未整理一覧と原文の一体表示)。固定応答の合格は実モデルの統合品質を保証しない。実API評価は未実施。

## 追加分析の論点化とCMap同梱(2026-10-06 / v100)

追加分析v3は固定の「解釈・短期・中期・長期」から、通常2〜4件の重要な論点へ変更する。根拠が不足する場合は1件または0件を許し、形式を埋めるための「判断不能」は要求しない。各論点は結論・根拠・条件付きの読み・限界・次の確認点を持つ。
Expand Down Expand Up @@ -126,3 +135,6 @@ v121の最終結果: 全1,599件/53ファイル、type-check、lint、buildが
代表的な結合検査で、空ページのみを省いたsmart要約から全文の追加分析・採点へ進むこと、回転文字の原文引用・保存復元、文書種別ごとの目印、原文改変の拒否を確認する。入力指紋をv123へ変更し、旧入力の分析を再利用しない。実モデル品質と未検出のPDF情報に関する従来の検証限界は変わらない。

v123確認: 全1,636件/58ファイル、type-check、lint、build、CMap168個+LICENSEの同梱照合が成功。4資料のオフライン再生で抽出原文の保持と予算を再確認した。回転文字のない安川・26ページ資料では元アイテムの重複追加は0。26ページ資料は約17.1万文字/236KBで既存予算内。過去の点検応答不足・旧形式拒否はv122時の境界を維持し、有料API・新モデル品質・実Chrome確認を成功として追加していない。

最終診断の保存に失敗した場合は、結果ID・実行ID・入力ハッシュ・PDF URLが完全一致する最終スナップショットだけを、現在のService Workerのメモリから取得できる。保存済みの途中記録を最終結果として返さない。一時記録は最大12件・全体1MiB・1件256KiBに制限し、JSONには未保存であることと一時的な保持であることを明示する。Worker終了・再起動や上限による除去後は取得できない。画面側は取得中に設定・表示結果が変わった場合の古い応答を破棄する。
一時診断の`persistenceFailure`は容量不足かその他の保存エラーか、およびread/prepare/writeの失敗箇所のみを記録する。生の保存例外や設定情報を転記せず、生成のoutcome/errorと分ける。
8 changes: 8 additions & 0 deletions docs/development.md
Original file line number Diff line number Diff line change
Expand Up @@ -1978,3 +1978,11 @@ v96の事前固定2実行は6要求で終了。BlueMeme/Worldとも独立した
境界の担当は `disclosure-observation`(所有者・別名・保存表示)、`additional-analysis`(根拠の投影)、`useSummarize`(実React・保存失敗・明示再試行・ライフサイクル)。生成指示やAPI上限は変更せず、個社/PDF専用分岐や新しい評価基盤は追加しない。旧条件のキャッシュを再利用しないよう分析指紋をv104へ更新する。実API・実Chrome画面の追加確認は行っていない。

最終差分は通常の `npm test`(設定済み2並列)40ファイル/1,254件、type-check・lint・build・diff checkが成功。元の診断応答は19確定事実と24指標/11説明の意味点検到達を保持し、固定した点検応答の表示と保存復元が一致した。固定点検の成功を実モデル品質の証明には数えない。

### 2026-10-10: 要約保存と比較・追加分析表示

分析指紋v124。原資料で選択済みの累計実績と同一表・同一指標軸にある前年値を、通常の候補検証と一意な比較成立を通して取得する。期間・主体・範囲・会計基準・条件の照合は緩和しない。新しい有料要求は追加しない。

256KiB以上の要約キャッシュはgzip/base64で可逆圧縮して保存し、読込時は展開上限32MiBと外側の識別情報を検査した後、従来の原文・要約表示・結果ID検証を通す。旧非圧縮キャッシュも読める。圧縮中の設定変更・キャッシュ削除/置換は保存直前にも検査する。容量不足は他の保存エラーと区別して表示し、既存の要約や診断を自動削除しない。設定のキャッシュ一覧は逐次展開し、一覧用メタデータだけを保持する。

v124の保存失敗後の回復: 新しい要約の保存失敗を既存キャッシュの消失と同一視しない。同じキーの保存済み要約を原文・表示・結果IDで再検証し、画面の新しい結果を置換せず再表示可能性を維持する。存在確認の読込失敗や古い読込は「保存なし」ではないため有料生成へ進めない。一覧の「表示」で保存が失われていた場合も、その操作中は生成せず、次の明示的な「要約」を待つ。クリック時には毎回保存を再確認し、現在のキーで正常に「保存なし」と読めた「要約」操作のみ通常生成へ進む。設定変更・削除・置換後の遅い再確認は無効化する。
4 changes: 3 additions & 1 deletion evaluation/scripts/check-extension-smoke.ts
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,8 @@ import path from 'node:path';
import { pathToFileURL } from 'node:url';
import { validateSavedFacts } from '../../src/lib/fact-cache';
import { validatePresentation } from '../../src/lib/summary-presentation';
import { decodeSummaryStorage } from '../../src/lib/summary-storage';
import type { CachedSummary } from '../../src/types/summaryMetadata';
import { SUMMARY_DIAGNOSTICS_KEY } from '../../src/lib/summary-trace';
import {
preflightExtensionSmoke,
Expand Down Expand Up @@ -211,7 +213,7 @@ export async function checkExtensionSmoke(args: string[]) {
outcome === 'success' ? 'firstSuccess' : 'partialSuccess'
);
assert.equal(stored.caches.length, 1);
const saved = stored.caches[0][1];
const saved = (await decodeSummaryStorage(stored.caches[0][1])) as CachedSummary;
validateSavedFacts(saved.facts);
validatePresentation(saved.presentation, saved.facts);
assert.deepEqual(saved.facts, preflight.result!.facts);
Expand Down
24 changes: 24 additions & 0 deletions src/background/index.test.ts
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,8 @@ interface TestResponse {
retryExtractionMode?: 'full';
error?: string;
diagnosticRunId: string;
diagnosticInputHash?: string;
trace?: import('../lib/analysis-trace').AnalysisDiagnosticExport;
diagnosticPersistence?: 'saved' | 'failed';
persistenceWarning?: string;
summary: string;
Expand Down Expand Up @@ -889,6 +891,28 @@ describe('要約・採点・追加分析の分離', () => {
expect(result.analysis).toMatchObject({ issues: [] });
expect(result.diagnosticPersistence).toBe('failed');
expect(result.persistenceWarning).toContain('保存できません');
expect(result.persistenceWarning).toContain('保存容量が不足');
expect(mocked.generateText).toHaveBeenCalledTimes(2);
const exported = await request({
action: 'getAnalysisDiagnostic',
runId: result.diagnosticRunId,
summaryResultId: summary.resultId,
inputHash: result.diagnosticInputHash,
});
expect(exported.trace).toMatchObject({
runId: result.diagnosticRunId,
outcome: 'success',
volatile: true,
persistenceWarning: expect.stringContaining('未保存'),
persistenceFailure: { code: 'quota', stage: 'write' },
});
const wrong = await request({
action: 'getAnalysisDiagnostic',
runId: result.diagnosticRunId,
summaryResultId: summary.resultId,
inputHash: 'other',
});
expect(wrong.error).toContain('未保存の最終診断');
expect(mocked.generateText).toHaveBeenCalledTimes(2);
vi.mocked(chrome.storage.local.set).mockImplementation(write);
const next = await request(followup);
Expand Down
90 changes: 63 additions & 27 deletions src/background/index.ts
Original file line number Diff line number Diff line change
@@ -1,3 +1,4 @@
import { summaryStorageWarning } from '@/lib/summary-storage';
import {
saveSummaryTrace,
summaryBuildDigest,
Expand All @@ -12,6 +13,7 @@ import {
} from '@/lib/pdf-extraction-error';
import {
saveAnalysisTrace,
loadAnalysisTrace,
nextAnalysisIntentAt,
type AnalysisTrace,
type AnalysisGenerationDiagnostic,
Expand Down Expand Up @@ -92,28 +94,59 @@ chrome.runtime.onInstalled.addListener((details) => {
})
.catch((error) => console.error('旧ホスト権限の削除に失敗:', error));
});
chrome.runtime.onMessage.addListener((request: Request, _sender, sendResponse) => {
if (!['summarize', 'score', 'analyze'].includes(request.action)) return;
const diagnosticRunId = request.action !== 'score' ? crypto.randomUUID() : null;
const task =
request.action === 'summarize'
? handleSummarize(request, diagnosticRunId!)
: request.action === 'analyze'
? handleAnalyze(request, diagnosticRunId!)
: handleFollowup(request);
task
.then((response) =>
sendResponse({ ...response, ...(diagnosticRunId ? { diagnosticRunId } : {}) })
)
.catch((error) =>
sendResponse({
error: error instanceof Error ? error.message : String(error),
...(error instanceof SummarySourceSelectionError ? { retryExtractionMode: 'full' } : {}),
...(diagnosticRunId ? { diagnosticRunId } : {}),
})
);
return true;
});
interface AnalysisDiagnosticRequest {
action: 'getAnalysisDiagnostic';
pdfUrl: string;
runId: string;
summaryResultId: string;
inputHash: string;
}
chrome.runtime.onMessage.addListener(
(request: Request | AnalysisDiagnosticRequest, _sender, sendResponse) => {
if (request.action === 'getAnalysisDiagnostic') {
if (
![request.pdfUrl, request.runId, request.summaryResultId, request.inputHash].every(
(value) => typeof value === 'string' && value.length > 0
)
) {
sendResponse({ error: '追加分析診断の識別情報が不正です' });
return;
}
void loadAnalysisTrace(
request.pdfUrl,
request.runId,
request.summaryResultId,
'failed',
request.inputHash
)
.then((trace) => sendResponse({ trace }))
.catch((error) =>
sendResponse({ error: error instanceof Error ? error.message : String(error) })
);
return true;
}
if (!['summarize', 'score', 'analyze'].includes(request.action)) return;
const diagnosticRunId = request.action !== 'score' ? crypto.randomUUID() : null;
const task =
request.action === 'summarize'
? handleSummarize(request, diagnosticRunId!)
: request.action === 'analyze'
? handleAnalyze(request, diagnosticRunId!)
: handleFollowup(request);
task
.then((response) =>
sendResponse({ ...response, ...(diagnosticRunId ? { diagnosticRunId } : {}) })
)
.catch((error) =>
sendResponse({
error: error instanceof Error ? error.message : String(error),
...(error instanceof SummarySourceSelectionError ? { retryExtractionMode: 'full' } : {}),
...(diagnosticRunId ? { diagnosticRunId } : {}),
})
);
return true;
}
);

// Concurrent summary/follow-up requests share only the in-flight initialization.
// Recheck contexts after completion so a subsequently closed document is recreated.
Expand Down Expand Up @@ -359,22 +392,23 @@ async function handleAnalyze(request: FollowupRequest, runId: string) {
elapsedMs: 0,
};
let diagnosticPersistence: DiagnosticPersistence = 'failed';
let diagnosticWarning: string | undefined;
const saveTrace = async () => {
trace.elapsedMs = Math.round(performance.now() - started);
try {
await saveAnalysisTrace(trace);
diagnosticPersistence = 'saved';
} catch {
diagnosticWarning = undefined;
} catch (error) {
diagnosticPersistence = 'failed';
diagnosticWarning = summaryStorageWarning(error, '追加分析の診断');
}
};
let terminalObserved = false;
const metadata = () => ({
diagnosticPersistence,
diagnosticInputHash: trace.inputHash,
...(diagnosticPersistence === 'failed'
? { persistenceWarning: '追加分析の診断を保存できませんでした' }
: {}),
...(diagnosticPersistence === 'failed' ? { persistenceWarning: diagnosticWarning } : {}),
});
try {
trace.pdfUrl = fullUrl(request.pdfUrl);
Expand Down Expand Up @@ -459,7 +493,9 @@ async function handleFollowup(
)
throw new Error('要約結果の識別子が一致しません');
if (request.action === 'analyze')
return { analysis: await analyzeFacts(config, facts, presentation, diagnostic, extraction.pages) };
return {
analysis: await analyzeFacts(config, facts, presentation, diagnostic, extraction.pages),
};
if (!settings.experimentalScoring) throw new Error('実験的スコアがOFFです');
const score = await attachScore(
config,
Expand Down
9 changes: 6 additions & 3 deletions src/content/SummaryButton.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ import { createPortal } from 'react-dom';
import { useSummarize } from './hooks/useSummarize';
import { useSummaryRow } from './hooks/useSummaryRow';
import { loadSummaryTrace } from '@/lib/summary-trace';
import { loadAnalysisTrace } from '@/lib/analysis-trace';
import { requestAnalysisTrace } from '@/lib/analysis-trace';
import { ACTION_BUTTON_STYLE, BUTTON_STYLES, FOCUS_STYLE } from './constants/styles';

interface RowData {
Expand Down Expand Up @@ -156,7 +156,7 @@ const SummaryButton: React.FC<SummaryButtonProps> = ({ rowData, row, iframeDoc }
try {
const trace =
kind !== 'summary'
? await loadAnalysisTrace(
? await requestAnalysisTrace(
rowData.pdfUrl,
kind === 'analysis' ? analysis.diagnosticRunId! : lastAnalysisRunId!,
result!.resultId!,
Expand Down Expand Up @@ -207,8 +207,11 @@ const SummaryButton: React.FC<SummaryButtonProps> = ({ rowData, row, iframeDoc }

// 同一描画内の連打でも要約要求は一度だけ送る。
if (summaryPending.current) return;
const requestedGeneration = !hasCached;
const request = (async () => {
if (!hasCached || !(await showCached())) await summarize();
// Always read first: availability can be unknown after a storage error.
// A click on 表示 must never silently turn into a paid generation.
if (!(await showCached()) && requestedGeneration) await summarize();
})();
summaryPending.current = request;
const clearPending = () => {
Expand Down
Loading
Loading