从入门到精通：Compartment用户手册与最佳实践

【免费下载链接】CompartmentEncrypted, fully offline agentic memory. One click install, GUI w/ memory map, all OS and agents. Superior memory creation, storage and retrieval.项目地址: https://gitcode.com/gh_mirrors/co/Compartment

Compartment是一款功能强大的加密离线代理记忆工具，让您的AI代理能够永久保存决策、偏好和细节信息，所有数据均加密存储在本地计算机上。支持一键安装，提供直观的图形界面和记忆地图，兼容所有操作系统和代理程序，为您带来卓越的记忆创建、存储和检索体验。

为什么选择Compartment？

🔒 安全加密，完全离线

Compartment采用端到端加密技术，所有数据在存储时都经过AEAD加密，包括嵌入向量。这意味着即使有人获取了您的存储文件，也无法访问其中的内容。更重要的是，Compartment完全离线运行，不需要网络连接，也不会收集任何遥测数据，确保您的隐私得到最大程度的保护。

🚀 闪电般的搜索速度

得益于先进的混合搜索技术，Compartment能够在短短12毫秒内完成一次完整的搜索。这比任何云存储服务的往返时间都要快得多，让您的AI代理能够即时获取所需信息。

🧠 智能记忆管理

Compartment不仅仅是一个简单的存储工具，它还具备智能记忆管理功能。系统会自动对记忆进行分类和排序，确保重要的决策和信息不会被淹没在大量数据中。同时，它还会自动为记忆添加相关标签，随着时间的推移不断优化记忆的组织方式。

Compartment应用界面展示了其核心功能和设计理念

快速上手：安装与设置

一键安装

Compartment提供了简单快捷的安装方式，适用于所有操作系统：

pip install compartment && compartment init

对于不熟悉命令行的用户，macOS用户可以下载最新发布的Compartment.pkg安装包，双击即可完成安装，无需预先安装Python或其他依赖。

连接AI代理

安装完成后，您需要将Compartment连接到您使用的AI代理。目前支持Claude、Hermes和OpenClaw等主流AI代理：

# 连接Claude compartment integrate claude # 连接Hermes compartment integrate hermes # 连接OpenClaw compartment integrate openclaw

这些命令会自动配置您的AI代理，使其能够使用Compartment作为记忆存储。

界面介绍与基本操作

系统托盘/菜单栏界面

安装完成后，Compartment会在您的系统托盘（Windows）或菜单栏（macOS）中显示一个图标。点击该图标，您可以看到一个简洁的控制面板：

Windows系统托盘界面，显示记忆数量和最近存储的内容

控制面板显示以下信息和功能：

• 已存储的记忆总数
• 最近存储的5条记忆
• 自动锁定设置（15分钟、30分钟、60分钟或永不锁定）
• 解锁/锁定按钮
• 更改密码选项
• 连接AI代理的快捷按钮

macOS菜单栏界面

在macOS上，Compartment的界面集成在菜单栏中，提供了类似的功能：

macOS菜单栏界面，展示了设置选项和最近记忆

高级功能使用指南

记忆管理命令

Compartment提供了一系列命令行工具，让您可以更灵活地管理记忆：

# 存储新记忆 compartment store "这是一条新记忆" --tag "重要" --importance 0.9 # 搜索记忆 compartment search "关键词" # 查看最近记忆 compartment recent # 删除记忆 compartment forget <记忆ID> --shred

记忆仪表板

通过以下命令，您可以在浏览器中查看记忆仪表板，直观地了解记忆的组织和分布情况：

compartment dash

仪表板提供了记忆统计、关系图、标签云等可视化工具，帮助您更好地理解和管理您的记忆库。

导入现有记忆

如果您之前使用Claude Code等工具存储了记忆，可以通过以下命令将其导入到Compartment中：

compartment import-claude

这将确保您的所有历史记忆都能在新的安全系统中得到保护和管理。

最佳实践与技巧

1. 定期备份您的记忆库

虽然Compartment采用了先进的加密和数据保护技术，但定期备份仍然是一个好习惯。您可以通过以下命令锁定并导出您的记忆库：

compartment lock cp ~/.compartment/memory.vault /path/to/backup/location

2. 使用标签组织记忆

为记忆添加标签可以帮助您更快地找到相关信息。建议为不同类型的记忆使用一致的标签策略，例如：

compartment store "客户会议纪要" --tag "工作" --tag "会议" --tag "客户A"

3. 利用重要性分级

Compartment允许您为记忆设置重要性级别（0-1），系统会根据这个级别来优化搜索结果。建议为关键决策和重要信息设置较高的重要性：

compartment store "项目截止日期：2023-12-31" --importance 0.9 --tag "工作" --tag "截止日期"

4. 启用双因素认证

为了进一步增强安全性，您可以启用双因素认证：

compartment 2fa enable

这将要求您在解锁记忆库时同时提供密码和一个密钥文件，大大提高了安全性。

常见问题解答

Compartment与其他记忆工具相比有什么优势？

Compartment最大的优势在于其安全性、速度和智能记忆管理。它完全离线运行，所有数据均加密存储，搜索速度极快，并且能够自动优化记忆的组织方式。

我可以在多台设备上使用Compartment吗？

是的，您可以通过导出和导入记忆库文件在不同设备之间迁移您的记忆。只需确保在传输过程中保护好您的密码和密钥文件。

Compartment支持哪些AI代理？

目前Compartment支持Claude、Hermes、OpenClaw等主流AI代理，并且通过MCP协议可以与任何支持MCP的AI代理兼容。

如何确保我的记忆库安全？

除了Compartment内置的加密保护外，建议您定期更换密码，启用双因素认证，并将记忆库备份到安全的位置。

总结

Compartment为AI代理提供了一个安全、高效、智能的记忆管理解决方案。通过本指南，您已经了解了Compartment的基本安装、设置和使用方法，以及一些高级功能和最佳实践。无论您是普通用户还是AI开发人员，Compartment都能帮助您的AI代理更好地记住重要信息，提高工作效率。

开始使用Compartment，体验下一代AI记忆管理工具带来的便利和安全吧！

【免费下载链接】CompartmentEncrypted, fully offline agentic memory. One click install, GUI w/ memory map, all OS and agents. Superior memory creation, storage and retrieval.项目地址: https://gitcode.com/gh_mirrors/co/Compartment