bowen-0x00/obsidian-excalidraw-example-vault/obsidian-excalidraw

Obsidian Excalidraw：原生绘图与真实 PNG 闭环

先决定目标和视觉，不要求用户写坐标

• 使用已发现的真实drawing_* MCP，前缀/schema以客户端为准；相对references路径属于当前Skill，客户端支持时才用skill://obsidian-excalidraw/...。
• 新图用唯一文件名创建独立.excalidraw.md；已有图按明确file_path绑定，保留file/contextToken/revision。不能用active/first、clear重画或手拼整场景JSON。
• 新图用真实ask一轮收集未定风格、色板/背景、字体及验收low/medium/high（默认medium）；与视觉偏好合并，最多五题，颜色编码可合入色板/按用途默认。提示词已指定、同套图已选、局部改图或“你决定/直接画”不重问；没有ask用编号问题。验收等级不是模型effort，不因effort低而跳过选择或省略必需检查。
• 已给定专业平整等方案时直接执行，不为重复选型读取整份风格问卷。正文20/标题28、roughness0、线宽2、矩形固定roundness:{type:3,value:6,roundType:"arc"}作为视觉起点；字体必须从当前宿主集合按角色与语言选定，不假设某个字体必有。标题粗体用真实text ID的set_text_global_style，非顶层bold。
• 配色落实为实际hex；strict任务同时控制底色、正文、边框，不能偷偷补默认蓝色。手绘线条和字体独立选择；字体先discovery确认，颜色/字重/尺寸最终读回并查看PNG，不凭profile名称认定生效。
• 创建文字、选/换字体先读[通用字体工作流](references/typography.md)：接口取得当前完整集合和来源→Agent按证据判断用途/未知项→按正文/代码/标签/注释等角色选实际family→用该family测量、落地、看PNG。不是本地字体白名单，也不让profile/代码primitive的历史默认名称替代发现；注册、字形覆盖、加载和实际fallback分别验证。已有图未请求换字则继承。
• 语义决定箭头：数据流triangle，强调推进可用PPT宽箭block_arrow/block_arrow_outline（不限于PPT页），UML用真实空心三角/菱形；不擅加双向。箭身宽走customData.blockArrowWidth，长度走端点/路径，头比例走arrowHeadSize，描边走strokeWidth，按空间主动选粗短/细长；先核对runtime支持，详见箭头选型与尺寸。普通elbow转角{type:2,value:6}/value0不等于block分支曲线。
• 绘图前读[分级验收](references/acceptance.md)：low基本检查，medium重点内容/可读/遮挡，high再细查连接与层级风格；高等级不强制每根箭头绑定。合法文字置于背景框上不算冲突；字互压、线穿字、后画对象盖字、换字体/字号导致不可读，中高等级优先修复。具体几何误报按issueId＋当前PNG＋理由处理，不能全局忽略。

硬件任务必须先分流

CPU/流水线/微架构/硬件数据通路/阵列/缓存层级/寄存器堆/片上互连：创建前必须读[microarchitecture](references/microarchitecture.md)，先定独立部件、命名端口、信号表、时序边界与固定区域，再选图元/库和路由。不能走普通服务架构快路径后，把ALU/RF/MUX/Hazard等缩成“IF/ID/EX阶段：项目符号列表”；检查失败不得降粒度、删除反馈线、重放整图追加副本或换新图刷通过。kind:"microarchitecture"不是专用硬件布局器，container也不固定流水级列。 硬件制作按专用参考的“契约→固定骨架→部件/端口→分批网络→保存后审计→全图/局部→最小补丁”执行。信号默认必须水平/竖直或正交elbow；两点起终点同时dx/dy非零就是斜线，不能只看angle0或check=pass。显式计算waypoints/逐段读回审计，保留ID和端点语义；符号多边形斜边不在此约束内。

默认低往返路径（0.8.10起）

