[Bug] 控制台先古之民本地化问题

[GlitchedReme]

模块范围

Public API（公开 API）

严重程度

Minor（轻微）

发生了什么？

先古之民的表写错了

复现步骤

期望行为

No response

日志 / 堆栈

RitsuLib 版本

No response

运行环境

No response

[ritsukage-local-analyzer]

Warning

此分析由 AI 自动生成，仅供开发者参考，最终判断请以人工确认为准。如有疑问建议结合本地环境进一步复现确认。

摘要

反馈者报告控制台（dev console）中先古之民（Ancient）相关本地化内容出现问题，标题为「控制台先古之民本地化问题」，描述仅有「先古之民的表写错了」及一张截图。问题被标记为 area/api、severity/minor，影响面推测为 dev console 中 Ancient 条目的标题查找或显示异常。目前反馈信息严重不足——无期望行为、无复现步骤、无日志、无版本号、无运行环境——在补充这些要素前难以做出准确判断。建议先向反馈者收集缺失信息，同时代码侧可预检 Ancient 标题的本地化表查找路径。

重点结论

• 简单介绍：dev console 中与先古之民（Ancient）相关的本地化标题或选项表可能在显示上有误，反馈仅有一句概括性描述和一张图片，无法从文字确认具体错误表现。
• 可能原因（推测）：DevConsoleAutocompleteCandidateSources.DefaultTitleForAutocomplete 中对 EventModel（含其子类 AncientEventModel）统一使用 "events" 本地化表进行标题查找，而 Ancient 对话内容使用的是 "ancients" 本地化表（见 AncientDialogueLocalization）。若某些 Ancient 条目的标题仅存在于 "ancients" 表而非 "events" 表，控制台自动补全可能出现标题为空或显示异常。
• 可能解决方案：在 DefaultTitleForAutocomplete 中对 AncientEventModel 添加分支判断，优先或额外尝试从 "ancients" 表获取标题；或确认原版数据中 Ancient 标题的实际存储表并统一查找路径。
• 需要补充：期望行为说明、复现步骤、RitsuLib 版本、运行环境、以及截图内可见的具体错误文字内容。

展开详细分析、证据与验证

问题描述

期望行为

未提供（_No response_）。

实际行为

反馈者仅表示「先古之民的表写错了」，并附带一张截图。截图内容未能以文字读取，无法确认具体是标题缺失、错位、乱码还是其他显示异常。

复现步骤

未提供（仅 -）。

日志、附件与原文摘录

• 截图：反馈者提供了一张 GitHub 附件图片（dd92233b-7a65-48f4-a027-29201a104a3b），说明 先古之民的表写错了。无其他日志或文本附件。

详细分析依据

1. 控制台 Ancient 标题查找链路：

   • DevConsoleAutocompleteCandidateSources.EnumerateLocalizedModelTitles（line 88–89）对 ModelDb.AllAncients 遍历调用 DefaultTitleForAutocomplete。
   • DefaultTitleForAutocomplete（line 139–158）为 EventModel 类型构造 LocString("events", entry + ".title")。由于 AncientEventModel 继承自 EventModel（见 DevConsoleAncientChoiceAutocompleteCatalog line 71 中 as AncientEventModel 的向下转型），该 switch 分支会命中 EventModel。
   • 但 AncientDialogueLocalization（line 16）将 Ancient 对话表名定义为 "ancients"。若某些 Ancient 的标题仅在 "ancients" 表中而 "events" 表中不存在，则控制台标题将为空，可能表现为不显示或显示原始 Entry ID。

2. Ancient 选项补全的查找路径：

   • DevConsoleAncientChoiceAutocompleteCatalog.TryGetDisplayTitle（line 14–21）通过 option.Title.GetFormattedText() 获取选项标题，不涉及直接的表名查找，该路径应不受上述表名问题影响。

3. 不确定因素：

   • 原版 STS2 中 Ancient 的标题（title）可能同时存在于 "events" 和 "ancients" 表中，因此对原版条目可能无影响；但 mod 添加的 Ancient 可能只在 "ancients" 表中有标题。
   • 若无截图具体内容，无法确认问题是否出自标题查找、对话表本身数据错误、或控制台的其他显示逻辑。

反馈规范性提醒

维度	状态	备注
期望/实际	缺失	仅有「表写错了」，无期望行为说明
复现步骤	缺失	仅填 -
环境与版本	缺失	RitsuLib 版本、运行环境均为 _No response_
日志/附件	部分	有截图但无可读文本日志
标题与背景	含糊	标题未说明「表」的具体含义（本地化表？UI 表格？console 输出？）

详细验证建议

• 在对应游戏版本中打开 dev console，输入 ancient 命令并观察自动补全列表中 Ancient 条目的标题是否正确显示（非空、非原始 Entry ID）。
• 对比原版 Ancient（如 THE_ARCHITECT）和 mod Ancient 的标题显示是否一致。
• 在 DefaultTitleForAutocomplete 中为 AncientEventModel 添加显式分支，尝试从 "ancients" 表获取标题作为回退或优先路径。
• 检查 ModelDb.AllAncients 中各条目的标题实际存在于 "events" 表还是 "ancients" 表。
• 向反馈者请求截图内容文字转述，确认具体错误表现。

风险与未决

