重构世界模拟器为模块化配方架构，完善创作编排、会话运行时与 Web UI，并清理过时技能。

Co-authored-by: Cursor <cursoragent@cursor.com>

docs/references.md

@@ -0,0 +1,88 @@
+# 外部项目参考（按层借鉴）
+
+以下仓库用于架构与实现参考。**只借鉴标明的一层，不把外部项目整体耦合进本仓库实现。**
+
+本系统运行内核为自研（相位机 + tool loop + 声明驱动 Worker）。Mastra、Next.js、assistant-ui 等**不是**近端迁移目标；若引入，须经适配层，且领域对象不得保存框架内部类型。
+
+许可证与再分发注意见仓库根 [`THIRD_PARTY_NOTICES.md`](../THIRD_PARTY_NOTICES.md)。
+
+---
+
+## 参考原则
+
+1. 按模块读代码与文档，禁止整仓复制粘贴为业务内核。
+2. 借鉴交互/产品概念时，数据模型仍用本仓库 Book / Session / 黑板。
+3. Prompt 拼接、权限、上下文编译由本仓库 Context Compiler 实现，不照搬他站拼接逻辑。
+4. 依赖使用 lockfile 精确版本；对外部项目的修改放在适配层。
+
+---
+
+## 仓库与借鉴层
+
+### Mastra
+
+- 仓库：<https://github.com/mastra-ai/mastra>
+- **可借鉴**：Agent/Tool 声明方式、模型 Provider、结构化输出、Memory/Storage 接口形态、Workflow 适用边界、Observability、TypeScript 组织
+- **不借鉴为内核**：不把动态调度、上下文权限、Definition/Instance、事件存档交给 Mastra 领域模型；本仓库已有 phase-runtime
+
+### assistant-ui
+
+- 仓库：<https://github.com/assistant-ui/assistant-ui>
+- **可借鉴**：流式聊天、消息组件、Tool 调用展示、会话状态、人工确认、前后端连接方式
+- **不负责**：Definition、存档、多 Agent 调度模型（仍由本仓库 API + Runtime）
+
+### LobeChat
+
+- 仓库：<https://github.com/lobehub/lobe-chat>
+- **可借鉴**：本地 AI 应用信息架构、会话列表、模型配置 UI、助手/角色配置、插件与知识库管理体验、布局
+- **不直接采用**：其会话数据模型
+
+### SillyTavern
+
+- 仓库：<https://github.com/SillyTavern/SillyTavern>
+- **可借鉴**：角色卡产品概念、世界书编辑体验、聊天存档与分支心流、角色扮演工作方式、导入导出与兼容性概念
+- **不照搬**：Prompt 拼接逻辑；世界书检索与权限由 Context Compiler 实现
+
+### LangGraph.js
+
+- 仓库：<https://github.com/langchain-ai/langgraphjs>
+- **可借鉴**：有状态 Runtime、Checkpoint、中断与恢复、Human-in-the-loop、长时间任务可恢复执行
+- **不采用**：用固定 Graph 表达整场创作流程（本仓库用相位机 + 动态 tool loop）
+
+### AutoGen
+
+- 仓库：<https://github.com/microsoft/autogen>
+- **可借鉴**：多 Agent 消息与生命周期、Agent 选择、事件驱动运行、Tool 执行边界、Runtime 抽象
+- **不采用**：Agent 间自由转发消息作为权限模型；上下文不得依赖自由转发
+
+### Letta
+
+- 仓库：<https://github.com/letta-ai/letta>
+- **可借鉴**：长期记忆分层、上下文窗口管理、状态与消息历史区分
+- **仍需自建**：小说、世界书、角色私有状态等领域模型
+
+### OpenHands
+
+- 仓库：<https://github.com/All-Hands-AI/OpenHands>
+- **可借鉴**：运行会话、事件流、Action/Observation、前后端状态同步、暂停恢复与可观测性
+- **不参考**：软件工程沙箱任务模型
+
+### CopilotKit
+
+- 仓库：<https://github.com/CopilotKit/CopilotKit>
+- **可借鉴**：Agent 与前端状态连接、流式事件、Human-in-the-loop、生成式 UI、动态表与确认交互呈现
+- **不替代**：本仓库 Book/黑板领域模型
+
+---
+
+## 与本仓库模块的映射
+
+| 本仓库模块 | 主要可参考项目 |
+|------------|----------------|
+| Runtime / 调度 / 恢复 | LangGraph.js、AutoGen、OpenHands、Mastra（边界） |
+| 上下文与记忆 | Letta、Mastra Memory 接口形态 |
+| 聊天与 HITL UI | assistant-ui、CopilotKit、LobeChat |
+| 角色卡 / 世界书 / 存档体验 | SillyTavern、LobeChat |
+| 模型接入与可观测 | Mastra |
+
+系统架构总览见 [`architecture.md`](./architecture.md)。