🔄 卡若AI 同步 2026-02-15 23:38 | 变更 7 个文件 | 排除 >20MB: 4 个

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 | 凭证 |

_共享模块/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

_共享模块/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"

_共享模块/wiki_source/Home.md

@@ -12,6 +12,7 @@
 | [五行角色](五行角色) | 卡资/卡人/卡木/卡火/卡土 职责与成员 |
 | [技能索引](技能索引) | 38 个 Skill 与触发词 |
 | [Gitea 使用](Gitea使用) | 工单、合并请求、版本发布、项目 |
+| [代码管理与脚本](代码管理与脚本) | 上传脚本、代码管理记录、界面功能说明 |
 
 ---
 

_共享模块/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 页操作即可；脚本与说明以本百科和仓库内文档为准。

_共享模块/工作台/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 个 |

_共享模块/工作台/代码管理.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) |