From 43fc7faced95bfa062c2f84c8c433f81840914e4 Mon Sep 17 00:00:00 2001 From: gzkoala Date: Sun, 8 Mar 2026 20:14:18 +0800 Subject: [PATCH] =?UTF-8?q?docs(update):=E6=9B=B4=E6=96=B0Porject=20Caffei?= =?UTF-8?q?ne=20README=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: gzkoala --- .../project-caffeine-system-topology.svg | 96 ++-- .../project-caffeine-tech-stack-framework.svg | 528 ++++++++---------- 2 files changed, 281 insertions(+), 343 deletions(-) diff --git a/docs/assets/images/project-caffeine-system-topology.svg b/docs/assets/images/project-caffeine-system-topology.svg index 6652297..0664740 100644 --- a/docs/assets/images/project-caffeine-system-topology.svg +++ b/docs/assets/images/project-caffeine-system-topology.svg @@ -1,15 +1,17 @@ + - @@ -75,9 +77,9 @@ SPDX-License-Identifier: MIT & CC-BY-SA-4.0 FIG-01 - 研报智能体 MCP 系统拓扑图 + 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 + + + 读取文献卡片与笔记 - - - 本地上下文共享 + + + 核心引擎共享调度 diff --git a/docs/assets/images/project-caffeine-tech-stack-framework.svg b/docs/assets/images/project-caffeine-tech-stack-framework.svg index 04de00e..7ecacd9 100644 --- a/docs/assets/images/project-caffeine-tech-stack-framework.svg +++ b/docs/assets/images/project-caffeine-tech-stack-framework.svg @@ -1,320 +1,266 @@ - + - - + + - - - - - - - - - - - - - + + + + + + + + + + + - - - FIG-02 - Project Caffeine开发框架与技术栈架构图 - 架构图 > MCP > 系统技术堆栈 - + + + + FIGURE-02 + + + Project Caffeine 开发框架与技术栈 + + + Framework > Tech Stack > Monolithic Server + + + + + + + + + + + + + + + + + + + + + + Client (Claude Desktop / Cherry Studio) - - - Layer 1: 宿主应用与大脑层 (Host & Brain) - + + - - - MCP Client 宿主联调环境 - VS Code (MCP 插件) / Claude + + - - + + + - - - - - Remote LLM Brain - Claude 3.5 / DeepSeek (Context Engine) - - - - - - Layer 2: 通信协议层 (JSON-RPC 2.0 Bus) - - mcp-protocol: STDIO 协议 (MVP阶段：本地 stdin/stdout 零网络开销) - - - - - - - - - - - - - Layer 3: 核心智能体引擎 / MCP Server 集群开发框架 - - - - - 📦 npm Workspaces (Monorepo) - 统一包管理 / 依赖隔离 / 共享 JSON-RPC Schema - - - - - - - S1: 文献查询 Server (执行者) - - - 开发环境与框架 - - Node.js (v20+) - - @mcp/sdk-ts - - - 核心组件与算法集成 - - Semantic Chunking 文本切块算法 - - - Playwright / Firecrawl 网页深抓取 - - - 集成外部接口 - - arXiv API - - S.Scholar API + + + 📦 Monolithic MCP Server - - - - - - S2: 提示词策略 Server (军师) + + + + - - 开发环境与框架 - - Node.js (v20+) - - @mcp/sdk-ts + + - - 核心智能体架构与引擎 - - Persona Matrix 角色化矩阵 + + - - Exploration State (防死循环账本) - - - 注入的静态思维框架 (Prompts) - - 5W3H - - SCQA - - SWOT + + + Academic APIs - - - - - - S3: CoT 推理 Server (分析师) + + + + + + 协议层 (Protocol) + MCP SDK + @modelcontextprotocol/sdk (stdio/SSE) + - - 开发环境与框架 - - Node.js (v20+) - - @mcp/sdk-ts + + + + + + 校验工具 (Validation) + Zod + 运行时类型校验与参数安全验证 + - - 质量把控与数据组装逻辑 - - 引文密度强制校验 (Citation Check) + + + + + 核心语言 (Core Language) + TypeScript + 所有服务逻辑与控制流强制使用 + - - 双轨制落盘编译器 (JSON-to-MD) + + + + + HTTP 客户端 (Network I/O) + axios + 封装学术 API，支持重试与速率限制 + - - 标准数据协议输出 - - Markdown 解析 - - YAML Frontmatter + + + + + + 运行环境 (Runtime) + Node.js LTS v20+ + 单进程异步非阻塞 I/O 引擎 + + + + + DevTools & Engineering Infrastructure + + + + + + + 日志工具 (Logging) + winston / log4js + 生产级结构化日志记录与追踪 + + + + + + + 调试工具 (Debugging) + VS Code (--inspect) + 统一入口进程挂载与源码级断点 + + + + + + + 测试工具 (Testing) + Jest + k6 + 服务单元测试与接口负载压测 + + + + + + + 包管理 (Package Config) + npm (单一 package.json) + + + + + + + + + + + + + 图例说明: + + + + + 接口/外部协议 (Interface) + + + + + + 核心引擎/计算 (Core/Sync) + + + + + + 网络/异步流 (Async I/O) + + + + + + 基建/工具 (DevTools) + - - - Layer 4: 数据存储与个人图谱化 (PKM Data Persistence) - - - - - - - - - - 本地个人知识库 (Local Vault) - Obsidian / Logseq Graph System - - - - 双向链接 [[文献名称]] 编排 - - - 自动化文献目录索引池 - - - - - Layer 5: 架构运维管控与安全基线 (Engineering & Security) - - - - - 零信任架构 (不可信负载防范) - - - - .env.example 隔离敏感凭证 - - - - 异步非阻塞事件流 (高并发处理能力) - - - - - - - - 语义图例说明: - - - - - 云端服务 / 外部资源 - - - - - - 本地服务 / 核心引擎 - - - - - - 高频计算 / 网络爬取 - - - - - - 治理规范 / 安全控制 - - - - - - 逻辑边界 / 虚拟容器 - - - - - - - 本作品采用 CC-BY-SA 4.0 进行许可，© 2025-2026 Gitconomy Research社区 + + + + 本作品采用 CC-BY-SA 4.0 进行许可，© 2025-2026 Gitconomy Research +