前端

Memory 系统让 Agent 能够长期协作，但它也是最容易失控的模块之一。没有记忆，Agent 每次都像新手；记忆太多，Agent 会被噪音干扰，甚至带来隐私风险。

构建可控 Memory 系统的关键，是明确什么该记、什么时候记、如何检索、如何更新、如何删除。

## 记忆类型

Agent 的记忆可以分为几类。

任务记忆保存当前任务状态，例如已完成步骤、资源 ID、错误原因。

偏好记忆保存用户长期偏好，例如文章不要一级标题、每篇标签不超过 3 个。

知识记忆保存项目背景，例如某个系统的 API 约定、业务规则、部署方式。

经验记忆保存执行过程中发现的问题，例如某个 CLI 创建文章必须先创建 draftId。

不同记忆类型不应该混在一起，因为它们的生命周期和使用场景不同。

## 写入策略

Memory 不应该自动保存所有内容。写入条件可以包括：用户明确要求、偏好重复出现、任务结束后生成摘要、关键经验经过确认。

对于敏感信息，例如 token、密码、个人信息，默认不进入长期记忆。确实需要保存时，也要脱敏、加密、设置过期时间。

## 读取策略

读取记忆时要根据当前任务检索相关内容。写文章时读取内容风格偏好，操作系统时读取工具使用经验，排障时读取历史错误记录。

向量检索适合从大量记忆中找相似内容，但结果仍需要过滤。不是所有相似记忆都应该进入上下文。

## 记忆压缩

长期任务会产生很多细节。保存完整对话通常不划算，更好的方式是保存摘要和决策。

例如一次排障可以压缩成：“treasure article create 需要先创建 draftId，否则后端会报错。”这条经验比保存整段对话更有用。

## 用户控制

可控 Memory 必须让用户可查看、可修改、可删除。用户说“忘掉这个偏好”时，系统必须真正删除，而不是后续继续使用。

这不仅是体验问题，也是隐私和合规问题。

## 小结

Memory 的目标不是无限记忆，而是保留对未来任务有价值的信息。好的 Memory 系统应该分类清晰、写入克制、检索精准、可被用户控制。

## 实战案例：保存用户内容偏好

在内容管理 Agent 中，用户可能反复提出偏好：正文不要一级标题、教程内容控制在 1500 到 2000 字符、每篇文章最多 3 个标签、搜索图片必须上传到自有素材系统。

这些信息如果只存在当前对话中，下一次任务就可能丢失。可以把它们写入偏好记忆，并标注适用范围：内容创作、Treasure 平台、教程文章。后续创建文章时，Agent 先检索这些偏好，再生成内容和执行命令。

但偏好记忆也要允许覆盖。用户这次要求 1500 到 2000 字符，并不代表所有内容都必须如此。因此记忆最好带有来源、时间和作用域，而不是变成全局不可变规则。

## 记忆更新与冲突处理

记忆不是只新增不修改。用户偏好可能变化，项目规则也可能更新。比如最初要求文章 1500 到 2000 字符，后续可能要求更短的摘要版。Memory 系统需要能识别新旧规则冲突，并优先使用最近、作用域更精确、用户明确确认过的规则。

一种可行做法是为每条记忆保存 metadata，包括来源对话、创建时间、适用范围、置信度和是否用户确认。检索到多条冲突记忆时，Agent 不应该随意选择，而应按规则排序，必要时向用户澄清。

## 删除与遗忘机制

可控 Memory 还需要“遗忘”能力。用户可能要求删除某条偏好，也可能要求清理某个项目的历史上下文。系统应支持按用户、项目、记忆类型和时间范围删除。删除后，Agent 不应继续在后续任务中使用这条记忆。

对于企业系统，遗忘机制还涉及合规要求。比如用户离职、项目归档、敏感数据过期，都可能要求清理相关长期记忆。因此 Memory 系统最好从一开始就把删除和审计纳入设计。

从记忆写入、检索、压缩、过期、用户可见性和隐私删除角度，构建可控的 Agent Memory 系统。

