noteconnection 1.6.6 → 1.7.0

package/README.md

@@ -285,6 +285,7 @@ Managing your knowledge base source is now easier than ever.
 - **Reset**: Use **File > Reset to Default** to return to the bundled demo notes.
 - **Config Path Overrides**: Set `NOTE_CONNECTION_CONFIG_PATH` (full file path) or `NOTE_CONNECTION_CONFIG_DIR` (directory) to customize where `app_config.toml` is stored.
 - **Window Behavior Tuning**: Edit `[multi_window]` in `app_config.toml` (`single_window_mode`, `hide_tauri_when_pathmode_opens`, `restore_tauri_when_pathmode_exits`, `confirm_before_full_shutdown_from_godot`, `sync_language`).
+- **Reader Protocol Tuning**: Edit `[frontend_settings.reading]` to control markdown rendering runtime (`markdown_engine`, `chunk_block_size`, `prefetch_blocks`, `index_cache_ttl_sec`, `max_doc_bytes`).
 - **Detailed Config Guide**: See [`docs/en/app_config.toml_guide.md`](docs/en/app_config.toml_guide.md) and template [`docs/examples/app_config.template.toml`](docs/examples/app_config.template.toml).
 
 ```toml
@@ -298,8 +299,32 @@ hide_tauri_when_pathmode_opens = true
 restore_tauri_when_pathmode_exits = true
 confirm_before_full_shutdown_from_godot = true
 sync_language = true
+
+[frontend_settings.reading]
+mode = "window"
+markdown_engine = "auto" # "legacy" | "pulldown" | "auto"
+chunk_block_size = 36
+prefetch_blocks = 8
+index_cache_ttl_sec = 1800
+max_doc_bytes = 100663296
 ```
 
+### Markdown Reader Protocol (v1.6.8)
+
+- **Dual-engine gray release**:
+  - `markdown_engine = "auto"`: prefer `pulldown-cmark`, fallback to legacy on failure.
+  - `markdown_engine = "pulldown"`: keep automatic fallback to legacy to avoid blank readers.
+  - `markdown_engine = "legacy"`: force original parser path.
+- **Unified cross-window behavior**: Tauri reader and Godot reader now both consume the same sidecar markdown protocol (`index/chunk/resolve-node/resolve-wiki`).
+- **Large file stability**: reader no longer requires single-shot full markdown payloads and supports block-based incremental loading.
+- **Mermaid reliability hardening**:
+  - Godot reader Mermaid rendering now uses `renderer = "auto"` so it can prefer frontend bridge and automatically fallback to local `resvg` when bridge render is unavailable.
+  - Mermaid fences must start on a new line; inline `$$```mermaid` patterns can break block classification.
+  - Use `npm run verify:markdown:mermaid:fence -- Knowledge_Base/testconcept` to catch malformed inline Mermaid fences before release.
+- **Local MCP web-debug baseline (Runbrowser)**:
+  - Build locally from source: `pnpm --filter @jiweiyuan/runbrowser-server build`, `pnpm --filter @jiweiyuan/runbrowser-core build`, `pnpm --filter @jiweiyuan/runbrowser-mcp build`.
+  - Run local MCP entrypoint: `node E:\Knowledge_project\tools\runbrowser\packages\mcp\bin.js`.
+
 ## 🏗️ Build & Deployment
 
 For developers building from source, NoteConnection offers two build modes:
@@ -319,19 +344,18 @@ For developers building from source, NoteConnection offers two build modes:
 - Run mapping validation: `npm run docs:diataxis:check`.
 - Run local docs site preview: `npm run docs:site:serve`.
 - Build static docs site: `npm run docs:site:build`.
-- EdgeOne Docs Portal (MkDocs deploy): `https://noteconnection-docs.edgeone.run`
-  - If you see `401 Authorization Required`, open the latest signed URL printed by deployment as `EDGEONE_DEPLOY_URL`, or disable preset-domain protection in EdgeOne Pages settings.
-- Public mirror (fallback): `https://jacobinwwey.github.io/NoteConnection/`.
+- GitHub Pages Docs Portal (project site): `https://jacobinwwey.github.io/NoteConnection/`.
+- Host root (for routing baseline): `https://jacobinwwey.github.io/`.
 - Recommended lookup entry points:
   - Users: `/diataxis/zh/tutorials/first-run/` or `/diataxis/en/tutorials/first-run/`
   - Developers: `/diataxis/en/reference/interfaces-and-runtime/` and `/diataxis/en/reference/release-and-governance/`
