dsh-stardew-blind-whale-farmer

大肥鱼种白饭 Blind Whale Farmer

让 DeepSeek 不靠视觉玩星露谷：闭着眼睛也能种田（种白饭）的大肥鱼 🐋🍚

dsh-stardew-blind-whale-farmer：一个 SMAPI 星露谷模组，加一个 DeepSeek Harness（DSH）插件。

一个 SMAPI 模组。它把游戏画面"翻译"成纯文字（状态、背包、文字地图、物体坐标、作物、出口、对话框/商店内容），交给 DeepSeek；DeepSeek 通过函数调用（tool calling）发出高层指令，模组负责寻路、走过去、用工具、播种、浇水、对话、购物、睡觉。整个过程不需要截图，也不需要视觉模型。

游戏 ──(主线程读取)──> 文字观察 ──> DeepSeek API ──> 工具调用 ──> 模组在游戏里执行（寻路+游戏原生操作）
  ^                                                                         |
  └──────────────────────────── 结果写进行动记录，进入下一轮 ────────────────┘

安装（第一次）

1. 安装 SMAPI（星露谷的模组加载器）

• 下载：（开发时用的是 SMAPI 4.5.2 + 游戏 1.6.15）
• 解压后运行安装程序（Windows 是 install on Windows.bat），按提示选择游戏目录
• Steam 里给星露谷设置启动选项："<游戏目录>\StardewModdingAPI.exe" %command%

2. 安装本模组（三选一）：

• 用 DSH 的话最省事：在 DSH 的插件市场装 dsh-stardew-blind-whale-farmer。插件自带编译好的模组，会自动装进游戏的 Mods（游戏开着时等关了再装）；以后在插件市场点“更新”，插件和模组一起更新。找不到游戏目录时，在插件的配置卡片里填“星露谷目录”。
• 从 GitHub Releases 下载压缩包，把里面的 BlindWhaleFarmer 文件夹放进游戏目录的 Mods 里。

从源码安装的话，在仓库根目录运行（会自动在 Steam / GOG 的安装位置找游戏，包括装在其他盘的 Steam 库）：

   powershell -ExecutionPolicy Bypass -File build.ps1

   powershell -ExecutionPolicy Bypass -File install.ps1

3. 填 API Key：打开 游戏目录\Mods\BlindWhaleFarmer\config.json，把 ApiKey 填成你的 DeepSeek Key（）。也可以不写在文件里，改设系统环境变量 DEEPSEEK_API_KEY。

使用

1. 通过 SMAPI 启动游戏，读取存档（建议先备份存档，或者新开一个存档给 AI 玩，AI 睡觉时会自动保存）。

2. 按 F8 启动 / 停止 AI。屏幕左上角会显示 AI 的想法和正在执行的动作。

3. 游戏窗口失去焦点时星露谷默认会暂停，想让它在后台跑：游戏设置里关闭"窗口不活动时暂停"。

SMAPI 控制台命令（调试用）：

| 命令 | 作用 |

|---|---|

| dsai_start / dsai_stop | 启动 / 停止 AI |

| dsai_state | 打印当前发给 AI 的文字状态（不调用 API，可以先看看它"看到"了什么） |

| dsai_do <工具> | 手动执行一个工具，例如 dsai_do travel_to {"location":"SeedShop"}、dsai_do water_crops {} |

| dsai_notes [内容] | 查看 / 改写 AI 的长期笔记 |

| dsai_tokens | 本次运行消耗的 token 数 |

每次运行的完整行动记录在 Mods\BlindWhaleFarmer\logs\transcript-*.log。AI 的笔记按存档保存在 Mods\BlindWhaleFarmer\data\。

用 WorkBuddy（或其他 MCP 客户端）来玩：不需要 API Key

模组启动时会在本机开一个 MCP 服务器：http://127.0.0.1:18080/mcp（只监听本机，别的电脑连不上）。WorkBuddy、Claude Code、Cursor 这类支持 MCP 的客户端连上来后，由客户端自己的 AI 思考、调用模组的工具玩游戏，消耗的是客户端的额度，不需要 DeepSeek API Key。