AI Agent 实战教程 15：构建可控的 Memory 系统

Memory 是 AI Agent 能够连续工作的基础。没有记忆，Agent 每次都像第一次见到用户；有了记忆，Agent 才能理解历史、延续任务、保留偏好，并在长期协作中变得更有上下文。

但记忆也是一把双刃剑。保存太少，Agent 不够智能；保存太多，系统会变得混乱，还可能带来隐私和安全风险。因此，Memory 设计的重点不是“尽可能多地记住”，而是“在合适的时候记住合适的信息”。

## 短期记忆

短期记忆通常就是当前对话上下文。它帮助 Agent 理解最近发生了什么。

例如用户刚刚说“把这 10 篇文章整理成教程”，后续又说“绑定到刚才那个模块”，Agent 需要知道“刚才那个模块”指什么。

短期记忆适合保存：

- 当前任务目标；
- 最近对话；
- 工具调用结果；
- 用户刚给出的约束；
- 临时中间产物。

短期记忆的问题是上下文窗口有限。任务越长，历史越多，模型越难关注关键内容。因此长任务需要状态摘要，而不是无限保留所有对话。

## 长期记忆

长期记忆保存跨会话信息，例如用户偏好、项目背景、常用工具、历史决策。

比如用户经常要求“每篇文章标签不要超过 3 个”，这个偏好就可以进入长期记忆。以后创建文章时，Agent 就能自动遵守这个规则。

长期记忆适合保存稳定信息，不适合保存临时情绪、一次性指令或未经确认的敏感数据。

## 向量记忆

向量记忆通常使用 Embedding 和 Vector Database。系统把历史信息转成向量，之后根据当前任务检索相关记忆。

它适合保存大量非结构化内容，例如：

- 历史对话摘要；
- 会议纪要；
- 项目文档；
- 用户反馈；
- 操作经验。

当用户提出新任务时，系统检索相关记忆，把结果放入上下文，帮助 Agent 做出更符合历史背景的判断。

## 记忆写入策略

最容易出问题的是“什么时候写入记忆”。如果每句话都写入，记忆库会很快充满噪音。如果完全不写，Agent 又无法持续学习。

常见策略包括：

- 用户明确说“记住”；
- 系统识别到稳定偏好；
- 任务完成后生成摘要；
- 用户确认后写入长期记忆；
- 对重复出现的信息提升权重。

对于重要记忆，最好让用户可见、可编辑、可删除。

## 记忆读取策略

读取记忆也需要控制。不是每次都读取所有记忆，而是根据当前任务检索相关内容。

例如写 AI Agent 教程时，应该检索用户对文章风格、标签数量、图片来源的偏好，而不需要读取无关的历史任务。

好的读取策略应该考虑相关性、时效性、权限和信息密度。

## 隐私与安全

Memory 可能包含敏感信息，因此必须设计安全边界。

需要考虑：

- 用户是否知道系统记住了什么；
- 用户能否删除记忆；
- 敏感数据是否脱敏；
- 不同用户之间是否隔离；
- Agent 是否会把记忆泄露给不该看到的人；
- 长期记忆是否有过期机制。

没有这些设计，Memory 会从能力变成风险。

## 小结

Memory 让 Agent 更连续、更个性化，也更像一个长期协作伙伴。但记忆系统必须可控、可解释、可清理。真正可靠的 Agent 不会什么都记，而是知道什么值得记、什么时候用、什么时候忘。

了解 Agent 的短期记忆、长期记忆、向量记忆和用户画像，以及记忆系统的风险。

AI Agent 实战教程 06：Memory 记忆机制设计

Git是一个由林纳斯·托瓦兹为了更好地管理linux内核开发而创立的分布式版本控制／软件配置管理软件。需要注意的是和GNU Interactive Tools，一个类似Norton Commander界面的文件管理器相区分。



C 语言，是一种通用的、过程式的编程语言，广泛用于系统与应用软件的开发。具有高效、灵活、功能丰富、表达力强和较高的移植性等特点，在程序员中备受青睐。

