WebアプリとExcelの間でSVGを双方向にコピー＆ペーストするとき、「どこでベクターとして扱えなくなったのか」を自分の環境で切り分けるための診断Kitです。 Web→Excel、Excel→Web、保存→終了→再オープン後のRound-tripを分け、Clipboard・SVG構造・receiver reject・PNG fallbackのどこで結果が変わったかを追います。 【こんな症状向け】 ・Webの図をSVGファイル保存なしでExcelへCtrl+Vしたい ・ExcelからWebへ戻すとPNG／Raster扱いになる ・image/svg+xmlが見えるのにVector importできない ・PasteEventとAsync Clipboardで見える形式が違う ・Freshでは通るのに保存→再オープン後だけ失敗する ・SVGとPNGが同時にあり、fallback地点が分からない 【このKitで得られるもの】 無料記事では、技術的な結論や最小実装まで公開する方針です。 このKitは「答えを見るための商品」ではなく、自分の環境で問題を再現・観測・比較・診断するための実用ツール集です。 収録している主なもの： ・合成SVG fixture ・Browser Clipboard diagnostic ・raw SVG capture ・Windows Clipboard format probe ・SVG Structure Analyzer ・Lifecycle SVG Diff ・Transform Audit ・expected output ・Case記録例 ・Direct／Reopen比較workflow ・各種checklist ・実機Reference Evidence ・Security / Privacy / Troubleshooting docs 【重要な考え方】 この問題では、次を分けて考える必要があります。 ・SVG MIME present ≠ editable vector ・Excelへ貼れた ≠ Web receiverで安全に受理できる ・SVGとPNGは同時にClipboardへ存在し得る ・Mixed SVGやRaster wrapper SVGも存在する ・Save / Reopen後にSVG byte列やSHAが変わっても、それだけで劣化とは言えない ・serialization差とrendering差は別問題 実機Reference Evidenceでは、Direct／Reopen比較、raw SVG、diagnostic JSON、transform保持、render cross-checkなどを確認しています。 独立rendererでpixel一致するケースもあれば、ごく小さなrender差が出るケースもあります。 そのため「SHAが違う＝劣化」「必ずpixel-perfect」といった単純な判定は採用していません。 【収録物】 ■ Web → Excel ・image/svg+xmlを書き込む合成HTML demo ・fixture切替Outbound test ・Outbound checklist ■ Excel → Web ・metadata-only Browser diagnostic ・明示操作時だけ保存するraw SVG local capture ・Windows native Clipboard format enumerator ■ Offline analysis ・SVG Structure Analyzer ・Lifecycle SVG Diff ・Transform Audit 　matrix / translate / scale / rotate / skew / transform list / ancestor presentation transform等 ・Expected Output JSON ・実機Reference Evidence ※ CSS transform、viewBox由来の最終CTM、SVGのuse要素の完全展開などはscope外または限定対応です。 ■ Documentation ・README / GET_STARTED ・実機試験ガイド ・End-to-End Walkthrough ・Workflow / Tool Guide ・Interpretation Guide ・Filled Case Record ・Troubleshooting ・Security & Privacy ・Regression / Lifecycle / Outbound checklists 【基本workflow】 症状を1文で固定 → Direction / LifecycleでCase IDを分ける → Native / PasteEvent / Async Clipboardを観測 → 必要な場合だけraw SVGを保存してhashを固定 → structure / transformをoffline解析 → receiver rejectとfallbackを記録 → 1変数だけ変えたcontrolを作る → Regressionへ固定 【向いている人】 ・Web drawing / diagram / CAD系の開発者 ・Office ↔ Web Clipboard実装者 ・Excel保存前後で挙動が変わる問題を追いたい人 ・SVG Clipboard問題をfixtureとEvidenceで再現したい人 【向いていない人】 ・完成済みOffice importer SDKが欲しい人 ・全Excel / Browser / Windowsでの互換保証が必要な人 ・個別debug代行を求める人 ・ファイルをuploadするだけで自動診断するSaaSが欲しい人 【無料記事・Bookとの違い】 無料記事： 技術的な答え、最小コード、失敗の考え方 Zenn Book： parser / security / lifecycle / regression / release acceptanceを体系的に理解するための内容 Research Kit： 自分の環境をfixture / probe / analyzerで観測・比較・再現するための実用品 【Privacy / Security】 metadata diagnosticはraw本文を保存しません。 raw captureは確認欄と明示操作後だけ元Clipboard Blobをローカル保存します。 合成または保存許可のあるテストデータを使用してください。 metadata diagnostic、raw capture、offline analyzer、native probeはClipboard payloadを外部serverへuploadする設計ではありません。 Outbound fixture toolはsame-originの同梱fixtureだけを対象とし、script、event handler、foreignObject、DTD / ENTITY、external reference、url()参照などを保守的に拒否します。 ただし、これは任意SVGを安全化する一般用途sanitizerではありません。 【動作範囲】 主研究環境はWindows + Chrome + Excelです。 別Excel build、Edge、macOS、Word、PowerPoint等で同じ結果を保証するものではありません。 本KitはOffice内部形式の完全実装ではなく、Clipboard挙動の観測・切り分け・bounded import設計を支援する研究／診断Kitです。 【FAQ】 Q. WebからExcelへSVGを直接貼れますか？ 主研究環境ではimage/svg+xmlをClipboard APIでwriteし、Excelへ貼り付けできることを確認しています。ただし全環境保証ではありません。 Q. image/svg+xmlがあればVectorですか？ いいえ。Raster-only SVG wrapperやMixed SVGもあり得ます。MIMEの存在とeditable vectorは別です。 Q. PNGがあるならSVGは無いのですか？ いいえ。Clipboardはmulti-formatで、SVGとPNGが同時に存在できます。 Q. 保存→再オープンすると必ずRasterになりますか？ いいえ。serializationが変わる場合はありますが、byte差だけで劣化とは判断しません。 Q. raw SVGを保存できますか？ できます。明示操作型capture toolで元Clipboard Blob基準のhashとraw SVG、metadata JSONを保存できます。 Q. metadataだけ見ることもできますか？ できます。raw本文を保存しないdiagnostic toolを収録しています。 Q. Pythonは必須ですか？ Analyzerを実行する場合はPython 3が必要です。HTML demo、docs、checklistの閲覧だけなら不要です。 Q. Windows以外でも使えますか？ Python analyzerやdocsは利用できますが、Windows native Clipboard probeとExcel / Windows固有の実機再現はWindowsが必要です。 Q. Clipboard permissionで動きません。 Browser permission、secure context、組織policyを確認してください。policyを回避する手順は提供しません。 Q. 顧客データを使ってよいですか？ 最初は完全合成fixtureまたは保存許可のある最小テストデータを推奨します。 Q. 完成済みOffice importerですか？ 違います。観測tool、fixture、analysis、Evidence model、checklistを提供する診断Kitです。 【ライセンス概要】 ・1購入につき1名のIndividual License ・購入者本人の研究、学習、業務上の内部検証、商用／非商用ソフトウェア設計検討に利用可能 ・本Kitそのもの、docs、fixtures、toolsの第三者への再配布・再販売は禁止 ・詳細条件は商品ZIP内のLICENSE.mdを優先します