-- EdgeOne publish command (MkDocs site): `edgeone pages deploy build/mkdocs-site -n noteconnection-docs -e production -a global`.
-- One-click docs publish command: `npm run docs:edgeone:publish`.
-- CI auto publish workflow (EdgeOne): `.github/workflows/docs-edgeone-publish.yml`.
+- CI auto publish workflow (GitHub Pages): `.github/workflows/docs-github-pages-publish.yml`.
+- Manual rollback entry: run workflow dispatch and set `git_ref` to a stable tag/commit.
+- MkDocs base/path can be overridden by environment variables: `MKDOCS_SITE_URL`, `MKDOCS_BASE_PATH`.
 - CI policy gate for docs mapping and site build: `.github/workflows/docs-diataxis-site.yml`.
-- Sharelife community UI docs release + rollback guide:
-  - English: [`docs/en/sharelife_community_release_and_rollback.md`](docs/en/sharelife_community_release_and_rollback.md)
-  - 中文: [`docs/zh/sharelife_community_release_and_rollback.md`](docs/zh/sharelife_community_release_and_rollback.md)
+- Docs release + rollback runbook:
+  - English: [`docs/en/docs_release_and_rollback.md`](docs/en/docs_release_and_rollback.md)
+  - 中文: [`docs/zh/docs_release_and_rollback.md`](docs/zh/docs_release_and_rollback.md)
 
 ## 🛠️ Hardware & Driver Requirements (AMDGPU)
 
@@ -346,6 +370,16 @@ For optimal performance with "GPU Optimised Rendering", especially on AMD RDNA c
 
 ## 📅 Changelog
 
+### v1.6.7 - Docs Governance Cleanup & GitHub Pages Stabilization (2026-03-29)
+- Removed unrelated external community UI documentation references from the repository documentation system.
+- Replaced legacy external runbooks with project-owned docs operations runbooks:
+  - `docs/en/docs_release_and_rollback.md`
+  - `docs/zh/docs_release_and_rollback.md`
+- Updated Diataxis governance mapping and cross-links to use the new canonical runbook paths.
+- Added GitHub Pages preflight verification in docs publish workflow to surface clear warnings when Pages is not enabled.
+- Resolved docs portal 404 condition by enabling repository Pages with `gh-pages` branch as publish source.
+- Prepared formal release metadata and version alignment to `1.6.7` (npm + Tauri).
+
 ### v1.6.6 - Unified Provider Runtime & TOML Settings Consolidation (2026-03-26)
 - Upgraded NoteMD API calling flow to a definition-driven provider architecture inspired by recent obsidian-NotEMD and cline patterns.
 - Added transport-based dispatch (openai-compatible, anthropic, google, azure-openai, ollama) and provider metadata (apiKeyMode, apiTestMode, category).
@@ -358,11 +392,11 @@ For optimal performance with "GPU Optimised Rendering", especially on AMD RDNA c
 - Updated bilingual documentation and templates for v1.6.6 schema and operations.
 ### v1.6.5 - Documentation Portal Update (2026-03-26)
 
-- Published MkDocs documentation to EdgeOne Pages project `noteconnection-docs`.
+- Published MkDocs documentation to GitHub Pages project site.
 - Added bilingual README guidance for docs lookup paths (user/tutorial and developer/reference entry points).
-- Standardized docs publish command for maintainers:
+- Standardized docs publish flow for maintainers:
   - `npm run docs:site:build`
-  - `edgeone pages deploy build/mkdocs-site -n noteconnection-docs -e production -a global`
+  - `.github/workflows/docs-github-pages-publish.yml` (`workflow_dispatch` supports `git_ref` rollback)
 ### v1.6.0 - Unified Runtime, NoteMD Integration & Release Hardening (2026-03-23)
 
 - **Tag Compare Snapshot (`v1.3.0..v1.6.0`)**:
@@ -919,7 +953,7 @@ For optimal performance with "GPU Optimised Rendering", especially on AMD RDNA c
 ## 中文文档
 
 
