A set of NPC Agent framework that can be reused in various games

Project overview

一套可复用在各种游戏上的 NPC Agent 框架，基于 DeepSeek Harness（dsh）构建。

核心是一句话：agent 做大脑，tool 做手脚，SQLite 做记忆，游戏引擎做皮囊。 想了解这套设计背后的完整推演、以及我们对未来 AI 游戏的判断，见 docs/design.md。 框架 vs 游戏是硬边界。 src/framework/ 不含任何游戏或客户端知识——没有货币名、没有地点、没有工具名、没有 three.js。它只依赖一个 GameWorld 接口。这条边界由 tests/layering.spec.ts 机械守护：往框架里写一个 player-1 或 npcspeak，测试就红。换个游戏 = 换 src/game/，框架一行不动。

依赖方向单向：游戏 → 框架 → dsh，从不反向。src/plugin.ts 是唯一把三者拼在一起的地方（composition root）。 1. 五分钟跑起来（不需要 API key）