ov-resources

OpenViking 资源

资源是用户添加到 OpenViking 的文档（文件、仓库、URL）。 它们位于 viking://resources/ 下的文件树中（用户私有资源有时位于 viking://user/<id>/resources/）。每个目录中的文件旁都有两个摘要：

• .abstract.md — 一段文字，说明目录中包含什么（L0）
• .overview.md — 目录内容的结构化概览（L1）

先阅读摘要，最后再打开完整文件。摘要可以帮助你决定去哪里查找，而无需阅读所有内容。

选择工具

你知道……	使用
大致主题	find(query, target_uri="viking://resources")
精确的词语、名称或错误字符串	grep(uri, pattern=[...])
文件名或扩展名	glob(pattern, uri)，例如 **/*.pdf
文件所在位置	list(uri) 和 read(uris)

默认使用 find。一旦知道资源所在位置，就使用 target_uri 限定范围——范围越窄，匹配结果越好。只有当问题模糊且需要意图分析时，才使用 search 而不是 find。

深入查找

1. find 会返回带有分数的 URI。匹配到 <dir>/.abstract.md 表示整个目录匹配，而不是答案就在摘要中。
2. read 该目录的 .overview.md，查看其中的内容。
3. list 该目录，或在其中运行限定范围的 find/grep，找到具体文件。
4. read 该文件。对于较长的文件，先用 grep 查找，再通过 offset/limit 读取匹配内容附近的部分。

只要获取到任务所需的信息就停止。进行两三次有针对性的读取，胜过十次宽泛搜索。

提示

• 如果 find 没有返回有用结果，使用 list viking://resources 查看现有内容，然后在最接近的目录中搜索。
• 较低的分数（低于约 0.4）通常是噪声；使用该领域自己的术语改写查询，而不是提高 limit。
• 引用所用资源的 viking:// URI，方便用户打开。
• 要添加新资源，请使用 add_resource 并提供文件路径或 URL；不要使用 write 复制其中的文本。