LoginGet Started

更新与版本管理

保持 ContextForge MCP 客户端更新，以获取最新功能、错误修复和改进。

当前版本

查看已安装版本

查看当前安装的版本：

npm list -g contextforge-mcp

输出示例： contextforge-mcp@0.1.71

如何更新

1更新到最新版本（推荐）

获取最新版本最简单的方式：

npm update -g contextforge-mcp

此命令会更新到 npm 上可用的最新版本。

2强制重新安装最新版

如果更新命令无效，可强制全新安装：

npm install -g contextforge-mcp@latest

此命令会删除旧版本并安装最新版。

3安装指定版本

如需安装特定版本：

npm install -g contextforge-mcp@0.1.71

将 0.1.71 替换为所需版本号。

重要：需要重启

更新包后，必须重启 Claude Code 才能使更改生效。

对于 Claude Code（CLI）：

  1. 关闭当前的 Claude Code 会话
  2. 退出终端（或运行 exit）
  3. 打开新的终端会话
  4. 重新启动 Claude Code

原因：Claude Code 以后台进程的方式运行 MCP 客户端。更新 npm 包只是更新了磁盘上的文件，旧进程仍在内存中运行。重启才会创建使用更新代码的新进程。

验证更新

重启 Claude Code 后，验证新版本是否已生效：

1. 检查已安装版本：

npm list -g contextforge-mcp

2. 在 Claude Code 中测试：

让 Claude 使用 ContextForge 工具。如果看到改进后的错误信息（包含有用的链接和详情），说明您正在使用最新版本！

故障排查

问题："版本未更新"

如果 npm update 无效：

  1. 尝试强制重新安装： npm install -g contextforge-mcp@latest
  2. 清除 npm 缓存： npm cache clean --force
  3. 然后重新安装： npm install -g contextforge-mcp@latest

问题："Permission denied"

在 macOS/Linux 上，可能需要 sudo：

sudo npm update -g contextforge-mcp

问题："仍然显示旧版错误信息"

请确保更新后重启了 Claude Code：

  1. 验证版本： npm list -g contextforge-mcp
  2. 完全退出 Claude Code
  3. 关闭终端
  4. 打开新终端并启动 Claude Code

问题："EBADENGINE 警告"

您可能会看到关于 Node.js 版本兼容性的警告：

npm warn EBADENGINE Unsupported engine

这通常可以安全忽略。这是来自开发依赖的警告，不影响 ContextForge 的功能。如果更新完成后显示 "changed 1 package"，说明一切正常！

近期发布说明

版本 0.1.71

当前版本

发布日期：2026 年 3 月 25 日

✨ 新增：
  • 关系感知搜索——查询现在可通过知识图谱连接发现相关条目
  • include_relationships 参数用于 memory_query ——查看每条结果的关联关系
  • Obsidian 库导入，支持 YAML frontmatter 解析、wikilink 关系创建和文件夹分类
  • memory_list_relationships ——列出知识条目的所有关联关系
🐛 修复：
  • 使用 project_id 时 memory_query 返回 0 条结果——Git Spaces 被纳入搜索导致超时
  • Projects 端点显示虚高的 Space 数量（包含了 Git Spaces）

版本 0.1.70

发布日期：2026 年 3 月 13 日

✨ 新增：
  • tasks_add_comment ——在 Claude 中为任务添加评论
  • tasks_list_comments ——查看任务的所有评论
  • tasks_list 输出中新增评论数量指示器
  • 当有新 MCP 版本可用时，在工具响应中显示更新通知
🔧 改进：
  • 仪表盘更新横幅，支持可关闭通知
  • 面向所有用户的版本通知系统
  • MCP 版本现从 package.json 读取（单一事实来源）

版本 0.1.65

发布日期：2026 年 3 月 11 日

✨ 变更：
  • tasks_delete 现在执行硬删除并完整级联清理（评论、活动记录、通知）
  • 所有任务卡片和行上新增删除按钮，可直接从列表视图操作
🔧 改进：
  • 无限滚动在删除条目后保持滚动位置
  • 深色模式下删除按钮可见性改善
  • CI auto-pr 工作流在无独特提交时跳过执行

版本 0.1.64

发布日期：2026 年 3 月 10 日

🔒 安全：
  • 修复 @hono/node-server 中的授权绕过漏洞（高危 CVE）
  • 修复 @modelcontextprotocol/sdk 中的跨客户端数据泄露（高危 CVE）
  • 修复 rollup 中的任意文件写入漏洞（高危 CVE）
🔧 改进：
  • 将所有依赖更新至最新安全版本

版本 0.1.49

发布日期：2026 年 1 月 29 日

✨ 新增：
  • issues_delete ——按 ID 或 short_id 删除任务（软删除）
  • 仪表盘中新增创建任务对话框（替代跳转到 /new 页面）
  • 任务详情页新增删除任务按钮（仅所有者可见）
🔧 改进：
  • 后端支持按 id 或 short_id 执行 DELETE
  • 从仪表盘管理任务的用户体验改善

版本 0.1.22

发布日期：2026 年 1 月 15 日

✨ 新增：
  • npx contextforge-setup ——交互式配置向导，轻松完成设置
  • npx contextforge-setup --verify ——检查当前配置状态
🔧 改进：
  • 简化安装流程，无需记忆复杂命令
  • 自动检测现有 ContextForge 配置

版本 0.1.21

发布日期：2026 年 1 月 15 日

✨ 新增：
  • memory_link_project ——将本地目录关联到云端项目
  • memory_unlink_project ——从目录中移除项目关联
  • memory_current_project ——查看已关联项目及其 Spaces
  • .contextforge 配置文件，实现项目上下文自动识别
🔧 改进：
  • memory_list_spaces 现在自动按已关联项目过滤
  • 更新帮助文本，包含项目关联文档

版本 0.1.20

发布日期：2026 年 1 月 15 日

✨ 新增：
  • memory_delete_project ——删除项目，级联删除所有 Spaces 和条目
  • 仪表盘项目详情页新增删除项目按钮
🔧 改进：
  • 后端现支持项目级联删除
  • 更新删除操作相关文档

版本 0.1.18

发布日期：2026 年 1 月 15 日

✨ 新增：
  • Projects 功能，用于整理 Spaces（层级结构：Projects → Spaces）
  • memory_move_space ——在项目间移动 Spaces
  • memory_delete_space ——删除 Space 及其条目
  • memory_list_projects 和 memory_create_project 工具
  • 仪表盘新增项目详情页
  • 仪表盘 UI 中新增 Space 的移动和删除按钮
🔧 改进：
  • 侧边栏重新排序：Usage 现在位于 Projects 之前
  • 超出限额场景下的用量显示改善
  • 修复 Edge Functions 上的 JWT 验证问题

版本 0.1.15

发布日期：2026 年 1 月 14 日

✨ 新增：
  • 多 Space 搜索能力
  • 查询中支持 Space 名称
  • 用户友好的错误提示信息

版本 0.1.4

发布日期：2026 年 1 月 12 日

✨ 新增：
  • Git 集成工具（连接、同步、历史记录）
  • Snapshot 管理（创建、还原、删除）
  • 导入/导出功能
  • 批量删除操作

在 GitHub Releases 上查看完整更新日志

更新最佳实践

+

定期检查更新

运行 npm outdated -g 查看是否有可用更新

+

更新后务必重启

记得重启 Claude Code 以使用新版本

+

更新后进行测试

执行一个简单操作，确认一切正常

-

破坏性变更极为罕见

次版本更新（0.1.x）始终向后兼容

需要帮助？

如果在更新过程中遇到问题：