Obsidian Smart Environment 的核心資料夾

.smart-env 是 Obsidian Smart Environment 的核心資料夾,用來儲存 AI 插件的本地嵌入資料、模型設定與上下文配置。它支援多個插件共享同一個嵌入索引,並確保資料不離開使用者裝置。


🧠 .smart-env 的主要功能與用途

這個資料夾是由 obsidian-smart-env 套件建立,目的是打造一個「本地優先、模組化、可擴充」的 AI 執行環境。以下是它的核心用途:

1. 共享嵌入索引(Shared Embedding Index)

  • 多個 AI 插件(如 Smart Chat、Smart Templates)可共用同一個嵌入資料庫。
  • 減少重複計算,加快啟動速度。

2. 本地資料儲存(Local-first)

  • 所有嵌入資料與模型設定都儲存在 .smart-env 資料夾中。
  • 不會將筆記內容上傳至雲端或第三方 API,保障隱私。

3. 即時嵌入更新(Real-time Embedding Refresh)

  • 每次筆記編輯後,系統會自動重新嵌入,不需手動重載。

4. 上下文切換(Context Profiles)

  • 支援根據工作情境切換不同的嵌入設定,例如「工作」、「家庭」、「專案」模式。

5. 模型與輸入控制(Model & Input Control)

  • 使用者可選擇本地或雲端模型(如 Ollama、LM Studio)。
  • 可從狀態列匯出整個 Smart Environment 的 JSON 設定。

📁 .smart-env 資料夾內容簡介

檔案 / 資料夾 功能說明
.ajson 檔案 儲存嵌入資料與筆記的向量表示,可供 ChatGPT 或其他模型解析
smart_env.config.js 自動產生的設定檔,定義要載入的模組與類別
smart_env.js 主程式入口,負責初始化 Smart Environment
collections/items/ 插件模組與資料類型的來源目錄
styles.css UI 元件樣式設定(若有)

⚠️ smart_env.config.js 是由建置流程自動產生的,請勿手動編輯。


🔧 適用對象與建議用途

  • 開發者:想打造 AI 插件但不想重複處理嵌入與模型設定。
  • 進階使用者:希望在 Obsidian 中使用本地 AI 模型並保留資料隱私。
  • 教育者 / 研究者:可用來建立可控、可重現的 AI 教學環境。

Also See

3
8:21 PM - December 06, 2025
8:21 PM - December 06, 2025
8:21 PM - December 06, 2025