chip-png-d2-gen

Chip PNG D2 Generator

任务

为芯片模块生成 D2 格式的架构框图、流程图、状态机图，通过 d2 CLI 编译为 PNG。

依赖

• D2 CLI：独立二进制，见 requirements.txt
• D2 语言规范：https://d2lang.com
• 工具路径查找：优先 <project_root>/.claude/tools/d2/d2.exe，其次系统 PATH

执行步骤

1. 编写 D2 源文件：将 .d2 文件写入项目输出目录，命名规则：

   • 架构/框图：{module}_arch.d2 或 wd_{name}.d2
   • 流程图：wd_{name}_flow.d2
   • 状态机：wd_{name}_fsm.d2

2. 生成 PNG：

   # 单文件：d2 CLI 直接编译（工具路径查找：.claude/tools/d2/d2.exe → 系统 PATH）
   d2 --layout dagre <output_dir>/input.d2 <output_dir>/output.png
   
   # 批量（通过 wavedrom skill 的 gen_wavedrom.js，处理所有 wd_*.d2 + wd_*.json）
   node .claude/skills/chip-png-wavedrom-gen/gen_wavedrom.js <output_dir>
   

   <output_dir> 为项目中存放图表源文件和输出 PNG 的目录。

3. 在文档中引用：

   ![描述](filename.png)
   

D2 编写规范

架构框图模板

direction: right

# 外部端口（左=输入，右=输出）
ext_in: "上游输入" {
  style.fill: "#E8F8F5"
  style.stroke: "#27AE60"
  style.stroke-width: 2
}

ext_out: "下游输出" {
  style.fill: "#FDEDEC"
  style.stroke: "#27AE60"
  style.stroke-width: 2
}

# 功能模块
module_a: "模块A" {
  style.fill: "#EBF5FB"
  style.stroke: "#5B9BD5"
  sub_block: "子功能" {shape: cylinder}
}

# 数据通路连线
ext_in -> module_a: "数据流" {style.stroke: "#2E75B6"; style.stroke-width: 2}
module_a -> ext_out {style.stroke: "#2E75B6"; style.stroke-width: 2}

# 配置连线（虚线）
config -> module_a: "配置" {style.stroke: "#8E44AD"; style.stroke-dash: 3}

流程图模板

direction: right

step1: "步骤1" {
  style.fill: "#EBF5FB"
  style.stroke: "#5B9BD5"
}

step2: "步骤2" {
  style.fill: "#E8F5E9"
  style.stroke: "#27AE60"
}

decision: "条件?" {
  shape: diamond
  style.fill: "#FFEBEE"
  style.stroke: "#C0392B"
}

step1 -> step2 -> decision
decision -> step3: "yes"

状态机模板

direction: right

idle: "IDLE" {
  style.fill: "#E8F5E9"
  style.stroke: "#27AE60"
}

busy: "BUSY" {
  style.fill: "#FFF3E0"
  style.stroke: "#E67E22"
}

error: "ERROR" {
  style.fill: "#FFEBEE"
  style.stroke: "#C0392B"
}

idle -> busy: "start && !err"
busy -> idle: "done"
busy -> error: "err"
error -> idle: "rst"