MIT 授权的 SMAPI 模组 + DSH 插件,把星露谷翻译成文字喂给 DeepSeek —— 53 个工具、会话预设、F7 接管和本机 MCP 服务器,不需要视觉模型。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-11-13
许可证
MIT
01它能帮你完成什么?
让 DeepSeek Harness 会话不靠截图、不靠视觉模型就能玩星露谷
一份文字化的游戏观察(状态、背包、字符地图、物体坐标、作物、出口、对话与商店内容)供模型推理,模型发出的工具调用由模组执行
想让 agent 用纯文字模型真正上手玩一局游戏的 dsh 用户
把日常农活交给 agent,一共 53 个工具
移动与跨地图规划、耕地播种浇水收获、钓鱼、照顾动物、跑镇上业务、下矿与战斗,以及界面与时间类动作
想当监工、不想自己刷前期的玩家
不想烧 DeepSeek token 时,让别的 MCP 客户端来驱动同一个存档
`http://127.0.0.1:18080/mcp` 上的 MCP 端点,WorkBuddy / Claude Code / Cursor 连上后由客户端自己的模型调用模组的工具
已经在用支持 MCP 的客户端、想把游戏工具接进去的人
02如何接入 DeepSeek Harness?
前置条件
- 星露谷装好 SMAPI 模组加载器 —— README 开发时用的是 SMAPI 4.5.2 + 游戏 1.6.15
- 一个 DeepSeek API Key(只用 MCP 客户端驱动模组时不需要)
- 只有从源码编译模组时才需要 .NET 6 或更新的 SDK
安装步骤
- 01
在 DSH 插件市场安装 `dsh-stardew-blind-whale-farmer` —— 插件自带编译好的模组并自动装进游戏的 `Mods`(游戏开着就等关了再装);找不到游戏目录时在插件的配置卡片里填“星露谷目录”
- 02
另一条路:从 GitHub Releases 下载压缩包,把 `BlindWhaleFarmer` 文件夹放进游戏目录的 `Mods`;或从源码用 `powershell -ExecutionPolicy Bypass -File build.ps1` 编译、再跑 `install.ps1` 安装
- 03
把 DeepSeek Key 填进 `Mods\BlindWhaleFarmer\config.json` 的 `ApiKey`,或者改设环境变量 `DEEPSEEK_API_KEY`
- 04
通过 SMAPI 启动游戏、读取存档,按 F8 启动或停止 AI
- 05
走 DSH 预设这条路:先在插件配置页打开“大肥鱼种白饭”会话预设,再新建会话并选中它 —— 只有那个会话会拿到玩游戏的工具
验证接入成功
- 屏幕左上角会显示 AI 的想法和正在执行的动作
- `dsai_state` 打印当前发给 AI 的文字状态,不调用 API
- `dsai_tokens` 报告本次运行消耗的 token 数
03DSH 适配与能力边界
DSH 插件 + SMAPI 模组:插件市场装好后自带编译好的 C# 模组并写入游戏的 `Mods`,同时提供会话预设 / 入口工具和配置卡片;模组本身还会开一个本机 MCP 服务器
游戏状态的文字观察
正在运行的星露谷存档→时间、天气、金钱、体力、背包、29×19 字符地图、作物与物体坐标、出口、村民与动物信息、对话和商店内容
不截任何图 —— 整个过程不需要截图,也不需要视觉模型53 个游戏工具
模型发出的工具调用→A* 寻路与跨地图移动、批量农活、钓鱼、照顾动物、建造买卖、下矿战斗、界面与时间动作
所有动作都走游戏自己的逻辑,体力消耗、动画和掉落和手动操作一致DSH 会话预设与入口工具
新建的 dsh 会话(预设)或任意会话(入口工具)→一个带着游戏工具与说明的会话,或者给老会话用的单个 `stardew` 入口工具
两者默认都关闭,需要在插件配置页里打开游戏工具和说明只会进入主动开启的那个会话本机 MCP 服务器
WorkBuddy、Claude Code、Cursor 这类 MCP 客户端→模组的工具,外加 `get_state`、`get_guide`、`toggle_ai`、`load_save`,走 `http://127.0.0.1:18080/mcp`
只监听本机,别的电脑连不上客户端思考时冻结游戏时间,超过 `McpIdleSeconds`(默认 120 秒)没有调用就暂停整个游戏内置 AI 和 MCP 客户端不能同时操作游戏接管、笔记与行动记录
F7 按键、`dsai_notes` 命令、transcript 文件→立刻中止正在执行的动作、可编辑的长期笔记、每次运行的完整行动记录
`Mods\BlindWhaleFarmer\logs\transcript-*.log` 按运行写入笔记按存档保存在 `Mods\BlindWhaleFarmer\data\`
04适合谁?何时不该用?
适合
- 想让 agent 用纯文字模型真正上手玩一局游戏的 dsh 用户
- 想当监工、不想自己刷前期的玩家
- 已经在用支持 MCP 的客户端、想把游戏工具接进去的人
不适合
- 它是 SMAPI 模组 + DSH 插件:星露谷要装好 SMAPI(开发时是 SMAPI 4.5.2 + 游戏 1.6.15),并且要有 DeepSeek API Key(只用 MCP 客户端时除外)。从源码编译还要 .NET 6 以上 SDK。
- 每一步请求大约 10k~14k 输入 token,AI 每 10~20 秒一步,所以一小时大约一两百万输入 token —— 这是要付费的 DeepSeek API 流量,不过 `BaseUrl` 可以指向任何 OpenAI 兼容接口。
- AI 睡觉时会自动保存,所以先备份存档,或者新开一个存档专门给 AI 玩。想让它后台跑,还得在游戏设置里关掉“窗口不活动时暂停”。
- 游戏工具不能漏进每个会话:用会话预设(或那个单独的入口工具),不要在 profile 里全局挂 `@deepseek-ai/dsh-mcp-client`;已经对话过的会话不能换预设;桌面版和网页版 profile 不同,各自都要装。
05兼容性、维护与安全提示
- 它是 SMAPI 模组 + DSH 插件:星露谷要装好 SMAPI(开发时是 SMAPI 4.5.2 + 游戏 1.6.15),并且要有 DeepSeek API Key(只用 MCP 客户端时除外)。从源码编译还要 .NET 6 以上 SDK。
- 每一步请求大约 10k~14k 输入 token,AI 每 10~20 秒一步,所以一小时大约一两百万输入 token —— 这是要付费的 DeepSeek API 流量,不过 `BaseUrl` 可以指向任何 OpenAI 兼容接口。
- AI 睡觉时会自动保存,所以先备份存档,或者新开一个存档专门给 AI 玩。想让它后台跑,还得在游戏设置里关掉“窗口不活动时暂停”。
- 游戏工具不能漏进每个会话:用会话预设(或那个单独的入口工具),不要在 profile 里全局挂 `@deepseek-ai/dsh-mcp-client`;已经对话过的会话不能换预设;桌面版和网页版 profile 不同,各自都要装。
MIT · 最新版本 v1.1.7(2026-11-12)· 仅 README 证据,未做安全审计
06常见问题
在 DeepSeek Harness 里怎么装?
在 DSH 插件市场装 `dsh-stardew-blind-whale-farmer`:插件自带编译好的 SMAPI 模组并自动装进游戏的 `Mods`(游戏开着就等关了再装),以后在插件市场点“更新”插件和模组一起更新。找不到游戏目录时,在插件的配置卡片里填“星露谷目录”。前提是先装好 SMAPI。
为什么我的会话里 AI 看不到游戏?
“大肥鱼种白饭”会话预设默认是关的。先在插件配置页打开它,再新建会话并选中 —— 只有那个会话会连上游戏、拿到工具。已经对话过的会话不能再换预设(DSH 的规定),其他会话则刻意不带这些工具,不占上下文。
需要 DeepSeek API Key 吗?
只有内置 AI 需要。把 Key 填进 `Mods\BlindWhaleFarmer\config.json` 的 `ApiKey`,或者设环境变量 `DEEPSEEK_API_KEY`。如果你改用 WorkBuddy、Claude Code、Cursor 连模组的 MCP 服务器,就由客户端自己的模型来玩,不需要 DeepSeek Key。
它会往哪里写东西?
每次运行的完整行动记录写在 `Mods\BlindWhaleFarmer\logs\transcript-*.log`,AI 的长期笔记按存档保存在 `Mods\BlindWhaleFarmer\data\`,并且会出现在 `get_state` 最前面,所以新会话能接着玩。每次玩几个游戏日 / 多少分钟这类设置改在插件配置页里,改了自动推送到游戏,不用重启。
玩一小时大概花多少?
每步约 10k~14k 输入 token,AI 每 10~20 秒一步,所以每小时大约一两百万输入 token。系统提示加 43 个工具定义(约 7.5k)是固定的,能命中 DeepSeek 的缓存;实际消耗可以用 `dsai_tokens` 查。
07相关的 DSH 工作流
rea
作者 morluto
用智能体逆向工程一切,从应用行为一直到原生二进制。
reactive-resume
作者 reactive-resume
开源简历制作插件,强调隐私保护,支持自定义、可移植和自托管。
next-ai-draw-io
作者 dayuanjiang
通过对话创建和编辑 draw.io 图表,提供 Web、桌面应用及 MCP 服务,可用于流程图和架构图绘制。
everos
作者 evermind-ai
为所有 AI 智能体提供的便携统一记忆层,本地优先、Markdown 原生、数据归用户所有,跨应用与工作流自进化。
08数据与来源
`dsh-stardew-blind-whale-farmer`:一个 SMAPI 星露谷模组,加一个 DeepSeek Harness(DSH)插件。
**用 DSH 的话最省事**:在 DSH 的插件市场装 dsh-stardew-blind-whale-farmer。插件自带编译好的模组,会自动装进游戏的 `Mods`(游戏开着时等关了再装);以后在插件市场点“更新”,插件和模组一起更…
提供一个 **“大肥鱼种白饭”会话预设**(默认关闭,在插件的配置页里打开):新建会话时选它,那个会话才连上游戏、拿到玩游戏的工具;其他会话里完全没有这些工具和说明,不占上下文;已经对话过的会话不能再换预设(DSH 的规定),要玩请新建会话
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-13。发现错误?提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。
