メインコンテンツまでスキップ

Export/Import Notes

目的​

literature-analysisによって生成された3種類の構造化ノート（ダイジェスト、参考文献リスト、引用分析）をエクスポート・インポートし、Zoteroインスタンス間の移行を容易にします。

分析結果の編集について

Literature Analysisによって生成されたノートは、バックエンドデータからレンダリングされたものです。ノート内容を直接変更しても、バックエンドデータは変更されません。分析結果を編集するには、以下の手順を行います: ノートをエクスポート → エクスポートされたファイルを修正 → ノートをインポートして再インポート。

export-notes（ノートのエクスポート）​

ユースケース​

  • 文献分析結果を共同研究者と共有する
  • 別のZoteroインスタンスに分析結果をインポートする
  • 文献分析の成果物をバックアップする

入力制約​

制約タイプ説明
入力ユニット親アイテム
選択方法親アイテムと3種類のノートの混合選択に対応
複数選択の動作複数選択時、エクスポートディレクトリ選択ダイアログは1回のみ表示

エクスポートされる成果物​

ファイル説明
digest.md文献ダイジェストMarkdown
references.json参考文献リストJSON
citation_analysis.json引用分析データJSON
citation_analysis.md引用分析レポートMarkdown
representative_image.jpg代表画像（ダイジェストノートに埋め込み画像が含まれる場合）

代表画像はzs:representative-image:v1のMarkdownコメントブロックとしてdigest.mdに挿入され、同じディレクトリの相対パスで参照されます。画像のエクスポートに失敗しても、テキストおよびJSON成果物のエクスポートはブロックされません。

推定所要時間​

数秒で完了します（純粋なローカルファイル操作で、バックエンドは不要）。

import-notes（ノートのインポート）​

ユースケース​

  • 別のZoteroインスタンスで文献分析結果を復元する
  • 共同研究者が共有した分析成果物をインポートする

入力制約​

制約タイプ説明
入力ユニット単一の親アイテム
インポート方法エクスポートされた成果物を含むディレクトリを選択

インポートフロー​

1. インポートディレクトリの選択
   └── ディレクトリにはdigest.md、references.json、citation_analysis.jsonが含まれている必要がある

2. 構造検証
   └── references.jsonとcitation_analysis.jsonは候補になる前に構造検証を受ける
       └── 検証失敗は警告を表示するが、他の成果物のインポートはブロックしない

3. 画像解析
   └── digest.mdにzs:representative-image:v1マーカーブロックが含まれる場合
       └── 同じディレクトリから代表画像を自動的に解析
       └── ユーザーが手動で代表画像を選択またはクリアすることも可能

4. 書き込み
   └── 親アイテムの下に対応するノートを作成/更新

画像のインポートに失敗しても、ダイジェストノートのインポートはブロックされません。

依存関係​

  • バックエンド接続は不要
  • Zoteroローカルストレージのみに依存

関連Workflow​