Skip to content

AGENTS.md

Latest commit

 

History

History
74 lines (56 loc) · 4.84 KB

AGENTS.md

File metadata and controls

74 lines (56 loc) · 4.84 KB
Raw

AGENTS.md — RimMind-Bridge-RimChat

RimMind 与 RimChat 的对话/动作门控、上下文拉取桥。仅编译依赖 Core； 对 RimChat 的访问经过反射，不直接依赖其他 RimMind 子模组。

阅读路径

任务 入口与实际所有者
加载、设置和扩展注册 Source/RimMindBridgeRimChatMod.cs → Extensions/
对话、玩家菜单互斥 Source/Bridge/DialogueGate.cs
动作分类、叙事者事件门控 Source/Bridge/ActionGate.cs
当前游戏事件冷却 Source/Cooldown/SharedIncidentCooldown.cs → GameComponent_BridgeRimChat.cs
RimChat 历史 → Core Context Source/Bridge/ContextPullBridge.cs（RimMindAPI.MainThreadSnapshot.GetAsync 主线程快照 + 结构失败自动停用） → RimChatApiShim.cs
RimChat 启用检测 Source/Detection/RimChatDetector.cs（6000-tick TTL 缓存 + 跨存档/回退 tick 自动刷新 + InvalidateCache）
设置值与存档 Source/Settings/BridgeRimChatSettings.cs

门控规则

  • Chitchat、Auto、PlayerInput 独立开关；玩家菜单与 PlayerInput 共用条件。
  • 玩家输入：enablePlayerInputGate && skipPlayerDialogue && !forceRimMindPlayerDialogue。
  • 动作：enableActionGate 关闭或 forceRimMindActions 开启时不阻止。
  • 外交分类：adjust_faction、trigger_incident；社交分类： romance_attempt、romance_breakup；招募分类：recruit_agree。
  • Storyteller 事件是独立门控：enableActionGate && skipTriggerIncident 后检查共享冷却； 不受 forceRimMindActions 影响。
  • RimChat 未激活时不阻止上述行为。

状态与兼容边界

  • ModSettings 只保存用户设置；新增设置需同步字段、ExposeData、ApplyDefaults、UI、翻译。
  • 上次事件 tick 是 GameComponent_BridgeRimChat 的实例字段。 SharedIncidentCooldown 只定位 Current.Game 的组件，不持有跨游戏状态。
  • 存档键保留 RimMind_BridgeRimChat_LastIncidentTick；组件由 Verse 发现 (Game game) 构造。
  • 新游戏不继承旧游戏冷却；无游戏时冷却不生效。新增 per-game 状态必须由游戏组件拥有。
  • RimChatDetector.IsRimChatActive 采用 6000-tick TTL 缓存（CacheIntervalTicks = 6000），当游戏 tick 回退（读档/新局 now < _cacheTick）或超过 6000 tick 时重新探测 ModsConfig.IsActive("yancy.rimchat")，支持 InvalidateCache() 强制失效。
  • 对 RimChat 的反射统一走 RimChatApiShim，异常隔离；类型延迟解析并保留 NoInlining，属性与字段元数据通过 GetCachedProperty / GetCachedField（ConcurrentDictionary）缓存，缺失成员通过 WarnOnce（_warnedMissingMembers）去重告警，manager 获取复用 TryGetManagerInstance。
  • 所有扩展和 Context Provider 的 owner 为 RimMindBridgeRimChat，不要混用带点号名称。
  • 设置变化由已注册委托实时读取，不重复注册 SkipCheck。

Context Provider

通过 RimMindAPI.Context.ContextKeys.Register(new ContextProviderDef(...)) 注册：

Key 来源 开关
rimchat_diplomacy 外交会话，world-level pullDiplomacyHistory
rimchat_rpg_history Pawn RPG 历史 pullRpgHistory
  • 主线程快照与结构熔断：rimchat_diplomacy 与 rimchat_rpg_history 均通过 RimMindAPI.MainThreadSnapshot.GetAsync 将 Verse/RimChat 状态读取封送到主线程执行，后台线程绝不直接访问 Verse 或 RimChat 集合；反射读取统一复用 RimChatApiShim.GetCachedField，一旦发现必需字段缺失，由 RimChatApiShim 触发单次告警（warn-once）并将 _diplomacyDisabled / _rpgDisabled 置位停用对应拉取（Register() / Unregister() 时重置）。
  • Pawn 存活校验：Pawn 解析复用 TryFindPawnById（委托 RimMindPawnLookup.FindPawnByNumber + RimMindPawnLookup.IsActiveSpawnedColonist），禁止无界扫描 WorldPawns.AllPawnsAlive。
  • Context、门控与事件通知均经过 Core 公共边界。

验证

从仓库根目录运行：

dotnet test RimMind-Bridge-RimChat/Tests/RimMindBridgeRimChat.Tests.csproj -c Release
dotnet build RimMind-Bridge-RimChat/Source/RimMindBridgeRimChat.csproj -c Release
  • Tests/Contracts/RimChatGateContracts.cs：门控、冷却边界、新游戏隔离和存档恢复。
  • Tests/Contracts/RimChatContextApiContracts.cs：Context 与反射边界。
  • Tests/Contracts/RimChatCompatibilityContracts.cs：设置和扩展兼容。
  • Tests/RimChatStubs.cs：仅替代 Verse/RimChat 等外部边界。

每 mod 全部项目累计少于 1000 个发现用例，每个参数化数据行计数。 游戏 E2E 资源阻塞时不运行、不宣称通过。

先询问

修改动作分类、冷却默认值（60000）、RimChat 类型名、新增 ContextPush 或新持久化字段前先确认。禁止对 RimChat 添加编译期引用。