commit 03f7f1e6315f6486bac6f6fb253e09c0fc846ca5
Author: gitea_admin <gitea_admin@beforegolive.com>
Date:   Mon Jul 13 09:28:24 2026 +0800

    docs: 初始化仓库 README 和 .gitignore

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..f16a057
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,5 @@
+.DS_Store
+*.swp
+*.bak
+.idea/
+.vscode/
\ No newline at end of file
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..6cd5b47
--- /dev/null
+++ b/README.md
@@ -0,0 +1,38 @@
+# gitea_admin/ci-actions
+
+Gitea Actions 公共 action 仓库。
+
+通过 `uses: gitea_admin/ci-actions/<name>@v1` 在业务 workflow 中复用，
+避免每个仓库重复实现。
+
+## 可用 action
+
+| Action | 用途 |
+|---|---|
+| [`notify-bark/`](./notify-bark/) | 推送结果到 Bark iOS 客户端 |
+| [`notify-email/`](./notify-email/) | 发送结果邮件（兼容 163/126 SMTP） |
+
+## 引用示例
+
+```yaml
+- uses: gitea_admin/ci-actions/notify-bark@v1
+  with:
+    device_key: ${{ secrets.BARK_DEVICE_KEY }}
+    title: "[${{ github.repository }}] ${{ github.workflow }}"
+    body: "status: ${{ needs.build.result }}"
+```
+
+完整示例见各 action 的 README。
+
+## 版本约定
+
+- 首次发布打 `v1.0.0`；业务 workflow 用 `@v1`（永远指向 `v1.x.y` 最新）
+- 改 bug → `v1.0.1`；兼容新 input → `v1.1.0`；breaking change → `v2.0.0`
+
+## 添加新 action
+
+1. 在仓库根下新建 `<action-name>/` 目录
+2. 写 `action.yml`（composite / docker 形态）
+3. 写 `README.md` 说明 inputs / outputs / 使用示例
+4. 在本 README 的「可用 action」表格里加一行
+5. 提交后打 tag `v1.x.y`
\ No newline at end of file