减少模型轮次，不减少绘图能力或验证。 一次读齐本任务所需schema；可并行读取独立资料/只读状态。todo更新与下一步操作同一轮，不为一次进度更新单独等模型；用户显式要求计划时照做。 对普通服务/业务节点＋连线，且视觉方案已给定：本页字段足够时直接用快路径，不为标题粗体/R6/triangle遍读所有参考。此规则不适用于硬件微架构，硬件必须先读专用参考；复杂固定列/多端口/总线图用显式位置/尺寸、原生operations与真实素材。查接口问题优先读取该工具schema并修字段，不扫整个能力库。

1. 有drawing_setup先status；已连接时discovery核对字体/引擎。可同轮发独立只读请求。连接失败先按真实前提恢复，不能假设画布存在。远端只status，不connect/start/reload宿主。
2. drawing_context(create,filename,foldername)或明确file_path绑定，取得token和revision。多Agent各自一图，只由协调者管理服务，宿主串行执行；同图竞争发生REVISION_CONFLICT就重新读，不覆盖用户新编辑。
3. 普通节点/流程/架构优先`drawing_compose(context_token,base_revision,diagram)`，即使没有素材库也适用。它在代码内完整plan→apply，复用同一测量/布局/绑定和事务，不让模型复制一大段plan.operations。库组合仍按阶段提交并报告已执行集合，不宣称跨阶段原子。
4. 没有后续样式时compose传inspect:true,acceptance_level:本次选择；还需样式时先compose，再一次apply(inspect:true)按refs局部修正。expected覆盖任务关键内容/关系；后续省略等级/断言会继承同context设置。operations每项必须有op不是type；标题粗体用{"op":"set_text_global_style","targets":["refs中真实textID"],"bold":true}。不为绕检查重建整图。
5. inspect:true返回实际PNG ImageContent及JSON：composition或applied回执、check完整诊断、preview注册预览（含同revision全图canvasSummary/路径/hash）、毫秒timings。内部真实full-read+结构/几何/语义check→按该revision导出，不缓存过期结果、不自动review。默认false保持原接口；check失败仍展示PNG供修复，不能当完成。
6. 查看真实PNG，再review(visual_reviewed:true,visual_checks:实际结论,visual_issues:具体问题)。medium记录content/readability/occlusion，high再记录connections/hierarchy_style，值pass/not_applicable/fail；不能复制pass或对有文字图以not_applicable跳过。review以当前状态重算；几何候选可逐项dispositions记录合法构图/误报原因，引用/语义错误不可豁免；详见分级验收。
7. 有问题只改受影响元素/绑定文字/邻边，apply(inspect=true)得到下一轮PNG再看。默认最多5轮（初图计1），达到要求立即停止，连续两轮无改善或上限到达则needs_attention并报告剩余项；不换token重置预算。

inspect是合并已有步骤，不是原子跨请求事务：check/render前用户改图会拒绝过期状态；提交后的检查/导出失败明确返回已提交receipt和phase，不能假称回滚。原生ID、绑定、资源与全图摘要不因此减少。

图描述与常用操作

• diagram：kind=flowchart/architecture/swimlane/freeform，nodes含唯一id/shape/label，edges含id/from/to/label/fromPort/toPort；containers/lanes保留归属，layout支持TB/LR、间距和可负origin。节点内容image/latex/echarts/embeddable及UML/电路等按下表读相应参考。
• edge的startArrowhead/endArrowhead放edge顶层，显式null表示无头；style放stroke/roughness/roundness。三角头triangle不是filled_triangle；两种block是整条宽箭身。高层不自动转发blockArrowWidth，按refs补patch_custom_data；set_arrow_style不接受该宽度字段。先发现实际头型集合，不能只因插件已更新就假设旧Bridge支持。
• PPT两种宽箭都能独立设strokeColor（轮廓）与backgroundColor（内部填充），fillStyle另控填充方式；普通细线身主要用strokeColor，不套宽箭填充语义。outline默认画布底色而非天然透明；改宽/改色分别操作并看实际PNG，不能用描边宽代替箭身宽。
• 需要先审查计划、手动坐标或复杂增量时，原有read/measure/plan/apply/check/preview/primitives等全部保留。plan.operations完整交给apply，尽量程序传递；原生CLI、EA与MCP schema不可混用。
• 语义断言示例：{type:"label_equals",id:真实节点或textID,text:全文}、{type:"edge_label",from:起点ID,to:终点ID,text:"通过"}。普通check不等于所有业务语义已覆盖。
• operations的op是执行动作；expected的type是断言种类；nodes的shape才是图元种类。三者不可混用。只按返回refs填写native IDs，不能把示例ID原样提交。用户没要求连线标签就不为装饰添加标签。
• set_text用真实text/owner；translate保持精度并去重bound text；resize改单元素尺寸不等于整组缩放；scale_selection/rotate使用完整group或精确targets，维护绑定。细节及所有操作见完整工作流。

