From acb81d3240b5380117be917909525b45e3a114ba Mon Sep 17 00:00:00 2001 From: karuo Date: Sun, 15 Feb 2026 23:38:02 +0800 Subject: [PATCH] =?UTF-8?q?=F0=9F=94=84=20=E5=8D=A1=E8=8B=A5AI=20=E5=90=8C?= =?UTF-8?q?=E6=AD=A5=202026-02-15=2023:38=20|=20=E5=8F=98=E6=9B=B4=207=20?= =?UTF-8?q?=E4=B8=AA=E6=96=87=E4=BB=B6=20|=20=E6=8E=92=E9=99=A4=20>20MB:?= =?UTF-8?q?=204=20=E4=B8=AA?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../_团队成员/金仓/Gitea管理/SKILL.md | 48 +++++++++++++--- _共享模块/scripts/init_wiki_gitea.sh | 35 ++++++++++++ _共享模块/scripts/sync_wiki_to_gitea.sh | 9 ++- _共享模块/wiki_source/Home.md | 1 + _共享模块/wiki_source/代码管理与脚本.md | 55 +++++++++++++++++++ _共享模块/工作台/gitea_push_log.md | 1 + _共享模块/工作台/代码管理.md | 1 + 7 files changed, 141 insertions(+), 9 deletions(-) create mode 100755 _共享模块/scripts/init_wiki_gitea.sh create mode 100644 _共享模块/wiki_source/代码管理与脚本.md diff --git a/01_卡资（金）/_团队成员/金仓/Gitea管理/SKILL.md b/01_卡资（金）/_团队成员/金仓/Gitea管理/SKILL.md index 0130fa99..668184c2 100644 --- a/01_卡资（金）/_团队成员/金仓/Gitea管理/SKILL.md +++ b/01_卡资（金）/_团队成员/金仓/Gitea管理/SKILL.md @@ -3,7 +3,7 @@ name: Gitea管理 description: CKB NAS 自建 Gitea 的仓库创建、推送、API、挂载管理。触发词：Gitea、推送到Gitea、创建仓库、Git推送、CKB Git、界面不显示。统一用 HTTPS+API 创建，确保仓库在 Gitea 界面可见。 triggers: Gitea、Gitea管理、推送到Gitea、创建Gitea仓库、Git推送CKB、CKB_NAS_Git、仓库界面不显示 owner: 金仓 -version: "1.0" +version: "1.1" updated: "2026-02-15" --- @@ -88,13 +88,7 @@ git push -u gitea main --- -## 七、关联文档 - -| 文档 | 路径 | 说明 | -|------|------|------| -| Gitea 推送手册 | `_共享模块/references/Gitea推送_卡若AI调用手册.md` | 卡若AI 调用流程 | -| 账号与 API | `_共享模块/工作台/00_账号与API索引.md` § Gitea | 凭证 | -| CKB NAS Gitea 访问 | `群晖NAS管理/references/CKB_NAS_Gitea_类GitHub访问.md` | 部署与访问 | +## 七、关联文档（见第十一节） --- @@ -104,3 +98,41 @@ git push -u gitea main 2. 新建仓库 → 用 API 创建 3. 推送 → `git push gitea main`（remote 用 HTTPS URL） 4. 检查界面 → http://open.quwanzhi.com:3000/fnvtk/ + +--- + +## 九、界面功能（工单 / 合并请求 / 百科 / 版本发布 / 项目） + +确保仓库在 Gitea 上以下功能可用、有说明可查： + +| 功能 | 说明 | +|:---|:---| +| **工单** | 模板在 `.gitea/ISSUE_TEMPLATE/`，新建工单可选：功能建议、Bug 反馈、任务报备 | +| **合并请求** | 模板 `.gitea/pull_request_template.md`，合并时带出说明与自检项 | +| **百科** | 源在 `_共享模块/wiki_source/`，含 Home、快速开始、五行角色、技能索引、Gitea使用、**代码管理与脚本**；同步脚本 `sync_wiki_to_gitea.sh` | +| **版本发布** | 脚本 `_共享模块/scripts/create_gitea_release.sh` 可打 tag 并建 Release | +| **项目** | 在 Gitea 页「项目」新建看板，工单拖入待办/进行中/已完成 | +| **代码管理** | 每次上传写入 `_共享模块/工作台/代码管理.md`（代码推送+百科同步结果+链接） | + +--- + +## 十、上传时同步的板块（卡若AI 有更新就上传） + +执行 `bash _共享模块/auto_sync_gitea.sh` 时会： + +1. **代码**：排除 >20MB → 提交 → 推送到 Gitea 主仓 +2. **百科**：自动执行 `sync_wiki_to_gitea.sh`，将 wiki_source 推送到仓库「百科」页 +3. **代码管理**：写入 `gitea_push_log.md` 与 `代码管理.md`（时间、代码/百科结果、提交说明、仓库/百科链接） + +若百科尚未初始化（首次为空）：可先到 Gitea 仓库「百科」→「创建第一个页面」标题填 **Home** 保存一次，再执行上传；或运行 `bash _共享模块/scripts/init_wiki_gitea.sh` 尝试 API 初始化。 + +--- + +## 十一、关联文档 + +| 文档 | 路径 | 说明 | +|------|------|------| +| Gitea 推送手册 | `_共享模块/references/Gitea推送_卡若AI调用手册.md` | 卡若AI 调用、有更新就上传、代码管理 | +| 工单/合并请求/Wiki/发布 | `_共享模块/references/Gitea_工单与合并请求使用说明.md` | 各功能使用说明 | +| 代码管理 | `_共享模块/工作台/代码管理.md` | 每次上传记录 | +| 账号与 API | `_共享模块/工作台/00_账号与API索引.md` § Gitea | 凭证 | diff --git a/_共享模块/scripts/init_wiki_gitea.sh b/_共享模块/scripts/init_wiki_gitea.sh new file mode 100755 index 00000000..713b9a3b --- /dev/null +++ b/_共享模块/scripts/init_wiki_gitea.sh @@ -0,0 +1,35 @@ +#!/bin/bash +# 尝试通过 Gitea API 初始化百科（创建第一页），使后续 sync_wiki_to_gitea.sh 可推送 +# 若 API 不支持或失败，请到 Gitea 仓库「百科」→「创建第一个页面」标题填 Home 保存一次 + +REPO_DIR="/Users/karuo/Documents/个人/卡若AI" +WIKI_SRC="$REPO_DIR/_共享模块/wiki_source" +API="http://open.quwanzhi.com:3000/api/v1" +AUTH="fnvtk:Zhiqun1984" +OWNER="fnvtk" +REPO="karuo-ai" + +# 若已有 Home 内容则用其 base64，否则用简单占位（macOS 兼容） +if [ -f "$WIKI_SRC/Home.md" ]; then + CONTENT_B64=$(base64 < "$WIKI_SRC/Home.md" | tr -d '\n') +else + CONTENT_B64=$(echo -n "# Home" | base64 | tr -d '\n') +fi + +# 尝试 Gitea 1.19+ Wiki API（部分版本支持） +HTTP=$(curl -s -o /dev/null -w "%{http_code}" -u "$AUTH" -X POST "$API/repos/$OWNER/$REPO/wiki/page" \ + -H "Content-Type: application/json" \ + -d "{\"title\":\"Home\",\"content_base64\":\"$CONTENT_B64\",\"message\":\"init\"}" 2>/dev/null) + +if [ "$HTTP" = "201" ] || [ "$HTTP" = "200" ]; then + echo "百科已通过 API 初始化。" + exit 0 +fi + +# 不支持或失败：提示手动创建第一页 +echo "百科尚未初始化。请到 Gitea 仓库页操作一次：" +echo " 1. 打开 http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki" +echo " 2. 点击「创建第一个页面」" +echo " 3. 标题填 Home，内容随意，保存" +echo " 4. 再运行: bash _共享模块/scripts/sync_wiki_to_gitea.sh" +exit 1 diff --git a/_共享模块/scripts/sync_wiki_to_gitea.sh b/_共享模块/scripts/sync_wiki_to_gitea.sh index be791cb5..ae0b001d 100755 --- a/_共享模块/scripts/sync_wiki_to_gitea.sh +++ b/_共享模块/scripts/sync_wiki_to_gitea.sh @@ -13,7 +13,14 @@ mkdir -p "$(dirname "$WIKI_CLONE")" if [ ! -d "$WIKI_CLONE/.git" ]; then rm -rf "$WIKI_CLONE" 2>/dev/null || true - git clone "$WIKI_REMOTE" "$WIKI_CLONE" + if ! git clone "$WIKI_REMOTE" "$WIKI_CLONE" 2>/dev/null; then + echo "百科尚未初始化，尝试通过 API 初始化..." + bash "$REPO_DIR/_共享模块/scripts/init_wiki_gitea.sh" 2>/dev/null || true + if ! git clone "$WIKI_REMOTE" "$WIKI_CLONE" 2>/dev/null; then + echo "请到 Gitea 仓库「百科」→「创建第一个页面」，标题填 Home 保存一次，再运行本脚本。" + exit 1 + fi + fi fi cd "$WIKI_CLONE" diff --git a/_共享模块/wiki_source/Home.md b/_共享模块/wiki_source/Home.md index 21110953..41cd7aea 100644 --- a/_共享模块/wiki_source/Home.md +++ b/_共享模块/wiki_source/Home.md @@ -12,6 +12,7 @@ | [五行角色](五行角色) | 卡资/卡人/卡木/卡火/卡土 职责与成员 | | [技能索引](技能索引) | 38 个 Skill 与触发词 | | [Gitea 使用](Gitea使用) | 工单、合并请求、版本发布、项目 | +| [代码管理与脚本](代码管理与脚本) | 上传脚本、代码管理记录、界面功能说明 | --- diff --git a/_共享模块/wiki_source/代码管理与脚本.md b/_共享模块/wiki_source/代码管理与脚本.md new file mode 100644 index 00000000..e71ba5c7 --- /dev/null +++ b/_共享模块/wiki_source/代码管理与脚本.md @@ -0,0 +1,55 @@ +# 代码管理与脚本 + +本仓库在 Gitea 上的**代码管理**与**同步脚本**说明，上传时都会更新到此处。 + +--- + +## 一、代码管理记录 + +每次上传到 Gitea 后，本地会写入**代码管理**记录，便于追溯版本与同步结果。 + +| 项 | 说明 | +|:---|:---| +| **记录文件** | 仓库内 `_共享模块/工作台/代码管理.md` | +| **内容** | 时间、代码推送结果、百科同步结果、提交说明、仓库/百科链接 | +| **推送记录** | `_共享模块/工作台/gitea_push_log.md`（每次推送追加一行） | + +--- + +## 二、上传与同步脚本（Gitea 相关） + +| 脚本 | 路径 | 作用 | +|:---|:---|:---| +| **自动上传（代码+百科+代码管理）** | `_共享模块/auto_sync_gitea.sh` | 有更新时执行：排除 >20MB → 提交 → 推送到 Gitea → 同步百科 → 写入代码管理 | +| **百科同步** | `_共享模块/scripts/sync_wiki_to_gitea.sh` | 将 `_共享模块/wiki_source/` 推送到 Gitea「百科」页 | +| **版本发布** | `_共享模块/scripts/create_gitea_release.sh` | 打 tag 并创建 Release。例：`bash _共享模块/scripts/create_gitea_release.sh v1.0.0 "说明"` | + +执行顺序建议：日常只跑 `auto_sync_gitea.sh`，会自动尝试同步百科并写代码管理。 + +--- + +## 三、界面功能（工单 / 合并请求 / 百科 / 版本发布 / 项目） + +| 功能 | 入口 | 说明 | +|:---|:---|:---| +| **代码** | 仓库页「<> 代码」 | 主仓库代码与目录 | +| **工单** | 「工单」 | 新建可选模板：功能建议、Bug 反馈、任务报备 | +| **合并请求** | 「合并请求」 | 分支合并到 main，带合并说明模板 | +| **百科** | 「百科」 | 本文档所在处，由 wiki_source 同步 | +| **版本发布** | 「版本发布」 | Tag + 发布说明，可用脚本创建 | +| **项目** | 「项目」 | 看板：待办/进行中/已完成，工单可拖入 | +| **动态** | 「动态」 | 自动展示提交与工单/MR 动态 | + +仓库地址：**http://open.quwanzhi.com:3000/fnvtk/karuo-ai** + +--- + +## 四、上传时需整理并同步的板块 + +以后每次上传时，会一并整理并更新到 Gitea 的包括： + +- **代码**：主仓变更（>20MB 不传） +- **百科**：本目录（wiki_source）全部页面 +- **代码管理**：本地 `代码管理.md` 与 `gitea_push_log.md` 追加当次记录 + +工单、合并请求、版本发布、项目在 Gitea 页操作即可；脚本与说明以本百科和仓库内文档为准。 diff --git a/_共享模块/工作台/gitea_push_log.md b/_共享模块/工作台/gitea_push_log.md index cbc454d6..d98f63d9 100644 --- a/_共享模块/工作台/gitea_push_log.md +++ b/_共享模块/工作台/gitea_push_log.md @@ -7,3 +7,4 @@ |:---|:---| | 2026-02-15 23:09:40 | 🔄 卡若AI 同步 2026-02-15 23:09 | 变更 5 个文件 | 排除 >20MB: 4 个 | | 2026-02-15 23:26:43 | 🔄 卡若AI 同步 2026-02-15 23:26 | 变更 21 个文件 | 排除 >20MB: 4 个 | +| 2026-02-15 23:34:04 | 🔄 卡若AI 同步 2026-02-15 23:34 | 变更 7 个文件 | 排除 >20MB: 4 个 | diff --git a/_共享模块/工作台/代码管理.md b/_共享模块/工作台/代码管理.md index 3cb1cd93..3366f4ec 100644 --- a/_共享模块/工作台/代码管理.md +++ b/_共享模块/工作台/代码管理.md @@ -10,3 +10,4 @@ | 时间 | 代码推送 | 百科同步 | 提交说明 | 链接 | |:---|:---|:---|:---|:---| +| 2026-02-15 23:34:04 | 成功 | 失败(百科未初始化或网络) | 🔄 卡若AI 同步 2026-02-15 23:34 | 变更 7 个文件 | 排除 >20MB: 4 个 | [仓库](http://open.quwanzhi.com:3000/fnvtk/karuo-ai) [百科](http://open.quwanzhi.com:3000/fnvtk/karuo-ai/wiki) |