这个博客是怎么来的呢？

Cloudflare (DNS + CDN + SSL Full Strict)
    │
    ├── Vercel ─── Next.js 15 前端
    │   ├── 公开博客：文章列表 + 详情 + 标签筛选 + 搜索
    │   ├── 登录/注册：邮箱密码 + GitHub OAuth
    │   ├── 评论区（登录后可见）
    │   └── Agent Console UI（仅允许账号）
    │
    ├── 硅谷服务器 ─── FastAPI 后端
    │   ├── /api/posts       → 博客文章
    │   ├── /api/auth        → 认证（注册、登录、GitHub OAuth、JWT）
    │   ├── /api/comments    → 评论区
    │   ├── /api/agent       → Agent Sandbox (session、SSE、diff)
    │   ├── /internal/llm    → DeepSeek model gateway
    │   ├── Nginx 反代 + TLS (Let's Encrypt)
    │   └── PostgreSQL 17 + pgvector
    │
    ├── Docker ─── Pi coding-agent runner
    │   ├── 一次性 workspace (git init)
    │   ├── 资源限制 (1 CPU, 768MB, 128 pids)
    │   └── 不挂载生产密钥、目录或 Docker socket
    │
    ├── 腾讯云 COS ─── Notion 图片镜像 + 博客配图
    │
    └── Notion API ──→ 定时同步 → 后端 → 图片镜像 COS → 写入 PG

Markdown 正文
  │
  ├── remark-gfm       → GFM 扩展（表格、任务列表、删除线）
  ├── remark-math      → 识别 $...$ 和 $$...$$ 数学公式
  │
  └── react-markdown   → AST 解析 + React 组件渲染
        │
        ├── rehype-slug       → 标题自动加 id，用于锚点跳转
        ├── rehype-raw        → 解析 Markdown 里内嵌的 HTML（如 <details>）
        ├── rehype-sanitize   → 白名单过滤，防 XSS
        │     └── 扩展白名单: <details> <summary> <u> <input> <mark> <kbd> <sub> <sup>
        ├── rehype-highlight  → 代码语法高亮 (highlight.js + github.css)
        └── rehype-katex      → 数学公式渲染为 HTML+CSS

:root {
  --paper: #f7f3ea;   /* 暖白纸色背景 */
  --ink: #111111;     /* 正文黑色 */
  --red: #d9281e;     /* 强调/警告 */
  --blue: #185abc;    /* 链接 */
  --yellow: #f2c94c;  /* 高亮 */
}

app/
├── main.py              → FastAPI 入口 + lifespan hook + CORS
├── config.py            → pydantic-settings 全局配置单例
├── authRouter.py        → /api/auth/*     (注册、登录、GitHub OAuth、JWT)
├── postsRouter.py       → /api/posts/*    (文章列表、文章详情)
├── commentsRouter.py    → /api/comments/* (评论 CRUD)
├── agent/router.py      → /api/agent/*    (Agent session、SSE、diff)
├── agent/gatewayRouter.py → /internal/llm/*  (DeepSeek model gateway)
├── agent/internalRouter.py → /internal/agent/* (runner 内部回调)
├── agent/runner.py      → Docker sandbox 生命周期管理
├── agent/service.py     → Agent 业务逻辑（创建 session、事件存储、plan 审批）
├── agent/memory.py      → 长期记忆 CRUD + pgvector 搜索
├── agent/capability.py  → Agent 能力审批与管理
├── notion/              → Notion 同步 + Markdown 转换 + 图片镜像
└── database/            → ORM models + 连接管理 + DDL

# 只有"允许"与"不允许"之分
# guest 和 owner 如果都在允许列表中，能力完全一致
can_access_agent = check_allowed_agent_account(user)

shared_buffers = 64MB   # 默认 128MB
work_mem = 4MB          # 默认 4MB，不动
max_connections = 20    # 默认 100

from fastembed import TextEmbedding

model = TextEmbedding("BAAI/bge-small-zh-v1.5")
embedding = list(model.embed(["要编码的文本"]))[0]  # → 512 维 float list

Notion Data Source API
  │
  ├── APScheduler 定时触发 (启动立刻跑一次，之后每 15 分钟)
  │
  ├── Python httpx 翻页拉 data source pages
  │     ├── 提取属性: title, slug, tags, status, date, summary, category
  │     ├── 镜像 cover 图片到 COS
  │     ├── UPSERT posts 表
  │     ├── 递归拉取全部 block children
  │     ├── 识别 image block → 下载临时 URL → SHA256 → 上传 COS → public URL
  │     └── 收集 {blockId: publicUrl} 映射
  │
  ├── Node 子进程调用 notion-to-md@3.1.9
  │     ├── 接收: blocks JSON + imageUrlByBlockId
  │     ├── 图片 URL 替换为 COS URL
  │     └── 返回: Markdown 字符串
  │
  └── 写入 posts.content_md + post_images 表

# Python 端: 通过 subprocess 调 Node 脚本
process = await asyncio.create_subprocess_exec(
    "node", "scripts/notion-to-md.cjs",
    stdin=asyncio.subprocess.PIPE,
    stdout=asyncio.subprocess.PIPE,
)
stdout, stderr = await process.communicate(inputBytes)

浏览器 Agent Console
  │  POST /api/agent/sessions  → 创建任务
  │  GET  /api/agent/sessions/{id}/events  → SSE 订阅事件流
  │
FastAPI 控制平面
  │  校验 canAccessAgent
  │  创建 agent_sessions / agent_events 记录
  │  准备 workspace（从模板复制 + git init）
  │  检查并发限制（默认 1）
  │
Docker sandbox
  │  docker run --rm -i --cpus 1 --memory 768m --pids-limit 128
  │  --cap-drop ALL --security-opt no-new-privileges
  │  -v workspace:/workspace:rw
  │
Pi coding-agent runner
  │  stdin/stdout JSONL 通信
  │  通过 /internal/llm 调 DeepSeek（短期 session token）
  │  Plan Mode → tool calls → diff → final answer
  │
  └── 事件回写到 agent_events 表 + SSE 推前端

Pi runner container
  └── 只访问 FastAPI /internal/llm  ← 短期 session token
        └── FastAPI 注入真实 DeepSeek API key
              └── <https://api.deepseek.com/anthropic>

docker run \\
  --rm \\                    # 退出即删除
  --cpus 1 \\                # 单核
  --memory 768m \\           # 内存上限
  --pids-limit 128 \\        # 进程数上限
  --cap-drop ALL \\          # 移除全部 Linux capabilities
  --security-opt no-new-privileges \\  # 禁止提权
  -v /workspace:/workspace:rw \\       # 只挂临时 workspace
  artemis-pi-runner:latest

WITH RECURSIVE traversal AS (
    -- 种子节点：HNSW 向量搜索 top-k
    SELECT m.id, m.content, 0 AS depth
    FROM memories m
    WHERE m.id IN (SELECT id FROM hnsw_search(...))

    UNION ALL

    -- 沿 memory_edges 扩展
    SELECT m.id, m.content, t.depth + 1
    FROM memories m
    JOIN memory_edges e ON e.to_memory_id = m.id
    JOIN traversal t ON t.id = e.from_memory_id
    WHERE t.depth < 3  -- 最多 3 跳
)
SELECT DISTINCT * FROM traversal;

Notion image block
  │
  ├── 读取 caption + 前后文段落
  ├── 下载临时 URL（httpx，5 分钟超时）
  ├── 上传到 COS（boto3 put_object）
  ├── 写入 post_images 表（cos_key, public_url, caption, surrounding_text, content_hash）
  └── Markdown 图片 URL 替换为 COS public URL

Cloudflare
├── artemis2045.com  (CNAME → Vercel)
├── www.artemis2045.com  (CNAME → Vercel)
└── api.artemis2045.com  (A → 硅谷服务器 IP)
    │
    └── 硅谷服务器 (Ubuntu 24.04.4)
        ├── Nginx（1Panel OpenResty） :443 (Let's Encrypt)
        │   ├── proxy_pass /api/* → 127.0.0.1:8000
        │   └── 请求体 50MB 限制
        ├── FastAPI (uvicorn) :8000 → --reload
        ├── PostgreSQL :5432 → Docker artemis-pg
        └── Docker sandbox → 按需创建/销毁