Skip to content

Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.

docs: README community links as icon + text, sharper positioning (#5199)

Zayn Jarvis586c7e32bb34
diff --git a/README.md b/README.md
index 6d84f12be..6e190747e 100644
--- a/README.md
+++ b/README.md
@@ -12,18 +12,25 @@ English / [中文](README_CN.md) / [日本語](README_JA.md)
<a href="https://www.openviking.ai">Website</a> · <a href="https://openviking.ai/studio">Live Demo</a> · <a href="https://github.com/volcengine/OpenViking">GitHub</a> · <a href="https://github.com/volcengine/OpenViking/issues">Issues</a> · <a href="https://docs.openviking.ai/">Docs</a>
-[![](https://img.shields.io/github/v/release/volcengine/OpenViking?color=369eff\&labelColor=black\&logo=github\&style=flat-square)](https://github.com/volcengine/OpenViking/releases)
-[![](https://img.shields.io/github/stars/volcengine/OpenViking?labelColor\&style=flat-square\&color=ffcb47)](https://github.com/volcengine/OpenViking)
-[![](https://img.shields.io/github/issues/volcengine/OpenViking?labelColor=black\&style=flat-square\&color=ff80eb)](https://github.com/volcengine/OpenViking/issues)
-[![](https://img.shields.io/github/contributors/volcengine/OpenViking?color=c4f042\&labelColor=black\&style=flat-square)](https://github.com/volcengine/OpenViking/graphs/contributors)
-[![](https://img.shields.io/badge/license-AGPLv3-white?labelColor=black\&style=flat-square)](https://github.com/volcengine/OpenViking/blob/main/LICENSE)
-[![](https://img.shields.io/github/last-commit/volcengine/OpenViking?color=c4f042\&labelColor=black\&style=flat-square)](https://github.com/volcengine/OpenViking/commits/main)
-
-[![Deploy on Railway](https://railway.com/button.svg)](https://railway.com/deploy/openviking)
-
-👋 Join our Community
-
-📱 <a href="https://docs.openviking.ai/en/about/01-about-us#lark-group">Lark Group</a> · <a href="https://docs.openviking.ai/en/about/01-about-us#wechat-group">WeChat</a> · <a href="https://discord.com/invite/eHvx8E9XF3">Discord</a> · <a href="https://x.com/openvikingai">X</a>
+<p>
+ <a href="https://github.com/volcengine/OpenViking/releases"><img src="https://img.shields.io/github/v/release/volcengine/OpenViking?color=369eff&labelColor=black&logo=github&style=flat-square" alt="release"></a>
+ <a href="https://github.com/volcengine/OpenViking"><img src="https://img.shields.io/github/stars/volcengine/OpenViking?labelColor&style=flat-square&color=ffcb47" alt="stars"></a>
+ <a href="https://github.com/volcengine/OpenViking/issues"><img src="https://img.shields.io/github/issues/volcengine/OpenViking?labelColor=black&style=flat-square&color=ff80eb" alt="issues"></a>
+ <a href="https://github.com/volcengine/OpenViking/graphs/contributors"><img src="https://img.shields.io/github/contributors/volcengine/OpenViking?color=c4f042&labelColor=black&style=flat-square" alt="contributors"></a>
+ <a href="https://github.com/volcengine/OpenViking/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-AGPLv3-white?labelColor=black&style=flat-square" alt="license"></a>
+ <a href="https://github.com/volcengine/OpenViking/commits/main"><img src="https://img.shields.io/github/last-commit/volcengine/OpenViking?color=c4f042&labelColor=black&style=flat-square" alt="last commit"></a>
+</p>
+
+<p>
+ <a href="https://railway.com/deploy/openviking"><img src="https://railway.com/button.svg" alt="Deploy on Railway" height="30"></a>
+</p>
+
+<p>
+ <a href="https://docs.openviking.ai/en/about/01-about-us#lark-group"><img src="docs/images/community/lark.svg" width="18" height="18" alt="Lark">&nbsp;Lark</a> ·
+ <a href="https://docs.openviking.ai/en/about/01-about-us#wechat-group"><img src="docs/images/community/wechat.svg" width="18" height="18" alt="WeChat">&nbsp;WeChat</a> ·
+ <a href="https://discord.com/invite/eHvx8E9XF3"><img src="docs/images/community/discord.svg" width="18" height="18" alt="Discord">&nbsp;Discord</a> ·
+ <a href="https://x.com/openvikingai"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/community/x-dark.svg"><img src="docs/images/community/x.svg" width="16" height="16" alt="X"></picture>&nbsp;X</a>
+</p>
<a href="https://trendshift.io/repositories/19668" target="_blank"><img src="https://trendshift.io/api/badge/repositories/19668" alt="volcengine%2FOpenViking | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
@@ -33,9 +40,9 @@ English / [中文](README_CN.md) / [日本語](README_JA.md)
## What is OpenViking
-OpenViking is an open-source context database for AI agents. It gives agents a place to store knowledge, remember users, and reuse experience across sessions.
+OpenViking is an open-source context database for AI agents — one filesystem for everything an agent knows: knowledge, memory, and skills.
-OpenViking organizes context as a virtual filesystem under `viking://`. Agents can operate on it like files: use `ls`, `tree`, `read`, and `write` to browse directories, read, create, and edit content, or search within a directory. Directory summaries support on-demand loading.
+Most agent memory is a black box: text goes in, embeddings come out, and nobody can see what was actually stored. OpenViking organizes context as a virtual filesystem under `viking://` instead. Agents navigate it like files — `ls`, `tree`, `read`, `write`, `grep` — and you can open any directory to inspect and edit what your agent knows. Directory summaries are loaded on demand: agents read the map before the territory.
<a href="https://openviking.ai/studio" target="_blank" rel="noopener noreferrer">
<picture>
@@ -48,10 +55,10 @@ OpenViking organizes context as a virtual filesystem under `viking://`. Agents c
## Why OpenViking
-- **One filesystem for all context.** Resources hold documents and code; memories retain user preferences and experience; skills define how to perform tasks. Each has a `viking://` URI for browsing and retrieval. → [Viking URI](https://docs.openviking.ai/en/concepts/04-viking-uri) · [Context types](https://docs.openviking.ai/en/concepts/02-context-types)
-- **Load only the context you need.** Directory abstracts (L0) and overviews (L1) help agents decide when to read full content (L2). → [Context layers](https://docs.openviking.ai/en/concepts/03-context-layers)
-- **Search within the directory structure.** Vector search finds candidate directories, then explores their contents. `find` runs a query directly; `search` can use session context to plan retrieval. → [Retrieval](https://docs.openviking.ai/en/concepts/07-retrieval)
-- **Turn sessions into memory.** Committing a session archives the conversation and starts background extraction. Memory policies control what is retained; candidates are compared with existing memories for creation, merging, or skipping. With VikingBot enabled, `ov compile` uses a skill to organize source material into a wiki, knowledge graph, or report. → [Sessions](https://docs.openviking.ai/en/concepts/08-session) · [Context compilation](https://docs.openviking.ai/en/context-compilation/01-overview)
+- **One filesystem for knowledge, memory, and skills.** Resources hold documents and code; memories retain user preferences and experience; skills define how to perform tasks — not just extracted facts, but the full context, each with a `viking://` URI for browsing and retrieval. → [Viking URI](https://docs.openviking.ai/en/concepts/04-viking-uri) · [Context types](https://docs.openviking.ai/en/concepts/02-context-types)
+- **Search a directory, not the whole index.** Scope semantic search to a project or memory subtree instead of scanning a flat vector pool. `find` runs a query directly; `search` plans retrieval from session context. → [Retrieval](https://docs.openviking.ai/en/concepts/07-retrieval)
+- **Read the summary before the source.** Generated directory abstracts (L0) and overviews (L1) let agents judge relevance before opening full content (L2). → [Context layers](https://docs.openviking.ai/en/concepts/03-context-layers)
+- **Sessions become files you can read.** Committing a session archives the conversation and extracts memories as Markdown you can inspect, edit, and merge. With VikingBot enabled, `ov compile` organizes source material into a wiki, knowledge graph, or report. → [Sessions](https://docs.openviking.ai/en/concepts/08-session) · [Context compilation](https://docs.openviking.ai/en/context-compilation/01-overview)
[Architecture](https://docs.openviking.ai/en/concepts/01-architecture) · [Design rationale](https://blog.openviking.ai/post/openviking-context-database/)
@@ -308,7 +315,7 @@ To propose a partnership, [open an issue](https://github.com/volcengine/OpenViki
- **Docs**: [docs.openviking.ai](https://docs.openviking.ai/) · [FAQ](https://docs.openviking.ai/en/faq/faq)
- **Blog**: [blog.openviking.ai](https://blog.openviking.ai/)
- **Team**: [About us](https://docs.openviking.ai/en/about/01-about-us)
-- **Chat**: 📱 [Lark Group](https://docs.openviking.ai/en/about/01-about-us#lark-group) · 💬 [WeChat](https://docs.openviking.ai/en/about/01-about-us#wechat-group) · 🎮 [Discord](https://discord.com/invite/eHvx8E9XF3) · 🐦 [X](https://x.com/openvikingai)
+- **Chat**: <a href="https://docs.openviking.ai/en/about/01-about-us#lark-group"><img src="docs/images/community/lark.svg" width="18" height="18" alt="Lark">&nbsp;Lark</a> · <a href="https://docs.openviking.ai/en/about/01-about-us#wechat-group"><img src="docs/images/community/wechat.svg" width="18" height="18" alt="WeChat">&nbsp;WeChat</a> · <a href="https://discord.com/invite/eHvx8E9XF3"><img src="docs/images/community/discord.svg" width="18" height="18" alt="Discord">&nbsp;Discord</a> · <a href="https://x.com/openvikingai"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/community/x-dark.svg"><img src="docs/images/community/x.svg" width="16" height="16" alt="X"></picture>&nbsp;X</a>
- **Contribute**: bug fixes and new features are both welcome — see [CONTRIBUTING.md](CONTRIBUTING.md)
<a href="https://github.com/volcengine/OpenViking/graphs/contributors">
diff --git a/README_CN.md b/README_CN.md
index abc46a868..6b9818138 100644
--- a/README_CN.md
+++ b/README_CN.md
@@ -12,16 +12,25 @@
<a href="https://www.openviking.ai">官网</a> · <a href="https://openviking.ai/studio">在线体验</a> · <a href="https://github.com/volcengine/OpenViking">GitHub</a> · <a href="https://github.com/volcengine/OpenViking/issues">问题反馈</a> · <a href="https://docs.openviking.ai/">文档</a>
-[![](https://img.shields.io/github/v/release/volcengine/OpenViking?color=369eff\&labelColor=black\&logo=github\&style=flat-square)](https://github.com/volcengine/OpenViking/releases)
-[![](https://img.shields.io/github/stars/volcengine/OpenViking?labelColor\&style=flat-square\&color=ffcb47)](https://github.com/volcengine/OpenViking)
-[![](https://img.shields.io/github/issues/volcengine/OpenViking?labelColor=black\&style=flat-square\&color=ff80eb)](https://github.com/volcengine/OpenViking/issues)
-[![](https://img.shields.io/github/contributors/volcengine/OpenViking?color=c4f042\&labelColor=black\&style=flat-square)](https://github.com/volcengine/OpenViking/graphs/contributors)
-[![](https://img.shields.io/badge/license-AGPLv3-white?labelColor=black\&style=flat-square)](https://github.com/volcengine/OpenViking/blob/main/LICENSE)
-[![](https://img.shields.io/github/last-commit/volcengine/OpenViking?color=c4f042\&labelColor=black\&style=flat-square)](https://github.com/volcengine/OpenViking/commits/main)
-
-👋 加入我们的社区
-
-📱 <a href="https://docs.openviking.ai/zh/about/01-about-us#飞书群">飞书群</a> · <a href="https://docs.openviking.ai/zh/about/01-about-us#微信群">微信群</a> · <a href="https://discord.com/invite/eHvx8E9XF3">Discord</a> · <a href="https://x.com/openvikingai">X</a>
+<p>
+ <a href="https://github.com/volcengine/OpenViking/releases"><img src="https://img.shields.io/github/v/release/volcengine/OpenViking?color=369eff&labelColor=black&logo=github&style=flat-square" alt="release"></a>
+ <a href="https://github.com/volcengine/OpenViking"><img src="https://img.shields.io/github/stars/volcengine/OpenViking?labelColor&style=flat-square&color=ffcb47" alt="stars"></a>
+ <a href="https://github.com/volcengine/OpenViking/issues"><img src="https://img.shields.io/github/issues/volcengine/OpenViking?labelColor=black&style=flat-square&color=ff80eb" alt="issues"></a>
+ <a href="https://github.com/volcengine/OpenViking/graphs/contributors"><img src="https://img.shields.io/github/contributors/volcengine/OpenViking?color=c4f042&labelColor=black&style=flat-square" alt="contributors"></a>
+ <a href="https://github.com/volcengine/OpenViking/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-AGPLv3-white?labelColor=black&style=flat-square" alt="license"></a>
+ <a href="https://github.com/volcengine/OpenViking/commits/main"><img src="https://img.shields.io/github/last-commit/volcengine/OpenViking?color=c4f042&labelColor=black&style=flat-square" alt="last commit"></a>
+</p>
+
+<p>
+ <a href="https://railway.com/deploy/openviking"><img src="https://railway.com/button.svg" alt="Deploy on Railway" height="30"></a>
+</p>
+
+<p>
+ <a href="https://docs.openviking.ai/zh/about/01-about-us#飞书群"><img src="docs/images/community/lark.svg" width="18" height="18" alt="飞书">&nbsp;飞书</a> ·
+ <a href="https://docs.openviking.ai/zh/about/01-about-us#微信群"><img src="docs/images/community/wechat.svg" width="18" height="18" alt="微信">&nbsp;微信</a> ·
+ <a href="https://discord.com/invite/eHvx8E9XF3"><img src="docs/images/community/discord.svg" width="18" height="18" alt="Discord">&nbsp;Discord</a> ·
+ <a href="https://x.com/openvikingai"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/community/x-dark.svg"><img src="docs/images/community/x.svg" width="16" height="16" alt="X"></picture>&nbsp;X</a>
+</p>
<a href="https://trendshift.io/repositories/19668" target="_blank"><img src="https://trendshift.io/api/badge/repositories/19668" alt="volcengine%2FOpenViking | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
@@ -31,9 +40,9 @@
## OpenViking 是什么
-OpenViking 是面向 AI 智能体的开源上下文数据库,用来存储知识、记住用户,并在会话之间复用经验。
+OpenViking 是面向 AI 智能体的开源上下文数据库——用一个文件系统装下 Agent 所知道的一切:知识、记忆和技能。
-OpenViking 将上下文组织成 `viking://` 虚拟文件系统。Agent 可以像操作文件一样,通过 `ls`、`tree`、`read`、`write` 等操作浏览目录、读取、创建和编辑内容,也可以在目录内检索。目录摘要支持按需加载。
+大多数 Agent 记忆是个黑盒:文本进去,向量出来,没人看得到里面到底存了什么。OpenViking 换一种做法,把上下文组织成 `viking://` 虚拟文件系统。Agent 像操作文件一样用 `ls`、`tree`、`read`、`write`、`grep` 浏览和修改;你也可以随时打开目录,查看和编辑 Agent 记住的内容。目录摘要按需加载:先看地图,再进森林。
<a href="https://openviking.ai/studio" target="_blank" rel="noopener noreferrer">
<picture>
@@ -46,10 +55,10 @@ OpenViking 将上下文组织成 `viking://` 虚拟文件系统。Agent 可以
## 为什么用 OpenViking
-- **用文件系统组织上下文。** 资源存放文档和代码,记忆保留用户偏好与经验,技能定义任务执行方式。每项上下文都有 `viking://` URI,供 Agent 浏览和检索。→ [Viking URI](https://docs.openviking.ai/zh/concepts/04-viking-uri) · [上下文类型](https://docs.openviking.ai/zh/concepts/02-context-types)
-- **按需加载上下文。** 目录摘要(L0)和概览(L1)帮助 Agent 判断何时读取完整内容(L2)。→ [上下文分层](https://docs.openviking.ai/zh/concepts/03-context-layers)
-- **沿目录结构检索。** 向量检索先找到候选目录,再探索其中的内容。`find` 直接执行查询,`search` 可以结合会话上下文规划检索。→ [检索机制](https://docs.openviking.ai/zh/concepts/07-retrieval)
-- **从会话提取记忆。** 提交 Session 后,会话被归档,后台按记忆策略提取内容,与已有记忆比较后新建、合并或跳过。启用 VikingBot 后,还可用 `ov compile` 配合技能,将资料整理成 Wiki、知识图谱或报告。→ [会话管理](https://docs.openviking.ai/zh/concepts/08-session) · [上下文编译](https://docs.openviking.ai/zh/context-compilation/01-overview)
+- **一个文件系统,装下知识、记忆和技能。** 资源存放文档和代码,记忆保留用户偏好与经验,技能定义任务的执行方式——不只是抽取出来的"记忆条目",而是完整上下文,每一项都有 `viking://` URI 供浏览和检索。→ [Viking URI](https://docs.openviking.ai/zh/concepts/04-viking-uri) · [上下文类型](https://docs.openviking.ai/zh/concepts/02-context-types)
+- **在目录里检索,而不是在整个索引里捞。** 把语义检索限定在某个项目或记忆子树内,而不是扫描一个扁平的向量池。`find` 直接执行查询,`search` 结合会话上下文规划检索。→ [检索机制](https://docs.openviking.ai/zh/concepts/07-retrieval)
+- **先看摘要,再读原文。** 自动生成的目录摘要(L0)和概览(L1)帮助 Agent 判断相关性,再决定是否读取全文(L2)。→ [上下文分层](https://docs.openviking.ai/zh/concepts/03-context-layers)
+- **会话沉淀为可读的文件。** 提交会话后,对话被归档,记忆被提取为可查看、可编辑、可合并的 Markdown。启用 VikingBot 后,`ov compile` 还能把资料整理成 Wiki、知识图谱或报告。→ [会话管理](https://docs.openviking.ai/zh/concepts/08-session) · [上下文编译](https://docs.openviking.ai/zh/context-compilation/01-overview)
[架构](https://docs.openviking.ai/zh/concepts/01-architecture) · [设计思路](https://blog.openviking.ai/post/openviking-context-database/)
@@ -306,7 +315,7 @@ ov chat # 在另一个终端运行
- **文档**:[docs.openviking.ai](https://docs.openviking.ai/) · [FAQ](https://docs.openviking.ai/zh/faq/faq)
- **博客**:[blog.openviking.ai](https://blog.openviking.ai/)
- **团队**:[关于我们](https://docs.openviking.ai/zh/about/01-about-us)
-- **交流**:📱 [飞书群](https://docs.openviking.ai/zh/about/01-about-us#飞书群) · 💬 [微信群](https://docs.openviking.ai/zh/about/01-about-us#微信群) · 🎮 [Discord](https://discord.com/invite/eHvx8E9XF3) · 🐦 [X](https://x.com/openvikingai)
+- **交流**:<a href="https://docs.openviking.ai/zh/about/01-about-us#飞书群"><img src="docs/images/community/lark.svg" width="18" height="18" alt="飞书">&nbsp;飞书</a> · <a href="https://docs.openviking.ai/zh/about/01-about-us#微信群"><img src="docs/images/community/wechat.svg" width="18" height="18" alt="微信">&nbsp;微信</a> · <a href="https://discord.com/invite/eHvx8E9XF3"><img src="docs/images/community/discord.svg" width="18" height="18" alt="Discord">&nbsp;Discord</a> · <a href="https://x.com/openvikingai"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/community/x-dark.svg"><img src="docs/images/community/x.svg" width="16" height="16" alt="X"></picture>&nbsp;X</a>
- **贡献**:修 bug、加新功能都欢迎——见 [CONTRIBUTING_CN.md](CONTRIBUTING_CN.md)
<a href="https://github.com/volcengine/OpenViking/graphs/contributors">
diff --git a/README_JA.md b/README_JA.md
index ce4d7661b..c9c2fc0b6 100644
--- a/README_JA.md
+++ b/README_JA.md
@@ -12,16 +12,25 @@
<a href="https://www.openviking.ai">Webサイト</a> · <a href="https://openviking.ai/studio">ライブデモ</a> · <a href="https://github.com/volcengine/OpenViking">GitHub</a> · <a href="https://github.com/volcengine/OpenViking/issues">Issues</a> · <a href="https://docs.openviking.ai/">ドキュメント</a>
-[![](https://img.shields.io/github/v/release/volcengine/OpenViking?color=369eff\&labelColor=black\&logo=github\&style=flat-square)](https://github.com/volcengine/OpenViking/releases)
-[![](https://img.shields.io/github/stars/volcengine/OpenViking?labelColor\&style=flat-square\&color=ffcb47)](https://github.com/volcengine/OpenViking)
-[![](https://img.shields.io/github/issues/volcengine/OpenViking?labelColor=black\&style=flat-square\&color=ff80eb)](https://github.com/volcengine/OpenViking/issues)
-[![](https://img.shields.io/github/contributors/volcengine/OpenViking?color=c4f042\&labelColor=black\&style=flat-square)](https://github.com/volcengine/OpenViking/graphs/contributors)
-[![](https://img.shields.io/badge/license-AGPLv3-white?labelColor=black\&style=flat-square)](https://github.com/volcengine/OpenViking/blob/main/LICENSE)
-[![](https://img.shields.io/github/last-commit/volcengine/OpenViking?color=c4f042\&labelColor=black\&style=flat-square)](https://github.com/volcengine/OpenViking/commits/main)
-
-👋 コミュニティに参加しよう
-
-📱 <a href="https://docs.openviking.ai/en/about/01-about-us#lark-group">Larkグループ</a> · <a href="https://docs.openviking.ai/en/about/01-about-us#wechat-group">WeChat</a> · <a href="https://discord.com/invite/eHvx8E9XF3">Discord</a> · <a href="https://x.com/openvikingai">X</a>
+<p>
+ <a href="https://github.com/volcengine/OpenViking/releases"><img src="https://img.shields.io/github/v/release/volcengine/OpenViking?color=369eff&labelColor=black&logo=github&style=flat-square" alt="release"></a>
+ <a href="https://github.com/volcengine/OpenViking"><img src="https://img.shields.io/github/stars/volcengine/OpenViking?labelColor&style=flat-square&color=ffcb47" alt="stars"></a>
+ <a href="https://github.com/volcengine/OpenViking/issues"><img src="https://img.shields.io/github/issues/volcengine/OpenViking?labelColor=black&style=flat-square&color=ff80eb" alt="issues"></a>
+ <a href="https://github.com/volcengine/OpenViking/graphs/contributors"><img src="https://img.shields.io/github/contributors/volcengine/OpenViking?color=c4f042&labelColor=black&style=flat-square" alt="contributors"></a>
+ <a href="https://github.com/volcengine/OpenViking/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-AGPLv3-white?labelColor=black&style=flat-square" alt="license"></a>
+ <a href="https://github.com/volcengine/OpenViking/commits/main"><img src="https://img.shields.io/github/last-commit/volcengine/OpenViking?color=c4f042&labelColor=black&style=flat-square" alt="last commit"></a>
+</p>
+
+<p>
+ <a href="https://railway.com/deploy/openviking"><img src="https://railway.com/button.svg" alt="Deploy on Railway" height="30"></a>
+</p>
+
+<p>
+ <a href="https://docs.openviking.ai/en/about/01-about-us#lark-group"><img src="docs/images/community/lark.svg" width="18" height="18" alt="Lark">&nbsp;Lark</a> ·
+ <a href="https://docs.openviking.ai/en/about/01-about-us#wechat-group"><img src="docs/images/community/wechat.svg" width="18" height="18" alt="WeChat">&nbsp;WeChat</a> ·
+ <a href="https://discord.com/invite/eHvx8E9XF3"><img src="docs/images/community/discord.svg" width="18" height="18" alt="Discord">&nbsp;Discord</a> ·
+ <a href="https://x.com/openvikingai"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/community/x-dark.svg"><img src="docs/images/community/x.svg" width="16" height="16" alt="X"></picture>&nbsp;X</a>
+</p>
<a href="https://trendshift.io/repositories/19668" target="_blank"><img src="https://trendshift.io/api/badge/repositories/19668" alt="volcengine%2FOpenViking | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
@@ -31,9 +40,9 @@
## OpenVikingとは
-OpenVikingは、AIエージェントのためのオープンソースのコンテキストデータベースです。知識やユーザー情報を保存し、セッションをまたいで経験を再利用できます。
+OpenVikingは、AIエージェントのためのオープンソースのコンテキストデータベースです。知識・記憶・スキル——エージェントが知っているすべてを、一つのファイルシステムにまとめます。
-OpenViking はコンテキストを `viking://` 仮想ファイルシステムとして整理します。エージェントはファイルと同じように、`ls`、`tree`、`read`、`write` などでディレクトリの閲覧、内容の読み取り、作成、編集を行い、ディレクトリ内を検索できます。ディレクトリの要約により、必要に応じて内容を読み込めます。
+多くのエージェントメモリはブラックボックスです。テキストを入れると埋め込みが返ってきますが、何が保存されたのかは誰にも見えません。OpenVikingは、コンテキストを `viking://` という仮想ファイルシステムとして整理します。エージェントは `ls`、`tree`、`read`、`write`、`grep` でファイルのように操作し、人間もディレクトリを開いて中身を確認・編集できます。ディレクトリの要約はオンデマンドで読み込まれます。
<a href="https://openviking.ai/studio" target="_blank" rel="noopener noreferrer">
<picture>
@@ -46,10 +55,10 @@ OpenViking はコンテキストを `viking://` 仮想ファイルシステム
## OpenVikingを選ぶ理由
-- **ファイルシステムでコンテキストを整理。** リソースは文書やコード、メモリはユーザーの好みや経験、スキルはタスクの実行方法を保存します。それぞれに `viking://` URI があり、閲覧や検索に使えます。→ [Viking URI](https://docs.openviking.ai/en/concepts/04-viking-uri) · [Context types](https://docs.openviking.ai/en/concepts/02-context-types)
-- **必要なコンテキストを読み込む。** ディレクトリの要約(L0)と概要(L1)を使い、全文(L2)を読むか判断します。→ [Context layers](https://docs.openviking.ai/en/concepts/03-context-layers)
-- **ディレクトリ構造に沿って検索。** ベクトル検索で候補のディレクトリを見つけ、その内容を探索します。`find` はクエリを直接実行し、`search` はセッションのコンテキストを使って検索を計画できます。→ [Retrieval](https://docs.openviking.ai/en/concepts/07-retrieval)
-- **セッションからメモリを抽出。** コミットすると会話をアーカイブし、メモリポリシーに従ってバックグラウンドで抽出します。候補を既存のメモリと比較し、新規作成、統合、スキップを判断します。VikingBot を有効にすると、`ov compile` とスキルで資料を Wiki、知識グラフ、レポートに整理できます。→ [Session](https://docs.openviking.ai/en/concepts/08-session) · [Context compilation](https://docs.openviking.ai/en/context-compilation/01-overview)
+- **知識・記憶・スキルを一つのファイルシステムに。** リソースは文書やコード、メモリはユーザーの好みや経験、スキルはタスクの実行方法を保存します。抽出された事実だけでなく完全なコンテキストが、それぞれ `viking://` URI を持ち、閲覧・検索できます。→ [Viking URI](https://docs.openviking.ai/en/concepts/04-viking-uri) · [Context types](https://docs.openviking.ai/en/concepts/02-context-types)
+- **インデックス全体ではなく、ディレクトリを検索。** プロジェクトやメモリのサブツリーに意味検索の範囲を絞り、フラットなベクトルプールをスキャンしません。`find` はクエリを直接実行し、`search` はセッションのコンテキストから検索を計画します。→ [Retrieval](https://docs.openviking.ai/en/concepts/07-retrieval)
+- **全文の前に、まず要約を読む。** 自動生成されるディレクトリの要約(L0)と概要(L1)で関連性を判断してから、全文(L2)を開きます。→ [Context layers](https://docs.openviking.ai/en/concepts/03-context-layers)
+- **セッションは読めるファイルになる。** コミットすると会話をアーカイブし、メモリを確認・編集・統合できる Markdown として抽出します。VikingBot を有効にすると、`ov compile` で資料を Wiki、知識グラフ、レポートに整理できます。→ [Session](https://docs.openviking.ai/en/concepts/08-session) · [Context compilation](https://docs.openviking.ai/en/context-compilation/01-overview)
[Architecture](https://docs.openviking.ai/en/concepts/01-architecture) · [設計の背景](https://blog.openviking.ai/post/openviking-context-database/)
@@ -306,7 +315,7 @@ ov chat # 別のターミナルで実行
- **ドキュメント**: [docs.openviking.ai](https://docs.openviking.ai/) · [FAQ](https://docs.openviking.ai/en/faq/faq)
- **ブログ**: [blog.openviking.ai](https://blog.openviking.ai/)
- **チーム**: [About us](https://docs.openviking.ai/en/about/01-about-us)
-- **チャット**: 📱 [Larkグループ](https://docs.openviking.ai/en/about/01-about-us#lark-group) · 💬 [WeChat](https://docs.openviking.ai/en/about/01-about-us#wechat-group) · 🎮 [Discord](https://discord.com/invite/eHvx8E9XF3) · 🐦 [X](https://x.com/openvikingai)
+- **チャット**: <a href="https://docs.openviking.ai/en/about/01-about-us#lark-group"><img src="docs/images/community/lark.svg" width="18" height="18" alt="Lark">&nbsp;Lark</a> · <a href="https://docs.openviking.ai/en/about/01-about-us#wechat-group"><img src="docs/images/community/wechat.svg" width="18" height="18" alt="WeChat">&nbsp;WeChat</a> · <a href="https://discord.com/invite/eHvx8E9XF3"><img src="docs/images/community/discord.svg" width="18" height="18" alt="Discord">&nbsp;Discord</a> · <a href="https://x.com/openvikingai"><picture><source media="(prefers-color-scheme: dark)" srcset="docs/images/community/x-dark.svg"><img src="docs/images/community/x.svg" width="16" height="16" alt="X"></picture>&nbsp;X</a>
- **コントリビュート**: バグ修正も新機能も歓迎します — [CONTRIBUTING_JA.md](CONTRIBUTING_JA.md) を参照してください
<a href="https://github.com/volcengine/OpenViking/graphs/contributors">
diff --git a/docs/images/community/discord.svg b/docs/images/community/discord.svg
new file mode 100644
index 000000000..ae1a9eacd
--- /dev/null
+++ b/docs/images/community/discord.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" role="img"><title>Discord</title><path fill="#5865F2" d="M20.317 4.3698a19.7913 19.7913 0 00-4.8851-1.5152.0741.0741 0 00-.0785.0371c-.211.3753-.4447.8648-.6083 1.2495-1.8447-.2762-3.68-.2762-5.4868 0-.1636-.3933-.4058-.8742-.6177-1.2495a.077.077 0 00-.0785-.037 19.7363 19.7363 0 00-4.8852 1.515.0699.0699 0 00-.0321.0277C.5334 9.0458-.319 13.5799.0992 18.0578a.0824.0824 0 00.0312.0561c2.0528 1.5076 4.0413 2.4228 5.9929 3.0294a.0777.0777 0 00.0842-.0276c.4616-.6304.8731-1.2952 1.226-1.9942.021-.0416.0016-.0918-.0403-.1074-.6532-.2482-1.2743-.5485-1.8722-.8923a.077.077 0 01-.0076-.1277c.1258-.0943.2517-.1923.3718-.2914a.0743.0743 0 01.0776-.0105c3.9278 1.7933 8.18 1.7933 12.0614 0a.0739.0739 0 01.0785.0095c.1202.099.246.1981.3728.2924a.077.077 0 01-.0066.1276 12.2986 12.2986 0 01-1.873.8914.0766.0766 0 00-.0407.1067c.3604.7.7719 1.3628 1.225 1.9932a.076.076 0 00.0842.0286c1.961-.6067 3.9495-1.5219 6.0023-3.0294a.077.077 0 00.0313-.0552c.5004-5.177-.8382-9.6739-3.5485-13.6604a.061.061 0 00-.0312-.0286zM8.02 15.33c-1.1825 0-2.1569-1.0857-2.1569-2.419 0-1.3332.9555-2.4189 2.157-2.4189 1.2108 0 2.1757 1.0952 2.1568 2.419 0 1.3332-.9555 2.4189-2.1569 2.4189zm7.9748 0c-1.1825 0-2.1569-1.0857-2.1569-2.419 0-1.3332.9554-2.4189 2.1569-2.4189 1.2108 0 2.1757 1.0952 2.1568 2.419 0 1.3332-.946 2.4189-2.1568 2.4189Z"/></svg>
\ No newline at end of file
diff --git a/docs/images/community/lark.svg b/docs/images/community/lark.svg
new file mode 100644
index 000000000..0e0c2644a
--- /dev/null
+++ b/docs/images/community/lark.svg
@@ -0,0 +1,9 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="7.5 7.5 25.8 23" fill="none">
+ <g>
+ <path d="M21.0689 20.5036C21.0894 20.483 21.1114 20.4639 21.1319 20.4433C21.1744 20.4036 21.2155 20.3625 21.2566 20.3213L21.3416 20.2378L21.5978 19.9842L21.9459 19.6403L22.2446 19.3443L22.5255 19.0661L22.8188 18.777L23.0874 18.5111L23.4615 18.1411C23.5327 18.0713 23.6054 18.0027 23.6794 17.9356C23.815 17.8109 23.9548 17.6917 24.0987 17.5766C24.2302 17.4711 24.3659 17.3696 24.5029 17.271C24.6961 17.134 24.8962 17.0051 25.1004 16.8846C25.3005 16.7667 25.506 16.6557 25.717 16.5543C25.9144 16.4584 26.1172 16.3707 26.3227 16.2898C26.4378 16.2446 26.5529 16.2021 26.6708 16.1624C26.7297 16.1418 26.7886 16.1226 26.8476 16.1048C26.32 14.0274 25.3553 12.1254 24.0548 10.5015C23.8027 10.1836 23.4162 10 23.0079 10H12.2206C12.0247 10 11.9438 10.2494 12.1014 10.3645C15.7712 13.0545 18.8325 16.5228 21.0442 20.5269C21.0524 20.52 21.0606 20.5118 21.0689 20.5036Z" fill="#00D6B9"/>
+ <path d="M16.7907 30C22.3611 30 27.2134 26.9263 29.7458 22.3823C29.8349 22.2234 29.9212 22.0617 30.0034 21.8986C29.8746 22.1452 29.7335 22.3782 29.5786 22.5975C29.5238 22.6756 29.4676 22.7523 29.4087 22.8277C29.3361 22.9222 29.2607 23.0127 29.184 23.1017C29.1223 23.1716 29.0606 23.2401 28.9962 23.3073C28.8661 23.443 28.7304 23.5704 28.5892 23.691C28.5111 23.7581 28.4317 23.8225 28.3494 23.8856C28.2535 23.9582 28.1562 24.0281 28.0576 24.0952C27.9945 24.1377 27.9315 24.1788 27.8671 24.2172C27.7999 24.2583 27.7328 24.298 27.6629 24.3364C27.5231 24.4145 27.3806 24.4858 27.2354 24.5516C27.1093 24.6091 26.9805 24.6612 26.8503 24.7091C26.7091 24.7612 26.5653 24.8064 26.42 24.8475C26.2035 24.9078 25.9842 24.9544 25.7595 24.9901C25.5978 25.0147 25.4347 25.0339 25.2689 25.0449C25.0963 25.0572 24.9209 25.0613 24.7441 25.0586C24.5509 25.0558 24.3563 25.0435 24.159 25.0216C24.0151 25.0065 23.8698 24.9846 23.7259 24.9599C23.5999 24.938 23.4738 24.9106 23.3464 24.8804C23.2792 24.864 23.2134 24.8475 23.1463 24.8297C22.9599 24.779 22.7749 24.7283 22.5913 24.6749C22.4995 24.6488 22.4077 24.6214 22.3159 24.594C22.1788 24.5529 22.0418 24.5118 21.9061 24.4693C21.7951 24.4351 21.6828 24.3994 21.5718 24.3624C21.4663 24.3282 21.3607 24.2939 21.2552 24.2583C21.184 24.2336 21.1113 24.2103 21.0401 24.1857C20.9524 24.1555 20.8661 24.1254 20.7797 24.0952C20.7181 24.0733 20.655 24.0514 20.5934 24.0295C20.47 23.9856 20.3481 23.9404 20.2261 23.8952C20.1548 23.8691 20.085 23.8417 20.0137 23.8143C19.9192 23.7787 19.8246 23.7417 19.73 23.7047C19.63 23.6649 19.5313 23.6266 19.4313 23.5855C19.3669 23.5594 19.3025 23.5334 19.2381 23.506C19.1586 23.4731 19.0778 23.4402 18.9983 23.406C18.9366 23.3799 18.875 23.3539 18.8133 23.3278C18.7489 23.3004 18.6845 23.273 18.6214 23.2443C18.5666 23.2196 18.5104 23.1963 18.4556 23.1716C18.4049 23.1497 18.3542 23.1264 18.3035 23.1045C18.2528 23.0812 18.2008 23.0579 18.1501 23.0346C18.0966 23.0099 18.0445 22.9866 17.9911 22.962C17.9239 22.9304 17.8582 22.9003 17.791 22.8688C17.7211 22.8359 17.6513 22.803 17.5827 22.7701C17.5087 22.7345 17.4347 22.6989 17.3607 22.6619C17.2977 22.6303 17.2347 22.6002 17.1716 22.5687C13.8362 20.901 10.8763 18.6783 8.34943 15.9856C8.22336 15.8513 8 15.9404 8 16.124L8.00548 25.6437V26.4166C8.00548 26.8647 8.22748 27.2867 8.60021 27.5348C10.9462 29.0915 13.7622 30 16.7907 30Z" fill="#3370FF"/>
+ <path d="M29.7458 22.3823C29.7431 22.3864 29.7403 22.3905 29.739 22.3947L29.7458 22.3823L29.7965 22.2891C29.7787 22.3207 29.7622 22.3508 29.7458 22.3823Z" fill="#133C92"/>
+ <path d="M29.9774 21.9466L29.9911 21.9219L29.9979 21.9096C29.9911 21.9219 29.9842 21.9342 29.9774 21.9466Z" fill="#133C92"/>
+ <path d="M33.1511 16.5817C32.0219 16.0254 30.7516 15.7129 29.4073 15.7129C28.6084 15.7129 27.8356 15.8225 27.1038 16.0295C27.0189 16.0528 26.9353 16.0788 26.8517 16.1048C26.7928 16.124 26.7338 16.1432 26.6749 16.1624C26.5571 16.2021 26.4419 16.2446 26.3268 16.2898C26.1213 16.3707 25.9185 16.4584 25.7212 16.5543C25.5101 16.6557 25.3046 16.7667 25.1045 16.8846C24.899 17.0051 24.7003 17.134 24.507 17.271C24.3686 17.3683 24.2343 17.4711 24.1028 17.5766C23.9589 17.6917 23.8191 17.8123 23.6835 17.9356C23.6095 18.0027 23.5368 18.0713 23.4656 18.1411L23.0915 18.5111L22.8229 18.777L22.5296 19.0661L22.2487 19.3443L21.95 19.6403L21.6019 19.9842L21.3457 20.2378L21.2607 20.3213C21.2196 20.3625 21.1771 20.4022 21.136 20.4433C21.1155 20.4639 21.0935 20.483 21.073 20.5036C21.0415 20.5337 21.0099 20.5639 20.9784 20.594C20.9428 20.6269 20.9085 20.6598 20.8729 20.6927C19.9493 21.5409 18.9174 22.2741 17.8006 22.8674C17.8664 22.8989 17.9336 22.9305 18.0007 22.9606C18.0528 22.9853 18.1062 23.0099 18.1597 23.0332C18.2104 23.0565 18.2624 23.0798 18.3131 23.1031C18.3638 23.1264 18.4145 23.1483 18.4652 23.1703C18.5201 23.1949 18.5762 23.2196 18.6311 23.2429C18.6955 23.2703 18.7585 23.2991 18.8229 23.3265C18.8846 23.3525 18.9462 23.3786 19.0079 23.4046C19.0874 23.4388 19.1682 23.4717 19.2477 23.5046C19.3121 23.5307 19.3765 23.5567 19.4409 23.5841C19.5396 23.6238 19.6396 23.6636 19.7396 23.7033C19.8342 23.7403 19.9288 23.7773 20.0233 23.813C20.0946 23.8404 20.1645 23.8664 20.2357 23.8938C20.3577 23.939 20.4796 23.9842 20.603 24.0281C20.6646 24.05 20.7263 24.0719 20.7893 24.0939C20.8757 24.124 20.9634 24.1542 21.0497 24.1843C21.1209 24.209 21.1936 24.2336 21.2648 24.2569C21.3703 24.2926 21.4759 24.3268 21.5814 24.3611C21.6924 24.3967 21.8034 24.4323 21.9157 24.468C22.0514 24.5104 22.1884 24.5516 22.3255 24.5927C22.4173 24.6201 22.5091 24.6475 22.6009 24.6735C22.7845 24.727 22.9695 24.779 23.1559 24.8284C23.223 24.8462 23.2888 24.864 23.356 24.8791C23.4834 24.9092 23.6095 24.9353 23.7355 24.9585C23.8808 24.9846 24.0247 25.0051 24.1686 25.0202C24.3645 25.0421 24.5605 25.0545 24.7537 25.0572C24.9305 25.06 25.1045 25.0558 25.2785 25.0435C25.4443 25.0312 25.6074 25.0134 25.7691 24.9887C25.9938 24.9544 26.2131 24.9065 26.4296 24.8462C26.5749 24.8064 26.7188 24.7599 26.8599 24.7078C26.9901 24.6598 27.1189 24.6077 27.245 24.5502C27.3902 24.4844 27.5327 24.4132 27.6725 24.335C27.741 24.2967 27.8095 24.2569 27.8767 24.2158C27.9411 24.1761 28.0041 24.135 28.0672 24.0939C28.1658 24.0267 28.2631 23.9568 28.359 23.8842C28.4399 23.8212 28.5207 23.7568 28.5988 23.6896C28.74 23.569 28.8757 23.4402 29.0058 23.3059C29.0702 23.2388 29.1319 23.1716 29.1936 23.1004C29.2703 23.0113 29.3457 22.9209 29.4183 22.8263C29.4759 22.7509 29.5334 22.6742 29.5882 22.5961C29.7417 22.3782 29.8815 22.1466 30.0089 21.9027L30.1528 21.6149L31.4574 19.0154L31.4546 19.0209C31.8644 18.1055 32.444 17.2806 33.1511 16.5817Z" fill="#133C9A"/>
+ </g>
+</svg>
diff --git a/docs/images/community/wechat.svg b/docs/images/community/wechat.svg
new file mode 100644
index 000000000..88224f135
--- /dev/null
+++ b/docs/images/community/wechat.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" role="img"><title>WeChat</title><path fill="#07C160" d="M8.691 2.188C3.891 2.188 0 5.476 0 9.53c0 2.212 1.17 4.203 3.002 5.55a.59.59 0 0 1 .213.665l-.39 1.48c-.019.07-.048.141-.048.213 0 .163.13.295.294.295a.345.345 0 0 0 .163-.044l1.916-.972a.76.76 0 0 1 .374-.108c.113 0 .227.025.334.074.882.35 1.83.541 2.833.541.25 0 .493-.013.738-.035a5.53 5.53 0 0 1-.22-1.54c0-3.376 3.208-6.113 7.168-6.113.275 0 .546.015.814.043C16.273 5.342 12.81 2.188 8.691 2.188zM5.77 6.386c.639 0 1.157.518 1.157 1.157 0 .64-.518 1.157-1.157 1.157-.64 0-1.157-.517-1.157-1.157 0-.639.517-1.157 1.157-1.157zm5.843 0c.639 0 1.157.518 1.157 1.157 0 .64-.518 1.157-1.157 1.157-.64 0-1.157-.517-1.157-1.157 0-.639.518-1.157 1.157-1.157zm4.385 4.385c-3.418 0-6.188 2.37-6.188 5.293 0 1.608.835 3.05 2.135 4.032.115.087.185.22.185.362 0 .052-.01.104-.029.155l-.316 1.196a.258.258 0 0 0-.022.096c0 .13.104.236.235.236.05 0 .099-.016.14-.047l1.545-.783a.607.607 0 0 1 .3-.087c.09 0 .181.02.266.06 1.004.47 2.136.732 3.328.732 3.418 0 6.188-2.37 6.188-5.293 0-2.923-2.77-5.293-6.188-5.293zm-2.32 2.94a.928.928 0 1 1 0 1.856.928.928 0 0 1 0-1.856zm4.641 0a.928.928 0 1 1 0 1.856.928.928 0 0 1 0-1.856z"/></svg>
\ No newline at end of file
diff --git a/docs/images/community/x-dark.svg b/docs/images/community/x-dark.svg
new file mode 100644
index 000000000..64b17215d
--- /dev/null
+++ b/docs/images/community/x-dark.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" role="img"><title>X</title><path fill="#FFFFFF" d="M18.901 1.153h3.68l-8.04 9.19L24 22.846h-7.406l-5.8-7.584-6.638 7.584H.474l8.6-9.83L0 1.154h7.594l5.243 6.932ZM17.61 20.644h2.039L6.486 3.24H4.298Z"/></svg>
\ No newline at end of file
diff --git a/docs/images/community/x.svg b/docs/images/community/x.svg
new file mode 100644
index 000000000..f6ddd36d8
--- /dev/null
+++ b/docs/images/community/x.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" role="img"><title>X</title><path fill="#000000" d="M18.901 1.153h3.68l-8.04 9.19L24 22.846h-7.406l-5.8-7.584-6.638 7.584H.474l8.6-9.83L0 1.154h7.594l5.243 6.932ZM17.61 20.644h2.039L6.486 3.24H4.298Z"/></svg>
\ No newline at end of file