docs(add):更新Arabica Sprint2 系统组件架构设计说明文档

Signed-off-by: gzkoala <guohao@gitconomy.org>
This commit is contained in:
gzkoala
2026-03-05 15:38:00 +08:00
parent 8b6c74954a
commit c4d4f4859b

View File

@@ -118,12 +118,17 @@ project-caffeine/
![Sprint2组件架构图](./../../../docs/assets/images/arabica-srpint2-architecture-design.svg)
架构图中的核心数据链路包含以下四个关键环节
Sprint 2 系统组件架构在 Sprint 1 的基础上,将提示词策略 ServerS2从单一工具升级为多维思维框架引擎。核心组件包括
- **发起框架请求**:客户端(如 Cherry Studio接收用户的自然语言查询后大语言模型会自主决策并向服务端发起 `prompts/get` 请求,以获取最匹配的静态思维框架模板(例如 SCQA 框架)
- **分发提示词模板**:服务端的 `promptsController.js` 负责接收请求,并通过更新后的 `promptService.js` 从新增的 `src/models/frameworks/` 目录中加载对应的框架 JSON 定义,将其作为增强提示词下发给客户端。
- **执行意图拆解**:大模型在进行初步推理时,可通过调用新增的 `generate_search_queries` 工具来深化研究广度。此时,`toolsController.js` 会将请求路由分发至专属的 `intentService.js`,由该服务将用户的原始模糊查询精准拆解为 3-5 个专业检索词。
- **约束结构化输出**系统通过在提示词模板的系统消息System Prompt中注入多智能体角色矩阵雏形与少样本Few-Shot示例强制约束大模型结合生成的检索词与分析框架最终输出符合标准规范的深度 Markdown 报告。
- 控制器层:新增 promptsController.js 专门处理 MCP Prompts 原语prompts/list 和 prompts/gettoolsController.js 扩展支持 generate_search_queries 工具调用
- 服务层promptService.js 升级为多框架管理器,从 models/frameworks/ 目录加载 JSON 定义的思维模板5W3H、SCQA、SWOT、PESTLE 等);新增 intentService.js 实现意图拆解逻辑,将自然语言查询转化为专业检索词。
- 模型层schemas.js 增加 Prompts 参数和意图拆解工具的 Zod 校验frameworks/ 目录以 JSON 形式存放各框架的元数据、模板内容和角色定义。
- 主入口app.js 同时注册 Prompts 和 Tools 能力,通过 stdio 与客户端通信。
该架构的核心数据链路分为四步:客户端通过 prompts/get 获取匹配的思维框架模板;服务端返回结构化提示词;大模型在推理中可调用 generate_search_queries 获取检索词;最终通过模板内嵌的系统消息(含角色矩阵和 Few-Shot 示例约束输出格式生成符合规范的深度报告。这一设计为后续文献检索Sprint 3和递归深度研究奠定了坚实的“大脑”基础。
---