An LLM-powered personal knowledge OS.
Drop a link in Telegram — KnowPipe extracts, classifies, enriches, and saves it as an Obsidian note. Then query your vault with AI, generate reports, and let knowledge compound over time. Not a bookmark tool — a full ingest → compile → query → output knowledge pipeline, fully automated.
Quick Start
git clone https://github.com/JaplinChen/KnowPipe.git && cd KnowPipe
npm install && cp .env.example .env
# Edit .env → set BOT_TOKEN and VAULT_PATH
./start.shGet your BOT_TOKEN from @BotFather on Telegram. Set VAULT_PATH to your Obsidian vault directory. That's it — send any URL to your bot and it becomes a note.
Supported platforms: X / Threads / Reddit / YouTube / GitHub / TikTok / Bilibili / Weibo / Xiaohongshu / Douyin / Zhihu / iTHome + any webpage.
See 中文文件 below for full documentation.
LLM 驅動的個人知識作業系統。
丟一個連結給 Telegram Bot，它會自動抓取、AI 分類、摘要豐富化、存入 Obsidian — 然後你可以對知識庫提問、生成報告、追蹤趨勢。知識不只是被收藏，而是被編譯、連結、持續增值。
為什麼需要 KnowPipe？
你在 Twitter 看到一篇好文、Reddit 上有精彩討論、Threads 上有值得收藏的串文—— 但你知道這些內容遲早會消失在時間線裡。
傳統做法是「人寫、機器讀」。KnowPipe 反過來：機器寫、人審閱。
每次擷取都自動豐富化——AI 摘要、實體萃取、智慧分類。每次查詢的結果都回流知識庫——探索 → 沉澱 → 再探索，形成知識複利。你的 Vault 不是靜態筆記堆，而是一個持續成長的知識體。
架構哲學：知識流水線
KnowPipe 的設計圍繞一條完整的知識生命週期，從原始資料到可操作的知識：
攝取 ──→ 編譯 ──→ 查詢 ──→ 輸出 ──→ 自癒
Ingest Compile Query Output Lint
↑ │
└────────── 知識複利閉環 ←───────────┘
| 階段 | KnowPipe 做了什麼 | 指令 |
|---|---|---|
| 攝取 Ingest | 14 平台 Extractor + PDF + 通用網頁 + 雷達自動搜尋 + 多平台巡邏，全自動攝取 | 丟連結 / /radar / /track |
| 編譯 Compile | 108 規則智慧分類 → AI 摘要 + 翻譯 → 實體萃取 + 知識圖譜 → 主題編譯（Karpathy 三層）→ Harness 品質閘門（含 AI 偽裝偵測）→ 分類器自動進化 | 自動 / /knowledge / /compile |
| 查詢 Query | Vault 知識問答、主題探索、深度合成、對比分析、語意搜尋、互動式研究 | /ask / /explore / /research |
| 輸出 Output | 精華摘要 / 週報 / PPTX 簡報 / Anki 記憶卡 / PNG 資訊卡 / 趨勢警報，結果回流 Vault | /digest / /slides / /anki |
| 自癒 Lint | 品質審查 + HTML 殘留修復 + 重複掃描 + Extractor 健康探測 + 失敗反思日誌 | /vault / 自動排程 |
功能一覽
- 丟連結就存檔 — 穩定支援 14 個平台 + 通用網頁；中國平台支援三層降級（Camoufox → Jina Reader → MediaCrawler）
- 連結深度抓取 — 文章 / 回覆中的外部連結自動抓取完整內文（最多 3000 字），注入 AI 豐富化統合分析；已存 Vault 的連結在「相關連結」區塊自動附加
→ [[wikilink]]跳轉 - 內容雷達 —
/radar定期自動搜尋關注主題並存入 Vault（DDG / GitHub Trending / RSS / HN / Reddit / Dev.to / 自訂 JSON API） - RSSHub 巡邏 — 自架 RSSHub 服務，訂閱知乎 / B站 / 掘金 / 少數派等 5000+ 路由，自動攝取中文內容圈動態
- 追蹤系統 —
/track時間軸抓取、作者訂閱、多平台巡邏 - 內容過濾系統 — 全局分類黑名單 + 關鍵字封鎖（
/filter）；訂閱白名單（每個帳號可設定只抓指定分類）；巡邏/訂閱/雷達通知均帶 👎 不感興趣 按鈕（點擊封鎖該分類）及 🗑️ 刪除+封鎖 按鈕（同時刪除 Vault 筆記）；巡邏 👎 展示關鍵字選擇器讓用戶精確封鎖
- 智慧分類 — 計分制分類器，108 條規則覆蓋 24 大類（含 13 個 AI 子領域），支援 exclude 防誤判 + 動態學習
- AI 豐富化 — 自動摘要、關鍵字萃取；插圖辨識（最多 5 張，
## 插圖說明區塊）；內嵌影片逐字稿（Web 文章內 YouTube iframe 自動轉錄）；連結全文分析（所有外部連結抓取正文，GitHub 額外解析 stars / language / topics，AI 統合主文與連結內容）；留言品質篩選（廣告詞過濾、按讚數排序、## 精選討論技術評論獨立區塊） - 知識圖譜 — 實體萃取、關係三元組（compares / builds_on / integrates 等）、缺口分析、Skill 自動生成
- 主題編譯 — Karpathy 三層架構（raw → compiled → wiki），同主題 ≥3 篇筆記自動編譯為結構化綜述，含工具對比表格、交叉洞察、wikilink 引用
- 記憶整合 — 自動發現跨筆記關聯，LLM 語義合成，每週生成整合報告
- 批次翻譯 — 英文 / 簡中筆記自動翻譯為繁體中文
- 分類器自動進化 — AlphaEvolve 啟發：每次執行
/knowledge evolve自動生成 5 個候選規則變體，在 eval dataset（每分類 5 篇）上評估準確率，改善 >1% 時自動套用至learned-patterns.json
- 知識問答 —
/ask用 Vault 筆記上下文 + AI 回答問題 - 知識探索 —
/explore推薦筆記、知識簡報、深度合成、主題對比 - 統一搜尋 —
/search一個入口搜 Vault 筆記、網頁、跨平台提及、影片字幕 - 影片語意搜尋 —
/vsearchFTS5 三元組索引，支援中英文混合查詢 - 研究助理 —
/research互動式研究對話
- 知識報告 —
/digest精華摘要（含 💀 知識死角：近 90 天有筆記但 30 天未查詢）、週報合成、知識蒸餾（含 📈 季度技能成長 sparkline）、跨筆記洞察、baoyu-xhs-images 風格知識卡片 - 簡報生成 —
/slides自動產生 PPTX 簡報 - 記憶卡 —
/anki生成 Anki 記憶卡 - 資訊卡片 — 每則筆記自動生成視覺化 PNG 摘要卡
- 主動推理 — 每日自動推送知識摘要 + 趨勢警報 + 分類提醒 + 當日過濾統計
- 相關筆記推薦 — 兩層演算法（實體圖譜 → 關鍵字比對）自動附加
[[wikilink]]連結
- 品質管理 —
/vault統一入口：品質報告（含自動修復按鈕）、重複掃描、AI 重處理、排版修正 - Vault 品質守護 —
/vault guardian六維度自動評分（摘要深度 / 關鍵字相關性 / 分類適合度 / 逐字稿使用 / 廣告污染 / metadata 完整性）；低分文章自動推送 Telegram 通知；每日品質日誌寫入vault/_meta/quality-log.md；MOC 與 auto-generated 報告自動豁免 - Harness 品質管線 — Evaluator-Generator 分離架構：規則檢查（含 AI 偽裝偵測：關鍵字與原文重疊率 < 2 時觸發重生成）→ 語義評分（0-10 分四維度）→ 針對性修復，品質標準與生成能力解耦
- 自我修復 — 排程掃描自動修復 HTML 殘留 / 壞路徑，Extractor 健康探測 + 降級告警
- 失敗反思系統 — Extractor 失敗自動分類原因（
auth_blocked/timeout/structure_changed），重試時輸出診斷日誌 - 事故偵測 — 每 5 分鐘掃描 log 的已知錯誤簽名，異常達閾值時 Telegram 推播警報；
/doctor顯示 24h 自癒事件統計 - 自癒 CI — GitHub Actions workflow（
self-heal.yml）偵測 PR CI 失敗時，自動呼叫 Claude Code 分析並修復，最多 3 次迭代；超過次數或判斷無法自動修復時，自動建立 GitHub Issue 升級給人工
- 10 個核心指令 + 34 個完整指令 — InlineKeyboard 按鈕引導
- 遠端管理 —
/admin狀態、診斷、日誌、重啟、遠端指令 - Admin Web UI —
http://localhost:3001啟動時自動開啟研究介面；點「管理」按鈕進入設定（初始設定、功能配置、監控面板） - 多模型智慧路由 — 依複雜度自動選 flash / standard / deep 免費模型；可選 oMLX 本地推理
- 功能開關 —
/config即時切換 12 項功能（含 YouTube 說話人識別） - 跨裝置同步 — 搭配 Remotely Save + InfiniCLOUD 免費 WebDAV
支援平台（14 個）
| 平台 | 內容 | 評論 | 時間軸 | 備註 |
|---|---|---|---|---|
| X / Twitter | ✅ | ✅ | — | fxTweet API |
| Threads | ✅ | ✅ | ✅ | topic tag 自動偵測，智慧標題 |
| ✅ | ✅ | — | 公開 API | |
| YouTube | ✅ | — | — | yt-dlp 字幕擷取 + InnerTube HTML fallback + 播放清單 |
| GitHub | ✅ | — | — | Repo / Issue / PR |
| TikTok | ✅ | — | — | yt-dlp + whisper.cpp STT 逐字稿 |
| iTHome | ✅ | — | — | 台灣科技新聞 |
| 通用網頁 | ✅ | — | — | 5 層降級（Readability → Jina Reader → Camoufox → Browser Use → Regex） |
| PDF 文件 | ✅ | — | — | 直接傳檔到 Telegram |
| 直連影片 | ✅ | — | — | MP4 / WebM / MKV 直連下載 + 轉錄 |
| 平台 | 內容 | 備註 |
|---|---|---|
| Bilibili | 需 yt-dlp，部分內容需登入 Cookie | |
| 微博 | Camoufox + API，訪客驗證可能阻擋 | |
| 小紅書 | Camoufox → MediaCrawler（需 Cookie），登入牆頻繁 | |
| 抖音 / 今日頭條 | Camoufox → MediaCrawler（需 Cookie），反爬偵測嚴格 | |
| 知乎 | Camoufox + RSSHub 熱榜備援；專欄文章支援評論抓取 |
⚠️ 需登入的平台採三層降級：Camoufox（反偵測瀏覽器）→ MediaCrawler FastAPI 服務（需帳號 Cookie）→ 失敗拋錯。Cookie 填入data/mediacrawler-cookies.json，MediaCrawler 服務啟動方式：python3.11 scripts/mediacrawler-server.py。 通用網頁擷取另支援 Jina Reader 及 Browser Use CLI 作為中間層降級方案。
快速開始
在 Telegram 找 @BotFather → 傳送 /newbot → 取得 Token（格式：1234567890:AAFdFMgb...）
一般使用者 — 執行 npm install && cp .env.example .env，編輯 .env 填入設定
開發者 — 手動設定：
npm install
cp .env.example .env編輯 .env：
# 必填
BOT_TOKEN=your_telegram_bot_token
VAULT_PATH=/Users/yourname/ObsidianVault
# 選填
ALLOWED_USER_IDS=123456,789012 # 限制使用者（逗號分隔 Telegram user ID）
ENABLE_TRANSLATION=true # 啟用簡轉繁翻譯
MAX_LINKED_URLS=5 # 單則貼文最多抓取的外部連結數
SAVE_VIDEOS=false # 影片存入 Vault（預設 false，僅保留原始連結）
OMLX_API_KEY= # oMLX 本地推理（選配，需 macOS Apple Silicon）# Camoufox 初始化（首次，Threads/小紅書/抖音需要）
npx camoufox-js fetch執行 ./start.sh（或 npm run dev），保持終端機開啟即可。
指令速查（34 個指令）
Telegram / 選單只顯示 10 個核心指令，子功能透過按鈕展開。所有指令都可直接輸入使用。
| 指令 | 用途 |
|---|---|
| 傳送 URL | 自動擷取內容與評論，分類後存到 Vault |
| 傳送 PDF | 自動擷取文字、AI 摘要、分類存入 Vault |
/search |
統一搜尋入口（按鈕選：Vault / 網頁 / 提及 / 影片） |
/ask <問題> |
用 Vault 知識回答問題（AI 結合筆記上下文） |
/explore <主題> |
知識探索（推薦筆記 / 簡報 / 深度合成 / 對比） |
/digest |
知識報告（精華 / 週報 / 蒸餾 / 跨筆記洞察 / 知識卡片） |
/discover <關鍵字> |
GitHub 專案探索（無參數=每日熱門掃描） |
/radar |
內容雷達（自動搜尋+存入；add custom 可接 JSON API 自訂來源） |
/track |
追蹤入口（按鈕選：時間軸 / 訂閱 / 巡邏） |
/vault |
Vault 維護入口（品質 / 重複 / 重處理 / 排版 / 基準 / 重試 / 推薦連結） |
/admin |
系統管理入口（狀態 / 健康 / 診斷 / 日誌 / 重啟 / 指令 / 清除 / 學習） |
/help |
分類式說明選單 |
| 類別 | 指令 | 用途 |
|---|---|---|
| 搜尋 | /search |
統一搜尋（Vault / 網頁 / 提及 / 影片） |
/find <關鍵字> |
快速搜尋 Vault 筆記 | |
/monitor <關鍵字> |
跨平台提及搜尋 | |
/vsearch <關鍵字> |
影片語意搜尋（FTS5） | |
| 知識 | /ask <問題> |
Vault 知識問答 |
/explore <主題> |
知識探索（推薦 / 簡報 / 合成 / 對比） | |
/digest |
知識報告（精華 / 週報 / 蒸餾 / 整合） | |
/knowledge |
知識圖譜（缺口 / 技能 / 分析 / 健康 / DNA / 分類器進化） | |
/compile |
主題知識編譯（Karpathy 三層架構）/ 系統編譯 | |
/research |
互動式研究對話 | |
/slides |
AI 自動生成簡報（PPTX） | |
/anki |
生成 Anki 記憶卡 | |
/validate <想法> |
雙層創業驗證（AI 競品分析 + 核心判斷問題） | |
| 追蹤 | /track |
統一追蹤入口（時間軸 / 訂閱 / 巡邏） |
/timeline @用戶 |
抓取用戶最近貼文 | |
/subscribe |
訂閱管理（查看 / 新增 / 移除 / 白名單） | |
/patrol |
多平台巡邏（HN / Reddit / Dev.to / GitHub） | |
| 發現 | /discover <關鍵字> |
GitHub 專案探索 |
/radar |
內容雷達（多來源自動搜尋） | |
/suggest |
推薦相關筆記連結 | |
| Vault | /vault |
統一維護入口（7 子功能） |
/quality |
品質報告 + 自動修復 | |
/dedup |
重複筆記掃描 | |
/reprocess <路徑> |
重新 AI 豐富筆記 | |
/reformat |
修復排版問題 | |
/benchmark |
品質基準報告 | |
/retry |
重試失敗連結 | |
| 系統 | /admin |
統一管理入口（8 子功能） |
/config |
功能開關即時切換 | |
/filter |
內容過濾管理（查看 / 新增 / 移除黑名單） | |
/toolkit |
開發工具箱 | |
/memory |
匯出學習記憶 | |
/skillmgr |
AI 技能管理 |
所有指令缺參數時會自動引導輸入。統一入口使用 InlineKeyboard 按鈕選擇子功能。
| 統一入口 | 子指令 | 用途 |
|---|---|---|
/search |
vault <關鍵字> |
搜尋 Vault 筆記（frontmatter + 全文） |
web <查詢> |
網頁搜尋（DuckDuckGo） | |
monitor <關鍵字> |
跨平台搜尋提及 | |
video <關鍵字> |
搜尋影片筆記（章節/轉錄） | |
/knowledge |
dna |
🧬 知識 DNA — keyword 指紋、分類分佈、學習重心轉移、空白帶，結果存 Vault |
evolve |
🔬 分類器進化 — 自動生成規則變體、評估準確率、套用最佳變體 | |
/digest |
digest |
精華摘要（末尾自動附加 💀 知識死角） |
weekly |
週報深度合成 | |
distill |
知識蒸餾（末尾附加 📈 季度技能成長 sparkline） | |
distill conflicts |
矛盾偵測：找出 Vault 中互相衝突的觀點 | |
distill gaps |
知識缺口地圖：找出覆蓋不足的領域 | |
consolidate |
跨筆記洞察 | |
cards |
baoyu-xhs-images 知識卡片（自動選 style/layout） | |
/track |
timeline @用戶 [數量] |
抓取用戶最近貼文 + 時間軸視覺提示詞 |
subscribe |
訂閱管理（查看/新增/移除） | |
patrol |
多平台巡邏（HN/Reddit/Dev.to/GitHub） | |
patrol stats |
Bot 主動值班效率報告（proactive ratio） | |
/vault |
quality |
品質報告 + 自動修復按鈕 |
dedup |
掃描重複筆記 | |
reprocess <路徑> |
重新 AI 豐富筆記 | |
reformat |
修復排版問題 | |
benchmark |
品質基準報告 | |
retry |
重試失敗連結 | |
suggest |
推薦相關筆記連結 | |
guardian [--since Nh] [--dry-run] |
六維度品質守護掃描，低分文章推送 Telegram | |
draft [category] [--days N] |
從指定分類近 N 天筆記生成草稿 | |
/admin |
status |
Bot 狀態與統計 |
health |
系統健康報告 | |
doctor |
全面即時診斷（含 ⚡ 管線韌性稽核：掃描所有 LLM 呼叫點的 try/catch 覆蓋狀況） | |
logs [n] |
查看最近 log | |
restart |
遠端重啟 Bot | |
code <action> |
遠端執行指令 | |
clear |
清除統計 | |
learn |
Vault 學習（分類/翻譯） |
研究工具（Research Toolkit）
KnowPipe 不只是收錄工具——內建完整的研究工作流，讓 Vault 中累積的知識可以被查詢、分析、重組為新的輸出。
| 指令 | 用途 | 輸出 |
|---|---|---|
/research <主題> |
從 Vault 搜尋相關筆記，AI 生成研究摘要 | Telegram 訊息（摘要 + 核心概念 + 關鍵問題 + 參考筆記） |
/slides <主題> |
根據 Vault 筆記自動生成簡報 | PPTX 檔案（直接下載） |
/anki <主題> |
生成記憶卡片 | 10 張問答式 flashcard |
Bot 啟動後瀏覽器自動開啟 http://localhost:3001/research，進入三欄式互動研究介面。點左側欄「管理」按鈕可開啟設定面板（初始設定、功能配置、監控面板）：
- 左欄：筆記瀏覽器，支援資料夾樹狀展開、標籤篩選、多選勾選
- 中欄：輸入研究主題 → AI 分析 → 互動式對話（支援對話歷史、
[[wikilink]]引用） - 右欄：工具面板 — 投影片預覽/下載、AI 工具快捷入口（結果統一輸出至中欄）
每條 AI 回應下方的 Action Bar：
| 按鈕 | 說明 |
|---|---|
| 📋 複製 | 將該則回應複製到剪貼簿 |
| 💾 存入 Vault | 將該則回應存為 Vault/KnowPipe/知識整合/research-{主題}-{時間}.md |
| 🛠 工具 ▾ | 下拉選單觸發研究報告、比較表、Anki、教學大綱（結果顯示於中欄對話區） |
輸入框底部「💾 全部存入 Vault」可將整段對話（所有 AI 回應）合併成一份筆記。存入後以 toast 顯示檔名確認，已存入按鈕自動鎖定防重複。
存入的 Markdown 帶有 frontmatter：category: 知識整合、tool: {工具類型}、tags。
支援三語切換（繁中 / English / Tiếng Việt）。
Vault 筆記 → 內容壓縮 → 版面推斷 → PPTX 渲染
11 種版面自動推斷：標題頁、摘要、條列、對比（左右欄 + VS 標記）、表格、引言、指標卡片（2×2 KPI）、時間軸、來源引用、架構分層圖、圖片集
3 種配色風格：Notion 暖色調、技術藍圖深色、企業淺色
版面根據內容關鍵字自動推斷（例如含「比較」→ 對比版面，含「架構」→ 分層圖），使用 pptxgenjs 渲染為標準 PPTX 檔案，支援微軟正黑體繁中排版。
| 工具 | 說明 |
|---|---|
| 研究報告 | 結構化報告（摘要、背景、核心發現、分析洞察、結論建議），deep 模型生成 |
| 對比表格 | 自動比較 Vault 中的工具/方案/概念，Markdown 表格 + 分析總結 |
| Anki 卡片 | 10 張理解導向的問答卡片，適合主動回憶練習 |
| 教學大綱 | 學習目標 + 5-8 章課程架構 + 延伸閱讀推薦 |
研究工具內建智慧文本壓縮，自動清除圖片標記、廣告話術（30+ 模式）、重複段落（Jaccard 相似度 >0.75 自動去重），並根據主題相關性篩選內容。壓縮結果以 SHA256 雜湊快取，避免重複處理。
常見問題
Bot 沒有回應？
在終端機按 Ctrl+C 停止，再執行 npm run dev 重新啟動。
顯示「409 Conflict」？ 上次 Bot 未正確關閉。程式內建 ProcessGuardian 三段式自癒會自動處理：指數退避重試 → 自動 logOut + 冷卻 → 退出提示。通常無需人工介入。
抓取超時或失敗？ 所有外部請求皆有超時保護（HTTP 30s / 影片 120s / 存檔 10s）。如果 DuckDuckGo 被限流，搜尋會自動降級到 Camoufox。
想修改設定？
編輯 .env 檔案，或在 Telegram 使用 /config 即時切換功能開關。
跨裝置同步（選配）
Vault 預設不儲存影片（SAVE_VIDEOS=false），實際大小約數十 MB，非常適合雲端同步。
推薦方案：InfiniCLOUD（免費 20GB WebDAV）+ Remotely Save 外掛
- 註冊 InfiniCLOUD → My Page → 開啟 Apps Connection → 取得 WebDAV 位址與專用密碼
- Obsidian 安裝 Remotely Save 外掛 → Remote Service 選 WebDAV → 填入位址、帳號、WebDAV 密碼
- 建議啟用 Password-Based Encryption（E2E 加密）
- 三台裝置（Windows / Mac / iPhone）使用相同設定，首次同步後即可自動排程
其他相容後端：OneDrive、Dropbox、S3、Synology NAS WebDAV。
開發資訊
npm run dev # 開發模式（tsx 即時執行）
npm run dev:loop # 開發模式 + 自動重啟（搭配 /restart 指令）
npm run build # 編譯 TypeScript
npm start # 生產模式（需先 build）
npm run start:loop # 生產模式 + 自動重啟
npx tsc --noEmit # 型別檢查
npm test # 執行測試（Vitest）
npm run lint # ESLint 檢查
npm run format # Prettier 排版攝取 編譯 查詢 輸出
Ingest Compile Query Output
───────────── ────────────── ───────────── ──────────────
14 平台 Extractor 108 規則分類器 /ask 知識問答 /digest 週報
+ PDF / 通用網頁 + AI 摘要 + 翻譯 /explore 探索 /slides 簡報
+ /radar 雷達 + 實體萃取 /research 研究 /anki 記憶卡
+ /track 巡邏 + 知識圖譜建構 /vsearch 語意搜 PNG 資訊卡
+ 連結深度抓取 + 動態學習 /search 統一搜 主動推理推送
+ RSSHub 5000+ 路由 + 記憶整合 wikilink 推薦
+ 主題編譯（Karpathy）
自癒 Lint
──────────────
Harness 品質閘門
（Evaluator→Generator）
HTML 自動修復
Extractor 健康探測
失敗反思 + 重試
- TypeScript + ESM（
tsx執行），316 個檔案 - Telegraf — Telegram Bot API（10 指令 hub 架構 + InlineKeyboard + ForceReply）
- Camoufox — 反偵測瀏覽器（Firefox 基底），瀏覽器池最多 4 實例，閒置立即釋放
- Jina Reader — 通用網頁 Markdown 轉換（
r.jina.ai），Readability 失敗時自動觸發，零配置 - RSSHub — 自架 Docker 服務（port 1200），5000+ 路由覆蓋中文內容平台，整合進 Patrol 巡邏來源
- MediaCrawler — Python FastAPI 服務（port 8765），小紅書 / 抖音帶 Cookie 抓取，Camoufox 失敗時自動降級
- ProcessGuardian — 三段式 409 自癒（指數退避 → 自動 logOut + 冷卻 → 退出）+ 殭屍進程自動清理
- OpenCode CLI + 多模型路由 — 依複雜度自動選 flash / standard / deep 免費模型；可選 oMLX 本地推理優先
- 知識系統 — 實體萃取、知識圖譜、缺口分析、Skill 自動生成、用戶偏好萃取、知識蒸餾（含視覺化提示詞）、記憶整合、MOC 生成、Karpathy 主題編譯
- 視覺卡片系統 —
visual-cards-builder自動依分類選 style（notion/minimal/bold/fresh），依摘要長度選 layout（dense/balanced/list），輸出 baoyu-xhs-images 格式指令 - YouTube InnerTube fallback — yt-dlp 未安裝時自動降級到 HTML 頁面提取 metadata；說話人識別（feature flag，flash tier LLM）
- 研究助理 — 互動式研究對話、PPTX 簡報生成、Anki 記憶卡、壓縮快取、資源管理
- 資訊卡片 — 每則筆記自動生成 PNG 視覺摘要卡（標題 / 分類 / 關鍵字 / 分類色系）
- 分類系統 — 24 個分類模組、108 條規則（含 13 個 AI 子領域）+ 動態學習
- 所有長任務採 fire-and-forget：先回覆「處理中」→ 背景執行 → 完成通知
- 評論品質篩選：去除讚美/感謝語後不足 10 字的評論自動濾除
- URL 去重快取：避免重複儲存相同內容
- 批次翻譯：opencc-js（簡轉繁）+ Google Translate（英翻中），無需 API key
20 個自訂技能，涵蓋開發全流程：
| 類別 | 技能 | 用途 |
|---|---|---|
| 開發流程 | /design /dev /ship /improve |
架構確認 → 開發 → 驗證提交推送 → 審計改善 |
| 驗證 | /verify |
完成前 4 步驟閘門：tsc → 單元測試 → smoke check → git status |
| Session | /resume /handoff |
自動啟動 / 交接記錄 |
| 測試 | /test |
classify / extractor / smoke / status |
| 重構 | /refactor |
影響分析 → 遷移 → 模組化拆分 |
| Vault | /vault /vault-audit /vault-guardian |
維護修復 / Vault 全量品質稽核 / 品質守護排程 |
| Vault 蜂群 | /vault-swarm |
平行 Task agents 按分類稽核 Vault 品質，合併為單一 PR |
| Spec 驅動 | /spec |
從 specs/<name>.md 生成失敗測試 → TDD 迴圈直到通過 → 開 PR |
| Bot 管理 | /launch |
啟動 / 停止 / 診斷 409 |
| 維護 | /health /weekly |
即時快照 / 週維護（含依賴檢查） |
| 新平台 | /new-platform |
腳手架 → 實作 → 測試 → 提交 |
| 除錯 | /bug-swarm |
3 worktree 平行 TDD 修復，reviewer 選最優解 |
- 所有 TypeScript 檔案 ≤ 300 行
- 不使用任何 API SDK（無 Anthropic SDK、無 OpenAI SDK）
- LLM enrichment 來源：oMLX 本地推理（選配）→ OpenCode CLI 多模型路由（flash / standard / deep，全免費）→ DDG AI Chat（免費備援）
- Enrichment 輸出過濾廢話與廣告語，保持中性專業語氣；GitHub badge/shield 圖片自動清除
- Frontmatter 防護：
---關閉標記確保獨立成行，防止與後續內容黏合 - 外部呼叫必須有 timeout（HTTP 30s / yt-dlp 120s / Obsidian 10s）
- 輕量 Vault — 影片預設不存入 Vault（
SAVE_VIDEOS=false），僅保留原始 URL 連結
src/
├── index.ts # 入口（ProcessGuardian 自動重試）
├── bot.ts # Telegram Bot（ForceReply 攔截 + URL 處理）
├── classifier.ts # 內容智慧分類（108 規則 × 24 大類）
├── classifier-categories.ts # 分類規則資料（108 規則 × 24 大類）
├── saver.ts # Obsidian 存檔協調（主流程）
├── saver/ # 存檔子模組
│ ├── slug.ts # 檔名 slug 生成
│ ├── url-index.ts # URL 去重索引（in-memory + 持久化）
│ └── image-downloader.ts # 圖片下載 + 同來源洪水警告
├── process-guardian.ts # 三段式 409 自癒 + 殭屍清理 + PID lockfile
├── cards/ # 資訊卡片
│ ├── card-renderer.ts # PNG 卡片渲染引擎
│ └── card-templates.ts # 卡片版型（標題/分類/關鍵字/色系）
├── commands/ # 指令處理（32 指令 + InlineKeyboard）
│ ├── register-commands.ts # 統一指令註冊 + callback 路由
│ ├── *-hub.ts # 4 個統一入口（search/track/vault/admin）
│ └── *-command.ts # 各功能 handler
├── extractors/ # 各平台內容擷取器（14 平台）
│ ├── x-extractor.ts # Twitter/X（fxTweet API）
│ ├── threads-extractor.ts # Threads（Camoufox，topic tag 偵測）
│ ├── reddit-extractor.ts # Reddit（公開 API）
│ ├── youtube-extractor.ts # YouTube（yt-dlp + 播放清單）
│ ├── tiktok-extractor.ts # TikTok（yt-dlp + whisper.cpp STT）
│ ├── github-extractor.ts # GitHub（REST API）
│ ├── bilibili-extractor.ts # B站（公開 API）
│ ├── weibo-extractor.ts # 微博（API + Camoufox）
│ ├── xiaohongshu-extractor.ts # 小紅書（Camoufox）
│ ├── douyin-extractor.ts # 抖音（Camoufox）
│ ├── zhihu-extractor.ts # 知乎（Camoufox）
│ ├── ithome-extractor.ts # iTHome（台灣科技新聞）
│ ├── direct-video-extractor.ts # 直連影片（MP4/WebM/MKV）
│ └── web-extractor.ts # 通用網頁（5 層降級：Readability→Jina→Camoufox→BrowserUse→Regex）
├── formatters/ # 按平台分離的 Markdown 格式化
│ ├── base.ts # 組裝器（frontmatter + body + stats）
│ ├── shared.ts # 共用工具（評論品質篩選, badge 過濾）
│ └── *.ts # 各平台 formatter
├── knowledge/ # 知識系統
│ ├── knowledge-store.ts # 知識庫讀寫
│ ├── knowledge-graph.ts # 知識圖譜（缺口分析、實體關聯）
│ ├── skill-generator.ts # 高密度主題 → Skill 自動生成
│ ├── distiller.ts # 知識蒸餾
│ ├── topic-compiler.ts # 主題知識編譯（Karpathy raw→compiled 架構）
│ ├── consolidator.ts # 記憶整合（跨筆記叢集 + LLM 洞察）
│ ├── moc-generator.ts # Maps of Content 自動生成
│ ├── vault-analyzer.ts # 增量 Vault 分析（實體萃取 + 關係抽取）
│ ├── health-report.ts # 知識健康報告
│ └── knowledge-dna.ts # 知識 DNA（keyword 指紋 + 分類分佈 + 學習重心轉移）
├── research/ # 研究助理
│ ├── research-commands.ts # /research /slides /anki 指令
│ ├── chat-service.ts # 互動式研究對話引擎
│ ├── slide-pptx.ts # PPTX 簡報生成
│ └── research-ui.html # 研究介面 Web UI
├── enrichment/ # 內容後處理（連結展開、翻譯）
├── learning/ # 分類學習與 AI 增強（含 classifier-evolver.ts AlphaEvolve 進化循環）
├── radar/ # 內容雷達（多來源自動搜尋 → Vault）
├── patrol/ # 多平臺巡邏（HN / Dev.to / GitHub Trending / RSSHub）
├── admin/ # Admin Web UI（port 3001）
├── memory/ # 使用者偏好記憶
├── video/ # 影片語意搜尋（FTS5）
├── plugins/ # 插件系統（動態載入）
├── proactive/ # 主動推理（排程摘要 + 趨勢警報）
├── monitoring/ # 自我修復 + 品質基準
├── vault/ # Vault 維護工具
└── utils/ # 共用工具（LLM 路由 / 搜尋 / 快取 / 瀏覽器池 / Jina / RSSHub / MediaCrawler）
├── usage-tracker.ts # LLM 呼叫 usage 追蹤（tier/task/耗時，寫入 data/usage-stats.jsonl）
├── innertube-service.ts # YouTube HTML metadata 提取（yt-dlp fallback）
├── speaker-identifier.ts # YouTube 字幕說話人識別（flash tier）
└── visual-cards-builder.ts # baoyu-xhs-images 知識卡片 + 時間軸視覺提示詞生成
詳見 CONTRIBUTING.md。歡迎使用 Claude Code / Codex 等 AI 輔助工具。
ISC License — 可自由使用、複製、修改與散布，僅需保留版權聲明。