echoo19/hearth
GitHub: echoo19/hearth
一款开源的 agent 原生桌面应用，让 AI coding agent 根据自然语言描述构建游戏并提供带记忆的自动化测试反馈。
Stars: 119 | Forks: 12
### 面向开放式 Agentic 游戏开发的应用
[下载](https://hearthengine.com/download) · [快速开始](docs/quickstart.md) · [工作原理](https://hearthengine.com/how-it-works) · [反馈](https://hearthengine.com/feedback)
[](LICENSE)
当前版本为 v1.8.0，支持 macOS、Windows 和 Linux。
## 这是什么
输入你想玩的内容。一个 coding agent 会将其构建出来，游戏会显示在
对话旁边的窗格中，并在 agent 工作时持续运行。提出
修改需求，看着它实时生效，而不是阅读关于它的总结。
没有项目格式，也无需学习引擎。agent 会将普通的
文件写入你电脑上的一个文件夹中，使用它认为合适的任何方式，并且
任何能在浏览器中运行的内容都能在该窗格中运行。你的游戏永远不需要
知道 Hearth 的存在。
而且，agent 就是你已经付费使用的那个。
## 记住一切的测试员
每个项目都会配备一个。它会在自己的浏览器中亲自玩你的游戏，并
记录下它的发现。在再次游玩之前，它会重新阅读这些笔记。
因此，它不会每次都大脑空空地出现。它会出现时就知道自己
上周卡在哪里，并去查看你是否已经修复了它。
这种记忆让它能够回答你每次修改后真正想问的、而没有历史记录的事物绝对无法回答的问题：**这有帮助吗？**
这是一个真实的会话，这是它在某个小型平台跳跃游戏的跳跃高度增加后，进行的第二次游玩：
每一项陈述都被定位到它发生时的具体帧，所以你可以直接去查看。它的
记忆是你项目中的一个普通 markdown 文件，所以当它对你的游戏产生误解时，你可以打开它并修改那一行。它旧的会话永远不会被
重写，所以你可以发现它什么时候改变了主意。
它不是一名优秀的玩家，也不会假装是。任何需要反应速度的内容都能打败它，它记录下的是它尝试了什么以及在哪里失败了，而从不声称自己通关了。它也不会告诉你你的游戏是否有趣。那部分依然由你决定。
它只在你提出要求时才会游玩，并且每一轮都在你自己的模型配额下运行。即使你在会话中途停止它，它仍然会写下笔记。更多信息请参阅
[docs/tester.md](docs/tester.md)。
## 使用你自己的 agent
**Claude.** Hearth 运行你已登录的 Claude Code，因此 API key 是
可选的。你在编写器中选择模型，并且在聊天中途切换会
在你的下一条消息中生效。还有一个单轮工作量调节器，用于当某个
修改需要更多或更少思考时使用。
**ChatGPT.** Hearth 会与你安装的开源
[Codex CLI](https://github.com/openai/codex) 进行通信，并且由 Codex 保持登录状态。
模型直接从二进制文件中启用，包含推理工作量。
**其他任何工具。** 侧边栏在聊天旁边有一个终端：一个真正的 shell，
在项目文件夹中打开，并且 hearth 工具已添加到 PATH 中。运行你喜欢的任何
agent CLI，窗格都会同步更新，因为无论如何 Hearth 都会监视该文件夹。
对话也会保留。聊天会在应用
重启和断开连接期间保留 agent 的工作记忆，并且停止一轮会暂停对话，而不是
结束它。实时的斜杠命令、结构化问题、精确批准、
工作流和子代理都来自各自已安装的 CLI。当某个功能属于
全屏终端 UI 时，**Continue in CLI** 会恢复该确切的提供商
会话，而不让原生适配器在它旁边运行。设置、附件、
技能和批准位于
[docs/agents.md](docs/agents.md)。
## 你的文件，你的文件夹，没有锁定
每个项目都是 `~/Hearth` 下的一个普通文件夹。移动它、备份它、在
任何编辑器中打开它、放到 GitHub 上，或者完全离开 Hearth 并
带走你的游戏。没有任何东西存在于数据库或云端中，也
没有什么需要导出的，因为它从未被困在任何地方。
你的对话也保存在那里，因此游戏如何制作的历史
会随项目一起保存。Hearth 自身的记录保存在 `.hearth` 文件夹中，该文件夹会自动排除在你的 git 历史之外。
[docs/projects-and-chats.md](docs/projects-and-chats.md) 包含了布局说明。
## 深入探索
- [docs/probe-shim.md](docs/probe-shim.md)：游戏可以通过它拥有的一个小文件为测试员命名其实体和动作。这是一种提议，什么也不说的游戏同样是一流的游戏。
- [docs/mcp.md](docs/mcp.md) 和 [docs/cli.md](docs/cli.md)：探针也是一个 MCP server 和 CLI，供在应用外工作的 agent 使用。
- [docs/connect-your-engine.md](docs/connect-your-engine.md)：不在浏览器中运行的游戏。
- [docs/roadmap.md](docs/roadmap.md) 和 [docs/architecture.md](docs/architecture.md)：下一步计划，以及该应用是如何整合在一起的。
- Hearth 曾经是一个 2D 游戏引擎。该引擎保留在 [`engine-v1`](https://github.com/echoo19/hearth/tree/engine-v1) 分支上（最终版本 [v1.2.1](https://github.com/echoo19/hearth/releases/tag/v1.2.1)）并且不再开发。
## 贡献与许可
开发设置、基本规则和 AI 贡献政策位于
[CONTRIBUTING.md](CONTRIBUTING.md)。Hearth 是免费且开源的，基于
[MIT 许可证](LICENSE)。