fb63d134e5
- gitea_ops.py: API CLI(组织/成员/工单/标签/里程碑/仓库),纯标准库 - board_ops.py: 看板网页 CLI(Playwright),处理 Gitea 1.26 看板无 API 限制 - SKILL.md: QwenPaw skill 文档(命令手册 + 血泪教训 + 失败模式) - README.md: 项目说明
35 lines
1.5 KiB
Markdown
35 lines
1.5 KiB
Markdown
# GiteaProjectOps — Gitea 项目治理自动化工具箱
|
||
|
||
对 Gitea 组织/仓库做项目治理操作的完整工具箱:**工单(issue)、标签(label)、里程碑(milestone)、人员(组织成员)、组织/仓库信息、看板(project board)**。
|
||
|
||
## 组件
|
||
|
||
| 文件 | 说明 |
|
||
|---|---|
|
||
| `SKILL.md` | QwenPaw 可复用 Skill(`/gitea-project-manage`),含完整命令手册与踩坑记录 |
|
||
| `scripts/gitea_ops.py` | API CLI:工单/标签/里程碑/成员/组织/仓库(Python 标准库,零依赖) |
|
||
| `scripts/board_ops.py` | 看板网页 CLI:新建/改名/删除看板、列管理、工单进看板、卡片拖拽(Playwright) |
|
||
|
||
## 为什么拆两个脚本
|
||
|
||
Gitea 1.26 的看板(Projects)**没有 REST API**(swagger 300 个端点无 project 相关),
|
||
工单/标签/里程碑有 API,但看板必须走浏览器 DOM 操作。详见 `SKILL.md`。
|
||
|
||
## 快速开始
|
||
|
||
```bash
|
||
# API 操作(token 默认读 /app/working.secret/gitea_token)
|
||
python3 scripts/gitea_ops.py org members
|
||
python3 scripts/gitea_ops.py issue list PineSoundServer --state open
|
||
|
||
# 看板操作(需 playwright + Gitea 账号)
|
||
pip install playwright && playwright install chromium
|
||
GITEA_USER=<用户名> GITEA_PASS=<密码> python3 scripts/board_ops.py boards PineSoundServer
|
||
```
|
||
|
||
## 环境
|
||
|
||
- Gitea:内网 `http://192.168.1.3:10082`(API 前缀 `/api/v1`)· 外网 `code.infoepoch.cn`
|
||
- 组织:`PineSound`
|
||
- 详见 `SKILL.md` 的环境与凭据章节。
|