C 语言是由 UNIX 的研制者丹尼斯·里奇（Dennis Ritchie）和肯·汤普逊（Ken Thompson）于 1970 年研制出的B语言的基础上发展和完善起来的。目前，C 语言编译器普遍存在于各种不同的操作系统中，例如 UNIX、MS-D

C语言

C++ 是一种通用的、静态类型的编程语言，它具有高效性、灵活性和可移植性等特点。C++ 基于 C 语言，同时支持面向对象编程和泛型编程，可以用于开发各种类型的应用程序，如系统软件、游戏、桌面应用程序、移动应用程序等。

C++ 的主要特点包括：

高效性：C++ 是一种编译型语言，可以生成高效的本地代码，在性能要求高的应用程序中得到广泛应用；
面向对象编程：C++ 支持面向对象编程，包括封装、继承

React 是一个由 Facebook 开发的流行的 JavaScript 库，用于构建交互式用户界面。它采用了一种基于组件化的开发模式，使得开发人员可以将 UI 拆分为独立的、可复用的组件，并由这些组件构建复杂的用户界面。

React 的主要特点包括：

组件化开发：React 将 UI 拆分为独立的、可复用的组件，开发人员可以将这些组件组合在一起构建复杂的用户界面；
虚拟 DOM：React

React

Web前端开发是从网页制作演变而来的，名称上有很明显的时代特征。在互联网的演化进程中，网页制作是Web 1.0时代的产物，那时网站的主要内容都是静态的，用户使用网站的行为也以浏览为主。2005年以后，互联网进入Web 2.0时代，各种类似桌面软件的Web应用大量涌现，网站的前端由此发生了翻天覆地的变化。网页不再只是承载单一的文字和图片，各种富媒体让网页的内容更加生动，网页上软件化的交互形式为用户提

JavaScript 是一种基于脚本的编程语言，主要用于在 Web 页面上实现交互式的效果和动态的内容。JavaScript 是一种解释性语言，不需要编译就可以直接在浏览器中运行。

JavaScript 的主要特点包括：

轻量级：JavaScript 代码通常比较短小，可以快速加载和执行。

可移植性：JavaScript 可以在各种不同的浏览器和操作系统上运行。

面向对象编程：JavaSc

JavaScript

Cypress 是一个前端自动化测试工具，用于测试基于Web的应用程序。它能够测试运行在浏览器中的应用，并且适用于单元测试、集成测试和端到端（E2E）测试。Cypress 提供了一个丰富的API集，以及一个友好的交互式界面，让开发和测试人员能够轻松编写、运行和调试测试用例。

Cypress

ORM（Object-Relational Mapping，对象关系映射）是编程中的一个概念，它指的是一种技术手段，可以将不兼容的类型系统转换为面向对象模型。换句话说，ORM 允许开发者在编程语言中使用对象的方式来操作数据库中的数据。

Linux 是一个广泛使用的开源操作系统内核，由林纳斯·托瓦兹（Linus Torvalds）于1991年创建。它是 Unix-like 操作系统的一个重要分支，并且它的设计和实现遵循了模块化的设计原则。Linux 内核本身可以与不同的用户空间组件配合，形成完整的操作系统。这些完整的系统被称为 Linux 发行版，例如 Ubuntu、Fedora、Debian、CentOS 和 Arch Linu

Linux

Vue.js（简称 Vue）是一种开源的轻量级 JavaScript 框架，由 Evan You 于2014年首次发布。Vue 致力于在用户界面（UI）开发中实现数据与视图的双向绑定，为创建现代化 Web 应用、单页面应用（SPA）以及多种复杂界面提供了一种简洁、高效且可扩展的解决方案。

#### 核心特性

- **组件化：** Vue 包含了独立的、可复用的组件，有助于将 UI 切成逻辑部分

Docker 是一个开源的容器化平台，允许开发者打包应用及其全部依赖到一个可移植的容器中，然后这个容器可以在任何机器上运行，确保应用在不同环境之间运行的一致性。Docker 使用了 Linux 容器（LXC）的技术，但进行了扩展，使其更为易用、功能更全面。

