39 lines
1.2 KiB
Markdown
39 lines
1.2 KiB
Markdown
# Cursor Hooks 说明
|
||
|
||
## 结构
|
||
|
||
```
|
||
hooks/
|
||
├── run-hook.ps1 # Windows dispatcher（读取 local-env.json 后分发）
|
||
├── session-init.ps1 # sessionStart hook（PowerShell 版）
|
||
├── session-init.sh # sessionStart hook（bash 版）
|
||
├── check-changelog.ps1 # stop hook（PowerShell 版）
|
||
├── check-changelog.sh # stop hook（bash 版）
|
||
└── README.md # 本文件
|
||
```
|
||
|
||
## 跨平台适配
|
||
|
||
`hooks.json` 中的 `command` 字段是**平台绑定的**——Windows 用 `powershell`，macOS/Linux 用 `bash`。
|
||
|
||
### Windows（当前）
|
||
|
||
hooks.json 使用 `powershell ... run-hook.ps1` 作为入口，dispatcher 根据
|
||
`.cursor/local-env.json` 的 `shell` 字段决定执行 `.ps1` 还是 `.sh` 脚本。
|
||
|
||
### 迁移到 macOS / Linux
|
||
|
||
将 hooks.json 的 command 改为直接调用 `.sh` 脚本：
|
||
|
||
```json
|
||
{
|
||
"version": 1,
|
||
"hooks": {
|
||
"sessionStart": [{ "command": "bash .cursor/hooks/session-init.sh", "timeout": 5 }],
|
||
"stop": [{ "command": "bash .cursor/hooks/check-changelog.sh", "timeout": 10, "loop_limit": 1 }]
|
||
}
|
||
}
|
||
```
|
||
|
||
同时更新 `.cursor/local-env.json` 的 `shell` 字段为 `bash` 或 `zsh`。
|