bingo-light 2.1.1 → 2.1.3

package/README.en.md

@@ -10,7 +10,7 @@
   <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT"></a>
   <a href="https://github.com/DanOps-1/bingo-light/releases"><img src="https://img.shields.io/github/v/release/DanOps-1/bingo-light?label=Release&color=orange" alt="Release"></a>
   <br>
-  <a href="#for-ai-agents"><img src="https://img.shields.io/badge/MCP_Server-29_tools-blueviolet.svg" alt="MCP: 29 tools"></a>
+  <a href="#for-ai-agents"><img src="https://img.shields.io/badge/MCP_Server-49_tools-blueviolet.svg" alt="MCP: 49 tools"></a>
   <a href="https://www.python.org/"><img src="https://img.shields.io/badge/Python-3.8+-3776ab.svg" alt="Python 3.8+"></a>
   <img src="https://img.shields.io/badge/Dependencies-Zero-brightgreen.svg" alt="Zero deps">
   <a href="https://github.com/DanOps-1/bingo-light/stargazers"><img src="https://img.shields.io/github/stars/DanOps-1/bingo-light?style=social" alt="Stars"></a>
@@ -25,7 +25,7 @@ GitHub's "Sync fork" button breaks the moment you have customizations. `git reba
 
 Your patches live as a clean, named stack on top of upstream. Syncing is `bingo-light sync`. Conflicts get remembered so you never solve the same one twice. And if something goes sideways, `bingo-light undo` puts everything back in one second.
 
-Every command speaks JSON. The built-in MCP server gives AI agents 29 tools to manage your fork autonomously -- from init through conflict resolution. No human in the loop required.
+Every command speaks JSON. The built-in MCP server gives AI agents 49 tools to manage your fork autonomously -- from init through conflict resolution. No human in the loop required.
 
 ---
 
@@ -69,6 +69,12 @@ That's it. Three commands and your fork stays in sync forever.
 
 > The AI calls `conflict-analyze --json`, reads the structured ours/theirs data, writes the merged file, and the rebase continues. No human needed.
 
+During a rebase, `conflict-analyze` also returns:
+- **`patch_intent`** — patch name, subject, full commit message, original SHA, original diff, metadata (reason/tags/upstream_pr/status/owner), and position in the patch stack.
+- **`verify`** — configured `test.command` plus per-file syntax/parse commands by extension (`.py/.json/.yml/.yaml/.toml/.sh`).
+
+`conflict-resolve --verify` (CLI) or `verify: true` (MCP) runs `test.command` after the final `git rebase --continue`; the result is attached as `verify_result`.
+
 ---
 
 ## Key Features
@@ -93,13 +99,14 @@ That's it. Three commands and your fork stays in sync forever.
 
 ### For AI Agents
 
-- :electric_plug: **MCP server (29 tools)** -- full fork management from init through conflict resolution.
+- :electric_plug: **MCP server (49 tools)** -- full fork management from init through conflict resolution.
 - :bar_chart: **`--json` on everything** -- every command returns structured JSON. Parse, don't scrape.
 - :mute: **`--yes` flag** -- fully non-interactive. No TTY required. No prompts. Ever.
 - :gear: **Auto-detect non-TTY** -- pipes and subprocesses trigger non-interactive mode automatically.
 - :memo: **`BINGO_DESCRIPTION` env var** -- set patch descriptions without stdin.
 - :mag: **`conflict-analyze --json`** -- structured conflict data: file, ours, theirs, resolution hints.
 - :white_check_mark: **`conflict-resolve`** -- write resolved content via MCP, auto-stage, continue rebase. Zero manual intervention.
+- :package: **Dependency patching** -- `dep patch/apply/sync` for npm/pip packages. Patches survive `npm install`.
 - :satellite: **Advisor agent** -- `contrib/agent.py` monitors drift, analyzes risk, auto-syncs when safe.
 
 ---
@@ -199,7 +206,7 @@ make install && bingo-light setup
 
 ## For AI Agents
 
