NoteConnection v1.7.0

NoteConnection v1.7.0

English

Release Scope

• Compare baseline: v1.6.8..v1.7.0
• Commits: 16
• Files changed: 36
• Churn: +6,539 / -67

Highlights

• Finalized startup acceleration rollout with Phase 2/3/4 runtime improvements:
  • startup delta tick transport (full|delta) with low-alpha adaptive policies
  • frame-coalesced startup tick application on main thread to reduce redundant paints
  • staged edge rendering and startup overlay stabilization flow
• Hardened warm-start reliability with strict snapshot validation:
  • fingerprint and topology consistency checks
  • snapshot age guard
  • position coverage threshold checks before restore
• Extended startup validation automation for release readiness:
  • baseline vs pilot compare report
  • platform matrix report + strict watch mode
  • no-hardware engineering signoff pipeline (Windows real logs + simulated cohorts)

Subsystem Notes

• Frontend Runtime (app.js / simulationWorker.js):
  • Added low-alpha epsilon/full-sync controls and delta payload optimization.
  • Added startup tickSummary telemetry attached to T5 stable_layout checkpoint.
• Startup Perf Toolchain (scripts/):
  • Added compare/matrix/watch/simulate/cohort/signoff workflow integration and guardrails.
• Docs and Contracts (Diataxis EN/ZH):
  • Synced runtime contract docs for new startup profile fields and telemetry semantics.
  • Added bilingual roadmap docs for knowledge-mastery evolution and linked them into docs nav/map.
• Version Metadata:
  • Aligned package.json, package-lock.json, and src-tauri/tauri.conf.json to 1.7.0.

Operational Boundary

• Engineering signoff can proceed with no-hardware flow.
• Release signoff for cross-platform quality still requires real macOS/Android/iOS cohort evidence.

---

中文

发布范围

• 对比基线：v1.6.8..v1.7.0
• 提交数：16
• 变更文件数：36
• 代码/文档变更量：+6,539 / -67

版本亮点

• 启动提速 Phase 2/3/4 能力完成收口：
  • 启动期 full|delta Tick 传输与低 alpha 自适应策略
  • 主线程启动 Tick 帧级合并应用，减少冗余重绘
  • 分阶段边渲染与启动遮罩稳定化链路
• Warm Start 恢复可靠性加固：
  • 指纹与拓扑一致性校验
  • 快照时效保护
  • 应用前位置覆盖率阈值校验
• 启动性能验证自动化链路扩展：
  • baseline/pilot 对比报表
  • 多平台矩阵报表与严格 watch 门禁
  • 无多端硬件场景的工程签收流水线（Windows 真实日志 + 模拟 cohorts）

子系统说明

• 前端运行时（app.js / simulationWorker.js）：
  • 新增低 alpha 阶段 epsilon/full-sync 自适应调参与 delta 载荷优化。
  • 在 T5 stable_layout 增加 tickSummary 启动观测输出。
• 启动性能工具链（scripts/）：
  • 完成 compare/matrix/watch/simulate/cohort/signoff 全链路脚本化与门禁衔接。
• 文档与契约（Diataxis 中英双语）：
  • 同步新增启动 profile 字段与观测契约语义。
  • 新增“知识彻底掌握演进”双语路线文档并接入导航与映射。
• 版本元数据：
  • package.json、package-lock.json、src-tauri/tauri.conf.json 统一到 1.7.0。

运维边界

• 工程签收可使用 no-hardware 流程。
• 跨平台发布签收仍需真实 macOS/Android/iOS cohort 证据。

v1.6.8

NoteConnection v1.6.8

English

Release Scope

• Compare baseline: v1.6.7..v1.6.8
• Commits: 1
• Files changed: 7
• Churn: +157 / -31

Highlights

