diff --git a/frontend/README.md b/frontend/README.md
new file mode 100644
index 0000000..4c4ee00
--- /dev/null
+++ b/frontend/README.md
@@ -0,0 +1,34 @@
+# Common Agent Frontend
+
+## 启动方式
+
+进入前端目录：
+
+```bash
+cd frontend
+```
+
+安装依赖：
+
+```bash
+pnpm config set registry https://registry.npmjs.org/
+pnpm install
+```
+
+启动开发服务：
+
+```bash
+pnpm dev
+```
+
+构建生产包：
+
+```bash
+pnpm build
+```
+
+本地预览生产包：
+
+```bash
+pnpm preview
+```