# AI Sync

> AI Tools 端到端同步工作流，同步 Hermes 配置、记忆、技能和 Python 文件到 GitHub。

- Skill: `crimsonblazezero/ai-sync` (Agent Skill)
- Install (CLI): `npx skillmds@latest add crimsonblazezero/ai-sync`
- Raw SKILL.md: https://api.skillmd.com/api/skills/crimsonblazezero/ai-sync/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: crimsonblazezero (https://skillmd.com/u/crimsonblazezero)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/crimsonblazezero/ai-sync

---


# AI Tools 端到端同步工作流

## 触发条件
- 用户需要同步配置和技能到 GitHub
- 用户切换设备后需要同步 Hermes/Antigravity 配置
- 用户需要备份或恢复技能
- 用户想推送本地更改到远程仓库

## 同步架构

```
┌─────────────────────────────────────────────────────────────┐
│                    GitHub (远程仓库)                         │
│                                                             │
│  ┌─────────────────┐    ┌─────────────────┐                │
│  │ ai-sync         │    │ Zero-Tools      │                │
│  │ (配置 + 记忆)    │    │ (技能 + 脚本)    │                │
│  └─────────────────┘    └─────────────────┘                │
└─────────────────────────────────────────────────────────────┘
          ▲                        ▲
          │                        │
     ~/Desktop/ai-sync/    D:/Zero Tools/
          │                        │
          └────────┬───────────────┘
                   │
          symlink  │
                   │
      ~/AppData/Local/hermes/skills/
```

## 仓库结构

### 1. ai-sync 仓库
- **路径**: `~/Desktop/ai-sync/`
- **远程**: `crimsonblazezero/ai-sync`
- **用途**: 同步 Hermes 配置和记忆数据
- **内容**:
  - `hermes/config.yaml` - Hermes 配置
  - `hermes/SOUL.md` - Hermes 人格定义
  - `MEMORY.md` - 持久记忆
  - `USER.md` - 用户信息
  - `sync-config.sh` - 配置同步脚本
  - `sync-skills.sh` - 技能同步脚本
  - `sync-all.sh` - 一键同步脚本

### 2. Zero-Tools 仓库
- **路径**: `D:/Zero Tools/`
- **远程**: `crimsonblazezero/Zero-Tools`
- **用途**: 同步技能和 Python 脚本
- **内容**:
  - `skills/` - 126 个 Hermes 技能
  - `src/` - Python 脚本
  - `docs/` - 文档
  - symlink: `~/AppData/Local/hermes/skills/` → `D:/Zero Tools/skills/`

### 3. workbuddy-config 仓库
- **路径**: `/d/AgentSystem/workbuddy-config/`
- **远程**: 无（本地使用）
- **用途**: WorkBuddy 配置源
- **symlink**: `.workbuddy/` → `workbuddy-config/`

## 使用方法

### 快速开始

```bash
# 查看同步状态
bash ~/Desktop/ai-sync/sync-all.sh status

# 拉取配置和记忆（从 GitHub 同步到本地）
bash ~/Desktop/ai-sync/sync-config.sh pull

# 推送配置和记忆（从本地同步到 GitHub）
bash ~/Desktop/ai-sync/sync-config.sh push

# 拉取技能（从 GitHub 同步到 Zero-Tools）
bash ~/Desktop/ai-sync/sync-skills.sh pull

# 推送技能（从本地同步到 GitHub）
bash ~/Desktop/ai-sync/sync-skills.sh push

# 一键同步所有（配置 + 技能）
bash ~/Desktop/ai-sync/sync-all.sh pull
bash ~/Desktop/ai-sync/sync-all.sh push
```

### 详细操作

#### 1. 同步配置和记忆

```bash
cd ~/Desktop/ai-sync

# 拉取（远程 → 本地）
bash sync-config.sh pull

# 推送（本地 → 远程）
bash sync-config.sh push
```

**覆盖范围**:
- `~/AppData/Local/hermes/config.yaml`
- `~/AppData/Local/hermes/SOUL.md`
- `MEMORY.md`
- `USER.md`

#### 2. 同步技能

```bash
cd ~/Desktop/ai-sync

# 拉取（远程 → Zero-Tools）
bash sync-skills.sh pull

# 推送（Zero-Tools → 远程）
bash sync-skills.sh push
```

**覆盖范围**:
- `D:/Zero Tools/skills/`
- `D:/Zero Tools/src/`
- `D:/Zero Tools/docs/`

#### 3. 一键同步

```bash
# 一键拉取（配置 + 技能）
bash ~/Desktop/ai-sync/sync-all.sh pull

# 一键推送（配置 + 技能）
bash ~/Desktop/ai-sync/sync-all.sh push

# 查看状态
bash ~/Desktop/ai-sync/sync-all.sh status
```

## 注意事项

### 路径兼容
脚本已适配 Windows/MSYS2 环境，使用 `cygpath` 转换路径。

### 冲突处理
- 推送前会检查本地是否有未提交的更改
- 如果有本地更改，会先 commit 再 push
- 拉取前会检查是否有本地未提交的更改

### 备份策略
- 每次推送前会自动创建备份
- 备份保存在 `backups/` 目录
- 备份命名格式: `backup-YYYYMMDD-HHMMSS`

### 权限要求
- 需要 SSH 访问 GitHub 的权限
- 需要写入 `~/AppData/Local/hermes/` 的权限
- 需要写入 `D:/Zero Tools/` 的权限

## 故障排查

### 问题 1: SSH 连接失败
```bash
# 检查 SSH 状态
gh auth status

# 重新认证
gh auth login
```

### 问题 2: 路径转换错误
脚本已内置 `cygpath` 转换，如果仍有问题，检查：
- Git Bash 是否安装
- MSYS2 路径是否正确

### 问题 3: 权限不足
```bash
# 检查 Hermes 目录权限
ls -la ~/AppData/Local/hermes/

# 检查 Zero-Tools 目录权限
ls -la "D:/Zero Tools/"
```

### 问题 4: 技能数不一致
```bash
# 检查本地技能数
ls ~/AppData/Local/hermes/skills/ | wc -l

# 检查远程技能数
cd ~/Desktop/ai-sync && bash sync-skills.sh status
```

## 相关命令

### 手动同步
```bash
# 只同步配置
cd ~/Desktop/ai-sync && git pull && bash sync-config.sh pull

# 只同步技能
cd "D:/Zero Tools" && git pull

# 只推送配置
cd ~/Desktop/ai-sync && bash sync-config.sh push && git push

# 只推送技能
cd "D:/Zero Tools" && git add -A && git commit -m "sync skills" && git push
```

### 查看日志
```bash
# 查看同步日志
cat ~/Desktop/ai-sync/logs/sync-$(date +%Y%m%d).log

# 查看 Git 日志
cd ~/Desktop/ai-sync && git log --oneline -5
cd "D:/Zero Tools" && git log --oneline -5
```

## 更新记录

- 2026-08-02: 初始版本，创建同步脚本
- 2026-08-02: 修复 Windows/MSYS2 路径问题