主题
MOD-01 内容数据、配置与版本：产品与进度
最后更新：2026-09-30
模块状态：🟤 架构设计中
产品方案状态：已批准
批准记录：2026-09-30，用户确认整章产品方案并继续进入架构设计
前置依赖：总体设计、PRE-01规则与内容、PRE-02交互、PRE-03视听与资源生产基线均已批准
当前交付：产品方案已批准；整章架构设计待批准，全部功能仍待开发
下一步：整体评审MOD-01架构设计，架构批准后才能编码
目标与交付边界
玩家应得到名称、数值、技能说明与实际内容一致的对局；制作人员应能定位每一条内容、发现缺项和错误，并明确知道某次内容更新影响什么。一次对局从开始到恢复都使用同一套内容，不能因为后来改了某名武将而中途变更其规则。
本模块交付可使用的内容整理、检查、预览和本地内容包管理工具，以及供后续游戏模块使用的内容版本。产品设计只确定行为、信息、边界与验收，不决定文件格式、数据库、协议、引擎、界面框架或运行时目录；这些由后续架构设计确定。当前没有游戏编码或正式资源生产。
权威来源为总体设计、PRE-01、PRE-02和PRE-03。冻结参考快照为2026年9月1日，后续外部补丁不会自动改变项目内容。本章不重新命名三国人物、不改数值或候选规则，也不复制参考游戏的数据文件、代码或资产。
首阶段交付
| 使用者 | 本模块提供的结果 | 边界 |
|---|---|---|
| 内容负责人 | 浏览与编辑获批内容，检查身份、形态、数值、来源及影响范围，形成有版本的内容包 | 不在工具中直接批准新玩法或修改已批准规则 |
| 美术与本地化负责人 | 按内容身份绑定图像、文字、表现和来源凭据，区分评审图、临时资源与正式资源 | 不在本模块绘制全量人物，也不将低清评审整图直接当成正式界面 |
| 后续游戏模块 | 获取完整、可追溯且与能力版本兼容的指定内容包，收到明确的不可用原因 | 规则执行由MOD-02等承接；对局与恢复由MOD-04等承接 |
| 玩家 | 正确的内容说明和一致的对局版本；缺少所需内容时得到可理解的提示 | 玩家不接触内容编辑器，不显示参考号、校验路径或内部包处理术语 |
仅提供本地制作与本地包管理，不在本章建立多人协同后台、登录权限平台、云发布、下载器、灰度、支付或运营审批系统。MOD-03负责启动与更新界面，MOD-04负责对局状态和保存恢复，MOD-10负责在线版本协商，MOD-18负责发行与线上发布。这里的“发布内容包”表示形成不可改写的本地候选版本，不等于对外发行游戏。
内容身份与全量覆盖
稳定身份
每项内容有独立的项目稳定ID，参考号仅作审计定位，不能充当项目运行时ID。ID不取决于中文名、势力、数值、文件位置或列表顺序。改名、改说明、换资源或获批调参时保留内容身份，并形成新内容版本；复制条目创建新身份，不能覆盖原项。已经发布过的ID不得回收复用，停用后仍可追溯。
身份与形态分别记录。普通武将与神将各有明确的内容项与对应关系，共享人物身份；不能只靠名称或数值翻倍推断神将效果。主公与其主公技分开，替换后的主公技独立关联。初阶与高阶神兵、来源不同的同名模板、召集物和动态生成定义不能因名字相同而合并。
内容定义与对局中的对象实例分开：某局召集的两名同名武将引用同一内容定义，但拥有各自的当前属性和状态；实例编号和状态归MOD-04，不由内容表预先创建。来源定义型输出记录生成者、合法来源与已核参数，不凭模板造一个固定成品。
覆盖口径
以下是基线覆盖要求，新增或变更必须有获批来源；记录数量不是全部能在普通招贤台出现的数量。
| 内容类别 | 当前覆盖要求 | 必须区分 |
|---|---|---|
| 主公与主公技 | 116名主公及116个起始主公技，变化主公技按衍生条目关联 | 常规护甲、费用、被动／主动、候选条件与生成来源 |
| 标准武将身份 | 247项：246可用、1禁用；普通与神将关系逐项保留 | 池内／池外、品阶、实际势力、基础属性与形态效果 |
| 锦囊 | 72项 | 品阶、费用、目标、消耗、池与来源限制 |
| 神兵 | 234项：初阶112、高阶122 | 档位、费用、条件、替换与关联形态 |
| 天意 | 43项 | 强度档、绑定对象、入口、次数与禁配 |
| 衍生设计 | 583项已定位设计及3项来源定义型输出 | 180项确定路径、403项条件候选路径；1169条直接来源边保留事实状态 |
内容覆盖率的分母是PRE-01当前获批工作集。工具分别展示“已建档覆盖”“规则已核”“能力已支持”“资源已齐”“可纳入对局包”，不能用一个完成率把这些状态合并。已建档覆盖必须达到100%；禁用项保留记录但不进入可投放清单，条件候选不自动算作可用。
主公、武将、锦囊、神兵、天意、衍生关系与排除项逐条对应PRE-01原条目。工具允许按项目全名、稳定ID、参考号、类别、形态、实际势力、来源与缺口筛选；同名项同时显示类别、形态和来源，以免编辑错对象。十势力、无势力、全势力和多实际势力按原定义表达，“兵职”只作说明与检索，不新增组合加成。
每条内容需要的信息
| 信息组 | 内容人员必须看见并能核对的内容 |
|---|---|
| 身份与出处 | 项目稳定ID、中文全名、类别、所属人物或身份、参考定位、PRE-01条目与批准依据 |
| 玩法与形态 | 品阶、实际势力、基础数值、费用、普通／神将或初／高阶关联、初始主公技与变化关系；不适用字段说明原因 |
| 生成与可用性 | 所在池或来源、已知出现条件、禁用状态、直接生成边与条件、不确定事项及主责MOD |
| 能力需求 | 已批准的触发、条件、目标、效果、状态、持续与叠加、表现需求；引用的能力声明和验收情况 |
| 说明与资源 | 各阅读位置的中文名称与效果、关键词解释、人物及形态图、图标、表现与音频关联、复用来源、资源质量与权利来源 |
| 版本与变化 | 所属内容版本、变更原因、变更前后差异、受影响引用、检查结果与处理人 |
未知数值、概率、候选资格或来源绑定必须明确标为待核，并指向PRE-01原问题与主责MOD；不得填0、空字符串、默认权重或临时猜值来通过检查。明确的0、无效果、无候选与不适用各有独立含义，不能代替未知。
资源与本地化关联
每条内容按稳定身份和形态关联资源与文字，不按文件名猜角色。下面的关联要求适用于覆盖表中的每一个条目；具体源文件与资源标识由本模块实际建档时登记，不能在产品设计阶段把尚未制作的文件记作已经存在。
| 内容与使用位置 | 必须关联的文字与资源 | 允许复用与验收 |
|---|---|---|
| 主公选择、局内主公、左侧名单、最终结果 | 同一主公全名、肖像与头像裁切、生命／护甲标识；绑定正确主公技 | 共用人物主体；名单头像和姓名必须同一人，己方主公不挂势力徽记 |
| 主公技 | 名称、完整效果、费用或被动说明、图标、动态提示所需文字与表现 | 起始与变化技能分别关联；不借用其他技能说明冒充 |
| 普通武将与神将、召集物 | 人物主体、手牌与详情、战斗单位形态、形态标识、全名、势力、攻血、关键词及效果 | 同一身份可复用主体，神将边框与效果独立；完整卡面不充当战场棋子 |
| 锦囊、神兵、天意及其他可选择内容 | 主体图、类别／档位标识、费用、完整名称与效果、来源与剩余次数所需文字 | 初／高阶可复用主体但保留差异；候选板与详情引用同一内容定义 |
| 动态生成、变形与来源定义型输出 | 已核生成关系、基础资源、来源与当前形态说明、合法组合的表现需求 | 不能给未知动态成品硬绑定一个无依据的固定人物或数值 |
| 通用界面与反馈 | 字体、面板、按钮、资源数字、关键词解释、错误与恢复文案、共享音效及静态替代表现 | 通用资源一次登记、多项引用；各承接MOD制作验收，不逐角色重复复制 |
例如刘备主公引用刘备人物主体与其头像裁切，主公技引用“以德励士”的独立名称、图标和说明；法术或武将不能因为也有绿色图标就复用其技能身份。麴义普通／神将各自引用对应属性和效果，可共享人物主体；出现同名模板时以PRE-01明确来源分开。以上只是关联示例，不生成新的玩法或资源编号。
资源明确区分评审参考、临时可用与正式验收三类用途。PRE-03的26张A评审图只作设计参考，C只作对照；整张效果图不允许绑定成正式棋盘按钮、人物资源或规则文本。临时资源可以支持已批准的灰盒目标，但必须可读、身份正确、无缺失；不能用临时标记绕过规则或能力缺口。正式资源按PRE-03规格验收，文字与数值为可编辑文本，不从位图裁切。
每个资源记录作者或提供方、来源、使用许可依据、可用范围、制作与验收状态；没有项目所需使用权的资源不能进入交付包。共享资源替换前显示所有受影响条目，错误绑定不得只改当前预览而遗留其他引用。
首阶段中文必须完整。显示名称、效果和关键词解释要与同版本内容一致；技能数值不能在美术图和说明里各维护一份互相冲突的值。涉及数值或条件的说明由MOD-02定义其生成与校核规则，本模块负责关联和阻断缺失、过期说明；不能靠关键词自动改写未知技能。尚未开放的其他语言不计入当前完成要求，新增语言需独立检查，不用另一语言悄悄覆盖缺失中文。
编辑、检查与预览流程
制作人员依次选择工作集、定位条目、修改草稿、查看影响、运行检查、核对差异，再生成指定用途的包。工具必须提供以下五个可直接到达的工作视图；它们是内容制作界面，不是新增游戏内页面。
| 工作视图 | 需要看见的信息 | 操作结果与失败处理 |
|---|---|---|
| 内容目录 | 版本、覆盖分项、筛选结果、全名、类别、形态、可用性及缺口 | 打开唯一条目；零结果正常显示，不删除未显示内容 |
| 条目详情 | 当前值、批准来源、形态／生成关联、能力、文字、资源及依赖 | 保存草稿并标明未发布；非法值保留编辑内容并定位错误，不覆盖有效版本 |
| 引用与差异 | 谁引用本项、本项引用谁、前后值、资源与文字差异、停用影响 | 修改共享项和停用项前可检查完整影响；未保存离开需选择保存、放弃或继续编辑 |
| 检查与预览 | 错误、警告、所属条目、来源、修正入口；同内容在头像、手牌、详情与棋子中的表达 | 点击错误定位问题；预览标明内容版本与资源用途，不用图片证明规则执行已通过 |
| 内容包管理 | 包用途、基线、版本、依赖、检查结果、变化摘要和当前新局选用版本 | 生成、查看、选用或回退；失败保留原选用版本，不能显示成功 |
修改草稿不影响已发布内容包。批量编辑必须先展示涉及条目和前后差异，再确认应用；任一必需校验失败时，不把半批修改当成已发布版本。导入缺项、重复项或身份冲突时提供逐项报告，不按同名自动覆盖。
预览至少支持PRE-03要求的主公、普通／神将、锦囊、初／高阶神兵、天意与动态来源样例，检查不同使用位置、三档文字、势力色及静态替代资源。没有规则执行能力时只提供资料和静态表现预览，明确“未进行对局验证”；真实技能执行预览接入MOD-02及对应玩法模块后验收。
阻断与提示
| 发现的问题 | 必须采取的处理 |
|---|---|
| 缺失身份、重复稳定ID、错误普通／神将对应、失效引用 | 阻断生成交付内容包，列出全部可定位的问题 |
| 规则、数值或名称偏离批准来源 | 阻断；先修复数据，确需修改产品时回到原主责设计审批 |
| 未核字段、条件候选尚未闭合、完整范围不明 | 允许保存资料草稿；阻断受影响内容纳入可用对局包，不猜默认值 |
| 能力不存在、版本不兼容或尚未验收 | 阻断可用对局包；列出所需能力与主责模块，不生成替代脚本 |
| 缺中文、过期说明、缺必需资源、身份绑定错误、许可不足 | 阻断对应交付用途；明确条目与使用位置，不能以空白卡面顶替 |
| 使用临时资源但身份和可读性合格 | 内部联调用途明确提示；正式资源交付用途阻断，直到对应MOD验收 |
| 未使用的合法资源、可选角色配音未提供 | 提示整理或说明不适用，不阻断首阶段；不能因此跳过必需反馈音与文字 |
重复检查同一未变更内容应得到同一问题清单与包内容判定，不能由当前列表筛选、编辑顺序或警告确认按钮改变结果。检查失败后可继续编辑，旧有效包保留。
能力支持与规则缺口
仅引用已有且已验收能力的新内容，只能修改内容数据、美术资源、本地化和内容测试；不得要求修改客户端、服务端、协议或数据库结构。出现新触发、目标、状态、效果或表现能力时，工具明确报告“需要新机制”，由对应MOD先完成产品、架构、实现和验收，再允许内容引用。
禁止任意脚本、运行时插件、武将ID特判、递归和无边界循环。生成关系可以描述真实玩法中的再次召集或复制，但不能由内容工具递归展开成无限条目；运行效果的执行次数和终止规则必须由主责机制模块闭合。
MOD-01管理能力需求及支持声明的关联，MOD-02及各玩法模块对能力语义、参数范围和验收结论负责。尚未实现的能力可登记为需求，不得标为已支持。MOD-01的工具验收可以用明确标注的测试专用能力声明验证拒绝与兼容行为，但不能将测试声明放进玩家对局包或宣称真实技能已实现。这样可以先完成内容工具，不倒置MOD-01与MOD-02的依赖关系。
PRE-01的15类待核事实仍由原主责MOD闭合，本模块不改“待核”为“已核”。其中“同名模板与动态生成”由MOD-02主责、MOD-01协同：本模块提供来源区分、动态定义、版本差异和缺口报告；鲜果／硕果、卫星、楼车、王济输出及其他动态数值的精确绑定仍由主责模块提供证据。PRE-02五项规则依赖同样保留；恢复资格和历史战阵迁移不由内容工具自行决定。
本模块产品批准需要闭合的是内容身份、资料状态、关联与发布门禁的处理规则；不要求先替MOD-02、MOD-05完成全部玩法核查。可用对局包必须满足所含全部合法可达内容的规则与能力门禁。未知项不能静默删除、改成不可达或缩小牌池来拼出“完整对局包”。
内容包、版本锁定与回退
内容包用途
| 用途 | 可包含的内容 | 使用边界 |
|---|---|---|
| 资料检查 | 全量已建档资料、禁用项和明确待核信息 | 用于编辑、审阅、差异与覆盖检查，不能启动玩家对局 |
| 内部联调 | 明确选择的已核内容和已支持能力，可用合格临时资源 | 包内标明范围与缺口，仅验证指定场景；不得宣称完整首阶段内容已交付 |
| 可用对局 | 当前批准模式的完整合法可达内容及兼容能力；资源用途满足该次获批交付目标 | 无未核必需字段、无未支持能力、无缺失必需资源；灰盒目标与正式资源交付分别验收 |
生成内容包前展示用途、工作集版本、模式、内容与资源范围、能力依赖、检查结论和变化摘要。已发布包不可原地改写；任何影响内容、文字、资源或依赖的变更都形成可区分的新版本，并能查看相对于来源版本的差异。同一版本标识不能对应两套不同内容。
内容包包含或明确绑定本次使用的全部内容、说明、必需资源与兼容能力要求。生成中断或检查失败不改变“当前供新局使用的版本”，临时产物不能被误选为成功发布包。选用前验证整体完整性和兼容性，不能把新版规则、旧版文字、其他版本资源拼在一起。
对局锁定
新局开始时固定内容版本。已经开始的对局继续使用原版本，包括主公、技能、牌池、说明、资源和合法生成内容；发布新包、改草稿或改变新局默认版本均不得改写原对局。重连、保存恢复与回放需要原版本时，也必须使用该版本；实际对局锁定、状态和恢复行为由MOD-04及对应模块实现。
所需旧版本缺失、损坏或与当前程序不兼容时，内容模块返回明确原因，游戏沿PRE-02恢复失败流程提示并保留原局，不换版本继续、不重抽内容、不自动认输或新开一局覆盖。MOD-01负责指定版本可获得性与兼容判断，MOD-03负责玩家提示，MOD-04负责原局保护和恢复。
跨局历史战阵可能引用已移除内容，不能当作普通池过滤掉；引用版本、身份记录与迁移依据必须保留。继承哪些属性、旧内容是否可运行及迁移失败分支，按PRE-01“跨局历史战阵”由MOD-05协同MOD-04闭合；没有明确结论时拒绝相关可用包，不静默换成新武将。
回退与清理
回退是将后续新局选用版本切换到一个已检查且兼容的旧包，不修改或删除当前对局内容，也不让旧包覆盖保存中的新规则对象。回退前展示目标版本、主要差异、兼容检查和被影响的新局入口；确认后只改变新局选用版本。失败时保持原选用版本，并给出修正入口。
旧包只要仍被未结束对局、保留的保存记录、历史战阵或回放引用，就不能清理。引用情况由对应模块提供；无法确认是否仍被使用时不允许删除。明确不再被使用的包可以由制作人员查看影响后清理，但发布记录、稳定身份及变更依据仍保留。保存迁移、规则兼容和对外撤回不是一次“回退”按钮可以自动解决的事项。
实施顺序、责任与依赖
下面是本模块产品交付顺序；具体架构工作项和文件职责见本模块架构设计，当前不创建测试或缺陷文档。
| 顺序 | 主责 | 交付结果 | 前置与验收 |
|---|---|---|---|
| 1 | 模块负责人、内容负责人 | 身份、形态、来源、资料状态与包用途方案 | 本章产品获批；能够解释全量工作集、禁用和待核差异 |
| 2 | 后台／内容工具负责人 | 内容建档、编辑、引用检查与差异查看能力 | 架构获批后实现；全量已建档覆盖100%，重复、缺失和误合并被阻断 |
| 3 | 美术与本地化负责人 | 逐条资源、文字与来源关联；临时／正式用途判定 | 采用PRE-03 A方向；主体制作由承接MOD完成，本模块不伪报画质验收 |
| 4 | 后台／内容工具负责人 | 能力门禁、包检查、生成与版本记录 | 使用能力提供方声明，未知或未验收能力不能进入可用对局包 |
| 5 | 客户端负责人 | 内容阅读与静态预览、指定版本可用性反馈 | 与工具共用同版本内容；玩家失败文案与恢复页面沿PRE-02 |
| 6 | 后台与客户端负责人分别承担自身交付 | 新局版本选用、旧包保护和回退边界 | 各自完成对应能力；与MOD-03、MOD-04集成时验证原局不变 |
| 7 | 模块负责人 | 工具可用性与内容关联验收、对后续MOD交接 | 本模块工具结果可验收；完整对局及实际新武将无代码变更的最终证明在对应模块集成后验收 |
本地内容工具的“后台负责人”表示内容处理职责，不意味着首阶段增加在线服务。全量玩法能力和正式美术尚未交付时，工具可以完成建档、校验和版本管理验收；进度不得写成全部内容已可玩或全部正式资源通过。
验收标准与主要风险
以下是实现后的必要验收要求，不是已经执行或通过的测试记录。
| 验收场景 | 通过标准 |
|---|---|
| 基线全量建档 | 覆盖表逐项可定位，246可用／1禁用、条件路径与来源定义型输出未被混淆，缺项能定位原条目 |
| 改名、调参、复制、停用 | 原身份不因改名或获批调参而变化；复制产生新身份；停用不能复用ID或破坏旧包 |
| 同名与多形态 | 同名不同来源不误合并，普通／神将与初／高阶可分别核对，动态输出不被硬编码成模板数值 |
| 缺值与未知 | 明确0、不适用和待核区分；未核权重或资格不能通过填默认值发布 |
| 已有与新增机制 | 真实支持声明允许合法组装；未支持能力被阻断且列出主责；测试专用声明不能进入玩家对局包 |
| 内容、文字与资源一致 | 全名、形态、势力、技能说明和人物对应；失效引用、错图、错字、过期效果与许可缺失阻断交付 |
| 资料与联调范围 | 资料检查包不能开局；联调包明确自身范围，不能静默裁去未知内容后冒充完整包 |
| 包生成与选用失败 | 检查失败、中断或不兼容不改变当前有效版本，不出现半包可用或虚构成功 |
| 进行中对局遇到更新 | 新局可选新包，原局规则、文字和资源仍来自原包；恢复不得替换版本 |
| 旧包回退与清理 | 回退只影响后续新局；仍被引用或引用不明的旧包不能删除；失败保留原选择 |
| 静态预览与实际规则 | 静态预览明确未验证战斗；接入真实能力后说明与执行一致，不能用预览图片冒充技能验收 |
主要风险是资料完整被误当作可玩、未核字段被默认值掩盖、资源画质低但被标为正式，以及旧内容被更新覆盖。分别通过分项覆盖统计、阻断规则、资源用途与承接验收、不可改写包和对局版本锁定控制。不得用缩小首阶段内容范围或复制旧项目实现来解决。
功能进度
本表记录MOD-01实际功能实现进度。产品方案已批准，架构设计待批准，全部功能待开发，无编码或测试通过结论。
| 功能ID | 功能名称 | 状态 | 验收依据 |
|---|---|---|---|
| MOD-01-F001 | 稳定身份与全量内容建档 | ⚪ 待开发 | 全量覆盖、身份不复用、形态与来源可定位 |
| MOD-01-F002 | 内容编辑、引用与变更差异 | ⚪ 待开发 | 草稿不影响发布包，批量修改与依赖影响可检查 |
| MOD-01-F003 | 资源、本地化与权利来源关联 | ⚪ 待开发 | 逐项正确绑定，用途区分，缺失与过期阻断 |
| MOD-01-F004 | 规则缺口与能力支持校验 | ⚪ 待开发 | 未核、未支持、新机制和测试声明不能绕过门禁 |
| MOD-01-F005 | 内容与静态表现预览 | ⚪ 待开发 | 同版本多位置阅读，预览不冒充真实规则验收 |
| MOD-01-F006 | 内容包生成与版本记录 | ⚪ 待开发 | 用途区分、完整性检查、发布后不可改写 |
| MOD-01-F007 | 指定版本使用与原局保护 | ⚪ 待开发 | 开始后版本固定，缺失或不兼容不替换原局 |
| MOD-01-F008 | 新局版本回退与旧包清理 | ⚪ 待开发 | 只切换后续新局，引用中的旧版本受保护 |
本章产品方案已批准，当前等待MOD-01整章架构评审；不启动其他MOD，不把设计文档完成写成游戏功能已经实现。