81 lines
2.6 KiB
Markdown
81 lines
2.6 KiB
Markdown
# deb-publisher
|
|
|
|
帮助 Agent 复用项目已有的 DEB 打包与发布方式，完成构建、包检查、上传和发布验证。
|
|
|
|
## 什么时候使用
|
|
|
|
当你希望 Agent 处理以下任务时使用：
|
|
|
|
- “帮我构建这个项目的 DEB 包”
|
|
- “把 1.2.3 版本的 DEB 发布到包仓库”
|
|
- “看看项目里的 DEB 发布流程”
|
|
- “检查这个 DEB 是否可以发布”
|
|
|
|
只想在本机安装一个 `.deb`，或者要构建 RPM、Docker 镜像时，不需要使用这个 skill。
|
|
|
|
## 使用前准备
|
|
|
|
请准备或确认：
|
|
|
|
- 要构建或发布的版本号。
|
|
- 项目已经配置好构建脚本、Make 目标或 `debian/` 目录；上传脚本由 skill 自带，
|
|
不需要放进项目。
|
|
- 发布所需的令牌已经放入项目约定的环境变量或密钥系统。
|
|
- 如果要真实发布，明确告诉 Agent 目标仓库以及是否允许覆盖同版本。
|
|
|
|
不要把令牌直接粘贴到对话、命令参数或项目文件中。
|
|
|
|
## 使用示例
|
|
|
|
仅分析，不产生或上传包：
|
|
|
|
```text
|
|
看看这个项目的 DEB 是怎么构建和发布的。
|
|
```
|
|
|
|
只构建和检查，不上传：
|
|
|
|
```text
|
|
使用 deb-publisher 构建 1.2.3 的 DEB，检查包元数据和内容，不要上传。
|
|
```
|
|
|
|
构建并发布：
|
|
|
|
```text
|
|
使用 deb-publisher 构建并发布 1.2.3 的 amd64 DEB 到项目已配置的测试仓库。
|
|
```
|
|
|
|
发布已有产物：
|
|
|
|
```text
|
|
使用 deb-publisher 检查并发布 ./dist/example_1.2.3_amd64.deb。
|
|
```
|
|
|
|
## Agent 会做什么
|
|
|
|
Agent 会优先发现和复用项目已有入口，然后：
|
|
|
|
1. 确认版本、架构、产物路径、目标仓库和授权范围。
|
|
2. 构建 DEB，或定位你指定的已有产物。
|
|
3. 检查包的元数据、内容和 SHA-256。
|
|
4. 在你明确要求发布时，通过 skill 自带的 `scripts/upload_deb.sh` 上传。
|
|
5. 检查服务端响应，并在仓库支持时确认该版本已经可见。
|
|
|
|
## 如何判断完成
|
|
|
|
结果中应包含包名、版本、架构、产物路径、SHA-256，以及构建、上传和仓库可见性的
|
|
独立状态。异步索引尚未完成时，Agent 应明确说明“上传已接受，索引待更新”。
|
|
|
|
## 上传协议
|
|
|
|
自带脚本适用于接收 multipart 字段 `package`、`token` 和 `repository_name` 的
|
|
HTTP DEB 仓库，默认路径是 `/api/v2/upload/package`。使用以下环境变量：
|
|
|
|
- `DEB_SERVER_URL`：仓库服务地址。
|
|
- `DEB_TOKEN`：认证令牌。
|
|
- `DEB_REPOSITORY`：目标仓库名。
|
|
- `DEB_UPLOAD_PATH`：可选的上传路径覆盖。
|
|
|
|
令牌只从环境变量读取，不作为命令行参数传递。若你的仓库使用其他 API 协议，应先告诉
|
|
Agent，不要直接套用该脚本。
|