版本升级说明

本页用于集中记录 NcfPackageSources 的重要升级项。
面向对象：升级项目的开发者、维护者、运维同学。

使用方式

每次升级前后，建议按下面顺序检查：

1. 先看“升级摘要”，确认本次影响范围。
2. 再看“行为变化清单”，确认是否影响现有模块。
3. 最后看“升级后验证清单”，完成最小回归检查。

当前基线

• 文档基线提交：631f16b4（2026-06-17）
• 对应能力文档：
  • NcfPackageSources 源码指南
  • NCF 核心能力详解
  • 新手快速上手（60 分钟）

升级摘要（2026-06）

1. 模块化注册与治理

• Function 注册推荐路径统一为 [FunctionRender] 自动扫描。
• MCP 作为模块能力由接口契约统一管理。
• 模块排障建议统一顺序：模块状态 -> 注册状态 -> 鉴权策略 -> 运行时日志。

2. AI / RAG 实战链路

• 可按 AIKernel -> PromptRange -> AgentsManager -> KnowledgeBase 完成最小闭环。
• KnowledgeBase 支持文件切片、向量化、召回测试的基础流程。

3. 开源协作与文档共建

• 文档明确了 Issue / PR 最小信息模板与提交建议。
• 新增了“从使用者到贡献者”的流程说明，便于团队内外协作。

行为变化记录模板（后续新增请按此格式）

YYYY-MM-DD / vX.Y.Z

• 影响模块：Senparc.Xncf.XXX / Senparc.Ncf.XXX
• 变化类型：新增 / 调整 / 弃用 / 安全修复
• 关键变化：
  • ...
• 升级动作：
  • ...
• 回退建议：
  • ...
• 验证清单：
  • ...

升级后验证清单（建议最小项）

• 模块安装、启用、菜单可见状态正常。
• Function 与 MCP 注册结果可查询且可调用。
• 管理接口鉴权（Cookie / Bearer / Policy）符合预期。
• 关键日志无持续性错误（数据库、模型服务、网络依赖）。