feat：epic 1
This commit is contained in:
parent
25848353f2
commit
755b06f634
|
|
@ -5,27 +5,45 @@ work: ../work/epic-fps-gunfeel-training.md
|
||||||
---
|
---
|
||||||
# FPS 枪感训练场原型
|
# FPS 枪感训练场原型
|
||||||
|
|
||||||
起点：创建基于 Unity 的 Windows 端 FPS 原型，验证类似战术射击游戏的基础枪感。目标：在单人灰盒训练场中证明移动、停稳、短点射、固定后坐力与动态靶训练的核心循环。
|
## 起点与目标
|
||||||
|
长期愿景是 Unity Windows 战术 FPS。本 Epic 交付单人灰盒训练场，验证移动、停稳、短点射及动态靶训练循环。
|
||||||
|
|
||||||
范围：Unity Windows 单人训练场；一把自动步枪；停稳精准、移动散布增加、快速停稳；可学习固定后坐力；静态靶与横向往返/随机换向动态靶；命中反馈与训练统计。
|
## 范围与非目标
|
||||||
|
一把自动步枪、灰盒场景、静态靶、横向往返与随机换向动态靶、命中反馈、统计及 Windows x64 可执行构建。
|
||||||
|
不包含固定弹道记忆/压枪系统、联网、英雄技能、经济、攻防模式、成品美术、多武器与换弹；原型无限弹药。
|
||||||
|
|
||||||
非目标：联网、英雄技能、经济系统、完整回合制攻防、美术品质地图、多武器库。
|
## 共享语言与概念边界
|
||||||
|
- 短点射是玩家在全自动步枪上手动按下再松开，每组 1–3 发，不是自动三连发模式。
|
||||||
验收标准：玩家能移动并快速停稳；移动与静止射击精度差异清晰；短点射比持续扫射更可控；后坐力模式可重复学习；动态靶两种模式可训练；命中反馈和统计可读。
|
- 后坐力是镜头上抬；散布是弹道相对当前瞄准方向的随机角度偏差。持续射击增加二者，停火恢复精度，不要求学习固定弹道。
|
||||||
|
- 停稳指松开移动输入后平面速度低于 0.1 m/s。
|
||||||
|
- 有效命中指一次射线首次击中靶体，一枪最多一次；先击中遮挡物时不计靶体命中。
|
||||||
|
- 场景示例：移动时准星扩张，松开 WASD 停稳后恢复移动精度惩罚；左键按住连续射击增加散布，松开后恢复，命中靶体才反馈并计数。
|
||||||
|
|
||||||
## 关键决策
|
## 关键决策
|
||||||
- **DEC-1 · 首版聚焦枪感**：单人灰盒训练场优先验证基础射击体验。
|
- DEC-1：沿用用户确定的单人训练场、短点射、快速停稳和两种动态靶方向。
|
||||||
- **DEC-2 · 射击节奏**：停稳精准、移动增加散布、短点射控制精度。
|
- DEC-2：纠正旧稿误记，以短点射控制精度取代固定后坐力模式。
|
||||||
- **DEC-3 · 后坐力**：采用可学习的固定后坐力模式，并允许持续射击时散布增加。
|
- DEC-3：本轮提议的可调初始验收基线：移动 5 m/s，停稳不超过 100 ms，射速 600 RPM，停火 250 ms 后恢复基础散布；静止半角 0.15°，移动至少 1.5°，连射 10 发后至少 2°。owner 批准本修订后，这些值即为本 Epic 冻结的默认验收阈值；允许运行时调参，但测试始终使用冻结默认值。更改通过阈值须走契约变更；后续 Epic 可重新平衡。
|
||||||
- **DEC-4 · 目标类型**：静态靶与动态靶并存，动态靶支持横向往返和随机换向。
|
- DEC-4：拟用 Unity 6 LTS、内置渲染管线和 Input System；ITEM-1 固定实际可用的 Editor 精确版本及包版本。
|
||||||
|
|
||||||
|
## 验收标准
|
||||||
|
- WASD 移动、鼠标瞄准、左键按住连射/松开停火；停稳符合 100 ms 阈值，移动准星扩张。
|
||||||
|
- 散布测试不包含镜头后坐力：使用固定朝向的虚拟枪口和正前方 20 m 垂直平面，RMS = sqrt(mean(x²+y²))，单位 m。种子 42，每个对照重置同一弹道随机流和精度状态。基础对照各采 1000 个独立首发，每发重置射击热度；移动组预先保持 5 m/s 一秒，静止组速度为零；移动 RMS 至少为静止的 5 倍。点射/扫射对照均静止、共 300 发：点射每组三发，组内间隔 100 ms，上一组末发后停火 250 ms 再发下一组；扫射连续每 100 ms 一发。除开始外不人工重置精度，仅按真实停火逻辑恢复；点射 RMS 不超过扫射的 60%。镜头后坐力另做实际输入体验验证。另直接断言散布模型的锥体半角：静止首发 0.15°（误差不超过 0.001°）、移动首发至少 1.5°、连续第 10 发至少 2°；以 r=20*tan(半角) 换算采样支持域半径，逐发验证采样不越出模型锥体，避免用随机样本最大值推断下限。
|
||||||
|
- 命中显示标记并使靶体闪烁；未命中不触发。统计发射数、命中数、命中率；零发显示 0%，重置清零。
|
||||||
|
- 往返靶左右各 3 m 范围、默认 2 m/s，到边界反向。随机模式每 0.5–1.5 s 随机选方向，边界强制反向，使用独立于弹道的目标随机流、均匀时间分布和等概率左右选择，初始向右；边界反向不重置既定随机倒计时，越界位移反射回合法区间。R 重置到中心并复位随机种子。往返断言：默认参数 1 s 时 x=2 m、2 s 时 x=2 m；随机模式同种子同时间步长重置后轨迹一致，固定步长模拟 10 分钟不越界。具体 RNG 算法在实现中固定并测试，不要求跨算法轨迹一致。
|
||||||
|
|
||||||
## 子项契约
|
## 子项契约
|
||||||
- ITEM-1：cs-feat；建立 Unity 项目与 Windows 灰盒训练场；依赖无；验收为可启动场景。
|
- ITEM-1（cs-feat）：工程、灰盒场景和构建入口；无依赖。固定 Editor/包版本及 Windows x64 配置；干净检出导入编译无错误，Play 进入含地面、光照、摄像机的场景；构建脚本输出 Builds/Windows，日志及测试证据输出 Artifacts，生成物不入库。Editor/激活缺失属于阻塞，不能以静态检查代替运行。
|
||||||
- ITEM-2：cs-feat；实现玩家移动、快速停稳与准星/散布反馈；依赖 ITEM-1；验收为移动状态影响精度。
|
- ITEM-2（cs-feat）：移动、视角、精度状态与准星；依赖 ITEM-1。WASD、可调鼠标灵敏度、俯仰限制、光标锁定；Esc 暂停释放光标、点击继续；暂停禁移动/射击。验证停稳阈值、地面墙体不穿透；速度驱动精度状态，真实射击验证归 ITEM-3。
|
||||||
- ITEM-3：cs-feat；实现自动步枪、短点射、固定后坐力与命中反馈；依赖 ITEM-2；验收为可重复压枪与命中反馈。
|
- ITEM-3（cs-feat）：步枪、最小静态靶与反馈；依赖 ITEM-2。实现连射、精度恢复、镜头后坐力和上述散布比较。唯一射击结果携带序号、命中对象/点、有效标记和时间，ITEM-3 只发布结果并负责即时反馈，绝不写统计字段；验证射线遮挡、暂停禁射、不同帧率射速与命中反馈。
|
||||||
- ITEM-4：cs-feat；实现静态靶、动态靶和训练统计；依赖 ITEM-3；验收为两种动态模式可运行且统计可读。
|
- ITEM-4（cs-feat）：动态靶、会话及统计；依赖 ITEM-3。模式切换、速度滑条 0.5–4 m/s（步进 0.5，默认 2）、固定种子；在 0.5、2、4 m/s 下验证边界及换向，R 恢复默认 2 m/s 并重置目标；R 重置统计、目标和武器精度；暂停冻结目标及会话；ITEM-4 是统计唯一写入者，每个射击序号仅消费一次；R 清空计数及去重状态，射击序号在进程内不复用；暂停不发布或消费射击结果。HUD 展示上述统计、退出按钮。验证两种动态模式边界、切换、重置和计数。
|
||||||
|
|
||||||
## 最终交付索引
|
## 最终交付索引
|
||||||
|
实施后记录项目入口、构建脚本、运行说明、测试证据和 Windows 产物路径。
|
||||||
|
|
||||||
## 整体验收
|
## 整体验收
|
||||||
|
四项完成后从干净检出用固定 Editor 构建 Windows x64 至 Builds/Windows。真机启动可执行文件进入训练场，验证移动、瞄准、停稳、点射/扫射、静态命中、两种动态模式、统计、重置、暂停/继续和退出，无阻断错误。证据存 Artifacts 并由游标引用。独立最终验收审查后由用户体验并最终接受枪感。
|
||||||
|
|
||||||
## 遗留风险
|
## 遗留风险
|
||||||
- Unity 版本与输入/渲染方案尚未指定，将在 ITEM-1 设计时确定。
|
- 常用目录、PATH、卸载注册表尚未发现 Unity；Editor、构建组件与许可证需要核实解决，缺失时不能宣称运行通过。
|
||||||
|
- 本轮数值是待确认的初始参数；量化测试不能取代用户最终主观枪感验收。
|
||||||
|
- 联网、服务器权威及延迟补偿属于后续 Epic，不预建框架。
|
||||||
|
|
|
||||||
|
|
@ -3,11 +3,11 @@ epic: ../epics/fps-gunfeel-training.md
|
||||||
phase: planning
|
phase: planning
|
||||||
approved_revision: pending
|
approved_revision: pending
|
||||||
current_item: null
|
current_item: null
|
||||||
next_action: owner 确认 Epic 目标、边界、验收标准与子项契约，并选择执行策略
|
next_action: 修订稿复审后确认契约变化并解决 Editor 环境
|
||||||
blocked_by: null
|
blocked_by: null
|
||||||
item_progression: pending
|
item_progression: continuous
|
||||||
milestone_commit: pending
|
milestone_commit: authorized
|
||||||
remote_publish: pending
|
remote_publish: each-milestone
|
||||||
---
|
---
|
||||||
## 子项进度
|
## 子项进度
|
||||||
- [ ] ITEM-1
|
- [ ] ITEM-1
|
||||||
|
|
@ -15,3 +15,9 @@ remote_publish: pending
|
||||||
- [ ] ITEM-3
|
- [ ] ITEM-3
|
||||||
- [ ] ITEM-4
|
- [ ] ITEM-4
|
||||||
## 临时决策与证据
|
## 临时决策与证据
|
||||||
|
- 2026-09-12：owner 明确批准上述策略，不重复询问。
|
||||||
|
- main 跟踪 wd/main；远端 https://git.ttlist.top/qs/wd.git 可访问。
|
||||||
|
- 首轮 design review：/root/epic_design_review，collaboration 结构化委派，异构 gpt-5.6-sol high，无回退。目标 SHA256 671051C0831F8DC6C355B35DB5544AB576F346F29D8CCACA79AA00F23AD523E9，结论需修改：固定后坐力误记、Windows 交付缺失、验收不明确、输入及命中归属缺失。修订稿待同 lineage 复审。
|
||||||
|
- PATH、默认 Editor 目录、常用程序目录、卸载注册表未发现 Unity，尚未安装/激活软件。
|
||||||
|
- 第二/三轮同 reviewer 复审完成；第三轮目标 42C75F9FF20069F9F6F59C1DF1EB70C96C802077BD2405B76FCEE471BEA1520E，无 blocking，important 为 owner 确认、绝对散布阈值覆盖、速度控件验收。后两项已补文档，未进行第四轮；达到三轮上限，交 owner 裁决当前候选，不宣称 review 全通过。
|
||||||
|
- 原执行/提交/发布授权继续有效；本轮无 commit/push，待 owner 接受修订及三轮后剩余审查状态。
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue
Block a user