-# 2026-03-24 v1.6.0
+# 2026-03-29 v1.6.7
 # NoteConnection: 层级知识图谱可视化系统
 
 <img width="606" height="309" alt="banner" src="https://github.com/user-attachments/assets/92e90de5-2b1a-4398-8e8b-6e142c92b6a2" />
@@ -1191,6 +1225,7 @@ npm start -- --path "E:/Knowledge/ObsidianVault" --no-gpu
 - **重置**: 使用 **文件 > 重置为默认** 返回由捆绑的演示笔记。
 - **配置路径覆盖**: 可通过 `NOTE_CONNECTION_CONFIG_PATH`（完整文件路径）或 `NOTE_CONNECTION_CONFIG_DIR`（目录）自定义 `app_config.toml` 位置。
 - **窗口行为可调**: 在 `app_config.toml` 的 `[multi_window]` 段调整 `single_window_mode`、`hide_tauri_when_pathmode_opens`、`restore_tauri_when_pathmode_exits`、`confirm_before_full_shutdown_from_godot`、`sync_language`。
+- **阅读协议可调**: 在 `[frontend_settings.reading]` 中统一调节 Markdown 渲染链路（`markdown_engine`、`chunk_block_size`、`prefetch_blocks`、`index_cache_ttl_sec`、`max_doc_bytes`）。
 - **详细配置说明**: 参见 [`docs/zh/app_config.toml_guide.md`](docs/zh/app_config.toml_guide.md) 与模板 [`docs/examples/app_config.template.toml`](docs/examples/app_config.template.toml)。
 
 ```toml
@@ -1204,8 +1239,32 @@ hide_tauri_when_pathmode_opens = true
 restore_tauri_when_pathmode_exits = true
 confirm_before_full_shutdown_from_godot = true
 sync_language = true
+
+[frontend_settings.reading]
+mode = "window"
+markdown_engine = "auto" # "legacy" | "pulldown" | "auto"
+chunk_block_size = 36
+prefetch_blocks = 8
+index_cache_ttl_sec = 1800
+max_doc_bytes = 100663296
 ```
 
+### Markdown 阅读协议（v1.6.8）
+
+- **双引擎灰度发布**：
+  - `markdown_engine = "auto"`：优先 `pulldown-cmark`，失败自动回退 legacy。
+  - `markdown_engine = "pulldown"`：仍保留自动回退 legacy，避免阅读器空白。
+  - `markdown_engine = "legacy"`：强制使用旧解析链路。
+- **双窗口统一行为**：Tauri 阅读器与 Godot 阅读器都统一消费 sidecar Markdown 协议（`index/chunk/resolve-node/resolve-wiki`）。
+- **大文档稳定性提升**：阅读链路不再依赖单次整文全量载入，改为块级增量加载。
+- **Mermaid 稳定性加固**：
+  - Godot 阅读器 Mermaid 渲染已切换为 `renderer = "auto"`，优先走前端桥接渲染，桥接不可用时自动回退本地 `resvg`。
+  - Mermaid fenced code 必须独占新行起始；`$$```mermaid` 这类行内拼接会导致分块识别失败。
+  - 发布前可执行 `npm run verify:markdown:mermaid:fence -- Knowledge_Base/testconcept`，提前拦截异常 Mermaid fence。
+- **本地 MCP 网页调试基线（Runbrowser）**：
+  - 建议按源码本地构建：`pnpm --filter @jiweiyuan/runbrowser-server build`、`pnpm --filter @jiweiyuan/runbrowser-core build`、`pnpm --filter @jiweiyuan/runbrowser-mcp build`。
+  - 本地 MCP 入口：`node E:\Knowledge_project\tools\runbrowser\packages\mcp\bin.js`。
+
 ## 🏗️ 构建与部署 (Build & Deployment)
 
 对于从源码构建的开发者，NoteConnection 提供两种构建模式：
@@ -1225,19 +1284,18 @@ sync_language = true
 - 映射一致性校验：`npm run docs:diataxis:check`。
 - 本地预览文档站点：`npm run docs:site:serve`。
 - 构建静态文档站点：`npm run docs:site:build`。
-- EdgeOne 文档入口（MkDocs 发布）：`https://noteconnection-docs.edgeone.run`
-  - 若出现 `401 Authorization Required`，请使用最近一次部署输出中的 `EDGEONE_DEPLOY_URL` 签名链接，或在 EdgeOne Pages 项目中关闭预设域名访问保护。
-- 公共镜像（兜底）：`https://jacobinwwey.github.io/NoteConnection/`。
+- GitHub Pages 文档入口（project site）：`https://jacobinwwey.github.io/NoteConnection/`。
+- 根域名（路由基线）：`https://jacobinwwey.github.io/`。
 - 推荐查询入口：
   - 用户文档：`/diataxis/zh/tutorials/first-run/` 或 `/diataxis/en/tutorials/first-run/`
   - 开发文档：`/diataxis/en/reference/interfaces-and-runtime/` 与 `/diataxis/en/reference/release-and-governance/`