Docker

Rust是一种系统编程语言，由Mozilla Research开发。它是一种安全、并发和高效的语言，旨在为开发人员提供更好的内存安全和线程安全，同时保持高性能和可扩展性。

Rust的设计具有以下特点：

内存安全：Rust在编译时执行内存安全检查，防止常见的内存错误，例如使用空指针或释放不再使用的内存。

并发性：Rust具有一种称为"无等待"（lock-free）的并发模型，它可以确保线程安全

Rust

MySQL 是一款流行的关系型数据库管理系统（RDBMS）。它负责存储、检索和管理结构化数据，尤其是以表格形式存储的数据。MySQL 使用 SQL（Structured Query Language，结构化查询语言）作为查询和操作数据的接口，并遵循许多 SQL 标准。它是一种兼具性能、可靠性和易用性的数据库系统，适用于各种应用场景，从个人项目到大型企业应用。

MySQL

JavaScript 的升级版 TypeScript 已日益成为开发世界全新的演变里程碑。立足于 JavaScript 的优雅灵活与 TypeScript 的强类型体系，本教程旨在助您铸就极致的开发力量。

我们的 TypeScript 系列教程将自始至终地引导你掌握 TypeScript 的各种方面，与您一起，宏观理解 JavaScript 世界、深入钻研 TypeScript 规则与逻辑，探索

TypeScript

Mongoose 是一个面向 MongoDB 数据库的对象数据模型（ODM）库，用于在 Node.js 环境下建模和操作 MongoDB 文档结构。它提供了一些方便的特性，如数据验证、查询构建、业务逻辑钩子（hooks）和中间件，使得处理 MongoDB 文档更加直观和安全。


Mongoose

Tailwind CSS 是一个非常强大且受欢迎的实用型 CSS 框架，于2017年由.Adam Wathan、Jonathan Reinink、David Hemphill 和 Steve Schoger 共同创立。 这个框架的主要目标是帮助开发者快速构建定制化的用户界面，而无需从头开始编写 CSS 代码。
Tailwind 提供了一整套预先定义好的类名，代表 CSS 的各种属性，如颜色、字体大

Tailwind CSS

Elasticsearch（常写作 Elasticsearch）是基于 Lucene 的分布式搜索与分析引擎，面向海量数据提供近实时（NRT）的全文检索、结构化查询与聚合分析能力。它以 JSON 文档为核心数据模型，通过 索引（index）—分片（shard）—副本（replica） 的机制实现横向扩展与高可用：数据被切分到多个分片分布在不同节点上，副本用于容灾与提升读取吞吐。Elasticsea

ElasticSearch

Go，也称为 Golang，是一种开源的编程语言，由 Google 开发。Go 是一种静态类型、编译型、并发型的语言，它被设计为一种简单、快速、可靠和高效的语言。Go 语言的语法类似于 C 语言，但也借鉴了其他语言的一些特性，如 Python 和 Java。

Go 语言的设计目标是提供一种简单、易于学习和使用的语言，同时具有高效的执行速度和并发处理能力。Go 语言的主要特点包括：

1. 并发支

Golang

CSS（Cascading Style Sheets）是一种用于描述文档样式和布局的样式表语言，常用于 Web 开发中。它通过定义样式规则来控制 HTML 元素的外观和布局，使得开发人员可以更加灵活地控制页面的样式和排版。

CSS 的主要特点包括：

分离样式和内容：CSS 可以将样式信息从 HTML 内容中分离出来，使得样式和内容的管理更加清晰和易于维护；
层叠样式：CSS 中的样式规则是可以

Network（网络）是指连接在一起的计算机、设备和其他物体，它们可以彼此通信和交换信息。网络可以分为局域网（LAN）、广域网（WAN）、互联网（Internet）等不同的类型和层次，它们在不同的范围和层次上提供了不同的服务和功能。

网络的主要特点包括：

连通性：网络可以将不同的计算机、设备和应用程序连接在一起，实现彼此之间的通信和数据交换。

分布式：网络中的计算机和设备分布在不同的地理位置