DM 在这个项目中能做到什么
DM 可以把战役资料维护成结构化网页：wiki 负责长期设定，时间线负责事件脉络，任务板负责当前目标，资产和商店负责资源流动，日志负责每场团的事实沉淀，各方势力负责公开人物档案。
网页端编辑的重点不是实时主持，而是“整理”和“公开”。你可以先写 DM 私密草稿，确认公开边界后再发布；也可以在跑后把本场发生的事实、战利品、费用和下一步一次性写入日志。
现在 DM 能直接修改什么
DM 登录后，侧栏会出现 DM 控制台。当前已经做成网页编辑界面的内容，基本可以直接在浏览器里维护；保存后会写入服务端状态或内容文件，其中 wiki、图片、各方势力等重要内容会按各自规则同步到仓库。
最适合网页端修改的是“玩家会反复查看、且需要保持最新”的资料：词条、任务、日志、资产、商店、日历、人物档案、揭示状态和剧情展示素材。
- 内容草稿：新建或修订 wiki 词条，编辑标题、摘要、分类、正文段落、条目列表、图片、关联词条、标签和可见性；审核玩家投稿并发布为正式词条。
- 秘密揭露：开启或关闭 reveal flag，查看被 flag 锁住的词条与段落，为已有词条新增带 requiredFlag 的揭示段落。
- 跑后整理：新增或更新战役日志，记录本场摘要、战利品、费用、下一步、标签、玩家可见性，并可顺手推进日期和公开剧情 flag。
- 场次准备：维护跑前准备条目，包括标题、日期、状态、场景概要、相关词条、计划揭示、DM 备注和玩家可见摘要。
- 各方势力编辑：维护势力分组、成员、肖像、身份、定位、状态、公开摘要、轶事、关系和标签；当前公开页会读取这些数据展示英雄档案。
- 剧情模式：上传和选择背景、立绘，调整当前剧情画面；素材按战役与用途隔离。
- 任务、商店、资产、日历：维护任务状态、任务说明、商品与购买记录、队伍/个人仓库、物品请求处理、金库流水、当前日期和事件节点。
- AI 文件与 AI 设置：维护用于辅助草稿生成的资料来源，配置本账号的 AI 接口信息。
现在还不能直接修改什么
还有一些内容目前不是完整的网页编辑器，或者虽然能通过某个工作流间接改变，但不建议把它当成自由编辑入口。遇到这些需求时，最好先确认是否要单独开发功能，或临时由代码/文件层面处理。
判断标准很简单：如果页面没有明确的编辑表单、保存按钮或审核流程，就不要假设它已经支持稳定修改。
有表单、有保存、有审核或同步提示的地方，才是当前稳定的网页编辑能力。
- 不能在公开“各方势力”页面直接开编辑模式：目前编辑入口在 DM 控制台的“各方势力编辑”，公开页只负责展示和切换角色卡。
- 不能在网页端细改完整 DND 规则数据：各方势力的 heroSheet 已有展示字段，但还没有专门的高级角色卡编辑器，也不做武器、法术、投骰或 FVTT 导入。
- 不能让玩家直接发布正式 wiki：玩家只能投稿，DM 需要在内容草稿中审核、改写、批准和发布。
- 不能把所有媒体当成可随意删除：图片如果被正式词条、草稿、剧情模式或各方势力引用，删除会被保护；部分文件删除功能本来就没有开放。
- 不能在网页端修改底层战役列表、账号种子、权限模型、路由结构、构建配置或部署脚本；这些仍属于代码/运维层。
- 不能把 FVTT 的现场角色卡、地图、战斗和投骰同步当成现有功能；网页端只做档案、轻量管理和展示。
- 不能保证最近更新收录所有后台操作：图片上传、商品维护、仓库流水和 AI 临时文件通常不是玩家需要追踪的公开内容。
推荐工作流：从素材到公开档案
最稳定的顺序是：先写草稿，再定可见性，最后发布或揭示。不要把未检查的素材直接推给玩家。
- 收集素材：从桌边记录、聊天记录、个人笔记、玩家投稿或 AI 辅助输出中整理原始内容。
- 创建草稿：进入“DM 控制台 → 内容草稿”，新建词条或复制已有词条生成可编辑草稿。
- 设置可见性：为词条和段落选择公开、保密占位或隐藏；需要延后公开的内容设置 requiredFlag。
- 预览与批准：在发布前检查图片、摘要、关联词条、标签、隐藏段落和玩家视图。
- 发布：批准后发布到当前战役内容目录；公开内容会进入玩家可读 wiki，并可能出现在最近更新。
- 揭示：当剧情推进到合适时，进入“秘密揭露”打开对应 flag，或新增带 requiredFlag 的揭示段落。
- 跑后归档：用“跑后整理”写下本场事实、战利品、费用、下一步，必要时推进日期和揭示 flag。
内容草稿与 wiki 维护
内容草稿是 DM 维护 wiki 的主入口。它支持新建词条、基于已有词条生成修订草稿、预览、批准和发布。发布后的内容会进入对应战役的 content/campaigns 目录，成为正式档案。
写 wiki 时建议先保证“玩家能读懂”：标题明确，摘要说明它为什么重要，正文按段落组织，相关词条链接到人物、地点、势力和物品。复杂设定不必一次写完，可以先发布公开基础信息，再用隐藏段落保存未来揭示。
- 人物词条：写身份、外观、已知关系、当前立场和玩家已经见过的事件。
- 地点词条：写入口、氛围、势力归属、重要房间、已公开危险和相关事件。
- 物品词条：写外观、用途、来源、持有人和公开效果；机械细节可保留在 DM 隐藏段落。
- 势力词条：写目标、成员、公开关系、冲突和玩家已经知道的行动。
- 时间线素材：写事件时间、参与者、结果和关联词条，不要把未揭示因果写进玩家可见正文。
AI 辅助写作怎么用
AI 适合批量整理 wiki 草稿、补全摘要、统一语气、根据已有世界资料生成候选段落。它不适合自动决定设定真相，也不应该绕过 DM 审核直接发布。
如果要让 AI 帮忙写词条，先给它明确的事实来源和可见性要求。生成后重点检查四件事：是否编造事实、是否泄露秘密、是否把猜测写成定论、是否把人物语气写偏。
- 推荐用途：把跑后记录拆成 wiki 草稿、把玩家投稿整理成正式语气、批量补全摘要和标签、生成不同版本的公开描述。
- 不推荐用途：让 AI 决定剧情真相、自动生成未确认关系、替 DM 判断玩家是否应该知道某秘密。
- 玩家也可以使用 AI 辅助投稿，但 DM 应将其视为“待审核素材”，不是正式内容。
秘密揭露与可见性规则
本项目的可见性分为三层：已公开、保密占位、完全隐藏。已公开内容直接进入玩家视图；保密占位会让玩家知道这里存在秘密但看不到正文；完全隐藏则不会出现在玩家页面。
秘密揭露页面负责管理 reveal flag。你可以查看哪些 flag 已开启、哪些词条或段落被某个 flag 锁住，也可以创建一个带 requiredFlag 的新段落，让它在未来揭示时自动出现。
- 公开前先问：玩家是否已经在桌边接触到这条信息？
- 如果答案是“还没有，但知道有秘密会增加期待”，使用保密占位。
- 如果答案是“知道它存在都会剧透”，使用完全隐藏。
- 揭示 flag 命名应短而稳定，例如 chapter_2_gate_open，不要用临时中文长句。
- 打开 flag 后检查玩家视图，确认新内容可读、链接正确、没有误公开 DM 备注。
跑前准备、跑中使用、跑后整理
跑前使用“场次准备”记录本场标题、日期、场景概要、相关词条、计划揭示和玩家可见摘要。它不是复杂剧本管理器，只保留真正能减少临场负担的信息。
跑中不要求实时维护网页。FVTT 和桌边沟通优先，网页端最多用于查词条、展示剧情模式画面或确认任务与资产。跑后再集中整理，通常比边跑边写更可靠。
跑后进入“跑后整理”，写入本场摘要、战利品、费用、下一步和标签；同时更新仓库、任务状态、当前日期和需要公开的 reveal flag。这样一次整理就能反哺日志、任务、最近更新和玩家复习路径。
- 跑前：准备相关词条、计划揭示、关键 NPC、可能出现的物品和本场目标。
- 跑中：优先主持；必要时只查资料或展示剧情模式，不强迫自己实时录入。
- 跑后：整理事实、更新任务、登记战利品和费用、推进日期、打开已经公开的秘密。
任务、商店、资产和日历维护
这些模块负责团务信息，不必写成华丽 prose。玩家打开它们时最需要的是准确、当前、容易操作。任务板要清楚写状态、地点、委托人、报酬和下一步；商店要清楚价格、库存和购买记录；资产库要清楚物品归属、数量、来源和使用记录；日历要清楚当前日期和近期事件。
如果某项任务或资产含有秘密，可以把公开说明写得简短，把完整解释留在 DM 备注或隐藏 wiki 段落中。不要为了让页面好看而牺牲可读性。
- 任务板：更新 active、completed、archived 等状态，玩家不可见任务不应出现在公开更新里。
- 商店与金库：记录采购和资金变化，避免玩家反复问“现在还有多少钱”。
- 资产与仓库：队伍库存和个人仓库分开，物品请求适合让玩家提出使用或领取需求。
- 日历：用于锚定战役当前日期、未来事件和跑后推进。
各方势力与剧情模式
“各方势力编辑”用于维护公开人物档案。第一层是势力或队伍，第二层是成员。成员可以有肖像、身份、定位、轶事、关系和英雄角色卡字段。这个页面适合展示玩家角色和重要 NPC，不适合塞入所有路人。
剧情模式用于管理背景和立绘素材，并排布当前画面。它是叙事辅助，不是直播系统；DM 同步展示时会覆盖普通玩家当前战役页面，但不会替代 FVTT 的战斗或地图展示。
- 各方势力保存后会走网页编辑的 GitHub 同步链路。
- 人物肖像尽量复用已有 wiki 图片逻辑，避免重复上传同一张图。
- NPC 关系应写玩家已经可见的关系，不要把未来背叛、隐藏身份或 DM 计划写进公开关系栏。
- 剧情模式素材按战役和用途隔离，背景与立绘分开管理。
GitHub 同步与发布心态
网页端重要编辑会写入项目内容文件，并通过安全检查同步到 GitHub。同步机制会避免把无关变更、删除或危险路径一起推上去；如果工作树里存在不属于本次操作的改动，系统可能暂停并要求人工处理。
这意味着 DM 不需要手动复制网页内容到仓库，但也应理解：正式发布的内容会进入版本历史。发布前检查标题、可见性、图片和关联词条，比发布后再反复修补更省力。
- 正常网页编辑：内容写入当前战役目录，触发对应同步操作。
- 图片和媒体：会按用途保存，删除通常需要确认没有被词条、草稿或人物名册引用。
- 遇到同步暂停：先看提示中是否有无关文件或生产环境生成的媒体，不要直接清理未知文件。
- 部署前：如果是正式 release，按项目既定的 stage-disc/run-disc-tests 流程验证。