PPT Master 图表执行器Executor Chart Branch实战指南值驱动几何、绘图区标记与坐标校验全流程【免费下载链接】ppt-masterAI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations,>项目地址: https://gitcode.com/GitHub_Trending/ppt/ppt-master本文以 ppt-master 技能包中的 executor-chart.md 为核心系统讲解值驱动图表从几何构建、chart-plot-area对象级标记到verify-charts坐标校准的完整执行链路。读完你将掌握如何让柱长、点位置、扇区角度、多边形顶点等每一条数据痕迹都由权威数据计算而来如何在每页 SVG 中埋入校验所需的绘图区标记以及如何在 Default / Quick 两种执行档案下运行坐标校验并产出门禁回执。1. 分支定位什么时候该走 Chart 分支在 ppt-master 的执行架构中executor-base.md 是常驻加载的页面创作权威它按信息模型做条件分支路由。Executor Chart Branch是其中负责由数值决定可见几何的条件分支只要源值决定柱子的长度/高度、点位置、弧角、多边形顶点、连接线或流向宽度/路径、气泡圆心/半径、时长位置、面积或任何其他定量视觉变量就进入本分支。迷你图mini charts、迷你趋势线sparklines、插图insets和小多图small multiples即使没有目录引用也算数。该分支与相邻分支按信息模型划界判定依据是对象实际的信息模型而非是否套用了某个模板引用信息模型路由数值、日期或时长决定几何或其他视觉变量本分支Executor Chart定性顺序、分组、包含、因果或命名区域决定拓扑executor-structure.md行表头与列表头共同定位每个单元格事实executor-table.md例如一份排期只要日期或时长决定每条任务条的x与width它就是甘特图语义哪怕源数据来自一张 PowerPoint 表格而定性阶段 × 泳道的排布属于 Structure 分支。从源码侧也能印证这一边界——templates/charts/README.md 明确写着matrix_2x2是图表每项 x/y 编码两个值、半径编码第三个指标而固定 2×2 的标题文本区域是页面级 Structure。2. 值驱动几何数据拥有标记Data Owns the Marks2.1 硬性规则与构建顺序硬性规则——数据拥有标记每一条定量标记都必须从权威数据与一个显式的比例/编码推导而来。禁止目测位置、禁止保留目录预览中的示例数值、禁止为了构图美观而篡改数据。构造必须按如下顺序进行解析数据域数据域、类别、单位、基线baseline、比例以及任何半径/颜色/分箱映射建立绘图框架确定解读数据所需的绘图框、坐标轴/网格或径向框、图例由数值计算标记包括累计、派生或层级几何添加标注数据标签、轴/类别标签、注解、单位、来源注释以及页面契约中的可见例外套用样式在不改变编码的前提下应用项目排版、调色板、效果与容器处理。2.2 感知读取Perceptual Reading准则选择同一数据最无歧义的呈现方式保留有意义的源顺序或语义顺序否则按页面的比较任务排序可读时优先使用直接的系列标签图例、网格线、刻度仅在能实质减少查找成本时保留可比面板共享域、比例和类别顺序除非披露的差异本身就是信息幅度型柱/条形必须从零基线开始区间型标记保持权威域任何非零基线或坐标轴断裂必须显式标注且不得夸大双轴图仅在两条序列共享完全相同的时间/类别域、且单位与身份保持无歧义时有效否则应拆分为独立视图。2.3 图表配色与标注约定Reference单色深度方案优于彩虹主系列用完整主题色对比系列用同一色相约 60% 透明度基线用灰色虚线强调色只用于关键数据点正/警告/负趋势分别使用整套 deck 的绿/黄/红极性角色在柱子末端或数据点旁放直接数据标签而非依赖图例用文字标注真正的拐点如政策变更产品发布行业均值或目标用灰色虚线对比基线单图内单位与精度保持一致涉及归属或来源时加淡色来源注释。2.4 对象级完整性Per-object Completeness每一个权威系列、类别、点、标签、单位、限定词、来源和比例线索都必须保留。对于object-keyyes的图表即声明为原生 PowerPoint 图表替换对象的对象JSON 必须在同一次编辑中与绘制的 fallback 逐项镜像图例标签逐字一致点级例外颜色进point_colors轴比例、来自绘图区标记的plot_area、可见数据标签或汇总数字进data_labels或伴生文本实际标签/轴/网格颜色如实写入不确定时省略text_color及其同族字段而非猜测。当源数据无法确定所需比例或派生值时在 Default 中上抛到上游解决或在 Quick 中依据显式源事实解决绝不在绘制时编造。2.5 与目录引用的协作边界若页面以chart/key作为主参考则由 executor-visualization.md 负责解析与适配该分支保证参考不是锁尺寸、间距、轴向、分组、方向、密度都可自由调整但权威标签、数值、单位、来源必须保留而本分支依然拥有数值到几何的计算权。从零创作的图表遵循同一契约。偶发的微型视觉小趋势或指标只有在 Default §IX 或 Quick 的活动上下文决策将其提升为坐标校验对象后才进入 §3 校验流程。3. 绘图区标记Plot-area Marker每个校验图表对象的强制身份证3.1 对象级标记每个校验图表对象必选硬性规则——对象级标记每一个在 Default §IXVisualization中键控的图表对象以及每一个被 Quick 提升为坐标校验对象的图表对象都必须有一个页面局部的kebab-case对象键。实现方式用g idobject-key包裹在绘图区分组idobject-key-chartArea内部、坐标轴之后、第一条数据标记之前放置恰好一个标记标记 payload 前缀为objectobject-key |。直角坐标系的矩形绘图区标记模板g idrevenue-trend g idrevenue-trend-chartArea !-- axes -- !-- chart-plot-area: objectrevenue-trend | x_min,y_min,x_max,y_max -- !-- data marks -- /g /g径向图标记的三种标准形式!-- chart-plot-area: objectshare-pie | pie | center: cx,cy | radius: r -- !-- chart-plot-area: objectshare-donut | donut | center: cx,cy | outer-radius: r1 | inner-radius: r2 -- !-- chart-plot-area: objectcapability-radar | radar | center: cx,cy | radius: r --标记值的推导规则值推导x_min/x_maxY 轴线的 X 或最左数据边界 / 最右轴端点或数据边界y_min/y_max最顶网格线或数据边界的 Y / X 轴基线或底部数据边界cx, cy包含平移变换后的绝对圆心r,r1,r2所绘径向几何的可见外/内半径旧格式兼容仅当页面恰好只有一个校验图表对象时才接受无对象作用域的g idchartArea旧标记。仓库中的模板就是活教材column_chart.svg 在idchartArea组内、网格线与坐标轴之后、bar-1之前写了!-- chart-plot-area: 140,150,1160,550 --而坐标计算如185M→ 高度 370px、100M200px正是基于该绘图区完成的area_chart.svg、donut_chart.svg、butterfly_chart.svg 等 33 个 templates/charts 下的计算器支持型模板都携带同一注释约定。注意仅因包含数字就给定性结构或单元格网格表格加标记是违规的标记缺失会触发校验阶段的声明回退并增加不必要的推导工作量。3.2 创作时检查Authoring-time Check每页含校验图表后立即执行rg -n chart-plot-area project_path/svg_output/current_page.svg标记数量必须等于被提升的图表对象数且每个标记都位于其对象包裹组内。3.3 原生布局交接Native Layout Handoff对于原生就绪的经典图表若其绘制的绘图矩形必须保持固定将该绝对矩形复制进元数据plot_area需要 PowerPoint 自动布局时则省略。注意注释本身不影响导出封闭式元数据 schema 由 native-data-interface.md §2 定义——原生替换标记g># 柱状图--value-range 来自轴刻度标签附传形式保护负最小值 python3 skills/ppt-master/scripts/svg_position_calculator.py calc bar --data L1:V1,L2:V2 --area x_min,y_min,x_max,y_max --bar-width 120 --value-range0,axis_max # 折线/散点 python3 skills/ppt-master/scripts/svg_position_calculator.py calc line --data x1:y1,x2:y2 --area x_min,y_min,x_max,y_max --y-range0,max # 饼图/环图 python3 skills/ppt-master/scripts/svg_position_calculator.py calc pie --data S1:V1,S2:V2 --center cx,cy --radius 200 [--inner-radius 120] --start-angle -90 # 雷达图 python3 skills/ppt-master/scripts/svg_position_calculator.py calc radar --data D1:V1,D2:V2,D3:V3 --center cx,cy --radius 200 --max-value 100**比例感知比对Scale-aware comparison**是关键纪律判定错位前必须确认每次调用都使用了 SVG 视觉上声明的轴范围、绘图区、圆心/半径、起始角或尺寸比例——calc bar的输出头必须显示Value scale: axis ticks (...)SVG 有刻度时若显示auto (max*1.1)则说明刻度未读取应回到 Step 3 重读。比例匹配后若坐标确实不同手工更新禁止正则或批量替换。对于decomposable-calc的复合图表svg-pipeline.md 提供了逐图种的配方例如堆叠柱对 N 个系列各跑一次calc bar以各段高度为数据值并把--area的y_max下移该类别所有下段之和哑铃图两端点是点而非柱端类别编号为0.5, 1.5, …, N-0.5用--y-range0,N每个端点系列跑一次calc line瀑布图先算运行累计cum[i] cum[i-1] ± delta[i]再以相同参数跑两次calc bartop与botheight bot.Y - top.Y甘特图由表头刻度位置求出每单位像素跑两次calc line得到每条任务条的x与x width——只有由日期/时长推导的排期才进入校验。面积图没有独立计算模式用calc line输出上边界点再闭合到绘图区底部基线y_max。4.3 更新后的检查器顺序更新任何页面后按档案的检查器顺序走。Default 重跑svg_quality_checker.py project_path --canonical-authoring --stage final --json写出 Step 7.3 所需的当前final报告Quick 先完成全部图表比对/修复再回到 quick-generate.md §4 执行其唯一一次无锁最终检查器——图表页面之间不调用检查器。校验完成后Default 继续 generate-pptx.md Step 7Quick 回到 quick-generate §4 直接导出。5. 与原生图表替换的衔接object-keyyes的原子创作executor-chart.md强调object-keyyes图表的 JSON 必须与绘制的 fallback 逐项镜像、且在同一次编辑内完成。这条规则的实际落点正是 native-data-interface.md §2 的原子创作要求一个对象的可见 fallback、data-pptx-replace-with标记与单个 JSONmetadata子元素是一个创作单元必须在数据仍在上下文中时一次性写出绝不能推迟到 verify-charts、最终门禁或导出阶段。随后用以下命令为 SVG-first 对象盖章python3 skills/ppt-master/scripts/stamp_native_fallbacks.py svg-file-or-directory --write # 不加 --write 为只读预览跳过 JSON-first 标记从 column_chart.svg 可以看到完整形态g idcolumn_chart contenteditable="false">【免费下载链接】ppt-masterAI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations,>项目地址: https://gitcode.com/GitHub_Trending/ppt/ppt-master创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考