Obsidian Windows 维护

你运行在 Windows 10，Obsidian 安装在 D:\sofeware\obsidian\，三个 vault 分别在 D:\Hermes\knowledge-base、D:\Hermes、D:\Hermes\hermes-agent。

环境速查

• Obsidian 安装目录：D:\sofeware\obsidian\Obsidian.exe
• 用户数据目录：C:\Users\28672\AppData\Roaming\obsidian\
• 全局配置：C:\Users\28672\AppData\Roaming\obsidian\obsidian.json
• 日志文件：C:\Users\28672\AppData\Roaming\obsidian\obsidian.log
• Vault 配置目录：<vault>\.obsidian\

一、启动卡在"加载仓库中..."

先看日志

tail -50 "C:\Users\28672\AppData\Roaming\obsidian\obsidian.log"

常见原因（按频率）

1. core-plugins.json 损坏（0 字节空文件）

检查三个 vault 的 core-plugins.json：

ls -la "D:\Hermes\hermes-agent\.obsidian\core-plugins.json"
ls -la "D:\Hermes\.obsidian\core-plugins.json"
ls -la "D:\Hermes\knowledge-base\.obsidian\core-plugins.json"

如果某个是 0 字节，从正常 vault 复制：

cp "D:\Hermes\knowledge-base\.obsidian\core-plugins.json" "D:\Hermes\hermes-agent\.obsidian\core-plugins.json"

2. 自动更新从 GitHub 下载卡死

日志中反复出现 Downloading update from https://github.com/obsidianmd/obsidian-releases/releases/download/... 说明 Obsidian 在尝试下载新版 asar.gz。GitHub Releases 在国内极慢，会阻塞 vault 加载。

修复：禁用自动更新

编辑 C:\Users\28672\AppData\Roaming\obsidian\obsidian.json，添加：

{
  "config": {
    "autoUpdates": false
  }
}

用 execute_code 直接改（不要用 yaml.dump / patch，直接用 json 读写）：

import json
path = 'C:/Users/28672/AppData/Roaming/obsidian/obsidian.json'
with open(path, 'r') as f:
    data = json.load(f)
data['config'] = {'autoUpdates': False}
with open(path, 'w') as f:
    json.dump(data, f, indent=2)

改完后清理 pending-update 缓存：

rm -rf "C:\Users\28672\AppData\Local\obsidian\pending-update"

3. Vault 太大导致索引卡死

hermes-agent vault（含所有 skills）文件极多，首次索引会非常慢甚至卡死。

临时方案：切到轻量 vault

编辑 obsidian.json，把 open: true 从大 vault 移到 knowledge-base：

for k, v in data['vaults'].items():
    v.pop('open', None)
data['vaults']['1a41a7935e557b20']['open'] = True  # knowledge-base

二、obsidian.json 结构

{
  "vaults": {
    "<hash>": {
      "path": "D:\\Hermes\\knowledge-base",
      "ts": 1782642883273,
      "open": true
    }
  },
  "config": {
    "autoUpdates": false
  }
}

• open: true 标记 Obsidian 启动时默认打开的 vault
• 只有一个 vault 的 open 应为 true
• vault hash 是 Obsidian 生成的固定 ID

三、常用诊断命令

# 查看进程
tasklist | grep -i obsidian

# 强制杀掉
taskkill -f -im Obsidian.exe

# 查看 vault 配置
cat "C:\Users\28672\AppData\Roaming\obsidian\obsidian.json"

# 查看最近的错误
grep -i -E "error|fail|crash|exception|corrupt" "C:\Users\28672\AppData\Roaming\obsidian\obsidian.log" | tail -10

四、Pitfall：computer_use 截 Obsidian 窗口返回 0x0

如果 computer_use capture app=Obsidian 返回 0x0，先 list_apps 确认窗口名。Obsidian 启动后窗口可能有短暂的不可见期，等 5-8 秒再截图。