内容
ObsidianMap
将 Obsidian 仓库转换为思维，供 Claude Code 使用。 可以在对话中搜索、遍历、链接和创建概念笔记。代码仓库将折叠为一个不透明的节点，以避免污染图形。
## 安装
您需要：**Node.js 20+**，**git**，和 **Claude Code**。
```bash
git clone https://github.com/alfarom256/ObsidianMap.git
cd ObsidianMap
npm install
npm run build
```
## 配置您的仓库
将示例配置文件复制到您的 Obsidian 仓库根目录，并将其重命名为 `.mindmap.json`：
```bash
cp .mindmap.example.json /path/to/yault/.mindmap.json
```
打开该文件并调整 `opaqueFolders` — 这些是应该折单个节点的目录 glob，而不是遍历典型的值：`Projects/*`Code/*`，`**/`。
## 在 Claude Code 中注册
```bash
claude m obsidian-mindmap -- node /absolute/path/to/Obsid/index.js /path/to/your/vault/.mindmap.json
```
在 Windows 上，在路径中使用杠（例如 `C:/you/ObsidianMap/dist`）。
## 验证
Code 中，运行 `/m。您应该看到 `obsindmap` 已连接。
> *在我的仓库中搜索与图论相关的节点。*
## 使用附带的技能进行一次性您不需要手动编辑 `.mind`，而是安装捆 Claude Code 技能，并让它引导您完成配置：
```mkdir -p ~/.claude/skills/configure-obsidian-map
cp SKILL.md ~/.claude/configure-obsidian-mapILL.md
```
然后在 中：`/configure-obs`。它会清点提出应该不透明/排除/索引为概念的目录，并在您写入配置。
## 向 Claude 公开的工具
**树导航：** `tree`，`children`，`parent`，`ancestors`，`siblings`
**查找：** `search_nodes`，`get_concept`
**交叉引用（wikilinks）：** `references_from`，`references_to`
**语义：** `suggest_gaps`
**写入：** `create_concept`，`link_concepts`，`update_concept`，`merge_concepts`，`reindex被建模为一棵树：每个概念透明文件夹节点都有一个（其包含的文件一直到 `folder:`。Wikilinks 和被解析和存储，但它们交叉引用** — 可通过 `references_from` / `references_to，而不是混合到导航中。
语义差距检测（
`@huggingfaceers` 由 `npm install安装。要启用差距检测，请在 `.mindmap.json` 中设置dings.enabled: true`， Claude Code。第一次调用 `suggest_gaps` 会下载约 30 MB 的模型权重并将其缓存在本地。然后询问 Claude： *我的仓库中有哪些概念差距？*
它返回语义相关链接的概念对。
## 配置参考
```jsonc
{
Path": ".", // 仓库根目录，相对于此配置文件opaqueFolders":/*"], // 折单个节点的目录 glob
"exclude": ["Untitled*.mdTemplates"], // 完全的文件路径 glob（无节点 "conceptThreshold": {
"minChars": 200, // 小型笔记（低于两个）将被跳过
minOutgoingLinks": 2
},
"embeddings": "enabled": false,
"model": "Xenova/all-M-L6-v2",
similarityThreshold": 0.78
},
"watch { "enabled": truedebounceMs": "index": {": ".mindmap-index.json" }
}
```
## 日常笔记 在 Obsidian 中像往常一样编辑笔记；监视更新内存图和持久索引。
- `merge_concepts` 会的文件移动到 `<vault>/.trash/`，而不是删除它恢复。
- 如果图形偏移（例如，在 Obsidian 外进行命名），请让 Claude 调用index` 工具，或删除map-index.json` 并重启 MCP。
