<!--
---
title: "Project Caffeine项目命名规则指南"
description: "详细阐述 Project Caffeine（萃取者计划）的核心命名隐喻、A-Z 咖啡图谱版本号规范及其在 Git 与工程化中的配置标准"
type: "Guide"
file: "project-caffeine-version-name-convention-guide.md"
version: "v1.0.0 (Arabica)"
author: "Gitconomy Research-郭晧"
date: 2026-02-28
tags:
  - Project Caffeine
  - Name Convention
  - A-Z版本迭代
  - Project Management
license: "CC BY-SA 4.0"
status: "Active"
---
-->
# Project Caffeine项目版本命名规则指南

## 1. 项目代号深度解析：为什么是 "Project Caffeine"？

本科研助手智能体系统旨在解决海量信息检索、深度推理与结构化报告生成的痛点。我们将项目正式定名为 **Project Caffeine（萃取者计划）**，因为**咖啡的精细萃取过程，完美隐喻了本系统在编写科研报告时，大语言模型执行一步步深度推理与提纯的完整工作流**。

具体而言，咖啡萃取与科研推理存在以下高度的相似之处：

1. **生豆采摘与筛选 对应 “全网数据抓取”**： 面对互联网上杂乱无章的海量原始数据（生豆），我们的“文献查询 MCP Server”就像经验丰富的采摘者，自动连接 arXiv、PubMed 等外部 API 获取生豆，并过滤掉无效的视觉杂音。

2. **精细研磨 对应 “语义分块 (Semantic Chunking)”**： 咖啡豆必须经过精确刻度的研磨才能释放风味。面对导致 Token 超载的超长篇 PDF 论文，系统在本地完成文本解析与“向量切割（语义分块）”，将长文本研磨成大模型能够完美吸收的知识颗粒。

3. **高压萃取 对应 “CoT 多步链式推理”**： 意式咖啡机的高压水流穿过咖啡粉饼的瞬间，即是核心风味物质被提取的过程。这等同于系统的“CoT 推理 MCP Server”强制大模型加载经典思维框架（如 SCQA、SWOT 分析、思维链）。模型在极高的数据密度下进行交叉比对、事实冲突验证与逻辑推演，一步步滤去幻觉与水分。

4. **最终成杯 对应 “结构化科研报告”**： 正如经过滤纸或把手滴落的纯净咖啡液，系统最终“萃取”出的是极具学术深度的研究洞察，并将其沉淀为带有 YAML 元数据的高质量 Markdown 文件，无缝接入用户的本地知识管理图谱（PKM）。

此外，MCP 协议本身被定义为解决“N×M 整合难题”的标准接口（犹如科技界的 USB-C 接口）。在我们的项目命名中，**MCP 协议就是那个标准化的咖啡机手柄（Portafilter）**，它以统一的规格兼容了各种不同的外部数据（咖啡豆）与宿主模型（咖啡机）。

--------------------------------------------------------------------------------

## 2. 版本号命名规范：A-Z 咖啡图谱

为了让系统的演进路径清晰且充满极客浪漫主义，**系统的版本号（Release Version）将严格采用以英文字母 A 到 Z 顺序开头的、与咖啡相关的英文单词进行命名**。每一个代号都将映射该版本核心突破的技术特征。

以下是规划中的 A-Z 核心版本迭代序列：

- **v1.x (A)**: Arabica (阿拉比卡 - 基础高品质咖啡树种)
- **v2.x (B)**: Bourbon (波旁 - 阿拉比卡经典优质变种)
- **v3.x (C)**: Cortado (可塔朵 - 浓缩与牛奶等比例混合的平衡咖啡)
- **v4.x (D)**: Drip (滴滤/手冲 - 依靠重力慢速萃取的方式)
- **v5.x (E)**: Espresso (意式浓缩 - 高压快速萃取的咖啡精华)
- **v6.x (F)**: Flat White (馥芮白/平白 - 奶泡更薄的浓缩奶咖)
- **v7.x (G)**: Geisha (瑰夏 - 具有极其复杂花果香的顶级咖啡品种)
- **v8.x (H)**: Honey Process (蜜处理 - 保留果胶层进行干燥的处理法)
- **v9.x (I)**: Ibrik (土耳其咖啡壶 - 最古老的不过滤煮沸法器具)
- **v10.x (J)**: Java (爪哇 - 印尼著名产区，也常作为咖啡的代名词)
- **v11.x (K)**: Kona (科纳 - 夏威夷顶级咖啡产区)
- **v12.x (L)**: Liberica (赖比瑞卡 - 世界第三大原生咖啡树种，风味独特)
- **v13.x (M)**: Macchiato (玛奇朵 - 意为“印记”，仅加少许奶泡的浓缩)
- **v14.x (N)**: Nitro (氮气冷萃咖啡 - 注入氮气带来绵密气泡口感的冷萃)
- **v15.x (O)**: Obata (奥巴塔 - 抗病虫害的优良阿拉比卡杂交品种)
- **v16.x (P)**: Peaberry (圆豆 - 单粒果实变异，风味更集中)
- **v17.x (Q)**: Q-Grader (咖啡品鉴师 - 国际认证的咖啡质量分级专家)
- **v18.x (R)**: Robusta (罗布斯塔 - 醇度厚重、抗虫害能力强的原生树种)
- **v19.x (S)**: Syphon (虹吸壶 - 利用水蒸气压力原理的冲煮器具)
- **v20.x (T)**: Typica (铁皮卡 - 最古老、最经典的阿拉比卡原生变种)
- **v21.x (U)**: Unwashed (日晒处理/非水洗 - 保留完整果实晒干的最古老处理法)
- **v22.x (V)**: V60 (V60滤杯 - 具有60度锥角的经典手冲器具)
- **v23.x (W)**: Washed (水洗处理 - 去除果肉与果胶后洗净风干的处理法)
- **v24.x (X)**: Xalapa (哈拉帕 - 墨西哥知名高海拔精品咖啡产区)
- **v25.x (Y)**: Yirgacheffe (耶加雪菲 - 以明亮柑橘花香闻名的埃塞俄比亚产区)
- **v26.x (Z)**: Zambia (赞比亚 - 极具潜力的非洲高海拔精品咖啡产地)

---

## 3. 分支与工程配置规范

为了将该命名规则严格落实到开发环节，团队需遵循以下工程配置标准：

1. **环境变量注入**：在工程的 `package.json` 及系统级 `.env` 文件中，需显式声明代号。

2. **Git 分支管理**：所有的 Release 发布分支需携带字母代号后缀，例如：`release/v1.0-arabica`, `release/v2.1-bourbon`。

3. **架构图注规范**：根据《图形即代码设计规范指南》，所有的系统架构 SVG 拓扑图中，右上角及面包屑导航的注释必须带有当前版本的咖啡代号，例如 `Release: v1.0.0 (Arabica)`。

---

## 许可声明

本文档采用 **知识共享署名--相同方式共享 4.0 国际许可协议 (CC BY--SA 4.0)** 进行许可，© 2025-2026  Gitconomy Research.
