# Gameplay Surface Camera Up

> 当贴壁角色经过地面小凸缘就把视角扭向地面时，以局部表面法线证据协调 world-up 与角色 up，保留真正攀墙时的视角旋转；不替代遮挡显露、相机碰撞、短促震动或速度 FOV。

- Skill: `ziyou-lu/gameplay-surface-camera-up` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx get-skill add ziyou-lu/gameplay-surface-camera-up`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ziyou-lu/gameplay-surface-camera-up/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ziyou-lu (https://skillmd.com/u/ziyou-lu)
- Updated: 2026-11-19
- Page: https://skillmd.com/skills/ziyou-lu/gameplay-surface-camera-up

---


# 表面感知的相机上方向

## 效果预览

同样原鸟跨小凸缘；左镜头参照跟随局部倾角旋转，右按周围地面证据保持上方向。

左侧为使用前，右侧为使用后；斜视 2.5D 短循环，用途示意（非引擎实测；音频相关预览仅示意触发关系，不含声音）。

![经过小凸缘，镜头别突然歪下去：使用前后对比](assets/before-after.webp)

## 触发条件

贴壁角色经过近地小凸缘时相机误转向地面，但真正攀墙又需要随表面旋转。

## 输入与前置条件

world-up、角色 up、基础相机控制契约、局部探针命中/法线、地面分类规则与混合端点。

## 实施步骤

1. 固定路线对比小凸缘误倾和正常攀墙，先确认缺陷来自基础上方向，不是相机穿墙或遮挡显示。
2. 在角色周围布置适合几何的探针；可采用锥形射线排列，并按角色尺度和表面分布配置锥角、长度与采样密度。显示有效命中、位置与法线，统一法线坐标，过滤自身/无效查询。
3. 以法线与 world-up 的夹角分类地面证据，分别记录有效查询数和地面命中数。没有有效查询不能自动当成已确认墙面。
4. 用地面证据生成 world-up 与角色 up 的混合信号：足够地面证据偏世界向上，可靠贴壁证据允许角色向上。明确零命中、混合表面和饱和端点策略；中间映射由项目选择并记录。
5. 保持既有镜头目标和控制权，只替换基础上方向参考。需要平滑/滞回时独立加入并测响应延迟，不用无限阻尼掩盖错误分类。
6. 切场/切角色清空旧表面信号；相机碰撞、遮挡显露和玩家舒适度分别检查，本算法不替代它们。

## 参数调整

先调探针长度/分布使近地证据稳定，再调地面夹角阈值、混合端点和响应速度；切勿把某个端点计数当总射线数，或未定义就用命中数除固定常数。

## 验收与失败处理

- [ ] 同路线小凸缘不过早翻转，真实上墙不永久锁 world-up。
- [ ] 阈值两侧坡面、混合地墙、零/少命中和查询失败有明确输出。
- [ ] 凸凹角、倒挂、移动物体和快速反向不跳变；记录平滑延迟。
- [ ] 控制权切换无旧信号，独立检查穿插/遮挡/不适，失败先看调试分类而非增加 shake。

## 按需组合

- [角色遮挡显露](../gameplay-occlusion-reveal/SKILL.md)
- [镜头冲击](../gameplay-camera-feedback/SKILL.md)
- [速度镜头](../gameplay-speed-camera/SKILL.md)
- [完成镜头交接](../gameplay-completion-sequences/SKILL.md)
- [重力方向线索](../gameplay-gravity-orientation-cues/SKILL.md)

需要核查出处、示例参数或证据限制时，读取[来源参考](references/sources.md)。

