# 发布索引（Releases）

本目录登记**公开版本与资产索引**。每个发布一个文件：`vX.Y.Z.md`，记录发布元数据、产物与验证边界。

## 发布规则
- 版本号语义化（MAJOR.MINOR.PATCH）。
- 发布前必须：对应 DV verification.md 证据通过；ADR 无未决的重大分歧。
- 发布文件中须给出「验证边界」：哪些 DV 被覆盖、如何复验、已知限制。
- 部署/配置相关变更同步到 [`docs/deploy/README.md`](../../deploy/README.md) 与 [配置变更日志](../../deploy/changelog.md)。
- **版本以 git 为准**：发布必须对应一个 git 版本标记（优先使用 tag；历史提交以提交信息中的 vX.Y.Z 为准）；代码内版本字段应与 git 标记一致。

## 版本列表（对齐 git）
| 版本 | 文件 | 对应 git 标记 | 主要规格覆盖 | 状态 |
| --- | --- | --- | --- | --- |
| **v1.0.0** | [v1.0.0.md](v1.0.0.md) | 基线 `ba80d28`，**待打 tag `v1.0.0`** | DV-0001 ~ DV-0011 全量（首个正式版本） | 待发布 |
| v0.9.9 | [v0.9.9.md](v0.9.9.md) | `416ef48 v0.9.9` / `f92fff6 基线版本` / `eea3b96 v0.9.9-SP1` | 阶段一~三全部 DV | 历史发布记录 |
| v0.9.6 | [v0.9.6.md](v0.9.6.md) | `c005964 v0.9.6` | MCP 内集成/凭证管理/Python3.12/storage 持久化（历史） | 历史发布记录 |

> git 发布线：v0.9.1 → v0.9.2 → v0.9.6 → v0.9.7 → v0.9.8 → v0.9.9（含 `-SP1`）→ **v1.0.0（待打 tag）**。
> 仓库历史**未使用 git tag**，上表在 v1.0.0 之前以提交信息中的版本标记为准；自 v1.0.0 起发布**必须打 tag**。
>
> v1.0.0 是首个正式大版本：代码内版本字段（`APP_VERSION`、`package.json version`）已统一为 1.0.0，此前的「遗留占位」说明随本发布失效。
>
> v0.9.6 / v0.9.9 为**历史发布记录**（v0.9.6 整合自原 `docs/UPGRADE_v0.9.6.md`）；其中的「版本对齐说明」「已知差异」保留原文，仅用于追溯。

## 部署/配置类变更
不占用发布号的运维与配置变更，记录在 [docs/deploy/changelog.md](../../deploy/changelog.md)（原根目录 `CHANGELOG_DEPLOY.md`，已迁入 `docs/`）。