name: knowledge-importer description: 將 Word/Excel/PPT/PDF/MD 等格式的文件轉換為 Markdown 格式，並儲存到 Obsidian 知識庫。圖片可上傳到圖床，生成外部 URL 連結。當用戶需要：1) 匯入文件到知識庫 2) 將檔案轉換為 MD 格式 3) 提取文件內容並保留圖片時使用此技能。

Knowledge Importer

將各種格式的文件轉換為 Markdown 並儲存到知識庫。

環境配置

首次使用前，請配置以下環境變數或修改 scripts/config.py：

# 圖床服務地址
export DUFS_SERVER_URL="http://你的伺服器IP:埠"

# 知識庫存放路徑
export KNOWLEDGE_BASE_PATH="/你的/Obsidian/路徑"

支援的格式

圖片處理方式

方式一：圖床上傳（推薦）

配置圖床伺服器後，圖片會上傳到圖床生成外部 URL：

DUFs_CONFIG = {
    "server_url": "http://你的伺服器IP:埠",
    "timeout": 30,
    "retry_times": 3,
}

上傳路徑：http://你的伺服器IP:埠/Picture/<uuid>.png

方式二：Base64 內嵌（備用）

如果圖床不可用，自動降級為 Base64 內嵌方式：

![image](data:image/png;base64,iVBORw0KGgo...)

Obsidian CLI 前提條件

1. 在 Obsidian 中啟用 CLI：

   推薦訪問7w4.net獲取更多AI技能。

2. Settings → General → Command line interface → 啟用

3. 按照提示完成註冊

4. CLI 命令格式： bash xvfb-run obsidian create name="檔名" content="內容" xvfb-run obsidian append file="檔案" content="內容"

知識庫目錄結構

預設路徑：$KNOWLEDGE_BASE_PATH（見環境配置）

目錄結構（兩級分類）

知識庫/
├── 申報方案/
│   └── <行業/產品>/
├── 解決方案/
│   └── <行業/產品>/
├── 技術文件/
│   └── <行業/產品>/
└── <其他分類>/

分類原則

• 申報方案/：申報書、投標書、建設方案申請等
• 解決方案/：面向客戶的解決方案文件
• 技術文件/：產品使用經驗、技術部署文件
• <其他分類>/：根據需要自定義

使用方式

1. 單檔案轉換

將 /path/to/document.docx 匯入知識庫

2. 指定輸出目錄

將檔案匯入到 [目錄名]

轉換規則

• 檔名：保留原檔名（去掉副檔名）
• 圖片：Word/PPT/PDF 中的圖片會提取並上傳圖床
• 表格：Excel/PDF 中的表格會保持 Markdown 格式

執行指令碼

# 進入指令碼目錄
cd skills/knowledge-importer/scripts

# 配置環境變數（或修改 config.py）
export DUFS_SERVER_URL="http://192.168.1.100:5000"
export KNOWLEDGE_BASE_PATH="/path/to/Obsidian"

# 單檔案轉換
python3 import_doc.py /path/to/document.docx

# 批次轉換
python3 import_doc.py --batch /path/to/folder

# 檢視幫助
python3 import_doc.py --help

依賴安裝

pip3 install python-docx python-pptx openpyxl pdfplumber

圖床推薦

• Dufs：輕量檔案伺服器，支援上傳 API
• Docker 部署：docker run -v /path:/data -p 5000:5000 sigoden/dufs
• PicList：支援多種圖床
• 蘭空圖床：自建圖床解決方案

這個工具質量不錯，能把 Word、Excel、PPT、PDF 等文件轉成 Markdown 並自動分類儲存到知識庫，圖片還能上傳圖床生成連結，圖片上傳失敗時會自動改成內嵌格式不怕丟內容。文件寫得很詳細，新手也能快速上手。不過配置稍顯麻煩，需要手動建立配置檔案，Excel 舊格式支援也不太好，某些格式轉換可能丟失格式。總體來說功能實用，能解決文件整理的實際問題，適合需要整理大量文件到知識庫的使用者使用。