# dsh-git-sync

**Repository Path**: shenmo7192/dsh-git-sync

## Basic Information

- **Project Name**: dsh-git-sync
- **Description**: No description available
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-15
- **Last Updated**: 2026-08-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# dsh-git-sync

通过 Git 仓库同步 DeepSeek Harness 的配置、历史数据和提示词。

默认同步以下内容（可通过 `include` 调整）：

- `settings.yaml` — Harness 设置
- `AGENTS.md` — 用户全局提示词/约定
- `skills/` — 自定义技能与提示词
- `sessions/` — 会话历史
- `storages/` — 本地存储数据
- `cordis.patch.yml` — 用户级补丁配置
- `profiles/web/cordis.patch.yml`、`profiles/web/package.json` — Web profile 配置

不会同步 `.credentials.yaml` 等凭据文件。

## 安装

在插件源码目录执行：

```sh
dsh plugin --profile web add .
```

或从 GitHub 安装：

```sh
dsh plugin --profile web add github:shenmo7192/dsh-git-sync
```

## 配置

安装后可在 `~/.dsh/profiles/web/cordis.patch.yml` 中覆盖插件配置：

```yaml
- id: git-sync
  config:
    repository: https://gitee.com/shenmo7192/dsh-sync.git
    branch: main
    syncOnStart: true
    intervalMinutes: 60
    autoPull: true
    autoPush: true
    include:
      - settings.yaml
      - AGENTS.md
      - skills
      - sessions
      - storages
      - cordis.patch.yml
      - profiles/web/cordis.patch.yml
      - profiles/web/package.json
      - profiles/web/pnpm-lock.yaml
      - profiles/web/pnpm-workspace.yaml
      - profiles/web/cordis.yml
    ignore:
      - '**/node_modules/**'
      - '.credentials.yaml'
```

### 配置项

| 字段 | 说明 | 默认值 |
| --- | --- | --- |
| `repository` | Git 仓库地址 | `https://gitee.com/shenmo7192/dsh-sync.git` |
| `branch` | 分支 | `main` |
| `dshHome` | DSH 主目录 | `$DSH_HOME` 或 `~/.dsh` |
| `localPath` | 本地镜像仓库路径 | `~/.dsh-git-sync` |
| `statePath` | 同步状态文件路径 | `~/.dsh-git-sync-state.json` |
| `syncOnStart` | 启动时立即同步 | `true` |
| `intervalMinutes` | 定时同步间隔（分钟），`0` 表示不定时 | `60` |
| `autoPull` | 是否拉取远程更新 | `true` |
| `autoPush` | 是否推送本地更新 | `true` |
| `include` | 要同步的相对路径列表 | 见上文 |
| `ignore` | 忽略模式 | 见上文 |
| `userName` | Git 提交用户名 | `shenmo` |
| `userEmail` | Git 提交邮箱 | `shenmo@spark-app.store` |

## 工作原理

插件会在本机维护一个 Git 镜像仓库，默认位于 `~/.dsh-git-sync`：

1. 确保镜像仓库存在并切换到指定分支；
2. 读取本地同步状态（`~/.dsh-git-sync-state.json`）；
3. 首次在已有远程数据的设备上运行时，采用远程版本并应用到 DSH 主目录；
4. 如果只有本地修改，则提交并推送到远程；
5. 如果远程和本地都有修改，先把本地修改提交到镜像，再变基合并远程；若发生冲突则本次同步失败，需手动解决镜像仓库中的冲突；
6. 将最终合并结果应用回 DSH 主目录；
7. 如果开启了 `autoInstall`，自动在 `~/.dsh/profiles/*` 下执行 `pnpm install`，下载并安装同步过来的插件依赖。

> 注意：当前版本是面向个人多设备同步的轻量实现。如果多台设备同时修改同一文件，Git 合并冲突会导致本次同步失败，请手动解决镜像仓库中的冲突后再同步。