new_org/Project-Caffeine
2
0
Fork 1
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

docs(add):新增Project Caffeine MVP 开发路线图规划文档

Browse Source 
Signed-off-by: gzkoala <guohao@gitconomy.org>
This commit is contained in:
gzkoala
2026-02-28 17:23:28 +08:00
parent dd27ee19c1
commit e00cc812c6
2 changed files with 452 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/assets/images/project-caffeine-mvp-roadmap.svg
+313
View File
@@ -0,0 +1,313 @@
<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1200 1250" width="100%" height="100%">
<!--
================================================================================
图表名称：个人级研究助手智能体开发路线图 (Agent Development Roadmap - Gantt View)
文件命名：project-caffeine-mvpd-roadmap.svg
用途：基于甘特图展示从底层基建到递归深挖再到 PKM 集成的开发阶段，起始于2026年3月1日。
版本：v1.0.0
作者：Gitconomy Research-郭晧
SPDX-License-Identifier: MIT & CC-BY-SA-4.0
创建日期：2026-02-27
================================================================================
-->
<!-- Background: Solid White for Git compatibility -->
<rect width="100%" height="100%" fill="#FFFFFF" />
<defs>
<style>
:root {
/* 云端/远程大脑/外部整合 —— 主色调：科技蓝 */
--c-cloud-blue: #0099FF;
/* 本地/工具/基础建设 —— 主色调：生机绿 */
--c-local-green: #009900;
/* 风险/核心攻坚/递归等待 —— 警示琥珀 */
--c-risk-amber: #FF991F;
/* 治理/规划/架构 —— 治理蓝 */
--c-gov-blue: #0052CC;
/* 运维/发布/操作 —— 执行绿 */
--c-op-green: #00875A;
/* 中性色 —— 边框、辅助文字、背景网格 */
--c-neutral-gray: #475569;
--c-neutral-gray-light: #E2E8F0;
}
.font-sans { font-family: 'Noto Sans', 'Helvetica Neue', Arial, sans-serif; }
.font-mono { font-family: 'JetBrains Mono', Consolas, 'Courier New', monospace; }
.phase-title { font-size: 15px; font-weight: bold; }
.task-text { font-size: 13px; fill: #334155; }
.duration-text { font-size: 11px; fill: #64748B; }
.grid-line { stroke: var(--c-neutral-gray-light); stroke-width: 1; }
.grid-dash { stroke: var(--c-neutral-gray-light); stroke-width: 1; stroke-dasharray: 4 4; }
</style>
<!-- 瀑布流依赖箭头 -->
<marker id="arrow-down" markerWidth="6" markerHeight="6" refX="3" refY="6" orient="auto">
<path d="M 0 0 L 6 0 L 3 6 Z" fill="var(--c-neutral-gray)" />
</marker>
</defs>
<!--
===========================================================================
顶层标题块 (Title Block)
===========================================================================
-->
<g id="title-block" transform="translate(600, 40)">
<text y="0" text-anchor="middle" class="font-mono" font-size="12" fill="var(--c-neutral-gray)" letter-spacing="1">FIG-ROADMAP-01 (GANTT)</text>
<text y="30" text-anchor="middle" class="font-sans" font-weight="bold" font-size="24" fill="#000000">Project Caffeine MVP 开发路线图</text>
<text y="55" text-anchor="middle" class="font-mono" font-size="14" fill="var(--c-neutral-gray)">Project Management &gt; MVP to V0.1.0 Timeline (Start: 2026-03-01)</text>
<rect x="-30" y="70" width="60" height="3" fill="var(--c-gov-blue)" />
</g>
<!--
===========================================================================
甘特图网格与时间轴 (Gantt Grid & Timeline)
总宽度: 840px (56天), 每天: 15px, 每周: 105px, X轴起始点: 300
===========================================================================
-->
<g id="gantt-grid">
<!-- 横向主分隔线 -->
<line x1="40" y1="140" x2="1140" y2="140" class="grid-line" stroke-width="2"/>
<!-- 垂直背景斑马纹与周刻度线 -->
<!-- W1 (03/01) -->
<rect x="300" y="140" width="105" height="950" fill="transparent" />
<text x="352" y="130" text-anchor="middle" class="font-sans" font-weight="bold" font-size="13" fill="var(--c-neutral-gray)">W1 (03/01)</text>
<line x1="300" y1="140" x2="300" y2="1090" class="grid-line" />
<!-- W2 (03/08) -->
<rect x="405" y="140" width="105" height="950" fill="var(--c-neutral-gray-light)" opacity="0.15" />
<text x="457" y="130" text-anchor="middle" class="font-sans" font-weight="bold" font-size="13" fill="var(--c-neutral-gray)">W2 (03/08)</text>
<line x1="405" y1="140" x2="405" y2="1090" class="grid-line" />
<!-- W3 (03/15) -->
<rect x="510" y="140" width="105" height="950" fill="transparent" />
<text x="562" y="130" text-anchor="middle" class="font-sans" font-weight="bold" font-size="13" fill="var(--c-neutral-gray)">W3 (03/15)</text>
<line x1="510" y1="140" x2="510" y2="1090" class="grid-line" />
<!-- W4 (03/22) -->
<rect x="615" y="140" width="105" height="950" fill="var(--c-neutral-gray-light)" opacity="0.15" />
<text x="667" y="130" text-anchor="middle" class="font-sans" font-weight="bold" font-size="13" fill="var(--c-neutral-gray)">W4 (03/22)</text>
<line x1="615" y1="140" x2="615" y2="1090" class="grid-line" />
<!-- W5 (03/29) -->
<rect x="720" y="140" width="105" height="950" fill="transparent" />
<text x="772" y="130" text-anchor="middle" class="font-sans" font-weight="bold" font-size="13" fill="var(--c-neutral-gray)">W5 (03/29)</text>
<line x1="720" y1="140" x2="720" y2="1090" class="grid-line" />
<!-- W6 (04/05) -->
<rect x="825" y="140" width="105" height="950" fill="var(--c-neutral-gray-light)" opacity="0.15" />
<text x="877" y="130" text-anchor="middle" class="font-sans" font-weight="bold" font-size="13" fill="var(--c-neutral-gray)">W6 (04/05)</text>
<line x1="825" y1="140" x2="825" y2="1090" class="grid-line" />
<!-- W7 (04/12) -->
<rect x="930" y="140" width="105" height="950" fill="transparent" />
<text x="982" y="130" text-anchor="middle" class="font-sans" font-weight="bold" font-size="13" fill="var(--c-neutral-gray)">W7 (04/12)</text>
<line x1="930" y1="140" x2="930" y2="1090" class="grid-line" />
<!-- W8 (04/19) -->
<rect x="1035" y="140" width="105" height="950" fill="var(--c-neutral-gray-light)" opacity="0.15" />
<text x="1087" y="130" text-anchor="middle" class="font-sans" font-weight="bold" font-size="13" fill="var(--c-neutral-gray)">W8 (04/19)</text>
<line x1="1035" y1="140" x2="1035" y2="1090" class="grid-line" />
<!-- 结束边界线 -->
<line x1="1140" y1="140" x2="1140" y2="1090" class="grid-line" stroke-width="2"/>
<!-- 起点红线标识 -->
<line x1="300" y1="140" x2="300" y2="1100" stroke="#EF4444" stroke-width="2" stroke-dasharray="4 2" />
<rect x="255" y="1098" width="90" height="20" rx="10" fill="#EF4444" />
<text x="300" y="1112" text-anchor="middle" class="font-mono" font-size="11" fill="#FFFFFF" font-weight="bold">START</text>
</g>
<!--
===========================================================================
任务列表区 (左侧列) 与甘特进度条 (右侧区)
===========================================================================
-->
<g id="gantt-tasks">
<!-- ================= PHASE 0 ================= -->
<!-- 行间辅助线 -->
<line x1="40" y1="190" x2="1140" y2="190" class="grid-dash"/>
<text x="40" y="178" class="font-sans phase-title" fill="var(--c-gov-blue)">阶段 0: 设计阶段规划</text>
<text x="60" y="206" class="task-text">• 架构与技术栈选型</text>
<rect x="300" y="190" width="30" height="24" rx="4" fill="var(--c-gov-blue)" />
<text x="335" y="206" class="font-mono duration-text">2d</text>
<line x1="40" y1="226" x2="1140" y2="226" class="grid-dash"/>
<text x="60" y="242" class="task-text">• API 契约与规范文档</text>
<rect x="330" y="226" width="30" height="24" rx="4" fill="var(--c-gov-blue)" />
<text x="365" y="242" class="font-mono duration-text">2d</text>
<line x1="40" y1="262" x2="1140" y2="262" class="grid-dash"/>
<text x="60" y="278" class="task-text">• 递归深研核心算法设计</text>
<rect x="360" y="262" width="15" height="24" rx="4" fill="var(--c-gov-blue)" />
<text x="380" y="278" class="font-mono duration-text">1d</text>
<line x1="40" y1="298" x2="1140" y2="298" class="grid-dash"/>
<text x="60" y="314" class="task-text">• 提示词工程与角色矩阵规范</text>
<rect x="375" y="298" width="15" height="24" rx="4" fill="var(--c-gov-blue)" />
<text x="395" y="314" class="font-mono duration-text">1d</text>
<line x1="40" y1="334" x2="1140" y2="334" class="grid-dash"/>
<text x="60" y="350" class="task-text">• 双轨制数据结构与 PKM 集成</text>
<rect x="390" y="334" width="15" height="24" rx="4" fill="var(--c-gov-blue)" />
<text x="410" y="350" class="font-mono duration-text">1d</text>
<!-- Dependency P0 -> P1 -->
<path d="M 405 358 L 405 404" stroke="var(--c-neutral-gray)" stroke-width="1.5" stroke-dasharray="2 2" marker-end="url(#arrow-down)" fill="none" />
<!-- ================= PHASE 1 ================= -->
<line x1="40" y1="410" x2="1140" y2="410" class="grid-dash"/>
<text x="40" y="398" class="font-sans phase-title" fill="var(--c-local-green)">阶段 1: 基础设施与单点能力验证</text>
<text x="60" y="426" class="task-text">• MCP 环境初始化与 API 集成</text>
<rect x="405" y="410" width="45" height="24" rx="4" fill="var(--c-local-green)" />
<text x="455" y="426" class="font-mono duration-text">3d</text>
<line x1="40" y1="446" x2="1140" y2="446" class="grid-dash"/>
<text x="60" y="462" class="task-text">• 开发数据落盘模块 (save_to_local)</text>
<rect x="450" y="446" width="30" height="24" rx="4" fill="var(--c-local-green)" />
<text x="485" y="462" class="font-mono duration-text">2d</text>
<line x1="40" y1="482" x2="1140" y2="482" class="grid-dash"/>
<text x="60" y="498" class="task-text">• 客户端接入联调与全链路测试</text>
<rect x="480" y="482" width="30" height="24" rx="4" fill="var(--c-local-green)" />
<text x="515" y="498" class="font-mono duration-text">2d</text>
<!-- Dependency P1 -> P2 -->
<path d="M 510 506 L 510 552" stroke="var(--c-neutral-gray)" stroke-width="1.5" stroke-dasharray="2 2" marker-end="url(#arrow-down)" fill="none" />
<!-- ================= PHASE 2 ================= -->
<line x1="40" y1="558" x2="1140" y2="558" class="grid-dash"/>
<text x="40" y="546" class="font-sans phase-title" fill="var(--c-local-green)">阶段 2: 思维框架与单次分析闭环</text>
<text x="60" y="574" class="task-text">• 注入思维框架与检索拆解工具</text>
<rect x="510" y="558" width="45" height="24" rx="4" fill="var(--c-local-green)" />
<text x="560" y="574" class="font-mono duration-text">3d</text>
<line x1="40" y1="594" x2="1140" y2="594" class="grid-dash"/>
<text x="60" y="610" class="task-text">• CoT 推理分析深度集成</text>
<rect x="555" y="594" width="30" height="24" rx="4" fill="var(--c-local-green)" />
<text x="590" y="610" class="font-mono duration-text">2d</text>
<line x1="40" y1="630" x2="1140" y2="630" class="grid-dash"/>
<text x="60" y="646" class="task-text">• 语义切块算法突破 Token 瓶颈</text>
<rect x="585" y="630" width="30" height="24" rx="4" fill="var(--c-local-green)" />
<text x="620" y="646" class="font-mono duration-text">2d</text>
<!-- Dependency P2 -> P3 -->
<path d="M 615 654 L 615 700" stroke="var(--c-neutral-gray)" stroke-width="1.5" stroke-dasharray="2 2" marker-end="url(#arrow-down)" fill="none" />
<!-- ================= PHASE 3 ================= -->
<line x1="40" y1="706" x2="1140" y2="706" class="grid-dash"/>
<text x="40" y="694" class="font-sans phase-title" fill="var(--c-risk-amber)">阶段 3: 递归深挖引擎的核心攻坚 [🔥]</text>
<text x="60" y="722" class="task-text">• 盲区探测器与智能体角色化</text>
<rect x="615" y="706" width="75" height="24" rx="4" fill="var(--c-risk-amber)" />
<text x="695" y="722" class="font-mono duration-text">5d</text>
<line x1="40" y1="742" x2="1140" y2="742" class="grid-dash"/>
<text x="60" y="758" class="task-text">• 探索账本 (防死循环状态机)</text>
<rect x="690" y="742" width="60" height="24" rx="4" fill="var(--c-risk-amber)" />
<text x="755" y="758" class="font-mono duration-text">4d</text>
<line x1="40" y1="778" x2="1140" y2="778" class="grid-dash"/>
<text x="60" y="794" class="task-text">• 深研工作流编排与逻辑约束</text>
<rect x="750" y="778" width="75" height="24" rx="4" fill="var(--c-risk-amber)" />
<text x="830" y="794" class="font-mono duration-text">5d</text>
<!-- Dependency P3 -> P4 -->
<path d="M 825 802 L 825 848" stroke="var(--c-neutral-gray)" stroke-width="1.5" stroke-dasharray="2 2" marker-end="url(#arrow-down)" fill="none" />
<!-- ================= PHASE 4 ================= -->
<line x1="40" y1="854" x2="1140" y2="854" class="grid-dash"/>
<text x="40" y="842" class="font-sans phase-title" fill="var(--c-cloud-blue)">阶段 4: 学术级质量把控与 PKM</text>
<text x="60" y="870" class="task-text">• 引用密度强制校验与局限声明</text>
<rect x="825" y="854" width="75" height="24" rx="4" fill="var(--c-cloud-blue)" />
<text x="905" y="870" class="font-mono duration-text">5d</text>
<line x1="40" y1="890" x2="1140" y2="890" class="grid-dash"/>
<text x="60" y="906" class="task-text">• Playwright 网页正文深度抓取</text>
<rect x="900" y="890" width="75" height="24" rx="4" fill="var(--c-cloud-blue)" />
<text x="980" y="906" class="font-mono duration-text">5d</text>
<line x1="40" y1="926" x2="1140" y2="926" class="grid-dash"/>
<text x="60" y="942" class="task-text">• Obsidian 双向链接与图谱对接</text>
<rect x="975" y="926" width="60" height="24" rx="4" fill="var(--c-cloud-blue)" />
<text x="1040" y="942" class="font-mono duration-text">4d</text>
<!-- Dependency P4 -> P5 -->
<path d="M 1035 950 L 1035 996" stroke="var(--c-neutral-gray)" stroke-width="1.5" stroke-dasharray="2 2" marker-end="url(#arrow-down)" fill="none" />
<!-- ================= PHASE 5 ================= -->
<line x1="40" y1="1002" x2="1140" y2="1002" class="grid-dash"/>
<text x="40" y="990" class="font-sans phase-title" fill="var(--c-op-green)">阶段 5: 非功能性优化与发布准备</text>
<text x="60" y="1020" class="task-text">• 高并发控制压测与内存 LRU 缓存</text>
<rect x="1035" y="1002" width="60" height="24" rx="4" fill="var(--c-op-green)" />
<text x="1100" y="1020" class="font-mono duration-text">4d</text>
<line x1="40" y1="1038" x2="1140" y2="1038" class="grid-dash"/>
<text x="60" y="1056" class="task-text">• 工程化打包固化与 V0.1.0 发布</text>
<rect x="1095" y="1038" width="45" height="24" rx="4" fill="var(--c-op-green)" />
<text x="1145" y="1056" class="font-mono duration-text">3d</text>
</g>
<!--
===========================================================================
底部图例与注释块 (Legend & Key Block)
===========================================================================
-->
<g id="legend" transform="translate(600, 1140)">
<rect x="-420" y="-16" width="840" height="40" rx="4" fill="rgba(255, 255, 255, 0.9)" stroke="var(--c-neutral-gray)" stroke-width="0.5"/>
<g transform="translate(-400, 0)">
<text x="0" y="8" class="font-sans" font-size="13" font-weight="bold" fill="var(--c-neutral-gray)">时间轴色彩与阶段语义对照表:</text>
<g transform="translate(190, 0)">
<rect x="-6" y="-6" width="12" height="12" rx="2" fill="var(--c-gov-blue)" />
<text x="12" y="8" class="font-sans" font-size="12" fill="var(--c-neutral-gray)">架构设计 (P0)</text>
</g>
<g transform="translate(320, 0)">
<rect x="-6" y="-6" width="12" height="12" rx="2" fill="var(--c-local-green)" />
<text x="12" y="8" class="font-sans" font-size="12" fill="var(--c-neutral-gray)">基建与闭环 (P1/P2)</text>
</g>
<g transform="translate(470, 0)">
<rect x="-6" y="-6" width="12" height="12" rx="2" fill="var(--c-risk-amber)" />
<text x="12" y="8" class="font-sans" font-size="12" fill="var(--c-neutral-gray)">高难并发与递归 (P3)</text>
</g>
<g transform="translate(630, 0)">
<rect x="-6" y="-6" width="12" height="12" rx="2" fill="var(--c-cloud-blue)" />
<text x="12" y="8" class="font-sans" font-size="12" fill="var(--c-neutral-gray)">知识图谱应用 (P4)</text>
</g>
</g>
</g>
<!--
===========================================================================
底部许可声明
===========================================================================
-->
<text x="600" y="1210" text-anchor="middle" class="font-sans" font-size="11" fill="var(--c-neutral-gray)">
本作品采用 CC-BY-SA 4.0 进行许可，© 2025-2026 Gitconomy Research社区
</text>
</svg>
Side by Side

After

Width:  |  Height:  |  Size: 16 KiB

docs/plan/project-caffeine-mvp-development-roadmap.md
+139
View File
@@ -0,0 +1,139 @@
<!--
---
title: "Project Caffeine MVP 开发路线图"
description: "基于敏捷迭代原则的 Project Caffeine 系统五阶段开发规划与核心设计蓝图"
type: "Roadmap"
file: "project-caffeine-mvp-development-roadmap.md"
version: "V0.1.0"
author: "Gitconomy Research-郭晧"
date: 2026-02-28
tags:
- Project Caffeine
- MCP
- MVP
- 开发路线图
- Deep Research
- PKM
license: "CC BY-SA 4.0"
status: "Active"
---
-->
# Project Caffeine MVP 开发路线图
## 1. 开发路线图概述
本系统的开发将遵循“敏捷迭代、核心优先、由浅入深”的研发原则。为了确保开发过程的稳健性，整个生命周期被划分为五个渐进式阶段，从最基础的物理检索链路起步，逐步叠加思维框架、递归推理算法，最终实现与本地个人知识库的完美融合。每个阶段均能独立跑通并产出具备核心价值的最小可行性产品（MVP）。
---
## 2. 设计阶段规划
在正式启动编码前，需用 1 周时间完成从产品需求到技术实现的图纸转化。此阶段需产出以下 **5 份核心设计文档**，作为后续所有开发的唯一事实依据：
| 序号 | 核心设计文档名称 | 核心内容 | 输出价值 |
| :---- | :---------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------ |
| **1** | 《系统总体架构和开发框架设计》<br> | 确定三大 MCP Server（执行者、军师、分析师）的开发语言（如 TypeScript vs. Python）。确定底层依赖组件：如网页抓取库、文本切块算法库。系统部署拓扑图规划。 | 统一团队技术栈，明确性能边界，避免后期因组件不兼容导致的大规模重构。 |
| **2** | 《MCP 接口契约与 API 规范文档 (API Contract)》 | 基于 JSON-RPC 2.0 规范，详细定义所有 Tools（如 `search_academic_literature`）、Prompts（如 `analyze_via_scqa`）和 Resources 的出入参 JSON Schema。定义全局错误码（如 API 限流、Token 超载、抓取失败）及异常抛出机制。 | 由于系统是解耦的微服务，这份契约能让 S1、S2、S3 的开发人员以及前端/客户端联调人员实现完全的并行开发。 |
| **3** | 《递归深度研究核心算法与状态机设计》 | 设计深研状态机（Deep Research State Machine）：明确大模型在“检索 -> 切块 -> 提取 -> 评估盲区 -> 追问”循环中的状态流转图。定义“探索账本（Exploration State）”的数据结构，设计布隆过滤器或哈希去重逻辑，严防大模型陷入检索死循环。制定长文本“Token 感知语义切块（Semantic Chunking）”的具体策略与重叠率标准。 | 这是本系统最硬核的算法底座，决定了系统能否真正被称为“AI 研究员”而不是单纯的“搜索外挂”。 |
| **4** | 《大模型提示词工程与角色矩阵规范 》 | 详细设计并固化系统所需的所有底层 Prompt 模板（5W3H、SCQA、5 Whys、PESTLE 等）。建立**多智能体角色矩阵 (Persona Matrix)**：为“检索策略专家”、“洞察提取研究员”、“战略分析顾问”等角色撰写精确的 System Prompts。定义大模型的输出结构约束（如强制 Markdown 格式、强制引用溯源标记的 Few-Shot 示例）。 | 确保大模型的输出质量稳定、格式统一、逻辑严密，降低大模型的幻觉率。 |
| **5** | 《双轨制数据结构与 PKM 集成白皮书 》 | 设计系统内部流转的 JSON 数据结构规范。设计最终落盘的 Markdown 模板与 YAML Frontmatter 元数据字典（需列出所有支持的键值对，如 `title`, `citation_density_check`, `research_depth_level`）。梳理与 Obsidian/Logseq 等工具联动的双向链接（`[[...]]`）自动生成策略。 | 保障用户最终获得的本地知识图谱干净、可检索且具备高可扩展性。 |
---
## 3. 开发阶段规划
### 3.1 阶段 1：基础设施与单点能力验证 (MVP 阶段)
1. **目标**：搭建底层 MCP 框架，跑通“检索 -> 落盘”的基础物理链路。
2. **预计周期**：1 周
3. **S1 (文献查询 Server) 核心开发**：
- 初始化 MCP Server 环境（基于 Node.js）。
- 集成至少 2 个核心学术 API（如 arXiv API、Semantic Scholar API），实现基础的 `search_academic_literature` 工具。
- 开发双轨制数据落盘模块 `save_to_local_vault`，实现 JSON 到 Markdown + YAML Frontmatter 的自动转换。
4. **客户端联调测试**：将 S1 接入 Cherry Studio，测试大模型能否通过对话触发搜索，并成功在本地 Obsidian 目录生成标准 `.md` 文件。
- **🎯 里程碑成果**：系统拥有了“手”和“脚”，能帮用户查文献并规范化存入本地。
### 3.2 阶段 2：思维框架与单次分析闭环 (思维引擎组装)
1. **目标**：上线 S2 和 S3，打通“意图拆解 -> 检索 -> 框架分析 -> 落盘”的**单轮（非递归）**工作流。
2. **预计周期**：1 周
3. **S2 (提示词策略 Server) 核心开发**：
- 注册 Prompts 原语，写入 5W3H、SCQA、SWOT 等静态思维框架模板。
- 开发 `generate_search_queries` 工具，让大模型能将用户的“大白话”拆解为 3-5 个专业检索词（实现 Breadth 广度解析）。
4. **S3 (CoT多步推理 Server) 核心开发**：开发 `cot_literature_synthesis` 核心提示词模板，规范大模型的输出结构（摘要、引言、主体等）。
5. **S1 (文献查询 Server) 能力扩充**：开发 `fetch_and_split_document`：引入文本切块（Semantic Chunking）算法，解决长篇 PDF 解析导致的 Token 超限问题。
- **🎯 里程碑成果**：用户输入问题，系统能自动拆解关键词、并发检索多篇文献，并基于 SCQA 框架生成一份基础报告存入本地。
### 3.3 阶段 3：递归深挖引擎的核心攻坚 (Deep Research 模式)
1. **目标**：实现系统最具价值的“自主探索与深度递归”能力。
2. **预计周期**：2周
3. **S2 (提示词策略 Server) 升级**：
- 引入**角色化智能体 (Persona Agents)** 逻辑，支持动态下发“检索专家”、“提取员”等角色指令。
- 开发最关键的 `evaluate_research_depth`（深度评估）和 `evaluate_knowledge_gaps`（盲区探测）工具。
4. **S1 (文献查询 Server) 升级**：开发 `manage_exploration_state` 工具，记录已经检索过的 Query 和文献 ID，防止系统在循环搜索时陷入死循环。
5. **工作流编排**：在客户端提示词中写入递归循环逻辑：强约束大模型在每次提取洞察（Learnings）后，必须调用 S2 评估盲区；若未达标，必须携带原 Learnings 发起新一轮检索。
- **🎯 里程碑成果**：系统不再是“查一次就写报告”，而是能像人类一样，顺着第一轮的线索，自动发起第二轮、第三轮的深挖检索。
### 3.4 阶段 4：学术级质量把控与 PKM 融合
1. **目标**：拔高输出结果的严谨性，彻底点亮 Obsidian 本地知识图谱。
2. **预计周期**：2 周
3. **S3 (CoT多步推理 Server) 质检强化**：
- 实现**引用密度强制校验**逻辑，确保正文中的核心事实必须带有 `[文献ID]` 尾注。
- 开发“利益冲突与时效性局限”自动声明模块。
4. **PKM (个人知识管理) 深度对接**：优化 `save_to_local_vault`：在 Markdown 正文中自动生成 Obsidian 格式的双向链接 `[[文献名称]]`，将主报告与独立洞察卡片物理串联。
5. **S1 (文献查询 Server) 爬虫强化**：实现 `scrape_and_parse_deep_content`，引入 Playwright 或 Firecrawl，突破纯 API 限制，抓取含金量高的网页正文。
- **🎯 里程碑成果**：生成的报告达到专业研报标准，且用户的 Obsidian 图谱中开始出现网状关联的知识节点。
### 3.5 阶段 5：非功能性优化与发布准备
1. **目标**：解决高并发下的稳定性问题，准备打包开源或交付。
2. **预计周期**：1周
3. **性能与稳定性优化**：
- 在 S1 增加 API 并发控制（Concurrency-limited batching）与请求重试机制，防止触发外部数据库的 Rate Limit。
- 增加 LRU 缓存机制，避免重复消耗大模型 Token 抓取相同的文献。
4. **工程化打包**：完善 `.env.example`（配置各路 API Keys、默认 Depth/Breadth 参数等）。
- **🎯 里程碑成果**：V0.1.0 正式发布。
---
## 4. 开发路线图
*图1-1：Project Caffiene MVP开发路线图*
![](./../assets/images/project-caffeine-mvp-roadmap.svg)
---
## 许可声明
本文档采用 **知识共享署名--相同方式共享 4.0 国际许可协议 (CC BY--SA 4.0)** 进行许可，© 2025-2026 Gitconomy Research.