# 外部项目参考（按层借鉴） 以下仓库用于架构与实现参考。**只借鉴标明的一层，不把外部项目整体耦合进本仓库实现。** 本系统运行内核为自研（相位机 + 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 - 仓库： - **可借鉴**：Agent/Tool 声明方式、模型 Provider、结构化输出、Memory/Storage 接口形态、Workflow 适用边界、Observability、TypeScript 组织 - **不借鉴为内核**：不把动态调度、上下文权限、Definition/Instance、事件存档交给 Mastra 领域模型；本仓库已有 phase-runtime ### assistant-ui - 仓库： - **可借鉴**：流式聊天、消息组件、Tool 调用展示、会话状态、人工确认、前后端连接方式 - **不负责**：Definition、存档、多 Agent 调度模型（仍由本仓库 API + Runtime） ### LobeChat - 仓库： - **可借鉴**：本地 AI 应用信息架构、会话列表、模型配置 UI、助手/角色配置、插件与知识库管理体验、布局 - **不直接采用**：其会话数据模型 ### SillyTavern - 仓库： - **可借鉴**：角色卡产品概念、世界书编辑体验、聊天存档与分支心流、角色扮演工作方式、导入导出与兼容性概念 - **不照搬**：Prompt 拼接逻辑；世界书检索与权限由 Context Compiler 实现 ### tavern2agent（方法层） - 仓库： - **可借鉴**：卡语义拆解中的 data / progressive 去向、真值与派生分离、主 GM + 旁观审计（少拆执行单元）、承重才立可变概念 - **落本地文档**：`progressive-data-design.md`；技能 `variable-design` / `variable-context` - **不借鉴为内核**：Pi 宿主、per-card TS engine/reducer 代码生成、CodeAct 万能入口 ### LangGraph.js - 仓库： - **可借鉴**：有状态 Runtime、Checkpoint、中断与恢复、Human-in-the-loop、长时间任务可恢复执行 - **不采用**：用固定 Graph 表达整场创作流程（本仓库用相位机 + 动态 tool loop） ### AutoGen - 仓库： - **可借鉴**：多 Agent 消息与生命周期、Agent 选择、事件驱动运行、Tool 执行边界、Runtime 抽象 - **不采用**：Agent 间自由转发消息作为权限模型；上下文不得依赖自由转发 ### Letta - 仓库： - **可借鉴**：长期记忆分层、上下文窗口管理、状态与消息历史区分 - **仍需自建**：小说、世界书、角色私有状态等领域模型 ### OpenHands - 仓库： - **可借鉴**：运行会话、事件流、Action/Observation、前后端状态同步、暂停恢复与可观测性 - **不参考**：软件工程沙箱任务模型 ### 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`](./architecture.md)。