108 lines
4.0 KiB
Markdown
108 lines
4.0 KiB
Markdown
# Gitea 工单、合并请求、百科、版本发布、项目 — 使用说明
|
||
|
||
> 仓库：http://open.quwanzhi.com:3000/fnvtk/karuo-ai
|
||
> 本文路径：`运营中枢/references/Gitea_工单与合并请求使用说明.md`
|
||
|
||
---
|
||
|
||
## 一、工单（Issues）
|
||
|
||
### 功能
|
||
- 记录需求、Bug、任务，便于追踪和协作。
|
||
- 新建时可选择模板，规范填写。
|
||
|
||
### 模板（仓库内已配置）
|
||
| 模板 | 用途 |
|
||
|:---|:---|
|
||
| 功能建议 | 为新功能或优化提想法，可勾选所属板块（金/水/木/火/土） |
|
||
| Bug 反馈 | 反馈错误与异常，填复现步骤与期望/实际行为 |
|
||
| 任务报备 | 记录计划中或进行中的任务，便于同步 |
|
||
| 默认工单 | 通用，自由填写 |
|
||
|
||
### 操作
|
||
1. 打开仓库 → 点「工单」→「新建工单」
|
||
2. 选择上述任一模板，按项填写后提交。
|
||
|
||
---
|
||
|
||
## 二、合并请求（Merge Requests）
|
||
|
||
### 功能
|
||
- 将分支改动合并进 `main` 前做评审与记录。
|
||
- 可与工单关联（如填写「Closes #1」）。
|
||
|
||
### 模板（仓库内已配置）
|
||
- 合并说明、变更类型（Skill/规则、脚本、结构等）、关联工单、自检（如无 >20MB 大文件）。
|
||
|
||
### 操作
|
||
1. 在分支上完成修改并推送到 Gitea
|
||
2. 仓库页「合并请求」→「新建合并请求」，选择分支 → main
|
||
3. 按模板补充说明后创建，审核通过后合并。
|
||
|
||
---
|
||
|
||
## 三、百科（Wiki）
|
||
|
||
### 功能
|
||
- 仓库的说明文档，独立于代码目录，便于在 Gitea 页直接阅读。
|
||
|
||
### 内容来源与同步
|
||
- **源目录**：`01_卡资（金）/金仓_存储备份/Gitea管理/百科源文件/`（Home.md、快速开始、五行角色、技能索引、Gitea使用 等）
|
||
- **同步到 Gitea 百科**：执行
|
||
`bash 01_卡资（金）/金仓_存储备份/Gitea管理/脚本/sync_wiki_to_gitea.sh`
|
||
会将上述 Markdown 推送到 Gitea 的「百科」页。
|
||
- **若百科尚未初始化**：请先在 Gitea 仓库页打开「百科」→「创建首页」，保存一次后再运行上述脚本。
|
||
|
||
### 操作
|
||
- 改完 `wiki_source/` 后运行上述脚本即可更新线上百科。
|
||
- **百科首次为空时**：到 Gitea 仓库「百科」→「创建第一个页面」，标题填 **Home** 保存一次，再运行脚本；之后每次上传会自动同步。
|
||
- 百科中已包含 **代码管理与脚本** 说明（上传脚本、代码管理记录、工单/合并请求/版本发布/项目 入口）。
|
||
|
||
---
|
||
|
||
## 四、版本发布（Releases）
|
||
|
||
### 功能
|
||
- 为重要节点打 Tag，并写发布说明，便于回溯与分发。
|
||
|
||
### 脚本（可选）
|
||
```bash
|
||
bash 01_卡资（金）/金仓_存储备份/Gitea管理/脚本/create_gitea_release.sh [版本号] [说明]
|
||
# 例：bash 01_卡资（金）/金仓_存储备份/Gitea管理/脚本/create_gitea_release.sh v1.0.0 "首次结构化发布"
|
||
```
|
||
- 会在当前仓库打 tag 并推送到 Gitea，并调用 API 创建/更新 Release。
|
||
- 也可在 Gitea 页「版本发布」中手动新建发布。
|
||
|
||
---
|
||
|
||
## 五、项目（Projects）
|
||
|
||
### 功能
|
||
- 看板：将工单拖入「待办 / 进行中 / 已完成」等列，做任务排期与状态跟踪。
|
||
|
||
### 操作
|
||
1. 仓库页「项目」→「新建项目」
|
||
2. 添加列（如：待办、进行中、已完成）
|
||
3. 在「工单」中把对应工单关联到项目，并拖到对应列。
|
||
|
||
---
|
||
|
||
## 六、软件包（Packages）
|
||
|
||
### 说明
|
||
- 本仓库以文档与 Skill 为主，一般不使用「软件包」；若后续有需要再配置包类型。
|
||
|
||
---
|
||
|
||
## 七、动态（Activity）
|
||
|
||
### 说明
|
||
- 「动态」页自动展示提交、工单、合并请求等动态，无需额外配置。
|
||
|
||
---
|
||
|
||
## 八、界面与优化说明
|
||
|
||
- **工单 / 合并请求 / 百科 / 发布 / 项目** 的「该有的功能」已通过仓库内模板与脚本配置好，在 Gitea 页可直接使用。
|
||
- **Gitea 站点整体界面**（主题、布局、导航）由 Gitea 服务端与站点管理端配置，本仓库无法修改；若需改主题或菜单，需在 open.quwanzhi.com:3000 的**管理后台**中调整。
|