From cc1aa6f65cf42c3bd6a6a05d0eb0648ee1d3d74c Mon Sep 17 00:00:00 2001 From: gzkoala Date: Sat, 28 Feb 2026 16:51:19 +0800 Subject: [PATCH] =?UTF-8?q?docs(add):=E6=96=B0=E5=A2=9EProject=20Caffeine?= =?UTF-8?q?=E9=A1=B9=E7=9B=AE=E4=BB=93=E5=BA=93README=E7=A4=BA=E6=84=8F?= =?UTF-8?q?=E5=9B=BE?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: gzkoala --- .../images/figure01-mcp-system-topology.svg | 287 ++++++++++++++++ .../figure02-mcp-tech-stack-framework.svg | 320 ++++++++++++++++++ .../figure03-mcp-logic-architecture.svg | 288 ++++++++++++++++ ...ject-caffeine-roadmap-high-level-gantt.svg | 236 +++++++++++++ .../project-caffeine-system-topology.svg | 287 ++++++++++++++++ .../project-caffeine-tech-stack-framework.svg | 320 ++++++++++++++++++ 6 files changed, 1738 insertions(+) create mode 100644 docs/assets/images/figure01-mcp-system-topology.svg create mode 100644 docs/assets/images/figure02-mcp-tech-stack-framework.svg create mode 100644 docs/assets/images/figure03-mcp-logic-architecture.svg create mode 100644 docs/assets/images/project-caffeine-roadmap-high-level-gantt.svg create mode 100644 docs/assets/images/project-caffeine-system-topology.svg create mode 100644 docs/assets/images/project-caffeine-tech-stack-framework.svg diff --git a/docs/assets/images/figure01-mcp-system-topology.svg b/docs/assets/images/figure01-mcp-system-topology.svg new file mode 100644 index 0000000..2972c41 --- /dev/null +++ b/docs/assets/images/figure01-mcp-system-topology.svg @@ -0,0 +1,287 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + FIG-MCP-01 + + Project Caffeine 研报智能体 MCP 系统拓扑图 + + 架构图 > 智能体 MCP > 系统拓扑 + + + + + + + + + + + 用户层 (本地运行环境) + + + + MCP 服务端集群 (核心执行区) + + + + 外部学术基础设施 (公有云) + + + + 本地知识库 + + + + + + + + + + + + stdio + JSON-RPC 2.0 + + + + SSE / HTTP + JSON-RPC 2.0 + + + MCP 标准传输协议层 + + + + + + + + + + + + + + 研究人员 + 学术用户 + + + + + + MCP 客户端 + Claude Desktop / Cursor + + 大模型上下文与工具调度 + + + + + + + 远程大模型 + OpenAI / Anthropic API + + + + HTTPS 网络通信 + 提示词请求 / 结果流式响应 + + + + + + + + + 文献查询 MCP Server + 工具: search_papers(), fetch_pdf() + 负责多源学术数据库 API 聚合与清洗 + + + + + + + 提示词策略 MCP Server + 提示词: synthesis_template + 负责基于主题动态组装超级提示词 + + + + + + + CoT 推理 MCP Server + 工具: run_cot_chain(), verify_logic() + 协调多步思考推理，抽取实体与洞察生成 + + + + + + + + + + 学术数据库 + PubMed, arXiv + IEEE, WOS + + + + + + + 互联网资源 + PDF / HTML + + + + + + + + + 本地知识库 + Obsidian / Logseq + (YAML / Markdown) + + + + + + + API 请求调用 (REST/GraphQL) + + + + 拉取文献全文 / 网页爬取 + + + + + + 本地读写 Markdown / YAML + + + + + 本地上下文共享 + + + + + + + + + + + + + 图例说明: + + + + + L1：本地执行 / 计算节点 (极速/同步) + + + + + + L2：云端大脑 / 外部资源 (网络依赖) + + + + + + L3：网络通信 / 异步等待 (存在延迟) + + + + + + + + + + 本作品采用 CC-BY-SA 4.0 进行许可，© 2025-2026 Gitconomy Research + + + + diff --git a/docs/assets/images/figure02-mcp-tech-stack-framework.svg b/docs/assets/images/figure02-mcp-tech-stack-framework.svg new file mode 100644 index 0000000..16fddec --- /dev/null +++ b/docs/assets/images/figure02-mcp-tech-stack-framework.svg @@ -0,0 +1,320 @@ + + + + + + + + + + + + + + + + + + + + + + + + FIG-02 + Project Caffeine开发框架与技术栈架构图 + 架构图 > 智能体 MCP > 开发框架和技术堆栈 + + + + + + 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 + + + + + + + + S2: 提示词策略 Server (军师) + + + 开发环境与框架 + + Node.js (v20+) + + @mcp/sdk-ts + + + 核心智能体架构与引擎 + + Persona Matrix 角色化矩阵 + + + Exploration State (防死循环账本) + + + 注入的静态思维框架 (Prompts) + + 5W3H + + SCQA + + SWOT + + + + + + + + S3: CoT 推理 Server (分析师) + + + 开发环境与框架 + + Node.js (v20+) + + @mcp/sdk-ts + + + 质量把控与数据组装逻辑 + + 引文密度强制校验 (Citation Check) + + + 双轨制落盘编译器 (JSON-to-MD) + + + 标准数据协议输出 + + Markdown 解析 + + YAML Frontmatter + + + + + + 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社区 + + + diff --git a/docs/assets/images/figure03-mcp-logic-architecture.svg b/docs/assets/images/figure03-mcp-logic-architecture.svg new file mode 100644 index 0000000..aef771c --- /dev/null +++ b/docs/assets/images/figure03-mcp-logic-architecture.svg @@ -0,0 +1,288 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + FIG-MCP-03 + MCP 系统工作流逻辑示意图 + 架构图 > 智能体 MCP > 工作流 + + + + + + + + + + + + + + Host Application (宿主应用程序) + Cherry Studio + + + + + + + MCP Server (MCP 服务端) + Local Node + + + + + + + + + + User Prompt + + + + + + + + + + 大语言模型 + (Remote LLM) + Reasoning Engine + + + + + + MCP Client (客户端) + 协议翻译与能力协商 + Context Injector + + + + + + Tool Use 请求 + + + 注入外部上下文 + + + + + + + + Server Router & Handler + JSON-RPC 2.0 解析 + + + + + + + + Prompts + 模板/策略 + + + + + Resources + 被动上下文 + + + + + Tools + 主动操作 + + + + + + + 核心性能与管控层 + LRU Cache | Semantic Chunking | Roots 鉴权 + + + + + + + 外部数据源 / DB + PKM / Academics API + + + + + + + + + + + + + + + JSON-RPC 2.0 + STDIO 或 HTTP+SSE 传输 + 能力发现与工具执行请求 + + + + + + + Standard JSON + 返回标准化数据/截断结果 + + + + + Sampling /createMessage + + + + + + + 1 + + + + 2 + + + + 3 + + + + 4 + + + + 5 + + + + 6 + + + + 7 + + + + 8 + + + + + + + + + + + + 图例说明: + + + + + LLM + + + + + + Local Component / Tool + + + + + + Network / Async I/O + + + + + + Sync I/O (Fast) + + + + + + + + + + 本作品采用 CC-BY-SA 4.0 进行许可，© 2025-2026 Gitconomy Research + + + + diff --git a/docs/assets/images/project-caffeine-roadmap-high-level-gantt.svg b/docs/assets/images/project-caffeine-roadmap-high-level-gantt.svg new file mode 100644 index 0000000..81547ba --- /dev/null +++ b/docs/assets/images/project-caffeine-roadmap-high-level-gantt.svg @@ -0,0 +1,236 @@ + + + + + + + + + + + + + + + + + + FIG-03 + Project Caffeine MVP阶段开发路线图总览 + + + + + + + + + + + + W1 + 03/01 + + + + + W2 + 03/08 + + + + + W3 + 03/15 + + + + + W4 + 03/22 + + + + + W5 + 03/29 + + + + + W6 + 04/05 + + + + + W7 + 04/12 + + + + + W8 + 04/19 + + + + + + + + + START + + + + + + + 阶段 0: 核心设计与 API 规划 + + 1 周 + + + + + + + 阶段 1: 基础设施与 MVP 验证 + + 1 周 + + + + + + + 阶段 2: 思维框架与单次分析闭环 + + 1 周 + + + + + + + 阶段 3: 递归深挖引擎核心攻坚 🔥 + + 2 周 + + + + + + + 阶段 4: 学术级质量把控与 PKM + + 2 周 + + + + + + + 阶段 5: 性能优化与 V0.1.0 发布 + + 1 周 + + + + + + + + + + 阶段类型语义说明: + + + + 架构设计 (P0) + + + + + 底层基建与同步闭环 (P1/P2) + + + + + 高难并发与递归推理 (P3) + + + + + 外部抓取与知识图谱 (P4) + + + + + + + 本作品采用 CC-BY-SA 4.0 进行许可，© 2025-2026 Gitconomy Research社区 + + + diff --git a/docs/assets/images/project-caffeine-system-topology.svg b/docs/assets/images/project-caffeine-system-topology.svg new file mode 100644 index 0000000..5345bce --- /dev/null +++ b/docs/assets/images/project-caffeine-system-topology.svg @@ -0,0 +1,287 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + FIG-01 + + 研报智能体 MCP 系统拓扑图 + + 架构图 > 学术研究智能体 MCP > 系统拓扑 + + + + + + + + + + + 用户层 (本地运行环境) + + + + MCP 服务端集群 (核心执行区) + + + + 外部学术基础设施 (公有云) + + + + 本地知识库 + + + + + + + + + + + + stdio + JSON-RPC 2.0 + + + + SSE / HTTP + JSON-RPC 2.0 + + + MCP 标准传输协议层 + + + + + + + + + + + + + + 研究人员 + 学术用户 + + + + + + MCP 客户端 + Claude Desktop / Cursor + + 大模型上下文与工具调度 + + + + + + + 远程大模型 + OpenAI / Anthropic API + + + + HTTPS 网络通信 + 提示词请求 / 结果流式响应 + + + + + + + + + 文献查询 MCP Server + 工具: search_papers(), fetch_pdf() + 负责多源学术数据库 API 聚合与清洗 + + + + + + + 提示词策略 MCP Server + 提示词: synthesis_template + 负责基于主题动态组装超级提示词 + + + + + + + CoT 推理 MCP Server + 工具: run_cot_chain(), verify_logic() + 协调多步思考推理，抽取实体与洞察生成 + + + + + + + + + + 学术数据库 + PubMed, arXiv + IEEE, WOS + + + + + + + 互联网资源 + PDF / HTML + + + + + + + + + 本地知识库 + Obsidian / Logseq + (YAML / Markdown) + + + + + + + API 请求调用 (REST/GraphQL) + + + + 拉取文献全文 / 网页爬取 + + + + + + 本地读写 Markdown / YAML + + + + + 本地上下文共享 + + + + + + + + + + + + + 图例说明: + + + + + L1：本地执行 / 计算节点 (极速/同步) + + + + + + L2：云端大脑 / 外部资源 (网络依赖) + + + + + + L3：网络通信 / 异步等待 (存在延迟) + + + + + + + + + + 本作品采用 CC-BY-SA 4.0 进行许可，© 2025-2026 Gitconomy Research + + + + diff --git a/docs/assets/images/project-caffeine-tech-stack-framework.svg b/docs/assets/images/project-caffeine-tech-stack-framework.svg new file mode 100644 index 0000000..f842827 --- /dev/null +++ b/docs/assets/images/project-caffeine-tech-stack-framework.svg @@ -0,0 +1,320 @@ + + + + + + + + + + + + + + + + + + + + + + + + FIG-02 + Project Caffeine开发框架与技术栈架构图 + System Architecture > Project Caffeine Tech Stack + + + + + + 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 + + + + + + + + S2: 提示词策略 Server (军师) + + + 开发环境与框架 + + Node.js (v20+) + + @mcp/sdk-ts + + + 核心智能体架构与引擎 + + Persona Matrix 角色化矩阵 + + + Exploration State (防死循环账本) + + + 注入的静态思维框架 (Prompts) + + 5W3H + + SCQA + + SWOT + + + + + + + + S3: CoT 推理 Server (分析师) + + + 开发环境与框架 + + Node.js (v20+) + + @mcp/sdk-ts + + + 质量把控与数据组装逻辑 + + 引文密度强制校验 (Citation Check) + + + 双轨制落盘编译器 (JSON-to-MD) + + + 标准数据协议输出 + + Markdown 解析 + + YAML Frontmatter + + + + + + 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社区 + + +