-- EdgeOne 发布命令（MkDocs 产物）：`edgeone pages deploy build/mkdocs-site -n noteconnection-docs -e production -a global`。
-- 一键文档发布命令：`npm run docs:edgeone:publish`。
-- CI 自动发布工作流（EdgeOne）：`.github/workflows/docs-edgeone-publish.yml`。
+- CI 自动发布工作流（GitHub Pages）：`.github/workflows/docs-github-pages-publish.yml`。
+- 手动回滚入口：运行 workflow_dispatch 并设置 `git_ref` 为稳定 tag/commit。
+- MkDocs base/path 可通过环境变量覆盖：`MKDOCS_SITE_URL`、`MKDOCS_BASE_PATH`。
 - CI 文档治理工作流：`.github/workflows/docs-diataxis-site.yml`。
-- Sharelife 社区界面文档发布与回滚指南：
-  - English：[`docs/en/sharelife_community_release_and_rollback.md`](docs/en/sharelife_community_release_and_rollback.md)
-  - 中文：[`docs/zh/sharelife_community_release_and_rollback.md`](docs/zh/sharelife_community_release_and_rollback.md)
+- 文档发布与回滚运行手册：
+  - English：[`docs/en/docs_release_and_rollback.md`](docs/en/docs_release_and_rollback.md)
+  - 中文：[`docs/zh/docs_release_and_rollback.md`](docs/zh/docs_release_and_rollback.md)
 
 ---
 
@@ -1245,6 +1303,16 @@ sync_language = true
 
 ## 更新日志 (Changelog)
 
+### v1.6.7 - 文档治理清理与 GitHub Pages 稳定性修复 (2026-03-29)
+- 清理并移除了项目文档体系中与本项目无关的外部社区界面文档引用。
+- 将历史外部手册替换为项目内通用文档运维手册：
+  - `docs/en/docs_release_and_rollback.md`
+  - `docs/zh/docs_release_and_rollback.md`
+- 同步更新 Diataxis 映射与跨文档链接，确保权威来源路径一致。
+- 在文档发布工作流新增 GitHub Pages 预检步骤，未启用 Pages 时给出明确告警。
+- 已通过仓库 Pages 启用与 `gh-pages` 源配置修复文档站点 404 问题。
+- 完成下个正式版本发布准备，并将版本统一到 `1.6.7`（npm + Tauri）。
+
 ### v1.6.6 - Provider 运行时流程与 TOML 配置统一 (2026-03-26)
 - 参考 obsidian-NotEMD 与 cline 的 Provider 策略，重构 NoteMD API 调用流为定义驱动。
 - 新增 transport 分发（openai-compatible / anthropic / google / azure-openai / ollama）与 provider 元数据（apiKeyMode、apiTestMode、category）。
@@ -1258,11 +1326,11 @@ sync_language = true
 
 ### v1.6.5 - 文档门户更新 (2026-03-26)
 
-- 已将 MkDocs 文档发布到 EdgeOne Pages 项目 `noteconnection-docs`。
+- 已将 MkDocs 文档发布到 GitHub Pages project site。
 - 在 README 中补充了面向用户与开发者的中英文文档检索入口。
-- 维护者发布命令统一为：
+- 维护者发布流程统一为：
   - `npm run docs:site:build`
-  - `edgeone pages deploy build/mkdocs-site -n noteconnection-docs -e production -a global`
+  - `.github/workflows/docs-github-pages-publish.yml`（`workflow_dispatch` 支持 `git_ref` 回滚）
 
 ### v1.6.0 - 单窗口运行时、NoteMD 集成与发布加固 (2026-03-23)
 

