NPC-Forge / TERMy Vibe 项目

项目简介

NPC-Forge 是一个用纯确定性方式构建对话式 Agent 的开源框架，核心特点在于完全运行在 CPU 上，不依赖任何机器学习模型或大语言模型（LLM）。这意味着 NPC-Forge 构建的 Agent 不会出现幻觉（hallucination）、生成内容垃圾（slop）或被安全对齐过滤器误拦截的问题。与其依赖模型随机生成结果，开发者可以用 NPC-Forge 快速构建确定性 Agent，对接任意工作流、API 或外部工具链。

TERMy 是 NPC-Forge 框架内置的第一个 NPC，它将自然语言翻译成 Linux shell 命令行，无需任何人工神经元即可工作。项目开发者是 PJON 网络协议的作者，PJON 已于 2025 年被苏黎世联邦理工学院（ETH Zurich）实现为 ASIC 芯片，表明其长期技术积累获得了学术界的认可。

核心功能

1. 确定性对话 Agent：基于规则和数据集的确定性对话逻辑，每个回复都有据可查，不会产生幻觉或安全对齐误拦截，适合对可靠性要求极高的自动化场景。

2. CPU 本地运行：不需要 GPU，不依赖云端 API，任何配备 CPU 的设备均可运行，包括嵌入式系统和老旧硬件，响应时间在毫秒级。

3. 多轮上下文管理：支持多轮对话上下文，保持话题连贯性，可处理打断、俚语、口误和词序颠倒等自然语言变体。

4. 情感分析：内置情感分析模块，Agent 可根据对话情感状态调整回复策略。

5. 工具调用支持：Agent 可触发外部工具和工作流，实现真实系统操作，如文件管理、API 调用等。

6. OpenAI 兼容 API：实现 OpenAI 风格的 API 接口，可无缝对接 Open WebUI、Copilot 等现有 LLM 工具链，将确定性 Agent 能力注入已有 AI 辅助编程工作流。

7. NDF 0.0 数据集格式：自定义数据集格式，简单易用，通过更新数据集文件并执行 npc-forge reboot 即可热更新 Agent 行为，无需重新训练。

8. TERMy 内置终端助手：内置的命令行助手，将自然语言转化为 shell 命令，支持自然语言查询系统状态和执行操作。

技术实现

NPC-Forge 的技术选型非常明确：用确定性设计替代随机生成。其核心依赖不是神经网络，而是：

FlintParser 解析器：负责将用户输入的自然语言转换为结构化命令，处理拼写错误、口语化表达和词序变化。解析结果经过精心设计的规则引擎匹配到对应的数据集条目，触发预定义的回复或工具调用。

FlintNPC 引擎：负责管理对话状态、多轮上下文和情感追踪。每个 NPC 拥有独立的人格数据集（dataset），人格通过 JSON/YAML 格式定义，包含触发条件、回复模板和分支逻辑。

NDF 0.0 数据集格式：NPC-Forge 的数据集格式经过专门设计，支持快速迭代。开发者只需编辑数据集文件，无需修改核心代码，通过 npc-forge reboot 热更新即可生效，极大降低调试和优化成本。

TCS 0.0 命令安全机制：Terminal Commands Security 规范定义了哪些系统命令可以自动执行，哪些需要用户明确批准，防止破坏性操作被意外触发。这是 NPC-Forge 从框架层面保障安全的机制。

整个框架使用 Shell 脚本和 JavaScript 实现，安装和启动流程极简：git clone → ./setup.sh → npc-forge install npcs/termy → termy [你的问题]，60 秒内即可完成从安装到第一个对话的全流程。

快速上手

第一步：克隆并安装框架

git clone https://github.com/gioblu/NPC-Forge.git
cd NPC-Forge && chmod +x setup.sh && ./setup.sh

第二步：安装 TERMy NPC

npc-forge install npcs/termy

第三步：启动对话

termy 你好，请帮我查看当前目录下的文件

第四步：自定义 NPC（可选）

编辑 npcs/termy/dataset 目录下的数据集文件，添加自定义问答对或命令映射，完成后执行：

npc-forge reboot

常用 NPC-Forge CLI 命令：

• npc-forge list — 列出已安装的所有 NPC
• npc-forge test — 运行 NPC 测试套件
• npc-forge serve — 启动 OpenAI/Copilot 兼容 API 服务器
• npc-forge stop — 停止服务
• npc-forge watch — 启动服务并实时监控日志

适用人群

1. Linux/嵌入式开发者：在服务器或嵌入式设备上工作的开发者，TERMy 可在不依赖云端 API 的前提下提供本地命令行辅助能力。

2. 隐私敏感用户：不希望将工作内容发送给第三方 LLM 服务，或在断网环境工作的用户，NPC-Forge 完全本地运行。

3. AI 工程研究者：研究非 LLM 的 Agent 架构的学者和工程师，NPC-Forge 提供了一个可扩展的实验框架，数据集驱动的方式便于对比实验。

4. 复古计算爱好者：希望在老旧硬件上运行 AI 对话能力的用户，NPC-Forge 对硬件要求极低，可在树莓派等设备上流畅运行。