springaialibabapractice 发布门户

「降 Spring AI 阿里」18 掌配套代码仓：每一掌都能跑、能验收、能回滚。 本页是稳定入口——版本契约看 Releases，掌次路线看仓库文档，协作入口在文末。

本页由 .github/workflows/deploy-pages.yml 从 docs/site/ 自动发布。 改动本页 = 提交一次 PR；不允许直接编辑 Pages 产物。

Quick Start

环境要求：JDK 21 LTS + Maven 3.9+（用仓库自带 ./mvnw 即可）+ Docker（可选）。 不需要任何密钥就能跑通编译与单测。 

git clone git@github.com:lifuchun522/springaialibabapractice.git
cd springaialibabapractice
./mvnw -B -ntp clean verify        # 编译 + 单测 + 架构图门禁 + 索引死链门禁

想看完整效果：按仓库 README 第七节一键启动（docker compose 一条命令起全套）。 遇到「跑不起来」请先到 Discussions 问答 提问（工作日 48 小时内首次响应）。

版本入口（Releases）

软件版本从 v0.1.0 起，语义化版本；每个版本页给出该版本的改动分类 （新增 / 修复 / 文档 / 依赖 / 安全 / 其他）。

掌次路线

仓库有两套 tag，语义不混用：

tag指向什么用在哪
ch01 – ch18 教程章节（文章 + 视频对应的那一掌） 跟着系列连载读；不产生 Release
v* 软件版本（符合 SemVer） 取用某个可复现的代码状态；Release 只在这里创建

十八掌的完整目录、按角色选路线、每掌的验收记录： README · docs/

FAQ

问题答案
版本和章节是一回事吗？ 不是。ch* 是教程章节标签，v* 是软件版本。要看版本改动去 Releases，要按课程学去 README。
该从哪一掌开始读？ 按角色选路线，不要从头读到尾。见 Discussions #60 的起点对照。
仓库有治理/运维相关的文档吗？ 有，十三保仓库运营治理在 docs/github-ops/。
发现安全漏洞怎么办？ 不要在公开 Issue 里贴细节，走 私密漏洞报告。 见 SECURITY.md。
本地跑需要哪些密钥？ 编译与单测不需要任何密钥。要调真实模型时用环境变量注入，见 .env.example。

贡献入口