package/dist/src/frontend/README.md

@@ -285,6 +285,7 @@ Managing your knowledge base source is now easier than ever.
 - **Reset**: Use **File > Reset to Default** to return to the bundled demo notes.
 - **Config Path Overrides**: Set `NOTE_CONNECTION_CONFIG_PATH` (full file path) or `NOTE_CONNECTION_CONFIG_DIR` (directory) to customize where `app_config.toml` is stored.
 - **Window Behavior Tuning**: Edit `[multi_window]` in `app_config.toml` (`single_window_mode`, `hide_tauri_when_pathmode_opens`, `restore_tauri_when_pathmode_exits`, `confirm_before_full_shutdown_from_godot`, `sync_language`).
+- **Reader Protocol Tuning**: Edit `[frontend_settings.reading]` to control markdown rendering runtime (`markdown_engine`, `chunk_block_size`, `prefetch_blocks`, `index_cache_ttl_sec`, `max_doc_bytes`).
 - **Detailed Config Guide**: See [`docs/en/app_config.toml_guide.md`](docs/en/app_config.toml_guide.md) and template [`docs/examples/app_config.template.toml`](docs/examples/app_config.template.toml).
 
 ```toml
@@ -298,8 +299,32 @@ hide_tauri_when_pathmode_opens = true
 restore_tauri_when_pathmode_exits = true
 confirm_before_full_shutdown_from_godot = true
 sync_language = true
+
+[frontend_settings.reading]
+mode = "window"
+markdown_engine = "auto" # "legacy" | "pulldown" | "auto"
+chunk_block_size = 36
+prefetch_blocks = 8
+index_cache_ttl_sec = 1800
+max_doc_bytes = 100663296
 ```
 
+### Markdown Reader Protocol (v1.6.8)
+
+- **Dual-engine gray release**:
+  - `markdown_engine = "auto"`: prefer `pulldown-cmark`, fallback to legacy on failure.
+  - `markdown_engine = "pulldown"`: keep automatic fallback to legacy to avoid blank readers.
+  - `markdown_engine = "legacy"`: force original parser path.
+- **Unified cross-window behavior**: Tauri reader and Godot reader now both consume the same sidecar markdown protocol (`index/chunk/resolve-node/resolve-wiki`).
+- **Large file stability**: reader no longer requires single-shot full markdown payloads and supports block-based incremental loading.
+- **Mermaid reliability hardening**:
+  - Godot reader Mermaid rendering now uses `renderer = "auto"` so it can prefer frontend bridge and automatically fallback to local `resvg` when bridge render is unavailable.
+  - Mermaid fences must start on a new line; inline `$$```mermaid` patterns can break block classification.
+  - Use `npm run verify:markdown:mermaid:fence -- Knowledge_Base/testconcept` to catch malformed inline Mermaid fences before release.
+- **Local MCP web-debug baseline (Runbrowser)**:
+  - Build locally from source: `pnpm --filter @jiweiyuan/runbrowser-server build`, `pnpm --filter @jiweiyuan/runbrowser-core build`, `pnpm --filter @jiweiyuan/runbrowser-mcp build`.
+  - Run local MCP entrypoint: `node E:\Knowledge_project\tools\runbrowser\packages\mcp\bin.js`.
+
 ## 🏗️ Build & Deployment
 
 For developers building from source, NoteConnection offers two build modes:
@@ -319,19 +344,18 @@ For developers building from source, NoteConnection offers two build modes:
 - Run mapping validation: `npm run docs:diataxis:check`.
 - Run local docs site preview: `npm run docs:site:serve`.
 - Build static docs site: `npm run docs:site:build`.
-- EdgeOne Docs Portal (MkDocs deploy): `https://noteconnection-docs.edgeone.run`
-  - If you see `401 Authorization Required`, open the latest signed URL printed by deployment as `EDGEONE_DEPLOY_URL`, or disable preset-domain protection in EdgeOne Pages settings.
-- Public mirror (fallback): `https://jacobinwwey.github.io/NoteConnection/`.
+- GitHub Pages Docs Portal (project site): `https://jacobinwwey.github.io/NoteConnection/`.
+- Host root (for routing baseline): `https://jacobinwwey.github.io/`.
 - Recommended lookup entry points:
   - Users: `/diataxis/zh/tutorials/first-run/` or `/diataxis/en/tutorials/first-run/`
   - Developers: `/diataxis/en/reference/interfaces-and-runtime/` and `/diataxis/en/reference/release-and-governance/`
