RFC: Sect system expansion with multi-role identities

[teps3105]

RFC: Sect system expansion with multi-role identities

Status: Experimental

Summary / 摘要

This proposal suggests expanding the existing Sect (宗門) system with autonomous development capabilities, a state machine, delta aggregation, and a multi-role protagonist identity system.

本建議提案擴展現有的宗門系統，新增自主發展能力、狀態機、Delta 聚合以及多角色天驕身分系統。

Motivation / 動機

Current State / 當前狀態

The project has an Avatar class for character core data (cultivation, attributes, actions, relationships) with protagonist mode supporting none/random/all. The Sect class contains static data (faction, style, headquarters, members, techniques) but lacks autonomous behavior.

專案現有 Avatar 類用於角色核心數據（修為、屬性、行動、關係等），支援 protagonist 模式（none/random/all）。Sect 類包含靜態數據（陣營、風格、總部、成員、功法），但缺乏自主行為能力。

Existing Issues / 現存問題

• Sects cannot act independently, grow, decline, or wage war / 宗門無法獨立行動、成長、衰退或發動戰爭
• No interaction between sects (alliances, enmity, mergers) / 宗門之間無互動（聯盟、敵對、併吞）
• Limited interaction between avatars and sects / 天驕與宗門的互動不夠豐富

Missing Items / 缺失項目

• No autonomous sect development system / 無宗門自主發展系統
• No state machine for sect lifecycle / 無宗門生命週期狀態機
• No delta aggregation for tracking sect changes / 無追蹤宗門變更的 Delta 聚合
• No multi-role protagonist identity system / 無多角色天驕身分系統
• No time warp functionality / 無時間倍率功能
• No vector visualization for sect states / 無宗門狀態向量可視化

Detailed Design / 詳細設計

1. Sect Vector System / 宗門向量系統

# src/classes/sect_vector.py
from dataclasses import dataclass
import numpy as np

@dataclass
class SectVector:
    """宗門狀態向量 / Sect state vector"""
    resources: float      # 資源 / Resources
    military: float       # 軍事 / Military
    prestige: float       # 聲望 / Prestige
    cultivation: float    # 修煉 / Cultivation
    stability: float      # 穩定 / Stability
    innovation: float     # 創新 / Innovation

    def drift(self, rate: float = 0.01):
        """向量漂移 / Vector drift"""
        # 自然漂移邏輯

Implements numpy-based state vectors representing sect characteristics with natural drift mechanism.

實作基於 numpy 的狀態向量，表示宗門特徵並包含自然漂移機制。

2. Sect State Machine / 宗門狀態機

# src/classes/sect_fsm.py
from enum import Enum

class SectState(Enum):
    RISING = "rising"           # 興起
    STABLE = "stable"           # 穩定
    DECLINING = "declining"     # 衰落
    CRISIS = "crisis"           # 危機
    DISSOLVED = "dissolved"     # 解散

@dataclass
class SectFSM:
    """宗門狀態機 / Sect finite state machine"""
    current_state: SectState
    transition_history: List[SectTransition]

    def transition(self, new_state: SectState, trigger: str):
        # 狀態轉換邏輯

3. Delta Aggregation System / Delta 聚合系統

# src/classes/sect_delta_system.py
from dataclasses import dataclass
from typing import List

@dataclass
class SectDelta:
    timestamp: int
    type: str  # "vector_drift", "state_change", "event"
    data: dict

@dataclass
class MajorEventDelta(SectDelta):
    """重大事件 Delta / Major event delta"""
    involved_avatars: List[int]  # 參與的天驕 IDs
    impact: float  # 影響程度

4. Multi-Role Identity System / 多角色身分系統

# src/classes/protagonist_role.py
from enum import Enum

class ProtagonistRole(Enum):
    NONE = "none"                    # 無 / None (0.0)
    MALE_LEAD = "male_lead"          # 男主 / Male Lead (1.0)
    FEMALE_LEAD = "female_lead"      # 女主 / Female Lead (1.0)
    RIVAL = "rival"                  # 勁敵 / Rival (0.8)
    NEMESIS = "nemesis"              # 宿敵 / Nemesis (0.9)
    SAINT = "saint"                  # 聖子 / Saint (0.7)
    SECT_LEADER = "sect_leader"      # 教主 / Sect Leader (0.6)
    ELDER = "elder"                  # 長老 / Elder (0.5)
    DISCIPLE = "disciple"            # 傳人 / Disciple (0.6)
    EVIL_GENIUS = "evil_genius"      # 邪道天驕 / Evil Genius (0.8)
    DEMON_LORD = "demon_lord"        # 魔尊 / Demon Lord (0.9)
    HERO = "hero"                    # 俠士 / Hero (0.7)

    @property
    def event_priority(self) -> float:
        """事件優先級 / Event priority"""
        return self._value_to_priority[self]

5. Time Warp System / 時間倍率系統

# src/sim/time_warp_system.py
from enum import Enum

class TimeWarpMultiplier(Enum):
    PAUSED = 0
    X1 = 1
    X10 = 10
    X100 = 100
    X1000 = 1000

@dataclass
class TimeWarpSystem:
    """時間倍率系統 / Time warp system"""
    current_multiplier: TimeWarpMultiplier
    # 暫停、x1、x10、x100、x1000

Frontend Components / 前端組件

• SectVectorRadar.vue - Radar chart for six-dimensional vector
• SectStateBadge.vue - State badge component
• ProtagonistRoleBadge.vue - Role badge component
• TimeWarpControl.vue - Time multiplier control

