LD-Notion Hub

外观

整体架构 ​

LD-Notion 是一个浏览器侧应用：核心逻辑运行在用户脚本或扩展 content script 中，通过浏览器存储保存非敏感配置，并通过本地加密凭证保险箱保存敏感凭证，再调用外部 API 读写 Notion、GitHub、AI 服务和 Obsidian。

模块结构 ​

mermaid
flowchart TB
  subgraph Runtime[运行形态]
    UserScript[Tampermonkey 用户脚本]
    FullExt[独立 Chrome 扩展]
    BridgeExt[书签桥接扩展]
  end

  subgraph UI[界面层]
    MainUI[Linux.do / GitHub 主面板]
    NotionUI[Notion 浮动 AI 面板]
    GenericUI[通用网页剪藏面板]
    Popup[扩展 Popup]
  end

  subgraph Services[服务层]
    WorkspaceService[WorkspaceService]
    NotionAPI[NotionAPI / NotionTransport]
    GitHubAPI[GitHubAPI / GitHubExporter]
    BookmarkExporter[BookmarkBridge / BookmarkExporter]
    ZhihuAPI[ZhihuAPI]
    ObsidianAPI[ObsidianAPI]
    Agent[AI Agent Loop]
  end

  subgraph Guard[安全层]
    OperationGuard[OperationGuard]
    Audit[审计日志]
    Permission[权限等级]
  end

  subgraph External[外部系统]
    LinuxDo[Linux.do]
    GitHub[GitHub API]
    ChromeBookmarks[chrome.bookmarks]
    Notion[Notion API]
    AI[AI Providers]
    Obsidian[Obsidian REST API]
  end

  UserScript --> MainUI
  UserScript --> NotionUI
  UserScript --> GenericUI
  FullExt --> MainUI
  FullExt --> NotionUI
  FullExt --> GenericUI
  FullExt --> Popup
  BridgeExt --> BookmarkExporter

  MainUI --> Services
  NotionUI --> Services
  GenericUI --> Services
  Popup --> Services

  Services --> OperationGuard
  OperationGuard --> Permission
  OperationGuard --> Audit
  OperationGuard --> NotionAPI

  NotionAPI --> Notion
  WorkspaceService --> Notion
  GitHubAPI --> GitHub
  BookmarkExporter --> ChromeBookmarks
  ZhihuAPI --> External
  ObsidianAPI --> Obsidian
  Agent --> AI
  Agent --> Services
  MainUI --> LinuxDo

关键数据流 ​

  1. UI 层读取用户配置与来源选择。
  2. 来源服务拉取帖子、仓库、书签或网页信息。
  3. 解析层清洗内容、保留格式、生成 Notion Blocks 或 Markdown。
  4. 可选 AI 层生成摘要、分类、标签或执行对话式任务。
  5. 写入前进入 OperationGuard。
  6. Notion 或 Obsidian 适配层完成输出。
  7. 非敏感状态、日志和导出记录写回浏览器本地存储；OAuth 凭据自 v3.12.0 起同样保存在浏览器本地 GM 存储（跨页回调可读必需），其它敏感凭证写入本地加密保险箱。

代码定位 ​

模块位置
用户脚本主体LinuxDo-Bookmarks-to-Notion.user.js
书签桥接扩展chrome-extension/
独立扩展构建scripts/build-extension.js 输出 chrome-extension-full/
协调层（UI 命令分发）src/coordination/UICommandService.js
事件总线（解耦循环依赖）src/coordination/event-bus.js（零依赖，security/import/bridge → ui 通知）
AI 中央依赖访问器src/ai/deps.js（getAI/getState/getService 三件套）
AI 域模块src/ai/handlers/（4 域）+ src/ai/tools/（3 域）+ src/ai/utils/（4 纯函数集）
AI 输出 schema 校验src/ai/schema.js（AISchema，校验 AI 返回的 URL/属性名/值/结构）
API 域模块src/api/（核心 696 LOC + constants/DOMToNotion/obsidian/notion-upload）
URL 安全原语src/security/UrlValidator.js（validateAiBaseUrl/validateObsidianUrl/validatePageExternalUrl）
多源适配器注册表src/adapter/（AdapterRegistry + 各 *Adapter，bridge 经 lazy accessor 注入）
自动化测试tests/（29 文件 556 用例）
UI 手工回归docs/ui-regression-checklist.md

设计取舍 ​

  • 纯前端部署：安装简单，但共享生产级 secret 仍不适合放进前端；OAuth 三键自 v3.12.0 起走浏览器本地 GM 存储以支持跨页回调，其它敏感凭证通过本地加密保险箱降低明文暴露面。
  • 单脚本核心：便于 Tampermonkey 分发，但需要构建 seam 来稳定生成扩展版。
  • 权限守卫集中化：减少 AI 与用户触发写入入口的安全漂移。
  • 多来源统一抽象：跨源搜索和推荐更自然，但来源去重策略需要分别处理。