正在加载文档内容…
行程表
维护记录
记录教程版本、源码与网络依据、截图处理方式和验证范围。
发布于
本页供维护者核对事实，不是新手阅读的前置步骤。
rainbow-sv-modder 1.0.59。b27d74e7f52dc055e23fe58a0010b671ff29f329。8099dd01bc6d3696faffc553908805302abc91ec。用户提供的另一款软件截图仅用于说明红色箭头样式。本文所有产品操作截图来自实际运行的彩虹鸡。
产品源码根目录：D:\SourceCode\VsCode\rainbow-sv-modder。
| 内容 | 主要依据（相对产品根目录） |
|---|---|
| 首页、新建项目、导航及设置 | src/renderer/src 中的项目创建页面、App.tsx；src/main/project-service.ts、app-settings-service.ts |
| 图片格式与尺寸 | src/main/image-import-validation.ts |
| 默认/冬日/沙滩资源与自定义场景 | 人物模块 CharacterDetailPanel.tsx、外观预设及保存逻辑 |
| 对话的开始节点、手动保存、后续对话 | src/renderer/src/dialogues/DialogueModule.tsx、DialogueFlowInspector.tsx、DialogueFlowCanvas.tsx |
| 触发模板和生成 Key |
另外核对了 D:\SourceCode\Idea\rainbow-service 的权益查询逻辑，以及 D:\SourceCode\VS\SVDebugServer 中 CP 重载的前置要求。未操作账户、支付或线上数据。
游戏源码目录：D:\SourceCode\sv\sv de\Stardew Valley。
| 源文件 / 方法 | 用于校正的内容 |
|---|---|
Menus/DialogueBox.cs 肖像绘制 | 64 × 64 格子、索引越界后的普通表情回退 |
Dialogue.cs | 对话表情标记 |
AnimatedSprite.cs | 普通 NPC 四方向走路帧的排列 |
NPC.cs 的 tryToRetrieveDialogue | 日期、好感、星期与年份后缀；基础 key 不等于严格限第一年 |
NPC.cs 的外观选择逻辑 | 岛屿服装、季节与人物地点条件 |
NPC.cs 的行程选择与 parseMasterSchedule |
Content Patcher 源码目录：D:\SourceCode\sv\StardewMods\ContentPatcher。核对 Framework/Patches/LoadPatch.cs、EditDataPatch.cs 及 docs/author-guide 下的 Load、Include、排错文档。CP 负责补丁加载和数据修改；NPC 是否选中某个对话或行程 key，最终仍由游戏逻辑决定。
回答以项目实现、游戏源码、CP 官方资料为准。论坛和社区帖子只用于识别用户会问的问题，不作为游戏规则的唯一证据，也未据此声称做过提问频率统计。
| 来源 | 用途 |
|---|---|
| SMAPI 官网（在新窗口打开） | 安装入口 |
| CP 官方安装说明（在新窗口打开） | 安装 CP 内容包、使用 SMAPI 启动 |
| CP 作者指南（在新窗口打开） | 内容包结构 |
| CP Load 说明（在新窗口打开） | 整张加载资源时的冲突 |
已实际完成：
尚未完成的游戏验证：没有启动游戏实测台词触发、肖像替换或行程运行；也没有验证专业功能的付费账户体验。正文中“成功时应看到”的描述是读者的验收方法，不是已实测的结论。
示例仅包含一条对话，不附带游戏原始图片。肖像、行走图和行程章节是后续独立练习，不隐含它们已加入示例成品。
下面的路径均相对产品源码根目录。表中的“覆盖”表示有对应使用说明，不代表已完成所有字段或全部游戏版本的功能测试。
| 模块 | 已覆盖内容 | 章节 | 产品依据 |
|---|---|---|---|
| 人物 | 资料、喜好、关系、住所、婚后空间、新 NPC、条件外观、动画 | 03、04、09–11 | characters/CharacterDetailPanel.tsx、人物外观与动画编辑器、导出器 |
| 宠物 | 品种/独立类型、精灵表、图标、行为、领养与许可证 | 12–13 | src/renderer/src/pets/PetModule.tsx、src/shared/pets/pet-types.ts |
| 地图 | 导入及依赖、整图替换、覆盖模式、传送、互动、鱼池 | 14–18 | src/renderer/src/maps/MapModule.tsx、MapPreviewPane.tsx、warps、interactions |
补充核对了游戏 Event.cs 的已看事件记录及 AddQuest、Quests/Quest.cs 的任务解析、奖励与后续任务、Crop.cs 的生长阶段/再生/收获物，以及 Objects/Furniture.cs 的朝向和显示/占地字段。CP 补充阅读了官方 action-editmap.md、action-editdata.md；细节以本机对应版本和产品导出实现共同判断。
扩充时特别修正了这些边界：事件列表“导入”尚未接入；事件起始条件列表没有完成任务条件或任意 GSQ 编辑入口；因此综合案例使用“收到指定邮件 → 事件发任务”这条当前可配置的路线。玛妮领养许可证由宠物导出处理；机器额外耗材配置是整体替换；商店与入口分别保存。
新增网络选题参考：邮件未出现的论坛提问（在新窗口打开）、重复收信的社区提问（在新窗口打开）。处理办法来自产品/游戏实现，未将第三方回复直接当作技术结论。CP EditMap 官方说明（在新窗口打开）用于核对地图覆盖语义。
扩充配图在独立“模块演示”项目中打开实际模块、向导与面板采集；未完成的表单仅展示操作入口，不作为可安装成品。专业入口内部的付费体验、实时游戏连接及四个综合案例的游戏运行仍未实测。新增的演示草稿没有混入原入门示例包。
本轮还在实际界面填写、保存并重新打开教学信件，输入全局覆盖示例并确认自动保存。最终交付共 50 个 Markdown 文件（43 篇专题、4 个案例、目录/示例说明/维护记录各 1 篇）、35 张完整窗口配图、6 个入门示例 JSON 文件。285 处本地链接和图片引用全部通过存在性检查；截图尺寸、箭头边界、示例 JSON、Include 依赖和 i18n 引用均通过检查。配图已逐张目视复核。
DialogueKeyField.tsx 及共享 Key 格式定义| 对话导入边界 | 对话导入弹窗及主进程导入服务；跳过项与冲突报告逻辑 |
| 行程字段、规则、自动保存与恢复 | src/renderer/src/schedules/ScheduleModule.tsx 及共享行程规则 |
| 文件拆分、格式、元数据和覆盖重建 | src/main/content-patcher-exporter.ts；实测导出的 5 个文件 |
| 专业功能入口 | src/shared/membership/pro-feature-types.ts 和权益检查服务 |
spring 与 default 的区别| patch summary 与验证边界 |
| SMAPI 日志页面（在新窗口打开） | 日志收集入口 |
| 社区：肖像替换问题（在新窗口打开） | “装了头像却没变化”的问题线索 |
| 社区：NPC 行程问题（在新窗口打开） | 行程未生效的问题线索 |
| 星露谷论坛：NPC 不离开出生位置（在新窗口打开） | 规则与路径排错选题 |
| 星露谷论坛：修改 NPC 路径（在新窗口打开） | 新手路径修改问题线索 |
fishing| 事件 | 起始信息、出场、条件、命令、分支/续段、脚本导入与排错 | 19–21 | src/renderer/src/events/EventModule.tsx、EventFlowInspector.tsx、src/shared/events/event-preconditions.ts |
| 任务 | 十种类型、必填校验、自动保存、接取、奖励和任务链 | 22–23 | src/renderer/src/quests/QuestModule.tsx 及共享任务类型 |
| 对话 | 规则、表情、问答、条件分支、回答记录、游戏动作 | 02、05、24 | src/renderer/src/dialogues 与共享对话模型 |
| 节日 | 项目新 NPC 的参与、按人物/节日配置、自定义节日及多人规划 | 25–26 | src/renderer/src/festivals/FestivalModule.tsx、FestivalCustomWorkspace.tsx |
| 行程表 | 站点、规则、雨天/婚后、到站行为、恢复与路径排查 | 06 | src/renderer/src/schedules/ScheduleModule.tsx、src/shared/schedules/schedule-key-rule.ts |
| 物品与制作 | 普通物品/增益/图集、作物、配方、机器、家具 | 27–31 | src/renderer/src/items 下各 Workspace 和共享类型 |
| 商店 | 项目/外部商店、库存、配方、货币/交换、限购、收购、入口和店主区域 | 32–33 | src/renderer/src/shops/ShopModule.tsx |
| 邮件 | 正文、ID、投递时间/对象/条件、防重复、物品/配方/任务等特殊内容 | 34–35 | src/renderer/src/mail/MailModule.tsx、正文工具及共享邮件编译器 |
| 音乐 | OGG/WAV、试听、地点默认音乐 | 36 | src/renderer/src/music/MusicModule.tsx、音频导入与导出逻辑 |
| 全局覆盖 | 启用、JSONC Changes、顺序、附带文件及对比 | 37 | 全局覆盖编辑器、保存服务、src/main/content-patcher-exporter.ts |
| XNB 预览 | 资源树、图片导出、文本复制、地图及 XACT 音频 | 38 | src/renderer/src/xnb-preview.tsx |
| 调试器 | 依赖与连接、已加载内容包重载、事件/对话、农夫图、测试状态 | 39–40 | src/renderer/src/debugger、src/main/debugger-dependency-service.ts、SVDebugServer |
| 项目/设置/账号 | 打开、备份、元数据、目录、版本、登录与权益状态 | 01、07、41 | src/renderer/src/projects、src/renderer/src/account/AccountPage.tsx、专业权益类型 |