ai-diff-preview/README.md

AI Code Diff Preview

类 Cursor 的 AI 代码差异预览 VSCode 插件，使用 VSCode 内置 Diff 编辑器 + 浮动 Accept/Reject 标签。

功能特性

• ✅ VSCode 原生 Diff 编辑器 — 使用内置 vscode.diff，不自定义 Webview
• ✅ EditRecord 独立追踪 — 每次 Edit/Write 独立记录，不合并
• ✅ 逐次编辑 Accept/Reject — 细粒度控制每次 AI 修改
• ✅ QuickPick 文件列表 — 对话结束后弹出原生文件选择器
• ✅ 快捷键导航 — Alt+↑/↓ 跳转变更文件
• ✅ Bug 修复 — Accept 后再编辑不再丢失追踪
• ✅ 冲突检测 — 自动检测用户手动修改导致的冲突

工作流程

Claude Edit/Write → 收集到 ChangeSet (EditRecord 粒度)
  ├── autoShowDiffPerEdit=true → 立即弹出 VSCode 内置 Diff
  └── autoShowDiffPerEdit=false → 静默收集，更新状态栏

Claude Stop → 变更集就绪
  ├── showAllDiffsOnStop=true → QuickPick 文件列表 → 点击打开内置 Diff
  └── showAllDiffsOnStop=false → 仅通知，用户手动 Ctrl+Shift+D 查看

安装

git clone https://github.com/your-username/ai-diff-preview.git
cd ai-diff-preview
npm install
npm run build

使用方法

快捷键

快捷键	条件	功能
Alt+↓	aiDiffPreview.isActive	下一个变更文件
Alt+↑	aiDiffPreview.isActive	上一个变更文件
Tab	aiDiffPreview.isActive	接受当前编辑
Esc	aiDiffPreview.isActive	拒绝所有变更
Ctrl+Shift+A	aiDiffPreview.isActive	Accept All
Ctrl+Shift+R	aiDiffPreview.isActive	Reject All
Ctrl+Shift+D	aiDiffPreview.isActive	显示文件列表
Ctrl+Shift+F	aiDiffPreview.isActive	查看当前文件 Diff

配置项

配置项	类型	默认值	说明
aiDiffPreview.enableAutoTrigger	boolean	true	启用自动触发
aiDiffPreview.autoShowDiffPerEdit	boolean	false	每次编辑自动弹 Diff
aiDiffPreview.showAllDiffsOnStop	boolean	true	Stop 后弹文件列表
aiDiffPreview.floatingLabelMode	string	"statusBar"	浮动标签位置
aiDiffPreview.maxFileSize	number	100000	最大文件大小

开发

npm run watch      # 监听模式
npm run test       # 运行测试 (13 tests)
npm run lint       # 代码检查
npm run package    # 打包 vsix

项目结构

src/
├── extension.ts              # 插件入口
├── trigger/
│   └── hookHandler.ts        # Hook 处理器 + QuickPick 文件列表
├── snapshot/
│   └── snapshotManager.ts    # 变更集管理器 (ChangeSetManager)
├── diff/
│   └── diffEngine.ts         # Diff 计算引擎
├── render/
│   ├── diffViewer.ts         # ★ VSCode 内置 Diff 查看器
│   ├── reviewPanel.ts        # Webview 面板 (次要)
│   ├── inlineDecorator.ts    # 内联装饰器
│   ├── codeLensProvider.ts   # CodeLens 提供器
│   └── statusBar.ts          # 状态栏
├── transaction/
│   ├── acceptHandler.ts      # Accept 处理器
│   └── rejectHandler.ts      # Reject 处理器
└── models/
    ├── types.ts              # 类型定义
    └── constants.ts          # 常量定义

License

MIT