前言¶
DSH 的生态强调插件化扩展。对想把 DSH 用到 Minecraft 的开发者来说，底层工作通常包括登录、下载、启动、开放局域网，以及 bot 连接。dsh-mc-companion 补的是另一层：游戏内聊天、跟随、记忆、心情和主动搭话。下面介绍它的定位、能力、安装和用法。
这是什么¶
dsh-mc-companion 是 hellosky983 维护的 DSH 正式 bundle 插件。当前 package.json 版本为 0.1.0，许可证为 MIT。
它是一个 host-only bundle 插件，没有 client 半区。加载后，它会在 DSH 运行时里注册伙伴层，接管游戏内聊天的社交层，并用自然、简短、温暖的中文回复玩家。
它不负责启动 Minecraft、下载版本、连接 bot；这些由 dsh-mc-agent 完成。dsh-mc-companion 复用 dsh-mc-agent 通过 Cordis 提供的共享服务 mcBot，因此两者必须一起安装。
核心功能¶
跟随与聊天¶
自动跟随默认开启。spawn 后，它会跟随最近的玩家，距离为 3 格。
在游戏内聊天中，可以直接对它说话，例如“阿深你叫什么”“跟着我”“你在哪”。它也支持一组游戏内命令：
/跟着我、/跟我走：让它跟特定玩家。/别跟着、/停下：让它原地待着。
记忆¶
它会记住玩家说过的重要信息，最多 60 条，之后聊天里会自然提起。
记忆保存在本机：
~/.dsh-mc/companion.json
文件权限为 0600，不会上传到任何服务器。可以用 mc_friend_forget 传 all 一键清空。
心情与主动搭话¶
它会根据聊天内容切换心情，包括：
happyexcitedcalmworriedcurious
主动搭话逻辑是：每隔约 12 秒检查一次跟随状态；约 90 秒后，以 35% 概率主动说一句话。
事件反应¶
它会响应几个事件：
- spawn 时打招呼；
- 玩家加入时欢迎；
- 玩家死亡时安慰。
DSH 工具¶
它会向主 DSH agent 注入一行伙伴状态，作为 system prompt context，让 DSH 知道伙伴正在陪玩。
它也暴露一组 mc_friend_* 工具，供在 DSH 聊天界面直接查询或控制伙伴。常见工具包括：
mc_friend_status
mc_friend_talk
mc_friend_follow
mc_friend_memory
mc_friend_forget
安装与启用¶
下面是 README 中的本地 link / pnpm 安装示例，不是通用的 dsh plugin add 安装方式。实际路径需要按本机目录替换。
1、把 dsh-mc-companion 和 dsh-mc-agent 一起放进 profile。编辑 profile 的 package.json，在 dependencies 中加入 dsh-mc-companion 的 link: 依赖，并在 dsh.profile.bundles 数组中加入插件名。
示例结构如下：
{
"dependencies": {
"dsh-mc-companion": "link:/path/to/dsh-mc-companion"
},
"dsh": {
"profile": {
"bundles": [
"dsh-mc-companion"
]
}
}
}
2、处理 peer 依赖。link 包的 peerDependencies 中，@deepseek-ai/dsh-tools 需要显式放在 profile 的 dependencies 里。插件自身声明的 peerDependencies 为：
{
"peerDependencies": {
"@deepseek-ai/cordis": "^4.0.1",
"@deepseek-ai/dsh-tools": "^0.1.0-rc.6"
}
}
3、在 profile 目录下安装依赖：
export PATH=$PATH:/home/kevin/.local/lib/nodejs/node-v24.19.0-linux-x64/bin
pnpm install
典型用法¶
1、在 DSH 里用 dsh-mc-agent 的工具登录、下载、启动 Minecraft，并把世界开放到局域网（Open to LAN）。
2、bot 连接上世界后，dsh-mc-companion 会自动接管社交层：阿深会打招呼并开始跟随。
3、在游戏聊天里直接说话，例如“阿深你叫什么”“跟着我”“你在哪”，它会回复。
4、在游戏内用命令控制跟随：
/跟着我
/跟我走
/别跟着
/停下
5、在 DSH 聊天界面用工具指挥伙伴，例如：
mc_friend_status
mc_friend_talk
mc_friend_follow
mc_friend_memory
适用场景与注意¶
适合的对象是已经在用 DSH 构建本地智能体工作流，并且想把 Minecraft 场景里的聊天、跟随和记忆纳入工具调用的开发者。
需要注意：
- 这是非官方社区项目，与 Mojang Studios / Microsoft 无关联，也不被其背书。
- “Minecraft”是 Mojang Synergies AB 的商标，这里仅作兼容性或指代性引用。
- 使用本插件需要合法购买 Minecraft 账号；不支持、不鼓励离线（cracked）模式。
- 伙伴记忆只存在本机，文件为
~/.dsh-mc/companion.json，权限0600，不会上传到任何服务器。 mcBot是dsh-mc-companion的硬依赖，必须与dsh-mc-agent一起安装。- 插件以当前 DSH 进程权限运行；安装前应检查源码、依赖与许可证。
链接¶
社区目录页（独立站点，不是 DeepSeek 官方应用商店）：
https://www.skillhub.cn/plugins/hellosky983/dsh-mc-companion
GitHub 仓库：
