chore: squash all branches into one commit

Author: Kingson4Wu

.github/workflows/ci.yml

@@ -0,0 +1,60 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  test:
+    name: Test (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os:
+          - ubuntu-latest
+          - macos-latest
+          - windows-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v8.2.0
+        with:
+          enable-cache: true
+
+      - name: Sync dependencies
+        run: uv sync --dev
+
+      - name: Run tests
+        run: uv run pytest
+
+      - name: Run lint
+        run: uv run ruff check
+
+      - name: Check POSIX installer syntax
+        if: runner.os != 'Windows'
+        run: bash -n install.sh
+
+      - name: Check Windows installer syntax
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: |
+          $tokens = $null
+          $errors = $null
+          [System.Management.Automation.Language.Parser]::ParseFile(
+            (Resolve-Path "install.ps1"),
+            [ref]$tokens,
+            [ref]$errors
+          ) | Out-Null
+          if ($errors.Count -gt 0) {
+            $errors | Format-List
+            exit 1
+          }

.gitignore

@@ -0,0 +1,6 @@
+__pycache__/
+*.pyc
+.venv/
+*.egg-info/
+docs/superpowers
+

README.md

@@ -0,0 +1,131 @@
+# git-auto-sync
+
+定时巡检多个本地 Git 仓库,对有变动的仓库**智能挑选要提交的文件 → AI 生成提交信息 → 提交并同步到远程**,并把结果推送到你选择的通知通道。
+
+由参考脚本(单仓库 bash)演进而来,核心差异:多仓库、配置驱动、平台原生定时、可插拔的 AI provider 与通知通道。
+
+## 工作流程
+
+每个仓库依次执行:
+
+1. 无变动 → 静默跳过
+2. **智能暂存**:把变更交给 AI,挑出该提交的文件,排除机密 / 构建产物 / 超大文件;被排除项可自动写入 `.gitignore`(AI 不可用时降级为 `git add -A`)
+3. AI 生成 Conventional Commits 中文提交信息(失败回退规则法)
+4. `git commit`
+5. `git pull --rebase` → `git push`(冲突则 abort 保持干净、标记失败、继续下一个仓库)
+6. 按策略汇总并通知
+
+## 安装
+
+### 一行安装(推荐)
+
+macOS / Linux:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/OctopusGarage/git-auto-sync/main/install.sh | bash
+```
+
+Windows PowerShell:
+
+```powershell
+powershell -ExecutionPolicy ByPass -c "irm https://raw.githubusercontent.com/OctopusGarage/git-auto-sync/main/install.ps1 | iex"
+```
+
+会自动:装 [uv](https://docs.astral.sh/uv/)(若缺失)→ 下载**最新 release** 到 `~/.git-auto-sync` → `uv sync` → 在 `~/.local/bin` 放全局 `git-auto-sync` 启动器(macOS/Linux 为 shell 脚本,Windows 为 `.cmd`) → 首次安装运行引导向导 `init`。重复执行即更新已有安装,已有配置时会跳过向导避免覆盖。可用 `GIT_AUTO_SYNC_VERSION=v0.1.0` 固定版本、`GIT_AUTO_SYNC_DIR` 改安装目录。
+
+> 通过管道安装(无 tty)时会以 `--yes` 跑 `init`:写好配置但**不**安装定时任务——本工具会自动提交并 push,无人值守地启用它需要你显式执行 `git-auto-sync install`。
+
+### 手动安装
+
+```bash
+cd git-auto-sync
+uv sync                       # 安装依赖
+uv run git-auto-sync init     # 引导向导(见下)
+# 或安装为命令行工具:
+uv tool install .
+```
+
+### 引导向导(`init`)
+
+```bash
+git-auto-sync init            # 交互式:扫描目录挑选仓库、选 AI provider、配置通知、可选安装定时任务
+git-auto-sync init --yes      # 非交互,全用默认值,不安装定时任务
+```
+
+向导会扫描你指定的父目录(默认 `~/programming`)下**两层内**的 git 仓库供勾选,也可手动补充路径;写好 `~/.git-auto-sync/config.toml` 后即时校验。
+
+### 更新
+
+```bash
+git-auto-sync update          # 下载最新 release、uv sync(定时任务无需重装,启动器路径稳定)
+git-auto-sync update --check  # 只看有没有新版本
+```
+
+## 配置
+
+默认读取 `~/.git-auto-sync/config.toml`(可用 `--config` 指定)。所有运行时数据(配置、日志、调度产物)都在 `~/.git-auto-sync/` 下。
+
+```bash
+mkdir -p ~/.git-auto-sync
+cp config.example.toml ~/.git-auto-sync/config.toml
+```
+
+完整字段见 [`config.example.toml`](config.example.toml)。要点:
+
+- `[defaults]` 提供全局默认,每个 `[[repos]]` 可逐字段覆盖。
+- 任意字符串值支持 `env:VARNAME`,运行时从环境变量解析,避免把密钥写进文件。
+- `ai_provider`:`claude-cli`(默认,复用本地 `claude` CLI)/ `anthropic-api`(读 `ANTHROPIC_API_KEY`)/ `rules`(纯规则)。任何 provider 调用失败都会自动回退到规则法,工具不会因为 AI 不可用而中断。
+- `notify_on`:`change_or_fail`(默认,有变动或失败才通知)/ `fail_only` / `always`。
+
+## 命令
+
+```bash
+git-auto-sync init                  # 引导向导,生成配置
+git-auto-sync sync                  # 同步全部仓库
+git-auto-sync sync --repo foo       # 只同步路径匹配 foo 的仓库
+git-auto-sync sync --dry-run        # 预演:打印将要提交的内容,不落地
+git-auto-sync status                # 列出各仓库的分支与 clean/dirty
+git-auto-sync config check          # 校验配置文件
+git-auto-sync install --interval 30m  # 安装平台原生定时任务
+git-auto-sync uninstall             # 卸载定时任务
+git-auto-sync update                # 自更新到最新 release
+```
+
+退出码:`0` 成功,`1` 有仓库同步失败,`2` `--repo` 未匹配到任何仓库。
+
+## 定时运行
+
+`install` 按当前平台生成并挂载原生调度,不自带常驻进程:
+
+- **macOS** → launchd(`~/Library/LaunchAgents/com.octopusgarage.git-auto-sync.plist`)
+- **Linux** → systemd user timer(`~/.config/systemd/user/git-auto-sync.timer`)
+- **Windows** → Task Scheduler(`OctopusGarage.git-auto-sync`)
+
+间隔形如 `30m` / `1h` / `90s`。卸载用 `git-auto-sync uninstall`。
+
+## 通知通道
+
+- `log`:追加时间戳块到日志文件,并打印到 stdout(审计用)
+- `telegram`:bot token + chat_id
+- `lark`:飞书自定义机器人 webhook
+
+一次同步结束后,按 `notify_on` 策略向所有启用的通道推送一条汇总;单个通道发送失败不影响其他通道与主流程。
+
+## 安全边界
+
+无人值守自动提交的最大风险是误提交机密或垃圾。本工具的防线:
+
+- AI 暂存分析排除 `.env`、私钥、证书、`node_modules`/`dist`/`build`/`__pycache__`、超大二进制、日志等;
+- 被排除的文件**不提交**,并(在 `ai_gitignore_autowrite=true` 时)自动写入 `.gitignore`;
+- 拿不准时可先 `--dry-run` 预演。
+
+## 开发
+
+```bash
+uv run pytest          # 运行测试
+uv run ruff check .    # 代码检查
+```
+
+## License
+
+MIT

config.example.toml

@@ -0,0 +1,31 @@
+# git-auto-sync 示例配置
+# 复制到 ~/.git-auto-sync/config.toml 后按需修改。
+
+[defaults]
+ai_provider            = "claude-cli"      # claude-cli | anthropic-api | rules
+ai_staging             = true              # AI 智能挑选要提交的文件;false 则 git add -A
+ai_gitignore_autowrite = true              # ai_staging 下,把被忽略的文件追加进 .gitignore
+push                   = true              # 提交后 pull --rebase 再 push
+notify_on              = "change_or_fail"  # change_or_fail | fail_only | always
+
+# ---- 要同步的仓库,可配置多个 ----
+[[repos]]
+path = "~/programming/foo"
+
+[[repos]]
+path = "~/programming/bar"
+push = false                               # 可逐仓库覆盖任意 defaults 字段
+
+# ---- 通知通道(只有 enabled=true 的才生效) ----
+[notifiers.log]
+enabled = true
+path    = "~/.git-auto-sync/sync.log"
+
+[notifiers.telegram]
+enabled   = false
+bot_token = "env:TELEGRAM_BOT_TOKEN"       # env: 前缀表示从环境变量读取,避免明文写密钥
+chat_id   = "123456"
+
+[notifiers.lark]
+enabled = false
+webhook = "https://open.feishu.cn/open-apis/bot/v2/hook/xxxx"