Gotchas around hooks

钩子（Hooks）相关关键概念

• 安全推荐： 推荐在脚本中使用绝对路径（Absolute Paths）而非相对路径（Relative Paths）。
• 目的： 减轻路径拦截和二进制植入攻击的风险。
• 路径差异问题： 绝对路径依赖于项目在不同机器上的实际位置，因此难以共享 settings. json 文件。
• 解决方案： 使用 settings. example. json 文件作为模板。
• 该文件中的脚本引用包含 $PWD 占位符（Placeholder）。
• 初始化过程 (npm run setup)：
• 运行 init-claude. js 脚本。
• 该脚本执行以下操作：
• 将 $PWD 占位符替换为用户机器上的项目绝对路径。
• 复制 settings. example. json 文件。
• 将副本重命名为 settings. local. json。
• 结果： 实现了在保持安全推荐（使用绝对路径）的同时，能够共享配置文件的目标。

Takeaways

• 安全推荐使用绝对路径，以减轻路径拦截和二进制植入攻击的风险。
• 由于绝对路径依赖于机器位置，难以共享配置文件，因此使用 settings. example. json 作为模板。
• 该模板中包含 $PWD 占位符，用于代表用户机器上的项目绝对路径。
• 运行 npm run setup 会执行初始化脚本，将 $PWD 替换为实际路径，并生成 settings. local. json。