ov-resources

OpenViking リソース

リソースとは、ユーザーが OpenViking に追加したドキュメント（ファイル、リポジトリ、URL）です。 リソースは viking://resources/ 配下のファイルツリーに保存されます（ユーザー専用の場合は viking://user/<id>/resources/ に保存されることもあります）。各ディレクトリには、ファイルと並んで 2 つの概要があります。

• .abstract.md — ディレクトリに何が含まれているかを示す 1 段落の要約（L0）
• .overview.md — 内容を構造化して示す概要（L1）

まず概要を読み、最後にファイル全体を開いてください。概要があるため、すべてを読まずにどこを調べるか判断できます。

ツールを選ぶ

わかっていること…	使用するもの
おおよその内容	find(query, target_uri="viking://resources")
正確な単語、名前、エラー文字列	grep(uri, pattern=[...])
ファイル名または拡張子	glob(pattern, uri) 例：**/*.pdf
ファイルの場所	list(uri) と read(uris)

まずは find を使います。対象のリソースがわかったら、すぐに target_uri で範囲を絞ってください。範囲を狭めるほど、関連性の高い結果が得られます。質問が曖昧で意図の分析が必要な場合に限り、find の代わりに search を使います。

詳しく調べる

1. find はスコア付きの URI を返します。<dir>/.abstract.md がヒットした場合は、ディレクトリ全体が一致したことを意味し、要約に答えがあるとは限りません。
2. そのディレクトリの .overview.md を read して、内容を確認します。
3. ディレクトリを list するか、その中で範囲を絞った find／grep を実行して、目的のファイルにたどり着きます。
4. ファイルを read します。長いファイルの場合は、先に grep を実行し、一致箇所の前後を offset／limit で指定して read します。

必要な情報が得られたら、そこで止めてください。広範囲に 10 回検索するより、対象を絞った 2、3 回の読み取りのほうが効果的です。

ヒント

• find で有用な結果が得られない場合は、list viking://resources で内容を確認してから、最も近いディレクトリ内を検索します。
• スコアが低い場合（約 0.4 未満）は、通常ノイズです。limit を増やすのではなく、その分野で使われる用語に言い換えてください。
• ユーザーが開けるよう、参照した viking:// URI を記載してください。
• 新しいリソースを追加するには、ファイルパスまたは URL を指定して add_resource を使用してください。テキストを write でコピーしないでください。