用途：这是一份 Zitadel 参考索引，按主题组织资料，便于在升级、生成客户端、替换 Login、迁移 Actions 或运维自托管安装时只加载与任务相关的内容。
主要能力：索引包含 release-changes-by-topic.md（升级风险、API 过渡、安全修复、Login 变更、身份提供商、遥测、安装与维护）、api-and-protocols.md（旧版与基于资源的 API、ConnectRPC、SCIM、OIDC、OAuth、JWT 断言、令牌声明、登出、SAML、探针）、actions.md（Actions V2 目标与执行、载荷校验、变更契约、V1 迁移、会话并发策略）、integrations-and-idps.md、login-and-management.md、concepts-and-migrations.md、application-examples.md、sdk-and-clients.md、self-hosting-and-operations.md。
关键要点：升级前需重新评估许可（服务器仓库视为 AGPLv3）；CockroachDB 不能就地升级，当前存储仅支持 PostgreSQL，需用镜像工作流迁移事件历史并保留源加密密钥；优先使用基于资源的 API，组织上下文从 x-zitadel-orgid 移到请求的 organization_id 字段；新自动化应迁移到 Actions V2，V1 已冻结并计划移除，启用 V2 不会禁用 V1，需防止重复副作用；自定义 Login 应基于 Login V2 与 Session API，会话令牌每次返回都是替换，只保留最新；自托管应使用容器路径，init 每次安装运行一次，setup 每个部署的二进制运行，start 仅在 setup 成功后运行。
使用方式：按任务查阅对应参考文件；API 与协议部分给出旧版服务的作用域、REST 与 gRPC 前缀，OIDC 端点通过 /.well-known/openid-configuration 发现，浏览器应用使用带 PKCE 的授权码流程；机器认证按调用方选择 Basic、private_key_jwt、客户端凭证、PAT 或 JWT bearer；Actions V2 通过 POST /v2/actions/targets 创建目标并绑定条件。
限制：资料未提供具体版本号、价格、平台支持范围或效果数据；部分行为（如投影最终一致性、事件序列）需以实际部署验证，不应推断事件序列连续。