Skip to content

v0.2.1 — Progressive load & lower instruction context

Choose a tag to compare

View all tags
@endlessYoung endlessYoung released this 10 Aug 16:52
· 3 commits to main since this release
v0.2.1
332a6bb

visual-architecture v0.2.1

Release relative to v0.1.0: progressive loading, shared visual/routing contracts, scriptable validation, and substantially smaller skill-instruction context.

Highlights

  • Progressive loading — Interview and full generation load instructions by stage, instead of pulling every design system and gate into the first turn
  • Shared contracts — contracts/routing.md and contracts/visual.md as the single source of truth for routing and visual rules
  • Validatable artifacts — schemas/ plus bin/validate-{ir,resolution,layout}.mjs
  • Package entry — Root SKILL.md as the install/discovery entrypoint
  • PNG export (G11) — Self-contained HTML must expose a visible PNG export action

Performance (instruction context)

Scenario Before (≈tokens) Now (≈tokens) Reduction Relative efficiency
Interview 4,100 2,083 49.2% 1.97×
Full · Apple Document 32,000 12,463 61.1% 2.57×
Full · Neural Blueprint 31,000 12,307 60.3% 2.52×
Full · Cyber Nexus 30,000 11,821 60.6% 2.54×

Metrics measure skill-instruction context (unique bytes ÷ 2.8), not end-to-end wall-clock latency. Detailed audit protocols remain in the development repository and are not shipped in the npm / npx package.

Behavior changes

  • Grill-me: one recommendation package + one confirmation; after that, “you decide / just generate” accepts the package
  • Routing policy standardized to orthogonal-shared-bus
  • Nested skill/SKILL.md removed in favor of the package-root entry

Install

npx visual-architecture@0.2.1
# or
npx visual-architecture@latest

Links

简体中文

相对 v0.1.0：渐进加载、契约化视觉/路由、可脚本校验，以及显著降低的 Skill 指令上下文占用。

亮点

  • 渐进加载 — Interview 与完整出图分阶段加载指令，避免首轮灌入全部设计系统与门禁
  • 共享契约 — contracts/routing.md、contracts/visual.md 作为路由与视觉 SSOT
  • 可校验产物 — schemas/ + bin/validate-{ir,resolution,layout}.mjs
  • 包入口 — 根目录 SKILL.md 作为安装/发现入口
  • PNG 导出（G11） — 自包含 HTML 必须提供可见的 PNG 导出

性能（指令上下文）

场景 优化前（≈tokens） 当前（≈tokens） 降幅 相对效率
Interview 4,100 2,083 49.2% 1.97×
完整路径 · Apple Document 32,000 12,463 61.1% 2.57×
完整路径 · Neural Blueprint 31,000 12,307 60.3% 2.52×
完整路径 · Cyber Nexus 30,000 11,821 60.6% 2.54×

指标为 Skill 指令上下文（unique bytes÷2.8），非端到端墙钟。详细审计协议仅保留在开发仓库，不随 npm / npx 包分发。

行为变化

  • Grill-me：一套推荐 + 一次确认；之后「你定 / just generate」即接受该方案
  • 路由策略统一为 orthogonal-shared-bus
  • 移除嵌套 skill/SKILL.md，统一使用包根入口

安装

npx visual-architecture@0.2.1
Assets 2
Loading