如何查找react-three/cannon中useBox的官方文档与使用说明

@react-three/cannon（即原use-cannon库）的所有钩子包括useBox都有官方说明文档，不需要硬读源码。

useBox核心参数逻辑梳理 #

你不需要靠试错调整参数，先明确几个对应规则：

• useBox配置中的args参数：定义物理碰撞体的尺寸，格式为[x轴宽度, y轴高度, z轴深度]，单位和Three.js场景单位一致
• 你用到的<Box>组件的scale参数：定义视觉渲染的立方体尺寸，需要和useBox的args保持固定对应关系（示例中桌面args为[2.5, 0.25, 2.5]，对应scale为[5, 0.5, 5]，刚好为2倍关系），你之前只修改scale没同步调整args和position，才会出现桌腿穿出桌面的问题
• position参数：定义碰撞体（以及绑定了ref的渲染组件）的世界坐标，格式为[x, y, z]，桌腿和桌面没有自动绑定逻辑，位置需要你手动计算对齐，比如你把桌腿y轴拉长2单位，就要把position的y值向下调整1单位，就能避免穿出桌面

离线查阅文档的方式 #

你下载的pmndrs/use-cannon仓库源码本身就包含完整的文档站点源码，存放在docs目录下，你可以本地启动文档服务离线查阅所有内容：

1. 进入仓库的docs文件夹
2. 执行npm install安装依赖
3. 执行npm run dev启动本地文档服务
4. 打开本地服务地址后，在左侧导航栏找到Shapes分类，就能看到useBox的完整说明，包括所有可配置参数、返回值、使用示例

内容的提问来源于stack exchange，提问作者NealWalters