Concepts

Concepts 分区用于解释 LD-Notion 的架构、路由、权限、AI 与扩展机制。使用功能页解决“怎么做”，使用这里理解“为什么这样流转”。

机制地图

mindmap
  root((LD-Notion 机制地图))
    Routing Rules
      来源选择
      目标选择
      授权状态
      AI 配置
      权限等级
    Import Pipeline
      captured
      normalized
      guard_checked
      enriched
      previewed
      written
      audited
      failed
    OperationGuard
      权限检查
      危险确认
      审计事件
      撤销窗口
    AI Agent Loop
      observe
      plan
      act
      observe
    Auth Model
      Notion OAuth
      Manual Token
      本地加密保险箱
      失效处理
    Prompt Injection Defense
      XML 标签隔离
      输出净化
      UI 全局转义
    SyncState V1/V2
      V2 扁平结构
      V1 facade 代理
      自动迁移
      写入优化
    Extension Architecture
      userscript
      content script
      background service worker
      popup
      storage
      remote APIs
    UI Design System
      design tokens
      theme switching
      interaction states
      accessibility
      responsive layout
    Module Architecture
      UI module split (8 files)
      AI module sections (7 sections)
      UrlValidator (API key exfil protection)
      AutoImporter method decomposition

机制页用途

页面	用途
Routing Rules	解释来源、目标、授权、AI 配置和权限等级如何共同决定处理路径。
Import Pipeline	解释内容从捕获、标准化、守卫检查、增强、预览到写入和审计的状态流。
OperationGuard	解释写入动作前的权限、确认、审计和撤销边界。
AI Agent Loop	解释 AI 助手如何 observe、plan、act，并再次观察结果。
Auth Model	解释 Notion OAuth、manual token、本地加密保险箱和授权失败处理。
Prompt Injection Defense	解释 AI 输入隔离、输出净化和 UI 全局转义的多层防御体系。
SyncState V1/V2 迁移	解释 SyncState 从嵌套 V1 到扁平 V2 的迁移、facade 代理和写入优化。
Extension Architecture	解释 userscript、Chrome 扩展、构建 seam、权限和部署边界。
UI 设计系统	解释设计 token、主题切换、交互状态、可访问性和响应式布局规范。