Rein-NPC playground

Rein-NPC playground

让你和一个小镇里的三个游戏角色对话，它们由一个只下载一次、在浏览器里运行的 4B 模型扮演，每条回复下面都会显示模型做出的决定。

由 jmc0 在 Hugging Face 上制作。这些说明是 Mindket 根据它的 Space 页面和 README 写的，应用自己的文件和许可证在 Hugging Face 上。

简介

它是什么：Rein-NPC playground 是 jmc0 发布在 Hugging Face Space 上的一个静态网页。它把你放进一个小镇，里面有一位店主、一位战地医护兵和一位城门队长。你走到其中一个面前，就可以开口对话。扮演他们的是一个叫 Rein-NPC-4B 的 4B 模型，它就在你的浏览器里运行。

适合谁：适合想看小模型怎样驱动角色和工具调用的游戏开发者和模型研究者，也适合想不装任何东西就和游戏角色聊天的好奇的人。

行业 | 谁在用 | 怎么用 | 例子
游戏开发 | 游戏开发者 | 和三个角色对话，读每条回复下面显示的决定 | 看一次工具调用怎样改变小镇里的金币或库存
机器学习 | 模型研究者 | 通过它的页面试用 Rein-NPC-4B 模型 | 检查模型什么时候认为需要工具调用，什么时候不需要
网页开发 | 前端开发者 | 下载文件，阅读 js 文件夹 | 研究模型怎样通过 WebAssembly 和 WebGPU 在浏览器里运行

如果你想要一个完整的游戏，或者背后有服务器的聊天机器人，可以跳过它，因为这个页面只是一个小镇。

用在哪里：这个演示可以在这些地方使用。

• 网页浏览器：Chrome 或 Edge 通过 WebGPU 走快速路径，其他浏览器会退回到很慢的 CPU 版本
• Windows、macOS 或 Linux：用 Python 下载文件，然后在浏览器里打开 index.html

用途 | 谁用 | 能得到什么
和角色对话 | 任何好奇的人 | 一条符合角色的回复，下面列出模型做出的决定
观察小镇变化 | 游戏开发者 | 由工具结果更新的金币、库存、生命值、城门和守卫
清除缓存 | 磁盘空间不够的人 | 从浏览器里删掉模型文件，还可以选择重新下载

如何设置：在线使用需要一个浏览器，首次加载时还需要网络连接。想放一份本地副本，还要准备几样东西。

• 一个网页浏览器，最好是 Chrome 或 Edge
• 一次性下载模型所需的网络连接，共 3.07 GB，分四个文件
• Windows、macOS 或 Linux 上的 Python，用于本地副本

1. 如果你只想在线使用，打开它在 Hugging Face 上的 Space 页面。
2. 想要本地副本的话，先用 pip 安装 Hugging Face hub 库。
3. 把这个 Space 的文件下载到名为 rein-npc-playground 的文件夹里。
4. 进入这个文件夹。
5. 在网页浏览器里打开 index.html。

pip install -U huggingface_hub
hf download jmc0/rein-npc-playground --repo-type space --local-dir rein-npc-playground
cd rein-npc-playground

如何使用：在线使用时，打开 Space 页面，等一次性的模型下载完成，然后走到一个角色面前开口对话。每条回复下面，页面都会列出模型做出的决定。有了本地副本，就进入这个文件夹，在浏览器里打开 index.html。

cd rein-npc-playground

工具 | 作用
js/config.js | 把所有常量放在一个地方
js/rein.js | 实现决策协议
js/chat.js | 构建聊天提示词，运行生成，并从输出里读出工具调用
js/npcs.js | 定义三个角色，以及他们的动作在游戏里的效果
js/game.js | 运行这个小镇
js/model.js | 下载模型，缓存并加载它
js/ui.js | 绘制各个面板
js/main.js | 把其他文件连起来

示例：你走到店主面前，聊起想买点东西。模型先回答这个角色的规则，再写出回复，页面把决定列在回复下面。随后工具的结果可以改变你的金币或店里的库存。

新手与专家：如果你是新手，先用 Chrome 或 Edge 打开页面，等下载完成，再和战地医护兵聊聊。读一读每条回复下面的决定，看看模型选了什么。

如果你熟悉这个领域，Rein-NPC-4B 基于 Qwen3.5-4B 构建，Rein 的决策模型被打包进同一个文件。它通过 wllama 运行，wllama 是为 WebAssembly 和 WebGPU 编译的 llama.cpp。同一个模型在写每一句话之前，先回答这个角色的规则。它要判断是否调用工具、调用哪一个。它还要检查有没有人在改写这个角色的名字，以及世界里的某个事实是不是受到了攻击。页面像游戏一样应用这些答案。它填好工具调用，在不需要时拦下工具调用，规则触发时再提醒模型这条规则的依据。Q4_K_M 文件被切成四块，每块不到 1 GB，因为 wllama 需要小于 2 GB 的文件。

你走到一个角色面前开口对话
模型回答这个角色的规则
模型写出回复
页面把决定应用到小镇上

注意事项：一切都在你的浏览器里运行，但第一次加载需要网络。

• Download: Q4_K_M 版 3.07 GB，分四个文件，一次性取进浏览器缓存
• Speed: Chrome 或 Edge 里的 WebGPU 很快，CPU 版本很慢
• Privacy: 模型在你自己的机器上运行，你输入的内容留在那里
• Network: 本地副本仍然要从 jsDelivr 加载 wllama 和模板渲染器，并从 GGUF 仓库加载模型文件
• Models: jmc0/Rein-NPC-4B 和 jmc0/Rein-NPC-4B-GGUF
• Size: 仓库里有 16 个文件
• License: apache-2，美术资源是 CC0
• Cost to run: 没有提到
• Data it reaches: 它下载的库和模型文件，不包括你输入的内容
• Not for: 没有网络连接的使用，因为页面要通过网络加载它的库和模型

Hugging Face 上的数据（2026年11月13日）

• 点赞：1
• 构建方式：static
• 许可证：apache-2.0

链接

• Space：https://huggingface.co/spaces/jmc0/rein-npc-playground
• 文件：https://huggingface.co/spaces/jmc0/rein-npc-playground/tree/main

试用

在浏览器里打开这个 Space，或在它的页面上把它复制到你自己的 Hugging Face 账号。这个工具包里没有会自己运行的东西。