前言¶
星露谷模组 Blind Whale Farmer 在本机开 MCP 服务，把画面转成文字状态，再靠工具调用让模型种田、出货、睡觉。若只在 profile 里全局挂 MCP 客户端，每个 DSH 会话都会塞进四十多个游戏工具和长说明，普通聊天、写代码的上下文会被占满。DeepSeek Harness 按会话预设和插件拆分能力；dsh-stardew-blind-whale-farmer 负责把游玩上限、攻略、连接方式收进插件配置页，并和模组 config.json 双向同步。下面介绍它解决什么问题、怎么装、怎么用。
这是什么¶
dsh-stardew-blind-whale-farmer（npm 包名，当前版本 0.5.0，MIT）是维护者 Darianliu23 为 大肥鱼种白饭 Blind Whale Farmer 写的 DSH 插件。它不能单独代替游戏模组：你需要先用 SMAPI 安装仓库里的 BlindWhaleFarmer 模组，游戏运行后才会在本机 http://127.0.0.1:18080/mcp 暴露 MCP（端口可在模组 config.json 的 McpPort 修改）。插件做的是在 DSH 侧连上这条 MCP、可选注册「大肥鱼种白饭」会话预设或精简入口工具，并把你在 DSH 里改的游玩参数与攻略推回游戏。
SkillHub 目录分类为工作流；GitHub 仓库见 Darianliu23/dsh-stardew-blind-whale-farmer。
核心功能¶
配置同步¶
插件约每 15 秒向模组 /settings 询问当前设置版本；与 DSH 侧不一致时推送。改完配置点保存，十几秒内生效，无需重启游戏；模组也会写回 Mods/BlindWhaleFarmer/config.json，不开 DSH 时仍按文件生效。游戏未启动时不推送，启动后自动补推。
可在 DSH 左侧边栏「插件」→ dsh-stardew-blind-whale-farmer → 组件名旁「配置 ›」调整（分组为游玩 / 攻略 / 会话与连接），包括但不限于：
| 设置 | 默认 | 说明 |
|---|---|---|
| 每次玩几个游戏日 | 0（不限） | 睡一觉算一天，到上限后游戏动作被拒绝，AI 停下汇报 |
| 每次玩多少分钟 | 0（不限） | 现实分钟，到上限先回家睡觉存档再停 |
| 思考时冻结时间 | 开 | 与模组 McpFreezeTime 对应 |
| 空闲多少秒算不玩了 | 120 | 对应 McpIdleSeconds |
| 顺手采集范围 | 1 | 对应 ForageRadius |
| 额外要求 | 空 | 对应 ExtraInstructions |
| 攻略文件 | guide/攻略.md |
相对 Mods/BlindWhaleFarmer |
| 攻略·攻略 / 钓鱼 / 采矿 / 节日 | 模组自带 | 文本框修改会优先于磁盘文件推给游戏 |
| 端口 | 18080 | 与 McpPort 一致 |
两种接入会话的方式（默认均关闭）¶
「大肥鱼种白饭」会话预设：打开后注册预设（默认名「大肥鱼种白饭」，基础预设 standard）。只有新建会话并在发第一条消息前选中该预设的会话才会加载 get_state 等全套工具与规则；其他会话不占星露谷上下文。已开聊的会话不能换预设（DSH 会报 agent-preset/locked），要玩请新建会话。长期笔记由模组 AI 写入，会出现在 get_state 开头，新会话可接续。
stardew 入口工具：在所有会话（含老会话）只多一个 stardew 工具。AI 先 {"action":"help"} 再按需 {"action":"动作名","args":{...}}；攻略用 {"action":"get_guide"}。与预设可同时开启；专门开会话玩时预设体验更完整。
模型坏回复自动续玩¶
默认开启：若本轮调用过星露谷工具、最后一条回复是未解析成功的坏工具调用、且会话正常结束，空闲后会自动发「接着玩」（agent.followup）。连续自动续玩默认最多 3 次，中间有一次游戏动作成功则重新计数。
依赖与实现¶
插件通过 cordis.patch.yml 注入 DSH，配置 UI 来自自带的 lib/client.js（非 DSH 自动生成表单）。依赖 @deepseek-ai/schemastery（package.json 中为 3.18.4）。修改 lib/index.js 里 Config 后需运行 npm run build:client regenerate 配置卡片。
安装与启用¶
前置：游戏模组¶
DSH 插件不包含 SMAPI 模组本体。按 Blind Whale Farmer 仓库 README 安装 SMAPI 与 BlindWhaleFarmer（Release 解压到 Mods，或 Windows 下 build.ps1 / install.ps1）。内置 DeepSeek 玩法需在模组 config.json 填 ApiKey 或设环境变量 DEEPSEEK_API_KEY；仅用 DSH + 本插件时，消耗的是 DSH 所用模型的额度，不必在模组里写 DeepSeek Key。
安装 DSH 插件¶
DSH 桌面版与网页版使用不同 profile（<DSH_HOME>/profiles/desktop 与 profiles/web），每个要用的 profile 各装一次。
在 DSH 插件页面使用官方给出的标识安装（只会装 lib/、cordis.patch.yml 等，不会把模组源码装进 DSH）：
github:Darianliu23/dsh-stardew-blind-whale-farmer
装好或升级插件后重启一次 DSH，配置入口才会出现。文档明确建议：不要再在 profile 的 cordis.patch.yml 里全局挂 @deepseek-ai/dsh-mcp-client 连星露谷，否则每个会话都会带上游戏工具。
本地 link 开发安装步骤见仓库 docs/dsh-plugin.md。
典型用法¶
- SMAPI 启动星露谷并读档（建议备份或新档；AI 睡觉会存档）。SMAPI 控制台应出现 MCP 已启动（默认
http://127.0.0.1:18080/mcp）。若窗口失焦会暂停，需在设置里关闭「窗口不活动时暂停」以便后台跑。 - 在 DSH 插件配置里打开「大肥鱼种白饭」预设或「stardew 入口工具」，保存并等待同步到模组。
- 预设方式：新建会话，在第一条消息前选择「大肥鱼种白饭」，然后例如让 AI 先
get_state，再安排当日农活与睡觉。 - 入口工具方式：在已有会话中让 AI 调用
stardew，例如先{"action":"help"}，再转发具体动作。 - 游戏中 F7 可接管 / 交还 AI；内置 F8 AI 与 MCP 客户端不能同时操作（内置 AI 运行时 MCP 会提示先停 F8）。长动作（钓鱼、下矿）单次最长约 15 分钟，插件侧单个动作最长等待默认 16 分钟。
模组侧调试命令（SMAPI 控制台）包括 dsai_state（只看文字状态、不调 API）、dsai_do 手动执行工具等；完整行动记录在 Mods/BlindWhaleFarmer/logs/transcript-*.log。
适用场景与注意¶
适合谁：已经在用 Blind Whale Farmer、希望用 DSH 统一模型与额度、并要把「玩几游戏日 / 几分钟、攻略、冻结时间」集中在 DSH 里改的人；也适合不想换预设、只在某个老会话里偶尔用 stardew 入口玩一局的人。
权限与安全：插件随当前 DSH 进程权限运行，会向本机游戏端口发 HTTP；安装前请阅读仓库源码与 MIT 许可证，自行评估是否信任维护者与网络暴露面（MCP 仅监听 127.0.0.1）。
生态说明：DeepSeek Harness 社区插件目录在 SkillHub，与 DeepSeek / 幻方无官方从属关系。
限制（来自模组 README，插件不消除这些）：例如战斗策略较朴素、传说鱼低等级成功率低、内置 AI 与 MCP 互斥等；费用上内置 DeepSeek 每步约 10k～14k 输入 token 量级，以官网定价与 dsai_tokens 为准。
结尾¶
dsh-stardew-blind-whale-farmer 把星露谷 blind-whale 模组的 MCP 玩法收进 DSH 插件模型：配置可推送、会话可隔离、可选自动续玩。目录页：SkillHub 插件页；源码与模组说明：GitHub 仓库。
