# 火炬 VOD 管理器

一个**轻量、开源**的阿里云视频点播（VOD）媒体资源管理工具，解决官方控制台批量下载、删除操作繁琐的问题。

> **注意**：Web 版已废弃，当前主要维护 **macOS 原生 SwiftUI 版本**，目标上架 Mac App Store。

## 功能特性

- 视频库快速查看、搜索
- 批量下载到用户指定目录
- 下载文件自动使用视频标题重命名
- 多账号 / 多 Region 切换管理
- 下载任务历史
- 操作日志审计
- 浏览器下载与下载工具（aria2 / wget）两种导出方式

## 技术栈

- **macOS 客户端**：Swift 6 + SwiftUI + SwiftData
- **阿里云 API**：自实现 POP 签名，直接调用 VOD OpenAPI
- **网络**：URLSession
- **持久化**：SwiftData（SQLite）

## 项目结构

```
.
├── apps/
│   ├── macos/        # macOS 原生 SwiftUI 应用（当前维护重点）
│   ├── web/          # React 前端（已废弃，保留作为历史参考）
│   └── server/       # Express 后端（已废弃，保留作为历史参考）
├── docs/             # 文档
├── PRD.md            # 产品需求文档
├── README.md
└── AGENTS.md
```

## macOS 版快速开始

```bash
cd apps/macos/VODManager
swift build
swift run
```

或在 Xcode 中打开 `Package.swift`。

## App Store 上架准备

1. 在 Xcode 中配置 Signing & Capabilities
2. 使用 `apps/macos/VODManager/VODManager.entitlements` 中的沙盒配置
3. 配置 Bundle Identifier 和 Team
4. 提交 Mac App Store 审核

## 阿里云 RAM 最小权限

建议为本工具单独创建 RAM 子用户：

```json
{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "vod:Get*",
        "vod:List*",
        "vod:SearchMedia",
        "vod:GetPlayInfo",
        "vod:DeleteVideo",
        "vod:UpdateVideoInfo"
      ],
      "Resource": "*"
    }
  ]
}
```

## License

[MIT](./LICENSE)