Files

moranzhi 94f67fa744 引入上下文片段、固定槽与投影排序，并完善机遇裁定与游玩期 UI。

把创作产物收敛为可挂载片段与 play_slots/context_order，同步修订世界模拟器模块与运行时拼装。

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

2026-08-03 01:36:32 +08:00

4.6 KiB

Raw Blame History

外部项目参考（按层借鉴）

以下仓库用于架构与实现参考。只借鉴标明的一层，不把外部项目整体耦合进本仓库实现。

本系统运行内核为自研（相位机 + tool loop + 声明驱动 Worker）。Mastra、Next.js、assistant-ui 等不是近端迁移目标；若引入，须经适配层，且领域对象不得保存框架内部类型。

许可证与再分发注意见仓库根 THIRD_PARTY_NOTICES.md。

参考原则

按模块读代码与文档，禁止整仓复制粘贴为业务内核。
借鉴交互/产品概念时，数据模型仍用本仓库 Book / Session / 黑板。
Prompt 拼接、权限、上下文编译由本仓库 Context Compiler 实现，不照搬他站拼接逻辑。
依赖使用 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 实现

tavern2agent（方法层）

仓库：https://github.com/Xerxes-2/tavern2agent
可借鉴：卡语义拆解中的 data / progressive 去向、真值与派生分离、主 GM + 旁观审计（少拆执行单元）、承重才立可变概念
落本地文档：progressive-data-design.md；技能 variable-design / variable-context
不借鉴为内核：Pi 宿主、per-card TS engine/reducer 代码生成、CodeAct 万能入口

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 接口形态
真值 / Data / Progressive 设计方法	tavern2agent（方法层）、SillyTavern 世界书概念
上下文片段 / 双锚点插入序	SillyTavern prompt_order / injection 概念（只借鉴形态，见 `context-fragment-design.md`）
聊天与 HITL UI	assistant-ui、CopilotKit、LobeChat
角色卡 / 世界书 / 存档体验	SillyTavern、LobeChat
模型接入与可观测	Mastra

系统架构总览见 architecture.md。

4.6 KiB Raw Blame History Unescape Escape