全部指南
指南

根据已提供证据制作交互系统图

选择一个架构问题,编写有类型的节点与连线模型,测试带搜索、节点详情与受限缩放的离线系统图。区分推断关系与已观察行为。

快速开始

让 AI 助手帮你完成

将这段提示粘贴到你正在使用的 AI 助手中:

使用 Interactive System Map 处理我明确提供的描述或获准代码库证据。选择一个问题与一种图形语法,编写稳定且有类型的节点和连线、准确标签、来源引用、证据状态及一条主路径。在新目录创建离线系统图、model.json 与 handoff.md。测试搜索、键盘选择、直接邻居、缩放边界、重置、窄屏容纳与控制台。明确保留未知项,不声称图上的可达性能够证明运行影响或安全性。

这个技能包含自动架构扫描器吗?

Interactive System Map v1.0.0 是供助手使用的创作说明工作流。所审核内容包包含 SKILL.md 与三份参考资料,不提供系统图生成器、扫描器或打包好的演示文件。助手需要根据获准描述、代码证据或有类型规格编写系统图,不应编造缺失基础设施或运行关系。

选择一个问题与一种图形语法

提出有限问题,例如所提供的导出请求如何从界面到达存储产物。选择架构、工作流、时序、数据流或生命周期,不要将它们混在同一画布。记录来源与版本,将每条声明标记为已提供、已观察、推断或未知。

先编写稳定节点与有类型的关系

阅读 references/map-authoring.md 与 references/icon-library.md。使用稳定节点标识、语义类型、简明标签、分组与证据说明。每条连线需要来源、目标、方向、准确的关系标签及证据状态。先声明一条主路径,再添加例外。

四节点导出流程的虚构示例
标识与类型作用证据边界
browser · 客户端提交导出简报已提供的虚构需求
gateway · 服务检查请求并入队已提供的虚构需求
worker · 进程制作产物已提供的虚构需求
archive · 存储保存产物保留期限未知

让助手编写完整离线产物

安装并选择技能,提供审核后的模型,要求在新目录生成 map-output/index.html、model.json 和 handoff.md。这些是要求的输出路径,不是包内已有文件。若嵌入现有应用,应先检查实际框架与组件再选择实现。独立系统图应内联所需 CSS、JavaScript 与 SVG,移除远程字体、账号和存储依赖。

文件实际生成后,可用以下标准库服务在本地预览产出。打开 http://127.0.0.1:5376/,使用 Ctrl+C 停止。这个服务不会生成系统图,也不会检查代码库。

python3 -m http.server 5376 --bind 127.0.0.1 --directory ./map-output

分别测试拓扑与交互

  • 将每个节点、端点与连线标签同模型及引用来源核对。已声明的异步队列不应变成没有标记的同步箭头。缺少生产证据的内容仍保持未知。
  • 按准确节点名称搜索,使用键盘与指针选择,检查直接关系,再清空搜索。选中状态可以突出已有邻居,但不应改变或编造拓扑。
  • 检查缩放上下限、重置、主题、减少动效与标签可读性。手机宽度下,将宽图限制在有标签的滚动区域内,不要将整图缩至无法阅读,也不要让它撑宽整个文档。
  • 检查浏览器控制台及必要网络资源。离线声明要求产物不依赖外部脚本、字体、图片、Cookie 或保存的账号状态。静态截图不能证明这些行为。

说明系统图能够与不能够证明什么

交付系统图、有类型模型、来源位置与版本、假设、布局决策及实际浏览器检查。图上的可达关系描述编写的连接,不能证明运行故障影响、容量、安全性或生产正确性。实际系统变化后,应更新证据并重新检查图示。

全部指南