OpenViking 能做什么
OpenViking 是面向 AI Agent 的开源上下文数据库。它把资料、记忆和技能组织在同一个虚拟文件系统里，让 Agent 能找到相关内容，并在后续任务中继续使用。
如果你正在解决“资料散落不好找”“每次会话都要重述背景”或“已有经验难以复用”，可以从下面选一条路径。
从你的任务开始
| 你想做到什么 | 先做什么 | 再往哪里走 |
|---|---|---|
| 让 Agent 找到项目资料中的依据 | 导入并检索第一份文档 | 换成你的资料，验证实际效果 |
| 给正在使用的 Agent 加入跨会话记忆 | 选择 Agent 接入方式 | 按插件说明安装，再用两次会话检查记忆 |
| 在自己的应用中使用上下文 | 应用开发路径 | 选资源、会话或技能流程，再查对应 API |
| 将资料整理成 Wiki、图谱或日报 | 上下文编译概览 | 选一种产物，用熟悉的来源核对结果 |
还没决定从哪条开始？ 先完成第一次导入与检索。这条路径用一份小文档走完连接、导入、检索和读取原文，不要求先读完原理。
已有服务地址和 API Key，可直接安装与使用 CLI。需要自己提供服务，查看部署路径；想使用 OpenViking 自带的 Agent，查看VikingBot 安装与配置。
怎样把第一次体验用起来
- 取得第一个结果。 不只确认服务健康，还要能读到导入的原文。
- 换成自己的任务。 用你知道答案的资料或跨会话背景，检查命中内容和实际使用情况，见用你的任务验证效果。
- 接进日常工作。 选择一个 Agent、应用或编译流程继续使用。需要多人共享时，再完善部署和访问控制。
出现问题时，从观测与排障区分连接、处理与检索问题。
上下文如何组织
| 上下文 | 用来存什么 |
|---|---|
| 资源 | 文档、代码仓库等外部资料 |
| 记忆 | 从会话提取的偏好、事实与经验 |
| 技能 | 可复用工作流程的指令与配套文件 |
内容通过 viking:// URI 定位，可以按路径浏览，也可以先检索再读取。上下文类型和 Viking URI解释对象与空间的边界。
按层读取内容
OpenViking 可在语义处理时生成目录摘要（L0）和概览（L1），再按需读取原文（L2）。L0、L1 是目录级附属文件，是否生成取决于处理状态和配置；它们不是每个文件都固定具备的一对摘要。详见上下文层级。
从会话生成记忆
应用记录消息，提交会话后按策略异步提取记忆。插件可以自动执行其中部分步骤，支持范围见集成能力对照。生成了哪些记忆、后续是否召回，需要检查实际结果。
想系统理解这套流程，从概念与原理开始；想直接完成任务，用左侧“接入你的工作”选择下一步。