Initial commit: Momentry Core v0.1

- Rust-based digital asset management system - Video analysis: ASR, OCR, YOLO, Face, Pose - RAG capabilities with Qdrant vector database - Multi-database support: PostgreSQL, Redis, MongoDB - Monitoring system with launchd plists - n8n workflow automation integration
2026-03-16 15:07:33 +08:00
commit de14bd6afa
101 changed files with 19858 additions and 0 deletions
--- a/docs/INSTALL_GITEA.md
+++ b/docs/INSTALL_GITEA.md
@@ -0,0 +1,394 @@
+# Gitea 安裝指南 (本地部署)
+
+## 概述
+
+本文檔說明如何在 macOS 上安裝 Gitea Git 服務，配置為本地部署。
+
+---
+
+## 當前狀態
+
+| 項目 | 狀態 |
+|------|------|
+| Gitea | ✅ 已安裝 v1.25.3 |
+| 數據目錄 | /Users/accusys/momentry/var/gitea/ |
+| 配置目錄 | /Users/accusys/momentry/etc/gitea/ |
+| 日誌目錄 | /Users/accusys/momentry/log/ |
+| Plist | /Library/LaunchDaemons/com.momentry.gitea.plist |
+
+---
+
+## 安裝步驟
+
+### Step 1: 安裝 Gitea (使用 brew)
+
+```bash
+# 安裝 Gitea
+brew install gitea
+```
+
+**驗證**:
+```bash
+gitea --version
+# gitea version 1.25.3
+```
+
+---
+
+### Step 2: 建立目錄
+
+```bash
+# 建立數據目錄
+mkdir -p /Users/accusys/momentry/var/gitea/data
+mkdir -p /Users/accusys/momentry/var/gitea/log
+
+# 建立配置目錄
+mkdir -p /Users/accusys/momentry/etc/gitea
+
+# 建立日誌目錄
+mkdir -p /Users/accusys/momentry/log
+
+# 建立日誌文件
+touch /Users/accusys/momentry/log/gitea.log
+touch /Users/accusys/momentry/log/gitea.error.log
+
+# 設定權限
+chown -R accusys:staff /Users/accusys/momentry/var/gitea
+chown -R accusys:staff /Users/accusys/momentry/etc/gitea
+chown -R accusys:staff /Users/accusys/momentry/log
+```
+
+---
+
+### Step 3: 建立設定檔
+
+建立 `/Users/accusys/momentry/etc/gitea/app.ini`:
+
+```ini
+APP_NAME = Gitea: Git with a cup of tea
+RUN_USER = accusys
+WORK_PATH = /Users/accusys/momentry/var/gitea
+RUN_MODE = prod
+
+[database]
+DB_TYPE = postgres
+HOST = 127.0.0.1:5432
+NAME = gitea
+USER = gitea
+PASSWD = gitea_pass
+SSL_MODE = disable
+
+[repository]
+ROOT = /Users/accusys/momentry/var/gitea/data/gitea-repositories
+
+[server]
+SSH_DOMAIN = gitea.momentry.ddns.net
+DOMAIN = gitea.momentry.ddns.net
+HTTP_PORT = 3000
+ROOT_URL = http://gitea.momentry.ddns.net:3000/
+APP_DATA_PATH = /Users/accusys/momentry/var/gitea/data
+DISABLE_SSH = false
+SSH_PORT = 2222
+LFS_START_SERVER = true
+OFFLINE_MODE = true
+
+[lfs]
+PATH = /Users/accusys/momentry/var/gitea/data/lfs
+
+[log]
+MODE = console, file
+ROOT_PATH = /Users/accusys/momentry/log
+```
+
+---
+
+### Step 4: 使用 plist 開機自動啟動
+
+```bash
+# 複製 plist 到 LaunchDaemons 目錄
+sudo cp /Users/accusys/momentry_core_0.1/momentry_runtime/plist/com.momentry.gitea.plist /Library/LaunchDaemons/
+
+# 載入並啟動
+sudo launchctl load /Library/LaunchDaemons/com.momentry.gitea.plist
+```
+
+---
+
+## 監控配置
+
+### 添加到監控配置
+
+在 `monitor/config/monitor_config.yaml` 中添加：
+
+```yaml
+service:
+  services:
+    - name: "gitea"
+      type: "http"
+      port: 3000
+      host: "localhost"
+      check_url: "http://localhost:3000/"
+      timeout: 5
+      enabled: true
+```
+
+---
+
+## 卸載步驟
+
+### 重要: 路徑說明
+
+| 路徑 | 類型 | 說明 |
+|------|------|------|
+| `/Users/accusys/momentry/var/gitea/` | 數據 | **不要刪除** - Gitea 數據 |
+| `/Users/accusys/momentry/etc/gitea/` | 配置 | **不要刪除** - Gitea 配置 |
+| `/Users/accusys/momentry/log/` | 日誌 | **不要刪除** - 日誌目錄 |
+| `/opt/homebrew/opt/gitea/` | 安裝 | **刪除** - Gitea 安裝目錄 |
+
+### Step 1: 停止 Gitea
+
+```bash
+# 找到 Gitea 進程
+ps aux | grep gitea | grep -v grep
+
+# 停止 Gitea
+pkill gitea
+
+# 確認停止
+ps aux | grep gitea | grep -v grep || echo "Gitea 已停止"
+```
+
+---
+
+### Step 2: 卸載 Gitea
+
+```bash
+# 卸載 Gitea
+brew uninstall gitea
+
+# 移除 plist
+sudo launchctl unload /Library/LaunchDaemons/com.momentry.gitea.plist
+sudo rm /Library/LaunchDaemons/com.momentry.gitea.plist
+```
+
+---
+
+### Step 3: 刪除專屬檔案
+
+```bash
+# 刪除數據目錄 (可選)
+rm -rf /Users/accusys/momentry/var/gitea
+
+# 刪除配置目錄 (可選)
+rm -rf /Users/accusys/momentry/etc/gitea
+
+# 刪除日誌 (可選)
+rm -f /Users/accusys/momentry/log/gitea.log
+rm -f /Users/accusys/momentry/log/gitea.error.log
+```
+
+**注意: 不要刪除以下共用目錄**:
+```bash
+# 這些是共用的，不要刪除!
+# /Users/accusys/momentry/var
+# /Users/accusys/momentry/etc
+# /Users/accusys/momentry/log
+```
+
+---
+
+### Step 4: 卸載後檢查清單
+
+```bash
+echo "=== Gitea 卸載後檢查 ==="
+
+# 1. 檢查 Gitea 進程
+echo "1. Gitea 進程:"
+ps aux | grep gitea | grep -v grep && echo "   ✗ 仍在運行" || echo "   ✓ 已停止"
+
+# 2. Port 3000
+echo "2. Port 3000:"
+lsof -i :3000 > /dev/null 2>&1 && echo "   ✗ 仍被佔用" || echo "   ✓ 已釋放"
+
+# 3. gitea 命令
+echo "3. gitea 命令:"
+which gitea > /dev/null 2>&1 && echo "   ✗ 仍存在" || echo "   ✓ 已移除"
+
+# 4. brew 安裝
+echo "4. brew 安裝:"
+brew list gitea > /dev/null 2>&1 && echo "   ✗ 仍存在" || echo "   ✓ 已移除"
+
+# 5. launchctl 服務
+echo "5. launchctl 服務:"
+sudo launchctl list | grep gitea > /dev/null 2>&1 && echo "   ✗ 仍存在" || echo "   ✓ 已移除"
+
+# 6. 數據目錄 (可選刪除)
+echo "6. 數據目錄:"
+[ -d "/Users/accusys/momentry/var/gitea" ] && echo "   ✓ 保留" || echo "   ✗ 已刪除"
+
+# 7. 配置目錄 (可選刪除)
+echo "7. 配置目錄:"
+[ -d "/Users/accusys/momentry/etc/gitea" ] && echo "   ✓ 保留" || echo "   ✗ 已刪除"
+```
+
+**預期結果**:
+```
+=== Gitea 卸載後檢查 ===
+1. Gitea 進程:
+   ✓ 已停止
+2. Port 3000:
+   ✓ 已釋放
+3. gitea 命令:
+   ✓ 已移除
+4. brew 安裝:
+   ✓ 已移除
+5. launchctl 服務:
+   ✓ 已移除
+6. 數據目錄:
+   ✓ 保留 (或 ✗ 已刪除)
+7. 配置目錄:
+   ✓ 保留 (或 ✗ 已刪除)
+```
+
+---
+
+## 手動檢查命令
+
+```bash
+# 1. 檢查進程
+ps aux | grep gitea | grep -v grep
+
+# 2. 檢查 Port
+lsof -i :3000
+
+# 3. 測試連線
+curl http://localhost:3000/
+
+# 4. 查看版本
+gitea --version
+
+# 5. 驗證配置
+gitea doctor --config /Users/accusys/momentry/etc/gitea/app.ini
+
+# 6. 查看日誌
+tail -20 /Users/accusys/momentry/log/gitea.log
+```
+
+---
+
+## 連線資訊
+
+| 項目 | 值 |
+|------|-----|
+| URL | http://localhost:3000 |
+| Domain | gitea.momentry.ddns.net |
+| SSH Port | 2222 |
+| Database | PostgreSQL (gitea) |
+
+---
+
+## 環境變數
+
+在 `.env` 中:
+
+```env
+GITEA_URL=http://localhost:3000
+GITEA_ROOT=/Users/accusys/momentry/var/gitea/data/gitea-repositories
+```
+
+---
+
+## 故障排除
+
+### Gitea 無法啟動
+
+```bash
+# 檢查日誌
+tail -f /Users/accusys/momentry/log/gitea.log
+
+# 檢查配置語法
+gitea doctor --config /Users/accusys/momentry/etc/gitea/app.ini
+
+# 檢查目錄權限
+ls -la /Users/accusys/momentry/var/gitea/
+
+# 重新設定權限
+chown -R $(whoami):staff /Users/accusys/momentry/var/gitea
+```
+
+### Port 被佔用
+
+```bash
+# 檢查哪個程序佔用 port 3000
+lsof -i :3000
+
+# 終止佔用程序
+kill <PID>
+```
+
+### 需要重新載入 plist
+
+```bash
+# 卸載舊服務 (如果存在)
+sudo launchctl unload /Library/LaunchDaemons/com.momentry.gitea.plist 2>/dev/null
+
+# 載入新服務
+sudo launchctl load /Library/LaunchDaemons/com.momentry.gitea.plist
+```
+
+---
+
+## 檔案位置
+
+| 類型 | 路徑 | 說明 |
+|------|------|------|
+| 安裝 | `/opt/homebrew/opt/gitea/` | Gitea 安裝目錄 |
+| 執行檔 | `/opt/homebrew/opt/gitea/bin/gitea` | Gitea 執行檔 |
+| 數據目錄 | `/Users/accusys/momentry/var/gitea/data/` | 數據儲存 |
+| 配置 | `/Users/accusys/momentry/etc/gitea/app.ini` | 設定檔 |
+| 日誌 | `/Users/accusys/momentry/log/gitea.log` | 執行日誌 |
+| 錯誤日誌 | `/Users/accusys/momentry/log/gitea.error.log` | 錯誤日誌 |
+| plist | `/Library/LaunchDaemons/com.momentry.gitea.plist` | 開機啟動 |
+| 備份 | `/Users/accusys/momentry/var/gitea_backup/app.ini` | 配置備份 |
+
+---
+
+## 資料庫資訊
+
+Gitea 使用 PostgreSQL 作為資料庫:
+
+| 項目 | 值 |
+|------|-----|
+| Database | gitea |
+| User | gitea |
+| Host | 127.0.0.1:5432 |
+| Password | gitea_pass |
+
+---
+
+## 常用指令
+
+```bash
+# 啟動 Gitea
+gitea web --config /Users/accusys/momentry/etc/gitea/app.ini
+
+# 驗證配置
+gitea doctor --config /Users/accusys/momentry/etc/gitea/app.ini
+
+# 查看版本
+gitea --version
+
+# 備份數據
+gitea dump --config /Users/accusys/momentry/etc/gitea/app.ini --zipfile /Users/accusys/momentry/var/gitea_backup.zip
+```
+
+---
+
+## 版本資訊
+
+- 版本: 1.25.3
+- HTTP Port: 3000
+- SSH Port: 2222
+- 數據目錄: /Users/accusys/momentry/var/gitea/
+- 配置: /Users/accusys/momentry/etc/gitea/app.ini
+- 日誌目錄: /Users/accusys/momentry/log/