-- EdgeOne publish command (MkDocs site): `edgeone pages deploy build/mkdocs-site -n noteconnection-docs -e production -a global`.
-- One-click docs publish command: `npm run docs:edgeone:publish`.
-- CI auto publish workflow (EdgeOne): `.github/workflows/docs-edgeone-publish.yml`.
+- CI auto publish workflow (GitHub Pages): `.github/workflows/docs-github-pages-publish.yml`.
+- Manual rollback entry: run workflow dispatch and set `git_ref` to a stable tag/commit.
+- MkDocs base/path can be overridden by environment variables: `MKDOCS_SITE_URL`, `MKDOCS_BASE_PATH`.
 - CI policy gate for docs mapping and site build: `.github/workflows/docs-diataxis-site.yml`.
-- Sharelife community UI docs release + rollback guide:
-  - English: [`docs/en/sharelife_community_release_and_rollback.md`](docs/en/sharelife_community_release_and_rollback.md)
-  - 中文: [`docs/zh/sharelife_community_release_and_rollback.md`](docs/zh/sharelife_community_release_and_rollback.md)
+- Docs release + rollback runbook:
+  - English: [`docs/en/docs_release_and_rollback.md`](docs/en/docs_release_and_rollback.md)
+  - 中文: [`docs/zh/docs_release_and_rollback.md`](docs/zh/docs_release_and_rollback.md)
 
 ## 🛠️ Hardware & Driver Requirements (AMDGPU)
 
@@ -346,6 +370,16 @@ For optimal performance with "GPU Optimised Rendering", especially on AMD RDNA c
 
 ## 📅 Changelog
 
+### v1.6.7 - Docs Governance Cleanup & GitHub Pages Stabilization (2026-03-29)
+- Removed unrelated external community UI documentation references from the repository documentation system.
+- Replaced legacy external runbooks with project-owned docs operations runbooks:
+  - `docs/en/docs_release_and_rollback.md`
+  - `docs/zh/docs_release_and_rollback.md`
+- Updated Diataxis governance mapping and cross-links to use the new canonical runbook paths.
+- Added GitHub Pages preflight verification in docs publish workflow to surface clear warnings when Pages is not enabled.
+- Resolved docs portal 404 condition by enabling repository Pages with `gh-pages` branch as publish source.
+- Prepared formal release metadata and version alignment to `1.6.7` (npm + Tauri).
+
 ### v1.6.6 - Unified Provider Runtime & TOML Settings Consolidation (2026-03-26)
 - Upgraded NoteMD API calling flow to a definition-driven provider architecture inspired by recent obsidian-NotEMD and cline patterns.
 - Added transport-based dispatch (openai-compatible, anthropic, google, azure-openai, ollama) and provider metadata (apiKeyMode, apiTestMode, category).
@@ -358,11 +392,11 @@ For optimal performance with "GPU Optimised Rendering", especially on AMD RDNA c
 - Updated bilingual documentation and templates for v1.6.6 schema and operations.
 ### v1.6.5 - Documentation Portal Update (2026-03-26)
 
-- Published MkDocs documentation to EdgeOne Pages project `noteconnection-docs`.
+- Published MkDocs documentation to GitHub Pages project site.
 - Added bilingual README guidance for docs lookup paths (user/tutorial and developer/reference entry points).
-- Standardized docs publish command for maintainers:
+- Standardized docs publish flow for maintainers:
   - `npm run docs:site:build`
-  - `edgeone pages deploy build/mkdocs-site -n noteconnection-docs -e production -a global`
+  - `.github/workflows/docs-github-pages-publish.yml` (`workflow_dispatch` supports `git_ref` rollback)
 ### v1.6.0 - Unified Runtime, NoteMD Integration & Release Hardening (2026-03-23)
 
 - **Tag Compare Snapshot (`v1.3.0..v1.6.0`)**:
@@ -919,7 +953,7 @@ For optimal performance with "GPU Optimised Rendering", especially on AMD RDNA c
 ## 中文文档
 
 
