diff --git a/.gitea/workflows/ci.yml b/.gitea/workflows/ci.yml
index aebf9a6..0a3e2b4 100644
--- a/.gitea/workflows/ci.yml
+++ b/.gitea/workflows/ci.yml
@@ -2,6 +2,7 @@
 #
 # 触发条件：
 #   - pull_request（opened, synchronize）
+#   - 仅代码改动触发，纯文档改动跳过（paths-ignore）
 #
 # 注意：只保留 pull_request 触发，避免 push + pull_request 双倍触发
 #
@@ -16,6 +17,12 @@ name: CI
 on:
   pull_request:
     types: [opened, synchronize]
+    paths-ignore:
+      - 'docs/**'
+      - 'mockups/**'
+      - 'prompt_templates/**'
+      - '*.md'
+      - 'README.md'
 
 jobs:
   # ── Job 1: Lint ──────────────────────────────────────
diff --git a/.gitea/workflows/deploy.yml b/.gitea/workflows/deploy.yml
index d0b1e77..23c8cdc 100644
--- a/.gitea/workflows/deploy.yml
+++ b/.gitea/workflows/deploy.yml
@@ -2,6 +2,7 @@
 #
 # 触发条件：
 #   - push 到 main 分支
+#   - 仅代码改动触发部署，纯文档改动跳过（paths-ignore）
 #
 # Gitea v1.23.4 限制注意：
 #   - 不支持 failure() 表达式
@@ -13,6 +14,12 @@ name: Deploy
 on:
   push:
     branches: [main]
+    paths-ignore:
+      - 'docs/**'
+      - 'mockups/**'
+      - 'prompt_templates/**'
+      - '*.md'
+      - 'README.md'
 
 jobs:
   # ── Job 1: CI（main 分支跑完整测试）─────────────────