name: 可视化代码 description: 分析源代码并生成架构图。用于可视化代码结构、关系或工作流。支持类图、ER图、序列图和依赖图。 argument-hint: <路径> [图表类型] allowed-tools: 任务、读取、写入、全局、搜索、Bash
可视化代码命令
分析源代码文件并自动生成适当的图表。
用法
/visualization:visualize-code <路径> [图表类型]
参数
<路径>- 要分析的文件或目录(必需)[图表类型]- 可选:class(类图)、er(ER图)、sequence(序列图)、dependency(依赖图)(如果省略则自动检测)
示例
/visualization:visualize-code src/models
/visualization:visualize-code src/services/user.service.ts class
/visualization:visualize-code prisma/schema.prisma er
/visualization:visualize-code src/routes sequence
/visualization:visualize-code src dependency
支持的分析类型
| 类型 | 触发条件 | 输入 |
|---|---|---|
class(类图) |
TypeScript/Python/Java类 | .ts、.py、.java、.cs文件 |
er(ER图) |
ORM/数据库模式 | schema.prisma、models.py、*.entity.ts |
sequence(序列图) |
API路由处理器 | 包含HTTP处理器的路由文件 |
dependency(依赖图) |
导入语句 | 任何源文件 |
执行
委托给 visualization:code-visualizer 代理,使用以下提示:
任务: 分析源代码并生成适当的图表。
目标: $1(要分析的路径) 图表类型: $2(可选 - 如未指定则自动检测)
说明:
- 发现文件:使用Glob在指定路径查找文件
- 确定分析类型:基于:
- 明确的图表类型参数(如提供)
- 文件模式和内容
- 读取和分析相关源文件
- 提取结构:
- 对于类图:类、属性、方法、关系
- 对于ER图:实体、字段、键、关系
- 对于序列图:处理器、服务调用、响应
- 对于依赖图:导入、模块关系
- 生成图表:使用Mermaid语法(首选GitHub渲染)
- 返回结果:包含图表和分析说明
自动检测规则:
| 文件模式 | 默认类型 |
|---|---|
schema.prisma |
ER图 |
models.py(Django/SQLAlchemy) |
ER图 |
*.entity.ts |
ER图 |
**/routes/**、*_controller.* |
序列图 |
通用的.ts、.py、.java |
类图 |
输出格式:
返回:
- 简要总结分析内容(文件、类、实体等)
- 生成的图表在 ```mermaid 代码块中
- 任何限制或不完整分析说明
- 改进建议
类图输出示例:
分析 src/models/ 中的5个文件:
- User.ts(1个类,4个方法)
- Post.ts(1个类,3个方法)
- Comment.ts(1个类,2个方法)
classDiagram
class User {
+String id
+String email
+createPost()
+addComment()
}
...
注意:为清晰起见,省略了一些私有实用方法。