-# 2026-03-24 v1.6.0
+# 2026-03-29 v1.6.7
 # NoteConnection: 层级知识图谱可视化系统
 
 <img width="606" height="309" alt="banner" src="https://github.com/user-attachments/assets/92e90de5-2b1a-4398-8e8b-6e142c92b6a2" />
@@ -1191,6 +1225,7 @@ npm start -- --path "E:/Knowledge/ObsidianVault" --no-gpu
 - **重置**: 使用 **文件 > 重置为默认** 返回由捆绑的演示笔记。
 - **配置路径覆盖**: 可通过 `NOTE_CONNECTION_CONFIG_PATH`（完整文件路径）或 `NOTE_CONNECTION_CONFIG_DIR`（目录）自定义 `app_config.toml` 位置。
 - **窗口行为可调**: 在 `app_config.toml` 的 `[multi_window]` 段调整 `single_window_mode`、`hide_tauri_when_pathmode_opens`、`restore_tauri_when_pathmode_exits`、`confirm_before_full_shutdown_from_godot`、`sync_language`。
+- **阅读协议可调**: 在 `[frontend_settings.reading]` 中统一调节 Markdown 渲染链路（`markdown_engine`、`chunk_block_size`、`prefetch_blocks`、`index_cache_ttl_sec`、`max_doc_bytes`）。
 - **详细配置说明**: 参见 [`docs/zh/app_config.toml_guide.md`](docs/zh/app_config.toml_guide.md) 与模板 [`docs/examples/app_config.template.toml`](docs/examples/app_config.template.toml)。
 
 ```toml
@@ -1204,8 +1239,32 @@ hide_tauri_when_pathmode_opens = true
 restore_tauri_when_pathmode_exits = true
 confirm_before_full_shutdown_from_godot = true
 sync_language = true
+
+[frontend_settings.reading]
+mode = "window"
+markdown_engine = "auto" # "legacy" | "pulldown" | "auto"
+chunk_block_size = 36
+prefetch_blocks = 8
+index_cache_ttl_sec = 1800
+max_doc_bytes = 100663296
 ```
 
+### Markdown 阅读协议（v1.6.8）
+
+- **双引擎灰度发布**：
+  - `markdown_engine = "auto"`：优先 `pulldown-cmark`，失败自动回退 legacy。
+  - `markdown_engine = "pulldown"`：仍保留自动回退 legacy，避免阅读器空白。
+  - `markdown_engine = "legacy"`：强制使用旧解析链路。
+- **双窗口统一行为**：Tauri 阅读器与 Godot 阅读器都统一消费 sidecar Markdown 协议（`index/chunk/resolve-node/resolve-wiki`）。
+- **大文档稳定性提升**：阅读链路不再依赖单次整文全量载入，改为块级增量加载。
+- **Mermaid 稳定性加固**：
+  - Godot 阅读器 Mermaid 渲染已切换为 `renderer = "auto"`，优先走前端桥接渲染，桥接不可用时自动回退本地 `resvg`。
+  - Mermaid fenced code 必须独占新行起始；`$$```mermaid` 这类行内拼接会导致分块识别失败。
+  - 发布前可执行 `npm run verify:markdown:mermaid:fence -- Knowledge_Base/testconcept`，提前拦截异常 Mermaid fence。
+- **本地 MCP 网页调试基线（Runbrowser）**：
+  - 建议按源码本地构建：`pnpm --filter @jiweiyuan/runbrowser-server build`、`pnpm --filter @jiweiyuan/runbrowser-core build`、`pnpm --filter @jiweiyuan/runbrowser-mcp build`。
+  - 本地 MCP 入口：`node E:\Knowledge_project\tools\runbrowser\packages\mcp\bin.js`。
+
 ## 🏗️ 构建与部署 (Build & Deployment)
 
 对于从源码构建的开发者，NoteConnection 提供两种构建模式：
@@ -1225,19 +1284,18 @@ sync_language = true
 - 映射一致性校验：`npm run docs:diataxis:check`。
 - 本地预览文档站点：`npm run docs:site:serve`。
 - 构建静态文档站点：`npm run docs:site:build`。
-- EdgeOne 文档入口（MkDocs 发布）：`https://noteconnection-docs.edgeone.run`
-  - 若出现 `401 Authorization Required`，请使用最近一次部署输出中的 `EDGEONE_DEPLOY_URL` 签名链接，或在 EdgeOne Pages 项目中关闭预设域名访问保护。
-- 公共镜像（兜底）：`https://jacobinwwey.github.io/NoteConnection/`。
+- GitHub Pages 文档入口（project site）：`https://jacobinwwey.github.io/NoteConnection/`。
+- 根域名（路由基线）：`https://jacobinwwey.github.io/`。
 - 推荐查询入口：
   - 用户文档：`/diataxis/zh/tutorials/first-run/` 或 `/diataxis/en/tutorials/first-run/`
   - 开发文档：`/diataxis/en/reference/interfaces-and-runtime/` 与 `/diataxis/en/reference/release-and-governance/`
