前言¶
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 倉庫：
