fix(themes): share code line layout with isolated previews

更新RAG检索增强文档，添加换行标记以改善显示格式。

优化功能演示导航表格布局，调整列宽使内容更易读。

清理多个演示文档的多余空行，统一文档格式规范。

.gitignore

@@ -18,6 +18,7 @@ backend/.env
 # 运行期生成的 SQLite 索引（vault 下的 Markdown 测试数据需提交）
 backend/data/*.db*
 backend/data/credentials/
+backend/data/logs/
 # 阶段验收笔记（验收用，不提交）
 backend/data/vault/验收/
 # 本机 MCP 配置、授权状态及服务器工作目录不得提交。

README.md

@@ -4,7 +4,7 @@
 
 NotesAgent 是本地优先的 AI 笔记与知识库项目。当前可运行形态为 Vue/Vite Web 前端与 FastAPI AI Core：Markdown 和附件保存在本地 Vault，SQLite 管理元数据、全文索引、向量空间、搜索历史、AI 会话、任务、Agent Trace、多模态任务及运行诊断。AI 对话已接入知识库检索，会话与消息由后端持久化并供 Web 和桌面客户端共用。
 
-截至 2026-09-05，第一阶段及第二阶段 A～F 的工程范围已经合并到 `main`。当前已完成真实 Workspace、混合检索与知识库问答、Agent/Tool/Permission、Skill/Plugin、MCP 配置与调用、模型提供商与路由、RAG Benchmark，以及本地 Embedding、音频转写和片段级声纹聚类。Tauri/Rust Host、Stronghold、原生多 Vault 文件系统、生产级 MCP 沙箱和 Sync Server 尚未接入。
+截至 2026-09-06，第一阶段及第二阶段 A～F 的工程范围已经合并到 `main`。当前已完成真实 Workspace、混合检索与知识库问答、Agent/Tool/Permission、Skill/Plugin、MCP 配置与调用、模型提供商与路由、RAG Benchmark，以及本地 Embedding、音频转写和片段级声纹聚类。Tauri/Rust Host、Stronghold、原生多 Vault 文件系统、生产级 MCP 沙箱和 Sync Server 尚未接入。
 
 ## 目录
 
@@ -26,8 +26,24 @@ NotesAgent/
 - 多模态：API 优先，未配置或响应无效时回退本地；`local_only` 禁止远程调用。任务、修订、事件、来源和回退原因写入 SQLite。
 - 模型运行：默认 CPU，可选 CUDA 12.8 组件；固定模型 revision，按需启动独立子进程，交互检索优先排队，CUDA 初始化或显存失败时用同一冻结配置在 CPU 重试一次。
 - 可观测性：输入、输出、缓存命中、推理 Token 与音频用量卡片；本地运行诊断保留最近 200 条，不保存正文、文件路径、密钥或异常全文。
+- 运行日志：统一查看向量/模型错误、Agent、任务与 HTTP 操作；独立后台存储最近 20,000 条，支持错误码/关联 ID 筛选和游标分页。入口无需打开 Vault，详见 [后台运行日志与压力问题修复](docs/development/后台运行日志与压力问题修复.md)。
 - 界面偏好：设置页可即时切换全局中文/英文界面，并控制由系统词典提供的编辑器拼写检查；偏好目前保存于 Web 端设备配置，后续由 Tauri 配置存储接管。
 
+## 第二阶段最新合并（2026-09-06）
+
+PR #31 已合并。工作区打开与 HTTP 保存不再等待向量推理；正文和全文索引先可用，向量随后后台更新。“已保存”与“向量就绪”是两个独立状态。Skill / Plugin 支持 ZIP 安装与本地安装状态恢复，并已提供功能示例包；远程社区仍是第三阶段计划。
+
+新增开发说明：
+
+- [工作区后台索引与保存](docs/development/工作区后台索引与保存开发说明.md)：状态、并发、恢复和验证。
+- [模型隔离向量索引与增量登记](docs/development/模型隔离向量索引与增量登记.md)：持久化 sqlite-vec 空间、旧向量复用、外部新增文件增量计算与检索性能验证。
+- [Mermaid 预览与缩放](docs/development/Mermaid预览与缩放开发说明.md)：大图适配、鼠标缩放和文字裁切修复。
+- [扩展安装持久化与社区包](docs/development/扩展安装持久化与社区包开发说明.md)：安装边界和示例包验证。
+- [模型上下文管理](docs/development/模型上下文管理.md)：全局人设、预算估算和摘要限制。
+- [第三阶段实施规划](docs/architecture/第三阶段实施规划.md)：Tauri Rust 容器、各社区与 Sync Server。
+
+代码基线 `a5c44c4` 的验证结果为后端 621 项、前端 345 项测试通过，前端生产构建通过。这是该提交的回归记录，不表示全部真实厂商及设备场景完成专项验收。
+
 ## 本地模型
 
 | 能力 | 当前模型 | 许可 | 说明 |

backend/README.md

@@ -101,3 +101,9 @@ uv run pytest
 - [阶段 F：Embedding 与知识库问题](../docs/retrospectives/阶段F-Embedding与知识库问题与解决方案.md)
 
 机器可读接口以运行中的 `/openapi.json` 为准。
+
+## 工作区保存与扩展恢复（2026-09-06）
+
+HTTP 保存先写正文、元数据及 FTS，再调度后台向量更新；打开 Vault 的向量计算也不再阻塞入口。手动全量重建接口仍等待完成。待处理标记持久化，重新打开 Vault 可恢复处理；任务详情不是完整持久化队列。
+
+实现与验证见 [工作区后台索引与保存](../docs/development/工作区后台索引与保存开发说明.md)。扩展安装日志、ZIP 限制和社区包测试见 [扩展安装持久化与社区包](../docs/development/扩展安装持久化与社区包开发说明.md)。

backend/app/agent/async_trace.py

@@ -0,0 +1,51 @@
+"""Serialize and batch durable Trace writes off the asyncio event loop."""
+import asyncio
+from contextvars import copy_context
+
+
+class AsyncTraceWriter:
+    def __init__(self, repository):
+        self.repository = repository
+        self.queue = asyncio.Queue(maxsize=1024)
+        self.worker = None
+
+    async def submit(self, operation, *args):
+        future = asyncio.get_running_loop().create_future()
+        await self.queue.put((operation, args, future))
+        if self.worker is None or self.worker.done():
+            self.worker = asyncio.create_task(self._drain())
+        # Cancellation must not let an older snapshot commit after cancellation.
+        cancelled = False
+        while not future.done():
+            try:
+                await asyncio.shield(future)
+            except asyncio.CancelledError:
+                cancelled = True
+        future.result()
+        return cancelled
+
+    async def _drain(self):
+        while not self.queue.empty():
+            batch = []
+            while len(batch) < 64 and not self.queue.empty():
+                batch.append(self.queue.get_nowait())
+            try:
+                work = asyncio.get_running_loop().run_in_executor(
+                    None, copy_context().run, self.repository.write_batch, [(op, args) for op, args, _ in batch])
+                # asyncio.run/shutdown may cancel every Task simultaneously. The
+                # executor Future survives; finish it and release all waiters.
+                while not work.done():
+                    try:
+                        await asyncio.shield(work)
+                    except asyncio.CancelledError:
+                        pass
+                work.result()
+            except Exception as exc:
+                for _, _, future in batch:
+                    future.set_exception(exc)
+            else:
+                for _, _, future in batch:
+                    future.set_result(None)
+            finally:
+                for _ in batch:
+                    self.queue.task_done()

backend/app/agent/runtime.py

@@ -4,6 +4,8 @@ from __future__ import annotations
 
 import asyncio
 import json
+from app.agent.async_trace import AsyncTraceWriter
+from app.operation_logs import log_event, agent_run_id
 from collections.abc import AsyncIterator
 from dataclasses import dataclass, field
 from datetime import datetime, timezone
@@ -65,6 +67,9 @@ class RunRecord:
     subscribers: set[asyncio.Queue[AgentEvent]] = field(default_factory=set)
     task: asyncio.Task[None] | None = None
     next_sequence: int = 0
+    publish_lock: asyncio.Lock = field(default_factory=asyncio.Lock)
+    cancel_lock: asyncio.Lock = field(default_factory=asyncio.Lock)
+    persisted_run: AgentRun | None = None
 
 
 class AgentRuntime:
@@ -84,6 +89,7 @@ class AgentRuntime:
         self.skills = skills
         self.trace_repository = trace_repository or AgentTraceRepository()
         self._records: dict[str, RunRecord] = {}
+        self._writer = AsyncTraceWriter(self.trace_repository)
 
     async def create_run(self, request: AgentRunCreateRequest) -> AgentRun:
         self._prune_records()
@@ -122,19 +128,25 @@ class AgentRuntime:
             skill_config=skill_config,
             allowed_tools=allowed_tools,
         )
-        self.trace_repository.create_run(
-            run,
-            request,
-            self._config_snapshot(record),
-        )
+        # Reserve capacity before yielding to concurrent creators.
         self._records[run.run_id] = record
+        try:
+            cancelled = await self._writer.submit('create', run.model_copy(deep=True), request.model_copy(deep=True), self._config_snapshot(record))
+        except BaseException:
+            self._records.pop(run.run_id, None)
+            raise
+        record.persisted_run = run.model_copy(deep=True)
+        log_event('agent', 'run.created', run_id=run.run_id, provider_id=run.provider_id, model=run.model)
+        if cancelled:
+            await self._finish_cancelled(record)
+            raise asyncio.CancelledError
         record.task = asyncio.create_task(self._execute(record), name=run.run_id)
         return run.model_copy(deep=True)
 
     def get_run(self, run_id: str) -> AgentRun:
         record = self._records.get(run_id)
         if record is not None:
-            return record.run.model_copy(deep=True)
+            return (record.persisted_run or record.run).model_copy(deep=True)
         run = self.trace_repository.recover_interrupted(run_id)
         if run is None:
             raise AgentRunNotFoundError(run_id)
@@ -145,7 +157,7 @@ class AgentRuntime:
         recovered = [
             self.trace_repository.recover_interrupted(item.run_id) or item
             if item.run_id not in self._records
-            else self._records[item.run_id].run.model_copy(deep=True)
+            else (self._records[item.run_id].persisted_run or self._records[item.run_id].run).model_copy(deep=True)
             for item in items
         ]
         return recovered, total
@@ -154,25 +166,24 @@ class AgentRuntime:
         record = self._records.get(run_id)
         if record is None:
             return self.get_run(run_id)
-        if record.run.status in TERMINAL_STATUSES:
-            return record.run.model_copy(deep=True)
-        record.run.cancelled = True
-        record.run.status = AgentRunStatus.cancelled
-        record.run.updated_at = datetime.now(timezone.utc)
-        self.permissions.cancel_run(run_id)
-        self._publish(record, AgentEventType.run_cancelled, {})
-        if record.task and not record.task.done():
-            record.task.cancel()
-        return record.run.model_copy(deep=True)
+        async with record.cancel_lock:
+            if record.task and not record.task.done():
+                if record.run.status not in TERMINAL_STATUSES:
+                    record.task.cancel()
+                    self.permissions.cancel_run(run_id)
+                await asyncio.gather(record.task, return_exceptions=True)
+            if record.run.status not in TERMINAL_STATUSES:
+                await self._finish_cancelled(record)
+            return (record.persisted_run or record.run).model_copy(deep=True)
 
-    def resolve_permission(self, run_id: str, request_id: str, decision: str) -> bool:
+    async def resolve_permission(self, run_id: str, request_id: str, decision: str) -> bool:
         record = self._records.get(run_id)
         if record is None:
             return False
         ticket = self.permissions.get_ticket(run_id, request_id)
         resolved = self.permissions.resolve(run_id, request_id, decision)
         if resolved:
-            self._publish(
+            await self._publish(
                 record,
                 AgentEventType.permission_resolved,
                 {
@@ -189,23 +200,24 @@ class AgentRuntime:
         record = self._records.get(run_id)
         run = self.get_run(run_id)
         if record is None:
-            for event in self.trace_repository.list_events(
+            for event in await asyncio.to_thread(self.trace_repository.list_events,
                 run_id, after_sequence=after_sequence
             ):
                 yield event
             return
 
-        # 先注册订阅再读持久化历史；同一事件循环内没有 await，不会丢失交界事件。
+        # 先注册再异步读取历史；历史与实时队列的交界用 sequence 去重。
         queue: asyncio.Queue[AgentEvent] = asyncio.Queue()
         record.subscribers.add(queue)
-        history = self.trace_repository.list_events(
-            run_id, after_sequence=after_sequence
-        )
         last_sequence = after_sequence
         try:
+            history = await asyncio.to_thread(self.trace_repository.list_events,
+                run_id, after_sequence=after_sequence)
             for event in history:
                 last_sequence = event.sequence
                 yield event
+                if event.event in {AgentEventType.run_completed, AgentEventType.run_failed, AgentEventType.run_cancelled}:
+                    return
             if run.status in TERMINAL_STATUSES:
                 return
             while True:
@@ -232,7 +244,7 @@ class AgentRuntime:
                 await asyncio.shield(record.task)
             except asyncio.CancelledError:
                 pass
-        return record.run.model_copy(deep=True)
+        return (record.persisted_run or record.run).model_copy(deep=True)
 
     def get_trace(
         self, run_id: str, *, after_sequence: int, limit: int
@@ -246,23 +258,35 @@ class AgentRuntime:
         return trace
 
     async def _execute(self, record: RunRecord) -> None:
+        token = agent_run_id.set(record.run.run_id)
         try:
             async with asyncio.timeout(record.request.run_timeout_seconds):
                 await self._run_loop(record)
         except asyncio.CancelledError:
             if record.run.status != AgentRunStatus.cancelled:
-                self._finish_cancelled(record)
+                await self._finish_cancelled(record)
         except TimeoutError:
-            self._fail(record, "AGENT_TIMEOUT", "Agent run exceeded its timeout.")
+            await self._fail(record, "AGENT_TIMEOUT", "Agent run exceeded its timeout.")
         except ProviderError as exc:
-            self._fail(record, exc.code, exc.message)
+            await self._fail(record, exc.code, exc.message)
         except Exception as exc:
-            self._fail(record, "AGENT_FAILED", str(exc))
+            log_event('agent', 'execution.failed', level='ERROR', error=exc, run_id=record.run.run_id)
+            await self._fail(record, "AGENT_FAILED", str(exc))
+        finally:
+            self.permissions.cancel_run(record.run.run_id)
+            agent_run_id.reset(token)
+
+    async def shutdown(self) -> None:
+        results = await asyncio.gather(*(self.cancel(run_id) for run_id in list(self._records)), return_exceptions=True)
+        for result in results:
+            if isinstance(result, BaseException):
+                log_event('agent', 'shutdown.failed', level='ERROR', error=result)
+        await self._writer.queue.join()
 
     async def _run_loop(self, record: RunRecord) -> None:
         record.run.status = AgentRunStatus.running
         record.run.updated_at = datetime.now(timezone.utc)
-        self._publish(
+        await self._publish(
             record,
             AgentEventType.run_started,
             {"provider_id": record.request.provider_id, "model": record.request.model},
@@ -277,7 +301,7 @@ class AgentRuntime:
             record.run.updated_at = datetime.now(timezone.utc)
             model_call_id = f"model_call_{uuid4().hex}"
             started_at = perf_counter()
-            self._publish(
+            await self._publish(
                 record,
                 AgentEventType.model_call_started,
                 {
@@ -299,7 +323,7 @@ class AgentRuntime:
                     )
                 )
             except Exception as exc:
-                self._publish(
+                await self._publish(
                     record,
                     AgentEventType.model_call_failed,
                     {
@@ -309,7 +333,7 @@ class AgentRuntime:
                     },
                 )
                 raise
-            self._publish(
+            await self._publish(
                 record,
                 AgentEventType.model_call_completed,
                 {
@@ -322,7 +346,7 @@ class AgentRuntime:
                 },
             )
             record.run.token_usage += turn.input_tokens + turn.output_tokens
-            self._publish(
+            await self._publish(
                 record,
                 AgentEventType.usage,
                 {"token_usage": record.run.token_usage},
@@ -331,12 +355,12 @@ class AgentRuntime:
                 record.request.token_budget is not None
                 and record.run.token_usage > record.request.token_budget
             ):
-                self._fail(record, "TOKEN_BUDGET_EXCEEDED", "Agent token budget exceeded.")
+                await self._fail(record, "TOKEN_BUDGET_EXCEEDED", "Agent token budget exceeded.")
                 return
 
             if turn.tool_calls:
                 if len(turn.tool_calls) > MAX_TOOL_CALLS_PER_TURN:
-                    self._fail(
+                    await self._fail(
                         record,
                         "TOO_MANY_TOOL_CALLS",
                         f"Provider requested more than {MAX_TOOL_CALLS_PER_TURN} tools in one turn.",
@@ -360,10 +384,17 @@ class AgentRuntime:
                     async with semaphore:
                         return await self._execute_tool(record, call, model_call_id)
 
-                results = await asyncio.gather(*(execute(call) for call in calls))
+                executions = [asyncio.create_task(execute(call)) for call in calls]
+                try:
+                    results = await asyncio.gather(*executions)
+                finally:
+                    for execution in executions:
+                        if not execution.done():
+                            execution.cancel()
+                    await asyncio.gather(*executions, return_exceptions=True)
                 for call, result in zip(calls, results):
                     record.run.tool_results.append(result)
-                    self._collect_citations(record, result)
+                    await self._collect_citations(record, result)
                     messages.append(
                         Message(
                             role=MessageRole.tool,
@@ -376,20 +407,20 @@ class AgentRuntime:
 
             if turn.text is not None:
                 record.run.output = turn.text
-                self._publish(record, AgentEventType.text_delta, {"text": turn.text})
+                await self._publish(record, AgentEventType.text_delta, {"text": turn.text})
                 record.run.status = AgentRunStatus.completed
                 record.run.updated_at = datetime.now(timezone.utc)
-                self._publish(
+                await self._publish(
                     record,
                     AgentEventType.run_completed,
                     {"output": turn.text, "token_usage": record.run.token_usage},
                 )
                 return
 
-            self._fail(record, "EMPTY_MODEL_RESPONSE", "Provider returned no text or tool call.")
+            await self._fail(record, "EMPTY_MODEL_RESPONSE", "Provider returned no text or tool call.")
             return
 
-        self._fail(record, "MAX_STEPS_EXCEEDED", "Agent reached its maximum step count.")
+        await self._fail(record, "MAX_STEPS_EXCEEDED", "Agent reached its maximum step count.")
 
     async def _execute_tool(
         self, record: RunRecord, call: ToolCall, parent_model_call_id: str
@@ -397,7 +428,7 @@ class AgentRuntime:
         started_at = perf_counter()
         call_data = call.model_dump(mode="json")
         call_data["parent_model_call_id"] = parent_model_call_id
-        self._publish(record, AgentEventType.tool_call, call_data)
+        await self._publish(record, AgentEventType.tool_call, call_data)
         try:
             registered = self.tools.get(call.name)
         except ToolNotFoundError:
@@ -411,7 +442,7 @@ class AgentRuntime:
                 error_code="TOOL_NOT_ALLOWED",
                 error_message="Tool is not included in allowed_tools.",
             )
-            self._publish_tool_result(
+            await self._publish_tool_result(
                 record, result, parent_model_call_id, started_at
             )
             return result
@@ -425,7 +456,7 @@ class AgentRuntime:
                 error_code="NETWORK_NOT_ALLOWED",
                 error_message="Agent run does not allow network tools.",
             )
-            self._publish_tool_result(
+            await self._publish_tool_result(
                 record, result, parent_model_call_id, started_at
             )
             return result
@@ -436,7 +467,7 @@ class AgentRuntime:
             # 运行状态必须在等待期间可见，前端才能展示并处理权限确认卡片。
             ticket = self.permissions.create_ticket(record.run.run_id, permission)
             record.run.status = AgentRunStatus.waiting_permission
-            self._publish(
+            await self._publish(
                 record,
                 AgentEventType.permission_required,
                 {
@@ -458,13 +489,18 @@ class AgentRuntime:
                     error_code="PERMISSION_TIMEOUT",
                     error_message="Tool permission confirmation timed out.",
                 )
-                self._publish_tool_result(
+                await self._publish_tool_result(
                     record, result, parent_model_call_id, started_at
                 )
                 return result
             record.run.status = AgentRunStatus.running
             record.run.updated_at = datetime.now(timezone.utc)
-            self.trace_repository.save_run(record.run)
+            async with record.publish_lock:
+                snapshot = record.run.model_copy(deep=True)
+                cancelled = await self._writer.submit('save', snapshot)
+                record.persisted_run = snapshot
+                if cancelled:
+                    raise asyncio.CancelledError
             result = (
                 await self._invoke_tool(record, call)
                 if decision in {"allow_once", "allow_session"}
@@ -473,10 +509,10 @@ class AgentRuntime:
         else:
             result = await self._invoke_tool(record, call)
 
-        self._publish_tool_result(record, result, parent_model_call_id, started_at)
+        await self._publish_tool_result(record, result, parent_model_call_id, started_at)
         return result
 
-    def _publish_tool_result(
+    async def _publish_tool_result(
         self,
         record: RunRecord,
         result: ToolResult,
@@ -486,7 +522,7 @@ class AgentRuntime:
         data = result.model_dump(mode="json")
         data["parent_model_call_id"] = parent_model_call_id
         data["duration_ms"] = int((perf_counter() - started_at) * 1000)
-        self._publish(record, AgentEventType.tool_result, data)
+        await self._publish(record, AgentEventType.tool_result, data)
 
     async def _invoke_tool(self, record: RunRecord, call: ToolCall) -> ToolResult:
         try:
@@ -519,45 +555,60 @@ class AgentRuntime:
             error_message="Tool permission was denied.",
         )
 
-    def _finish_cancelled(self, record: RunRecord) -> None:
+    async def _finish_cancelled(self, record: RunRecord) -> None:
         record.run.cancelled = True
         record.run.status = AgentRunStatus.cancelled
         record.run.updated_at = datetime.now(timezone.utc)
-        self._publish(record, AgentEventType.run_cancelled, {})
+        await self._publish(record, AgentEventType.run_cancelled, {})
 
-    def _fail(self, record: RunRecord, code: str, message: str) -> None:
-        if record.run.status in TERMINAL_STATUSES:
+    async def _fail(self, record: RunRecord, code: str, message: str) -> None:
+        log_event('agent', 'run.error', level='ERROR', run_id=record.run.run_id, error_code=code)
+        if record.persisted_run and record.persisted_run.status in TERMINAL_STATUSES:
             return
         record.run.status = AgentRunStatus.failed
         record.run.error_code = code
         record.run.error_message = message
         record.run.updated_at = datetime.now(timezone.utc)
-        self._publish(
+        await self._publish(
             record,
             AgentEventType.run_failed,
             {"code": code, "message": message},
         )
 
-    def _publish(
+    async def _publish(
         self, record: RunRecord, event_type: AgentEventType, data: dict[str, object]
     ) -> None:
-        sanitized = sanitize_trace_value(data)
-        assert isinstance(sanitized, dict)
-        event = AgentEvent(
-            event=event_type,
-            run_id=record.run.run_id,
-            sequence=record.next_sequence,
-            data=sanitized,
-            timestamp=datetime.now(timezone.utc),
-        )
-        record.next_sequence += 1
-        record.events.append(event)
-        self.trace_repository.append_event(record.run, event)
-        # 内存只保留实时订阅窗口；完整审计轨迹由 SQLite 保存。
-        if len(record.events) > MAX_EVENTS_PER_RUN:
-            del record.events[: len(record.events) - MAX_EVENTS_PER_RUN]
-        for queue in record.subscribers:
-            queue.put_nowait(event)
+        async with record.publish_lock:
+            sanitized = sanitize_trace_value(data)
+            assert isinstance(sanitized, dict)
+            event = AgentEvent(
+                event=event_type,
+                run_id=record.run.run_id,
+                sequence=record.next_sequence,
+                data=sanitized,
+                timestamp=datetime.now(timezone.utc),
+            )
+            snapshot = record.run.model_copy(deep=True)
+            try:
+                cancelled = await self._writer.submit('event', snapshot, event)
+            except Exception as exc:
+                log_event('agent', 'trace.write_failed', level='ERROR', error=exc, run_id=record.run.run_id)
+                raise
+            record.next_sequence += 1
+            record.persisted_run = snapshot
+            record.events.append(event)
+            log_event('agent', event_type.value,
+                      level='ERROR' if event_type.value.endswith('Failed') or data.get('success') is False else 'INFO',
+                      run_id=record.run.run_id, provider_id=record.run.provider_id, model=record.run.model,
+                      sequence=event.sequence, step=record.run.current_step, status=snapshot.status.value,
+                      tool=data.get('name'), error_code=data.get('code') or data.get('error_code'))
+            # 内存只保留实时订阅窗口；完整审计轨迹由 SQLite 保存。
+            if len(record.events) > MAX_EVENTS_PER_RUN:
+                del record.events[: len(record.events) - MAX_EVENTS_PER_RUN]
+            for queue in record.subscribers:
+                queue.put_nowait(event)
+            if cancelled:
+                raise asyncio.CancelledError
 
     @staticmethod
     def _request_metadata(record: RunRecord) -> dict[str, object]:
@@ -583,7 +634,7 @@ class AgentRuntime:
             "metadata": record.request.metadata,
         }
 
-    def _collect_citations(self, record: RunRecord, result: ToolResult) -> None:
+    async def _collect_citations(self, record: RunRecord, result: ToolResult) -> None:
         if not result.success or not isinstance(result.output, dict):
             return
         items = result.output.get("items")
@@ -601,7 +652,7 @@ class AgentRuntime:
                 continue
             known.add(citation.citation_id)
             record.run.citations.append(citation)
-            self._publish(record, AgentEventType.citation, citation.model_dump(mode="json"))
+            await self._publish(record, AgentEventType.citation, citation.model_dump(mode="json"))
 
     def _get_record(self, run_id: str) -> RunRecord:
         try:
@@ -618,7 +669,7 @@ class AgentRuntime:
             (
                 record
                 for record in self._records.values()
-                if record.run.status in TERMINAL_STATUSES
+                if record.run.status in TERMINAL_STATUSES and (record.task is None or record.task.done())
             ),
             key=lambda record: record.run.updated_at,
         )

backend/app/agent/trace_repository.py

@@ -6,6 +6,7 @@ SQLite 中的事件是 SSE、前端 Trace 和 Benchmark 的共同事实来源。
 
 from __future__ import annotations
 
+from contextlib import nullcontext
 import json
 import re
 from datetime import datetime, timezone
@@ -94,15 +95,30 @@ def sanitize_trace_value(
 
 
 class AgentTraceRepository:
+    def write_batch(self, jobs):
+        conn = connect()
+        try:
+            with transaction(conn):
+                for operation, args in jobs:
+                    if operation == 'create':
+                        self.create_run(*args, _conn=conn)
+                    elif operation == 'save':
+                        self.save_run(*args, _conn=conn)
+                    else:
+                        self.append_event(*args, _conn=conn)
+        finally:
+            conn.close()
+
     def create_run(
         self,
         run: AgentRun,
         request: AgentRunCreateRequest,
         config_snapshot: dict[str, Any],
+        *, _conn=None,
     ) -> None:
-        conn = connect()
+        conn = _conn or connect()
         try:
-            with transaction(conn):
+            with transaction(conn) if _conn is None else nullcontext():
                 conn.execute(
                     """
                     INSERT INTO agent_runs(
@@ -126,22 +142,24 @@ class AgentTraceRepository:
                     ),
                 )
         finally:
-            conn.close()
+            if _conn is None:
+                conn.close()
 
-    def save_run(self, run: AgentRun) -> None:
-        conn = connect()
+    def save_run(self, run: AgentRun, *, _conn=None) -> None:
+        conn = _conn or connect()
         try:
-            with transaction(conn):
+            with transaction(conn) if _conn is None else nullcontext():
                 self._update_run(conn, run)
         finally:
-            conn.close()
+            if _conn is None:
+                conn.close()
 
-    def append_event(self, run: AgentRun, event: AgentEvent) -> None:
+    def append_event(self, run: AgentRun, event: AgentEvent, *, _conn=None) -> None:
         """在同一事务中保存最新 Run 和事件；复写同一序号时保持幂等。"""
 
-        conn = connect()
+        conn = _conn or connect()
         try:
-            with transaction(conn):
+            with transaction(conn) if _conn is None else nullcontext():
                 self._update_run(conn, run)
                 conn.execute(
                     """
@@ -158,7 +176,8 @@ class AgentTraceRepository:
                     ),
                 )
         finally:
-            conn.close()
+            if _conn is None:
+                conn.close()
 
     def get_run(self, run_id: str) -> AgentRun | None:
         conn = connect()

backend/app/contracts.py

@@ -116,6 +116,7 @@ class NoteUpdateRequest(Contract):
     title: str | None = None
     markdown: str | None = None
     tags: list[str] | None = None
+    expected_content_hash: str | None = Field(default=None, pattern=r"^[0-9a-f]{64}$")
 
 
 class NoteMoveRequest(Contract):
@@ -1131,6 +1132,11 @@ class TranscriptNoteRequest(Contract):
 
 
 class IndexStatus(Contract):
+    running_jobs: int = 0
+    active_searches: int = 0
+    completed_searches: int = 0
+    failed_searches: int = 0
+    cancelled_searches: int = 0
     vector_refresh_required: bool = False
     total_notes: int = 0
     total_blocks: int = 0

backend/app/errors.py

@@ -25,6 +25,10 @@ class ApiError(Exception):
 
 
 async def api_error_handler(_: Request, exc: ApiError) -> JSONResponse:
+    from app.operation_logs import log_event
+    log_event('api', 'operation.failed', level='ERROR' if exc.status_code >= 500 else 'WARNING',
+              error=exc, status=exc.status_code,
+              **{key: value for key, value in exc.details.items() if key in {'run_id', 'task_id', 'note_id', 'job_id', 'provider_id'}})
     body = ErrorResponse(
         error=ErrorDetail(code=exc.code, message=exc.message, details=exc.details)
     )

backend/app/local_models/protocol.py

@@ -0,0 +1,11 @@
+"""Bound embedding result frames so large notes do not exceed pipe line limits."""
+import json
+
+
+def response_lines(response, operation):
+    if operation == 'embedding' and 'result' in response and 'error_code' not in response:
+        vectors = response['result']
+        for offset in range(0, len(vectors), 128):
+            yield json.dumps({'embedding_offset': offset, 'embedding_chunk': vectors[offset:offset + 128]}, allow_nan=False) + '\n'
+        response = {**response, 'result': [], 'embedding_count': len(vectors)}
+    yield json.dumps(response, ensure_ascii=False, allow_nan=False) + '\n'

backend/app/local_models/runtime.py

@@ -189,15 +189,30 @@ class Runtime:
                 await process.stdin.drain()
                 process.stdin.close()
                 final = None
+                vectors = []
                 while line := await process.stdout.readline():
                     message = json.loads(line)
-                    if "progress" in message:
+                    if "embedding_chunk" in message:
+                        chunk = message['embedding_chunk']
+                        if (operation != 'embedding' or not isinstance(chunk, list)
+                                or message.get('embedding_offset') != len(vectors)
+                                or len(vectors) + len(chunk) > len(payload.get('texts', []))):
+                            raise ProviderError('LOCAL_MODEL_INVALID_RESPONSE', '本地向量传输顺序或数量无效。')
+                        vectors.extend(chunk)
+                    elif "progress" in message:
                         callback = runtime_progress.get()
                         if callback:
                             callback(message)
                     else:
                         final = message
                 await process.wait()
+                if isinstance(final, dict) and 'embedding_count' in final:
+                    if (final['embedding_count'] != len(vectors)
+                            or len(vectors) != len(payload.get('texts', []))):
+                        raise ProviderError('LOCAL_MODEL_INVALID_RESPONSE', '本地向量传输不完整。')
+                    final['result'] = vectors
+                elif vectors:
+                    raise ProviderError('LOCAL_MODEL_INVALID_RESPONSE', '本地向量传输缺少结束标记。')
                 return final
             try:
                 result = await asyncio.wait_for(receive(), config.timeout_seconds)

backend/app/local_models/worker.py

@@ -216,4 +216,6 @@ if __name__ == "__main__":
                 response = {"error_code": "LOCAL_INFERENCE_FAILED", "message": "本地推理失败，请检查媒体格式、模型和设备配置。"}
     if "error_code" in response:
         response["diagnostics"] = {"requested_device": request["config"]["device"], "actual_device": request.get("_actual_device", "unknown")}
-    sys.stdout.buffer.write((json.dumps(response, ensure_ascii=False, allow_nan=False) + "\n").encode("utf-8"))
+    from protocol import response_lines
+    for line in response_lines(response, request['operation']):
+        sys.stdout.buffer.write(line.encode('utf-8'))

backend/app/log_routes.py

@@ -0,0 +1,11 @@
+from fastapi import APIRouter, Query
+from app.operation_logs import get_store
+
+router = APIRouter(prefix='/api/logs', tags=['Diagnostics'])
+
+
+@router.get('')
+def list_logs(limit: int = Query(50, ge=1, le=200), before: int | None = Query(None, ge=1),
+              level: str = Query('', pattern='^(|INFO|WARNING|ERROR|CRITICAL)$'),
+              source: str = Query('', max_length=100), q: str = Query('', max_length=200)):
+    return get_store().query(limit=limit, before=before, level=level, source=source, q=q)

backend/app/main.py

@@ -1,4 +1,7 @@
 from contextlib import asynccontextmanager
+import asyncio
+from time import perf_counter
+from uuid import uuid4
 
 from fastapi import FastAPI
 from fastapi.exceptions import RequestValidationError
@@ -14,17 +17,22 @@ from app.local_model_routes import router as local_model_router
 from app.usage_routes import router as usage_router
 from app.provider_preview_routes import router as provider_preview_router
 from app.schemas import HealthResponse, ServiceStatusResponse
+from app.log_routes import router as log_router
+from app.operation_logs import install_logging, log_event, request_id, shutdown_logging
 
 settings = get_settings()
 
 
 @asynccontextmanager
 async def lifespan(_: FastAPI):
+    install_logging()
+    log_event('system', 'service.started')
     from app.services import transcription_service
     transcription_service.recover_interrupted()
     try:
         yield
     finally:
+        await container.agent.shutdown()
         from app.services import index_service
         await index_service.shutdown()
         await transcription_service.shutdown()
@@ -35,6 +43,8 @@ async def lifespan(_: FastAPI):
             await manager.cancel_download(key)
         container.plugins.shutdown()
         container.mcp_servers.shutdown()
+        log_event('system', 'service.stopped')
+        await asyncio.to_thread(shutdown_logging)
 
 
 app = FastAPI(
@@ -60,6 +70,32 @@ app.include_router(media_router)
 app.include_router(local_model_router)
 app.include_router(usage_router)
 app.include_router(provider_preview_router)
+app.include_router(log_router)
+
+
+@app.middleware('http')
+async def operation_log(request, call_next):
+    token = request_id.set(uuid4().hex)
+    started = perf_counter()
+    status = 500
+    failure = None
+    try:
+        response = await call_next(request)
+        status = response.status_code
+        response.headers['X-Request-ID'] = request_id.get()
+        return response
+    except Exception as exc:
+        failure = exc
+        raise
+    finally:
+        # Do not record query strings, request/response bodies or arbitrary URLs.
+        route = getattr(request.scope.get('route'), 'path', 'unmatched')
+        if not route.startswith('/api/logs') and (request.method not in {'GET', 'HEAD', 'OPTIONS'} or status >= 400 or perf_counter() - started > 1):
+            log_event('http', 'request.finished', level='ERROR' if status >= 500 else 'WARNING' if status >= 400 else 'INFO',
+                      error=failure, method=request.method, route=route, status=status,
+                      duration_ms=round((perf_counter() - started) * 1000, 2),
+                      **{k: v for k, v in request.path_params.items() if k in {'run_id', 'task_id', 'note_id', 'job_id', 'provider_id'}})
+        request_id.reset(token)
 
 
 @app.get("/health", response_model=HealthResponse, tags=["System"])

backend/app/operation_logs.py

@@ -0,0 +1,186 @@
+"""Bounded, asynchronous operational diagnostics, separate from business/Trace data.
+
+Only explicitly allowed metadata is stored. Never store prompts, tool arguments,
+provider response bodies or raw exception messages in this diagnostic channel.
+"""
+from __future__ import annotations
+
+import json
+import logging
+import math
+import queue
+import re
+import sqlite3
+import threading
+import traceback
+from contextvars import ContextVar
+from contextlib import closing
+from datetime import datetime, timezone
+from pathlib import Path
+
+from app.config import get_settings
+
+request_id: ContextVar[str] = ContextVar('log_request_id', default='')
+agent_run_id: ContextVar[str] = ContextVar('log_agent_run_id', default='')
+_allowed = {'run_id', 'task_id', 'note_id', 'job_id', 'provider_id', 'model',
+            'device', 'error_code', 'error_type', 'status', 'duration_ms', 'count',
+            'step', 'sequence', 'tool', 'method', 'route', 'request_id', 'fallback',
+            'frames', 'source', 'changed_fields'}
+_safe = re.compile(r'[^\w .:/@{}\[\],()=+\-]', re.UNICODE)
+
+
+def metadata(values: dict) -> dict:
+    result = {}
+    for key, value in values.items():
+        if key not in _allowed or value is None:
+            continue
+        if isinstance(value, (int, float, bool)):
+            if not isinstance(value, float) or math.isfinite(value):
+                result[key] = value
+        else:
+            text = str(value)
+            text = re.sub(r'(?i)(?:bearer\s+\S+|sk-[\w-]+)', '[REDACTED]', text)
+            result[key] = _safe.sub('', text)[:500]
+    return result
+
+
+class LogStore:
+    def __init__(self, path: Path, *, retain: int = 20_000):
+        self.path = path
+        self.retain = retain
+        self.queue: queue.Queue = queue.Queue(maxsize=4096)
+        self.dropped = 0
+        self.failed = 0
+        self.closed = False
+        self.state_lock = threading.Lock()
+        self.thread = threading.Thread(target=self._write, name='operation-logs', daemon=True)
+        path.parent.mkdir(parents=True, exist_ok=True)
+        with closing(self._connect()) as conn, conn:
+            conn.execute('CREATE TABLE IF NOT EXISTS logs (id INTEGER PRIMARY KEY, timestamp TEXT NOT NULL, level TEXT NOT NULL, source TEXT NOT NULL, event TEXT NOT NULL, details TEXT NOT NULL)')
+            conn.execute('CREATE INDEX IF NOT EXISTS logs_level_id ON logs(level, id)')
+            conn.execute('CREATE INDEX IF NOT EXISTS logs_source_id ON logs(source, id)')
+        self.thread.start()
+
+    def _connect(self):
+        conn = sqlite3.connect(self.path, timeout=5)
+        conn.row_factory = sqlite3.Row
+        return conn
+
+    def emit(self, level: str, source: str, event: str, details: dict):
+        row = (datetime.now(timezone.utc).isoformat(), level, source[:100], event[:160], json.dumps(metadata(details), ensure_ascii=False))
+        with self.state_lock:
+            if self.closed:
+                return
+            try:
+                self.queue.put_nowait(row)
+            except queue.Full:
+                self.dropped += 1
+
+    def _write(self):
+        while True:
+            first = self.queue.get()
+            batch = [first]
+            while len(batch) < 128:
+                try:
+                    batch.append(self.queue.get_nowait())
+                except queue.Empty:
+                    break
+            stop = None in batch
+            rows = [row for row in batch if row is not None]
+            try:
+                if rows:
+                    with closing(self._connect()) as conn, conn:
+                        conn.executemany('INSERT INTO logs(timestamp,level,source,event,details) VALUES(?,?,?,?,?)', rows)
+                        conn.execute('DELETE FROM logs WHERE id <= (SELECT id FROM logs ORDER BY id DESC LIMIT 1 OFFSET ?)', (self.retain,))
+            except Exception:
+                self.failed += len(rows)
+            finally:
+                for _ in batch:
+                    self.queue.task_done()
+            if stop:
+                return
+
+    def query(self, *, limit=50, before=None, level='', source='', q=''):
+        clauses, args = [], []
+        for column, value in [('level', level), ('source', source)]:
+            if value:
+                clauses.append(f'{column} = ?')
+                args.append(value)
+        if before is not None:
+            clauses.append('id < ?')
+            args.append(before)
+        if q:
+            clauses.append('(instr(event, ?) > 0 OR instr(details, ?) > 0)')
+            args += [q, q]
+        where = ' WHERE ' + ' AND '.join(clauses) if clauses else ''
+        with closing(self._connect()) as conn, conn:
+            rows = conn.execute('SELECT * FROM logs' + where + ' ORDER BY id DESC LIMIT ?', (*args, limit + 1)).fetchall()
+            sources = [row[0] for row in conn.execute('SELECT DISTINCT source FROM logs ORDER BY source')]
+        items = [{**dict(row), 'details': json.loads(row['details'])} for row in rows[:limit]]
+        return {'items': items, 'next_cursor': items[-1]['id'] if len(rows) > limit else None,
+                'sources': sources, 'pending': self.queue.qsize(), 'dropped': self.dropped,
+                'write_failures': self.failed, 'retention': self.retain}
+
+    def close(self):
+        with self.state_lock:
+            if self.closed:
+                return
+            self.closed = True
+        self.queue.put(None)
+        self.thread.join(timeout=15)
+
+
+_store: LogStore | None = None
+_lock = threading.Lock()
+
+
+def get_store() -> LogStore:
+    global _store
+    path = get_settings().data_dir / 'logs' / 'operations.sqlite3'
+    with _lock:
+        if _store is None or _store.path != path or _store.closed:
+            if _store is not None and not _store.closed:
+                _store.close()
+            _store = LogStore(path)
+        return _store
+
+
+def log_event(module: str, event: str, *, level='INFO', error: BaseException | None = None, **details):
+    if request_id.get():
+        details.setdefault('request_id', request_id.get())
+    if agent_run_id.get():
+        details.setdefault('run_id', agent_run_id.get())
+    if error:
+        details['error_type'] = type(error).__name__
+        details.setdefault('error_code', getattr(error, 'code', None))
+        details['frames'] = '; '.join(f'{Path(f.filename).name}:{f.lineno}:{f.name}' for f in traceback.extract_tb(error.__traceback__)[-8:])
+    try:
+        get_store().emit(level, module, event, details)
+    except Exception:
+        # Logging must not turn a successful save/run into a business failure.
+        logging.getLogger('operation_log_storage').error('Operational log storage unavailable')
+
+
+class ApplicationLogHandler(logging.Handler):
+    def emit(self, record):
+        if record.name == 'operation_log_storage' or getattr(record, '_notes_operation_logged', False):
+            return
+        record._notes_operation_logged = True
+        # Legacy log messages can include note text/credentials, even in f-strings.
+        # Preserve source location and error class; structured call sites carry IDs.
+        log_event(record.name, 'application.warning' if record.levelno < 40 else 'application.error',
+                  level=record.levelname, error=record.exc_info[1] if record.exc_info else None,
+                  frames=f'{Path(record.pathname).name}:{record.lineno}:{record.funcName}')
+
+
+def install_logging():
+    # Uvicorn's default logger stops propagation before the root logger.
+    for name in ('', 'uvicorn'):
+        logger = logging.getLogger(name)
+        if not any(isinstance(h, ApplicationLogHandler) for h in logger.handlers):
+            logger.addHandler(ApplicationLogHandler(level=logging.WARNING))
+
+
+def shutdown_logging():
+    if _store is not None and not _store.closed:
+        _store.close()

backend/app/retrieval/activity.py

@@ -0,0 +1,30 @@
+"""Process-local retrieval activity, shared by search, RAG and Agent callers."""
+import asyncio
+from functools import wraps
+
+active = 0
+completed = 0
+failed = 0
+cancelled = 0
+
+
+def track_search(operation):
+    @wraps(operation)
+    async def wrapped(self, request):
+        global active, completed, failed, cancelled
+        if request.mode == 'fts':
+            return await operation(self, request)
+        active += 1
+        try:
+            result = await operation(self, request)
+            completed += 1
+            return result
+        except asyncio.CancelledError:
+            cancelled += 1
+            raise
+        except Exception:
+            failed += 1
+            raise
+        finally:
+            active -= 1
+    return wrapped

backend/app/retrieval/engine.py

@@ -10,6 +10,7 @@ from __future__ import annotations
 from datetime import datetime, timezone
 
 from app import repository
+from app.retrieval.activity import track_search
 from app.contracts import (
     Citation,
     PageMeta,
@@ -52,6 +53,7 @@ class RetrievalEngine:
         # remain authoritative, including monkeypatches on the singleton.
         self._routed_defaults = (embedding, vector_store) if route_embeddings else None
 
+    @track_search
     async def search(self, request: SearchRequest) -> SearchResponse:
         if request.mode == SearchMode.fts:
             return self._search_fts(request)

backend/app/retrieval/routed_vectors.py

@@ -2,15 +2,14 @@
 
 The runtime's model_id is the authoritative space ID (including provider URL,
 endpoint, model and dimensions); equal dimensions alone never imply compatibility.
-This phase uses a lazy, rebuildable SQLite side table instead of a schema migration.
-Search scans only current blocks in one database snapshot and requires complete
-coverage. Cosine ranking costs O(blocks * dimensions) with an O(top_k) heap; this
-small-vault implementation should become a per-space ANN index at larger scale.
+Durable vectors are reused to build per-space/dimension sqlite-vec indexes lazily.
+Native exact KNN avoids Python JSON decoding and dot products on every search.
+Coverage checks and ranking share one transaction.
 """
 
 from __future__ import annotations
 
-import heapq
+import asyncio
 import json
 import logging
 import math
@@ -20,9 +19,11 @@ from typing import Protocol
 
 from app.database.db import connect, transaction
 from app.errors import ApiError
+from app.operation_logs import log_event
 from app.retrieval.vectorstore import VectorHit
 from app.retrieval.provenance import record_embedding
 from app.retrieval.hybrid import rrf_fuse
+from app.retrieval import space_index
 
 logger = logging.getLogger(__name__)
 
@@ -101,6 +102,8 @@ async def embed_remote(texts: list[str], *, accept_local=False, strict=False, lo
             source=result.source,
         )
     except Exception as exc:
+        log_event('vectors', 'embedding.failed', level='ERROR' if strict else 'WARNING', error=exc,
+                  count=len(texts), fallback='none' if strict else 'local_index')
         # Avoid logging provider exceptions containing credentials or note text.
         record_embedding(fallback_reason="REMOTE_EMBEDDING_UNAVAILABLE")
         logger.warning("Remote embedding unavailable (%s); using local index", type(exc).__name__)
@@ -118,9 +121,15 @@ def _ensure_table(conn: sqlite3.Connection) -> None:
             block_id TEXT NOT NULL REFERENCES blocks(block_id) ON DELETE CASCADE,
             dimensions INTEGER NOT NULL CHECK (dimensions > 0),
             vector TEXT NOT NULL,
-            PRIMARY KEY (space_id, block_id)
+            PRIMARY KEY (space_id, dimensions, block_id)
         )
     """)
+    primary = [row[1] for row in sorted(conn.execute('PRAGMA table_info(routed_block_vectors)'), key=lambda row: row[5]) if row[5]]
+    if primary == ['space_id', 'block_id']:
+        conn.execute('CREATE TABLE routed_block_vectors_upgrade (space_id TEXT NOT NULL, block_id TEXT NOT NULL REFERENCES blocks(block_id) ON DELETE CASCADE, dimensions INTEGER NOT NULL CHECK(dimensions>0), vector TEXT NOT NULL, PRIMARY KEY(space_id,dimensions,block_id))')
+        conn.execute('INSERT INTO routed_block_vectors_upgrade SELECT * FROM routed_block_vectors')
+        conn.execute('DROP TABLE routed_block_vectors')
+        conn.execute('ALTER TABLE routed_block_vectors_upgrade RENAME TO routed_block_vectors')
     conn.execute("""
         CREATE INDEX IF NOT EXISTS routed_block_vectors_block_id
         ON routed_block_vectors(block_id)
@@ -146,13 +155,14 @@ def store_remote(
             conn.executemany(
                 """INSERT INTO routed_block_vectors (space_id, block_id, dimensions, vector)
                    VALUES (?, ?, ?, ?)
-                   ON CONFLICT (space_id, block_id) DO UPDATE SET
+                   ON CONFLICT (space_id, dimensions, block_id) DO UPDATE SET
                        dimensions = excluded.dimensions, vector = excluded.vector""",
                 [
                     (batch.space_id, block_id, batch.dimensions, json.dumps(vector, allow_nan=False))
                     for block_id, vector in zip(block_ids, batch.vectors)
                 ],
             )
+            space_index.upsert(conn, block_ids, batch)
         except BaseException:
             conn.execute("ROLLBACK TO routed_vectors_write")
             raise
@@ -180,6 +190,50 @@ async def search_remote(query: str, *, top_k: int, accept_local=False, strict=Fa
     if batch is None:
         return None
 
+    if not await _prepare_for_search([batch], strict):
+        return None
+    return await asyncio.to_thread(_search_space, batch, top_k, strict)
+
+
+async def _prepare_indexes(batches):
+    from app.services.coordination import vault_mutation_lock
+    def prepare(check_only=False):
+        conn = connect()
+        try:
+            if check_only:
+                return space_index.is_ready(conn, batches)
+            space_index.prepare(conn, batches)
+        finally:
+            conn.close()
+    if await asyncio.to_thread(prepare, True):
+        return
+    # Share the cooperative gate with saves: never block the event loop on a
+    # SQLite write lock while a migration owns it in another thread.
+    async with vault_mutation_lock():
+        work = asyncio.create_task(asyncio.to_thread(prepare))
+        cancelled = False
+        while not work.done():
+            try:
+                await asyncio.shield(work)
+            except asyncio.CancelledError:
+                cancelled = True
+        work.result()
+        if cancelled:
+            raise asyncio.CancelledError
+
+
+async def _prepare_for_search(batches, strict):
+    try:
+        await _prepare_indexes(batches)
+        return True
+    except Exception as exc:
+        record_embedding(fallback_reason='REMOTE_INDEX_UNAVAILABLE')
+        if strict:
+            raise ApiError(409, 'SEMANTIC_INDEX_UNAVAILABLE', '向量索引准备失败，请检查索引状态。') from exc
+        return False
+
+
+def _search_space(batch, top_k, strict):
     record_embedding(attempted_space={"model_id": batch.space_id, "dimensions": batch.dimensions})
     try:
         conn = connect()
@@ -195,29 +249,7 @@ async def search_remote(query: str, *, top_k: int, accept_local=False, strict=Fa
                     if strict:
                         raise ValueError("semantic index missing")
                     return None
-                rows = conn.execute(
-                    """SELECT b.block_id, r.vector
-                       FROM blocks AS b
-                       LEFT JOIN routed_block_vectors AS r
-                         ON r.block_id = b.block_id AND r.space_id = ? AND r.dimensions = ?
-                       ORDER BY b.block_id""",
-                    (batch.space_id, batch.dimensions),
-                )
-
-                def hits():
-                    for row in rows:
-                        if row["vector"] is None:
-                            raise ValueError("remote space has incomplete block coverage")
-                        vector = _unit_vector(json.loads(row["vector"]), batch.dimensions)
-                        score = math.fsum(a * b for a, b in zip(batch.vectors[0], vector))
-                        yield VectorHit(id=row["block_id"], score=max(0.0, min(1.0, score)))
-
-                try:
-                    result = heapq.nlargest(top_k, hits(), key=lambda hit: hit.score)
-                finally:
-                    # Exceptions may retain the generator/traceback; finalize its
-                    # cursor now so a subsequent rebuild can acquire a write lock.
-                    rows.close()
+                result = space_index.search(conn, batch, top_k)
                 record_embedding(source=batch.source, model_id=batch.space_id,
                                  dimensions=batch.dimensions, fallback_reason=None)
                 return result
@@ -241,6 +273,12 @@ async def _search_partitioned(query: str, policies: set[bool], *, top_k: int, st
         if batch is None:
             return None
         batches[policy] = batch
+    if not await _prepare_for_search(list(batches.values()), strict):
+        return None
+    return await asyncio.to_thread(_search_partitions, batches, policies, top_k, strict)
+
+
+def _search_partitions(batches, policies, top_k, strict):
     conn = connect()
     try:
         with transaction(conn):
@@ -250,23 +288,7 @@ async def _search_partitioned(query: str, policies: set[bool], *, top_k: int, st
                 raise ValueError("embedding policies changed while querying")
             ranked = []
             for policy, batch in batches.items():
-                rows = conn.execute(
-                    "SELECT b.block_id,r.vector FROM blocks b LEFT JOIN routed_block_vectors r "
-                    "ON r.block_id=b.block_id AND r.space_id=? AND r.dimensions=? "
-                    "WHERE b.embedding_local_only=? ORDER BY b.block_id",
-                    (batch.space_id, batch.dimensions, int(policy)),
-                )
-                def hits():
-                    for row in rows:
-                        if row['vector'] is None:
-                            raise ValueError("incomplete policy coverage")
-                        vector = _unit_vector(json.loads(row['vector']), batch.dimensions)
-                        score = math.fsum(a * b for a, b in zip(batch.vectors[0], vector))
-                        yield VectorHit(id=row['block_id'], score=max(0.0, min(1.0, score)))
-                try:
-                    ranked.append(heapq.nlargest(top_k, hits(), key=lambda hit: hit.score))
-                finally:
-                    rows.close()
+                ranked.append(space_index.search(conn, batch, top_k, policy))
             spaces = [{"source": b.source, "model_id": b.space_id, "dimensions": b.dimensions,
                        "local_only": policy} for policy, b in batches.items()]
             record_embedding(source="mixed" if len({b.source for b in batches.values()}) > 1 else batch.source,

backend/app/retrieval/space_index.py

@@ -0,0 +1,89 @@
+"""Persistent vec0 indexes derived from durable routed vectors, one per space/dimension."""
+import hashlib
+import json
+import threading
+
+import sqlite_vec
+
+from app.retrieval.vectorstore import VectorHit
+
+
+_migration_lock = threading.Lock()
+
+
+def is_ready(conn, batches):
+    return all(conn.execute('SELECT 1 FROM sqlite_master WHERE name=?',
+               (table_name(batch.space_id, batch.dimensions),)).fetchone() for batch in batches)
+
+
+def prepare(conn, batches):
+    """Finish lazy writes before opening a search snapshot. Warm searches do not write."""
+    from app.retrieval.routed_vectors import _ensure_table
+    batches = list(batches)
+    if is_ready(conn, batches):
+        return
+    # Waiting holds no read transaction, so a concurrent migration can commit.
+    with _migration_lock:
+        if is_ready(conn, batches):
+            return
+        conn.execute('BEGIN IMMEDIATE')
+        try:
+            _ensure_table(conn)
+            for batch in batches:
+                ensure(conn, batch.space_id, batch.dimensions)
+            conn.execute('COMMIT')
+        except BaseException:
+            conn.execute('ROLLBACK')
+            raise
+
+
+def table_name(space, dimensions):
+    return 'routed_vec_' + hashlib.sha256(json.dumps([space, dimensions]).encode()).hexdigest()
+
+
+def ensure(conn, space, dimensions):
+    from app.retrieval.routed_vectors import _unit_vector
+    table = table_name(space, dimensions)
+    if conn.execute('SELECT 1 FROM sqlite_master WHERE name=?', (table,)).fetchone():
+        return table
+    if type(dimensions) is not int or not 0 < dimensions <= 8192:
+        raise ValueError('unsupported vector dimensions')
+    conn.execute(f'CREATE VIRTUAL TABLE {table} USING vec0(block_id TEXT PRIMARY KEY, embedding float[{dimensions}], local_only INTEGER)')
+    for row in conn.execute('SELECT r.block_id,r.vector,b.embedding_local_only FROM routed_block_vectors r JOIN blocks b USING(block_id) WHERE r.space_id=? AND r.dimensions=?', (space, dimensions)):
+        conn.execute(f'INSERT INTO {table}(block_id,embedding,local_only) VALUES (?,?,?)',
+                     (row[0], sqlite_vec.serialize_float32(_unit_vector(json.loads(row[1]), dimensions)), row[2]))
+    literal = conn.execute('SELECT quote(?)', (space,)).fetchone()[0]
+    for event in ('DELETE', 'UPDATE'):
+        conn.execute(f'''CREATE TRIGGER {table}_{event.lower()} AFTER {event} ON routed_block_vectors
+            WHEN old.space_id={literal} AND old.dimensions={dimensions}
+            BEGIN DELETE FROM {table} WHERE block_id=old.block_id; END''')
+    return table
+
+
+def upsert(conn, block_ids, batch):
+    from app.retrieval.routed_vectors import _unit_vector
+    table = ensure(conn, batch.space_id, batch.dimensions)
+    for block_id, vector in zip(block_ids, batch.vectors):
+        conn.execute(f'DELETE FROM {table} WHERE block_id=?', (block_id,))
+        conn.execute(f'INSERT INTO {table}(block_id,embedding,local_only) SELECT block_id,?,embedding_local_only FROM blocks WHERE block_id=?',
+                     (sqlite_vec.serialize_float32(_unit_vector(vector, batch.dimensions)), block_id))
+
+
+def search(conn, batch, top_k, policy=None):
+    table = table_name(batch.space_id, batch.dimensions)
+    # Coverage checks stay relational; no JSON decoding or Python dot products on the hot path.
+    where = '' if policy is None else ' AND b.embedding_local_only=?'
+    params = () if policy is None else (int(policy),)
+    missing = conn.execute(f'''SELECT 1 FROM blocks b LEFT JOIN routed_block_vectors r
+        ON r.block_id=b.block_id AND r.space_id=? AND r.dimensions=?
+        WHERE r.block_id IS NULL{where} LIMIT 1''', (batch.space_id, batch.dimensions, *params)).fetchone()
+    expected = conn.execute('SELECT COUNT(*) FROM blocks' + ('' if policy is None else ' WHERE embedding_local_only=?'), params).fetchone()[0]
+    actual = conn.execute(f'SELECT COUNT(*) FROM {table}' + ('' if policy is None else ' WHERE local_only=?'), params).fetchone()[0]
+    if missing or actual != expected:
+        raise ValueError('incomplete vector space coverage')
+    if top_k <= 0:
+        return []
+    rows = conn.execute(f'SELECT block_id,distance FROM {table} WHERE embedding MATCH ? AND k=?'
+                        + ('' if policy is None else ' AND local_only=?'),
+                        (sqlite_vec.serialize_float32(batch.vectors[0]), top_k, *params)).fetchall()
+    return [VectorHit(id=row[0], score=max(0.0, min(1.0, 1 - row[1] ** 2 / 2))) for row in rows]

backend/app/routes.py

@@ -11,6 +11,7 @@ from fastapi.responses import StreamingResponse
 from app.agent import AgentCapacityError, AgentRunNotFoundError
 from app.container import container
 from app.config import get_settings
+from app.operation_logs import log_event
 from app.extensions.archive import MAX_ZIP_BYTES, install_zip
 from app.services.persona_settings import PersonaSettings, load_persona, save_persona
 from app.contracts import (
@@ -225,7 +226,7 @@ async def open_workspace(request: WorkspaceOpenRequest) -> WorkspaceSnapshot:
 
 @router.get("/workspace/tree", response_model=list[WorkspaceEntry], tags=["Workspace"])
 async def get_workspace_tree() -> list[WorkspaceEntry]:
-    return workspace_service.get_workspace_tree()
+    return await workspace_service.refresh_workspace_tree()
 
 
 @router.post("/workspace/folders", response_model=WorkspaceEntry, tags=["Workspace"])
@@ -286,7 +287,8 @@ async def get_note(note_id: str) -> Note:
 @router.patch("/notes/{note_id}", response_model=Note, tags=["Notes"])
 async def update_note(note_id: str, request: NoteUpdateRequest) -> Note:
     return await note_service.update_note(
-        note_id, title=request.title, markdown=request.markdown, tags=request.tags, defer_vectors=True
+        note_id, title=request.title, markdown=request.markdown, tags=request.tags,
+        expected_content_hash=request.expected_content_hash, defer_vectors=True
     )
 
 
@@ -454,11 +456,15 @@ async def chat(request: ChatRequest) -> StreamingResponse:
                         usage = {"input_tokens": input_tokens, "output_tokens": output_tokens,
                                  "total_tokens": input_tokens + output_tokens}
                     elif event.event == ModelEventType.error:
+                        log_event('chat', 'model.error', level='ERROR', provider_id=request.provider_id,
+                                  model=request.model, error_code=event.data.get('code'))
                         if assistant_content:
                             assistant_content += "\n\n"
                         assistant_content += str(event.data.get("message", "Model generation failed."))
                     yield as_sse(event.event.value, event.model_dump_json())
         except Exception as exc:
+            log_event('chat', 'chat.failed', level='ERROR', error=exc,
+                      provider_id=request.provider_id, model=request.model)
             failure_message = exc.message if isinstance(exc, ApiError) else "知识库检索或模型生成失败，请检查服务状态。"
             if assistant_content:
                 assistant_content += "\n\n"
@@ -497,7 +503,7 @@ async def chat(request: ChatRequest) -> StreamingResponse:
 async def list_agent_runs(
     limit: int = Query(default=50, ge=1, le=100), offset: int = Query(default=0, ge=0)
 ) -> AgentRunListResponse:
-    items, total = container.agent.list_runs(limit=limit, offset=offset)
+    items, total = await asyncio.to_thread(container.agent.list_runs, limit=limit, offset=offset)
     return AgentRunListResponse(
         items=items,
         page=PageMeta(total=total, limit=limit, offset=offset),
@@ -602,7 +608,7 @@ async def get_agent_trace(
     limit: int = Query(default=200, ge=1, le=500),
 ) -> AgentTraceResponse:
     try:
-        return container.agent.get_trace(
+        return await asyncio.to_thread(container.agent.get_trace,
             run_id, after_sequence=after_sequence, limit=limit
         )
     except AgentRunNotFoundError as exc:
@@ -623,7 +629,7 @@ async def decide_agent_permission(
     run_id: str, request_id: str, request: PermissionDecisionRequest
 ) -> OperationResponse:
     agent_run_or_404(run_id)
-    if not container.agent.resolve_permission(run_id, request_id, request.decision):
+    if not await container.agent.resolve_permission(run_id, request_id, request.decision):
         raise ApiError(
             404,
             "PERMISSION_REQUEST_NOT_FOUND",
@@ -1222,7 +1228,7 @@ async def test_provider(request: ProviderTestRequest) -> ProviderTestResponse:
 async def list_tasks(
     limit: int = Query(default=50, ge=1, le=100), offset: int = Query(default=0, ge=0)
 ) -> TaskListResponse:
-    items, total = task_service.list_tasks(limit=limit, offset=offset)
+    items, total = await asyncio.to_thread(task_service.list_tasks, limit=limit, offset=offset)
     return TaskListResponse(
         items=items, page=PageMeta(total=total, limit=limit, offset=offset)
     )
@@ -1230,12 +1236,12 @@ async def list_tasks(
 
 @router.post("/tasks", response_model=Task, tags=["Tasks"])
 async def create_task(request: TaskCreateRequest) -> Task:
-    return task_service.create_task(**request.model_dump())
+    return await task_service.write_in_background(task_service.create_task, **request.model_dump())
 
 
 @router.get("/tasks/{task_id}", response_model=Task, tags=["Tasks"])
 async def get_task(task_id: str) -> Task:
-    task = task_service.get_task(task_id)
+    task = await asyncio.to_thread(task_service.get_task, task_id)
     if task is None:
         raise ApiError(
             404, "RESOURCE_NOT_FOUND", "task not found", {"task_id": task_id}
@@ -1245,7 +1251,7 @@ async def get_task(task_id: str) -> Task:
 
 @router.patch("/tasks/{task_id}", response_model=Task, tags=["Tasks"])
 async def update_task(task_id: str, request: TaskUpdateRequest) -> Task:
-    return task_service.update_task(task_id, request.model_dump(exclude_unset=True))
+    return await task_service.write_in_background(task_service.update_task, task_id, request.model_dump(exclude_unset=True))
 
 
 @router.delete(
@@ -1254,7 +1260,7 @@ async def update_task(task_id: str, request: TaskUpdateRequest) -> Task:
     tags=["Tasks"],
 )
 async def delete_task(task_id: str) -> OperationResponse:
-    if not task_service.delete_task(task_id):
+    if not await task_service.write_in_background(task_service.delete_task, task_id):
         raise ApiError(
             404, "RESOURCE_NOT_FOUND", "task not found", {"task_id": task_id}
         )

backend/app/services/coordination.py

@@ -1,7 +1,14 @@
 import asyncio
 from functools import wraps
+from weakref import WeakKeyDictionary
 
-_vault_mutation_lock = asyncio.Lock()
+_vault_locks = WeakKeyDictionary()
+
+
+def vault_mutation_lock():
+    # Service/test lifecycle restarts must not reuse a lock bound to a closed loop.
+    loop = asyncio.get_running_loop()
+    return _vault_locks.setdefault(loop, asyncio.Lock())
 
 
 def serialized_vault_mutation(operation):
@@ -9,7 +16,7 @@ def serialized_vault_mutation(operation):
 
     @wraps(operation)
     async def wrapped(*args, **kwargs):
-        async with _vault_mutation_lock:
+        async with vault_mutation_lock():
             return await operation(*args, **kwargs)
 
     return wrapped

backend/app/services/index_service.py

@@ -4,6 +4,7 @@ from __future__ import annotations
 
 import asyncio
 import logging
+from app.operation_logs import log_event
 
 from datetime import datetime, timezone
 from pathlib import Path
@@ -16,7 +17,7 @@ from app.errors import ApiError
 from app.knowledge.parser import parse_note
 from app.services.note_service import index_note, prepare_note_index
 from app.database.db import connect, transaction
-from app.services.coordination import _vault_mutation_lock
+from app.services.coordination import vault_mutation_lock
 from app.retrieval.vectorstore import SqliteVecStore
 from app.local_models.runtime import LocalEmbedding
 from app.services import note_service
@@ -25,6 +26,7 @@ vector_store = SqliteVecStore()
 
 _jobs: dict[str, IndexJob] = {}
 _active_job_id: str | None = None
+_active_scope: str | None = None
 _last_completed_at: datetime | None = None
 _last_error: str | None = None
 MAX_JOBS = 100
@@ -33,6 +35,7 @@ _logger = logging.getLogger(__name__)
 
 
 def _remember_job(job: IndexJob) -> None:
+    log_event('vectors', 'index.' + job.status, job_id=job.job_id, status=job.status)
     _jobs[job.job_id] = job
     while len(_jobs) > MAX_JOBS:
         oldest = next(iter(_jobs))
@@ -64,7 +67,7 @@ def _scan_vault() -> list[tuple[str, str, str, datetime, datetime]]:
 
 
 async def rebuild(request: IndexRebuildRequest) -> IndexJob:
-    global _active_job_id, _last_completed_at, _last_error
+    global _active_job_id, _active_scope, _last_completed_at, _last_error
     if _active_job_id is not None:
         raise ApiError(409, "INDEX_BUSY", "索引正在后台计算，请稍后重试。")
     job_id = "job_" + uuid4().hex[:12]
@@ -82,6 +85,7 @@ async def rebuild(request: IndexRebuildRequest) -> IndexJob:
     saved_paths = {record.file_path: record for record in saved_records.values() if record is not None}
 
     _active_job_id = job_id
+    _active_scope = 'all'
     _last_error = None
     _remember_job(IndexJob(
         job_id=job_id, status="running", scope=request.scope,
@@ -112,7 +116,7 @@ async def rebuild(request: IndexRebuildRequest) -> IndexJob:
             prepared_notes.append((parsed, prepared))
         # All network/model awaits precede the transaction. The concrete SQLite
         # methods below complete synchronously despite their async interfaces.
-        async with _vault_mutation_lock:
+        async with vault_mutation_lock():
             if _scan_vault() != docs or saved_records != {key: repository.get_note_record(key) for key in _pending_notes()}:
                 raise ApiError(409, "INDEX_SNAPSHOT_CHANGED", "笔记在计算期间发生变化，稍后重新计算。")
             conn = connect()
@@ -148,6 +152,7 @@ async def rebuild(request: IndexRebuildRequest) -> IndexJob:
             finally:
                 conn.close()
     except BaseException as exc:
+        log_event('vectors', 'index.failed', level='WARNING' if isinstance(exc, asyncio.CancelledError) else 'ERROR', error=exc, job_id=job_id)
         _remember_job(IndexJob(
             job_id=job_id, status="failed", scope=request.scope,
             created_at=datetime.now(timezone.utc),
@@ -156,6 +161,7 @@ async def rebuild(request: IndexRebuildRequest) -> IndexJob:
         raise
     finally:
         _active_job_id = None
+        _active_scope = None
 
     job = IndexJob(job_id=job_id, status="completed", scope=request.scope, created_at=datetime.now(timezone.utc))
     _remember_job(job)
@@ -166,16 +172,26 @@ async def rebuild(request: IndexRebuildRequest) -> IndexJob:
 
 
 def get_status() -> IndexStatus:
+    from app.retrieval import activity
     counts = repository.stats()
-    vector_refresh_required = repository.get_index_meta().get('workspace_vectors_pending') == '1' or bool(_pending_notes())
+    workspace_pending = repository.get_index_meta().get('workspace_vectors_pending') == '1'
+    notes_pending = len(_pending_notes())
+    vector_refresh_required = workspace_pending or bool(notes_pending)
+    running = int(_active_job_id is not None)
+    # An entire-vault rebuild is one job, not one job per block/note.
+    pending = 1 if running and _active_scope == 'all' else (1 + running if workspace_pending else max(notes_pending, running))
+    activity_fields = dict(running_jobs=running, active_searches=activity.active,
+                           completed_searches=activity.completed, failed_searches=activity.failed,
+                           cancelled_searches=activity.cancelled)
     if _active_job_id is not None:
-        return IndexStatus(status="running", pending_jobs=0, active_job_id=_active_job_id, vector_refresh_required=vector_refresh_required,
+        return IndexStatus(**activity_fields, status="running", pending_jobs=pending, active_job_id=_active_job_id, vector_refresh_required=vector_refresh_required,
                            total_notes=counts["notes"], total_blocks=counts["blocks"])
     return IndexStatus(
+        **activity_fields,
         vector_refresh_required=vector_refresh_required,
         total_notes=counts["notes"], total_blocks=counts["blocks"],
         status="failed" if _last_error else "idle",
-        pending_jobs=0,
+        pending_jobs=pending,
         last_completed_at=_last_completed_at,
         error_message=_last_error,
     )
@@ -227,7 +243,7 @@ def _pending_notes() -> list[str]:
 
 
 async def _refresh_saved_note(note_id: str) -> None:
-    global _active_job_id, _last_error, _last_completed_at
+    global _active_job_id, _active_scope, _last_error, _last_completed_at
     record = repository.get_note_record(note_id)
     key = f'note_vectors_pending:{note_id}'
     if record is None:
@@ -240,13 +256,14 @@ async def _refresh_saved_note(note_id: str) -> None:
     parsed.title = record.title
     job_id = 'job_' + uuid4().hex[:12]
     _active_job_id = job_id
+    _active_scope = 'note'
     _last_error = None
     _remember_job(IndexJob(job_id=job_id, status='running', scope='all', created_at=datetime.now(timezone.utc)))
     try:
         prepared = await prepare_note_index(parsed, strict=True)
         if isinstance(note_service.embedding, LocalEmbedding) and parsed.blocks and prepared[1] is None:
             raise ApiError(503, "EMBEDDING_UNAVAILABLE", "笔记已保存，后台向量计算未完成。")
-        async with _vault_mutation_lock:
+        async with vault_mutation_lock():
             current = repository.get_note_record(note_id)
             if current != record or note_service._read_markdown(record.file_path) != markdown:
                 # Another save or rename won the race; leave the durable queue entry intact.
@@ -254,6 +271,14 @@ async def _refresh_saved_note(note_id: str) -> None:
             conn = connect()
             try:
                 with transaction(conn):
+                    existing_ids = {row[0] for row in conn.execute('SELECT block_id FROM blocks WHERE note_id=?', (note_id,))}
+                    if existing_ids != {block.block_id for block in parsed.blocks}:
+                        # An external editor changed a newly registered note while inference ran.
+                        # Reconcile that note only; the snapshot check above protects newer saves.
+                        parsed.title = parse_note(markdown=markdown, file_path=record.file_path,
+                            folder=record.folder, tags=record.tags, created_at=record.created_at,
+                            updated_at=record.updated_at, note_id=note_id).title
+                        await index_note(parsed, prepared=prepared, conn=conn)
                     # Write only vectors: metadata and FTS already represent the saved revision.
                     vectors, remote = prepared
                     from app.retrieval.vectorstore import VectorRecord
@@ -261,14 +286,24 @@ async def _refresh_saved_note(note_id: str) -> None:
                     await vector_store.upsert([VectorRecord(id=b.block_id, vector=v)
                         for b, v in zip(parsed.blocks, vectors)], conn=conn)
                     routed_vectors.store_remote(conn, [b.block_id for b in parsed.blocks], remote)
+                    if isinstance(note_service.embedding, LocalEmbedding) and parsed.blocks:
+                        from app.retrieval.space_index import table_name
+                        if remote is None:
+                            raise ApiError(503, 'EMBEDDING_UNAVAILABLE', '笔记已保存，向量计算未完成。')
+                        table = table_name(remote.space_id, remote.dimensions)
+                        missing = conn.execute(f'SELECT 1 FROM blocks b LEFT JOIN {table} v ON v.block_id=b.block_id WHERE b.note_id=? AND v.block_id IS NULL LIMIT 1', (note_id,)).fetchone()
+                        if missing:
+                            raise ApiError(500, 'SEMANTIC_INDEX_WRITE_FAILED', '向量写入未完成，保留待处理标记。')
                     repository.set_index_meta({key: '0'}, conn=conn)
             finally:
                 conn.close()
         _last_completed_at = datetime.now(timezone.utc)
         _remember_job(IndexJob(job_id=job_id, status='completed', scope='all', created_at=_last_completed_at))
     except BaseException as exc:
+        log_event('vectors', 'index.failed', level='WARNING' if isinstance(exc, asyncio.CancelledError) else 'ERROR', error=exc, job_id=job_id)
         _last_error = str(exc) or '后台向量计算已中断，笔记已保存。'
         _remember_job(IndexJob(job_id=job_id, status='failed', scope='all', created_at=datetime.now(timezone.utc)))
         raise
     finally:
         _active_job_id = None
+        _active_scope = None

backend/app/services/model_diagnostics.py

@@ -19,6 +19,13 @@ def connection():
 
 
 def record(**values):
+    from app.operation_logs import log_event
+    log_event('models', 'model.' + str(values.get('operation', 'inference')),
+              level='ERROR' if values.get('status') == 'failed' else 'WARNING' if values.get('status') == 'fallback' else 'INFO',
+              model=values.get('model'), source=values.get('source'), status=values.get('status'),
+              device=values.get('actual_device') or values.get('attempted_device'),
+              error_code=values.get('error_code'), fallback=values.get('fallback_reason'),
+              duration_ms=round(values.get('elapsed_seconds', 0) * 1000, 2))
     safe = {key: value[:240] for key, value in values.items() if key in TEXT and isinstance(value, str)}
     safe.update({key: value for key, value in values.items()
                  if key in NUMBERS and type(value) in (float, int) and math.isfinite(value) and value >= 0})

backend/app/services/task_service.py

@@ -2,11 +2,37 @@ from __future__ import annotations
 
 from datetime import datetime, timezone
 from uuid import uuid4
+import asyncio
+from contextvars import copy_context
+from functools import partial
+from weakref import WeakKeyDictionary
 
 from app import repository
 from app.contracts import Task, TaskStatus
 from app.database.db import connect, transaction
 from app.errors import ApiError
+from app.operation_logs import log_event
+
+_write_locks = WeakKeyDictionary()
+
+
+async def write_in_background(operation, *args, **kwargs):
+    # SQLite has one writer. Queue cooperatively instead of letting many worker
+    # threads fight over the file lock and starve unrelated model work.
+    loop = asyncio.get_running_loop()
+    lock = _write_locks.setdefault(loop, asyncio.Lock())
+    async with lock:
+        work = loop.run_in_executor(None, copy_context().run, partial(operation, *args, **kwargs))
+        cancelled = False
+        while not work.done():
+            try:
+                await asyncio.shield(work)
+            except asyncio.CancelledError:
+                cancelled = True
+        result = work.result()
+        if cancelled:
+            raise asyncio.CancelledError
+        return result
 
 
 def _now() -> datetime:
@@ -49,6 +75,7 @@ def create_task(
                 ),
             )
         row = conn.execute("SELECT * FROM tasks WHERE task_id = ?", (task_id,)).fetchone()
+        log_event('tasks', 'task.created', task_id=task_id, note_id=note_id, status='todo')
         return _task_from_row(row)
     finally:
         conn.close()
@@ -111,6 +138,7 @@ def update_task(task_id: str, values: dict[str, object]) -> Task:
                 params,
             )
         row = conn.execute("SELECT * FROM tasks WHERE task_id = ?", (task_id,)).fetchone()
+        log_event('tasks', 'task.updated', task_id=task_id, status=row['status'], changed_fields=','.join(values))
         return _task_from_row(row)
     finally:
         conn.close()
@@ -121,6 +149,7 @@ def delete_task(task_id: str) -> bool:
     try:
         with transaction(conn):
             cursor = conn.execute("DELETE FROM tasks WHERE task_id = ?", (task_id,))
+        log_event('tasks', 'task.deleted' if cursor.rowcount else 'task.not_found', task_id=task_id)
         return cursor.rowcount > 0
     finally:
         conn.close()

backend/app/services/usage_service.py

@@ -98,6 +98,11 @@ class UsageAttempt:
                     reasoning_tokens=first("output_tokens_details.reasoning_tokens", "completion_tokens_details.reasoning_tokens"))
 
     def persist(self):
+        from app.operation_logs import log_event
+        log_event('providers', 'model.request_finished', level='INFO' if self.completed else 'WARNING',
+                  provider_id=self.provider_id, model=self.model, run_id=self.run_id,
+                  request_id=self.request_id, source=self.source,
+                  status='completed' if self.completed else 'incomplete')
         try:
             with closing(connection()) as conn:
                 conn.execute("INSERT OR REPLACE INTO model_usage VALUES (?,?,?,?,?,?,?,?,?,?,?)", (

backend/app/services/workspace_service.py

@@ -105,6 +105,14 @@ def get_workspace_tree() -> list[WorkspaceEntry]:
     return _tree(get_settings().vault_path.resolve(), locations)
 
 
+async def refresh_workspace_tree() -> list[WorkspaceEntry]:
+    """Observe external creates/deletes without waiting for vector inference."""
+    if get_workspace_info().requires_refresh:
+        await _register_workspace_files()
+        index_service.schedule_workspace_rebuild()
+    return get_workspace_tree()
+
+
 async def open_workspace(requested_path: str | None) -> WorkspaceSnapshot:
     """打开只登记文件与全文索引，不让 Embedding 或厂商网络阻塞工作区。"""
 
@@ -153,7 +161,7 @@ async def _register_workspace_files() -> None:
                     created_at=parsed.created_at, updated_at=parsed.updated_at, blocks=parsed.blocks)
                 conn.execute('UPDATE blocks SET embedding_local_only=? WHERE note_id=?', (int(parsed.embedding_local_only), parsed.note_id))
             if prepared:
-                repository.set_index_meta({'workspace_vectors_pending': '1'}, conn=conn)
+                repository.set_index_meta({f'note_vectors_pending:{parsed.note_id}': '1' for parsed in prepared}, conn=conn)
     finally:
         conn.close()
 

backend/data/vault/产品/RAG 检索增强与引用定位.md

@@ -16,3 +16,5 @@ tags: RAG, 产品
 
 粗排后使用 Reranker 对候选块重新打分，提升相关性。
 
+<br />
+

backend/data/vault/功能演示/00 演示导航.md

@@ -2,20 +2,20 @@
 title: 功能演示导航
 tags: 演示, 入门
 ---
-
 # 功能演示导航
 
 这组笔记用于在真实工作区查看 Markdown、代码高亮、图表和检索效果。文中的项目、日期和数据均为演示内容。
 
 ## 建议阅读顺序
 
-| 笔记 | 可以查看的功能 |
-| --- | --- |
-| 01 Markdown 与大纲 | 元数据、标题层级、列表、引用、表格与行内代码 |
-| 02 多语言代码与公式 | Shiki 语言配色、代码块标签、数学公式 |
-| 03 Mermaid 图表集 | 六种常用图型、主题颜色和大图查看 |
-| 04 星灯项目资料 | 全文搜索、知识库问答与引用定位 |
-| 05 Skill 与 Plugin 操作样例 | 扩展安装、选区命令和只读笔记检查 |
+| 笔记                            | 可以查看的功能                |
+| ----------------------------- | ---------------------- |
+| 01 Markdown 与大纲               | 元数据、标题层级、列表、引用、表格与行内代码 |
+| 02 多语言代码与公式                   | Shiki 语言配色、代码块标签、数学公式  |
+| 03 Mermaid 图表集                | 六种常用图型、主题颜色和大图查看       |
+| 04 星灯项目资料                     | 全文搜索、知识库问答与引用定位        |
+| 05 Skill 与 Plugin 操作样例        | 扩展安装、选区命令和只读笔记检查       |
+| [06 警告框与提示框](06%20警告框与提示框.md) | 类型与别名、标题、折叠、嵌套和主题配色    |
 
 ## 工作区操作
 
@@ -35,3 +35,4 @@ tags: 演示, 入门
 - [ ] 在已配置模型后进行一次带知识库检索的问答。
 
 > 上述清单供体验时自行勾选，不是自动验收结果。模型调用可能产生费用，图表与代码示例本身不会执行代码。
+

backend/data/vault/功能演示/04 星灯项目资料.md

@@ -2,7 +2,6 @@
 title: 星灯资料站项目简报
 tags: 演示, 星灯项目, 检索
 ---
-
 # 星灯资料站
 
 星灯资料站是本组演示中的虚构项目，目标是为一个读书小组建立离线可用的学习资料目录。项目代号为 ST-27。
@@ -38,3 +37,4 @@ tags: 演示, 星灯项目, 检索
 最后一个问题在本笔记中没有答案。检查回答是否说明资料不足，而不是编造负责人。其他问题可以对照正文并点击引用定位核实。
 
 > 新建笔记需要完成索引后才能参与检索。没有模型配置时，也可以先在搜索页使用项目名、代号或独特检索词查找原文。
+

backend/data/vault/功能演示/06 警告框与提示框.md

@@ -0,0 +1,150 @@
+---
+title: 警告框与提示框演示
+tags: 演示, Markdown, 警告框, 主题
+---
+
+# 警告框与提示框
+
+本页展示 GitHub 警告框和 Obsidian 提示框的类型、标题、折叠、嵌套及正文格式。打开工作区写作模式查看效果；切换源码模式查看原始语法。
+
+## 五种常用警告框
+
+> [!NOTE]
+> 记录补充信息：这份笔记中的内容都是功能演示，不会执行代码或调用模型。
+
+> [!TIP] 小技巧：快速插入
+> 点击编辑器顶部的“提示框”选择器，选择类型后替换模板内容。
+
+> [!IMPORTANT] 保存与显示状态
+> 点击标题展开或收起，只改变本次显示状态。要修改默认状态，请在源码中的类型标记后添加 `+` 或 `-`。
+
+> [!WARNING] 修改前保留原文
+> 在演示笔记中练习时，可以先复制一段内容；需要恢复时使用撤销。
+
+> [!CAUTION] 需要重点关注的说明
+> `CAUTION` 与 `WARNING` 使用同一警告配色。提示框是笔记内容，不是应用报错弹窗。
+
+## 更多类型
+
+> [!ABSTRACT] 本页摘要
+> 类型区分语义，标题说明重点，正文保留详细信息。
+
+> [!INFO] 环境信息
+> 警告框的边框、标题和背景随主题变化。
+
+> [!TODO] 待办
+> - [ ] 展开下方折叠示例。
+> - [ ] 切换深色主题。
+> - [ ] 保存后重新打开本页。
+
+> [!SUCCESS] 已完成
+> 本段展示成功状态，不代表自动测试或实际任务已经完成。
+
+> [!QUESTION] 可以嵌套吗？
+> 可以。增加一级引用符号即可在提示框中嵌入另一个提示框。
+
+> [!FAILURE] 未达到预期
+> 示例：资料中缺少日期，需要补充后再归档。
+
+> [!DANGER] 风险提示
+> 示例：不要把唯一一份原始资料直接覆盖为整理结果。
+
+> [!BUG] 问题记录
+> 示例：发现显示异常时，记录主题、操作步骤和对应 Markdown 源码。
+
+> [!EXAMPLE] 示例
+> 将提示内容写成一句明确的说明，比只写“注意”更容易理解。
+
+> [!QUOTE] 摘录
+> 一条笔记既要保留结论，也要保留形成结论的依据。
+
+## 默认展开与默认折叠
+
+> [!TIP]+ 默认展开：点击标题试试
+> 类型后的 `+` 表示默认展开。点击标题可收起，再次点击可展开。
+
+> [!WARNING]- 默认折叠：点击查看内容
+> 你已经展开了这段说明。类型后的 `-` 表示重新渲染时默认收起。
+>
+> 正文可以包含 **加粗**、*斜体*、~~删除线~~ 和 `行内代码`。
+
+## 嵌套与混合格式
+
+> [!INFO]+ 一次资料整理
+> 先整理来源，再检查缺漏。
+>
+> 1. 收集原始资料。
+> 2. 按主题分组。
+> 3. 为尚未确认的内容添加说明。
+>
+> > [!SUCCESS] 已收集
+> > 原始笔记、会议纪要和参考链接已放入同一文件夹。
+>
+> > [!WARNING]- 尚待确认
+> > 一条资料缺少发布日期，需要补充来源。
+>
+> | 项目 | 状态 |
+> | --- | --- |
+> | 原始资料 | 已归档 |
+> | 日期核对 | 待补充 |
+>
+> ```python
+> notes = ["原始资料", "整理结果"]
+> print(len(notes))
+> ```
+>
+> 行内公式：$a^2 + b^2 = c^2$。
+
+## 类型别名
+
+别名不区分大小写。下面的表格列出兼容关系。
+
+| 类型 | 别名 |
+| --- | --- |
+| abstract | summary、tldr |
+| tip | hint |
+| success | check、done |
+| question | help、faq |
+| warning | caution、attention |
+| failure | fail、missing |
+| danger | error |
+| quote | cite |
+
+> [!summary] 摘要别名
+> 这段使用 `summary`，外观与 `abstract` 一致。
+
+> [!check] 成功别名
+> 这段使用 `check`，外观与 `success` 一致。
+
+> [!custom-demo] 未知类型的回退
+> 自定义类型暂时使用 note 外观，源文件中的类型名仍然保留。
+
+## 语法对照
+
+以下围栏中的内容应当保持为代码，不渲染成警告框。
+
+```markdown
+> [!NOTE] 自定义标题
+> 正文内容。
+
+> [!WARNING]- 默认折叠
+> 点击标题查看正文。
+
+> [!TIP]+ 默认展开
+> 默认可见的正文。
+```
+
+普通行内代码也保持原样：`[!WARNING]`。
+
+> 这是一段普通引用，没有提示类型标记，因此不应显示为警告框。
+
+## 主题与保存体验清单
+
+- [ ] 在浅色、深色、护眼主题下区分信息、成功、警告与危险颜色。
+- [ ] 使用纸间时光，查看纸张虚线边框和嵌套层次。
+- [ ] 使用 Ocean Blue 与 Midnight Purple，检查标题和正文是否清晰。
+- [ ] 点击折叠标题，并使用 Tab、Enter 或空格体验键盘操作。
+- [ ] 在源码模式修改一个类型或标题，再切回写作模式。
+- [ ] 保存并重新打开，确认类型、标题、正文与默认折叠状态保持一致。
+
+这是一份手动体验清单，未勾选不表示功能失败。桌面容器的原生格式快捷键与元数据转换仍属于第三阶段规划。

backend/data/vault/渲染压测/01 渲染压测-2.56万字.md

@@ -0,0 +1,958 @@
+# 长文渲染压力测试
+
+## 第 1 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 1
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 2 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 2
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 3 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 3
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 4 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 4
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 5 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 5
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 6 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 6
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 7 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 7
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 8 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 8
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+> [!TIP] 验收提示
+> 内容需要保留，折叠后仍可展开。
+
+| 项目 | 状态 |
+| --- | --- |
+| 渲染 | 待验证 |
+
+```javascript
+const note = { title: "长文测试", ready: true };
+console.log(note);
+```
+
+## 第 9 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 9
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 10 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 10
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 11 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 11
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 12 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 12
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 13 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 13
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 14 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 14
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 15 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 15
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 16 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 16
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+> [!TIP] 验收提示
+> 内容需要保留，折叠后仍可展开。
+
+| 项目 | 状态 |
+| --- | --- |
+| 渲染 | 待验证 |
+
+```javascript
+const note = { title: "长文测试", ready: true };
+console.log(note);
+```
+
+## 第 17 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 17
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 18 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 18
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 19 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 19
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 20 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 20
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 21 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 21
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 22 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 22
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 23 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 23
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 24 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 24
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+> [!TIP] 验收提示
+> 内容需要保留，折叠后仍可展开。
+
+| 项目 | 状态 |
+| --- | --- |
+| 渲染 | 待验证 |
+
+```javascript
+const note = { title: "长文测试", ready: true };
+console.log(note);
+```
+
+## 第 25 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 25
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 26 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 26
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 27 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 27
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 28 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 28
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 29 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 29
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 30 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 30
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 31 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 31
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 32 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 32
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+> [!TIP] 验收提示
+> 内容需要保留，折叠后仍可展开。
+
+| 项目 | 状态 |
+| --- | --- |
+| 渲染 | 待验证 |
+
+```javascript
+const note = { title: "长文测试", ready: true };
+console.log(note);
+```
+
+## 第 33 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 33
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 34 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 34
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 35 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 35
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 36 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 36
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 37 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 37
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 38 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 38
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 39 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 39
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 40 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 40
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+> [!TIP] 验收提示
+> 内容需要保留，折叠后仍可展开。
+
+| 项目 | 状态 |
+| --- | --- |
+| 渲染 | 待验证 |
+
+```javascript
+const note = { title: "长文测试", ready: true };
+console.log(note);
+```
+
+## 第 41 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 41
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 42 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 42
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 43 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 43
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 44 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 44
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 45 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 45
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 46 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 46
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 47 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 47
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 48 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 48
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+> [!TIP] 验收提示
+> 内容需要保留，折叠后仍可展开。
+
+| 项目 | 状态 |
+| --- | --- |
+| 渲染 | 待验证 |
+
+```javascript
+const note = { title: "长文测试", ready: true };
+console.log(note);
+```
+
+## 第 49 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 49
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 50 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 50
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 51 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 51
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 52 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 52
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 53 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 53
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 54 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 54
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 55 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 55
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 56 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 56
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+> [!TIP] 验收提示
+> 内容需要保留，折叠后仍可展开。
+
+| 项目 | 状态 |
+| --- | --- |
+| 渲染 | 待验证 |
+
+```javascript
+const note = { title: "长文测试", ready: true };
+console.log(note);
+```
+
+## 第 57 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 57
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 58 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 58
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 59 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 59
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 60 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 60
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 61 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 61
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 62 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 62
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 63 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 63
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 64 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 64
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+> [!TIP] 验收提示
+> 内容需要保留，折叠后仍可展开。
+
+| 项目 | 状态 |
+| --- | --- |
+| 渲染 | 待验证 |
+
+```javascript
+const note = { title: "长文测试", ready: true };
+console.log(note);
+```
+
+## 第 65 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 65
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 66 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 66
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 67 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 67
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 68 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 68
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 69 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 69
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 70 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 70
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 71 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 71
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 72 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 72
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+> [!TIP] 验收提示
+> 内容需要保留，折叠后仍可展开。
+
+| 项目 | 状态 |
+| --- | --- |
+| 渲染 | 待验证 |
+
+```javascript
+const note = { title: "长文测试", ready: true };
+console.log(note);
+```
+
+## 第 73 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 73
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 74 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 74
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 75 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 75
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 76 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 76
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 77 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 77
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 78 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 78
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 79 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 79
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 80 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 80
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+> [!TIP] 验收提示
+> 内容需要保留，折叠后仍可展开。
+
+| 项目 | 状态 |
+| --- | --- |
+| 渲染 | 待验证 |
+
+```javascript
+const note = { title: "长文测试", ready: true };
+console.log(note);
+```
+
+## 第 81 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 81
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 82 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 82
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 83 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 83
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 84 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 84
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 85 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 85
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 86 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 86
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 87 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 87
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 88 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 88
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+> [!TIP] 验收提示
+> 内容需要保留，折叠后仍可展开。
+
+| 项目 | 状态 |
+| --- | --- |
+| 渲染 | 待验证 |
+
+```javascript
+const note = { title: "长文测试", ready: true };
+console.log(note);
+```
+
+## 第 89 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 89
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 90 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 90
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 91 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 91
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 92 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 92
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 93 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 93
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 94 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 94
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 95 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 95
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 96 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 96
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+> [!TIP] 验收提示
+> 内容需要保留，折叠后仍可展开。
+
+| 项目 | 状态 |
+| --- | --- |
+| 渲染 | 待验证 |
+
+```javascript
+const note = { title: "长文测试", ready: true };
+console.log(note);
+```
+
+## 第 97 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 97
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 98 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 98
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 99 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 99
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 100 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 100
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+## 第 101 节：知识整理
+
+本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。本地知识库保存课程记录与项目思考，编辑时需要稳定响应。长篇文档包含章节结构和引用信息，阅读过程中可以随时折叠展开。这里使用生成的测试内容验证渲染性能，不读取真实笔记。
+
+### 小结 101
+
+重点包含 **强调文字**、`inlineCode` 和 [链接](https://example.com)。
+
+
+## 文末校验
+
+结束标记：长文内容完整。

backend/scripts/agent-task-stress.py

@@ -0,0 +1,250 @@
+"""Offline Agent/runtime and task API load test; all state lives in a temporary directory."""
+from __future__ import annotations
+
+import argparse
+import asyncio
+import json
+import inspect
+import math
+import os
+import pathlib
+import platform
+import sys
+import tempfile
+import time
+
+sys.path.insert(0, str(pathlib.Path(__file__).resolve().parents[1]))
+
+
+def stats(values):
+    values = sorted(values)
+    return {"count": len(values), "median_ms": round(values[len(values)//2], 2),
+            "p95_ms": round(values[min(len(values)-1, math.ceil(len(values)*.95)-1)], 2),
+            "max_ms": round(values[-1], 2)} if values else {"count": 0}
+
+
+async def main(output):
+    # Set before importing any app modules: container has import-time initialization.
+    with tempfile.TemporaryDirectory(prefix="notes-agent-task-stress-") as directory:
+        root = pathlib.Path(directory)
+        os.environ.update(APP_DATA_DIR=str(root / 'data'), APP_DB_PATH=str(root / 'app.db'),
+                          APP_VAULT_PATH=str(root / 'vault'))
+        from app.container import container
+        from app.contracts import AgentRunCreateRequest, AgentRunStatus
+        from app.agent.runtime import AgentRuntime, AgentCapacityError
+        from app.agent.permissions import PermissionMode
+        from app.main import app
+        import httpx
+
+        report = {"python": platform.python_version(), "platform": platform.platform(),
+                  "provider": "mock with 50 ms injected delay per model turn; no network", "results": []}
+
+        def save(name, value):
+            report['results'].append({"scenario": name, **value})
+            output.write_text(json.dumps(report, ensure_ascii=False, indent=2), encoding='utf-8')
+            print(json.dumps(report['results'][-1], ensure_ascii=False), flush=True)
+
+        async def measured(operation):
+            delays = []
+            async def heartbeat():
+                while True:
+                    start = time.perf_counter()
+                    await asyncio.sleep(.01)
+                    delays.append(max(0, (time.perf_counter()-start)*1000-10))
+            pulse = asyncio.create_task(heartbeat())
+            await asyncio.sleep(0)
+            start = time.perf_counter()
+            try:
+                result = await operation()
+                await asyncio.sleep(.02)
+                return {**result, "elapsed_ms": round((time.perf_counter()-start)*1000, 2),
+                        "event_loop_lag": stats(delays)}
+            finally:
+                pulse.cancel()
+                await asyncio.gather(pulse, return_exceptions=True)
+
+        adapter = container.providers.get('mock').adapter
+        original = adapter.complete
+        async def delayed(request):
+            await asyncio.sleep(.05)
+            return await original(request)
+        adapter.complete = delayed
+        runtime = container.agent
+
+        for concurrency in (1, 10, 50, 200):
+            async def batch():
+                durations, sequences, statuses = [], [], []
+                semaphore = asyncio.Semaphore(concurrency)
+                async def one(index):
+                    async with semaphore:
+                        start = time.perf_counter()
+                        created = await runtime.create_run(AgentRunCreateRequest(
+                            input=f'/tool system.echo {{"text":"pressure-{index}"}}',
+                            provider_id='mock', model='mock-1', allowed_tools=['system.echo']))
+                        events = [event async for event in runtime.events(created.run_id)]
+                        done = await runtime.wait(created.run_id)
+                        durations.append((time.perf_counter()-start)*1000)
+                        statuses.append(done.status.value)
+                        sequence = [event.sequence for event in events]
+                        sequences.append(sequence == list(range(len(sequence))))
+                        assert done.status == AgentRunStatus.completed
+                        assert done.tool_results[0].output == {"text": f"pressure-{index}"}
+                        replay = [event.sequence async for event in runtime.events(created.run_id, after_sequence=2)]
+                        assert replay == sequence[3:]
+                        return created.run_id
+                ids = await asyncio.gather(*(one(i) for i in range(max(20, concurrency))))
+                assert all(sequences)
+                recovered = AgentRuntime(container.providers, container.tools, container.permissions,
+                                         trace_repository=runtime.trace_repository)
+                assert all(recovered.get_run(run_id).status == AgentRunStatus.completed for run_id in ids)
+                assert not any(record.subscribers for record in runtime._records.values())
+                return {"concurrency": concurrency, "runs": len(ids), "latency": stats(durations),
+                        "completed": statuses.count('completed'), "ordered_events_and_replay": True,
+                        "terminal_recovery": True, "retained_records": len(runtime._records)}
+            save('agent_tool_runs', await measured(batch))
+
+        # Hold model calls so all 200 records remain active while testing admission.
+        gate = asyncio.Event()
+        async def blocked(request):
+            await gate.wait()
+            return await original(request)
+        adapter.complete = blocked
+        async def capacity():
+            ids = [(await runtime.create_run(AgentRunCreateRequest(input='capacity', provider_id='mock', model='mock-1'))).run_id for _ in range(200)]
+            rejected = False
+            try:
+                await runtime.create_run(AgentRunCreateRequest(input='overflow', provider_id='mock', model='mock-1'))
+            except AgentCapacityError:
+                rejected = True
+            await asyncio.sleep(0)
+            latencies = []
+            for run_id in ids:
+                start = time.perf_counter()
+                await runtime.cancel(run_id)
+                latencies.append((time.perf_counter()-start)*1000)
+            states = await asyncio.gather(*(runtime.wait(run_id) for run_id in ids))
+            assert rejected and all(run.status == AgentRunStatus.cancelled for run in states)
+            assert all(not record.task or record.task.done() for record in runtime._records.values())
+            return {"active_limit": 200, "overflow_rejected": rejected, "cancelled": len(states), "cancel_latency": stats(latencies)}
+        save('capacity_and_cancel', await measured(capacity))
+        adapter.complete = delayed
+
+        async def permissions():
+            tool = container.tools.get('system.echo')
+            previous = tool.definition.permission
+            tool.definition.permission = 'stress.confirm'
+            container.permissions.policy.set_rule('stress.confirm', PermissionMode.confirm)
+            async def one(index):
+                created = await runtime.create_run(AgentRunCreateRequest(input='/tool system.echo {"text":"permission"}',
+                    provider_id='mock', model='mock-1', allowed_tools=['system.echo'], tool_timeout_seconds=30))
+                stream = runtime.events(created.run_id)
+                try:
+                    async for event in stream:
+                        if event.event.value == 'PermissionRequired':
+                            if index % 2: await runtime.cancel(created.run_id)
+                            else: assert await runtime.resolve_permission(created.run_id, str(event.data['request_id']), 'allow')
+                            break
+                finally:
+                    await stream.aclose()
+                return (await runtime.wait(created.run_id)).status.value
+            try:
+                states = await asyncio.wait_for(asyncio.gather(*(one(i) for i in range(20))), 60)
+                assert states.count('completed') == states.count('cancelled') == 10
+                assert not any(record.subscribers for record in runtime._records.values())
+                return {"runs": 20, "approved_completed": 10, "cancelled_waiting_permission": 10, "subscribers_released": True}
+            finally:
+                tool.definition.permission = previous
+        save('permission_wait', await measured(permissions))
+
+        async def failures():
+            active = 0
+            async def injected(request):
+                text = request.messages[-1].content
+                if text == 'inject-provider-error': raise RuntimeError('injected offline provider failure')
+                if text == 'inject-model-timeout': await asyncio.sleep(60)
+                return await delayed(request)
+            tool = container.tools.get('system.echo')
+            executor = tool.executor
+            async def slow_tool(arguments, context):
+                nonlocal active
+                active += 1
+                try:
+                    if arguments.text == 'slow': await asyncio.sleep(60)
+                    value = executor(arguments, context)
+                    return await value if inspect.isawaitable(value) else value
+                finally: active -= 1
+            adapter.complete = injected
+            tool.executor = slow_tool
+            async def one(index):
+                mode = index % 4
+                text = ['normal', 'inject-provider-error', 'inject-model-timeout', '/tool system.echo {"text":"slow"}'][mode]
+                created = await runtime.create_run(AgentRunCreateRequest(input=text, provider_id='mock', model='mock-1',
+                    allowed_tools=['system.echo'], run_timeout_seconds=1 if mode == 2 else 30, tool_timeout_seconds=1))
+                result = await runtime.wait(created.run_id)
+                if mode == 0: assert result.status == AgentRunStatus.completed
+                elif mode == 1: assert result.status == AgentRunStatus.failed and result.error_code == 'AGENT_FAILED'
+                elif mode == 2: assert result.status == AgentRunStatus.failed and result.error_code == 'AGENT_TIMEOUT'
+                else: assert result.tool_results[0].error_code == 'TOOL_TIMEOUT'
+            try:
+                await asyncio.wait_for(asyncio.gather(*(one(i) for i in range(20))), 45)
+                assert active == 0
+                return {"runs": 20, "success": 5, "provider_errors": 5, "model_timeouts": 5,
+                        "tool_timeouts": 5, "remaining_tool_executors": active}
+            finally:
+                adapter.complete = delayed
+                tool.executor = executor
+        save('failure_and_timeout_isolation', await measured(failures))
+
+        async with httpx.AsyncClient(transport=httpx.ASGITransport(app=app), base_url='http://stress.local') as client:
+            for count in (100, 1000):
+                async def tasks():
+                    timings = {name: [] for name in ('create', 'update', 'list', 'delete')}
+                    async def call(method, path, **kwargs):
+                        start = time.perf_counter()
+                        response = await client.request(method, path, **kwargs)
+                        response.raise_for_status()
+                        return response.json(), (time.perf_counter()-start)*1000
+                    semaphore = asyncio.Semaphore(20)
+                    async def create(index):
+                        async with semaphore:
+                            body, duration = await call('POST', '/api/tasks', json={'title': f'压测任务 {index}', 'description': '独立测试数据'})
+                            timings['create'].append(duration)
+                            return body['task_id']
+                    ids = await asyncio.gather(*(create(i) for i in range(count)))
+                    first, _ = await call('GET', '/api/tasks')
+                    seen = []
+                    for offset in range(0, count, 100):
+                        body, duration = await call('GET', f'/api/tasks?limit=100&offset={offset}')
+                        timings['list'].append(duration)
+                        seen.extend(item['task_id'] for item in body['items'])
+                    assert len(set(seen)) == count and set(seen) == set(ids)
+                    async def change(run_id):
+                        async with semaphore:
+                            body, duration = await call('PATCH', f'/api/tasks/{run_id}', json={'status': 'done'})
+                            assert body['status'] == 'done'
+                            timings['update'].append(duration)
+                            _, duration = await call('DELETE', f'/api/tasks/{run_id}')
+                            timings['delete'].append(duration)
+                    await asyncio.gather(*(change(run_id) for run_id in ids))
+                    final, _ = await call('GET', '/api/tasks')
+                    assert final['page']['total'] == 0
+                    return {"tasks": count, "client_concurrency": 20, "latencies": {key: stats(value) for key, value in timings.items()},
+                            "default_page_count": len(first['items']), "default_total": first['page']['total'],
+                            "pagination_complete": True, "final_total": 0}
+                save('task_api_crud', await measured(tasks))
+
+        report['database_bytes'] = (root / 'app.db').stat().st_size
+        report['complete'] = True
+        output.write_text(json.dumps(report, ensure_ascii=False, indent=2), encoding='utf-8')
+        container.plugins.shutdown()
+        container.mcp_servers.shutdown()
+        from app.operation_logs import shutdown_logging
+        await asyncio.to_thread(shutdown_logging)
+
+
+if __name__ == '__main__':
+    parser = argparse.ArgumentParser()
+    parser.add_argument('--output', type=pathlib.Path, required=True)
+    args = parser.parse_args()
+    args.output.parent.mkdir(parents=True, exist_ok=True)
+    asyncio.run(main(args.output))

backend/scripts/task-http-stress.py

@@ -0,0 +1,96 @@
+"""Real loopback HTTP task load with a separate, temporary Uvicorn process."""
+import argparse
+import asyncio
+import json
+import math
+import os
+from pathlib import Path
+import socket
+import subprocess
+import sys
+import tempfile
+from time import perf_counter
+
+import httpx
+
+
+def stats(values):
+    values = sorted(values)
+    return {'count': len(values), 'p95_ms': round(values[math.ceil(len(values)*.95)-1], 2),
+            'max_ms': round(values[-1], 2)} if values else {'count': 0}
+
+
+async def main(args):
+    with tempfile.TemporaryDirectory(prefix='notes-task-http-') as directory:
+        root = Path(directory)
+        env = {**os.environ, 'APP_DATA_DIR': str(root/'data'), 'APP_DB_PATH': str(root/'app.db'), 'APP_VAULT_PATH': str(root/'vault')}
+        with socket.socket() as sock:
+            sock.bind(('127.0.0.1', 0)); port = sock.getsockname()[1]
+        process = subprocess.Popen([sys.executable, '-m', 'uvicorn', 'app.main:app', '--host', '127.0.0.1', '--port', str(port), '--log-level', 'error'],
+            cwd=Path(__file__).resolve().parents[1], env=env, stdout=subprocess.DEVNULL, stderr=subprocess.DEVNULL,
+            creationflags=subprocess.CREATE_NO_WINDOW if os.name == 'nt' else 0)
+        try:
+            async with httpx.AsyncClient(base_url=f'http://127.0.0.1:{port}', timeout=30) as client:
+                for _ in range(150):
+                    if process.poll() is not None: raise RuntimeError('Isolated Uvicorn exited')
+                    try:
+                        (await client.get('/health')).raise_for_status(); break
+                    except httpx.HTTPError: await asyncio.sleep(.1)
+                else: raise TimeoutError('Isolated Uvicorn startup')
+                sem = asyncio.Semaphore(args.concurrency)
+                timings = {key: [] for key in ('create', 'update', 'list', 'delete', 'health')}
+                errors = []
+                async def request(method, path, kind, **kwargs):
+                    start = perf_counter()
+                    response = await client.request(method, path, **kwargs)
+                    timings[kind].append((perf_counter()-start)*1000)
+                    response.raise_for_status()
+                    return response.json()
+                async def health():
+                    while True:
+                        try: await request('GET', '/health', 'health')
+                        except httpx.HTTPError as error: errors.append(type(error).__name__)
+                        await asyncio.sleep(.05)
+                heartbeat = asyncio.create_task(health())
+                start = perf_counter()
+                try:
+                    async def create(index):
+                        async with sem:
+                            return (await request('POST', '/api/tasks', 'create', json={'title': f'HTTP 压测 {index}'}))['task_id']
+                    ids = await asyncio.gather(*(create(i) for i in range(args.count)))
+                    seen = []
+                    for offset in range(0, args.count, 100):
+                        page = await request('GET', f'/api/tasks?limit=100&offset={offset}', 'list')
+                        seen.extend(item['task_id'] for item in page['items'])
+                    assert set(seen) == set(ids) and len(seen) == args.count
+                    async def change(task_id):
+                        async with sem:
+                            updated = await request('PATCH', f'/api/tasks/{task_id}', 'update', json={'status': 'done'})
+                            assert updated['status'] == 'done'
+                            await request('DELETE', f'/api/tasks/{task_id}', 'delete')
+                    await asyncio.gather(*(change(task_id) for task_id in ids))
+                    remaining = await request('GET', '/api/tasks', 'list')
+                    assert remaining['page']['total'] == 0
+                finally:
+                    heartbeat.cancel(); await asyncio.gather(heartbeat, return_exceptions=True)
+                report = {'transport': 'real loopback HTTP, separate Uvicorn process', 'tasks': args.count,
+                    'concurrency': args.concurrency, 'elapsed_ms': round((perf_counter()-start)*1000, 2),
+                    'latencies': {key: stats(value) for key,value in timings.items()}, 'health_errors': errors,
+                    'pagination_complete': True, 'final_total': 0}
+                args.output.parent.mkdir(parents=True, exist_ok=True)
+                args.output.write_text(json.dumps(report, ensure_ascii=False, indent=2), encoding='utf-8')
+                print(json.dumps(report, ensure_ascii=False))
+        finally:
+            process.terminate()
+            try: process.wait(timeout=10)
+            except subprocess.TimeoutExpired: process.kill(); process.wait()
+
+
+if __name__ == '__main__':
+    parser = argparse.ArgumentParser()
+    parser.add_argument('--output', type=Path, required=True)
+    parser.add_argument('--count', type=int, default=1000)
+    parser.add_argument('--concurrency', type=int, default=20)
+    args = parser.parse_args()
+    if args.count < 1 or args.concurrency < 1: parser.error('count and concurrency must be positive')
+    asyncio.run(main(args))

backend/scripts/vector-index-benchmark.py

@@ -0,0 +1,64 @@
+"""Synthetic, isolated exact-search comparison; does not access the user Vault."""
+import heapq
+import json
+import math
+import random
+import sqlite3
+import statistics
+import sys
+import tempfile
+import time
+from pathlib import Path
+
+import sqlite_vec
+
+sys.path.insert(0, str(Path(__file__).resolve().parents[1]))
+from app.retrieval import space_index
+from app.retrieval.routed_vectors import RemoteEmbeddings, _unit_vector
+
+
+def main():
+    rng = random.Random(42)
+    count, dimensions = 4000, 384
+    with tempfile.TemporaryDirectory(prefix='notes-vec-bench-') as temporary:
+        conn = sqlite3.connect(Path(temporary) / 'vectors.db')
+        conn.row_factory = sqlite3.Row
+        conn.enable_load_extension(True)
+        sqlite_vec.load(conn)
+        conn.enable_load_extension(False)
+        conn.execute('CREATE TABLE blocks(block_id TEXT PRIMARY KEY, embedding_local_only INTEGER)')
+        conn.execute('CREATE TABLE routed_block_vectors(space_id TEXT,block_id TEXT,dimensions INTEGER,vector TEXT,PRIMARY KEY(space_id,dimensions,block_id))')
+        vectors = [_unit_vector([rng.uniform(-1, 1) for _ in range(dimensions)], dimensions) for _ in range(count)]
+        conn.executemany('INSERT INTO blocks VALUES (?,0)', [(str(i),) for i in range(count)])
+        conn.executemany('INSERT INTO routed_block_vectors VALUES (?,?,?,?)', [('benchmark', str(i), dimensions, json.dumps(v)) for i, v in enumerate(vectors)])
+        start = time.perf_counter()
+        space_index.ensure(conn, 'benchmark', dimensions)
+        migration_ms = (time.perf_counter() - start) * 1000
+        conn.commit()
+        query = vectors[0]
+        batch = RemoteEmbeddings('benchmark', dimensions, [query])
+        def legacy():
+            def hits():
+                for row in conn.execute('SELECT block_id,vector FROM routed_block_vectors'):
+                    vector = _unit_vector(json.loads(row[1]), dimensions)
+                    yield row[0], max(0., min(1., math.fsum(a*b for a,b in zip(query,vector))))
+            return heapq.nlargest(20, hits(), key=lambda hit:hit[1])
+        def native():
+            return [(hit.id,hit.score) for hit in space_index.search(conn,batch,20)]
+        measurements = {}
+        results = {}
+        for name, operation in [('python_json_scan', legacy), ('sqlite_vec',native)]:
+            elapsed = []
+            for _ in range(5):
+                start = time.perf_counter()
+                results[name] = operation()
+                elapsed.append((time.perf_counter()-start)*1000)
+            measurements[name] = {'median_ms':statistics.median(elapsed), 'samples_ms':elapsed}
+        assert [hit[0] for hit in results['python_json_scan']] == [hit[0] for hit in results['sqlite_vec']]
+        print(json.dumps({'blocks':count,'dimensions':dimensions,'top_k':20,'migration_ms':migration_ms,
+                          'same_top_k':True,'measurements':measurements},indent=2))
+        conn.close()
+
+
+if __name__ == '__main__':
+    main()

backend/tests/test_agent_core.py

@@ -112,7 +112,7 @@ def test_permission_confirmation_resumes_agent() -> None:
                     break
 
         assert request_id is not None
-        assert container.agent.resolve_permission(
+        assert await container.agent.resolve_permission(
             created.run_id, request_id, "allow_once"
         )
         completed = await container.agent.wait(created.run_id)
@@ -370,8 +370,9 @@ def test_cancelling_permission_wait_cancels_run() -> None:
         )
 
         async with asyncio.timeout(2):
-            while container.agent.get_run(created.run_id).status != AgentRunStatus.waiting_permission:
-                await asyncio.sleep(0)
+            async for event in container.agent.events(created.run_id):
+                if event.event == AgentEventType.permission_required:
+                    break
 
         cancelled = await container.agent.cancel(created.run_id)
         await container.agent.wait(created.run_id)

backend/tests/test_index_activity.py

@@ -0,0 +1,68 @@
+import asyncio
+from types import SimpleNamespace
+
+import pytest
+
+from app.retrieval import activity
+from app.services import index_service
+
+
+@pytest.fixture(autouse=True)
+def reset_activity(monkeypatch):
+    for field in ('active', 'completed', 'failed', 'cancelled'):
+        monkeypatch.setattr(activity, field, 0)
+    monkeypatch.setattr(index_service, '_active_job_id', None)
+    monkeypatch.setattr(index_service, '_active_scope', None)
+    monkeypatch.setattr(index_service, '_last_error', None)
+    monkeypatch.setattr(index_service.repository, 'stats', lambda: {'notes': 16, 'blocks': 3787})
+    monkeypatch.setattr(index_service.repository, 'get_index_meta', lambda: {})
+
+
+def test_pending_rebuild_and_incremental_jobs(monkeypatch):
+    meta = {'workspace_vectors_pending': '1', 'note_vectors_pending:a': '1', 'note_vectors_pending:b': '1'}
+    monkeypatch.setattr(index_service.repository, 'get_index_meta', lambda: meta)
+    status = index_service.get_status()
+    assert status.vector_refresh_required and status.pending_jobs == 1
+    assert status.running_jobs == 0
+    monkeypatch.setattr(index_service, '_active_job_id', 'job_test')
+    monkeypatch.setattr(index_service, '_active_scope', 'all')
+    status = index_service.get_status()
+    assert (status.status, status.pending_jobs, status.running_jobs) == ('running', 1, 1)
+    monkeypatch.setattr(index_service, '_active_scope', 'note')
+    assert index_service.get_status().pending_jobs == 2
+    meta.pop('workspace_vectors_pending')
+    assert index_service.get_status().pending_jobs == 2
+    monkeypatch.setattr(index_service, '_active_job_id', None)
+    monkeypatch.setattr(index_service, '_last_error', 'failed')
+    status = index_service.get_status()
+    assert (status.status, status.pending_jobs, status.running_jobs) == ('failed', 2, 0)
+    meta.clear()
+    assert index_service.get_status().pending_jobs == 0
+
+
+def test_search_activity_covers_completion_failure_and_cancellation():
+    async def scenario():
+        gate = asyncio.Event()
+
+        @activity.track_search
+        async def search(_self, request):
+            await gate.wait()
+            if request.query == 'fail':
+                raise ValueError('failure')
+            return 'ok'
+
+        tasks = [asyncio.create_task(search(None, SimpleNamespace(mode=mode, query=query)))
+                 for mode, query in [('vector', 'ok'), ('hybrid', 'fail'), ('vector', 'cancel'), ('fts', 'ok')]]
+        await asyncio.sleep(0)
+        assert index_service.get_status().active_searches == 3
+        tasks[2].cancel()
+        with pytest.raises(asyncio.CancelledError):
+            await tasks[2]
+        gate.set()
+        results = await asyncio.gather(*tasks, return_exceptions=True)
+        assert results[0] == results[3] == 'ok'
+        status = index_service.get_status()
+        assert (status.active_searches, status.completed_searches, status.failed_searches, status.cancelled_searches) == (0, 1, 1, 1)
+        assert status.pending_jobs == 0
+
+    asyncio.run(scenario())

backend/tests/test_local_models.py

@@ -12,6 +12,42 @@ from app.local_models.runtime import Runtime
 from app.providers.base import ProviderError
 
 
+@pytest.mark.parametrize('threaded', [False, True])
+def test_large_embedding_result_crosses_pipe_limit_without_truncation(monkeypatch, tmp_path, threaded):
+    import app.local_models.runtime as module
+    import app.local_models.process as process_module
+    from app.local_models.protocol import response_lines
+    vector = [0.012345678901234567] * 384
+    result = {'result': [vector] * 2111}
+    assert len(json.dumps(result).encode()) > 16 * 1024 * 1024
+    assert max(map(len, response_lines(result, 'embedding'))) < 16 * 1024 * 1024
+    worker = tmp_path / 'large_worker.py'
+    protocol_dir = Path(module.__file__).parent
+    worker.write_text(
+        'import sys,json\n'
+        f'sys.path.insert(0, {str(protocol_dir)!r})\n'
+        'from protocol import response_lines\n'
+        'request=json.load(sys.stdin)\n'
+        'vector=[0.012345678901234567]*384\n'
+        'for line in response_lines({"result":[vector]*len(request["payload"]["texts"])}, "embedding"):\n'
+        ' sys.stdout.write(line)\n', encoding='utf-8')
+    monkeypatch.setattr(module, 'read_state', lambda key: {'status': 'installed'})
+    monkeypatch.setattr(module, 'interpreter', lambda *_: Path(sys.executable))
+    original_async = asyncio.create_subprocess_exec
+    original_threaded = process_module.ThreadedProcess
+
+    async def spawn(*args, **kwargs):
+        if threaded:
+            raise NotImplementedError
+        return await original_async(sys.executable, str(worker), **kwargs)
+
+    monkeypatch.setattr(module.asyncio, 'create_subprocess_exec', spawn)
+    monkeypatch.setattr(process_module, 'ThreadedProcess',
+                        lambda args, **kwargs: original_threaded((sys.executable, str(worker)), **kwargs))
+    actual = asyncio.run(Runtime().infer('bekko', 'embedding', {'texts': ['test'] * 2111}))
+    assert actual == result['result']
+
+
 def test_download_resumes_partial_and_checks_digest(monkeypatch):
     payload = b'verified-model-weights'
     entry = {'path':'model.safetensors','size':len(payload),'hash':hashlib.sha256(payload).hexdigest(),

backend/tests/test_operation_logs.py

@@ -0,0 +1,151 @@
+import asyncio
+import json
+import logging
+import threading
+from pathlib import Path
+
+from app.operation_logs import LogStore, ApplicationLogHandler, get_store, log_event, shutdown_logging
+
+
+def test_logs_persist_filter_cursor_and_retention(tmp_path):
+    store = LogStore(tmp_path / 'logs.db', retain=3)
+    try:
+        for i in range(6):
+            store.emit('ERROR' if i % 2 else 'INFO', 'vectors', 'embedding.failed', {'run_id': f'run_{i}'})
+        store.queue.join()
+        first = store.query(limit=2)
+        assert len(first['items']) == 2 and first['next_cursor']
+        assert len(store.query(before=first['next_cursor'])['items']) == 1
+        assert len(store.query(level='ERROR')['items']) == 2
+        assert len(store.query(q='run_5')['items']) == 1
+        assert not store.query(source='tasks')['items']
+    finally:
+        store.close()
+    reopened = LogStore(tmp_path / 'logs.db', retain=3)
+    try:
+        assert len(reopened.query()['items']) == 3
+    finally:
+        reopened.close()
+
+
+def test_logs_exclude_content_and_legacy_exception_messages():
+    try:
+        log_event('vectors', 'embedding.failed', level='ERROR',
+                  error=ValueError('private note and secret'), model='embedding-v1',
+                  prompt='private note', arguments={'api_key': 'secret'}, api_key='secret')
+        handler = ApplicationLogHandler()
+        record = logging.LogRecord('app.sample', logging.ERROR, __file__, 1,
+                                   'private note and secret %s', ('credentials',), None)
+        handler.emit(record)
+        handler.emit(record)  # a logger propagated to another installed handler
+        store = get_store()
+        store.queue.join()
+        data = json.dumps(store.query())
+        assert len(store.query()['items']) == 2
+        assert 'private note' not in data and 'credentials' not in data and 'api_key' not in data
+        assert 'ValueError' in data and 'embedding-v1' in data
+    finally:
+        shutdown_logging()
+
+
+def test_http_log_correlates_task_operations_without_body():
+    import httpx
+    from app.main import app
+    async def scenario():
+        async with httpx.AsyncClient(transport=httpx.ASGITransport(app=app), base_url='http://test') as client:
+            response = await client.post('/api/tasks', json={'title': 'private title'})
+            assert response.status_code == 200
+            rid = response.headers['x-request-id']
+            store = get_store()
+            await asyncio.to_thread(store.queue.join)
+            result = (await client.get('/api/logs', params={'q': rid})).json()
+            assert len(result['items']) >= 2
+            assert 'private title' not in json.dumps(result)
+            assert any(item['event'] == 'task.created' for item in result['items'])
+            assert (await client.get('/api/logs', params={'limit': 201})).status_code == 422
+    try:
+        asyncio.run(scenario())
+    finally:
+        shutdown_logging()
+
+
+def test_trace_writer_batches_off_loop_and_survives_cancel():
+    from app.agent.async_trace import AsyncTraceWriter
+    started, release = threading.Event(), threading.Event()
+    class Repository:
+        def write_batch(self, jobs):
+            assert threading.current_thread() is not threading.main_thread()
+            started.set()
+            assert release.wait(2)
+            self.jobs = jobs
+    async def scenario():
+        repo = Repository()
+        writer = AsyncTraceWriter(repo)
+        pending = asyncio.create_task(writer.submit('save', 'snapshot'))
+        while not started.is_set():
+            await asyncio.sleep(.001)
+        pending.cancel()
+        writer.worker.cancel()  # simultaneous application shutdown
+        await asyncio.sleep(.005)
+        assert not pending.done()
+        release.set()
+        assert await asyncio.wait_for(pending, 2) is True
+        assert repo.jobs == [('save', ('snapshot',))]
+        assert writer.queue.empty()
+    asyncio.run(scenario())
+
+
+def test_trace_write_failure_is_reported_and_next_submission_recovers():
+    from app.agent.async_trace import AsyncTraceWriter
+    class Repository:
+        fail = True
+        def write_batch(self, jobs):
+            if self.fail:
+                self.fail = False
+                raise OSError('disk unavailable')
+    async def scenario():
+        import pytest
+        writer = AsyncTraceWriter(Repository())
+        with pytest.raises(OSError):
+            await writer.submit('save', 'first')
+        assert not await writer.submit('save', 'second')
+        await writer.queue.join()
+    asyncio.run(scenario())
+
+
+def test_log_write_failure_does_not_stall_queue(tmp_path, monkeypatch):
+    store = LogStore(tmp_path / 'failed.db')
+    try:
+        def broken():
+            raise OSError('disk unavailable')
+        monkeypatch.setattr(store, '_connect', broken)
+        store.emit('ERROR', 'vectors', 'embedding.failed', {'duration_ms': float('nan')})
+        store.queue.join()
+        assert store.failed == 1
+    finally:
+        store.close()
+
+
+def test_cancelled_task_write_keeps_its_slot_until_commit():
+    from app.services.task_service import write_in_background
+    started, release = threading.Event(), threading.Event()
+    order = []
+    def first():
+        started.set()
+        assert release.wait(2)
+        order.append('first')
+    async def scenario():
+        import pytest
+        pending = asyncio.create_task(write_in_background(first))
+        while not started.is_set():
+            await asyncio.sleep(.001)
+        pending.cancel()
+        second = asyncio.create_task(write_in_background(lambda: order.append('second')))
+        await asyncio.sleep(.01)
+        assert order == []
+        release.set()
+        with pytest.raises(asyncio.CancelledError):
+            await pending
+        await second
+        assert order == ['first', 'second']
+    asyncio.run(scenario())

backend/tests/test_routed_retrieval.py

@@ -66,6 +66,161 @@ async def seed():
     return apple, banana
 
 
+def test_native_spaces_isolate_dimensions_and_reuse_without_json_scan(runtime, monkeypatch):
+    from app.retrieval import space_index
+    async def scenario():
+        apple, banana = await seed()
+        ids = [b.block_id for note in (apple, banana) for b in note.blocks]
+        conn = connect()
+        try:
+            with transaction(conn):
+                routed_vectors.store_remote(conn, ids, routed_vectors.RemoteEmbeddings('space-a', 4, [[1., 0., 0., 0.]] * len(ids)))
+            assert conn.execute('SELECT COUNT(DISTINCT dimensions) FROM routed_block_vectors').fetchone()[0] == 2
+        finally:
+            conn.close()
+        # A new connection uses the persistent native index, without reading vector JSON.
+        def forbidden(*args, **kwargs):
+            raise AssertionError('query decoded stored JSON')
+        monkeypatch.setattr(space_index.json, 'loads', forbidden)
+        hits = await routed_vectors.search_remote('apple orchard', top_k=2, strict=True)
+        assert len(hits) == 2
+        assert hits[0].id == apple.blocks[0].block_id
+    asyncio.run(scenario())
+
+
+def test_legacy_vectors_migrate_without_document_embedding(runtime):
+    from app.retrieval import space_index
+    async def scenario():
+        apple, banana = await seed()
+        conn = connect()
+        table = space_index.table_name('space-a', 3)
+        try:
+            with transaction(conn):
+                conn.execute(f'DROP TRIGGER {table}_delete')
+                conn.execute(f'DROP TRIGGER {table}_update')
+                conn.execute(f'DROP TABLE {table}')
+                conn.execute('ALTER TABLE routed_block_vectors RENAME TO saved_vectors')
+                conn.execute('CREATE TABLE routed_block_vectors(space_id TEXT,block_id TEXT REFERENCES blocks(block_id) ON DELETE CASCADE,dimensions INTEGER,vector TEXT,PRIMARY KEY(space_id,block_id))')
+                conn.execute('INSERT INTO routed_block_vectors SELECT * FROM saved_vectors')
+                conn.execute('DROP TABLE saved_vectors')
+        finally:
+            conn.close()
+        runtime.calls.clear()
+        hits = await routed_vectors.search_remote('apple orchard', top_k=2, strict=True)
+        assert len(hits) == 2
+        assert runtime.calls == [['apple orchard']]
+    asyncio.run(scenario())
+
+
+@pytest.mark.parametrize('partitioned', [False, True])
+def test_concurrent_first_search_serializes_migration_and_warm_search_is_read_only(runtime, monkeypatch, partitioned):
+    import threading
+    from app.retrieval import space_index
+    async def scenario():
+        await seed()
+        table = space_index.table_name('space-a', 3)
+        conn = connect()
+        try:
+            with transaction(conn):
+                conn.execute(f'DROP TRIGGER {table}_delete')
+                conn.execute(f'DROP TRIGGER {table}_update')
+                conn.execute(f'DROP TABLE {table}')
+        finally:
+            conn.close()
+        entered, release, second = threading.Event(), threading.Event(), threading.Event()
+        original_ensure, original_prepare = space_index.ensure, space_index.prepare
+        calls = []
+        def ensure(*args):
+            calls.append(1)
+            entered.set()
+            assert release.wait(5)
+            return original_ensure(*args)
+        def prepare(*args):
+            if entered.is_set():
+                second.set()
+            return original_prepare(*args)
+        monkeypatch.setattr(space_index, 'ensure', ensure)
+        monkeypatch.setattr(space_index, 'prepare', prepare)
+        batch = routed_vectors.RemoteEmbeddings('space-a', 3, [[1., 0., 0.]])
+        async def search():
+            if entered.is_set():
+                second.set()
+            await routed_vectors._prepare_indexes([batch])
+            if partitioned:
+                return await asyncio.to_thread(routed_vectors._search_partitions, {False: batch}, {False}, 2, True)
+            return await asyncio.to_thread(routed_vectors._search_space, batch, 2, True)
+        tasks = []
+        try:
+            tasks.append(asyncio.create_task(search()))
+            assert await asyncio.to_thread(entered.wait, 5)
+            tasks.append(asyncio.create_task(search()))
+            assert await asyncio.to_thread(second.wait, 5)
+            release.set()
+            first, other = await asyncio.gather(*tasks)
+            assert first == other and len(first) == 2
+            assert len(calls) == 1
+            # Prepared indexes are reusable even with SQLite query_only enforced.
+            original_connect = routed_vectors.connect
+            def read_only():
+                connection = original_connect()
+                connection.execute('PRAGMA query_only=ON')
+                return connection
+            monkeypatch.setattr(routed_vectors, 'connect', read_only)
+            assert await search() == first
+        finally:
+            release.set()
+            await asyncio.gather(*tasks, return_exceptions=True)
+    asyncio.run(scenario())
+
+
+@pytest.mark.parametrize('cancel_search', [False, True])
+def test_save_waits_for_migration_even_when_search_is_cancelled(runtime, monkeypatch, cancel_search):
+    import threading
+    from app.retrieval import space_index
+    async def scenario():
+        apple, _ = await seed()
+        table = space_index.table_name('space-a', 3)
+        conn = connect()
+        try:
+            with transaction(conn):
+                conn.execute(f'DROP TRIGGER {table}_delete')
+                conn.execute(f'DROP TRIGGER {table}_update')
+                conn.execute(f'DROP TABLE {table}')
+        finally:
+            conn.close()
+        entered, release = threading.Event(), threading.Event()
+        original = space_index.ensure
+        def slow(*args):
+            entered.set()
+            assert release.wait(5)
+            return original(*args)
+        monkeypatch.setattr(space_index, 'ensure', slow)
+        # Keep the subsequent vector job queued; test saving and its durable marker.
+        monkeypatch.setattr(index_service, 'schedule_workspace_rebuild', lambda: None)
+        query = asyncio.create_task(routed_vectors.search_remote('apple orchard', top_k=2, strict=True))
+        save = None
+        try:
+            assert await asyncio.to_thread(entered.wait, 5)
+            if cancel_search:
+                query.cancel()
+            save = asyncio.create_task(note_service.update_note(apple.note_id, markdown='Saved during migration', defer_vectors=True))
+            await asyncio.sleep(0.02)
+            assert not save.done()
+            release.set()
+            saved = await asyncio.wait_for(save, 5)
+            assert saved.markdown == 'Saved during migration'
+            assert (await note_service.get_note(apple.note_id)).markdown == saved.markdown
+            assert repository.get_index_meta()[f'note_vectors_pending:{apple.note_id}'] == '1'
+            # Query may observe the saved revision's pending index, but saving must succeed.
+            result = (await asyncio.gather(query, return_exceptions=True))[0]
+            if cancel_search:
+                assert isinstance(result, asyncio.CancelledError)
+        finally:
+            release.set()
+            await asyncio.gather(*([query, save] if save else [query]), return_exceptions=True)
+    asyncio.run(scenario())
+
+
 @pytest.mark.parametrize("outcome", ["api", "api_failure", "missing_space"])
 def test_benchmark_reports_actual_embedding_and_fallback(runtime, outcome):
     from app.benchmarks import service

backend/tests/test_workspace.py

@@ -114,3 +114,34 @@ def test_workspace_openapi_paths_are_published() -> None:
         "/api/workspace/folders/delete",
         "/api/notes/{note_id}/rename",
     } <= paths.keys()
+
+def test_external_files_are_registered_and_removed_without_vector_wait(monkeypatch) -> None:
+    from app.services import index_service
+    scheduled = []
+    monkeypatch.setattr(index_service, 'schedule_workspace_rebuild', lambda: scheduled.append(True))
+    vault = get_settings().vault_path
+    vault.mkdir(parents=True, exist_ok=True)
+    external = vault / 'external.md'
+    external.write_text('# External\n', encoding='utf-8')
+    tree = asyncio.run(get_workspace_tree())
+    assert tree[0].note_id is not None
+    external.rename(vault / 'renamed.md')
+    tree = asyncio.run(get_workspace_tree())
+    assert [item.name for item in tree] == ['renamed.md']
+    (vault / 'renamed.md').unlink()
+    assert asyncio.run(get_workspace_tree()) == []
+    assert len(scheduled) == 3
+
+
+def test_save_rejects_external_content_change() -> None:
+    import hashlib
+    from app.contracts import NoteUpdateRequest
+    from app.routes import update_note
+    original = '# Original\n'
+    note = asyncio.run(create_note(NoteCreateRequest(title='Conflict', markdown=original)))
+    disk = get_settings().vault_path / note.file_path
+    disk.write_text('# External\n', encoding='utf-8')
+    with pytest.raises(ApiError) as error:
+        asyncio.run(update_note(note.note_id, NoteUpdateRequest(markdown='# Editor\n', expected_content_hash=hashlib.sha256(original.encode()).hexdigest())))
+    assert error.value.code == 'NOTE_CONTENT_CONFLICT'
+    assert disk.read_text(encoding='utf-8') == '# External\n'

backend/tests/test_workspace_background.py

@@ -5,6 +5,33 @@ from app.config import get_settings
 from app.services import index_service, workspace_service
 
 
+def test_external_new_note_does_not_rebuild_existing_notes(monkeypatch):
+    from app.services import note_service
+    async def scenario():
+        await note_service.create_note(title='Existing', markdown='Keep existing vectors', folder=None, tags=[])
+        calls = []
+        original = index_service.prepare_note_index
+        async def record(parsed, **kwargs):
+            calls.append(parsed.file_path)
+            return await original(parsed, **kwargs)
+        async def forbidden(*args, **kwargs):
+            raise AssertionError('full rebuild should not run')
+        monkeypatch.setattr(index_service, 'prepare_note_index', record)
+        monkeypatch.setattr(index_service, 'rebuild', forbidden)
+        path = get_settings().vault_path / 'external.md'
+        path.write_text('# External\n\nNew content', encoding='utf-8')
+        try:
+            await workspace_service.refresh_workspace_tree()
+            await index_service._background_task
+            assert calls == ['external.md']
+            assert not index_service.get_status().vector_refresh_required
+            await workspace_service.open_workspace(None)
+            assert calls == ['external.md']
+        finally:
+            await index_service.shutdown()
+    asyncio.run(scenario())
+
+
 def test_open_returns_before_vectors_and_deduplicates_background(monkeypatch):
     async def scenario():
         started, release = asyncio.Event(), asyncio.Event()

docs/README.md

@@ -2,7 +2,7 @@
 
 本目录集中保存团队开发期间需要长期维护的架构、接口、实现、协作和问题复盘文档。文档按用途分类，避免设计约束、开发记录与故障复盘混放。
 
-当前文档基线为 2026-09-05：第一阶段和第二阶段 A～F 工程范围已经合并到 `main`，当前可运行形态仍为 Vue/Vite Web 前端与 FastAPI AI Core。Tauri/Rust Host、Stronghold、原生多 Vault 文件系统、生产级 MCP 沙箱和 Sync Server 尚未接入。
+当前文档基线为 2026-09-06：第一阶段和第二阶段 A～F 工程范围已经合并到 `main`，当前可运行形态仍为 Vue/Vite Web 前端与 FastAPI AI Core。Tauri/Rust Host、Stronghold、原生多 Vault 文件系统、生产级 MCP 沙箱和 Sync Server 尚未接入。
 
 仓库入口文档：[项目 README](../README.md)、[前端 README](../frontend/README.md)、[后端 README](../backend/README.md)。
 
@@ -34,6 +34,19 @@
 
 ## development：开发说明
 
+- [前端构建分块优化开发说明](development/前端构建分块优化开发说明.md)
+
+- [工作区后台索引与保存开发说明](development/工作区后台索引与保存开发说明.md)
+- [模型隔离向量索引与增量登记](development/模型隔离向量索引与增量登记.md)
+- [Mermaid 预览与缩放开发说明](development/Mermaid预览与缩放开发说明.md)
+- [扩展安装持久化与社区包开发说明](development/扩展安装持久化与社区包开发说明.md)
+- [模型上下文管理](development/模型上下文管理.md)
+- [Markdown 渲染检查](development/Markdown渲染检查.md)
+- [警告框与桌面编辑命令开发说明](development/警告框与桌面编辑命令开发说明.md)
+- [标题折叠与样式开发说明](development/标题折叠与样式开发说明.md)
+- [主题组件覆盖检查](development/主题组件覆盖检查.md)
+- [第二阶段补充验收工具](development/第二阶段补充验收工具.md)
+
 - [多模态管线与模型运行开发说明](development/多模态管线与模型运行开发说明.md)
 - [阶段 F 收尾验收记录](development/阶段F收尾验收记录.md)
 - [AI Core 与 Agent Core 开发说明](development/AI-Core与Agent-Core开发说明.md)
@@ -81,3 +94,9 @@
 - 问题复盘至少写清原因、后果、解决思路、实际方案和验证结果。
 - `.local-plans/` 只保存个人或阶段性的本地计划，不属于正式团队文档，不应提交到远程仓库。
 - 文档中的“计划实现”和“已经实现”必须明确区分；实现状态以代码、测试和运行时契约为准。
+
+- [Markdown 语法预设与外部文件刷新](development/Markdown语法预设与外部文件刷新.md)
+
+- [长文渲染优化与压测报告](development/长文渲染优化与压测报告.md)
+- [Agent 与任务压测报告](development/Agent与任务压测报告.md)
+- [后台运行日志与压力问题修复](development/后台运行日志与压力问题修复.md)

docs/contracts/Tauri-Rust桌面客户端需求说明-第三阶段.md

@@ -21,7 +21,9 @@
 
 桌面客户端顶部菜单栏的 **段落 → 导入为笔记属性…** 预留元数据格式导入功能，与标题、正文、列表等段落操作归组。它处理笔记内容中的元数据，不是主题包安装入口。
 
-建议稳定的前端命令标识为 `editor.import-note-properties`，仅为设计标识，尚未注册为 Tauri IPC。原生菜单和编辑器命令面板应分发同一命令，避免两套转换逻辑。快捷键待第三阶段统一分配，不抢占现有编辑快捷键。
+稳定的前端命令标识为 `editor.import-note-properties`，已进入前端 v1 命令目录，但属性转换处理器与 Tauri IPC 尚未实现。原生菜单和编辑器命令面板应分发同一命令，避免两套转换逻辑。快捷键待第三阶段统一分配，不抢占现有编辑快捷键。
+
+Markdown 格式（含警告框）与元数据共用 `editorCommandService` 的能力查询和命令分发接口，详见 [警告框与桌面编辑命令开发说明](../development/警告框与桌面编辑命令开发说明.md)。Host 根据 supported / enabled 显隐或禁用菜单，不能把已预留的命令 ID 当作已可执行能力；原生快捷键不绕过活动文档、只读和冲突检查。
 
 ### 2.2 输入与转换规则
 

docs/contracts/后端接口契约-开发版.md

@@ -42,7 +42,7 @@ Web 联调阶段只暴露后端通过 `APP_VAULT_PATH` 配置的单一 Vault，
 | 方法 | 路径 | 用途 |
 | --- | --- | --- |
 | GET | `/api/workspace` | 获取当前 Vault、文件数和索引同步状态 |
-| POST | `/api/workspace/open` | 打开配置的 Vault；磁盘路径集变化时重建索引 |
+| POST | `/api/workspace/open` | 打开配置的 Vault；路径集变化时先登记文件与 FTS，再调度后台向量更新 |
 | GET | `/api/workspace/tree` | 获取真实 Markdown 文件和目录树 |
 | POST | `/api/workspace/folders` | 新建目录 |
 | POST | `/api/workspace/folders/rename` | 重命名目录并同步 Note 路径 |
@@ -198,3 +198,24 @@ RunCancelled
 
 - `GET /api/index/status` 额外返回 `total_notes: int` 和 `total_blocks: int`，来自当前 SQLite 索引；未建立内容索引时为 0。
 - `GET /api/permissions/policy` 返回 `Record<string, "allow" | "confirm" | "deny">`，值取自后端当前生效的 PermissionPolicy。此接口只读，不提供全局修改能力，运行时权限确认仍使用既有 Agent permission endpoint。
+
+## 2026-09-06：后台索引补充
+
+- `POST /api/workspace/open` 返回可使用的 WorkspaceSnapshot，不等待向量推理。
+- 外部新增文件登记后按笔记持久化后台向量任务，不再因此设置全库重建标记；已存在的全库待处理标记仍继续执行。模型空间与维度的持久化 sqlite-vec 索引从已有向量转换，接口响应结构不变。实现与性能验证见 [模型隔离向量索引与增量登记](../development/模型隔离向量索引与增量登记.md)。
+- `PATCH /api/notes/{note_id}` 成功代表正文、元数据和 FTS 已保存；后台向量失败不撤销这次保存。
+- `GET /api/index/status` 新增 `vector_refresh_required: boolean`，表示工作区或笔记存在向量待处理标记。该字段不是进度百分比；任务失败时也可为 true。
+- `pending_jobs` 返回真实未完成索引任务数（包含运行中），不再固定为 0。全库待重建或运行中的全量重建计一个任务；逐笔记刷新按待处理标记计数。`running_jobs` 返回当前运行数。失败后保留的待重建标记仍计入未完成数。
+- `active_searches`、`completed_searches`、`failed_searches`、`cancelled_searches` 分别表示向量/混合检索的进行中、完成、失败、取消次数，覆盖搜索、对话和 Agent 经统一检索引擎发起的调用，排除纯 FTS；混合检索回退 FTS 后成功仍计完成。计数仅保存在当前服务进程内，重启归零，与索引队列互相独立。
+- 设置与搜索页每秒轮询状态，其他页面空闲时每 5 秒轮询；不是事件推送。短检索可能无法观察到进行中状态，但完成/失败计数会保留。设置页与底部状态栏复用状态标签，未知字段显示“未获取”。
+- `POST /api/index/rebuild` 仍仅支持全量重建，并等待结果；不要将上述异步语义推广到所有索引 API。
+
+状态、恢复限制与验证见 [工作区后台索引与保存开发说明](../development/工作区后台索引与保存开发说明.md)。
+
+## 2026-09-06：统一运行日志
+
+`GET /api/logs` 返回独立持久化的后台操作日志，无需打开 Vault。参数：`limit` 默认 50、最大 200；`before` 为上一页 next_cursor；`level` 为 INFO/WARNING/ERROR/CRITICAL 或空；`source` 按模块精确匹配；`q` 在事件名和脱敏元数据中做字面搜索。
+
+返回 `items: [{id,timestamp,level,source,event,details}]`、`next_cursor`（无后续页时 null）、`sources`、`pending`、`dropped`、`write_failures`、`retention`。日志按 ID 倒序，保留最近 20,000 条。响应头 `X-Request-ID` 与后台日志关联。不得依赖日志记录笔记正文、工具参数、凭据或原始异常消息。
+
+队列、错误处理、字段白名单和验证方法见 [后台运行日志与压力问题修复](../development/后台运行日志与压力问题修复.md)。

docs/development/Agent与任务压测报告.md

@@ -0,0 +1,156 @@
+# Agent 与任务压测报告
+
+> 日期：2026-09-06。范围：当前第二阶段 Agent Runtime、任务 API、任务列表及 Trace 组件。测试在 Windows 11、Python 3.12.6、独立无头 Chrome 下执行，前端为 Vite 开发模式，纸间时光版本 1.8.1。
+
+## 1. 结论
+
+功能正确性检查通过：Agent 工具调用、事件序号与回放、终态持久化恢复、容量拒绝、取消、权限等待、故障隔离，以及任务增删改查和分页均得到预期结果。性能仍有三项明确问题：
+
+| 优先级 | 问题 | 本轮证据 | 建议方向 |
+| --- | --- | --- | --- |
+| P1 | 任务列表未加载后续页；Agent 历史列表也没有后续分页入口 | 100、1000 条任务的实际页面均只请求 `/api/tasks` 并显示 50 条；Agent store 同样仅调用默认分页一次，接口默认 50 | 增加服务端筛选与分页/加载更多，显示总量，防止统计仅基于已加载项 |
+| P1 | 高并发 Agent 阻塞事件循环 | 200 并发的完成延迟 P95 约 10.55 秒；进程内心跳最大延迟约 3.56 秒 | 分析同步持久化，设计有界执行调度及顺序写入，保留事件落盘、终态与回放一致性 |
+| P1 | 大 Trace 的树形筛选长时间阻塞 | 2000 事件树形搜索约 483–617 ms；10000 事件约 25.91 秒 | 为匹配的 sequence/tool/model ID 建 Set，避免逐节点重复遍历事件；再评估分段显示及增量更新 |
+
+本次新增的是可复现压测与报告，没有把上述生产问题标记为已修复。页面滚动与树形搜索是不同瓶颈：10000 事件的滚动 P95 约 40 ms，并不能说明搜索交互也流畅。
+
+## 2. 隔离与方法
+
+- 后端脚本在导入任何 app 模块前，将 `APP_DATA_DIR`、`APP_DB_PATH`、`APP_VAULT_PATH` 指向临时目录，结束后清理；不读写用户 Vault、现有任务及 Provider 凭据。
+- Agent 使用内置 Mock Provider，每轮模型调用注入 50 ms 异步等待，正常样本包含一次 `system.echo` 工具调用和两轮模型调用；不调用真实厂商，也不衡量回答质量或真实模型吞吐。
+- 进程内运行直接调用真实 Runtime、SQLite 和任务 ASGI 路由。任务 HTTP 复核另起独立 Uvicorn 进程，用真实回环连接执行，避免将 ASGI 驱动的连续无让出执行误解为网络服务延迟。
+- 前端挂载真实 TasksView、TraceTimeline 和 Pinia store。压测页拦截全部 fetch，不向真实后端发出请求。任务接口夹具保留默认 50 条分页，先测实际加载条数，再注入完整列表测试渲染上限，两者分开记录。
+- Trace 由确定性模型开始/完成、工具调用/结果事件组成，带调用与父节点 ID；测量首次渲染、时间线过滤、树形切换、匹配全部节点的树形搜索。
+- 滚动用 CDP 派发 120 次滚轮事件，记录真实滚动容器及 `maxScrollTop`，防止对未滚动页面统计帧间隔。Trace 测试容器显式解除应用根节点的裁剪，由独立滚动区承担真实 Agent 页滚动容器的职责。
+
+本轮每个前端配置测一次；开发编译、后台负载、缓存和浏览器调度都会影响结果，数据用于发现瓶颈，不作为生产环境 SLA。首次渲染计时不包含模块下载，包含 Vue 更新及两个 animation frame。
+
+## 3. Agent 后端
+
+### 3.1 正常工具调用与回放
+
+| 并发数 | 运行数 | 完成延迟中位数（ms） | 完成延迟 P95（ms） | 场景心跳最大延迟（ms） |
+| ---: | ---: | ---: | ---: | ---: |
+| 1 | 20 | 146.20 | 170.13 | 26.84 |
+| 10 | 20 | 405.75 | 505.74 | 136.71 |
+| 50 | 50 | 2234.45 | 2304.42 | 798.84 |
+| 200 | 200 | 10262.47 | 10554.52 | 3559.97 |
+
+290 个正常运行全部完成，工具返回内容逐项一致；实时订阅事件序号连续，`after_sequence=2` 回放与原事件后缀一致。新的 Runtime 实例可以从 SQLite 恢复这些终态运行。订阅者集合最终清空，进程内保留记录不超过 200。
+
+“并发”是同时提交的协程数，不代表独立 CPU 工作线程。当前 queued 是启动前状态，Runtime 并没有把超额活跃运行无限排入执行队列。场景心跳还包含提交、持久化回放与恢复校验，不能将其全部归为模型执行耗时；50、200 并发场景的心跳采样数仅 8 个，表中因此列最大值而非宣称稳定分位数。
+
+代码定位：`AgentRuntime._publish()` 同步调用 `AgentTraceRepository.append_event()`，后者逐事件连接 SQLite 并提交事务；`connect()` 还加载扩展和检查迁移。这是需要进一步拆分测量的阻塞路径，本轮未完成各子步骤 CPU/磁盘成本归因。
+
+### 3.2 容量、取消与故障注入
+
+- 保持 200 个模型调用活跃，第 201 次创建得到 `AgentCapacityError`；随后取消全部 200 个运行，全部进入 cancelled，后台任务均结束。
+- 20 个运行等待权限：10 个允许后完成，10 个等待中取消，订阅者均释放。
+- 20 个混合运行：5 个正常完成、5 个 Provider 异常、5 个模型超时、5 个工具超时，均获得预期状态或错误码；工具执行器剩余数量为 0。
+- 正常回放和故障场景合计创建 530 个运行，临时数据库最终约 2.95 MB。工具超时被记录为 ToolResult 错误，后续 Mock 模型仍可能完成运行，不将它误算为整个 Run 必然失败。
+
+这里的“恢复”是新 Runtime 读取终态持久化数据，未模拟 OS 强杀时的写入中断。SSE 通过 Runtime 的事件生成器验证序号及断点回放，没有进行真实网络慢读者/断网压力测试。
+
+## 4. 任务 API
+
+进程内分别对 100、1000 条任务执行创建、逐页读取、更新为 done、删除，所有 ID 完整，最终总量为 0。默认接口每页 50 条，显式每页 100 条遍历可以取回全部数据。
+
+ASGITransport 的 1000 条突发操作中，心跳出现约 14 秒延迟：测试客户端与同步路由处于同一事件循环，连续就绪协程缺少网络等待，不能将其视作真实 HTTP 健康检查延迟。因此增加独立 Uvicorn + 回环 HTTP 复核：
+
+| 操作 | 数量 | P95（ms） | 最大值（ms） |
+| --- | ---: | ---: | ---: |
+| 创建 | 1000 | 116.45 | 134.91 |
+| 更新 | 1000 | 159.29 | 193.37 |
+| 删除 | 1000 | 156.43 | 190.10 |
+| 分页/收尾查询 | 11 | 20.96 | 20.96 |
+| 并行健康检查 | 117 | 157.00 | 195.07 |
+
+HTTP 客户端并发 20，总耗时约 18.31 秒；健康检查零失败，分页无重复/遗漏，最终任务数为 0。此处是本机单次结果，未覆盖跨网络、长期持久负载或多进程同时写同一数据库。
+
+## 5. 前端
+
+### 5.1 任务列表
+
+100、1000 条数据的实际加载阶段都只有一次 `/api/tasks` 请求，store 中均为 50 条。以下是额外注入完整 1000 条数据后的结果，不是生产页面当前可以加载 1000 条的证明。
+
+| 主题 | 完整列表渲染（ms） | 完成状态筛选（ms） |
+| --- | ---: | ---: |
+| 默认浅色 | 117.4 | 44.1 |
+| 默认深色 | 137.8 | 47.8 |
+| 纸间时光 1.8.1 | 150.0 | 59.5 |
+
+1000 条列表约 11007 个 DOM 节点，实际滚动最远达到 81000 px；筛选 done 得到 334 条，与夹具期望一致。100 条样本筛选得到 34 条，也一致。默认浅色的 1000 条滚动 P95 约 30.2 ms，纸间时光约 50.1 ms；样本数少，暂不据此认定新的单一 CSS 根因。
+
+### 5.2 Agent Trace
+
+| 事件数/主题 | 首次渲染（ms） | 时间线搜索（ms） | 树形切换（ms） | 树形全匹配搜索（ms） |
+| --- | ---: | ---: | ---: | ---: |
+| 2000 / 默认浅色 | 283.8 | 97.4 | 64.0 | 617.2 |
+| 2000 / 默认深色 | 289.0 | 74.5 | 62.9 | 483.0 |
+| 2000 / 纸间时光 | 337.3 | 86.3 | 62.1 | 540.1 |
+| 10000 / 纸间时光 | 1803.9 | 582.8 | 317.5 | 25914.8 |
+
+200 事件的树形搜索约 20–29 ms。2000 事件时间线约 20542 个 DOM 节点，10000 事件约 102542 个。查询“压力测试 1”分别命中 444、4444 条事件，与直接检查输入数据的结果一致；树形搜索“压力测试”匹配所有事件，会自动展开匹配子树。
+
+代码定位：`TraceTimeline.filteredTree` 为每个节点调用 `filteredEvents.some(...)`。节点数和匹配事件数一起增加时，会产生近似二次增长的匹配工作，随后还需构造并渲染展开子树。建议先用匹配 ID 集合消除嵌套扫描，再测 DOM 更新成本；不要仅用防抖隐藏单次 25 秒阻塞。
+
+10000 是扩大数据规模的诊断测试，高于 Runtime 默认内存事件保留量 2000；它直接向组件传入事件，不代表当前单次 API 页或实时 store 默认会收到这一数量。也未覆盖逐事件 SSE 增量刷新的端到端成本。
+
+## 6. 复现与原始数据
+
+```powershell
+# 后端：独立临时数据，离线 Mock
+backend/.venv/Scripts/python.exe backend/scripts/agent-task-stress.py --output .local-plans/agent-task-backend.json
+# 真实 HTTP：独立 Uvicorn、随机回环端口
+backend/.venv/Scripts/python.exe backend/scripts/task-http-stress.py --count 1000 --concurrency 20 --output .local-plans/task-http.json
+# 前端：先启动独立 Vite，另一个终端执行后续命令
+npm --prefix frontend run dev -- --port 5175 --strictPort
+backend/.venv/Scripts/python.exe frontend/tests/performance/run-stress.py --url 'http://127.0.0.1:5175/tests/performance/agent-task.html?kind=tasks&theme=paper-moments' --scroll --sizes 100 1000 --runs 1 --output .local-plans/task-ui.json
+backend/.venv/Scripts/python.exe frontend/tests/performance/run-stress.py --url 'http://127.0.0.1:5175/tests/performance/agent-task.html?kind=trace&theme=paper-moments' --scroll --sizes 200 2000 10000 --runs 1 --output .local-plans/trace-ui.json
+```
+
+URL 的 theme 可换为 light、dark。测试应串行运行，避免不同负载相互争用；10k Trace 树形筛选可能长时间占用测试浏览器。浏览器使用临时用户目录，不接管用户当前浏览器。
+
+- [Agent 与进程内任务 API 数据](performance/2026-09-06-agent-task-backend.json)
+- [真实 HTTP 任务数据](performance/2026-09-06-task-http.json)
+- [前端 13 组样本数据](performance/2026-09-06-agent-task-ui.json)
+- [前端压测工具](../../frontend/tests/performance/README.md)
+
+附加回归：`test_agent_core.py`、`test_api.py` 共 26 项通过。脚本中的状态、序号、输出、分页与筛选断言均通过。未提交或推送本次材料。
+
+## 7. 修复后复测（2026-09-06）
+
+以上保留首次压测基线。本节对应后台 Trace 批量写入、任务后台写入、完整列表加载、Trace 集合匹配/分页和统一日志接入后的实现。样本开启新操作日志，仍只调用隔离 Mock。
+
+| 项目 | 修复前 | 修复后 |
+| --- | ---: | ---: |
+| 200 并发 Agent 完成 P95 | 10,554.52 ms | 1,233.12 ms |
+| 200 并发测量区间事件循环最大延迟 | 3,559.97 ms | 509.00 ms |
+| 纸间时光 10k Trace 首次渲染 | 1,803.9 ms | 94.4 ms |
+| 纸间时光 10k Trace 树形全匹配筛选 | 25,914.8 ms | 189.2 ms |
+| 纸间时光 10k Trace 首屏 DOM 节点 | 约 102,542 | 1,852 |
+| 1,000 条任务首次实际加载 | 50 条 | 1,000 条（10 次 API 请求） |
+
+Agent 测量区间还包含同步读回、校验和重启恢复，最大心跳延迟不是纯执行阶段指标。290 次普通运行、200 个容量/取消场景、20 个权限场景、20 个失败/超时场景全部通过，订阅者和工具执行器释放。不能声称消除了所有主线程工作。
+
+Trace 搜索检查完整数据，只有渲染分页。10k 样本滚动 frame gap P95 为 10.1 ms，无 longtask；时间线筛选 284.9 ms，树形切换 100.9 ms。这是单次本机样本，不代表所有硬件与实时 SSE 输入。
+
+1,000 条任务界面每页 100 条；筛选后数据总数 334，当前页 100。筛选 18.7 ms，滚动 frame gap P95 为 30 ms，无 longtask。断言同时检查完整数据量和分页渲染数量。
+
+真实 HTTP 测试 1,000 条任务、20 并发，CRUD 全部成功，分页完整，最终任务数 0：
+
+| 指标 | 修复前 | 修复后 |
+| --- | ---: | ---: |
+| health P95 | 157.00 ms | 38.64 ms |
+| 创建 P95 | 116.45 ms | 157.68 ms |
+| 更新 P95 | 159.29 ms | 208.68 ms |
+| 删除 P95 | 156.43 ms | 205.45 ms |
+| 总耗时 | 18.31 s | 24.51 s |
+
+后台排队和操作记录改善了无关请求的响应，但这组样本写入吞吐下降，不能描述为 CRUD 全面提速。后续可以评估任务事务批量化与连接初始化开销；本次没有降低 SQLite 持久化级别。
+
+- [Agent / 进程内任务复测](performance/2026-09-06-agent-task-backend-fixed.json)
+- [真实 HTTP 任务复测](performance/2026-09-06-task-http-fixed.json)
+- [Trace 浏览器复测](performance/2026-09-06-agent-trace-ui-fixed.json)
+- [任务浏览器复测](performance/2026-09-06-task-ui-fixed.json)
+- [日志架构与验收说明](后台运行日志与压力问题修复.md)

docs/development/Knowledge与Retrieval-Core开发说明.md

@@ -235,3 +235,9 @@ rag.search
 - RAG Benchmark 已建立：`POST /api/benchmarks/rag/runs` 创建即返回 queued、后台 Task 执行，
   通过 SSE 实时推送进度，报告含逐 Case 结果与 `total_cases` / `successful_cases` / `failed_cases` / `failure_rate`。
 - Agent Benchmark 暂缓，待 Agent Runtime 完成后交付。
+
+## 2026-09-06 实现补充
+
+上文的 MVP 同步说明是早期基线。当前打开 Vault 和 HTTP PATCH 保存已拆分即时元数据 / FTS 与后台向量计算；手动全量重建仍等待完成。生产 Embedding 使用实际模型和隔离向量空间，HashEmbedding 仅用于测试。
+
+后续维护以 [工作区后台索引与保存开发说明](工作区后台索引与保存开发说明.md) 的实现边界、状态和验证步骤为准。

docs/development/Markdown渲染检查.md

@@ -30,6 +30,14 @@
 | 自定义字号 span | 装饰渲染 | 清理后 HTML | 既有字号标记测试 |
 | 原始 HTML | 编辑器按自身 HTML 节点规则保留 | 清理后展示，脚本及事件属性移除 | 新增安全 HTML 测试 |
 
-源码模式展示 Markdown 原文，不隐藏反引号、星号和围栏。脚注、定义列表、Wiki 双链、Obsidian callout、图表以外的自定义围栏等未作为独立渲染扩展启用，不在“已支持”范围内。
+源码模式展示 Markdown 原文，不隐藏反引号、星号和围栏。脚注、定义列表、Wiki 双链、图表以外的自定义围栏等未作为独立渲染扩展启用，不在“已支持”范围内。
+
+2026-09-06 补充：GitHub alerts 与 Obsidian callout 已在工作区和静态预览接入，包含常用类型/别名、自定义标题、嵌套与折叠。语法、命令接口与验证方法见 [警告框与桌面编辑命令开发说明](警告框与桌面编辑命令开发说明.md)。
 
 自动检查覆盖解析、DOM 输出、部分编辑交互、保存往返和主题变量。尚未完成所有浏览器、所有输入法及每个主题的逐页截图比对；不能据此宣称像素级视觉验收通过。测试使用隔离样例，没有修改用户笔记。
+
+## 2026-09-06 Mermaid 补充
+
+补齐大图居中与完整适配、显示宽度缩放基准、滚轮速度限制、鼠标位置补偿及重开滚动位置清理。修复 Milkdown 段落内边距挤出 foreignObject 标签框的问题，浏览器核对 1、many、contains 完整显示。
+
+实现原理、测试命令和视觉复核步骤见 [Mermaid 预览与缩放开发说明](Mermaid预览与缩放开发说明.md)。

docs/development/Markdown语法预设与外部文件刷新.md

@@ -0,0 +1,48 @@
+# Markdown 语法预设与外部文件刷新
+
+日期：2026-09-06。
+
+## 1. 设置入口与范围
+
+“设置 → 编辑器 → Markdown 语法预设”管理语法与编辑行为，独立于“标题样式”的字号、字体和字重设置。
+
+支持 ATX/Setext 标题、无序列表标记、有序列表递增、代码围栏、裸链接识别、数学公式、警告框、Mermaid、代码行号、自动换行、缩进和工具栏新建代码块的默认语言。Setext 只作用于 H1/H2。提供扩展、GitHub 和基础三组内置配置，支持最多 20 个命名自定义预设，同名保存替换旧配置。
+
+配置保存在本机 localStorage 的 `markdown-preferences`，读取时校验。静态预览即时应用；写作编辑器在下次打开时应用，避免切换设置重建正在编辑的文档。写作模式保存会统一整篇正文的语法标记，源码模式保留手写语法。关闭扩展后对应内容按普通 Markdown/代码展示。
+
+本次不是完整复制 Typora：未提供上下标、高亮、智能标点、physics 包及导出公式选项。基础配置仍支持现有 GFM 表格等功能。
+
+## 2. 主题与折叠
+
+六个主题共用语义颜色和表单控件。内置浅色、深色、护眼更新为 1.3.0；纸间时光 1.8.0；Ocean Blue 1.5.0；Midnight Purple 2.3.0。社区预览增加语法控件和标题折叠样本。
+
+标题箭头使用统一 CSS 形状，默认隐藏，悬停标题或键盘聚焦按钮时显示；无悬停能力的触摸设备保持可见。用户自定义标题外观独立于主题配色。
+
+## 3. 外部文件刷新与保存保护
+
+Web 当前采用串行后台轮询：前一次完成后间隔两秒，在窗口聚焦时也检查。隐藏页面暂停读取，卸载移除监听。此机制不是原生文件事件监听；第三阶段可由 Tauri 文件事件替代。
+
+`GET /workspace/tree` 检查磁盘新增、删除和重命名，为新文件登记元数据及全文索引，向量任务继续后台执行。前端保留文件夹展开状态，并丢弃过期请求响应。读取失败保留旧树并显示重试入口。
+
+当前打开且未修改的文件检测到外部正文变化后更新编辑器；存在本地编辑时保留缓冲区，停止自动保存并提示冲突。重新加载磁盘版本需要用户确认。原文件删除或移动后，隐藏不可用的重新加载入口，提供下载当前 Markdown 副本和确认关闭笔记；取消关闭或确认期间正文改变时保留缓冲区。关闭后可重新选择其他文件，不再阻塞导航。`PATCH /notes/{note_id}` 新增可选 `expected_content_hash`（原始正文 UTF-8 SHA-256，64 位小写十六进制），保存前校验，不匹配返回 `NOTE_CONTENT_CONFLICT`，防止覆盖外部修改。
+
+范围限制：现有文件的外部正文修改会刷新当前编辑器，但本轮目录检查不会据此重建其搜索索引；可通过重建索引同步检索内容。
+
+## 4. 验证方法
+
+```powershell
+cd frontend
+npm run test
+npm run build
+cd ..
+backend/.venv/Scripts/python.exe -m pytest backend/tests/test_workspace.py backend/tests/test_workspace_background.py -q -p no:cacheprovider
+```
+
+手工验证：
+
+1. 保存并重新应用命名预设，刷新后确认保留；重新打开笔记，检查 Setext、列表和代码围栏的源码。
+2. 切换六个主题，在社区预览和工作区检查控件、警告框、标题箭头；移出标题后箭头隐藏，Tab 聚焦仍可操作。
+3. 在系统文件管理器新增、重命名、删除 Markdown 文件，保持前端可见，确认树自动更新且目录展开状态保留。
+4. 分别在正文未修改、有未保存编辑时从外部修改同一文件，验证自动加载与冲突保护；拒绝重新加载应保留编辑内容。
+
+本次自动验证覆盖预设持久化、解析选项隔离、写作语法输出、标题折叠、树刷新竞态、外部文件登记及保存冲突。

docs/development/Mermaid预览与缩放开发说明.md

@@ -0,0 +1,46 @@
+# Mermaid 预览与缩放开发说明
+
+> 本文档用于前端开发和图表渲染联调。
+>
+> 更新日期：2026-09-06。代码基线：`a5c44c4`。
+
+## 当前实现
+
+工作区和静态 Markdown 通过 `mermaidService.ts` 串行渲染，使用主题变量与 Mermaid strict 模式。工作区由 `mermaidPreview.ts` 发布当前版本预览；`DiagramInteractions.vue` 提供缩放和大图交互。
+
+- 行内按钮在悬停或键盘焦点进入时显示；触屏保留操作入口。
+- 行内中键点击 SVG 后进入滚轮缩放，移动鼠标或窗口失焦退出。
+- 大图直接使用滚轮缩放，缩放范围为 20%～500%。
+- 行内首次缩放以实际显示宽度为基准，避免受容器限制的图表跳回原始宽度。
+- 大图打开时根据原始比例与可用窗口宽高确定 100% 基准，清除旧滚动位置并居中；100% 不一定等于 SVG 原始像素宽度。
+- 滚轮增量按时间和 delta 限制，宽度变化使用 180ms 过渡；支持减少动态效果偏好。
+- 过渡期间根据鼠标位置补偿内外滚动容器。受滚动边界限制时，不能保证鼠标锚点在任意位置绝对不动。
+
+## 文字裁切的原因与修复
+
+Mermaid 的 HTML 标签放在固定尺寸的 SVG `foreignObject` 中。Milkdown 的正文段落规则会给内部 p 增加上下各 4px 内边距，导致关系标注超出文字框。工作区现在对图表内部 p 清除段落内边距和外边距，并继承图表行高、字重。
+
+大图复制 SVG 时保留 `foreignObject`，先清理嵌入 HTML，再清理整个 SVG，移除脚本及事件属性。不能为了保留标签而关闭安全清理。
+
+类图未声明方法时，其方法区为空是正常结构。排查时应先对照源码，再检查 DOM 标签、尺寸和裁切范围。
+
+## 验证方法
+
+在 frontend 目录执行：
+
+```powershell
+pnpm exec vitest run src/components/common/DiagramInteractions.spec.ts src/features/editor/diagramIntegration.spec.ts src/features/editor/mermaidPreview.spec.ts
+pnpm exec vue-tsc -b
+```
+
+使用 Vault 中“功能演示/03 Mermaid 图表集.md”手动检查：
+
+1. 检查流程图、时序图、类图、状态图、ER 图和甘特图。
+2. 类图的 1、many、contains 应完整显示；查看内部 p 的 padding 应为 0。
+3. 甘特图大图初始应完整适配；放大后可通过滚动条查看超出部分。
+4. 连续滚轮输入不应首次跳大；移动鼠标后行内滚轮模式退出。
+5. 关闭并重开大图，不保留上次滚动位置。
+
+浏览器实测中，关系标注文字高度约 16.5px，对应 16.5px 的 SVG 标签框；contains 约 24px，对应 24px 框。该结果不替代所有主题、字体、浏览器的视觉验收。
+
+相关格式范围见 [Markdown 渲染检查](Markdown渲染检查.md)。

docs/development/Plugin-Command与Settings开发说明.md

@@ -115,3 +115,9 @@ pnpm build
 阶段 D 测试覆盖注册/注销生命周期、位置过滤、参数与 Context 校验、上下文裁剪、设置影响命令执行、声明式 Secret Resolver 与越权拒绝、真实 MCP Command Target 与 Agent Tool 隔离、必填 Secret 传递、外部 Schema 引用拒绝、定长 Secret Reference、篡改引用的跨命名空间阻断、Secret 删除与卸载失败回滚、Provider/通用凭据命名空间隔离、五类设置字段、Schema 版本冲突、Secret 密文与清理、损坏存储、空 Command 列表等无效贡献文件、OpenAPI 路径、前端 Service 请求格式、Host 状态展示和动态 Secret 表单。
 
 生产构建仍会报告现有大 Chunk 警告，不影响构建成功；该问题属于前端按路由和 Markdown 依赖拆包的后续性能任务。
+
+## 2026-09-06 安装状态补充
+
+ZIP 导入和安装日志已接入。安装路径、包摘要、启用状态及 Plugin 授权可以在本地恢复；用户目录安装源与受管理 ZIP 解压目录使用不同卸载边界。功能示例包已入库，远程社区服务仍属计划。
+
+详见 [扩展安装持久化与社区包开发说明](扩展安装持久化与社区包开发说明.md)。

docs/development/performance/2026-09-06-agent-task-backend-fixed.json

@@ -0,0 +1,230 @@
+{
+  "python": "3.12.6",
+  "platform": "Windows-11-10.0.26100-SP0",
+  "provider": "mock with 50 ms injected delay per model turn; no network",
+  "results": [
+    {
+      "scenario": "agent_tool_runs",
+      "concurrency": 1,
+      "runs": 20,
+      "latency": {
+        "count": 20,
+        "median_ms": 150.79,
+        "p95_ms": 169.57,
+        "max_ms": 178.52
+      },
+      "completed": 20,
+      "ordered_events_and_replay": true,
+      "terminal_recovery": true,
+      "retained_records": 20,
+      "elapsed_ms": 3047.59,
+      "event_loop_lag": {
+        "count": 995,
+        "median_ms": 0,
+        "p95_ms": 5.65,
+        "max_ms": 21.83
+      }
+    },
+    {
+      "scenario": "agent_tool_runs",
+      "concurrency": 10,
+      "runs": 20,
+      "latency": {
+        "count": 20,
+        "median_ms": 187.48,
+        "p95_ms": 214.02,
+        "max_ms": 214.58
+      },
+      "completed": 20,
+      "ordered_events_and_replay": true,
+      "terminal_recovery": true,
+      "retained_records": 40,
+      "elapsed_ms": 514.15,
+      "event_loop_lag": {
+        "count": 192,
+        "median_ms": 0,
+        "p95_ms": 4.82,
+        "max_ms": 20.02
+      }
+    },
+    {
+      "scenario": "agent_tool_runs",
+      "concurrency": 50,
+      "runs": 50,
+      "latency": {
+        "count": 50,
+        "median_ms": 364.9,
+        "p95_ms": 366.99,
+        "max_ms": 367.3
+      },
+      "completed": 50,
+      "ordered_events_and_replay": true,
+      "terminal_recovery": true,
+      "retained_records": 90,
+      "elapsed_ms": 526.56,
+      "event_loop_lag": {
+        "count": 172,
+        "median_ms": 0,
+        "p95_ms": 4.57,
+        "max_ms": 69.89
+      }
+    },
+    {
+      "scenario": "agent_tool_runs",
+      "concurrency": 200,
+      "runs": 200,
+      "latency": {
+        "count": 200,
+        "median_ms": 1118.63,
+        "p95_ms": 1233.12,
+        "max_ms": 1237.31
+      },
+      "completed": 200,
+      "ordered_events_and_replay": true,
+      "terminal_recovery": true,
+      "retained_records": 200,
+      "elapsed_ms": 1839.2,
+      "event_loop_lag": {
+        "count": 470,
+        "median_ms": 0,
+        "p95_ms": 2.6,
+        "max_ms": 509.0
+      }
+    },
+    {
+      "scenario": "capacity_and_cancel",
+      "active_limit": 200,
+      "overflow_rejected": true,
+      "cancelled": 200,
+      "cancel_latency": {
+        "count": 200,
+        "median_ms": 7.71,
+        "p95_ms": 10.8,
+        "max_ms": 17.37
+      },
+      "elapsed_ms": 3613.48,
+      "event_loop_lag": {
+        "count": 1613,
+        "median_ms": 0,
+        "p95_ms": 0,
+        "max_ms": 7.86
+      }
+    },
+    {
+      "scenario": "permission_wait",
+      "runs": 20,
+      "approved_completed": 10,
+      "cancelled_waiting_permission": 10,
+      "subscribers_released": true,
+      "elapsed_ms": 388.83,
+      "event_loop_lag": {
+        "count": 72,
+        "median_ms": 0,
+        "p95_ms": 9.9,
+        "max_ms": 15.27
+      }
+    },
+    {
+      "scenario": "failure_and_timeout_isolation",
+      "runs": 20,
+      "success": 5,
+      "provider_errors": 5,
+      "model_timeouts": 5,
+      "tool_timeouts": 5,
+      "remaining_tool_executors": 0,
+      "elapsed_ms": 1295.29,
+      "event_loop_lag": {
+        "count": 152,
+        "median_ms": 0,
+        "p95_ms": 7.2,
+        "max_ms": 17.24
+      }
+    },
+    {
+      "scenario": "task_api_crud",
+      "tasks": 100,
+      "client_concurrency": 20,
+      "latencies": {
+        "create": {
+          "count": 100,
+          "median_ms": 214.09,
+          "p95_ms": 264.51,
+          "max_ms": 309.99
+        },
+        "update": {
+          "count": 100,
+          "median_ms": 221.48,
+          "p95_ms": 403.74,
+          "max_ms": 495.1
+        },
+        "list": {
+          "count": 1,
+          "median_ms": 7.92,
+          "p95_ms": 7.92,
+          "max_ms": 7.92
+        },
+        "delete": {
+          "count": 100,
+          "median_ms": 232.9,
+          "p95_ms": 468.48,
+          "max_ms": 475.63
+        }
+      },
+      "default_page_count": 50,
+      "default_total": 100,
+      "pagination_complete": true,
+      "final_total": 0,
+      "elapsed_ms": 3673.22,
+      "event_loop_lag": {
+        "count": 2337,
+        "median_ms": 0,
+        "p95_ms": 0,
+        "max_ms": 118.92
+      }
+    },
+    {
+      "scenario": "task_api_crud",
+      "tasks": 1000,
+      "client_concurrency": 20,
+      "latencies": {
+        "create": {
+          "count": 1000,
+          "median_ms": 200.87,
+          "p95_ms": 237.75,
+          "max_ms": 376.8
+        },
+        "update": {
+          "count": 1000,
+          "median_ms": 220.04,
+          "p95_ms": 260.19,
+          "max_ms": 300.07
+        },
+        "list": {
+          "count": 10,
+          "median_ms": 7.89,
+          "p95_ms": 9.61,
+          "max_ms": 9.61
+        },
+        "delete": {
+          "count": 1000,
+          "median_ms": 218.1,
+          "p95_ms": 266.23,
+          "max_ms": 316.14
+        }
+      },
+      "default_page_count": 50,
+      "default_total": 1000,
+      "pagination_complete": true,
+      "final_total": 0,
+      "elapsed_ms": 32562.93,
+      "event_loop_lag": {
+        "count": 24893,
+        "median_ms": 0,
+        "p95_ms": 0,
+        "max_ms": 91.85
+      }
+    }
+  ],
+  "database_bytes": 2981888,
+  "complete": true
+}

docs/development/performance/2026-09-06-agent-task-backend.json

@@ -0,0 +1,230 @@
+{
+  "python": "3.12.6",
+  "platform": "Windows-11-10.0.26100-SP0",
+  "provider": "mock with 50 ms injected delay per model turn; no network",
+  "results": [
+    {
+      "scenario": "agent_tool_runs",
+      "concurrency": 1,
+      "runs": 20,
+      "latency": {
+        "count": 20,
+        "median_ms": 146.2,
+        "p95_ms": 170.13,
+        "max_ms": 171.23
+      },
+      "completed": 20,
+      "ordered_events_and_replay": true,
+      "terminal_recovery": true,
+      "retained_records": 20,
+      "elapsed_ms": 3041.03,
+      "event_loop_lag": {
+        "count": 190,
+        "median_ms": 5.64,
+        "p95_ms": 16.81,
+        "max_ms": 26.84
+      }
+    },
+    {
+      "scenario": "agent_tool_runs",
+      "concurrency": 10,
+      "runs": 20,
+      "latency": {
+        "count": 20,
+        "median_ms": 405.75,
+        "p95_ms": 505.74,
+        "max_ms": 539.28
+      },
+      "completed": 20,
+      "ordered_events_and_replay": true,
+      "terminal_recovery": true,
+      "retained_records": 40,
+      "elapsed_ms": 1045.19,
+      "event_loop_lag": {
+        "count": 15,
+        "median_ms": 57.63,
+        "p95_ms": 136.71,
+        "max_ms": 136.71
+      }
+    },
+    {
+      "scenario": "agent_tool_runs",
+      "concurrency": 50,
+      "runs": 50,
+      "latency": {
+        "count": 50,
+        "median_ms": 2234.45,
+        "p95_ms": 2304.42,
+        "max_ms": 2307.54
+      },
+      "completed": 50,
+      "ordered_events_and_replay": true,
+      "terminal_recovery": true,
+      "retained_records": 90,
+      "elapsed_ms": 2552.49,
+      "event_loop_lag": {
+        "count": 8,
+        "median_ms": 345.24,
+        "p95_ms": 798.84,
+        "max_ms": 798.84
+      }
+    },
+    {
+      "scenario": "agent_tool_runs",
+      "concurrency": 200,
+      "runs": 200,
+      "latency": {
+        "count": 200,
+        "median_ms": 10262.47,
+        "p95_ms": 10554.52,
+        "max_ms": 10584.03
+      },
+      "completed": 200,
+      "ordered_events_and_replay": true,
+      "terminal_recovery": true,
+      "retained_records": 200,
+      "elapsed_ms": 11442.28,
+      "event_loop_lag": {
+        "count": 8,
+        "median_ms": 1647.87,
+        "p95_ms": 3559.97,
+        "max_ms": 3559.97
+      }
+    },
+    {
+      "scenario": "capacity_and_cancel",
+      "active_limit": 200,
+      "overflow_rejected": true,
+      "cancelled": 200,
+      "cancel_latency": {
+        "count": 200,
+        "median_ms": 4.32,
+        "p95_ms": 5.36,
+        "max_ms": 8.27
+      },
+      "elapsed_ms": 3645.04,
+      "event_loop_lag": {
+        "count": 3,
+        "median_ms": 14.04,
+        "p95_ms": 3610.52,
+        "max_ms": 3610.52
+      }
+    },
+    {
+      "scenario": "permission_wait",
+      "runs": 20,
+      "approved_completed": 10,
+      "cancelled_waiting_permission": 10,
+      "subscribers_released": true,
+      "elapsed_ms": 971.64,
+      "event_loop_lag": {
+        "count": 11,
+        "median_ms": 49.09,
+        "p95_ms": 314.46,
+        "max_ms": 314.46
+      }
+    },
+    {
+      "scenario": "failure_and_timeout_isolation",
+      "runs": 20,
+      "success": 5,
+      "provider_errors": 5,
+      "model_timeouts": 5,
+      "tool_timeouts": 5,
+      "remaining_tool_executors": 0,
+      "elapsed_ms": 1531.14,
+      "event_loop_lag": {
+        "count": 83,
+        "median_ms": 5.17,
+        "p95_ms": 27.82,
+        "max_ms": 255.96
+      }
+    },
+    {
+      "scenario": "task_api_crud",
+      "tasks": 100,
+      "client_concurrency": 20,
+      "latencies": {
+        "create": {
+          "count": 100,
+          "median_ms": 5.37,
+          "p95_ms": 34.16,
+          "max_ms": 61.99
+        },
+        "update": {
+          "count": 100,
+          "median_ms": 7.22,
+          "p95_ms": 35.0,
+          "max_ms": 96.33
+        },
+        "list": {
+          "count": 1,
+          "median_ms": 3.73,
+          "p95_ms": 3.73,
+          "max_ms": 3.73
+        },
+        "delete": {
+          "count": 100,
+          "median_ms": 5.44,
+          "p95_ms": 14.57,
+          "max_ms": 36.43
+        }
+      },
+      "default_page_count": 50,
+      "default_total": 100,
+      "pagination_complete": true,
+      "final_total": 0,
+      "elapsed_ms": 2532.22,
+      "event_loop_lag": {
+        "count": 4,
+        "median_ms": 776.23,
+        "p95_ms": 1712.81,
+        "max_ms": 1712.81
+      }
+    },
+    {
+      "scenario": "task_api_crud",
+      "tasks": 1000,
+      "client_concurrency": 20,
+      "latencies": {
+        "create": {
+          "count": 1000,
+          "median_ms": 5.18,
+          "p95_ms": 32.23,
+          "max_ms": 43.29
+        },
+        "update": {
+          "count": 1000,
+          "median_ms": 6.51,
+          "p95_ms": 14.72,
+          "max_ms": 90.27
+        },
+        "list": {
+          "count": 10,
+          "median_ms": 5.48,
+          "p95_ms": 6.18,
+          "max_ms": 6.18
+        },
+        "delete": {
+          "count": 1000,
+          "median_ms": 4.76,
+          "p95_ms": 8.42,
+          "max_ms": 97.64
+        }
+      },
+      "default_page_count": 50,
+      "default_total": 1000,
+      "pagination_complete": true,
+      "final_total": 0,
+      "elapsed_ms": 21242.37,
+      "event_loop_lag": {
+        "count": 4,
+        "median_ms": 6932.7,
+        "p95_ms": 14260.46,
+        "max_ms": 14260.46
+      }
+    }
+  ],
+  "database_bytes": 2949120,
+  "complete": true
+}

docs/development/performance/2026-09-06-agent-task-ui.json

@@ -0,0 +1,706 @@
+[
+  {
+    "kind": "tasks",
+    "theme": "light",
+    "size": 100,
+    "initialRenderMs": 33.099999994039536,
+    "requests": [
+      "/api/tasks"
+    ],
+    "initialTaskCount": 50,
+    "fullListRenderMs": 79.09999999403954,
+    "fullListIsInjected": true,
+    "domNodes": 1107,
+    "frameGapsMs": {
+      "median": 10,
+      "p95": 10.100000000000364,
+      "max": 69.49999999403951
+    },
+    "frames": 407,
+    "longTasks": [],
+    "scrollTop": 0,
+    "scrollHeight": 11702,
+    "maxScrollTop": 10845,
+    "filteredCount": 34,
+    "expectedFilteredCount": 34,
+    "filterMs": 16.299999982118607,
+    "repeat": 1
+  },
+  {
+    "kind": "tasks",
+    "theme": "light",
+    "size": 1000,
+    "initialRenderMs": 4.4000000059604645,
+    "requests": [
+      "/api/tasks"
+    ],
+    "initialTaskCount": 50,
+    "fullListRenderMs": 117.39999997615814,
+    "fullListIsInjected": true,
+    "domNodes": 11007,
+    "frameGapsMs": {
+      "median": 20.099999999999454,
+      "p95": 30.199999999999818,
+      "max": 50
+    },
+    "frames": 353,
+    "longTasks": [],
+    "scrollTop": 54000,
+    "scrollHeight": 115652,
+    "maxScrollTop": 81000,
+    "filteredCount": 334,
+    "expectedFilteredCount": 334,
+    "filterMs": 44.10000002384186,
+    "repeat": 1
+  },
+  {
+    "kind": "tasks",
+    "theme": "dark",
+    "size": 100,
+    "initialRenderMs": 30.900000005960464,
+    "requests": [
+      "/api/tasks"
+    ],
+    "initialTaskCount": 50,
+    "fullListRenderMs": 78.2999999821186,
+    "fullListIsInjected": true,
+    "domNodes": 1107,
+    "frameGapsMs": {
+      "median": 10,
+      "p95": 10.100000000000364,
+      "max": 49.69999998807907
+    },
+    "frames": 411,
+    "longTasks": [],
+    "scrollTop": 0,
+    "scrollHeight": 11702,
+    "maxScrollTop": 10845,
+    "filteredCount": 34,
+    "expectedFilteredCount": 34,
+    "filterMs": 16.099999994039536,
+    "repeat": 1
+  },
+  {
+    "kind": "tasks",
+    "theme": "dark",
+    "size": 1000,
+    "initialRenderMs": 5,
+    "requests": [
+      "/api/tasks"
+    ],
+    "initialTaskCount": 50,
+    "fullListRenderMs": 137.7999999821186,
+    "fullListIsInjected": true,
+    "domNodes": 11007,
+    "frameGapsMs": {
+      "median": 20,
+      "p95": 30.199999999999818,
+      "max": 40.19999999999982
+    },
+    "frames": 360,
+    "longTasks": [],
+    "scrollTop": 54000,
+    "scrollHeight": 115652,
+    "maxScrollTop": 81000,
+    "filteredCount": 334,
+    "expectedFilteredCount": 334,
+    "filterMs": 47.79999998211861,
+    "repeat": 1
+  },
+  {
+    "kind": "tasks",
+    "theme": "paper-moments",
+    "size": 100,
+    "initialRenderMs": 38.099999994039536,
+    "requests": [
+      "/api/tasks"
+    ],
+    "initialTaskCount": 50,
+    "fullListRenderMs": 116.09999999403954,
+    "fullListIsInjected": true,
+    "domNodes": 1107,
+    "frameGapsMs": {
+      "median": 10,
+      "p95": 20,
+      "max": 59.900000000000034
+    },
+    "frames": 387,
+    "longTasks": [],
+    "scrollTop": 0,
+    "scrollHeight": 11764,
+    "maxScrollTop": 10907,
+    "filteredCount": 34,
+    "expectedFilteredCount": 34,
+    "filterMs": 11.600000023841858,
+    "repeat": 1
+  },
+  {
+    "kind": "tasks",
+    "theme": "paper-moments",
+    "size": 1000,
+    "initialRenderMs": 5.800000011920929,
+    "requests": [
+      "/api/tasks"
+    ],
+    "initialTaskCount": 50,
+    "fullListRenderMs": 150,
+    "fullListIsInjected": true,
+    "domNodes": 11007,
+    "frameGapsMs": {
+      "median": 10.100000000000364,
+      "p95": 50.100000000000364,
+      "max": 80
+    },
+    "frames": 368,
+    "longTasks": [],
+    "scrollTop": 54000,
+    "scrollHeight": 115714,
+    "maxScrollTop": 81000,
+    "filteredCount": 334,
+    "expectedFilteredCount": 334,
+    "filterMs": 59.5,
+    "repeat": 1
+  },
+  {
+    "kind": "trace",
+    "theme": "light",
+    "size": 200,
+    "initialRenderMs": 75.10000002384186,
+    "requests": [],
+    "domNodes": 2092,
+    "scrollContainers": [
+      {
+        "node": "HTML",
+        "height": 905,
+        "scrollHeight": 905,
+        "overflow": "hidden",
+        "position": "static"
+      },
+      {
+        "node": "BODY",
+        "height": 905,
+        "scrollHeight": 905,
+        "overflow": "hidden",
+        "position": "static"
+      },
+      {
+        "node": "viewport",
+        "height": 905,
+        "scrollHeight": 18853,
+        "overflow": "auto",
+        "position": "static"
+      },
+      {
+        "node": "app",
+        "height": 18853,
+        "scrollHeight": 18853,
+        "overflow": "visible",
+        "position": "static"
+      },
+      {
+        "node": "trace-visualization",
+        "height": 18805,
+        "scrollHeight": 18805,
+        "overflow": "visible",
+        "position": "static"
+      },
+      {
+        "node": "timeline-view",
+        "height": 16692,
+        "scrollHeight": 16692,
+        "overflow": "visible",
+        "position": "static"
+      },
+      {
+        "node": "timeline",
+        "height": 16692,
+        "scrollHeight": 16692,
+        "overflow": "visible",
+        "position": "relative"
+      }
+    ],
+    "frameGapsMs": {
+      "median": 10,
+      "p95": 10.100000000000364,
+      "max": 40.00000000000003
+    },
+    "frames": 411,
+    "longTasks": [],
+    "scrollTop": 0,
+    "scrollHeight": 18853,
+    "maxScrollTop": 17948,
+    "filteredDomNodes": 436,
+    "filteredCount": 44,
+    "expectedFilteredCount": 44,
+    "filterMs": 16,
+    "treeSwitchMs": 32.099999994039536,
+    "treeFilterMs": 27.900000005960464,
+    "treeFilteredDomNodes": 689,
+    "repeat": 1
+  },
+  {
+    "kind": "trace",
+    "theme": "light",
+    "size": 2000,
+    "initialRenderMs": 283.7999999821186,
+    "requests": [],
+    "domNodes": 20542,
+    "scrollContainers": [
+      {
+        "node": "HTML",
+        "height": 905,
+        "scrollHeight": 905,
+        "overflow": "hidden",
+        "position": "static"
+      },
+      {
+        "node": "BODY",
+        "height": 905,
+        "scrollHeight": 905,
+        "overflow": "hidden",
+        "position": "static"
+      },
+      {
+        "node": "viewport",
+        "height": 905,
+        "scrollHeight": 184678,
+        "overflow": "auto",
+        "position": "static"
+      },
+      {
+        "node": "app",
+        "height": 184678,
+        "scrollHeight": 184678,
+        "overflow": "visible",
+        "position": "static"
+      },
+      {
+        "node": "trace-visualization",
+        "height": 184630,
+        "scrollHeight": 184630,
+        "overflow": "visible",
+        "position": "static"
+      },
+      {
+        "node": "timeline-view",
+        "height": 166992,
+        "scrollHeight": 166992,
+        "overflow": "visible",
+        "position": "static"
+      },
+      {
+        "node": "timeline",
+        "height": 166992,
+        "scrollHeight": 166992,
+        "overflow": "visible",
+        "position": "relative"
+      }
+    ],
+    "frameGapsMs": {
+      "median": 10,
+      "p95": 10.100000000000364,
+      "max": 20.100000000000023
+    },
+    "frames": 491,
+    "longTasks": [],
+    "scrollTop": 54000,
+    "scrollHeight": 184678,
+    "maxScrollTop": 81000,
+    "filteredDomNodes": 4036,
+    "filteredCount": 444,
+    "expectedFilteredCount": 444,
+    "filterMs": 97.40000000596046,
+    "treeSwitchMs": 64,
+    "treeFilterMs": 617.1999999880791,
+    "treeFilteredDomNodes": 6539,
+    "repeat": 1
+  },
+  {
+    "kind": "trace",
+    "theme": "dark",
+    "size": 200,
+    "initialRenderMs": 81.5,
+    "requests": [],
+    "domNodes": 2092,
+    "scrollContainers": [
+      {
+        "node": "HTML",
+        "height": 905,
+        "scrollHeight": 905,
+        "overflow": "hidden",
+        "position": "static"
+      },
+      {
+        "node": "BODY",
+        "height": 905,
+        "scrollHeight": 905,
+        "overflow": "hidden",
+        "position": "static"
+      },
+      {
+        "node": "viewport",
+        "height": 905,
+        "scrollHeight": 18853,
+        "overflow": "auto",
+        "position": "static"
+      },
+      {
+        "node": "app",
+        "height": 18853,
+        "scrollHeight": 18853,
+        "overflow": "visible",
+        "position": "static"
+      },
+      {
+        "node": "trace-visualization",
+        "height": 18805,
+        "scrollHeight": 18805,
+        "overflow": "visible",
+        "position": "static"
+      },
+      {
+        "node": "timeline-view",
+        "height": 16692,
+        "scrollHeight": 16692,
+        "overflow": "visible",
+        "position": "static"
+      },
+      {
+        "node": "timeline",
+        "height": 16692,
+        "scrollHeight": 16692,
+        "overflow": "visible",
+        "position": "relative"
+      }
+    ],
+    "frameGapsMs": {
+      "median": 10,
+      "p95": 10.100000000000364,
+      "max": 30
+    },
+    "frames": 415,
+    "longTasks": [],
+    "scrollTop": 0,
+    "scrollHeight": 18853,
+    "maxScrollTop": 17948,
+    "filteredDomNodes": 436,
+    "filteredCount": 44,
+    "expectedFilteredCount": 44,
+    "filterMs": 16.69999998807907,
+    "treeSwitchMs": 31.099999994039536,
+    "treeFilterMs": 28.900000005960464,
+    "treeFilteredDomNodes": 689,
+    "repeat": 1
+  },
+  {
+    "kind": "trace",
+    "theme": "dark",
+    "size": 2000,
+    "initialRenderMs": 289,
+    "requests": [],
+    "domNodes": 20542,
+    "scrollContainers": [
+      {
+        "node": "HTML",
+        "height": 905,
+        "scrollHeight": 905,
+        "overflow": "hidden",
+        "position": "static"
+      },
+      {
+        "node": "BODY",
+        "height": 905,
+        "scrollHeight": 905,
+        "overflow": "hidden",
+        "position": "static"
+      },
+      {
+        "node": "viewport",
+        "height": 905,
+        "scrollHeight": 184678,
+        "overflow": "auto",
+        "position": "static"
+      },
+      {
+        "node": "app",
+        "height": 184678,
+        "scrollHeight": 184678,
+        "overflow": "visible",
+        "position": "static"
+      },
+      {
+        "node": "trace-visualization",
+        "height": 184630,
+        "scrollHeight": 184630,
+        "overflow": "visible",
+        "position": "static"
+      },
+      {
+        "node": "timeline-view",
+        "height": 166992,
+        "scrollHeight": 166992,
+        "overflow": "visible",
+        "position": "static"
+      },
+      {
+        "node": "timeline",
+        "height": 166992,
+        "scrollHeight": 166992,
+        "overflow": "visible",
+        "position": "relative"
+      }
+    ],
+    "frameGapsMs": {
+      "median": 10,
+      "p95": 10.100000000000364,
+      "max": 20.200000000000045
+    },
+    "frames": 487,
+    "longTasks": [],
+    "scrollTop": 54000,
+    "scrollHeight": 184678,
+    "maxScrollTop": 81000,
+    "filteredDomNodes": 4036,
+    "filteredCount": 444,
+    "expectedFilteredCount": 444,
+    "filterMs": 74.5,
+    "treeSwitchMs": 62.900000005960464,
+    "treeFilterMs": 483,
+    "treeFilteredDomNodes": 6539,
+    "repeat": 1
+  },
+  {
+    "kind": "trace",
+    "theme": "paper-moments",
+    "size": 200,
+    "initialRenderMs": 119.59999999403954,
+    "requests": [],
+    "domNodes": 2092,
+    "scrollContainers": [
+      {
+        "node": "HTML",
+        "height": 905,
+        "scrollHeight": 905,
+        "overflow": "hidden",
+        "position": "static"
+      },
+      {
+        "node": "BODY",
+        "height": 905,
+        "scrollHeight": 905,
+        "overflow": "hidden",
+        "position": "static"
+      },
+      {
+        "node": "viewport",
+        "height": 905,
+        "scrollHeight": 18853,
+        "overflow": "auto",
+        "position": "static"
+      },
+      {
+        "node": "app",
+        "height": 18853,
+        "scrollHeight": 18853,
+        "overflow": "visible",
+        "position": "static"
+      },
+      {
+        "node": "trace-visualization",
+        "height": 18805,
+        "scrollHeight": 18805,
+        "overflow": "visible",
+        "position": "static"
+      },
+      {
+        "node": "timeline-view",
+        "height": 16692,
+        "scrollHeight": 16692,
+        "overflow": "visible",
+        "position": "static"
+      },
+      {
+        "node": "timeline",
+        "height": 16692,
+        "scrollHeight": 16692,
+        "overflow": "visible",
+        "position": "relative"
+      }
+    ],
+    "frameGapsMs": {
+      "median": 10,
+      "p95": 20,
+      "max": 89.99999999999997
+    },
+    "frames": 394,
+    "longTasks": [],
+    "scrollTop": 0,
+    "scrollHeight": 18853,
+    "maxScrollTop": 17948,
+    "filteredDomNodes": 436,
+    "filteredCount": 44,
+    "expectedFilteredCount": 44,
+    "filterMs": 19.700000017881393,
+    "treeSwitchMs": 40.10000002384186,
+    "treeFilterMs": 19.899999976158142,
+    "treeFilteredDomNodes": 689,
+    "repeat": 1
+  },
+  {
+    "kind": "trace",
+    "theme": "paper-moments",
+    "size": 2000,
+    "initialRenderMs": 337.2999999821186,
+    "requests": [],
+    "domNodes": 20542,
+    "scrollContainers": [
+      {
+        "node": "HTML",
+        "height": 905,
+        "scrollHeight": 905,
+        "overflow": "hidden",
+        "position": "static"
+      },
+      {
+        "node": "BODY",
+        "height": 905,
+        "scrollHeight": 905,
+        "overflow": "hidden",
+        "position": "static"
+      },
+      {
+        "node": "viewport",
+        "height": 905,
+        "scrollHeight": 184678,
+        "overflow": "auto",
+        "position": "static"
+      },
+      {
+        "node": "app",
+        "height": 184678,
+        "scrollHeight": 184678,
+        "overflow": "visible",
+        "position": "static"
+      },
+      {
+        "node": "trace-visualization",
+        "height": 184630,
+        "scrollHeight": 184630,
+        "overflow": "visible",
+        "position": "static"
+      },
+      {
+        "node": "timeline-view",
+        "height": 166992,
+        "scrollHeight": 166992,
+        "overflow": "visible",
+        "position": "static"
+      },
+      {
+        "node": "timeline",
+        "height": 166992,
+        "scrollHeight": 166992,
+        "overflow": "visible",
+        "position": "relative"
+      }
+    ],
+    "frameGapsMs": {
+      "median": 10,
+      "p95": 20.100000000000023,
+      "max": 30.100000000000023
+    },
+    "frames": 416,
+    "longTasks": [],
+    "scrollTop": 54000,
+    "scrollHeight": 184678,
+    "maxScrollTop": 81000,
+    "filteredDomNodes": 4036,
+    "filteredCount": 444,
+    "expectedFilteredCount": 444,
+    "filterMs": 86.2999999821186,
+    "treeSwitchMs": 62.099999994039536,
+    "treeFilterMs": 540.0999999940395,
+    "treeFilteredDomNodes": 6539,
+    "repeat": 1
+  },
+  {
+    "kind": "trace",
+    "theme": "paper-moments",
+    "size": 10000,
+    "initialRenderMs": 1803.9000000059605,
+    "requests": [],
+    "domNodes": 102542,
+    "scrollContainers": [
+      {
+        "node": "HTML",
+        "height": 905,
+        "scrollHeight": 905,
+        "overflow": "hidden",
+        "position": "static"
+      },
+      {
+        "node": "BODY",
+        "height": 905,
+        "scrollHeight": 905,
+        "overflow": "hidden",
+        "position": "static"
+      },
+      {
+        "node": "viewport",
+        "height": 905,
+        "scrollHeight": 921678,
+        "overflow": "auto",
+        "position": "static"
+      },
+      {
+        "node": "app",
+        "height": 921678,
+        "scrollHeight": 921678,
+        "overflow": "visible",
+        "position": "static"
+      },
+      {
+        "node": "trace-visualization",
+        "height": 921630,
+        "scrollHeight": 921630,
+        "overflow": "visible",
+        "position": "static"
+      },
+      {
+        "node": "timeline-view",
+        "height": 834992,
+        "scrollHeight": 834992,
+        "overflow": "visible",
+        "position": "static"
+      },
+      {
+        "node": "timeline",
+        "height": 834992,
+        "scrollHeight": 834992,
+        "overflow": "visible",
+        "position": "relative"
+      }
+    ],
+    "frameGapsMs": {
+      "median": 20.100000000000364,
+      "p95": 40,
+      "max": 100
+    },
+    "frames": 357,
+    "longTasks": [
+      82,
+      53
+    ],
+    "scrollTop": 54000,
+    "scrollHeight": 921678,
+    "maxScrollTop": 81000,
+    "filteredDomNodes": 40036,
+    "filteredCount": 4444,
+    "expectedFilteredCount": 4444,
+    "filterMs": 582.7999999821186,
+    "treeSwitchMs": 317.5,
+    "treeFilterMs": 25914.80000001192,
+    "treeFilteredDomNodes": 32539,
+    "repeat": 1
+  }
+]

docs/development/performance/2026-09-06-agent-trace-ui-fixed.json

@@ -0,0 +1,156 @@
+[
+  {
+    "kind": "trace",
+    "theme": "paper-moments",
+    "size": 2000,
+    "initialRenderMs": 117.19999998807907,
+    "requests": [],
+    "domNodes": 1852,
+    "scrollContainers": [
+      {
+        "node": "HTML",
+        "height": 905,
+        "scrollHeight": 905,
+        "overflow": "hidden",
+        "position": "static"
+      },
+      {
+        "node": "BODY",
+        "height": 905,
+        "scrollHeight": 905,
+        "overflow": "hidden",
+        "position": "static"
+      },
+      {
+        "node": "viewport",
+        "height": 905,
+        "scrollHeight": 17214,
+        "overflow": "auto",
+        "position": "static"
+      },
+      {
+        "node": "app",
+        "height": 17214,
+        "scrollHeight": 17214,
+        "overflow": "visible",
+        "position": "static"
+      },
+      {
+        "node": "trace-visualization",
+        "height": 17166,
+        "scrollHeight": 17166,
+        "overflow": "visible",
+        "position": "static"
+      },
+      {
+        "node": "timeline-view",
+        "height": 16692,
+        "scrollHeight": 16692,
+        "overflow": "visible",
+        "position": "static"
+      },
+      {
+        "node": "timeline",
+        "height": 16692,
+        "scrollHeight": 16692,
+        "overflow": "visible",
+        "position": "relative"
+      }
+    ],
+    "frameGapsMs": {
+      "median": 10,
+      "p95": 10.100000000000364,
+      "max": 80.09999999999997
+    },
+    "frames": 408,
+    "longTasks": [],
+    "scrollTop": 0,
+    "scrollHeight": 17214,
+    "maxScrollTop": 16309,
+    "filteredDomNodes": 1844,
+    "filteredCount": 200,
+    "expectedFilteredCount": 200,
+    "filterMs": 71.90000000596046,
+    "treeSwitchMs": 51.400000005960464,
+    "treeFilterMs": 48.70000001788139,
+    "treeFilteredDomNodes": 1343,
+    "repeat": 1
+  },
+  {
+    "kind": "trace",
+    "theme": "paper-moments",
+    "size": 10000,
+    "initialRenderMs": 94.40000000596046,
+    "requests": [],
+    "domNodes": 1852,
+    "scrollContainers": [
+      {
+        "node": "HTML",
+        "height": 905,
+        "scrollHeight": 905,
+        "overflow": "hidden",
+        "position": "static"
+      },
+      {
+        "node": "BODY",
+        "height": 905,
+        "scrollHeight": 905,
+        "overflow": "hidden",
+        "position": "static"
+      },
+      {
+        "node": "viewport",
+        "height": 905,
+        "scrollHeight": 17214,
+        "overflow": "auto",
+        "position": "static"
+      },
+      {
+        "node": "app",
+        "height": 17214,
+        "scrollHeight": 17214,
+        "overflow": "visible",
+        "position": "static"
+      },
+      {
+        "node": "trace-visualization",
+        "height": 17166,
+        "scrollHeight": 17166,
+        "overflow": "visible",
+        "position": "static"
+      },
+      {
+        "node": "timeline-view",
+        "height": 16692,
+        "scrollHeight": 16692,
+        "overflow": "visible",
+        "position": "static"
+      },
+      {
+        "node": "timeline",
+        "height": 16692,
+        "scrollHeight": 16692,
+        "overflow": "visible",
+        "position": "relative"
+      }
+    ],
+    "frameGapsMs": {
+      "median": 10,
+      "p95": 10.100000000000364,
+      "max": 50.09999999999991
+    },
+    "frames": 414,
+    "longTasks": [],
+    "scrollTop": 0,
+    "scrollHeight": 17214,
+    "maxScrollTop": 16309,
+    "filteredDomNodes": 1844,
+    "filteredCount": 200,
+    "expectedFilteredCount": 200,
+    "filterMs": 284.90000000596046,
+    "treeSwitchMs": 100.90000000596046,
+    "treeFilterMs": 189.19999998807907,
+    "treeFilteredDomNodes": 1343,
+    "repeat": 1
+  }
+]

docs/development/performance/2026-09-06-long-document-after.json

@@ -0,0 +1,380 @@
+[
+  {
+    "requestedHan": 25000,
+    "hanCharacters": 25632,
+    "sourceCharacters": 35728,
+    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) HeadlessChrome/152.0.0.0 Safari/537.36",
+    "viewport": [
+      1424,
+      905
+    ],
+    "openMs": 379.09999999403954,
+    "domNodes": 2110,
+    "selectionMs": {
+      "median": 0.4000000059604645,
+      "p95": 0.7000000178813934,
+      "max": 1.300000011920929
+    },
+    "insertMs": {
+      "median": 6.300000011920929,
+      "p95": 9.599999994039536,
+      "max": 10.400000005960464
+    },
+    "foldMs": {
+      "median": 42.900000005960464,
+      "p95": 45.599999994039536,
+      "max": 45.599999994039536
+    },
+    "integrity": true,
+    "previewMs": [
+      176.30000001192093,
+      22.69999998807907,
+      19.80000001192093
+    ],
+    "previewNodes": 1058,
+    "longTasks": {
+      "count": 4,
+      "median": 91,
+      "p95": 359,
+      "max": 359
+    },
+    "heapUsedBytes": 36560189,
+    "repeat": 1
+  },
+  {
+    "requestedHan": 25000,
+    "hanCharacters": 25632,
+    "sourceCharacters": 35728,
+    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) HeadlessChrome/152.0.0.0 Safari/537.36",
+    "viewport": [
+      1424,
+      905
+    ],
+    "openMs": 218.59999999403954,
+    "domNodes": 2110,
+    "selectionMs": {
+      "median": 0.29999998211860657,
+      "p95": 0.5,
+      "max": 0.5
+    },
+    "insertMs": {
+      "median": 4.799999982118607,
+      "p95": 6.9000000059604645,
+      "max": 7.699999988079071
+    },
+    "foldMs": {
+      "median": 45.30000001192093,
+      "p95": 79,
+      "max": 79
+    },
+    "integrity": true,
+    "previewMs": [
+      112.90000000596046,
+      27.80000001192093,
+      25.399999976158142
+    ],
+    "previewNodes": 1058,
+    "longTasks": {
+      "count": 5,
+      "median": 65,
+      "p95": 198,
+      "max": 198
+    },
+    "heapUsedBytes": 78394355,
+    "repeat": 2
+  },
+  {
+    "requestedHan": 25000,
+    "hanCharacters": 25632,
+    "sourceCharacters": 35728,
+    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) HeadlessChrome/152.0.0.0 Safari/537.36",
+    "viewport": [
+      1424,
+      905
+    ],
+    "openMs": 207.59999999403954,
+    "domNodes": 2110,
+    "selectionMs": {
+      "median": 0.4000000059604645,
+      "p95": 0.5999999940395355,
+      "max": 0.699999988079071
+    },
+    "insertMs": {
+      "median": 4.600000023841858,
+      "p95": 5.9000000059604645,
+      "max": 6.800000011920929
+    },
+    "foldMs": {
+      "median": 35.900000005960464,
+      "p95": 45.400000005960464,
+      "max": 45.400000005960464
+    },
+    "integrity": true,
+    "previewMs": [
+      98.30000001192093,
+      29.69999998807907,
+      29.80000001192093
+    ],
+    "previewNodes": 1058,
+    "longTasks": {
+      "count": 4,
+      "median": 59,
+      "p95": 184,
+      "max": 184
+    },
+    "heapUsedBytes": 72765231,
+    "repeat": 3
+  },
+  {
+    "requestedHan": 60000,
+    "hanCharacters": 61172,
+    "sourceCharacters": 85716,
+    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) HeadlessChrome/152.0.0.0 Safari/537.36",
+    "viewport": [
+      1424,
+      905
+    ],
+    "openMs": 394.30000001192093,
+    "domNodes": 4720,
+    "selectionMs": {
+      "median": 0.4000000059604645,
+      "p95": 0.6000000238418579,
+      "max": 0.699999988079071
+    },
+    "insertMs": {
+      "median": 6.300000011920929,
+      "p95": 7.799999982118607,
+      "max": 13.599999994039536
+    },
+    "foldMs": {
+      "median": 95.80000001192093,
+      "p95": 145.5,
+      "max": 145.5
+    },
+    "integrity": true,
+    "previewMs": [
+      180.59999999403954,
+      61.20000001788139,
+      50
+    ],
+    "previewNodes": 2560,
+    "longTasks": {
+      "count": 10,
+      "median": 103,
+      "p95": 358,
+      "max": 358
+    },
+    "heapUsedBytes": 73234300,
+    "repeat": 1
+  },
+  {
+    "requestedHan": 60000,
+    "hanCharacters": 61172,
+    "sourceCharacters": 85716,
+    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) HeadlessChrome/152.0.0.0 Safari/537.36",
+    "viewport": [
+      1424,
+      905
+    ],
+    "openMs": 447.5,
+    "domNodes": 4720,
+    "selectionMs": {
+      "median": 0.4000000059604645,
+      "p95": 0.5999999940395355,
+      "max": 0.5999999940395355
+    },
+    "insertMs": {
+      "median": 6.699999988079071,
+      "p95": 12.699999988079071,
+      "max": 14.5
+    },
+    "foldMs": {
+      "median": 99.5,
+      "p95": 110.40000000596046,
+      "max": 110.40000000596046
+    },
+    "integrity": true,
+    "previewMs": [
+      153,
+      44.900000005960464,
+      49.400000005960464
+    ],
+    "previewNodes": 2560,
+    "longTasks": {
+      "count": 9,
+      "median": 113,
+      "p95": 410,
+      "max": 410
+    },
+    "heapUsedBytes": 97026266,
+    "repeat": 2
+  },
+  {
+    "requestedHan": 60000,
+    "hanCharacters": 61172,
+    "sourceCharacters": 85716,
+    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) HeadlessChrome/152.0.0.0 Safari/537.36",
+    "viewport": [
+      1424,
+      905
+    ],
+    "openMs": 492.69999998807907,
+    "domNodes": 4720,
+    "selectionMs": {
+      "median": 0.5,
+      "p95": 0.6000000238418579,
+      "max": 1
+    },
+    "insertMs": {
+      "median": 7.199999988079071,
+      "p95": 9.599999994039536,
+      "max": 10.100000023841858
+    },
+    "foldMs": {
+      "median": 115.80000001192093,
+      "p95": 149.7000000178814,
+      "max": 149.7000000178814
+    },
+    "integrity": true,
+    "previewMs": [
+      141.39999997615814,
+      67.5,
+      61.900000005960464
+    ],
+    "previewNodes": 2560,
+    "longTasks": {
+      "count": 11,
+      "median": 109,
+      "p95": 445,
+      "max": 445
+    },
+    "heapUsedBytes": 88746335,
+    "repeat": 3
+  },
+  {
+    "requestedHan": 120000,
+    "hanCharacters": 122322,
+    "sourceCharacters": 171613,
+    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) HeadlessChrome/152.0.0.0 Safari/537.36",
+    "viewport": [
+      1424,
+      905
+    ],
+    "openMs": 893.4000000059605,
+    "domNodes": 9139,
+    "selectionMs": {
+      "median": 0.7000000178813934,
+      "p95": 1.2000000178813934,
+      "max": 2.399999976158142
+    },
+    "insertMs": {
+      "median": 18,
+      "p95": 28.900000005960464,
+      "max": 31.5
+    },
+    "foldMs": {
+      "median": 217,
+      "p95": 292.90000000596046,
+      "max": 292.90000000596046
+    },
+    "integrity": true,
+    "previewMs": [
+      203.10000002384186,
+      98.7999999821186,
+      92.30000001192093
+    ],
+    "previewNodes": 5117,
+    "longTasks": {
+      "count": 13,
+      "median": 199,
+      "p95": 796,
+      "max": 796
+    },
+    "heapUsedBytes": 113890741,
+    "repeat": 1
+  },
+  {
+    "requestedHan": 120000,
+    "hanCharacters": 122322,
+    "sourceCharacters": 171613,
+    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) HeadlessChrome/152.0.0.0 Safari/537.36",
+    "viewport": [
+      1424,
+      905
+    ],
+    "openMs": 869.0999999940395,
+    "domNodes": 9139,
+    "selectionMs": {
+      "median": 0.7000000178813934,
+      "p95": 1.300000011920929,
+      "max": 3.4000000059604645
+    },
+    "insertMs": {
+      "median": 16.69999998807907,
+      "p95": 22.599999994039536,
+      "max": 22.80000001192093
+    },
+    "foldMs": {
+      "median": 220.5,
+      "p95": 263.09999999403954,
+      "max": 263.09999999403954
+    },
+    "integrity": true,
+    "previewMs": [
+      207.39999997615814,
+      98.7000000178814,
+      90.2999999821186
+    ],
+    "previewNodes": 5117,
+    "longTasks": {
+      "count": 14,
+      "median": 205,
+      "p95": 780,
+      "max": 780
+    },
+    "heapUsedBytes": 125636820,
+    "repeat": 2
+  },
+  {
+    "requestedHan": 120000,
+    "hanCharacters": 122322,
+    "sourceCharacters": 171613,
+    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) HeadlessChrome/152.0.0.0 Safari/537.36",
+    "viewport": [
+      1424,
+      905
+    ],
+    "openMs": 845.9000000059605,
+    "domNodes": 9139,
+    "selectionMs": {
+      "median": 0.699999988079071,
+      "p95": 1.0999999940395355,
+      "max": 2.9000000059604645
+    },
+    "insertMs": {
+      "median": 18.69999998807907,
+      "p95": 27.19999998807907,
+      "max": 35
+    },
+    "foldMs": {
+      "median": 205.7000000178814,
+      "p95": 263.90000000596046,
+      "max": 263.90000000596046
+    },
+    "integrity": true,
+    "previewMs": [
+      213.09999999403954,
+      100,
+      91.5
+    ],
+    "previewNodes": 5117,
+    "longTasks": {
+      "count": 13,
+      "median": 191,
+      "p95": 768,
+      "max": 768
+    },
+    "heapUsedBytes": 86940861,
+    "repeat": 3
+  }
+]

docs/development/performance/2026-09-06-long-document-baseline.json

@@ -0,0 +1,380 @@
+[
+  {
+    "requestedHan": 25000,
+    "hanCharacters": 25632,
+    "sourceCharacters": 35728,
+    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) HeadlessChrome/152.0.0.0 Safari/537.36",
+    "viewport": [
+      1424,
+      905
+    ],
+    "openMs": 398,
+    "domNodes": 2110,
+    "selectionMs": {
+      "median": 1.0999999940395355,
+      "p95": 1.9000000059604645,
+      "max": 1.9000000059604645
+    },
+    "insertMs": {
+      "median": 5.300000011920929,
+      "p95": 8.100000023841858,
+      "max": 8.800000011920929
+    },
+    "foldMs": {
+      "median": 58.70000001788139,
+      "p95": 70.19999998807907,
+      "max": 70.19999998807907
+    },
+    "integrity": true,
+    "previewMs": [
+      230.7999999821186,
+      45.5,
+      39.70000001788139
+    ],
+    "previewNodes": 1058,
+    "longTasks": {
+      "count": 5,
+      "median": 84,
+      "p95": 372,
+      "max": 372
+    },
+    "heapUsedBytes": 42428845,
+    "repeat": 1
+  },
+  {
+    "requestedHan": 25000,
+    "hanCharacters": 25632,
+    "sourceCharacters": 35728,
+    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) HeadlessChrome/152.0.0.0 Safari/537.36",
+    "viewport": [
+      1424,
+      905
+    ],
+    "openMs": 272.09999999403954,
+    "domNodes": 2110,
+    "selectionMs": {
+      "median": 1,
+      "p95": 2.0999999940395355,
+      "max": 2.399999976158142
+    },
+    "insertMs": {
+      "median": 5.699999988079071,
+      "p95": 7,
+      "max": 7.300000011920929
+    },
+    "foldMs": {
+      "median": 48.900000005960464,
+      "p95": 55,
+      "max": 55
+    },
+    "integrity": true,
+    "previewMs": [
+      157,
+      37.69999998807907,
+      40
+    ],
+    "previewNodes": 1058,
+    "longTasks": {
+      "count": 6,
+      "median": 63,
+      "p95": 245,
+      "max": 245
+    },
+    "heapUsedBytes": 62409024,
+    "repeat": 2
+  },
+  {
+    "requestedHan": 25000,
+    "hanCharacters": 25632,
+    "sourceCharacters": 35728,
+    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) HeadlessChrome/152.0.0.0 Safari/537.36",
+    "viewport": [
+      1424,
+      905
+    ],
+    "openMs": 224.90000000596046,
+    "domNodes": 2110,
+    "selectionMs": {
+      "median": 0.7000000178813934,
+      "p95": 1.4000000059604645,
+      "max": 2
+    },
+    "insertMs": {
+      "median": 4.399999976158142,
+      "p95": 6.4000000059604645,
+      "max": 8
+    },
+    "foldMs": {
+      "median": 39.099999994039536,
+      "p95": 44.10000002384186,
+      "max": 44.10000002384186
+    },
+    "integrity": true,
+    "previewMs": [
+      139,
+      46.099999994039536,
+      39.900000005960464
+    ],
+    "previewNodes": 1058,
+    "longTasks": {
+      "count": 4,
+      "median": 92,
+      "p95": 200,
+      "max": 200
+    },
+    "heapUsedBytes": 35903770,
+    "repeat": 3
+  },
+  {
+    "requestedHan": 60000,
+    "hanCharacters": 61172,
+    "sourceCharacters": 85716,
+    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) HeadlessChrome/152.0.0.0 Safari/537.36",
+    "viewport": [
+      1424,
+      905
+    ],
+    "openMs": 458.39999997615814,
+    "domNodes": 4720,
+    "selectionMs": {
+      "median": 2.9000000059604645,
+      "p95": 5.699999988079071,
+      "max": 6.0999999940395355
+    },
+    "insertMs": {
+      "median": 7.5999999940395355,
+      "p95": 9.699999988079071,
+      "max": 12.400000005960464
+    },
+    "foldMs": {
+      "median": 120.30000001192093,
+      "p95": 160.09999999403954,
+      "max": 160.09999999403954
+    },
+    "integrity": true,
+    "previewMs": [
+      173.5,
+      65.60000002384186,
+      70.09999999403954
+    ],
+    "previewNodes": 2560,
+    "longTasks": {
+      "count": 12,
+      "median": 110,
+      "p95": 415,
+      "max": 415
+    },
+    "heapUsedBytes": 60644006,
+    "repeat": 1
+  },
+  {
+    "requestedHan": 60000,
+    "hanCharacters": 61172,
+    "sourceCharacters": 85716,
+    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) HeadlessChrome/152.0.0.0 Safari/537.36",
+    "viewport": [
+      1424,
+      905
+    ],
+    "openMs": 649.6999999880791,
+    "domNodes": 4720,
+    "selectionMs": {
+      "median": 2.699999988079071,
+      "p95": 5.699999988079071,
+      "max": 5.800000011920929
+    },
+    "insertMs": {
+      "median": 7.5,
+      "p95": 9.099999994039536,
+      "max": 10.699999988079071
+    },
+    "foldMs": {
+      "median": 116,
+      "p95": 149.09999999403954,
+      "max": 149.09999999403954
+    },
+    "integrity": true,
+    "previewMs": [
+      209.30000001192093,
+      80.90000000596046,
+      88.7999999821186
+    ],
+    "previewNodes": 2560,
+    "longTasks": {
+      "count": 12,
+      "median": 116,
+      "p95": 586,
+      "max": 586
+    },
+    "heapUsedBytes": 64379838,
+    "repeat": 2
+  },
+  {
+    "requestedHan": 60000,
+    "hanCharacters": 61172,
+    "sourceCharacters": 85716,
+    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) HeadlessChrome/152.0.0.0 Safari/537.36",
+    "viewport": [
+      1424,
+      905
+    ],
+    "openMs": 519.7000000178814,
+    "domNodes": 4720,
+    "selectionMs": {
+      "median": 2.9000000059604645,
+      "p95": 4.9000000059604645,
+      "max": 5.5
+    },
+    "insertMs": {
+      "median": 9.200000017881393,
+      "p95": 11.700000017881393,
+      "max": 11.900000005960464
+    },
+    "foldMs": {
+      "median": 118.40000000596046,
+      "p95": 134.5,
+      "max": 134.5
+    },
+    "integrity": true,
+    "previewMs": [
+      198.5,
+      84.80000001192093,
+      91.59999999403954
+    ],
+    "previewNodes": 2560,
+    "longTasks": {
+      "count": 11,
+      "median": 119,
+      "p95": 469,
+      "max": 469
+    },
+    "heapUsedBytes": 43218088,
+    "repeat": 3
+  },
+  {
+    "requestedHan": 120000,
+    "hanCharacters": 122322,
+    "sourceCharacters": 171613,
+    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) HeadlessChrome/152.0.0.0 Safari/537.36",
+    "viewport": [
+      1424,
+      905
+    ],
+    "openMs": 894.6000000238419,
+    "domNodes": 9139,
+    "selectionMs": {
+      "median": 7.9000000059604645,
+      "p95": 11.599999994039536,
+      "max": 24.700000017881393
+    },
+    "insertMs": {
+      "median": 18.19999998807907,
+      "p95": 22.19999998807907,
+      "max": 30.799999982118607
+    },
+    "foldMs": {
+      "median": 247.59999999403954,
+      "p95": 256.59999999403954,
+      "max": 256.59999999403954
+    },
+    "integrity": true,
+    "previewMs": [
+      294.2999999821186,
+      134.09999999403954,
+      129.90000000596046
+    ],
+    "previewNodes": 5117,
+    "longTasks": {
+      "count": 14,
+      "median": 207,
+      "p95": 821,
+      "max": 821
+    },
+    "heapUsedBytes": 60930415,
+    "repeat": 1
+  },
+  {
+    "requestedHan": 120000,
+    "hanCharacters": 122322,
+    "sourceCharacters": 171613,
+    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) HeadlessChrome/152.0.0.0 Safari/537.36",
+    "viewport": [
+      1424,
+      905
+    ],
+    "openMs": 875.3999999761581,
+    "domNodes": 9139,
+    "selectionMs": {
+      "median": 9.199999988079071,
+      "p95": 15.199999988079071,
+      "max": 15.900000005960464
+    },
+    "insertMs": {
+      "median": 20.599999994039536,
+      "p95": 23.19999998807907,
+      "max": 26.5
+    },
+    "foldMs": {
+      "median": 244.09999999403954,
+      "p95": 269,
+      "max": 269
+    },
+    "integrity": true,
+    "previewMs": [
+      272.2999999821186,
+      146.30000001192093,
+      157.40000000596046
+    ],
+    "previewNodes": 5117,
+    "longTasks": {
+      "count": 14,
+      "median": 192,
+      "p95": 785,
+      "max": 785
+    },
+    "heapUsedBytes": 31982024,
+    "repeat": 2
+  },
+  {
+    "requestedHan": 120000,
+    "hanCharacters": 122322,
+    "sourceCharacters": 171613,
+    "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) HeadlessChrome/152.0.0.0 Safari/537.36",
+    "viewport": [
+      1424,
+      905
+    ],
+    "openMs": 842.3000000119209,
+    "domNodes": 9139,
+    "selectionMs": {
+      "median": 8,
+      "p95": 11.900000005960464,
+      "max": 15.199999988079071
+    },
+    "insertMs": {
+      "median": 18.900000005960464,
+      "p95": 20.099999994039536,
+      "max": 21.700000017881393
+    },
+    "foldMs": {
+      "median": 212.5,
+      "p95": 240.5,
+      "max": 240.5
+    },
+    "integrity": true,
+    "previewMs": [
+      253.7000000178814,
+      129.19999998807907,
+      172
+    ],
+    "previewNodes": 5117,
+    "longTasks": {
+      "count": 14,
+      "median": 191,
+      "p95": 762,
+      "max": 762
+    },
+    "heapUsedBytes": 49460811,
+    "repeat": 3
+  }
+]

docs/development/performance/2026-09-06-scroll-after.json

@@ -0,0 +1,122 @@
+[
+  {
+    "requestedHan": 25000,
+    "theme": "paper-moments",
+    "frameGapsMs": {
+      "median": 10,
+      "p95": 20.100000000000364,
+      "max": 110.09999999999991
+    },
+    "frames": 380,
+    "framesOver25ms": 14,
+    "longTasks": [
+      97
+    ],
+    "scrollTop": 6111,
+    "scrollHeight": 33908,
+    "foldedScrollTop": 0,
+    "caretAfterFold": 1,
+    "repeat": 1
+  },
+  {
+    "requestedHan": 25000,
+    "theme": "paper-moments",
+    "frameGapsMs": {
+      "median": 10,
+      "p95": 20.100000000000136,
+      "max": 50
+    },
+    "frames": 374,
+    "framesOver25ms": 15,
+    "longTasks": [
+      57
+    ],
+    "scrollTop": 6111,
+    "scrollHeight": 33908,
+    "foldedScrollTop": 0,
+    "caretAfterFold": 1,
+    "repeat": 2
+  },
+  {
+    "requestedHan": 60000,
+    "theme": "paper-moments",
+    "frameGapsMs": {
+      "median": 30.100000000000364,
+      "p95": 50,
+      "max": 100
+    },
+    "frames": 267,
+    "framesOver25ms": 210,
+    "longTasks": [
+      81,
+      84
+    ],
+    "scrollTop": 52492,
+    "scrollHeight": 80287,
+    "foldedScrollTop": 0,
+    "caretAfterFold": 1,
+    "repeat": 1
+  },
+  {
+    "requestedHan": 60000,
+    "theme": "paper-moments",
+    "frameGapsMs": {
+      "median": 30,
+      "p95": 40.100000000000364,
+      "max": 100
+    },
+    "frames": 279,
+    "framesOver25ms": 213,
+    "longTasks": [
+      77,
+      59
+    ],
+    "scrollTop": 52493,
+    "scrollHeight": 80287,
+    "foldedScrollTop": 0,
+    "caretAfterFold": 1,
+    "repeat": 2
+  },
+  {
+    "requestedHan": 120000,
+    "theme": "paper-moments",
+    "frameGapsMs": {
+      "median": 70,
+      "p95": 100,
+      "max": 130
+    },
+    "frames": 264,
+    "framesOver25ms": 229,
+    "longTasks": [
+      84,
+      52,
+      89,
+      58
+    ],
+    "scrollTop": 53157,
+    "scrollHeight": 159554,
+    "foldedScrollTop": 0,
+    "caretAfterFold": 1,
+    "repeat": 1
+  },
+  {
+    "requestedHan": 120000,
+    "theme": "paper-moments",
+    "frameGapsMs": {
+      "median": 70.09999999999854,
+      "p95": 100,
+      "max": 130.10000000000036
+    },
+    "frames": 261,
+    "framesOver25ms": 230,
+    "longTasks": [
+      83,
+      53
+    ],
+    "scrollTop": 53195,
+    "scrollHeight": 159554,
+    "foldedScrollTop": 0,
+    "caretAfterFold": 1,
+    "repeat": 2
+  }
+]

docs/development/performance/2026-09-06-scroll-baseline.json

@@ -0,0 +1,119 @@
+[
+  {
+    "requestedHan": 25000,
+    "theme": "paper-moments",
+    "frameGapsMs": {
+      "median": 10,
+      "p95": 30.09999999999991,
+      "max": 120.10000000000002
+    },
+    "frames": 356,
+    "framesOver25ms": 45,
+    "longTasks": [
+      116
+    ],
+    "scrollTop": 6075,
+    "scrollHeight": 33871,
+    "foldedScrollTop": 0,
+    "caretAfterFold": 1,
+    "repeat": 1
+  },
+  {
+    "requestedHan": 25000,
+    "theme": "paper-moments",
+    "frameGapsMs": {
+      "median": 10,
+      "p95": 30,
+      "max": 80.10000000000002
+    },
+    "frames": 369,
+    "framesOver25ms": 29,
+    "longTasks": [
+      93
+    ],
+    "scrollTop": 6111,
+    "scrollHeight": 33908,
+    "foldedScrollTop": 0,
+    "caretAfterFold": 1,
+    "repeat": 2
+  },
+  {
+    "requestedHan": 60000,
+    "theme": "paper-moments",
+    "frameGapsMs": {
+      "median": 40,
+      "p95": 59.900000000001455,
+      "max": 100.09999999999991
+    },
+    "frames": 264,
+    "framesOver25ms": 221,
+    "longTasks": [
+      92
+    ],
+    "scrollTop": 52345,
+    "scrollHeight": 80177,
+    "foldedScrollTop": 0,
+    "caretAfterFold": 1,
+    "repeat": 1
+  },
+  {
+    "requestedHan": 60000,
+    "theme": "paper-moments",
+    "frameGapsMs": {
+      "median": 40,
+      "p95": 50.100000000000364,
+      "max": 130.10000000000036
+    },
+    "frames": 265,
+    "framesOver25ms": 229,
+    "longTasks": [
+      84,
+      109
+    ],
+    "scrollTop": 52344,
+    "scrollHeight": 80177,
+    "foldedScrollTop": 0,
+    "caretAfterFold": 1,
+    "repeat": 2
+  },
+  {
+    "requestedHan": 120000,
+    "theme": "paper-moments",
+    "frameGapsMs": {
+      "median": 70,
+      "p95": 90.10000000000036,
+      "max": 170.19999999999982
+    },
+    "frames": 260,
+    "framesOver25ms": 235,
+    "longTasks": [
+      89,
+      77
+    ],
+    "scrollTop": 53200,
+    "scrollHeight": 159554,
+    "foldedScrollTop": 0,
+    "caretAfterFold": 1,
+    "repeat": 1
+  },
+  {
+    "requestedHan": 120000,
+    "theme": "paper-moments",
+    "frameGapsMs": {
+      "median": 70,
+      "p95": 90.10000000000036,
+      "max": 140.10000000000036
+    },
+    "frames": 259,
+    "framesOver25ms": 228,
+    "longTasks": [
+      92,
+      57
+    ],
+    "scrollTop": 53196,
+    "scrollHeight": 159554,
+    "foldedScrollTop": 0,
+    "caretAfterFold": 1,
+    "repeat": 2
+  }
+]

docs/development/performance/2026-09-06-scroll-theme-comparison.json

@@ -0,0 +1,150 @@
+{
+  "light": {
+    "requestedHan": 120000,
+    "theme": "light",
+    "variant": "default",
+    "frameGapsMs": {
+      "median": 10,
+      "p95": 30,
+      "max": 90.09999999999991
+    },
+    "frames": 403,
+    "framesOver25ms": 29,
+    "longTasks": [
+      89
+    ],
+    "scrollTop": 54000,
+    "scrollHeight": 168515,
+    "foldedScrollTop": 0,
+    "caretAfterFold": 1,
+    "repeat": 1
+  },
+  "dark": {
+    "requestedHan": 120000,
+    "theme": "dark",
+    "variant": "default",
+    "frameGapsMs": {
+      "median": 10,
+      "p95": 30,
+      "max": 90
+    },
+    "frames": 408,
+    "framesOver25ms": 27,
+    "longTasks": [
+      88
+    ],
+    "scrollTop": 54000,
+    "scrollHeight": 168515,
+    "foldedScrollTop": 0,
+    "caretAfterFold": 1,
+    "repeat": 1
+  },
+  "fixed": [
+    {
+      "requestedHan": 120000,
+      "theme": "paper-moments",
+      "variant": "default",
+      "frameGapsMs": {
+        "median": 10,
+        "p95": 30.100000000000136,
+        "max": 100
+      },
+      "frames": 422,
+      "framesOver25ms": 31,
+      "longTasks": [
+        99
+      ],
+      "scrollTop": 54037,
+      "scrollHeight": 160247,
+      "foldedScrollTop": 0,
+      "caretAfterFold": 1,
+      "repeat": 1
+    },
+    {
+      "requestedHan": 120000,
+      "theme": "paper-moments",
+      "variant": "default",
+      "frameGapsMs": {
+        "median": 10,
+        "p95": 30,
+        "max": 90
+      },
+      "frames": 427,
+      "framesOver25ms": 31,
+      "longTasks": [
+        84,
+        58
+      ],
+      "scrollTop": 54000,
+      "scrollHeight": 160211,
+      "foldedScrollTop": 0,
+      "caretAfterFold": 1,
+      "repeat": 2
+    },
+    {
+      "requestedHan": 120000,
+      "theme": "paper-moments",
+      "variant": "default",
+      "frameGapsMs": {
+        "median": 10,
+        "p95": 30.09999999999991,
+        "max": 90.09999999999991
+      },
+      "frames": 422,
+      "framesOver25ms": 29,
+      "longTasks": [
+        85
+      ],
+      "scrollTop": 54037,
+      "scrollHeight": 160247,
+      "foldedScrollTop": 0,
+      "caretAfterFold": 1,
+      "repeat": 3
+    }
+  ],
+  "outlineDisabled": [
+    {
+      "requestedHan": 120000,
+      "theme": "paper-moments",
+      "variant": "no-outline",
+      "frameGapsMs": {
+        "median": 10,
+        "p95": 30.099999999999454,
+        "max": 100
+      },
+      "frames": 418,
+      "framesOver25ms": 31,
+      "longTasks": [
+        101
+      ],
+      "scrollTop": 54037,
+      "scrollHeight": 160247,
+      "foldedScrollTop": 0,
+      "caretAfterFold": 1,
+      "repeat": 1
+    },
+    {
+      "requestedHan": 120000,
+      "theme": "paper-moments",
+      "variant": "no-outline",
+      "frameGapsMs": {
+        "median": 10,
+        "p95": 30,
+        "max": 99.89999999999964
+      },
+      "frames": 413,
+      "framesOver25ms": 32,
+      "longTasks": [
+        87,
+        50,
+        52,
+        52
+      ],
+      "scrollTop": 53965,
+      "scrollHeight": 160174,
+      "foldedScrollTop": 0,
+      "caretAfterFold": 1,
+      "repeat": 2
+    }
+  ]
+}

docs/development/performance/2026-09-06-scroll-token-cache.json

@@ -0,0 +1,66 @@
+[
+  {
+    "requestedHan": 120000,
+    "theme": "paper-moments",
+    "frameGapsMs": {
+      "median": 70.29999999999927,
+      "p95": 100.20000000000073,
+      "max": 210.20000000000073
+    },
+    "frames": 308,
+    "framesOver25ms": 286,
+    "longTasks": [
+      86,
+      54,
+      56,
+      62,
+      50,
+      58,
+      53,
+      52,
+      58,
+      100,
+      107,
+      96,
+      60,
+      99,
+      89,
+      136,
+      101,
+      98,
+      101,
+      90,
+      66,
+      120,
+      74,
+      99,
+      58
+    ],
+    "scrollTop": 53127,
+    "scrollHeight": 159554,
+    "foldedScrollTop": 0,
+    "caretAfterFold": 1,
+    "repeat": 1
+  },
+  {
+    "requestedHan": 120000,
+    "theme": "paper-moments",
+    "frameGapsMs": {
+      "median": 70,
+      "p95": 90,
+      "max": 150
+    },
+    "frames": 261,
+    "framesOver25ms": 235,
+    "longTasks": [
+      84,
+      67,
+      52
+    ],
+    "scrollTop": 53233,
+    "scrollHeight": 159554,
+    "foldedScrollTop": 0,
+    "caretAfterFold": 1,
+    "repeat": 2
+  }
+]

docs/development/performance/2026-09-06-sqlite-vec-search.json

@@ -0,0 +1,29 @@
+{
+  "blocks": 4000,
+  "dimensions": 384,
+  "top_k": 20,
+  "migration_ms": 1329.5076999929734,
+  "same_top_k": true,
+  "measurements": {
+    "python_json_scan": {
+      "median_ms": 1289.638800022658,
+      "samples_ms": [
+        1289.638800022658,
+        1238.6701999930665,
+        1115.6752999813762,
+        1436.7559000093024,
+        1833.9683999947738
+      ]
+    },
+    "sqlite_vec": {
+      "median_ms": 19.673499977216125,
+      "samples_ms": [
+        29.709700000239536,
+        17.876600002637133,
+        35.13619999284856,
+        19.673499977216125,
+        18.28439999371767
+      ]
+    }
+  }
+}

docs/development/performance/2026-09-06-task-http-fixed.json

@@ -0,0 +1,36 @@
+{
+  "transport": "real loopback HTTP, separate Uvicorn process",
+  "tasks": 1000,
+  "concurrency": 20,
+  "elapsed_ms": 24509.81,
+  "latencies": {
+    "create": {
+      "count": 1000,
+      "p95_ms": 157.68,
+      "max_ms": 186.7
+    },
+    "update": {
+      "count": 1000,
+      "p95_ms": 208.68,
+      "max_ms": 259.91
+    },
+    "list": {
+      "count": 11,
+      "p95_ms": 23.39,
+      "max_ms": 23.39
+    },
+    "delete": {
+      "count": 1000,
+      "p95_ms": 205.45,
+      "max_ms": 279.12
+    },
+    "health": {
+      "count": 375,
+      "p95_ms": 38.64,
+      "max_ms": 164.76
+    }
+  },
+  "health_errors": [],
+  "pagination_complete": true,
+  "final_total": 0
+}

docs/development/performance/2026-09-06-task-http.json

@@ -0,0 +1,36 @@
+{
+  "transport": "real loopback HTTP, separate Uvicorn process",
+  "tasks": 1000,
+  "concurrency": 20,
+  "elapsed_ms": 18312.92,
+  "latencies": {
+    "create": {
+      "count": 1000,
+      "p95_ms": 116.45,
+      "max_ms": 134.91
+    },
+    "update": {
+      "count": 1000,
+      "p95_ms": 159.29,
+      "max_ms": 193.37
+    },
+    "list": {
+      "count": 11,
+      "p95_ms": 20.96,
+      "max_ms": 20.96
+    },
+    "delete": {
+      "count": 1000,
+      "p95_ms": 156.43,
+      "max_ms": 190.1
+    },
+    "health": {
+      "count": 117,
+      "p95_ms": 157.0,
+      "max_ms": 195.07
+    }
+  },
+  "health_errors": [],
+  "pagination_complete": true,
+  "final_total": 0
+}

docs/development/performance/2026-09-06-task-ui-fixed.json

@@ -0,0 +1,70 @@
+[
+  {
+    "kind": "tasks",
+    "theme": "paper-moments",
+    "size": 1000,
+    "initialRenderMs": 173,
+    "requests": [
+      "/api/tasks?limit=100&offset=0",
+      "/api/tasks?limit=100&offset=100",
+      "/api/tasks?limit=100&offset=200",
+      "/api/tasks?limit=100&offset=300",
+      "/api/tasks?limit=100&offset=400",
+      "/api/tasks?limit=100&offset=500",
+      "/api/tasks?limit=100&offset=600",
+      "/api/tasks?limit=100&offset=700",
+      "/api/tasks?limit=100&offset=800",
+      "/api/tasks?limit=100&offset=900"
+    ],
+    "initialTaskCount": 1000,
+    "fullListRenderMs": 85.39999997615814,
+    "fullListIsInjected": true,
+    "renderedTasks": 100,
+    "domNodes": 1111,
+    "scrollContainers": [
+      {
+        "node": "HTML",
+        "height": 905,
+        "scrollHeight": 905,
+        "overflow": "hidden",
+        "position": "static"
+      },
+      {
+        "node": "BODY",
+        "height": 905,
+        "scrollHeight": 905,
+        "overflow": "hidden",
+        "position": "static"
+      },
+      {
+        "node": "viewport",
+        "height": 905,
+        "scrollHeight": 905,
+        "overflow": "auto",
+        "position": "static"
+      },
+      {
+        "node": "app",
+        "height": 905,
+        "scrollHeight": 905,
+        "overflow": "hidden",
+        "position": "static"
+      }
+    ],
+    "frameGapsMs": {
+      "median": 10,
+      "p95": 30,
+      "max": 50.10000000000002
+    },
+    "frames": 384,
+    "longTasks": [],
+    "scrollTop": 0,
+    "scrollHeight": 11798,
+    "maxScrollTop": 10941,
+    "filteredCount": 100,
+    "totalFilteredCount": 334,
+    "expectedFilteredCount": 100,
+    "filterMs": 18.69999998807907,
+    "repeat": 1
+  }
+]

docs/development/主题组件覆盖检查.md

@@ -1,5 +1,28 @@
 # 主题组件覆盖检查（2026-09-05）
 
+## 2026-09-06：Markdown 行为与文档滚动适配
+
+| 主题 | 当前版本 |
+| --- | --- |
+| Light / Dark / Sepia | 1.4.0 |
+| 纸间时光 | 1.9.0 |
+| Ocean Blue | 1.6.0 |
+| Midnight Purple | 2.4.0 |
+
+新增共享 `frontend/src/styles/markdown-behavior.css`，由应用入口及隔离主题预览同时加载。六个主题通过语义变量提供链接悬停与键盘焦点、任务复选框、引用与分隔线、文字选区、表格选区、标题折叠状态、警告框折叠状态和文档滚动按钮配色。标题箭头沿用悬停或键盘聚焦时显示的规则；表格选区采用透明叠色，避免遮住单元格文字。纸间时光保留长文轻量背景实现。
+
+只读 Markdown（包括 AI 对话）现在同步代码行号、自动换行和缩进宽度设置。语法是否启用仍由 Markdown 预设与解析器决定；ATX / Setext 等源码写法解析成同级标题后使用相同主题样式，不用 CSS 模拟语法。主题预览新增 H4–H6、嵌套列表、任务列表、链接、行内代码、折叠警告框、带行号长代码及滚动按钮样例。
+
+工作区滚动按钮固定在编辑区域右下角，适用于写作和源码模式：顶部只显示到底部、底部只显示到顶部、中间同时显示；空文档或没有可滚动内容时隐藏。滚动状态通过被动监听与动画帧合并更新，尺寸、内容和折叠变化会重新计算，减少动画偏好开启时直接跳转。
+
+验证方法：
+
+1. 运行 `cd frontend` 后执行 `npm test` 和 `npm run build`，检查主题变量覆盖、六主题预览矩阵、主题升级、Markdown 预设和滚动按钮回归。
+2. 本地启动前端，访问 `tests/visual/index.html?theme=light`，依次切换表中六个主题，检查新增样例的链接焦点、复选框、折叠态、代码换行及行号。社区主题已安装旧版本时，应在主题页更新后再检查。
+3. 工作区分别打开空笔记、短笔记、长笔记，切换写作与源码模式，在顶部、中间、底部验证按钮数量和跳转方向；调整窗口尺寸、折叠标题后再次检查。
+
+本次自动检查覆盖仓库内六主题的结构和样式变量，不包含用户自行导入的任意第三方 CSS，也不等同于所有浏览器的逐页视觉验收。
+
 本次检查仓库内 3 个内置主题和 3 个社区预设，共扫描 105 个前端源文件的组件与语义样式变量。用户自行导入的第三方 CSS 不在仓库中，不据此声称已验收。
 
 ## 范围与结果

docs/development/前端构建分块优化开发说明.md

@@ -0,0 +1,43 @@
+# 前端构建分块优化开发说明
+
+> 更新日期：2026-09-06。基于 main 的 64af068 进行构建对比；以下结果为本地生产构建，不是网络耗时或性能评分。
+
+## 当前方案
+
+- Mermaid 由静态导入改成第一次渲染或校验图表时动态导入。复用加载 Promise，加载失败清除缓存以允许重试，主题初始化与渲染继续串行执行。
+- CodeMirror 基础模块、ProseMirror 和 Milkdown 分组缓存。仅显式选中的模块进入手动分组，不吸收所有传递依赖。
+- CodeMirror 语言解析器、全部 Shiki 语法和 Mermaid 图型继续按需加载。不能将所有语言打入 editor vendor，否则会反而增加编辑器的首次加载量。
+- KaTeX 按实际安装版本分组，避免合并项目版本和依赖内版本。不强制升级第三方依赖的数学解析器。
+- 启用 Vite manifest，并提供 build:report 脚本用于持续比较入口静态依赖。
+
+## 构建观察
+
+数值按十进制 kB 计算。静态闭包包括入口 JS 与递归 imports，去重后求和；不包含 CSS、字体、运行时动态导入或浏览器缓存。gzip 为每个 JS 文件压缩后求和，不代表服务器必然启用该压缩。
+
+| 检查项 | 优化前 | 优化后 |
+| --- | --- | --- |
+| 聊天页静态 JS 闭包 | 约 1563.5 kB | 约 894 kB |
+| 聊天页闭包 gzip | 约 451.6 kB | 约 292 kB |
+| VisualMarkdownEditor 单包 | 约 1145.8 kB | 约 20 kB，核心依赖转入独立块 |
+| 首屏静态 JS 闭包 | 约 409.7 kB | 约 409 kB，基本不变 |
+
+组件单包缩小不等于整个编辑器只需要 20 kB。编辑器仍需要加载基础框架、核心依赖和实际用到的语法。此次主要减少普通 Markdown 页对 Mermaid 的提前加载，并改善模块缓存边界；未测量真实启动耗时，不能声称首屏提速比例。
+
+## 验证方法
+
+在 frontend 目录执行：
+
+```powershell
+pnpm build
+pnpm build:report
+pnpm test
+pnpm exec vite preview --host 127.0.0.1 --port 4173
+```
+
+build:report 读取 dist/.vite/manifest.json，输出入口闭包大小与最大的 15 个 JS 块。对比时保存相同构建环境的两份输出；更新依赖后需重新测量。
+
+本轮前端 345 项测试通过，类型检查及生产构建通过。已在生产预览打开工作区和真实 Mermaid 示例笔记，确认编辑器与 SVG 加载，未发现控制台 error。Shiki 全语言覆盖仍由既有语言测试检查。
+
+## 保留的大块与边界
+
+C++、Emacs Lisp 等语法、Oniguruma WASM、部分 Mermaid 图型及 Mermaid 核心仍可能超过 500 kB。这些资源保留按需加载，不裁减语言支持，也不提高警告阈值来隐藏问题。首次打开复杂图表或对应语言仍有加载成本；后续可基于真实请求和设备数据评估 Worker、资源预热及库版本升级。

docs/development/后台运行日志与压力问题修复.md

@@ -0,0 +1,101 @@
+# 后台运行日志与压力问题修复
+
+## 1. 范围与入口
+
+本次针对 Agent 与任务压测发现的历史记录截断、同步数据库写入阻塞事件循环、长 Trace 树形筛选过慢进行修复，并增加统一运行日志。
+
+主导航的「日志」打开 `/logs`。知识库选择页也有入口；无需成功打开 Vault 即可查看。需要 AI Core 正常提供 HTTP 服务。后台未启动时，页面显示连接错误，不伪造历史结果。
+
+页面提供级别、模块、事件名/错误码/关联 ID 筛选及详情展开。日志列表高度受限，按时间从旧到新显示，默认每 5 秒获取新日志并跟随到底部。向上滚动时暂停跟随，抵达顶部自动加载更早日志并保持阅读位置；可一键回到最新。隐藏页面和卸载后停止轮询。界面最多保留当前浏览窗口的 500 条，继续读取旧日志时移出另一端的记录，后台保留窗口不受影响。所有组件使用已有主题变量、卡片、按钮、下拉框及 `ui-disclosure` 展开样式。
+
+## 2. 日志覆盖
+
+| 模块 | 记录内容 | 定位信息 |
+| --- | --- | --- |
+| vectors | 后台索引状态、向量调用失败、是否使用本地索引回退 | job_id、错误码、异常类型、调用位置、批次数量 |
+| models | 本地模型/远程模型运行诊断、CUDA/CPU、失败与回退 | 模型、设备、状态、错误码、耗时 |
+| agent | 创建运行、模型轮次、工具调用与结果、权限决策、完成/失败/取消 | run_id、Provider、模型、步骤、事件序号、工具名 |
+| tasks | 创建、修改、删除及不存在的删除目标 | task_id、关联 note_id、修改字段名、状态 |
+| providers / chat | 模型请求完成或未完整结束、流式模型错误、对话失败 | Provider、模型、request_id、run_id、错误码 |
+| http / api | HTTP 写操作、失败请求、超过一秒的请求及业务错误 | HTTP 方法、路由模板、状态码、耗时、request_id、资源 ID |
+| system / Python logger | 服务启动与停止，以及应用、服务器和依赖库的 warning/error | 模块、代码位置、异常类型 |
+
+`X-Request-ID` 响应头可与日志中的 request_id 对照。请求上下文通过 ContextVar 传播到后台任务和线程；Agent 内部工具触发的日志还带 run_id。查询日志自身以及正常短轮询不生成 HTTP 操作日志，避免轮询放大日志量。
+
+这里只记录操作诊断，不替代完整 Agent Trace、Token 用量台账和模型诊断表。旧代码 logger 的自由文本可能包含笔记或厂商返回，因此桥接时只记录级别、模块、代码位置和异常类型；需要业务错误码的地方使用结构化接口。
+
+## 3. 存储、容量与隐私
+
+- 位置：`APP_DATA_DIR/logs/operations.sqlite3`，与业务数据库独立，应用重启后可继续查看。
+- 保留最近 20,000 条；每批写入时淘汰更早的记录。不是按天永久归档。
+- 后台线程批量写入，队列最多 4,096 条，一批最多 128 条。队列满时丢弃新诊断记录并计数，绝不阻塞保存或模型推理。
+- 日志页面显示待写入数量、队列溢出和写入失败数量。计数属于当前进程；重启后重置。存储不可读时显示请求失败。
+- 正常退出先停止 Agent 和其他后台工作，再排空日志队列；强制终止进程可能丢失尚未写入的队列内容。
+- 不记录请求/响应正文、系统提示词、工具参数/输出、笔记标题或正文、凭据、原始异常消息、查询字符串。元数据按白名单筛选并限长，Bearer 和 `sk-` 凭据形式额外脱敏。
+- API 仅返回保留窗口内的诊断数据，不提供任意文件读取和日志删除接口。
+
+## 4. 开发接口
+
+```python
+from app.operation_logs import log_event
+
+log_event('vectors', 'embedding.failed', level='ERROR', error=exc,
+          model=model_id, job_id=job_id, error_code='EMBEDDING_UNAVAILABLE',
+          fallback='local_index')
+```
+
+第一个参数是模块名。`source` 是可选的元数据字段，例如 `local` 或 `api`，不要与模块名混淆。事件名应使用开发时定义的短常量。不要把正文、URL、异常消息或用户输入拼入事件名。
+
+`GET /api/logs` 参数：
+
+| 参数 | 规则 |
+| --- | --- |
+| limit | 默认 50，范围 1–200 |
+| before | 上页 next_cursor；正整数，返回更早的 ID |
+| level | 空或 INFO / WARNING / ERROR / CRITICAL |
+| source | 模块名精确匹配，最多 100 字符 |
+| q | 在事件名及脱敏元数据中做字面子串搜索，最多 200 字符 |
+
+返回 `items`、`next_cursor`、`sources`、`pending`、`dropped`、`write_failures`、`retention`。按递增 ID 的倒序分页，插入新日志不改变已经翻到的旧页边界。没有匹配记录时 items 为空、next_cursor 为 null。
+
+## 5. 压力问题的修复方式
+
+Agent Trace 写入由独立异步队列调度到线程，最多合并 64 个写入为一个 SQLite 事务。提交成功后才更新对外可见快照和广播 SSE。创建记录在第一次 await 前占用运行名额，避免并发创建突破 200 个活动运行上限。取消等待正在提交的快照结束，再写终态；服务关闭会等待 Agent 和 Trace 队列。数据库失败不会被当成成功提交。
+
+任务 HTTP 写操作在协程中排队，然后在线程执行；读操作也在线程执行，减少文件锁争用和主事件循环阻塞。SQLite 仍是单写者，不意味着任务写入支持无限并发。
+
+前端读取任务和 Agent 列表的后续 API 页，不再只显示第一页的 50 条。任务筛选和数量基于已获取的完整列表，界面每页显示 100 个任务；运行侧栏每页 50 条。列表刷新失败保留上次结果。列表读取使用现有 offset 协议，不是跨多页的事务快照；其他客户端同时修改数据时可以刷新重新获取。
+
+Trace 搜索先生成事件序号、模型调用 ID、工具调用 ID 的集合，再一次遍历调用树。匹配子节点保留父节点。搜索作用于完整已加载的历史，每页只渲染 200 个事件或树节点。工具统计按工具名和状态汇总，避免在底部再次生成数千个调用卡片。
+
+## 6. 验证方法
+
+后端回归覆盖日志持久化、重启、保留窗口、筛选与游标、正文排除、HTTP 关联 ID，以及后台 Trace 写入同时取消时仍释放等待方。业务回归覆盖 Agent/任务、模型路由、本地模型、用量统计和对话。
+
+```powershell
+cd backend
+.venv/Scripts/python.exe -m pytest tests/test_agent_core.py tests/test_api.py tests/test_operation_logs.py tests/test_model_routing.py tests/test_local_models.py tests/test_usage_overrides.py tests/test_chat_history.py tests/test_chat_context.py -q
+```
+
+运行测试前应将 APP_DATA_DIR、APP_DB_PATH 和 APP_VAULT_PATH 指向临时目录，避免模块导入时初始化真实扩展。pytest 的 fixture 会继续为每个测试隔离数据。
+
+前端执行 `npm --prefix frontend test` 和 `npm --prefix frontend run build`。新增用例验证后续任务/Agent 页完整加载、Trace 全历史搜索与分页、日志筛选/游标、自动跟随与上滚暂停、顶部历史加载、存储异常提示及卸载后停止刷新。
+
+2026-09-06 实测：后端全量 627 项通过；随后增加的 3 项写入失败/取消回归也通过，最后相关接口回归 21 项通过。前端全量 413 项通过，生产构建通过。构建仍提示已有部分 Markdown/Mermaid 依赖块大于 500 kB；后端测试保留已有 Starlette TestClient 弃用提示。纸间时光日志页已用隔离合成数据检查截图，运行中的本机 `/api/logs` 也已确认可返回结果。
+
+离线并发压测与真实本机 HTTP 压测复现方式、前后数据见 [Agent 与任务压测报告](Agent与任务压测报告.md)。压测只使用隔离数据和 Mock Provider，不消耗用户厂商额度。
+
+手工验收建议：
+
+1. 创建、修改和删除一个测试任务，按返回的 task_id 或 X-Request-ID 筛选日志。
+2. 运行含工具调用的 Agent，批准或取消权限请求；按 run_id 检查创建、权限、工具结果和终态。
+3. 在隔离配置中请求未安装的本地模型，查看 models/vectors 的错误码与回退信息，不应出现输入文本。
+4. 重启 AI Core，确认已提交日志仍可查看；退出 Vault 后从入口页打开日志。
+5. 切换默认浅色、深色、纸间时光主题，检查筛选栏、错误徽标和详情展开；窄窗口下应换行且详情不撑出页面。
+# 2026-09-06：大批量本地向量传输修复
+
+全量重建包含 2111 个文本块时，本地模型可能成功完成推理，但整批向量被写成一行 JSON。接收端单行限制为 16 MiB：asyncio 管道拒绝超长行，Windows 线程管道则读到不完整 JSON，最终被包装成 `LOCAL_MODEL_INVALID_RESPONSE`。这类错误不表示 CUDA 显存不足，也不应通过切换 CPU 处理。
+
+Embedding 响应改为每 128 条向量一个 JSON 帧，结束帧携带总数。接收端检查偏移连续性、请求数量和结束标记；缺块时明确失败，不把部分向量写入索引。模型仍只加载一次，推理批大小不变。语音等其他响应保持原协议。
+
+验证方法：在隔离数据目录运行 `tests/test_local_models.py`，分别使用 asyncio 与 Windows 线程管道传输 2111 × 384 的结果，确认旧格式超过 16 MiB，而分帧可完整接收。该文件 7 项测试通过。另使用本机 Bekko 权重、CUDA 对 2111 条合成文本做真实推理：返回 2111 条 384 维向量，设备 `cuda:0`，耗时约 12.55 秒；旧格式 JSON 为 17,886,180 字节。该验收不修改用户笔记、索引或运行配置；用户原始长文档的全库重建仍需在服务加载修复后重试。

docs/development/工作区后台索引与保存开发说明.md

@@ -0,0 +1,67 @@
+# 工作区后台索引与保存开发说明
+
+> 本文档用于团队开发和联调，说明 Web Workspace 的打开、保存与后台向量更新边界。
+>
+> 更新日期：2026-09-06。代码基线：`a5c44c4`，已随 PR #31 合并到 `main`。
+
+## 当前实现
+
+打开知识库和保存正文不再等待 Embedding 推理。Markdown 是正文载体；SQLite 元数据和 FTS 可先使用，向量结果随后更新。这里的后台任务是 AI Core 进程内的 asyncio 任务，不是独立队列服务，也不是 Tauri 后台服务。
+
+| 操作 | 请求完成前 | 后台阶段 |
+| --- | --- | --- |
+| 打开 Vault | 校验配置路径；路径集合变化时登记新文件、删除失效记录并返回真实文件树 | 标记需要更新时自动全量计算向量 |
+| HTTP PATCH 保存笔记 | 写正文、解析元数据、更新 FTS、清理旧向量并持久化待处理标记 | 按笔记计算向量，核对版本后写入 |
+| 手动全量重建 | HTTP 请求仍等待全量重建结果 | 推理期间不持有 Vault 写锁，提交阶段原子替换 |
+
+`note_service.update_note` 的 `defer_vectors` 默认仍为 `False`；HTTP PATCH 路由显式传入 `True`。创建、移动及其他内部调用不能据此宣称已经全部后台化。
+
+## 代码入口
+
+| 文件 | 职责 |
+| --- | --- |
+| `backend/app/services/workspace_service.py` | 文件登记、打开工作区、触发后台任务 |
+| `backend/app/services/note_service.py` | 正文保存、即时元数据与全文索引 |
+| `backend/app/services/index_service.py` | 后台任务去重、全量与单笔记向量更新、状态与关闭 |
+| `backend/app/services/coordination.py` | Vault 写入互斥 |
+| `frontend/src/features/vault/VaultEntry.vue` | 等待提示、超时错误及重试 |
+| `frontend/src/stores/editor.ts` | 保存快照、状态及连续输入补存 |
+| `frontend/src/components/common/AppShell.vue` | 每轮请求结束后间隔 5 秒刷新索引状态 |
+
+## 一致性与恢复
+
+- 文件登记和保存的待处理标记与索引写入使用同一 SQLite 事务。
+- `workspace_vectors_pending=1` 表示工作区全量向量需要更新；`note_vectors_pending:<note_id>=1` 表示该笔记有待处理工作。
+- 模型推理在写锁外执行；提交前重新核对磁盘快照或笔记记录。版本不一致时不写入旧结果，后台循环重新处理。
+- 保存接口成功后，“已保存”代表正文和全文索引已写入，不代表向量已经就绪。向量不可用期间，语义检索可能尚未覆盖刚保存的内容。
+- 模型失败保留待处理标记，正文不会因后台失败回滚。重新打开 Vault 可再次调度；不是保证持续重试的生产任务队列。
+- 关闭后端会取消进程内后台任务；持久化标记保留。任务详情、活动任务 ID 和错误信息仍主要保存在内存，重启后不会保留完整任务历史。
+- 前端保存期间继续输入时，当前请求完成后仍保持 dirty，并安排后续自动保存；落盘失败显示 save_failed。
+
+## 状态与接口
+
+`GET /api/index/status` 新增 `vector_refresh_required: boolean`，表示仍有待处理标记。它与 `status` 一起使用：失败、等待和运行中都可能需要向量更新。`pending_jobs` 不是百分比或剩余笔记数。
+
+打开 Vault 请求超时为 15 秒；诊断和状态请求为 10 秒。超时表示前端停止等待，不保证服务端操作已经取消，不应因此认定保存成功或失败。
+
+## 验证方法
+
+在 backend 目录执行：
+
+```powershell
+uv run pytest tests/test_workspace.py tests/test_workspace_background.py -q -p no:cacheprovider
+```
+
+在 frontend 目录执行：
+
+```powershell
+pnpm exec vitest run src/services/apiClient.spec.ts src/stores/editorSave.spec.ts
+```
+
+回归覆盖：模型等待期间仍可打开工作区和创建目录、重复打开去重、快照变化重算、连续保存保留最新标题和标签、模型失败不回滚正文、重新打开恢复处理、请求超时及自动补存。
+
+手动联调请使用测试 Vault：新增 Markdown 后打开；计算期间修改并保存两次；重新打开确认最后内容；在隔离配置中模拟模型不可用，核对正文保留与索引错误分别显示。
+
+## 当前限制
+
+路径登记按磁盘与数据库的路径集合判断变化，不等同于完整外部文件监听。多进程后台调度、生产任务队列、完整失败历史和原生文件监听属于后续工作。不要把当前进程内互斥用于推断多实例安全性。

docs/development/扩展安装持久化与社区包开发说明.md

@@ -0,0 +1,45 @@
+# 扩展安装持久化与社区包开发说明
+
+> 本文档用于 Skill、Plugin 安装及社区示例包开发。
+>
+> 更新日期：2026-09-06。代码基线：`a5c44c4`；社区服务仍处于第三阶段规划。
+
+## 当前实现
+
+`backend/app/extensions/archive.py` 解析上传 ZIP，`installed.py` 为运行时增加本地安装日志。`extension-installations.sqlite3` 位于 data_dir 下，记录包路径、内容摘要、启用状态、插件授权及受管理目录；成功解压的包保存在 `extension-packages`，供后续命令读取。
+
+| 环节 | 行为 |
+| --- | --- |
+| 安装 ZIP | 最大 10 MiB，解压总量最大 50 MiB，最多 2048 条目 |
+| 路径检查 | 拒绝目录穿越、链接、特殊文件、加密条目、重复及大小写冲突路径 |
+| 包布局 | 根目录或唯一顶层目录包含 skill.yaml / plugin.yaml |
+| 重启恢复 | 校验目录和内容摘要后恢复安装状态；插件恢复授权 |
+| 包内容变化 | 不自动启用变化后的包，需重新安装并检查权限 |
+| 卸载 | 受管理 ZIP 目录可清理；用户目录安装源不删除 |
+
+安装持久化不等于操作系统级沙箱、签名验证或远程社区服务上线。生产隔离、社区发布治理与签名机制仍按第三阶段规划推进。
+
+## 社区示例
+
+源码与打包入口位于 `backend/extensions/community/`。`note-reviewer` 为笔记审阅 Skill，`markdown-workbench` 为可执行 Plugin。功能、安装和测试输入见该目录 README 与各包 README。
+
+重新打包：
+
+```powershell
+cd backend
+uv run python extensions/community/build_packages.py
+```
+
+仅在需要更新社区示例产物时执行，并核对 dist 中 ZIP 和 index.json 是否与源码一致。
+
+## 验证方法
+
+在 backend 目录执行：
+
+```powershell
+uv run pytest tests/test_extension_archive.py tests/test_installed_extensions.py tests/test_community_packages.py -q -p no:cacheprovider
+```
+
+手动使用测试数据目录安装示例包，启用并调用；重启后端后确认状态恢复。对包副本修改内容再重启，应出现恢复失败提示。卸载目录安装包时，原目录应继续存在。
+
+生产社区规划见 [第三阶段实施规划](../architecture/第三阶段实施规划.md)，命令和设置接口见 [Plugin Command 与 Settings 开发说明](Plugin-Command与Settings开发说明.md)。

docs/development/标题折叠与样式开发说明.md

@@ -0,0 +1,52 @@
+# 标题折叠与样式开发说明
+
+日期：2026-09-06。范围为工作区写作模式的章节折叠，以及正文标题外观偏好。
+
+## 1. 章节边界与交互
+
+H1–H6 标题旁在悬停时显示统一折叠箭头；键盘聚焦也显示，触摸设备保持可见。章节从标题之后开始，结束于同一容器内下一个同级或更高级标题；末尾没有后续内容的标题不显示按钮。引用等容器中的标题只影响所在容器，不折叠外部正文。
+
+- 工具栏使用单个按钮：有可见章节展开时显示“全部折叠”，否则显示“全部展开”。父章节隐藏的子章节不影响按钮判断，其自身折叠状态仍保留。无可折叠章节时按钮禁用。
+- 折叠父章节不会清空子章节的折叠状态。
+- 折叠时若选区在将隐藏的正文中，光标先移到标题。
+- 从大纲、查找或键盘跳到隐藏内容时，展开包含目标的章节，避免隐藏光标。
+- 折叠只影响当前编辑器视图，不修改 Markdown，不触发文档脏状态，也不占用撤销历史。重开文件恢复展开；源码模式与静态预览不进行章节折叠。
+
+实现位于 `headingFolding.ts`：插件状态保存标题位置，通过事务映射跟随文档编辑；删除或改成正文的标题会从状态中清理。Decoration 隐藏完整块，widget 提供可聚焦的折叠按钮。章节范围按标题栈计算，并按不可变文档缓存；隐藏范围合并后遍历节点，避免每个节点重复扫描全部标题。
+
+## 2. 标题样式设置
+
+入口为“设置 → 编辑器 → 标题样式”，主题页“编辑器外观”中也提供同一组件。
+
+- 默认跟随当前主题，不覆盖主题字号、字体与粗细。
+- 启用自定义后，分别调整 H1–H6 字号（12–72 px）和字重（400–800 的五个档位）。
+- 标题字体可跟随正文，或使用系统衬线、无衬线、等宽字体。
+- 面板即时预览，工作区正文和静态 Markdown 预览使用同一偏好。
+- 不影响笔记属性栏的标题、侧栏大纲字号或页面标题，不改写源文件中的标题级别。
+- “恢复跟随主题”清除自定义覆盖；主题页“恢复默认”也重置标题设置。
+
+偏好由 `headingAppearance` store 保存到本机 `editor-heading-appearance`。读取时校验字体枚举、字重与字号范围；应用 CSS 前再次规范化，避免空输入、无效存储或异常大数影响布局。刷新后恢复设置，切换主题保留自定义偏好。用户显式启用的覆盖只作用于 Markdown 标题，优先于主题规则；颜色继续跟随主题。
+
+## 3. 桌面命令预留
+
+既有 `editorCommandService` v1 增加三个可执行 ID：
+
+| 命令 | 行为 |
+| --- | --- |
+| editor.heading.toggle-fold | 切换选区所在章节的折叠状态 |
+| editor.heading.fold-all | 折叠所有有内容的章节 |
+| editor.heading.unfold-all | 展开所有章节 |
+
+均不需要参数，沿用活动文档、模式与冲突检查。原生快捷键仍由第三阶段容器绑定，此处不注册系统级快捷键。
+
+## 4. 验证
+
+```sh
+cd frontend
+npm run test -- src/features/editor/headingFolding.spec.ts src/features/editor/VisualMarkdownEditor.spec.ts src/features/editor/HeadingStyleSettings.spec.ts src/stores/headingAppearance.spec.ts
+npm run build
+```
+
+自动检查覆盖章节边界、嵌套容器、隐藏选区迁移、父子折叠状态、大纲目标展开、序列化保持、设置保存恢复、输入校验和面板恢复默认。
+
+手动检查：打开“功能演示 / 01 Markdown 与大纲”，依次折叠 H2 与 H1，再从大纲跳转；确认隐藏内容重新显示。打开设置调整 H1 字号与 H2 粗细，返回笔记检查外观，刷新后检查偏好仍在；关闭自定义后依次切换六个主题核对主题原有样式。

docs/development/模型隔离向量索引与增量登记.md

@@ -0,0 +1,30 @@
+# 模型隔离向量索引与增量登记
+
+## 目标与实现
+
+向量仍保存在本地 `app.db`，重启复用。`routed_block_vectors` 主键升级为 `(space_id, dimensions, block_id)`，同维度不同模型、同模型不同维度均独立存储。每个空间建立以模型标识和维度的 SHA-256 命名的 `vec0` 虚拟表，动态表名不包含厂商输入。
+
+首次访问旧空间时，在事务中将已有 JSON 向量转换为归一化 float32 索引，不重新调用 Embedding 模型。随后检索由 sqlite-vec 执行精确 KNN，避免每次在 Python 中解码所有向量、计算点积。该实现是精确搜索，不是 ANN；依据归一化向量的欧氏距离换算余弦分数。参见 [sqlite-vec KNN 文档](https://alexgarcia.xyz/sqlite-vec/features/knn.html)。
+
+覆盖检查和 KNN 使用同一事务。向量更新、删除及笔记级联删除通过触发器清理派生索引，新向量与原始向量在同一保存点写入。索引缺失或不完整仍明确失败/按已有策略回退，不混入其他模型结果。本地专用笔记按 `local_only` 元数据过滤，不同空间的结果继续使用 RRF 融合。
+
+数据库搜索及旧空间转换在线程中运行，不阻塞异步服务事件循环。首次转换仍会占用 SQLite 写事务；超大库应进一步评估迁移耗时。新增空间保留原空间索引，暂不自动清理历史空间。
+
+首次转换使用进程内迁移锁串行执行，在打开检索读快照之前以 `BEGIN IMMEDIATE` 获取写事务；等待迁移时不持有读事务，避免多个搜索从读锁升级写锁发生冲突。迁移完成后二次检查即可复用。普通检索和隐私分区检索共用该流程，已有索引的检索仅执行读取。
+
+首次转换同时通过 Vault 的异步写入锁与笔记保存、后台索引协调，避免保存事务读取旧 Block 后与迁移争抢写锁。等待是异步的；取消检索时，仍等待迁移线程结束后才释放锁。已就绪的空间直接走只读检查，不进入写入队列。写入锁按事件循环生命周期创建，避免重启后复用已关闭循环的锁。
+
+## 外部新增文件
+
+文件树检测到新增 Markdown 后先登记元数据与全文索引，然后为每条新笔记持久化 `note_vectors_pending:<note_id>`，逐笔记在后台计算。不再因新增文件设置全库重建标记；已存在的全库待处理标记仍保留，以免跳过之前未完成的任务。
+
+新增文件在推理期间再次变化时校验快照并重试，只同步该笔记。写入失败保留待处理标记。手动“重建全部”仍执行全库重建，正常重新打开已完成的工作区不再入队。
+
+## 验证
+
+- 隔离数据库运行后端全套测试：637 项通过；最终覆盖检查优化另运行检索及后台工作区回归，96 项通过。
+- 新增用例验证同模型不同维度并存、重新连接复用且查询不解码向量 JSON、旧表迁移只计算查询向量，以及外部新增文件不触发全量重建。
+- 并发迁移回归用同步事件暂停第一个请求的转换，同时发起第二个请求；验证普通/隐私分区路径均只迁移一次、两个请求结果一致，并开启 SQLite `query_only` 验证后续检索不会写入。相关检索与后台工作区测试 91 项通过。
+- 并发保存回归暂停迁移后发起实际 `update_note(..., defer_vectors=True)`，验证保存等待、事件循环仍可运行、放行迁移后正文成功落盘并保留新内容的向量待处理标记；另覆盖搜索被取消时不得提前放行保存。
+- `backend/scripts/vector-index-benchmark.py` 使用临时数据库、固定随机种子，比较 4000 条 384 维向量的 top-20，旧新路径结果顺序一致。5 次采样中位数：Python 扫描约 1289.64 ms，sqlite-vec 约 19.67 ms；首次转换约 1329.51 ms。该结果只测向量检索，不包含查询 Embedding、重排与 HTTP 耗时，不代表端到端加速比例。
+- 原始结果：[2026-09-06-sqlite-vec-search.json](performance/2026-09-06-sqlite-vec-search.json)。基准可用后端虚拟环境 Python 直接执行上述脚本，不读写用户 Vault。

docs/development/警告框与桌面编辑命令开发说明.md

@@ -0,0 +1,90 @@
+# 警告框与桌面编辑命令开发说明
+
+日期：2026-09-06。范围为前端渲染与命令边界；不包含 Tauri IPC、原生菜单或系统级快捷键注册。
+
+## 1. 格式与渲染
+
+使用引用块语法。GitHub 的 NOTE、TIP、IMPORTANT、WARNING、CAUTION 均可渲染；同时支持 Obsidian 的常用类型、别名、标题、嵌套与折叠。
+
+```markdown
+> [!WARNING]- 自定义标题
+> 提示正文，支持 **粗体**、`行内代码`、列表等 Markdown。
+>
+> > [!TIP]+ 嵌套提示
+> > 展开内容
+```
+
+无 `+` / `-` 时不可折叠；`+` 默认展开，`-` 默认折叠。点击折叠只改变本次显示状态，不自动改写源文件中的默认状态。标题作为文本显示，不执行 HTML。未知类型使用 note 外观并保留类型名。
+
+| 规范类型 | 兼容别名 |
+| --- | --- |
+| note | — |
+| abstract | summary、tldr |
+| info、todo | — |
+| tip | hint |
+| important | — |
+| success | check、done |
+| question | help、faq |
+| warning | caution、attention |
+| failure | fail、missing |
+| danger | error |
+| bug、example | — |
+| quote | cite |
+
+工作区顶部“提示框”选择器可插入模板。编辑器保留原生 blockquote 文档节点，以 NodeView 展示标题与折叠按钮，装饰隐藏标记；选区进入标记时显示原文以便修改。序列化仅取消引用首行提示标记的转义，避免保存后退回普通引用。代码中的标记不转换。写作模式会规范化 Markdown 转义；需要永久展示字面标记时使用行内代码或围栏代码。
+
+静态预览使用 marked 的 blockquote renderer，折叠使用原生 details / summary，内容仍经过 DOMPurify。两个入口共享 `callouts.ts` 与 `callouts.css`；颜色继承主题的 info、warning、success、error、surface 和 text 变量，不另存固定浅色配色。因此已有主题和符合主题规范的导入主题均可继承。
+
+## 2. 桌面命令边界 v1
+
+入口：`frontend/src/services/editorCommandService.ts`。
+
+- `editorCommandVersion`：当前版本 1。
+- `getEditorCommandCapabilities()`：返回每个稳定命令 ID 的 supported 与 enabled。预留 ID 不等于已经实现。
+- `executeEditorCommand(id, params?)`：返回 `{ ok: true }` 或 `{ ok: false, reason }`。reason 为 unsupported、unavailable、invalid-params、failed。
+- `registerEditorCommands(target)`：由活动编辑器注册处理器，返回注销函数。旧组件注销不清除替代组件的注册。
+
+成功表示处理器接受并执行了命令；具体格式操作仍遵循编辑器的选区规则。命令不直接写磁盘，变更进入既有脏状态、撤销与自动保存链路。无活动文件、源码模式、只读、冲突、编辑器加载中或文件已切换时禁用当前处理器。
+
+| 已接入 ID（统一加 editor. 前缀） | params |
+| --- | --- |
+| bold、italic、ordered-list、bullet-list、inline-code、code-block、inline-math、math-block、paragraph | 无 |
+| heading | 整数 1–6 |
+| font-size | 有限数值 8–96，单位 px；作用于选区 |
+| insert-markdown | 非空 Markdown 字符串，最多 100000 字符 |
+| callout | `{ type, title?, body?, fold? }`；fold 为空串、+ 或 -；标题不可换行 |
+
+目录还预留删除线、任务列表、引用、Mermaid、链接、图片、表格、分隔线、硬换行、引用式链接、HTML、撤销/重做，以及 `editor.import-note-properties`、`editor.metadata.edit`、`editor.metadata.title`、`editor.metadata.tags`。这些单独的处理器尚未接入，返回 unsupported；现阶段复杂格式可通过 insert-markdown 插入。元数据不得通过普通正文插入接口冒充属性导入。
+
+第三阶段由 Host 将原生菜单/快捷键映射到上述 ID。快捷键表需支持平台差异与用户改键，过滤表单、输入法组合与弹窗焦点；不要重复绑定浏览器和 Milkdown 已有按键。宿主只能调用允许的命令，不执行任意脚本。元数据处理器须按已有桌面需求完成无损 YAML 合并、版本检查、冲突提示及属性/正文一并撤销后才可标记 supported。
+
+## 3. 验证方法
+
+在 frontend 运行：
+
+```sh
+npm run test -- src/utils/callouts.spec.ts src/services/editorCommandService.spec.ts src/features/editor/VisualMarkdownEditor.spec.ts
+npm run build
+```
+
+- callouts：逐个类型与别名、大小写、嵌套、默认折叠、空正文、未知类型、标题注入、普通引用和代码排除。
+- 编辑器：初始解析、直接输入标记、按钮折叠、序列化往返、命令参数校验和冲突禁用。
+- 命令服务：能力查询、无活动目标、未知命令、未实现命令和旧目标注销隔离。
+- 启动开发服务器，访问 `/tests/visual/callouts.html?theme=paper-moments`；依次替换 light、dark、sepia、ocean-blue、midnight-purple。左右分别是工作区和静态预览，核对边框、标题、正文、嵌套与折叠；缩窄窗口检查换行。
+
+此项不宣称支持所有 Markdown 方言；脚注、定义列表、Wiki 双链及 `:::` 等其他警告框语法仍需独立扩展。原生快捷键和元数据转换属于第三阶段验收。
+
+## 4. 六主题适配补充
+
+主题新增 `--color-callout-info/success/warning/danger/important/quote` 六个语义变量。每种类型继续使用共享组件结构，标题、边框与淡色背景取同一语义配色。未知导入主题未定义这些变量时，默认继承其已有状态色。折叠标题补齐悬停、键盘焦点与不可折叠标题状态。
+
+| 主题 | 本次版本 | 外观 |
+| --- | --- | --- |
+| light、dark、sepia | 1.2.0 | 分别使用浅色、深色、暖色配色 |
+| paper-moments | 1.7.0 | 纸张边框、虚线内描边和轻投影；嵌套取消重复投影 |
+| ocean-blue | 1.4.0 | 海蓝与低亮度状态色 |
+| midnight-purple | 2.2.0 | 深色表面与高亮度状态色 |
+
+修正工作区基础选择器覆盖类型颜色的问题，默认色使用低优先级规则。社区预览 iframe 同步载入共享 callouts CSS，并展示 14 种规范类型、默认展开/折叠及嵌套样例。主题安装与预览使用同一 CSS 来源，纸间时光下载包的清单和样式同步更新；已安装旧版可通过主题页既有更新入口升级。
+
+验证增加六主题 × 六配色在实际 8% 混色背景上的标题对比度检查（至少 4.5:1），工作区选择器覆盖回归，以及六主题预览结构检查。此检查针对不透明 sRGB 配色，不代替每个平台的字体与截图验收。

docs/development/长文渲染优化与压测报告.md

@@ -0,0 +1,110 @@
+# 长文渲染优化与压测报告
+
+日期：2026-09-06。基线为 `750e172`，结果为本次未提交的渲染优化；基线和优化版使用相同样本、浏览器参数及操作序列。
+
+## 1. 测试环境与范围
+
+Windows、Intel Core i7-13620H、Headless Chrome 152，视口 1424 × 905，Vite 开发服务。每种规模重开测试页面三次，独立测试浏览器，不读写真实笔记。耗时基于 performance.now；打开指标不包含模块网络加载。样本含标题、表格、代码块、提示框和行内格式。
+
+实际汉字数为 25632、61172、122322；Markdown 总字符数以原始 JSON 为准。不是仅以文件字节数代替“字数”。共完成优化前后 18 轮浏览器运行，所有运行的插入内容与文末完整性检查通过。
+
+## 2. 本次优化
+
+- 标题装饰按不可变文档和折叠状态弱缓存；光标移动不改变折叠状态时复用结果。没有折叠范围时不遍历全文生成隐藏装饰。
+- 文档变更后用位置 Set 验证标题映射，避免对每个已折叠标题反复扫描所有标题。
+- 字号装饰按不可变文档弱缓存；提示框标记位置按文档缓存，光标移动只判断标记是否处于编辑范围。
+- 静态代码高亮增加 LRU，最多 64 项、累计 100 万个字符串字符；超过预算四分之一的单块不缓存。缓存同时包含深浅主题颜色，最终输出继续净化。缓存只在进程内，不写入存储。
+
+弱缓存随文档释放，不用全局 Map 持有历史文档；高亮缓存有明确上限。
+
+## 3. 对比结果
+
+单位 ms。打开取三轮中位数；选区、插入、折叠取各轮 P95 的中位数；热预览取六次热运行中位数。P95 样本量较少，仅用于本机前后比较。
+
+| 实际汉字数 | 打开 前→后 | 光标移动 P95 前→后 | 插入 P95 前→后 | 折叠/展开 P95 前→后 | 热预览 前→后 |
+| --- | --- | --- | --- | --- | --- |
+| 25632 | 272.1 → 218.6 | 1.9 → 0.6 | 7.0 → 6.9 | 55.0 → 45.6 | 40.0 → 26.6 |
+| 61172 | 519.7 → 447.5 | 5.7 → 0.6 | 9.7 → 9.6 | 149.1 → 145.5 | 82.9 → 55.6 |
+| 122322 | 875.4 → 869.1 | 11.9 → 1.2 | 22.2 → 27.2 | 256.6 → 263.9 | 140.2 → 95.5 |
+
+主要收益是减少光标移动的重复工作，以及重复代码块/重复预览的高亮开销。2.5 万汉字样本完成全部操作，但不以此宣称所有文档都能维持 60 FPS。
+
+12 万汉字的整篇折叠仍超过 250 ms，插入 P95 本轮反而增加，不能声称打字性能全面提升；全量 DOM 更新、编辑器自身处理与浏览器调度仍需进一步分项剖析。打开仍有长任务，缓存没有解决虚拟化问题。
+
+## 4. 原始数据与复现
+
+- [优化前 JSON](performance/2026-09-06-long-document-baseline.json)
+- [优化后 JSON](performance/2026-09-06-long-document-after.json)
+- [压测脚本与指标说明](../../frontend/tests/performance/README.md)
+
+```powershell
+npm --prefix frontend run test
+npm --prefix frontend run build
+npm --prefix frontend run dev -- --port 5175 --strictPort
+# 另一个终端：
+backend/.venv/Scripts/python.exe frontend/tests/performance/run-stress.py --url http://127.0.0.1:5175/tests/performance/stress.html --runs 3 --output .local-plans/stress-results.json
+```
+
+新增回归检查确认光标移动复用标题装饰、正文编辑使缓存失效、折叠与展开不残留隐藏内容。前端 402 项测试通过。
+
+## 5. 边界与后续
+
+本次测量是浏览器中的程序化编辑事务，不是输入法、实际键盘到屏幕显示、滚动帧率或生产包启动测试。样本代码块存在重复，LRU 收益不能直接外推到全部唯一代码块的文档。堆内存只采样，不作为内存泄漏结论。
+
+后续应针对 12 万字的输入和整篇折叠采集独立 CPU trace，评估装饰的增量映射及可见区域渲染；在输入法、表格与代码块编辑验收之前，不直接给 contenteditable 应用跳过布局或整篇虚拟化。
+
+## 6. 手动压测反馈后的滚动与定位修复
+
+用户实测：2.56 万字正常，6 万字快速滚动轻微停顿，12 万字明显卡顿；从长文末尾全部折叠没有回到顶层。
+
+本轮将“全部折叠”设为一次性把光标移到首个标题并将编辑区滚动到顶部，单个标题折叠保留原有定位行为。回归用例包含 100 个同级顶层标题，从文末触发后检查光标、scrollTop 与正文不变，避免只有一个 H1 的样本掩盖问题。
+
+语言标签改为只同步变动的代码块，语言菜单只在打开时响应滚动定位，并合并同一帧的重复事件；监听祖先滚动，卸载时清理监听及待执行帧。
+
+新增独立 CDP 滚轮测试，在相同的有限高度 flex 容器、纸间时光主题下，每档运行两次。下表为每次帧间隔 P95 的中位数，单位 ms，越小越好。这不是原先编辑事务基准的延续，也不是生产环境 FPS。
+
+| 请求汉字数 | 修改前 | 修改后 |
+| --- | ---: | ---: |
+| 25000 | 30.05 | 20.10 |
+| 60000 | 55.00 | 45.05 |
+| 120000 | 90.10 | 100.00 |
+
+两档较短样本有改善，12 万字没有改善，仍未达到流畅滚动的目标。CPU 采样显示滚入新代码块时的 CodeMirror 初始化、选区测量及 DOM 观察回调占用明显；不能仅凭此认定唯一原因。代码块布局隔离实验未带来收益，已撤回，未引入可能影响编辑、选区或布局的虚拟化。
+
+- [滚轮基线数据](performance/2026-09-06-scroll-baseline.json)
+- [滚轮修改后数据](performance/2026-09-06-scroll-after.json)
+
+下一步需要评估代码块按交互初始化或编辑器级虚拟化，并同时验证输入、选区、搜索定位和折叠；当前不将 12 万字滚动问题标记为完成。
+
+本轮前端 405 项测试通过，涵盖折叠定位、语言标签增量同步、菜单祖先滚动定位和卸载清理。
+
+## 7. CodeMirror 高亮复用实验
+
+在上轮提交 `874e916` 的基础上继续尝试：同一语言及主题的 CodeMirror LanguageSupport 内缓存高亮装饰，代码块离屏销毁后重新创建时，相同正文不再重复分词及构建装饰。缓存最多 32 项、64000 个源字符，超过 16000 字符的单块不缓存，使用 LRU 淘汰；语言支持释放时缓存一并释放。编辑后的内容按新正文计算，不复用旧位置。
+
+回归测试通过统计分词调用验证跨视图复用、正文编辑重新计算和超限淘汰。原有深浅主题切换与编辑测试继续验证显示内容。
+
+12 万字继续测量两次，帧间隔 P95 分别约 100.2 ms、90 ms，二者中位数约 95.1 ms；上一轮约 100 ms。样本重复代码较多，结果仍在明显波动范围内，不能宣称解决滚动卡顿。此优化减少确定可重复的高亮工作，但下一步仍须处理创建 CodeMirror 和布局测量的成本。
+
+- [本轮滚轮原始数据](performance/2026-09-06-scroll-token-cache.json)
+
+## 8. 主题对照与纸间时光 1.8.1 修复
+
+用户补充：同一份 12 万字文档在默认浅色、深色下不卡顿。因此重新进行主题对照，之前将 CodeMirror 作为主要优化方向的判断不足；CPU 采样中的布局及选区测量耗时不能单独证明编辑器是主要原因。
+
+保持相同文档和滚轮脚本，默认浅色、深色各测一次，P95 均约 30 ms。纸间时光 1.8.0 仅禁用整篇 `.ProseMirror` 的虚线 outline 后，两次 P95 约 30.1、30 ms；相比此前约 90–100 ms，构成明确的样式消融证据。主题与 CodeMirror 的交互仍可能影响布局，但不需要先用编辑器虚拟化解决这个差异。
+
+修复将贯穿长文的虚线轮廓改为四条小尺寸渐变平铺背景，保留纸张、缝线、胶带、段落横线和叠纸阴影。独立伪元素虚线 border 的实验反而更慢，已撤回。正式主题版本升为 1.8.1。
+
+| 主题或实验 | 次数 | 帧间隔 P95（ms） |
+| --- | ---: | --- |
+| 默认浅色 | 1 | 30 |
+| 默认深色 | 1 | 30 |
+| 1.8.0 仅禁用整篇 outline | 2 | 30.1、30 |
+| 1.8.1 平铺缝线 | 3 | 30.1、30、30.1 |
+
+1.8.1 三次测试的帧间隔中位数均为 10 ms，全部折叠后的 scrollTop 均为 0，光标位置均为 1。已检查视口截图，手账装饰保留。这里的结果说明本轮样本与环境下，纸间时光恢复到接近默认主题的滚动表现，不代表所有设备、所有复杂文档均无长任务。
+
+已安装主题保存在本地，不会自动被新版资源覆盖。刷新前端后，到“主题 → 社区主题 → 纸间时光”点击“更新”，确认版本 1.8.1 再进行手动复测。
+
+- [主题对比原始数据](performance/2026-09-06-scroll-theme-comparison.json)

frontend/README.md

@@ -41,6 +41,10 @@ pnpm dev
 
 编辑器使用 Milkdown/Crepe 与 CodeMirror 6；Markdown 展示使用 marked、DOMPurify 和 Shiki。Provider logo 位于 `src/assets/providers`，授权与来源说明随目录保存。
 
+写作模式支持按标题折叠章节及全部展开/折叠；“设置 → 编辑器 → 标题样式”可按 H1–H6 设置字号、粗细与标题字体。设置本地保存，不改写 Markdown；详见 [标题折叠与样式开发说明](../docs/development/标题折叠与样式开发说明.md)。
+
+工作区和静态预览支持 GitHub alerts / Obsidian callout 的类型、别名、标题、嵌套与折叠。桌面快捷键使用预留的 v1 编辑命令边界，尚未接入 Tauri 原生快捷键与元数据转换处理器；见 [警告框与桌面编辑命令开发说明](../docs/development/警告框与桌面编辑命令开发说明.md)。
+
 语言设置会即时更新主导航、页面标题和各功能页面，并同步更新文档与编辑器的 `lang`。拼写检查使用浏览器或桌面 WebView 提供的本地词典，开关会即时作用于可视化 Markdown、源码编辑器以及普通文本输入；JSON、密码等结构化或敏感输入保持关闭。
 
 ## 数据边界
@@ -78,3 +82,17 @@ pnpm build
 - 异步页面需要处理加载、空数据、后端错误、重复提交和迟到响应。
 - 功能行为或契约变化时，同一提交同步更新测试和相关文档。
 - 页面需求见[前端页面需求说明](../docs/contracts/前端页面需求说明-开发版.md)，后端行为以运行时 `/openapi.json` 为准。
+
+## 保存状态与图表联调（2026-09-06）
+
+“已保存”表示正文与全文索引请求成功；向量可能仍在后台计算。状态栏定期刷新索引状态；保存期间继续输入会补存。Vault 入口具有超时、错误与重试提示。
+
+Mermaid 大图打开时适配窗口，支持平滑滚轮缩放和鼠标位置补偿；行内中键启用滚轮控制，移动鼠标退出。标签段落样式与正文隔离，避免 foreignObject 内文字裁切。
+
+开发和验证方法见 [后台索引与保存](../docs/development/工作区后台索引与保存开发说明.md)、[Mermaid 预览与缩放](../docs/development/Mermaid预览与缩放开发说明.md)。
+
+## 构建体积检查
+
+执行 `pnpm build` 后运行 `pnpm build:report`，查看入口静态 JS 依赖与大块清单。分组策略、统计口径及保留的大资源见 [前端构建分块优化开发说明](../docs/development/前端构建分块优化开发说明.md)。
+
+Markdown 语法预设、主题适配和外部文件刷新规则见 [开发说明](../docs/development/Markdown语法预设与外部文件刷新.md)。

frontend/package.json

@@ -8,7 +8,8 @@
     "build": "vue-tsc -b && vite build",
     "test": "vitest run",
     "preview": "vite preview",
-    "type-check": "vue-tsc --noEmit"
+    "type-check": "vue-tsc --noEmit",
+    "build:report": "node scripts/build-size.mjs"
   },
   "dependencies": {
     "@codemirror/commands": "6.11.0",

frontend/scripts/build-size.mjs

@@ -0,0 +1,19 @@
+import { readFileSync } from 'node:fs'
+import { resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { gzipSync } from 'node:zlib'
+const root = fileURLToPath(new URL('../dist/', import.meta.url))
+const manifest = JSON.parse(readFileSync(resolve(root, '.vite/manifest.json'), 'utf8'))
+const files = new Map(Object.values(manifest).filter(x => x.file.endsWith('.js')).map(x => [x.file, x]))
+const sizes = file => { const bytes = readFileSync(resolve(root, file)); return { bytes: bytes.length, gzip: gzipSync(bytes).length } }
+const closure = key => {
+  const seen = new Set()
+  function visit(k) { if (seen.has(k)) return; seen.add(k); for (const i of manifest[k]?.imports ?? []) visit(i) }
+  visit(key)
+  return [...new Set([...seen].map(k => manifest[k]?.file).filter(f => f?.endsWith('.js')))]
+}
+const entries = Object.entries(manifest).filter(([key, value]) => value.isEntry || /(?:WorkspaceView|VisualMarkdownEditor|VaultEntry|ChatView)\.vue$/.test(key)).map(([key]) => {
+  const files = closure(key)
+  return { entry: key, files, bytes: files.reduce((n, f) => n + sizes(f).bytes, 0), gzip: files.reduce((n, f) => n + sizes(f).gzip, 0) }
+})
+console.log(JSON.stringify({ entries, largest: [...files.keys()].map(file => ({ file, ...sizes(file) })).sort((a,b) => b.bytes-a.bytes).slice(0,15), chunks: files.size }, null, 2))

frontend/src/assets/themes/paper-moments.theme

@@ -1,6 +1,6 @@
 theme_id: paper-moments
 name: 纸间时光 · Paper Moments
-version: 1.6.2
+version: 1.9.0
 author: NotesAgent
 description: 奶油纸张、手帐虚线与粉蓝胶带，把每天的灵感好好收藏。
 min_app_version: 0.2.0
@@ -9,6 +9,15 @@ css_entry: theme.css
 license: MIT
 ---
 [data-theme="paper-moments"] {
+  --color-markdown-selection: #ecd3c7;
+  --color-editor-scroll-background: #fff9e9;
+  --color-editor-scroll-text: #875343;
+  --color-callout-info: #406b7b;
+  --color-callout-success: #536f43;
+  --color-callout-warning: #875f25;
+  --color-callout-danger: #a34e42;
+  --color-callout-important: #805c7e;
+  --color-callout-quote: #6e6053;
   color-scheme: light;
   --color-background-primary: #faf7ee;
   --color-background-secondary: #f3eee3;
@@ -149,9 +158,13 @@ license: MIT
   padding: 44px 40px 60px 52px;
   border: 1px solid #685949;
   border-radius: 8px 16px 8px 8px;
-  outline: 1px dashed #c5b9a7;
-  outline-offset: -10px;
-  background: linear-gradient(90deg, transparent 32px, #e9cfc7 32px 34px, transparent 34px), #fffef8;
+  /* Small repeated tiles retain the stitching without a document-height dashed outline. */
+  background:
+    linear-gradient(#c5b9a7 50%, transparent 50%) 10px 0 / 1px 8px repeat-y,
+    linear-gradient(#c5b9a7 50%, transparent 50%) calc(100% - 10px) 0 / 1px 8px repeat-y,
+    linear-gradient(90deg, #c5b9a7 50%, transparent 50%) 0 10px / 8px 1px repeat-x,
+    linear-gradient(90deg, #c5b9a7 50%, transparent 50%) 0 calc(100% - 10px) / 8px 1px repeat-x,
+    linear-gradient(90deg, transparent 32px, #e9cfc7 32px 34px, transparent 34px), #fffef8;
   box-shadow: 6px 6px 0 #d8e6e2, 12px 12px 0 #f0d8cf;
 }
 [data-theme="paper-moments"] .milkdown-host .ProseMirror::before {
@@ -322,3 +335,15 @@ license: MIT
 /* Nested choices retain a quiet paper border without repeating tape/shadows. */
 [data-theme="paper-moments"] .surface-nested { border: 1px dashed #c5b9a7; background: #fffdf5; border-radius: 6px; }
 [data-theme="paper-moments"] .surface-nested.selected { border-color: var(--color-accent-primary); background: var(--color-accent-soft); }
+
+/* Callout paper: no tape over titles, no repeated shadows in nested blocks. */
+[data-theme="paper-moments"] .markdown-callout,
+[data-theme="paper-moments"] .milkdown .ProseMirror blockquote.markdown-callout {
+  border-radius: 10px 3px 10px 3px;
+  outline: 1px dashed color-mix(in srgb, var(--callout-color) 30%, transparent);
+  outline-offset: -6px;
+  box-shadow: 3px 3px 0 color-mix(in srgb, var(--callout-color) 12%, transparent);
+  padding: 14px 18px;
+}
+[data-theme="paper-moments"] .markdown-callout .markdown-callout { box-shadow: none; }
+[data-theme="paper-moments"] .markdown-callout > .callout-title { font-family: Georgia, 'Noto Serif SC', 'Songti SC', SimSun, serif; }

frontend/src/components/common/AppShell.vue

@@ -12,6 +12,8 @@ import TitleBar from './TitleBar.vue'
 import CommandPalette from './CommandPalette.vue'
 import { getIndexStatus } from '@/services/indexService'
 import { navigateToCitation } from '@/composables/useCitationNavigation'
+import { useWorkspaceRefresh } from '@/composables/useWorkspaceRefresh'
+useWorkspaceRefresh()
 
 defineProps<{
   showSecondarySidebar?: boolean
@@ -27,8 +29,9 @@ const router = useRouter()
 let statusTimer: ReturnType<typeof setTimeout> | undefined
 let disposed = false
 async function pollIndex() {
-  try { settingsStore.indexStatus = await getIndexStatus() } catch { /* retain last status; retry */ }
-  if (!disposed) statusTimer = setTimeout(pollIndex, 5000)
+  try { const status = await getIndexStatus(); if (!disposed) settingsStore.indexStatus = status } catch { /* retain last status; retry */ }
+  const busy = settingsStore.indexStatus.status === 'indexing' || settingsStore.indexStatus.active_searches
+  if (!disposed) statusTimer = setTimeout(pollIndex, busy || route.name === 'settings' || route.name === 'search' ? 1000 : 5000)
 }
 onMounted(() => { void settingsStore.loadDiagnostics(); void pollIndex() })
 onUnmounted(() => { disposed = true; clearTimeout(statusTimer) })

frontend/src/components/common/MarkdownContent.vue

@@ -3,6 +3,10 @@ import DiagramInteractions from './DiagramInteractions.vue'
 import { computed, ref, watch } from 'vue'
 import { renderMarkdown } from '@/utils/markdown'
 import { useThemeStore } from '@/stores/theme'
+import { useHeadingAppearanceStore } from '@/stores/headingAppearance'
+const headingAppearance = useHeadingAppearanceStore()
+import { useMarkdownPreferencesStore } from '@/stores/markdownPreferences'
+const markdownPreferences = useMarkdownPreferencesStore()
 
 const props = defineProps<{ source: string }>()
 const themeStore = useThemeStore()
@@ -12,15 +16,15 @@ let renderVersion = 0
 const diagramTheme = computed<'light' | 'dark'>(() => (themeStore.isDark ? 'dark' : 'light'))
 
 // 主题切换需要重渲染：Mermaid SVG 的配色在渲染时烘焙，无法靠 CSS 变量事后调整。
-watch([() => props.source, diagramTheme, () => themeStore.currentThemeId], async ([source, theme]) => {
+watch([() => props.source, diagramTheme, () => themeStore.currentThemeId, () => JSON.stringify(markdownPreferences.normalized)], async ([source, theme]) => {
   const version = ++renderVersion
-  const result = await renderMarkdown(source, { theme })
+  const result = await renderMarkdown(source, { theme, preferences: markdownPreferences.normalized })
   if (version === renderVersion) html.value = result
 }, { immediate: true, flush: 'post' })
 </script>
 
 <template>
-  <DiagramInteractions><div class="markdown-content" v-html="html" /></DiagramInteractions>
+  <DiagramInteractions :data-heading-style="headingAppearance.preferences.custom ? 'custom' : undefined" :style="headingAppearance.cssVariables"><div class="markdown-content" :data-code-wrap="markdownPreferences.normalized.wrapCode" :data-line-numbers="markdownPreferences.normalized.lineNumbers" :style="{ '--markdown-code-indent': markdownPreferences.normalized.indent }" v-html="html" /></DiagramInteractions>
 </template>
 
 <style>
@@ -32,12 +36,10 @@ watch([() => props.source, diagramTheme, () => themeStore.currentThemeId], async
 .markdown-content li::marker { color: var(--color-markdown-marker); font-weight: 700; }
 .markdown-content .shiki { overflow: auto; margin: .85em 0; padding: 16px; border: 1px solid var(--color-code-border); border-radius: 6px; background: var(--color-code-background) !important; color: var(--color-code-text); font-family: var(--font-ui-mono); font-size: .875em; line-height: 1.45; tab-size: 4; }
 .markdown-content code { padding: .1em .3em; border-radius: var(--radius-sm); background: var(--color-background-tertiary); font-family: var(--font-ui-mono); }
-.markdown-content .shiki code { display: block; min-width: max-content; padding: 0; background: transparent; font: inherit; }
 .markdown-content :not(pre) > code { background: var(--color-code-background); color: var(--color-code-text); border: 1px solid var(--color-code-border); }
 .markdown-content div.markdown-math { overflow-x: auto; padding-block: .5em; }
 .markdown-content h4, .markdown-content h5, .markdown-content h6 { margin: 1em 0 .5em; font-weight: 600; }
 .markdown-content input[type="checkbox"] { margin-right: .45em; accent-color: var(--color-accent-primary); }
-.markdown-content .shiki .line { display: block; min-height: 1.45em; }
 .markdown-content blockquote { padding-left: 1em; border-left: 3px solid var(--color-accent-primary); color: var(--color-text-secondary); }
 .markdown-content table { width: 100%; margin: .65em 0; border-collapse: collapse; }
 .markdown-content th, .markdown-content td { padding: .45em .65em; border: 1px solid var(--color-markdown-grid); text-align: left; }

frontend/src/components/common/PrimarySidebar.vue

@@ -1,7 +1,7 @@
 <script setup lang="ts">
 import { useRoute, useRouter } from 'vue-router'
 import { computed, ref } from 'vue'
-import { ArrowLeftBold, ArrowRightBold, Brush, ChatDotRound, CircleCheck, Connection, Cpu, FolderOpened, Lightning, Monitor, Search, Setting } from '@element-plus/icons-vue'
+import { ArrowLeftBold, ArrowRightBold, Brush, ChatDotRound, CircleCheck, Connection, Cpu, Document, FolderOpened, Lightning, Monitor, Search, Setting } from '@element-plus/icons-vue'
 import AppIcon from './AppIcon.vue'
 import { t } from '@/i18n'
 
@@ -20,6 +20,7 @@ const navItems = computed(() => [
   { name: 'plugins', icon: Connection, label: 'Plugin' },
   { name: 'mcp-servers', icon: Monitor, label: 'MCP' },
   { name: 'themes', icon: Brush, label: t('主题', 'Themes') },
+  { name: 'logs', icon: Document, label: t('日志', 'Logs') },
   { name: 'settings', icon: Setting, label: t('设置', 'Settings') },
 ])
 

frontend/src/components/common/StatusBar.vue

@@ -38,11 +38,7 @@ const saveStatusColor = computed(() => {
   return map[editorStore.saveStatus] || 'var(--color-text-tertiary)'
 })
 
-const indexStatusText = computed(() => {
-  const s = settingsStore.indexStatus.status
-  if (s === 'idle' && settingsStore.indexStatus.vector_refresh_required) return t('全文可用 · 向量待重建', 'Full text ready · vectors need rebuilding')
-  return s === 'unknown' ? t('索引状态未获取', 'Index status unavailable') : s === 'idle' ? t('索引就绪', 'Index ready') : s === 'indexing' ? t('后台计算索引', 'Indexing in background') : t('索引错误', 'Index error')
-})
+const indexStatusText = computed(() => settingsStore.indexStatusLabel)
 
 const aiCoreStatusText = computed(() => {
   const map: Record<string, string> = {
@@ -78,7 +74,7 @@ const showEditorInfo = computed(() => route.name === 'workspace')
         {{ saveStatusText }}
       </span>
       <span class="status-item" :title="indexStatusText">
-        <span class="status-dot" :style="{ background: settingsStore.indexStatus.status === 'error' ? 'var(--color-error)' : settingsStore.indexStatus.status === 'indexing' ? 'var(--color-warning)' : 'var(--color-success)' }" />
+        <span class="status-dot" :style="{ background: settingsStore.indexStatus.status === 'error' ? 'var(--color-error)' : settingsStore.indexStatus.status === 'unknown' ? 'var(--color-text-tertiary)' : settingsStore.indexStatus.status === 'indexing' || settingsStore.indexStatus.vector_refresh_required || settingsStore.indexStatus.active_searches ? 'var(--color-warning)' : 'var(--color-success)' }" />
         {{ indexStatusText }}
       </span>
       <span class="status-item" :style="{ color: aiCoreColor }">

frontend/src/composables/useWorkspaceRefresh.ts

@@ -0,0 +1,40 @@
+import { onMounted, onUnmounted } from 'vue'
+import { useWorkspaceStore } from '@/stores/workspace'
+import { useEditorStore } from '@/stores/editor'
+
+/** Web fallback until the desktop host supplies filesystem events. No overlapping polls. */
+export function useWorkspaceRefresh() {
+  const workspace = useWorkspaceStore()
+  const editor = useEditorStore()
+  let stopped = false
+  let running = false
+  let timer: ReturnType<typeof setTimeout> | undefined
+  async function refresh() {
+    if (running || stopped) return
+    clearTimeout(timer)
+    running = true
+    try {
+      if (document.visibilityState !== 'hidden' && workspace.hasVault) {
+        await workspace.refreshFileTree()
+        if (!stopped) {
+          if (editor.currentFilePath && editor.currentFilePath === workspace.activeFilePath && !workspace.activeFile) editor.setExternalChanged()
+          else await editor.checkExternalFile()
+        }
+      }
+    } catch { /* Keep the existing tree; the store exposes the error and retries. */ }
+    finally {
+      running = false
+      if (!stopped) timer = setTimeout(refresh, 2000)
+    }
+  }
+  onMounted(() => {
+    window.addEventListener('focus', refresh)
+    document.addEventListener('visibilitychange', refresh)
+    void refresh()
+  })
+  onUnmounted(() => {
+    stopped = true; clearTimeout(timer)
+    window.removeEventListener('focus', refresh)
+    document.removeEventListener('visibilitychange', refresh)
+  })
+}

frontend/src/contracts/index.ts

@@ -507,6 +507,11 @@ export interface ThemeConfig {
 // ============ Index ============
 
 export interface IndexStatus {
+  running_jobs?: number
+  active_searches?: number
+  completed_searches?: number
+  failed_searches?: number
+  cancelled_searches?: number
   vector_refresh_required?: boolean
   status: 'unknown' | 'idle' | 'indexing' | 'error'
   pending_jobs: number
@@ -801,6 +806,11 @@ export interface ApiTask {
 }
 
 export interface ApiIndexStatus {
+  running_jobs?: number
+  active_searches?: number
+  completed_searches?: number
+  failed_searches?: number
+  cancelled_searches?: number
   vector_refresh_required?: boolean
   total_notes: number
   total_blocks: number

frontend/src/features/agent/RunListPanel.vue

@@ -1,5 +1,5 @@
 <script setup lang="ts">
-import { onMounted, ref } from 'vue'
+import { computed, watch, onMounted, ref } from 'vue'
 import { useRouter } from 'vue-router'
 import { useAgentStore } from '@/stores/agent'
 import { localeTag, t } from '@/i18n'
@@ -8,6 +8,10 @@ import { runStatusLabel } from './labels'
 const agentStore = useAgentStore()
 const router = useRouter()
 const error = ref('')
+const page = ref(1)
+const pages = computed(() => Math.max(1, Math.ceil(agentStore.sortedRuns.length / 50)))
+const visibleRuns = computed(() => agentStore.sortedRuns.slice((page.value - 1) * 50, page.value * 50))
+watch(pages, count => { page.value = Math.min(page.value, count) })
 
 onMounted(async () => {
   try { await agentStore.loadRuns() } catch (reason) { error.value = reason instanceof Error ? reason.message : t('运行记录加载失败', 'Failed to load runs') }
@@ -20,8 +24,9 @@ function selectRun(runId: string) { void router.push({ name: 'agent', params: {
   <div class="sidebar-panel">
     <button class="button-primary new-button" @click="router.push({ name: 'agent' })">＋ {{ t('新建运行', 'New run') }}</button>
     <p v-if="error" class="subtle error-text">{{ error }}</p>
+    <div v-if="pages > 1" class="inline-actions"><button class="button-secondary" :disabled="page === 1" @click="page--">{{ t('上一页', 'Previous') }}</button><span>{{ page }} / {{ pages }}</span><button class="button-secondary" :disabled="page === pages" @click="page++">{{ t('下一页', 'Next') }}</button></div>
     <div class="sidebar-list">
-      <button v-for="run in agentStore.sortedRuns" :key="run.run_id" class="sidebar-list-item run-item"
+      <button v-for="run in visibleRuns" :key="run.run_id" class="sidebar-list-item run-item"
         :class="{ active: agentStore.activeRunId === run.run_id }" @click="selectRun(run.run_id)">
         <span class="badge" :class="{ success: run.status === 'completed', error: run.status === 'failed', warning: run.status === 'waiting_permission' }">{{ runStatusLabel(run.status) }}</span>
         <strong>{{ run.run_id.slice(0, 12) }}</strong><small>{{ run.started_at ? new Date(run.started_at).toLocaleString(localeTag()) : t('等待开始', 'Waiting to start') }}</small>

frontend/src/features/agent/TraceTimeline.spec.ts

@@ -41,6 +41,17 @@ async function switchToTree(wrapper: ReturnType<typeof mountTree>) {
 }
 
 describe('TraceTimeline 树形视图', () => {
+  it('bounds rendered events while searching the complete history', async () => {
+    const events = Array.from({ length: 1000 }, (_, i) => event('TextDelta', { text: `message-${i}` }))
+    const wrapper = mountTree(events)
+    expect(wrapper.findAll('.event-card')).toHaveLength(200)
+    await wrapper.findAll('button').find(button => button.text() === '下一页')!.trigger('click')
+    expect(wrapper.findAll('.event-card')).toHaveLength(200)
+    await wrapper.get('input').setValue('message-999')
+    expect(wrapper.findAll('.event-card')).toHaveLength(1)
+    expect(wrapper.text()).toContain('message-999')
+    wrapper.unmount()
+  })
   it('filters errors while retaining tree ancestors and final tool data', async () => {
     const events = sampleEvents()
     const result = events.find(item => item.event === 'ToolResult')!

frontend/src/features/agent/TraceTimeline.vue

@@ -1,6 +1,6 @@
 <script setup lang="ts">
 import { localeTag, t } from '@/i18n'
-import { computed, ref } from 'vue'
+import { computed, ref, watch } from 'vue'
 import type { TraceNode, AgentEvent } from '@/contracts'
 import { buildTraceNodes, getToolCallsFromEvents, getTotalDuration } from '@/services/traceService'
 import { eventLabel, localizeDetails } from './labels'
@@ -37,9 +37,12 @@ const filteredEvents = computed(() => {
 })
 const filteredTree = computed(() => {
   if (!filtering.value) return traceNodes.value
-  const matches = (node: TraceNode) => filteredEvents.value.some(event => event.sequence === node.sequence
-    || (node.type === 'tool_call' && node.data.tool_call_id != null && node.data.tool_call_id === event.data.tool_call_id)
-    || (node.type === 'model_call' && node.data.model_call_id != null && node.data.model_call_id === event.data.model_call_id))
+  const sequences = new Set(filteredEvents.value.map(event => event.sequence))
+  const tools = new Set<unknown>(filteredEvents.value.map(event => event.data.tool_call_id).filter(id => id != null))
+  const models = new Set<unknown>(filteredEvents.value.map(event => event.data.model_call_id).filter(id => id != null))
+  const matches = (node: TraceNode) => sequences.has(node.sequence)
+    || (node.type === 'tool_call' && tools.has(node.data.tool_call_id))
+    || (node.type === 'model_call' && models.has(node.data.model_call_id))
   const prune = (nodes: TraceNode[]): TraceNode[] => nodes.flatMap(node => {
     const children = prune(node.children)
     return matches(node) || children.length ? [{ ...node, children }] : []
@@ -50,6 +53,17 @@ function resetFilters() { query.value = ''; eventType.value = ''; toolName.value
 
 const traceNodes = computed(() => buildTraceNodes(props.events))
 const toolCalls = computed(() => getToolCallsFromEvents(props.events))
+const toolSummary = computed(() => {
+  const groups = new Map<string, { key: string; name: string; status: string; count: number; duration_ms: number }>()
+  for (const call of toolCalls.value) {
+    const key = `${call.name}:${call.status}`
+    const group = groups.get(key) ?? { key, name: call.name, status: call.status, count: 0, duration_ms: 0 }
+    group.count++
+    group.duration_ms += call.duration_ms ?? 0
+    groups.set(key, group)
+  }
+  return [...groups.values()]
+})
 const totalDuration = computed(() => getTotalDuration(props.events))
 
 const summaryStats = computed(() => {
@@ -153,6 +167,12 @@ function flatNodes(nodes: TraceNode[], depth = 0): Array<{ node: TraceNode; dept
 }
 
 const flatTrace = computed(() => flatNodes(filteredTree.value))
+const page = ref(1)
+const pageCount = computed(() => Math.max(1, Math.ceil((viewMode.value === 'tree' ? flatTrace.value.length : filteredEvents.value.length) / 200)))
+const visibleEvents = computed(() => filteredEvents.value.slice((page.value - 1) * 200, page.value * 200))
+const visibleTrace = computed(() => flatTrace.value.slice((page.value - 1) * 200, page.value * 200))
+watch([query, eventType, toolName, errorsOnly, viewMode], () => { page.value = 1 })
+watch(pageCount, count => { page.value = Math.min(page.value, count) })
 </script>
 
 <template>
@@ -199,11 +219,12 @@ const flatTrace = computed(() => flatNodes(filteredTree.value))
       <button v-if="filtering" class="button-secondary" @click="resetFilters">清除筛选</button>
       <span aria-live="polite">{{ filteredEvents.length }} / {{ events.length }} 事件</span>
     </div>
+    <nav v-if="pageCount > 1" class="inline-actions"><button class="button-secondary" :disabled="page === 1" @click="page--">{{ t('上一页', 'Previous') }}</button><span>{{ page }} / {{ pageCount }}</span><button class="button-secondary" :disabled="page === pageCount" @click="page++">{{ t('下一页', 'Next') }}</button></nav>
     <p v-if="filtering && !filteredEvents.length" class="subtle" role="status">没有匹配的事件</p>
     <div v-if="viewMode === 'timeline'" class="timeline-view">
       <div class="timeline">
         <article
-          v-for="event in filteredEvents"
+          v-for="event in visibleEvents"
           :key="event.sequence"
           class="event-card"
           :class="{ expanded: isDetailOpen(`event-${event.sequence}`) }"
@@ -255,7 +276,7 @@ const flatTrace = computed(() => flatNodes(filteredTree.value))
     </div>
 
     <div v-else class="tree-view">
-      <div v-for="item in flatTrace" :key="item.node.id" class="tree-node" :style="{ paddingLeft: `${item.depth * 24 + 8}px` }">
+      <div v-for="item in visibleTrace" :key="item.node.id" class="tree-node" :style="{ paddingLeft: `${item.depth * 24 + 8}px` }">
         <div
           class="node-row"
           :class="[getNodeStatusClass(item.node), { 'detail-open': isDetailOpen(item.node.id) }]"
@@ -303,9 +324,10 @@ const flatTrace = computed(() => flatNodes(filteredTree.value))
     <div v-if="!filtering && toolCalls.length > 0 && viewMode === 'timeline'" class="tool-calls-summary panel">
       <h3 class="panel-title">工具调用统计</h3>
       <div class="tool-call-list">
-        <div v-for="call in toolCalls" :key="call.tool_call_id" class="tool-call-item" :class="call.status">
+        <div v-for="call in toolSummary" :key="call.key" class="tool-call-item" :class="call.status">
           <span class="tool-status-dot"></span>
           <code class="tool-name">{{ call.name }}</code>
+          <span>{{ call.count }} {{ t('次', 'calls') }}</span>
           <span v-if="call.duration_ms != null" class="tool-duration">
             {{ formatDuration(call.duration_ms) }}
           </span>

frontend/src/features/editor/EditorHeader.spec.ts

@@ -0,0 +1,41 @@
+// @vitest-environment happy-dom
+import { mount, flushPromises } from '@vue/test-utils'
+import { createPinia, setActivePinia } from 'pinia'
+import { afterEach, expect, it, vi } from 'vitest'
+import EditorHeader from './EditorHeader.vue'
+import { useEditorStore } from '@/stores/editor'
+import { useWorkspaceStore } from '@/stores/workspace'
+import * as service from '@/services/workspaceService'
+afterEach(() => vi.restoreAllMocks())
+it('offers recovery for a missing file, supports cancel, and releases navigation after confirmation', async () => {
+ const pinia = createPinia(); setActivePinia(pinia)
+ vi.spyOn(service, 'getNoteId').mockResolvedValue('id')
+ const read = vi.spyOn(service, 'readFileContent').mockResolvedValue('original')
+ const editor = useEditorStore(), workspace = useWorkspaceStore()
+ await editor.loadFile('/removed.md'); workspace.openFile('/removed.md')
+ editor.updateContent('unsaved'); editor.setExternalChanged()
+ const wrapper = mount(EditorHeader, { global: { plugins: [pinia], stubs: { ActionDialog: { name: 'ActionDialog', template: '<div />', props: ['message'], emits: ['resolve'] } } } })
+ const close = () => wrapper.findAll('button').find(button => button.text() === '关闭当前笔记')!
+ try {
+  expect(wrapper.text()).toContain('原文件已删除或移动')
+  expect(wrapper.text()).not.toContain('重新加载外部版本')
+  expect(wrapper.text()).toContain('下载 Markdown 副本')
+  await close().trigger('click')
+  wrapper.findComponent({ name: 'ActionDialog' }).vm.$emit('resolve', null); await flushPromises()
+  expect(editor.content).toBe('unsaved')
+  await close().trigger('click')
+  wrapper.findComponent({ name: 'ActionDialog' }).vm.$emit('resolve', ''); await flushPromises()
+  expect(editor.currentFilePath).toBeNull(); expect(workspace.activeFilePath).toBeNull()
+  read.mockResolvedValue('another file')
+  await editor.loadFile('/other.md')
+  expect(editor.content).toBe('another file')
+ } finally { wrapper.unmount() }
+})
+it('does not discard text changed after confirmation was opened', async () => {
+ setActivePinia(createPinia())
+ const editor = useEditorStore()
+ editor.currentFilePath = '/removed.md'; editor.updateContent('before'); editor.setExternalChanged()
+ editor.updateContent('after')
+ expect(await editor.discardExternalChanges('/removed.md', 'before')).toBe(false)
+ expect(editor.content).toBe('after')
+})

frontend/src/features/editor/EditorHeader.vue

@@ -1,11 +1,39 @@
 <script setup lang="ts">
 import { useEditorStore } from '@/stores/editor'
 import { useWorkspaceStore } from '@/stores/workspace'
-import { computed } from 'vue'
+import { computed, ref } from 'vue'
+import ActionDialog from '@/components/common/ActionDialog.vue'
+import { useActionDialog } from '@/composables/useActionDialog'
 import { t } from '@/i18n'
 
 const editorStore = useEditorStore()
 const workspaceStore = useWorkspaceStore()
+const { actionDialog, resolveAction, askConfirm } = useActionDialog()
+const reloadError = ref('')
+const needsRecovery = computed(() => ['conflict', 'external_changed'].includes(editorStore.saveStatus))
+const missingFile = computed(() => needsRecovery.value && editorStore.currentFilePath === workspaceStore.activeFilePath && !workspaceStore.activeFile && !workspaceStore.treeRefreshError)
+function downloadCopy() {
+  const url = URL.createObjectURL(new Blob([editorStore.content], { type: 'text/markdown;charset=utf-8' }))
+  const link = document.createElement('a')
+  link.href = url
+  link.download = `${(editorStore.currentFilePath?.split('/').pop() ?? 'note.md').replace(/\.md$/i, '')}-recovered.md`
+  document.body.append(link); link.click(); link.remove()
+  setTimeout(() => URL.revokeObjectURL(url), 1000)
+}
+async function discard() {
+  const path = editorStore.currentFilePath, snapshot = editorStore.content
+  if (!path || !(await askConfirm(t('关闭将丢弃当前编辑内容。需要保留时，请先下载 Markdown 副本。确认关闭？', 'Closing discards the current editor content. Download a Markdown copy first if needed. Close?')))) return
+  if (!(await editorStore.discardExternalChanges(path, snapshot))) return
+  workspaceStore.closeFile(path)
+  workspaceStore.setActiveFile(null)
+  reloadError.value = ''
+}
+async function reload() {
+  const path = editorStore.currentFilePath, snapshot = editorStore.content
+  if (!(await askConfirm(t('重新加载会丢弃当前未保存内容。请先复制需要保留的文字。继续吗？', 'Reload discards unsaved edits. Copy any text you need to keep first. Continue?')))) return
+  if (path !== editorStore.currentFilePath || snapshot !== editorStore.content) return
+  try { await editorStore.reloadExternalFile(); reloadError.value = '' } catch (error) { reloadError.value = error instanceof Error ? error.message : '重新加载失败' }
+}
 
 const statusText = computed<Record<string, string>>(() => ({
   idle: t('空闲', 'Idle'), dirty: t('未保存', 'Unsaved'), saving: t('保存中…', 'Saving…'), saved: t('已保存', 'Saved'), save_failed: t('保存失败', 'Save failed'),
@@ -15,14 +43,20 @@ const statusText = computed<Record<string, string>>(() => ({
 
 <template>
   <header class="editor-header">
+    <ActionDialog v-if="actionDialog" v-bind="actionDialog" @resolve="resolveAction" />
     <div class="file-identity"><strong>{{ workspaceStore.activeFile?.name ?? t('未命名笔记', 'Untitled note') }}</strong><small>{{ workspaceStore.activeFilePath }}</small></div>
     <div class="editor-actions">
       <span class="save-status" :class="editorStore.saveStatus">{{ statusText[editorStore.saveStatus] }}</span>
+      <button v-if="needsRecovery && !missingFile" class="button-secondary" @click="reload">{{ t('重新加载外部版本', 'Reload external version') }}</button>
+      <span v-if="missingFile" class="save-status conflict">{{ t('原文件已删除或移动', 'Original file deleted or moved') }}</span>
+      <button v-if="needsRecovery" class="button-secondary" @click="downloadCopy">{{ t('下载 Markdown 副本', 'Download Markdown copy') }}</button>
+      <button v-if="needsRecovery" class="button-secondary" @click="discard">{{ t('关闭当前笔记', 'Close current note') }}</button>
+      <span v-if="reloadError" class="save-status conflict" role="alert">{{ reloadError }}</span>
       <div class="mode-switch" :aria-label="t('编辑模式', 'Editor mode')">
         <button type="button" :class="{ active: editorStore.mode === 'wysiwyg' }" @click="editorStore.setMode('wysiwyg')">{{ t('写作', 'Writing') }}</button>
         <button type="button" :class="{ active: editorStore.mode === 'source' }" @click="editorStore.setMode('source')">{{ t('源码', 'Source') }}</button>
       </div>
-      <button type="button" class="save-button" :disabled="editorStore.saveStatus === 'saving'" @click="editorStore.save">{{ t('保存', 'Save') }}</button>
+      <button type="button" class="save-button" :disabled="['saving','conflict','external_changed'].includes(editorStore.saveStatus)" @click="editorStore.save">{{ t('保存', 'Save') }}</button>
     </div>
   </header>
 </template>
@@ -40,6 +74,7 @@ const statusText = computed<Record<string, string>>(() => ({
 .file-identity { display: grid; min-width: 0; }
 .file-identity strong, .file-identity small { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
 .file-identity small { color: var(--color-text-tertiary); font-size: var(--font-size-xs); }
+.editor-actions { flex-wrap: wrap; justify-content: flex-end; }
 .editor-actions, .mode-switch { display: flex; align-items: center; gap: var(--space-sm); }
 .save-status { color: var(--color-text-tertiary); font-size: var(--font-size-xs); }
 .save-status.dirty, .save-status.external_changed { color: var(--color-warning); }

frontend/src/features/editor/EditorPane.vue

@@ -3,12 +3,14 @@ import { defineAsyncComponent, ref, watch } from 'vue'
 import { useEditorStore } from '@/stores/editor'
 import { useSettingsStore } from '@/stores/settings'
 import { useThemeStore } from '@/stores/theme'
+import EditorScrollButtons from './EditorScrollButtons.vue'
 const VisualMarkdownEditor = defineAsyncComponent(() => import('./VisualMarkdownEditor.vue'))
 
 const editorStore = useEditorStore()
 const settingsStore = useSettingsStore()
 const themeStore = useThemeStore()
 const sourceEditor = ref<HTMLTextAreaElement | null>(null)
+const container = ref<HTMLElement | null>(null)
 watch(() => editorStore.headingRequest, request => {
   const input = sourceEditor.value
   if (!request || !input || request.path !== editorStore.currentFilePath) return
@@ -24,13 +26,17 @@ function updateContent(event: Event) {
 </script>
 
 <template>
-  <VisualMarkdownEditor v-if="editorStore.mode === 'wysiwyg'" :key="`${editorStore.currentFilePath ?? 'empty'}:${themeStore.resolvedCodeBlockTheme}:${settingsStore.language}`"
+  <div ref="container" class="editor-scroll-pane">
+  <VisualMarkdownEditor v-if="editorStore.mode === 'wysiwyg'" :key="`${editorStore.currentFilePath ?? 'empty'}:${editorStore.contentRevision}:${themeStore.resolvedCodeBlockTheme}:${settingsStore.language}`"
     :initial-content="editorStore.content" />
   <textarea v-else ref="sourceEditor" class="editor-pane source" :value="editorStore.content" :spellcheck="settingsStore.spellCheck"
     :lang="settingsStore.language" :aria-label="settingsStore.language === 'en' ? 'Markdown source editor' : 'Markdown 源码编辑器'" @input="updateContent" />
+  <EditorScrollButtons :container="container" :content="editorStore.content" />
+  </div>
 </template>
 
 <style scoped>
+.editor-scroll-pane { position: relative; display: flex; flex-direction: column; flex: 1; min-height: 0; min-width: 0; overflow: hidden; }
 .editor-pane {
   box-sizing: border-box;
   flex: 1;

frontend/src/features/editor/EditorScrollButtons.spec.ts

@@ -0,0 +1,47 @@
+// @vitest-environment happy-dom
+import { afterEach, expect, it, vi } from 'vitest'
+import { mount } from '@vue/test-utils'
+import EditorScrollButtons from './EditorScrollButtons.vue'
+
+afterEach(() => { vi.useRealTimers(); vi.unstubAllGlobals(); document.body.innerHTML = '' })
+
+it('shows only useful directions, scrolls the editor, and hides empty or short documents', async () => {
+  vi.useFakeTimers()
+  vi.stubGlobal('matchMedia', () => ({ matches: false }))
+  const container = document.createElement('div')
+  const viewport = document.createElement('textarea')
+  viewport.className = 'source'
+  container.append(viewport)
+  document.body.append(container)
+  Object.defineProperty(viewport, 'scrollHeight', { configurable: true, value: 1000 })
+  Object.defineProperty(viewport, 'clientHeight', { configurable: true, value: 200 })
+  const scroll = vi.fn()
+  viewport.scrollTo = scroll
+  const wrapper = mount(EditorScrollButtons, { props: { container, content: 'A long note' } })
+  const update = async (top: number) => {
+    viewport.scrollTop = top
+    viewport.dispatchEvent(new Event('scroll'))
+    await vi.advanceTimersByTimeAsync(40)
+  }
+  try {
+    await update(0)
+    expect(wrapper.findAll('button')).toHaveLength(1)
+    expect(wrapper.find('button').attributes('aria-label')).toBe('滑动到底部')
+    await wrapper.find('button').trigger('click')
+    expect(scroll).toHaveBeenLastCalledWith({ top: 1000, behavior: 'smooth' })
+    await update(400)
+    expect(wrapper.findAll('button')).toHaveLength(2)
+    await update(800)
+    expect(wrapper.findAll('button')).toHaveLength(1)
+    expect(wrapper.find('button').attributes('aria-label')).toBe('滑动到顶部')
+    await wrapper.find('button').trigger('click')
+    expect(scroll).toHaveBeenLastCalledWith({ top: 0, behavior: 'smooth' })
+    await wrapper.setProps({ content: '  \n' })
+    await update(400)
+    expect(wrapper.findAll('button')).toHaveLength(0)
+    Object.defineProperty(viewport, 'scrollHeight', { value: 200 })
+    await wrapper.setProps({ content: 'Short note' })
+    await update(0)
+    expect(wrapper.findAll('button')).toHaveLength(0)
+  } finally { wrapper.unmount() }
+})

frontend/src/features/editor/EditorScrollButtons.vue

@@ -0,0 +1,62 @@
+<script setup lang="ts">
+import { computed, onBeforeUnmount, ref, watch } from 'vue'
+import { Top, Bottom } from '@element-plus/icons-vue'
+import AppIcon from '@/components/common/AppIcon.vue'
+import { t } from '@/i18n'
+
+const props = defineProps<{ container: HTMLElement | null; content: string }>()
+const hasContent = computed(() => !!props.content.trim())
+const canUp = ref(false), canDown = ref(false)
+let viewport: HTMLElement | null = null
+let frame = 0
+let mutation: MutationObserver | undefined
+let resize: ResizeObserver | undefined
+function update() {
+  frame = 0
+  const next = props.container?.querySelector<HTMLElement>('.milkdown-host, textarea.source') ?? null
+  if (next !== viewport) {
+    viewport?.removeEventListener('scroll', schedule)
+    resize?.disconnect()
+    viewport = next
+    viewport?.addEventListener('scroll', schedule, { passive: true })
+  }
+  if (viewport) {
+    resize?.observe(viewport)
+    for (const child of viewport.children) resize?.observe(child)
+    const document = viewport.querySelector('.ProseMirror')
+    if (document) resize?.observe(document)
+  }
+  const max = viewport ? viewport.scrollHeight - viewport.clientHeight : 0
+  const visible = hasContent.value && max > 2
+  canUp.value = visible && viewport!.scrollTop > 2
+  canDown.value = visible && viewport!.scrollTop < max - 2
+}
+function schedule() { if (!frame) frame = requestAnimationFrame(update) }
+function scroll(to: 'top' | 'bottom') {
+  viewport?.scrollTo({ top: to === 'top' ? 0 : viewport.scrollHeight,
+    behavior: window.matchMedia('(prefers-reduced-motion: reduce)').matches ? 'auto' : 'smooth' })
+}
+watch(() => props.container, container => {
+  mutation?.disconnect()
+  resize?.disconnect()
+  mutation = new MutationObserver(schedule)
+  resize = new ResizeObserver(schedule)
+  if (container) mutation.observe(container, { childList: true, subtree: true, characterData: true, attributes: true })
+  schedule()
+}, { immediate: true, flush: 'post' })
+watch(() => props.content, schedule)
+onBeforeUnmount(() => {
+  cancelAnimationFrame(frame)
+  mutation?.disconnect()
+  resize?.disconnect()
+  viewport?.removeEventListener('scroll', schedule)
+})
+</script>
+
+<template>
+  <div v-if="canUp || canDown" class="editor-scroll-buttons" :aria-label="t('文档滚动', 'Document scrolling')">
+    <button v-if="canUp" type="button" class="button-secondary" :title="t('滑动到顶部', 'Scroll to top')" :aria-label="t('滑动到顶部', 'Scroll to top')" @click="scroll('top')"><AppIcon :icon="Top" :size="20" /></button>
+    <button v-if="canDown" type="button" class="button-secondary" :title="t('滑动到底部', 'Scroll to bottom')" :aria-label="t('滑动到底部', 'Scroll to bottom')" @click="scroll('bottom')"><AppIcon :icon="Bottom" :size="20" /></button>
+  </div>
+</template>
+

frontend/src/features/editor/HeadingStyleSettings.spec.ts

@@ -0,0 +1,20 @@
+// @vitest-environment happy-dom
+import { expect, it } from 'vitest'
+import { mount } from '@vue/test-utils'
+import { createPinia } from 'pinia'
+import HeadingStyleSettings from './HeadingStyleSettings.vue'
+it('previews individual heading settings and restores theme inheritance', async () => {
+  localStorage.clear()
+  const wrapper = mount(HeadingStyleSettings, { global: { plugins: [createPinia()] } })
+  try {
+    expect(wrapper.get('input[aria-label="H1 字号"]').attributes('disabled')).toBeDefined()
+    await wrapper.get('input[type="checkbox"]').setValue(true)
+    await wrapper.get('input[aria-label="H1 字号"]').setValue(42)
+    await wrapper.get('select[aria-label="H1 粗细"]').setValue('400')
+    expect(wrapper.get('.heading-style-preview').attributes('style')).toContain('--heading-1-size: 42px')
+    expect(wrapper.get('.heading-style-preview').attributes('style')).toContain('--heading-1-weight: 400')
+    await wrapper.get('button').trigger('click')
+    expect(wrapper.get('.heading-style-preview').attributes('data-heading-style')).toBeUndefined()
+    expect(wrapper.get('.heading-style-preview').attributes('style') ?? '').not.toContain('--heading-1-size')
+  } finally { wrapper.unmount() }
+})

frontend/src/features/editor/HeadingStyleSettings.vue

@@ -0,0 +1,37 @@
+<script setup lang="ts">
+import { useHeadingAppearanceStore } from '@/stores/headingAppearance'
+import { t } from '@/i18n'
+const appearance = useHeadingAppearanceStore()
+</script>
+
+<template>
+  <details class="ui-disclosure heading-style-settings">
+    <summary>{{ t('标题样式', 'Heading styles') }}</summary>
+    <div class="heading-settings-body">
+      <label><input v-model="appearance.preferences.custom" type="checkbox" /> {{ t('自定义标题样式', 'Customize heading styles') }}</label>
+      <p class="subtle">{{ t('关闭时跟随主题。设置作用于正文 H1–H6，不改写 Markdown，也不改变笔记属性标题。', 'Disable to follow the theme. Applies to document H1–H6 without rewriting Markdown or the metadata title.') }}</p>
+      <label>{{ t('标题字体', 'Heading font') }}
+        <select v-model="appearance.preferences.family" class="select" :disabled="!appearance.preferences.custom">
+          <option value="inherit">{{ t('跟随正文', 'Follow body') }}</option><option value="serif">{{ t('衬线字体', 'Serif') }}</option><option value="sans-serif">{{ t('无衬线字体', 'Sans serif') }}</option><option value="monospace">{{ t('等宽字体', 'Monospace') }}</option>
+        </select>
+      </label>
+      <div v-for="(level, index) in appearance.preferences.levels" :key="index" class="heading-setting-row">
+        <strong>H{{ index + 1 }}</strong>
+        <label>{{ t('字号 px', 'Size px') }}<input v-model.number="level.size" class="input" type="number" min="12" max="72" :disabled="!appearance.preferences.custom" :aria-label="`H${index + 1} ${t('字号', 'size')}`" /></label>
+        <label>{{ t('粗细', 'Weight') }}<select v-model.number="level.weight" class="select" :disabled="!appearance.preferences.custom" :aria-label="`H${index + 1} ${t('粗细', 'weight')}`"><option :value="400">{{ t('常规', 'Regular') }}</option><option :value="500">Medium</option><option :value="600">Semibold</option><option :value="700">{{ t('加粗', 'Bold') }}</option><option :value="800">Extra bold</option></select></label>
+      </div>
+      <button class="button-secondary" type="button" @click="appearance.reset">{{ t('恢复跟随主题', 'Restore theme defaults') }}</button>
+      <div class="heading-style-preview" :data-heading-style="appearance.preferences.custom ? 'custom' : undefined" :style="appearance.cssVariables">
+        <div class="markdown-content"><component :is="`h${index + 1}`" v-for="(_, index) in appearance.preferences.levels" :key="index">H{{ index + 1 }} {{ t('标题预览', 'Heading preview') }}</component></div>
+      </div>
+    </div>
+  </details>
+</template>
+
+<style scoped>
+.heading-settings-body { display: grid; gap: 14px; padding: 16px; }
+.heading-setting-row { display: grid; grid-template-columns: 40px minmax(0, 1fr) minmax(0, 1fr); gap: 12px; align-items: end; }
+.heading-setting-row label { display: grid; gap: 6px; min-width: 0; }
+.heading-setting-row strong { align-self: center; }
+.heading-style-preview { border: 1px solid var(--color-border-default); border-radius: var(--radius-md); padding: 16px; overflow-wrap: anywhere; background: var(--color-surface-primary); color: var(--color-text-primary); }
+</style>

frontend/src/features/editor/MarkdownPreferenceSettings.vue

@@ -0,0 +1,45 @@
+<script setup lang="ts">
+import { ref } from 'vue'
+import { useMarkdownPreferencesStore, markdownPresets } from '@/stores/markdownPreferences'
+import { t } from '@/i18n'
+const store = useMarkdownPreferencesStore()
+const name = ref('')
+const error = ref('')
+function save() { error.value = store.savePreset(name.value) ? '' : t('请输入名称，最多保存 20 个预设。', 'Enter a name; up to 20 presets.'); if (!error.value) name.value = '' }
+</script>
+<template>
+  <section class="markdown-preferences surface-nested">
+    <h3>{{ t('Markdown 语法与编辑预设', 'Markdown syntax and editing presets') }}</h3>
+    <p class="subtle">{{ t('语法和代码设置在下次打开写作编辑器时应用；不批量改写已有笔记。静态预览即时更新。', 'Syntax and code settings apply when the visual editor next opens; existing notes are not rewritten in bulk. Static previews update immediately.') }}</p>
+    <div class="inline-actions"><button class="button-secondary" @click="store.apply(markdownPresets.extended)">{{ t('扩展 Markdown', 'Extended Markdown') }}</button><button class="button-secondary" @click="store.apply(markdownPresets.github)">GitHub</button><button class="button-secondary" @click="store.apply(markdownPresets.plain)">{{ t('基础 Markdown', 'Basic Markdown') }}</button></div>
+    <div class="form-grid">
+      <label>{{ t('标题语法', 'Heading syntax') }}<select v-model="store.preferences.heading" class="select"><option value="atx">ATX (#)</option><option value="setext">Setext (=== / ---)</option></select></label>
+      <label>{{ t('无序列表', 'Bullet list') }}<select v-model="store.preferences.bullet" class="select"><option>-</option><option>*</option><option>+</option></select></label>
+      <label>{{ t('有序列表', 'Ordered list') }}<select v-model="store.preferences.incrementList" class="select"><option :value="true">1. 2. 3.</option><option :value="false">1. 1. 1.</option></select></label>
+      <label>{{ t('代码围栏', 'Code fence') }}<select v-model="store.preferences.fence" class="select"><option value="`">```</option><option value="~">~~~</option></select></label>
+    </div>
+    <p class="subtle">{{ t('Setext 适用于 H1/H2，H3–H6 仍使用 #。写作模式保存时会规范化整篇正文的标记；源码模式保留手写语法。', 'Setext applies to H1/H2; H3–H6 use #. Visual-mode saves normalize document markers; source mode preserves handwritten syntax.') }}</p>
+    <div class="markdown-switches">
+      <label><input v-model="store.preferences.autoLinks" type="checkbox" />{{ t('自动识别裸链接', 'Recognize bare URLs') }}</label>
+      <label><input v-model="store.preferences.math" type="checkbox" />{{ t('数学公式', 'Math') }}</label>
+      <label><input v-model="store.preferences.callouts" type="checkbox" />{{ t('警告框与提示框', 'Alerts and callouts') }}</label>
+      <label><input v-model="store.preferences.diagrams" type="checkbox" />Mermaid</label>
+      <label><input v-model="store.preferences.lineNumbers" type="checkbox" />{{ t('代码行号', 'Code line numbers') }}</label>
+      <label><input v-model="store.preferences.wrapCode" type="checkbox" />{{ t('代码自动换行', 'Wrap code') }}</label>
+    </div>
+    <div class="form-grid">
+      <label>{{ t('代码缩进', 'Code indent') }}<select v-model.number="store.preferences.indent" class="select"><option :value="2">2</option><option :value="4">4</option><option :value="8">8</option></select></label>
+      <label>{{ t('新建代码块默认语言', 'Default language for new code blocks') }}<input v-model="store.preferences.defaultLanguage" class="input" maxlength="40" placeholder="python" /></label>
+    </div>
+    <form class="inline-actions" @submit.prevent="save"><input v-model="name" class="input" maxlength="40" :aria-label="t('预设名称', 'Preset name')" :placeholder="t('我的预设名称', 'My preset name')" /><button class="button-primary">{{ t('保存为预设', 'Save preset') }}</button></form>
+    <p v-if="error" class="error-banner" role="alert">{{ error }}</p>
+    <div v-for="(preset, index) in store.customPresets" :key="preset.name" class="inline-actions"><strong>{{ preset.name }}</strong><button class="button-secondary" @click="store.apply(preset.preferences)">{{ t('应用', 'Apply') }}</button><button class="button-danger" @click="store.customPresets.splice(index, 1)">{{ t('删除', 'Delete') }}</button></div>
+  </section>
+</template>
+<style scoped>
+.markdown-preferences { display: grid; gap: 16px; padding: 16px; margin-block: 16px; }
+.markdown-preferences .form-grid > label { display: grid; gap: 6px; min-width: 0; }
+.markdown-switches { display: grid; grid-template-columns: repeat(auto-fit,minmax(190px,1fr)); gap: 12px; }
+.markdown-switches label { display: flex; align-items: center; gap: 8px; }
+.inline-actions { flex-wrap: wrap; }
+</style>

frontend/src/features/editor/VisualMarkdownEditor.spec.ts

@@ -13,6 +13,10 @@ import { useThemeStore } from '@/stores/theme'
 import { codeBlockConfig } from '@milkdown/kit/component/code-block'
 import { EditorView as CodeMirror } from '@codemirror/view'
 import { renderMarkdown } from '@/utils/markdown'
+import { useEditorStore } from '@/stores/editor'
+import { executeEditorCommand } from '@/services/editorCommandService'
+import { headingFoldKey } from './headingFolding'
+import { useMarkdownPreferencesStore } from '@/stores/markdownPreferences'
 
 type EditorComponent = { getEditor: () => Editor | undefined }
 
@@ -51,6 +55,161 @@ afterEach(() => {
 })
 
 describe('VisualMarkdownEditor formatting toolbars', () => {
+  it('opens a rendered Markdown link on Ctrl click without changing its source', async () => {
+    const wrapper = mount(VisualMarkdownEditor, {
+      props: { initialContent: '[**文档**](https://example.com/docs)' }, attachTo: document.body,
+    })
+    mounted.push(wrapper)
+    const editor = await waitForEditor(wrapper)
+    const before = editor.action(getMarkdown())
+    const open = vi.spyOn(window, 'open').mockReturnValue(null)
+    try {
+      const link = wrapper.get('.ProseMirror a')
+      await link.trigger('click', { ctrlKey: true, button: 0 })
+      expect(open).toHaveBeenCalledWith('https://example.com/docs', '_blank', 'noopener,noreferrer')
+      expect(editor.action(getMarkdown())).toBe(before)
+    } finally { open.mockRestore() }
+  })
+
+  it('applies syntax and renderer preferences when opening the visual editor', async () => {
+    const preferences = useMarkdownPreferencesStore()
+    preferences.preferences.heading = 'setext'
+    preferences.preferences.bullet = '+'
+    preferences.preferences.fence = '~'
+    preferences.preferences.callouts = false
+    preferences.preferences.math = false
+    preferences.preferences.autoLinks = false
+    const wrapper = mount(VisualMarkdownEditor, { props: { initialContent: '# Heading\n\n- first\n- second\n\n> [!NOTE]\n> text\n\nhttps://example.com\n\n```text\ncode\n```' }, attachTo: document.body })
+    mounted.push(wrapper)
+    const editor = await waitForEditor(wrapper)
+    const result = editor.action(getMarkdown())
+    expect(result).toContain('Heading\n===')
+    expect(result).toContain('+ first')
+    expect(result).toContain('~~~text')
+    expect(wrapper.find('.markdown-callout').exists()).toBe(false)
+    expect(wrapper.find('.ProseMirror a').exists()).toBe(false)
+  })
+  it('folds heading sections, retains nested state and opens hidden outline targets', async () => {
+    const source = '# A\n\nbody\n\n## B\n\nchild\n\n# C\n\nvisible'
+    const wrapper = mount(VisualMarkdownEditor, { props: { initialContent: source }, attachTo: document.body })
+    mounted.push(wrapper)
+    const editor = await waitForEditor(wrapper)
+    await wrapper.get('.heading-fold-toggle[aria-label="折叠 H2 B"]').trigger('click')
+    await wrapper.get('.heading-fold-toggle[aria-label="折叠 H1 A"]').trigger('click')
+    expect(wrapper.findAll('.heading-fold-hidden').length).toBeGreaterThan(1)
+    await wrapper.get('.heading-fold-toggle[aria-label="展开 H1 A"]').trigger('click')
+    expect(wrapper.get('.heading-fold-toggle[aria-label="展开 H2 B"]').attributes('aria-expanded')).toBe('false')
+    editor.action(ctx => {
+      const view = ctx.get(editorViewCtx)
+      let position = 0
+      view.state.doc.descendants((node, pos) => { if (node.isText && node.text === 'child') position = pos })
+      view.dispatch(view.state.tr.setSelection(TextSelection.create(view.state.doc, position)))
+      expect(headingFoldKey.getState(view.state)?.size).toBe(0)
+    })
+    expect(wrapper.find('.heading-fold-hidden').exists()).toBe(false)
+    expect(editor.action(getMarkdown()).trim()).toBe(source)
+    await wrapper.get('button[aria-label="折叠所有章节"]').trigger('click')
+    expect(wrapper.findAll('.section-actions button')).toHaveLength(1)
+    expect(wrapper.get('.section-actions button').text()).toBe('全部展开')
+    await wrapper.get('.heading-fold-toggle[aria-label="展开 H1 C"]').trigger('click')
+    expect(wrapper.get('.section-actions button').text()).toBe('全部折叠')
+    await wrapper.get('button[aria-label="折叠所有章节"]').trigger('click')
+    await wrapper.get('button[aria-label="展开所有章节"]').trigger('click')
+    expect(wrapper.get('.section-actions button').text()).toBe('全部折叠')
+    expect(wrapper.find('.heading-fold-hidden').exists()).toBe(false)
+  })
+  it('reuses heading decorations for cursor-only moves and invalidates them for folds and edits', async () => {
+    const wrapper = mount(VisualMarkdownEditor, { props: { initialContent: '# A\n\nfirst paragraph\n\nsecond paragraph' }, attachTo: document.body })
+    mounted.push(wrapper)
+    const editor = await waitForEditor(wrapper)
+    editor.action(ctx => {
+      const view = ctx.get(editorViewCtx), plugin = headingFoldKey.get(view.state)!
+      const decorations = () => plugin.props.decorations!.call(plugin, view.state)
+      const initial = decorations()
+      view.dispatch(view.state.tr.setSelection(TextSelection.create(view.state.doc, 6)))
+      expect(decorations()).toBe(initial)
+      view.dispatch(view.state.tr.insertText('新增'))
+      expect(decorations()).not.toBe(initial)
+    })
+    await wrapper.get('.section-actions button').trigger('click')
+    expect(wrapper.find('.heading-fold-hidden').exists()).toBe(true)
+    await wrapper.get('.section-actions button').trigger('click')
+    expect(wrapper.find('.heading-fold-hidden').exists()).toBe(false)
+  })
+  it('returns to the top after collapsing many sibling chapters from the document end', async () => {
+    const source = Array.from({ length: 100 }, (_, i) => `# Chapter ${i}\n\nBody ${i}`).join('\n\n')
+    const wrapper = mount(VisualMarkdownEditor, { props: { initialContent: source }, attachTo: document.body })
+    mounted.push(wrapper)
+    const editor = await waitForEditor(wrapper)
+    editor.action(ctx => {
+      const view = ctx.get(editorViewCtx)
+      view.dispatch(view.state.tr.setSelection(TextSelection.near(view.state.doc.resolve(view.state.doc.content.size - 1))))
+    })
+    const viewport = wrapper.get('.milkdown-host').element as HTMLElement
+    viewport.scrollTop = 5000
+    await wrapper.get('.section-actions button').trigger('click')
+    expect(viewport.scrollTop).toBe(0)
+    editor.action(ctx => expect(ctx.get(editorViewCtx).state.selection.from).toBe(1))
+    expect(editor.action(getMarkdown()).trim()).toBe(source)
+  })
+  it('offers expand all when individually collapsed parents hide expanded children', async () => {
+    const source = '# A\n\nbody\n\n## B\n\nchild\n\n# C\n\nbody'
+    const wrapper = mount(VisualMarkdownEditor, { props: { initialContent: source }, attachTo: document.body })
+    mounted.push(wrapper)
+    const editor = await waitForEditor(wrapper)
+    await wrapper.get('.heading-fold-toggle[aria-label="折叠 H1 A"]').trigger('click')
+    expect(wrapper.get('.section-actions button').text()).toBe('全部折叠')
+    await wrapper.get('.heading-fold-toggle[aria-label="折叠 H1 C"]').trigger('click')
+    expect(wrapper.get('.section-actions button').text()).toBe('全部展开')
+    expect(wrapper.get('.heading-fold-toggle[aria-label="折叠 H2 B"]').attributes('aria-expanded')).toBe('true')
+    await wrapper.get('.heading-fold-toggle[aria-label="展开 H1 A"]').trigger('click')
+    expect(wrapper.get('.section-actions button').text()).toBe('全部折叠')
+    expect(wrapper.get('.heading-fold-toggle[aria-label="折叠 H2 B"]').attributes('aria-expanded')).toBe('true')
+    await wrapper.get('.heading-fold-toggle[aria-label="折叠 H1 A"]').trigger('click')
+    await wrapper.get('.section-actions button').trigger('click')
+    expect(wrapper.find('.heading-fold-hidden').exists()).toBe(false)
+    expect(wrapper.get('.section-actions button').text()).toBe('全部折叠')
+    expect(editor.action(getMarkdown()).trim()).toBe(source)
+  })
+  it('renders and folds callouts without losing portable Markdown on serialization', async () => {
+    const source = '> [!WARNING]- 注意\n>\n> **正文**\n>\n> > [!TIP] 内层\n> > 内容'
+    const wrapper = mount(VisualMarkdownEditor, { props: { initialContent: source }, attachTo: document.body })
+    mounted.push(wrapper)
+    const editor = await waitForEditor(wrapper)
+    expect(wrapper.findAll('.markdown-callout')).toHaveLength(2)
+    expect(wrapper.get('.markdown-callout').attributes('data-collapsed')).toBe('true')
+    await wrapper.get('.callout-title').trigger('click')
+    expect(wrapper.get('.markdown-callout').attributes('data-collapsed')).toBe('false')
+    const markdown = editor.action(getMarkdown())
+    expect(markdown.trim()).toBe(source)
+  })
+  it('dispatches native-ready commands through editor transactions and rejects invalid parameters', async () => {
+    useEditorStore().currentFilePath = 'test.md'
+    const wrapper = mount(VisualMarkdownEditor, { props: { initialContent: 'text' }, attachTo: document.body })
+    mounted.push(wrapper)
+    const editor = await waitForEditor(wrapper)
+    expect(await executeEditorCommand('editor.heading', 8)).toEqual({ ok: false, reason: 'invalid-params' })
+    expect(await executeEditorCommand('editor.heading', 2)).toEqual({ ok: true })
+    expect(editor.action(getMarkdown())).toContain('## text')
+    expect(await executeEditorCommand('editor.callout', { type: 'tip', body: '**test**' })).toEqual({ ok: true })
+    expect(wrapper.find('.markdown-callout').exists()).toBe(true)
+    useEditorStore().saveStatus = 'conflict'
+    expect(await executeEditorCommand('editor.bold')).toEqual({ ok: false, reason: 'unavailable' })
+  })
+  it('keeps code examples as ordinary quotes and renders newly typed markers', async () => {
+    const wrapper = mount(VisualMarkdownEditor, { props: { initialContent: '> `[!NOTE]`\n\n> text' }, attachTo: document.body })
+    mounted.push(wrapper)
+    const editor = await waitForEditor(wrapper)
+    expect(wrapper.find('.markdown-callout').exists()).toBe(false)
+    editor.action(ctx => {
+      const view = ctx.get(editorViewCtx)
+      let position = 0
+      view.state.doc.descendants((node, pos) => { if (node.isText && node.text === 'text') position = pos })
+      view.dispatch(view.state.tr.insertText('[!TIP]', position, position + 4))
+    })
+    expect(wrapper.find('.markdown-callout').exists()).toBe(true)
+    expect(editor.action(getMarkdown())).toContain('[!TIP]')
+  })
   it('renders the supported format matrix and preserves inline code', async () => {
     const source = ['# H1','## H2','### H3','#### H4','##### H5','###### H6',
       '正文 **粗体** *斜体* ~~删除~~ `s` 与 ``a`b``', '> 引用', '- 项目\n  - 子项', '1. 第一\n2. 第二',

frontend/src/features/editor/VisualMarkdownEditor.vue

@@ -4,19 +4,22 @@ import { useActionDialog } from '@/composables/useActionDialog'
 const { actionDialog, resolveAction, askPrompt } = useActionDialog()
 import DiagramInteractions from '@/components/common/DiagramInteractions.vue'
 import { onBeforeUnmount, onMounted, ref, watch } from 'vue'
-import { Link } from '@element-plus/icons-vue'
+import { Link, Fold, Expand } from '@element-plus/icons-vue'
 import { Crepe } from '@milkdown/crepe'
 import { codeBlockConfig } from '@milkdown/kit/component/code-block'
 import { basicSetup } from 'codemirror'
-import { keymap } from '@codemirror/view'
+import { keymap, EditorView as CodeEditorView } from '@codemirror/view'
+import { indentUnit } from '@codemirror/language'
+import { EditorState as CodeEditorState } from '@codemirror/state'
 import { indentWithTab } from '@codemirror/commands'
 import { shikiEditorTheme, shikiLanguages, renderCodeLanguage } from './shikiCodeMirror'
 import './language-icons.css'
 import { installLanguagePickerPopover } from './languagePickerPopover'
 import { installCodeBlockLabels } from './codeBlockLabels'
+import { installLinkNavigation } from './linkNavigation'
 import { createMermaidPreview } from './mermaidPreview'
 import { splitNoteMetadata, updateMetadataTags } from './noteMetadata'
-import { getMarkdown } from '@milkdown/kit/utils'
+import { getMarkdown, $remark, $prose } from '@milkdown/kit/utils'
 import {
   createCodeBlockCommand,
   toggleEmphasisCommand,
@@ -28,8 +31,10 @@ import {
   wrapInHeadingCommand,
   wrapInOrderedListCommand,
 } from '@milkdown/kit/preset/commonmark'
-import { commandsCtx, editorViewCtx } from '@milkdown/kit/core'
-import { TextSelection } from '@milkdown/kit/prose/state'
+import { commandsCtx, editorViewCtx, parserCtx, remarkStringifyOptionsCtx } from '@milkdown/kit/core'
+import { Slice } from '@milkdown/kit/prose/model'
+import { registerEditorCommands, type CommandHandler, type EditorCommandId } from '@/services/editorCommandService'
+import { TextSelection, Plugin } from '@milkdown/kit/prose/state'
 import { callCommand } from '@milkdown/kit/utils'
 import AppIcon from '@/components/common/AppIcon.vue'
 import { useEditorStore } from '@/stores/editor'
@@ -37,11 +42,18 @@ import { useSettingsStore } from '@/stores/settings'
 import { useThemeStore } from '@/stores/theme'
 import { applyMarkdownFontSize, fontSizeMarkdownPlugin } from './fontSizeMarkdown'
 import { inlineCodeInputPlugin } from './inlineCodeInput'
+import { calloutPlugin, configureCalloutSerialization } from './calloutPlugin'
+import { calloutTypes } from '@/utils/callouts'
+import { headingFoldingPlugin, headingFoldTransaction, headingFoldKey, headingSections } from './headingFolding'
+import { useHeadingAppearanceStore } from '@/stores/headingAppearance'
+import { useMarkdownPreferencesStore } from '@/stores/markdownPreferences'
 import { t } from '@/i18n'
 import '@milkdown/crepe/theme/common/style.css'
 import '@milkdown/crepe/theme/frame.css'
 
 const props = defineProps<{ initialContent: string }>()
+const headingAppearance = useHeadingAppearanceStore()
+const markdownPreferences = { ...useMarkdownPreferencesStore().normalized }
 const metadata = ref(splitNoteMetadata(props.initialContent))
 const tagDraft = ref('')
 function setTags(tags: string[]) {
@@ -63,10 +75,87 @@ const settingsStore = useSettingsStore()
 const themeStore = useThemeStore()
 const editorRoot = ref<HTMLElement | null>(null)
 const loading = ref(true)
+const allHeadingsFolded = ref(false)
+const hasFoldableHeadings = ref(false)
 const fontSizeInput = ref(16)
 let crepe: Crepe | null = null
 let disposeLanguagePicker: (() => void) | undefined
 let disposeCodeLabels: (() => void) | undefined
+let disposeLinkNavigation: (() => void) | undefined
+let disposeCommands: (() => void) | undefined
+let disposed = false
+
+function insertMarkdown(source: string) {
+  crepe?.editor.action(ctx => {
+    const doc = ctx.get(parserCtx)(source)
+    if (!doc) throw new Error('Invalid Markdown')
+    const view = ctx.get(editorViewCtx)
+    view.dispatch(view.state.tr.replaceSelection(new Slice(doc.content, 0, 0)).scrollIntoView())
+    view.focus()
+  })
+}
+
+function insertCallout(event: Event) {
+  const select = event.target as HTMLSelectElement
+  if (select.value) insertMarkdown(`> [!${select.value.toUpperCase()}]\n> ${t('提示内容', 'Callout content')}`)
+  select.value = ''
+}
+
+function installCommands() {
+  const targetPath = editorStore.currentFilePath
+  const handlers: Partial<Record<EditorCommandId, CommandHandler>> = {}
+  for (const [id, action] of [['editor.heading.toggle-fold', 'toggle'], ['editor.heading.fold-all', 'all'], ['editor.heading.unfold-all', 'none']] as const) {
+    handlers[id] = () => { foldHeadings(action); return { ok: true } }
+  }
+  const toolbar: ToolbarCommand[] = ['bold', 'italic', 'ordered-list', 'bullet-list', 'inline-code', 'code-block', 'inline-math', 'math-block']
+  for (const command of toolbar) {
+    if (!markdownPreferences.math && command.includes('math')) continue
+    handlers[`editor.${command}`] = () => { runCommand(command); return { ok: true } }
+  }
+  handlers['editor.paragraph'] = () => { crepe!.editor.action(callCommand(turnIntoTextCommand.key)); return { ok: true } }
+  handlers['editor.heading'] = params => {
+    if (!Number.isInteger(params) || Number(params) < 1 || Number(params) > 6) return { ok: false, reason: 'invalid-params' }
+    crepe!.editor.action(callCommand(wrapInHeadingCommand.key, Number(params)))
+    return { ok: true }
+  }
+  handlers['editor.font-size'] = params => {
+    if (typeof params !== 'number' || !Number.isFinite(params) || params < 8 || params > 96) return { ok: false, reason: 'invalid-params' }
+    fontSizeInput.value = params
+    applyFontSizeValue()
+    return { ok: true }
+  }
+  handlers['editor.insert-markdown'] = params => {
+    if (typeof params !== 'string' || !params.trim() || params.length > 100000) return { ok: false, reason: 'invalid-params' }
+    insertMarkdown(params)
+    return { ok: true }
+  }
+  handlers['editor.callout'] = params => {
+    if (!markdownPreferences.callouts) return { ok: false, reason: 'unsupported' }
+    if (!params || typeof params !== 'object') return { ok: false, reason: 'invalid-params' }
+    const { type, title = '', body = '', fold = '' } = params as Record<string, unknown>
+    if (typeof type !== 'string' || !/^[\w-]{1,64}$/.test(type) || typeof title !== 'string' || /[\r\n]/.test(title)
+      || typeof body !== 'string' || !['', '+', '-'].includes(String(fold)) || title.length + body.length > 100000) return { ok: false, reason: 'invalid-params' }
+    insertMarkdown(`> [!${type}]${fold} ${title}\n${body.split(/\r?\n/).map(line => `> ${line}`).join('\n')}`)
+    return { ok: true }
+  }
+  disposeCommands = registerEditorCommands({
+    available: () => !loading.value && !!crepe && editorStore.mode === 'wysiwyg' && editorStore.saveStatus !== 'conflict'
+      && !!targetPath && targetPath === editorStore.currentFilePath && crepe.editor.action(ctx => ctx.get(editorViewCtx).editable),
+    handlers,
+  })
+}
+
+function foldHeadings(action: 'toggle' | 'all' | 'none') {
+  crepe?.editor.action(ctx => {
+    const view = ctx.get(editorViewCtx)
+    const tr = headingFoldTransaction(view.state, action)
+    if (tr) view.dispatch(tr)
+    if (action === 'all') {
+      const viewport = editorRoot.value?.closest<HTMLElement>('.milkdown-host')
+      if (viewport) viewport.scrollTop = 0
+    }
+  })
+}
 const diagramPreviews = new Map<string, { source: string; apply: (value: HTMLElement) => void }>()
 function renderDiagram(source: string, apply: (value: HTMLElement) => void) {
   for (const [id, entry] of diagramPreviews) {
@@ -114,7 +203,7 @@ function runCommand(command: ToolbarCommand) {
     'ordered-list': callCommand(wrapInOrderedListCommand.key),
     'bullet-list': callCommand(wrapInBulletListCommand.key),
     'inline-code': callCommand(toggleInlineCodeCommand.key),
-    'code-block': callCommand(createCodeBlockCommand.key, ''),
+    'code-block': callCommand(createCodeBlockCommand.key, markdownPreferences.defaultLanguage),
     'inline-math': callCommand('ToggleLatex'),
     'math-block': callCommand(createCodeBlockCommand.key, 'LaTeX'),
   }
@@ -181,7 +270,7 @@ onMounted(async () => {
   crepe = new Crepe({
     root: editorRoot.value,
     defaultValue: metadata.value?.body ?? props.initialContent,
-    features: { [Crepe.Feature.TopBar]: false },
+    features: { [Crepe.Feature.TopBar]: false, [Crepe.Feature.Latex]: markdownPreferences.math },
     featureConfigs: {
       [Crepe.Feature.Placeholder]: { text: t('开始记录你的想法…', 'Start writing your thoughts…') },
       [Crepe.Feature.CodeMirror]: {
@@ -245,12 +334,54 @@ onMounted(async () => {
     languages: shikiLanguages(themeStore.resolvedCodeBlockTheme),
     renderLanguage: renderCodeLanguage,
     renderPreview: (language, content, applyPreview) => language.trim().toLowerCase() === 'mermaid'
-      ? renderDiagram(content, applyPreview)
+      ? markdownPreferences.diagrams ? renderDiagram(content, applyPreview) : null
       : config.renderPreview(language, content, applyPreview),
-    extensions: [basicSetup, keymap.of([indentWithTab]), shikiEditorTheme(themeStore.resolvedCodeBlockTheme)],
+    extensions: [basicSetup, keymap.of([indentWithTab]), shikiEditorTheme(themeStore.resolvedCodeBlockTheme),
+      indentUnit.of(' '.repeat(markdownPreferences.indent)), CodeEditorState.tabSize.of(markdownPreferences.indent),
+      ...(markdownPreferences.wrapCode ? [CodeEditorView.lineWrapping] : [])],
   })))
+  crepe.editor.config(ctx => ctx.update(remarkStringifyOptionsCtx, options => ({
+    ...options, setext: markdownPreferences.heading === 'setext', bullet: markdownPreferences.bullet,
+    incrementListMarker: markdownPreferences.incrementList, fence: markdownPreferences.fence,
+  })))
+  if (!markdownPreferences.autoLinks) crepe.editor.use($remark('disable-bare-autolinks', () => () => (tree, file) => {
+    type Ast = { type: string; value?: string; url?: string; children?: Ast[]; position?: { start: { offset?: number }; end: { offset?: number } } }
+    const source = String(file.value)
+    const walk = (node: Ast) => {
+      if (node.type === 'link' && node.position) {
+        const raw = source.slice(node.position.start.offset, node.position.end.offset)
+        if (/^(?:https?:\/\/|www\.)\S+$/.test(raw)) {
+          node.type = 'text'; node.value = raw; delete node.children; delete node.url
+        }
+      }
+      node.children?.forEach(walk)
+    }
+    walk(tree as Ast)
+  }))
   crepe.editor.use(fontSizeMarkdownPlugin)
   crepe.editor.use(inlineCodeInputPlugin)
+  if (markdownPreferences.callouts) crepe.editor.use(calloutPlugin)
+  crepe.editor.use(headingFoldingPlugin)
+  crepe.editor.use($prose(() => new Plugin({
+    view(view) {
+      const sync = (current: typeof view) => {
+        const sections = headingSections(current.state.doc)
+        const folded = headingFoldKey.getState(current.state)
+        hasFoldableHeadings.value = sections.length > 0
+        // Hidden descendants retain their own state but are not visible expanded sections.
+        let hiddenUntil = -1
+        allHeadingsFolded.value = sections.length > 0 && sections.every(section => {
+          if (section.from < hiddenUntil) return true
+          if (!folded?.has(section.from)) return false
+          hiddenUntil = section.end
+          return true
+        })
+      }
+      sync(view)
+      return { update: sync }
+    },
+  })))
+  if (markdownPreferences.callouts) crepe.editor.config(configureCalloutSerialization)
   crepe.on((listener) => {
     listener.markdownUpdated((_ctx, markdown, previousMarkdown) => {
       // 忽略编辑器初始化/回显事件，防止无内容变化时触发自动保存循环。
@@ -263,8 +394,10 @@ onMounted(async () => {
   await crepe.create()
   if (editorRoot.value) disposeLanguagePicker = installLanguagePickerPopover(editorRoot.value)
   if (editorRoot.value) disposeCodeLabels = installCodeBlockLabels(editorRoot.value)
+  if (editorRoot.value) disposeLinkNavigation = installLinkNavigation(editorRoot.value)
   applyProofingPreferences()
   loading.value = false
+  if (!disposed) installCommands()
 })
 
 watch([() => settingsStore.spellCheck, () => settingsStore.language], applyProofingPreferences)
@@ -282,15 +415,24 @@ watch(() => editorStore.headingRequest, request => {
   })
 })
 
-onBeforeUnmount(() => { diagramPreviews.clear(); disposeCodeLabels?.(); disposeLanguagePicker?.(); void crepe?.destroy() })
+onBeforeUnmount(() => { disposed = true; disposeCommands?.(); diagramPreviews.clear(); disposeLinkNavigation?.(); disposeCodeLabels?.(); disposeLanguagePicker?.(); void crepe?.destroy() })
 
 defineExpose({ getEditor: () => crepe?.editor })
 </script>
 
 <template>
-  <DiagramInteractions class="visual-editor">
+  <DiagramInteractions class="visual-editor" :class="{ 'hide-code-line-numbers': !markdownPreferences.lineNumbers }" :data-heading-style="headingAppearance.preferences.custom ? 'custom' : undefined" :style="headingAppearance.cssVariables">
     <ActionDialog v-if="actionDialog" v-bind="actionDialog" @resolve="resolveAction" />
     <div class="markdown-toolbar" role="toolbar" :aria-label="t('Markdown 格式工具栏', 'Markdown formatting toolbar')">
+      <div class="section-actions">
+        <button type="button" :disabled="loading || !hasFoldableHeadings"
+          :title="allHeadingsFolded ? t('展开所有章节正文', 'Expand all section content') : t('折叠所有章节，保留标题', 'Collapse all sections, keeping headings visible')"
+          :aria-label="allHeadingsFolded ? t('展开所有章节', 'Unfold all sections') : t('折叠所有章节', 'Fold all sections')"
+          @click="foldHeadings(allHeadingsFolded ? 'none' : 'all')">
+          <AppIcon :icon="allHeadingsFolded ? Expand : Fold" :size="16" />
+          <span>{{ allHeadingsFolded ? t('全部展开', 'Expand all') : t('全部折叠', 'Collapse all') }}</span>
+        </button>
+      </div>
       <label class="toolbar-select heading-select" :title="t('设置标题级别', 'Set heading level')">
         <span class="format-glyph heading-glyph">H</span>
         <select :aria-label="t('标题级别', 'Heading level')" @change="applyHeading">
@@ -321,9 +463,15 @@ defineExpose({ getEditor: () => crepe?.editor })
       <span class="toolbar-divider" />
       <button type="button" :title="t('行内代码', 'Inline code')" :aria-label="t('行内代码', 'Inline code')" @pointerdown.prevent="runCommand('inline-code')"><code class="code-glyph">&lt;/&gt;</code></button>
       <button type="button" :title="t('代码块', 'Code block')" :aria-label="t('代码块', 'Code block')" @pointerdown.prevent="runCommand('code-block')"><span class="block-glyph">{ }</span></button>
-      <button type="button" :title="t('行内公式', 'Inline formula')" :aria-label="t('行内公式', 'Inline formula')" @pointerdown.prevent="runCommand('inline-math')"><span class="math-glyph">ƒx</span></button>
-      <button type="button" :title="t('公式块', 'Formula block')" :aria-label="t('公式块', 'Formula block')" @pointerdown.prevent="runCommand('math-block')"><span class="math-glyph">∑</span></button>
+      <button v-if="markdownPreferences.math" type="button" :title="t('行内公式', 'Inline formula')" :aria-label="t('行内公式', 'Inline formula')" @pointerdown.prevent="runCommand('inline-math')"><span class="math-glyph">ƒx</span></button>
+      <button v-if="markdownPreferences.math" type="button" :title="t('公式块', 'Formula block')" :aria-label="t('公式块', 'Formula block')" @pointerdown.prevent="runCommand('math-block')"><span class="math-glyph">∑</span></button>
       <button type="button" :title="t('插入链接', 'Insert link')" :aria-label="t('插入链接', 'Insert link')" @pointerdown.prevent="applyLink"><AppIcon :icon="Link" :size="17" /></button>
+      <label class="toolbar-select">
+        <select v-if="markdownPreferences.callouts" :aria-label="t('插入警告框', 'Insert callout')" @change="insertCallout">
+          <option value="">{{ t('提示框', 'Callout') }}</option>
+          <option v-for="(_, type) in calloutTypes" :key="type" :value="type">{{ type }}</option>
+        </select>
+      </label>
     </div>
     <div v-if="loading" class="editor-loading">{{ t('正在加载编辑器…', 'Loading editor…') }}</div>
     <div class="milkdown-host" :class="{ loading }">
@@ -343,10 +491,16 @@ defineExpose({ getEditor: () => crepe?.editor })
 
 <style scoped>
 .visual-editor { display: flex; flex: 1; min-height: 0; flex-direction: column; background: var(--color-background-primary); }
+.hide-code-line-numbers :deep(.cm-lineNumbers) { display: none; }
 .markdown-toolbar { display: flex; align-items: center; flex-wrap: wrap; gap: 2px; min-height: 42px; padding: 5px var(--space-lg); border-bottom: 1px solid var(--color-border-subtle); background: var(--color-surface-primary); }
 .markdown-toolbar button { display: inline-grid; place-items: center; min-width: 32px; min-height: 30px; padding: 4px 8px; border-radius: var(--radius-sm); color: var(--color-text-primary); }
 .markdown-toolbar button:hover, .toolbar-select:hover { background: var(--color-background-hover); color: var(--color-text-primary); }
 .markdown-toolbar button:focus-visible, .toolbar-select:focus-within { outline: 2px solid var(--color-border-focus); outline-offset: 1px; }
+.section-actions { display: inline-flex; align-items: center; flex-shrink: 0; margin-inline-end: 8px; padding: 2px; border: 1px solid var(--color-border-default); border-radius: var(--radius-md); background: var(--color-background-secondary); }
+.markdown-toolbar .section-actions button { display: inline-flex; align-items: center; justify-content: center; gap: 5px; min-height: 28px; padding: 4px 8px; font: inherit; font-size: var(--font-size-xs); line-height: 1.25; white-space: nowrap; color: var(--color-text-secondary); }
+.section-actions :deep(.app-icon) { transform: rotate(90deg); }
+.markdown-toolbar .section-actions button:hover:not(:disabled) { background: var(--color-background-hover); color: var(--color-accent-primary); }
+.markdown-toolbar .section-actions button:disabled { opacity: .45; cursor: default; }
 .format-glyph { font-family: Georgia, 'Times New Roman', serif; font-size: 17px; line-height: 1; }
 .heading-glyph { font-weight: 800; }
 .font-size-glyph { font-size: 18px; }

frontend/src/features/editor/calloutPlugin.ts

@@ -0,0 +1,99 @@
+import { $prose } from '@milkdown/kit/utils'
+import { Plugin } from '@milkdown/kit/prose/state'
+import { Decoration, DecorationSet } from '@milkdown/kit/prose/view'
+import type { Node as ProseNode } from '@milkdown/kit/prose/model'
+import { parseCallout } from '@/utils/callouts'
+import '@/styles/callouts.css'
+import { remarkStringifyOptionsCtx, type Editor } from '@milkdown/kit/core'
+
+export const configureCalloutSerialization: Parameters<Editor['config']>[0] = ctx => {
+  ctx.update(remarkStringifyOptionsCtx, options => ({
+    ...options,
+    handlers: { ...options.handlers, blockquote(node, _parent, state, info) {
+      const exit = state.enter('blockquote')
+      const tracker = state.createTracker(info)
+      tracker.move('> ')
+      tracker.shift(2)
+      const result = state.indentLines(state.containerFlow(node, tracker.current()), (line, _index, blank) => `>${blank ? '' : ' '}${line}`)
+      exit()
+      // Only remove escaping from a leading callout marker, never body literals.
+      return result.replace(/^(> )\\\[!([\w-]+)\\?\]/, '$1[!$2]')
+    } },
+  }))
+}
+
+const markerCache = new WeakMap<ProseNode, { from: number; to: number }[]>()
+function calloutMarkers(doc: ProseNode) {
+  const cached = markerCache.get(doc)
+  if (cached) return cached
+  const markers: { from: number; to: number }[] = []
+  doc.descendants((node, position) => {
+    if (node.type.name !== 'blockquote' || node.firstChild?.type.name !== 'paragraph' || node.firstChild.firstChild?.marks.length) return
+    const callout = parseCallout(node.firstChild.textBetween(0, node.firstChild.content.size, '\n', '\n'))
+    if (callout) markers.push({ from: position + 2, to: position + 2 + callout.markerLength })
+  })
+  markerCache.set(doc, markers)
+  return markers
+}
+
+// Keep native blockquotes in the document: typing, undo and Markdown serialization
+// remain Milkdown transactions; the view never rewrites a user's callout source.
+export const calloutPlugin = $prose(() => new Plugin({
+  props: {
+    decorations(state) {
+      const decorations: Decoration[] = []
+      for (const { from, to } of calloutMarkers(state.doc)) {
+        const editing = state.selection.from <= to && state.selection.to >= from
+        decorations.push(Decoration.inline(from, to, { class: editing ? 'callout-marker-editing' : 'callout-marker' }))
+      }
+      return DecorationSet.create(state.doc, decorations)
+    },
+    nodeViews: {
+      blockquote(initialNode) {
+        const dom = document.createElement('blockquote')
+        const header = document.createElement('button')
+        header.type = 'button'
+        header.className = 'callout-title'
+        header.contentEditable = 'false'
+        const contentDOM = document.createElement('div')
+        contentDOM.className = 'callout-body'
+        dom.append(header, contentDOM)
+        let signature = ''
+        let foldable = false
+        const update = (node: typeof initialNode) => {
+          if (node.type.name !== 'blockquote') return false
+          const callout = node.firstChild?.type.name === 'paragraph' && !node.firstChild.firstChild?.marks.length
+            ? parseCallout(node.firstChild.textBetween(0, node.firstChild.content.size, '\n', '\n')) : null
+          dom.className = callout ? 'markdown-callout' : ''
+          header.hidden = !callout
+          foldable = !!callout?.fold
+          header.disabled = !foldable
+          if (callout) {
+            dom.dataset.callout = callout.type
+            const next = `${callout.name}:${callout.fold}`
+            if (signature !== next) dom.dataset.collapsed = String(callout.fold === '-')
+            signature = next
+            header.textContent = `${foldable ? (dom.dataset.collapsed === 'true' ? '▸ ' : '▾ ') : ''}${callout.title}`
+            if (foldable) header.setAttribute('aria-expanded', String(dom.dataset.collapsed !== 'true'))
+            else header.removeAttribute('aria-expanded')
+          } else {
+            delete dom.dataset.callout
+            delete dom.dataset.collapsed
+            signature = ''
+          }
+          return true
+        }
+        let current = initialNode
+        header.onclick = () => {
+          if (!foldable) return
+          dom.dataset.collapsed = String(dom.dataset.collapsed !== 'true')
+          update(current)
+        }
+        update(initialNode)
+        return { dom, contentDOM, update(node) { current = node; return update(node) },
+          stopEvent: event => header.contains(event.target as Node),
+          ignoreMutation: mutation => mutation.type !== 'selection' && !contentDOM.contains(mutation.target) }
+      },
+    },
+  },
+}))

frontend/src/features/editor/codeBlockLabels.spec.ts

@@ -1,5 +1,5 @@
 // @vitest-environment happy-dom
-import { expect, it } from 'vitest'
+import { expect, it, vi } from 'vitest'
 import { installCodeBlockLabels } from './codeBlockLabels'
 
 it('keeps footer labels in sync when the language changes and stops after disposal', async () => {
@@ -16,3 +16,21 @@ it('keeps footer labels in sync when the language changes and stops after dispos
   await new Promise(resolve => setTimeout(resolve, 0))
   expect(block.dataset.languageLabel).toBe('TypeScript')
 })
+
+it('ignores code text mutations and discovers newly inserted code blocks', async () => {
+  const root = document.createElement('div')
+  root.innerHTML = '<div class="milkdown-code-block"><button class="language-button">Python</button><div class="cm-content">old</div></div>'
+  const dispose = installCodeBlockLabels(root)
+  const scan = vi.spyOn(root, 'querySelectorAll')
+  try {
+    root.querySelector('.cm-content')!.textContent = 'new code'
+    await new Promise(resolve => setTimeout(resolve, 0))
+    expect(scan).not.toHaveBeenCalled()
+    const block = document.createElement('div')
+    block.className = 'milkdown-code-block'
+    block.innerHTML = '<button class="language-button">Rust</button>'
+    root.append(block)
+    await new Promise(resolve => setTimeout(resolve, 0))
+    expect(block.dataset.languageLabel).toBe('Rust')
+  } finally { dispose(); scan.mockRestore() }
+})

frontend/src/features/editor/codeBlockLabels.ts

@@ -1,11 +1,38 @@
-/** Mirror the live picker label for theme decorations without changing Markdown. */
+/** Mirror changed language labels without rescanning every code block on each DOM mutation. */
 export function installCodeBlockLabels(root: HTMLElement): () => void {
-  const sync = () => root.querySelectorAll<HTMLElement>('.milkdown-code-block').forEach(block => {
+  const sync = (block: HTMLElement) => {
     const label = block.querySelector('.language-button')?.textContent?.trim() || 'Plain text'
     if (block.dataset.languageLabel !== label) block.dataset.languageLabel = label
+  }
+  const discover = (node: Node, blocks: Set<HTMLElement>) => {
+    if (!(node instanceof HTMLElement)) return
+    if (node.matches('.milkdown-code-block')) blocks.add(node)
+    node.querySelectorAll<HTMLElement>('.milkdown-code-block').forEach(block => blocks.add(block))
+  }
+  const observer = new MutationObserver(records => {
+    const changed = new Set<HTMLElement>()
+    for (const record of records) {
+      const element = record.target instanceof Element ? record.target : record.target.parentElement
+      // CodeMirror viewport/text changes do not change the footer's language.
+      const label = element?.closest('.language-button')
+      const block = label?.closest<HTMLElement>('.milkdown-code-block')
+      if (block) changed.add(block)
+      if ([...record.removedNodes].some(node => node instanceof Element &&
+        (node.matches('.language-button') || node.querySelector('.language-button')))) {
+        const owner = element?.closest<HTMLElement>('.milkdown-code-block')
+        if (owner) changed.add(owner)
+      }
+      for (const node of record.addedNodes) {
+        discover(node, changed)
+        if (node instanceof Element && (node.matches('.language-button') || node.querySelector('.language-button'))) {
+          const owner = node.closest<HTMLElement>('.milkdown-code-block')
+          if (owner) changed.add(owner)
+        }
+      }
+    }
+    changed.forEach(block => { if (root.contains(block)) sync(block) })
   })
-  const observer = new MutationObserver(sync)
+  root.querySelectorAll<HTMLElement>('.milkdown-code-block').forEach(sync)
   observer.observe(root, { subtree: true, childList: true, characterData: true })
-  sync()
   return () => observer.disconnect()
 }