---
title: "NoKV"
created: 2026-07-04
updated: 2026-07-04
type: concept
tags: [agent, workspace, filesystem, metadata, infrastructure]
sources: ["https://nokv.io/blog/agents-want-filesystems"]
---

# NoKV

面向 AI Agent workspace 的元数据控制层，把实验 run、日志、checkpoint、artifact 等工作结果放进一个文件系统形态的命名空间，让 Agent 可以用 `ls`/`grep`/`read` 去找线索、看证据、引用行号。

## 定位

- 列入 **CNCF Cloud Native Landscape**（AI Native Infra / Storage 分区）
- 早期 Go 原生存储引擎被 **CMU dbdb.io** 收录（历史条目）
- 当前主线：Rust 实现的 Agent workspace 文件系统产品线

## 接口形态

`nokv_native_v1` 提供类 POSIX 语义：
- `ls`：目录列举 → run 是目录，日志是文件
- `stat`：对象元数据卡片
- `catalog`：发现可查询字段
- `find`：过滤、排序、limit、字段投影下推
- `aggregate`：聚合查询
- `read`：按需读取内容
- `grep`：递归搜索，返回带行号的证据

## 核心理念

不是「文件系统替代数据库」，而是在数据库/对象存储之上加一层 **Agent-friendly 元数据控制层**——把复杂性留在系统里，把清晰、局部、可引用的操作面交给 Agent。

## 参考

- [[agent-workspace-filesystem|Agent 工作空间文件系统]]
- [[agents-want-filesystems-nokv-2026|新智元报道]]
- [[progressive-disclosure|渐进式披露]]
- [[pushdown-in-agent-interface|Agent 接口下推]]
