先按现象找到对应问题。每次只改一处，重新导出后再测试，比较容易知道是哪一步解决了问题。
人物列表空白，或者读不到游戏图片
打开 设置 → 游戏根目录，先自动扫描；失败再手动选择安装游戏的 Stardew Valley 文件夹。选中的目录应包含 Content，不要直接选 Content 本身。
常见问题与排错
按常见现象排查资源读取、导出安装、人物外观和对话行程。
发布于
正在加载文档内容…
正在加载文档内容…
行程表
维护记录
打开项目 需要彩虹鸡项目文件夹，里面应有 project.json。content.json 是 Content Patcher 成品文件，不能当作项目打开。
如果只想导入其中的对话，使用 对话 → 导入对话 → 扫描并预览。先看支持哪些候选项和导入报告，不要把它当作整个 CP 模组的通用转换器。
按顺序检查：
“项目已保存”和“模组已导出”是两件事。两份游戏、两套 Mods 并存时，尤其要核对路径。
这是正常的文件拆分方式。在彩虹鸡 导出预览 左侧展开 patches，查看实际补丁；台词正文在 i18n/default.json。
复制成品时要复制整个文件夹，不能只拿根目录的两个 JSON。可对照附带的实际导出示例。
不要把 JPG 只改后缀为 .png，也不要把任意大头像直接拉伸。到肖像详情逐格查看，再去对话页选择表情验证。
聊天头像与地图小人是两套资源：前者从 编辑肖像 改，后者从 编辑行走图 改。
默认、冬日、沙滩等外观也要分别检查。只换默认图，已有的季节外观仍可能继续被选中。“沙滩”预设与姜岛度假服装有关，不等于走到鹈鹕镇沙滩就触发。
两个补丁同时整张加载同一个资源时可能冲突。先看 SMAPI/CP 提示的资源名称，确认冲突的是哪个人物、哪个场景；临时只保留其中一套对应替换再测试。CP 对整张 Load 的处理见官方说明（在新窗口打开）。
不要只靠改文件夹排序猜测谁会生效。涉及其他作者的美化包时，也检查它是否提供人物或季节开关。
先回 开始 节点检查 NPC、类型、触发条件、生成 key，不要只看标题。
接着确认测试日期、是否初次见面、天气和好感。指定日期等对话可能比普通星期台词更优先；当天已经聊过，也不适合反复验证日常开场。
最后检查其他对话模组是否也修改了同一个 NPC 的同一个 key。先用第一句台词的简单条件测试，再逐步加条件。
“第 1 年”模板生成的基础 key 还可能作为后续年份的回退使用。严格限定年份时，不能只依赖这个模板名称。
先分两步检查：
初学时保留原版地点和坐标，只改一个时间。等它生效，再改目的地。导出后重新进入新的一天检查，不要把已经开始的旧行程当成新结果。
普通行程最终可以回退到 spring；不要只建一个 default 就认为全天路线齐了。完整步骤见行程表教程。
这些入口需要对应的专业权限。基础的人物 PNG 替换、对话编辑、行程字段编辑和导出，可以先按本套教程练习。
如果已经开通却仍提示无权限，先确认登录账号是否正确、权益是否有效，以及网络能否完成权益检查。不要用重新建项目解决账号问题。
调试器还需要游戏侧的 SVDebugServer 等依赖；修改依赖前先关闭游戏，再按软件提示安装或更新。首次练习用正常导出、重新启动游戏的方式验证即可。
先记下：软件版本、项目 Unique ID、修改的人物、预期效果、实际效果、测试日期和天气。
如果 SMAPI 有报错，按 SMAPI 日志页面（在新窗口打开）的步骤取得日志。求助时提供日志链接和相关页面截图，比只说“没反应”更容易定位。
愿意看控制台时，可以在 SMAPI 控制台 输入下面的命令。自己的模组要换成自己的 Unique ID：
patch summary "RainbowTutorial.FirstMod"重点看补丁是否加载、条件是否满足、修改是否应用。具体字段和命令用法见 Content Patcher 官方排错指南（在新窗口打开）。