AI 設定

typemd 透過兩個管道整合 AI：

TUI AI 功能 — 自動產生描述、自動建議標籤、schema 探索，由 AI provider 驅動（Claude CLI、Ollama、LM Studio 等）
Skill instructions — tmd instructions 輸出嵌入的 skill 指令並附帶 vault context，可供任何 AI 工具使用

前置條件

已安裝 typemd 並初始化 vault
一個 AI provider：Claude Code、Ollama、LM Studio、或任何 OpenAI 相容 API

1. 安裝 typemd plugin

typemd plugin 讓 Claude Code 學會如何操作你的 vault。加入 typemd marketplace 並安裝：

claude
# 在 Claude Code 中：
/plugin marketplace add typemd/marketplace
/plugin install typemd@typemd-marketplace

這會安裝兩個 skill：

Skill	功能
vault-guide	教 AI 如何設計與管理 vault — CLI 指令、type schema、物件格式、wiki-links、views、templates
instructions-guide	教 AI 如何使用 `tmd instructions` 來取得附帶 vault context 的 skill 指令

vault-guide 會在 Claude Code 偵測到 .typemd/ 目錄時自動啟用。

2. 啟用 TUI AI 功能

在 vault 設定中加入：

ai:
  enabled: true

或使用 CLI：

tmd config set ai.enabled true

預設會使用 Claude CLI。若要使用其他 provider，請明確設定：

# .typemd/config.yaml — 使用 Ollama
ai:
  enabled: true
  default: ollama
  providers:
    ollama:
      type: openai-compatible
      base_url: http://localhost:11434
      model: qwen3-coder:30b

你可以設定多個 provider，並透過更改 ai.default 在它們之間切換。完整設定請參考設定 — AI 設定。

啟用後，TUI 中可以使用以下 AI 操作：

按鍵	動作
`g`	開啟 AI 動作選單（在物件上）— 產生描述 / 建議標籤
`Ctrl+E`	Schema 探索模式（在 type 上）— AI 分析物件並建議 schema 改進

3. 使用 skill instructions

tmd instructions 輸出嵌入的 skill 指令，並附帶你的 vault type 定義。這讓任何 AI 工具都能理解你的 vault，不需要手動收集 context。

# 列出可用的 skills
tmd instructions

# 取得 explore skill 及 vault context（JSON 格式）
tmd instructions explore

# 儲存 skill 到 Claude Code skills 目錄
tmd instructions explore --skill > .claude/skills/explore/SKILL.md

JSON 輸出包含你的 vault type 摘要（名稱、emoji、描述、屬性），AI 可以立即了解你的資料模型。完整說明請參考 tmd instructions。

接下來

安裝 typemd plugin 並啟用 AI 後，你可以：

請 Claude Code 分析你的 markdown 檔案並建議 type schema（explore skill）
請 Claude Code 匯入既有檔案到你的 vault（importer skill）
使用 TUI AI 功能自動產生物件的描述和標籤
將 tmd instructions 的輸出導入任何 AI 工具，進行 vault 感知的工作流程