存储管理

监控文档用量、了解哪些内容计入配额,并在需要时释放空间。

了解配额

文档配额统计你所有 Spaces 中存储的知识条目总数。无论是手动添加、通过 MCP 写入,还是通过 git 同步,每一条内容都算作一个文档。

手动条目

通过 MCP memory_ingest 工具创建或从文件导入的知识条目。

Git 同步数据

从已连接的 GitHub 仓库同步的提交记录和拉取请求,存储在专用的 git Spaces 中。

任务关联数据

与任务关联的 git 数据(引用 Issues 的提交)受到保护,永不会被自动清理。

套餐限额

套餐文档数Spaces 数存储空间
免费版200350 MB
Pro 版5,000无限制1 GB
企业版10,000无限制2 GB

什么是 Git Spaces?

当你连接 GitHub 仓库并运行 git_sync时,ContextForge 会创建一个 git Space 来存储同步的提交记录和拉取请求。每次同步都会在该 Space 中创建知识条目。

随着时间推移,如果频繁同步,这些 git Spaces 会积累并消耗大量文档配额。例如,一个活跃开发的仓库可能从提交和 PR 数据中生成数百个文档。

提示

超过 30 天且未与任何任务关联的 git Spaces 可以安全清理。你随时可以重新同步仓库以获取最新数据。

清理存储

存储管理页面可帮助你查看并清理旧的 git 同步数据。操作步骤如下:

1

进入存储管理

前往 控制台 → 存储,或在使用量警告横幅出现时点击"管理存储"按钮。

2

查看使用情况

页面显示当前文档数量、git Spaces 总数、超过 30 天的旧 git Spaces,以及清理后可释放的文档数。

3

清理旧 git 数据

点击"清理旧 git 数据"按钮,删除超过 30 天的 git Spaces。文档数量会立即更新。

受保护的内容

清理过程经过安全设计,以下内容永远不会被删除:

  • 普通 Spaces — 所有手动创建的 Spaces 及其知识条目始终安全。
  • 任务关联的 git 数据 — 包含与任务关联的提交或 PR 的 git Spaces 将被保留,确保任务活动历史完整。
  • 近期 git Spaces — 仅超过 30 天的 git Spaces 才符合清理条件。近期同步的数据始终保留。
  • Projects 与任务 — 你的 Projects、任务和已连接的仓库不受存储清理影响。

使用量警告

当你接近限额时,ContextForge 会发出相应警告:

低于 80%

正常使用,不显示任何警告。

80% - 99%

控制台顶部显示"即将达到使用限额"横幅,附带存储管理链接。

100%

"已达使用限额" — 在释放空间或升级套餐之前,新内容写入将被阻止。

存储管理技巧

按需同步

只同步你实际需要的仓库。每次同步都会生成计入配额的文档。

定期清理

每月检查存储管理页面,清除不再需要的旧 git 数据。

按需重新同步

清理后,你随时可以重新同步仓库以获取最新的提交记录和 PR。

升级以获得更多空间

如果你持续需要更多文档容量,可考虑升级到 Pro(5,000 个文档)或企业版(10,000 个文档)。