使用 mod 响应事件

on('tool.call', async ($, e, next) => {
  // 在工具运行之前运行
  $.ui.log('Claude is about to use ' + e.tool)
  // 原样传递事件
  return next(e)
})

on('tool.call', async ($, e, next) => {
  // 让工具运行，并等待其结果
  const result = await next(e)
  // 在工具运行后运行
  $.ui.log(e.tool + ' finished')
  // 原样返回结果
  return result
})

on('prompt.submit', async ($, e, next) => {
  // 传递事件的副本，其文本已更改
  return next({ ...e, text: e.text.trim() })
})

on('tool.call', { tool: 'Bash' }, async () => {
  // 没有调用 next，所以命令永远不会运行
  return { deny: 'Bash is turned off in this project. Use the file tools.' }
})

// 字符串匹配一个值：仅 Bash 调用
on('tool.call', { tool: 'Bash' }, hook)
// 数组匹配其中任何值：Edit 调用和 Write 调用
on('tool.call', { tool: ['Edit', 'Write'] }, hook)
// 正则表达式按模式匹配：来自一个 MCP 服务器的每个工具
on('tool.call', { tool: /^mcp__github__/ }, hook)

// matcher 将 hook 限制为 Bash 调用，因此 e.command 是 shell 命令
on('tool.call', { tool: 'Bash' }, async ($, e, next) => {
  if (/git push .*--force/.test(e.command)) {
    // 返回而不调用 next 会回答事件，所以命令永远不会运行
    return { deny: 'Force pushes are not allowed in this repository. Push to a new branch instead.' }
  }
  // 每个其他命令都会进行权限检查，然后进行 Bash
  return next(e)
})

on('tool.call', { tool: ['Edit', 'Write'] }, async ($, e, next) => {
  // 等待权限检查和工具，并保留它们生成的内容
  const result = await next(e)
  // 被拒绝的调用返回为 { deny }，失败的调用设置了 isError
  const changed = !result.deny && !result.isError
  if (changed && e.file_path.endsWith('.mdx')) $.ui.log('Claude changed ' + e.file_path)
  // 原样返回结果，所以 Claude 读取工具返回的内容
  return result
})

const RISKY = /\brm\s+-rf?\b|\bgit\s+reset\s+--hard\b|\bgit\s+push\b.*--force/

export function register(on) {
  on('tool.call', { tool: 'Bash' }, async ($, e, next) => {
    // 让每个其他命令通过而不提问
    if (!RISKY.test(e.command)) return next(e)
    // 从安全答案开始，所以没有人回答的问题会拒绝命令
    let answer = 'Refuse'
    try {
      // 工具调用在这里等待，直到用户选择两个标签之一
      answer = await $.ui.ask('Run this command? ' + e.command, ['Run it', 'Refuse'])
    } catch {
      // 用户关闭了问题，或这是一个 claude -p 运行，没有人可以问
    }
    if (answer !== 'Run it') {
      // 回答而不调用 next，所以命令不会运行
      return { deny: 'The user declined this command. Ask before trying a different approach.' }
    }
    return next(e)
  })
}

on('prompt.submit', async ($, e, next) => {
  // 原样传递不提及拉取请求的提示
  if (!/\bPR\b|pull request/i.test(e.text)) return next(e)
  const git = await $.process.run(['git', 'branch', '--show-current'])
  // 在 git 存储库外，命令失败，因此没有分支可添加
  if (git.exitCode !== 0) return next(e)
  // 保留早期 hook 添加的任何上下文，并为 Claude 添加一行
  return next({ ...e, context: [...(e.context ?? []), 'Current branch: ' + git.stdout.trim()] })
})

// function* 使 hook 成为生成器，可以逐块传递响应
on('turn.step', async function* ($, e, next) {
  // 发送请求，在每个片段到达时转发它，并保留完成的结果
  const result = yield* next(e)
  // 跳过不报告令牌计数的结果
  if (result.usage) {
    $.ui.log('cache read ' + result.usage.cache_read_input_tokens + ' · wrote ' + result.usage.cache_creation_input_tokens)
  }
  // 原样返回结果，所以轮次照常继续
  return result
})

on('classic.Stop', async ($, e, next) => {
  // e 具有设置文件中的 Stop hook 从 stdin 读取的相同字段
  $.ui.log('Transcript saved at ' + e.transcript_path)
  // 传递事件，所以你的设置文件中的 Stop hooks 仍然运行
  return next(e)
})

// on 返回一个注册，.catch 将处理程序附加到该 hook
on('tool.call', { tool: 'Bash' }, guard).catch(async ($, e, next) => {
  // next.error.kind 是 'throw' 或 'timeout'，说明 guard 如何失败
  return { deny: 'The command guard failed, so this command was not run: ' + next.error.kind }
})