dsh-junimo

dsh-junimo

简体中文 · [繁體中文](README.zh-Hant.md) · [English](README.en-US.md) · [Español](README.es-ES.md)

DeepSeek Harness 插件，为《星露谷物语》提供 41 个操控工具，并补充 MCP 层无法覆盖的部署自检与游戏生命周期管理。

> 开发与维护约定（给 AI Agent）见 [AGENTS.md](AGENTS.md)。

概述

本仓库是一个 dsh 组合包（bundle），作用于 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的 profile 层。

游戏逻辑不在此实现。全部 41 个工具由 [Junimo-MCP](https://github.com/mlkgrnt/Junimo-MCP) 的 junimo-mcp.exe（OCaml，单文件）提供，经官方 @deepseek-ai/dsh-mcp-client 以 stdio MCP 协议桥接，模型侧呈现为 mcp__junimo__<工具名>。本仓库不修改 Junimo-MCP 的任何代码。

插件自身承担四项职责：

1. 装配 MCP 桥接，并提供 junimoPaths 服务作为 exe、skill 目录的唯一真源

2. 向系统提示词注入星露谷操作纪律，规避时序与存档类常见错误

3. 注册 4 个原生工具：诊断、窗口聚焦、游戏启动、读档

4. 在 dsh Web UI 右侧边栏注册一块只读的「季历面板」

第 3 项无法由 MCP 工具实现——mod 运行于游戏进程内部，不能启动自身进程，也不能将自身窗口置前。第 4 项由一条宿主路由加一份预构建的客户端 bundle 实现，见「[季历面板](#季历面板)」。

junimo-mcp.exe 已随包内置（bin/，v3.3.1，6 MB），安装插件后无需另行获取二进制。

架构

模型 ──mcp__junimo__*──▶ dsh-mcp-client ──stdio──▶ junimo-mcp.exe ──HTTP──▶ 执行器 mod ──▶ 游戏
                              ▲                          ▲
                        dsh-junimo 装配             原样复用，未修改
                        + 4 个原生工具

| 组成 | 提供方 | 说明 |

|---|---|---|

| 41 个游戏工具 | @deepseek-ai/dsh-mcp-client + 内置 exe | 感知、移动、交互、界面、农活、箱子、社交、节日、生计 |

| 4 个原生工具 | 本插件 | junimo_doctor / junimo_focus / junimo_game_launch / junimo_load_save |

| 提示词纪律 | 本插件 | 系统提示词段落 junimo:rules，约 1000 字符 |

| 随包 skill | @deepseek-ai/dsh-skill-filesystem | skills/junimo/，按需加载，不占常驻上下文 |

| 参考文档 | 本插件 | reference/game-semantics.md，含工具速查表与已知边界 |

| 季历面板 | 本插件 | 右侧边栏只读面板：宿主路由 GET /junimo/panel + 预构建的 client/index.js |

前置要求

| 项 | 要求 |

|---|---|

| 操作系统 | Windows（内核与插件、mod 三层的平台现状不同，见「[平台支持](#平台支持)」） |

| dsh | >= 0.2.1-rc.2（声明于 package.json 的 dsh.engines） |

| 游戏 | Stardew Valley 1.6.x |

| SMAPI | 4.x（junimo_game_launch 依赖它启动） |

| POSIX shell | Git for Windows 或 WSL 的 bash，用于启动游戏。缺失时退回 cmd，可正常启动，但会多出一个 SMAPI 控制台窗口 |

| 执行器 mod | [JunimoBridge](https://github.com/mlkgrnt/junimo-bridge) v0.3.2，安装至 Mods/JunimoBridge/（端口 7850）；也兼容 [NagiBridge-Remix](https://github.com/pendel001/NagiBridge-Remix)（Mods/NagiBridge/，7842） |

SMAPI 与 mod 的安装步骤见 [Junimo-MCP 的 AGENTS.md](https://github.com/mlkgrnt/Junimo-MCP/blob/main/AGENTS.md)。

> [JunimoBridge](https://github.com/mlkgrnt/junimo-bridge) 采用 MIT 许可（本项目的姊妹仓库，只实现真正在用的那批端点，报文与 NagiBridge 对齐）。NagiBridge-Remix 采用 PolyForm Noncommercial 1.0.0，个人与非商业用途免费。本项目不打包任何 mod 代码。原版 NagiBridge 与 Remix 的 UniqueID 不同，同时安装会争用 7842 端口，切换时需先移出旧目录。

安装

# 本地 checkout
dsh plugin --profile web add link:/path/to/dsh-junimo

# 或直接从 GitHub 安装（纯 ESM 源码，无构建步骤）
dsh plugin --profile web add github:mlkgrnt/dsh-junimo

dsh plugin add 会初始化 profile，并将本包追加至 dsh.profile.bundles。重启 dsh 后生效。

安装后执行 junimo_doctor 完成链路检查。该工具输出 exe 路径与版本、7850 端口状态、mod 响应、存档就绪状态、SMAPI 与执行器 mod 文件完整性，以及 SMAPI 日志中的错误行。

> 从 GitHub 安装时若提示构建脚本未授权，将 pnpm 给出的包键加入 profile 的 pnpm-workspace.yaml 的 allowBuilds。本包不含构建步骤，通常不会触发。

配置

环境变量

| 变量 | 默认值 | 说明 |

|---|---|---|

| JUNIMO_MCP_BIN | 内置 bin/junimo-mcp.exe | 覆盖内置 exe，用于升级、回退或使用自编译版本 |

| STARDEW_GAME_DIR | 自动探测 | 含 Stardew Valley.exe 的目录；未设置时依次尝试 Steam 库与常见安装路径 |

| STARDEW_API_URL | http://localhost:7850 | mod 端点。必须使用 localhost，127.0.0.1 会被系统拒绝 |

| STARDEW_AUTO_MENU | 1 | 透传给 exe：自动应答无选项对话 |

| STARDEW_AUTO_EVENT | 未设置 | 透传给 exe：自动跳过剧本事件，默认关闭 |