策划案最终版本

docs/技术报告_音频资源制作.md

@@ -59,6 +59,7 @@
 
 **部署优先级建议**：
 1. **ChatTTS** — 对话自然度最高，适合即兴/随机对白生成
+2. **F5-TTS** — 保留为按需部署项，适合需要更高质量零样本克隆时补充评估
 
 #### 线上服务
 
@@ -203,16 +204,17 @@ python run_gradio.py \
 
 | 序号 | 工具 | 操作 | 预计耗时 | VRAM |
 |------|------|------|---------|------|
-| 4 | **ChatTTS** | `pip install ChatTTS` → 下载模型 | 30min | 4GB |
+| 2 | **ChatTTS** | `pip install ChatTTS` → 下载模型 | 30min | 4GB |
 
 ### 按需部署
 
 | 序号 | 工具 | 场景 |
 |------|------|------|
-| 5 | **DiffRhythm 2** | 需要快速迭代大量 BGM 候选时 |
+| 3 | **F5-TTS** | 需要更高质量零样本声音克隆，且 VoxCPM2/CosyVoice2 不满足时 |
-| 6 | **AudioLDM 2** | 需要精确短音效生成时 |
+| 4 | **DiffRhythm 2** | 需要快速迭代大量 BGM 候选时 |
-| 7 | **YuE** | 需要完整中文歌曲（人声+伴奏）时 |
+| 5 | **AudioLDM 2** | 需要精确短音效生成时 |
-| 8 | **OpenVoice V2** | 需要快速跨语言声音克隆时 |
+| 6 | **YuE** | 需要完整中文歌曲（人声+伴奏）时 |
+| 7 | **OpenVoice V2** | 需要快速跨语言声音克隆时 |
 
 ---
 

docs/游戏策划案.md

@@ -1,9 +1,11 @@
 # 《听仙》— 纯听觉仙侠MUD游戏策划案
 
-> 版本：v1.5（修订版）
+> 版本：v1.6（修订版）
 > 日期：2026-05-21
 > 状态：修订策划（解决交互冲突、属性体系一致性、H5平台限制、键盘输入收敛、MVP收窄、技术架构前置、音频队列收敛）
 
+> **阅读说明**：本文按玩家体验与系统设计顺序组织章节；开发实施顺序见《策划案任务拆分》。其中技术架构虽在第十三章展开，但在开发计划中必须前置验证。
+
 ---
 
 ## 目录
@@ -417,6 +419,19 @@
 
 > 毒不是独立灵根或主功法类别，默认作为状态效果或附加效果存在，例如中毒、腐蚀、毒雾持续伤害。若后续设计毒修流派，应作为资料片式特殊体系单独定义，不混入五行克制矩阵。
 
+#### 灵根与功法适性
+
+灵根不硬性限制可学习功法，避免玩家因初始选择被锁死流派；但同灵根功法有适性加成，鼓励角色构建差异。
+
+| 关系 | 学习/使用规则 |
+|------|--------------|
+| 同灵根功法 | 学习熟练度获取 +20%，灵力消耗 -10%，直接伤害/治疗/护盾数值 +10% |
+| 相生功法 | 可正常学习和使用，无加成也无惩罚 |
+| 相克功法 | 可学习，但熟练度获取 -10%，灵力消耗 +10% |
+| 无五行/身法/通用功法 | 不受灵根适性影响 |
+
+示例：火灵根玩家可以学习冰锥术（水系），但熟练度成长较慢、消耗略高；火球术则成长和输出更好。
+
 #### 技能获取途径
 1. **出身自带**：根据灵根和出身获得1-2个初始技能
 2. **门派传授**：完成门派任务后由师父NPC传授
@@ -911,6 +926,20 @@
 
 ### 7.3 战斗数值公式
 
+#### 派生战斗属性
+
+基础属性不直接等同于战斗面板值，战斗中使用以下派生属性：
+
+```
+物理攻击力 = 根骨 × 2.0 + 悟性 × 0.5 + 武器攻击力 + 装备加成
+法术攻击力 = 灵力 × 2.0 + 神识 × 0.5 + 法宝攻击力 + 功法加成
+物理防御力 = 根骨 × 1.2 + 护甲防御力 + 装备加成
+法术防御力 = 神识 × 1.2 + 灵力 × 0.5 + 装备加成
+暴击率 = 基础暴击(5%) + 悟性加成 + 装备加成
+```
+
+技能配置决定使用物理攻击力还是法术攻击力；目标防御力同理按技能伤害类型选择物理/法术防御。
+
 #### 伤害计算
 ```
 基础伤害 = 技能系数 × (攻击力 - 目标防御力 × 0.5)
@@ -924,6 +953,8 @@
 最终命中 = 命中率 - 闪避率（下限50%，上限99%）
 ```
 
+命中率和闪避率先按原始值相减，再对**最终命中**做 `clamp(50%, 99%)`。例如等级差导致命中率超过100%时，不单独截断命中率，只保证最终命中不会超过99%。
+
 #### 属性克制
 
 | 攻\守 | 金 | 木 | 水 | 火 | 土 |
@@ -1029,9 +1060,12 @@
 
 [分岔路]
 语音："前方通道一分为三。左边传来翻书声，中间飘来药香，右边似有怪物的低吼。"
