covel

Covel 是一个模块化、智能体化的 AI 角色扮演游戏框架，也是一个可游玩的工作室。其架构分为内核（调度、上下文组装、工具、校验、持久化、渲染）、插件包（游戏行为，如代理与函数运行时、UI、模式、工具、事件、投影和生命周期钩子）以及可移植世界包（设定、角色、规则、插件默认值、记忆块、任务、物品、立绘和场景）。它包含两种游玩模式：舞台模式是全屏视觉小说，提供场景背景、角色立绘、打字机式对话、选项覆盖层，并可为新地点按需生成背景；故事模式基于文本，包含叙述回合、建议行动、内联表单，以及每回合的代理时间线。插件是能力包，而不是固定角色。内置示例包括 narrator、codex、core-quest 等代理运行时；pregame、dice-check/roller、scene-cast 等函数运行时；npc-graph 和图像生成等混合包；cost-gate、story-guard、director 等生命周期钩子；以及 memory、character-blueprint、character-presence 等 UI 或数据契约。内核通过发现能力和 outputKind 来工作，而不会基于具体插件 ID 分支，因此组件保持可替换。内置 RPG 机制包括预先掷骰的检定并显示可见的算术凭据、自动追踪的任务日志、玩家管理的物品栏，以及按 NPC 的好感度条；这些都是可选插件，世界可以预置开局任务、初始装备和初始好感度。每个回合结束后，共享的 WorldIR 事实投影让任务、物品栏、好感度、codex 和关系插件能够复用相同证据。世界包通过 world.yaml、WORLD.md 和 WorldData 导入声明；pluginPolicy 可将插件标记为必需、推荐或排除，memoryBlocks 可添加类型特定记忆，例如线索或信号日志。该框架提供 zh-CN、en-US 和 ru-RU UI 目录，并支持本地化插件说明、世界文件、角色数据和规则，同时回退到规范来源。Trace Inspector 按会话和回合分组执行，公开运行时、流程、LLM 请求、工具、消息、状态和钩子事件，并提供 Session Data 和 Cost 视图。存储以本地优先，使用磁盘上的 SQLite；Web 模式将 API 密钥保存在浏览器 localStorage 中，而桌面模式将其以明文保存在 ~/.covel/keys.env。项目提供 macOS Apple Silicon 和 Windows x64 的桌面构建，源码可通过 pnpm 运行 web 和 server 目标。内置世界包包括 Mistport Chronicles、Haruka Academy 和 Emberback Relay。作者可以通过 AI Create World 流程生成世界包，或使用 create-plugin 搭建插件脚手架。当前版本 v0.0.32 为早期访问，API、世界数据和插件清单可能在版本之间变化。项目采用 MIT 许可，社区中心和 marketplace 功能在路线图中。