pip install craftsman-map

# 1. 在你的项目根目录建立索引（改代码前必须先跑这个）
cd /path/to/your-project
craftsman-map index

# 2. 看功能块地图（渐进披露第一层）
craftsman-map map

# 3. 找符号
craftsman-map search "UserService"

# 4. 看符号详情 + 邻居
craftsman-map symbol "src/auth/service.py::UserService"

# 5. 分析影响面（改这里会波及哪里）
craftsman-map impact "src/auth/service.py::UserService.login"

# 6. 钻取展开（渐进披露第二层）
craftsman-map explore "src/auth/service.py::UserService" --depth 2

# 7. 热点分析（哪些文件改动最频繁）
craftsman-map hotspots

# 8. 统计概览
craftsman-map overview

# 9. 分层架构视图（自动标出入口/核心/工具层）
craftsman-map layers

# 10. 自动识别真实入口
craftsman-map entrypoints

# 11. 工作链：追踪从入口到出口的调用路径
craftsman-map trace "src/main.py::main"

# 12. 生成 wiki 描述（规则版，零成本）
craftsman-map wiki

# 13. 拿某个功能块的描述原料包（给调用方 LLM 生成描述用）
craftsman-map describe --cluster 0

# 14. 把 LLM 生成的描述写回缓存
craftsman-map desc --cluster 0 --text "这个模块负责..."

craftsman-map serve-mcp

{
  "mcpServers": {
    "craftsman-map": {
      "command": "craftsman-map",
      "args": ["serve-mcp"]
    }
  }
}

craftsman-map/
├── craftsman_map/
│   ├── cli.py              # CLI 入口
│   ├── mcp_server.py       # MCP stdio server（16 个工具）
│   ├── indexer.py          # INGEST 层：扫描 + 解析 + 建图
│   ├── git_history.py      # git 历史维度（dulwich 纯 Python）
│   ├── graph/
│   │   ├── model.py        # Node / Edge 数据模型（含 confidence）
│   │   ├── store.py        # CodeGraph 存储 + 聚类 + 序列化
│   │   └── linker.py       # 引用消解
│   ├── parsers/
│   │   ├── base.py         # 解析器抽象接口
│   │   ├── python_parser.py
│   │   ├── ts_parser.py    # JS/TS/Go（tree-sitter）
│   │   └── doc_parser.py   # Markdown / 资产
│   ├── understand/
│   │   ├── wiki.py         # 理解层：规则描述 + 原料包 + 注入回写
│   │   ├── view.py         # 分层视图
│   │   └── trace.py        # 工作链追踪
│   └── commands/
│       ├── core.py
│       └── understand.py
├── tests/                  # 68 条测试，全部 passed
├── clients/                # 各平台 MCP 配置文件
└── pyproject.toml

pip install -e ".[dev]"
pytest tests/ -v