WorkBuddy 设置：

1. 先通过 SMAPI 启动游戏、读取存档（SMAPI 控制台会显示 MCP 服务器已启动：http://127.0.0.1:18080/mcp）。

2. WorkBuddy → 设置 / 连接器 → 自定义连接器 → Configure MCP（会打开 ~/.workbuddy/mcp.json），加上：

   {
     "mcpServers": {
       "stardew": {
         "url": "http://127.0.0.1:18080/mcp"
       }
     }
   }

保存后在 My MCP 列表里打开它的开关。不同版本菜单名可能不一样，以你的客户端界面为准；如果它要求选传输方式，选 Streamable HTTP。

3. 对 WorkBuddy 说："用 stardew 工具玩星露谷：先 get_state 看看状态，然后今天把作物浇完、出货，晚上睡觉。"

说明：

• 工具：get_state（读取文字状态）、get_guide（读攻略），加上内置 AI 用的全部工具；连接时还会把操作规则和攻略（和内置 AI 的提示词一样）发给客户端。
• 客户端思考（两次调用之间）时游戏时间自动冻结；超过 McpIdleSeconds（默认 120 秒）没有调用就把整个游戏暂停（按任意键或 AI 再次调用时继续，PauseWhenAiStops 可关）。屏幕左上角会显示 [MCP 客户端思考中，时间已冻结]。
• 按 F8 启动的内置 AI 和 MCP 客户端不能同时操作：内置 AI 运行时，MCP 的工具调用会返回提示让你先按 F8 停掉它。
• AI 卡住或者你想自己玩一会儿时，在游戏里按 F7 接管：AI 正在执行的动作立刻中止，之后它的游戏动作都会被拒绝（它会收到“玩家接管了”的提示并停下汇报）。再按一次 F7 交还，然后在 DSH 里让它继续。
• 长动作（下矿、钓鱼、wait）最长要 15 分钟；接受 SSE 的客户端（比如 DSH）会每 15 秒收到一次心跳，不会因为等太久断开。个别客户端的工具调用超时比这短，遇到超时就让它把动作拆小。
• 客户端的一次任务通常只能连续玩一段时间，需要你隔一会儿让它"继续"。
• 端口冲突时改 config.json 的 McpPort；不想开就设 EnableMcp: false。

用 DeepSeek Harness（DSH）玩： 装上本仓库的 [DSH 插件](docs/dsh-plugin.md)（dsh-stardew-blind-whale-farmer）。它会：

• 提供一个 “大肥鱼种白饭”会话预设（默认关闭，在插件的配置页里打开）：新建会话时选它，那个会话才连上游戏、拿到玩游戏的工具；其他会话里完全没有这些工具和说明，不占上下文；已经对话过的会话不能再换预设（DSH 的规定），要玩请新建会话；AI 的长期笔记会出现在 get_state 最前面，新会话能接着玩。
• 也可以在所有会话（包括老会话）里提供一个很小的 stardew 入口工具（默认关闭）：不用换预设，常驻上下文只多一个工具的简短说明，AI 要玩时先 action="help" 再按需调用各个动作。
• 在 DSH 左侧边栏「插件」→ dsh-stardew-blind-whale-farmer → 点组件名旁边的「配置 ›」 里提供设置：每次玩几个游戏日 / 多少分钟、思考时冻结时间、给 AI 的额外要求、攻略文件等，改了自动推送到游戏，不用重启。

桌面版和网页版用不同的 profile，各自都要装。不要再在 profile 里全局挂 @deepseek-ai/dsh-mcp-client 连星露谷，否则每个会话都会带上这些工具。

更新模组后： 关掉游戏，装好新版，打开游戏（到标题画面就行），再重启 DSH，回到原来的会话说一句“继续”就行，不用新开会话，聊天记录也还在。只重开游戏不够：这样虽然模组改动会生效，但会话里还是旧的工具列表和规则。

联机：和 AI 一起玩

你当主机，AI 当农场工人，在同一台电脑上开两个游戏窗口。

1. 准备存档：联机存档要有空的小屋（新建时选，或者找 Robin 建）。建议先备份。