• Fixed the tauri.sidecar.cleanup contract expectation so release CI recognizes the new markdown-worker sidecar and no longer blocks npm publish on a stale assertion.
• Added explicit release-note quality discipline in AGENTS.md, including bilingual section requirements and subsystem-oriented release narrative standards.
• Backfilled and strengthened v1.6.7 release notes so the published release body stays aligned with the real shipped delta across runtime, packaging, CI, and docs surfaces.

Release Pipeline Reliability

• Updated src/tauri.sidecar.cleanup.contract.test.ts to match the runtime sidecar list (server, godot, markdown-worker), removing the false-negative test failure that previously stopped the npm release stage.
• Kept the release path aligned with existing automation triggers (tag push and GitHub Release publication) so the npm workflow remains idempotent and reproducible.

Documentation and Governance

• Extended AGENTS.md with a dedicated "Release Notes Discipline" section to enforce:
  • bilingual ## English and ## 中文 split,
  • compare baseline declaration,
  • subsystem-grouped concrete highlights,
  • direct publish-ready release body quality.
• Refined docs/release_notes_v1.6.7.md content structure and detail depth to match repository release quality expectations.

Version Metadata

• Bumped release metadata to 1.6.8 in:
  • package.json
  • package-lock.json
  • src-tauri/tauri.conf.json

Release Notes

• This patch release focuses on release reliability and documentation quality control: it unblocks the npm pipeline regression, standardizes release-note governance, and keeps bilingual release communication consistent.

---

中文

发布范围

• 对比基线：v1.6.7..v1.6.8
• 提交数：1
• 变更文件数：7
• 代码/文档变更量：+157 / -31

版本亮点

• 修复 tauri.sidecar.cleanup 契约测试中的旧断言，使发布 CI 能正确识别新增的 markdown-worker sidecar，避免 npm 发布被误拦截。
• 在 AGENTS.md 新增发布说明质量约束，明确双语分段与按子系统组织的发布叙事标准。
• 回填并增强 v1.6.7 发布说明细节，确保已发布版本正文与实际交付变更（运行时、打包、CI、文档）一致。

发布链路可靠性

• 更新 src/tauri.sidecar.cleanup.contract.test.ts，将运行时 sidecar 列表对齐为 server、godot、markdown-worker，消除此前阻断 npm 发布阶段的误报测试失败。
• 保持发布流程与既有自动化触发机制（tag push + GitHub Release 发布）一致，确保 npm 工作流具备幂等与可复现性。

文档与治理

• 在 AGENTS.md 增补 "Release Notes Discipline" 章节，强制要求：
  • ## English 与 ## 中文 双语分段，
  • 明确 compare baseline，
  • 按子系统组织具体亮点，
  • 发布文案可直接用于 GitHub Release 正文。
• 细化 docs/release_notes_v1.6.7.md 的结构与信息密度，使其达到仓库既定发布质量基线。

版本元数据

• 将以下文件版本统一提升到 1.6.8：
  • package.json
  • package-lock.json
  • src-tauri/tauri.conf.json

发布说明

• 本次补丁版本聚焦发布可靠性与文档质量治理：既修复 npm 发布链路回归点，也统一双语发布说明标准，保障后续发版稳定执行。

v1.6.7

NoteConnection v1.6.7

English

Release Scope

• Compare baseline: v1.6.6..v1.6.7
• Commits: 5
• Files changed: 56
• Churn: +6,021 / -862

Highlights

• Added a packaged markdown-worker sidecar across desktop targets and wired the new runtime through the frontend reader, NoteMD bridge, Tauri packaging, and validation scripts.
• Extended the embedded reader/path-mode experience with richer panel refresh, settings synchronization, and markdown rendering flow updates spanning frontend, server, and Godot integration code.
• Replaced legacy external docs-publish runbooks with project-owned bilingual GitHub Pages release/rollback guidance and aligned Diataxis/governance references to the new canonical docs.

Markdown Worker and Reader Runtime

