From 98413b372c4e72fa1ded3f45593f9941840792d5 Mon Sep 17 00:00:00 2001 From: gzkoala Date: Sun, 8 Mar 2026 16:28:03 +0800 Subject: [PATCH] =?UTF-8?q?docs(update):=E6=9B=B4=E6=96=B0Porject=20Caffei?= =?UTF-8?q?ne=E7=B3=BB=E7=BB=9F=E6=95=B4=E4=BD=93=E6=9E=B6=E6=9E=84?= =?UTF-8?q?=E7=A4=BA=E6=84=8F=E5=9B=BE=EF=BC=8C=E6=A0=B9=E6=8D=AEMCP?= =?UTF-8?q?=E4=B8=89=E5=A4=A7=E5=8E=9F=E8=AF=AD=E4=BD=93=E7=B3=BB=E4=BF=AE?= =?UTF-8?q?=E6=94=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: gzkoala --- .../arabica-sprint3-architecture-design.svg | 480 ++++++++++++++++++ .../images/figure01-mcp-system-topology.svg | 98 ++-- 2 files changed, 525 insertions(+), 53 deletions(-) create mode 100644 docs/assets/images/arabica-sprint3-architecture-design.svg diff --git a/docs/assets/images/arabica-sprint3-architecture-design.svg b/docs/assets/images/arabica-sprint3-architecture-design.svg new file mode 100644 index 0000000..c71c245 --- /dev/null +++ b/docs/assets/images/arabica-sprint3-architecture-design.svg @@ -0,0 +1,480 @@ + + + + + + + + + + + + + + + + + + + + + + + + + FIG-02 + Arabica Sprint 3 系统开发组件架构图 + 架构图 > Arabica Sprint 3 > 文献检索与标准化落盘工作流 + + + + + + + + + + + + + 📦 MCP Server Runtime（Sprint 3) + + + + + + + ☁️ Cloud + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Query + Report + Reasoning / Tool Calls + LLM Result + + + tools/call + Result JSON + + stdio + + + HTTP GET (Search) + Metadata JSON + fs.writeFileSync() + + + + + + + + + + User / 用户 + + + + + + + + Cherry Studio (MCP Client) + 大模型对话与调度宿主 + Initiates stdio subprocess + + + + + + LLM + (Remote) + + + + + + + + Academic APIs + arXiv API + Semantic Scholar API + + + + + + + + app.ts + McpServer 注册原语 + Stdio Transport + + + + + + + + + promptsController + 处理 prompts/get + + + + + + + + toolsController + search_academic_literature + save_literature_to_vault + + + + + + + + resourcesController + 处理 resources/read 分发 + 含 literature:// 协议支持 + + + + + + + + S2 Strategy Services + + + promptService + 多维思维框架管理 + + + intentService + 意图拆解生成检索词 + + + + + + + + literatureService.ts (New) + 并发调用学术API及去重 + 向大模型返回标准化 JSON 数组 + + + + + + + + resourceService.ts + 文件系统读取交互 + 读取 Vault 中的文献卡片 + + + + + + + + + storageService.ts (New) + JSON 转 Markdown+YAML + 路径安全校验与双轨数据落盘 + + + + + + utils/yamlHelper.js + 生成 Frontmatter 文本 + + + + + + apiClients.js + Axios / 重试 + + + + + schemas.js + literatureSchema + Zod强校验标准 + + + + + + + Local Vault + .md 卡片落盘 + + + + + + + + + 1 + + + + 2 + + + + 3 + + + + 4 + + + + 5 + + + + 6 + + + + 7 + + + + 8 + + + + 9 + + + + + + Sprint 3 文献检索落盘工作流 + + + + + 1 + User: 输入研究主题进行查询 + + + + 2 + LLM: 判断并决定检索相关学术文献 + + + + 3 + Client: 调用 search_academic 工具 + + + + 4 + S1: 并发请求 arXiv / Sem. Scholar + + + + 5 + API: 返回聚合的 JSON 文献元数据 + + + + 6 + LLM: 分析后调用 save_literature + + + + 7 + S1: 将 JSON 转为 MD + YAML 前缀 + + + + 8 + S1: 安全写入指定的本地 Vault 目录 + + + + 9 + LLM: 生成带本地文献引用的最终报告 + + + + + + + + + + + + + + 组件与语义对照: + + + + + 宿主客户端架构 + + + + + + 路由分发控制器 (Controllers) + + + + + + 核心引擎与本地执行层 (Sprint 3核心) + + + + + + 远程云端 API 依赖 + + + + + + + 本作品采用 CC-BY-SA 4.0 进行许可，© 2025-2026 Gitconomy Research社区 + + diff --git a/docs/assets/images/figure01-mcp-system-topology.svg b/docs/assets/images/figure01-mcp-system-topology.svg index 2972c41..fe6c26c 100644 --- a/docs/assets/images/figure01-mcp-system-topology.svg +++ b/docs/assets/images/figure01-mcp-system-topology.svg @@ -1,15 +1,17 @@ + - @@ -77,7 +79,7 @@ SPDX-License-Identifier: MIT & CC-BY-SA-4.0 Project Caffeine 研报智能体 MCP 系统拓扑图 - 架构图 > 智能体 MCP > 系统拓扑 + 架构图 > 智能体 MCP > 核心原语拓扑 @@ -92,15 +94,15 @@ SPDX-License-Identifier: MIT & CC-BY-SA-4.0 - MCP 服务端集群 (核心执行区) + 单体 MCP Server (三大核心原语) - + 外部学术基础设施 (公有云) - - 本地知识库 + + 本地持久化存储 @@ -121,7 +123,7 @@ SPDX-License-Identifier: MIT & CC-BY-SA-4.0 JSON-RPC 2.0 - MCP 标准传输协议层 + MCP 传输协议层 @@ -145,7 +147,7 @@ SPDX-License-Identifier: MIT & CC-BY-SA-4.0 MCP 客户端 Claude Desktop / Cursor - 大模型上下文与工具调度 + 大模型上下文与协议调度 @@ -161,33 +163,33 @@ SPDX-License-Identifier: MIT & CC-BY-SA-4.0 提示词请求 / 结果流式响应 - + - + - 文献查询 MCP Server - 工具: search_papers(), fetch_pdf() - 负责多源学术数据库 API 聚合与清洗 + Tools 原语 (动作执行) + search_academic_literature(), save_to_vault() + 调用外部API检索文献并执行标准化数据双轨落盘 - + - 提示词策略 MCP Server - 提示词: synthesis_template - 负责基于主题动态组装超级提示词 + Prompts 原语 (上下文策略) + prompts/get: 5w3h, scqa, pestle 等 + 提供多维思维框架，动态指导大模型分析与拆解 - + - - - CoT 推理 MCP Server - 工具: run_cot_chain(), verify_logic() - 协调多步思考推理，抽取实体与洞察生成 + + + Resources 原语 (数据暴露) + literature://local/, note://local/ + 暴露本地知识库的文献卡片与笔记供大模型访问 @@ -198,49 +200,39 @@ SPDX-License-Identifier: MIT & CC-BY-SA-4.0 学术数据库 - PubMed, arXiv - IEEE, WOS + arXiv API + Semantic Scholar - - - - - 互联网资源 - PDF / HTML - - - - + 本地知识库 - Obsidian / Logseq + Obsidian / PKM (YAML / Markdown) - + - API 请求调用 (REST/GraphQL) + API 请求调用 (REST) - - - 拉取文献全文 / 网页爬取 + + + + JSON 转 Markdown+YAML - - - - - 本地读写 Markdown / YAML + + + 读取文献卡片与笔记 - - - 本地上下文共享 + + + 核心引擎共享调度