完整摘要与不可省略的质量门

• drawing_read默认返回全部未删除元素、coverage=complete、file/revision/count/total、precision2、世界bounds；不是只选中元素。分页有total/truncated，ids查询不作全图证明。坐标取整只供反馈，绝不回写覆盖精确值。
• preview和inspect.preview均含同revision全图canvasSummary：id/type/geometry、必要文字、bindings、group/frame/锁定等；长文字标截断并用full按需读完整源，密集点列用pointCount。几何/空值/省略字段、并发与完整遍历详见完整工作流。
• 由PNG定位ID后局部改：scene坐标=sceneOrigin+原PNG像素/scale；阅读器缩放需先还原原像素。不能拿截图像素直接写x/y，不能手填boundElements/startBinding/endBinding或原生version/index。
• 完成标准：用户内容/关系齐全、资源complete、当前PNG实际看过、本等级阻断项解决且review=completed。几何unknown/重叠候选可凭具体当前PNG审查并披露限制，不等于自动几何证明；不为装饰/合法背景包含无限修图。禁止删边、裁全文或缩成不可读来“通过”。
• 硬件图必须按专用部件/端口/关键网络清单验收，expected不得空却宣称“语义100%通过”。几何pass不等于微架构正确，review也不自动证明专业质量。overview有效字高≈actualScale×fontSize；缩成6px的小字条带必须调整或实际查看必要局部，不把complete=true当可读。
• 微架构另有独立正交门：精确read世界点列，逐段排除dx/dy同时非零的信号线并报告ID/段索引；现有通用check不含这项保证。只修route不降粒度、不盲目重放；实际修复轮数累计，不能用新token重置。
• 字体验收核对真实family、全文、字重、混合语言、易混字符和输出字高；属性名/测量相同不证明无fallback。换字体后重测并重排受影响对象。普通planner不是多角色字体引擎，混排走已确认的measure＋原生text操作，不传虚构role/font字段。
• 原生可编辑性优先：保留shape/text/arrow/frame/group、图片源/LaTeX源、SVG path、扩展配置；不能默认用整图图片替代。有分支时全文和“通过/未通过”标签都核对；长中文菱形适度换行，不横向撑成全图。
• 数学$…$不在普通text中自动解析；用真实create_latex或宿主Extract-Latex/原生text+公式组合，保留源TeX，缺MathJax明确报告，不能留源码冒充公式。转换会替换text ID且影响frame/group/层级，先读混排公式。
• 线交叉用修改版lineCrossings的arc/gap/dot/none；dot不建立电气绑定。禁止白色遮罩、假小弧/圆点、拆线模拟交叉；样式和priority边界见排版参考。曲线/非直角旋转等精确检查仍可能unknown，不能伪称全通过。

按需读取，不删除高级能力

“绘图脚本目录”取插件settings.scriptFolderPath，不假设个人路径；受管脚本在Agent-Drawing子目录。Token只留私有状态目录，不打印/放图/报告；不自动授信、autorun或改全局主题。mode=remote时渲染在宿主，PNG/ledger属于远端，MCP ImageContent已可看，不需要X11。

交付真实vault文件、最终PNG、check/保存结果、review轮数与剩余限制；CLI-only没有MCP ledger须明确记录实际评审。任何能力都以真实入口/源/API和实际运行证据为准，不捏造工具或完成状态。