XU Config Transfer

[!NOTE] 中文说明 配置搬运工 — 在多个 Obsidian 库之间勾选导出、导入配置（全局设置+插件配置），导入前自动备份、可一键还原。

在多个 Obsidian 库之间勾选导出、导入配置，支持逐项查看详情、冲突智能标注、覆盖前自动备份与一键还原。

Installation / 安装

1. Open Obsidian Settings → Community Plugins
2. Search "XU Config Transfer" and install, then enable
3. 打开 Obsidian 设置 → 第三方插件, 搜索 "XU Config Transfer" 安装并启用

Manual install / 手动安装:

1. Download main.js, manifest.json, styles.css from the latest release
2. Put them into <vault>/.obsidian/plugins/xu-config-transfer/

Usage / 使用方法

Export / 导出:

1. Run Export config (selected items) from the command palette (or Settings → Export config)
2. Use the View button to inspect each config file before exporting
3. Pick items and set the save path (any in-vault folder, editable at the bottom)
4. The export file xu-config-export-*.json is created; a dialog shows the full path with a "Show in folder" button (desktop)
   • 在源库运行「导出配置（勾选项）」，可用「查看」按钮预览每项配置，勾选后在底部自定义保存位置（库内任意文件夹），导出完成后弹窗显示完整路径并可一键打开所在文件夹（桌面端）

Import / 导入:

1. Copy the export file into the target vault (any folder except .obsidian)
2. Run Import config (selected items) — the whole vault is scanned; if no file is found, a step-by-step guide is shown
3. Pick items with conflict badges: New / Overwrite / Identical (identical items are unchecked by default)
4. A result report shows what changed per item, including key-level diffs for overwritten files and the backup path
   • 把导出文件复制到目标库任意文件夹（.obsidian 除外），运行「导入配置（勾选项）」——自动扫描全库，找不到文件时给出分步引导；勾选项带冲突标注（新增/覆盖/内容相同）；导入完成弹出结果报告，逐项列出变化明细（覆盖项含键级 diff）与备份路径

Restore / 还原:

• Settings → Backups: restore or delete batches with one click
• 设置页 → 备份管理：按批次一键还原或删除

Note / 提示: workspace.json (window layout) is always excluded; restart Obsidian after importing the community plugin list. workspace.json（窗口布局）不参与导出导入；导入插件启用清单后建议重启 Obsidian 生效。

Features / 功能

• Selective export: global settings (editor / appearance / hotkeys / core plugins / plugin list) + per-plugin data.json
• Selective import: conflict badges (New / Overwrite / Identical), whole-vault scan, step guide when nothing found
• Per-item detail preview (formatted JSON, copy button) before export
• Import result report with key-level diff for overwritten items and automatic timestamped backups
• One-click restore / delete by backup batch in settings
• Custom in-vault save path; "Show in folder" on desktop after export
• Mobile friendly (adapter API only, no Node); workspace.json always excluded
• 勾选导出：全局设置（编辑器/外观/快捷键/核心插件/插件清单）+ 各插件 data.json
• 勾选导入：冲突智能标注（新增/覆盖/内容相同）、全库扫描、找不到文件给引导
• 导出前逐项查看详情（格式化 JSON + 复制）
• 导入结果报告：覆盖项键级 diff、自动按时间戳备份
• 备份按批次一键还原/删除
• 保存位置可自定义（库内路径），桌面端导出后一键打开所在文件夹
• 全程 vault.adapter API，支持移动端；workspace.json 始终排除

License / 许可证

MIT