• Added tools/markdown_worker Rust binary and platform packaging paths for Windows, Linux, and macOS.
• Introduced src/markdown/MarkdownGateway.ts plus contract/integration coverage for markdown worker runtime selection and server integration.
• Updated sidecar build, validation, cleanup, and readiness scripts so the markdown worker is treated as a first-class Tauri sidecar during dev/build/test flows.
• Expanded frontend reader and NoteMD integration surfaces:
  • src/frontend/reader.js
  • src/frontend/notemd.js
  • src/frontend/settings.js
  • src/server.ts

Docs Publishing and Release Operations

• Switched docs publishing away from the removed external EdgeOne runbook to repo-owned GitHub Pages runbooks:
  • docs/en/docs_release_and_rollback.md
  • docs/zh/docs_release_and_rollback.md
• Added GitHub Pages preflight/auto-enable logic in .github/workflows/docs-github-pages-publish.yml so docs deployments can self-heal common Pages configuration drift.
• Hardened npm-publish.yml with version-existence guarding to keep npm publish idempotent when both tag-push and release events fire for the same version.
• Aligned release metadata for 1.6.7 in package/Tauri manifests and refreshed README + Diataxis references to match the new operator workflow.

Stability and Verification

• Added regression coverage for markdown gateway runtime routing, app-config persistence, server integration, and embed refresh behavior.
• Kept Tauri preflight cleanup/ensure scripts in the verification path so stale copied sidecars are removed before dev/build/test flows start.
• Preserved bilingual release-note structure so GitHub Release text can be published directly from this document without post-hoc rewriting.

Release Notes

• This release is not just a docs-only cut: it delivers the new markdown worker runtime, expands embedded reader integration, and hardens GitHub Pages plus npm release operations around that rollout.
• The compare window remains tightly scoped to v1.6.6..v1.6.7, so the notes above are intended to map directly to the actual shipped delta.

---

中文

发布范围

• 对比基线：v1.6.6..v1.6.7
• 提交数：5
• 变更文件数：56
• 代码/文档变更量：+6,021 / -862

版本亮点

• 为桌面端新增可打包的 markdown-worker sidecar，并把该运行时完整接入前端阅读器、NoteMD 桥接、Tauri 打包与校验脚本。
• 扩展嵌入式阅读器 / Path Mode 体验，补齐面板刷新、设置同步与 Markdown 渲染链路，覆盖前端、服务端与 Godot 集成代码。
• 用项目自有的双语 GitHub Pages 发布 / 回滚手册替换历史外部文档发布手册，并同步收敛 Diataxis / 治理文档的权威引用入口。

Markdown Worker 与阅读器运行时

• 新增 tools/markdown_worker Rust 二进制，并补齐 Windows、Linux、macOS 的打包路径。
• 引入 src/markdown/MarkdownGateway.ts，并补充 markdown worker 运行时选择与服务端集成的契约 / 集成测试。
• 更新 sidecar 的构建、校验、清理、就绪脚本，使 markdown worker 在 Tauri 的开发 / 构建 / 测试流程中成为一等 sidecar。
• 扩展前端阅读器与 NoteMD 集成面：
  • src/frontend/reader.js
  • src/frontend/notemd.js
  • src/frontend/settings.js
  • src/server.ts

文档发布与版本运维

• 将文档发布流程从已移除的外部 EdgeOne 手册切换到仓库自有 GitHub Pages 手册：
  • docs/en/docs_release_and_rollback.md
  • docs/zh/docs_release_and_rollback.md
• 在 .github/workflows/docs-github-pages-publish.yml 中增加 GitHub Pages 预检 / 自动启用逻辑，用于自恢复常见 Pages 配置漂移。
• 在 npm-publish.yml 中增加版本存在性保护，使同一版本同时被 tag push 与 release 事件触发时仍保持 npm publish 幂等。
• 对齐 1.6.7 的 package / Tauri manifest 版本元数据，并同步刷新 README 与 Diataxis 引用，保证运维入口一致。

稳定性与验证

