docs: add workflow diagram and CI syntax check

- README: mermaid flowchart at top showing 微信读书 → CLI → Obsidian vault → Bases 视图
- CI: GitHub Actions runs python3 -m py_compile on push/PR to catch syntax errors

Author: ZhongJiaqi

.github/workflows/syntax-check.yml

@@ -0,0 +1,19 @@
+name: Syntax Check
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  py-compile:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+      - name: Compile check
+        run: python3 -m py_compile weread-to-obsidian

README.md

@@ -2,6 +2,22 @@
 
 > 把微信读书的划线和想法自动整理成 Obsidian 笔记。让你"翻阅过的痕迹"从 App 里解放出来，变成可整理、可重读、可二次加工的素材。
 
+## 工作流一览
+
+```mermaid
+flowchart LR
+    A["📱 微信读书<br/>划线 · 想法"]
+    B["⚙️ weread-to-obsidian<br/>Python CLI · stdlib only"]
+    C["📖 单本笔记<br/>按章节 · YAML frontmatter<br/>weread:// 深链回 App"]
+    D["🗂️ Obsidian Bases 视图<br/>表格 · 时间线 · 卡片墙"]
+
+    A -->|"Agent API Gateway"| B
+    B -->|"输出 Markdown"| C
+    C -.->|"frontmatter 字段"| D
+```
+
+一条命令把笔记从微信读书拉到本地 Obsidian vault，并通过 `.base` 视图聚合浏览。
+
 ## 它做什么
 
 一条命令，把你在微信读书的笔记（划线 + 想法/批注）按章节结构化输出成 Markdown，落到 Obsidian vault 里。