QSanguosha-For-Hegemony技能开发教程：基本技能的组合与实现

技能组合的必要性

在QSanguosha-For-Hegemony项目中，许多复杂的武将技能无法仅通过单一技能实现。为了完整还原这些技能效果，开发者需要掌握基本技能的组合技巧。本文将深入讲解两种主要的技能组合方式：并列式和嵌入式，并通过具体案例展示实现方法。

并列式技能组合

并列式组合是指两个或多个技能同时存在且相互独立，共同构成完整的技能效果。

案例：奇心技能

技能描述：

• 锁定技，你的手牌上限增加X，X为你当前的体力
• 你的攻击范围增加X，X为你损失的体力

实现分析： 这个技能明显包含两个独立效果：

1. 手牌上限调整
2. 攻击范围调整

代码实现：

-- 手牌上限部分
devQixin = sgs.CreateMaxCardsSkill{
    name = "devQixin",
    extra_func = function(self, target)
        if target:hasSkill(self:objectName()) and 
           (target:hasShownSkill(self) or target:askForSkillInvoke(self:objectName())) then
            return target:getHp()
        end
    end
}

-- 攻击范围部分
devQixinAttackRange = sgs.CreateAttackRangeSkill{
    name = "#devQixin_attack", -- #开头的技能会被隐藏
    extra_func = function(self, target)
        if target:hasSkill(self:objectName()) and target:hasShownSkill(self) then
            return target:getLostHp()
        end
    end
}

-- 组合两个技能
sgs.insertRelatedSkills(extension, "devQixin", "#devQixin_attack")

关键点：

1. 使用#前缀隐藏辅助技能
2. insertRelatedSkills函数将多个技能关联起来
3. 主技能(显示在界面上的)放在第一个参数位置

嵌入式技能组合

嵌入式组合是指一个技能包含多个子技能，通常由触发技和视为技通过view_as_skill连接实现。

案例：奸雄技能

技能描述： 出牌阶段限一次，你可以将一张牌当作本出牌阶段上次使用的牌使用。(杀需要考虑限制)

实现分析： 这个技能需要：

1. 记录上次使用的基本牌
2. 提供将手牌视为记录牌的能力

代码实现：

-- 视为技部分
devJiaoxiongVS = sgs.CreateViewAsSkill{
    name = "devJiaoxiong",
    n = 1,
    enabled_at_play = function(self, player)
        if player:getMark(self:objectName()) >= 0 then
            return not player:hasFlag("hasUsed"..self:objectName())
        end
    end,
    view_filter = function(self, selected, to_select)
        return not to_select:isEquipped()
    end,
    view_as = function(self, cards)
        if #cards == 1 then
            local acard = sgs.Sanguosha:cloneCard(
                sgs.Sanguosha:getCard(sgs.Self:getMark(self:objectName())):objectName())
            acard:addSubcard(cards[1]:getId())
            acard:setSkillName(self:objectName())
            acard:setShowSkill(self:objectName())
            return acard
        end
    end
}

-- 触发技部分
devJiaoxiong = sgs.CreateTriggerSkill{
    name = "devJiaoxiong",
    view_as_skill = devJiaoxiongVS,
    events = {sgs.CardFinished, sgs.EventPhaseStart},
    can_trigger = function(self, event, room, player, data)
        -- 实现逻辑...
    end
}

关键点：

1. view_as_skill连接视为技和触发技
2. 使用Mark系统传递卡牌ID
3. 通过Flag控制技能使用次数

复杂技能案例：箭矢

技能描述：

• 每当你的黑色牌因弃置而失去时，可将这些牌置于武将牌上称为"箭"
• 回合外可将两张"箭"当成【无懈可击】使用

实现分析： 这个技能需要：

1. 处理弃牌事件并收集符合条件的牌
2. 提供将两张"箭"视为无懈可击的能力

代码实现：

-- 技能卡定义
devJianshiCard = sgs.CreateSkillCard{
    name = "devJianshiCard",
    -- 实现on_validate等函数...
}

-- 视为技部分
devJianshiVS = sgs.CreateZeroCardViewAsSkill{
    name = "devJianshi",
    -- 实现view_as等函数...
}

-- 触发技部分
devJianshi = sgs.CreateTriggerSkill{
    name = "devJianshi",
    view_as_skill = devJianshiVS,
    events = {sgs.BeforeCardsMove},
    -- 实现can_trigger等函数...
}

关键点：

1. 使用SkillCard处理复杂的卡牌转换逻辑
2. 通过Pile系统管理"箭"的存储
3. 注意内存管理，及时删除临时对象

技能开发方法论

通过以上案例，我们可以总结出技能开发的基本步骤：

1. 技能分析：拆解技能效果，确定需要哪些基本技能
2. 职责划分：明确每个子技能的功能边界
3. 代码实现：逐个实现各子技能
4. 技能组合：使用insertRelatedSkills或view_as_skill连接各子技能

最佳实践建议

1. 合理使用#前缀隐藏辅助技能，保持界面简洁
2. 注意内存管理，特别是使用cloneCard创建的对象
3. 使用注释明确各部分的职责
4. 对于复杂技能，先设计流程图再编码
5. 充分利用调试工具验证技能效果

掌握这些技能组合技巧，开发者可以更高效地实现QSanguosha-For-Hegemony中的各种复杂武将技能。