diff --git a/.gitea/workflows/dev-deploy.yaml b/.gitea/workflows/dev-deploy.yaml
new file mode 100644
index 0000000..2ae878d
--- /dev/null
+++ b/.gitea/workflows/dev-deploy.yaml
@@ -0,0 +1,33 @@
+# ============================================================
+# ai-agent dev 分支自动发布
+# 触发：push dev 分支
+# 流程：构建镜像 -> push 本地仓库(127.0.0.1:5000) -> 部署到 dev 宿主机本地 k3s
+# 前置：runner 挂载 dev k3s kubeconfig 到 /root/.kube/k3s-dev.yaml
+# ============================================================
+name: Deploy ai-agent to dev k3s
+
+on:
+  push:
+    branches: [ dev ]
+
+jobs:
+  build-and-deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - name: 拉取代码
+        uses: actions/checkout@v4
+
+      - name: 构建并推送镜像
+        run: |
+          TAG=dev-${GITHUB_SHA::8}
+          docker build -t 127.0.0.1:5000/ai-agent:${TAG} .
+          docker push 127.0.0.1:5000/ai-agent:${TAG}
+
+      - name: 部署到 dev k3s
+        env:
+          KUBECONFIG: /root/.kube/k3s-dev.yaml
+        run: |
+          kubectl create namespace dev --dry-run=client -o yaml | kubectl apply -f -
+          kubectl apply -f deploy/k8s/ai-agent.yaml
+          kubectl set image deployment/ai-agent ai-agent=127.0.0.1:5000/ai-agent:dev-${GITHUB_SHA::8} -n dev
+          kubectl rollout status deployment/ai-agent -n dev --timeout=5m
diff --git a/deploy/k8s/ai-agent.yaml b/deploy/k8s/ai-agent.yaml
new file mode 100644
index 0000000..031542d
--- /dev/null
+++ b/deploy/k8s/ai-agent.yaml
@@ -0,0 +1,46 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: ai-agent
+  namespace: dev
+spec:
+  replicas: 1
+  selector:
+    matchLabels:
+      app: ai-agent
+  template:
+    metadata:
+      labels:
+        app: ai-agent
+    spec:
+      containers:
+        - name: ai-agent
+          image: 127.0.0.1:5000/ai-agent:dev-latest
+          imagePullPolicy: IfNotPresent
+          ports:
+            - containerPort: 3005
+          env:
+            - name: TZ
+              value: Asia/Shanghai
+          readinessProbe:
+            tcpSocket:
+              port: 3005
+            initialDelaySeconds: 10
+            periodSeconds: 10
+          livenessProbe:
+            tcpSocket:
+              port: 3005
+            initialDelaySeconds: 30
+            periodSeconds: 15
+---
+apiVersion: v1
+kind: Service
+metadata:
+  name: ai-agent
+  namespace: dev
+spec:
+  selector:
+    app: ai-agent
+  ports:
+    - port: 3005
+      targetPort: 3005