-bingo-light was designed from day one for AI agents. Every command speaks JSON. The MCP server exposes 29 tools covering the full lifecycle from `init` to `conflict-resolve`. Non-interactive mode is the default when stdin is not a TTY.
+bingo-light was designed from day one for AI agents. Every command speaks JSON. The MCP server exposes 49 tools covering the full lifecycle from `init` to `conflict-resolve`. Non-interactive mode is the default when stdin is not a TTY.
 
 ### MCP setup -- Claude Code
 
@@ -233,7 +240,7 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
 
 **Any MCP client** (VS Code Copilot, Cursor, custom agents): connect via stdio to `python3 mcp-server.py`.
 
-### 29 MCP Tools
+### 49 MCP Tools
 
 | Tool | Purpose |
 |------|---------|
@@ -375,6 +382,12 @@ bingo-light patch meta <name> [key] [value]   Get/set patch metadata
 bingo-light conflict-analyze                  Structured conflict data for AI
 bingo-light config get|set|list [key] [val]   Manage configuration
 bingo-light test                              Run configured test suite
+bingo-light dep patch <package> [name]         Patch a modified npm/pip dependency
+bingo-light dep apply [package]               Re-apply dependency patches after install
+bingo-light dep sync                          Re-apply after update + detect conflicts
+bingo-light dep status                        Dependency patch health check
+bingo-light dep list                          List all dependency patches
+bingo-light dep drop <package> [patch]        Remove a dependency patch
 bingo-light workspace init|add|status|sync    Multi-repo management
 bingo-light auto-sync                         Generate GitHub Actions workflow
 bingo-light version                           Print version
@@ -417,7 +430,7 @@ StGit (649 stars) manages patch stacks but has no AI integration, no MCP server,
 | Handles customizations | **Yes** | **No** | Manual | Manual | Manual |
 | Conflict memory (rerere) | **Auto** | No | Manual | No | No |
 | Conflict prediction | **Yes** | No | No | No | No |
-| AI / MCP integration | **29 tools** | No | No | No | No |
+| AI / MCP integration | **49 tools** | No | No | No | No |
 | JSON output | **All commands** | No | No | No | No |
 | Non-interactive mode | **Native** | No | Partial | Partial | Partial |
 | Undo sync | **One command** | No | git reflog | Manual | Manual |
