Skip to content

Notemd 1.9.4

Latest

Choose a tag to compare

@Jacobinwwey Jacobinwwey released this 21 Jul 14:07

Notemd v1.9.4

Highlights

  • Diagrams are now a source-aware, multi-format platform: CircuitikZ, Draw.io, Drawnix, SVG, PNG, PDF, HTML, and editable artifacts have explicit source, render, preview, and export contracts.
  • CircuitikZ now has an optional managed desktop runtime: Notemd can discover trusted compilers or install a pinned, integrity-checked Tectonic environment outside the Vault, while dependency-free previews remain available.
  • Diagram work is easier to find and manage: Vault-persistent history adds search, filters, completion-time ordering, pagination, artifact actions, direct entry points, and an adaptive right-side drawer.
  • Large settings surfaces are easier to navigate: fuzzy search, stable favorites, and section navigation reduce setup friction without removing advanced controls.

Major Upgrades

  • Added constrained CircuitikZ generation contracts, circuit-family fixtures, topology validation, native compile diagnostics, repair briefs, and SVG/PNG geometry quality gates.
  • Added readable SVG, PNG, and PDF companions plus editable diagram export targets and an offline artifact CLI with BOM-safe input handling.
  • Added a managed CircuitikZ environment with ownership-scoped activation, secure download verification, install/repair/removal actions, compiler discovery, and native smoke tests.
  • Added Vault-scoped diagram history persistence, search, filtering, pagination, missing-artifact feedback, reopen/export actions, and command/sidebar access to the shared adaptive history view.
  • Added settings discovery with fuzzy matching, localized stable favorite identities, section navigation, and focused feedback for empty searches.
  • Added preflight handling for missing or non-empty batch target folders, including task-level confirmation and an opt-in policy to create missing folders automatically.
  • Completed published multilingual documentation routes and content parity, while keeping generated MDX synchronization limited to user-visible route or content changes.
  • Hardened Slidev standalone export across page boundaries, Mermaid fitting, MP4 frame ordering and clarity, and Windows environment probing.

Fixes And Robustness

  • Fixed the diagram history drawer scroll model so long histories remain vertically navigable inside the preview shell.
  • Improved CircuitikZ preview legibility, label placement, line weights, clipping detection, arrow alignment, and multi-format companion readability.
  • Fixed missing-history-artifact reporting and source-only artifact reopening instead of presenting silent or misleading preview states.
  • Fixed diagram artifact CLI handling for UTF-8 BOM inputs and npm argument rewriting on Windows.
  • Stripped NUL bytes from generated documentation pages and hardened GitHub Pages deployment retries.
  • Restored the README Star History and Friendly Links hierarchy.
  • Added explicit source/render-target routing so CircuitikZ no longer falls through an unrelated mind-map generation contract.
  • Fixed npm 10 clean-install reproducibility and made the CircuitikZ, CLI fallback, and website documentation contract tests portable across Windows and Linux release runners.

Comparative Summary

  • Before: CircuitikZ depended on an externally prepared LaTeX toolchain and failures were difficult to diagnose. After: users can keep dependency-free previews, select a trusted system compiler, or install a verified managed Tectonic runtime with native diagnostics.
  • Before: diagram sources and render types were easy to confuse, and source-only artifacts had limited export evidence. After: source, renderer, preview companion, and export target are explicit, with readable SVG/PNG/PDF and editable artifacts where supported.
  • Before: generated diagrams were primarily tied to the current preview session. After: history persists per Vault and is searchable, filterable, pageable, reopenable, and reachable from commands and the sidebar.
  • Before: a dense settings page required manual scanning. After: users can search approximately, favorite recurring settings, and jump between major sections.
  • Before: published documentation routes and Slidev/Page delivery had parity and convergence gaps. After: multilingual routes are complete and export/deployment workflows have explicit verification gates.

Verification

  • npm run chronicle:sync-repo-saga
  • npm run chronicle:update -- --tag 1.9.4
  • npm run build
  • npm test -- --runInBand
  • npm run audit:i18n-ui
  • npm run audit:render-host
  • npm --prefix website run build (all 34 published locales)
  • npm --prefix website run audit:build
  • npm run verify:slidev-export -- --vault docs --source architecture.zh-CN.md --format html --html-mode standalone --output-subfolder export/release-1.9.4 --require-native-standalone --sample-slides all --no-screenshots --json (36/36 slides passed with no overflow, unreadable content, or render errors)
  • npm run verify:diagram-semantics -- --version 1.9.4 --commit HEAD --surfaces mermaid,json-canvas,vega-lite,editable-html-svg --output .cache/release-1.9.4-diagram-verification.md
  • npm run diagram:smoke-circuitikz -- --output-dir docs/export/release-1.9.4-circuitikz-smoke --compile-executable C:\\texlive\\2023\\bin\\windows\\pdflatex.exe --compile-arg -interaction=nonstopmode --compile-arg -halt-on-error --compile-arg -output-directory={outputDir} --compile-arg {tex} --expected-artifact {outputDir}/{jobName}.pdf (6/6 fixtures compiled with zero errors or warnings)
  • obsidian help
  • The optional obsidian-cli wrapper is not installed on this Windows host; the unrelated npm package with that name was not substituted for it.
  • Real Obsidian reload and diagram preview/history acceptance: plugin 1.9.4 enabled, 34 Notemd commands registered, history drawer scrolled from 0 to 200 with overflow-y: auto, and no plugin error notices or error-level console messages.
  • git diff --check

Notemd v1.9.4

亮点

  • 图表现在是识别源类型的多格式平台:CircuitikZ、Draw.io、Drawnix、SVG、PNG、PDF、HTML 与可编辑产物都具有明确的源、渲染、预览与导出契约。
  • CircuitikZ 现在提供可选的桌面端托管运行时:Notemd 可以发现可信编译器,或在 Vault 外安装固定版本且经过完整性校验的 Tectonic 环境,同时继续提供零依赖预览。
  • 图形工作更易查找和管理:按 Vault 持久化的历史支持搜索、筛选、完成时间排序、分页、产物操作、直达入口与自适应右侧抽屉。
  • 复杂设置更易导航:模糊搜索、稳定收藏与大项导览降低配置成本,同时保留高级控制项。

主要升级

  • 新增受约束的 CircuitikZ 生成契约、电路族 fixture、拓扑校验、原生编译诊断、修复 brief,以及 SVG/PNG 几何质量门禁。
  • 新增清晰可读的 SVG、PNG、PDF companion、可编辑图表导出目标,以及支持 BOM 输入的离线 artifact CLI。
  • 新增 CircuitikZ 托管环境,包含 ownership-scoped 激活、安全下载校验、安装/修复/移除操作、编译器发现与原生 smoke test。
  • 新增按 Vault 保存的图形历史、搜索、筛选、分页、缺失产物反馈、重新打开/导出操作,以及从命令与侧边栏进入共享自适应历史视图的入口。
  • 新增设置模糊匹配、已本地化的稳定收藏标识、大项导览,以及搜索无结果时的明确反馈。
  • 新增批处理目标文件夹预检:缺失文件夹或非空文件夹会在任务级确认,并可选择以后自动创建缺失文件夹。
  • 补齐已发布的多语言文档路由与内容一致性,同时将生成式 MDX 同步限制在用户可见路由或内容确有变化的场景。
  • 加固 Slidev standalone 导出,包括跨页内容、Mermaid 自适应、MP4 帧顺序与清晰度,以及 Windows 环境检测。

修复与鲁棒性

  • 修复图形历史抽屉的滚动模型,使长历史列表可在预览 shell 内正常上下滚动。
  • 改善 CircuitikZ 预览的可读性、标签布局、线宽、裁切检测、箭头对齐与多格式 companion 清晰度。
  • 修复历史产物缺失反馈与仅源文件产物的重新打开行为,避免静默或具有误导性的预览状态。
  • 修复 diagram artifact CLI 对 UTF-8 BOM 输入及 Windows npm 参数重写的处理。
  • 清理生成文档页面中的 NUL 字节,并增强 GitHub Pages 部署重试。
  • 恢复 README 中 Star History 与 Friendly Links 的正确层级。
  • 建立明确的源与 render target 路由,避免 CircuitikZ 错误落入无关的 mind-map 生成契约。
  • 修复 npm 10 冷安装的可复现性,并使 CircuitikZ、CLI fallback 与网站文档契约测试可在 Windows 和 Linux 发布 runner 上稳定执行。

对比摘要

  • 改动前:CircuitikZ 依赖用户自行准备 LaTeX 工具链,失败原因也难以诊断。改动后:用户可继续使用零依赖预览、选择可信系统编译器,或安装经过校验的托管 Tectonic,并获得原生诊断。
  • 改动前:图表源类型与 render 类型容易混淆,仅源文件产物的导出证据有限。改动后:源、renderer、预览 companion 与导出目标均明确分离,并在支持时提供清晰的 SVG/PNG/PDF 与可编辑产物。
  • 改动前:生成图形主要依附当前预览会话。改动后:历史按 Vault 持久化,可搜索、筛选、分页、重新打开,并可从命令与侧边栏直达。
  • 改动前:设置页内容密集,只能手动逐项查找。改动后:用户可以模糊搜索、收藏常用设置,并在主要设置分区间快速跳转。
  • 改动前:已发布文档路由以及 Slidev/Pages 交付存在一致性与收敛缺口。改动后:多语言路由完整,导出与部署流程也具有明确的验证门禁。

验证

  • npm run chronicle:sync-repo-saga
  • npm run chronicle:update -- --tag 1.9.4
  • npm run build
  • npm test -- --runInBand
  • npm run audit:i18n-ui
  • npm run audit:render-host
  • npm --prefix website run build(全部 34 个已发布 locale)
  • npm --prefix website run audit:build
  • npm run verify:slidev-export -- --vault docs --source architecture.zh-CN.md --format html --html-mode standalone --output-subfolder export/release-1.9.4 --require-native-standalone --sample-slides all --no-screenshots --json(36/36 页通过,无溢出、不可读内容或渲染错误)
  • npm run verify:diagram-semantics -- --version 1.9.4 --commit HEAD --surfaces mermaid,json-canvas,vega-lite,editable-html-svg --output .cache/release-1.9.4-diagram-verification.md
  • npm run diagram:smoke-circuitikz -- --output-dir docs/export/release-1.9.4-circuitikz-smoke --compile-executable C:\\texlive\\2023\\bin\\windows\\pdflatex.exe --compile-arg -interaction=nonstopmode --compile-arg -halt-on-error --compile-arg -output-directory={outputDir} --compile-arg {tex} --expected-artifact {outputDir}/{jobName}.pdf(6/6 fixture 编译成功,0 error / 0 warning)
  • obsidian help
  • 本 Windows 主机未安装可选的 obsidian-cli wrapper;没有使用 npm 上同名但不兼容的包冒充该工具。
  • 在真实 Obsidian 中重载并验收:插件 1.9.4 已启用,34 个 Notemd 命令已注册,历史抽屉以 overflow-y: auto 从 0 滚动到 200,且没有插件错误提示或 error-level console 消息。
  • git diff --check