常见问题

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

v0.2 规范草案 更新于

基础问题

Agent NAS 是什么?

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

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

还不是。它目前是一个带规范草案的概念(v0.2,2026 年 11 月)。L0 与 L1 可以用现成零件今天搭出来;参考实现 v0 的目标是 2027 年上半年,之后的安排见路线图。

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

QNAP、Synology 和 TrueNAS 等厂商推出的智能体,用来管理这台盒子。Agent NAS 规定的是别的智能体怎样在盒子里的数据上工作:分支、租约、记忆与遗忘。两者互补,参见比较。

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

它们是检索与整合的工具,而 Agent NAS 的真相是带来源的普通笔记。向量库和记忆框架可以作为索引器挂在 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。

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

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

Agent NAS 能阻止提示词注入吗?

不能。模型之外的任何东西都无法完全阻止它。Agent NAS 限制的是被注入的智能体能做什么:Trust Labels 让读过外部内容的会话,无法再同时拥有敏感数据与对外通道,有后果的动作需要 Human Gate。坦诚的局限见安全。

它如何处理“被遗忘权”?

通过 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 就够了。更多情形见用例。

我怎样引用或参与贡献?

每个页面都列出了规范网址和建议的引用格式。要参与贡献,请在 GitHub 上提交 issue 或发起讨论。详情见关于页面。

引用本页

为读者、搜索引擎和智能体提供稳定的网址与建议的引用格式。

建议引用格式
Agent NAS project. “常见问题.” agentnas.com, 2026-11-11. https://agentnas.com/zh-cn/faq/