开发指南

这里是 Yuiju 的开发文档入口。第一次参与项目时，先完成本地启动，再根据要修改的模块阅读架构和边界说明。

从哪里开始

1. 本地开发：安装依赖、准备配置并启动服务。
2. 技术架构：了解 World、Message、Web、Memory 之间如何协作。

修改特定能力前

• 修改模型调用、Prompt 或 structured output：阅读 LLM 协定。
• 修改数据库、消息平台或 Python 记忆服务：阅读 外部依赖。

项目目录

目录	职责
packages/world	推进世界和角色行为，执行 Action
packages/message	接入 QQ、飞书等消息平台并生成回复
apps/dashboard	新版管理界面与 Hono 查询接口
packages/utils	配置、数据库、模型、记忆和 Prompt 等公共能力
packages/satorijs-adapter-onebot	将 OneBot 接入统一消息协议
packages/source	图片、音频、数据集和辅助脚本
packages/python	可选的长期记忆图谱服务

项目使用 pnpm workspace。上表中的旧版 World、Message、Utils 仍保留，旧 Web 已删除。Dashboard 使用新系统的 data/config/config.json，其他旧模块仍读取根目录的 yuiju.config.json。