From ba0d938121fcd4ec110125a8786e6fed700d6793 Mon Sep 17 00:00:00 2001 From: Ink-dark Date: Sat, 27 Jun 2026 13:56:11 +0800 Subject: [PATCH 1/3] @ docs: finalize v0.14.0 release documentation MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - CHANGELOG: 更新日期为 2026-06-27，新增安全修复和 CI 修复条目 - TODO: 更新日期，里程碑表新增 v0.14.0 - README/README-zh_CN: 修复 cd 命令和构建说明 - 所有 178 测试通过，clippy 0 warnings Co-Authored-By: Claude @ --- CHANGELOG.md | 19 ++++++++++++++++--- README-zh_CN.md | 4 ++-- README.md | 8 ++++---- TODO.md | 3 ++- 4 files changed, 24 insertions(+), 10 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index c3242d1..b16614c 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,17 +4,30 @@ All notable changes to AdapterGit (agit) will be documented in this file. --- -## [v0.14.0] — 2026-06-22 +## [v0.14.0] — 2026-06-27 -> Workspace 拆分 — Multi-crate Architecture +> Workspace 拆分 + 安全修复 — Multi-crate Architecture & Security Fix ### Refactor - **workspace 拆分**: 单 crate → 3 crate workspace (agit-core + agit-ai + agit-cli) -- **agit-core**: 纯 Rust Git 核心库，可独立复用 +- **agit-core**: 纯 Rust Git 核心库，可独立复用（19 个模块） - **agit-ai**: AI 提交信息生成独立 crate，携带 reqwest 依赖 - **agit-cli**: CLI 二进制，lite/full 双版本分发 - **双版本**: `cargo build --no-default-features -F tag` = Lite, `--all-features` = Full +### Security +- **quinn-proto**: 升级 0.11.14 → 0.11.15 修复 RUSTSEC-2026-0185 (CVSS 7.5) + +### Fixes +- **CI**: 修复 smoke test 路径适配 workspace 结构 + +### Documentation +- 更新全部 7 份文档：CLAUDE.md, README, README-zh_CN, ARCHITECTURE, CONTRIBUTING, CHANGELOG, TODO +- 新增 `*.bundle` 到 .gitignore + +### Tests +- 178 tests (109 单元 + 69 集成)，全部通过 + ## [v0.13.0] — 2026-06-21 > 双版本分发 + AI 提交 — Dual-Edition Distribution & AI Commit diff --git a/README-zh_CN.md b/README-zh_CN.md index 8f1db44..2e6c02b 100644 --- a/README-zh_CN.md +++ b/README-zh_CN.md @@ -87,7 +87,7 @@ curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh # 克隆并进入仓库 git clone https://github.com/bit-torch/AdapterGit.git -cd agit +cd AdapterGit # Full 版本（完整功能，含 TLS + AI） cargo build --release --all-features @@ -362,7 +362,7 @@ print(result.stdout) # JSON 输出 ```bash # 1. Fork 并克隆仓库 git clone https://github.com/bit-torch/AdapterGit.git -cd agit +cd AdapterGit # 2. 安装 Rust rustup toolchain install stable diff --git a/README.md b/README.md index b3b7c57..66f93d3 100644 --- a/README.md +++ b/README.md @@ -374,15 +374,15 @@ Contributions are welcome! agit is open source and we appreciate all forms of co ```bash # 1. Fork and clone the repository git clone https://github.com/bit-torch/AdapterGit.git -cd agit +cd AdapterGit # 2. Install Rust rustup toolchain install stable -# 3. Build -cargo build +# 3. Build (workspace: agit-core + agit-ai + agit-cli) +cargo build --all-features -# 4. Run tests +# 4. Run tests (178 tests) cargo test ``` diff --git a/TODO.md b/TODO.md index b5a6c3c..e84d213 100644 --- a/TODO.md +++ b/TODO.md @@ -1,6 +1,6 @@ # TODO - 待办事项 -AdapterGit 项目待办事项清单。最后更新: 2026-06-22 (v0.14.0 workspace 拆分完成)。 +AdapterGit 项目待办事项清单。最后更新: 2026-06-27 (v0.14.0 发版)。 ## Phase 10: Workspace 拆分 ✅ @@ -169,4 +169,5 @@ AdapterGit 项目待办事项清单。最后更新: 2026-06-22 (v0.14.0 workspac | **v0.11.0** | **Blame + Reflog** | ✅ **已发布** | blame, reflog, 103 单元测试 | | **v0.12.0** | **Bisect** | ✅ **已发布** | bisect (start/good/bad/skip/reset/log/run), 109 单元测试 | | **v0.13.0** | **双版本分发 + AI 提交** | ✅ **已发布** | lite/full, musl, .deb, macOS, Docker, LLM commit | +| **v0.14.0** | **Workspace 拆分** | ✅ **已发布** | agit-core + agit-ai + agit-cli 三 crate | | v1.0.0 | 完整 Git 子集 + 全平台分发 | 🏁 目标 | 全命令覆盖 + 多平台安装包 | From e56dc1b5c684ac030a67d28b1b3812d74d0fafa0 Mon Sep 17 00:00:00 2001 From: Ink-dark Date: Sat, 27 Jun 2026 14:02:54 +0800 Subject: [PATCH 2/3] =?UTF-8?q?@=20docs:=20add=20whatwedo.md=20=E2=80=94?= =?UTF-8?q?=20user-facing=20feature=20overview?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 从用户视角完整梳理 agit 的功能流程，方便检查合理性。 14 个使用场景，附"还没做"清单。 Co-Authored-By: Claude @ --- whatwedo.md | 219 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 219 insertions(+) create mode 100644 whatwedo.md diff --git a/whatwedo.md b/whatwedo.md new file mode 100644 index 0000000..94678a1 --- /dev/null +++ b/whatwedo.md @@ -0,0 +1,219 @@ +# agit 做了什么 — 用户视角全流程 + +> 白话梳理：打开终端，用 agit 从零到一把 Git 事儿全办了。 + +## 1. 拿到手 + +- **Lite 版**：单文件，下载就能跑，不用安装。丢 U 盘、CI 容器、公用电脑都行。 +- **Full 版**：装完自动配 PATH，有 AI 写提交信息。 +- 也支持 `cargo install`，或者自己 `cargo build`（180 秒左右出二进制）。 + +## 2. 开仓库 + +``` +agit init # 当前目录变仓库 +agit init --path /tmp/project # 指定目录 +agit init --pattern rust # 顺手生成 .gitignore (rust/python/node/go/java) +agit init --licence mit # 顺手生成 LICENCE 文件 +``` + +## 3. 日常提交 + +``` +agit add . # 全加 +agit add src/main.rs # 加单个 + ↓ 自动尊重 .gitignore +agit commit -m "fix: typo" # 正常提交 +agit commit --ai "修登录" # AI 帮你写 commit message + ↓ 自动打 [AI-committed] 标记，方便追溯 +``` + +**AI 写提交信息怎么玩？** 配置好 `AGIT_LLM_API_KEY`（OpenAI / DeepSeek / 月之暗面 / 智谱 / Ollama 都行），`agit commit --ai` 会自动把暂存区 diff 喂给 LLM，吐一条 Conventional Commits 格式的提交信息。 + +## 4. 看状态 + +``` +agit status # 哪些改了、哪些暂存了 +agit log # 提交历史 +agit log --oneline -n 10 # 精简模式 +agit log --all # 所有分支 +agit diff # 改了什么 +agit diff --cached # 暂存区改了什么 +agit diff --name-only # 只看文件名 +agit diff # 两次提交之间 +agit show HEAD # 最近一次提交的详情 +``` + +## 5. 分支和跳转 + +``` +agit branch # 列出本地分支 +agit branch -c feat/xxx # 新建分支 +agit branch -d feat/xxx # 删分支 +agit checkout feat/xxx # 切换过去 +agit checkout --force feat/xxx # 有未提交改动也切（自动 stash 再 pop） +``` + +## 6. 和别人协作（远程） + +``` +agit clone https://... # 克隆（HTTP/HTTPS） +agit clone git@github.com:... # 克隆（SSH，走系统 ssh） +agit fetch # 看看远程有什么更新 +agit pull # 拉下来并自动合并 +agit push origin main # 推上去 +agit remote add upstream ... # 加个远程 +agit remote list # 看看有哪些远程 +``` + +## 7. 合并代码 + +``` +agit merge feat/xxx # 把分支合进来 + ↓ 能 fast-forward 就 fast-forward + ↓ 有冲突就写冲突标记，让你手动解决 +``` + +## 8. 高级操作 + +### 变基（rebase） +``` +agit rebase main # 把当前分支"搬"到 main 上面 +agit rebase --onto main HEAD~3 # 选三笔搬过去 +agit rebase --continue # 解决冲突后继续 +agit rebase --skip # 跳过当前这笔 +agit rebase --abort # 不玩了，回退 +``` + +### 遴选（cherry-pick） +``` +agit cherry-pick abc123 # 挑一笔提交过来 +agit cherry-pick abc123 def456 # 多笔一起 +agit cherry-pick --continue # 解决冲突后继续 +agit cherry-pick --abort # 不玩了 +``` + +### 储藏（stash） +``` +agit stash # 把改动暂存起来 +agit stash pop # 拿出来 +agit stash list # 看看有哪些 +agit stash drop # 丢掉 +``` + +### 重置（reset） +``` +agit reset --soft HEAD~1 # 撤销提交，改动回暂存区 +agit reset --mixed # 默认：回暂存区 +agit reset --hard HEAD~1 # 彻底丢掉（慎用） +``` + +### 二分查找（bisect） +``` +agit bisect start --bad HEAD --good v0.1.0 +agit bisect good # 这个版本没问题 +agit bisect bad # 这个版本有 bug +agit bisect run "cargo test" # 自动跑脚本定位 +``` + +### 追溯（blame） +``` +agit blame src/main.rs # 每行代码谁写的 +agit blame --revision HEAD~5 src/main.rs # 看历史版本 +``` + +### 引用日志（reflog） +``` +agit reflog # HEAD 的所有变动记录 +agit reflog main # main 分支的变动记录 +``` + +## 9. 标签 + +``` +agit tag # 列标签 +agit tag -c v1.0.0 # 打轻量标签 +agit tag -c v1.0.0 -m "发版" # 打注释标签 +agit tag -d v1.0.0 # 删标签 +``` + +## 10. 文件操作 + +``` +agit rm file.txt # 删文件（同时从暂存区移除） +agit rm --cached file.txt # 只从暂存区移除，保留文件 +agit mv old.txt new.txt # 改名/移动 +``` + +## 11. 查看内部对象 + +``` +agit cat-file -p abc123 # 看对象内容 +agit cat-file -t abc123 # 看对象类型 +agit ls-tree abc123 # 看一棵树里有什么 +``` + +## 12. 配置 + +``` +agit config user.name "Me" # 设用户名 +agit config --global user.email "me@x.com" # 全局配置 +agit config --list # 看所有配置 +agit config --get user.name # 查一项 +agit config --unset user.name # 删一项 +``` + +**配置优先级**：环境变量 > 仓库 `.agit/config.toml` > 全局 `~/.agitconfig.toml` > 默认值 + +还支持命令别名： +```toml +# ~/.agitconfig.toml +[alias] +co = "commit" +st = "status" +``` + +## 13. 输出格式 + +``` +agit log --json # JSON 输出（给脚本/AI 用） +agit status --yaml # YAML 输出 +agit --no-color log # 不要颜色（管道用） +``` + +## 14. AI 模式 + +``` +agit --ai commit -m "fix" # 开启 AI 模式 +``` + +AI 模式下会自动： +- 提交信息加 `[AI-committed]` 前缀 +- 阻止危险命令：`push`、`stash drop`、`branch -D`、`rebase`、`cherry-pick`、`bisect` + +--- + +## 一张图：从打开终端到推上 GitHub + +``` +agit init + → agit add . + → agit commit -m "init" + → (改代码) + → agit add . + → agit commit --ai "新功能" + → agit push origin main +``` + +## 还没做的（用户一眼就能看出缺什么） + +| 功能 | 状态 | 说明 | +|------|------|------| +| 交互式 rebase (`-i`) | ❌ 不支持 | 需要 TUI，和"永不挂起"的设计理念冲突 | +| 交互式 add (`-p`) | ❌ 不支持 | 同上 | +| submodule | ❌ 不支持 | | +| hooks | ❌ 不支持 | pre-commit / post-commit 等 | +| grep | ❌ 不支持 | | +| Git 协议 v2 | ❌ 不支持 | 目前走 v1 协议 | +| Windows 安装包 (.msi) | ❌ 待做 | | +| musl 静态编译 | ⏳ 待修复 | CI 缺 musl-gcc | From 6b47e154dacb5ee1e2d2355bf5810675f939e79d Mon Sep 17 00:00:00 2001 From: Ink-dark Date: Sat, 27 Jun 2026 14:12:17 +0800 Subject: [PATCH 3/3] @ fix(ci): specify package for cargo-deb in workspace MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit cargo deb --no-build → cargo deb --no-build -p agit-cli workspace 下需要明确指定要打包的包。 Co-Authored-By: Claude @ --- .github/workflows/ci.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 399c52c..483b01d 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -132,7 +132,7 @@ jobs: - name: Build .deb package run: | cargo install cargo-deb --locked - cargo deb --no-build + cargo deb --no-build -p agit-cli cp target/debian/*.deb agit-linux-x86_64.deb 2>/dev/null || true - uses: actions/upload-artifact@v4 with: