karuo-ai/_共享模块/references/Gitea_工单与合并请求使用说明.md

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 页直接阅读。

内容来源与同步

• 源目录：_共享模块/wiki_source/（Home.md、快速开始、五行角色、技能索引、Gitea使用 等）
• 同步到 Gitea 百科：执行
  bash _共享模块/scripts/sync_wiki_to_gitea.sh
  会将上述 Markdown 推送到 Gitea 的「百科」页。
• 若百科尚未初始化：请先在 Gitea 仓库页打开「百科」→「创建首页」，保存一次后再运行上述脚本。

操作

• 改完 wiki_source/ 后运行上述脚本即可更新线上百科。
• 百科首次为空时：到 Gitea 仓库「百科」→「创建第一个页面」，标题填 Home 保存一次，再运行脚本；之后每次上传会自动同步。
• 百科中已包含 代码管理与脚本 说明（上传脚本、代码管理记录、工单/合并请求/版本发布/项目 入口）。

---

四、版本发布（Releases）

功能

• 为重要节点打 Tag，并写发布说明，便于回溯与分发。

脚本（可选）

bash _共享模块/scripts/create_gitea_release.sh [版本号] [说明]
# 例：bash _共享模块/scripts/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 的管理后台中调整。