Directory Structure / 目錄結構

├── src/classes/
│   ├── sect_vector.py (新增)
│   ├── sect_fsm.py (新增)
│   ├── sect_delta_system.py (新增)
│   ├── protagonist_role.py (新增)
│   └── avatar/core.py (擴展)
├── src/sim/
│   ├── time_warp_system.py (新增)
│   └── world.py (擴展)
└── web/src/components/
    ├── SectVectorRadar.vue (新增)
    ├── SectStateBadge.vue (新增)
    ├── ProtagonistRoleBadge.vue (新增)
    └── TimeWarpControl.vue (新增)

Rationale and Alternatives / 理由與替代方案

Design Decisions / 設計決策

• Vector-based state representation enables quantitative sect comparison / 向量化狀態表示實現宗門定量比較
• Finite state machine provides clear lifecycle tracking / 有限狀態機提供清晰生命週期追蹤
• Delta aggregation supports time-warp without full simulation / Delta 聚合支持快進模式無需完整模擬
• Multi-role system enables diverse narrative possibilities / 多角色系統實現多樣化敘事可能

Implementation Concerns / 實施考量

Risk Assessment / 風險評估

Risk / 風險	Level / 等級
Vector drift instability / 向量漂移不穩定	Medium (40%)
Role transition frequency / 身分轉換頻率過高	Low (20%)
Time-warp performance / 時間倍率性能	Low (15%)
Existing test breakage / 現有測試失敗	Medium (35%)

Mitigation Strategy / 緩解策略

• Tune drift_rate parameter (default 0.01) / 調整 drift_rate 參數（預設 0.01）
• Role transitions require specific conditions (cultivation level, sect state) / 身分轉換需滿足特定條件
• Delta aggregation in fast-forward mode avoids avatar expansion / 快進模式下 Delta 聚合避免展開天驕
• Run all existing tests before merging / 合併前運行所有現有測試

Testing Strategy / 測試策略

# tests/test_sect_vector.py
def test_sect_vector_drift():
    """測試向量漂移 / Test vector drift"""
    sect = Sect(name="Test Sect")
    initial_vector = sect.vector.copy()
    sect.tick(years=10)
    assert not np.array_equal(sect.vector, initial_vector)

def test_sect_fsm_transitions():
    """測試狀態機轉換 / Test FSM transitions"""
    sect = Sect(name="Test Sect")
    sect.fsm.current_state = SectState.CRISIS
    sect.trigger_event("recovery")
    assert sect.fsm.current_state == SectState.DECLINING

def test_role_transition_paths():
    """測試身分轉換路徑 / Test role transition paths"""
    avatar = Avatar(role=ProtagonistRole.DISCIPLE)
    avatar.promote_to_leader()
    assert avatar.role == ProtagonistRole.SAINT

Unresolved Questions / 未解問題

1. Should the time warp system persist across save/load operations?
   時間倍率系統是否應在存檔/讀檔時持久化？

2. Should role transitions be reversible (e.g., Saint → Disciple)?
   身分轉換是否應可逆（例如：聖子 → 傳人）？

3. What should be the maximum number of concurrent high-dimensional deltas?
   同時存在的最大高維 Delta 數量應為多少？

References / 參考

• Current Sect implementation: src/classes/sect.py / 當前宗門實現
• Current Avatar implementation: src/classes/avatar/core.py / 當前天驕實現
• Current World implementation: src/sim/world.py / 當前世界實現
• Frontend locales: web/src/locales/ / 前端語言文件

[teps3105]

已更新提案

[4thfever]

感谢提案。
我认可的部分在于，目前的宗门系统依然单薄且单调，没有很好的承担起修仙世界的重要背景板任务。
不过目前的重点工作依然是在世界细节上进行补完，还不准备开新的模式。
把宗门系统独立出来作为单独的模式，我个人认为这个太“重”了，且不能提高目前以avatar为主角的观察体验。
我目前更关注的宗门相关的任务是：

1. 宗门会有怎样的内部活动？比如宗门大比？
2. 宗门会有怎样的内部运行机制。类似藏宝阁、任务榜。任务是如何发布的，又是如何结算的？
3. 不同宗门内，宗门内部的弟子如何互动？宗门内部的上下级如何互动？
4. 有些宗门不让弟子离开宗门游历，怎么实现和体现？会不会过分单调？

同时，这些实现必须足够简洁，以适配目前不同智能程度的LLM，以及现在每个宗门弟子人数不多的事实。

[4thfever]

这个不代表你的思路不好哈，只是现在还不是时候。将来有一天（虽然会比较久）会去考虑宗门的扩张和变迁的（类似WorldBox）

[teps3105]

應該說是，在既有的宗門系統上擴張，而不是增加新的宗門模式

就是說角色的狀態改成天驕角色

宗門能看到更多狀態，而不是現在單獨只能看一點東西，玩家代入感不足

我的想法是，把每個avastar 當成「天驕」來處理，宗門只是背景版，這樣在改動上非常少，繼承現有的模式，只是框架擴張而已

[4thfever]

没差了，因为现在做宗门的更多状态机是over-design了。
目前的重点还是丰富avatar的系统本身。
只能说抱歉我在这方面会独裁一下了（

[teps3105]

理解，那我這份就先封存成ROADMAP，作為未來方向

[4thfever]

ok的，另外拉你进team了

[4thfever]

作为长线事项，convert to discussion了。