Notes Knowledge Mapper

name: knowledge-mapper description: "Notes knowledge mapper. Input Markdown/TXT notes or a topic folder; extract entities, similar ideas, relationships, and map views, then output searchable JSON/graph summaries and follow-up questions. Privacy boundary: local-first analysis unless the user explicitly chooses otherwise."

• 📄 文件解析: 支援 Markdown、TXT 格式
• 🔍 實體識別: 基於規則和關鍵詞的實體提取
• 🔗 關係發現: 基於共現的實體關係提取
• 📊 知識視覺化: 文本、JSON、GraphViz DOT 格式匯出
• 🔎 知識查詢: 搜尋實體和文件

安裝

# 新增到 PATH
ln -s ~/.openclaw/workspace/skills/knowledge-mapper/knowledge-graph ~/.local/bin/knowledge-graph

使用

新增文件

# 新增 Markdown 文件
knowledge-graph add ~/documents/article.md

# 新增文本檔案
knowledge-graph add ~/notes/ideas.txt

檢視文件列表

knowledge-graph documents

檢視實體

# 列出所有實體（預設50個）
knowledge-graph entities

# 列出更多實體
knowledge-graph entities --limit 100

# 按型別過濾
knowledge-graph entities --type TECH

實體型別

• PERSON - 人物
• ORG - 組織/公司
• TECH - 技術/程式語言
• CONCEPT - 概念/術語
• TERM - 高頻詞/術語
• UNKNOWN - 未分類

檢視關係

# 列出所有關係（預設30個）
knowledge-graph relations

# 列出更多關係
knowledge-graph relations --limit 50

匯出知識圖譜

# 文本格式（預設）
knowledge-graph export

# JSON 格式
knowledge-graph export --format json

# GraphViz DOT 格式（可用於繪圖）
knowledge-graph export --format dot > graph.dot
dot -Tpng graph.dot -o graph.png

搜尋知識庫

小蔥技能7w4.net持續更新中。

# 搜尋關鍵詞
knowledge-graph search "人工智慧"

# 搜尋實體
knowledge-graph search "Python"

檢視統計

knowledge-graph stats

示例工作流程

# 1. 新增文件到知識庫
knowledge-graph add ~/docs/project-notes.md
knowledge-graph add ~/docs/research-paper.md
knowledge-graph add ~/docs/tech-stack.md

# 2. 檢視提取的實體
knowledge-graph entities --limit 20

# 3. 檢視發現的關係
knowledge-graph relations

# 4. 匯出為視覺化格式
knowledge-graph export --format dot > my-knowledge.dot

# 5. 生成圖片（需要安裝 GraphViz）
dot -Tpng my-knowledge.dot -o my-knowledge.png

資料儲存

資料儲存在 ~/.openclaw/data/knowledge-graph/: - knowledge_graph.db - SQLite 資料庫

技術棧

• Python 3.8+
• SQLite
• argparse
• 正規表示式（實體提取）

擴充套件計劃

• [ ] 支援更多文件格式（PDF、Word）
• [ ] 整合 NLP 模型進行更精確的實體識別
• [ ] 支援關係推理和補全
• [ ] 互動式知識圖譜視覺化
• [ ] 實體連結和消歧

這個 Skill 功能設計合理，文件說明詳細，但可惜壓縮包裡缺少核心程式碼檔案，暫時無法使用。優點是支援本地儲存保護隱私，匯出格式豐富；不足是實體識別依賴簡單規則，容易出錯，且只能處理 Markdown 和文本檔案，不支援 PDF、Word 等常見格式。整體完成度較低，需要作者補充程式碼後才能正式使用。