山谷物语 – 无限对话

《星露谷物语》无限沉浸对话 MOD 使用指南
【核心介绍】
为所有村民与配偶提供基于情境的自然对话——依据友谊等级、天气、时间、地点、在场人物、礼物历史、婚姻状态、孩子、农场现状等实时生成个性化回应，大幅提升角色真实感与游戏沉浸感。
【安装指南】
1. 确认前置已安装：确保已安装「Stardew Valley 1.6.14」、「SMAPI 4.1.7」；（可选）「Generic Mod Config Menu 1.14.1」。
2. 下载 ZIP 文件，解压全部内容至游戏根目录 `/mods/ValleyTalk` 文件夹（路径必须为 `/mods/ValleyTalk`，不可嵌套或改名）。
3. 根据所选 AI 提供商，在 `config.json` 中填写对应配置（详见【模型提供商】模块），API 密钥为必填项。
4. 启动游戏即可生效；首次运行需等待 SMAPI 日志显示 “ValleyTalk connected to [model]” 确认连接成功。
> ⚠️ 本 MOD 安装前，需同步安装前置依赖的 MOD：「SMAPI 4.1.7」；不兼容 Android 平台。
【功能详情】
✅ 已优化：
– 所有村民按原版逻辑响应友谊、季节、天气、时间、位置、社区中心进度、包裹完成状态；
– 配偶知晓农场建筑/动物/作物、宠物、孩子、婚姻幸福度、结婚时间、多配偶关系（兼容「Polyamory Sweet」「Immersive Spouses」）；
– 村民与配偶能记住并引用过往对话；
– 支持多语言（含 i18n 翻译包与实时翻译技术）；
– 兼容节日与事件基础对话（首次对话仍使用原版台词）。
❌ 未修改：
– 其他模组新增的自定义 NPC 或角色传记（如 SVE 新村民仅使用默认对话）；
– 非对话类模组对游戏机制的改动（如 Automate、SpaceCore 等不影响 ValleyTalk 运行）；
– 原版 UI、动画、音效、存档结构。
✨ 额外调整：
– 对话频率可三档独立配置（配偶/送礼/普通对话）；
– 支持禁用指定角色（通过 `DisableCharacters` 字段设置逗号分隔名单）；
– 多人模式下，主机玩家保存全局历史，其他玩家本地保存个人事件历史（升级时务必保留该文件夹）。
【使用要求】
– 必备：「Stardew Valley 1.6.14」、「SMAPI 4.1.7」；
– 系统：Windows / macOS / Linux（已验证）；不支持 Android；其他平台兼容性未知；
– 硬件：需稳定网络连接（商用 API）或本地 GPU/CPU 资源（自托管 LlamaCpp）；无最低显卡要求，但响应速度取决于所选模型与网络延迟。
【兼容性说明】
✅ 兼容范围：
– 「Stardew Valley Extended」（SVE）——新增角色使用默认对话；
– 「Polyamory Sweet」——所有村民认可并谈论全部配偶；
– 「Immersive Spouses」——配偶与村民可讨论当日计划；
– 「Generic Mod Config Menu」——提供图形化配置界面；
– 「Automate」「SpaceCore」「Farm Type Manager」「Expanded Preconditions」等非对话类主流模组。
❌ 不兼容模组：
– 「Cooperative Egg Hunt」；
– 「Button’s Extra Trigger Action Stuff」；
> 若对话显示 `$%%%` 等异常字符，大概率因上述模组覆盖了 ValleyTalk 的代码逻辑，请停用排查。
> ❗ 暂未推出官方兼容补丁。
【注意事项】
– 对话生成期间屏幕会短暂冻结（通常 2–5 秒），属正常现象，速度取决于所选 AI 提供商；
– 手柄操作长对话时可能出现选项选择异常（基础游戏 Bug），请优先使用鼠标选择回应；
– 可直接添加至现有存档，但村民不会记忆安装前发生的任何对话；
– 更新 MOD 时：先备份 `config.json`，再删除旧 `/mods/ValleyTalk` 文件夹，最后解压新版本并还原配置文件；
– 删除 MOD：直接删除 `/mods/ValleyTalk` 文件夹即可。
【更新日志】
– 2024 年 12 月 30 日 v0.14.0：新增多人游戏支持（需保留玩家本地事件历史文件夹）；配偶根据原版赠礼逻辑赠送/谈论礼物；优化 Shane 与 Jas 早期对话一致性；增强怀孕/收养识别；修复 llama.cpp 支持及 DisplayName 容错。
– 2024 年 11 月 15 日 v0.13.0：完全兼容「Polyamory Sweet」与「Immersive Spouses」；修复非英文环境错误日志；改进标点生成；新增 AI 对结婚时间、多配偶、每日日程的理解。
【模型提供商】
> ✅ 所有提供商均需在 `config.json` 中配置，API 密钥为必填项；启用状态设为 `true`。
Anthropic（推荐）
– 最佳体验：`anthropic/claude-3.5-sonnet`（知识最全，细节丰富）；
– 性价比首选：`anthropic/claude-3.5-haiku-20241022`；
– 接入方式：通过「网址链接」注册获取密钥（最简路径）；
– 直连限制：Anthropic 官方 API 当前仅面向商业用户开放。
Mistral
– 免费首选：`open-mixtral-8x22b-2404`（La Plateforme 免费计划可用）；
– 强力自托管：`mistral-large-latest`（需添加账单信息）；
– 获取密钥： 网址链接
OpenAI
– 推荐模型：`gpt-4o-2024-11-20`（平衡质量与速度）；
– 经济替代：`gpt-4o-mini-2024-07-18`；
– 获取密钥： 网址链接
Google Gemini
– 免费额度：`gemini-1.5-flash`（每日 1500 次免费调用）；
– 实验版本：`gemini-2.0-flash-exp`；
– 获取密钥： 网址链接
OpenAI 兼容 / LlamaCpp（高级）
– 适用于 Ollama、本地部署等 OpenAI 兼容服务；
– LlamaCpp 需额外配置 `PromptFormat`（含 `{system}` `{prompt}` `{response_start}` 占位符）；
– ServerAddress 为必填项（如 ` 网址链接
【运行成本】
– MOD 本身完全免费；
– 商用 API：按 token 计费（输入为主），实测约 $0.01 / 次对话（以 Claude 3.5 Sonnet 为例）；
– 本地模型（LlamaCpp）：零费用，但需较高硬件资源，响应较慢。
【免责声明】
– MOD 处于积极开发阶段，可能存在未覆盖边缘场景；请通过评论区反馈问题；
– AI 响应依赖模型能力，若返回格式错误或拒绝响应，MOD 将重试 4 次后放弃（可能增加延迟与费用）；
– 输入信息符合家庭友好标准，但使用 NSFW 模型可能导致不可控输出，不建议启用。