sanguo_llmwiki/skills/wiki-export/SKILL.md

name, description, trigger

name	description	trigger
wiki-export	导出知识图谱为结构化格式（JSON、Markdown、GraphML）	当用户需要备份、迁移或分析 wiki 知识图谱时

Wiki Export

使用场景

• 备份知识图谱
• 迁移到其他系统
• 分析知识结构
• 生成可视化数据
• 与其他工具集成

操作步骤

1. 选择导出格式

   • JSON（完整数据）
   • Markdown（静态网站）
   • GraphML（图可视化）
   • CSV（数据分析）

2. 收集数据

   • 从 MCP Server 获取所有页面
   • 获取链接关系
   • 获取标签索引
   • 获取元数据

3. 格式化输出

   • 转换为选定的格式
   • 应用压缩（可选）
   • 生成目录结构

4. 写入文件

   • 保存到指定位置
   • 生成校验和
   • 创建清单文件

导出格式

格式 1：完整 JSON（完整备份）

{
  "version": "1.0",
  "exported_at": "2024-01-15T10:30:00Z",
  "stats": {
    "total_pages": 1353,
    "total_links": 4200,
    "total_tags": 156
  },
  "pages": [
    {
      "path": "practices/example.md",
      "title": "示例页面",
      "category": "practices",
      "tags": ["tag1", "tag2"],
      "summary": "页面摘要",
      "content_hash": "...",
      "lifecycle": "verified",
      "source_tool": "claude",
      "created_at": "2024-01-01",
      "updated_at": "2024-01-15",
      "indexed_at": "2024-01-15"
    }
  ],
  "links": [
    {
      "source": "practices/a.md",
      "target": "concepts/b.md"
    }
  ],
  "tags": [
    {
      "tag": "python",
      "count": 42
    }
  ]
}

格式 2：静态 Markdown（静态网站）

保持原有目录结构，可直接用于静态网站生成。

格式 3：GraphML（图可视化）

<?xml version="1.0" encoding="UTF-8"?>
<graphml xmlns="http://graphml.graphdrawing.org/xmlns">
  <graph id="wiki-graph" edgedefault="directed">
    <node id="practices/a.md">
      <data key="title">示例</data>
      <data key="category">practices</data>
    </node>
    <edge source="practices/a.md" target="concepts/b.md"/>
  </graph>
</graphml>

格式 4：CSV（数据分析）

path,title,category,tags,summary,lifecycle,updated_at
practices/a.md,示例,practices,"tag1,tag2",摘要,verified,2024-01-15

输出格式

{
  "success": true,
  "format": "json",
  "output_path": "/path/to/export.json",
  "stats": {
    "total_pages": 1353,
    "total_links": 4200,
    "file_size": "5.2MB"
  },
  "checksum": "sha256:..."
}

MCP 集成

调用 MCP Server 工具：

• wiki_status - 获取导出前的状态
• 查询所有页面、链接、标签

目录结构

导出输出目录：

export/
├── wiki-export-YYYYMMDD.json
├── wiki-export-YYYYMMDD.md/
│   ├── practices/
│   ├── concepts/
│   └── ...
├── wiki-export-YYYYMMDD.graphml
├── wiki-export-YYYYMMDD.csv
└── manifest.json  # 导出清单

配置选项

~/.sanguo-llmwiki/config.yaml：

export:
  default_format: "json"    # 默认导出格式
  compress_output: false    # 是否压缩
  include_content: true    # 是否包含页面内容
  split_large_files: false # 分割大文件

使用示例

备份整个 wiki：

wiki-export --format json --output ~/backups/wiki.json

导出用于可视化：

wiki-export --format graphml --output ~/analysis/wiki.graphml

导出用于数据分析：

wiki-export --format csv --output ~/data/wiki.csv

注意事项

1. 大型 wiki 导出可能需要较长时间
2. 确保有足够的磁盘空间
3. 验证导出文件的完整性
4. 敏感信息需注意保护