# 常见问题

> 回答人们对 Agent NAS 最先会问的问题：它是什么，与现有的存储和记忆工具有何不同，如何处理安全与隐私，以及项目进展到哪里。

## 基础问题

### Agent NAS 是什么？

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

### Agent NAS 是可以购买或下载的产品吗？

还不是。它目前是一个带规范草案的概念（v0.2，2026 年 11 月）。L0 与 L1 可以用现成零件今天搭出来；参考实现 v0 的目标是 2027 年上半年，之后的安排见[路线图](https://agentnas.com/zh-cn/roadmap/)。

### 它和 NAS 厂商推出的 AI 智能体有什么不同？

QNAP、Synology 和 TrueNAS 等厂商推出的智能体，用来管理这台盒子。Agent NAS 规定的是别的智能体怎样在盒子里的数据上工作：分支、租约、记忆与遗忘。两者互补，参见[比较](https://agentnas.com/zh-cn/compare/)。

### 它和向量数据库或记忆框架有什么不同？

它们是检索与整合的工具，而 Agent NAS 的真相是带来源的普通笔记。向量库和记忆框架可以作为索引器挂在 [Agent Memory](https://agentnas.com/zh-cn/concepts/agent-memory/) 之下，索引随时可以丢弃重建。

### 它是开源的吗？

规范和本站内容采用 CC BY 4.0 许可。参考实现计划以 Apache-2.0 开源。

## 设计与安全

### 为什么用文件和 Git，而不是数据库？

智能体正在向文件收敛：指令在 `AGENTS.md` 里，技能在 `SKILL.md` 里，记忆是 Markdown，历史在 Git 里。文件任何工具、任何模型都能读，容易对比，也容易带走。数据库和索引仍然会用，但它们是可以重建的派生层。

### 一次运行出了错，最坏会怎样？

最坏的情况是丢掉一个可丢弃的分支：受保护的主线只能经审阅的合并更新，删除是软删除，快照不在任何租约之内。前提是错误发生在 NAS 之内；已经发出的邮件和已经调用的外部接口，NAS 无法撤销。

### 租约和 OAuth 令牌是什么关系？

租约就是一枚 OAuth 访问令牌：靠令牌交换（RFC 8693）申请，用富授权请求（RFC 9396）描述路径与动作。Agent NAS 补上的是以运行为单位的约定，包括分支、预算与 Rule of Two 属性。详见 [Capability Lease](https://agentnas.com/zh-cn/concepts/capability-lease/)。

### 为什么说记忆是“笔记加缓存”？

这样它才能被检视、更正、迁移和遗忘。笔记是文件；索引、嵌入和摘要都由它们按记录在案的配方计算而来。换嵌入模型，系统就在后台重算。受污染会话写的笔记先进入隔离区，在审阅之前不会自动加载。

### Agent NAS 能阻止提示词注入吗？

不能。模型之外的任何东西都无法完全阻止它。Agent NAS 限制的是被注入的智能体能做什么：[Trust Labels](https://agentnas.com/zh-cn/concepts/trust-labels/) 让读过外部内容的会话，无法再同时拥有敏感数据与对外通道，有后果的动作需要 [Human Gate](https://agentnas.com/zh-cn/concepts/human-gate/)。坦诚的局限见[安全](https://agentnas.com/zh-cn/security/)。

### 它如何处理“被遗忘权”？

通过 [Cascade Forget](https://agentnas.com/zh-cn/concepts/cascade-forget/)：沿血缘删除由来源派生的摘要、嵌入与笔记，按保留类处理历史，并对 `sensitive` 类销毁密钥（加密粉碎）。它出具的报告会明确列出覆盖不到的范围：NAS 之外的副本、模型提供商的日志、模型权重。它无法让模型忘记任何东西。

### 我必须使用 MCP 吗？

不必。MCP 只是控制面的接口之一，文件、Git 和 S3 不需要它；协议层本来就设计为可以替换。

## 采用与未来

### 它会取代我现有的 NAS 或云存储吗？

不会。Overlay 部署形态在现有的 NAS、对象存储或 Git 托管之前放一个网关，只管理其中的一个目录或桶。云存储也可以充当 Store。

### 哪些智能体框架和运行时可以配合使用？

任何能挂载目录，或者会用 Git、S3 或 MCP 的运行时。Agent Home 的布局遵循开放约定（`AGENTS.md`、Agent Skills、带 YAML frontmatter 的 Markdown），所以 Claude Code、Cursor、Codex、OpenHands、LangGraph 以及自研的框架都是候选。

### 我可以随时离开吗？

随时可以。所有内容都能导出为普通文件和 Git 历史。这是四个承诺之一，而不是一个功能。

### 什么时候不该用 Agent NAS？

只有一个智能体、数据可以随意重来的时候：一个 Git 仓库加 `AGENTS.md` 就够了。更多情形见[用例](https://agentnas.com/zh-cn/use-cases/)。

### 我怎样引用或参与贡献？

每个页面都列出了规范网址和建议的引用格式。要参与贡献，请在 GitHub 上提交 issue 或发起讨论。详情见[关于页面](https://agentnas.com/zh-cn/about/)。

---

规范网址: https://agentnas.com/zh-cn/faq/
更新于: 2026-11-11 · 规范草案 v0.2 · CC BY 4.0