flowchart LR
  subgraph Client["Windows 桌面端 (FigFig.exe / WebView2)"]
    UI["三栏玻璃工作台\n(HTML / CSS / JS)"]
    Host["WinForms 原生宿主\n(只读流映射 / 剪贴板 / 导出守卫)"]
    Worker["Web Worker 渲染与查询隔离沙箱\n(dist/worker.js)"]
    UI <-->|"RPC / 资源围栏"| Host
    UI <-->|"异步消息"| Worker
  end

  subgraph Engine["同构解析与实例展开引擎 (Isomorphic Core)"]
    Parser["Kiwi 二进制与 ZIP 解码器\n(parseDocumentFast)"]
    Resolver["实例作用域场景展开器\n(resolveFrameScene)"]
    Renderer["高精度 SVG 与热区合成器\n(renderFrameEnhanced)"]
    Parser --> Resolver --> Renderer
  end

  subgraph MCP["AI 智能体桥接 (mcp/server.mjs)"]
    Stdio["MCP 2024-11-05 Stdio Server"]
    Resvg["本地 WASM 光栅化\n(vendor/resvg.wasm)"]
    Stdio --> Resvg
  end

  FigFile[("本地 .fig / .deck 文件\n(Strictly Read-Only)")] --> Host
  FigFile --> Stdio
  Worker --> Engine
  Stdio --> Engine

# 启动 FigFig（默认加载内置的云原生设计系统示例库）
.\release\FigFig-1.2.0\FigFig.exe

# 启动并直接以只读模式打开指定的本地 .fig 文件
.\release\FigFig-1.2.0\FigFig.exe --open "D:\Designs\your-design-file.fig"

# 1. 构建 Web 核心 bundle、多尺寸风车图标与内置示例库 (dist/)
node tools/build.mjs

# 2. 编译原生 Windows x64 可执行程序并打包便携版 ZIP (release/FigFig-1.2.0/)
powershell -NoProfile -ExecutionPolicy Bypass -File tools/build.ps1 -ProjectRoot .

# 3. 运行浏览器 UI 与高分屏防抖/分栏/导出回归测试
node tools/verify-ui.mjs

# 4. 运行原生桌面端 (CDP) + 只读安全守卫 + MCP 协议端到端验证
node tools/verify.mjs

{
  "servers": {
    "figfig-design": {
      "type": "stdio",
      "command": "node",
      "args": ["D:/path/to/figfig/mcp/server.mjs"]
    }
  }
}

{
  "mcpServers": {
    "figfig-design": {
      "command": "node",
      "args": ["D:/path/to/figfig/mcp/server.mjs"]
    }
  }
}

figfig/
├── assets/                  # 四色折纸风车矢量/位图图标、多尺寸 .ico 与内置示例 .fig
├── licenses/                # WebView2 与第三方运行时许可文件
├── mcp/
│   └── server.mjs           # 零依赖 MCP 2024-11-05 (stdio) 只读协议服务端
├── native/
│   ├── FigFigApp.cs         # Windows x64 WinForms + WebView2 原生宿主窗口与本地资源围栏
│   ├── FigFigStore.cs       # 只读文件流会话管理、SHA-256 校验与导出扩展名白名单守卫
│   └── FigFigTests.cs       # C# 原生只读与防覆盖安全自检套件
├── src/
│   ├── index.html           # 三栏玻璃工作台视图结构
│   ├── app.css              # 清透玻璃主题系统（Light / Sepia / Dark）与响应式样式
│   ├── app.js               # 前端控制器、可拖拽分栏、无抖动缩放视口与导出工作流
│   ├── engine-ext.js        # 实例作用域场景展开器、几何/渐变/蒙版/边框增强渲染与全文检索
│   └── worker-entry.js      # 同构 Web Worker / Node RPC 入口
├── tools/
│   ├── branding.mjs         # 四色折纸风车图标与多尺寸 .ico 构建脚本
│   ├── build.mjs            # 核心 Worker bundle 组装与内置示例归档生成器
│   ├── build.ps1            # 原生测试、C# 编译、资源打包与便携版 ZIP 构建脚本
│   ├── verify-ui.mjs        # 浏览器端 UI 交互、分栏、高分屏防抖与导出自动化测试
│   └── verify.mjs           # 原生桌面端 (CDP)、剪贴板与 MCP 7 工具端到端验收套件
├── vendor/                  # OpenFig / Kiwi / fflate / fzstd 基础 bundle 与本地 resvg WASM
├── LICENSE                  # MIT 开源许可证
├── THIRD-PARTY-NOTICES.txt  # 第三方开源组件声明与非官方商标免责声明
└── package.json             # 项目元数据与脚本入口