科学图形重建与绘制 是做什么的?
一个独立的、提供者中立的技能。调用主机决定绘制什么;引擎执行声明的几何图形、颜色、图层、编辑和导出。交付 SVG 以及从该 SVG 渲染出的 PNG。使用 Anaconda ScientificFigure_skill 和已安装的 figure-cli。
0.10 指南:两个任务,同一个主机和场景
当前引擎 0.10.0 在 0.9 基础上增加了确定性布局质量审核(layout-audit)、有边界的布局修复(--fix)和字体配置文件预检查。FigurePlan 0.1 和 Scene 0.3 保持不变,0.8 的执行、编辑和渲染基础得以保留。调用主机已经是执行解释和视觉审查的模型;不要添加第二个模型或 Agent。请参阅 0.10 计划 和 质量审核合同;0.9 计划、0.8 功能 和 语义规划 / 新 CLI 工作流 对以下所有内容仍然有效。工作流页面定义了已实现的入口点和确切的文件合同;交付说明 记录了实际的验证和限制。
在构建复杂图形之前选择任务指南:
- 参考重建: 阅读 参考重建。在几何图形之前确定信息结构和阅读顺序、基本部分、关系以及具体未知项。分离实体、过程箭头、标注引导线、放大视图、图例和装饰。不要根据专业知识填充无法读取的区域。
- 自然语言设计: 阅读 文本设计。分离用户明确的内容、设计选择和科学假设。围绕请求的机制设计层次结构;不要发明准备、管理或实验条件。
- 两个任务: 当方法不确定时,使用 构建选择。根据所需的形状、部件、重复、孔洞、遮挡和样式进行选择,然后比较实际可用资源。一个简单的平面对象可以直接从简短的意图/未知注释进入几何图形和预览;无需强制搜索或多个规划文件。
默认自治;仅在被要求时暂停
| 模式 | 启动时机 | 主机行为 |
|---|---|---|
autonomous(默认) | 用户要求绘图或表示完成 | 绘制、检查、纠正并交付;不因每一步骤的批准而暂停 |
interactive | 用户要求查看样本、确认每页或参与 | 发布已确认的检查点并等待反馈或批准 |
- 打开审核页面不会强制暂停。在自治模式下,在下一个安全检查点读取新反馈;如果用户要求停止,则停止发布候选方案并先处理其编辑。
- 在交互模式下,完成并发布第一张达成一致的页面,等待,然后继续。对于多页工作,第一张批准的页面固定共享的排版、间距、卡片样式和调色板规则;后续页面共享这些规则,而不是强制相同的布局。
- 无法读取图像的主机可以使用几何和结构检查,但必须将视觉审查标记为
not_executed。 - 批准一个 SVG 版本不是科学审查,也不表示批准后续版本。
默认流程:理解、选择、构建、检查、纠正
- 说明目的、预期的显示尺寸、模块和阅读顺序。列出对象、不可或缺的内部部件、可编辑单元、标签、颜色含义和关系。保持未解决的内容明确。对于复杂图形,在编写大量几何图形之前,使此草稿可检查。在有用的地方使用现有的 FigurePlan 模块/对象/关系;未选定的构造可以保持
unresolved。这些是单个规划输入的阶段,而不是另一个场景树。 - 仅询问影响决策的局部问题:例如,一个浅色区域是开口还是表面,或者引导线在哪里结束。检查原始图形和相关裁剪区域;仅在必要时使用基于源的证据。保留 ROI 和坐标映射。测量值和相似度分数是观察结果,而不是对象标识或科学置信度;不存在隐式 OCR。
- 根据结构和样式选择配方/资产/直接/程序。检查实际的配方参数和可编辑部件键或资产权利和导入限制。目录包含 15 个配方系列、两个符号系列元数据条目和一个 Twemoji 柠檬资产;不要发明鼠标/烧瓶/头像配方。如果配方缺少必需的部件,则拒绝该构造并回退到自由程序,可选地组合合适的子部件。使用局部坐标、曲线、变换、现有的绘图函数和成熟的库。直接场景、旧的语义计划 0.3 和
SceneBuilder仍然有效;在开始绘图之前不要要求编写大型手写 JSON。 - 首先构建主要结构和必需的内部部件,然后是连接器和标签。保持稳定的对象/部件 ID。酌情使用填充表面、描边、真实孔洞、有边界的遮罩/遮挡、重复和渐变;不要向平面艺术添加体积光照。主机通过常规工具明确运行程序并提供生成的场景片段;检查/编译和项目加载不运行保存的源代码。保持新的候选方案与已编辑的项目分开,并在接受之前使用 B/U/C 合并。
- 以预期的显示尺寸读取实际的
preview.png,并检查放大的关键区域。检查模块和连接 → 轮廓/比例/孔洞 → 必要的内部结构 → 颜色/图层 → 文本。在同一比例下比较参考图;当替换早期绘图时,同时比较参考图/旧图/新图。有效的计划、命名的路径或通过的测试无法证明绘制的结构是预期的。 - 将每个发现与 ID 和具体行动联系起来:更改构建方法、替换候选方案、调整几何/参数、获取局部证据或保留不确定性。针对当前修订版应用补丁,或重新生成候选方案并进行合并;再次渲染和检查。默认最多进行三轮有针对性的纠正。保留已接受的对象和用户编辑。将视觉评估绑定到当前场景/预览;更改的几何图形、资源或渲染会使旧的评估失效。报告遗漏和未执行的审查。科学审查保持独立,在未要求时不执行。
成功意味着绘制良好、结构清晰的图形,其主要部分可独立编辑。测试确立工程行为,而非绘图质量。独立主机消融、保留基准测试活动、人工小组、领域认证、运行时集成、跨版本模板迁移以及实验性偏移/可变宽度开发不在当前工作范围内。不要将它们变成先决条件或未经请求的下一个任务。分别报告实际重用情况,作为外部艺术作品、绘图代码重用和几何/渲染库重用;在注册表中拥有资产并不意味着此绘图使用了它。
主机可以编写 Python 或 JavaScript 绘图程序。使用普通变量、函数、局部坐标、变换、重复和成熟的几何库来计算形状;在可用时使用稳定的引擎辅助函数。允许特定于图形的绘图程序;不要将少量参考图形变成主题特定的引擎算法,或将示例计划视为科学模板库。将生成的场景/计划候选方案通过引擎验证、渲染和项目事务。当针对已编辑的项目重新运行时,在接受更改之前比较最后生成的基线、当前场景和新候选方案;保留用户编辑并报告冲突。使用可用的 构建辅助工具 和 生成协议:generation diff PROJECT --candidate SOURCE --output DIFF,检查建议的预览和冲突,然后 generation accept PROJECT --candidate DIFF --base-revision N。保存的源代码是惰性的;接受会重新计算合并并检查当前修订版/内容/收据。切勿用纯脚本输出覆盖已编辑的项目。不要嵌入光栅图像,将每个纹理追踪为微小的路径,或用吸引人的填充替换缺失的结构。
在绘图之前选择是从提供的参考重建还是允许的资源重用。分别披露:外部艺术作品(来源、许可证、版本/哈希和修改);重用的绘图代码,包括您自己的函数(文件/版本、重用部分和更改);以及几何/渲染库(实际库/版本和角色)。本地编写的函数不是外部资产,库调用也不是借用的艺术作品。单独记录方法灵感与复制的代码;复制的外部代码需要其固定的源代码修订版、文件、许可证和声明。对于明确冻结的光栅比较,绝不用官方源 SVG 替代。在相同的纠正预算内,检查实际预览中的主要结构、几何/孔洞/遮挡,然后是样式/文本。背景色的覆盖补丁不能建立真正的孔洞或可编辑的交错。程序源是重现性的输入;接受的场景是唯一当前可编辑的权威。打开项目或包不得执行绘图程序。
使用文件执行,无需模型服务
conda run -n ScientificFigure_skill figure-cli doctor --json
使用 inspect reference.png 获取源大小/哈希值。基于源的计划声明 SHA-256、大小和 ROI。旧版计划 0.3 语义执行不会隐式运行颜色分割、像素候选搜索或骨架分析。旧的计划 0.1/0.2 输入保留其行为。
conda run -n ScientificFigure_skill figure-cli reconstruct reference.png --plan plan.json --output work/figure
草稿预览循环和阶段计时
draw 和 reconstruct 接受 --preview:它只写入 figure.svg、preview.png 和 preview.json,除非 --scale 另有说明,否则以比例 1 渲染,并可能替换其自身的先前预览。它不是项目或可交付物——没有收据、对象清单、质量审核记录、审核绑定或参考比较——因此将其用于首次检查以及每次纠正轮次,然后在结构正确后使用不带 --preview 的相同命令运行。
conda run -n ScientificFigure_skill figure-cli draw plan.json --output work/quick --preview
两个路径都以秒为单位返回 timings:validate、to_svg、render、inventory、qa、publish、total;预览省略交付阶段,收据记录相同的发布前阶段。在此主机上,一个包含 501 个对象的场景作为预览大约需要 0.33 秒,作为完整项目大约需要 1.16 秒,大部分差异来自比例 1 和比例 3 的 PNG 渲染。引擎无法看到模型端的时间:在测量重建时,记录主机的首次推理、输出令牌和纠正轮次,以及这些数字,绝不要将引擎秒数归因于模型延迟或反之。
在复杂构建之前检查文本和字体
将要绘制的每个字符串——标签、公式、单位、轴文本、图例——收集到一个请求中,并在几何图形之前运行此操作:
{"schema_version": "0.1", "texts": ["Cell membrane", "H₂O → O₂", "细胞膜"]}
conda run -n ScientificFigure_skill figure-cli font-probe texts.json --output work/fonts
status: ok 选择一个真实的本地字体并写入 font-probe.json 和 font-probe-sample.png;needs_input 列出缺失的字符和每个字体的覆盖率。--font PATH 添加特定文件。--profile(默认名称 scientific-default)另外将打包的建议(Times New Roman / Microsoft YaHei / Cambria Math)与已安装的字体进行解析,并报告每个角色的路径、字体、摘要和缺失的示例字符;缺失的族报告为缺失,绝不替换。引擎渲染一个族,因此不要声称混合字体回退:自己将 SCIENTIFIC_FIGURE_FONT 设置为选定的路径,或简化文本。对于几页,在页 1 之前一次探测所有页的并集。缺失的字形是构建决策,而不是最后一刻的导出错误。
在绘图时显示图形
conda run -n ScientificFigure_skill figure-cli draw plan.json --output work/quick --preview
conda run -n ScientificFigure_skill figure-cli review-serve work/quick --open
conda run -n ScientificFigure_skill figure-cli review-status work/quick-review
review-serve 在 127.0.0.1 上服务最新成功发布的 figure.svg,带有一个随机令牌,并在阻塞前打印 URL。该页面在重新加载期间保留缩放、平移和未发送的固定,并允许用户将评论固定到对象 ID 或空白区域。review-status 读取反馈日志。添加 --wait --timeout N 以阻塞直到新的一轮到达;没有它,用 Ctrl-C 停止。服务器只读取图形并写入反馈;它从不编辑项目。
反馈存储在 <preview>-review/feedback.json 中,位于可替换预览目录之外,每个提交都绑定到显示的 SVG SHA256 和修订版。来自旧版本的提交被拒绝并返回 HTTP 409,绝不静默应用。通过正常的补丁或生成合并应用已接受的评论,然后发布新预览。本地页面是浏览器回退;它不创建 VS Code 侧边栏,并且嵌入式主机仍然必须将此反馈视为此版本化的文件。
交付纯图形和最终 SVG
conda run -n ScientificFigure_skill figure-cli export-variants work/figure --output deliverables/figure
这将读取一个经过验证的项目并写入 figure.final.svg 和 figure.graphics.svg(无文本)以及 variants.json。两者都来自同一场景,因此共享 ID 保持相同的几何和样式;不会重新绘制任何内容。文本...