# Admin PDA 版本发布模块指引

## 路径基准与读取顺序

- 本文件适用于 `src/modules/pda-releases/`，代码路径相对本目录；应用公共规则见 `../../../AGENTS.md`。
- 只有 `pages/PdaReleasesView.vue` 与 `api/pdaReleases.ts`；上传草稿、发布与停发都在同一页。
- 后端归 `file/`（`PdaReleaseController`、`PdaReleaseService`、`pda-releases-v1.yaml`），接口经 `/platform/v1/files/pda-releases`；设备端更新逻辑在两端 PDA 的 `app-update` 工具里。

## 页面与入口

| 目标 | 页面/入口 | API 与后端 |
|---|---|---|
| 国内/海外 APK、WGT 版本列表与上传 | `pages/PdaReleasesView.vue` | `api/pdaReleases.ts`；`file/` |
| 发布与停发 | 列表行操作 | `api/pdaReleases.ts`；权限 `platform:pda-release:manage` |
| 匿名清单与包下载（设备侧） | 不在本页 | `file/` 匿名入口，只暴露当前已发布与历史未停发文件 |

## 关键边界

- 上传只创建草稿，不自动发布；发布与停发必须二次确认，并展示影响端（国内/海外）。
- 国内与海外按 `domestic/overseas` 分开查询与操作，AppID、包名、签名与版本序列不得混用。
- 列表权限 `platform:pda-release:list`，上传/发布/停发权限 `platform:pda-release:manage`。
- 停发只影响后续下载，不追回已安装设备；强更与 WGT 安装重启由设备端策略决定，本模块不越权。

## 验证

- 定向：`pnpm test src/modules/pda-releases/<目标测试>`；接口变化同时核对 `file/` 的 `pda-releases-v1.yaml`。
- 本文件或索引变更后，从后端根运行 `./scripts/agents-index-contract.ps1`。