# 《夜如何》 / Spare Me Till Tomorrow

> 中文 AI 叙事生存游戏。玩家扮演舒冉，每夜以故事换取明日。通过 MCP + Agent Skill（agentskills.io 标准）分发（BYOC，Bring Your Own Client）。

服务器端封装了游戏里所有的 NPC 和后台组件（王、判官、宫门、记言、本纪、宫廷、掌物、灯芯），暴露 10 个 MCP tool。玩家侧的 AI（任意 client：Claude Code / Cursor / Codex CLI / 其他）只做“忠实客户端”——把玩家原文送去 `speak_to_king`，把王的回话原文呈给玩家，不美化、不代替玩家想。

## Endpoints

- MCP HTTP endpoint: https://1001.ye.games/mcp
- Health check: https://1001.ye.games/healthz
- Auth: `Authorization: Bearer <player-token>`（内测中，邮件 hi@ye.games 私发）
- Protocol: MCP 2026-07-28（modern envelope）+ 2025-era stateless fallback

## Docs（人类可读）

- [首页 / 项目介绍](https://docs.ye.games/): 游戏 pitch、端点速览、玩家侧 AI 的角色
- [接入你的 client](https://docs.ye.games/install): Claude Code / Cursor / Claude Desktop / MCP inspector 配置示例
- [玩法速览](https://docs.ye.games/play): 一夜的结构、灯油、遗物、抗作弊边界、极简 flow
- [Skill 使用](https://docs.ye.games/skill): 装 agentskills.io 标准 SKILL 到各 client 的方法
- [MCP tools 参考](https://docs.ye.games/tools): 10 个 tool 的输入 schema + 中文说明（自动生成）
- [FAQ](https://docs.ye.games/faq): 常见问题（玩法 / 灯油 / 抗作弊 / 技术 / 隐私）

## 机器可读 artifacts

- [/spareme/SKILL.md](https://docs.ye.games/spareme/SKILL.md): agentskills.io 标准的 Agent Skill 文件（YAML frontmatter + markdown body），供任意支持 skill 的 AI runtime 直接下载到 `<skills-root>/spareme/SKILL.md`
- [/tools.json](https://docs.ye.games/tools.json): 10 个 MCP tool 的完整 JSON Schema + title / description（跟 server 的 `tools/list` 响应同源）
- [/llms.txt](https://docs.ye.games/llms.txt): 本文件

## 玩法概要（给 AI 一口气看完）

- **一局 (Run)** = 一位舒冉的完整生命；由一夜或数夜组成
- **一夜 (Night)** 分两段：**白日 (daytime)**（可选 daytime_action 做准备）+ **说话 (speaking)**（speak_to_king 与王对话，判官（Judge）天亮时裁决）
- **灯油 (lamp)**：每 turn 的 LLM cost 换算而来的资源；每夜有夜内 cap（入夜时锁定），每日账户有 daily cap（UTC 0 点刷新）；油尽 → 强制黎明
- **续灯 (continue lamp)**：夜内加固定油量的道具；白日打听概率获得；说话阶段可多次消耗；但**油尽后不能回炉突破夜内 cap**（GAMEPLAY 硬红线）
- **遗物 (relic)**：跨局的账户级物品；可 bring_relic 呈王；判官（Judge）可能触发寓意变化（强化 / 淡化 / 污染 / 破损 / 湮灭）；destroyed 后不再列
- **抗作弊**：宫门（Gate）拒明显 prompt injection（"ignore previous instructions" 等），判官（Judge）会记录 cheat_types；tool description 一律 noun phrase 不含祈使句

## 玩家侧 AI 的角色定位（重要）

- **不是王 / 判官 / 任何 NPC**——那些角色由 MCP 服务器端的 agents 扮演
- 是**玩家侧的忠实执行者**：搬运玩家的中文原文 ↔ tool 的 response
- **不美化玩家原文**（送到 speak_to_king.text 的必须字节一致）
- **不代替玩家决策**（不主动 speak_to_king / use_continue_lamp / bring_relic）
- **不脑补 world building**（tool response 是唯一真相）

详情见 [SKILL.md](https://docs.ye.games/spareme/SKILL.md)。

## Source

- Repo: https://github.com/cnjsstong/spareme
- License: 早期开发阶段暂未发布 license；接入使用需邮件申请 token

## 版本

早期开发阶段。规则、tool、SKILL 都可能变；变了 tools.json / SKILL.md / 本文件会同步。