你在 DeepSeek Harness 里照常写代码、查资料、做交付——同时活在一个 Minecraft 生存世界里：每写一个文件掉 1 饥饿，深夜干活会刷怪，没有铁镐连 subagent 都调用不了。饿了得吃，夜了得防，死了背包全掉、经验减半，新会话从重生点复活。

所有规则由引擎硬结算（不是人设演戏），所有游戏概念对齐原版 Minecraft 生存模式，所有插件机制遵循官方插件规范（与 dsh-collaboration 套件同构）。

套件版本 0.1.0：engine 0.13.0 · tool-survival 0.6.0 · hud 0.1.3 · 安装指南 · GitHub Releases

核心特性

• 🎮 原版概念硬结算：生命 20（10 心）、饥饿 20、昼夜、夜晚刷怪——全部由引擎在 tools/pre-execute 实时结算，不是人设演戏
• 🧑‍🚀 用户是玩家：agent 是化身与执行者——播报状态、听令行事，可一句话授权托管
• ⛏️ 工作即挖矿：写文件、完成目标、退出计划都会掉落原版矿石与经验
• 🔒 真实工具门禁：没有铁镐就用不了 subagent，没有望远镜就上不了网——像没有镐子挖不了钻石
• 💾 世界存档跨会话：天数、经验、成就、墓碑持久化；死亡掉落、新会话重生
• 🖥️ 浏览器状态栏：心+鸡腿+昼夜+经验，只在生存模式会话显示（OpenMoji 图标，无版权风险）

目录

1. 快速上手
2. 玩家与化身（播报与听令）
3. 世界规则
4. 生存工具
5. 挖矿与掉落
6. 合成与物品
7. 工具门禁
8. 死亡与重生
9. 难度档
10. 进度（成就）
11. 设定（settings.yaml）
12. 存档与持久化
13. 浏览器状态栏
14. 小贴士
15. 故障排查
16. 组件与架构
17. 素材许可
18. 开发
19. 已知不足与参与贡献

快速上手

1. 按 docs/installation.md 安装并重启 DSH；
2. 新建会话，选择预设「生存模式」；
3. 直接开始真实工作（编码、查资料、写文档照常）——引擎在后台硬结算你的生存状态；
4. 输入框上方出现状态栏：❤️ 生命（10 颗心 = 20 血）、🍗 饥饿（10 根鸡腿 = 20 饥饿）、☀️/🌙 天数、⭐ 经验；
5. 用 survival_status 查看完整状态与配方书；完成任务会掉落材料，survival_craft 合成，survival_eat 吃东西，survival_sleep 睡觉。

一句话玩法：工作即挖矿，挖矿得材料，材料合成物品，物品解锁能力与防御；饿了吃、夜了防、够了合成；死了新会话复活，世界继续。

玩家与化身（播报与听令）

你是玩家，agent 是你的化身与执行者。 生存决策由你拍板：

• 化身只播报、执行：引擎在状态跃迁时推送事件（见下方「跃迁播报」），agent 收到后第一时间向你汇报状态与选项；吃、睡、合成什么默认等你的指令，agent 只做你布置的真实工作本身。
• 可一句话授权托管：说"生存你自己管"，agent 就会自主管理（饿了自己吃、夜了自己防）；想收回就说"生存听我指挥"。
• 娱乐性就在这里：你一边布置真实工作，一边要时刻留意状态、指挥进食与合成、亲手解锁新能力——分心就会饿死或被夜袭。

跃迁播报

引擎只在状态变化瞬间推送一条消息（不刷屏，恢复后重新武装）：

播报是插件来源消息，不推进游戏时间（只有真实用户消息算对话回合）。

世界规则

生命与饥饿

• 行动消耗饥饿：普通工具调用 −1（重型工具同为 −1，但受工具门禁约束）。
• 回合回复饥饿：每个对话回合 +1（休息节奏，纯聊天也能续命）。
• 免费动作（不耗饥饿、不推进时间）：生存工具本身，以及观察与交谈类——read / glob / grep / read_image / ask_user / todo_write / create_goal / get_goal / skill / job_list / job_output / job_kill / list_agents。
• 饥饿归零 → 每次行动掉 1 血（和平难度除外）。
• 自然再生（回血）：每个对话回合结算时，饱食度 ≥ 10 → 回复 1 血；和平难度无条件回血。饿着不会回血、只会掉血——吃饱才能养伤。

