ドキュメントを閲覧

llms.txtのインポートとエクスポート

SourceShelfは、ローカルファイルの読み込みとSafariからのWebサイト取得の両方で、現在のllms.txt v2形式に対応します。ローカルファイルの読み込みは引き続きオフラインです。Web取得はSafari拡張機能とWebサイト権限だけを使い、ネイティブアプリはネットワークから分離されたままです。

このページの内容

SafariからWebサイトを読み込む

HTTP(S)ページでSourceShelfを開き、リサーチ > llms.txtから読み込むを選びます。SourceShelfはインデックスを探索し、順序付きのセクションと項目を表示し、アクセスが必要な外部オリジンを示して、リソースと1つの保存先を選べるようにします。llms.txtインデックスが最初に保存され、成功したリソースが選択順で続きます。空のパックは作りません。

SourceShelf拡張機能を最初に開いたとき、SafariがWebサイトへのアクセスを求めることがあります。コレクションに記載された別オリジンには、個別の許可が必要な場合があります。これらのアクセス権限はSafariが管理します。拒否した場合はSafariの拡張機能設定で変更し、レビューを開き直してください。

Webサイトの探索順序

SourceShelfは、HTMLの<link rel="describedby">、HTTP Linkヘッダーのrel="describedby"、現在のURLからルートへ向かう最も具体的なllms.txtパス、最後にルートの/llms.txtを順に確認します。相対URLはページ基準で解決し、重複を除きます。H1を持つ最初の有効なテキストまたはMarkdown応答を採用し、候補12件、リダイレクト5回、8 MiB、20秒を上限とします。

Webコンテンツの選択と来歴

選択項目ごとに、SourceShelfは明示的なrel="alternate" Markdown表現を優先し、次にpage.html.mdとpage.mdを試し、最後にHTMLを抽出します。この処理はllms.txtフローだけに適用され、クイックキャプチャは変わりません。インデックス記載項目だけが対象で、通常のリンクを巡回しません。履歴では、記載URL、実際に取得した表現、探索方法、インデックスURLを区別し、パッケージ整合性を主張しません。

Webサイト取得の上限とキャンセル

レビューは1,000件、同時取得は3リソース、1ソース100画像、操作全体256 MiBが上限です。危険なスキーム、リダイレクト、権限、時間、サイズ、解析、抽出のエラーはリソース別に表示します。キャンセルすると拡張機能の要求を止めて一時データを削除しますが、ローカル処理へ渡された作業は完了する場合があります。

ネイティブアプリのネットワーク分離

ネイティブアプリにはこの機能の外向きネットワーク権限がなく、SafariやWebのllms.txt取得にURLSessionを使いません。拡張機能が許可済みの取得、Markdown選択、画像準備を行い、上限付きのローカルハンドオフを送ります。変換、履歴、パック、出力フォルダ権限、永続化はネイティブ側に残ります。

コレクションをインポートする

ファイル > リサーチパックを読み込む…を選ぶか、変換画面の操作を使います。単独のローカルコレクションの場合は、次のいずれかを選択します。

  • ある llms.txt ファイル；または
  • を含むフォルダ llms.txt。

インデックスにローカルドキュメントのリンクが含まれている場合は、フォルダを選択します。これにより、SourceShelfはそれらを解決するための安全なルートになります。

パースアセンブリが受け入れるもの

インデックスには1つのH1タイトルを含める必要があります。また、以下を含めることもできます。

  • オプションのブロック引用要約。
  • 詳細な散文；
  • H2セクションを順序しました。
  • 説明付きのマークダウンリンクリストエントリ。
  • 特別な ## Optional セクション。

オプションのバイト順序マークを受け付けます。不適切なオプションのエントリは警告として報告されます。

H1だけが必須です。概要、詳細、セクション、説明、## Optionalは存在しない場合は省略され、エクスポート時に内容を作りません。

ローカルリンクの安全性

SourceShelf は、相対的なもののみを解決します。 .md、 .markdown、そして .txt 選択されたルートの下に含まれるリンク。それは拒否します：

  • .. トラバース；
  • 絶対的なローカルパス；
  • ルートから逃れるシンボリックリンク；
  • 支えがない URL 計画。

HTTP（S）リンクは名前付きのアクセス不可のライブラリ参照になります。タイトル、説明、および出典は引き続き表示されますが、SourceShelfはそれらを取得しません。繰り返されるターゲットは、正規化された識別子によって重複を削除され、最初の出現を保持します。

インポートされたインデックスは、最初に読み込めるライブラリアイテムです。ローカルドキュメントは、インデックス順に続きます。SourceShelfは、H1から名前にちなんで保存されたパックを作成し、正規化された名前の衝突の置き換え、保存として保存、キャンセル動作を提供します。

コレクションフォルダを作成する

きれいに保存したパックを開き、選択します。 エクスポート…> llms.txt コレクションフォルダ、Trust & Safetyを通過し、親フォルダを選択します。SourceShelfは衝突防止の <pack-name>-llms フォルダ：

<pack-name>-llms/
├── llms.txt
├── documents/
│   └── ordered-source.md
├── assets/
│   └── referenced-image.png
├── sourceshelf-manifest.json
└── checksums.sha256

ルートインデックスには、パッケージタイトル、信頼されていないコンテンツの概要、並べられたものが含まれています。 ## Sources リンク、そして ## Optional 有効なウェブ原産地を持つ利用できないソースのエントリ。ドキュメントの画像リンクは、コピーされたファイルに書き直されます。 assets/。

読み取り可能なマークダウンで実際に参照されているアーカイブされた画像のみが含まれています。有効なウェブ原産地がない読み取りできないエントリは省略され、生成後に報告されます。

SourceShelfは生成しません llms-full.txt、このフォーマットのリトライブロック、エンベディング、またはリモートダウンロード。