-左滑：藏经阁方向
+当前焦点："藏经阁通道"
-右滑：密室方向
+右滑 → "丹房通道"
-上滑：确认前进
+右滑 → "密室通道"
+左滑/右滑 → 在三个出口间循环切换
+单击 → 播报当前出口详情
+上滑 → 沿当前选中出口前进
 ```
 
 ### 8.3 Boss机制的音频传达
@@ -1225,7 +1259,7 @@ NPC: 张道长
 
 #### NPC商店
 - 双击NPC进入对话 → 选择"交易"选项 → 进入商店态
-- 商店态操作：上下滑动浏览商品，单击查看详情，双击购买
+- 商店态操作：上/下滑动浏览商品，左滑返回对话态，右滑切换分类，单击查看详情，双击购买
 - 每次购买语音播报："购买回灵丹×1，花费灵石20枚。剩余灵石：480枚。"
 
 #### 玩家交易
@@ -1808,7 +1842,7 @@ Redis:
 | **v0.2 战斗原型** | 回合制战斗 | 2种怪+3个技能+完整回合制语音流+战斗结算 | 纯音频回合制是否可玩、操作节奏是否舒适 | +30个文件 |
 | **v0.3 内容原型** | 任务/对话系统 | 1个NPC+1条教学任务+物品/装备基础操作+菜单系统 | 能否通过音频完成"接任务→打怪→交任务"闭环 | +20个文件 |
 | **v0.4 联机原型** | 多人同步 | 登录+同房间玩家可见+房间聊天（文字转语音）+WebSocket | 多人状态同步+语音播报是否混乱 | +15个文件 |
-| **v0.5 内测MVP** | 内容量+游历修士 | 扩展至15-20个房间+主线第一章前半+3-5个游历修士+日常任务 | 首次完整体验测试、留存观察 | +150个文件 |
+| **v0.5 内测MVP** | 内容量+游历修士 | 扩展至15-20个房间+主线第一章前半+3-5个游历修士+日常任务 | 首次完整体验测试、留存观察 | +187个文件 |
 | **v0.6 社交原型** | 社交与交易 | 好友+私聊+玩家交易+简单组队 | 纯音频社交与交易流程是否清晰 | +80个文件 |
 | **v0.7 副本/PvP扩展** | PvP+组队副本 | 切磋系统+组队副本+新区域 | 多人玩法验证 | +120个文件 |
 | **v1.0 正式版** | 完整内容 | 5大区域+主线前3章+门派+公会+完整经济系统 | 公开上线 | +1500个文件 |

docs/策划案任务拆分.md

@@ -144,20 +144,25 @@
 ## 依赖关系图
 
 ```
-第一层（并行）               第二层（并行）        第三层（并行）         第四层（并行）
+第一层（并行）          第二层（并行）          第三层（并行）          第四层（并行）
-┌──────────┐             ┌──────────┐        ┌──────────┐        ┌──────────┐
+┌──────────┐        ┌──────────┐          ┌──────────┐          ┌──────────┐
-│ 1.游戏概述 │──┬────────→│ 5.角色修炼 │───┬──→│ 8.战斗系统 │───┬──→│12.社交系统 │
+│ 1.游戏概述 │──────→│ 5.角色修炼 │────────→│ 8.战斗系统 │────────→│12.社交系统 │
-└──────────┘  │          └──────────┘   │    └──────────┘   │    └────▲─────┘
+└──────────┘        └──────────┘          └──────────┘          └──────────┘
-┌──────────┐  │          ┌──────────┐   │    ┌──────────┐   │    ┌──────────┐
+┌──────────┐        ┌──────────┐          ┌──────────┐          ┌──────────┐
-│ 2.世界观   │──┼────────→│ 6.地图导航 │───┼──→│ 9.副本系统 │───┼──→│13.AI游历修士│
+│ 2.世界观   │──────→│ 6.地图导航 │────────→│ 9.副本系统 │────────→│13.AI游历修士│
-└──────────┘  │          └──────────┘   │    └──────────┘   │    └──────────┘
+└──────────┘        └──────────┘          └──────────┘          └──────────┘
-┌──────────┐  │          ┌──────────┐   │    ┌──────────┐   │    ┌──────────┐
+┌──────────┐        ┌──────────┐          ┌──────────┐          ┌──────────┐
-│ 3.交互设计 │──┼────────→│ 7.音频系统 │───┘──→│10.任务剧情 │───┘──→│14.生产管线 │
+│ 3.交互设计 │──────→│ 7.音频系统 │────────→│10.任务剧情 │────────→│14.生产管线 │
-└──────────┘  │          └──────────┘        └──────────┘        └────▲─────┘
+└──────────┘        └──────────┘          └──────────┘          └──────────┘
-┌──────────┐  │          5/6 ───────────────→┌──────────┐─────────────┘
+┌──────────┐                              ┌──────────┐
-│ 4.技术架构 │──┘                              │11.经济物品│
+│ 4.技术架构 │────────────────────────────→│11.经济物品│
-│  (前置!)   │                               └────┬─────┘
+│  (前置!)   │                              └──────────┘
-└──────────┘                                      └────────────→ 12.社交交易
+└──────────┘
+
+补充依赖：
+- 8/9/10/11 均依赖 5/6/7 的角色、地图、音频基础能力
+- 12 的交易依赖 11 的经济与物品系统
+- 14 的资源生产依赖 7 的音频系统与 11 的物品/技能定义
 ```
 
 > **变更说明**：技术架构从第四层提升至第一层。手势识别、音频引擎、WebSocket协议、移动浏览器限制等技术约束会直接决定玩法设计能否落地，必须前置验证。
@@ -172,3 +177,5 @@
 3. **音频需求清单** — 该模块需要哪些语音/音效/BGM资源
 4. **交互流程** — 玩家操作手势 → 系统响应音频 的完整流转
 5. **边界条件** — 异常情况处理（网络延迟、操作冲突等）
+
+> 以上是模块验收清单，不要求策划案章节标题逐项同构。后续修订时应检查每章是否覆盖这 5 类信息，缺失项可用小节或表格补齐。