ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

Deer Flow chart-visualization 技能实战:generate_mind_map 思维导图的参数规范与生成全流程

Deer Flow chart-visualization 技能实战:generate_mind_map 思维导图的参数规范与生成全流程 Deer Flow chart-visualization 技能实战generate_mind_map 思维导图的参数规范与生成全流程【免费下载链接】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-flowDeer Flow 内置的 chart-visualization 技能提供 26 种图表工具其中generate_mind_map用于将中心主题展开为 2~3 级分支的思维导图适合头脑风暴、方案规划与知识结构整理。本文基于该技能的思维导图参考规范 generate_mind_map.md 展开完整覆盖其输入字段、默认值与调用流程并结合 技能主文件 和 生成脚本 的源码说明从参数组装到拿回图片 URL 的完整链路读完即可按规范构造 payload 并实际调用生成思维导图。功能定位什么时候选思维导图而不是其他树状图参考规范对generate_mind_map的功能界定是围绕中心主题展开 2~3 级分支帮助组织想法、计划或知识结构常用于头脑风暴、方案规划。在主技能的选型指引中思维导图与组织架构图同属 Hierarchies Trees 类别见 SKILL.md选型上可按内容性质区分概念发散、计划拆解如上线方案目标 / 资源 / 风险用generate_mind_map职责与汇报关系明确岗位、角色、人数用generate_organization_chart其节点支持description字段说明职责见 组织架构图规范根因分析、原因分类人、机、料、法用generate_fishbone_diagram主干放置问题陈述见 鱼骨图规范。三类工具在输入结构上高度同构——都要求data为带name和children的递归节点树可选style.texture、theme、width、height因此一旦掌握了思维导图的规范迁移到另外两种树状图的成本很低。输入字段规范必填与可选参数规范将输入字段分为必填和可选两组逐项说明如下。必填参数字段类型说明dataobject节点树。每个节点至少包含namestring子节点通过childrenarray递归扩展建议深度 ≤3 层data是唯一的必填字段。从规范表述看建议深度 ≤3与同级参考文档如鱼骨图最大建议 3 层一致是出于可读性考虑的经验上限而非硬校验超过 3 层的树在默认 600×400 画布中会显得拥挤规范建议的应对方式是把大主题拆分为多张导图见下文使用建议。一个符合规范的最小节点树长这样{ data: { name: 季度产品规划, children: [ { name: 目标, children: [ { name: 新用户增长 30% }, { name: 留存率提升至 45% } ] }, { name: 资源, children: [ { name: 前后端各增编 2 人 } ] }, { name: 风险, children: [ { name: 依赖第三方接口变更 } ] } ] } }可选参数字段类型默认值可选值 / 说明style.texturestringdefaultdefault/rough切换线条质感手绘风themestringdefaultdefault/academy/dark整体配色主题widthnumber600画布宽度像素heightnumber400画布高度像素分支较多时可以把width/height调大以获得更舒展的布局需要深色背景嵌入报告或演示时将theme设为dark即可无需改动数据结构。内容组织建议规范给出的使用建议可以总结为三条可操作的写法中心节点写主题根节点name是整张导图的题目一句话点明发散对象一级分支代表主要维度如目标、资源、风险保证维度彼此正交、不重叠叶子节点使用短语不要写整句描述短语节点在导图渲染中更紧凑清晰分支较多时先分拆多张导图与其压缩一张图到不可读不如按主题分批生成每次调用一个独立 payload。调用方式payload 组装与执行命令思维导图不是直接调用本地绘图库而是通过 chart-visualization 技能统一的生成脚本提交到远端渲染服务。按 SKILL.md 定义的三步工作流调用generate_mind_map的过程是1. 组装 payloadpayload 采用统一的toolargs结构{ tool: generate_mind_map, args: { data: { name: Deer Flow 上线检查单, children: [ { name: 后端, children: [ { name: API 冒烟测试 }, { name: 鉴权链路回归 } ] }, { name: 前端, children: [ { name: 构建产物体积 } ] } ]}, theme: academy, width: 720, height: 480 } }2. 执行生成命令node ./scripts/generate.js payload_json脚本接受内联 JSON 字符串也支持传入一个 JSON 文件路径脚本内会先做fs.existsSync判断见 generate.js并且支持一次传入数组批量生成多张图。3. 脚本内部做了什么从 generate.js 源码可以确认完整链路CHART_TYPE_MAP将工具名映射为图表类型标识generate_mind_map对应mind-mapgenerate.js#L6-L32未知工具名会打印Error: Unknown tool并跳过该条 spec非地图类图表思维导图即属此类走generateChartUrl把type: mind-map、source: chart-visualization-creator与args合并为请求体POST 到可视化服务服务地址由环境变量VIS_REQUEST_SERVER指定未设置时回退到内置默认地址generate.js#L34-L39服务端返回success: true时脚本输出data.resultObj即生成的图片 URL打印到 stdout失败则抛出errorMessage。技能主文件同时声明了运行环境要求nodejs: 18.0.0SKILL.md front-matter这与脚本依赖 Node 18 原生fetch的实现一致。4. 返回结果与二次优化规范对返回结果的约定是返回思维导图 URL并在_meta.spec中保留节点树以便后续优化。也就是说拿到 URL 的同时还能获得一份完整记录本次输入的 spec 结构——当用户要求给风险分支下再加一个子节点时可以基于_meta.spec中的原始节点树做增改后重新提交而不是从头重建。技能工作流的第 4 步也要求把图片 URL 完整 argsspecification一并返回给用户二者配合保证生成过程可追溯、可迭代。适用前提与注意事项网络依赖生成动作实际发生在远端渲染服务VIS_REQUEST_SERVER指向的服务本地环境需要能访问该地址脚本失败时会输出HTTP status或服务端errorMessage属于环境问题而非参数错误参数以规范文档为准26 种图表各有独立的参考文档本文覆盖的data/theme/style.texture/width/height字段集是思维导图、组织架构图、鱼骨图这一树状图家族的共同约定具体取值范围以 references 目录 中对应文档为准深度与尺寸是经验建议data深度 ≤3、600×400 默认画布均为建议值脚本本身不做结构校验节点过多时应在内容组织阶段分拆导图而不是指望渲染端自适应。小结generate_mind_map的规范很短但信息完整一个必填的递归节点树data、四个带默认值的可选渲染参数、以及URL _meta.spec的返回约定。配合 chart-visualization 技能统一的tool/argspayload 格式和scripts/generate.js生成脚本开发者只需把主题组织成根节点 维度分支 短语叶子的三层结构即可在 Deer Flow 中稳定产出可二次迭代的思维导图并将其与组织架构图、鱼骨图在同一参数范式下灵活切换。【免费下载链接】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),仅供参考
返回列表