# Agent NAS

> Agent NAS 是围绕“一次运行”设计的网络附加存储：智能体的每次运行都在隔离的分支里工作，凭一张短时、窄域的租约访问数据；每个改动都能追溯、能撤销；记忆是带来源的普通文件。对外，它说智能体早已会说的话：文件、Git、S3 和 MCP。

状态：概念与规范草案 v0.2，2026 年 11 月。尚无参考实现。 每个页面都另有 Markdown 版本：在页面网址后加上 `index.md`，或发送 `Accept: text/markdown`。下列链接均指向 Markdown 版本。 内容采用 CC BY 4.0 许可。

## 从这里开始

- [什么是 Agent NAS？](https://agentnas.com/zh-cn/what-is-agent-nas/index.md): Agent NAS 是围绕智能体“一次运行”设计的网络附加存储。本页给出它的定义、构成 Agent NAS 的六个条件、它不是什么，以及谁不需要它。
- [九个概念](https://agentnas.com/zh-cn/concepts/index.md): Agent NAS 提出九个命名概念，分为工作、权限与知识三簇。每个概念都有定义、机制、从小处开始的做法、接口草图和坦诚的局限。
- [架构](https://agentnas.com/zh-cn/architecture/index.md): Agent NAS 的架构：Interface、Trust、Memory、Store 四层加可选的 Sync，建立在六个名词之上；说明存储契约、一次运行的旅程与部署形态。
- [接口](https://agentnas.com/zh-cn/interfaces/index.md): Agent NAS 的数据面用挂载、Git 与 S3，控制面用 MCP、HTTP 与 CLI；面向智能体的 MCP 工具只有九个，HTTP 接口全部为 POST。
- [规范](https://agentnas.com/zh-cn/spec/index.md): Agent NAS 规范草案 v0.2：规范的组成、L0 到 L4 五个符合性等级及其可执行的验收测试、conformance.json 声明格式与版本策略。

## 九个概念

- [Agent Home (智能体之家)](https://agentnas.com/zh-cn/concepts/agent-home/index.md): 按角色划分、带历史的目录，全是普通文件，可以带走。
- [Agent Branch (智能体分支)](https://agentnas.com/zh-cn/concepts/agent-branch/index.md): 每次运行在写时复制的分支里工作，经审阅的合并才进入主线。
- [Flight Recorder (飞行记录仪)](https://agentnas.com/zh-cn/concepts/flight-recorder/index.md): 以运行为单位、哈希链接的记录，包括这次运行读过什么。
- [Capability Lease (能力租约)](https://agentnas.com/zh-cn/concepts/capability-lease/index.md): 发给一次运行的、有期限与预算的窄域授权；子租约只能更窄。
- [Human Gate (人类闸门)](https://agentnas.com/zh-cn/concepts/human-gate/index.md): 只在不可逆、对外或提权的动作之前出现，展示真实的差异。
- [Trust Labels (信任标签)](https://agentnas.com/zh-cn/concepts/trust-labels/index.md): 来源与敏感度两个小标签，加上会话污点，强制执行 Rule of Two。
- [Agent Memory (智能体记忆)](https://agentnas.com/zh-cn/concepts/agent-memory/index.md): 笔记是你能读能改的真相，索引只是可以丢弃的缓存。
- [Budgeted Reads (预算化读取)](https://agentnas.com/zh-cn/concepts/budgeted-reads/index.md): 同一个文件可以用轮廓、章节、行范围或全文来读，按预算降级。
- [Cascade Forget (级联遗忘)](https://agentnas.com/zh-cn/concepts/cascade-forget/index.md): 沿血缘删除派生物，按保留类处理历史，并如实报告做不到的部分。

## 参考

- [安全](https://agentnas.com/zh-cn/security/index.md): Agent NAS 的安全模型：保护什么、不保护什么，Rule of Two 如何在存储边界强制执行，十类威胁与控制措施，以及坦诚的局限。
- [用例](https://agentnas.com/zh-cn/use-cases/index.md): Agent NAS 的典型用例：夜间运行的智能体、换框架不丢记忆、多智能体共享记忆、事故复盘、遗忘请求，以及什么时候不该用它。
- [比较](https://agentnas.com/zh-cn/compare/index.md): Agent NAS 与 NAS 厂商智能体、智能体文件系统、可分叉存储、记忆框架和沙箱的关系：互补之处、借鉴了什么，以及真正新的只有五点。
- [路线图](https://agentnas.com/zh-cn/roadmap/index.md): Agent NAS 路线图：现在发布概念、规范草案与官网并收集反馈；下一步做 Lite 与 Overlay 的参考实现；以及以后做什么、明确不做什么。
- [设计原则](https://agentnas.com/zh-cn/principles/index.md): Agent NAS 的八个设计论点，以及它押注的七件事：每个赌注的依据、押错时设计怎样退化，哪些预期保持稳定，哪些预期会变。
- [常见问题](https://agentnas.com/zh-cn/faq/index.md): 关于 Agent NAS 的常见问题：它是什么，与 NAS 厂商的智能体有何不同，如何应对提示词注入和遗忘，什么时候不该用它，以及目前的进展。
- [术语表](https://agentnas.com/zh-cn/glossary/index.md): Agent NAS 术语表：九个概念与配套词汇的定义，涵盖主体、运行、读清单、证据指针、会话污点、保留类和加密粉碎等，每条都可单独引用。
- [关于](https://agentnas.com/zh-cn/about/index.md): Agent NAS 项目简介：状态、许可、治理，如何引用与参与，以及为智能体和爬虫发布的机器可读资源（llms.txt、MCP、OpenAPI）。

## 机器接口

- [MCP](https://agentnas.com/mcp/server-card): 只读 MCP 服务器卡片（Streamable HTTP 端点：https://agentnas.com/mcp）。工具：search_docs、get_page、list_pages、get_briefing。
- [OpenAPI](https://agentnas.com/openapi.json): POST /api/search 的 OpenAPI 描述（JSON 进，JSON 出）。
- [llms-full.txt](https://agentnas.com/zh-cn/llms-full.txt): 完整文档合并为一个 Markdown 文件。
- [sitemap.xml](https://agentnas.com/sitemap.xml): 所有语言的全部页面，含 hreflang 备用链接。

## Optional

- [English](https://agentnas.com/llms.txt)
- [繁體中文](https://agentnas.com/zh-tw/llms.txt)
- [日本語](https://agentnas.com/ja/llms.txt)
- [한국어](https://agentnas.com/ko/llms.txt)
- [Español](https://agentnas.com/es/llms.txt)
- [Français](https://agentnas.com/fr/llms.txt)
- [Deutsch](https://agentnas.com/de/llms.txt)
- [GitHub](https://github.com/xwzy/agentnas.com)