mirror of
https://github.com/Gmaker689/ai-diff-preview.git
synced 2026-09-27 03:21:52 +08:00
docs: README加入安装步骤和Claude Code Hooks必须配置说明
- 删除独立的 .jsonc 示例文件(vsix不会包含)
- README新增安装方式A(vsix直接)和B(源码编译)
- README新增⚠️必须配置章节,含完整 hooks JSON 可复制粘贴
- 说明项目级/用户级 settings.json 位置
This commit is contained in:
@@ -20,22 +20,67 @@ AI Code Diff Preview 为 VSCode 注入 Cursor 风格的 Accept/Reject 差异审
|
||||
|
||||
## 安装
|
||||
|
||||
### 方式 A:直接安装 .vsix 文件(推荐)
|
||||
|
||||
1. 从 [Releases](https://github.com/YonHaoGuo/ai-diff-preview/releases) 下载最新 `ai-diff-preview-*.vsix`
|
||||
2. VSCode 中 `Ctrl+Shift+P` → **Extensions: Install from VSIX** → 选择下载的文件
|
||||
3. 重启 VSCode
|
||||
|
||||
### 方式 B:源码编译安装
|
||||
|
||||
```bash
|
||||
# 克隆仓库
|
||||
git clone https://github.com/YonHaoGuo/ai-diff-preview.git
|
||||
cd ai-diff-preview
|
||||
|
||||
# 安装依赖
|
||||
npm install
|
||||
|
||||
# 编译
|
||||
npm run build
|
||||
|
||||
# 打包 vsix
|
||||
npm run package
|
||||
npm run package # 生成 ai-diff-preview-*.vsix
|
||||
# 然后按方式 A 的第2步安装
|
||||
```
|
||||
|
||||
或通过 VSCode 扩展市场安装(即将发布)。
|
||||
---
|
||||
|
||||
## ⚠️ 必须配置:启用 Claude Code Hooks
|
||||
|
||||
**插件依赖 Claude Code 的 Hooks 机制才能工作,安装后必须配置,否则不会触发!**
|
||||
|
||||
打开 Claude Code 配置文件(**任选其一**):
|
||||
|
||||
| 作用范围 | 配置文件路径 |
|
||||
|----------|-------------|
|
||||
| **当前项目**(推荐) | 项目根目录 `.claude/settings.json` |
|
||||
| **所有项目** | Windows: `C:\Users\<用户名>\.claude\settings.json`<br>macOS/Linux: `~/.claude/settings.json` |
|
||||
|
||||
将以下内容**合并**到你已有的配置文件中(`hooks` 是顶层字段,和现有字段平级):
|
||||
|
||||
```json
|
||||
{
|
||||
"hooks": {
|
||||
"PostToolUse": [
|
||||
{
|
||||
"matcher": "tool_name === 'Edit' || tool_name === 'Write'",
|
||||
"hooks": [
|
||||
{
|
||||
"type": "command",
|
||||
"command": "node -e \"const fs=require('fs');const p=process.cwd()+'/.claude/hooks/pending.json';try{fs.mkdirSync(require('path').dirname(p),{recursive:true});fs.writeFileSync(p,JSON.stringify({toolName:process.env.CLAUDE_TOOL_NAME,filePath:process.env.CLAUDE_TOOL_INPUT_FILE_PATH,oldString:process.env.CLAUDE_TOOL_INPUT_OLD_STRING||'',newString:process.env.CLAUDE_TOOL_INPUT_NEW_STRING||'',content:process.env.CLAUDE_TOOL_INPUT_CONTENT||'',timestamp:Date.now(),type:'edit'}));}catch(e){console.error(e)}\""
|
||||
}
|
||||
]
|
||||
}
|
||||
],
|
||||
"Stop": [
|
||||
{
|
||||
"hooks": [
|
||||
{
|
||||
"type": "command",
|
||||
"command": "node -e \"const fs=require('fs');const p=process.cwd()+'/.claude/hooks/pending.json';try{fs.mkdirSync(require('path').dirname(p),{recursive:true});fs.writeFileSync(p,JSON.stringify({toolName:'Stop',filePath:'',oldString:'',newString:'',content:'',timestamp:Date.now(),type:'stop'}));}catch(e){console.error(e)}\""
|
||||
}
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
配置完成后,**重启 Claude Code 对话**即可生效。
|
||||
|
||||
## 使用方法
|
||||
|
||||
|
||||
Reference in New Issue
Block a user