Project-Caffeine/CHANGELOG.md

Changelog (更新日志)

本项目的所有显著更改都将记录在此文件中。

本项目遵循 Keep a Changelog 规范，并且项目版本号采用 Semantic Versioning (语义化版本)。

---

[0.1.1] - 2026-03-06

Added (新增)

• 接入 MCP Prompts 原语：新增 prompts/list 和 prompts/get 接口，向大模型暴露静态思维框架模板，支持降低前置上下文长度。
• 多维静态思维框架库：在 src/models/frameworks/ 目录下新增 5W3H、SCQA、SWOT、PESTLE 等基于 JSON 格式的静态思维框架模板。
• 新增意图拆解工具：开发 generate_search_queries 工具，支持将用户模糊的自然语言查询自动拆解为 3-5 个专业检索词，为后续文献检索提供广度解析。
• 输入参数严格校验：在 schemas.ts 中基于 Zod 新增针对 generate_search_queries 工具及 Prompts 原语的强类型参数校验规则。
• 底层角色矩阵与输出规范：建立多智能体角色矩阵 (Persona Matrix) 雏形，通过系统消息 (System Prompt) 及 Few-Shot 示例，强制约束大模型输出标准的 Markdown 格式报告。
• 测试与质量保障体系：制定《Project Caffeine 项目测试规范指南》与《MCP Inspector 使用说明文档》，确立包含单元测试、协议集成、负载性能与安全审计的四级自动化测试体系。

Changed (变更)

• 重构提示词服务：将 promptService.ts 升级为多框架管理器，支持从本地静态 JSON 文件中动态加载思维框架库。
• 扩展工具控制器：更新 toolsController.ts，新增对意图拆解服务的路由分发能力。
• 优化构建脚本：在 package.json 的 build 脚本中引入跨平台构建工具 copyfiles，以确保在执行 tsc 编译时，静态 JSON 文件能够自动同步至 dist/models/frameworks/ 目录 (依据历史对话)。

Deprecated (废弃)

(无)

Removed (移除)

(无)

Fixed (修复)

• 静态资源编译丢失问题：修复了因 TypeScript 原生编译器 (tsc) 不拷贝非 .ts 文件，导致运行时大模型发起 prompts/get 请求时抛出 MCP error -32603: 获取框架失败 的问题 (依据历史对话)。

Security (安全)

• 非法参数防注入：通过引入 Zod 模型层校验，在服务端自动拦截因客户端大模型未正确生成必填参数（如 SCQA 框架缺失 situation 字段）而导致的无效负载，并标准抛出 JSON-RPC -32602 错误机制。

---

[0.1.0] - 2026-03-03

Added (新增)

• 初始化本地基础设施：基于 Node.js (v18+) 和 TypeScript 搭建底层架构，配置主入口 src/app.ts 实例化官方 MCP SDK。
• 零网络开销通信：实现基于 stdio (标准输入输出) 传输层的本地环境工作流，支持 Cherry Studio 无缝挂载。
• 单点提示词策略引擎：开发纯本地业务逻辑 promptService.ts，向客户端注册 generate_5_whys 工具，支持将查询主题拆解为 5 Whys 多层追问。
• 本地知识库集成：内置数据适配器，暴露 list_local_notes 和 read_local_note 两个核心工具，支持大模型直接读取本地 Obsidian (.md) 文件夹内容。
• 知识库资源暴露：新增被动资源读取协议 obsidian-index (obsidian://vault/index)，向客户端暴露本地知识库的完整目录结构。
• 源码级联调环境：配置 tsconfig.json 生成 sourceMap，并在 .vscode/launch.json 中配置 --inspect=9229 端口映射，实现基于底层 Node 进程的断点与日志监控。

Changed (变更)

(无)

Deprecated (废弃)

(无)

Removed (移除)

(无)

Fixed (修复)

(无)

Security (安全)

• 沙箱隔离与越权防御：在 read_local_note 本地资源服务中实现严格的路径防穿越（Path Traversal）安全校验，将 AI 生成的指令视为不可信负载，直接拦截并阻断读取指定工作目录之外的恶意文件请求。