DeerFlow chart-visualization 技能generate_organization_chart 组织架构图的完整参数与生成机制【免费下载链接】deer-flowAn open-source long-horizon SuperAgent harness that researches, codes, and creates. With the help of sandboxes, memories, tools, skill, subagents and message gateway, it handles different levels of tasks that could take minutes to hours.项目地址: https://gitcode.com/GitHub_Trending/de/deer-flow本篇指南围绕 DeerFlow 内置chart-visualization技能中的组织架构图规格 generate_organization_chart.md 展开讲清generate_organization_chart工具的输入字段必填与可选参数、数据结构约定与使用建议并结合 generate.js 源码说明该参数如何被组装成请求、经由图表类型映射发送到可视化服务最终返回图片 URL。读完后你可以直接为 Agent 或脚本编写合法的组织架构图 payload并理解从参数到出图的完整链路。一、它在 DeerFlow 技能体系中的位置chart-visualization是 DeerFlow 的公共内置技能之一在 skills.mdx 的内置技能清单中被描述为从数据创建图表和可视化。技能的入口定义在 SKILL.md其中声明了 Node.js 兼容性要求nodejs: 18.0.0和四步工作流智能选图根据数据特征从 26 种图表类型中选择最合适的工具。组织架构图与思维导图同属Hierarchies Trees层级与树类别——凡是展示公司、团队、项目的上下级隶属关系SKILL.md 都指向generate_organization_chart参数提取阅读references/目录下对应图表的规格文件本工具即 generate_organization_chart.md把用户数据映射为期望的args格式调用脚本以 JSON payload 执行node ./scripts/generate.js payload_json返回结果把生成的图片 URL 与完整的args一起返回给用户。因此理解generate_organization_chart的关键在于两点一是把组织信息组织成符合规格的节点树二是了解脚本如何消费这份规格。二、功能定位展示层级关系并承载角色职责规格文档对generate_organization_chart的定义是展示公司、团队或项目的层级关系并可在节点上描述角色职责。这与思维导图围绕中心主题发散分支和矩形树图强调各节点权重占比形成互补组织架构图的语义核心是上下级隶属节点名称通常是岗位/角色每个节点可通过description字段承载职责说明或人数信息适合组织架构图、团队分工图、项目汇报关系图等场景。三、输入字段完整说明必填字段data节点树data是唯一的必填参数类型为object约束如下节点至少包含namestring一般填写岗位或角色名称可选descriptionstring用于简要说明该节点职责或人数子节点通过childrenarray递归嵌套每个子节点同样是含name及可选description/children的对象规格文档建议最大深度为 3 层——层级过深会导致横向展开过宽节点文字挤压。一个符合规格的组织结构示例如下{ data: { name: CTO, description: 技术负责人, children: [ { name: 前端组长, description: 5 人, children: [ { name: 前端工程师, description: 3 人 } ] }, { name: 后端组长, description: 8 人, children: [ { name: 后端工程师, description: 6 人 } ] } ] } }可选字段一览字段类型默认值可选值 / 说明orientstringverticalvertical纵向上级的下级在下方展开标准 org chart 形态/horizontal横向展开适合宽而浅的结构style.texturestringdefaultdefault标准渲染/rough手绘风格纹理themestringdefaultdefault/academy/dark三套主题配色widthnumber600输出画布宽度像素heightnumber400输出画布高度像素这几个可选字段与其他树形/图表类规格如 generate_mind_map.md、generate_treemap_chart.md保持一致的theme/width/height/style.texture体系说明它们是chart-visualization技能内统一的渲染参数约定。四、使用建议来自规格文档规格文档给出的实操建议值得遵循节点名称使用岗位/角色如产品负责人而非具体人名description简要说明职责或人数——这使图表聚焦于组织结构本身而非人员信息组织较大时拆分多个子图或按部门分批展示而不是硬把十几个部门压进一张图。这与最大深度建议为 3的建议呼应宁可多张图也不要牺牲可读性。五、执行链路payload 如何变成图片 URL结合 generate.js 的源码可以完整还原generate_organization_chart的执行过程。1. 命令行与 payload 格式脚本支持两种输入方式见 main()参数是已存在的文件路径时读取文件解析否则直接作为 JSON 字符串解析并且支持批量——若解析结果是数组会逐项处理。SKILL.md 规定的 payload 格式为{ tool: generate_organization_chart, args: { data: { name: CEO, children: [ { name: CTO } ] }, orient: vertical, theme: default, width: 600, height: 400 } }对应执行命令node ./scripts/generate.js payload_json注意 payload 顶层是toolargs两层结构tool声明图表工具名args即规格文档中定义的那组输入字段。2. 工具名到图表类型的映射脚本内部维护了一张CHART_TYPE_MAP见 generate.js#L6-L32把面向 Agent 的工具名映射为服务端类型标识generate_organization_chart: organization-chart,即tool: generate_organization_chart会被转换为type: organization-chart发送。若tool字段缺失或不在映射表中脚本会打印错误并跳过该项而不是中断整个批量任务。3. 请求组装与服务端对非地图类工具组织架构图即走此分支generateChartUrl() 会组装如下请求体并 POST 到可视化服务{ type: organization-chart, // 由 CHART_TYPE_MAP 转换而来 source: chart-visualization-creator, ...options // 展开即 argsdata、orient、theme、width 等 }服务端地址由环境变量决定见 getVisRequestServer()优先取VIS_REQUEST_SERVER未设置时回退到 AntV Studio 的默认 gpt-vis 接口。请求成功data.success为真后resultObj——即生成图表的图片 URL——被直接打印到 stdout。这就是 SKILL.md 工作流第 4 步返回图片 URL的来源。4. 与地图类工具的区别从源码结构看generate_district_map、generate_path_map、generate_pin_map三个地图工具走独立的generateMap()分支请求体携带serviceId与input并依赖SERVICE_ID环境变量而组织架构图与其余 23 种图表一样走generateChartUrl()的简单分支不需要SERVICE_ID。六、返回结果与可迭代性按规格文档成功调用后返回组织架构图的图片 URLstdout 输出完整args保存在_meta.spec中用于日后迭代——即你可以基于同一份 spec 修改节点后重新生成而不必重新描述数据结构。SKILL.md 也明确要求把图片 URL 和生成所用的完整args一并返回给用户二者配合构成可复现的图表记录。七、最小可运行示例假设要在 DeerFlow 技能目录下直接验证一次组织架构图生成需要 Node.js 18且能访问VIS_REQUEST_SERVER指定的服务node ./skills/public/chart-visualization/scripts/generate.js { tool: generate_organization_chart, args: { data: { name: CEO, description: 1 人, children: [ { name: CTO, description: 技术负责人 }, { name: CFO, description: 财务负责人 } ] }, orient: vertical, theme: default, width: 600, height: 400 } }执行成功时 stdout 输出一行图片 URL失败时以Error generating chart for generate_organization_chart: ...形式打印错误信息见 generate.js#L137-L161 的错误处理逻辑。小结generate_organization_chart的规格可以浓缩为一句话一棵以name为必选、children递归嵌套、深度建议不超过 3 的节点树加上orient/theme/width/height/style.texture五个可选渲染参数由 generate.js 经CHART_TYPE_MAP映射为organization-chart类型提交到可视化服务产出图片 URL 并保留_meta.spec供迭代。编写节点数据时记住两条建议——节点名写岗位角色、description写职责或人数大组织拆图分批——即可获得可读性最佳的输出。【免费下载链接】deer-flowAn open-source long-horizon SuperAgent harness that researches, codes, and creates. With the help of sandboxes, memories, tools, skill, subagents and message gateway, it handles different levels of tasks that could take minutes to hours.项目地址: https://gitcode.com/GitHub_Trending/de/deer-flow创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 DeerFlow chart-visualization 技能：generate_organization_chart 组织架构图的完整参数与生成机制
DeerFlow chart-visualization 技能generate_organization_chart 组织架构图的完整参数与生成机制【免费下载链接】deer-flowAn open-source long-horizon SuperAgent harness that researches, codes, and creates. With the help of sandboxes, memories, tools, skill, subagents and message gateway, it handles different levels of tasks that could take minutes to hours.项目地址: https://gitcode.com/GitHub_Trending/de/deer-flow本篇指南围绕 DeerFlow 内置chart-visualization技能中的组织架构图规格 generate_organization_chart.md 展开讲清generate_organization_chart工具的输入字段必填与可选参数、数据结构约定与使用建议并结合 generate.js 源码说明该参数如何被组装成请求、经由图表类型映射发送到可视化服务最终返回图片 URL。读完后你可以直接为 Agent 或脚本编写合法的组织架构图 payload并理解从参数到出图的完整链路。一、它在 DeerFlow 技能体系中的位置chart-visualization是 DeerFlow 的公共内置技能之一在 skills.mdx 的内置技能清单中被描述为从数据创建图表和可视化。技能的入口定义在 SKILL.md其中声明了 Node.js 兼容性要求nodejs: 18.0.0和四步工作流智能选图根据数据特征从 26 种图表类型中选择最合适的工具。组织架构图与思维导图同属Hierarchies Trees层级与树类别——凡是展示公司、团队、项目的上下级隶属关系SKILL.md 都指向generate_organization_chart参数提取阅读references/目录下对应图表的规格文件本工具即 generate_organization_chart.md把用户数据映射为期望的args格式调用脚本以 JSON payload 执行node ./scripts/generate.js payload_json返回结果把生成的图片 URL 与完整的args一起返回给用户。因此理解generate_organization_chart的关键在于两点一是把组织信息组织成符合规格的节点树二是了解脚本如何消费这份规格。二、功能定位展示层级关系并承载角色职责规格文档对generate_organization_chart的定义是展示公司、团队或项目的层级关系并可在节点上描述角色职责。这与思维导图围绕中心主题发散分支和矩形树图强调各节点权重占比形成互补组织架构图的语义核心是上下级隶属节点名称通常是岗位/角色每个节点可通过description字段承载职责说明或人数信息适合组织架构图、团队分工图、项目汇报关系图等场景。三、输入字段完整说明必填字段data节点树data是唯一的必填参数类型为object约束如下节点至少包含namestring一般填写岗位或角色名称可选descriptionstring用于简要说明该节点职责或人数子节点通过childrenarray递归嵌套每个子节点同样是含name及可选description/children的对象规格文档建议最大深度为 3 层——层级过深会导致横向展开过宽节点文字挤压。一个符合规格的组织结构示例如下{ data: { name: CTO, description: 技术负责人, children: [ { name: 前端组长, description: 5 人, children: [ { name: 前端工程师, description: 3 人 } ] }, { name: 后端组长, description: 8 人, children: [ { name: 后端工程师, description: 6 人 } ] } ] } }可选字段一览字段类型默认值可选值 / 说明orientstringverticalvertical纵向上级的下级在下方展开标准 org chart 形态/horizontal横向展开适合宽而浅的结构style.texturestringdefaultdefault标准渲染/rough手绘风格纹理themestringdefaultdefault/academy/dark三套主题配色widthnumber600输出画布宽度像素heightnumber400输出画布高度像素这几个可选字段与其他树形/图表类规格如 generate_mind_map.md、generate_treemap_chart.md保持一致的theme/width/height/style.texture体系说明它们是chart-visualization技能内统一的渲染参数约定。四、使用建议来自规格文档规格文档给出的实操建议值得遵循节点名称使用岗位/角色如产品负责人而非具体人名description简要说明职责或人数——这使图表聚焦于组织结构本身而非人员信息组织较大时拆分多个子图或按部门分批展示而不是硬把十几个部门压进一张图。这与最大深度建议为 3的建议呼应宁可多张图也不要牺牲可读性。五、执行链路payload 如何变成图片 URL结合 generate.js 的源码可以完整还原generate_organization_chart的执行过程。1. 命令行与 payload 格式脚本支持两种输入方式见 main()参数是已存在的文件路径时读取文件解析否则直接作为 JSON 字符串解析并且支持批量——若解析结果是数组会逐项处理。SKILL.md 规定的 payload 格式为{ tool: generate_organization_chart, args: { data: { name: CEO, children: [ { name: CTO } ] }, orient: vertical, theme: default, width: 600, height: 400 } }对应执行命令node ./scripts/generate.js payload_json注意 payload 顶层是toolargs两层结构tool声明图表工具名args即规格文档中定义的那组输入字段。2. 工具名到图表类型的映射脚本内部维护了一张CHART_TYPE_MAP见 generate.js#L6-L32把面向 Agent 的工具名映射为服务端类型标识generate_organization_chart: organization-chart,即tool: generate_organization_chart会被转换为type: organization-chart发送。若tool字段缺失或不在映射表中脚本会打印错误并跳过该项而不是中断整个批量任务。3. 请求组装与服务端对非地图类工具组织架构图即走此分支generateChartUrl() 会组装如下请求体并 POST 到可视化服务{ type: organization-chart, // 由 CHART_TYPE_MAP 转换而来 source: chart-visualization-creator, ...options // 展开即 argsdata、orient、theme、width 等 }服务端地址由环境变量决定见 getVisRequestServer()优先取VIS_REQUEST_SERVER未设置时回退到 AntV Studio 的默认 gpt-vis 接口。请求成功data.success为真后resultObj——即生成图表的图片 URL——被直接打印到 stdout。这就是 SKILL.md 工作流第 4 步返回图片 URL的来源。4. 与地图类工具的区别从源码结构看generate_district_map、generate_path_map、generate_pin_map三个地图工具走独立的generateMap()分支请求体携带serviceId与input并依赖SERVICE_ID环境变量而组织架构图与其余 23 种图表一样走generateChartUrl()的简单分支不需要SERVICE_ID。六、返回结果与可迭代性按规格文档成功调用后返回组织架构图的图片 URLstdout 输出完整args保存在_meta.spec中用于日后迭代——即你可以基于同一份 spec 修改节点后重新生成而不必重新描述数据结构。SKILL.md 也明确要求把图片 URL 和生成所用的完整args一并返回给用户二者配合构成可复现的图表记录。七、最小可运行示例假设要在 DeerFlow 技能目录下直接验证一次组织架构图生成需要 Node.js 18且能访问VIS_REQUEST_SERVER指定的服务node ./skills/public/chart-visualization/scripts/generate.js { tool: generate_organization_chart, args: { data: { name: CEO, description: 1 人, children: [ { name: CTO, description: 技术负责人 }, { name: CFO, description: 财务负责人 } ] }, orient: vertical, theme: default, width: 600, height: 400 } }执行成功时 stdout 输出一行图片 URL失败时以Error generating chart for generate_organization_chart: ...形式打印错误信息见 generate.js#L137-L161 的错误处理逻辑。小结generate_organization_chart的规格可以浓缩为一句话一棵以name为必选、children递归嵌套、深度建议不超过 3 的节点树加上orient/theme/width/height/style.texture五个可选渲染参数由 generate.js 经CHART_TYPE_MAP映射为organization-chart类型提交到可视化服务产出图片 URL 并保留_meta.spec供迭代。编写节点数据时记住两条建议——节点名写岗位角色、description写职责或人数大组织拆图分批——即可获得可读性最佳的输出。【免费下载链接】deer-flowAn open-source long-horizon SuperAgent harness that researches, codes, and creates. With the help of sandboxes, memories, tools, skill, subagents and message gateway, it handles different levels of tasks that could take minutes to hours.项目地址: https://gitcode.com/GitHub_Trending/de/deer-flow创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考