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