• 增补 markdown gateway 运行时路由、app-config 持久化、服务端集成、嵌入式刷新行为的回归覆盖。
• 将 Tauri 预检清理 / ensure 脚本持续纳入验证链路，确保开发 / 构建 / 测试启动前不会遗留陈旧的复制 sidecar。
• 保持双语发布说明结构稳定，使 GitHub Release 文案可以直接从本文件发布，而不是事后再临时改写。

发布说明

• 本版本并非单纯文档整理，而是围绕新的 markdown worker 运行时上线，同步完成嵌入式阅读器集成与 GitHub Pages / npm 发布链路加固。
• 本说明严格对应 v1.6.6..v1.6.7 的实际变更窗口，便于后续直接作为 GitHub Release 正文使用。

v1.6.6

English

Highlights

• Refactored the NoteMD provider call flow to a definition-driven runtime inspired by recent obsidian-NotEMD and cline provider strategies.
• Added transport-based dispatch (openai-compatible, anthropic, google, azure-openai, ollama) with provider metadata (apiKeyMode, apiTestMode, category).
• Expanded built-in provider presets: Qwen, Doubao, Moonshot, GLM, MiniMax, Groq, Together, Fireworks, Requesty, and OpenAI Compatible.

Unified TOML Configuration

• Unified Tauri + Godot + NoteMD runtime settings into app_config.toml.
• Added full NoteMD persistence with [notemd] and [[notemd.providers]], while preserving legacy compatibility through [notemd.api] mirror fields.
• Added Path Mode persistence in [path_mode] and runtime APIs:
  • GET /api/path-mode/settings
  • POST|PUT /api/path-mode/settings
• Migrated Godot settings panel sync to runtime TOML settings API.

Stability and Governance

• Hardened Tauri Rust config save logic to preserve unknown TOML sections, preventing accidental overwrite of [notemd] / [path_mode] during KB/language updates.
• Added and updated contract/integration tests for provider routing, TOML extraction/persistence, and Path Mode settings APIs.
• Updated bilingual docs and Diataxis references, including schema and operator guidance for app_config.toml.

中文

重点更新

• 参考 obsidian-NotEMD 与 cline 的 Provider 调用策略，重构 NoteMD API 调用流为“定义驱动”运行时架构。
• 新增 transport 分发（openai-compatible、anthropic、google、azure-openai、ollama）及 provider 元数据（apiKeyMode、apiTestMode、category）。
• 扩展内置 Provider 预设：Qwen、Doubao、Moonshot、GLM、MiniMax、Groq、Together、Fireworks、Requesty、OpenAI Compatible。

TOML 配置统一

• 将 Tauri + Godot + NoteMD 的运行时配置统一到 app_config.toml。
• NoteMD 全量配置持久化到 [notemd] 与 [[notemd.providers]]，并保留 [notemd.api] 兼容镜像。
• Path Mode 配置持久化到 [path_mode]，并提供运行时接口：
  • GET /api/path-mode/settings
  • POST|PUT /api/path-mode/settings
• Godot 设置面板切换为运行时 TOML 配置同步链路。

稳定性与治理

• 加固 Tauri Rust 侧配置回写逻辑：保留未知 TOML section，避免更新 KB/语言时误覆盖 [notemd] / [path_mode]。
• 新增并更新 Provider/TOML/Path Mode 相关契约与集成测试。
• 同步更新双语文档与 Diataxis 参考（含 app_config.toml 配置结构与运维说明）。

v1.6.5

NoteConnection v1.6.5

English

Release Scope

• Compare baseline: v1.6.4..v1.6.5
• Commits: 1
• Files changed: 4
• Churn: +32 / -4

Highlights

• Published the MkDocs documentation portal to EdgeOne Pages project noteconnection-docs.
• Added bilingual README documentation discovery guidance for both users and developers:
  • EdgeOne docs portal entry
  • Public fallback mirror entry
  • Recommended Diataxis lookup paths
