SuperAPI AI 工具集

wiki-import

办公与效率

查看项目

更新于 10-15 00:30

技能介绍

用途

wiki-import 用于把此前由 wiki-export 导出的 wiki 内容导入当前 Obsidian 仓库,实现仓库到仓库的知识迁移。它支持两种来源:

  • graph.json:图骨架,重建页面存根(frontmatter、类型化关系、## Related 链接列表,无正文),有损。
  • OKF 包(wiki-export/okf/ 目录):实际的 markdown 文件,重建带真实正文的完整页面,无损。真正的仓库间迁移应使用此方式。

两种方式都会写入带正确 frontmatter 和 wikilink 的页面,然后更新仓库元数据。

主要能力

  • 自动检测来源类型:.json 文件按 graph.json 处理;含 OKF frontmatter(type 键)的 .md 目录或含 okf_version 的根 index.md 按 OKF 包处理。
  • 导入前显示预览(节点/页面数量、链接数、目标仓库)。
  • 三种冲突处理模式:merge(默认,更新已有页面 frontmatter 并补充缺失 wikilink)、skip(不覆盖已有页面,仅创建新页面)、overwrite(用重建的存根替换匹配页面)。
  • graph.json 导入会构建邻接图和类型化边图,按模板重建页面存根。
  • OKF 导入会反向映射 frontmatter、还原正文中的 markdown 链接为 wikilink,并保留扩展键以实现无损往返。
  • 更新 .manifest.json、index.md、log.md 和 hot.md 等仓库元数据。

使用方式

  1. 解析配置:遵循 llm-wiki/SKILL.md 中的 Config Resolution Protocol,获得 OBSIDIAN_VAULT_PATH;如存在则读取 $OBSIDIAN_VAULT_PATH/AGENTS.md 应用约定。
  2. 定位并检测来源:用户提供路径则直接使用;否则按顺序自动检测 ./wiki-export/okf/ 目录、./wiki-export/graph.json 文件;都不存在则询问用户。
  3. 校验来源:graph.json 需为有效 JSON,含 nodes、links、graph 顶层键且至少 1 个节点;OKF 包需至少 1 个非保留 .md 文件且含可解析的 YAML frontmatter 和非空 type。
  4. 确定冲突模式(默认 merge)。
  5. 按来源类型重建页面(graph.json 走存根重建,OKF 走完整页面重建)。
  6. 更新仓库元数据:.manifest.json 新增条目并递增统计;通过 obsidian-wiki memory sync IMPORT 命令更新 index.md、log.md、hot.md。
  7. 打印导入摘要。

适用场景

  • 在 Obsidian 仓库之间迁移此前导出的 wiki 内容。
  • 需要无损迁移完整页面正文时使用 OKF 包导入。
  • 仅需重建结构骨架和 wikilink 时使用 graph.json 导入。

限制

  • graph.json 导入是有损的,只生成存根,不含正文。
  • OKF 包中无 frontmatter 或无 type 的 .md 文件会被跳过并计入 unparseable。
  • 若源 graph.json 经过可见性过滤,导入页面仅反映过滤后的集合。
  • 默认 merge 模式可安全重复运行,但会更新时间戳;overwrite 模式会完全重置页面为存根。
  • 引用了但不存在于 nodes 中的节点仍会显示为 wikilink,只是没有对应页面文件。
  • 具体收费、价格、平台支持等信息暂未提供。