-- EdgeOne 发布命令（MkDocs 产物）：`edgeone pages deploy build/mkdocs-site -n noteconnection-docs -e production -a global`。
-- 一键文档发布命令：`npm run docs:edgeone:publish`。
-- CI 自动发布工作流（EdgeOne）：`.github/workflows/docs-edgeone-publish.yml`。
+- CI 自动发布工作流（GitHub Pages）：`.github/workflows/docs-github-pages-publish.yml`。
+- 手动回滚入口：运行 workflow_dispatch 并设置 `git_ref` 为稳定 tag/commit。
+- MkDocs base/path 可通过环境变量覆盖：`MKDOCS_SITE_URL`、`MKDOCS_BASE_PATH`。
 - CI 文档治理工作流：`.github/workflows/docs-diataxis-site.yml`。
-- Sharelife 社区界面文档发布与回滚指南：
-  - English：[`docs/en/sharelife_community_release_and_rollback.md`](docs/en/sharelife_community_release_and_rollback.md)
-  - 中文：[`docs/zh/sharelife_community_release_and_rollback.md`](docs/zh/sharelife_community_release_and_rollback.md)
+- 文档发布与回滚运行手册：
+  - English：[`docs/en/docs_release_and_rollback.md`](docs/en/docs_release_and_rollback.md)
+  - 中文：[`docs/zh/docs_release_and_rollback.md`](docs/zh/docs_release_and_rollback.md)
 
 ---
 
@@ -1245,6 +1303,16 @@ sync_language = true
 
 ## 更新日志 (Changelog)
 
+### v1.6.7 - 文档治理清理与 GitHub Pages 稳定性修复 (2026-03-29)
+- 清理并移除了项目文档体系中与本项目无关的外部社区界面文档引用。
+- 将历史外部手册替换为项目内通用文档运维手册：
+  - `docs/en/docs_release_and_rollback.md`
+  - `docs/zh/docs_release_and_rollback.md`
+- 同步更新 Diataxis 映射与跨文档链接，确保权威来源路径一致。
+- 在文档发布工作流新增 GitHub Pages 预检步骤，未启用 Pages 时给出明确告警。
+- 已通过仓库 Pages 启用与 `gh-pages` 源配置修复文档站点 404 问题。
+- 完成下个正式版本发布准备，并将版本统一到 `1.6.7`（npm + Tauri）。
+
 ### v1.6.6 - Provider 运行时流程与 TOML 配置统一 (2026-03-26)
 - 参考 obsidian-NotEMD 与 cline 的 Provider 策略，重构 NoteMD API 调用流为定义驱动。
 - 新增 transport 分发（openai-compatible / anthropic / google / azure-openai / ollama）与 provider 元数据（apiKeyMode、apiTestMode、category）。
@@ -1258,11 +1326,11 @@ sync_language = true
 
 ### v1.6.5 - 文档门户更新 (2026-03-26)
 
-- 已将 MkDocs 文档发布到 EdgeOne Pages 项目 `noteconnection-docs`。
+- 已将 MkDocs 文档发布到 GitHub Pages project site。
 - 在 README 中补充了面向用户与开发者的中英文文档检索入口。
-- 维护者发布命令统一为：
+- 维护者发布流程统一为：
   - `npm run docs:site:build`
-  - `edgeone pages deploy build/mkdocs-site -n noteconnection-docs -e production -a global`
+  - `.github/workflows/docs-github-pages-publish.yml`（`workflow_dispatch` 支持 `git_ref` 回滚）
 
 ### v1.6.0 - 单窗口运行时、NoteMD 集成与发布加固 (2026-03-23)