• Standardized maintainer docs deploy command:
  • npm run docs:site:build
  • edgeone pages deploy build/mkdocs-site -n noteconnection-docs -e production -a global
• Bumped project release version to 1.6.5 across:
  • package.json
  • package-lock.json
  • src-tauri/tauri.conf.json

Release Notes

• This release is documentation portal and release-process hardening focused.
• Existing runtime behavior and packaging logic remain unchanged.

---

中文

发布范围

• 对比基线：v1.6.4..v1.6.5
• 提交数：1
• 变更文件数：4
• 代码/文档变更量：+32 / -4

版本亮点

• 已将 MkDocs 文档门户发布到 EdgeOne Pages 项目 noteconnection-docs。
• 已补充 README 中英文文档检索入口，覆盖用户与开发者场景：
  • EdgeOne 文档站入口
  • 公共镜像兜底入口
  • Diataxis 推荐查询路径
• 统一维护者文档发布命令：
  • npm run docs:site:build
  • edgeone pages deploy build/mkdocs-site -n noteconnection-docs -e production -a global
• 已将项目版本号统一提升到 1.6.5，覆盖：
  • package.json
  • package-lock.json
  • src-tauri/tauri.conf.json

发布说明

• 本版本聚焦文档门户上线与发布流程固化。
• 运行时行为与打包逻辑不做功能性变更。

v1.6.4

Automated desktop multi-OS release assets.

v1.6.3

Automated desktop multi-OS release assets.

v1.6.2

Automated desktop multi-OS release assets.

v1.6.1

Automated desktop multi-OS release assets.

v1.6.0

NoteConnection v1.6.0

English

Highlights

• Tauri-first runtime architecture finalized; Electron runtime removed.
• Single-window orchestration stabilized between Tauri and Godot (no dual-primary window overlap).
• NoteMD evolved into an integrated processing subsystem (src/notemd/*) with frontend surfaces and API wiring.
• Tauri-side NoteMD browse workflows (file/folder/save picker chain) stabilized end-to-end.
• PDF ingestion guidance added: convert PDF with Mineru before Markdown import.
• Android dual pipeline hardened (Capacitor + Tauri Android), including prerequisite alignment scripts.
• CI governance expanded with FixRisk, SBOM/attestation, privacy/signature, pathbridge strict schema, and wasm parity gates.
• Final pre-release CI fixes included in tag:
  • runtime bridge invoke-contract compatibility for source-manager loadflow checks
  • SBOM transparency policy conditioning for unsigned/signing-key-absent publish contexts

Detailed Reports

• English: docs/en/release_v1.6.0_report.md
• Chinese: docs/zh/release_v1.6.0_report.md

---

中文

发布范围

• 对比基线：v1.3.0..v1.6.0
• 提交数：107
• 变更文件数：301
• 代码/文档变更量：+125,957 / -10,083

版本亮点

• 完成 Tauri 主导运行时架构，Electron 运行时清退完成。
• 稳定 Tauri 与 Godot 的单窗口编排（不再双主窗口并存）。
• NoteMD 演进为完整集成子系统（src/notemd/* + 前端界面 + API 链路）。
• 修复并稳定 Tauri 中 NoteMD 的文件/文件夹/保存选择流程。
• 新增 PDF 导入规范提示：需先通过 Mineru 转换为 Markdown。
• 强化双 Android 导出路径（Capacitor + Tauri Android）及前置校验脚本。
• 扩展 CI 治理能力：FixRisk、SBOM/attestation、隐私/签名、pathbridge 严格 schema、wasm parity 门禁。
• 标签内最终 CI 修复包含：
  • runtime bridge invoke 契约兼容修复（source-manager loadflow）
  • 无签名发布场景下的 SBOM transparency 条件化策略修复

详细报告

• 英文：docs/en/release_v1.6.0_report.md
• 中文：docs/zh/release_v1.6.0_report.md