• 截图不可读，无法确认问题是否确实与标题表名有关，也可能是指控制台输出的选项表（choice table）内容/格式有误。
• 缺少复现步骤和版本信息，可能为特定游戏版本或特定 mod 环境下的局部问题。
• 若确认为 "events" vs "ancients" 表名不匹配，修复需确保不影响原版 Ancient 的现有标题解析行为。

---

English translation

Summary

The reporter describes a localization issue with Ancient (先古之民) entries in the dev console, titled "[Bug] Console Ancient People localization issue." The body states only "The Ancients table is written wrong" with a screenshot. Labeled area/api and severity/minor, the issue likely involves incorrect title lookup or display for Ancient entries in the dev console. The report is critically lacking expected behavior, repro steps, logs, version, and environment info — making accurate diagnosis impossible until these are supplemented. Meanwhile, a code-side check of the Ancient title localization table lookup path is warranted.

Key Takeaways

• What's happening: Dev console autocomplete or display for Ancient entries appears to show incorrect or missing localization data. The report offers only a one-line summary and a screenshot with no text-accessible details.
• Likely cause (speculative): DevConsoleAutocompleteCandidateSources.DefaultTitleForAutocomplete resolves all EventModel instances (including subclass AncientEventModel) to the "events" localization table for titles, whereas Ancient dialogue data uses the "ancients" table per AncientDialogueLocalization. If certain Ancient entries have titles only in "ancients" and not in "events", the title lookup would return empty.
• Suggested action: Add an explicit AncientEventModel branch in DefaultTitleForAutocomplete to resolve titles from "ancients" as a fallback or priority; verify against vanilla data to confirm which table actually stores Ancient titles.
• Missing information: Expected behavior, repro steps, RitsuLib version, runtime environment, and a text description of what the screenshot shows.

Expand detailed analysis, evidence, and verification

Problem Description

Expected Behavior

Not provided (_No response_).

Actual Behavior

The reporter states only "The Ancients table is written wrong" with a screenshot attached. The screenshot content cannot be read as text; the exact error (missing title, wrong text, garbled characters, or other display anomaly) is unclear.

Reproduction Steps

Not provided (only -).

Logs, Attachments, and Excerpts

• Screenshot: A GitHub attachment (dd92233b-7a65-48f4-a027-29201a104a3b) showing what is described as "The Ancients table is written wrong." No log text or other attachments provided.

Detailed Analysis

1. Console Ancient title lookup chain:

   • DevConsoleAutocompleteCandidateSources.EnumerateLocalizedModelTitles (line 88–89) iterates ModelDb.AllAncients and calls DefaultTitleForAutocomplete for each.
   • DefaultTitleForAutocomplete (line 139–158) constructs LocString("events", entry + ".title") for EventModel type matches. Since AncientEventModel inherits from EventModel (confirmed by the as AncientEventModel downcast at DevConsoleAncientChoiceAutocompleteCatalog line 71), this switch branch matches.
   • However, AncientDialogueLocalization (line 16) defines the Ancient dialogue table as "ancients". If some Ancient titles exist only in "ancients" and not in "events", the console title will be empty, potentially displaying the raw Entry ID or nothing.

2. Ancient choice autocomplete path:

   • DevConsoleAncientChoiceAutocompleteCatalog.TryGetDisplayTitle (line 14–21) retrieves option titles via option.Title.GetFormattedText(), not directly through a table name lookup, so this path is unlikely affected by the table name mismatch.

3. Uncertainties:

   • Vanilla STS2 may store Ancient titles in both "events" and "ancients" tables, so vanilla entries would be unaffected; only mod-added Ancients with titles in "ancients" alone would show the problem.
   • Without the screenshot content, it is not possible to confirm whether the issue is a title lookup problem, incorrect dialogue table data, or another console display logic issue.

Report Hygiene

Dimension	Status	Notes
Expected/Actual	Missing	Only "table is written wrong" with no expected behavior
Repro Steps	Missing	Only - provided
Environment & Version	Missing	RitsuLib version and runtime environment both _No response_
Logs/Attachments	Partial	Screenshot present but no readable text logs
Title & Background	Vague	Title does not clarify what "table" refers to (localization table? UI table? console output?)

Verification Checklist

• Open the dev console in the relevant game version, type ancient , and observe whether Ancient entry titles in autocomplete appear correctly (non-empty, not raw Entry IDs).
• Compare title display between vanilla Ancients (e.g., THE_ARCHITECT) and mod Ancients.
• Add an explicit AncientEventModel branch in DefaultTitleForAutocomplete to try "ancients" table for titles as a fallback or priority path.
• Check whether ModelDb.AllAncients entries have their titles in the "events" table or the "ancients" table.
• Request a text transcription of the screenshot content from the reporter.

Risks and Open Questions

• The screenshot is not text-readable; the problem may not be a title table name mismatch at all but instead a formatting/content issue with the displayed choice table.
• Without repro steps and version info, this could be a localized issue specific to a particular game version or mod environment.
• If confirmed as an "events" vs "ancients" table name mismatch, the fix must not break existing title resolution for vanilla Ancient entries.

---

工具侧记录

• BAKAOLC/STS2-RitsuLib#47 · 退出码 0 · 进程 170.50s
• deepseek-v4-pro · API 169997ms · 21 轮 · ↓44568 ↑7399 · 缓存读427520 写0 · $0.6216
• MCP available: management tools exposed to Claude.

[BAKAOLC]

/r set wip

[BAKAOLC]

/r set confirmed
/r close completed