AWS IoT 组件库

IoT Core

• type: aws-iot-core
• svg: <svg width="64" height="64">...</svg>
• properties:
  • protocol: MQTT|HTTP
  • endpoint: string
• connections:
  • target: aws-iot-greengrass
  • direction: bidirectional

2. **实现组件渲染**：在`lib/diagram-validator.ts`中添加组件验证规则

```typescript
// 添加IoT组件验证规则
export const validateIoTComponents = (diagram: Diagram) => {
  const iotComponents = diagram.components.filter(c => c.type.startsWith('aws-iot-'));
  
  iotComponents.forEach(component => {
    // 验证IoT Core必须与Greengrass有连接
    if (component.type === 'aws-iot-core') {
      const hasGreengrassConnection = diagram.connections.some(conn => 
        (conn.source === component.id && conn.target.includes('aws-iot-greengrass')) ||
        (conn.target === component.id && conn.source.includes('aws-iot-greengrass'))
      );
      
      if (!hasGreengrassConnection) {
        addWarning(`IoT Core组件 "${component.name}" 应连接到Greengrass设备`);
      }
    }
  });
};

3. 注册自定义组件：修改lib/storage.ts加载新组件

// 加载自定义AWS IoT组件
export const loadCustomShapes = async () => {
  const defaultShapes = await loadDefaultShapes();
  const iotShapes = await import('../docs/shape-libraries/aws-iot.md');
  return [...defaultShapes, ...iotShapes];
};

4. 测试与发布：通过tests/unit/diagram-validator.test.ts添加测试用例，验证新组件的渲染和连接规则

6. 技术选型对比与常见问题诊断

选择合适的架构可视化工具需要综合考虑多种因素，而解决使用过程中的常见问题则能提高工作效率。

6.1 架构可视化工具技术选型对比表

评估维度	Next AI Draw.io	draw.io	Lucidchart	Visio
开源性质	开源（MIT许可证）	部分开源	商业软件	商业软件
AI生成能力	内置多模型支持	无	基础AI功能	无
云服务组件库	丰富（AWS/Azure/GCP）	基础	丰富	需手动导入
协作功能	实时保存与共享	基础协作	高级协作	有限协作
部署方式	本地/云/容器	本地/云	仅云服务	本地安装
二次开发	支持API扩展	有限扩展	无	无
学习曲线	中等（AI辅助降低门槛）	平缓	平缓	陡峭
价格	免费	基础免费	订阅制	一次性购买

选型建议：

• 开源项目和预算有限团队：Next AI Draw.io或draw.io
• 企业级协作需求：Lucidchart
• 高度定制化需求：Next AI Draw.io（支持二次开发）
• 纯Windows环境且需复杂图表：Visio

6.2 常见问题诊断流程图

graph TD
    A[问题现象] --> B{图表无法生成?}
    B -->|是| C[检查AI服务配置]
    C --> D[验证API密钥是否有效]
    D -->|有效| E[检查输入描述是否清晰]
    E -->|不清晰| F[提供更具体的服务名称和关系描述]
    B -->|否| G{图表布局混乱?}
    G -->|是| H[使用自动布局功能]
    H --> I[调整力导向算法参数]
    G -->|否| J{组件无法识别?}
    J -->|是| K[更新组件库至最新版本]
    K --> L[检查组件名称拼写]
    J -->|否| M[其他问题]
    M --> N[查看错误日志: app/api/log-feedback/route.ts]