昼夜

• 昼夜由对话回合推进：每个用户消息算 1 个回合（纯聊天也过天）；一天的长度在设定里配置（默认 8 个回合），最后 1/3 是夜晚。
• 工具调用不推进时间，但会结算饥饿与怪物遭遇。
• 白天偶尔遇到羊（掉羊毛，用来做床）；夜晚刷怪。

夜晚怪物

防御手段见 物品：火把压制刷怪（概率 ×0.8，不是免疫）、剑自动反击（石 40% / 铁 60% / 钻石 90%，品质优先）、盾牌格挡、床睡觉跳过夜晚。

生存工具

挖矿与掉落

挖矿 = 完成任务。引擎监听真实的任务信号，成功即掉落（经验同时入账）：

铁矿石/铜矿石需要熔炉熔炼成锭才能用于合成；红石粉、钻石、紫水晶直接可用。

经验（⭐）

附魔系统暂未实装（避免功能过多）；铁砧修复是当前经验的唯一消耗途径——攒着修工具，别随便死。

合成与物品

材料一览

配方大全（survival_craft 的 recipe 参数）

基础

熔炼（需先有熔炉）

食物与工具

红石电路

铁砧与修复（经验的用途）

修复要求目标工具存在且有损伤（耐久低于上限）；修复不能超过上限。耐久数值在 settings.yaml 可调，修复量随之上限的一半联动。

物品使用方式

• 面包：survival_eat 自动消耗；饥饿归零前记得吃。
• 火把 / 望远镜 / 红石中继器 / 熔炉 / 床：合成即生效（放进物品栏自动起效），无需装备。
• 铁镐：调用 subagent/subagent_fork 时自动消耗 1 耐久；耗尽即失效，需重新合成（可多次合成叠加耐久）。
• 剑（石/铁/钻石）/ 盾牌：夜间遭遇怪物时自动判定反击/格挡，无需操作；多把剑并存时自动用最好的。
• 床：夜晚用 survival_sleep 睡觉；白天不能睡。
• 耐久池：工具可重复合成叠加（如两把铁镐 = 240 耐久）。

工具门禁

生存模式里，高级能力需要先合成对应物品——就像没有镐子挖不了钻石。引擎在 tools/pre-execute 真实拦截（不是人设演戏）：

没有对应物品时调用会被拒绝，并提示所需配方。tool-ralph 不存在于本预设——命令方块是创造模式专属，生存模式不可合成（原版设定）。

死亡与重生

• 死亡：血量归零 → 原版死亡信息（"你被苦力怕炸死了！"）→ 掉落全部背包物品与材料（床除外）→ 经验减半 → 墓碑入档。
• 死亡后本会话即终结：除生存工具外的所有工具调用被拒绝，状态栏显示 ☠️——写下遗言，然后结束会话。
• 重生：新开一个生存模式会话即复活。世界天数、经验（死亡时已减半）、进度保留；有床则床保留（重生点）；背包从零开始。
• 极限模式（hardcore）：死亡即删档，世界归零。

难度档

在 settings.yaml 的 dsh-survival.difficulty 选择：

注意：与原版一致，难度不影响工具门禁——和平难度下依然需要铁镐才能用 subagent。

进度（成就）

原版成就名，随存档永久保留：

设定（settings.yaml）

${DSH_HOME}\settings.yaml 的 dsh-survival 段（不写则全部用默认值）：

