mellos-mapping

mellos-mapping 是一款专为 Claude Code 和 Codex CLI 打造的实时分层依赖地图可视化插件，通过 MCP 协议以服务形式运行，在终端中以分屏面板展示 AI 编程助手在构建系统时的完整设计架构与开发进度。该工具将传统的任务清单式进度汇报转化为一种自下而上的分层视图：上层节点只能依赖下层节点，依赖关系仅允许向下指，这种约束通过图形化方式变得直观可见。

在使用流程上，当用户向 AI 描述一个非平凡的构建需求后，Claude 会先以虚线幽灵节点的方式声明完整的设计结构，用户可以在代码还未写一行时就审视并否决不合理的架构设计。随后 AI 每构建一个模块，相应的节点就会从幽灵状态转为转圈状态（代表正在构建），最后在获得测试通过证据后变为实心绿色。整个过程中，节点如果因为后续工作破坏了下层地基，会变红色提示依赖破损，这种机制让进度汇报成为最诚实的状态报告。

mellos-mapping 的设计原则是极简主义：插件本身不扫描代码、不判断实际内容，仅作为 AI 的汇报面板运行。地图文件存储在工作目录的 .mellos/ 目录下，随项目 git 提交，方便团队共享视野。面板支持鼠标交互（悬停高亮关系线、点击钉住节点详情、滚轮缩放等），也支持键盘操作（hjkl 微移视口、Tab 切换页面、双击下潜子图等）。

安装方式极为简便，在 Claude Code 对话中输入两行命令即可完成插件安装和启用。面板在每次写入时会自动感知是否有人在观看，如果没有人看，AI 会主动用 mmap_open 把面板打开。该工具需要 Node.js 18+ 环境，已发布至 npm，支持 npx 方式在任何 MCP 兼容客户端（Cursor、Windsurf、Zed、Gemini CLI 等）上运行。