show-me git:20260919.7add278A

Immutable. This exact content never changes and is served at /api/v1/blob/4d2b17350b7aecb9.

---
name: show-me
description: 在调用关系、状态变化、层级结构或多个组件的关系用短文本难以讲清时使用聚焦的 ASCII、Mermaid、diff 或 HTML 可视化；不为单一事实、简单步骤或纯视觉设计审查额外制作图表。
---

# 聚焦可视化说明

用最小的可视化回答当前问题。可视化必须让关系、顺序、层级或变化比短文本更容易理解；如果一句话或短列表已经清楚，直接回答，不创建图表。

## 选择视图

| 需要表达 | 默认形式 |
| --- | --- |
| 算法、条件和短控制流 | 伪代码或短流程图 |
| 调用关系、组件归属、文件职责 | 调用树、组件树或浅层文件树 |
| 三个以上参与者的时序或数据流 | Mermaid sequence/flowchart |
| 修改前后结构或状态变化 | 聚焦 diff |
| 界面布局、密集比较或需要交互探索 | HTML 页面 |

一次只选择能回答问题的形式。只有两个视图分别表达不同且必要的信息时才组合使用。

详细格式示例见 [references/examples.md](references/examples.md)，需要对应形式时再读取。

## 最小流程

1. 用一句话写清用户需要理解的关系或变化。
2. 从代码、配置、用户提供的内容或已验证事实中提取最小节点和连接。
3. 选择上表中的最简单形式，删除与问题无关的文件、字段、组件和分支。
4. 在图旁用一两句话解释读图方式和最重要的结论。
5. 复核节点名称、方向、顺序和状态；无法确认的关系标记为“推测”或省略，不把示意图画成已验证事实。

## HTML 边界

只有静态文本视图明显不足时才创建 HTML。沿用目标产品的颜色、字体和组件；没有真实设计系统时使用克制的中性样式，不虚构品牌。

- 使用真实标签与经过验证的数据；示例数据必须明确标记。
- 同时检查桌面和窄屏布局。
- 生成后实际打开或渲染，确认无脚本错误、遮挡、溢出和不可读文本。
- 用户未要求持久文件时，写到安全的临时或任务输出目录，不污染源码树。
- 创建文件不等于授权发布或部署。

## 输出契约

最终结果包括：

- 可视化本体或生成文件的可点击路径；
- 一段简短说明，指出视图覆盖的范围；
- 任何为了清晰而省略、简化或仍未验证的部分；
- HTML 的打开或渲染验证结果。

不要用装饰性图表重复已经清楚的正文，也不要用可视化替代必要的代码、日志或来源证据。