@@ -483,7 +496,7 @@ Yes. bingo-light uses standard git operations (fetch, rebase, push). It works wi
 ```
 bingo-light          CLI tool (Python 3, zero deps)
 bingo_core/          Core library package (all business logic)
-mcp-server.py        MCP server (zero-dep Python 3, 29 tools, JSON-RPC 2.0)
+mcp-server.py        MCP server (zero-dep Python 3, 49 tools, JSON-RPC 2.0)
 contrib/agent.py     Advisor agent (monitors drift, auto-syncs when safe)
 contrib/tui.py       Terminal dashboard (curses TUI, real-time monitoring)
 install.sh           Installer (--yes for CI, --help for options)

package/README.md

@@ -2,38 +2,43 @@
   <br>
   <img src="docs/logo.svg" alt="bingo-light logo" width="200">
   <br><br>
-  <strong>Fork 同步，一条命令搞定。<br>人用、AI 用，零依赖。</strong>
+  <strong>让 AI 接管你的 Fork 维护。<br>同步、冲突、补丁管理 — 全自动。</strong>
   <br><br>
   <a href="README.en.md">English</a> | <b>简体中文</b>
   <br><br>
   <a href="https://github.com/DanOps-1/bingo-light/actions"><img src="https://github.com/DanOps-1/bingo-light/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT"></a>
   <a href="https://github.com/DanOps-1/bingo-light/releases"><img src="https://img.shields.io/github/v/release/DanOps-1/bingo-light?label=Release&color=orange" alt="Release"></a>
-  <a href="#mcp-服务器"><img src="https://img.shields.io/badge/MCP_Server-29_tools-blueviolet.svg" alt="MCP: 27 tools"></a>
+  <a href="#mcp-服务器"><img src="https://img.shields.io/badge/MCP_Server-49_tools-blueviolet.svg" alt="MCP: 49 tools"></a>
   <a href="https://www.python.org/"><img src="https://img.shields.io/badge/Python-3.8+-3776ab.svg" alt="Python 3.8+"></a>
   <img src="https://img.shields.io/badge/Dependencies-Zero-brightgreen.svg" alt="Zero deps">
   <a href="https://github.com/DanOps-1/bingo-light/stargazers"><img src="https://img.shields.io/github/stars/DanOps-1/bingo-light?style=social" alt="Stars"></a>
   <br><br>
 </p>
 
-GitHub 的 "Sync fork" 按钮？你一改代码它就废了。手动 `git rebase`？六步操作，每次都得记。AI 想帮你同步？没接口可调。
+Fork 维护是个苦差事 — 上游一更新，你的定制化改动就得手动 rebase。GitHub 的 "Sync fork" 按钮碰到自定义 commit 直接废了。手动操作六步起步，冲突反复解，搞砸了还得从 reflog 里捞。
 
-**bingo-light 把这三个问题一锅端。**
+**装完 bingo-light，跟你的 AI 说一句"帮我同步 Fork"，剩下的它全搞定。**
 
-改动以补丁栈的形式叠在上游之上，干干净净。同步一句 `bingo-light sync`。冲突解过一次就记住了，下次自动跳过。搞砸了 `bingo-light undo` 秒回。
+内置 MCP 服务器 35 个工具，AI 自主完成：拉上游、rebase 补丁、分析冲突、写合并代码、继续 rebase。冲突解过一次自动记住（rerere），下次不再问。搞砸了 `undo` 秒回。
 
-所有命令支持 `--json` 输出。内置 MCP 服务器 29 个工具，AI 从初始化到冲突解决全程自主，不用人盯。
+> [!TIP]
+> **不想读文档？** 把这段丢给你的 AI，让它帮你装：
+>
+> ```
+> 帮我安装 bingo-light 并配置好 MCP，参考：
+> https://raw.githubusercontent.com/DanOps-1/bingo-light/main/docs/ai-setup.md
+> ```
 
 ---
 
 ## 目录
 
-- [快速开始](#快速开始)
-- [演示](#演示)
 - [安装](#安装)
+- [演示](#演示)
 - [功能特性](#功能特性)
+- [MCP 服务器（35 工具）](#mcp-服务器)
 - [工作原理](#工作原理)
-- [MCP 服务器](#mcp-服务器)
 - [命令参考](#命令参考)
 - [集成指南](#集成指南)
 - [配置](#配置)
@@ -41,53 +46,97 @@ GitHub 的 "Sync fork" 按钮？你一改代码它就废了。手动 `git rebase
 - [与其他方案对比](#与其他方案对比)
 - [项目生态](#项目生态)
 - [参与贡献](#参与贡献)
-- [许可证](#许可证)
 
 ---
 
-## 快速开始
+## 安装
+
+### 让 AI 帮你装（推荐）
 
-```bash
-# 安装（任选一种）
-pip install bingo-light             # Python
-npm install -g bingo-light          # Node.js
-brew install DanOps-1/tap/bingo-light  # Homebrew
+把下面这段丢给你的 AI（Claude Code、Cursor、Windsurf 等），它会自动装好并配好 MCP + Skill：
+
+```
+帮我安装并配置 bingo-light，参考这个文档：
+https://raw.githubusercontent.com/DanOps-1/bingo-light/main/docs/ai-setup.md
+```
+
+### 自己装
+
+| 方式 | 命令 |
+|------|------|
+| **pip** | `pip install bingo-light && bingo-light setup` |
+| **npm** | `npm install -g bingo-light && bingo-light setup` |
+| **npx** | `npx bingo-light setup` |
+| **Homebrew** | `brew install DanOps-1/tap/bingo-light && bingo-light setup` |
+
+<details>
+<summary><b>更多安装方式</b>（Docker / Shell / 源码）</summary>
 
-# 初始化 Fork 追踪
-cd my-forked-project
-bingo-light init https://github.com/original/project.git
+**Docker**
+```bash
+docker run --rm -v "$PWD:/repo" -w /repo ghcr.io/danops-1/bingo-light status
+docker run --rm -i -v "$PWD:/repo" -w /repo ghcr.io/danops-1/bingo-light mcp-server.py
+```
 
-# 改代码，创建命名补丁
-vim src/feature.py
-bingo-light patch new my-feature
+**Shell 一键安装**
+```bash
+curl -fsSL https://raw.githubusercontent.com/DanOps-1/bingo-light/main/install.sh | sh
+```
 
-# 上游有更新？一句话同步
-bingo-light sync
+**从源码**
+```bash
+git clone https://github.com/DanOps-1/bingo-light.git
+cd bingo-light && make install && bingo-light setup
 ```
 
-就这么简单。补丁永远干净地叠在最新上游之上。
+</details>
+
+> [!NOTE]
+> **依赖：** Python 3.8+ / git 2.20+，没了。零 pip 依赖。
+>
+> MCP 客户端可直接用 npx：`{"command": "npx", "args": ["-y", "bingo-light-mcp"]}`
+
+---
 
 ## 演示
 
-### 日常操作：初始化 → 建补丁 → 同步
+<table>
+<tr>
+<td width="50%">
+
+### 日常操作
+
+初始化 → 建补丁 → 同步上游
 
 <p align="center">
-  <img src="docs/demo.svg" alt="bingo-light 基本演示" width="850">
+  <img src="docs/demo.svg" alt="bingo-light 基本演示" width="100%">
 </p>
 
-### 冲突处理：同步 → 分析 → 搞定
+</td>
+<td width="50%">
+
+### 冲突解决
+
+同步 → AI 分析 → 自动修复
 
 <p align="center">
-  <img src="docs/demo-conflict.svg" alt="bingo-light 冲突解决演示" width="850">
+  <img src="docs/demo-conflict.svg" alt="bingo-light 冲突解决演示" width="100%">
 </p>
 
-> AI 调 `conflict-analyze --json` 拿到双方代码，写好合并结果，rebase 自动继续。全程零人工。
+</td>
+</tr>
+</table>
 
-### AI 拿到的是结构化数据
+> [!NOTE]
+> AI 调 `conflict-analyze --json` 拿到双方代码和解决提示，写好合并结果，rebase 自动继续。全程零人工。
+
+---
+
+### `--json` 输出：AI 直接消费
+
+<details open>
+<summary><b>Fork 状态</b> — <code>bingo-light status --json</code></summary>
 
-```
-$ bingo-light status --json
-```
 ```json
 {
   "ok": true,
@@ -102,11 +151,11 @@ $ bingo-light status --json
 }
 ```
 
-### 冲突分析（AI 直接消费）
+</details>
+
+<details>
+<summary><b>冲突分析</b> — <code>bingo-light conflict-analyze --json</code></summary>
 
-```
-$ bingo-light conflict-analyze --json
-```
 ```json
 {
   "rebase_in_progress": true,
@@ -119,96 +168,140 @@ $ bingo-light conflict-analyze --json
       "theirs": "... 你的补丁版本 ...",
       "hint": "上游重构了调度器核心；补丁需要适配新结构。"
     }
-  ]
+  ],
+  "patch_intent": {
+    "name": "custom-scheduler",
+    "subject": "...",
+    "message": "完整 commit 消息",
+    "original_sha": "a1b2c3d...",
+    "original_diff": "diff --git ...",
+    "meta": {"reason": "...", "tags": [], "status": "permanent"},
+    "stack_position": {"index": 3, "total": 7}
+  },
+  "verify": {
+    "test_command": "make test",
+    "file_hints": [
+      {"file": "kernel/sched/core.c", "command": "bash -n ...", "kind": "syntax"}
+    ]
+  }
 }
 ```
 
-## 安装
+`conflict-analyze` 在 rebase 中额外附带 `patch_intent`（补丁意图：原始 commit、diff、metadata、栈位置）与 `verify`（配置的 `test.command` + 按扩展名的逐文件校验命令）。`conflict-resolve --verify` 在最终 `git rebase --continue` 完成后自动跑 `test.command`，结果挂在 `verify_result` 字段。
 
-装完跑 `bingo-light setup`，交互式配好 MCP 和 AI Skill（Claude Code、Cursor、Windsurf、VS Code/Copilot、Gemini CLI 等一键选配）。
+</details>
 
-### pip / pipx
+<details>
+<summary><b>AI 全自动解冲突</b> — Claude Code 实际工作流</summary>
 
-```bash
-pip install bingo-light        # 或: pipx install bingo-light
-bingo-light setup              # 选配 AI 工具
 ```
+你: "同步上游，冲突帮我修了。"
 
-### npm / npx
+Claude Code:
+  1. bingo_status(cwd)            → 落后 47 commit，risk: core.c
+  2. bingo_sync(cwd, dry_run)     → 预判 1 个冲突
+  3. bingo_sync(cwd)              → rebase 卡在冲突
+  4. bingo_conflict_analyze()     → 拿到双方代码 + 提示
+  5. 读两边，写合并结果
+  6. bingo_conflict_resolve(file) → 搞定
+  7. bingo_status(cwd)            → 0 落后，补丁干净 ✓
+```
 
-```bash
-npm install -g bingo-light     # 全局安装
-bingo-light setup
+</details>
 
-# 或 npx 免装：
-npx bingo-light setup
+### 交互式 Setup
+
+```console
+$ bingo-light setup
+
+  ◆  bingo-light setup  v2.x.x
+  │
+  ◆  MCP Server
+  │  Connect bingo-light tools to your AI coding assistants
+  │
+  │  › ■ Claude Code        ~/.claude/settings.json
+  │    ■ Cursor              ~/.cursor/mcp.json
+  │    □ Windsurf            (not detected)
+  │    ■ VS Code / Copilot   ~/.vscode/mcp.json
+  │
+  ◆  Skills / Custom Instructions
+  │  Teach your AI how to use bingo-light
+  │
+  │    ■ Claude Code         ~/.claude/commands/bingo.md
+  │    ■ Continue            ~/.continue/rules/bingo.md
+  │
+  └  5 MCP + 2 skill(s) configured — ready to go!
 ```
 
-MCP 客户端直接用 npx：
-```json
-{"command": "npx", "args": ["-y", "bingo-light-mcp"]}
-```
+> [!TIP]
+> 支持 10 个 AI 工具的 MCP 配置 + 6 个平台的 Skill 安装。方向键多选，一次配完。
 
-### Homebrew
+## AI 如何使用 bingo-light
 
-```bash
-brew install DanOps-1/tap/bingo-light
-bingo-light setup
-```
+这才是重点。bingo-light 是为 AI agent 设计的 Fork 维护工具。
 
-### Docker
+### AI 拿到什么
 
-```bash
-# CLI
-docker run --rm -v "$PWD:/repo" -w /repo ghcr.io/danops-1/bingo-light status
+|  | 能力 | 说明 |
+|---|------|------|
+| 🔌 | **MCP 服务器** | 35 个工具，AI 直接调用，从 init 到冲突解决全链路 |
+| 📊 | **结构化输出** | 所有命令 `--json` 输出，AI 直接 parse |
+| 🤖 | **零交互** | `--yes` + 非 TTY 自适应，不会卡在确认提示 |
+| 🔍 | **冲突分析** | `conflict-analyze` 返回双方代码 + AI 可执行的解决提示 |
+| ✏️ | **冲突解决** | `conflict-resolve` 直接写入合并代码，自动 stage + 继续 rebase |
+| 🧠 | **冲突记忆** | rerere 自动记住解法，同样冲突不用 AI 再解第二次 |
+| 📋 | **Skill / 指令** | `/bingo` 教 AI 整套工作流，不用你写 prompt |
+| 📦 | **依赖补丁** | `dep patch/apply/sync` — npm/pip 包改了不怕 install 覆盖 |
+| 🔄 | **Advisor 代理** | `contrib/agent.py` 后台监控漂移，安全时自动同步 |
 
-# MCP 服务器（stdio）
-docker run --rm -i -v "$PWD:/repo" -w /repo ghcr.io/danops-1/bingo-light mcp-server.py
-```
-
-### Shell 安装器
+### AI 实际工作流
 
-```bash
-curl -fsSL https://raw.githubusercontent.com/DanOps-1/bingo-light/main/install.sh | sh
+你说一句 **"同步上游"**，AI 自己跑完整个流程：
 
-# 非交互模式（CI / Docker）
-curl -fsSL .../install.sh | sh -s -- --yes
+```
+bingo_status()            → 落后 47 commit，risk: core.c
+bingo_sync(dry_run=true)  → 预判 1 个冲突
+bingo_sync()              → rebase 卡在冲突
+bingo_conflict_analyze()  → 拿到 ours/theirs + hint
+  → AI 读两边代码，写合并结果
+bingo_conflict_resolve()  → 写入、stage、rebase 继续
+bingo_status()            → 0 落后，补丁干净 ✓
 ```
 
-### 从源码安装
+> [!IMPORTANT]
+> **你不需要理解 rebase、rerere、tracking branch 这些概念。** AI 全部处理。你只需要装好工具，告诉 AI 你想干嘛。
 
-```bash
-git clone https://github.com/DanOps-1/bingo-light.git
-cd bingo-light
-make install && bingo-light setup
-```
+### 支持哪些 AI 工具
+
+`bingo-light setup` 一键配好 MCP + Skill：
 
-**依赖：** Python 3.8+ / git 2.20+，没了。
+| AI 工具 | MCP | Skill |
+|---------|:---:|:-----:|
+| Claude Code | ✅ | ✅ |
+| Cursor | ✅ | — |
+| Windsurf | ✅ | ✅ |
+| VS Code / Copilot | ✅ | — |
+| Cline | ✅ | ✅ |
+| Roo Code | ✅ | ✅ |
+| Zed | ✅ | — |
+| Gemini CLI | ✅ | ✅ |
+| Continue | — | ✅ |
+| Amazon Q | ✅ | — |
 
-## 功能特性
+---
 
-### AI 侧
+## 人也能用
 
-| 功能 | 说明 |
-|------|------|
-| **MCP 服务器** | 29 个工具，初始化到冲突解决全覆盖 |
-| **`--json`** | 所有命令输出结构化 JSON |
-| **`--yes`** | 跳过一切确认，不需要 TTY |
-| **非 TTY 自适应** | 管道或子进程调用时自动静默 |
-| **`BINGO_DESCRIPTION`** | 环境变量设补丁描述 |
-| **`conflict-analyze`** | 冲突数据结构化：文件、双方代码、解决提示 |
-| **`conflict-resolve`** | MCP 直接写入解决内容，自动暂存 + 继续 rebase |
-| **Advisor 代理** | `contrib/agent.py` 自动监控、分析、安全时自动同步 |
+不用 AI 也完全没问题。同一套命令，人跑和 AI 跑效果一样。
 
-### 人类侧
+<details>
+<summary><b>人类功能一览</b></summary>
 
 | 功能 | 说明 |
 |------|------|
-| **零依赖** | Python 3 + git，一行装完 |
-| **命名补丁** | 每个改动是独立的、有名字的 commit |
 | **一键同步** | `bingo-light sync`，补丁自动 rebase 到最新上游 |
+| **命名补丁** | 每个改动是独立的、有名字的 commit |
 | **先试后跑** | `sync --dry-run` 临时分支预演，不碰真代码 |
-| **冲突记忆** | rerere 自动开，解一次就记住，再也不问 |
 | **秒级撤销** | `bingo-light undo` 恢复同步前状态 |
 | **冲突预警** | `status` 提前告诉你哪些文件会出事 |
 | **自检修复** | `doctor` 全面体检 + 试跑 rebase |
@@ -218,9 +311,10 @@ make install && bingo-light setup
 | **多仓管理** | `workspace` 统一管所有 Fork |
 | **补全** | bash / zsh / fish |
 | **通知推送** | Discord、Slack、Webhook，事件触发 |
-| **补丁元数据** | 标签、原因、过期时间、关联上游 PR |
 | **测试联动** | 同步后自动跑测试，挂了自动回滚 |
 
+</details>
+
 ## 工作原理
 
 ```
@@ -250,7 +344,7 @@ make install && bingo-light setup
 
 ## MCP 服务器
 
-`mcp-server.py`，纯 Python 3，零依赖，stdio 传输，29 个工具，JSON-RPC 2.0。
+`mcp-server.py`，纯 Python 3，零依赖，stdio 传输，35 个工具，JSON-RPC 2.0。
 
 运行 `bingo-light setup` 自动配置，或手动添加：
 
@@ -339,6 +433,12 @@ bingo-light conflict-analyze                 分析 rebase 冲突
 bingo-light config get|set|list [key] [val]  管理配置
 bingo-light history                          详细同步历史 + 映射
 bingo-light test                             运行测试套件
+bingo-light dep patch <package> [name]        补丁 npm/pip 依赖
+bingo-light dep apply [package]              重新应用依赖补丁
+bingo-light dep sync                         更新后重新应用 + 冲突检测
+bingo-light dep status                       依赖补丁健康状态
+bingo-light dep list                         列出所有依赖补丁
+bingo-light dep drop <package> [patch]       删除依赖补丁
 bingo-light workspace init|add|status|sync   多仓库管理
 bingo-light auto-sync                        生成 GitHub Actions 工作流
 bingo-light version                          打印版本
@@ -349,32 +449,14 @@ bingo-light help                             打印帮助
 
 ## 集成指南
 
-### Claude Code (MCP)
-
-MCP 配好后，Claude Code 全程接管：
-
-```
-你: "同步上游，冲突帮我修了。"
+| 集成方式 | 适用场景 | 示例 |
+|---------|---------|------|
+| **MCP** (49 tools) | Claude Code / Cursor / Windsurf 等 | `bingo-light setup` 自动配 |
+| **CLI `--json`** | 任何能跑 shell 的 AI | `bingo-light sync --json --yes` |
+| **Skill** | Claude Code / Continue / Gemini 等 | `/bingo` 教 AI 用法 |
 
-Claude Code:
-  1. bingo_status(cwd)        → 落后 47 commit，risk: core.c
-  2. bingo_sync(cwd, dry_run) → 预判 1 个冲突
-  3. bingo_sync(cwd)          → rebase 卡在冲突
-  4. bingo_conflict_analyze() → 拿到双方代码 + 提示
-  5. 读两边，写合并结果
-  6. bingo_conflict_resolve(cwd, file, content) → 搞定
-  7. bingo_status(cwd)        → 0 落后，补丁干净
-```
-
-### Aider / CLI 代理
-
-```bash
-bingo-light status --json          # 解析 Fork 状态
-bingo-light sync --yes             # 非交互同步
-bingo-light conflict-analyze --json # 结构化冲突数据
-```
-
-### 自定义 Python 代理
+<details>
+<summary><b>自定义 Python 代理</b></summary>
 
 ```python
 import subprocess, json
@@ -393,9 +475,10 @@ if status["behind"] > 0:
         analysis = bingo("conflict-analyze")
         for c in analysis["conflicts"]:
             resolved = my_llm_resolve(c["ours"], c["theirs"], c["hint"])
-            # 通过 CLI 或 MCP 写入解决内容
 ```
 
+</details>
+
 ## 配置
 
 配置存在 `.bingolight`（git-config 格式），自动排除在版本控制外。
@@ -494,7 +577,7 @@ StGit 管栈但没 AI 集成、没 MCP、没 JSON 输出、没冲突预测。qui
 | 处理定制化改动 | **有** | **不行** | 手动 | 手动 | 手动 |
 | 冲突记忆 (rerere) | **自动** | 无 | 需手动启用 | 无 | 无 |
 | 冲突预测 | **有** | 无 | 无 | 无 | 无 |
-| AI/MCP 集成 | **29 个工具** | 无 | 无 | 无 | 无 |
+| AI/MCP 集成 | **35 个工具** | 无 | 无 | 无 | 无 |
 | JSON 输出 | **所有命令** | 无 | 无 | 无 | 无 |
 | 非交互模式 | **原生支持** | 无 | 部分 | 部分 | 部分 |
 | 撤销同步 | **一条命令** | 无 | git reflog | 手动 | 手动 |
@@ -505,7 +588,7 @@ StGit 管栈但没 AI 集成、没 MCP、没 JSON 输出、没冲突预测。qui
 ```
 bingo-light          CLI 入口（Python 3，零依赖）
 bingo_core/          核心库包（全部业务逻辑）
-mcp-server.py        MCP 服务器（零依赖 Python 3，29 个工具）
+mcp-server.py        MCP 服务器（零依赖 Python 3，35 个工具）
 contrib/agent.py     Advisor 代理（监控 + 分析 + 安全时自动同步）
 contrib/tui.py       终端面板（curses TUI）
 install.sh           安装器（--yes 支持 CI，--help 查看选项）