3.9 KiB
3.9 KiB
外部项目参考（按层借鉴）
以下仓库用于架构与实现参考。只借鉴标明的一层，不把外部项目整体耦合进本仓库实现。
本系统运行内核为自研（相位机 + 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 实现
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。