與生成機制)
DeerFlow chart-visualization 技能generate_organization_chart 組織架構圖的完整參數(shù)與生成機制【免費下載鏈接】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技能中的組織架構圖規(guī)格 generate_organization_chart.md 展開講清generate_organization_chart工具的輸入字段必填與可選參數(shù)、數(shù)據(jù)結構約定與使用建議并結合 generate.js 源碼說明該參數(shù)如何被組裝成請求、經(jīng)由圖表類型映射發(fā)送到可視化服務最終返回圖片 URL。讀完后你可以直接為 Agent 或腳本編寫合法的組織架構圖 payload并理解從參數(shù)到出圖的完整鏈路。一、它在 DeerFlow 技能體系中的位置chart-visualization是 DeerFlow 的公共內置技能之一在 skills.mdx 的內置技能清單中被描述為從數(shù)據(jù)創(chuàng)建圖表和可視化。技能的入口定義在 SKILL.md其中聲明了 Node.js 兼容性要求nodejs: 18.0.0和四步工作流智能選圖根據(jù)數(shù)據(jù)特征從 26 種圖表類型中選擇最合適的工具。組織架構圖與思維導圖同屬Hierarchies Trees層級與樹類別——凡是展示公司、團隊、項目的上下級隸屬關系SKILL.md 都指向generate_organization_chart參數(shù)提取閱讀references/目錄下對應圖表的規(guī)格文件本工具即 generate_organization_chart.md把用戶數(shù)據(jù)映射為期望的args格式調用腳本以 JSON payload 執(zhí)行node ./scripts/generate.js payload_json返回結果把生成的圖片 URL 與完整的args一起返回給用戶。因此理解generate_organization_chart的關鍵在于兩點一是把組織信息組織成符合規(guī)格的節(jié)點樹二是了解腳本如何消費這份規(guī)格。二、功能定位展示層級關系并承載角色職責規(guī)格文檔對generate_organization_chart的定義是展示公司、團隊或項目的層級關系并可在節(jié)點上描述角色職責。這與思維導圖圍繞中心主題發(fā)散分支和矩形樹圖強調各節(jié)點權重占比形成互補組織架構圖的語義核心是上下級隸屬節(jié)點名稱通常是崗位/角色每個節(jié)點可通過description字段承載職責說明或人數(shù)信息適合組織架構圖、團隊分工圖、項目匯報關系圖等場景。三、輸入字段完整說明必填字段data節(jié)點樹data是唯一的必填參數(shù)類型為object約束如下節(jié)點至少包含namestring一般填寫崗位或角色名稱可選descriptionstring用于簡要說明該節(jié)點職責或人數(shù)子節(jié)點通過childrenarray遞歸嵌套每個子節(jié)點同樣是含name及可選description/children的對象規(guī)格文檔建議最大深度為 3 層——層級過深會導致橫向展開過寬節(jié)點文字擠壓。一個符合規(guī)格的組織結構示例如下{ data: { name: CTO, description: 技術負責人, children: [ { name: 前端組長, description: 5 人, children: [ { name: 前端工程師, description: 3 人 } ] }, { name: 后端組長, description: 8 人, children: [ { name: 后端工程師, description: 6 人 } ] } ] } }可選字段一覽字段類型默認值可選值 / 說明orientstringverticalvertical縱向上級的下級在下方展開標準 org chart 形態(tài)/horizontal橫向展開適合寬而淺的結構style.texturestringdefaultdefault標準渲染/rough手繪風格紋理themestringdefaultdefault/academy/dark三套主題配色widthnumber600輸出畫布寬度像素heightnumber400輸出畫布高度像素這幾個可選字段與其他樹形/圖表類規(guī)格如 generate_mind_map.md、generate_treemap_chart.md保持一致的theme/width/height/style.texture體系說明它們是chart-visualization技能內統(tǒng)一的渲染參數(shù)約定。四、使用建議來自規(guī)格文檔規(guī)格文檔給出的實操建議值得遵循節(jié)點名稱使用崗位/角色如產(chǎn)品負責人而非具體人名description簡要說明職責或人數(shù)——這使圖表聚焦于組織結構本身而非人員信息組織較大時拆分多個子圖或按部門分批展示而不是硬把十幾個部門壓進一張圖。這與最大深度建議為 3的建議呼應寧可多張圖也不要犧牲可讀性。五、執(zhí)行鏈路payload 如何變成圖片 URL結合 generate.js 的源碼可以完整還原generate_organization_chart的執(zhí)行過程。1. 命令行與 payload 格式腳本支持兩種輸入方式見 main()參數(shù)是已存在的文件路徑時讀取文件解析否則直接作為 JSON 字符串解析并且支持批量——若解析結果是數(shù)組會逐項處理。SKILL.md 規(guī)定的 payload 格式為{ tool: generate_organization_chart, args: { data: { name: CEO, children: [ { name: CTO } ] }, orient: vertical, theme: default, width: 600, height: 400 } }對應執(zhí)行命令node ./scripts/generate.js payload_json注意 payload 頂層是toolargs兩層結構tool聲明圖表工具名args即規(guī)格文檔中定義的那組輸入字段。2. 工具名到圖表類型的映射腳本內部維護了一張CHART_TYPE_MAP見 generate.js#L6-L32把面向 Agent 的工具名映射為服務端類型標識generate_organization_chart: organization-chart,即tool: generate_organization_chart會被轉換為type: organization-chart發(fā)送。若tool字段缺失或不在映射表中腳本會打印錯誤并跳過該項而不是中斷整個批量任務。3. 請求組裝與服務端對非地圖類工具組織架構圖即走此分支generateChartUrl() 會組裝如下請求體并 POST 到可視化服務{ type: organization-chart, // 由 CHART_TYPE_MAP 轉換而來 source: chart-visualization-creator, ...options // 展開即 argsdata、orient、theme、width 等 }服務端地址由環(huán)境變量決定見 getVisRequestServer()優(yōu)先取VIS_REQUEST_SERVER未設置時回退到 AntV Studio 的默認 gpt-vis 接口。請求成功data.success為真后resultObj——即生成圖表的圖片 URL——被直接打印到 stdout。這就是 SKILL.md 工作流第 4 步返回圖片 URL的來源。4. 與地圖類工具的區(qū)別從源碼結構看generate_district_map、generate_path_map、generate_pin_map三個地圖工具走獨立的generateMap()分支請求體攜帶serviceId與input并依賴SERVICE_ID環(huán)境變量而組織架構圖與其余 23 種圖表一樣走generateChartUrl()的簡單分支不需要SERVICE_ID。六、返回結果與可迭代性按規(guī)格文檔成功調用后返回組織架構圖的圖片 URLstdout 輸出完整args保存在_meta.spec中用于日后迭代——即你可以基于同一份 spec 修改節(jié)點后重新生成而不必重新描述數(shù)據(jù)結構。SKILL.md 也明確要求把圖片 URL 和生成所用的完整args一并返回給用戶二者配合構成可復現(xiàn)的圖表記錄。七、最小可運行示例假設要在 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 } }執(zhí)行成功時 stdout 輸出一行圖片 URL失敗時以Error generating chart for generate_organization_chart: ...形式打印錯誤信息見 generate.js#L137-L161 的錯誤處理邏輯。小結generate_organization_chart的規(guī)格可以濃縮為一句話一棵以name為必選、children遞歸嵌套、深度建議不超過 3 的節(jié)點樹加上orient/theme/width/height/style.texture五個可選渲染參數(shù)由 generate.js 經(jīng)CHART_TYPE_MAP映射為organization-chart類型提交到可視化服務產(chǎn)出圖片 URL 并保留_meta.spec供迭代。編寫節(jié)點數(shù)據(jù)時記住兩條建議——節(jié)點名寫崗位角色、description寫職責或人數(shù)大組織拆圖分批——即可獲得可讀性最佳的輸出?！久赓M下載鏈接】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創(chuàng)作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考 DeerFlow chart-visualization 技能：generate_organization_chart 組織架構圖的完整參數(shù)與生成機制
DeerFlow chart-visualization 技能generate_organization_chart 組織架構圖的完整參數(shù)與生成機制【免費下載鏈接】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技能中的組織架構圖規(guī)格 generate_organization_chart.md 展開講清generate_organization_chart工具的輸入字段必填與可選參數(shù)、數(shù)據(jù)結構約定與使用建議并結合 generate.js 源碼說明該參數(shù)如何被組裝成請求、經(jīng)由圖表類型映射發(fā)送到可視化服務最終返回圖片 URL。讀完后你可以直接為 Agent 或腳本編寫合法的組織架構圖 payload并理解從參數(shù)到出圖的完整鏈路。一、它在 DeerFlow 技能體系中的位置chart-visualization是 DeerFlow 的公共內置技能之一在 skills.mdx 的內置技能清單中被描述為從數(shù)據(jù)創(chuàng)建圖表和可視化。技能的入口定義在 SKILL.md其中聲明了 Node.js 兼容性要求nodejs: 18.0.0和四步工作流智能選圖根據(jù)數(shù)據(jù)特征從 26 種圖表類型中選擇最合適的工具。組織架構圖與思維導圖同屬Hierarchies Trees層級與樹類別——凡是展示公司、團隊、項目的上下級隸屬關系SKILL.md 都指向generate_organization_chart參數(shù)提取閱讀references/目錄下對應圖表的規(guī)格文件本工具即 generate_organization_chart.md把用戶數(shù)據(jù)映射為期望的args格式調用腳本以 JSON payload 執(zhí)行node ./scripts/generate.js payload_json返回結果把生成的圖片 URL 與完整的args一起返回給用戶。因此理解generate_organization_chart的關鍵在于兩點一是把組織信息組織成符合規(guī)格的節(jié)點樹二是了解腳本如何消費這份規(guī)格。二、功能定位展示層級關系并承載角色職責規(guī)格文檔對generate_organization_chart的定義是展示公司、團隊或項目的層級關系并可在節(jié)點上描述角色職責。這與思維導圖圍繞中心主題發(fā)散分支和矩形樹圖強調各節(jié)點權重占比形成互補組織架構圖的語義核心是上下級隸屬節(jié)點名稱通常是崗位/角色每個節(jié)點可通過description字段承載職責說明或人數(shù)信息適合組織架構圖、團隊分工圖、項目匯報關系圖等場景。三、輸入字段完整說明必填字段data節(jié)點樹data是唯一的必填參數(shù)類型為object約束如下節(jié)點至少包含namestring一般填寫崗位或角色名稱可選descriptionstring用于簡要說明該節(jié)點職責或人數(shù)子節(jié)點通過childrenarray遞歸嵌套每個子節(jié)點同樣是含name及可選description/children的對象規(guī)格文檔建議最大深度為 3 層——層級過深會導致橫向展開過寬節(jié)點文字擠壓。一個符合規(guī)格的組織結構示例如下{ data: { name: CTO, description: 技術負責人, children: [ { name: 前端組長, description: 5 人, children: [ { name: 前端工程師, description: 3 人 } ] }, { name: 后端組長, description: 8 人, children: [ { name: 后端工程師, description: 6 人 } ] } ] } }可選字段一覽字段類型默認值可選值 / 說明orientstringverticalvertical縱向上級的下級在下方展開標準 org chart 形態(tài)/horizontal橫向展開適合寬而淺的結構style.texturestringdefaultdefault標準渲染/rough手繪風格紋理themestringdefaultdefault/academy/dark三套主題配色widthnumber600輸出畫布寬度像素heightnumber400輸出畫布高度像素這幾個可選字段與其他樹形/圖表類規(guī)格如 generate_mind_map.md、generate_treemap_chart.md保持一致的theme/width/height/style.texture體系說明它們是chart-visualization技能內統(tǒng)一的渲染參數(shù)約定。四、使用建議來自規(guī)格文檔規(guī)格文檔給出的實操建議值得遵循節(jié)點名稱使用崗位/角色如產(chǎn)品負責人而非具體人名description簡要說明職責或人數(shù)——這使圖表聚焦于組織結構本身而非人員信息組織較大時拆分多個子圖或按部門分批展示而不是硬把十幾個部門壓進一張圖。這與最大深度建議為 3的建議呼應寧可多張圖也不要犧牲可讀性。五、執(zhí)行鏈路payload 如何變成圖片 URL結合 generate.js 的源碼可以完整還原generate_organization_chart的執(zhí)行過程。1. 命令行與 payload 格式腳本支持兩種輸入方式見 main()參數(shù)是已存在的文件路徑時讀取文件解析否則直接作為 JSON 字符串解析并且支持批量——若解析結果是數(shù)組會逐項處理。SKILL.md 規(guī)定的 payload 格式為{ tool: generate_organization_chart, args: { data: { name: CEO, children: [ { name: CTO } ] }, orient: vertical, theme: default, width: 600, height: 400 } }對應執(zhí)行命令node ./scripts/generate.js payload_json注意 payload 頂層是toolargs兩層結構tool聲明圖表工具名args即規(guī)格文檔中定義的那組輸入字段。2. 工具名到圖表類型的映射腳本內部維護了一張CHART_TYPE_MAP見 generate.js#L6-L32把面向 Agent 的工具名映射為服務端類型標識generate_organization_chart: organization-chart,即tool: generate_organization_chart會被轉換為type: organization-chart發(fā)送。若tool字段缺失或不在映射表中腳本會打印錯誤并跳過該項而不是中斷整個批量任務。3. 請求組裝與服務端對非地圖類工具組織架構圖即走此分支generateChartUrl() 會組裝如下請求體并 POST 到可視化服務{ type: organization-chart, // 由 CHART_TYPE_MAP 轉換而來 source: chart-visualization-creator, ...options // 展開即 argsdata、orient、theme、width 等 }服務端地址由環(huán)境變量決定見 getVisRequestServer()優(yōu)先取VIS_REQUEST_SERVER未設置時回退到 AntV Studio 的默認 gpt-vis 接口。請求成功data.success為真后resultObj——即生成圖表的圖片 URL——被直接打印到 stdout。這就是 SKILL.md 工作流第 4 步返回圖片 URL的來源。4. 與地圖類工具的區(qū)別從源碼結構看generate_district_map、generate_path_map、generate_pin_map三個地圖工具走獨立的generateMap()分支請求體攜帶serviceId與input并依賴SERVICE_ID環(huán)境變量而組織架構圖與其余 23 種圖表一樣走generateChartUrl()的簡單分支不需要SERVICE_ID。六、返回結果與可迭代性按規(guī)格文檔成功調用后返回組織架構圖的圖片 URLstdout 輸出完整args保存在_meta.spec中用于日后迭代——即你可以基于同一份 spec 修改節(jié)點后重新生成而不必重新描述數(shù)據(jù)結構。SKILL.md 也明確要求把圖片 URL 和生成所用的完整args一并返回給用戶二者配合構成可復現(xiàn)的圖表記錄。七、最小可運行示例假設要在 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 } }執(zhí)行成功時 stdout 輸出一行圖片 URL失敗時以Error generating chart for generate_organization_chart: ...形式打印錯誤信息見 generate.js#L137-L161 的錯誤處理邏輯。小結generate_organization_chart的規(guī)格可以濃縮為一句話一棵以name為必選、children遞歸嵌套、深度建議不超過 3 的節(jié)點樹加上orient/theme/width/height/style.texture五個可選渲染參數(shù)由 generate.js 經(jīng)CHART_TYPE_MAP映射為organization-chart類型提交到可視化服務產(chǎn)出圖片 URL 并保留_meta.spec供迭代。編寫節(jié)點數(shù)據(jù)時記住兩條建議——節(jié)點名寫崗位角色、description寫職責或人數(shù)大組織拆圖分批——即可獲得可讀性最佳的輸出?！久赓M下載鏈接】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創(chuàng)作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考