详细绘制图

其他 社区

技能解读

当前原文的自动摘译,尚未人工审校。

定制化

所有颜色和品牌特定款式都位于一个文件中:references/color-palette.md。在生成任何图表之前阅读它,并将其用作所有颜色选择(形状填充、描边、文本颜色、证据工件背景等一切)的唯一事实来源。要使此技能生成您自己的品牌风格的图表,请编辑color-palette.md。该文件中的其他内容都是通用设计方法和 Excalidraw 最佳实践。

核心理念

图表应该争论,而不是展示。图表不是格式化文本。这是一种视觉论证,展示了仅靠语言无法表达的关系、因果关系和流程。形状应该是意义。同构测试:如果删除所有文本,仅靠结构就能传达概念吗?如果没有,请重新设计。教育测试:有人可以从这张图中学到一些具体的东西,还是只是给方框贴上标签?一个好的图表可以教导——它显示实际的格式、真实的事件名称、具体的例子。

深度评估(首先执行此操作)

在设计之前,确定该图需要什么详细程度:

简单/概念图

在以下情况下使用抽象形状: 解释心理模型或哲学 观众不需要技术细节 概念就是抽象(例如,“关注点分离”)

综合/技术图表

在以下情况下使用具体示例: 绘制真实系统、协议或架构的图表 该图表将用于教学或解释(例如 YouTube 视频) 观众需要了解事物的实际情况 您正在展示多种技术如何集成

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
通用
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@coleam00 · 未声明许可证
上下文用量评级
较高消耗
接入复杂程度
需手动接入
是否需要外部接口密钥
不需要
兼容的系统
macOS · Linux · Windows
运行环境要求
Node.js · Python
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
  • 命令执行
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
第 0 步:评估所需深度

首先,确定是否需要: 简单/概念:抽象形状、标签、关系(心智模型、哲学) 综合/技术:具体示例、代码片段、真实数据(系统、架构、教程) 如果全面:首先进行研究。查找实际规格、格式、事件名称、API。

02
第一步:深入理解

阅读内容。对于每个概念,问:这个概念的作用是什么? (不是它是什么)概念之间存在什么关系?核心的转变或流程是什么?人们需要看到什么才能理解这一点? (不仅仅是阅读)

03
第 2 步:将概念映射到模式

对于每个概念,找到反映其行为的视觉模式: 如果概念... · 使用此模式 产生多个输出 · 扇出(从中心的径向箭头) 将输入合并为一个 · 收敛(漏斗、箭头合并) 具有层次结构/嵌套 · 树(线条 + 自由浮动文本)

04
第三步:确保多样性

对于多概念图:每个主要概念必须使用不同的视觉模式。没有统一的卡片或网格。

05
第 4 步:绘制流程草图

在使用 JSON 之前,请在心里描画眼睛如何在图表中移动。应该有一个清晰的视觉故事。

06
第5步:生成JSON

现在只需创建 Excalidraw 元素。请参阅下文了解如何处理大型图表。

07
第 6 步:渲染和验证(强制)

生成 JSON 后,您必须运行 render-view-fix 循环,直到图表看起来正确为止。这不是可选的 - 请参阅下面的渲染和验证部分以了解完整的过程。

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。