Skip to content

QGraphFlow v0.0.6

Latest
Latest

Choose a tag to compare

View all tags
@supermax92 supermax92 released this 04 Oct 19:26
· 25 commits to main since this release
v0.0.6
4a551da
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

修复与更新

命令行与分发

  • 新增 qgraphflow 命令（validate / generate），要求 Node.js 22 及以上。npmjs 包 qgraphflow 就是本 Release 的 tgz 原样发布，可直接 npx -y qgraphflow validate …，无需登录任何 registry。
  • generate-viewer 每次生成都为每个视图写一个浅色 SVG：单张图写 diagram.svg，集合写 diagram-<n>-<diagramType>.svg；在 Chromium 里原地保存时同步重写 SVG。
  • 一行安装 npx skills add supermax92/qgraphflow，已用 skills 1.7.0 实测 Claude Code、Codex、Cursor、Qoder。
  • GitHub Pages 在线演示：https://supermax92.github.io/qgraphflow/ （电商九视图与 agent-desk 示例，en / zh-CN）。
  • CI 增加 Node 24；发布工作流新增 npmjs 任务（可信发布、附 provenance、仓库不存令牌，已在 npmjs 上的版本只核对不重发）。

活文档

  • 带 --repo-root 校验时，检查 symbol 是否仍在记录的 lineStart–lineEnd 之内，不在就报错并给出候选行号；--fix --repo-root 在检查词唯一时自动重新定位。
  • SKILL.md 增加"刷新已有图"的流程；README 给出 CI 配置片段，失败时指出是哪张图。

图记法

  • 状态图按 UML 记法重画：entry / do / exit 动作格、自转移弧线、开放箭头；转移文字按触发、[守卫]、/ 效果 分层着色；状态卡片按生命周期语义着色，图例按实际出现的色调列项。
  • 时序图：带 replyTo 的同步调用要求被调方有激活条，--fix 自动补上；消息缺 route.messageY 时查看器不再白屏。
  • 标题、连线文字、分支词按 meta.locale 的语言写；连线标签换行不再拆开标识符。
  • 架构图、部署图的卡片装饰图形不再压住角标和文字。

布局

  • 连线交叉的有界局部搜索（端口、分支侧、折线通道互换，只在得分更好时保留）。
  • 精修只按评估次数结束，超时改为单次 ELK 求解的防挂死保险：慢机器或满载时同一张图排出同样的布局。

示例与文档

  • 电商示例（7 种语言）的时序图与状态图改用新记法。
  • 七种语言 README 第一屏：在线演示链接、一行安装、差异说明、"让图和代码保持同步"一节；需要 PAT 的 GitHub npm 安装说明换成 npmjs；README 致谢 Cocoon-AI/architecture-diagram-generator。
  • 精简 16 项：移除 motion 依赖与 effects.css、去掉 54px 消息间距兜底、删除不再被引用的夹具等。

不兼容变化

  • 输出目录除 index.html、graph.json 外还会有 SVG 文件；目录里已有同名 SVG 时需要 --force 才能覆盖。
  • 带 --repo-root 时，symbol 不是源码原文的旧图会校验失败：运行 --fix、手动改锚点，或删掉可选的 symbol。
  • 带 replyTo 的同步调用缺被调方激活条时命令行校验失败，运行 --fix 自动补上；没有 replyTo 的旧图不受影响。

安装包

下载 qgraphflow-0.0.6.zip，解压并保留隐藏文件；按 README 注册到客户端。.tgz 提供相同运行时内容，SHA256SUMS 用于校验。GitHub 自动生成的 Source code 压缩包不是精简插件安装包。

运行包 78 个文件（tgz 840,981 B，zip 894,960 B）。npmjs 包 qgraphflow@0.0.6 与 GitHub Packages 包 @supermax92/qgraphflow@0.0.6 均由本页附件发布；Qoder Desktop 商城条目需另行更新。

验收与保留项

  • Node 自动化测试 209/209 通过（本机 Node 22）；PR #4 与 main 上的 CI（Node 22 / 24）及 Pages 构建通过，在线演示已部署。
  • claude plugin validate . 通过。
  • ZIP/TGZ 内容一致（78 个文件），包内两份商城文件的 name 均为 supermax92，六处版本号均为 0.0.6；安装包从 v0.0.6 的干净导出构建，tgz 与合并前在 3d99cd7 上的演练构建逐字节一致。
  • 从解压后的运行包：qgraphflow validate 通过；电商示例生成 9 个视图与 9 个 SVG。
  • 保留 showcase-v1、showcase-v2、v0.0.5 的附件、tag 及 npm 旧版本。

本次验收不代表全部客户端或官方插件市场已经完成验收。

提交

  • 73564d3 ci: npm 发布工作流的校验改为 --input-only，九类图输入改用仓库示例
  • dcf2aad Merge pull request #2 from supermax92/refactor/q-flow/20260917-skill-guidance
  • 569e2a1 docs: README add（Cocoon-AI/architecture-diagram-generator）
  • 8ce6f6c Merge pull request #3 from supermax92/docs/readme/20260928-inspiration-credit
  • 518d8ac feat: 命令行导出 SVG、源码锚点漂移检测与 npmjs/Pages 分发
  • 434956a test: 兼容 npm 11 的 npm publish --json 输出格式
  • 487e69e feat: 状态图按 UML 记法重画，并收尾时序激活条、连线文字语言与布局交叉精修
  • 83feba2 fix: 修复审查发现的激活条、自转移弧线与布局打分问题
  • 9f40986 feat: 状态图按生命周期语义着色，连线标签换行不再拆开标识符
  • e3f2f9b fix: 布局精修与超时不再依赖时钟
  • abe8fa9 feat(showcase): 电商示例的时序图改用新记法
  • 54501d3 fix: 多段连线标签也按触发/守卫/效果着色
  • 85abf49 feat(showcase): 电商示例的状态图展示 entry 动作格与自转移
  • 9110869 merge: 合并状态图语义着色与连线标签换行（feat/q-flow/20261004-state-tone-label-wrap）
  • 9cf69d8 fix: 时序图消息缺 route.messageY 时不再白屏
  • 3d99cd7 chore: 发布 v0.0.6，版本号与安装包引用同步更新
  • 4a551da Merge pull request #4 from supermax92/feat/q-flow/20260928-svg-living-docs-distribution

完整差异

Assets 5
Loading