XMark - AI Code Bookmark (代码书签)

专为人类开发者与 AI 编程助手深度协同打造的 VS Code 原生代码书签扩展

📖 简介

XMark 是一款将代码书签与 AI 辅助编程无缝衔接的 VS Code 扩展。它以通用公开的 bookmark.json 为数据核心，原生支持行号区图标高亮、单行多书签层叠、代码漂移感知（Hash 比对）与快捷复制 Commit，既能作为人类日常开发的高效代码导航利器，也能作为 AI 理解项目结构与上下文的重要锚点。

🖥️ 使用方式

1. 行号区高亮与右键快捷管理

• 在编辑器代码行或左侧行号槽（Gutter）右键，即可快速添加、重命名或删除书签；
• 支持在单行添加多个不同维度的书签（如：业务入口、重构项），自动显示层叠图标并在 Hover 中聚合展示；
• 侧边栏书签项 Hover 浮层支持直接点击复制 Commit Hash，亦可通过右键菜单一键拷贝。

2. 代码漂移感知与一键校准

• 当书签所在行的代码内容被修改时，系统通过目标行内容 Hash 自动感知代码漂移；
• 行号区与侧边栏自动呈现黄色警告图标，且绝不随意静默错位；
• 在侧边栏右键该书签选择 “更新为当前代码行内容”，即可一键完成校准同步。

🤖 MCP 配置方式 (AI 协同)

XMark 提供了独立的 MCP (Model Context Protocol) 服务端 xmark-mcp，允许 Cursor、Claude Desktop、Windsurf、Trae 等 AI 客户端直接通过标准 MCP 协议读写与校验书签。

推荐直接使用 npx 零安装接入：

1. Cursor 配置 (~/.cursor/mcp.json 或项目根目录 .cursor/mcp.json)

{
  "mcpServers": {
    "xmark": {
      "command": "npx",
      "args": ["-y", "xmark-mcp", "--workspace", "${workspaceFolder}"]
    }
  }
}

2. Claude Desktop 配置 (claude_desktop_config.json)

{
  "mcpServers": {
    "xmark": {
      "command": "npx",
      "args": ["-y", "xmark-mcp", "--workspace", "/absolute/path/to/your/project"]
    }
  }
}

3. MCP 核心能力列表

📄 License

MIT