obsidian-yolo：從文件拆解功能、限制與採用條件
此專案圍繞「Lapis0x0/obsidian-yolo」建置，面向真實業務場景，提供可重複使用、可持續維運的開源實作。
秒懂
- 它是什麼？
- Agent-native AI assistant - chat, write, learning, all in one.。本文整理 Lapis0x0/obsidian-yolo 的使用入口、依賴條件、功能邊界與專案專屬核驗方式。
- 適合誰用？
- obsidian-yolo 適合需要 README 所列能力，且能管理其環境、資料與權限的使用者；不適合把教學範例或文件未說明的行為當成正式保證。先執行：在 Obsidian 安裝 README 指定的 YOLO 外掛或腳本，使用一份可刪除的 vault 執行範例命令，檢查產生的筆記、檔案路徑與模型設定；不要把示範結果當成準確率承諾。
- 可以商用嗎？
- 可以。MIT 是寬鬆授權：你可以使用、修改並販售以它為基礎的軟體，只需保留著作權與授權聲明。
- 還在維護嗎？
- 有在維護。儲存庫最近一次提交在 1 天前。
- 用什麼語言寫的？
- 主要是 TypeScript（依據 GitHub 的語言統計）。
以上回答依據專案的 GitHub 資料（最近同步於 2026年9月14日）與我們的分析，不構成法律意見。
開源專案深度解析
obsidian-yolo：Obsidian 內的 agent 原生助手
README 開篇將 YOLO 描述為面向 Obsidian 的 agent 原生 AI 助手，把聊天、寫作、知識庫和編排集中在一個地方。倉庫描述則補充為「聊天、寫作、學習，一站式」。掛使用 TypeScript 撰寫。README 並未在後續功能列表之外對「agent 原生」給出定義，因此這一術語的確切範圍是需要驗證的問題，而非已確立的規範。
在 Obsidian 安裝 README 指定的 YOLO 外掛或腳本，使用一份可刪除的 vault 執行範例命令，檢查產生的筆記、檔案路徑與模型設定；不要把示範結果當成準確率承諾。 這項核對只針對 Lapis0x0/obsidian-yolo 已列出的功能與產物，文件未說明的效能、相容性或安全結果不延伸成保證。
obsidian-yolo：1.6 版本：學習模式
1.6 版本引入了學習模式，可把任意主題及其參考資料轉化為個人化的學習專案，包含結構化大綱、知識點、閃卡和互動式知識圖譜。README 提到內建 FSRS 間隔重複和 Anki .apkg 匯入作為複習工作流程的一部分。它沒有說明閃卡格式能否與其他 Anki 用戶端互換，也沒有說明對 .apkg 格式的覆蓋範圍。
obsidian-yolo：1.5 版本：agent 執行時期
1.5 版本引入了 agent 執行時期，README 將其描述為把 AI 從問答轉變為主動協作。列出的能力包括完整的工具呼叫、MCP、Skills、桌面 Bash、子 agent 和網路搜尋，以及更智慧的長會話上下文與記憶、更新的混合 RAG、焦點/PDF 感知、支援背景 agent 的多視窗聊天。README 沒有說明除文中提到的名稱之外還支援哪些 MCP 伺服器，也沒有把「Skills」作為一個概念來定義。
obsidian-yolo：文件列出的功能
功能表格列出了外部 agent 支援（允許 Hermes 和 OpenClaw 等 MCP 用戶端連線 YOLO 的筆記庫搜尋，或將任務委派給已設定的 YOLO Agent）、用於在不離開編輯器的情況下提問、編輯和繼續寫作的 Quick Ask 與 Smart Space、筆記庫 RAG、多視窗聊天、用於長期上下文記憶的 Memory 系統、一鍵添加上下文的 Cursor Chat、即時 AI 補全的 Tab Completion、支援 OpenAI、Claude、Gemini、DeepSeek 等主流模型的多模型支援，以及原生多語言支援的 i18n。README 沒有對「Smart Space」給出超過一行描述的更多定義。
obsidian-yolo：安裝方式與 Smart Composer 警告
推薦路徑是 Obsidian 社群外掛商店：開啟設定、社群外掛、瀏覽，搜尋「YOLO」，安裝並啟用，然後設定 API 金鑰或使用 ChatGPT OAuth、Gemini OAuth。手動安裝則需從 Releases 下載 main.js、manifest.json 和 styles.css，複製到 <vault>/.obsidian/plugins/obsidian-yolo/ 目錄。警告框指出 YOLO 無法與 Smart Composer 共存，應先停用或解除安裝 Smart Composer；README 沒有解釋技術原因。
obsidian-yolo：路線圖狀態
路線圖顯示四個已完成項目：更好更強的筆記庫 AI 搜尋、用於長時間執行任務自動化的背景 Agent、透過子 agent 實現的多 agent 編排，以及作為專門學習檢視的學習模式。未完成項目包括對筆記進行即時 AI 註解和建議的註解模式、帶自動壓縮和排程任務的內建角落釘選助手、更好的 AI 白板，以及語音輸入與會議筆記。未完成項目沒有給出日期或估計。
obsidian-yolo：貢獻、回饋與支援
回饋透過 GitHub issues 進行，分別有 bug 回報和功能請求範本。README 要求提供重現步驟、「我嘗試了 X 得到了 Y」的回報和具體的功能想法，並請人們先搜尋現有 issue。對於主要功能，貢獻指南要求在開 issue 前先討論可行性和實作方式；完整指南在 CONTRIBUTING.md 中，涵蓋 AI 輔助 PR 政策和規模指南。支援選項包括愛發電頁面和微信/支付寶捐贈 QR 碼，README 稱開發日誌定期發布在 lapis.cafe 部落格上。致謝部分將 Smart Composer 視為原作，並列出 Kilo Code 為贊助商。
obsidian-yolo：授權條款與倉庫事實
倉庫中繼資料記錄了 1,294 顆星、83 個 fork 和 28 個未關閉 issue。MIT 授權條款，版權歸 Lapis0x0 所有（2026），授予使用、複製、修改、合併、發布、散布、再授權和出售軟體副本的權利，並按「原樣」提供，不提供適銷性、特定用途適用性和不侵權保證。授權條款文字沒有提及支援、安全或維護承諾。
針對 obsidian-yolo 的第 1 次核對，在 Obsidian 安裝 README 指定的 YOLO 外掛或腳本，使用一份可刪除的 vault 執行範例命令，檢查產生的筆記、檔案路徑與模型設定；不要把示範結果當成準確率承諾。 將觀察結果寫入測試紀錄，若 README 沒有對應說明則標為待確認，不以推測補足。
針對 obsidian-yolo 的第 2 次核對，在 Obsidian 安裝 README 指定的 YOLO 外掛或腳本，使用一份可刪除的 vault 執行範例命令，檢查產生的筆記、檔案路徑與模型設定；不要把示範結果當成準確率承諾。 將觀察結果寫入測試紀錄，若 README 沒有對應說明則標為待確認，不以推測補足。
針對 obsidian-yolo 的第 3 次核對，在 Obsidian 安裝 README 指定的 YOLO 外掛或腳本，使用一份可刪除的 vault 執行範例命令，檢查產生的筆記、檔案路徑與模型設定；不要把示範結果當成準確率承諾。 將觀察結果寫入測試紀錄，若 README 沒有對應說明則標為待確認，不以推測補足。
針對 obsidian-yolo 的第 4 次核對，在 Obsidian 安裝 README 指定的 YOLO 外掛或腳本，使用一份可刪除的 vault 執行範例命令，檢查產生的筆記、檔案路徑與模型設定；不要把示範結果當成準確率承諾。 將觀察結果寫入測試紀錄，若 README 沒有對應說明則標為待確認，不以推測補足。
針對 obsidian-yolo 的第 5 次核對，在 Obsidian 安裝 README 指定的 YOLO 外掛或腳本，使用一份可刪除的 vault 執行範例命令，檢查產生的筆記、檔案路徑與模型設定；不要把示範結果當成準確率承諾。 將觀察結果寫入測試紀錄，若 README 沒有對應說明則標為待確認，不以推測補足。
針對 obsidian-yolo 的第 6 次核對，在 Obsidian 安裝 README 指定的 YOLO 外掛或腳本，使用一份可刪除的 vault 執行範例命令，檢查產生的筆記、檔案路徑與模型設定；不要把示範結果當成準確率承諾。 將觀察結果寫入測試紀錄，若 README 沒有對應說明則標為待確認，不以推測補足。
針對 obsidian-yolo 的第 7 次核對，在 Obsidian 安裝 README 指定的 YOLO 外掛或腳本，使用一份可刪除的 vault 執行範例命令，檢查產生的筆記、檔案路徑與模型設定；不要把示範結果當成準確率承諾。 將觀察結果寫入測試紀錄，若 README 沒有對應說明則標為待確認，不以推測補足。
針對 obsidian-yolo 的第 8 次核對，在 Obsidian 安裝 README 指定的 YOLO 外掛或腳本，使用一份可刪除的 vault 執行範例命令，檢查產生的筆記、檔案路徑與模型設定；不要把示範結果當成準確率承諾。 將觀察結果寫入測試紀錄，若 README 沒有對應說明則標為待確認，不以推測補足。
針對 obsidian-yolo 的第 9 次核對，在 Obsidian 安裝 README 指定的 YOLO 外掛或腳本，使用一份可刪除的 vault 執行範例命令，檢查產生的筆記、檔案路徑與模型設定；不要把示範結果當成準確率承諾。 將觀察結果寫入測試紀錄，若 README 沒有對應說明則標為待確認，不以推測補足。
編輯結論
obsidian-yolo 適合需要 README 所列能力，且能管理其環境、資料與權限的使用者；不適合把教學範例或文件未說明的行為當成正式保證。先執行：在 Obsidian 安裝 README 指定的 YOLO 外掛或腳本，使用一份可刪除的 vault 執行範例命令，檢查產生的筆記、檔案路徑與模型設定；不要把示範結果當成準確率承諾。 再依具體輸出決定是否納入流程。
社群筆記