code-to-chartlisted
Install: claude install-skill serejaris/kimi-skills
# Diagram Maker
将代码仓库的 import/依赖关系通过 AST 解析提取出来,自动生成三种图表:
1. **架构图(Architecture Diagram)** — 模块/目录级别的依赖关系
2. **流程图(Flowchart)** — 文件级别的 import 调用链路
3. **组织架构图(Org Chart)** — 目录/文件的层级结构
支持语言:Python、JavaScript、TypeScript、Go、Java
输出格式:Mermaid 文本(`.mmd`)或 SVG 图片(需系统安装 `mmdc`)
## 使用方式
### 基础用法:分析整个项目
```bash
python3 scripts/analyze_codebase.py /path/to/project
```
输出三张 Mermaid 图到 stdout,同时写入当前���录下的 `.mmd` 文件。
### 指定图表类型
```bash
# 仅生成架构图
python3 scripts/analyze_codebase.py /path/to/project --type architecture
# 仅生成流程图
python3 scripts/analyze_codebase.py /path/to/project --type flowchart
# 仅生成组织架构图
python3 scripts/analyze_codebase.py /path/to/project --type org
```
### 指定输出目录和格式
```bash
# 输出到指定目录
python3 scripts/analyze_codebase.py /path/to/project --output /tmp/diagrams
# 输出 SVG(需要 mmdc)
python3 scripts/analyze_codebase.py /path/to/project --format svg
# 同时输出 Mermaid 和 SVG
python3 scripts/analyze_codebase.py /path/to/project --format both
```
### 输出 JSON 分析结果
```bash
python3 scripts/analyze_codebase.py /path/to/project --json
```
### 参数说明
| 参数 | 说明 |
|------|------|
| `directory` | 要分析的代码目录(必填) |
| `--type, -t` | 图表类型:`architecture`、`flowchart`、`org`、`all`(默认 `all`) |
| `--output, -o` | 输出目录(默认当前目录) |
| `--format, -f` | 输出格式:`mermaid`、`svg`、`both`(默认 `mermaid`) |
| `--max-files` | 最大扫描文件数(默认 500) |
| `--max-depth` | 组织架构图最大深度(默认 4) |
| `--json` | 以 JSON 格式输出分析结果 |
## 工作原理
1. **扫描阶段**:递归遍历目录,跳过 `node_modules`、`.git`、`__pycache__` 等
2. **解析阶段**:
- Python 文件使