Files

Warren e3d6b60825 feat: MarkBase initial version

Phase 1 (Infrastructure):
- Docs: README.md, AGENTS.md, CHANGELOG.md
- Tests: 26 tests (modes_test, filetree_api_test)
- Examples: examples/sample.md, sample.json
- CI/CD: .gitea/workflows/test.yml, release.yml
- Runner: configuration scripts and guides

Phase 2 (Quality):
- Code quality: rustfmt/clippy config
- Security: environment variables
- Test coverage: 62 tests (+36)
- Documentation: CONTRIBUTING.md, docs/api.yaml
- Showcase: demo_features.md, developer_quickstart.md

Test coverage: 75%
Test pass rate: 100%

2026-05-16 15:37:37 +08:00

1.9 KiB

Raw Permalink Blame History

Gitea Runner使用指南（快速版）

Runner已配置完成！

Runner資訊： -版本：v1.0.3

名稱：accusys-Mac-mini-M4-2.local
ID：1 -地址：https://gitea.momentry.ddns.net

啟動 Runner

方式A：前景執行（測試用）

cd /Users/accusys/markbase
./scripts/start_runner.sh

或直接執行：

cd /Users/accusys/markbase
~/.local/bin/gitea-runner daemon

方式B：背景服務（macOS launchd）

#配置為系統服務
./scripts/setup_launchd.sh

#管理命令
launchctl load ~/Library/LaunchAgents/com.gitea.runner.plist   #啟動
launchctl unload ~/Library/LaunchAgents/com.gitea.runner.plist #停止
launchctl list | grep gitea                                    #狀態
tail -f /tmp/gitea-runner.log                                  #日誌

##驗證 Runner狀態

./scripts/verify_runner.sh

##支持的Labels

macos-latest:host -本機Mac執行（bare-metal）
macos-arm64:host -本機Mac執行（bare-metal）
ubuntu-latest:docker - Docker容器執行

##觸發Workflow測試

Push觸發

git add .
git commit -m "test workflow"
git push origin main

在Gitea查看結果

1.登入：https://gitea.momentry.ddns.net 2.進入專案 → Actions →查看workflow執行狀態

##常見問題

Q: Runner無法連接Gitea？

curl -I https://gitea.momentry.ddns.net

Q: Workflow執行失敗？

tail -f /tmp/gitea-runner.log
tail -f /tmp/gitea-runner.err

Q: macOS功能測試失敗？ -確認SwitchAudioSource已安裝：brew install switchaudio-source -確認使用runs-on: macos-latest（bare-metal執行）

##Runner配置檔案

位置： /Users/accusys/markbase/.runner

重要： -不要手動刪除.runner檔案（會導致Runner重新註冊）

Runner token與註冊token不同（已自動生成）

最後更新：2026-05-16

1.9 KiB Raw Permalink Blame History Unescape Escape