PD2 Wiki Sync Tool

Project Diablo 2 Wiki 中英文同步工具，用于同步英文 Wiki 变更到中文翻译文档。

前置要求

1. 安装 Claude Code

本工具需要通过 Claude Code 来使用。

# 安装 Claude Code
npm install -g @anthropic-ai/claude-code

2. 克隆仓库

git clone <repository-url>
cd sync-pd2-wiki

3. 创建虚拟环境并安装依赖

python -m venv venv
source venv/bin/activate  # Linux/macOS
# 或
.\venv\Scripts\activate  # Windows

pip install -r requirements.txt

使用方法

启动 Claude Code

在项目目录下运行：

claude

使用 Skill 同步 Wiki

在 Claude Code 中使用 /wiki-sync-translate 命令：

示例 1：同步特定时间的所有页面变更

/wiki-sync-translate 帮我同步从2026-01-02以来的所有变更

示例 2：同步特定页面

/wiki-sync-translate 同步 Maps 页面的变更

示例 3：同步特定时间范围的单个页面

/wiki-sync-translate 同步从2026-01-01开始的 General Changes 页面

示例 4：同步最近的变更

/wiki-sync-translate 同步最近一周的所有变更

输出文件

同步完成后，文件会保存在 wiki_sync_output/<时间戳>/ 目录：

wiki_sync_output/20260322_145110/
├── new_pages/                      # 新创建的页面
│   └── [页面名].full.txt           # 英文完整内容
│
├── changed_pages/                  # 有变更的页面
│   ├── [页面名].full.txt           # 英文最新版本
│   ├── [页面名].cn.txt             # 中文原文
│   ├── [页面名].comparison.json    # 结构化变更信息
│   └── [页面名].old.txt            # 英文历史版本
│
└── result_pages/                   # 更新后的中文文档
    └── [页面名].cn.txt             # 可直接复制到 Wiki

变更配对算法

工具使用内容相似度算法来判断变更是否应该配对：

• 相似度阈值：0.5（50%）
• 只有内容相似度 ≥ 50% 的行才会被配对为 replaced
• 这避免了将完全不同内容的行错误配对

目录结构

sync-pd2-wiki/
├── .claude/
│   └── skills/
│       └── wiki-sync-translate/
│           ├── SKILL.md             # Skill 定义
│           └── scripts/
│               └── wiki_sync.py     # 同步脚本
│
├── wiki_sync_output/               # 同步输出
├── references/                     # 参考文件
├── requirements.txt                # Python 依赖
├── CLAUDE.md                       # Claude Code 配置
└── README.md                       # 本文件

License

MIT