存储管理
监控文档用量、了解哪些内容计入配额,并在需要时释放空间。
了解配额
文档配额统计你所有 Spaces 中存储的知识条目总数。无论是手动添加、通过 MCP 写入,还是通过 git 同步,每一条内容都算作一个文档。
手动条目
通过 MCP memory_ingest 工具创建或从文件导入的知识条目。
Git 同步数据
从已连接的 GitHub 仓库同步的提交记录和拉取请求,存储在专用的 git Spaces 中。
任务关联数据
与任务关联的 git 数据(引用 Issues 的提交)受到保护,永不会被自动清理。
套餐限额
| 套餐 | 文档数 | Spaces 数 | 存储空间 |
|---|---|---|---|
| 免费版 | 200 | 3 | 50 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 同步数据。操作步骤如下:
进入存储管理
前往 控制台 → 存储,或在使用量警告横幅出现时点击"管理存储"按钮。
查看使用情况
页面显示当前文档数量、git Spaces 总数、超过 30 天的旧 git Spaces,以及清理后可释放的文档数。
清理旧 git 数据
点击"清理旧 git 数据"按钮,删除超过 30 天的 git Spaces。文档数量会立即更新。
受保护的内容
清理过程经过安全设计,以下内容永远不会被删除:
- 普通 Spaces — 所有手动创建的 Spaces 及其知识条目始终安全。
- 任务关联的 git 数据 — 包含与任务关联的提交或 PR 的 git Spaces 将被保留,确保任务活动历史完整。
- 近期 git Spaces — 仅超过 30 天的 git Spaces 才符合清理条件。近期同步的数据始终保留。
- Projects 与任务 — 你的 Projects、任务和已连接的仓库不受存储清理影响。
使用量警告
当你接近限额时,ContextForge 会发出相应警告:
正常使用,不显示任何警告。
控制台顶部显示"即将达到使用限额"横幅,附带存储管理链接。
"已达使用限额" — 在释放空间或升级套餐之前,新内容写入将被阻止。
存储管理技巧
按需同步
只同步你实际需要的仓库。每次同步都会生成计入配额的文档。
定期清理
每月检查存储管理页面,清除不再需要的旧 git 数据。
按需重新同步
清理后,你随时可以重新同步仓库以获取最新的提交记录和 PR。
升级以获得更多空间
如果你持续需要更多文档容量,可考虑升级到 Pro(5,000 个文档)或企业版(10,000 个文档)。