dsh-survival:
  difficulty: normal        # peaceful | easy | normal | hard | hardcore
  dayLengthTurns: 8         # 一天包含的对话回合数（用户消息），最后 1/3 为夜晚
  mobChance: 0.3            # 夜晚每个回合/工具调用的刷怪基础概率（0–1）
  torchMobFactor: 0.8       # 持有火把时刷怪概率的倍率（光照压制；0=免疫）
  hungerPerAction: 1        # 普通工具调用的饥饿消耗
  heavyHunger: 1            # 重型工具（web/subagent/workflow）的饥饿消耗
  breadHunger: 8            # 面包回复的饥饿值（食物链净收益转正）
  pickaxeDurability: 120    # 铁镐耐久（subagent 可用次数池，修复量为其一半）
  swordDurability: 100      # 铁剑耐久（反击次数池）
  stoneSwordDurability: 50  # 石剑耐久（入门反击池）
  diamondSwordDurability: 200 # 钻石剑耐久（反击次数池）
  shieldDurability: 120     # 盾牌耐久（格挡次数池）
  smallLootChance: 0.7      # 写文件触发小矿的概率（0–1）

存档与持久化

浏览器状态栏

输入框上方的整行状态栏，只在「生存模式」会话显示，其他模式完全不可见（由 capability 门禁保证）：

• 10 颗心（满心 = 2 血、半心 = 1 血、黑心 = 空）
• 10 根鸡腿（满 = 2 饥饿、半 = 1、灰 = 空）
• ☀️/🌙 + 天数、⭐ + 经验
• 死亡后显示 💀 + 死亡信息
• 每 2 秒自动刷新，悬停显示精确数值

图标来自 OpenMoji（CC BY-SA 4.0），同一图标家族、尺寸风格严格一致。

小贴士

• 指挥节奏：收到跃迁播报（入夜/低饥饿/低血量）就下指令；想省心开局说一句"生存你自己管"即可托管。
• 开局节奏：先干活挖矿（写文件就有掉落）→ 小麦×3 合成面包保命 → 圆石×8 出熔炉 → 铁矿石熔炼 → 铁镐解锁 subagent。深挖（完成目标）才有红石和钻石。
• 夜晚应对：火把（煤+木棍）把刷怪压到 ×0.8，但不是免疫——铁剑/盾牌仍是硬防线；有羊毛就做床睡觉彻底跳过夜晚。
• 饥饿管理：观察（read/grep）和交谈（ask_user）免费，规划可以放在对话里；批量重活前先吃饱。
• 死亡不是失败：掉落有墓碑记录，世界进度延续；极限模式另说。
• 别浪费回合：门禁拦截是真实的——没合成望远镜前别反复试 web_search。

故障排查

组件与架构

引擎发布 survivalEngine 服务，消费者全在预设内部；跨会话存档通过消费宿主 storageDomain 服务完成。唯一的宿主行是 @dsh-survival/hud（预设 realm 对宿主不可见，浏览器 RPC 需要宿主侧 Remote——api-proxy 读 goals/skills 的同一官方通路）。

素材许可

状态栏图标来自 OpenMoji（CC BY-SA 4.0，署名-相同方式共享），同一 72×72 图标家族，见 packages/hud/assets/ATTRIBUTION.md。不包含任何 Minecraft 版权素材。

开发

pnpm install
pnpm run build       # tsup 构建 lib/（hud 含 client 包）
pnpm run typecheck   # 先 build 再 typecheck（工具包依赖引擎的 d.ts）
pnpm run pack        # 打包 tgz 到 dist/

安装到 DeepSeek Harness 见 docs/installation.md。

已知不足与参与贡献

本项目是娱乐向的独立作品，仍有许多不足与未实现的构想，期待开发者提 Issue 与 PR 共同改进：

• 附魔台：MC 经验系统的灵魂（赌附魔书、效率/耐久/锋利等效果），目前经验的唯一消耗途径只有铁砧修复
• 更多原版物品：盔甲、铁斧、锄头等工具体系，以及下界/末地概念
• 更多原版事件：雷暴（配合避雷针给铜锭第二种用途）、村民交易等
• 状态栏交互面板：只读的背包/配方面板（此前讨论过的方向，尚未实装）
• 多语言：README 与游戏文案目前以中文为主
• 测试覆盖：目前靠人工实测，欢迎补充自动化测试

欢迎 fork 本仓库并提交 PR——修复 bug、补充测试、调整平衡性、新增玩法模块皆受欢迎。提交前请了解架构约定：引擎与工具属于预设 isolate realm（服务不发布进 root realm），宿主侧仅 @dsh-survival/hud 状态栏桥一行；跨会话存档通过宿主 storageDomain 服务完成。